pax_global_header00006660000000000000000000000064130330401510014500gustar00rootroot0000000000000052 comment=02363e2ff40c27804efcca4933a473e3e4f64e94 pupnp-release-1.8.0/000077500000000000000000000000001303304015100142665ustar00rootroot00000000000000pupnp-release-1.8.0/.gitignore000066400000000000000000000031441303304015100162600ustar00rootroot00000000000000# # NOTE! Don't add files that are generated in specific # subdirectories here. Add them in the ".gitignore" file # in that subdirectory instead. # # NOTE! Please use 'git ls-files -i --exclude-standard' # command after changing this file, to see if there are # any tracked files which get ignored after the change. # # Normal rules # .* *.o *.o.* *.a *.s *.ko *.so *.so.dbg *.mod.c *.i *.lst *.symtypes *.order modules.builtin *.elf *.bin *.gz *.bz2 *.lzma *.patch *.gcno # # Top-level generic files # /tags /TAGS /linux /vmlinux /vmlinuz /System.map /Module.markers /Module.symvers # # git files that we don't want to ignore even it they are dot-files # !.gitignore !.mailmap # # Generated include files # include/config include/linux/version.h include/generated # stgit generated dirs patches-* # quilt's files patches series # cscope files cscope.* ncscope.* # gnu global files GPATH GRTAGS GSYMS GTAGS # QT-Creator files Makefile.am.user pupnp.config pupnp.creator pupnp.creator.user pupnp.files pupnp.includes *.orig *~ \#*# *.lo *.la Makefile Makefile.in aclocal.m4 autoconfig.h autoconfig.h.in autom4te.cache/ build-aux/ config.log config.status configure libtool libupnp*.pc m4/libtool.m4 m4/ltoptions.m4 m4/ltsugar.m4 m4/ltversion.m4 m4/lt~obsolete.m4 stamp-h1 upnp/inc/stamp-h2 upnp/inc/upnpconfig.h upnp/sample/tv_combo upnp/sample/tv_ctrlpt upnp/sample/tv_device upnp/unittest/unittest upnp/unittest/*.pp.c docs/doxygen /build/vc10/out.vc9.Win32/Debug /build/vc10/out.vc10.Win32 /build/vc10/out.vc10.x64 /pthreads /build/vc10/ipch /build/vc10/IUpnpErrFile.txt /build/vc10/IUpnpInfoFile.txt /build/vc10/*.opensdf pupnp-release-1.8.0/AUTHORS000066400000000000000000000000001303304015100153240ustar00rootroot00000000000000pupnp-release-1.8.0/COPYING000066400000000000000000000000001303304015100153070ustar00rootroot00000000000000pupnp-release-1.8.0/ChangeLog000066400000000000000000004364741303304015100160620ustar00rootroot00000000000000******************************************************************************* Version 1.8.0 ******************************************************************************* 2014-01-15 Peng Fix memory leaks. 2013-04-27 Thijs Schreijer Renamed SCRIPTSUPPORT to IXML_HAVE_SCRIPTSUPPORT for consistency. Also updated autoconfig and automake files, so it also works on non-windows. Option is enabled by default, because it adds an element to the node structure. Not using an available field is better than accidentally using an unavailable field. 2012-07-11 Thijs Schreijer Changed param to const UpnpAcceptSubscriptionExt() for consistency 2012-06-07 Thijs Schreijer updated ixmlDocument_createAttributeEx() and ixmlDocument_createAttribute() to use parameter DOMString instead of char * (same but now consistent) 2012-05-06 Thijs Schreijer Added script support (directive SCRIPTSUPPORT) for better support of garbage collected script languages. The node element gets a custom tag through ixmlNode_setCTag() and ixmlNode_getCTag(). And a callback upon releasing the node resources can be set using ixmlSetBeforeFree() See updated readme for usage. 2012-03-24 Fabrice Fontaine SF Bug Tracker id 3510595 - UpnpDownloadXmlDoc : can't get the file Submitted: Marco Virgulti ( mvirg83 ) - 2012-03-23 10:08:08 PDT There is a problem, perhaps, during downloading a document by UpnpDownloadXmlDoc. During debugging i've found that in an not exported api (unfortunately i forgot the code line...) where it is setted a local variable "int timeout" to -1 then passed directly to another function for sending data through tcp socket. I patched this setting it to 0 (there is an IF section that exits if timeout < 0). It is normal behavior or it is a bug? 2012-03-08 Fabrice Fontaine Check for NULL pointer in TemplateSource.h calloc can return NULL so check for NULL pointer in CLASS##_new and CLASS##_dup. 2012-03-08 Fabrice Fontaine Replace strcpy with strncpy in get_hoststr Replace strcpy with strncpy to avoid buffer overflow. 2012-03-08 Fabrice Fontaine Memory leak fix in handle_query_variable variable was never freed. 2011-02-07 Chandra Penke Add HTTPS support using OpenSSL. HTTPS support is optional and can be enabled by passing the --enable-open-ssl argument to the configure script. The following methods are introduced to the public API: UpnpInitOpenSslContext When enabled, HTTPS can be used by using "https://" instead of "http://" when passing URLs to the HTTP Client API. 2011-02-07 Chandra Penke Refactor HTTP Client API to be more generic. The following features are added: - Support for persistent HTTP connections (reusing HTTP connections). Tthis is still a work in progress and relies on applications to interpret the 'Connection' header appropriately. - Support for specifying request headers when making requests. Useful for interacting with web services that require custom headers. - Support for retrieving response headers (this is a API only change, some more work needs to be done to implement the actual functionality. Specifically copy_msg_headers in httpreadwrite.c needs to be implemented) - Common API for all HTTP methods. - Support for PUT, and DELETE methods. The following methods are introduced to the public HTTP Client API UpnpOpenHttpConnection, UpnpCloseHttpConnection, UpnpMakeHttpRequest, UpnpWriteHttpRequest, UpnpEndHttpRequest, UpnpGetHttpResponse, UpnpReadHttpResponse. Removed a lot of duplicate code in httpreadwrite.c 2011-01-17 Chandra Penke Include upnpconfig.h in FileInfo.h to automatically include large file macros 2011-01-17 Chandra Penke Fix for warnings Apple systems related to macros defined in list.h. In list.h, in apple systems, undefine the macros prior to defining them. 2011-01-16 Marcelo Jimenez Fix for UpnpFileInfo_get_LastModified() in http_MakeMessage(). UpnpFileInfo_get_LastModified() returns time_t, and http_MakeMessage() takes a "time_t *". Thanks to Chandra Penke for pointing the bug. 2010-11-22 Marcelo Jimenez Template object for ssdp_ResultData. 2010-11-10 Fabrice Fontaine Support for "polling" select in sock_read_write. Currently, in sock_read_write function, if the timeout is 0, pupnp realizes a "blocking" select (with an infinite timeout). With this patch, if timeout is set to 0, pupnp will realize a "polling" select and returns immediately if it can not read or write on the socket. This is very useful for GENA notifications when pupnp is trying to send events to a disconnected Control Point. "Blocking" select can now be done by putting a negative timeout value. 2010-09-18 Chandra Penke This is a minor build fix. The new Template*.h files added in the latest code need to be exported. Patch against the latest sources is attached. 2010-08-22 Marcelo Jimenez * upnp/src/api/Discovery.c: Fix a serious bug and memory leak in UpnpDiscovery_strcpy_DeviceType(). Thanks to David Blanchet for the patch. 2010-04-25 Marcelo Jimenez Separation of the ClientSubscription object. 2010-04-24 Marcelo Jimenez Protect the object destructors agains null pointers on deletion, which should be something valid. 2010-03-27 Marcelo Jimenez SF Patch Tracker [ 2987390 ] upnp_debug vs. ixml_debug Thanks for the load of updates, I'm still assimilating them ! Could I make a suggestion though? The addition of printNodes(IXML_Node) to upnpdebug a dds a new dependency on ixml.h for anything using upnpdebug.h. I'm making quite a bit of use of upnpdebug in porting things to version 1.8.0, and I'd prefer it if printNodes could be added to ixmldebug.h instead. I'm attach ing a patch, what do you think ? Nick 2010-03-27 Marcelo Jimenez * Forward port of svn revision 505: SF Patch Tracker [ 2836704 ] Patch for Solaris10 compilation and usage. Submitted By: zephyrus ( zephyrus00jp ) 2010-03-20 Marcelo Jimenez * SF Patch Tracker [ 2969188 ] 1.8.0: patch for FreeBSD compilation Submitted By: Nick Leverton (leveret) Fix the order of header inclusion for FreeBSD. 2010-03-20 Marcelo Jimenez * Forward port of svn revision 502: SF Patch Tracker [ 2836704 ] Search for nested serviceList (not stopping at the first lis Submitted By: zephyrus ( zephyrus00jp ) Internet Gateway Device description contains nested serviceList (rootdevice -> servicelist, subdevice and subdevice has the lower-level serviceList, etc..) Unfrotunately, the sample code sample_util.c used by tv_device sample, etc. has a code that looks for only the first top-level serviceList. This results in the failure to read all the services of an IGD xml description. Attached patch modifies this behavior and looks for the service by visiting all the serviceList in xml document in turn. With the modified patch (ad additional modification), I could simulate an IGD device and created a modified control program for that. Patch against 1.6.6 TIA. 2010-03-20 Marcelo Jimenez * SF Patch Tracker [ 2973319 ] Problem in commit 499 Submitted By: Nick Leverton (leveret) Afraid that this doesn't compile, it seems retval should be retVal in two places. 2010-03-16 Marcelo Jimenez * Fix for the ithread_mutex_unlock() logic in UpnpInit(). Thanks for Nicholas Kraft. 2010-03-15 Marcelo Jimenez * SF Patch Tracker [ 2962606 ] Autorenewal errors: invalid SID, too-short renewal interval Submitted By: Nick Leverton (leveret) Auto-renewals send an invalid SID due to a missing UpnpString_get_String call. They also send a renewal interval of 0 instead of copying it from the original subscription. 2010-03-15 Marcelo Jimenez * SF Patch Tracker [ 2964685 ] patch for avoiding inet_ntoa (1.8.0) Submitted By: Nick Leverton (leveret) Seems like SF's tracker won't let me add a patch to someone else's issue ?! This refers to https://sourceforge.net/support/tracker.php?aid=2724578 The calls to inet_ntoa are in getlocalhostname(), which is called from UpnpInit when it is returning the bound IP address. UpnpInit/getlocalhostname hasn't been updated to IPv6, I presume this is deliberate so that it doesn't start returning IPv6 addresses and overwriting the caller's IPv4-sized allocation. The attached patch just updates getlocalhostname to use inet_ntop instead of inet_ntoa, and also documents the fact that UpnpInit is IPv4 only whilst UpnpInnit2 is both IPv4 and IPv6. A fuller solution might be to change UpnpInit to use some variant on UpnpGetIfInfo. UpnpInit could still be left as IPv4 only if desired - perhaps UpnpGetIfInfo could take an option for the desired address family. getlocalhostname and its own copy of the interface scanning code would then be redundant. I don't have IPv6 capability here though so I'm reluctant to change the IPv6 code, as I have no way to test it. 2010-03-15 Marcelo Jimenez * SF Patch Tracker [ 2724578 ] patch for avoiding memory leaks when add devices each time a device been added, UpnpInit() is called, on exit, UpnpFinish() is called, but the memories allocated by ThreadPoolInit() may lost because there's no code to call ThreadPoolShutdown() to release the memories. And inet_ntoa() is not thread safe, so in my patch, I substitute inet_ntoa() with inet_ntop(). 2010-03-14 Marcelo Jimenez * SF Patch Tracker [ 2964687 ] Add new string based accessors to upnp object API As per email to pupnp-devel, this is the patch to add the _strget_ accessors for string-like objects in the interface. Will add a further patch shortly to udpate the sample programs. 2008-06-27 Marcelo Jimenez * Nicholas Kraft's patch to fix some IPv6 copy/paste issues. He reported to be getting infinite loops with the svn code. 2008-06-13 Marcelo Jimenez * SF Bug Tracker [ 1984541 ] ixmlDocumenttoString does not render the namespace tag. Submitted By: Beliveau - belivo Undoing the patch that fixed this problem. In fact, there was no problem and the patch was wrong. 2008-06-11 Marcelo Jimenez * Ingo Hofmann's patch for "Content-Type in Subscription responses". Adds charset="utf-8" attribute to the CONTENT-TYPE header line. Hi, I have found an inconsistency regarding the text/xml content-type returned by libupnp. It looks like only subscription responses send "text/xml" where all other messages contain "text/xml; charset="utf-8"". Since I'm working on an DLNA device the latter behaviour is mandatory. I changed the according lines in gena_device.c (see attached patch). I'm not sure if it would be ok for other device to have the charset field but it would help me a lot :) Best regards, Ingo 2008-06-04 Marcelo Jimenez * SF Bug Tracker [ 1984541 ] ixmlDocumenttoString does not render the namespace tag. Submitted By: Beliveau - belivo The problem occurs when converting a xml document using ixmlDocumenttoString containing a namespace tag created with ixmlDocument_createElementNS. The namespace tag doesn't get rendered. example: The following code fragment prints: instead of: Code: #include #include int main() { IXML_Document* wDoc = ixmlDocument_createDocument(); IXML_Element* wRoot = ixmlDocument_createElementNS(wDoc, "urn:schemas-upnp-org:device-1-0", "root"); ixmlNode_appendChild((IXML_Node *)wDoc,(IXML_Node *)wRoot); DOMString wString = ixmlDocumenttoString(wDoc); printf(wString); free(wString); ixmlDocument_free(wDoc); return 0; } The problem was in the printing routine, not in the library data structure. 2008-05-31 Marcelo Jimenez * Charles Nepveu's suggestion of not allocating a thread for MiniServer when it is not compiled. 2008-05-24 Marcelo Jimenez * Ported Peter Hartley's patch to compile with mingw. 2008-05-24 Marcelo Jimenez * Added some debug capability to ixml. 2008-05-02 Marcelo Jimenez * Merged Charles Nepveu's IPv6 work. libupnp now is IPv6 enabled. 2008-02-06 Marcelo Jimenez * Breaking API so that we now hide internal data structures. 2008-02-06 Marcelo Jimenez * Rewrote Peter Hartley's patch to include a new extra header field in FileInfo. ******************************************************************************* Version 1.6.21 ******************************************************************************* 2016-12-16 Gabriel Burca If the error or info log files can not be created, use stderr and stdout instead. 2016-12-08 Uwe Kleine-König Fix out-of-bound access in create_url_list() (CVE-2016-8863) If there is an invalid URL in URLS->buf after a valid one, uri_parse is called with out pointing after the allocated memory. As uri_parse writes to *out before returning an error the loop in create_url_list must be stopped early to prevent an out-of-bound access Bug: https://sourceforge.net/p/pupnp/bugs/133/ Bug-CVE: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8863 Bug-Debian: https://bugs.debian.org/842093 Bug-Redhat: https://bugzilla.redhat.com/show_bug.cgi?id=1388771 2016-11-30 Uwe Kleine-König miniserver: fix binding to ipv6 link-local addresses Linux requires to have sin6_scope_id hold the interface id when binding to link-local addresses. This is already in use in other parts of upnp, so portability shouldn't be in the way here. Without this bind(2) fails with errno=EINVAL (although ipv6(7) from manpages 4.08 specifies ENODEV in this case). Fixes: https://bugs.debian.org/813249 2016-09-15 Mathew Garret <(at)mjg59 (twitter)> SF Bug Tracker #132 CVE-2016-6255: write files via POST Submitted by: Balint Reczey in 2016-08-02 From Debian's BTS https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=831857 : From: Salvatore Bonaccorso carnil@debian.org To: Debian Bug Tracking System submit@bugs.debian.org Subject: libupnp: write files via POST Date: Wed, 20 Jul 2016 11:03:34 +0200 Source: libupnp Version: 1:1.6.17-1 Severity: grave Tags: security upstream Justification: user security hole Hi See http://www.openwall.com/lists/oss-security/2016/07/18/13 and https://twitter.com/mjg59/status/755062278513319936 . Proposed fix: https://github.com/mjg59/pupnp-code/commit/be0a01bdb83395d9f3a5ea09c1308a4f1a972cbd Regards, Salvatore From Mathew Garret's commit: Don't allow unhandled POSTs to write to the filesystem by default ******************************************************************************* Version 1.6.20 ******************************************************************************* 2016-02-22 Jean-Francois Dockes SF Bugs #131, Creator: Jean-Francois Dockes I know it sounds crazy that nobody ever saw this, but the CONTENT-LENGTH value in GENA NOTIFY messages is too small by one. It appears that most current control points don't notice the extra character (an LF, which is validly there but not included in Content-Length), probably because their protocol handler is reasonably lenient, and because the missing body LF does not prevent parsing the XML. But there is a least one anal CP (Linn Kazoo) which barfs, because it reads all data until connection close and the size mismatch triggers a bug. "Proof": In gena_device.c:217 (notify_send_and_recv()) ret_code = http_SendMessage(&info, &timeout, "bbb", start_msg.buf, start_msg.length, propertySet, strlen(propertySet), CRLF, strlen(CRLF)); start_msg has all the headers, including the empty line. Content-length should be strlen(propertySet) + strlen(CRLF) (2) In gena_device.c:433 (AllocGenaHeaders()) rc = snprintf(headers, headers_size, "%s%s%"PRIzu"%s%s%s", HEADER_LINE_1, HEADER_LINE_2A, strlen(propertySet) + 1, HEADER_LINE_2B, HEADER_LINE_3, HEADER_LINE_4); HEADER_LINE_2A is "CONTENT-LENGTH: ". The following value should be strlen(propertySet) + 2 2016-01-07 Marcelo Roberto Jimenez Fix for a reported integer overflow 2016-01-07 Jean-Francois Dockes 2016-01-07 Nick Leverton SF Patches #60, Creator: Jean-Francois Dockes When libupnp is configured with --enable-ipv6 but ipv6 is not available on the system (for example because the ipv6 code is not loaded in a Linux kernel as is the case by default on Raspbian), the ipv6 socket creation call will fail in miniserver.c and the library init will fail, even if the ipv4 initialisation would have succeeded. Let a library configured with --enable-ipv6 initialize in ipv4-only mode if ipv6 is not available instead of failing. This can happen if no ipv6 code is configured or loaded in the kernel. Don't fail if IPv6 is unavailable. We might be an IPv6 enabled distro build running on an IPv4-only custom kernel. 2016-01-07 Nick Leverton SF Bug Tracker #128, Creator: Nick Leverton redefining strndup causes "error: expected identifier or '(' before '__extension__'" Fix redefinition of strnlen and strndup These are available when HAVE_STRNDUP and HAVE_STRNLEN are defined, but libupnp provides an extern prototype anyway. Recent versions of glibc define this prototype differently, causing the following compile error: src/api/UpnpString.c:47:15: error: expected identifier or '(' before '__extension__' extern char *strndup(__const char *__string, size_t __n); 2016-01-07 Nick Leverton SF Bug Tracker #129, Creator: Nick Leverton shutdown() on UDP sockets logs ENOTCONN message. https://sourceforge.net/p/pupnp/bugs/129/ Fix ENOTCONN "Error in shutdown: Transport endpoint is not connected" When logging is enabled, ssdpserver logs bursts of "Error in shutdown: Transport endpoint is not connected" This is because shutdown() is not supported for UDP sockets and under recent UNIX specifications it returns ENOTCONN if used. 2016-01-07 Nick Leverton SF Bug Tracker #127, Creator: Klaus Fischer Miniserver uses INADDR_ANY instead of HostIP https://sourceforge.net/p/pupnp/bugs/127/ The internal miniserver.c uses INADDR_ANY instead of the HostIP/IfName provided when initializing libupnp. But, this HostIP/IfName gets used for the UDP socket when multicasting SSDP messages. Because of this, miniserver may end up sending from different IP address than ssdpserver. This patch causes miniserver to use the already known interface address. 2016-01-07 Marcelo Roberto Jimenez SF Bug Tracker #130, Creator: Shaddy Baddah infinite loop in UpnpGetIfInfo() under WIN32 Original code makes no sense. This patch should fix it. 2015-02-04 Shaun Marko Bug tracker #124 Build fails with --enable-debug Build environment Fedora 21 X86-64 * gcc 4.9.2 How to repeat $ ./configure --enable debug $ make libtool: compile: gcc -DHAVE_CONFIG_H -I. -I.. -I../upnp/inc -I./inc -I../threadutil/inc -I../ixml/inc -I./src/inc -pthread -g -O2 -Wall -MT src/api/libupnp_la-UpnpString.lo -MD -MP -MF src/api/.deps/libupnp_la-UpnpString.Tpo -c src/api/UpnpString.c -fPIC -DPIC -o src/api .libs/libupnp_la-UpnpString.o src/api/UpnpString.c:47:16: error: expected identifier or '(' before 'extension' extern char *strndup(const char *string, size_t __n); ^ Makefile:1016: recipe for target 'src/api/libupnp_la-UpnpString.lo' failed Reason for failure Build enables -O2 optimization flags which causes the inclusion of a macro implementation of strndup from include/bits/string2.h. Workarounds Disable optimization when configuring or making: $ configure CFLAGS='-g -pthread -O0' --enable-debug $ make or $ configure --enable-debug $ make CFLAGS='-g -pthread -O0' Define NO_STRING_INLINES $ export CFLAGS="-DNO_STRING_INLINES -O2" $ ./configure --enagble-debug $ make Fix * Don't declare strndup in src/api/UpnpString.c if it exists 2015-02-01 Jean-Francois Dockes Out-of-tree builds seem to be currently broken, because ixml and threadutil files need an include path to include UpnpGlobal.h, and configure tries to copy files into a directory which it does not create. The patch fixes both issues. 2014-01-03 Peng rewrite soap_device.c 1) separate HTTP handling from SOAP handling 2) remove repeated validity check, each check is performed exactly once 3) fix HTTP status code per UPnP spec, SOAP spec and RFC 2774 ******************************************************************************* Version 1.6.19 ******************************************************************************* 2013-11-14 Marcelo Roberto Jimenez SF Bug Tracker #119, Creator: Klaus Fischer Access violation due to changed usage of pthreads-win32 Dear libupnp developers, I have experienced a crash (access violation) when using libupnp on Windows. The crash is actually located in pthreads-win32 and happens when repeatedly de-/initializing libupnp on Win32 in the same process and both libupnp and pthreads-win32 are compiled as static libraries. So I'm doing this: - UpnpInit() - UpnpFinish() - UpnpInit() <- Crash I am already in touch with Ross Johnson on the pthreads-win32 mailing list regarding this issue: http://sourceware.org/ml/pthreads-win32/2013/msg00020.html He told me the problem is that the functions pthread_win32_process_attach/detach_np() should no longer be called directly, but are invoked automatically now since version 2.9.0 of pthreads-win32, which has been released approx. 1.5 years ago. Please refer to above link for in-depth information. So for proper using of latest pthreads-win32 library, those function calls should vanish inside libupnp. Could you consider adapting libupnp in that way? I would really like to use both libraries out-of-the-box without local modifications, and this issue prevents that. Best regards, Klaus 2013-11-08 Peng Fix several minor bugs in soap_device.c 1) remove redundant free 2) avoid user-provided ErrStr being overwritten by the default one 3) eliminated memory leak possiblity in handle_query_variable 2013-11-08 Peng Fix return value check of parse_uri. 2012-06-19 Yoichi NAKAYAMA SF Bug Tracker #118, Creator: T.Iwamoto tv_ctrlpt crashes after detecting a later version of tvcontrol service From: gon3456@users.sf.net Steps to reproduce: 1. Extracts and build libupnp-1.6.18 $ tar -xjf /path/to/archive/libupnp-1.6.18.tar.bz2 $ cd libupnp-1.6.18 $ ./configure $ make 2. Applies the attached patch and remake. $ patch -p1 < /path/to/patch/libupnp-1.6.18.patch $ make 3. Run tv_device. $ cd upnp/sample $ ./tv_device 4. Run tv_ctrlpt; the tv_ctrlpt crashes soon. $ ./tv_ctrlpt Segmentation fault (core dumped) This is an issue report about the sample program of control point. The tv_ctrlpt crashes after detecting a tvdevice that contains tvcontrol:2 or higher version of tvcontrol service. tv_ctrlpt should detect correctly such devices due to forward compatibility of control points with device. For more information about the compatibility, please refer the following document: DLNA Architectures and Protocols Part 1 2011 December - 7.3.2.1.3 (GUN:GZJXU) The attached patch changes the sample programs as below: - device: changes version of tvcontrol service from 1 to 2. This change may occur in the future. - cp: nothing changed: cp knows version 1 of tvcontrol service only. I know many vendors implements their control points based on the tv_ctrlpt, so I hope to fix this issue ASAP. == From: Yoichi NAKAYAMA SEGV is caused by strcpy with NULL argument. Attached patch will avoid SEGV in strcpy, but there may be other inconsistencies. > I know many vendors implements their control points based on the tv_ctrlpt, I don't think so. I think tv_ctrlpt is just a sample to be used with tv_device. 2013-10-28 Pino Toscano Fix compilation on GNU/Hurd 2013-10-28 Peng Fix return value of http_RecvPostMessage and update httpparser.c's comments 2013-10-17 Peng Fix return value of process_request and related subroutines 1) Only HTTP_XXX should be return 2) Make default return value work for process_request 2013-10-15 Peng Fix Content-Range generation bug 2013-09-10 zexian chen Hi, I had found some bugs about memory leak on libupnp-1.6.18. It may lead to memory leak when calling ThreadPoolAdd() or ThreadPoolAddPersistent() which does not return 0. See the attachment for patch. 2013-09-03 Peng Fix return value of config_description_doc. UPNP_E_XXX should not be used instead of IXML_XXX 2013-09-03 Peng Remove faulty free in GetDescDocumentAndURL. temp_str, which points to part of description, should not be freed. 2013-09-02 Peng Suppose the UPnP device is listening on 192.168.1.102:49152. Use the following to send garbage bytes to the device: while true; do echo "\""; done | netcat 192.168.1.102 49152 The device just keeps receiving these bytes and its memory usage keeps growing. Malicious client may exploit it to exhaust the device's memory. The attached patch eliminates this possibility. 2013-09-02 Peng 1) restore the scanner's original cursor position in case of insufficient input; 2) free the memories allocated for a new header in case of a failure. 2013-08-13 Peng Patch to fix behaviou when char is signed it seems to me that there is still something wrong: 1) the new is_qdtext_char() is incorrect. There is a trap if char is implemented as signed char. Suppose that c is '\xFF', it will be -1 when converted to an int. By definition, c should be qdtext: qdtext = > TEXT = OCTET = 2) the character after '\\' could be either part of a quoted-pair (together with '\\'), or a normal qdtext, since '\\' itself can be treated as a qdtext. This is equivalent to saying that the character after '\\' in a quoted string could be ANY octet. A patch based on the above two observations is attached. Peng 2013-08-13 Marcelo Roberto Jimenez Enforce RFC 2616 and accept "0" after a backslash for quoted-strings. Reported by Peng 2013-08-13 Peng Patch to make scanner_get_token more robust (avoid over-reading). 2013-07-30 Zheng Peng SF ticket #116 UpnpRemoveVirtualDir wrong linked list operation What if pVirtualDirList has two nodes and what we want to delete is the first one. Patch attached. 2013-07-30 Sebastian Brandt Dear libupnp-devels, when POST'ing to the simple web server in libupnp, the application crashes. This is caused by a missing "..." argument in webserver.c:1533. Seems it has been there for a long time ... 1.6.9 and 1.6.18 have it. webserver.c:1533 calls http_MakeMessage /* Send response. */ http_MakeMessage(&headers, 1, 1, "RTLSXcCc", ret, "text/html", X_USER_AGENT); The format parameter RTLSXcCc needs four arguments - R - response code - ret, T- content type - text/html, L - struct SendInstruction * - NOT PRESENT X - user agent - X_USER_AGENT This results in a crash. Changing to http_MakeMessage(&headers, 1, 1, "RTLSXcCc", ret, "text/html", &RespInstr, X_USER_AGENT); solves the situation. Yours, Sebastian Brandt ******************************************************************************* Version 1.6.18 ******************************************************************************* 2012-12-06 Marcelo Roberto Jimenez Security fix for CERT issue VU#922681 This patch addresses three possible buffer overflows in function unique_service_name(). The three issues have the folowing CVE numbers: CVE-2012-5958 Issue #2: Stack buffer overflow of Tempbuf CVE-2012-5959 Issue #4: Stack buffer overflow of Event->UDN CVE-2012-5960 Issue #8: Stack buffer overflow of Event->UDN Notice that the following issues have already been dealt by previous work: CVE-2012-5961 Issue #1: Stack buffer overflow of Evt->UDN CVE-2012-5962 Issue #3: Stack buffer overflow of Evt->DeviceType CVE-2012-5963 Issue #5: Stack buffer overflow of Event->UDN CVE-2012-5964 Issue #6: Stack buffer overflow of Event->DeviceType CVE-2012-5965 Issue #7: Stack buffer overflow of Event->DeviceType 2012-06-19 Yoichi NAKAYAMA Fix memory leak and access violation in UpnpSendAction(Ex)Async. Free buffers after malloc or ixmlPrintNode failure. Free Param->Header before destructing Param. 2012-05-25 Anoop Mohan This patch fixes a bug in non blocking connect call where the sock option length for SO_ERROR was passed as 0 instead of sizeof(int). 2012-04-24 Yoichi NAKAYAMA Disable SetGenaCallback call if device is disabled. If device is disabled, SetGenaCallback definition is disabled, but its call remains. A link error will occur in Win32. 2012-04-21 Yoichi NAKAYAMA Fix condition for allocation failure in get_content_type(). At the end of get_content_type() in webserver.c, it should check return value of ixmlCloneDOMString(). 2012-04-21 Yoichi NAKAYAMA Fix problems detected as dead assignment warning by clang scan-build. Wrong assignment by shutdown result hides the real error code of NewRequestHandler() in ssdp_device.c. Fix return code description of NewRequestHandler(). Handle return code from ithread_create in sample applications. Remove unused assignments. 2012-04-20 Yoichi NAKAYAMA Avoid dereference of null pointer in ixmlNode_setNodeProperties. The problem can occur if one of the arguments is NULL. Test argument and fix assertion. 2012-04-17 Yoichi NAKAYAMA Create intermediate directory per project on vc9. Sample applications share sample_util.c and collisions of object file can occur in parallel build. Modify project files to split intermediate directories against it. Apply similar changes also to library projects, like vc10 projects. 2012-04-11 Yoichi NAKAYAMA Avoid access violation after parser_parse_chunky_headers call. In parser_parse_chunky_headers, parser->msg.msg.buf can be changed by membuffer_delete call. Therefore if we save the pointer to parser->msg.entity.buf before calling membuffer_delete, it will induce access to released memory. 2012-04-06 Yoichi NAKAYAMA Remove possibility of access violation. 1. Test Instr before dereference it in http_RecvPostMessage. (Though it never becomes NULL because NULL is not passed to the static method) 2. Avoid strdup(NULL) in ixmlElement_setAttributeNS. Those are detected by llvm scan-build. 2012-04-05 Yoichi NAKAYAMA SF Bug Tracker id 3507819 - Use of thread-unsafe gmtime() in httpreadwrite.c Submitted: zephyrus ( zephyrus00jp ) - 2012-03-18 06:31:00 PDT Define http_gmtime_r and web_server_asctime_r and use it. Those prefix are added since pthread for Win32 already has macro gmtime_r and asctime_r. 2012-04-05 Yoichi NAKAYAMA Fix type of local variable stopSock in RunMiniServer() The variable is declared as SOCKET, but it is used to store return value of int receive_from_stopSock(...). The type was changed in the commit 4b47e6a51d9c7049a862695b68de75699e023551 by mistake. 2012-04-03 Fabrice Fontaine Compilation optimisation Do not compile the code related to the webserver in http_SendMessage when --disable-webserver is set ******************************************************************************* Version 1.6.17 ******************************************************************************* 2012-04-02 Fabrice Fontaine SF Bug Tracker id 3514145 - Memory leak fix in threadutil Submitted: Fabrice Fontaine ( ffontaine ) - 2012-04-02 06:49:20 PDT Put thread in a detached state when calling ithread_create otherwise in some circumstances, thread can end before the call to ithread_detach. 2012-03-30 Fabrice Fontaine Add --enable-unspecified_server Add --enable-unspecified_server configure option to set to "Unspecified" the OS name, OS version, product name and product version normally contained in the SERVER header as this could be used by an attacker. 2012-03-29 Fabrice Fontaine Removing implicit casts in miniserver.c Removing implicit integer or enum casts in miniserver.c. 2012-03-29 Fabrice Fontaine SF Bug Tracker id 3512833 - Miniserver is wrongly disabled Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-29 07:36:34 PDT Miniserver is disabled if ECXLUDE_GENA, EXCLUDE_SOAP and EXCLUDE_WEBSERVER are set. However, SSDP needs the Miniserver to answer to M-SEARCH requests. So, MiniServer should not be disabled if EXCLUDE_SSDP is not also set. 2012-03-26 Yoichi NAKAYAMA SF Bug Tracker id 3510693 - build fail with --disable-device Use INCLUDE_DEVICE_APIS instead of UPNP_HAVE_DEVICE as in other sources. Don't use soap_device_callback if INCLUDE_DEVICE_APIS is not set, otherwise link error occur on Windows. 2012-03-26 Fabrice Fontaine SF Bug Tracker id 3511149 - --disable-ssdp has no effect Submitted: Yoichi NAKAYAMA ( yoichi ) - 2012-03-25 18:14:34 PDT There are typos in upnp/src/inc/config.h "EXCLUDE_SSSDP" (shold be EXCLUDE_SSDP), therefore EXCLUDE_SSDP is always 0, and --disable-ssdp has no effect. 2012-03-24 Fabrice Fontaine Remove implicit casts Cast parameters of htonl in uint32_t in IN6_IS_ADDR_GLOBAL and IN6_IS_ADDR_ULA definitions. Remove comparison with 0 in while statement of vfmatch, http_SendMessage and http_MakeMessage. 2012-03-24 Yoichi NAKAYAMA SF Bug Tracker id 3510693 - build fail with --disable-device GetDeviceHandleInfo just fail without using undefined member DeviceAf if UPNP_HAVE_DEVICE is not defined. Move ContentTypeHeader definition to soap_common.c, since it is also used in soap_ctrlpt.c. ******************************************************************************* Version 1.6.16 ******************************************************************************* 2012-03-18 Fabrice Fontaine Replace sprintf by snprintf in http_WriteHttpPost Replace sprintf by snprintf in http_WriteHttpPost to avoid buffer overflow. 2012-03-18 Fabrice Fontaine Add infoSize parameter to get_sdk_info Add infoSize parameter to get_sdk_info function to replace sprintf call by a snprintf call. 2012-03-16 Fabrice Fontaine Check return code in ixml Check return code of ixmlDocument_CreateElementEx in ixmlDocument_CreateElement. Check return code of ixmlNode_setNodeName and ixmlNode_setNodeValue in ixmlNode_cloneCDATASect and ixmlNode_cloneTextNode. 2012-03-16 Fabrice Fontaine Add more explicit casts and remove dead code Comment unused SERVER from DeviceShutdown. Comment unused max from parse_hostport. Comment unused nodeptr from ixmlNode_cloneDoc. Comment unused newNode from Parser_hasDefaultNamespace. Comment unused Parser_parseReference function Check return code of shutdown and display an error if needed. 2012-03-15 Fabrice Fontaine Fix previous commit Replace HAVE_UPNP_OPTSSDP by UPNP_HAVE_OPTSSDP in upnpapi.c. 2012-03-15 Fabrice Fontaine Add --disable-optssdp option Modify configure.ac to add --disable-optssdp option. This option will remove OPT, 01-NLS and X_USER_AGENT headers from SSDP messages as those headers are optional. If --disable-gena and disable-optssdp are both used, uuid part will not be compiled anymore. 2012-03-15 Fabrice Fontaine Bug fix in ixmlNode_allowChildren Commit d48d73720bd325062c4d3b9ce85f3944be4f562d added a bug in ixmlNode_allowChildren, this function was returning FALSE instead of TRUE when newChild->nodeName was eELEMENT_NODE. 2012-03-15 Fabrice Fontaine Improve upnp/genlib/net Change ret_code from int to parse_status_t in match. Set back return code of ReadResponseLineAndHeaders from parse_status_t to int as this function can return UPNP_E_BAD_HTTPMSG. As a result, do not cast the result of this function into parse_status_t in http_OpenHttpGetProxy and http_OpenHttpGetEx. Use switch with PARSE_OK in parsetools.c. Add missing explicit casts of integer constants in uri.c and httpreadwrite.c. Use switch, int and sa_family_t with AF_INET in uri.c. Print an error in http_Download if realloc failed. 2012-03-14 Fabrice Fontaine Use switch instead of if with enums in upnpapi.c Replace if statements with switch when using HND_DEVICE and HND_CLIENT enum constants. Correct also UpnpUnRegisterRootDeviceLowPower and UpnpUnRegisterClient as those functions were wrongly awaiting an UPNP_E_INVALID_HANDLE instead of HND_INVALID from GetHandleInfo. 2012-03-14 Fabrice Fontaine Improve ssdp part Do not compile CreateClientRequestPacketUlaGua if IPv6 is disable. Cast DestAddr->sa_family from sa_family_t into int when calling CreateServicePacket as this function has been set back to accept int in a692e591defe6ed9a617b9b4a083964a01f7bbab. Use switch instead of if with AF_INET and AF_INET6. Add missing casts from AF_INET and AF_INET6 into sa_family_t when using them to set sin_family and sin6_family. Add missing explicit casts into size_t or lu when using integer constants with strlen or unsigned long indexes. Set SSDP_PAUSE to be unsigned as it is used with usleep. 2012-03-14 Fabrice Fontaine Use switch insted of if with enums in ixml Replace if statements with switch when using enums in ixml. Remove uneeded initialization in ixmlAttr_init, Parser_init and ixmlNode_init which was added by wrongly added in commit 06660b6383c438e4e2c9ca9854077cecc4da9e5d. 2012-03-14 Fabrice Fontaine Use switch insted of if with enums in threadutil Replace if statements with switch when using enums in threadutil. 2012-03-14 Fabrice Fontaine Fix missing break in http_RecvMessage There was a missing break in PARSE_INCOMPLETE_ENTITY due to commit 2eb3e069badd5c8676738c3ead37f9551fd8448e. 2012-03-14 Yoichi NAKAYAMA Fix parse failure observed with tvdevice sample. Commit c40d2bc0c9b60c43b641ac4669c7b8bbcd6134c5 has a problem at removing the parentheses in parser_parse_responseline. Difference of pointers was used with intention, don't cast them separately. 2012-03-14 Yoichi NAKAYAMA Fix compile error on Windows. Include UpnpStdInt.h for ssize_t. Define sa_family_t in UpnpInet.h. 2012-03-14 Yoichi NAKAYAMA Avoid ambiguous change of SsdpEvent in unique_service_name. Handle overflow before changing SsdpEvent. Because the behavior of "snprintf" is platform dependent in such case. 2012-03-14 Yoichi NAKAYAMA SF Bug Tracker id 3502958 - The commit 5944960e prevents a pupnp client (amule) from receiving replies from an IGD device. Previous change broke the feature. The error of unique_service_name in ssdp_request_type should be ignored. This reverts commit 5944960e172a797a9fcc196291f4046cafa7f6ec. 2012-03-13 Marcelo Roberto Jimenez Address family is an int Reference: "man 2 socket". 2012-03-11 Fabrice Fontaine Remove more implicit casts in upnp part Remove more "implicit integer or enum conversions" errors as well as dead code. 2012-03-11 Fabrice Fontaine Remove more implicit casts in upnp part Remove more "implicit integer or enum conversions" as well as memset before snprintf. 2012-03-11 Yoichi NAKAYAMA Avoid out of range access in CheckOtherHTTPHeaders. There was a problem in HDR_ACCEPT_LANGUAGE case. It may read from TmpBuf larger amount than allocated, since condition was always true. Terminate RespInstr->AcceptLanguageHeader correctly. Skip allocation if there is already sufficient buffer. 2012-03-10 Fabrice Fontaine Remove some of the implicit cast in upnp part Remove some of the "implicit integer or enum conversions" as well as some access to NULL reference in upnp part. 2012-03-10 Fabrice Fontaine Remove lock in ThreadPoolInit If ThreadPoolInit returned EAGAIN, tp->lock was not freed. 2012-03-10 Fabrice Fontaine Improve ixml Remove "implicit integer conversions" and "dereference NULL return value" errors in ixml part. 2012-03-10 Yoichi NAKAYAMA Exclude IPv6 stuff in SearchByTarget when UPNP_ENABLE_IPV6 is not defined. 2012-03-10 Yoichi NAKAYAMA Further measures against buffer overflows. * Pass output buffer size to CreateClientRequestPacket(UlaGua) from SearchByTarget and detect overflow. * Handle SearchByTarget error in UpnpSearchAsync. * Pass output buffer size to addrToString and detect overflow. * Handle addrToString error in configure_urlbase. * Handle overflow in http_SendMessage. * Respect unique_service_name error in ssdp_request_type so as not to touch non-terminated buffer under Evt. * Treat large argument as error in UpnpAddVirtualDir. * Use strncpy with the standard way in readFromSSDPSocket. * Do not clear buffer before snprintf. * Clarify the last argument of GetDescDocumentAndURL has size LINE_SIZE. * For inet_ntop, use buffer with size INET6_ADDRSTRLEN or INET_ADDRSTRLEN. 2012-03-10 Yoichi NAKAYAMA Handle allocation error in strndup to avoid access violation. Return NULL before calling strncpy. Platforms with HAVE_STRNDUP are not affected. 2012-03-10 Yoichi NAKAYAMA Synchronize autoconfig.h with upnpconfig.h. It fixes WIN32 build where configure is not invoked. 2012-03-09 Fabrice Fontaine More compilaton optimisation Do not compile most of service_table.c and client_table.c if --disable-gena is used. Do not compile urlconfig.c if --disable-webserver is used. Adding new UPNP_HAVE_xxx variables in upnpconfig.h and upnpconfig.h.in. 2012-03-09 Fabrice Fontaine Optimisation of --disable-webserver Do not compile webserver.c if --disable-webserver is used. 2012-03-09 Fabrice Fontaine Improve threadutil Remove "dereference NULL return" errors and implicit conversions to double or enum types. 2012-03-09 Fabrice Fontaine Optimisation of --disable-webserver Do not compile miniserver.c if --disable-webserver is used. 2012-03-09 Fabrice Fontaine Adding configure options Adding --disable-ssdp, --disable-soap, --disable-gena options to configure script. 2012-03-09 Fabrice Fontaine Bug fix of last commit _snprintf was wrongly defined in ssdp_server.c 2012-03-09 Fabrice Fontaine SF Bug Tracker id 3499781 - msvc doesn't have snprintf Submitted: Yoichi NAKAYAMA ( yoichi ) - 2012-03-08 10:18:39 PST 97a17ff5add73c97844e2fa74456bab4df0800f1 commit breaks build on windows/msvc since there is no snprintf. Note: * Some existing sources use _snprintf when WIN32 is defined, but its behavior is a bit different from C99 snprintf. * snprintf does terminate the buffer, so the commit (use buffer size minus 1 as argument) changes the behavior at the boundary. * Truncation might be better than crash in some cases. But it may result in not good. 2012-03-08 Marcelo Roberto Jimenez SF Bug Tracker id 3499878 - UpnpUnSubscribeAsync(): ‘retVal’ may be used uninitialized Submitted: Marcelo Roberto Jimenez ( mroberto ) - 2012-03-08 12:38:57 PST src/api/upnpapi.c: In function ‘UpnpUnSubscribeAsync’: src/api/upnpapi.c:2060:6: warning: ‘retVal’ may be used uninitialized in this function 2012-03-08 Marcelo Roberto Jimenez SF Bug Tracker id 3175217 - Crash bug in Parser_addNamespace() Submitted: Terry Farnham ( tfarnham ) - 2011-02-07 09:25:25 PST Details: The strcmp(pNode->prefix,pCur->prefix) crashes on pCur->prefix being NULL. This occurs on invalidly formatted xml where a node uses an undefined namespace. I would expect to receive IXML_FAILED in this situation. 2012-03-08 Fabrice Fontaine Removing access to NULL pointers in node.c and element.c Check that newNode is not NULL ixmlNode_cloneNodeTree and pass newAttr as the return node in the ixmlElement_setAttributeNodeNS call of ixmlElement_setAttributeNS. 2012-03-08 Fabrice Fontaine Memory leaks correction in upnpapi.c Fix memory leaks in UpnpUnSubscribe, SendActionExAsync and RenewSubscription. 2012-03-08 Fabrice Fontaine SF Bug Tracker id 3496993 - Write after free in ixmlNode_insertBefore Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-05 04:54:40 PST If ixmlNode_isParent(nodeptr, newChild) returns TRUE, ixmlNode_removeChild(nodeptr, newChild, NULL) will free newChild before the modifications of newChild->nextSibling and newChild->prevSibling. 2012-03-08 Fabrice Fontaine Remove most of strcpy, sprintf and strcat Replace strcpy, sprintf and strcat by strncpy, snprintf and strncat to avoid buffer overflows. 2012-03-07 Yoichi NAKAYAMA SF Bug Tracker id 3497714 - Buffer overflows Fix compile error on WIN32. Local variables must be declared first. Remove outdated comment. 2012-03-07 Yoichi NAKAYAMA Avoid access violation in assertion. xmlParser->pCurElement was dereferenced before null check. Affects debug build only. 2012-03-07 Fabrice Fontaine Remove SIZEOF_MISTACH error in notify_send_and_recv Replace sizeof(CRLF) by strlen(CRLF) as CRLF is a const char*. 2012-03-07 Fabrice Fontaine SF Bug Tracker id 3498442 - Memory leak in get_file_info Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-07 02:44:30 PST info->contentType is not freed before being set to NULL. 2012-03-07 Fabrice Fontaine SF Bug Tracker id 3498439 - Memory leak in removeServiceTable Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-07 02:35:46 PST UDN is not freed. 2012-03-07 Fabrice Fontaine SF Bug Tracker id 3498436 - Memory leak in Parser_processAttributeName Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-07 02:30:57 PST attr is not freed if ixmlNode_setNodeProperties or ixmlNode_setAttributeNode return an error in Parser_processAttributeName. 2012-03-07 Fabrice Fontaine Fixing an error in d6db7c555d0f11856ce5e3e479b16a4cf4689107 commit Evt.Sid should not be cast into char* when calling sizeof otherwise size will be 4. 2012-03-06 Fabrice Fontaine Removing two unused variables in ssdp_server.c Removing first TempPtr allocation in unique_service_name as well as one of the dbgStr allocation in AdvertizeAndReply as those values were not used. 2012-03-06 Fabrice Fontaine SF Bug Tracker id 3497714 - Buffer overflows Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-06 07:36:08 PST Call to strcpy should be replaced by call to memset and strncpy to avoid getting buffer overflows. 2012-03-05 Marcelo Roberto Jimenez SF Bug Tracker id 2989399 - UpnpSetVirtualDirCallbacks API removal in 1.6.x Submitted: Nick Leverton ( leveret ) - 2010-04-19 07:44:10 PDT Details: The recent codebase merge has removed a significant API call which is used by several pupnp devices such as mediatomb and gmediaserver. UpnpSetVirtualDirCallbacks() has been replaced by individual routines to set each callback. Essentially this means that 1.6.7 will in fact be a majo bump and 1.6.6 devices can no longer link against it. Could we have the call reinstated please, perhaps as a wrapper around the individual calls ? As it is, all distros will have to patch their 1.6.x apps, rebuild and re-link them. The other removed API calls and external variables don't seem to be used by any of the apps I have copies of, but UpnpSetVirtualDirCallbacks is important for maintaining compatibility within 1.6.x. 2012-03-05 Marcelo Roberto Jimenez SF Bug Tracker id 3325246 - Memory Leak in XML Parser Submitted: Terry Farnham ( tfarnham ) - 2011-06-23 09:45:54 PDT Details: The following bit of xml results in a memory leak from the xml parser: const char *xmlbuffer=" DMS-1.50"; When I execute the following code: IXML_Document *doc = ixmlParseBuffer(xmlbuffer); ixmlDocument_free(doc); It results in a memory leak in ixmlparser.c line 2107 where it calls safe_strdup( newElement->namespaceURI ); It's difficult to figure out why. 2012-03-05 Marcelo Roberto Jimenez SF Bug Tracker id 3417134 - Crash seen in UpnpFinish Submitted: Sunil ( sunilangadi ) - 2011-10-02 08:28:47 PDT Details: I observed crash in the below mentioned log statement in function upnpfinish(file: upnpapi.c). UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Exiting UpnpFinish: UpnpSdkInit is :%d:\n", UpnpSdkInit); In particular it was crashing in ithread_self in UpnpDisplayFileAndLine(file upnpdebug.c) on WIN32. Moving the call ithread_cleanup_library() below the upnp printf call mentioned above in function upnpfinish fixed the crash but I couldn't get to the root of the problem. The problem was observed on WIN32. 2012-03-05 Fabrice Fontaine SF Bug Tracker id 3497159 - Bug fix in Parser_readFileOrBuffer Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-05 14:20:58 PST fileSize = ftell( xmlFilePtr ); can return a negative value, in this case the function should exit (at the moment, the function exits only if ftell returns 0). 2012-03-05 Fabrice Fontaine SF Bug Tracker id 3497140 - Bug fix in http_get_code_text Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-05 13:07:03 PST Replace if( statusCode < 100 && statusCode >= 600 ) which can't be true by if( statusCode < 100 || statusCode >= 600 ). 2012-03-05 Fabrice Fontaine SF Bug Tracker id 3497126 - Resource leak in http_RecvPostMessage Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-05 12:33:59 PST Fp is not closed when an error is raised on membuffer_append or sock_read. 2012-03-05 Fabrice Fontaine SF Bug Tracker id 3497034 - Buffer not null terminated in UpnpGetIfInfo Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-05 06:43:52 PST gIF_NAME might be not null terminated. 2012-03-05 Fabrice Fontaine SF Bug Tracker id 3497033 - Buffer not null terminated in UpnpInit Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-05 06:42:18 PST gIF_IPV4, gIF_IPV6 and gIF_IPV6_ULA_GUA might be not null terminated. Moreover, gIF_IPV4 should be 16 characters (INET_ADDRSTRLEN) and not 22 and gIF_IPV6 should be 46 characters (INET6_ADDRSTRLEN) and not 65. 2012-03-05 Fabrice Fontaine Bug fix of lastest commit (parse_hostport) Missing parenthesis in memset. 2012-03-05 Fabrice Fontaine SF Bug Tracker id 3497027 - Buffer not null terminated in parse_hostport Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-05 06:28:38 PST workbuf might be not null terminated. 2012-03-05 Fabrice Fontaine SF Bug Tracker id 3497009 - Resource leak in http_SendMessage Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-05 05:51:44 PST Fp is not closed if fseeko(Fp, Instr->RangeOffset, SEEK_CUR) does not return 0. 2012-03-05 Fabrice Fontaine HInfo->ServiceTable initialization in UpnpRegisterRootDevice2 and UpnpRegisterRootDevice4 Initialize also HInfo->ServiceTable in UpnpRegisterRootDevice2 and UpnpRegisterRootDevice4 functions 2012-03-05 Fabrice Fontaine SF Bug Tracker id 3496703 - Handle_Info::ServiceList may have undefined value Submitted: Yoichi NAKAYAMA ( yoichi ) - 2012-03-03 20:49:25 PST In UpnpRegisterRootDevice(), HInfo->ServiceTable is not initialized and getServiceTable() may leave it intact. It will cause crash on freeServiceTable() called from UpnpUnRegisterRootDevice(). 2012-03-05 Fabrice Fontaine SF Bug Tracker id 3496702 - TvDeviceStop is called even if Start failed Submitted: Yoichi NAKAYAMA ( yoichi ) - 2012-03-03 20:35:08 PST In sample tvdevice, error of device_main() is not handled, and TvDeviceStop() cause crash. 2012-03-05 Fabrice Fontaine SF Bug Tracker id 3496942 - Memory leak in config_description_doc Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-05 01:55:54 PST element was not freed if membuffer_append_str(&url_str, "http://") does not return 0. Moreover addNew was not used. 2012-03-05 Fabrice Fontaine SF Bug Tracker id 3496938 - Missing structures initialisation in some functions Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-05 01:31:16 PST Memsetting to 0 some of the structures: finfo in process_request, job in readFromSSDPSocket, request in http_OpenHttpGetEx, job in genaNotifyThread, job in genaNotifyAllExt, job in genaNotifyAll, job in genaInitNotifyExt, job in genaInitNotify, LocalAddr in getlocalhostname. 2012-03-05 Fabrice Fontaine SF Bug Tracker id 3496934 - Memory leaks in getlocalhostname and UpnpGetIfInfo Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-05 01:25:42 PST LocalSock is not closed if ioctl(LocalSock, SIOCGIFCONF, &ifConf); returns an error. 2012-03-05 Fabrice Fontaine SF Bug Tracker id 3496933 - Out-of-bounds access in CheckOtherHTTPHeaders Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-05 01:15:34 PST An out-of-bands access is raised because size of RespInst->AcceptLanguageHeader is 200 and TmpBuf size is 180. 2012-03-05 Fabrice Fontaine Remove unused currentDevice variable in removeServiceTable currentDevice is not used in this function. 2012-03-05 Fabrice Fontaine SF Bug Tracker id 3496581 - Memory leak in getServiceList Submitted: Fabrice Fontaine ( ffontaine ) - 2012-03-03 08:43:23 PST serviceNodeList is not freed if current->next = malloc(sizeof(service_info)); returns NULL. 2012-02-29 Fabrice Fontaine SF Bug Tracker id 3495616 - Memory leak in ixmlElement_setAttributeNS Submitted: Fabrice Fontaine ( ffontaine ) - 2012-02-29 02:09:43 PST newAttrNode is not freed if newAttr->n.nodeValue = strdup(value); returns NULL or if ixmlElement_setAttributeNodeNS(element, newAttr, NULL) does not return IXML_SUCCESS. 2012-02-28 Fabrice Fontaine SF Bug Tracker id 3495286 - Double free in get_action_node Submitted: Fabrice Fontaine ( ffontaine ) - 2012-02-28 04:27:54 PST ixmlFreeDOMString(ActNodeName); is called twice if ixmlParseBufferEx(ActNodeName, RespNode); does not return IXML_SUCCESS. 2012-02-28 Fabrice Fontaine SF Bug Tracker id 3495280 - Memory leak in ixmlDocument_createElementEx Submitted: Fabrice Fontaine ( ffontaine ) - 2012-02-28 04:01:02 PST There is a memory leak in ixmlDocument_createElementEx: newElement->tagName is not freed if newElement->n.nodeName = strdup(tagName); returns NULL. 2012-02-27 Fabrice Fontaine SF Bug Tracker id 3494865 - Use of non-initialized variable in parser_parse_requestline Submitted: Marcelo Roberto Jimenez ( mroberto ) - 2012-02-26 16:50:23 PST src/genlib/net/http/httpparser.c: In function ‘parser_parse_requestline’: src/genlib/net/http/httpparser.c:1319:28: warning: ‘index’ may be used uninitialized in this function 2012-02-24 Marcelo Roberto Jimenez SF Bug Tracker id 3489999 - UpnpString leaks in genaSubscribe() Submitted: Yoichi NAKAYAMA ( yoichi ) - 2012-02-21 07:06:35 PST In genaSubscribe() (defined in upnp/src/gena/gena_ctrlpt.c), ActualSID and EventURL will not be freed if ScheduleGenaAutoRenew returns UPNP_E_SUCCESS. This fixes the an issue introduced by the previous fix. 2012-02-23 Marcelo Roberto Jimenez SF Bug Tracker id 3489990 - some files are missing in tarball Submitted: Yoichi NAKAYAMA ( yoichi ) - 2012-02-21 06:52:57 PST Released tarball (e.g. libupnp-1.6.15.tar.bz2) does not contain some files under upnp/{inc,src} used by the project files for windows (build/vc8/libupnp. vcproj and build/vc9/libupnp.vcproj). This breaks build on Windows from tarball released after following changes http://pupnp.git.sourceforge.net/git/gitweb.cgi?p=pupnp/pupnp;a=commitdiff;h=0eba550da039be01211b56fea0d02d03f0a12343 http://pupnp.git.sourceforge.net/git/gitweb.cgi?p=pupnp/pupnp;a=commitdiff;h=7a796b264ec7d5de5876fd6a2001c2d329709e02 2012-02-23 Marcelo Roberto Jimenez SF Bug Tracker id 3489999 - UpnpString leaks in genaSubscribe() Submitted: Yoichi NAKAYAMA ( yoichi ) - 2012-02-21 07:06:35 PST In genaSubscribe() (defined in upnp/src/gena/gena_ctrlpt.c), ActualSID and EventURL will not be freed if ScheduleGenaAutoRenew returns UPNP_E_SUCCESS. This fixes the original issue. 2012-02-23 Marcelo Roberto Jimenez SF Bug Tracker: UpnpString leaks in genaSubscribe() In genaSubscribe() (defined in upnp/src/gena/gena_ctrlpt.c), ActualSID and EventURL will not be freed if ScheduleGenaAutoRenew returns UPNP_E_SUCCESS. 2012-02-23 Marcelo Roberto Jimenez Revert cb89781a55466703763c1b0ee67094eb401ddfe9 as suggested by Fabrice Fontaine. 2012-02-07 Edwin Stearns Attached is a patch that resolved an issue I found with a server that gave its device description URI without a trailing slash (e.g. `http://127.0.0.1:5555`). 2012-01-04 Fabrice Fontaine Bug fix for IPv4-mapped IPv6 addresses. Setting IPv6 sockets with IPV6_V6ONLY flag to avoid getting IP packets with IPv4-mapped IPv6 addresses on IPv6 sockets. ******************************************************************************* Version 1.6.15 ******************************************************************************* 2012-01-11 Fabrice Fontaine Bug fix on M-SEARCH for IPv6 CPs. Small bug fix on IPv6 Control Point: now CP will also send M-SEARCH on site-scope address (FF05::C) instead of only sending M-SEARCH on link-scope (FF02::C). 2012-01-11 Fabrice Fontaine Retrieve IPv6 addresses in Upnp_Discovery. Changing sockaddr_in into sockaddr_storage in Upnp_Discovery to be able to retrieve IPv6 addresses of devices in Control Points using pupnp. 2012-01-09 Marcelo Roberto Jimenez SF Bug tracker, ID: 3469344 Submitted: dimmman ( dimmman ) - 2012-01-04 01:44:29 PST Details: Looking at the code (v1.6.14, upnptools.c) for UpnpResolveURL and UpnpResolveURL2 it shows that the ExitFunction: always returns UPNP_E_SUCCESS. I'm farily sure it's a simple mistake that should have been "return ret;" in both cases. Br, Jonny ******************************************************************************* Version 1.6.14 ******************************************************************************* 2011-10-31 Fabrice Fontaine UPnP Low Power Support. Adding two new functions (UpnpSendAdvertisementLowPower and UpnpUnRegisterRootDeviceLowPower) which can be used to specify values for the three SSDP headers defined by UPnP Low Power. Those headers are Powerstate, SleepPeriod and RegistrationState. 2011-10-24 Fabrice Fontaine Bug fix in IN6_IS_ADDR_GLOBAL. Changing IN6_IS_ADDR_GLOBAL to accept all IPv6 addresses which have a 2000::/3 prefix. 2011-07-20 Marc Essayan Bug Fix on M-SEARCH. Do not answer to M-SEARCH using HTTP version 1.0 as specified by the UPnP Device Architecture. 2011-03-18 Iain Denniston Fixes for compilation under Windows (specifically MSVC). Also added MSVC supported "_inline", and fixed some WIN32 specific warnings. 2011-03-08 Iain Denniston Several fixes to correctly use SOCKET (and related) types instead of non-portable variations. ******************************************************************************* Version 1.6.13 ******************************************************************************* 2011-03-15 Fabrice Fontaine Putting ssdpReqSocks under compilation flag. Putting all access to ssdpReqSock4 and ssdpReqSock6 under INCLUDE_CLIENT_APIS compilation flag to be able to compile when client part of library is disable. 2011-03-15 Fabrice Fontaine New UpnpRegisterRootDevice4 for legacy CPs. Add a new UpnpRegisterRootDevice4 which allow user to specify a description URL to be returned for legacy CPs (for example, CPs searching for a v1 when the device is v2). Most of those CPs does not work if they found a v2 in the XML description, so this new function is only used to solve interoperability issues. 2011-03-08 Iain Denniston Fix for memory leak. 2011-03-08 Iain Denniston Fix and Update of MSVC9 solution and project files - now compile in all modes. Added x64 and static library targets. 2011-03-08 Iain Denniston Partial fix for UpnpGetIfInfo with MSVC - convert wchar string to char string (full fix requires a lot of work - potentially impacting all supported platforms) 2011-03-11 Marcelo Roberto Jimenez Created the macros PRIzd and PRIzx to deal with MSVC lack of C99. Thanks to Iain Denniston for pointing it out. 2011-03-08 Iain Denniston Fixes for headers when compiled under C++ 2011-03-08 Iain Denniston Fix for uuid_unpack incorrect shift precedence. ******************************************************************************* Version 1.6.12 ******************************************************************************* 2011-02-08 Marcelo Roberto Jimenez Undo the "incorrectly exported include files". Legacy applications like linux-igd and igd2-for-linux are using those API to create a thread pool for managing their GENA events. Leave it to be reworked in 1.8.x. ******************************************************************************* Version 1.6.11 ******************************************************************************* 2011-02-07 Marcelo Roberto Jimenez Remove PrintThreadPoolStats() from the public API. This function uses a ThreadPool object as an argument, which is not supposed to be exported. 2011-02-07 Fabrice Fontaine Major bug fix in IPv6 code. Major bug fix in miniserver.c for IPv6, bug was introduced when changing implementation of get_port in November 20th 2010 ("gena:fix several compiler warnings" commit). 2011-02-06 Marcelo Roberto Jimenez Fix for incorrectly exported include files. The files FreeList.h, LinkedList.h, ThreadPool.h and TimerThread.h from the threautil library were being installed in the include directory of the library, incorrectly exposing internal data structure of the library. 2011-01-30 Chandra Penke Fix for compilation warnings of unused variables in upnpdebug.c in release builds. 2011-01-20 Chandra Penke Fix for Race condition can hang miniserver thread. Add 'requiredThreads' field to the ThreadPool structure, to avoid a race condition when waiting for a new thread to be created. The race condition occurs when a thread is destroyed while the master thread is waiting for a new thread to be created. Thanks to Chuck Thomason for pointing the problem. Summary: Race condition can hang miniserver thread - ID: 3158591 Details: Hello, I have found a race condition in the thread pool handling of libupnp-1.6.6 that periodically results in the miniserver thread getting blocked infinitely. In my setup, I have the miniserver thread pool configured with 1 job per thread, 2 threads minimum, and 50 threads maximum. Just before the lockup occurs, the miniserver thread pool contains 2 threads: one worker thread hanging around from a previous HTTP request job (let's call that thread "old_worker") and the miniserver thread itself. A new HTTP request comes in. Accordingly, the miniserver enters schedule_request_job() and then ThreadPoolAdd(). In ThreadPoolAdd(), the job gets added to the medium-priority queue, and AddWorker() is called. In AddWorker(), jobs = 1 and threads = 1, so CreateWorker gets called. When we enter CreateWorker(), tp->totalThreads is 2, so currentThreads is 3. The function creates a new thread and then blocks on tp->start_and_shutdown. The miniserver thread expects the newly created thread to increment tp->totalThreads and then signal the condition variable to wake up the miniserver thread and let it proceed. The newly created thread starts in the WorkerThread() function. It increments tp->totalThreads to 3, does a broadcast on the start_and_shutdown condition, and starts running its job. However, before the miniserver thread wakes up, "old_worker" times out. It sees that there are no jobs in any queue and that the total number of threads (3) is more than the minimum (2). As a result, it reduces tp->totalThreads to 2 and dies. Now the miniserver thread finally wakes up. It checks tp->totalThreads and sees that its value is 2, so it blocks on tp->start_and_shutdown again. It has now "missed" seeing tp->totalThreads get incremented to 3 and will never be unblocked again. When this issue does occur for a server device, the miniserver port remains open, but becomes unresponsive since the miniserver thread is stuck. SSDP alive messages keep getting sent out, as they are handled by a separate thread. Reproducing the issue is difficult due to the timing coincidence involved, but in my environment I am presently seeing it at least once a day. I figured out the sequence described above through addition of my own debug logs. The relevant code involved in this bug has not changed substantially in libupnp-1.6.10, though I am planning to test against 1.6.10 as well in the near future. Do you have any input for an elegant fix for this issue? Thanks, Chuck Thomason 2011-01-16 Marcelo Roberto Jimenez Define _FILE_OFFSET_BITS, _LARGEFILE_SOURCE and _LARGE_FILE_SOURCE in upnpconfig.h. Make these definitions available to programs using the library. Thanks to Chandra Penke for pointing the problem. Summary: Problem with large file support in pupnp build - ID: 3158969 Submitted: Chandra ( inactiveneurons ) - 2011-01-15 16:17:02 BRST Details: First off, I apologize in advance for the length of this comment, it's the only way I could describe the problem accurately. Secondly, a brief thanks (again). The company I'm working for has been using pupnp for a massively cross-platform project which involves iphone, osx, windows, linux x86, arm, and mips hosts. It's amazing how well it works, so kudos to the maintainers! We came across a problem when compiling with the following tool-chain: http://www.codesourcery.com/sgpp/lite/mips/portal/release824. The problem is the following: In configure.ac the following lines exist to enable large file support: AC_DEFINE([_LARGE_FILE_SOURCE], [], [Large files support]) AC_DEFINE([_FILE_OFFSET_BITS], [64], [File Offset size]) Which in turn result in the following #defines in autoconfig.h: #define _LARGE_FILE_SOURCE /**/ #define _FILE_OFFSET_BITS 64 However, this file is not exported as part of the upnp build. Therefore, while the entire library gets built with large file support, it's possible that dependent libraries which only rely on the include files may not use large file support. In the particular case of the above tool-chain, the 'off_t' type is 8 bytes when large file support is enabled, but only 4 bytes when it's not. As a result part our stack built on top of pupnp, which did not have large file support (because it did not use the above autoconf directives), was relying on 'a off_t' that was 4 bytes. This caused, among many things, for the UpnpFileInfo struct to break. Since the struct is completely invisible outside of pupnp (because of some template macro magic), pupnp thought that 'FileLength' field was 8 bytes, but the header setter/getter methods being used by dependent libraries thought that it was 4, which caused some erratic behavior when going through pupnp's webserver and HTTP client API. We put in a temporary work around by adding the following preprocessor flags: -D_LARGE_FILE_SOURCE, -D_FILE_OFFSET_BITS=64 as part of our build process. However, it's a hack, and I was wondering if I'm missing something and there's a better way to approach this. Thanks, Chandra 2011-01-16 Marcelo Roberto Jimenez Use config.h to test for the availability of strndup() and strnlen(). 2011-01-14 Chandra Penke - Null termination of strndup() implementation on systems missing it. - Implementation of strnlen() on systems missing it. 2011-01-14 Chandra Penke Fixes transfer encoding in the HTTP client API, which is currently broken. The break was due to a regression caused by another fix (tracker 3056713), which fixed an out of memory crash when downloading large files. The previous fix changed the http_ReadHttpGet() implementation so that data already read by the user was discarded. However, it only worked for transfers where the content length was specified. This fix extends the previous implementation to cover chunked transfer encoding. 2011-01-14 Chandra Penke Minor change in membuffer.c to include "membuffer.h" without looking in the standard header path. This allows pupnp to build in xcode. 2010-12-18 Marcelo Roberto Jimenez SF Tracker: Patches Fedora mingw32 compilation - ID: 3138849 Details: Hello. I trying compile libupnp-1.6.10 on the Fedora 14 MinGW Environment and get many errors. I create patch to fix it. With this patch i can get static library. This patch is very raw. Submitted: Ivan Romanov (ivanromanov) - 2010-12-16 23:29:19 UTC ******************************************************************************* Version 1.6.10 ******************************************************************************* 2010-11-23 Fabrice Fontaine Major bug fix in http_SendMessage. Currently, http_SendMessage was not able to write to write a buffer due to a bad use of file_buf instead of buf. This bug was introduced by the 0197-Doxygen-reformating-compiler-warnings patch. 2010-11-23 Fabrice Fontaine Returning the Sid in Upnp_Event_Subscribe. Currently, Upnp_Event_Subscribe always contains an empty chain in the Sid parameter. This patch now saves the client Subscription ID in this parameter so Control Points can see and use the same SID in the Upnp_Event_Subscribe and in the Upnp_Event structures. 2010-11-22 Marcelo Roberto Jimenez Two fixes from Juergen Lock : 1. varargs: pass size of CRLF as size_t not as int: --- upnp/src/gena/gena_device.c.orig +++ upnp/src/gena/gena_device.c @@ -225,7 +225,7 @@ static UPNP_INLINE int notify_send_and_r "bbb", start_msg.buf, start_msg.length, propertySet, strlen(propertySet), - "\r\n", 2); + "\r\n", sizeof "\r\n" - 1); if (ret_code) { membuffer_destroy(&start_msg); sock_destroy(&info, SD_BOTH); 2. Remove "b" arg here, there is no buffer passed: (this caused a pointer to be interpreted as a buffer size to be alloc'd/copied, hence the 32 GB.) --- upnp/src/genlib/net/http/webserver.c.orig +++ upnp/src/genlib/net/http/webserver.c @@ -1262,7 +1262,7 @@ static int process_request( // Content-Range: bytes 222-3333/4000 HTTP_PARTIAL_CONTENT // Transfer-Encoding: chunked if (http_MakeMessage(headers, resp_major, resp_minor, - "R" "TLD" "s" "tcS" "b" "Xc" "sCc", + "R" "TLD" "s" "tcS" "Xc" "sCc", HTTP_OK, // status code finfo.content_type, // content type RespInstr, // language info 2010-11-15 Marcelo Roberto Jimenez Added the convenience function UpnpResolveURL2() to upnptools.c. This function avoids some unecessary memory allocation. The memory alloc'd by this function must be freed later by the caller. 2010-11-10 Fabrice Fontaine Add GENA_NOTIFICATION_xxx_TIMEOUT variable. Currently, in notify_send_and_recv function, pupnp waits for HTTP_DEFAULT_TIMEOUT seconds when trying to send a GENA notification. When there is a lot of notifications with CPs which was disconnected without unsusbcribing, all the pupnp threads are blocked on this timeout. To correct, this issue, this patch adds a new variable, GENA_NOTIFICATION_SENDING_TIMEOUT, which can be used to lower the timeout so GENA threads return quickly when writing is impossible. By the same mean, pupnp waits the CP's answer to the NOTIFY for HTTP_DEFAULT_TIMEOUT seconds, so this patch adds a new variable, GENA_NOTIFICATION_ANSWERING_TIMEOUT, to customize this value. 2010-11-10 Fabrice Fontaine Add --disable-blocking-tcp-connections flag. Currently, pupnp is using a blocking connect to sends GENA notifications. As a result, when there is a lot of notifications with CPs which were disconnected without unsusbcribing, all the pupnp threads are blocked for 20s (timeout). To correct this issue, this patch replace the call to connect with a call to private_connect and add a compilation flag to disable blocking TCP connections, so if we are not able to connect to the CP, the notification is lost. 2010-11-07 Stefan Sommerfeld Several patches for windows compatibility and fixing warnings. 2010-11-07 Marcelo Roberto Jimenez PTHREAD_MUTEX_RECURSIVE on DragonFly is an enum. SF Bug Tracker - ID: 3104527 Submitted: OBATA Akio ( obache ) - 2010-11-07 07:10:28 BRST In threadutil/inc/ithread.h, it is expected that PTHREAD_MUTEX_RECURSIVE is defined as macro. But on DragonFly BSD, it is defined as enum, so not works as expected. Attachment patch treat that DragonFly BSD always have PTHREAD_MUTEX_RECURSIVE. 2010-11-07 Marcelo Roberto Jimenez ftime(3) in -lcompat should not be checked. SF Bug Tracker - ID: 3104521 Submitted: OBATA Akio ( obache ) - 2010-11-07 07:03:44 BRST In configure.ac AC_CHECK_FUNCS(ftime,, [AC_CHECK_LIB(compat, ftime)]) But since version 1.6.3, ftime(3) is not used, so it should be removed, or introduce unwanted linkage with -lcompat. ******************************************************************************* Version 1.6.9 ******************************************************************************* 2010-11-06 Marcelo Roberto Jimenez Fix for bug introduced in samples code in svn revision 502, commit git:25c908c558c8e60eb386c155a6b93add447ffec0 Sample device and combo were aborting with the message: "***** SampleUtil_Initialize was called multiple times!" 2010-11-06 Fabrice Fontaine Make multiple SSDP advertisements faster. Put the loop to send multiple copies of each SSDP advertisements in ssdp_server.c instead of ssdp_device.c so we have only one call to imillisleep ( SSDP_PAUSE ) to speed up advertisements. 2010-11-05 Fabrice Fontaine Removing unused NUM_COPY variable. Previously, NUM_COPY was used in ssdp_device.c to send multiple copies of each advertisements but also multiple replies to each M-SEARCH request. As sending multiple replies is not compliant with HTTPU/MU spec, NUM_COPY has been set to 1 in an older patch. However, as this variable is not needed and has been replaced with SSDP_COPY, it has been removed. 2010-11-05 Fabrice Fontaine Use SSDP_COPY to send multiple SSDP advertisements. Currently, SSDP_COPY is used only to send multiple M-SEARCH requests (in ssdp_ctrlpt.c). With this patch, SSDP_COPY is also used to send multiple copies of each advertisements packets (in ssdp_device.c). 2010-11-01 Carl Benson Fix for Android build. I had to do some modifications myself though, because the Android build system insists on having a file named "util.h" taking precedence in its include path, libupnp gets confused because of the same filename in upnp/src/inc/util.h ******************************************************************************* Version 1.6.8 ******************************************************************************* 2010-10-20 Marcelo Roberto Jimenez Fix a long date memory leak in webserver.c:StrStr(). 2010-10-19 Marcelo Roberto Jimenez Bug fix in select of miniserver.c Fix a bug in miniserver.c, in which maxMiniSock was wrongly declared as unsigned int and as a result it was beeng set to ((unsigned int)(-1)). As a result, after beeing incremented, it became zero, and this value was beeing used in the select() call. Thanks to Fabrice Fontaine for helping and testing with this issue. 2010-10-15 Marcelo Roberto Jimenez Fix for 100% CPU issue in select() in miniserv.c. I have also removed the sleep() call, it was just a workaround. SF Bug Tracker [ 3086852 ] 99% CPU loop in miniserver.c on a non ipv6 system. Submitted by: Jin ( jin_eld ) - 2010-10-13 19:29:13 UTC I cross compiled libupnp 1.6.7 for ARM9 using the --disable-ipv6 option, my system is an ipv4 only setup. I do not know why this problem only appears when running the app in the background (for instance using nohup &), but then it starts using 99% CPU. I traced the problem down to the select() call in miniserver.c in the RunMiniServer() function. Select returns code 1, but errno is set to "Socket operation on non-socket", I also see this when running my app under strace. I set all ...Sock6 variables to INVALID_SOCKET to make sure that they do not get added to the FD_SET and the problem is gone. ******************************************************************************* Version 1.6.7 ******************************************************************************* 2010-10-01 Fabrice Fontaine Adding --disable-notification-reordering option Adding a configure flag to disable GENA notification reordering as even with an imillisleep(1), this mechanism consumes too much CPU on embedded devices when there is a burst of notifications. 2010-09-30 Fabrice Fontaine Bug fix when there is no service in embedded devices When a device with embedded devices (like IGD) when created and one of the embedded devices did not have any service, there was a Segmentation Fault (see SF Tracker [ 2688125 ]). Original SF Tracker issue follows: SF Tracker [ 2688125 ] v1.6.6 crashes on subdevices without services Submitted by: Arno Willig ( akw ) - 2009-03-15 22:45:23 BRT I discovered a bug, which will make libupnp (1.6.6) segfault, when you create a upnp description document with multiple devices which have subdevices, but no own services. The crash occurs in genlib/service_table.c in line 977: end->next = getServiceList( currentDevice, &next_end, URLBase ); In this case "end" seems not to be defined, so end->next crashes. Can anyone confirm this, please? 2010-09-28 Marc Essayan Bug fix on burst of GENA notification When a lot of notifications were generated by a device in a short period of time then 100% of the CPU was used to reorder those notifications by pushing back the thread in the job queue. This mechanism has been modified so now thread sleep 1 ms before being pushed back into the job queue. Removing DEFAULT_SCHED_PARAM parameter and use sched_get_priority_min(DEFAULT_POLICY) instead. 2010-09-22 Fabrice Fontaine Bug fix on M-SEARCH response Devices must respond to M-SEARCH requests for any supported version and the response should specify the same version as was contained in the search target. Previously, the device did not answer if the M-SEARCH request did not contain the same version number than the version number of the device. 2010-09-21 Fabrice Fontaine Add Content-Language iff Accept-Language Add Content-Language header in the response if and only if there is an Accept-Language header in the request. 2010-09-21 Fabrice Fontaine Addition of WEB_SERVER_CONTENT_LANGUAGE parameter This patch adds the WEB_SERVER_CONTENT_LANGUAGE parameter so the user can specify the language used by the device during Description and Presentation steps of UPnP through the HTTP CONTENT-LANGUAGE header. By default, the WEB_SERVER_CONTENT_LANGUAGE is an empty string so no CONTENT-LANGUAGE is added. 2010-09-18 Fabrice Fontaine Customize the stack size of the threads used by pupnp through the new THREAD_STACK_SIZE variable. This patch allows a user to customize the stack size of the threads used by pupnp through the new THREAD_STACK_SIZE variable. This is especially useful on embedded systems with limited memory where the user can set THREAD_STACK_SIZE to ITHREAD_STACK_MIN. However, as this modification can have side effects, I set 0 as the default value, so threads will continue to use the default stack size of the system (which varies greatly as stated in https://computing.llnl.gov/tutorials/pthreads/). 2010-09-16 Fabrice Fontaine Broken IPv6. IPv6 is currently broken in latest release of branch-1.6.x, so find a patch attached that correct the issue (small fixes on define, undef and retVal). 2010-09-10 Warwick Harvey Patch to take notice of UPNP_USE_RWLOCK flag The configure.ac file included with UPnP checks for the presence of the pthread_rwlock_t type, and then sets the value of the UPNP_USE_RWLOCK flag appropriately. However, this flag is not referenced at all in the source code, and thus the code does not compile on systems that don't have the pthread_rwlock_t type (such as Android). Please find attached a patch (against the current 1.6.x head) that checks the value of this flag and falls back on using mutexes if read-write locks are not available. 2010-09-10 Jean Sigwald I discovered a reliable denial-of-service issue on the last stable release of libupnp (1.6.6) remotely triggerable by any unauthenticated user. The issue is related with a bad parsing of malformed XML. 2010-09-10 Chandra Penke * SF Patch Tracker [ 2854711 ] Patch for Solaris10 compilation and usage Submitted By: zephyrus ( zephyrus00jp ) Patch for Solaris10 compilation and usage. 2010-09-10 Chandra Penke Add support for conditionally enabling ipv6. 2010-09-10 Chandra Penke Fix for compilation in debug builds. Ensure internal methods are declared as static since debug builds don't inline. 2010-09-09 Chandra Penke Fix for regression in SSDP code to send/receive messages over UDP Sending messages over UDP is broken in some Apple OSes such as OS X and iOS. This might be broken in other OSes to but didn't verify. The fix is to modify the socket lenght argument of sendto to use the correct sockaddr lenght dependng on whether the socket is IPV4 or IPV6. Also added some error checks and debugging related to the issue 2010-09-07 Marcelo Jimenez Using UpnpReadHttpGet to download large files causes the application to crash. This happens when the file being downloaded exceeds the device memory - entirely possible when transferring video files. The programmatic cause is that the logic implemented in the function http_ReadHttpGet (which UpnpReadHttpGet calls) reads the entire file into memory. The fix modifies the existing logic to discard data after it's been read; there's no reason to keep it around since the caller of UpnpReadHttpGet already has a copy of it. This issue exists in 1.6.6 as well as the latest sources. Patch submitted by Chandra (inactiveneurons). 2010-09-07 Marcelo Jimenez In the latest sources, http_RequestAndResponse and other methods that use connect() are broken. More specifically, connect() in these methods is returning with an EINVAL. The programatic cause is that the address_len argument passed to connect() is different in IPV4 vs IPV6 (as described in: http://www.opengroup.org/onlinepubs/009695399/functions/connect.html). The current code always uses the IPV6 size. The fix modifies each use of connect() to use the correct size based on the address family being used. Patch submitted by Chandra (inactiveneurons). 2010-09-07 Marcelo Jimenez Fix compilation error in upnp/src/gena/gena_ctrlpt.c (this is most likely an error on all platforms). Patch submitted by Chandra (inactiveneurons). 2010-09-07 Marcelo Jimenez Fix compilation error in upnp/src/inc/ssdplib.h when compiling in OS X (the netinet/* headers are not available). Patch submitted by Chandra (inactiveneurons). 2010-09-07 Marcelo Jimenez Fix compilation error in ixml/inc/ixml.h when compiling with an Objective-C compiler (when cross-compiling for iPhone devices). Patch submitted by Chandra (inactiveneurons). 2010-08-21 Marcelo Jimenez * Issue regarding the GENA notifications. A string termination indicator was added at the end of the notification ("\r\n") in notify_send_and_recv() in upnp/src/gena/gena_device.c. Patch by Fabrice Fontaine. 2010-08-21 Marcelo Jimenez * The last part of Ronan Menard's patch. 2010-08-21 Marcelo Jimenez * upnp/src/ssdp/ssdp_device.c: Fix for IPV6 ULA/GUA issues. * upnp/src/ssdp/ssdp_ctrlpt.c: Fix for IPV6 ULA/GUA issues. * upnp/src/ssdp/ssdp_server.c: Fix for IPV6 ULA/GUA issues. Patch submitted by Ronan Menard. 2010-08-21 Marcelo Jimenez * upnp/src/genlib/miniserver/miniserver.c: Fix for IPV6 ULA/GUA issues. Patch submitted by Ronan Menard. 2010-08-21 Marcelo Jimenez * gena_subscribe(): Fix for IPV6 ULA/GUA issues. Patch submitted by Ronan Menard. 2010-08-21 Marcelo Jimenez * SOCKET ssdpSock6UlaGua: created variable for later use. Patch submitted by Ronan Menard. 2010-08-21 Marcelo Jimenez * SSDP_IPV6_SITELOCAL: new macro. Patch submitted by Ronan Menard. 2010-08-21 Marcelo Jimenez * The scope of the macro NUM_HANDLE is now restricted to upnpapi.c. 2010-08-21 Marcelo Jimenez * InitHandleList() has never been implemented, I guess no one has ever called it, so remove it. * GetFreeHandle() and FreeHandle() are now static as they should. 2010-08-21 Marcelo Jimenez * New internal buffer added to store global/ula IPV6 address. * Macros to test whether an IPV6 address is global or ula. * UpnpGetServerUlaGuaIp6Address(): added interface. * IN6_IS_ADDR_GLOBAL, IN6_IS_ADDR_ULA: new macros. * gIF_IPV6_ULA_GUA: new buffer. * UpnpRegisterRootDevice3(): Change to the test of already registered devices for IPV6. * UpnpGetIfInfo(): gua/ula issues. Patch submitted by Ronan Menard. 2010-08-19 Marcelo Jimenez * libUPnP does support IPV6 now. Patch submitted by Ronan Menard. 2010-08-19 Marcelo Jimenez * HTTP version equal to 1.0 should fail as required by the UPnP certification tool. Patch submitted by Ronan Menard. 2010-06-28 Marcelo Jimenez SF Bug Tracker [ 3022490 ] String declaration fix for patch applied in 3007407 Hello, When my patch for tracker ID 3007407 was accepted, the definition of the serviceList string was changed from #define SERVICELIST_STR "serviceList" to static const char *SERVICELIST_STR = "serviceList"; During internal code review of the final patch, it was pointed out that sizeof(SERVICELIST_STR) == 4 since SERVICELIST_STR is now declared as a pointer instead of an array. If you wish to use a variable instead of a define, I suggest the following instead: static const char SERVICELIST_STR[] = "serviceList"; Thanks, Chuck Thomason 2010-06-10 Marcelo Jimenez SF Bug Tracker [ 3007407 ] Service traversal issue in AdvertiseAndReply() Submitted: Chuck Thomason ( cyt4 ) - 2010-05-26 15:07:39 UTC When the UPnP server is started, one alive message is broadcast for each service in each device. It appears that libupnp's implementation of the alive message generation does not correctly navigate the XML description document when locating the services. This can result in the wrong UDN being used in the alive message sent for a service. In my specific case (see attached XML), the root EchoSTB device contains no services, but its embedded MediaServer device contains 2 services. When the existing libupnp code traverses the EchoSTB device in the XML, it searches the global list of serviceLists within the document instead of searching for a serviceList that is its direct child node. The ContentDirectory and ConnectionManager services are then announced with the UDN of EchoSTB1 (the root device) instead of with the UDN of MediaServer, which is actually their parent device. I discovered this behavior using libupnp-1.6.6. I have generated a patch against branch-1.6.x that corrects the XML navigation such that all services are traversed from their parent device, which results in the correct UDN being sent in the alive message for each service. I built from branch-1.6.x without this patch, tested, and confirmed that the issue still exists as I observed it in libupnp-1.6.6. I then built from branch-1.6.x with this patch, tested, and confirmed that the issue was resolved. Thanks, Chuck Thomason 2010-05-07 Marcelo Jimenez SF Bug Tracker [ 2995758 ] libupnp 1.6.6, wrong bind when reuseaddr is 1. Submitted: viallard anthony ( homer242 ) When trying to use reuseaddr option in miniserver/miniserver.c, there isn't a affectation of the port chosen (serverAddr.sin_port isn't receive listen_port variable value). 2010-04-25 Marcelo Jimenez Define PROTOTYPES to be one by default in global.h. This affects the RSA MD5 code. 2010-03-27 Nick Leverton Subscription auto-renewals copy the renewal time from old subscription. 2010-03-27 Marcelo Jimenez * Added API to ithread, created the following functions: - int ithread_initialize_library(void); - int ithread_cleanup_library(void); - int ithread_initialize_thread(void); - int ithread_cleanup_thread(void); * SF Bug Tracker [ 2876374 ] Access Violation when compiling with Visual Studio 2008 Submitted: Stulle ( stulleamgym ) - 2009-10-10 19:05 Hi, I am one of the devs of the MorphXT project and I use this lib in some other of my projects, too. When I tried to upgrade the lib earlier for one of my projects I had to realise that something did not work at first and while most of the things were reasonably ease to be fixed. Now, the last thing I encountered was not so easy to fix and I am uncertain if my fix is any good so I'll just post it here and wait for some comments. The problem was that I got an Access Violation when calling "UpnpInit". It would call "ithread_rwlock_init(&GlobalHndRWLock, NULL)" which eventually led to calling "pthread_cond_init" and I got the error notice at "EnterCriticalSection (&ptw32_cond_list_lock);". It appeared that "ptw32_cond_list_lock" was NULL. Now, I found two ways to fix this. Firstly moving the whole block after at least one of the "ThreadPoolInit" calls will fix the issue. Secondly, you could add: #ifdef WIN32 #ifdef PTW32_STATIC_LIB // to get the following working we need this... is it a good patch or not... I do not know! pthread_win32_process_attach_np(); #endif #endif right before "ithread_rwlock_init(&GlobalHndRWLock, NULL)". Just so you know, I am using libupnp 1.6.6 and libpthreads 2.8.0 and both are linked static into the binaries. I am currently using Visual Studio 2008 for development with Windows being the target OS. Any comment at your end? Regards, Stulle 2010-03-27 Marcelo Jimenez * SF Patch Tracker [ 2836704 ] Patch for Solaris10 compilation and usage. Submitted By: zephyrus ( zephyrus00jp ) This second part covers the issue on linking with -lsocket -lnsl -lrt. 2010-03-21 Marcelo Jimenez * SF Bug Tracker [ 2392166 ] ithread_detach not called for finished worker thread Submitted: Ulrik ( ulsv_enea ) - 2008-12-05 08:24 Valgrind reports a memory leak due to that the function ithread_detach is not called for finished worker threads in ThreadPool.c. ==21137== 2,176 bytes in 8 blocks are possibly lost in loss record 5 of 5 ==21137== at 0x4C20F3F: calloc (vg_replace_malloc.c:279) ==21137== by 0x4010F58: _dl_allocate_tls (in /lib/ld-2.6.1.so) ==21137== by 0x544BA92: pthread_create@@GLIBC_2.2.5 (in /lib/libpthread-2.6.1.so) ==21137== by 0x5F94592: CreateWorker (ThreadPool.c:639) ==21137== by 0x5F95079: ThreadPoolInit (ThreadPool.c:784) I'm using libupnp 1.6.6 For more info on pthread_detach, see: http://gelorakan.wordpress.com/2007/11/26/pthead_create-valgrind-memory-lea k-solved/ 2010-03-21 Marcelo Jimenez * SF Bug Tracker [ 2392304 ] Memory leak in SSDP AdvertiseAndReply Submitted: Ulrik ( ulsv_enea ) - 2008-12-05 08:24 Valgrind reports a memory leak function in AdvertiseAndReply (ssdp/ssdp_server.c) in libupnp 1.6.6 There are continue statements in many places in AdvertiseAndReply. In some of those error handling cases the variable nodelist is not free'ed before continuing to the next iteration. The next iteration will take care of free'ing the nodelist from the previous iteration in most cases, but not when breaking out of the for loop after the last element. I belive this memory leak can be solved by makeing sure that the rows ixmlNodeList_free( nodeList ); nodeList = NULL; are always executed, also in the beginning of the last iteration when we found out that there are not more elements. ==29110== at 0x4C21C16: malloc (vg_replace_malloc.c:149) ==29110== by 0x5D8DE0E: ixmlNodeList_addToNodeList (nodeList.c:106) ==29110== by 0x5D8B7E2: ixmlNode_getElementsByTagNameRecursive (node.c:1438) ==29110== by 0x5D8E587: ixmlElement_getElementsByTagName (element.c:491) ==29110== by 0x5B6C0F1: AdvertiseAndReply (ssdp_server.c:201) ==29110== by 0x5B7AB74: UpnpSendAdvertisement (upnpapi.c:1495) 2010-03-21 Marcelo Jimenez * libupnp and multi-flows scenario patch Submited by Carlo Parata from STMicroelectronics. Hi Roberto and Nektarios, after an analysis of the problem of libupnp with a multi-flows scenario, I noticed that the only cause of the freezed system is the ThreadPool management. There are not mutex problems. In practise, if all threads in the thread pool are busy executing jobs, a new worker thread should be created if a job is scheduled (I inspired to tombupnp library). So I solved the problem with a little patch in threadutil library that you can find attached in this e-mail. I hope to have helped you. 2010-03-21 Marcelo Jimenez * SF Patch Tracker [ 2964973 ] install: will not overwrite just-created ...blah... with... Submitted: Nick Leverton ( leveret ) - 2010-03-07 05:18 Full error: /usr/bin/install: will not overwrite just-created `/tmp/buildd/libupnp-1.6.6/debian/tmp/usr/share/doc/libupnp3-dev/examples/s ample_util.c' with `common/sample_util.c' This seems to be from Automake 1.11 which doesn't like having duplicate files in a Makefile.am. Patch attached, kindly provided by Stefan Potyra for Debian (http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=543068) This fix will be needed for both 1.6.x and 1.8.x branches. 2010-03-21 Marcelo Jimenez * Backport of svn revision 504: SF Patch Tracker [ 2969188 ] 1.8.0: patch for FreeBSD compilation Submitted By: Nick Leverton (leveret) Fix the order of header inclusion for FreeBSD. 2010-03-21 Marcelo Jimenez * SF Patch Tracker [ 2836704 ] Patch for Solaris10 compilation and usage. Submitted By: zephyrus ( zephyrus00jp ) Obs by Marcelo: The issue with linking with -lsocket -lnsl -lrt is not covered in this changeset beacuse I don't have solaris to test. I will need some help from zephyrus in this regard. The issue will be addressed in a future changeset. Compilation for solaris I have used gcc3.x and gcc4.x under solaris 10 for x86 / 64 bits. A couple of Source file fixes were necessary for successful compilation and runtime behavior. threadutil/src/ThreadPool.c POSIX sched_setschduler() returns non-negative value for success. Without the fix, UpnpInit() fails immediately. upnpp/src/api/upnpai.c There is a typo of a macro name "__sun" in one of the CPP conditional. Without the fix, the compilation aborts due to unknown constant in socket ioctl call. A few structs and an array is not properly initialized. Well, I think it may be safe as is, but when I checked it using purify evaluation version, it was reported that uninitizlied iszBuffer may cause read of uninitialized memory. So play it safe. Configure issue. This has to be more of a configure magic. To link a program successfully using network, we need -lsocket and -lnsl library specifications on the link line. We also need -lrt for programs that use thread scheduling features. The sample program under upnp/sample requires -lsocket -lnsl -lrt for successful linking. I added -lsocket -lnsl -lrt to Makefile.in. configure probably needs to take care of these. I don't know much about configure, automake, etc., so I am just raising a flag here. TIA 2010-03-20 Marcelo Jimenez * SF Patch Tracker [ 2836704 ] Search for nested serviceList (not stopping at the first lis Submitted By: zephyrus ( zephyrus00jp ) Internet Gateway Device description contains nested serviceList (rootdevice -> servicelist, subdevice and subdevice has the lower-level serviceList, etc..) Unfrotunately, the sample code sample_util.c used by tv_device sample, etc. has a code that looks for only the first top-level serviceList. This results in the failure to read all the services of an IGD xml description. Attached patch modifies this behavior and looks for the service by visiting all the serviceList in xml document in turn. With the modified patch (ad additional modification), I could simulate an IGD device and created a modified control program for that. Patch against 1.6.6 TIA. 2010-03-15 Marcelo Jimenez * SF Patch Tracker [ 2203721 ] timeb.h check obsolete 2010-03-15 Marcelo Jimenez * SF Patch Tracker [ 2970872 ] Update ErrorMessages for latest return code list Submitted By: Nick Leverton ( leveret ) ErrorMessage[] in upnptools.c has got a bit out of sync, the attached patch (generated from grep 'define UPNP_E_') should bring it up to date. 2010-03-15 Marcelo Jimenez * SF Patch Tracker [ 2857611 ] Declare a few functions to have proper (void) argument list. Submitted By: zephyrus ( zephyrus00jp ) In a publicly installed headers, a few functions are declared without any arguments at all, a la "()". When I used gcc's -Wimplict and -Wstrict-prototypes to check for the mismatch of function prototype declarations and their usage in my own program, some headers from libupnp-1.6.6 produced warnings. They are not strictly bugs, but pretty much annoying. This is 2009, and almost all the important compilers understand ISO-C. So the offending functions are declared as "(void") to show that they have no arguments at all. 2010-03-14 Marcelo Jimenez * SF Patch Tracker [ 2546532 ] Missing carriage return between SOAPACTION and User-Agent headers. There is something going wrong in soap_ctrlpt.c at line 931 (based on version 1.6.6 release). The http_Makemessage call looks as follows: if (http_MakeMessage( &request, 1, 1, "Q" "sbc" "N" "s" "s" "Ucc" "sss", SOAPMETHOD_POST, path.buf, path.length, "HOST: ", host.buf, host.length, content_length, ContentTypeHeader, "SOAPACTION: \"urn:schemas-upnp-org:control-1-0#QueryStateVariable\"", xml_start, var_name, xml_end ) != 0 ) { return UPNP_E_OUTOF_MEMORY; } This will result in the SOAPACTION header to be immediately followed by the User-Agent header, while a cr-lf should separate the two. I propose to fix this by changing the second "s" to "sc" to force the addition of a cr-lf after the SOAPACTION. This looks consistent to the other Makemessage calls. 2009-03-06 Oxygenic * parameter problem fixed in soap_request_and_response(), 2nd call to http_RequestAndResponse() was wrong (thanks to Kim Kyungsan) 2008-07-25 Marcelo Jimenez * Added upnp/m4/libupnp.m4 to the distribution tarball. 2008-07-25 Marcelo Jimenez * Fixed a missing HandleUnlock() in upnp/src/gena/gena_device.c. 2008-07-24 Marcelo Jimenez * SF Bug Tracker [ 2026431 ] pupnp does not build on GNU/KfreeBSD. Submitted By: Nick Leverton - leveret Gnu/KFreeBSD is one of the Debian architectures, it includes a FreeBSD kernel with GNU userspace (glibc etc). The Gnu/KfreeBSD developers provided the attached patch to test the appropriate #define and allow pupnp to build in their environment, and asked me to forward it to you. Since the test is a simple check for defined(__GLIBC__), this would presumably also help with other ports of GNU libc to non-Linux kernels. 2008-07-16 Marcelo Jimenez * Andre Sodermans (wienerschnitzel) patch for building libupnp under windows systems with VC9. This one fixes a missing include. 2008-06-30 Marcelo Jimenez * Added an m4 macro to deal with finding libupnp in the users' configure script. 2008-06-11 Marcelo Jimenez * Fixed a buffer overflow due to a bug in the calculation of the CONTENT-TYPE header line size, the length was beeing calculated with the wrong string, there was a missing colon. 2008-06-02 Marcelo Jimenez * SF Bug Tracker [ 1942285 ] UpnpCreatePropertySet can leak memory. Submitted By: Bob Ciora - bobciora In file upnp/src/api/upnptools.c, function UpnpCreatePropertySet can leak memory if no additional arguments are passed. This is because of the 'return' statement at (or near) line 554. The prior call to ixmlParseBufferEx may succeed. This causes a basic ixml tree to be created. The return statement at line 554 leaves this tree in memory without cleaning it up. There are two options: either add code prior to the return at 554 to clean up the tree, or simply allow a NumArg parameter of 0 to be passed. I prefer the second method -- there doesn't seem to be any need to pass *any* arguments to this function. In my local copy of upnptools.c, I have simply replaced the "return NULL" in line 554 to "return PropSet". I've attached the source file. 2008-05-26 Marcelo Jimenez * SF Bug Tracker [ 1903069 ] Subs (not services) not marked 'active' Submitted By: Bob Ciora - bobciora If the UpnpAcceptSubscription is not called, the subscription is not marked as "active", so no state variables will ever be sent. I have a "lazy" architecture where a service may not be ready to publish any state data at the time of a subscription. Subscriptions are still accepted, there's just nothing to send, so UpnpAcceptSubscription is never called. As a result, the subscription is never marked as "active" via the genaInitNotify functions. A best course of action would be to modify UpnpAcceptSubscription<...> functions so that they can accept *no* initial state information, but can still result in the subscription being marked as active. Technically, then, the "active" flag should be set here, not in the genaInitNotify<...> functions. But the UpnpAccept functions don't muck with the subscription table, and it's more work than it's worth to move that code from the gena fucntions to the upnpapi functions. So--- what I've done to correct this problem is to modify both UpnpAcceptSubscription<...> functions (in upnppapi.c) to accept an empty state list and still call the gena layer functions. The gena layer genaInitNotify<...> functions (gena_device.c) then mark the subscription as "active" *before* checking for an empty state set. In genaInitNotify, a check for "var_count <= 0" is added immediately after the "subs->active = 1;" line. If this occurs, then all cleanup is performed and the function returns GENA_SUCCESS (since now, an empty state list is not an error). The same check is made for "PropSet == 0" in genaInitNotifyExt (just after the "subs->active = 1;" line). I've modifified my proxy layer to call UpnpAcceptSubscriptionExt even when there is no state data to send. With the suggested changes to gena_device.c, later state changes are sent correctly. This has solved my problem. 2008-04-28 Marcelo Jimenez * Fix in function SetSeed() in threadutil/src/ThreadPool.c for CYGWIN compilation. Thanks to Gary Chan. ******************************************************************************* Version 1.6.6 ******************************************************************************* 2008-04-24 Marcelo Jimenez * Added thread id's to the UpnpPrintf debug messages. Thanks to Charles Nepveu for the idea. 2008-04-24 Marcelo Jimenez * SF Bug Tracker [ 1948586 ] Uppercase U in in "xmlns:U" in Invoke Action causes seg. f. Submitted By: Thomas Norheim - kjakan_no Device no longer segfaults with the following malformed xml action: 2 2008-04-23 Marcelo Jimenez * Use -O0 in debug builds so that variables do not get optimized out. 2008-04-10 Marcelo Jimenez * Apostolos Syropoulos changes for OpenSolaris x86. 2008-03-20 Marcelo Jimenez * Andre Sodermans (wienerschnitzel) patch for building libupnp under windows systems with VC9. 2008-03-20 Marcelo Jimenez * Andre Sodermans (wienerschnitzel) patch for building libupnp under windows systems with VC8. 2008-03-08 Marcelo Jimenez * Fixed a printf format problem on the upnp_tv_device.c from both upnp/sample/tvdevie and upnp/sample/tvcombo directories. The variable port was a short int instead of an unsigned short and it was beeing print as a negative value. 2008-03-08 Marcelo Jimenez * SF Bug Tracker [ 1902668 ] Cannot compile on MSVC Submitted By Luke Kim - nereusuj Version 1.6.5 cannot be compiled because of some changes in 1.6.3. MSVC does not support stdint.h, gettimeofday(), sys/param.h, const int variables in array size and Windows does not define _WINDOWS_ but define _WINDOWS. * MSVC does not understand "const int"'s as declarators of array dimensions, we must use #define'd constants. * Use WIN32 instead of _WINDOWS_ or _WINDOWS. 2008-02-22 Marcelo Jimenez * No longer ignore "upnp:rootdevice" advertisement. Thanks to Bob Ciora. 2008-02-10 Marcelo Jimenez * Changed "sys_errlist[errno]", which is deprecated, by "strerror_r()", which is thread safe. 2008-02-06 Marcelo Jimenez * Slightly improved error report by showing the sys_errlist string corresponding to errno. 2008-02-06 Marcelo Jimenez * Got rid of two useless constants: UPNP_SOCKETERROR and UPNP_INVALID_SOCKET. They both mean the same, that a network API function has failed. -1 is the value to check, not an invented constant. ******************************************************************************* Version 1.6.5 ******************************************************************************* 2008-02-02 Marcelo Jimenez * Peter Hartley's fix for wrong sized variable beeing passed to http_MakeMessage() on 64 bit architectures. ******************************************************************************* Version 1.6.4 ******************************************************************************* 2008-01-23 Marcelo Jimenez * Workaround for a problem with the new automake AM_CONDITIONAL macro from autotools-1.10. Thanks to Ingo Hofmann for helping with debugging this one. 2008-01-22 Marcelo Jimenez * Added quoting to macros AC_CONFIG_AUX_DIR, AC_CONFIG_MACRO_DIR and AC_CONFIG_SRCDIR in configure.ac. Also changed the name of the auxiliary directory in AC_CONFIG_AUX_DIR to build-aux. 2008-01-22 Marcelo Jimenez * Fix for setsockopt() in Threadpool.c to allow more than one process to join the multicast-group on OSX. Thanks to Ingo Hofmann. 2008-01-22 Marcelo Jimenez * Using defined(__OSX__) || defined(__APPLE__) instead of just defined(__OSX__) in the code. Thanks to Ingo Hofmann and Chris Pickel. 2008-01-21 Marcelo Jimenez * Fix for isFileInVirtualDir. Thanks to Peter Hartley for the patch. 2008-01-07 Marcelo Jimenez * Putting back a "defined(__OSX__)" that has been removed in the previous *BSD patch. Thanks to Chris Pickel for pointing it out. 2008-01-07 Marcelo Jimenez * SF Patches Tracker [ 1865812 ] typo in docs comment Submitted By: Hartmut Holzgraefe - hholzgra typo in docs comment ACCAPTED instead of ACCEPTED in @name UPNP_E_UNSUBSCRIBE_UNACCAPTED [-302] Also, the documentation file name was mispelled and was corrected in the Makefile.am. ******************************************************************************* Version 1.6.3 ******************************************************************************* 2007-12-25 Marcelo Jimenez * Using pthread flags for the whole project, not just at the places individually indicated by several Makefile.am files spread all over the directories. That was too much error prone. 2007-12-24 Marcelo Jimenez * Added a configure test to check if pthread_rwlock_t is available. Define _GNU_SOURCE if needed. The fallback behaviou will only be implemented if _GNU_SOURCE prooves to be insufficient on some platforms. Thanks to Jonathan Casiot (no_dice) and Robert Gingher (robsbox). 2007-12-17 Marcelo Jimenez * Removed unused iasnprintf.{c,h} files. 2007-12-17 Marcelo Jimenez * Removed STATSONLY() macro from ThreadPool.{c,h}. * Removed time() usage from ThreadPool.c. * Fixed STATS = 0 compilation. 2007-12-16 Marcelo Jimenez * Library was not compiling on FreeBSD 7. Code now no longer uses ftime(), using gettimeofday() instead. Thanks to Josh Carroll. ******************************************************************************* Version 1.6.2 ******************************************************************************* 2007-12-10 Marcelo Jimenez * Fixed a compilation error due to a missing #ifdef in upnp/src/genlib/miniserver/miniserver.c. Thanks to Eugene Christensen. 2007-11-12 Marcelo Jimenez * "make check" was failing because ixml/test/test_document.sh did not have the executable flag set. Thanks to Steve Bresson. 2007-11-12 Marcelo Jimenez * Fixed a memory leak in upnpapi.c to delete gMiniServerThreadPool in the call to UpnpFinish(). Thanks to Fabrice Fontaine. 2007-11-09 Marcelo Jimenez * Added a isleep() call to the error handler of select() in RunMiniServer(), so that it does not take 100% cpu in case select() fails repeatedly. ******************************************************************************* Version 1.6.1 ******************************************************************************* 2007-11-07 Marcelo Jimenez * SF Bug Tracker [ 1825278 ] AdvertiseAndReply sleeps with handle lock out Applied patch from Alex (afaucher) to change some write locks to read locks. 2007-11-06 Marcelo Jimenez * Adjusting libtool library numbers to reflect the last changes. 2007-11-06 Marcelo Jimenez * SF Bug Tracker [ 1825278 ] AdvertiseAndReply sleeps with handle lock out GlobalHndMutex, which was a mutex is now GlobalHndRWLock, which is a rwlock. HandleLock() is mapped to HandleWriteLock() while all other instances have not been checked. One instance in AdvertiseAndReply() has been changed to HandleReadLock(). Thanks to Alex (afaucher) for the bug report and suggestions. 2007-11-06 Marcelo Jimenez * Added support for rwlocks. 2007-11-05 Marcelo Jimenez * SF Bug Tracker [ 1825929 ] woker thread still alive after UpnpFinish() Submitted By: Luke Kim - nereusuj Worker thread still alive after calling UpnpFinish() because ThreadPoolShutdown() is in the #ifdef DEBUG block. 421 422 #ifdef DEBUG 423 ThreadPoolShutdown( &gSendThreadPool ); 424 ThreadPoolShutdown( &gRecvThreadPool ); 2007-08-28 Marcelo Jimenez * Changed the calls to virtualDirCallback.open(filename, UPNP_WRITE) to (virtualDirCallback.open)(filename, UPNP_WRITE) (notice the parenthesis) due to a change in glibc that produces compilation errors. 2007-08-28 Marcelo Jimenez * Initialization of the "randomness" struct so that valgrind does not complain. 2007-08-06 Marcelo Jimenez * Merge of patch submitted By Keith Brindley - brindlk SF Bug Tracker [ 1762758 ] Seek not working for large files Problem: Requests from the uPnP client to seek to a position beyond 2GB in a large file are handled as a request to see from the 2GB point. Impact: Varies depending on client. The Xbox 360 kills the connection when it realises. Solution: GetNextRange function (webserver.c) is updated to handle large file sizes. Fix should also recognise when built on a 32bit platform rather than 64 and handle accordingly. 2007-08-05 Marcelo Jimenez * Merge of Mac OS X patch from Stéphane Corthésy (davelopper), SF Bug Tracker [ 1686420 ] Modifications for MacOSX. Some of the proposed changes were already done by Rene Hexel's patch. ******************************************************************************* Version 1.6.0 ******************************************************************************* 2007-06-10 Marcelo Jimenez * More fixes to Mac OS X and NetBSD from Rene Hexel: [pupnp-devel] NetBSD & Mac OS X packages and patches Okay, I found a couple more things. I have attached a patch file against the trunk (version 206) that make the repository code compile and run on both Mac OS X and NetBSD. This fixes the following issues: upnp/src/api/upnpapi.c: SIOCGIFCONF didn't work properly, use getifaddrs() instead (on BSD systems). threadutil/src/ThreadPool.c: priorities only work if _POSIX_PRIORITY_SCHEDULING is defined (and greater than 0). threadutil/src/LinkedList.c and threadutil/src/iasnprintf.c: use stdlib.h instead of malloc.h on all BSD systems (not just FreeBSD). This is important, because malloc.h does not exist on Darwin/Mac OS X. Cheers , Rene 2007-06-09 Marcelo Jimenez * [pupnp-devel] NetBSD & Mac OS X packages and patches. Rene Hexel's patch to compile in NetBSD and Mac OS X. 2007-05-26 Marcelo Jimenez * Updated the macro files acx_pthread.m4, ax_cflags_gcc_option.m4, ax_cflags_warn_all.m4, m4/ax_cflags_warn_all_ansi.m4, m4/type_socklen_t.m4. 2007-05-26 Marcelo Jimenez * Fixed an issue with the instalation of the file upnpdebug.h. Since the last modifications that removed the macro DEBUV_ONLY, this file must be installed even on a non-debug build. 2007-05-26 Marcelo Jimenez * SF Bug Tracker [ 1711325 ] Bad DestAddr in Upnp_Discovery structure Submitted By: Bob Ciora The field DestAddr of the structure Upnp_Discovery is now a full SOCKADDRIN instead of a pointer to SOCKADDRIN. Commented code sugests that in a previous moment, the function ssdp_handle_ctrlpt_msg() did not use a postponed thread to call ctrlpt_callback(). Now the code uses a thread, and most probably the original data would get lost and the pointer would point to an invalid memory region. This fix caused an interface change in the library and the minor library version was bumped. Also, the libtool library numbers were changed accordingly. ******************************************************************************* Version 1.4.7 ******************************************************************************* 2007-05-26 Marcelo Jimenez * Added support for the Basic Device (http://www.upnp.org/standardizeddcps/basic.asp) as suggested by Titus Winters. 2007-05-25 Marcelo Jimenez * Fixed the file libupnp.pc.in to generate a correct path for the include files. 2007-05-25 Marcelo Jimenez * Removing the Dbg_Level, InitLog, SetLogFileNames and CloseLog defines. These were just aliases, no reason to keep them. 2007-05-25 Marcelo Jimenez * Changed the comments of the include files that expose the UPnP API to use only C89 comments and no C99 comments. 2007-05-24 Nektarios K. Papadopoulos * Added tvcombo sample that demonstrates coexistence of a device and a control point in the same application. 2007-05-24 Nektarios K. Papadopoulos * SF Tracker FR [ 1570020 ]. * Enable both device and control point in the same application. Resolve deadlock in the SSDP processing threads. * Fix Threadpool expansion condition. Thanks to Siva Chandran P. for the original patch. 2007-05-24 Nektarios K. Papadopoulos * Modified tvdevice (control and picture) service descriptions to make compatible with WinXP/IE control point. 'in' arguments must appear before 'out' arguments in argument list. Thanks to Martin Tremblay for pointing out the solution originally provided by MORIOKA Yasuhiro. 2007-05-21 Marcelo Jimenez * More MSVC fixes, using XINLINE instead of inline, MSVC has troubles with inline. Thanks to David Maass for reporting. * Changed XINLINE to UPNP_INLINE. 2007-05-21 Marcelo Jimenez * Added the file build/inc/msvc/inttypes.h. This file is for use with MSVC only, because it does not provide C99 compatibility. 2007-05-18 Marcelo Jimenez * Removed all uses of the DEVICEONLY(x) macro. 2007-05-17 Marcelo Jimenez * Removed all uses of the DBGONLY(x) macro. A static inline empty function now is used and the compiler takes care of optimizing it out. 2007-05-17 Marcelo Jimenez * Fixed a bug in UpnpPrintf, function could call va_start() and return befor calling va_end(). 2007-05-15 Marcelo Jimenez * EXPORT_SPEC missing on some declarations in ixml/inc/ixml.h. Thanks to David Maass. 2007-05-15 Marcelo Jimenez * sizeof is unsigned, so %zu is more adequate than %zd. 2007-05-15 Marcelo Jimenez * Using an invented printf directive PRIzu that on MSVC expands to "lu", and on normal C99 compilers expands to "zu". 2007-05-15 Marcelo Jimenez * Rewrote raw_find_str. Now it no longer uses strcasestr(), but it transforms the first input buffer into lowercase. 2007-05-08 Marcelo Jimenez * Fix for debug printf format strings. size_t are not expected in a string format like "%.*s". 2007-05-08 Marcelo Jimenez * Added inttypes.h as a header requirement in configure.ac. 2007-05-11 Marcelo Jimenez * Moved upnp_tv_ctrlpt and upnp_tv_device executables from folder upnp to folder upnp/sample. Moved folder upnp/sample/tvdevice/web to folder upnp/sample/web. This way, if someone compiles the tarball and executes upnp_tv_device from its creation directory, there will be no error -108 for not finding directory web. ******************************************************************************* Version 1.4.6 ******************************************************************************* 2007-04-19 Marcelo Jimenez * Fix for freebsd host_os in configure.ac. ******************************************************************************* Version 1.4.5 ******************************************************************************* 2007-04-19 Marcelo Jimenez * Case insensitive comparison in raw_find_str() (httpparser.c) as suggested by Craig Nelson in SF Tracker [ 1689382 ] DLINK DIR-625 patch. 2007-04-07 Nektarios K. Papadopoulos * Fix for a bug in makeAction where va_arg was beeing called one extra time. 2007-04-28 Marcelo Jimenez * SF Tracker [ 1703533 ] Patch to make it compile under FreeBSD Submitted By: Timothy Redaelli - drittz I made some patches to make it compile under FreeBSD using gethostbyaddr_r when supported. 2007-04-28 Marcelo Jimenez * [pupnp-devel] Type mixup on x86_64 causes UPNP_E_OUTOF_MEMORY Submitted By: Glen Masgai after an UpnpSendActionAsync() for example, i get UPNP_E_OUTOF_MEMORY in the callback using 1.4.4 on a x86_64 system. This happens in http_MakeMessage(), which in some cases get called with wrong types (int instead of size_t) in combination with format "b" and "Q". The attached patch should fix this. ******************************************************************************* Version 1.4.4 ******************************************************************************* 2007-04-06 Marcelo Jimenez * SF Tracker [ 1695399 ] Typo in util.h Submitted By: Luke Kim - nereusuj Unix sleep is in seconds but WIN32 Sleep is in milliseconds. 2007-04-17 Marcelo Jimenez * SF Tracker [ 1652827 ] UpnpRegisterRootDevice returned -104 Submitted By: Michael Andersen - miwer Issue was found to be related to sizeof (size_t) != sizeof (int) on AMD64 systems. Emil Ljungdahl's AMD64 patch has been applied along with some other fixes. Original user report follows: When I run upnpd I get the above mentioned error (UPNP_E_OUTOF_MEMORY). I've tried with 1.4.1 and 1.4.2-RC3, it's the same. I don't understand why, because I have plenty of RAM, and I even tried closing some applications, but it didn't help. $ upnpd eth1 br0 The following is logged in the /var/log/messages: Feb 6 01:33:47 server upnpd[6933]: Error registering the root device with descDocUrl: http://192.168.0.1:49152/gatedesc.xml Feb 6 01:33:47 server upnpd[6933]: UpnpRegisterRootDevice returned -104 I tried enabling debugging and it looks like it cannot allocate memory through the membuffer_append function. It's wierd because it's only a few bytes. Please note, that I enabled some extra debugging lines that were commented, in order to get more information. See attached files. ******************************************************************************* Version 1.4.3 ******************************************************************************* 2007-03-13 Marcelo Jimenez * SF Tracker [ 1663004 ] Compile on Cygwin Submitted By: Jon Foster - jongfoster This patch gives basic support for building under Cygwin - it compiles, links, and a simple UPnP device application can initialise. I'm not sure if it actually works yet, but this is definitely a step in the right direction. Patch is against the 1.4.1 release. Changes are: * threadutil/inc/ithread.h: Fix the ithread mutex support to use documented, portable APIs (if present) rather than the Non-Portable (_NP) ones it uses now. This is required because Cygwin implements only the portable API. * threadutil/src/ThreadPool.c: Fake SetPolicyType() to do nothing on Cygwin because otherwise it fails. Should probably investigate why it fails and add a proper implementation later. * upnp/src/api/upnpapi.c: On Cygwin, zero out the GlobalHndMutex structure before initialising it. Without this, the initialisation fails. This appears to be a bug in Cygwin. * upnp/src/genlib/net/uri/uri.c: Use gethostbyname() on Cygwin. 2007-03-05 Oxy * Code adapted and typedefs added to compile cleanly under Windows with Borland C++ Builder and MS Visual C++ 2007-03-03 Marcelo Jimenez * Fixed nasty segmentation fault bug on membuffer.c. ******************************************************************************* Version 1.4.2 ******************************************************************************* 2007-02-09 Marcelo Jimenez * 32/64 bits portability issues on *printf. Use %zd for size_t, and cast to (long long) for off_t. 2007-02-02 Marcelo Jimenez * Bumped the program version to 1.4.2 in config.ac. * Now requires autoconf 2.60. * Fixed docdir use. * Does not install the documentation by default. * Use dist-bzip2 to create a .bz2 distribution file. 2007-01-23 Marcelo Jimenez * SF Tracker [ 1634922 ] Support for large files (>= 2 GiB), part 2 Submitted By: Jonathan Casiot - no_dice Summary: This patch hopefully fixes the remaining types and related code to enable files >= 2 GiB to be streamed. Jonathan claims to have tested this with a patched version of ushare-0.9.8 and a D-Link DSM-520. 2007-01-09 Marcelo Jimenez * SF Tracker [ 1628629 ] Multicast interface patch Submitted By: Fredrik Svensson - svefredrik This patch fixes two problems: 1) Specify the IP address for the interface when we do setsockopt IP_ADD_MEMBERSHIP. This makes it possible to run when no default router has been configured. 2) Explicitly set the multicast interface through setsockopt IP_MULTICAST_IF. Avoids socket error -207 in some cases. * SF Tracker [ 1628590 ] XML parsing segfault patch Submitted By: Fredrik Svensson - svefredrik This patch fixes a segmentation fault problem that occurrs when parsing XML code than some routers produce. 2007-01-06 Marcelo Jimenez * SF Tracker [ 1628552 ] XML white space patch Submitted By: Fredrik Svensson - svefredrik * SF Tracker [ 1628562 ] Maximum total jobs patch Submitted By: Fredrik Svensson - svefredrik Also, I incremented the libray versions and included some comments in the file configure.ac so that we do not bump the library version excessively, only the necessary numbers on the next release. * SF Tracker [ 1628575 ] Linksys WRT54G patch Submitted By: Fredrik Svensson - svefredrik * SF Tracker [ 1628636 ] SSDP packet copy patch Submitted By: Fredrik Svensson - svefredrik Changed NUM_COPY to 1 since, according to section 9.2 of the HTTPU/MU spec, we should never send more than one copy of a reply to an SSDP request. Ref. section 9.2 of http://www.upnp.org/download/draft-goland-http-udp-04.txt 2006-12-23 Marcelo Jimenez * Thorough revision of every call of http_MakeMessage() due to a bug introduced in rev.79 "largefile patch added". http_MakeMessage() has a worst than brain damaged "printf" like interface. In rev.79, the "N" format parameter must be an off_t. Every call of this function with an "N" format parameter and an int passed on the stack would fail terribly. * SF Bug tracker [ 1590469 ] Typo in ixmlparser.c Submitted By: Erik Johansson - erijo * SF Bug Tracker [ 1590466 ] Invalid xml output Submitted By: Erik Johansson - erijo * SF Patch tracker [ 1581161 ] VStudio2005 patch Submitted By: David Maass - darkservant * SF Patch tracker [ 1587272 ] const-ified ixml Submitted By: Erik Johansson * Finished const-ifications as suggested by Erik Johansson in SF Patch tracker [ 1587272 ]. 2006-07-05 Nektarios K. Papadopoulos * [bug-id] 1580440 [submitted-by] Erik Johansson - erijo [patched-by] Erik Johansson - erijo The SOAP HTTP message that's generated on upnp errors is missing a \r\n\ between header and body. 2006-07-07 Oxy * support for large files (>2 GBytes) added ******************************************************************************* Version 1.4.1 ******************************************************************************* 2006-07-07 Oxy * full support for Windows added, static library and DLL are fully working, code compiles with Borland Builder C++ and MS Visual C/C++ 2006-07-05 Nektarios K. Papadopoulos * Include prebuilt documentation (html,pdf), dropping doc++ dependancy. 2006-07-03 Marcelo Jimenez * Patch for FreeBSD, thanks to Markus Strobl. 2006-06-26 Marcelo Jimenez * Fix for missing "else" in httpreadwrite.c. Thanks to npapadop for the patch. 2006-06-26 Marcelo Jimenez * Fix for va_list initialization in x86_64 architectures. 2006-06-08 Oxy * Patch to fix memory leaks and reasons for crashes added (thanks to loigu) ******************************************************************************* Version 1.4.0 ******************************************************************************* 2006-05-26 Oxy * defines in iasnprintf.h changed to work with GCC-version < 3 2006-05-22 Oxy * BSD-patch added (not tested yet on an BSD system) 2006-05-19 Oxy * Patch added for bug: ixml parser colapsed on empty args (arg="") 2006-05-18 Oxy * DSM-320 patch added (fetched from project MediaTomb) * httpGet additons atch added, Added proxy support by introducing UpnpOpenHttpGetProxy. UpnpOpenHttpGet now just calls UpnpOpenHttpGetProxy with the proxy url set to NULL. * Bugfix for typo ("\0" / "0") in ixmlparser.c * Bugfix for M-Search packet ******************************************************************************* FORK FROM DEAD libupnp ******************************************************************************* 2006-04-29 Rémi Turboult * THANKS: new file with list of contributors * upnp/src/gena/gena_device.c (respond_ok): add 'Content-Length: 0' in subscription response. Patch by Chaos (Bug # 1455367). 2006-04-08 Rémi Turboult * upnp/doc/UPnP_Programming_Guide.pdf: replace this document with the one in libupnp-doc-1.2.1 because current CVS version was corrupted. 2006-04-06 * changes applied to several files to work under Sparc Solaris, temporarily requiring a define SPARC_SOLARIS 2006-04-03 Rémi Turboult * upnp/Makefile.am: install upnp samples in $(docdir)/examples 2006-03-28 Rémi Turboult * configure.ac: add --with-docdir option to choose where documentation is installed (or -without-docdir to not install the documentation) 2006-03-27 Rémi Turboult * ixml/test: add simple test suite for xml parser 2006-03-26 Rémi Turboult * ixml/src/ixmlparser.c (Parser_processCDSect): fix bug which prevents CDATA sections which contain a 0 (zero) to be parsed (instead the parsing of the whole document is aborted). Patch by Arno Willig (Patch # 1432124). * configure.ac, upnp/Makefile.am: add "--disable-samples" configure option, and move samples compilation from check_PROGRAMS to noinst_PROGRAMS 2006-03-25 Rémi Turboult * upnp/src/genlib/miniserver/miniserver.c (get_miniserver_sockets): fix bug if new socket created has fd 0 (can only occur when stdin has been closed). Patch by Oskar Liljeblad 2004-07-02 : http://sourceforge.net/mailarchive/message.php?msg_id=8870528 2006-03-21 Rémi Turboult * upnp/test/test_init.c: add some version checks and exit if failure 2006-03-05 Rémi Turboult * libupnp version 1.3.1 * upnp/inc/upnpconfig.h.in: add new define UPNP_VERSION_PATCH * upnp/test/test_init.c: add simple test to run during checks * upnp/inc/upnp.h: include "upnpdebug.h" only if debug enabled in the library (else header file is not installed) * upnp/Makefile.am (libupnp_la_LDFLAGS): add inter-library libtool dependencies between upnp and ixml / threadutil, so that programs linking against upnp only still work. 2006-03-04 Rémi Turboult * libupnp version 1.3.0 2006-03-03 Rémi Turboult * upnp/src/genlib/net/http/httpreadwrite.c (get_sdk_info): use package version string from configure to set sdk info * upnp/Makefile.am: add sample/tvdevice/web/ files in EXTRA_DIST + do not distribute generated upnpconfig.h file. 2006-02-28 Rémi Turboult * upnp/src/inc/config.h, configure.ac: use only new defines UPNP_HAVE_xx instead of INCLUDE_yyy_APIS and INTERNAL_WEB_SERVER * upnp/Makefile.am, ixml/Makefile.am: add -export-symbols-regex to the librarie LDFLAGS in order to export only the symbols defined in the API 2006-02-27 Rémi Turboult * configure.ac: add libtool versions for the 3 libraries * ixml/src/ixml.c (copy_with_escape): add missing 'static' to function * threadutil/src/ThreadPool.c (SetSeed): add missing 'static' 2006-02-26 Rémi Turboult * threadutil/inc/iasnprintf.h: add gcc __printf__ format attribute to "iasnprintf" * upnp/src/api/upnpapi.c: fix invalid UpnpPrintf formats * upnp/src/gena/gena_device.c: fix invalid UpnpPrintf formats * upnp/src/inc/config.h: move upnp/inc/config.h to internal sources (this file is no longer installed with the libraries) * upnp/inc/upnpdebug.h: new file created from debug definitions previously in upnp/inc/config.h * upnp/src/api/config.c: rename to upnp/src/api/upnpdebug.c * upnp/inc/upnpconfig.h.in: new file to contain information on the configuration of the installed libraries (generates installed file ) 2006-02-22 Rémi Turboult * upnp/ : add missing include of config.h in some .c files 2006-02-21 Rémi Turboult * upnp/inc/upnp.h: move some definitions which should not be exported into "upnp/src/inc/util.h" * import all modifications below from libupnp in djmount 0.51 into official libupnp 2006-01-17 Rémi Turboult * threadutil/Makefile.am (libthreadutil_la_SOURCES): remove extraneous file 2006-01-15 Rémi Turboult * configure.ac: add checks for large-file support * upnp/inc/config.h: rename to "upnpconfig.h". The new "config.h" file is the one generated by autoconf. * m4/type_socklen_t.m4: added new check for socklen_t (fallback to int if not defined) * upnp/src/genlib/miniserver/miniserver.c, upnp/src/ssdp/ssdp_server.c: use socklen_t where appropriate (instead of int) * upnp/src/genlib/net/http/httpreadwrite.c (get_sdk_info): remove XINLINE declaration (unused and too late) * ixml/src/node.c (ixmlNode_getNodeType): fix compilation warning on const return type 2006-01-12 Rémi Turboult * upnp/src/inc/readwrite.h : suppress unused C++ header file 2006-01-11 Rémi Turboult * upnp/inc/config.h, upnp/src/inc/upnpapi.h, upnp/src/inc/httpreadwrite.h: remove internal configuration variable MINIMUM_DELAY (no clear purpose) 2005-12-05 Rémi Turboult * upnp/inc/upnp.h: re-declare obsolete method UpnpSetContentLength, for binary compatibility with previous libupnp version. * upnp/src/api/upnpapi.c: correct type of g_maxContentLength to size_t 2005-11-01 Rémi Turboult * autoconfiscate library : replace all makefiles by Makefile.am for automake support, + preliminary autoconf support (generated config.h not yet used in source files) 2005-10-18 Rémi Turboult * upnp/src/makefile: fix location of DEBUG STATIC libupnp library * upnp/sample/tvctrlpt/linux/Makefile, upnp/sample/tvdevice/linux/Makefile: fix STATIC library support 2005-10-16 Rémi Turboult * threadutil/src/Makefile (clean): remove built library 2005-08-28 Rémi Turboult * ixml/src/ixml.h, ixml/src/ixml.c (ixmlRelaxParser) : new function * ixml/src/ixmlparser.h, ixml/src/ixmlparser.c (Parser_setErrorChar) : new function 2005-08-02 Rémi Turboult * ixml/src/Makefile: correct bug for static library being incorrectly stripped when building non-debug 2005-06-09 Rémi Turboult * ixml/src/element.c (ixmlElement_removeAttributeNode): remove some compilation warning * ixml/inc/ixml.h, ixml/src/document.c : add some missing const's in public API * upnp/inc/upnptools.h, upnp/src/api/upnptools.c : add missing const's in public API 2005-05-28 Rémi Turboult * upnp/inc/config.h: suppress HTTP_READ_BYTES (unused) and replace by DEFAULT_SOAP_CONTENT_LENGTH (previously in upnpapi.h) * upnp/inc/upnp.h, upnp/src/api/upnpapi.c : replace UpnpSetContentLength (which was not using its Handle argument) by global function UpnpSetMaxContentLength. Remove "hard" limitation to 32K (not suitable for using in UPnP AV). * upnp/src/inc/upnpapi.h : removed DEFAULT_SOAP_CONTENT_LENGTH (moved to config.h) and MAX_SOAP_CONTENT_LENGTH (now unused) * upnp/src/api/upnptools.c : add more error message strings * upnp/src/genlib/net/http/httpreadwrite.c : return OUTOF_BOUNDS instead of BAD_HTTPMSG when allowed Content Length is exceeded. * upnp/src/genlib/net/http/httpreadwrite.c : corrected an incorrect sprintf format 2005-05-27 Rémi Turboult * upnp/makefile, upnp/src/makefile, ixml/Makefile, ixml/src/Makefile, threadutil/Makefile, threadutil/src/Makefile : implement STATIC library support (from patch at http://sourceforge.net/tracker/?group_id=7189&atid=307189 ) 2005-05-26 Rémi Turboult * upnp/src/api/upnpapi.c, upnp/src/soap/soap_device.c, upnp/src/soap/makefile : corrections for compilation with CLIENT=1 only * importing "libupnp-1.2.1a" as baseline pupnp-release-1.8.0/Doxyfile000066400000000000000000001457221303304015100160070ustar00rootroot00000000000000# Doxyfile 1.5.2 # This file describes the settings to be used by the documentation system # doxygen (www.doxygen.org) for a project # # All text after a hash (#) is considered a comment and will be ignored # The format is: # TAG = value [value, ...] # For lists items can also be appended using: # TAG += value [value, ...] # Values that contain spaces should be placed between quotes (" ") #--------------------------------------------------------------------------- # Project related configuration options #--------------------------------------------------------------------------- # This tag specifies the encoding used for all characters in the config file that # follow. The default is UTF-8 which is also the encoding used for all text before # the first occurrence of this tag. Doxygen uses libiconv (or the iconv built into # libc) for the transcoding. See http://www.gnu.org/software/libiconv for the list of # possible encodings. DOXYFILE_ENCODING = UTF-8 # The PROJECT_NAME tag is a single word (or a sequence of words surrounded # by quotes) that should identify the project. PROJECT_NAME = libUPnP # The PROJECT_NUMBER tag can be used to enter a project or revision number. # This could be handy for archiving the generated documentation or # if some version control system is used. PROJECT_NUMBER = 1.8.0 # The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) # base path where the generated documentation will be put. # If a relative path is entered, it will be relative to the location # where doxygen was started. If left blank the current directory will be used. OUTPUT_DIRECTORY = docs/doxygen # If the CREATE_SUBDIRS tag is set to YES, then doxygen will create # 4096 sub-directories (in 2 levels) under the output directory of each output # format and will distribute the generated files over these directories. # Enabling this option can be useful when feeding doxygen a huge amount of # source files, where putting all generated files in the same directory would # otherwise cause performance problems for the file system. CREATE_SUBDIRS = NO # The OUTPUT_LANGUAGE tag is used to specify the language in which all # documentation generated by doxygen is written. Doxygen will use this # information to generate all constant output in the proper language. # The default language is English, other supported languages are: # Afrikaans, Arabic, Brazilian, Catalan, Chinese, Chinese-Traditional, # Croatian, Czech, Danish, Dutch, Finnish, French, German, Greek, Hungarian, # Italian, Japanese, Japanese-en (Japanese with English messages), Korean, # Korean-en, Lithuanian, Norwegian, Polish, Portuguese, Romanian, Russian, # Serbian, Slovak, Slovene, Spanish, Swedish, and Ukrainian. OUTPUT_LANGUAGE = English # If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will # include brief member descriptions after the members that are listed in # the file and class documentation (similar to JavaDoc). # Set to NO to disable this. BRIEF_MEMBER_DESC = YES # If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend # the brief description of a member or function before the detailed description. # Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the # brief descriptions will be completely suppressed. REPEAT_BRIEF = YES # This tag implements a quasi-intelligent brief description abbreviator # that is used to form the text in various listings. Each string # in this list, if found as the leading text of the brief description, will be # stripped from the text and the result after processing the whole list, is # used as the annotated text. Otherwise, the brief description is used as-is. # If left blank, the following values are used ("$name" is automatically # replaced with the name of the entity): "The $name class" "The $name widget" # "The $name file" "is" "provides" "specifies" "contains" # "represents" "a" "an" "the" ABBREVIATE_BRIEF = # If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then # Doxygen will generate a detailed section even if there is only a brief # description. ALWAYS_DETAILED_SEC = YES # If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all # inherited members of a class in the documentation of that class as if those # members were ordinary class members. Constructors, destructors and assignment # operators of the base classes will not be shown. INLINE_INHERITED_MEMB = NO # If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full # path before files name in the file list and in the header files. If set # to NO the shortest path that makes the file name unique will be used. FULL_PATH_NAMES = YES # If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag # can be used to strip a user-defined part of the path. Stripping is # only done if one of the specified strings matches the left-hand part of # the path. The tag can be used to show relative paths in the file list. # If left blank the directory from which doxygen is run is used as the # path to strip. STRIP_FROM_PATH = # The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of # the path mentioned in the documentation of a class, which tells # the reader which header file to include in order to use a class. # If left blank only the name of the header file containing the class # definition is used. Otherwise one should specify the include paths that # are normally passed to the compiler using the -I flag. STRIP_FROM_INC_PATH = # If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter # (but less readable) file names. This can be useful is your file systems # doesn't support long names like on DOS, Mac, or CD-ROM. SHORT_NAMES = NO # If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen # will interpret the first line (until the first dot) of a JavaDoc-style # comment as the brief description. If set to NO, the JavaDoc # comments will behave just like the Qt-style comments (thus requiring an # explicit @brief command for a brief description. JAVADOC_AUTOBRIEF = NO # The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen # treat a multi-line C++ special comment block (i.e. a block of //! or /// # comments) as a brief description. This used to be the default behaviour. # The new default is to treat a multi-line C++ comment block as a detailed # description. Set this tag to YES if you prefer the old behaviour instead. MULTILINE_CPP_IS_BRIEF = NO # If the DETAILS_AT_TOP tag is set to YES then Doxygen # will output the detailed description near the top, like JavaDoc. # If set to NO, the detailed description appears after the member # documentation. DETAILS_AT_TOP = NO # If the INHERIT_DOCS tag is set to YES (the default) then an undocumented # member inherits the documentation from any documented member that it # re-implements. INHERIT_DOCS = YES # If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce # a new page for each member. If set to NO, the documentation of a member will # be part of the file/class/namespace that contains it. SEPARATE_MEMBER_PAGES = NO # The TAB_SIZE tag can be used to set the number of spaces in a tab. # Doxygen uses this value to replace tabs by spaces in code fragments. TAB_SIZE = 8 # This tag can be used to specify a number of aliases that acts # as commands in the documentation. An alias has the form "name=value". # For example adding "sideeffect=\par Side Effects:\n" will allow you to # put the command \sideeffect (or @sideeffect) in the documentation, which # will result in a user-defined paragraph with heading "Side Effects:". # You can put \n's in the value part of an alias to insert newlines. ALIASES = # Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C # sources only. Doxygen will then generate output that is more tailored for C. # For instance, some of the names that are used will be different. The list # of all members will be omitted, etc. OPTIMIZE_OUTPUT_FOR_C = YES # Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java # sources only. Doxygen will then generate output that is more tailored for Java. # For instance, namespaces will be presented as packages, qualified scopes # will look different, etc. OPTIMIZE_OUTPUT_JAVA = NO # If you use STL classes (i.e. std::string, std::vector, etc.) but do not want to # include (a tag file for) the STL sources as input, then you should # set this tag to YES in order to let doxygen match functions declarations and # definitions whose arguments contain STL classes (e.g. func(std::string); v.s. # func(std::string) {}). This also make the inheritance and collaboration # diagrams that involve STL classes more complete and accurate. BUILTIN_STL_SUPPORT = NO # If you use Microsoft's C++/CLI language, you should set this option to YES to # enable parsing support. CPP_CLI_SUPPORT = NO # If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC # tag is set to YES, then doxygen will reuse the documentation of the first # member in the group (if any) for the other members of the group. By default # all members of a group must be documented explicitly. DISTRIBUTE_GROUP_DOC = NO # Set the SUBGROUPING tag to YES (the default) to allow class member groups of # the same type (for instance a group of public functions) to be put as a # subgroup of that type (e.g. under the Public Functions section). Set it to # NO to prevent subgrouping. Alternatively, this can be done per class using # the \nosubgrouping command. SUBGROUPING = YES #--------------------------------------------------------------------------- # Build related configuration options #--------------------------------------------------------------------------- # If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in # documentation are documented, even if no documentation was available. # Private class members and static file members will be hidden unless # the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES EXTRACT_ALL = NO # If the EXTRACT_PRIVATE tag is set to YES all private members of a class # will be included in the documentation. EXTRACT_PRIVATE = YES # If the EXTRACT_STATIC tag is set to YES all static members of a file # will be included in the documentation. EXTRACT_STATIC = YES # If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) # defined locally in source files will be included in the documentation. # If set to NO only classes defined in header files are included. EXTRACT_LOCAL_CLASSES = YES # This flag is only useful for Objective-C code. When set to YES local # methods, which are defined in the implementation section but not in # the interface are included in the documentation. # If set to NO (the default) only methods in the interface are included. EXTRACT_LOCAL_METHODS = NO # If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all # undocumented members of documented classes, files or namespaces. # If set to NO (the default) these members will be included in the # various overviews, but no documentation section is generated. # This option has no effect if EXTRACT_ALL is enabled. HIDE_UNDOC_MEMBERS = NO # If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all # undocumented classes that are normally visible in the class hierarchy. # If set to NO (the default) these classes will be included in the various # overviews. This option has no effect if EXTRACT_ALL is enabled. HIDE_UNDOC_CLASSES = NO # If the HIDE_FRIEND_COMPOUNDS tag is set to YES, Doxygen will hide all # friend (class|struct|union) declarations. # If set to NO (the default) these declarations will be included in the # documentation. HIDE_FRIEND_COMPOUNDS = NO # If the HIDE_IN_BODY_DOCS tag is set to YES, Doxygen will hide any # documentation blocks found inside the body of a function. # If set to NO (the default) these blocks will be appended to the # function's detailed documentation block. HIDE_IN_BODY_DOCS = NO # The INTERNAL_DOCS tag determines if documentation # that is typed after a \internal command is included. If the tag is set # to NO (the default) then the documentation will be excluded. # Set it to YES to include the internal documentation. INTERNAL_DOCS = YES # If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate # file names in lower-case letters. If set to YES upper-case letters are also # allowed. This is useful if you have classes or files whose names only differ # in case and if your file system supports case sensitive file names. Windows # and Mac users are advised to set this option to NO. CASE_SENSE_NAMES = YES # If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen # will show members with their full class and namespace scopes in the # documentation. If set to YES the scope will be hidden. HIDE_SCOPE_NAMES = NO # If the SHOW_INCLUDE_FILES tag is set to YES (the default) then Doxygen # will put a list of the files that are included by a file in the documentation # of that file. SHOW_INCLUDE_FILES = YES # If the INLINE_INFO tag is set to YES (the default) then a tag [inline] # is inserted in the documentation for inline members. INLINE_INFO = YES # If the SORT_MEMBER_DOCS tag is set to YES (the default) then doxygen # will sort the (detailed) documentation of file and class members # alphabetically by member name. If set to NO the members will appear in # declaration order. SORT_MEMBER_DOCS = YES # If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the # brief documentation of file, namespace and class members alphabetically # by member name. If set to NO (the default) the members will appear in # declaration order. SORT_BRIEF_DOCS = NO # If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be # sorted by fully-qualified names, including namespaces. If set to # NO (the default), the class list will be sorted only by class name, # not including the namespace part. # Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES. # Note: This option applies only to the class list, not to the # alphabetical list. SORT_BY_SCOPE_NAME = NO # The GENERATE_TODOLIST tag can be used to enable (YES) or # disable (NO) the todo list. This list is created by putting \todo # commands in the documentation. GENERATE_TODOLIST = YES # The GENERATE_TESTLIST tag can be used to enable (YES) or # disable (NO) the test list. This list is created by putting \test # commands in the documentation. GENERATE_TESTLIST = YES # The GENERATE_BUGLIST tag can be used to enable (YES) or # disable (NO) the bug list. This list is created by putting \bug # commands in the documentation. GENERATE_BUGLIST = YES # The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or # disable (NO) the deprecated list. This list is created by putting # \deprecated commands in the documentation. GENERATE_DEPRECATEDLIST= YES # The ENABLED_SECTIONS tag can be used to enable conditional # documentation sections, marked by \if sectionname ... \endif. ENABLED_SECTIONS = # The MAX_INITIALIZER_LINES tag determines the maximum number of lines # the initial value of a variable or define consists of for it to appear in # the documentation. If the initializer consists of more lines than specified # here it will be hidden. Use a value of 0 to hide initializers completely. # The appearance of the initializer of individual variables and defines in the # documentation can be controlled using \showinitializer or \hideinitializer # command in the documentation regardless of this setting. MAX_INITIALIZER_LINES = 30 # Set the SHOW_USED_FILES tag to NO to disable the list of files generated # at the bottom of the documentation of classes and structs. If set to YES the # list will mention the files that were used to generate the documentation. SHOW_USED_FILES = YES # If the sources in your project are distributed over multiple directories # then setting the SHOW_DIRECTORIES tag to YES will show the directory hierarchy # in the documentation. The default is NO. SHOW_DIRECTORIES = YES # The FILE_VERSION_FILTER tag can be used to specify a program or script that # doxygen should invoke to get the current version for each file (typically from the # version control system). Doxygen will invoke the program by executing (via # popen()) the command , where is the value of # the FILE_VERSION_FILTER tag, and is the name of an input file # provided by doxygen. Whatever the program writes to standard output # is used as the file version. See the manual for examples. FILE_VERSION_FILTER = #--------------------------------------------------------------------------- # configuration options related to warning and progress messages #--------------------------------------------------------------------------- # The QUIET tag can be used to turn on/off the messages that are generated # by doxygen. Possible values are YES and NO. If left blank NO is used. QUIET = NO # The WARNINGS tag can be used to turn on/off the warning messages that are # generated by doxygen. Possible values are YES and NO. If left blank # NO is used. WARNINGS = YES # If WARN_IF_UNDOCUMENTED is set to YES, then doxygen will generate warnings # for undocumented members. If EXTRACT_ALL is set to YES then this flag will # automatically be disabled. WARN_IF_UNDOCUMENTED = YES # If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for # potential errors in the documentation, such as not documenting some # parameters in a documented function, or documenting parameters that # don't exist or using markup commands wrongly. WARN_IF_DOC_ERROR = YES # This WARN_NO_PARAMDOC option can be abled to get warnings for # functions that are documented, but have no documentation for their parameters # or return value. If set to NO (the default) doxygen will only warn about # wrong or incomplete parameter documentation, but not about the absence of # documentation. WARN_NO_PARAMDOC = NO # The WARN_FORMAT tag determines the format of the warning messages that # doxygen can produce. The string should contain the $file, $line, and $text # tags, which will be replaced by the file and line number from which the # warning originated and the warning text. Optionally the format may contain # $version, which will be replaced by the version of the file (if it could # be obtained via FILE_VERSION_FILTER) WARN_FORMAT = "$file:$line: $text" # The WARN_LOGFILE tag can be used to specify a file to which warning # and error messages should be written. If left blank the output is written # to stderr. WARN_LOGFILE = #--------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- # The INPUT tag can be used to specify the files and/or directories that contain # documented source files. You may enter file names like "myfile.cpp" or # directories like "/usr/src/myproject". Separate the files or directories # with spaces. INPUT = upnp ixml threadutil # This tag can be used to specify the character encoding of the source files that # doxygen parses. Internally doxygen uses the UTF-8 encoding, which is also the default # input encoding. Doxygen uses libiconv (or the iconv built into libc) for the transcoding. # See http://www.gnu.org/software/libiconv for the list of possible encodings. INPUT_ENCODING = UTF-8 # If the value of the INPUT tag contains directories, you can use the # FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp # and *.h) to filter out the source-files in the directories. If left # blank the following patterns are tested: # *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx # *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py FILE_PATTERNS = # The RECURSIVE tag can be used to turn specify whether or not subdirectories # should be searched for input files as well. Possible values are YES and NO. # If left blank NO is used. RECURSIVE = YES # The EXCLUDE tag can be used to specify files and/or directories that should # excluded from the INPUT source files. This way you can easily exclude a # subdirectory from a directory tree whose root is specified with the INPUT tag. EXCLUDE = # The EXCLUDE_SYMLINKS tag can be used select whether or not files or # directories that are symbolic links (a Unix filesystem feature) are excluded # from the input. EXCLUDE_SYMLINKS = NO # If the value of the INPUT tag contains directories, you can use the # EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude # certain files from those directories. Note that the wildcards are matched # against the file with absolute path, so to exclude all test directories # for example use the pattern */test/* EXCLUDE_PATTERNS = */.svn */.deps */.libs */test # The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names # (namespaces, classes, functions, etc.) that should be excluded from the output. # The symbol name can be a fully qualified name, a word, or if the wildcard * is used, # a substring. Examples: ANamespace, AClass, AClass::ANamespace, ANamespace::*Test EXCLUDE_SYMBOLS = # The EXAMPLE_PATH tag can be used to specify one or more files or # directories that contain example code fragments that are included (see # the \include command). EXAMPLE_PATH = # If the value of the EXAMPLE_PATH tag contains directories, you can use the # EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp # and *.h) to filter out the source-files in the directories. If left # blank all files are included. EXAMPLE_PATTERNS = # If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be # searched for input files to be used with the \include or \dontinclude # commands irrespective of the value of the RECURSIVE tag. # Possible values are YES and NO. If left blank NO is used. EXAMPLE_RECURSIVE = NO # The IMAGE_PATH tag can be used to specify one or more files or # directories that contain image that are included in the documentation (see # the \image command). IMAGE_PATH = # The INPUT_FILTER tag can be used to specify a program that doxygen should # invoke to filter for each input file. Doxygen will invoke the filter program # by executing (via popen()) the command , where # is the value of the INPUT_FILTER tag, and is the name of an # input file. Doxygen will then use the output that the filter program writes # to standard output. If FILTER_PATTERNS is specified, this tag will be # ignored. INPUT_FILTER = # The FILTER_PATTERNS tag can be used to specify filters on a per file pattern # basis. Doxygen will compare the file name with each pattern and apply the # filter if there is a match. The filters are a list of the form: # pattern=filter (like *.cpp=my_cpp_filter). See INPUT_FILTER for further # info on how filters are used. If FILTER_PATTERNS is empty, INPUT_FILTER # is applied to all files. FILTER_PATTERNS = # If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using # INPUT_FILTER) will be used to filter the input files when producing source # files to browse (i.e. when SOURCE_BROWSER is set to YES). FILTER_SOURCE_FILES = NO #--------------------------------------------------------------------------- # configuration options related to source browsing #--------------------------------------------------------------------------- # If the SOURCE_BROWSER tag is set to YES then a list of source files will # be generated. Documented entities will be cross-referenced with these sources. # Note: To get rid of all source code in the generated output, make sure also # VERBATIM_HEADERS is set to NO. SOURCE_BROWSER = NO # Setting the INLINE_SOURCES tag to YES will include the body # of functions and classes directly in the documentation. INLINE_SOURCES = NO # Setting the STRIP_CODE_COMMENTS tag to YES (the default) will instruct # doxygen to hide any special comment blocks from generated source code # fragments. Normal C and C++ comments will always remain visible. STRIP_CODE_COMMENTS = YES # If the REFERENCED_BY_RELATION tag is set to YES (the default) # then for each documented function all documented # functions referencing it will be listed. REFERENCED_BY_RELATION = YES # If the REFERENCES_RELATION tag is set to YES (the default) # then for each documented function all documented entities # called/used by that function will be listed. REFERENCES_RELATION = YES # If the REFERENCES_LINK_SOURCE tag is set to YES (the default) # and SOURCE_BROWSER tag is set to YES, then the hyperlinks from # functions in REFERENCES_RELATION and REFERENCED_BY_RELATION lists will # link to the source code. Otherwise they will link to the documentstion. REFERENCES_LINK_SOURCE = YES # If the USE_HTAGS tag is set to YES then the references to source code # will point to the HTML generated by the htags(1) tool instead of doxygen # built-in source browser. The htags tool is part of GNU's global source # tagging system (see http://www.gnu.org/software/global/global.html). You # will need version 4.8.6 or higher. USE_HTAGS = NO # If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen # will generate a verbatim copy of the header file for each class for # which an include is specified. Set to NO to disable this. VERBATIM_HEADERS = YES #--------------------------------------------------------------------------- # configuration options related to the alphabetical class index #--------------------------------------------------------------------------- # If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index # of all compounds will be generated. Enable this if the project # contains a lot of classes, structs, unions or interfaces. ALPHABETICAL_INDEX = NO # If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then # the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns # in which this list will be split (can be a number in the range [1..20]) COLS_IN_ALPHA_INDEX = 5 # In case all classes in a project start with a common prefix, all # classes will be put under the same header in the alphabetical index. # The IGNORE_PREFIX tag can be used to specify one or more prefixes that # should be ignored while generating the index headers. IGNORE_PREFIX = #--------------------------------------------------------------------------- # configuration options related to the HTML output #--------------------------------------------------------------------------- # If the GENERATE_HTML tag is set to YES (the default) Doxygen will # generate HTML output. GENERATE_HTML = YES # The HTML_OUTPUT tag is used to specify where the HTML docs will be put. # If a relative path is entered the value of OUTPUT_DIRECTORY will be # put in front of it. If left blank `html' will be used as the default path. HTML_OUTPUT = html # The HTML_FILE_EXTENSION tag can be used to specify the file extension for # each generated HTML page (for example: .htm,.php,.asp). If it is left blank # doxygen will generate files with .html extension. HTML_FILE_EXTENSION = .html # The HTML_HEADER tag can be used to specify a personal HTML header for # each generated HTML page. If it is left blank doxygen will generate a # standard header. HTML_HEADER = # The HTML_FOOTER tag can be used to specify a personal HTML footer for # each generated HTML page. If it is left blank doxygen will generate a # standard footer. HTML_FOOTER = # The HTML_STYLESHEET tag can be used to specify a user-defined cascading # style sheet that is used by each HTML page. It can be used to # fine-tune the look of the HTML output. If the tag is left blank doxygen # will generate a default style sheet. Note that doxygen will try to copy # the style sheet file to the HTML output directory, so don't put your own # stylesheet in the HTML output directory as well, or it will be erased! HTML_STYLESHEET = # If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes, # files or namespaces will be aligned in HTML using tables. If set to # NO a bullet list will be used. HTML_ALIGN_MEMBERS = YES # If the GENERATE_HTMLHELP tag is set to YES, additional index files # will be generated that can be used as input for tools like the # Microsoft HTML help workshop to generate a compressed HTML help file (.chm) # of the generated HTML documentation. GENERATE_HTMLHELP = NO # If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can # be used to specify the file name of the resulting .chm file. You # can add a path in front of the file if the result should not be # written to the html output directory. CHM_FILE = # If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can # be used to specify the location (absolute path including file name) of # the HTML help compiler (hhc.exe). If non-empty doxygen will try to run # the HTML help compiler on the generated index.hhp. HHC_LOCATION = # If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag # controls if a separate .chi index file is generated (YES) or that # it should be included in the master .chm file (NO). GENERATE_CHI = NO # If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag # controls whether a binary table of contents is generated (YES) or a # normal table of contents (NO) in the .chm file. BINARY_TOC = NO # The TOC_EXPAND flag can be set to YES to add extra items for group members # to the contents of the HTML help documentation and to the tree view. TOC_EXPAND = NO # The DISABLE_INDEX tag can be used to turn on/off the condensed index at # top of each HTML page. The value NO (the default) enables the index and # the value YES disables it. DISABLE_INDEX = NO # This tag can be used to set the number of enum values (range [1..20]) # that doxygen will group on one line in the generated HTML documentation. ENUM_VALUES_PER_LINE = 4 # If the GENERATE_TREEVIEW tag is set to YES, a side panel will be # generated containing a tree-like index structure (just like the one that # is generated for HTML Help). For this to work a browser that supports # JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+, # Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are # probably better off using the HTML help feature. GENERATE_TREEVIEW = NO # If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be # used to set the initial width (in pixels) of the frame in which the tree # is shown. TREEVIEW_WIDTH = 250 #--------------------------------------------------------------------------- # configuration options related to the LaTeX output #--------------------------------------------------------------------------- # If the GENERATE_LATEX tag is set to YES (the default) Doxygen will # generate Latex output. GENERATE_LATEX = YES # The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. # If a relative path is entered the value of OUTPUT_DIRECTORY will be # put in front of it. If left blank `latex' will be used as the default path. LATEX_OUTPUT = latex # The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be # invoked. If left blank `latex' will be used as the default command name. LATEX_CMD_NAME = latex # The MAKEINDEX_CMD_NAME tag can be used to specify the command name to # generate index for LaTeX. If left blank `makeindex' will be used as the # default command name. MAKEINDEX_CMD_NAME = makeindex # If the COMPACT_LATEX tag is set to YES Doxygen generates more compact # LaTeX documents. This may be useful for small projects and may help to # save some trees in general. COMPACT_LATEX = NO # The PAPER_TYPE tag can be used to set the paper type that is used # by the printer. Possible values are: a4, a4wide, letter, legal and # executive. If left blank a4wide will be used. PAPER_TYPE = a4wide # The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX # packages that should be included in the LaTeX output. EXTRA_PACKAGES = # The LATEX_HEADER tag can be used to specify a personal LaTeX header for # the generated latex document. The header should contain everything until # the first chapter. If it is left blank doxygen will generate a # standard header. Notice: only use this tag if you know what you are doing! LATEX_HEADER = # If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated # is prepared for conversion to pdf (using ps2pdf). The pdf file will # contain links (just like the HTML output) instead of page references # This makes the output suitable for online browsing using a pdf viewer. PDF_HYPERLINKS = YES # If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of # plain latex in the generated Makefile. Set this option to YES to get a # higher quality PDF documentation. USE_PDFLATEX = YES # If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode. # command to the generated LaTeX files. This will instruct LaTeX to keep # running if errors occur, instead of asking the user for help. # This option is also used when generating formulas in HTML. LATEX_BATCHMODE = NO # If LATEX_HIDE_INDICES is set to YES then doxygen will not # include the index chapters (such as File Index, Compound Index, etc.) # in the output. LATEX_HIDE_INDICES = NO #--------------------------------------------------------------------------- # configuration options related to the RTF output #--------------------------------------------------------------------------- # If the GENERATE_RTF tag is set to YES Doxygen will generate RTF output # The RTF output is optimized for Word 97 and may not look very pretty with # other RTF readers or editors. GENERATE_RTF = NO # The RTF_OUTPUT tag is used to specify where the RTF docs will be put. # If a relative path is entered the value of OUTPUT_DIRECTORY will be # put in front of it. If left blank `rtf' will be used as the default path. RTF_OUTPUT = rtf # If the COMPACT_RTF tag is set to YES Doxygen generates more compact # RTF documents. This may be useful for small projects and may help to # save some trees in general. COMPACT_RTF = NO # If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated # will contain hyperlink fields. The RTF file will # contain links (just like the HTML output) instead of page references. # This makes the output suitable for online browsing using WORD or other # programs which support those fields. # Note: wordpad (write) and others do not support links. RTF_HYPERLINKS = NO # Load stylesheet definitions from file. Syntax is similar to doxygen's # config file, i.e. a series of assignments. You only have to provide # replacements, missing definitions are set to their default value. RTF_STYLESHEET_FILE = # Set optional variables used in the generation of an rtf document. # Syntax is similar to doxygen's config file. RTF_EXTENSIONS_FILE = #--------------------------------------------------------------------------- # configuration options related to the man page output #--------------------------------------------------------------------------- # If the GENERATE_MAN tag is set to YES (the default) Doxygen will # generate man pages GENERATE_MAN = NO # The MAN_OUTPUT tag is used to specify where the man pages will be put. # If a relative path is entered the value of OUTPUT_DIRECTORY will be # put in front of it. If left blank `man' will be used as the default path. MAN_OUTPUT = man # The MAN_EXTENSION tag determines the extension that is added to # the generated man pages (default is the subroutine's section .3) MAN_EXTENSION = .3 # If the MAN_LINKS tag is set to YES and Doxygen generates man output, # then it will generate one additional man file for each entity # documented in the real man page(s). These additional files # only source the real man page, but without them the man command # would be unable to find the correct page. The default is NO. MAN_LINKS = NO #--------------------------------------------------------------------------- # configuration options related to the XML output #--------------------------------------------------------------------------- # If the GENERATE_XML tag is set to YES Doxygen will # generate an XML file that captures the structure of # the code including all documentation. GENERATE_XML = NO # The XML_OUTPUT tag is used to specify where the XML pages will be put. # If a relative path is entered the value of OUTPUT_DIRECTORY will be # put in front of it. If left blank `xml' will be used as the default path. XML_OUTPUT = xml # The XML_SCHEMA tag can be used to specify an XML schema, # which can be used by a validating XML parser to check the # syntax of the XML files. XML_SCHEMA = # The XML_DTD tag can be used to specify an XML DTD, # which can be used by a validating XML parser to check the # syntax of the XML files. XML_DTD = # If the XML_PROGRAMLISTING tag is set to YES Doxygen will # dump the program listings (including syntax highlighting # and cross-referencing information) to the XML output. Note that # enabling this will significantly increase the size of the XML output. XML_PROGRAMLISTING = YES #--------------------------------------------------------------------------- # configuration options for the AutoGen Definitions output #--------------------------------------------------------------------------- # If the GENERATE_AUTOGEN_DEF tag is set to YES Doxygen will # generate an AutoGen Definitions (see autogen.sf.net) file # that captures the structure of the code including all # documentation. Note that this feature is still experimental # and incomplete at the moment. GENERATE_AUTOGEN_DEF = NO #--------------------------------------------------------------------------- # configuration options related to the Perl module output #--------------------------------------------------------------------------- # If the GENERATE_PERLMOD tag is set to YES Doxygen will # generate a Perl module file that captures the structure of # the code including all documentation. Note that this # feature is still experimental and incomplete at the # moment. GENERATE_PERLMOD = NO # If the PERLMOD_LATEX tag is set to YES Doxygen will generate # the necessary Makefile rules, Perl scripts and LaTeX code to be able # to generate PDF and DVI output from the Perl module output. PERLMOD_LATEX = NO # If the PERLMOD_PRETTY tag is set to YES the Perl module output will be # nicely formatted so it can be parsed by a human reader. This is useful # if you want to understand what is going on. On the other hand, if this # tag is set to NO the size of the Perl module output will be much smaller # and Perl will parse it just the same. PERLMOD_PRETTY = YES # The names of the make variables in the generated doxyrules.make file # are prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. # This is useful so different doxyrules.make files included by the same # Makefile don't overwrite each other's variables. PERLMOD_MAKEVAR_PREFIX = #--------------------------------------------------------------------------- # Configuration options related to the preprocessor #--------------------------------------------------------------------------- # If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will # evaluate all C-preprocessor directives found in the sources and include # files. ENABLE_PREPROCESSING = YES # If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro # names in the source code. If set to NO (the default) only conditional # compilation will be performed. Macro expansion can be done in a controlled # way by setting EXPAND_ONLY_PREDEF to YES. MACRO_EXPANSION = YES # If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES # then the macro expansion is limited to the macros specified with the # PREDEFINED and EXPAND_AS_DEFINED tags. EXPAND_ONLY_PREDEF = NO # If the SEARCH_INCLUDES tag is set to YES (the default) the includes files # in the INCLUDE_PATH (see below) will be search if a #include is found. SEARCH_INCLUDES = YES # The INCLUDE_PATH tag can be used to specify one or more directories that # contain include files that are not input files but should be processed by # the preprocessor. INCLUDE_PATH = # You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard # patterns (like *.h and *.hpp) to filter out the header-files in the # directories. If left blank, the patterns specified with FILE_PATTERNS will # be used. INCLUDE_FILE_PATTERNS = # The PREDEFINED tag can be used to specify one or more macro names that # are defined before the preprocessor is started (similar to the -D option of # gcc). The argument of the tag is a list of macros of the form: name # or name=definition (no spaces). If the definition and the = are # omitted =1 is assumed. To prevent a macro definition from being # undefined via #undef or recursively expanded use the := operator # instead of the = operator. PREDEFINED = DEBUG UPNP_HAVE_TOOLS INCLUDE_DEVICE_APIS INCLUDE_CLIENT_APIS SCRIPTSUPPORT EXCLUDE_GENA=0 EXCLUDE_DOM=0 # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then # this tag can be used to specify a list of macro names that should be expanded. # The macro definition that is found in the sources will be used. # Use the PREDEFINED tag if you want to use a different macro definition. EXPAND_AS_DEFINED = # If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then # doxygen's preprocessor will remove all function-like macros that are alone # on a line, have an all uppercase name, and do not end with a semicolon. Such # function macros are typically used for boiler-plate code, and will confuse # the parser if not removed. SKIP_FUNCTION_MACROS = YES #--------------------------------------------------------------------------- # Configuration::additions related to external references #--------------------------------------------------------------------------- # The TAGFILES option can be used to specify one or more tagfiles. # Optionally an initial location of the external documentation # can be added for each tagfile. The format of a tag file without # this location is as follows: # TAGFILES = file1 file2 ... # Adding location for the tag files is done as follows: # TAGFILES = file1=loc1 "file2 = loc2" ... # where "loc1" and "loc2" can be relative or absolute paths or # URLs. If a location is present for each tag, the installdox tool # does not have to be run to correct the links. # Note that each tag file must have a unique name # (where the name does NOT include the path) # If a tag file is not located in the directory in which doxygen # is run, you must also specify the path to the tagfile here. TAGFILES = # When a file name is specified after GENERATE_TAGFILE, doxygen will create # a tag file that is based on the input files it reads. GENERATE_TAGFILE = # If the ALLEXTERNALS tag is set to YES all external classes will be listed # in the class index. If set to NO only the inherited external classes # will be listed. ALLEXTERNALS = NO # If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed # in the modules index. If set to NO, only the current project's groups will # be listed. EXTERNAL_GROUPS = YES # The PERL_PATH should be the absolute path and name of the perl script # interpreter (i.e. the result of `which perl'). PERL_PATH = /usr/bin/perl #--------------------------------------------------------------------------- # Configuration options related to the dot tool #--------------------------------------------------------------------------- # If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will # generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base # or super classes. Setting the tag to NO turns the diagrams off. Note that # this option is superseded by the HAVE_DOT option below. This is only a # fallback. It is recommended to install and use dot, since it yields more # powerful graphs. CLASS_DIAGRAMS = YES # You can define message sequence charts within doxygen comments using the \msc # command. Doxygen will then run the mscgen tool (see http://www.mcternan.me.uk/mscgen/) to # produce the chart and insert it in the documentation. The MSCGEN_PATH tag allows you to # specify the directory where the mscgen tool resides. If left empty the tool is assumed to # be found in the default search path. MSCGEN_PATH = # If set to YES, the inheritance and collaboration graphs will hide # inheritance and usage relations if the target is undocumented # or is not a class. HIDE_UNDOC_RELATIONS = YES # If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is # available from the path. This tool is part of Graphviz, a graph visualization # toolkit from AT&T and Lucent Bell Labs. The other options in this section # have no effect if this option is set to NO (the default) HAVE_DOT = YES # If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen # will generate a graph for each documented class showing the direct and # indirect inheritance relations. Setting this tag to YES will force the # the CLASS_DIAGRAMS tag to NO. CLASS_GRAPH = YES # If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen # will generate a graph for each documented class showing the direct and # indirect implementation dependencies (inheritance, containment, and # class references variables) of the class with other documented classes. COLLABORATION_GRAPH = YES # If the GROUP_GRAPHS and HAVE_DOT tags are set to YES then doxygen # will generate a graph for groups, showing the direct groups dependencies GROUP_GRAPHS = YES # If the UML_LOOK tag is set to YES doxygen will generate inheritance and # collaboration diagrams in a style similar to the OMG's Unified Modeling # Language. UML_LOOK = NO # If set to YES, the inheritance and collaboration graphs will show the # relations between templates and their instances. TEMPLATE_RELATIONS = NO # If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT # tags are set to YES then doxygen will generate a graph for each documented # file showing the direct and indirect include dependencies of the file with # other documented files. INCLUDE_GRAPH = YES # If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and # HAVE_DOT tags are set to YES then doxygen will generate a graph for each # documented header file showing the documented files that directly or # indirectly include this file. INCLUDED_BY_GRAPH = YES # If the CALL_GRAPH and HAVE_DOT tags are set to YES then doxygen will # generate a call dependency graph for every global function or class method. # Note that enabling this option will significantly increase the time of a run. # So in most cases it will be better to enable call graphs for selected # functions only using the \callgraph command. CALL_GRAPH = NO # If the CALLER_GRAPH and HAVE_DOT tags are set to YES then doxygen will # generate a caller dependency graph for every global function or class method. # Note that enabling this option will significantly increase the time of a run. # So in most cases it will be better to enable caller graphs for selected # functions only using the \callergraph command. CALLER_GRAPH = NO # If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen # will graphical hierarchy of all classes instead of a textual one. GRAPHICAL_HIERARCHY = YES # If the DIRECTORY_GRAPH, SHOW_DIRECTORIES and HAVE_DOT tags are set to YES # then doxygen will show the dependencies a directory has on other directories # in a graphical way. The dependency relations are determined by the #include # relations between the files in the directories. DIRECTORY_GRAPH = YES # The DOT_IMAGE_FORMAT tag can be used to set the image format of the images # generated by dot. Possible values are png, jpg, or gif # If left blank png will be used. DOT_IMAGE_FORMAT = png # The tag DOT_PATH can be used to specify the path where the dot tool can be # found. If left blank, it is assumed the dot tool can be found in the path. DOT_PATH = # The DOTFILE_DIRS tag can be used to specify one or more directories that # contain dot files that are included in the documentation (see the # \dotfile command). DOTFILE_DIRS = # The MAX_DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of # nodes that will be shown in the graph. If the number of nodes in a graph # becomes larger than this value, doxygen will truncate the graph, which is # visualized by representing a node as a red box. Note that doxygen will always # show the root nodes and its direct children regardless of this setting. DOT_GRAPH_MAX_NODES = 50 # Set the DOT_TRANSPARENT tag to YES to generate images with a transparent # background. This is disabled by default, which results in a white background. # Warning: Depending on the platform used, enabling this option may lead to # badly anti-aliased labels on the edges of a graph (i.e. they become hard to # read). DOT_TRANSPARENT = NO # Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output # files in one run (i.e. multiple -o and -T options on the command line). This # makes dot run faster, but since only newer versions of dot (>1.8.10) # support this, this feature is disabled by default. DOT_MULTI_TARGETS = NO # If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will # generate a legend page explaining the meaning of the various boxes and # arrows in the dot generated graphs. GENERATE_LEGEND = YES # If the DOT_CLEANUP tag is set to YES (the default) Doxygen will # remove the intermediate dot files that are used to generate # the various graphs. DOT_CLEANUP = YES #--------------------------------------------------------------------------- # Configuration::additions related to the search engine #--------------------------------------------------------------------------- # The SEARCHENGINE tag specifies whether or not a search engine should be # used. If set to NO the values of all tags below this one will be ignored. SEARCHENGINE = NO pupnp-release-1.8.0/INSTALL000066400000000000000000000000001303304015100153050ustar00rootroot00000000000000pupnp-release-1.8.0/LICENSE000066400000000000000000000027331303304015100153000ustar00rootroot00000000000000Copyright (c) 2000-2003 Intel Corporation All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither name of Intel Corporation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. pupnp-release-1.8.0/Makefile.am000066400000000000000000000024051303304015100163230ustar00rootroot00000000000000# # Top-level "Makefile.am" for libupnp # # Copyright (C) 2005 Rémi Turboult # ACLOCAL_AMFLAGS = -I m4 DISTCHECK_CONFIGURE_FLAGS = --enable-debug --enable-samples SUBDIRS = \ ixml \ threadutil \ upnp \ docs/dist EXTRA_DIST = \ Doxyfile \ libupnp-1.8.pc.in \ LICENSE \ THANKS \ libupnp.spec \ build/libupnp.bpf \ build/libupnp.bpr \ build/libupnp.dsp \ build/libupnp.dsw \ build/inc/autoconfig.h \ build/inc/upnpconfig.h \ build/msvc/inttypes.h \ build/msvc/stdint.h \ build/vc8/ixml.vcproj \ build/vc8/libupnp.sln \ build/vc8/libupnp.vcproj \ build/vc8/threadutil.vcproj \ build/vc8/tvcombo.vcproj \ build/vc8/tvctrlpt.vcproj \ build/vc8/tvdevice.vcproj \ build/vc9/ixml.vcproj \ build/vc9/libupnp.sln \ build/vc9/libupnp.vcproj \ build/vc9/threadutil.vcproj \ build/vc9/tvcombo.vcproj \ build/vc9/tvctrlpt.vcproj \ build/vc9/tvdevice.vcproj # This variable must have 'exec' in its name, in order to be installed # by 'install-exec' target (instead of default 'install-data') pkgconfigexecdir = $(libdir)/pkgconfig pkgconfigexec_DATA = libupnp-1.8.pc $(pkgconfigexec_DATA): config.status if WITH_DOCUMENTATION doc_DATA = LICENSE README NEWS TODO THANKS endif CLEANFILES = IUpnpErrFile.txt IUpnpInfoFile.txt pupnp-release-1.8.0/NEWS000066400000000000000000000062451303304015100147740ustar00rootroot00000000000000 What is new in libupnp 1.3.1 * fix: "upnp.h" includes "upnpdebug.h" only if debug enabled in the library (else header file is not installed) * fix: add inter-library dependencies between upnp and ixml / threadutil, so that programs linking against upnp only still work. ============================================================================ What is new in libupnp 1.3.0 * major change: autoconfiscate build system. automake + autoconf replace the previous makefiles. This should allow for easier build and installation on various distributions. * change: optional library features are selected with configure options (such as "./configure --enable-debug --disable-device") : see README file for the main options, and "./configure --help" to display a complete list. * new: install a pkgconfig file "libupnp.pc" * new: a new installed file provides macros to know the installed library version, and the optional features which have been configured in the library. * change: the old included file "config.h", which contained internal definitions needed to compile the library, is no longer installed in * change: the debug definitions previously available in are now available in (only if library configured with debug enabled). * change: add libtool versionning for the 3 libraries. Also hide all library symbols not part of the public API. * change: remove "hard" limit to 32K in UpnpSetContentLength (not suitable for UPnP AV clients). * new: new "UpnpSetMaxContentLength" function to globally set the maximum incoming content-length that the SDK will process (should be used instead of UpnpSetContentLength, which does not uses its handle argument) * change: returns OUTOF_BOUNDS instead of BAD_HTTPMSG when exceed allowed Content Length * new: ixml: new function ixmlRelaxParser to make the XML parser more tolerant to malformed text, if required (default behaviour is unchanged : abort on error) * fix: compilation error with gcc4 * fix: add some missing const's in public API * fix: add check for availability of socklen_t type * fix: miscellaneous bugs and warnings (see details in ChangeLog) ============================================================================ Changes to the SDK for UPnP Devices version 1.2.1a: - Changes the NAME_SIZE constant used for URL buffers to 256 bytes to accomodate longer URLs. ============================================================================ Changes to the SDK for UPnP Devices version 1.2.1: - Integrates an entirely new XML parser that features DOM2 API support and a much smaller code size. - Integrates a new threading utility library that manages all threads in the library. - Elimination of C++ and other code optimizations have reduced the binary size by over 60%. - The web server now supports application-level callbacks to handle dynamically generated data. - The web server now correctly handles chunked encoding. - A new client HTTP API has been added that allows downloading of items of unlimited size. - The SDK supports much better cross-compilation support. - Numerous memory leaks and bugs have been fixed. pupnp-release-1.8.0/README.md000066400000000000000000000401001303304015100155400ustar00rootroot00000000000000#Portable SDK for UPnP\* Devices (libupnp) Copyright (c) 2000-2003 Intel Corporation - All Rights Reserved. Copyright (c) 2005-2006 Rémi Turboult Copyright (c) 2006 Michel Pfeiffer and others See LICENSE for details. ## Table of Contents 1. Release List 2. Release Contents 3. Package Contents 4. System Requirements 5. Build Instructions 6. Install/Uninstall Instructions 7. Product Release Notes 8. New Features 9. Support and Contact Information 10. IXML support for scripting languages ## 1. Release List Release Number | Date | History ---------------|------|-------- 0.9.0 | 2000-08-01 | [UPnP SDK for Linux][UPnP SDK for Linux] 0.9.1 | 2000-08-17 | [UPnP SDK for Linux][UPnP SDK for Linux] 1.0.0 | 2000-08-31 | [UPnP SDK for Linux][UPnP SDK for Linux] 1.0.1 | 2000-10-13 | [UPnP SDK for Linux][UPnP SDK for Linux] 1.0.2 | 2001-02-07 | [UPnP SDK for Linux][UPnP SDK for Linux] 1.0.3 | 2001-06-12 | [UPnP SDK for Linux][UPnP SDK for Linux] 1.0.4 | 2001-08-15 | [UPnP SDK for Linux][UPnP SDK for Linux] 1.2.1 | 2003-02-13 | [UPnP SDK for Linux][UPnP SDK for Linux] 1.2.1a | 2003-11-08 | [UPnP SDK for Linux][UPnP SDK for Linux] 1.3.0 | 2006-03-04 | [UPnP SDK for Linux][UPnP SDK for Linux] 1.3.1 | 2006-03-05 | [UPnP SDK for Linux][UPnP SDK for Linux] 1.4.0 | 2006-06-12 | [Portable UPnP SDK][Portable UPnP SDK] 1.4.1 | 2006-08-11 | [Portable UPnP SDK][Portable UPnP SDK] 1.4.2 | 2007-02-16 | [Portable UPnP SDK][Portable UPnP SDK] 1.4.3 | 2007-03-06 | [Portable UPnP SDK][Portable UPnP SDK] 1.4.4 | 2007-04-17 | [Portable UPnP SDK][Portable UPnP SDK] 1.4.5 | 2007-04-28 | [Portable UPnP SDK][Portable UPnP SDK] 1.4.6 | 2007-04-30 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.0 | 2007-06-23 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.1 | 2007-11-08 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.2 | 2007-12-10 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.3 | 2007-12-26 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.4 | 2008-01-26 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.5 | 2008-02-02 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.6 | 2008-04-25 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.7 | 2010-10-04 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.8 | 2010-10-21 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.9 | 2010-11-07 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.10 | 2011-01-30 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.11 | 2011-02-07 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.12 | 2011-02-08 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.13 | 2011-03-17 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.14 | 2011-11-17 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.15 | 2012-01-25 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.16 | 2012-03-21 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.17 | 2012-04-03 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.18 | 2013-01-29 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.19 | 2013-11-15 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.20 | 2016-07-07 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.21 | 2016-12-21 | [Portable UPnP SDK][Portable UPnP SDK] 1.6.22 | 2017-??-?? | 1.8.0 | 2017-??-?? | [UPnP SDK for Linux]: https://sourceforge.net/projects/upnp/ [Portable UPnP SDK]: https://sourceforge.net/projects/pupnp/ ## 2. Release Contents The Portable SDK for UPnP Devices is an SDK for development of UPnP device and control point applications. It consists of the core UPnP protocols along with a UPnP-specific eXtensible Markup Language (XML) parser supporting the Document Object Model (DOM) Level 2 API and an optional, integrated mini web server for serving UPnP related documents. ## 3. Package Contents The SDK for UPnP Devices contains the following: Path/File | Description ----------------|------------------------------------------------------------- README | This file. Contains the installation and build instructions. LICENSE | The licensing terms the SDK is distributed under. NEWS | Changes and new features. ixml\doc | The files for generating the XML parser documentation from the source code. ixml\inc | The public include files required to use the XML parser. ixml\src | The source code to the XML parser library. threadutil\inc | The public include files required to the threading utility library. threadutil\src | The source code to the threading utility library. upnp\doc | The files for generating the SDK documentation from the source code. upnp\inc | The public include files required to use the SDK. upnp\src | The source files comprising the SDK, libupnp.so. upnp\sample | A sample device and control point application, illustrating the usage of the SDK. ## 4. System Requirements The SDK for UPnP Devices is designed to compile and run under several operating systems. It does, however, have dependencies on some packages that may not be installed by default. All packages that it requires are listed below. libpthread The header and library are installed as part of the glibc-devel package (or equivalent). Additionally, the documentation for the SDK can be auto-generated from the upnp.h header file using DOC++, a documentation system for C, C++, IDL, and Java\*. DOC++ generates the documentation in HTML or TeX format. Using some additional tools, the TeX output can be converted into a PDF file. To generate the documentation these tools are required: DOC++ | The homepage for DOC\+\+ is http://docpp.sourceforge.net/. The current version as of this release of the SDK is version 3.4.9. DOC\+\+ is the only requirement for generating the HTML documentation. ----------|-------------------------------------------------------------- LaTeX/TeX | To generate the PDF documentation, LaTeX and TeX tools are necessary. The tetex and tetex-latex packages provide these tools. dvips | dvips converts the DVI file produced by LaTeX into a PostScript\* file. The tetex-dvips package provides this tool. ps2pdf | The final step to making the PDF is converting the PostStript\* into Portable Document Format. The ghostscript package provides this tool. For the UPnP library to function correctly, networking must be configured properly for multicasting. To do this: ``` % route add -net 239.0.0.0 netmask 255.0.0.0 eth0 ``` where 'eth0' is the network adapter that the UPnP library will use. Without this addition, device advertisements and control point searches will not function. ## 5. Build Instructions ###CORE LIBRARIES The in the examples below, replace $(LIBUPNP) with "libupnp-x.y.z", with x, y, and z corresponding to the version of the library that you have. All pieces of the SDK are configured and built from the $(LIBUPNP) directory. ``` % cd $(LIBUPNP) % ./configure % make ``` will build a version of the binaries without debug support, and with default options enabled (see below for options available at configure time). ``` % cd $(LIBUPNP) % ./configure CFLAGS="-DSPARC_SOLARIS -mtune= -mcpu=" % make ``` will build a Sparc Solaris version of the binaries without debug support and with default options enabled (see below for options available at configure time). Please note: has to be replaced by a token that fits to your platform and CPU (e.g. "supersparc"). To build the documentation, assuming all the necessary tools are installed (see section 3) : To generate the HTML documentation: ``` % cd $(LIBUPNP) % make html ``` To generate the PDF file: ``` % cd $(LIBUPNP) % make pdf ``` A few options are available at configure time. Use "./configure --help" to display a complete list of options. Note that these options may be combined in any order. After installation, the file will provide a summary of the optional features that have been included in the library. ``` % cd $(LIBUPNP) % ./configure --enable-debug % make ``` will build a debug version with symbols support. To build the library with the optional, integrated mini web server (note that this is the default): ``` % cd $(LIBUPNP) % ./configure --enable-webserver % make ``` To build without: ``` % cd $(LIBUPNP) % ./configure --disable-webserver % make ``` The SDK also contains some additional helper APIs, declared in inc/tools/upnptools.h. If these additional tools are not required, they can be compiled out: ``` % cd $(LIBUPNP) % ./configure --disable-tools % make ``` By default, the tools are included in the library. To further remove code that is not required, the library can be build with or with out the control point (client) or device specific code. To remove this code: ``` % cd $(LIBUPNP) % ./configure --disable-client % make ``` to remove client only code or: ``` % cd $(LIBUPNP) % ./configure --disable-device % make ``` to remove device only code. By default, both client and device code is included in the library. The integrated web server is automatically removed when configuring with --disable-device. To build the library without large-file support (enabled by default) : ``` % cd $(LIBUPNP) % ./configure --disable-largefile % make ``` To remove all the targets, object files, and built documentation: ``` % cd $(LIBUPNP) % make clean ``` ### CROSS COMPILATION To cross compile the SDK, a special "configure" directive is all that is required: ``` % cd $(LIBUPNP) % ./configure --host=arm-linux % make ``` This will invoke the "arm-linux-gcc" cross compiler to build the library. ### SAMPLES The SDK contains two samples: a TV device application and a control point that talks with the TV device. They are found in the $(LIBUPNP)/upnp/sample directory. To build the samples (note: this is the default behaviour): ``` % cd $(LIBUPNP) % ./configure --enable-samples % make ``` will build the sample device "$(LIBUPNP)/upnp/tv_device" and sample control point "$(LIBUPNP)/upnp/tv_ctrlpt". Note : the sample device won't be built if --disable-device has been configured, and the sample control point won't be build if --disable-client has been configured. To run the sample device, you need to create a tvdevice directory and move the web directory there, giving: "$(LIBUPNP)/upnp/sample/tvdevice/web". To run the sample invoke from the command line as follows: ``` % cd $(LIBUPNP)/upnp/sample/tvdevice % ../tv_device ``` ### SOLARIS BUILD The building process for the Solaris operating system is similar to the one described above. Only the call to ./configure has to be done using an additional parameter: ``` % ./configure CFLAGS="-mcpu= -mtune= -DSPARC_SOLARIS" ``` where has to be replaced by the appropriate CPU tuning flag (e.g. "supersparc"). Afterwards ``` % make % make install ``` can be called as described above. ### WINDOWS BUILD In order to build libupnp under Windows the pthreads-w32 package is required. You can download a self-extracting ZIP file from the following location: ftp://sources.redhat.com/pub/pthreads-win32/pthreads-w32-2-7-0-release.exe or possibly newer versions if available. Execute the self-extracting archive and copy the Pre-build.2 folder to the top level source folder. Rename Pre-build.2 to pthreads. Open the provided workspace build\libupnp.dsw with Visual C++ 6.0 and select Build->Build libupnp.dll (F7) In the build directory there are also VC8, VC9 and VC10 folders containing solution files for Visual Studio 2005/2008/2010 respectively. If you use newer versions to build libupnp, eg Visual Studio 2003 or later, then you need to rebuild the pthreads package so it uses the same VC runtime as libupnp to prevent cross boundary runtime problems (see http://msdn.microsoft.com/en-us/library/ms235460%28v=VS.100%29.aspx). Just replace the files in the Pre-build.2 folder (renamed to pthreads as mentioned above) with the newly build versions. If you also use a newer version of pthreads-win32 then you should also replace the header files in that directory structure (obviously). For building a static library instead of a DLL and for using the static pthreads-w32 library following switches need to be defined additionally: UPNP_STATIC_LIB - for creating a statically linkable UPnP-library PTW32_STATIC_LIB - for using the static pthreads32 library ## 6. Install/Uninstall Instructions ### Install The top-level makefile for the UPnP SDK contains rules to install the necessary components. To install the SDK, as root: ``` % make install ``` ### Uninstall Likewise, the top-level makefile contains an uninstall rule, reversing the steps in the install: ``` % make uninstall ``` ## 7. Product Release Notes The SDK for UPnP Devices v1.2.1a has these known issues: * The UPnP library may not work with older versions of gcc and libstdc++, causing a segmentation fault when the library loads. It is recommended that gcc version 2.9 or later be used in building library. * The UPnP library does not work the glibc 2.1.92-14 that ships with Red Hat 7.0. For the library to function, you must updated the glibc and glibc-devel packages to 2.1.94-3 or later. There is some issue with libpthreads that has been resolved in the 2.1.94 version. ## 8. New Features See NEWS file. ## 9. Support and Contact Information Intel is not providing support for the SDK for UPnP Devices. Mailing lists and discussion boards can be found at http://www.libupnp.org/. If you find this SDK useful, please send an email to upnp@intel.com and let us know. \* Other brands, names, and trademarks are the property of their respective owners. ## 10. IXML support for scriptinglanguages The treestructure of XML documents created by IXML is hard to maintain when creating a binding for a scripting language. Even when many elements may never be used on the script side, it requires copying the entire tree structure once you start accessing elements several levels deep. Hence scriptsupport was added. To enable it compile while IXML_HAVE_SCRIPTSUPPORT has been defined (enabled by default). This allows control using only a list instead of a tree-like structure, and only nodes actually accessed need to be created instead of all the nodes in the tree. Here's how its supposed to work; * The scriptsupport allows you to add a callback when a node is freed on the C side, so appropriate action can be taken on the script side, see function ixmlSetBeforeFree(). * Instead of recreating the tree structure, an intermediate object should be created only for the nodes actually accessed. The object should be containing a pointer to the node and a 'valid flag' which is initially set to TRUE (the valid flag, can simply be the pointer to the node being NULL or not). Before creating the intermediate object, the custom tag 'ctag' can be used to check whether one was already created. * the node object gets an extra 'void\* ctag' field, a custom tag to make a cross reference to the script side intermediate object. It can be set using ixmlNode_setCTag(), and read using ixmlNode_getCTag(). Whenever a new intermediate object is created, the ctag of the coirresponding node should be set to point to this intermediate object. * The tree structure traversal is done on the C side (looking up parents, children and siblings) * Every intermediate object created should be kept in a list (preferably a key-value list, where the key is the pointer to the node and the value is the pointer to the intermediate object) * when the callback is called, the node should be looked up in the list, the flag set to false, the pointer to the C-side node be cleared and on the C-side the ctag should be cleared. * whenever the intermediate object is accessed and its flag is set to False, an error should be thrown that the XML document has been closed. Freeing resources can be done in 2 ways, C side by simply calling the free node methods, or script side by the garbage collector of the scriptengine. Scriptside steps; * if the valid flag is set to False (XML document is closed), then the intermediate object can be destroyed, no further action * if the node has a parent, then the intermediate object can be destroyed after the ctag on the corresponding node has been cleared. Nothing needs to be freed on the C-side. * if the node has no parent, then the node must be freed on the C side by calling the corresponding free node methods. This will result in a chain of callbacks closing the node and all underlying nodes. pupnp-release-1.8.0/THANKS000066400000000000000000000035141303304015100152040ustar00rootroot00000000000000 libupnp was originally written by Intel Corporation. Many people further contributed to libupnp by reporting problems, suggesting various improvements or submitting actual code. Here is a list of these people. Help us keep it complete and exempt of errors. - Alex (afaucher) - Andre Sodermans (wienerschnitzel) - Anoop Mohan (an00p) - Anthony Viallard (homer242) - Apostolos Syropoulos - Arno Willig - Bob Ciora - Carlo Parata - Carl Benson - Chandra Penke (inactiveneurons) - Chaos - Charles Nepveu (cnepveu) - Chris Pickel - Chuck Thomason (cyt4) - Craig Nelson - David Blanchet - David Maass - Dirk (dirk_vdb) - Emil Ljungdahl - Erik Johansson - Eric Tanguy - Erwan Velu - Eugene Christensen - Fabrice Fontaine (ffontaine) - Fredrik Svensson - Gabriel Burca - Glen Masgai - Gustavo Zacarias (gustavoz) - Hartmut Holzgraefe (hholzgra) - Iain Denniston (ectotropic) - Ingo Hofmann - Ivan Romanov (ivanromanov) - Jiri Zouhar - Jean-Francois Dockes (medoc) - John Dennis - Jonathan Casiot (no_dice) - Josh Carroll - Juergen Lock - Keith Brindley - Klaus Fischer (klafier) - Leuk_He - Loigu - Luke Kim (nereusuj) - Marcelo Roberto Jimenez (mroberto) - Markus Strobl - Matthew Garrett (mjg59) - Nektarios K. Papadopoulos (npapadop) - Nicholas Kraft - Nick Leverton (leveret) - Obata Akio (obache) - Oskar Liljeblad - Michael (oxygenic) - Paul Vixie - Peng - Peter Hartley - Philipp Matthias Hahn - Pino Toscano (pinotree) - Rene Hexel - Robert Buckley (rbuckley) - Robert Gingher (robsbox) - Ronan Menard - Salvatore Bonaccorso - Sebastian Brandt - Shaddy Baddah - Shaun Marko (semarko) - Siva Chandran - Stefan Sommerfeld (zerocom) - Stéphane Corthésy - Steve Bresson - Thijs Schreijer - Timothy Redaelli - Titus Winters - Tom (tomdev2) - Uwe Kleine-König - wangyanhai - Yoichi Nakayama (yoichi) - zephyrus (zephyrus00jp) - zexian chen - Zheng Peng (darkelf2010) pupnp-release-1.8.0/TODO000066400000000000000000000004541303304015100147610ustar00rootroot00000000000000 To Be Done ========== - non-regression testing - Why is NUM_HANDLE defined to 200 when we can register only: A) One client(1) B) An IPv4 and IPv6 device (2) NUM_HANDLE should be 3 - A sane way to implement the virtual directory callback initialization and checking against NULL pointers. pupnp-release-1.8.0/bootstrap000077500000000000000000000003511303304015100162300ustar00rootroot00000000000000#!/bin/sh rm -fr autom4te.cache # Equivalent to # aclocal # autoheader # automake --add-missing --copy # autoconf autoreconf --force --install -Wall -Wno-obsolete $* || exit 1 echo "Now run ./configure and then make." exit 0 pupnp-release-1.8.0/build/000077500000000000000000000000001303304015100153655ustar00rootroot00000000000000pupnp-release-1.8.0/build/inc/000077500000000000000000000000001303304015100161365ustar00rootroot00000000000000pupnp-release-1.8.0/build/inc/autoconfig.h000066400000000000000000000123701303304015100204500ustar00rootroot00000000000000/* autoconfig.h. Generated from autoconfig.h.in by configure. */ /* autoconfig.h.in. Generated from configure.ac by autoheader. */ /* Define to 1 to compile debug code */ #define DEBUG 1 /* Define to 1 if you have the header file. */ #define HAVE_ARPA_INET_H 1 /* Define to 1 if you have the header file. */ #define HAVE_DLFCN_H 1 /* Define to 1 if you don't have `vprintf' but do have `_doprnt.' */ /* #undef HAVE_DOPRNT */ /* Define to 1 if you have the header file. */ #define HAVE_FCNTL_H 1 /* Define to 1 if fseeko (and presumably ftello) exists and is declared. */ #define HAVE_FSEEKO 1 /* Define to 1 if you have the header file. */ #define HAVE_INTTYPES_H 1 /* Define to 1 if you have the header file. */ #define HAVE_LIMITS_H 1 /* Define to 1 if you have the header file. */ #define HAVE_MEMORY_H 1 /* Define to 1 if you have the header file. */ #define HAVE_NETDB_H 1 /* Define to 1 if you have the header file. */ #define HAVE_NETINET_IN_H 1 /* Define if you have POSIX threads libraries and header files. */ #define HAVE_PTHREAD 1 /* Define to 1 if you have the header file. */ #define HAVE_STDINT_H 1 /* Define to 1 if you have the header file. */ #define HAVE_STDLIB_H 1 /* Define to 1 if you have the header file. */ #define HAVE_STRINGS_H 1 /* Define to 1 if you have the header file. */ #define HAVE_STRING_H 1 /* Defines if strndup is available on your system */ #define HAVE_STRNDUP 1 /* Defines if strnlen is available on your system */ #define HAVE_STRNLEN 1 /* Define to 1 if you have the header file. */ #define HAVE_SYSLOG_H 1 /* Define to 1 if you have the header file. */ #define HAVE_SYS_IOCTL_H 1 /* Define to 1 if you have the header file. */ #define HAVE_SYS_SOCKET_H 1 /* Define to 1 if you have the header file. */ #define HAVE_SYS_STAT_H 1 /* Define to 1 if you have the header file. */ #define HAVE_SYS_TIME_H 1 /* Define to 1 if you have the header file. */ #define HAVE_SYS_TYPES_H 1 /* Define to 1 if you have the header file. */ #define HAVE_UNISTD_H 1 /* Define to 1 if you have the `vprintf' function. */ #define HAVE_VPRINTF 1 /* Define to 1 if you have the header file. */ /* #undef HAVE_WS2TCPIP_H */ /* see upnpconfig.h */ #define IXML_HAVE_SCRIPTSUPPORT 1 /* Define to the sub-directory in which libtool stores uninstalled libraries. */ #define LT_OBJDIR ".libs/" /* Define to 1 to prevent compilation of assert() */ /* #undef NDEBUG */ /* Define to 1 to prevent some debug code */ /* #undef NO_DEBUG */ /* Define to 1 if your C compiler doesn't accept -c and -o together. */ /* #undef NO_MINUS_C_MINUS_O */ /* Name of package */ #define PACKAGE "libupnp" /* Define to the address where bug reports for this package should be sent. */ #define PACKAGE_BUGREPORT "mroberto@users.sourceforge.net" /* Define to the full name of this package. */ #define PACKAGE_NAME "libupnp" /* Define to the full name and version of this package. */ #define PACKAGE_STRING "libupnp 1.8.0" /* Define to the one symbol short name of this package. */ #define PACKAGE_TARNAME "libupnp" /* Define to the home page for this package. */ #define PACKAGE_URL "" /* Define to the version of this package. */ #define PACKAGE_VERSION "1.8.0" /* Define to necessary symbol if this constant uses a non-standard name on your system. */ /* #undef PTHREAD_CREATE_JOINABLE */ /* Define to 1 if you have the ANSI C header files. */ #define STDC_HEADERS 1 /* see upnpconfig.h */ #define UPNP_ENABLE_BLOCKING_TCP_CONNECTIONS 1 /* see upnpconfig.h */ /* #undef UPNP_ENABLE_IPV6 */ /* see upnpconfig.h */ #define UPNP_ENABLE_NOTIFICATION_REORDERING 1 /* see upnpconfig.h */ /* #undef UPNP_ENABLE_OPEN_SSL */ /* see upnpconfig.h */ /* #undef UPNP_ENABLE_POST_WRITE */ /* see upnpconfig.h */ /* #undef UPNP_ENABLE_UNSPECIFIED_SERVER */ /* see upnpconfig.h */ #define UPNP_HAVE_CLIENT 1 /* see upnpconfig.h */ #define UPNP_HAVE_DEBUG 1 /* see upnpconfig.h */ #define UPNP_HAVE_DEVICE 1 /* see upnpconfig.h */ #define UPNP_HAVE_GENA 1 /* see upnpconfig.h */ #define UPNP_HAVE_OPTSSDP 1 /* see upnpconfig.h */ #define UPNP_HAVE_SOAP 1 /* see upnpconfig.h */ #define UPNP_HAVE_SSDP 1 /* see upnpconfig.h */ #define UPNP_HAVE_TOOLS 1 /* see upnpconfig.h */ #define UPNP_HAVE_WEBSERVER 1 /* Do not use pthread_rwlock_t */ #define UPNP_USE_RWLOCK 1 /* see upnpconfig.h */ #define UPNP_VERSION_MAJOR 1 /* see upnpconfig.h */ #define UPNP_VERSION_MINOR 8 /* see upnpconfig.h */ #define UPNP_VERSION_PATCH 0 /* see upnpconfig.h */ #define UPNP_VERSION_STRING "1.8.0" /* Version number of package */ #define VERSION "1.8.0" /* File Offset size */ #define _FILE_OFFSET_BITS 64 /* Define to 1 to make fseeko visible on some hosts (e.g. glibc 2.2). */ #define _LARGEFILE_SOURCE 1 /* Large files support */ #define _LARGE_FILE_SOURCE /**/ /* Define to empty if `const' does not conform to ANSI C. */ /* #undef const */ /* Define to `long int' if does not define. */ /* #undef off_t */ /* Define to `unsigned int' if does not define. */ /* #undef size_t */ /* Type for storing the length of struct sockaddr */ /* #undef socklen_t */ pupnp-release-1.8.0/build/inc/upnpconfig.h000066400000000000000000000122441303304015100204620ustar00rootroot00000000000000/* upnp/inc/upnpconfig.h. Generated from upnpconfig.h.in by configure. */ /* -*- C -*- */ /******************************************************************************* * * Copyright (c) 2006 Rémi Turboult * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * * Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef UPNP_CONFIG_H #define UPNP_CONFIG_H /*************************************************************************** * Library version ***************************************************************************/ /** The library version (string) e.g. "1.3.0" */ #define UPNP_VERSION_STRING "1.8.0" /** Major version of the library */ #define UPNP_VERSION_MAJOR 1 /** Minor version of the library */ #define UPNP_VERSION_MINOR 8 /** Patch version of the library */ #define UPNP_VERSION_PATCH 0 /** The library version (numeric) e.g. 10300 means version 1.3.0 */ #define UPNP_VERSION \ ((UPNP_VERSION_MAJOR * 100 + UPNP_VERSION_MINOR) * 100 + UPNP_VERSION_PATCH) /*************************************************************************** * Large file support ***************************************************************************/ /** File Offset size */ #define _FILE_OFFSET_BITS 64 /** Define to 1 to make fseeko visible on some hosts (e.g. glibc 2.2). */ #define _LARGEFILE_SOURCE 1 /** Large files support */ #define _LARGE_FILE_SOURCE /**/ /*************************************************************************** * Library optional features ***************************************************************************/ /* * The following defines can be tested in order to know which * optional features have been included in the installed library. */ /** Defined to 1 if the library has been compiled with DEBUG enabled * (i.e. configure --enable-debug) : file is available */ #define UPNP_HAVE_DEBUG 1 /** Defined to 1 if the library has been compiled with client API enabled * (i.e. configure --enable-client) */ #define UPNP_HAVE_CLIENT 1 /** Defined to 1 if the library has been compiled with device API enabled * (i.e. configure --enable-device) */ #define UPNP_HAVE_DEVICE 1 /** Defined to 1 if the library has been compiled with integrated web server * (i.e. configure --enable-webserver --enable-device) */ #define UPNP_HAVE_WEBSERVER 1 /** Defined to 1 if the library has been compiled with the SSDP part enabled * (i.e. configure --enable-ssdp) */ #define UPNP_HAVE_SSDP 1 /** Defined to 1 if the library has been compiled with optional SSDP headers * support (i.e. configure --enable-optssdp) */ #define UPNP_HAVE_OPTSSDP 1 /** Defined to 1 if the library has been compiled with the SOAP part enabled * (i.e. configure --enable-soap) */ #define UPNP_HAVE_SOAP 1 /** Defined to 1 if the library has been compiled with the GENA part enabled * (i.e. configure --enable-gena) */ #define UPNP_HAVE_GENA 1 /** Defined to 1 if the library has been compiled with helper API * (i.e. configure --enable-tools) : file is available */ #define UPNP_HAVE_TOOLS 1 /** Defined to 1 if the library has been compiled with ipv6 support * (i.e. configure --enable-ipv6) */ /* #undef UPNP_ENABLE_IPV6 */ /** Defined to 1 if the library has been compiled with unspecified SERVER * header (i.e. configure --enable-unspecified_server) */ /* #undef UPNP_ENABLE_UNSPECIFIED_SERVER */ /** Defined to 1 if the library has been compiled with OpenSSL support * (i.e. configure --enable-open_ssl) */ /* #undef UPNP_ENABLE_OPEN_SSL */ /** Defined to 1 if the library has been compiled to support filesystem writes on POST * (i.e. configure --enable-postwrite) */ /* #undef UPNP_ENABLE_POST_WRITE */ #endif /* UPNP_CONFIG_H */ pupnp-release-1.8.0/build/libupnp.bpf000066400000000000000000000042651303304015100175360ustar00rootroot00000000000000USEUNIT("..\ixml\src\nodeList.c"); USEUNIT("..\ixml\src\attr.c"); USEUNIT("..\ixml\src\document.c"); USEUNIT("..\ixml\src\element.c"); USEUNIT("..\ixml\src\ixml.c"); USEUNIT("..\ixml\src\ixmlmembuf.c"); USEUNIT("..\ixml\src\ixmlparser.c"); USEUNIT("..\ixml\src\namedNodeMap.c"); USEUNIT("..\ixml\src\node.c"); USEUNIT("..\threadutil\src\TimerThread.c"); USEUNIT("..\threadutil\src\FreeList.c"); USEUNIT("..\threadutil\src\iasnprintf.c"); USEUNIT("..\threadutil\src\LinkedList.c"); USEUNIT("..\threadutil\src\ThreadPool.c"); USEUNIT("..\upnp\src\win_dll.c"); USEUNIT("..\upnp\src\inet_pton.c"); USEUNIT("..\upnp\src\api\upnptools.c"); USEUNIT("..\upnp\src\api\upnpapi.c"); USEUNIT("..\upnp\src\gena\gena_device.c"); USEUNIT("..\upnp\src\gena\gena_callback2.c"); USEUNIT("..\upnp\src\gena\gena_ctrlpt.c"); USEUNIT("..\upnp\src\genlib\client_table\client_table.c"); USEUNIT("..\upnp\src\genlib\miniserver\miniserver.c"); USEUNIT("..\upnp\src\genlib\net\sock.c"); USEUNIT("..\upnp\src\genlib\net\http\webserver.c"); USEUNIT("..\upnp\src\genlib\net\http\httpparser.c"); USEUNIT("..\upnp\src\genlib\net\http\httpreadwrite.c"); USEUNIT("..\upnp\src\genlib\net\http\parsetools.c"); USEUNIT("..\upnp\src\genlib\net\http\statcodes.c"); USEUNIT("..\upnp\src\genlib\net\uri\uri.c"); USEUNIT("..\upnp\src\genlib\service_table\service_table.c"); USEUNIT("..\upnp\src\genlib\util\util.c"); USEUNIT("..\upnp\src\genlib\util\membuffer.c"); USEUNIT("..\upnp\src\genlib\util\strintmap.c"); USEUNIT("..\upnp\src\genlib\util\upnp_timeout.c"); USEUNIT("..\upnp\src\soap\soap_device.c"); USEUNIT("..\upnp\src\soap\soap_common.c"); USEUNIT("..\upnp\src\soap\soap_ctrlpt.c"); USEUNIT("..\upnp\src\ssdp\ssdp_server.c"); USEUNIT("..\upnp\src\ssdp\ssdp_ctrlpt.c"); USEUNIT("..\upnp\src\ssdp\ssdp_device.c"); USEUNIT("..\upnp\src\urlconfig\urlconfig.c"); USEUNIT("..\upnp\src\uuid\uuid.c"); USEUNIT("..\upnp\src\uuid\md5.c"); USEUNIT("..\upnp\src\uuid\sysdep.c"); USELIB("..\..\..\pthreads-w32-1-10-0-release\pthreadBC1.lib"); //--------------------------------------------------------------------------- This file is used by the project manager only and should be treated like the project file DllEntryPointpupnp-release-1.8.0/build/libupnp.bpr000066400000000000000000000171361303304015100175530ustar00rootroot00000000000000 [Version Info] IncludeVerInfo=0 AutoIncBuild=0 MajorVer=1 MinorVer=0 Release=0 Build=0 Debug=0 PreRelease=0 Special=0 Private=0 DLL=0 Locale=1031 CodePage=1252 [Version Info Keys] CompanyName= FileDescription= FileVersion=1.0.0.0 InternalName= LegalCopyright= LegalTrademarks= OriginalFilename= ProductName= ProductVersion=1.0.0.0 Comments= [HistoryLists\hlIncludePath] Count=3 Item0=..\upnp\src\genlib\util;..\upnp\src;..\upnp\src\uuid;..\upnp\src\urlconfig;..\upnp\src\ssdp;..\upnp\src\soap;..\upnp\src\genlib\service_table;..\upnp\src\genlib\net;..\upnp\src\genlib\net\uri;..\upnp\src\genlib\net\http;..\upnp\src\genlib\miniserver;..\upnp\src\genlib\client_table;..\upnp\src\gena;..\upnp\src\api;..\threadutil\src;..\ixml\src;$(BCB)\include;$(BCB)\include\vcl;..\ixml\inc;..\threadutil\inc;..\upnp\inc;inc;..\ixml\src\inc;..\upnp\src\inc;..\..\pthreads-w32-1-10-0-release Item1=..\upnp\src\genlib\util;..\upnp\src;..\upnp\src\uuid;..\upnp\src\urlconfig;..\upnp\src\ssdp;..\upnp\src\soap;..\upnp\src\genlib\service_table;..\upnp\src\genlib\net;..\upnp\src\genlib\net\uri;..\upnp\src\genlib\net\http;..\upnp\src\genlib\miniserver;..\upnp\src\genlib\client_table;..\upnp\src\gena;..\upnp\src\api;..\threadutil\src;..\ixml\src;$(BCB)\include;$(BCB)\include\vcl;..\ixml\inc;..\threadutil\inc;..\upnp\inc;inc;..\ixml\src\inc;..\upnp\src\inc;D:\DEVELOP\pthreads-w32-1-10-0-release Item2=..\upnp\src\genlib\util;..\upnp\src;..\upnp\src\uuid;..\upnp\src\urlconfig;..\upnp\src\ssdp;..\upnp\src\soap;..\upnp\src\genlib\service_table;..\upnp\src\genlib\net;..\upnp\src\genlib\net\uri;..\upnp\src\genlib\net\http;..\upnp\src\genlib\miniserver;..\upnp\src\genlib\client_table;..\upnp\src\gena;..\upnp\src\api;..\threadutil\src;..\ixml\src;$(BCB)\include;$(BCB)\include\vcl;..\ixml\inc;..\threadutil\inc;..\upnp\inc;inc;..\ixml\src\inc;..\upnp\src\inc [HistoryLists\hlLibraryPath] Count=3 Item0=..\upnp\src\uuid;..\upnp\src\urlconfig;..\upnp\src\ssdp;..\upnp\src\soap;..\upnp\src\genlib\util;..\upnp\src\genlib\service_table;..\upnp\src\genlib\net\uri;..\upnp\src\genlib\net\http;..\upnp\src\genlib\net;..\upnp\src\genlib\miniserver;..\upnp\src\genlib\client_table;..\upnp\src\gena;..\upnp\src\api;..\upnp\src;..\threadutil\src;..\ixml\src;$(BCB)\lib\obj;$(BCB)\lib;..\..\pthreads-w32-1-10-0-release Item1=..\upnp\src\uuid;..\upnp\src\urlconfig;..\upnp\src\ssdp;..\upnp\src\soap;..\upnp\src\genlib\util;..\upnp\src\genlib\service_table;..\upnp\src\genlib\net\uri;..\upnp\src\genlib\net\http;..\upnp\src\genlib\net;..\upnp\src\genlib\miniserver;..\upnp\src\genlib\client_table;..\upnp\src\gena;..\upnp\src\api;..\upnp\src;..\threadutil\src;..\ixml\src;$(BCB)\lib\obj;$(BCB)\lib;D:\DEVELOP\pthreads-w32-1-10-0-release Item2=..\upnp\src\uuid;..\upnp\src\urlconfig;..\upnp\src\ssdp;..\upnp\src\soap;..\upnp\src\genlib\util;..\upnp\src\genlib\service_table;..\upnp\src\genlib\net\uri;..\upnp\src\genlib\net\http;..\upnp\src\genlib\net;..\upnp\src\genlib\miniserver;..\upnp\src\genlib\client_table;..\upnp\src\gena;..\upnp\src\api;..\upnp\src;..\threadutil\src;..\ixml\src;$(BCB)\lib\obj;$(BCB)\lib [HistoryLists\hlDebugSourcePath] Count=1 Item0=$(BCB)\source\vcl [HistoryLists\hlConditionals] Count=4 Item0=WIN32;LIBUPNP_EXPORTS;UPNP_USE_BCBPP Item1=WIN32;LIBUPNP_EXPORTS Item2=WIN32;EXPORT_SPEC Item3=WIN32 [Debugging] DebugSourceDirs=$(BCB)\source\vcl [Parameters] RunParams= HostApplication= RemoteHost= RemotePath= RemoteDebug=0 [Compiler] ShowInfoMsgs=0 LinkDebugVcl=0 pupnp-release-1.8.0/build/libupnp.dsp000066400000000000000000000244351303304015100175560ustar00rootroot00000000000000# Microsoft Developer Studio Project File - Name="libupnp" - Package Owner=<4> # Microsoft Developer Studio Generated Build File, Format Version 6.00 # ** NICHT BEARBEITEN ** # TARGTYPE "Win32 (x86) Dynamic-Link Library" 0x0102 CFG=libupnp - Win32 Debug !MESSAGE Dies ist kein gültiges Makefile. Zum Erstellen dieses Projekts mit NMAKE !MESSAGE verwenden Sie den Befehl "Makefile exportieren" und führen Sie den Befehl !MESSAGE !MESSAGE NMAKE /f "libupnp.mak". !MESSAGE !MESSAGE Sie können beim Ausf?hren von NMAKE eine Konfiguration angeben !MESSAGE durch Definieren des Makros CFG in der Befehlszeile. Zum Beispiel: !MESSAGE !MESSAGE NMAKE /f "libupnp.mak" CFG="libupnp - Win32 Debug" !MESSAGE !MESSAGE Für die Konfiguration stehen zur Auswahl: !MESSAGE !MESSAGE "libupnp - Win32 Release" (basierend auf "Win32 (x86) Dynamic-Link Library") !MESSAGE "libupnp - Win32 Debug" (basierend auf "Win32 (x86) Dynamic-Link Library") !MESSAGE # Begin Project # PROP AllowPerConfigDependencies 0 # PROP Scc_ProjName "" # PROP Scc_LocalPath "" CPP=cl.exe MTL=midl.exe RSC=rc.exe !IF "$(CFG)" == "libupnp - Win32 Release" # PROP BASE Use_MFC 0 # PROP BASE Use_Debug_Libraries 0 # PROP BASE Output_Dir "Release" # PROP BASE Intermediate_Dir "Release" # PROP BASE Target_Dir "" # PROP Use_MFC 0 # PROP Use_Debug_Libraries 0 # PROP Output_Dir "Release" # PROP Intermediate_Dir "Release" # PROP Ignore_Export_Lib 0 # PROP Target_Dir "" # ADD BASE CPP /nologo /MT /W3 /GX /O2 /D "WIN32" /D "NDEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /D "LIBUPNP_EXPORTS" /YX /FD /c # ADD CPP /nologo /MT /W3 /GX /O2 /I "..\..\pthreads\include" /I "..\ixml\src\inc" /I "..\ixml\inc" /I "..\threadutil\inc" /I "..\upnp\inc" /I "..\upnp\src\inc" /I ".\inc" /D "WIN32" /D "NDEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /D "LIBUPNP_EXPORTS" /D "PTW32_STATIC_LIB" /D "UPNP_STATIC_LIB" /D "UPNP_USE_MSVCPP" /FR /YX /FD /c # ADD BASE MTL /nologo /D "NDEBUG" /mktyplib203 /win32 # ADD MTL /nologo /D "NDEBUG" /mktyplib203 /win32 # ADD BASE RSC /l 0x407 /d "NDEBUG" # ADD RSC /l 0x407 /d "NDEBUG" BSC32=bscmake.exe # ADD BASE BSC32 /nologo # ADD BSC32 /nologo LINK32=link.exe # ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /dll /machine:I386 # ADD LINK32 kernel32.lib user32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib ..\..\pthreads\lib\pthreadvc2.lib ws2_32.lib /nologo /dll /machine:I386 # SUBTRACT LINK32 /pdb:none !ELSEIF "$(CFG)" == "libupnp - Win32 Debug" # PROP BASE Use_MFC 0 # PROP BASE Use_Debug_Libraries 1 # PROP BASE Output_Dir "Debug" # PROP BASE Intermediate_Dir "Debug" # PROP BASE Target_Dir "" # PROP Use_MFC 0 # PROP Use_Debug_Libraries 1 # PROP Output_Dir "Debug" # PROP Intermediate_Dir "Debug" # PROP Ignore_Export_Lib 0 # PROP Target_Dir "" # ADD BASE CPP /nologo /MTd /W3 /Gm /GX /ZI /Od /D "WIN32" /D "_DEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /D "LIBUPNP_EXPORTS" /YX /FD /GZ /c # ADD CPP /nologo /MTd /W3 /Gm /GX /ZI /Od /I "..\..\pthreads\include" /I "..\ixml\src\inc" /I "..\ixml\inc" /I "..\threadutil\inc" /I "..\upnp\inc" /I "..\upnp\src\inc" /I "..\build\inc" /D "WIN32" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /D "LIBUPNP_EXPORTS" /D "UPNP_USE_MSVCPP" /FR /YX /FD /GZ /c # ADD BASE MTL /nologo /D "_DEBUG" /mktyplib203 /win32 # ADD MTL /nologo /D "_DEBUG" /mktyplib203 /win32 # ADD BASE RSC /l 0x407 /d "_DEBUG" # ADD RSC /l 0x407 /d "_DEBUG" BSC32=bscmake.exe # ADD BASE BSC32 /nologo # ADD BSC32 /nologo LINK32=link.exe # ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /dll /debug /machine:I386 /pdbtype:sept # ADD LINK32 kernel32.lib user32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib ..\..\pthreads\lib\pthreadvc2.lib ws2_32.lib /nologo /dll /debug /machine:I386 /pdbtype:sept !ENDIF # Begin Target # Name "libupnp - Win32 Release" # Name "libupnp - Win32 Debug" # Begin Group "Quellcodedateien" # PROP Default_Filter "cpp;c;cxx;rc;def;r;odl;idl;hpj;bat" # Begin Source File SOURCE=..\ixml\src\attr.c # End Source File # Begin Source File SOURCE=..\upnp\src\genlib\client_table\client_table.c # End Source File # Begin Source File SOURCE=..\ixml\src\document.c # End Source File # Begin Source File SOURCE=..\ixml\src\element.c # End Source File # Begin Source File SOURCE=..\threadutil\src\FreeList.c # End Source File # Begin Source File SOURCE=..\upnp\src\gena\gena_callback2.c # End Source File # Begin Source File SOURCE=..\upnp\src\gena\gena_ctrlpt.c # End Source File # Begin Source File SOURCE=..\upnp\src\gena\gena_device.c # End Source File # Begin Source File SOURCE=..\upnp\src\genlib\net\http\httpparser.c # End Source File # Begin Source File SOURCE=..\upnp\src\genlib\net\http\httpreadwrite.c # End Source File # Begin Source File SOURCE=..\threadutil\src\iasnprintf.c # End Source File # Begin Source File SOURCE=..\upnp\src\inet_pton.c # End Source File # Begin Source File SOURCE=..\ixml\src\ixml.c # End Source File # Begin Source File SOURCE=..\ixml\src\ixmlmembuf.c # End Source File # Begin Source File SOURCE=..\ixml\src\ixmlparser.c # End Source File # Begin Source File SOURCE=..\threadutil\src\LinkedList.c # End Source File # Begin Source File SOURCE=..\upnp\src\uuid\md5.c # End Source File # Begin Source File SOURCE=..\upnp\src\genlib\util\membuffer.c # End Source File # Begin Source File SOURCE=..\upnp\src\genlib\miniserver\miniserver.c # End Source File # Begin Source File SOURCE=..\ixml\src\namedNodeMap.c # End Source File # Begin Source File SOURCE=..\ixml\src\node.c # End Source File # Begin Source File SOURCE=..\ixml\src\nodeList.c # End Source File # Begin Source File SOURCE=..\upnp\src\genlib\net\http\parsetools.c # End Source File # Begin Source File SOURCE=..\upnp\src\genlib\service_table\service_table.c # End Source File # Begin Source File SOURCE=..\upnp\src\soap\soap_common.c # End Source File # Begin Source File SOURCE=..\upnp\src\soap\soap_ctrlpt.c # End Source File # Begin Source File SOURCE=..\upnp\src\soap\soap_device.c # End Source File # Begin Source File SOURCE=..\upnp\src\genlib\net\sock.c # End Source File # Begin Source File SOURCE=..\upnp\src\ssdp\ssdp_ctrlpt.c # End Source File # Begin Source File SOURCE=..\upnp\src\ssdp\ssdp_device.c # End Source File # Begin Source File SOURCE=..\upnp\src\ssdp\ssdp_server.c # End Source File # Begin Source File SOURCE=..\upnp\src\genlib\net\http\statcodes.c # End Source File # Begin Source File SOURCE=..\upnp\src\genlib\util\strintmap.c # End Source File # Begin Source File SOURCE=..\upnp\src\uuid\sysdep.c # End Source File # Begin Source File SOURCE=..\threadutil\src\ThreadPool.c # End Source File # Begin Source File SOURCE=..\threadutil\src\TimerThread.c # End Source File # Begin Source File SOURCE=..\upnp\src\genlib\util\upnp_timeout.c # End Source File # Begin Source File SOURCE=..\upnp\src\api\upnpapi.c # End Source File # Begin Source File SOURCE=..\upnp\src\api\upnptools.c # End Source File # Begin Source File SOURCE=..\upnp\src\genlib\net\uri\uri.c # End Source File # Begin Source File SOURCE=..\upnp\src\urlconfig\urlconfig.c # End Source File # Begin Source File SOURCE=..\upnp\src\genlib\util\util.c # End Source File # Begin Source File SOURCE=..\upnp\src\uuid\uuid.c # End Source File # Begin Source File SOURCE=..\upnp\src\genlib\net\http\webserver.c # End Source File # Begin Source File SOURCE=..\upnp\src\win_dll.c # End Source File # End Group # Begin Group "Header-Dateien" # PROP Default_Filter "h;hpp;hxx;hm;inl" # Begin Source File SOURCE=..\upnp\src\inc\client_table.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\config.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\gena.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\gena_ctrlpt.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\gena_device.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\global.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\gmtdate.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\http_client.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\httpparser.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\httpreadwrite.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\inet_pton.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\md5.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\membuffer.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\miniserver.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\netall.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\parsetools.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\server.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\service_table.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\soaplib.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\sock.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\ssdplib.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\statcodes.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\statuscodes.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\strintmap.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\sysdep.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\unixutil.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\upnp_timeout.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\upnpapi.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\uri.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\urlconfig.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\util.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\utilall.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\uuid.h # End Source File # Begin Source File SOURCE=..\upnp\src\inc\webserver.h # End Source File # End Group # Begin Group "Ressourcendateien" # PROP Default_Filter "ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe" # End Group # Begin Source File SOURCE=..\..\..\..\libupnp_win32.patch # End Source File # End Target # End Project pupnp-release-1.8.0/build/libupnp.dsw000066400000000000000000000010301303304015100175470ustar00rootroot00000000000000Microsoft Developer Studio Workspace File, Format Version 6.00 # WARNUNG: DIESE ARBEITSBEREICHSDATEI DARF NICHT BEARBEITET ODER GELSCHT WERDEN! ############################################################################### Project: "libupnp"=.\libupnp.dsp - Package Owner=<4> Package=<5> {{{ }}} Package=<4> {{{ }}} ############################################################################### Global: Package=<5> {{{ }}} Package=<3> {{{ }}} ############################################################################### pupnp-release-1.8.0/build/msvc/000077500000000000000000000000001303304015100163355ustar00rootroot00000000000000pupnp-release-1.8.0/build/msvc/inttypes.h000066400000000000000000000173021303304015100203700ustar00rootroot00000000000000// ISO C9x compliant inttypes.h for Microsoft Visual Studio // Based on ISO/IEC 9899:TC2 Committee draft (May 6, 2005) WG14/N1124 // // Copyright (c) 2006 Alexander Chemeris // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // // 1. Redistributions of source code must retain the above copyright notice, // this list of conditions and the following disclaimer. // // 2. Redistributions in binary form must reproduce the above copyright // notice, this list of conditions and the following disclaimer in the // documentation and/or other materials provided with the distribution. // // 3. The name of the author may be used to endorse or promote products // derived from this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED // WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF // MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO // EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; // OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, // WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR // OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF // ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // /////////////////////////////////////////////////////////////////////////////// #ifndef _MSC_VER // [ #error "Use this header only with Microsoft Visual C++ compilers!" #endif // _MSC_VER ] #ifndef _MSC_INTTYPES_H_ // [ #define _MSC_INTTYPES_H_ #if _MSC_VER > 1000 #pragma once #endif #include // 7.8 Format conversion of integer types typedef struct { intmax_t quot; intmax_t rem; } imaxdiv_t; // 7.8.1 Macros for format specifiers // The fprintf macros for signed integers are: #define PRId8 "d" #define PRIi8 "i" #define PRIdLEAST8 "d" #define PRIiLEAST8 "i" #define PRIdFAST8 "d" #define PRIiFAST8 "i" #define PRId16 "hd" #define PRIi16 "hi" #define PRIdLEAST16 "hd" #define PRIiLEAST16 "hi" #define PRIdFAST16 "hd" #define PRIiFAST16 "hi" #define PRId32 "I32d" #define PRIi32 "I32i" #define PRIdLEAST32 "I32d" #define PRIiLEAST32 "I32i" #define PRIdFAST32 "I32d" #define PRIiFAST32 "I32i" #define PRId64 "I64d" #define PRIi64 "I64i" #define PRIdLEAST64 "I64d" #define PRIiLEAST64 "I64i" #define PRIdFAST64 "I64d" #define PRIiFAST64 "I64i" #define PRIdMAX "I64d" #define PRIiMAX "I64i" #define PRIdPTR "Id" #define PRIiPTR "Ii" // The fprintf macros for unsigned integers are: #define PRIo8 "o" #define PRIu8 "u" #define PRIx8 "x" #define PRIX8 "X" #define PRIoLEAST8 "o" #define PRIuLEAST8 "u" #define PRIxLEAST8 "x" #define PRIXLEAST8 "X" #define PRIoFAST8 "o" #define PRIuFAST8 "u" #define PRIxFAST8 "x" #define PRIXFAST8 "X" #define PRIo16 "ho" #define PRIu16 "hu" #define PRIx16 "hx" #define PRIX16 "hX" #define PRIoLEAST16 "ho" #define PRIuLEAST16 "hu" #define PRIxLEAST16 "hx" #define PRIXLEAST16 "hX" #define PRIoFAST16 "ho" #define PRIuFAST16 "hu" #define PRIxFAST16 "hx" #define PRIXFAST16 "hX" #define PRIo32 "I32o" #define PRIu32 "I32u" #define PRIx32 "I32x" #define PRIX32 "I32X" #define PRIoLEAST32 "I32o" #define PRIuLEAST32 "I32u" #define PRIxLEAST32 "I32x" #define PRIXLEAST32 "I32X" #define PRIoFAST32 "I32o" #define PRIuFAST32 "I32u" #define PRIxFAST32 "I32x" #define PRIXFAST32 "I32X" #define PRIo64 "I64o" #define PRIu64 "I64u" #define PRIx64 "I64x" #define PRIX64 "I64X" #define PRIoLEAST64 "I64o" #define PRIuLEAST64 "I64u" #define PRIxLEAST64 "I64x" #define PRIXLEAST64 "I64X" #define PRIoFAST64 "I64o" #define PRIuFAST64 "I64u" #define PRIxFAST64 "I64x" #define PRIXFAST64 "I64X" #define PRIoMAX "I64o" #define PRIuMAX "I64u" #define PRIxMAX "I64x" #define PRIXMAX "I64X" #define PRIoPTR "Io" #define PRIuPTR "Iu" #define PRIxPTR "Ix" #define PRIXPTR "IX" // The fscanf macros for signed integers are: #define SCNd8 "d" #define SCNi8 "i" #define SCNdLEAST8 "d" #define SCNiLEAST8 "i" #define SCNdFAST8 "d" #define SCNiFAST8 "i" #define SCNd16 "hd" #define SCNi16 "hi" #define SCNdLEAST16 "hd" #define SCNiLEAST16 "hi" #define SCNdFAST16 "hd" #define SCNiFAST16 "hi" #define SCNd32 "ld" #define SCNi32 "li" #define SCNdLEAST32 "ld" #define SCNiLEAST32 "li" #define SCNdFAST32 "ld" #define SCNiFAST32 "li" #define SCNd64 "I64d" #define SCNi64 "I64i" #define SCNdLEAST64 "I64d" #define SCNiLEAST64 "I64i" #define SCNdFAST64 "I64d" #define SCNiFAST64 "I64i" #define SCNdMAX "I64d" #define SCNiMAX "I64i" #ifdef _WIN64 // [ # define SCNdPTR "I64d" # define SCNiPTR "I64i" #else // _WIN64 ][ # define SCNdPTR "ld" # define SCNiPTR "li" #endif // _WIN64 ] // The fscanf macros for unsigned integers are: #define SCNo8 "o" #define SCNu8 "u" #define SCNx8 "x" #define SCNX8 "X" #define SCNoLEAST8 "o" #define SCNuLEAST8 "u" #define SCNxLEAST8 "x" #define SCNXLEAST8 "X" #define SCNoFAST8 "o" #define SCNuFAST8 "u" #define SCNxFAST8 "x" #define SCNXFAST8 "X" #define SCNo16 "ho" #define SCNu16 "hu" #define SCNx16 "hx" #define SCNX16 "hX" #define SCNoLEAST16 "ho" #define SCNuLEAST16 "hu" #define SCNxLEAST16 "hx" #define SCNXLEAST16 "hX" #define SCNoFAST16 "ho" #define SCNuFAST16 "hu" #define SCNxFAST16 "hx" #define SCNXFAST16 "hX" #define SCNo32 "lo" #define SCNu32 "lu" #define SCNx32 "lx" #define SCNX32 "lX" #define SCNoLEAST32 "lo" #define SCNuLEAST32 "lu" #define SCNxLEAST32 "lx" #define SCNXLEAST32 "lX" #define SCNoFAST32 "lo" #define SCNuFAST32 "lu" #define SCNxFAST32 "lx" #define SCNXFAST32 "lX" #define SCNo64 "I64o" #define SCNu64 "I64u" #define SCNx64 "I64x" #define SCNX64 "I64X" #define SCNoLEAST64 "I64o" #define SCNuLEAST64 "I64u" #define SCNxLEAST64 "I64x" #define SCNXLEAST64 "I64X" #define SCNoFAST64 "I64o" #define SCNuFAST64 "I64u" #define SCNxFAST64 "I64x" #define SCNXFAST64 "I64X" #define SCNoMAX "I64o" #define SCNuMAX "I64u" #define SCNxMAX "I64x" #define SCNXMAX "I64X" #ifdef _WIN64 // [ # define SCNoPTR "I64o" # define SCNuPTR "I64u" # define SCNxPTR "I64x" # define SCNXPTR "I64X" #else // _WIN64 ][ # define SCNoPTR "lo" # define SCNuPTR "lu" # define SCNxPTR "lx" # define SCNXPTR "lX" #endif // _WIN64 ] // 7.8.2 Functions for greatest-width integer types // 7.8.2.1 The imaxabs function #define imaxabs _abs64 // 7.8.2.2 The imaxdiv function // This is modified version of div() function from Microsoft's div.c found // in %MSVC.NET%\crt\src\div.c #ifdef STATIC_IMAXDIV // [ static #else // STATIC_IMAXDIV ][ _inline #endif // STATIC_IMAXDIV ] imaxdiv_t __cdecl imaxdiv(intmax_t numer, intmax_t denom) { imaxdiv_t result; result.quot = numer / denom; result.rem = numer % denom; if (numer < 0 && result.rem > 0) { // did division wrong; must fix up ++result.quot; result.rem -= denom; } return result; } // 7.8.2.3 The strtoimax and strtoumax functions #define strtoimax _strtoi64 #define strtoumax _strtoui64 // 7.8.2.4 The wcstoimax and wcstoumax functions #define wcstoimax _wcstoi64 #define wcstoumax _wcstoui64 #endif // _MSC_INTTYPES_H_ ] pupnp-release-1.8.0/build/msvc/stdint.h000066400000000000000000000156061303304015100200230ustar00rootroot00000000000000// ISO C9x compliant stdint.h for Microsoft Visual Studio // Based on ISO/IEC 9899:TC2 Committee draft (May 6, 2005) WG14/N1124 // // Copyright (c) 2006 Alexander Chemeris // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // // 1. Redistributions of source code must retain the above copyright notice, // this list of conditions and the following disclaimer. // // 2. Redistributions in binary form must reproduce the above copyright // notice, this list of conditions and the following disclaimer in the // documentation and/or other materials provided with the distribution. // // 3. The name of the author may be used to endorse or promote products // derived from this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED // WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF // MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO // EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; // OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, // WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR // OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF // ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // /////////////////////////////////////////////////////////////////////////////// #ifndef _MSC_VER // [ #error "Use this header only with Microsoft Visual C++ compilers!" #endif // _MSC_VER ] #ifndef _MSC_STDINT_H_ // [ #define _MSC_STDINT_H_ #if _MSC_VER > 1000 #pragma once #endif #include // For Visual Studio 6 in C++ mode wrap include with 'extern "C++" {}' // or compiler give many errors like this: // error C2733: second C linkage of overloaded function 'wmemchr' not allowed #if (_MSC_VER < 1300) && defined(__cplusplus) extern "C++" { #endif # include #if (_MSC_VER < 1300) && defined(__cplusplus) } #endif // 7.18.1 Integer types // 7.18.1.1 Exact-width integer types typedef __int8 int8_t; typedef __int16 int16_t; typedef __int32 int32_t; typedef __int64 int64_t; typedef unsigned __int8 uint8_t; typedef unsigned __int16 uint16_t; typedef unsigned __int32 uint32_t; typedef unsigned __int64 uint64_t; // 7.18.1.2 Minimum-width integer types typedef int8_t int_least8_t; typedef int16_t int_least16_t; typedef int32_t int_least32_t; typedef int64_t int_least64_t; typedef uint8_t uint_least8_t; typedef uint16_t uint_least16_t; typedef uint32_t uint_least32_t; typedef uint64_t uint_least64_t; // 7.18.1.3 Fastest minimum-width integer types typedef int8_t int_fast8_t; typedef int16_t int_fast16_t; typedef int32_t int_fast32_t; typedef int64_t int_fast64_t; typedef uint8_t uint_fast8_t; typedef uint16_t uint_fast16_t; typedef uint32_t uint_fast32_t; typedef uint64_t uint_fast64_t; // 7.18.1.4 Integer types capable of holding object pointers #ifdef _WIN64 // [ typedef __int64 intptr_t; typedef unsigned __int64 uintptr_t; #else // _WIN64 ][ typedef int intptr_t; typedef unsigned int uintptr_t; #endif // _WIN64 ] // 7.18.1.5 Greatest-width integer types typedef int64_t intmax_t; typedef uint64_t uintmax_t; // 7.18.2 Limits of specified-width integer types #if !defined(__cplusplus) || defined(__STDC_LIMIT_MACROS) // [ See footnote 220 at page 257 and footnote 221 at page 259 // 7.18.2.1 Limits of exact-width integer types #define INT8_MIN ((int8_t)_I8_MIN) #define INT8_MAX _I8_MAX #define INT16_MIN ((int16_t)_I16_MIN) #define INT16_MAX _I16_MAX #define INT32_MIN ((int32_t)_I32_MIN) #define INT32_MAX _I32_MAX #define INT64_MIN ((int64_t)_I64_MIN) #define INT64_MAX _I64_MAX #define UINT8_MAX _UI8_MAX #define UINT16_MAX _UI16_MAX #define UINT32_MAX _UI32_MAX #define UINT64_MAX _UI64_MAX // 7.18.2.2 Limits of minimum-width integer types #define INT_LEAST8_MIN INT8_MIN #define INT_LEAST8_MAX INT8_MAX #define INT_LEAST16_MIN INT16_MIN #define INT_LEAST16_MAX INT16_MAX #define INT_LEAST32_MIN INT32_MIN #define INT_LEAST32_MAX INT32_MAX #define INT_LEAST64_MIN INT64_MIN #define INT_LEAST64_MAX INT64_MAX #define UINT_LEAST8_MAX UINT8_MAX #define UINT_LEAST16_MAX UINT16_MAX #define UINT_LEAST32_MAX UINT32_MAX #define UINT_LEAST64_MAX UINT64_MAX // 7.18.2.3 Limits of fastest minimum-width integer types #define INT_FAST8_MIN INT8_MIN #define INT_FAST8_MAX INT8_MAX #define INT_FAST16_MIN INT16_MIN #define INT_FAST16_MAX INT16_MAX #define INT_FAST32_MIN INT32_MIN #define INT_FAST32_MAX INT32_MAX #define INT_FAST64_MIN INT64_MIN #define INT_FAST64_MAX INT64_MAX #define UINT_FAST8_MAX UINT8_MAX #define UINT_FAST16_MAX UINT16_MAX #define UINT_FAST32_MAX UINT32_MAX #define UINT_FAST64_MAX UINT64_MAX // 7.18.2.4 Limits of integer types capable of holding object pointers #ifdef _WIN64 // [ # define INTPTR_MIN INT64_MIN # define INTPTR_MAX INT64_MAX # define UINTPTR_MAX UINT64_MAX #else // _WIN64 ][ # define INTPTR_MIN INT32_MIN # define INTPTR_MAX INT32_MAX # define UINTPTR_MAX UINT32_MAX #endif // _WIN64 ] // 7.18.2.5 Limits of greatest-width integer types #define INTMAX_MIN INT64_MIN #define INTMAX_MAX INT64_MAX #define UINTMAX_MAX UINT64_MAX // 7.18.3 Limits of other integer types #ifdef _WIN64 // [ # define PTRDIFF_MIN _I64_MIN # define PTRDIFF_MAX _I64_MAX #else // _WIN64 ][ # define PTRDIFF_MIN _I32_MIN # define PTRDIFF_MAX _I32_MAX #endif // _WIN64 ] #define SIG_ATOMIC_MIN INT_MIN #define SIG_ATOMIC_MAX INT_MAX #ifndef SIZE_MAX // [ # ifdef _WIN64 // [ # define SIZE_MAX _UI64_MAX # else // _WIN64 ][ # define SIZE_MAX _UI32_MAX # endif // _WIN64 ] #endif // SIZE_MAX ] // WCHAR_MIN and WCHAR_MAX are also defined in #ifndef WCHAR_MIN // [ # define WCHAR_MIN 0 #endif // WCHAR_MIN ] #ifndef WCHAR_MAX // [ # define WCHAR_MAX _UI16_MAX #endif // WCHAR_MAX ] #define WINT_MIN 0 #define WINT_MAX _UI16_MAX #endif // __STDC_LIMIT_MACROS ] // 7.18.4 Limits of other integer types #if !defined(__cplusplus) || defined(__STDC_CONSTANT_MACROS) // [ See footnote 224 at page 260 // 7.18.4.1 Macros for minimum-width integer constants #define INT8_C(val) val##i8 #define INT16_C(val) val##i16 #define INT32_C(val) val##i32 #define INT64_C(val) val##i64 #define UINT8_C(val) val##ui8 #define UINT16_C(val) val##ui16 #define UINT32_C(val) val##ui32 #define UINT64_C(val) val##ui64 // 7.18.4.2 Macros for greatest-width integer constants #define INTMAX_C INT64_C #define UINTMAX_C UINT64_C #endif // __STDC_CONSTANT_MACROS ] #endif // _MSC_STDINT_H_ ] pupnp-release-1.8.0/build/vc10/000077500000000000000000000000001303304015100161365ustar00rootroot00000000000000pupnp-release-1.8.0/build/vc10/.gitignore000066400000000000000000000000231303304015100201210ustar00rootroot00000000000000 *.suo *.user *.sdfpupnp-release-1.8.0/build/vc10/ixml.vcxproj000066400000000000000000000624621303304015100205360ustar00rootroot00000000000000 Debug Lib Win32 Debug Lib x64 Debug Win32 Debug x64 Release Lib Win32 Release Lib x64 Release Win32 Release x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89} ixml StaticLibrary NotSet true StaticLibrary NotSet StaticLibrary NotSet true StaticLibrary NotSet StaticLibrary NotSet true StaticLibrary NotSet StaticLibrary NotSet true StaticLibrary NotSet <_ProjectFileVersion>10.0.40219.1 $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ true $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ true $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ true $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ true $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ true $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ true $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ true $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ true AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset Disabled ..\..\ixml\inc;..\..\ixml\src\inc;..\inc;..\..\upnp\inc;%(AdditionalIncludeDirectories) DEBUG;WIN32;_USRDLL;LIBUPNP_EXPORTS;UPNP_USE_MSVCPP;IXML_HAVE_SCRIPTSUPPORT;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebugDLL $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC $(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) $(IntDir)$(MSBuildProjectName).log X64 Disabled ..\..\ixml\inc;..\..\ixml\src\inc;..\inc;..\..\upnp\inc;%(AdditionalIncludeDirectories) DEBUG;WIN32;_USRDLL;LIBUPNP_EXPORTS;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebugDLL $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC $(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) MaxSpeed Default true ..\..\ixml\inc;..\..\ixml\src\inc;..\inc;..\..\upnp\inc;%(AdditionalIncludeDirectories) WIN32;RELEASE;NDEBUG;_WINDOWS;_USRDLL;LIBUPNP_EXPORTS;UPNP_USE_MSVCPP;IXML_HAVE_SCRIPTSUPPORT;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreadedDLL true $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC $(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) X64 MaxSpeed Default true ..\..\ixml\inc;..\..\ixml\src\inc;..\inc;..\..\upnp\inc;%(AdditionalIncludeDirectories) WIN32;NDEBUG;_WINDOWS;_USRDLL;LIBUPNP_EXPORTS;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreadedDLL true $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC $(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) Disabled ..\..\ixml\inc;..\..\ixml\src\inc;..\inc;..\..\upnp\inc;%(AdditionalIncludeDirectories) IXML_HAVE_SCRIPTSUPPORT;DEBUG;WIN32;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebug $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC $(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) X64 Disabled ..\..\ixml\inc;..\..\ixml\src\inc;..\inc;..\..\upnp\inc;%(AdditionalIncludeDirectories) DEBUG;WIN32;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebug $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC $(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) MaxSpeed Default true ..\..\ixml\inc;..\..\ixml\src\inc;..\inc;..\..\upnp\inc;%(AdditionalIncludeDirectories) IXML_HAVE_SCRIPTSUPPORT;WIN32;NDEBUG;RELEASE;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreaded true $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC $(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) X64 MaxSpeed Default true ..\..\ixml\inc;..\..\ixml\src\inc;..\inc;..\..\upnp\inc;%(AdditionalIncludeDirectories) WIN32;NDEBUG;RELEASE;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreaded true $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC $(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) pupnp-release-1.8.0/build/vc10/ixml.vcxproj.filters000066400000000000000000000040601303304015100221730ustar00rootroot00000000000000 {4FC737F1-C7A5-4376-A066-2A32D752A2FF} cpp;c;cc;cxx;def;odl;idl;hpj;bat;asm;asmx {93995380-89BD-4b04-88EB-625FBE52EBFB} h;hpp;hxx;hm;inl;inc;xsd Source Files Source Files Source Files Source Files Source Files Source Files Source Files Source Files Source Files Source Files Header Files Header Files Header Files Header Files pupnp-release-1.8.0/build/vc10/libupnp.sln000066400000000000000000000231371303304015100203330ustar00rootroot00000000000000 Microsoft Visual Studio Solution File, Format Version 11.00 # Visual Studio 2010 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "libupnp", "libupnp.vcxproj", "{6227F51A-1498-4C4A-B213-F6FDED605125}" EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "ixml", "ixml.vcxproj", "{9C2C266D-35A3-465F-A297-0E21D54E5C89}" EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "threadutil", "threadutil.vcxproj", "{1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}" EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "tvctrlpt", "tvctrlpt.vcxproj", "{8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}" EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "tvdevice", "tvdevice.vcxproj", "{7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}" EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "tvcombo", "tvcombo.vcxproj", "{6365804B-22C6-4D5E-91F3-0C052EB55B4F}" EndProject Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{55AF07A8-18AA-45B8-A231-5082F1C6FC08}" ProjectSection(SolutionItems) = preProject ..\..\AUTHORS = ..\..\AUTHORS ..\..\bootstrap = ..\..\bootstrap ..\..\ChangeLog = ..\..\ChangeLog ..\..\configure.ac = ..\..\configure.ac ..\..\COPYING = ..\..\COPYING ..\..\Doxyfile = ..\..\Doxyfile ..\..\INSTALL = ..\..\INSTALL ..\..\libupnp-1.8.pc.in = ..\..\libupnp-1.8.pc.in ..\..\libupnp.spec = ..\..\libupnp.spec ..\..\LICENSE = ..\..\LICENSE ..\..\Makefile.am = ..\..\Makefile.am ..\..\NEWS = ..\..\NEWS ..\..\README = ..\..\README ..\..\THANKS = ..\..\THANKS ..\..\TODO = ..\..\TODO EndProjectSection EndProject Global GlobalSection(SolutionConfigurationPlatforms) = preSolution Debug Lib|Win32 = Debug Lib|Win32 Debug Lib|x64 = Debug Lib|x64 Debug|Win32 = Debug|Win32 Debug|x64 = Debug|x64 Release Lib|Win32 = Release Lib|Win32 Release Lib|x64 = Release Lib|x64 Release|Win32 = Release|Win32 Release|x64 = Release|x64 EndGlobalSection GlobalSection(ProjectConfigurationPlatforms) = postSolution {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug Lib|Win32.ActiveCfg = Debug Lib|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug Lib|Win32.Build.0 = Debug Lib|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug Lib|x64.ActiveCfg = Debug Lib|x64 {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug Lib|x64.Build.0 = Debug Lib|x64 {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug|Win32.ActiveCfg = Debug|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug|Win32.Build.0 = Debug|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug|x64.ActiveCfg = Debug|x64 {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug|x64.Build.0 = Debug|x64 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release Lib|Win32.ActiveCfg = Release Lib|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release Lib|Win32.Build.0 = Release Lib|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release Lib|x64.ActiveCfg = Release Lib|x64 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release Lib|x64.Build.0 = Release Lib|x64 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release|Win32.ActiveCfg = Release|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release|Win32.Build.0 = Release|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release|x64.ActiveCfg = Release|x64 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release|x64.Build.0 = Release|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug Lib|Win32.ActiveCfg = Debug Lib|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug Lib|Win32.Build.0 = Debug Lib|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug Lib|x64.ActiveCfg = Debug Lib|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug Lib|x64.Build.0 = Debug Lib|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug|Win32.ActiveCfg = Debug|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug|Win32.Build.0 = Debug|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug|x64.ActiveCfg = Debug|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug|x64.Build.0 = Debug|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release Lib|Win32.ActiveCfg = Release Lib|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release Lib|Win32.Build.0 = Release Lib|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release Lib|x64.ActiveCfg = Release Lib|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release Lib|x64.Build.0 = Release Lib|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release|Win32.ActiveCfg = Release|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release|Win32.Build.0 = Release|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release|x64.ActiveCfg = Release|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release|x64.Build.0 = Release|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug Lib|Win32.ActiveCfg = Debug Lib|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug Lib|Win32.Build.0 = Debug Lib|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug Lib|x64.ActiveCfg = Debug Lib|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug Lib|x64.Build.0 = Debug Lib|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug|Win32.ActiveCfg = Debug|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug|Win32.Build.0 = Debug|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug|x64.ActiveCfg = Debug|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug|x64.Build.0 = Debug|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release Lib|Win32.ActiveCfg = Release Lib|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release Lib|Win32.Build.0 = Release Lib|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release Lib|x64.ActiveCfg = Release Lib|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release Lib|x64.Build.0 = Release Lib|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release|Win32.ActiveCfg = Release|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release|Win32.Build.0 = Release|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release|x64.ActiveCfg = Release|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release|x64.Build.0 = Release|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug Lib|Win32.ActiveCfg = Debug Lib|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug Lib|Win32.Build.0 = Debug Lib|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug Lib|x64.ActiveCfg = Debug Lib|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug Lib|x64.Build.0 = Debug Lib|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug|Win32.ActiveCfg = Debug|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug|Win32.Build.0 = Debug|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug|x64.ActiveCfg = Debug|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug|x64.Build.0 = Debug|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release Lib|Win32.ActiveCfg = Release Lib|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release Lib|Win32.Build.0 = Release Lib|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release Lib|x64.ActiveCfg = Release Lib|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release Lib|x64.Build.0 = Release Lib|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release|Win32.ActiveCfg = Release|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release|Win32.Build.0 = Release|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release|x64.ActiveCfg = Release|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release|x64.Build.0 = Release|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug Lib|Win32.ActiveCfg = Debug Lib|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug Lib|Win32.Build.0 = Debug Lib|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug Lib|x64.ActiveCfg = Debug Lib|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug Lib|x64.Build.0 = Debug Lib|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug|Win32.ActiveCfg = Debug|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug|Win32.Build.0 = Debug|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug|x64.ActiveCfg = Debug|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug|x64.Build.0 = Debug|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release Lib|Win32.ActiveCfg = Release Lib|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release Lib|Win32.Build.0 = Release Lib|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release Lib|x64.ActiveCfg = Release Lib|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release Lib|x64.Build.0 = Release Lib|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release|Win32.ActiveCfg = Release|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release|Win32.Build.0 = Release|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release|x64.ActiveCfg = Release|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release|x64.Build.0 = Release|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug Lib|Win32.ActiveCfg = Debug Lib|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug Lib|Win32.Build.0 = Debug Lib|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug Lib|x64.ActiveCfg = Debug Lib|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug Lib|x64.Build.0 = Debug Lib|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug|Win32.ActiveCfg = Debug|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug|Win32.Build.0 = Debug|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug|x64.ActiveCfg = Debug|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug|x64.Build.0 = Debug|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release Lib|Win32.ActiveCfg = Release Lib|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release Lib|Win32.Build.0 = Release Lib|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release Lib|x64.ActiveCfg = Release Lib|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release Lib|x64.Build.0 = Release Lib|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release|Win32.ActiveCfg = Release|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release|Win32.Build.0 = Release|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release|x64.ActiveCfg = Release|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release|x64.Build.0 = Release|x64 EndGlobalSection GlobalSection(SolutionProperties) = preSolution HideSolutionNode = FALSE EndGlobalSection EndGlobal pupnp-release-1.8.0/build/vc10/libupnp.vcxproj000066400000000000000000001240221303304015100212250ustar00rootroot00000000000000 Debug Lib Win32 Debug Lib x64 Debug Win32 Debug x64 Release Lib Win32 Release Lib x64 Release Win32 Release x64 {6227F51A-1498-4C4A-B213-F6FDED605125} libupnp StaticLibrary false NotSet true StaticLibrary false NotSet DynamicLibrary false NotSet DynamicLibrary false NotSet true StaticLibrary false NotSet true StaticLibrary false NotSet DynamicLibrary false NotSet DynamicLibrary false NotSet true <_ProjectFileVersion>10.0.40219.1 $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ $(SolutionDir)\out.vc10.$(Platform)\$(Configuration)\lib\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ $(SolutionDir)\out.vc10.$(Platform)\$(Configuration)\lib\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset NDEBUG;%(PreprocessorDefinitions) true true Win32 .\Release/libupnp.tlb MaxSpeed Default true true ..\inc;..\msvc;..\..\upnp\inc;..\..\upnp\src\inc;..\..\ixml\inc;..\..\ixml\src\inc;..\..\threadutil\inc;..\..\pthreads;..\..\pthreads\include;%(AdditionalIncludeDirectories) IXML_HAVE_SCRIPTSUPPORT;WIN32;NDEBUG;RELEASE;_WINDOWS;_USRDLL;LIBUPNP_EXPORTS;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreadedDLL true $(IntDir) $(IntDir) $(IntDir)$(ProjectName).pdb Level3 true ProgramDatabase CompileAsC NDEBUG;%(PreprocessorDefinitions) 0x0407 pthreadvc2.lib;ws2_32.lib;iphlpapi.lib;ixml.lib;threadutil.lib;%(AdditionalDependencies) $(OutDir)$(ProjectName).dll true ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\ixml;$(OutDir)..\lib\threadutil;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Windows true true UseLinkTimeCodeGeneration false $(TargetDir)$(TargetName).lib MachineX86 true .\Release/libupnp.bsc Add pthreadVC2.dll to output NDEBUG;%(PreprocessorDefinitions) true true X64 .\Release/libupnp.tlb MaxSpeed Default true true $(SolutionDir)\..\inc;$(SolutionDir)\..\msvc;$(SolutionDir)\..\..\upnp\inc;$(SolutionDir)\..\..\upnp\src\inc;$(SolutionDir)\..\..\ixml\inc;$(SolutionDir)\..\..\ixml\src\inc;$(SolutionDir)\..\..\threadutil\inc;$(SolutionDir)\..\..\pthreads;$(SolutionDir)\..\..\pthreads\include;%(AdditionalIncludeDirectories) WIN32;NDEBUG;_WINDOWS;_USRDLL;LIBUPNP_EXPORTS;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreadedDLL true $(IntDir) $(IntDir) $(IntDir)$(ProjectName).pdb Level3 true ProgramDatabase CompileAsC NDEBUG;%(PreprocessorDefinitions) 0x0407 pthreadvc2.lib;ws2_32.lib;iphlpapi.lib;ixml.lib;threadutil.lib;%(AdditionalDependencies) $(OutDir)$(ProjectName).dll true ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\ixml;$(OutDir)..\lib\threadutil;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Windows true true UseLinkTimeCodeGeneration false $(TargetDir)$(TargetName).lib MachineX64 true .\Release/libupnp.bsc _DEBUG;%(PreprocessorDefinitions) true true Win32 .\Debug/libupnp.tlb Disabled ..\inc;..\msvc;..\..\upnp\inc;..\..\upnp\src\inc;..\..\ixml\inc;..\..\ixml\src\inc;..\..\threadutil\inc;..\..\pthreads;..\..\pthreads\include;%(AdditionalIncludeDirectories) IXML_HAVE_SCRIPTSUPPORT;DEBUG;WIN32;_WINDOWS;_USRDLL;LIBUPNP_EXPORTS;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebugDLL $(IntDir) $(IntDir) Level3 true ProgramDatabase CompileAsC _DEBUG;%(PreprocessorDefinitions) 0x0407 pthreadvc2.lib;ws2_32.lib;iphlpapi.lib;ixml.lib;threadutil.lib;%(AdditionalDependencies) $(OutDir)$(ProjectName).dll true ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\ixml;$(OutDir)..\lib\threadutil;%(AdditionalLibraryDirectories) true Windows false $(TargetDir)$(TargetName).lib MachineX86 true $(OutDir)libupnp.bsc $(IntDir)$(MSBuildProjectName).log _DEBUG;%(PreprocessorDefinitions) true true X64 .\Debug/libupnp.tlb Disabled $(SolutionDir)\..\inc;$(SolutionDir)\..\msvc;$(SolutionDir)\..\..\upnp\inc;$(SolutionDir)\..\..\upnp\src\inc;$(SolutionDir)\..\..\ixml\inc;$(SolutionDir)\..\..\ixml\src\inc;$(SolutionDir)\..\..\threadutil\inc;$(SolutionDir)\..\..\pthreads;$(SolutionDir)\..\..\pthreads\include;%(AdditionalIncludeDirectories) DEBUG;WIN32;_USRDLL;LIBUPNP_EXPORTS;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebugDLL $(IntDir) $(IntDir) $(IntDir)$(ProjectName).pdb Level3 true ProgramDatabase CompileAsC _DEBUG;%(PreprocessorDefinitions) 0x0407 pthreadvc2.lib;ws2_32.lib;iphlpapi.lib;ixml.lib;threadutil.lib;%(AdditionalDependencies) $(OutDir)$(ProjectName).dll true ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\ixml;$(OutDir)..\lib\threadutil;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Windows false $(TargetDir)$(TargetName).lib MachineX64 true $(OutDir)libupnp.bsc _DEBUG;%(PreprocessorDefinitions) true true Win32 .\Debug/libupnp.tlb Disabled ..\inc;..\msvc;..\..\upnp\inc;..\..\upnp\src\inc;..\..\ixml\inc;..\..\ixml\src\inc;..\..\threadutil\inc;..\..\pthreads;..\..\pthreads\include;%(AdditionalIncludeDirectories) IXML_HAVE_SCRIPTSUPPORT;WIN32;DEBUG;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebug $(IntDir) $(IntDir) $(OutDir)$(ProjectName).pdb Level3 true ProgramDatabase CompileAsC _DEBUG;%(PreprocessorDefinitions) 0x0407 ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\ixml;$(OutDir)..\lib\threadutil;%(AdditionalLibraryDirectories) true $(OutDir)libupnp.bsc _DEBUG;%(PreprocessorDefinitions) true true X64 .\Debug/libupnp.tlb Disabled $(SolutionDir)\..\inc;$(SolutionDir)\..\msvc;$(SolutionDir)\..\..\upnp\inc;$(SolutionDir)\..\..\upnp\src\inc;$(SolutionDir)\..\..\ixml\inc;$(SolutionDir)\..\..\ixml\src\inc;$(SolutionDir)\..\..\threadutil\inc;$(SolutionDir)\..\..\pthreads;$(SolutionDir)\..\..\pthreads\include;%(AdditionalIncludeDirectories) WIN32;DEBUG;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebug $(IntDir) $(IntDir) $(OutDir)$(ProjectName).pdb Level3 true ProgramDatabase CompileAsC _DEBUG;%(PreprocessorDefinitions) 0x0407 ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\ixml;$(OutDir)..\lib\threadutil;%(AdditionalLibraryDirectories) true $(OutDir)libupnp.bsc NDEBUG;%(PreprocessorDefinitions) true true Win32 .\Release/libupnp.tlb MaxSpeed Default true true ..\inc;..\msvc;..\..\upnp\inc;..\..\upnp\src\inc;..\..\ixml\inc;..\..\ixml\src\inc;..\..\threadutil\inc;..\..\pthreads;..\..\pthreads\include;%(AdditionalIncludeDirectories) IXML_HAVE_SCRIPTSUPPORT;WIN32;NDEBUG;RELEASE;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreaded true $(IntDir) $(IntDir) $(OutDir)$(ProjectName).pdb Level3 true ProgramDatabase CompileAsC NDEBUG;%(PreprocessorDefinitions) 0x0407 ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\ixml;$(OutDir)..\lib\threadutil;%(AdditionalLibraryDirectories) true .\Release/libupnp.bsc NDEBUG;%(PreprocessorDefinitions) true true X64 .\Release/libupnp.tlb MaxSpeed Default true true $(SolutionDir)\..\inc;$(SolutionDir)\..\msvc;$(SolutionDir)\..\..\upnp\inc;$(SolutionDir)\..\..\upnp\src\inc;$(SolutionDir)\..\..\ixml\inc;$(SolutionDir)\..\..\ixml\src\inc;$(SolutionDir)\..\..\threadutil\inc;$(SolutionDir)\..\..\pthreads;$(SolutionDir)\..\..\pthreads\include;%(AdditionalIncludeDirectories) WIN32;NDEBUG;RELEASE;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreaded true $(IntDir) $(IntDir) $(OutDir)$(ProjectName).pdb Level3 true ProgramDatabase CompileAsC NDEBUG;%(PreprocessorDefinitions) 0x0407 ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\ixml;$(OutDir)..\lib\threadutil;%(AdditionalLibraryDirectories) true .\Release/libupnp.bsc {9c2c266d-35a3-465f-a297-0e21d54e5c89} false {1d3eef7a-d248-48c0-b6b5-eca229fe4b3d} false pupnp-release-1.8.0/build/vc10/libupnp.vcxproj.filters000066400000000000000000000262541303304015100227040ustar00rootroot00000000000000 {47d40159-145c-4ff3-98f5-9b2c96c80092} cpp;c;cxx;rc;def;r;odl;idl;hpj;bat {2a8d348a-a429-4b41-9934-050df3866f50} h;hpp;hxx;hm;inl sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources sources headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers headers pupnp-release-1.8.0/build/vc10/threadutil.vcxproj000066400000000000000000000575001303304015100217270ustar00rootroot00000000000000 Debug Lib Win32 Debug Lib x64 Debug Win32 Debug x64 Release Lib Win32 Release Lib x64 Release Win32 Release x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D} threadutil StaticLibrary NotSet true StaticLibrary NotSet StaticLibrary NotSet true StaticLibrary NotSet StaticLibrary NotSet true StaticLibrary NotSet StaticLibrary NotSet true StaticLibrary NotSet <_ProjectFileVersion>10.0.40219.1 $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\lib\$(ProjectName)\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset Disabled ..\..\threadutil\inc;..\..\upnp\inc;..\..\pthreads;..\..\pthreads\include;%(AdditionalIncludeDirectories) DEBUG;WIN32;_USRDLL;LIBUPNP_EXPORTS;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebugDLL $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) $(IntDir)$(MSBuildProjectName).log X64 Disabled ..\..\threadutil\inc;..\..\upnp\inc;..\..\pthreads;..\..\pthreads\include;%(AdditionalIncludeDirectories) DEBUG;WIN32;_USRDLL;LIBUPNP_EXPORTS;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebugDLL $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) MaxSpeed Default true ..\..\threadutil\inc;..\..\upnp\inc;..\..\pthreads;..\..\pthreads\include;%(AdditionalIncludeDirectories) WIN32;NDEBUG;_WINDOWS;_USRDLL;LIBUPNP_EXPORTS;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreadedDLL true $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) X64 MaxSpeed Default true ..\..\threadutil\inc;..\..\upnp\inc;..\..\pthreads;..\..\pthreads\include;%(AdditionalIncludeDirectories) WIN32;NDEBUG;_WINDOWS;_USRDLL;LIBUPNP_EXPORTS;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreadedDLL true $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) Disabled ..\..\threadutil\inc;..\..\upnp\inc;..\..\pthreads;..\..\pthreads\include;%(AdditionalIncludeDirectories) DEBUG;WIN32;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebug $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) X64 Disabled ..\..\threadutil\inc;..\..\upnp\inc;..\..\pthreads;..\..\pthreads\include;%(AdditionalIncludeDirectories) DEBUG;WIN32;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebug $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) MaxSpeed Default true ..\..\threadutil\inc;..\..\upnp\inc;..\..\pthreads;..\..\pthreads\include;%(AdditionalIncludeDirectories) WIN32;NDEBUG;RELEASE;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreaded true $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) X64 MaxSpeed Default true ..\..\threadutil\inc;..\..\upnp\inc;..\..\pthreads;..\..\pthreads\include;%(AdditionalIncludeDirectories) WIN32;NDEBUG;RELEASE;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreaded true $(IntDir) $(OutDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) pupnp-release-1.8.0/build/vc10/threadutil.vcxproj.filters000066400000000000000000000031411303304015100233660ustar00rootroot00000000000000 {4FC737F1-C7A5-4376-A066-2A32D752A2FF} cpp;c;cc;cxx;def;odl;idl;hpj;bat;asm;asmx {93995380-89BD-4b04-88EB-625FBE52EBFB} h;hpp;hxx;hm;inl;inc;xsd Source Files Source Files Source Files Source Files Header Files Header Files Header Files Header Files Header Files pupnp-release-1.8.0/build/vc10/tvcombo.vcxproj000066400000000000000000000733501303304015100212340ustar00rootroot00000000000000 Debug Lib Win32 Debug Lib x64 Debug Win32 Debug x64 Release Lib Win32 Release Lib x64 Release Win32 Release x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F} tvcombo Application NotSet true Application NotSet Application NotSet true Application NotSet Application NotSet true Application NotSet Application NotSet true Application NotSet <_ProjectFileVersion>10.0.40219.1 $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset Disabled ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;DEBUG;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebugDLL $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\libupnp;$(OutDir)..\lib\threadutil;$(OutDir)..\lib\ixml;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console MachineX86 $(IntDir)$(MSBuildProjectName).log copy "$(SolutionDir)..\..\pthreads\lib\pthread*.dll" "$(OutDir)" mkdir "$(OutDir)web" xcopy "$(SolutionDir)..\..\upnp\sample\web" "$(OutDir)web" /S /E /Y Copy sample web folder and pthreadVC2.dll to output dir X64 Disabled ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;DEBUG;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebugDLL $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console MachineX64 MaxSpeed true ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;RELEASE;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreadedDLL true $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\libupnp;$(OutDir)..\lib\threadutil;$(OutDir)..\lib\ixml;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console true true MachineX86 copy "$(SolutionDir)..\..\pthreads\lib\pthread*.dll" "$(OutDir)" mkdir "$(OutDir)web" xcopy "$(SolutionDir)..\..\upnp\sample\web" "$(OutDir)web" /S /E /Y Copy sample web folder and pthreadVC2.dll to output dir X64 MaxSpeed true ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;RELEASE;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreadedDLL true $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console true true MachineX64 Disabled ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;DEBUG;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebug $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;ws2_32.lib;iphlpapi.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\libupnp;$(OutDir)..\lib\threadutil;$(OutDir)..\lib\ixml;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console MachineX86 copy "$(SolutionDir)..\..\pthreads\lib\pthread*.dll" "$(OutDir)" mkdir "$(OutDir)web" xcopy "$(SolutionDir)..\..\upnp\sample\web" "$(OutDir)web" /S /E /Y Copy sample web folder and pthreadVC2.dll to output dir X64 Disabled ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;DEBUG;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebug $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;ws2_32.lib;iphlpapi.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console MachineX64 MaxSpeed true ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;NDEBUG;RELEASE;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreaded true $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;ws2_32.lib;iphlpapi.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\libupnp;$(OutDir)..\lib\threadutil;$(OutDir)..\lib\ixml;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console true true MachineX86 copy "$(SolutionDir)..\..\pthreads\lib\pthread*.dll" "$(OutDir)" mkdir "$(OutDir)web" xcopy "$(SolutionDir)..\..\upnp\sample\web" "$(OutDir)web" /S /E /Y Copy sample web folder and pthreadVC2.dll to output dir X64 MaxSpeed true ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;NDEBUG;RELEASE;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreaded true $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;ws2_32.lib;iphlpapi.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console true true MachineX64 {6227f51a-1498-4c4a-b213-f6fded605125} false pupnp-release-1.8.0/build/vc10/tvcombo.vcxproj.filters000066400000000000000000000026401303304015100226750ustar00rootroot00000000000000 {4FC737F1-C7A5-4376-A066-2A32D752A2FF} cpp;c;cc;cxx;def;odl;idl;hpj;bat;asm;asmx {93995380-89BD-4b04-88EB-625FBE52EBFB} h;hpp;hxx;hm;inl;inc;xsd Source Files Source Files Source Files Source Files Header Files Header Files Header Files pupnp-release-1.8.0/build/vc10/tvctrlpt.vcxproj000066400000000000000000000733031303304015100214430ustar00rootroot00000000000000 Debug Lib Win32 Debug Lib x64 Debug Win32 Debug x64 Release Lib Win32 Release Lib x64 Release Win32 Release x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5} sample Application MultiByte true Application MultiByte Application MultiByte true Application MultiByte Application MultiByte true Application MultiByte Application MultiByte true Application MultiByte <_ProjectFileVersion>10.0.40219.1 $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)\out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)\out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)\out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)\out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)\out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset Disabled ..\..\upnp\inc;..\..\upnp\sample\common;..\..\ixml\inc;..\inc;..\..\threadutil\inc;..\..\pthreads;..\..\pthreads\include;..\..\upnp\sample\tvctrlpt\linux;..\..\upnp\sample\tvctrlpt;%(AdditionalIncludeDirectories) WIN32;DEBUG;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebugDLL $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\libupnp;$(OutDir)..\lib\threadutil;$(OutDir)..\lib\ixml;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console MachineX86 $(IntDir)$(MSBuildProjectName).log copy "$(SolutionDir)..\..\pthreads\lib\pthread*.dll" "$(OutDir)" mkdir "$(OutDir)web" xcopy "$(SolutionDir)..\..\upnp\sample\web" "$(OutDir)web" /S /E /Y Copy sample web folder and pthreadVC2.dll to output dir X64 Disabled ..\..\upnp\inc;..\..\upnp\sample\common;..\..\ixml\inc;..\inc;..\..\threadutil\inc;..\..\pthreads;..\..\pthreads\include;..\..\upnp\sample\tvctrlpt\linux;..\..\upnp\sample\tvctrlpt;%(AdditionalIncludeDirectories) WIN32;DEBUG;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebugDLL $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console MachineX64 MaxSpeed true ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;RELEASE;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreadedDLL true $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\libupnp;$(OutDir)..\lib\threadutil;$(OutDir)..\lib\ixml;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console true true MachineX86 copy "$(SolutionDir)..\..\pthreads\lib\pthread*.dll" "$(OutDir)" mkdir "$(OutDir)web" xcopy "$(SolutionDir)..\..\upnp\sample\web" "$(OutDir)web" /S /E /Y Copy sample web folder and pthreadVC2.dll to output dir X64 MaxSpeed true ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;RELEASE;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreadedDLL true $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console true true MachineX64 Disabled ..\..\upnp\inc;..\..\upnp\sample\common;..\..\ixml\inc;..\inc;..\..\threadutil\inc;..\..\pthreads;..\..\pthreads\include;..\..\upnp\sample\tvctrlpt\linux;..\..\upnp\sample\tvctrlpt;%(AdditionalIncludeDirectories) WIN32;DEBUG;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebug $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;ws2_32.lib;iphlpapi.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\libupnp;$(OutDir)..\lib\threadutil;$(OutDir)..\lib\ixml;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console MachineX86 copy "$(SolutionDir)..\..\pthreads\lib\pthread*.dll" "$(OutDir)" mkdir "$(OutDir)web" xcopy "$(SolutionDir)..\..\upnp\sample\web" "$(OutDir)web" /S /E /Y Copy sample web folder and pthreadVC2.dll to output dir X64 Disabled ..\..\upnp\inc;..\..\upnp\sample\common;..\..\ixml\inc;..\inc;..\..\threadutil\inc;..\..\pthreads;..\..\pthreads\include;..\..\upnp\sample\tvctrlpt\linux;..\..\upnp\sample\tvctrlpt;%(AdditionalIncludeDirectories) WIN32;DEBUG;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebug $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;ws2_32.lib;iphlpapi.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console MachineX64 MaxSpeed true ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;NDEBUG;RELEASE;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreaded true $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;ws2_32.lib;iphlpapi.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\libupnp;$(OutDir)..\lib\threadutil;$(OutDir)..\lib\ixml;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console true true MachineX86 copy "$(SolutionDir)..\..\pthreads\lib\pthread*.dll" "$(OutDir)" mkdir "$(OutDir)web" xcopy "$(SolutionDir)..\..\upnp\sample\web" "$(OutDir)web" /S /E /Y Copy sample web folder and pthreadVC2.dll to output dir X64 MaxSpeed true ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;NDEBUG;RELEASE;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreaded true $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;ws2_32.lib;iphlpapi.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console true true MachineX64 {6227f51a-1498-4c4a-b213-f6fded605125} false pupnp-release-1.8.0/build/vc10/tvctrlpt.vcxproj.filters000066400000000000000000000022711303304015100231060ustar00rootroot00000000000000 {4FC737F1-C7A5-4376-A066-2A32D752A2FF} cpp;c;cc;cxx;def;odl;idl;hpj;bat;asm;asmx {93995380-89BD-4b04-88EB-625FBE52EBFB} h;hpp;hxx;hm;inl;inc;xsd Source Files Source Files Source Files Header Files Header Files pupnp-release-1.8.0/build/vc10/tvdevice.vcxproj000066400000000000000000000736361303304015100214030ustar00rootroot00000000000000 Debug Lib Win32 Debug Lib x64 Debug Win32 Debug x64 Release Lib Win32 Release Lib x64 Release Win32 Release x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A} tvdevice Application MultiByte true Application MultiByte Application MultiByte true Application MultiByte Application MultiByte true Application MultiByte Application MultiByte true Application MultiByte <_ProjectFileVersion>10.0.40219.1 $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\bin\ $(SolutionDir)out.vc10.$(Platform)\$(Configuration)\tmp\$(ProjectName)\ false AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset AllRules.ruleset Disabled ..\..\upnp\inc;..\..\ixml\inc;..\..\upnp\sample\common;..\inc;..\..\threadutil\inc;..\..\pthreads;..\..\pthreads\include;..\..\upnp\sample\tvdevice;..\..\upnp\sample\tvdevice\linux;%(AdditionalIncludeDirectories) WIN32;DEBUG;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebugDLL $(IntDir) Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\libupnp;$(OutDir)..\lib\threadutil;$(OutDir)..\lib\ixml;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true Console MachineX86 $(IntDir)$(MSBuildProjectName).log copy "$(SolutionDir)..\..\pthreads\lib\pthread*.dll" "$(OutDir)" mkdir "$(OutDir)web" xcopy "$(SolutionDir)..\..\upnp\sample\web" "$(OutDir)web" /S /E /Y Copy sample web folder and pthreadVC2.dll to output dir X64 Disabled ..\..\upnp\inc;..\..\ixml\inc;..\..\upnp\sample\common;..\inc;..\..\threadutil\inc;..\..\pthreads;..\..\pthreads\include;..\..\upnp\sample\tvdevice;..\..\upnp\sample\tvdevice\linux;%(AdditionalIncludeDirectories) WIN32;DEBUG;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebugDLL $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console MachineX64 MaxSpeed true ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;RELEASE;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreadedDLL true $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\libupnp;$(OutDir)..\lib\threadutil;$(OutDir)..\lib\ixml;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console true true MachineX86 copy "$(SolutionDir)..\..\pthreads\lib\pthread*.dll" "$(OutDir)" mkdir "$(OutDir)web" xcopy "$(SolutionDir)..\..\upnp\sample\web" "$(OutDir)web" /S /E /Y Copy sample web folder and pthreadVC2.dll to output dir X64 MaxSpeed true ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;RELEASE;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreadedDLL true $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console true true MachineX64 Disabled ..\..\upnp\inc;..\..\ixml\inc;..\..\upnp\sample\common;..\inc;..\..\threadutil\inc;..\..\pthreads;..\..\pthreads\include;..\..\upnp\sample\tvdevice;..\..\upnp\sample\tvdevice\linux;%(AdditionalIncludeDirectories) WIN32;DEBUG;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebug $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;ws2_32.lib;iphlpapi.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\libupnp;$(OutDir)..\lib\threadutil;$(OutDir)..\lib\ixml;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console MachineX86 copy "$(SolutionDir)..\..\pthreads\lib\pthread*.dll" "$(OutDir)" mkdir "$(OutDir)web" xcopy "$(SolutionDir)..\..\upnp\sample\web" "$(OutDir)web" /S /E /Y Copy sample web folder and pthreadVC2.dll to output dir X64 Disabled ..\..\upnp\inc;..\..\ixml\inc;..\..\upnp\sample\common;..\inc;..\..\threadutil\inc;..\..\pthreads;..\..\pthreads\include;..\..\upnp\sample\tvdevice;..\..\upnp\sample\tvdevice\linux;%(AdditionalIncludeDirectories) WIN32;DEBUG;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true EnableFastChecks MultiThreadedDebug $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;ws2_32.lib;iphlpapi.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console MachineX64 MaxSpeed true ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;NDEBUG;RELEASE;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreaded true $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;ws2_32.lib;iphlpapi.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib\libupnp;$(OutDir)..\lib\threadutil;$(OutDir)..\lib\ixml;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console true true MachineX86 copy "$(SolutionDir)..\..\pthreads\lib\pthread*.dll" "$(OutDir)" mkdir "$(OutDir)web" xcopy "$(SolutionDir)..\..\upnp\sample\web" "$(OutDir)web" /S /E /Y Copy sample web folder and pthreadVC2.dll to output dir X64 MaxSpeed true ..\..\upnp\inc;..\..\upnp\sample\common;..\..\upnp\sample;..\..\ixml\inc;..\..\pthreads;..\..\pthreads\include;..\inc;..\..\threadutil\inc;..\..\upnp\sample\tvcombo;%(AdditionalIncludeDirectories) WIN32;NDEBUG;RELEASE;_WINDOWS;PTW32_STATIC_LIB;UPNP_STATIC_LIB;UPNP_USE_MSVCPP;_CRT_NONSTDC_NO_WARNINGS;_CRT_NONSTDC_NO_DEPRECATE;_CRT_SECURE_NO_WARNINGS;_CRT_SECURE_NO_DEPRECATE;_SECURE_SCL;_SCL_SECURE_NO_WARNINGS;_SCL_SECURE_NO_DEPRECATE;_AFX_SECURE_NO_WARNINGS;_AFX_SECURE_NO_DEPRECATE;_SECURE_ATL;_ATL_NO_COM_SUPPORT;_ATL_SECURE_NO_WARNINGS;_ATL_SECURE_NO_DEPRECATE;%(PreprocessorDefinitions) true MultiThreaded true $(IntDir) $(IntDir)$(ProjectName).pdb Level3 ProgramDatabase CompileAsC pthreadVC2.lib;ixml.lib;threadutil.lib;libupnp.lib;ws2_32.lib;iphlpapi.lib;%(AdditionalDependencies) ..\..\pthreads\;..\..\pthreads\lib;$(OutDir)..\lib;$(OutDir)..\bin;%(AdditionalLibraryDirectories) true $(OutDir)$(ProjectName).pdb Console true true MachineX64 {6227f51a-1498-4c4a-b213-f6fded605125} false pupnp-release-1.8.0/build/vc10/tvdevice.vcxproj.filters000066400000000000000000000036201303304015100230340ustar00rootroot00000000000000 {4FC737F1-C7A5-4376-A066-2A32D752A2FF} cpp;c;cc;cxx;def;odl;idl;hpj;bat;asm;asmx {93995380-89BD-4b04-88EB-625FBE52EBFB} h;hpp;hxx;hm;inl;inc;xsd {3953a023-20c4-4d35-860e-ec802019076c} Source Files Source Files Source Files Header Files Header Files SampleDeviceXMLs SampleDeviceXMLs SampleDeviceXMLs SampleDeviceXMLs SampleDeviceXMLs pupnp-release-1.8.0/build/vc8/000077500000000000000000000000001303304015100160655ustar00rootroot00000000000000pupnp-release-1.8.0/build/vc8/ixml.vcproj000066400000000000000000000102221303304015100202600ustar00rootroot00000000000000 pupnp-release-1.8.0/build/vc8/libupnp.sln000066400000000000000000000077031303304015100202630ustar00rootroot00000000000000 Microsoft Visual Studio Solution File, Format Version 9.00 # Visual Studio 2005 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "libupnp", "libupnp.vcproj", "{6227F51A-1498-4C4A-B213-F6FDED605125}" EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "threadutil", "threadutil.vcproj", "{24884928-0501-4CF2-BC8A-180AFC23B2AF}" EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "ixml", "ixml.vcproj", "{AD489FAF-9CDD-411B-BFE9-1B9C6C16D427}" EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "tvdevice", "tvdevice.vcproj", "{F592B023-E1F3-4A1E-841E-662DEE497435}" ProjectSection(ProjectDependencies) = postProject {6227F51A-1498-4C4A-B213-F6FDED605125} = {6227F51A-1498-4C4A-B213-F6FDED605125} {24884928-0501-4CF2-BC8A-180AFC23B2AF} = {24884928-0501-4CF2-BC8A-180AFC23B2AF} {AD489FAF-9CDD-411B-BFE9-1B9C6C16D427} = {AD489FAF-9CDD-411B-BFE9-1B9C6C16D427} EndProjectSection EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "tvctrlpt", "tvctrlpt.vcproj", "{BC1557D9-9E84-4BA5-861E-CB04D767FBDC}" ProjectSection(ProjectDependencies) = postProject {AD489FAF-9CDD-411B-BFE9-1B9C6C16D427} = {AD489FAF-9CDD-411B-BFE9-1B9C6C16D427} {24884928-0501-4CF2-BC8A-180AFC23B2AF} = {24884928-0501-4CF2-BC8A-180AFC23B2AF} {6227F51A-1498-4C4A-B213-F6FDED605125} = {6227F51A-1498-4C4A-B213-F6FDED605125} EndProjectSection EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "tvcombo", "tvcombo.vcproj", "{B5D74697-F615-4DCB-AA8B-935F6372F01C}" ProjectSection(ProjectDependencies) = postProject {6227F51A-1498-4C4A-B213-F6FDED605125} = {6227F51A-1498-4C4A-B213-F6FDED605125} {24884928-0501-4CF2-BC8A-180AFC23B2AF} = {24884928-0501-4CF2-BC8A-180AFC23B2AF} {AD489FAF-9CDD-411B-BFE9-1B9C6C16D427} = {AD489FAF-9CDD-411B-BFE9-1B9C6C16D427} EndProjectSection EndProject Global GlobalSection(SolutionConfigurationPlatforms) = preSolution Debug|Win32 = Debug|Win32 Release|Win32 = Release|Win32 EndGlobalSection GlobalSection(ProjectConfigurationPlatforms) = postSolution {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug|Win32.ActiveCfg = Debug|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug|Win32.Build.0 = Debug|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release|Win32.ActiveCfg = Release|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release|Win32.Build.0 = Release|Win32 {24884928-0501-4CF2-BC8A-180AFC23B2AF}.Debug|Win32.ActiveCfg = Debug|Win32 {24884928-0501-4CF2-BC8A-180AFC23B2AF}.Debug|Win32.Build.0 = Debug|Win32 {24884928-0501-4CF2-BC8A-180AFC23B2AF}.Release|Win32.ActiveCfg = Release|Win32 {24884928-0501-4CF2-BC8A-180AFC23B2AF}.Release|Win32.Build.0 = Release|Win32 {AD489FAF-9CDD-411B-BFE9-1B9C6C16D427}.Debug|Win32.ActiveCfg = Debug|Win32 {AD489FAF-9CDD-411B-BFE9-1B9C6C16D427}.Debug|Win32.Build.0 = Debug|Win32 {AD489FAF-9CDD-411B-BFE9-1B9C6C16D427}.Release|Win32.ActiveCfg = Release|Win32 {AD489FAF-9CDD-411B-BFE9-1B9C6C16D427}.Release|Win32.Build.0 = Release|Win32 {F592B023-E1F3-4A1E-841E-662DEE497435}.Debug|Win32.ActiveCfg = Debug|Win32 {F592B023-E1F3-4A1E-841E-662DEE497435}.Debug|Win32.Build.0 = Debug|Win32 {F592B023-E1F3-4A1E-841E-662DEE497435}.Release|Win32.ActiveCfg = Release|Win32 {F592B023-E1F3-4A1E-841E-662DEE497435}.Release|Win32.Build.0 = Release|Win32 {BC1557D9-9E84-4BA5-861E-CB04D767FBDC}.Debug|Win32.ActiveCfg = Debug|Win32 {BC1557D9-9E84-4BA5-861E-CB04D767FBDC}.Debug|Win32.Build.0 = Debug|Win32 {BC1557D9-9E84-4BA5-861E-CB04D767FBDC}.Release|Win32.ActiveCfg = Release|Win32 {BC1557D9-9E84-4BA5-861E-CB04D767FBDC}.Release|Win32.Build.0 = Release|Win32 {B5D74697-F615-4DCB-AA8B-935F6372F01C}.Debug|Win32.ActiveCfg = Debug|Win32 {B5D74697-F615-4DCB-AA8B-935F6372F01C}.Debug|Win32.Build.0 = Debug|Win32 {B5D74697-F615-4DCB-AA8B-935F6372F01C}.Release|Win32.ActiveCfg = Release|Win32 {B5D74697-F615-4DCB-AA8B-935F6372F01C}.Release|Win32.Build.0 = Release|Win32 EndGlobalSection GlobalSection(SolutionProperties) = preSolution HideSolutionNode = FALSE EndGlobalSection EndGlobal pupnp-release-1.8.0/build/vc8/libupnp.vcproj000066400000000000000000000330771303304015100207750ustar00rootroot00000000000000 pupnp-release-1.8.0/build/vc8/threadutil.vcproj000066400000000000000000000102371303304015100214620ustar00rootroot00000000000000 pupnp-release-1.8.0/build/vc8/tvcombo.vcproj000066400000000000000000000122031303304015100207610ustar00rootroot00000000000000 pupnp-release-1.8.0/build/vc8/tvctrlpt.vcproj000066400000000000000000000117421303304015100212010ustar00rootroot00000000000000 pupnp-release-1.8.0/build/vc8/tvdevice.vcproj000066400000000000000000000117411303304015100211270ustar00rootroot00000000000000 pupnp-release-1.8.0/build/vc9/000077500000000000000000000000001303304015100160665ustar00rootroot00000000000000pupnp-release-1.8.0/build/vc9/ixml.vcproj000066400000000000000000000414071303304015100202720ustar00rootroot00000000000000 pupnp-release-1.8.0/build/vc9/libupnp.sln000066400000000000000000000230661303304015100202640ustar00rootroot00000000000000 Microsoft Visual Studio Solution File, Format Version 10.00 # Visual Studio 2008 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "libupnp", "libupnp.vcproj", "{6227F51A-1498-4C4A-B213-F6FDED605125}" ProjectSection(ProjectDependencies) = postProject {9C2C266D-35A3-465F-A297-0E21D54E5C89} = {9C2C266D-35A3-465F-A297-0E21D54E5C89} {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D} = {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D} EndProjectSection EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "ixml", "ixml.vcproj", "{9C2C266D-35A3-465F-A297-0E21D54E5C89}" EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "threadutil", "threadutil.vcproj", "{1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}" EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "tvctrlpt", "tvctrlpt.vcproj", "{8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}" ProjectSection(ProjectDependencies) = postProject {6227F51A-1498-4C4A-B213-F6FDED605125} = {6227F51A-1498-4C4A-B213-F6FDED605125} EndProjectSection EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "tvdevice", "tvdevice.vcproj", "{7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}" ProjectSection(ProjectDependencies) = postProject {6227F51A-1498-4C4A-B213-F6FDED605125} = {6227F51A-1498-4C4A-B213-F6FDED605125} EndProjectSection EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "tvcombo", "tvcombo.vcproj", "{6365804B-22C6-4D5E-91F3-0C052EB55B4F}" ProjectSection(ProjectDependencies) = postProject {6227F51A-1498-4C4A-B213-F6FDED605125} = {6227F51A-1498-4C4A-B213-F6FDED605125} EndProjectSection EndProject Global GlobalSection(SolutionConfigurationPlatforms) = preSolution Debug Lib|Win32 = Debug Lib|Win32 Debug Lib|x64 = Debug Lib|x64 Debug|Win32 = Debug|Win32 Debug|x64 = Debug|x64 Release Lib|Win32 = Release Lib|Win32 Release Lib|x64 = Release Lib|x64 Release|Win32 = Release|Win32 Release|x64 = Release|x64 EndGlobalSection GlobalSection(ProjectConfigurationPlatforms) = postSolution {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug Lib|Win32.ActiveCfg = Debug Lib|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug Lib|Win32.Build.0 = Debug Lib|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug Lib|x64.ActiveCfg = Debug Lib|x64 {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug Lib|x64.Build.0 = Debug Lib|x64 {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug|Win32.ActiveCfg = Debug|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug|Win32.Build.0 = Debug|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug|x64.ActiveCfg = Debug|x64 {6227F51A-1498-4C4A-B213-F6FDED605125}.Debug|x64.Build.0 = Debug|x64 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release Lib|Win32.ActiveCfg = Release Lib|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release Lib|Win32.Build.0 = Release Lib|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release Lib|x64.ActiveCfg = Release Lib|x64 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release Lib|x64.Build.0 = Release Lib|x64 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release|Win32.ActiveCfg = Release|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release|Win32.Build.0 = Release|Win32 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release|x64.ActiveCfg = Release|x64 {6227F51A-1498-4C4A-B213-F6FDED605125}.Release|x64.Build.0 = Release|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug Lib|Win32.ActiveCfg = Debug Lib|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug Lib|Win32.Build.0 = Debug Lib|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug Lib|x64.ActiveCfg = Debug Lib|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug Lib|x64.Build.0 = Debug Lib|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug|Win32.ActiveCfg = Debug|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug|Win32.Build.0 = Debug|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug|x64.ActiveCfg = Debug|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Debug|x64.Build.0 = Debug|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release Lib|Win32.ActiveCfg = Release Lib|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release Lib|Win32.Build.0 = Release Lib|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release Lib|x64.ActiveCfg = Release Lib|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release Lib|x64.Build.0 = Release Lib|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release|Win32.ActiveCfg = Release|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release|Win32.Build.0 = Release|Win32 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release|x64.ActiveCfg = Release|x64 {9C2C266D-35A3-465F-A297-0E21D54E5C89}.Release|x64.Build.0 = Release|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug Lib|Win32.ActiveCfg = Debug Lib|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug Lib|Win32.Build.0 = Debug Lib|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug Lib|x64.ActiveCfg = Debug Lib|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug Lib|x64.Build.0 = Debug Lib|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug|Win32.ActiveCfg = Debug|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug|Win32.Build.0 = Debug|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug|x64.ActiveCfg = Debug|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Debug|x64.Build.0 = Debug|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release Lib|Win32.ActiveCfg = Release Lib|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release Lib|Win32.Build.0 = Release Lib|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release Lib|x64.ActiveCfg = Release Lib|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release Lib|x64.Build.0 = Release Lib|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release|Win32.ActiveCfg = Release|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release|Win32.Build.0 = Release|Win32 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release|x64.ActiveCfg = Release|x64 {1D3EEF7A-D248-48C0-B6B5-ECA229FE4B3D}.Release|x64.Build.0 = Release|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug Lib|Win32.ActiveCfg = Debug Lib|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug Lib|Win32.Build.0 = Debug Lib|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug Lib|x64.ActiveCfg = Debug Lib|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug Lib|x64.Build.0 = Debug Lib|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug|Win32.ActiveCfg = Debug|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug|Win32.Build.0 = Debug|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug|x64.ActiveCfg = Debug|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Debug|x64.Build.0 = Debug|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release Lib|Win32.ActiveCfg = Release Lib|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release Lib|Win32.Build.0 = Release Lib|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release Lib|x64.ActiveCfg = Release Lib|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release Lib|x64.Build.0 = Release Lib|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release|Win32.ActiveCfg = Release|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release|Win32.Build.0 = Release|Win32 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release|x64.ActiveCfg = Release|x64 {8FB56F1C-E617-4B79-96AE-1FA499A3A9B5}.Release|x64.Build.0 = Release|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug Lib|Win32.ActiveCfg = Debug Lib|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug Lib|Win32.Build.0 = Debug Lib|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug Lib|x64.ActiveCfg = Debug Lib|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug Lib|x64.Build.0 = Debug Lib|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug|Win32.ActiveCfg = Debug|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug|Win32.Build.0 = Debug|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug|x64.ActiveCfg = Debug|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Debug|x64.Build.0 = Debug|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release Lib|Win32.ActiveCfg = Release Lib|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release Lib|Win32.Build.0 = Release Lib|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release Lib|x64.ActiveCfg = Release Lib|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release Lib|x64.Build.0 = Release Lib|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release|Win32.ActiveCfg = Release|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release|Win32.Build.0 = Release|Win32 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release|x64.ActiveCfg = Release|x64 {7FB5F4A6-74F9-471D-B358-BAA0AC1CCA0A}.Release|x64.Build.0 = Release|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug Lib|Win32.ActiveCfg = Debug Lib|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug Lib|Win32.Build.0 = Debug Lib|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug Lib|x64.ActiveCfg = Debug Lib|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug Lib|x64.Build.0 = Debug Lib|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug|Win32.ActiveCfg = Debug|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug|Win32.Build.0 = Debug|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug|x64.ActiveCfg = Debug|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Debug|x64.Build.0 = Debug|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release Lib|Win32.ActiveCfg = Release Lib|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release Lib|Win32.Build.0 = Release Lib|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release Lib|x64.ActiveCfg = Release Lib|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release Lib|x64.Build.0 = Release Lib|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release|Win32.ActiveCfg = Release|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release|Win32.Build.0 = Release|Win32 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release|x64.ActiveCfg = Release|x64 {6365804B-22C6-4D5E-91F3-0C052EB55B4F}.Release|x64.Build.0 = Release|x64 EndGlobalSection GlobalSection(SolutionProperties) = preSolution HideSolutionNode = FALSE EndGlobalSection EndGlobal pupnp-release-1.8.0/build/vc9/libupnp.vcproj000066400000000000000000000774261303304015100210040ustar00rootroot00000000000000 pupnp-release-1.8.0/build/vc9/threadutil.vcproj000066400000000000000000000406061303304015100214660ustar00rootroot00000000000000 pupnp-release-1.8.0/build/vc9/tvcombo.vcproj000066400000000000000000000470511303304015100207730ustar00rootroot00000000000000 pupnp-release-1.8.0/build/vc9/tvctrlpt.vcproj000066400000000000000000000467061303304015100212120ustar00rootroot00000000000000 pupnp-release-1.8.0/build/vc9/tvdevice.vcproj000066400000000000000000000467101303304015100211340ustar00rootroot00000000000000 pupnp-release-1.8.0/configure.ac000066400000000000000000000530661303304015100165660ustar00rootroot00000000000000# -*- Autoconf -*- # # Top-level configure.ac file for libupnp # # Process this file with autoconf to produce a configure script. # # (C) Copyright 2005-2007 Rémi Turboult # AC_PREREQ(2.60) AC_INIT([libupnp], [1.8.0], [mroberto@users.sourceforge.net]) dnl ############################################################################ dnl # *Independently* of the above libupnp package version, the libtool version dnl # of the 3 libraries need to be updated whenever there is a change released: dnl # "current:revision:age" (this is NOT the same as the package version), dnl # where: dnl # - library code modified: revision++ dnl # - interfaces changed/added/removed: current++ and revision=0 dnl # - interfaces added: age++ dnl # - interfaces removed: age=0 dnl # *please update only once, before a formal release, not for each change* dnl # dnl ############################################################################ dnl # Release 1.4.1: dnl #AC_SUBST([LT_VERSION_IXML], [2:2:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [2:2:0]) dnl #AC_SUBST([LT_VERSION_UPNP], [2:2:0]) dnl # dnl ############################################################################ dnl # Release 1.4.6: dnl # "current:revision:age" dnl # dnl # - Code has changed in ixml dnl # revision: 2 -> 3 dnl # - Code has changed in threadutil dnl # revision: 2 -> 3 dnl # - Interface added in threadutil dnl # current: 2 -> 3 dnl # revisiion: 3 -> 0 dnl # age: 0 -> 1 dnl # - Code has changed in upnp dnl # revision: 2 -> 3 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:3:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [3:0:1]) dnl #AC_SUBST([LT_VERSION_UPNP], [2:3:0]) dnl # dnl ############################################################################ dnl # Release 1.6.0: dnl # "current:revision:age" dnl # dnl # - Code has changed in ixml dnl # revision: 3 -> 4 dnl # - Code has changed in threadutil dnl # revision: 0 -> 1 dnl # - Code has changed in upnp dnl # revision: 3 -> 4 dnl # - Interface changed in upnp dnl # current: 2 -> 3 dnl # revision: 4 -> 0 dnl # - Interface removed in upnp dnl # age: 0 -> 0 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:4:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [3:1:1]) dnl #AC_SUBST([LT_VERSION_UPNP], [3:0:0]) dnl # dnl ############################################################################ dnl # Release 1.6.1: dnl # "current:revision:age" dnl # dnl # - Code has changed in threadutil dnl # revision: 1 -> 2 dnl # - Interface added in threadutil dnl # current: 3 -> 4 dnl # revision: 2 -> 0 dnl # - Interface added in threadutil dnl # age: 1 -> 2 dnl # - Code has changed in upnp dnl # revision: 0 -> 1 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:4:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [4:0:2]) dnl #AC_SUBST([LT_VERSION_UPNP], [3:1:0]) dnl # dnl ############################################################################ dnl # Release 1.6.2: dnl # "current:revision:age" dnl # dnl # - Code has changed in upnp dnl # revision: 1 -> 2 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:4:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [4:0:2]) dnl #AC_SUBST([LT_VERSION_UPNP], [3:2:0]) dnl # dnl ############################################################################ dnl # Release 1.6.3: dnl # "current:revision:age" dnl # dnl # - Code has changed in threadutil dnl # revision: 0 -> 1 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:4:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [4:1:2]) dnl #AC_SUBST([LT_VERSION_UPNP], [3:2:0]) dnl # dnl ############################################################################ dnl # Release 1.6.4: dnl # "current:revision:age" dnl # dnl # - Code has changed in threadutil dnl # revision: 1 -> 2 dnl # - Code has changed in upnp dnl # revision: 2 -> 3 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:4:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [4:2:2]) dnl #AC_SUBST([LT_VERSION_UPNP], [3:3:0]) dnl # dnl ############################################################################ dnl # Release 1.6.5: dnl # "current:revision:age" dnl # dnl # - Code has changed in upnp dnl # revision: 3 -> 4 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:4:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [4:2:2]) dnl #AC_SUBST([LT_VERSION_UPNP], [3:4:0]) dnl # dnl ############################################################################ dnl # Release 1.6.6: dnl # "current:revision:age" dnl # dnl # - Code has changed in threadutil dnl # revision: 2 -> 3 dnl # - Code has changed in upnp dnl # revision: 4 -> 5 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:4:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [4:3:2]) dnl #AC_SUBST([LT_VERSION_UPNP], [3:5:0]) dnl # dnl ############################################################################ dnl # Release 1.6.7: dnl # "current:revision:age" dnl # dnl # - Code has changed in threadutil dnl # revision: 3 -> 4 dnl # - Code has changed in upnp dnl # revision: 5 -> 6 dnl # - Interfaces have been changed, added and removed in upnp dnl # current: 3 -> 4 dnl # revision: 6 -> 0 dnl # - Interfaces removed in upnp: dnl # age: -> 0 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:4:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [5:0:2]) dnl #AC_SUBST([LT_VERSION_UPNP], [3:5:0]) dnl # dnl # Obs.: 1.6.7 was released with a version error, the correct nubers should dnl # have been: dnl #AC_SUBST([LT_VERSION_UPNP], [4:0:0]) dnl # dnl ############################################################################ dnl # Release 1.6.8: dnl # "current:revision:age" dnl # dnl # - Code has changed in ixml dnl # revision: 4 -> 5 dnl # - Code has changed in threadutil dnl # revision: 0 -> 1 dnl # - Code has changed in upnp dnl # revision: 0 -> 1 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:5:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [5:1:2]) dnl #AC_SUBST([LT_VERSION_UPNP], [4:1:0]) dnl # dnl ############################################################################ dnl # Release 1.6.9: dnl # "current:revision:age" dnl # dnl # - Code has changed in threadutil dnl # revision: 1 -> 2 dnl # - Code has changed in upnp dnl # revision: 1 -> 2 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:5:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [5:2:2]) dnl #AC_SUBST([LT_VERSION_UPNP], [4:2:0]) dnl # dnl ############################################################################ dnl # Release 1.6.10: dnl # "current:revision:age" dnl # dnl # - Code has changed in ixml dnl # revision: 5 -> 6 dnl # - Code has changed in threadutil dnl # revision: 2 -> 3 dnl # - Code has changed in upnp dnl # revision: 2 -> 3 dnl # - interface has changed in upnp dnl # current: 4 -> 5 dnl # revision: 3 -> 0 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:6:0]) dnl ############################################################################ dnl # Release 1.6.11: dnl # "current:revision:age" dnl # dnl # - Code has changed in threadutil dnl # revision: 3 -> 4 dnl # - Code has changed in upnp dnl # revision: 3 -> 4 dnl # - interface has changed in upnp dnl # current: 5 -> 6 dnl # revision: 4 -> 0 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:6:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [5:4:2]) dnl #AC_SUBST([LT_VERSION_UPNP], [6:0:0]) dnl # dnl ############################################################################ dnl # Release 1.6.12: dnl # "current:revision:age" dnl # dnl # - interface added in threadutil dnl # current: 5 -> 6 dnl # revision: 4 - > 0 dnl # age: 2 -> 3 dnl # - interfaces removed in threadutil dnl # age: 3 -> 0 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:6:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [6:0:0]) dnl #AC_SUBST([LT_VERSION_UPNP], [6:0:0]) dnl # dnl ############################################################################ dnl # Release 1.6.13: dnl # "current:revision:age" dnl # dnl # - Code has changed in upnp dnl # revision: 0 -> 1 dnl # - interface added in upnp dnl # current: 6 -> 7 dnl # revision: 1 - > 0 dnl # age: 0 -> 1 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:6:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [6:0:0]) dnl #AC_SUBST([LT_VERSION_UPNP], [7:0:1]) dnl # dnl ############################################################################ dnl # Release 1.6.14: dnl # "current:revision:age" dnl # dnl # - Code has changed in upnp dnl # revision: 0 -> 1 dnl # - interface added in upnp dnl # current: 7 -> 8 dnl # revision: 1 - > 0 dnl # age: 1 -> 2 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:6:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [6:0:0]) dnl #AC_SUBST([LT_VERSION_UPNP], [8:0:2]) dnl # dnl ############################################################################ dnl # Release 1.6.15: dnl # "current:revision:age" dnl # dnl # - Code has changed in upnp dnl # revision: 0 -> 1 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:6:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [6:0:0]) dnl #AC_SUBST([LT_VERSION_UPNP], [8:1:2]) dnl # dnl ############################################################################ dnl # Release 1.6.16: dnl # "current:revision:age" dnl # dnl # - Code has changed in ixml dnl # revision: 6 -> 7 dnl # - Code has changed in threadutil dnl # revision: 0 -> 1 dnl # - Code has changed in upnp dnl # revision: 1 -> 2 dnl # - interface changed/added/removed in upnp dnl # current++(9); revision = 0 dnl # - interface added in upnp dnl # age++(3) dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:7:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [6:1:0]) dnl #AC_SUBST([LT_VERSION_UPNP], [9:0:3]) dnl # dnl ############################################################################ dnl # Release 1.6.17: dnl # "current:revision:age" dnl # dnl # - Code has changed in threadutil dnl # revision: 1 -> 2 dnl # - Code has changed in upnp dnl # revision: 0 -> 1 dnl # dnl #AC_SUBST([LT_VERSION_IXML], [2:7:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [6:2:0]) dnl #AC_SUBST([LT_VERSION_UPNP], [9:1:3]) dnl # dnl ############################################################################ dnl # Release 1.6.18: dnl # "current:revision:age" dnl # dnl # - dnl # dnl #AC_SUBST([LT_VERSION_IXML], [::]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [::]) dnl #AC_SUBST([LT_VERSION_UPNP], [::]) dnl # dnl ############################################################################ dnl # Release 1.8.0: dnl # "current:revision:age" dnl # dnl # - Start from a new ground. dnl # dnl #AC_SUBST([LT_VERSION_IXML], [10:0:0]) dnl #AC_SUBST([LT_VERSION_THREADUTIL], [10:0:0]) dnl #AC_SUBST([LT_VERSION_UPNP], [10:0:0]) dnl # dnl ############################################################################ AC_SUBST([LT_VERSION_IXML], [10:0:0]) AC_SUBST([LT_VERSION_THREADUTIL], [10:0:0]) AC_SUBST([LT_VERSION_UPNP], [10:0:0]) dnl ############################################################################ dnl # Repeating the algorithm to place it closer to the modificatin place: dnl # - library code modified: revision++ dnl # - interfaces changed/added/removed: current++ and revision=0 dnl # - interfaces added: age++ dnl # - interfaces removed: age=0 dnl # *please update only once, before a formal release, not for each change* dnl ############################################################################ AC_CONFIG_AUX_DIR([build-aux]) AC_CONFIG_MACRO_DIR([m4]) AC_CONFIG_SRCDIR([upnp/inc/upnp.h]) AM_INIT_AUTOMAKE([1.8 -Wall foreign subdir-objects dist-bzip2]) # # Get canonical host names in host and host_os # AC_CANONICAL_HOST # # There are 3 configuration files : # 1) "./autoconfig.h" is auto-generated and used only internally during build # (usually named "config.h" but conflicts with the file below) # 2) "./upnp/src/inc/config.h" is static and contains some compile-time # parameters. This file was previously in "./upnp/inc" but is no longer # installed (contains internal definitions only). # 3) "./upnp/inc/upnpconfig.h" is auto-generated and installed with the # libraries : it contains information on the configuration of the # installed libraries. # AC_CONFIG_HEADERS([autoconfig.h upnp/inc/upnpconfig.h]) #AC_SYS_LARGEFILE_SENSITIVE AC_REVISION([$Revision: 1.11 $]) upnpmaj=`echo "$PACKAGE_VERSION" | sed 's/\..*//' ` upnpmin=[`echo "$PACKAGE_VERSION" | sed 's/^[^.]\.// ; s/[^0-9].*$//' `] upnppatch=[`echo "$PACKAGE_VERSION" | sed 's/^[^.]\.[^.]\.// ; s/[^0-9].*$//' `] AC_DEFINE_UNQUOTED([UPNP_VERSION_STRING], "$PACKAGE_VERSION", [see upnpconfig.h]) AC_DEFINE_UNQUOTED([UPNP_VERSION_MAJOR], $upnpmaj, [see upnpconfig.h]) AC_DEFINE_UNQUOTED([UPNP_VERSION_MINOR], $upnpmin, [see upnpconfig.h]) AC_DEFINE_UNQUOTED([UPNP_VERSION_PATCH], $upnppatch, [see upnpconfig.h]) # # Check for DEBUG flag # RT_BOOL_ARG_ENABLE([debug], [no], [extra debugging code]) if test "x$enable_debug" = xyes ; then AC_DEFINE(UPNP_HAVE_DEBUG, 1, [see upnpconfig.h]) AC_DEFINE(DEBUG, 1, [Define to 1 to compile debug code]) else AC_DEFINE(NO_DEBUG, 1, [Define to 1 to prevent some debug code]) AC_DEFINE(NDEBUG, 1, [Define to 1 to prevent compilation of assert()]) fi # # Check for libupnp subsets # RT_BOOL_ARG_ENABLE([client], [yes], [control point code (client)]) if test "x$enable_client" = xyes ; then AC_DEFINE(UPNP_HAVE_CLIENT, 1, [see upnpconfig.h]) fi RT_BOOL_ARG_ENABLE([device], [yes], [device specific code (implies --disable-webserver if disabled)]) if test "x$enable_device" = xyes ; then AC_DEFINE(UPNP_HAVE_DEVICE, 1, [see upnpconfig.h]) fi if test "x$enable_device" = xno ; then enable_webserver=no else RT_BOOL_ARG_ENABLE([webserver], [yes], [integrated web server]) fi AM_CONDITIONAL(ENABLE_WEBSERVER, test x"$enable_webserver" = xyes) if test "x$enable_webserver" = xyes ; then AC_DEFINE(UPNP_HAVE_WEBSERVER, 1, [see upnpconfig.h]) fi RT_BOOL_ARG_ENABLE([ssdp], [yes], [SSDP part]) if test "x$enable_ssdp" = xyes ; then AC_DEFINE(UPNP_HAVE_SSDP, 1, [see upnpconfig.h]) fi RT_BOOL_ARG_ENABLE([optssdp], [yes], [optionnal SSDP headers support)]) if test "x$enable_optssdp" = xyes ; then AC_DEFINE(UPNP_HAVE_OPTSSDP, 1, [see upnpconfig.h]) enable_uuid=yes fi RT_BOOL_ARG_ENABLE([soap], [yes], [SOAP part]) if test "x$enable_soap" = xyes ; then AC_DEFINE(UPNP_HAVE_SOAP, 1, [see upnpconfig.h]) fi RT_BOOL_ARG_ENABLE([gena], [yes], [GENA part]) if test "x$enable_gena" = xyes ; then AC_DEFINE(UPNP_HAVE_GENA, 1, [see upnpconfig.h]) enable_uuid=yes fi AM_CONDITIONAL(ENABLE_UUID, test x"$enable_uuid" = xyes) RT_BOOL_ARG_ENABLE([tools], [yes], [helper APIs in upnptools.h]) if test "x$enable_tools" = xyes ; then AC_DEFINE(UPNP_HAVE_TOOLS, 1, [see upnpconfig.h]) fi RT_BOOL_ARG_ENABLE([ipv6], [no], [ipv6 support]) if test "x$enable_ipv6" = xyes ; then AC_DEFINE(UPNP_ENABLE_IPV6, 1, [see upnpconfig.h]) fi RT_BOOL_ARG_ENABLE([unspecified_server], [no], [unspecified SERVER header]) if test "x$enable_unspecified_server" = xyes ; then AC_DEFINE(UPNP_ENABLE_UNSPECIFIED_SERVER, 1, [see upnpconfig.h]) fi RT_BOOL_ARG_ENABLE([open_ssl], [no], [open-ssl support]) if test "x$enable_open_ssl" = xyes ; then AC_DEFINE(UPNP_ENABLE_OPEN_SSL, 1, [see upnpconfig.h]) fi RT_BOOL_ARG_ENABLE([notification_reordering], [yes], [GENA notification reordering in gena_device.c]) if test "x$enable_notification_reordering" = xyes ; then AC_DEFINE(UPNP_ENABLE_NOTIFICATION_REORDERING, 1, [see upnpconfig.h]) fi RT_BOOL_ARG_ENABLE([blocking_tcp_connections], [yes], [blocking TCP connections]) if test "x$enable_blocking_tcp_connections" = xyes ; then AC_DEFINE(UPNP_ENABLE_BLOCKING_TCP_CONNECTIONS, 1, [see upnpconfig.h]) fi RT_BOOL_ARG_ENABLE([scriptsupport], [yes], [script support for IXML document tree, see ixml.h]) if test "x$enable_scriptsupport" = xyes ; then AC_DEFINE(IXML_HAVE_SCRIPTSUPPORT, 1, [see upnpconfig.h]) fi RT_BOOL_ARG_ENABLE([postwrite], [no], [write to the filesystem on otherwise unhandled POST requests]) if test "x$enable_postwrite" = xyes ; then AC_DEFINE(UPNP_ENABLE_POST_WRITE, 1, [see upnpconfig.h]) fi RT_BOOL_ARG_ENABLE([samples], [yes], [compilation of upnp/sample/ code]) # # doc installation # autoconf >= 2.60 already defines ${docdir}, but we will not use its # default value, which is ${datarootdir}/doc/${PACKAGE_TARNAME}. # That would give us ${datarootdir}/doc/libupnp, and we want the package # version on that. # docdir="${datadir}/doc/${PACKAGE_NAME}-${PACKAGE_VERSION}" AC_MSG_CHECKING([for documentation directory]) AC_ARG_WITH( [documentation], AS_HELP_STRING( [--with-documentation=directory_name], [where documentation is installed @<:@[DATADIR/doc/]AC_PACKAGE_NAME[-]AC_PACKAGE_VERSION@:>@]) AS_HELP_STRING( [--without-documentation], [do not install the documentation]), [], [with_documentation=no]) # # If something has been entered after an equal sign, assume it is the directory # if test x"$with_documentation" != xyes -a x"$with_documentation" != xno; then docdir="$with_documentation" fi AM_CONDITIONAL(WITH_DOCUMENTATION, test x"$with_documentation" != xno) AC_SUBST(docdir) AC_MSG_RESULT($docdir) # # Checks for programs # AC_PROG_CC AM_PROG_CC_C_O m4_ifdef([AM_PROG_AR], [AM_PROG_AR]) AC_PROG_LIBTOOL AC_PROG_INSTALL AC_PROG_MAKE_SET AC_PROG_EGREP # # Default compilation flags # echo "--------------------- Default compilation flags -------------------------------" echo host is $host echo host_os is $host_os case $host_os in freebsd*) echo "Using FreeBSD specific compiler settings" # Put FreeBSD specific compiler flags here ;; *) echo "Using non-specific system compiler settings" if test x"$enable_debug" = xyes; then # AC_PROG_CC already sets CFLAGS to "-g -O2" by default, # but only if CFLAGS was not previously set. #: # Use -O0 in debug so that variables do not get optimized out AX_CFLAGS_GCC_OPTION([-O0, -g]) else # add optimise for size AX_CFLAGS_GCC_OPTION([-Os]) fi ;; esac AX_CFLAGS_WARN_ALL echo "-------------------------------------------------------------------------------" # # Lot's of stuff to ensure large file support # AC_TYPE_SIZE_T AC_TYPE_OFF_T AC_DEFINE([_LARGE_FILE_SOURCE], [], [Large files support]) AC_DEFINE([_FILE_OFFSET_BITS], [64], [File Offset size]) # # Are we targetting Win32? # AC_MSG_CHECKING([for Win32]) AC_COMPILE_IFELSE([AC_LANG_PROGRAM([ #ifdef WIN32 #error Yup #endif ],[])], [ac_cv_win32="no"], [ac_cv_win32="yes"]) if test "$ac_cv_win32" = "yes"; then AC_MSG_RESULT([yes]) else AC_MSG_RESULT([no]) fi # # Checks for header files (which aren't needed on Win32) # AC_HEADER_STDC if test "$ac_cv_win32" = "no"; then # libupnp code doesn't use autoconf variables yet, # so just abort if a header file is not found. AC_CHECK_HEADERS( [ \ arpa/inet.h \ fcntl.h \ inttypes.h \ limits.h \ netdb.h \ netinet/in.h \ stdlib.h \ string.h \ sys/ioctl.h \ sys/socket.h \ sys/time.h \ syslog.h \ unistd.h \ ], [], [AC_MSG_ERROR([required header file missing])]) fi # # Checks for typedefs, structures, and compiler characteristics # AC_C_CONST # The test for socklen_t was getting it wrong when it exists but is in ws2tcpip.h, # so we use a new test. #TYPE_SOCKLEN_T AC_CHECK_HEADERS([sys/types.h sys/socket.h ws2tcpip.h]) AC_MSG_CHECKING(for socklen_t) AC_COMPILE_IFELSE([AC_LANG_PROGRAM([ #ifdef HAVE_SYS_TYPES_H #include #endif #ifdef HAVE_SYS_SOCKET_H #include #endif #ifdef HAVE_WS2TCPIP_H #include #endif ],[ socklen_t t = 0; return t; ]) ],[ac_cv_socklen_t="yes"],[ac_cv_socklen_t="no"]) if test "$ac_cv_socklen_t" = "yes"; then AC_MSG_RESULT([yes]) else AC_MSG_RESULT([no, using int]) AC_DEFINE(socklen_t, int, [Type for storing the length of struct sockaddr]) fi # # Checks for library functions # AC_FUNC_VPRINTF AC_FUNC_FSEEKO AC_CHECK_FUNC(strnlen, AC_DEFINE(HAVE_STRNLEN, 1, [Defines if strnlen is available on your system])) AC_CHECK_FUNC(strndup, AC_DEFINE(HAVE_STRNDUP, 1, [Defines if strndup is available on your system])) # # Solaris needs -lsocket -lnsl -lrt AC_SEARCH_LIBS([bind], [socket]) AC_SEARCH_LIBS([gethostbyname], [nsl]) AC_SEARCH_LIBS([sched_getparam], [rt]) # # Checks for POSIX Threads # echo "--------------------------- pthread stuff -------------------------------------" ACX_PTHREAD( [], [AC_MSG_ERROR([POSIX threads are required to build this program])]) # # Update environment variables for pthreads # CC="$PTHREAD_CC" CFLAGS="$PTHREAD_CFLAGS $CFLAGS" LIBS="$PTHREAD_LIBS $LIBS" # # Determine if pthread_rwlock_t is available # echo "----------------------- pthread_rwlock_t stuff --------------------------------" AC_MSG_CHECKING([if pthread_rwlock_t is available]) AC_LANG([C]) AC_COMPILE_IFELSE( [AC_LANG_PROGRAM( [#include ], [pthread_rwlock_t *x;])], [AC_DEFINE([UPNP_USE_RWLOCK], [1], [Use pthread_rwlock_t]) AC_MSG_RESULT([yes, supported without any options])], [AC_COMPILE_IFELSE( [AC_LANG_PROGRAM( [#define _GNU_SOURCE #include ], [pthread_rwlock_t *x;])], [AC_DEFINE([UPNP_USE_RWLOCK], [1], [Use pthread_rwlock_t]) CPPFLAGS="$CPPFLAGS -D_GNU_SOURCE" AC_MSG_RESULT([yes, definition of _GNU_SOURCE required])], [AC_DEFINE([UPNP_USE_RWLOCK], [0], [Do not use pthread_rwlock_t]) AC_MSG_RESULT([no, needs to fallback to pthread_mutex]) AC_MSG_ERROR([pthread_rwlock_t not available])])]) echo "-------------------------------------------------------------------------------" AC_CONFIG_FILES([ Makefile ixml/Makefile ixml/doc/Makefile threadutil/Makefile upnp/Makefile upnp/doc/Makefile upnp/sample/Makefile upnp/unittest/Makefile docs/dist/Makefile libupnp-1.8.pc ]) AC_OUTPUT # # Files copied for windows compilation. # echo "configure: copying \"autoconfig.h\" to \"build/inc/autoconfig.h\"" test -d build/inc || mkdir -p build/inc cp autoconfig.h build/inc/autoconfig.h echo "configure: copying \"upnp/inc/upnpconfig.h\" to \"build/inc/upnpconfig.h\"" cp upnp/inc/upnpconfig.h build/inc/upnpconfig.h pupnp-release-1.8.0/docs/000077500000000000000000000000001303304015100152165ustar00rootroot00000000000000pupnp-release-1.8.0/docs/dist/000077500000000000000000000000001303304015100161615ustar00rootroot00000000000000pupnp-release-1.8.0/docs/dist/IXML_Programming_Guide.pdf000066400000000000000000007312001303304015100231070ustar00rootroot00000000000000%PDF-1.4 3 0 obj << /Length 72 /Filter /FlateDecode >> stream xs w3T0230WIS02370S0327UI567(40F!^\!\[endstream endobj 2 0 obj << /Type /Page /Contents 3 0 R /Resources 1 0 R /MediaBox [0 0 595.276 841.89] /Parent 7 0 R >> endobj 1 0 obj << /Font << /F19 6 0 R >> /ProcSet [ /PDF /Text ] >> endobj 10 0 obj << /Length 856 /Filter /FlateDecode >> stream xO0W$$CZ_kæ;;ZZ1(ꃝƾ\r?ߝ}lJ 1{Ё09\ogy9p_vOnLX'2?ɾg 2N2)T'$Ө8;Ͼ(HH"e?λA* T; f\WpB^-n t KC^DÏYY|O>!a(pA޽ƾwHF6(d!u2B0ZjAt/KB`x'_/x18鐷>'0cctaWq\\咞(ѷ}Kwq+TdX F3])Llҝ@ɐL?r|Pn@Y *lFEM-c 2"/@8t pj \ ujpZ B=J=-a,S&]!hT?(zBhտ4m7c(=3S1V31k6b!7cIg~-@Nkp1˷Hq-Juj9x NvFH ډ;P[xD$՞+ǴQRB!01%ZNq/(զ0-N*TքڑuyADݒ4{׵KW?s%yov}sZ.zU9hƌaݫy3mk> endobj 8 0 obj << /Font << /F20 13 0 R /F19 6 0 R /F23 16 0 R /F8 19 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 28 0 obj << /Length 535 /Filter /FlateDecode >> stream xڥRKo@Wq>l/H %+<$]cwv =Vm$0Daaņ AdY&EYVl'JfWI4*"d@2 ,3ʰK3zzM"dh-{T|ѷ@+[OM1+l<30Bf9!̦c$?\JhH,&ck"N\2ֻ/uc%I_wPձCowNn E) JH<. чm,@~:JW*R8EȘȰp> endobj 26 0 obj << /Font << /F20 13 0 R /F23 16 0 R /F8 19 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 31 0 obj << /Length 1821 /Filter /FlateDecode >> stream xڝXKoFWH!ᚻ| h9)JbB*IYHʒAs8;;;ofz{7x:[:ڤ*3'I|s깧Cu=7۷s6sݾDf=z~L;>N;I,|3o,f~ K=оYlf fu% 'ƎVY8m,/1 Euvn*E>E 95A+{Μ5yAbKXȝ+NSe {_a[c:T&4N)yi cS.GN4FW_484cS2SFp q.߭ l7%@N^~H0,0-=OxJ@;12LG7);VeQaWk*"?*'nA0I-UWg}7y{lXvX[ܚ$b `05 )(Ɛ ^߶ dwېm5YƲs/o=ffjp.ߐ]1cK_K䚂҄B[2sYtGZ;fX~\zģ8?V`P"j'4!Mݍ>D &H&n(,S˦eتd)Y [*s#$oh"b)b-94z8]Ꮶ:]DA-Kr o4Ҷ ][Qi", (X-wI0%o8EݜRHAUC:s? 2Lg; Tfp7 [,n4jbG^*S #Γ t2 l,:A+w(p}]w/<%$AH;]|Z$54;4/ LM͸iBߠ7ߍ  ͜ JE$Ҿ+K_Jb:sKAڢ}ΤZ%\'yUؖ*w{i9[4;*DNh?ģjO9G8<ѱm\,l5L:LZhmS&ARyB`?7_\5Duϲp2a.jjVQ#og\iWx]Q,Od:A+TVH8 F6c 4.;! PLVf]p E<: T?WuG_͙D7)\9K;7V1|އ iI?WSm?|`2/E ]L %j.LqV[^+`'q% ]NfPЮ U8c8!snkCc~n89.endstream endobj 30 0 obj << /Type /Page /Contents 31 0 R /Resources 29 0 R /MediaBox [0 0 595.276 841.89] /Parent 7 0 R >> endobj 29 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F19 6 0 R /F23 16 0 R /F27 37 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 40 0 obj << /Length 2029 /Filter /FlateDecode >> stream xڭX[s~W$*F;K9Oі$vJl "uO%TΩtâahzVL# m) c[a>j{9 _L3hgz 9k>9_^W ci@YZM}Ubn5BK5 ;  <:eDٮ36Go<^^n۶ߔVĩ[Jy7kcT}D.۪~5uHw*3)3/⹦eWr2Xiٖ /]$f޶%wή9ӒC-5#V˶ldu_;ձ'`F)'@J8¡2[*8Kjļ?`:nu_LK)[d.uVt(Xx6_>I/ `Splxn#trp֭\5u0V$w?gVLT3HjkwEޏ+prg̪hZTm?:,ΐpeΐn_4USϳIoc\nTщ cX3b3(C99-c$8yNZF٬'CYp\l~`"x6IHds|xLa9Ez dDf6Jdv/s%gp &f'E 8ٝ* $bn!93e|x MPXJOCAbҹY̺@ C4{k ʇL9E SrJHAb4J(OȁaF4JSaqʫIŭ^B/Ma*4{pN0AbQqǓdSݻA؋ME"G #\ 4"S@b)AnRPǐ(e1z=D8# 羘.0N?&L@&'B$ K-SGyLpDYvH1_ ")E{n6΅k.\Td?f9G<6Lc"RX%1ogx$"!§8_єnዟlöL uI38)~`҃3<tjGTq|0{?] Ͼr-F?]Z9 Ƽ;Ú^qj*kk^JcWWY _ #>68R^]*p"endstream endobj 39 0 obj << /Type /Page /Contents 40 0 R /Resources 38 0 R /MediaBox [0 0 595.276 841.89] /Parent 7 0 R >> endobj 38 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F19 6 0 R /F14 43 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 46 0 obj << /Length 480 /Filter /FlateDecode >> stream xڝMo0 wL0ߊiR(GYmMEX6G|_Q}0yf D$ 1zh67j$YTJ⟆ ͭM`Q) uJPYCP}f(dЅ? 7f=hL/>d0ɅLg]:@dahYטRtEG,L8QKB8;E*1u]>F4|>/ G̹Afge08ksEWKEi#} y\9;`Lzy"k I7@T(sdB2c'Hr lv`1EI5`9#fj$gEomy{I$\͘wegPĸЕi[WU>|i[z.껏Jn$qk؎0Ƴlv-("a?Q2:¿/Zendstream endobj 45 0 obj << /Type /Page /Contents 46 0 R /Resources 44 0 R /MediaBox [0 0 595.276 841.89] /Parent 7 0 R >> endobj 44 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 49 0 obj << /Length 2500 /Filter /FlateDecode >> stream xZYF~ׯ#}fId3@RT[EF3}Y Yys3zqZd72c(Vg7s9.o?Yq\!_Vcnn'r;͈e(CPt9?i6l )aeˑ"/Fף6azM^ko=NwK^_IIّ$]z(/nz83H5ɦ~_|QORF(A]A79@%R؂ܗкH{ c/ (RqTW9' EC ^@ po˺n]OǓ,P`cچW*e _Wwqⱜͦ6%v`L9*)Ne V`_~unk]rro\x3ι_Dh”QY k9ZWe!022[QJ_q1YLP:8I[ϧx1 rv)]0 >Es8P7Ab1HN9n-![p<ّ8tF[H24Py{,7txťm_p'm̋O1EI'q*ZV>i>]/7u_3ϴ +U$\m33.C`e5AM=j,zJm>ݛݳ]qYZ1މma`Wజj]_,Xvc"Gfs(✎9lZdZfk$  $TLgK%!vH, |p(,'V1'\eih>YS;6KRa7&Z5(Eu֒HfrTzh"'K1KױƋQDfNuGGEdUx9P/ ޻bNysk*nz¬@xP\x9<*Zz^PJM4(]Y7ޤ׋@}RuUHSjpbS%~C* O@ `ǀւw\+eV:&YNdaW{\GBwuʰ YuƯq_yP`H o:hPaoIi%d;CHG Mm<{$XsvTcsN!SݽqJ-&Šr~kigA3ga pG'7 "g5(@r; @ d9!' >N$af]m `9[]C=ݐ6PqJM⪓6`E < ct DP1=A$=Je z ^̆)Ҡ.8i>厜qD((:_xt tw9ŠD)(݄=U NX~踀"zΊ|%Hp-<㝟cѲ8Ȳh`6M4 JBCk#9 L5㉤;UlG~*V]e̅ڷAH4 r|_GAĆ8[xt vJ.Q+Qyw`ltJ!JiWY>bihY)T1 jL6y fs$erzKȘxCem ُ^v\:c Ğgaʞ0D)_J&UN *8 ߠu:)WO6hlLq_ӘOwȤ ӛ#ۍE1c#5c/S#XOX%B!P@B 3{쫛#fo&w Ţy^jOf^߇yMx6^_Lю =ԛzg߰tgzWM5Vw%Y Zx~O{8?+o ъ/9endstream endobj 48 0 obj << /Type /Page /Contents 49 0 R /Resources 47 0 R /MediaBox [0 0 595.276 841.89] /Parent 53 0 R >> endobj 47 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F28 52 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 56 0 obj << /Length 2509 /Filter /FlateDecode >> stream xYs7+8ܘ0#ok٩ZJU|x=CjѢ!Қj0F0GG0vBHˆ9hO+ÐfFaڂjQ7HU7p %e`d"Znw a:!) a8)hou՜COgky7 u(Yw$ )'̺֘zAT `.lW79+ˁ]{ ta'nA4o`V s~q2 , vFݷ~Նvj {ܠSeǪ.\%&:+E v NW.\>;o޺x BUoIf-Yy3oKZyD~ܦ,7ʧڰt>w FD`u*@~jyşsak ,/;ʸ09!p׾p0U'f=hOrOWlH!NJ<^MN09,wu4~ 9K~A4DdХX?*rXD\U+iT<T,,TX(kbT|~_zn "3c5Ql_g:kAW͙25T5Q *iD@ڠh< ٙ W ԢBAT# 5  Um'Qps [Qd}Sa2<ҐĒV f2Ao#@s4ߗN]5_*%PA8x2@tc!Njރq,mLㆼ\Ag>Zdօ%6EuI9[7P)9*Ohagek>;$r \up\&Fc!~SkZ+;Qt(Na qo:UVOa+=s(p-t5l,ndؒ/x?b0&\6 V ]T"/b#tl&N QաoeZESeΥD2Uᢓƚ'^,<۰=܇Nb6)l[7KRI:dp.il3̼/|Y奜#N>Ysr @&X.> ,*jcQ&RcQ0gXna`;L׀gB> ĝ>AEkeMU85YWɍ ϚXBߗv)}WzK>?jȊ*j<^F7BaSjL;\N(:vDDILf+Xi|%5GO)I Og*S)_AA9~ß.HM*$KBpk헏p_;M!;1C9P4 %- *"٫CNJXB^uF$LEB)M M' 9ATIW23,]a(TRJL&ߥ:|4V;tW{Gقl.{>,F1V-u- Wկ(Wt5*5OVHOSբԡ%XTK1qN]CK46n/6YV|)u>s‹N~ &n;`Y-BO-S +tNQkڨYrD)yο=BQ@Ke%3t ]V2yƵ~{jHqxN}2-qYl`C6WjCVԎq>#&ܪ&vӄd{uZ}d .C  /ON)9:٫?~endstream endobj 55 0 obj << /Type /Page /Contents 56 0 R /Resources 54 0 R /MediaBox [0 0 595.276 841.89] /Parent 53 0 R >> endobj 54 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 59 0 obj << /Length 2847 /Filter /FlateDecode >> stream x[YsF~ׯ#1s+NU\zpU60 J" -YO"Sq4z?ۙ#NjƸ%1Xg9O&?]Yz !_vsn2߯E~? 6ej^?lyAg.(l{!כ:RP@SA)bpAV-l`%Oa\*B?:i Ra*]iKYH.-pٶrm.o;% *ˇ׿:#itg8q ;S9ӲI/w|Wrt_az+PBG9Vkԫ q̩v˯sH;G:@TK|⧣J!LUF=~EySo\bbaqM&Yn@'.Uq?OI_נ\nƒ->r8#Z;ԵB0br6hp0`d0%dHاOh#U[PH<\lb,sœ|W/i:S'f?NZ5E9҃J& u4^~86a:)ה(sTcBh&Y00p,yn^[\Sfv-fiFUiKJevush`˰@ׁA ,YgLڇ&qR6+׷Nw̄4 hE]=թKOzRnaLn5܊m? JUKوWĩPSC!R Dm /l(ܭ|$(.DجA#P!rI͗`W ۴3{PZ(;:8t;8V}'3HҘ28ch:=!\(󌫳pQ5Bywh Qij;o[ -s;(`+1ٝTAl˛OBɫF٨[QdZ"!:P#;7)eN)o@7Ǎ ։I^*(6 1\pڎ1Ǡ@dbf%#24l9u-u@-O[H[틫_ϋrbřyK(V2hmv߆Yo,egc;YySƧ}:MQWϧ66A꧁]Iq] ib_#V&y+C><((B cH&yq ZFIRn!8aLŀjf#IAOY ",saQkHV (MYlt3 C[m#+R`MGL:b63ʠ VPE'驀,te8VwܙPQX^: M$ADRU<g0x]o ҿE˙ F9j FQ `Tk_N)$MY-eiҏs Ie_|(#.S%n;GRs$Fͩ818;FxL1$ Zgm3#ԙ4̄!Te?=110z5.'dfg10Dz` Kezy g:3R6HQ\>Py2W?@QW6Q *U4Ws"ٙ̍qGQ h<7& 陯c!L,jU'-:`fP+n7NUUF6A>VI(H^V^Ÿ>К)рp_u_][:GۍF7@\W@FL>~Pŋ;ZoW2+|| }xm6IpG*oegTz8+Z9A߰}l;=nġl<H@@n;ZKeM]:VO.Ї .N PPmϣ.t:MVр}ûl'x~;A; :vo Y8PC9Vdu8RaiC^e@)CX=tNK(XN2<$U?,\E' Nx@E^~4$<ͩL-=I(<9ȓl> [ێ}"ObNdQp?̒8xcsmV0^ [uEg =&, jJW玉.omlXvH_E.[(bXh ˬ"oϨ+m)Oiji*+b/mBACkz:<(Kg'0+<7,̠˭Nh1\s@K':Q>w^m"`k Q|bIY0̱Toa!ahMY ²I\՜rϚ]U? Wͼͩ/*qw3x \0S;VŃ3y%adB;pϲm9rv>bit0BRʆ4DOb Dp> endobj 57 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 62 0 obj << /Length 2185 /Filter /FlateDecode >> stream xYn6}WQV\/f@ͥIhQbZJ}gHʦ,91- 3Ù9Owl"{DPC:a4x5dŰB!y]F~<8͌2 ~fgSœ˞8 nuHV\ Bfޔ`g^?9iEeT>=@mO'8X '/UpHA0Qq۰'hBPbVZ:KjEQr'% f0-aSbXpߗ3|gt-)ф3 p=<`lh7X}0teM1)D֬B`"ZO`ص#*_@uN`zM HH.1#_{2Q䓒B t( k!`3#|$`=.QNBb8۩O,tM9"4$:fhy~uXޖ b)4DY}m˾aaY1AmʐH+b:OɧĜd[n ԇ{)aUQUɖB0bj9.R ",`FTWGV 1b/,`b3 yxmsM8#XFLbo,&7| S8?V(շ.r|F*bgH*vj`HSfcd (9^/U /7Nj+<[4OJ{d;KyHB.w]nqV2^Bz0 s(z{$^%|ܵۏ9ig@ô1d@.Py < M#aIz:: yV #[UM) 3+_ho^2т'}82<`,X6 IY{ f|3cR~/5)`X,Ǜ L3Q'UfGt1>N#!{^¿t<E@>c&/( m UnVd->zOFZjYVN7!.?.}6q Kcjr}UUA*\7df>g t~4%Ǡ%^bg!JyHGN҇Sy?D]E,.l#AӳnVYca0!5"&jTO!x񴜕XL:V!TcQ[l:I4E]>F&:R7v8x.|c4xp˂ s۲{ 1b^Pځwݼ2@f4)F9u(|DDާlQ'ݱRilg*EJ~t~z~v93G/z>c=gW7wځMI;_Fqq8nú#'"8<-Vwǫ*y7-*>HE0ڡa)H__~1 (>,j2& QH<U@9&0fİ^~xi'<^.}-ո|X`^=d^=qC @PgJT>9zXX%th;7wendstream endobj 61 0 obj << /Type /Page /Contents 62 0 R /Resources 60 0 R /MediaBox [0 0 595.276 841.89] /Parent 53 0 R >> endobj 60 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F14 43 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 65 0 obj << /Length 2013 /Filter /FlateDecode >> stream xZ[o~ׯ#ٖ_J |l E/-}3ݕV")5qN"E]1z^'ɒ6!T#MFZˤ,'RM3~rXz>ϨN벺][a4.F$$'J(dHF~'F1p1&yqj"t[_ܪZr+**zg h`,c F ˊ In?.& wNYR*k~A$RH2&I AF%V& 3 eiZ`>C^̃`ݼw$]A< QU[O" -`u|z7.[8Ғϖ# 6j݂ȘF-we,2lJr`X/>2At#cfU'l$[r;@Ffdu.0I}pg7gĆ᛼ Q(5e&uP2(Euetb/uug>&X1AX+M$Q`D/ 9k.SqXlZ67_YP7xN>n g'd"!^9<-ª7qp~DŽõM sx hU=sʭ4Ro}≬S,!4#řߘDy,j#.*IQ\\[IX*!!ɏټ6וG\FFgRB +zzvRhr UE\HY ^9jƧt¦ڏ@al [ h$^OI -  +c#emQ# ! PDϦ; SƐ2tוG: HrE.pkD\еٽqƇw[ܰQ//AL.R4Xto6-vLrǺ`q/qA[7̫"P `bƔzOh#vY5{*Z|fL-@jG m PnqOnx: {c-ge@ a)~x;Ր y> endobj 63 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F14 43 0 R /F27 37 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 68 0 obj << /Length 1993 /Filter /FlateDecode >> stream xZmίG֓yvJIno@ba/ό׆Lڨ"-c<>ssޞcpiQ["+Z]ޖr\19-{=fJQX-w~2ww/GF G qBӇFob6%#֔0犇"FieТ(cEV^WZxٗRApE2^з`f uXB^4Ɉ޷)NEGirD9WLa4!#n}ux êM}6-{|ʍ.4DX5 Ia( 9KN Mŭw7޶V:jn:Jݟq'g< b61.82ցI0~tkt>9X¿H}y7?lV?*'Q^i}݁2io2FQb475Fs{C]n7%VuMiZ"Ft {#Xtsl,бpv3FJVD:G8WKdJ:ʅD,_C$꤂\(B*a "§e91$QTwM!Ţah ٚE0yyy" kx-:5 CQy09frNJzLɺOO߫O%^+]v*S)K}?6JL{qHײ%Q\^8iа0nw k vf< 6ٶw0PZla| lHcW"vR @c\EKfQ OMț jK 8r>X鳬%=!ގihyC"γ>h/.W󉇳K&ؕ&a" gbMd=):`cME,mXl:Vm&$Y8GSS(ijG1th=FST-؋=MS9&,*@v_vg]U5}^3:'cT8he]Z &rRKu1,3Q>Y&:D 1Q)&JD};#l?sTl.OO US= Yhϖ5ҿua7(&U>ExndWnV-W'f͗/N]~l桦A̟k5YջLb!ftcH|Yؕ_ONWV ]2d bendstream endobj 67 0 obj << /Type /Page /Contents 68 0 R /Resources 66 0 R /MediaBox [0 0 595.276 841.89] /Parent 53 0 R >> endobj 66 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 71 0 obj << /Length 2076 /Filter /FlateDecode >> stream xZ[o~ׯ# 's[v7֍[Hؔ%@\^̅đl`a@3߹3/W#NjV0n0kuquU}ʷU-(_*n˶̦Ͷrzj p0'Tq}7ZLhzBpx1%̹n" ZԂePDp"r_J Pjʠ_Paf 렱yE&'#P+8q=qq r2La4_ ,쌒ڀ:9:Rya ZXO^Y^^ iY NꞰ >͈v/j5-_},߾9ʕ"MNPIwkiʛo^8squ|G0xP%aQWI IU)PXE{*mb ۏbu436'܆7UէE*cB-ʪ{2 A٭xA(9\v~v zvyW +8_Q~ic s)J~8,?Py.;qB1}\ tZLhpٛŴm oil}v+.sqs Iiw}'  -B)e 4G([yj?f}@0/zbP2/$봛$,؂ۨ.|qWw8gG+,BAsW,XVз VP,}(5l\z v66%W+9JG40? 3k=!1$irxrAN4f!_X>=>P 87 dcE?߲n̾Aw>Ø[U +rWURow Oay8^53nb[`吝;9Xkq@Z1:XzW.+׆09!=aIk_ LB;{qcB\hu(~w7/z;QXFquEm!w d tۃ(p{Cj6w*Vdɫu!Q9y ;~&}k/BgJPXZ!칫T`j>8>=_8d3gB'6~B ORG~l6v5wEm ~89eY)ͽBÕlv̼ q3F21s7)'ӲQ( vzwDs㾱{Q/:UqG{ xX.#lvꋌ(1oViw6[65QGV#Ns`}ӿy˙7qb =\Wxߧ7xծ ̈?ڏqrꝠT!yP J[jc%(qxj6s<`S'ᡏH?:Wtv7=Bu3+7 Y5m1b-2@> ߜR]V ]2?dU~endstream endobj 70 0 obj << /Type /Page /Contents 71 0 R /Resources 69 0 R /MediaBox [0 0 595.276 841.89] /Parent 72 0 R >> endobj 69 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 75 0 obj << /Length 2723 /Filter /FlateDecode >> stream xڽZr8}Wʄ q#yUI%v6q*E-MɒWǙӸРHْJU`qr=?z/";7luUSgr9*ʏF,8*ň|Ӭ.Ǔf=~eVVBe}^eGU*5Uɬͮ$aqw|$E+_D(a%"rTpOnĄ7+R8ɳZAVfXzO`EmJoEY=: ˚u!r3nѬ+ b$3.gd/*-Nd!ݩ̋ u7l[w(RV{zKEG Wߝjl>eFG ;M^aog2]榍%b&_qz^x][wԏ6:G$q2* dۊ6+aLh4[Bz Rg%!3|~ǨP* M:Z^A2ZTḛfE-<WgTkS-XSUԆ?U_6{equXt7a}2O 붓&,m$ٽ;r)/0Db&˰kνY7P>]n{urE{ 6=[VE[ۄ7zOǤe:up]RѺ[MrŒ={d4nWFYh6u3xFG/#6PR7HQWvPk*6~IIgUs,C"ֳBG촔#$qB)8UNXwb? _HX q80ѤoǼՊE Y|H|z"Nƚ.*fyaE gғ,t ,.=-.+-'t_Znt,hB&TzXDѱYE"C4MAZ̛vlmk^)|>,>lPij+ jSGzd^+2n㪹iN!5R DyBؑnTp㥨أ\?A6x-Zh'=Fs#u}z a(8[lO1UK0|U-*wսuNsv~Z=d(U.0*'[_&vT?V3x'9ԔߺiճKMu~Zb︎~ pEv+zx$3I0P 7+Z+Mx30Ҋ rRiЁ3#儕FGQ¡`víu P@.*Q@ iϘS($y҉BWZK2Io_?zݮ/h}B,NEB:$㿗V5ziCc 92$Sb-`vYPLT2L@A'ףHL32%/D,!XY,er-Q w/P9ɇh?聯% 4PJ4u."'!"ﵣntzԇSMV8&SPDӔ:iJh^dA%%:&nn~}= j\..rl} 3(+)'GQYKBn__endstream endobj 74 0 obj << /Type /Page /Contents 75 0 R /Resources 73 0 R /MediaBox [0 0 595.276 841.89] /Parent 72 0 R >> endobj 73 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 78 0 obj << /Length 2580 /Filter /FlateDecode >> stream xZnH}W M/ g0@&HV﩮n)I ,XMY]S̋'ERX5'*-&Y&yn'ϑBIF"z7RTQSnY~~sqy}!&)IN2%2E:ys&'X(BK׫Oii w V*Iql~gL*cZ\Ux;Hdg?z-7_xkG'Ht6)u(tp>SXsWmUJYnpv"5.״otݝ{;1(Ob kTlzׄ oiRHw$} RM3*qp>L]%G-նybl7]/NdTF/VA7zM:bTfт``+~ͅ_8&MRU@q!(!BAdY[ zY.j%-aD 57et")L,B%^MAWn4U!;3[h u9>Ns]E0Yd#p: G}pTXxY7nM]7OK&a"+^soݻ+^DKay3,iՓEő!X(@21E8zgȩPu߶.&~ߡ5 @u^Pw̒L1F|8ZqX+%DZ褿zu$ZJ|]_|^ŀRTҧ0zPB-4+aYa.J2kKw?}wN'Essp@]hy4o[pi4UeņD~WQS=P8q]hBzŮ;[Wj$ifCn\|)$䊏)W<5W.7o= )8T;3NX>gI|uw{N=+vՠy/l0Q.Tt{ZqX2B%/WUr mIk@J (7=0SҚ!j* P3*֫CP7D8kٷyT B sOb@a0ɺ`V*S]4R%̗MD* }Pu~R(w l3Ӟ*5=r\̓PsnG 0^e{o;'C#N|~tfpBQt(4g5{",KErB~R7} 7a4 RE7H L 8 |"0ɾs10ՂFVSӉ?H56e=q~\w;8vOYGS%ԁuf:5w4vm@'!:#h";)> k>);lͧ)z=5y>4ƫ=|  K̇gk׋io !j~z\Tz8:ʴRkm!:7@9eMǬY.w ⨣U~ꀻnK-E5QRQݶms߷; nWB9Wږ_)=Ȋ5G}0F;k hoeāFVoń^xf)4,q|XWG\j>'~'rPru a$L װrs!L $g;ڸ#Tq`NmC7Z:n> endobj 76 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 81 0 obj << /Length 2547 /Filter /FlateDecode >> stream xڭZr6}Wڄ/x4<$ٚ̃VmUɒיn@UEӍɻ6sie["ˌZξrT09?\XiT!|SVwi4veXhf!Nlx򟓯h6;/'g9=H.FFBDO6Xq.ü.gy@Z6r*,6kL//7 FMr AslenV70jVX½j_+ ?G5#p&8)T2/xǧE)Yf 0 _ZT+#%ֳ!/gg㛛5ѬF~Th-ۇ/xQM^VNWE)g(*+4#ÈS>O)M>2']pXF[Y GxP^X> *EaZ>^~ߎ;+ەy',"$Y@HHT6\A4|V7UGxP<`K]c#q©E/0|f SO嗋ⵈ>d3ښz~V^C볟,vlAah'$kce|sA,j hQAl2bia_w)KF*b{̗x`) FӭPa [o`ݤ Ɣ@CEr Vx1!%>\[[|YQGook m7_b82!a@LkՀB9E'e=q~}u0aPn`Qa` "pukfpQapV#-pGe P]׏S `ÁF$L|(<h2pwCTM?$AU#ޜlBz/}khl1`417d@*H[a{23Uuzte7"ert@E*V:MBM4)dSQ )bKJіУNfj5{gkLU"0Wa=절sWu61MSL,v3|\H!2c|@¬>P ۛ␐kbVuƅqx\*0Ȣl!{KAmiPUޝaLP᥁CbI,R'4u^D{[Ml'[yRI5y,7er?.jjn 6/X!w __p,ϽY'~C-I-q$J 3v(k"ڢu1ܘtzIO@jݲ̀TMU}0* *Aq:iip 1`*i5F?9euxzX=59k۸*17h΁cJU|`H?lޘtbTP_$X'г\rZq~ݝd/d%&{<^:~ODKb,:lI& b  >o]?8A``WpG(ʡሦ`e2눦"?>_]v5iFQqnUZV;g:n>С6&WX@8/XGt) ,FB7I(_(W 78+[zU>Od Xm 4fRE{Yu`ANt:Ydyo`g!\5IF# %]"֣([=hW-f\}(8dm0 %+T}ګq Tjd(i+\> endobj 79 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F14 43 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 84 0 obj << /Length 2342 /Filter /FlateDecode >> stream xڵZKoHWH ;fwn8Qf X-@oVjM4`fzWu޼7%Vlr1n6+KJd5 izB_MUɇd2 XfiVX?h6ÈaMה0kHrϣ4hVNTi$dKK$LKnT `("BHbK-00kv1eg"KHM(IiO0h>bU U=T CJiZVJ9yVRNd_7׷cI(ݯQ&HH t|sq|W {] -S /|V"%z<0I( @/Fvpj lc`X:ÃcȦ4T˿>^'X uXa bʮAAO˄WS9FPA8F>i|RŖcs=0iPE,p,,lGtRjiծ쀢@DcCB̒KrOWq|G Gn7kIXG!L>?w)=\qg+agiM}w|>sU4H. Gn>דT^HI+7mB~5&J&d"ga!Fx RXP6Hd #Do"t}07Q6t, 1Dv,{8f:/}uoWK@!8_,Ow_cM?ºB A;B,7pQngwb8rf^p3 ?8"k< HyU{ cz^V^\Z9#?Vs6(zJHSF~o=C(l9 caů=T(VC]Cȝ =k zgsCdRb !}x> YAPy0{2OU$|pM5 i-r~~s__;& '\]|ZTM\ Fʅc#cHe\xٝN&FO$>-O]]&Kbi83|ɐrvsv{brq?msyt $19b8ڲRHBP \@6mx chA ) UNd[b{ 2lq"q!Aks\Aoo S>^|y~6ԯ!1hfB]Ϯusd 7$EZy 0ϔ۾3Ee8uAϕ<:yOu(&&g S:z?+NJT>%cib9 [a>ᄯ_>SjL@0g .p3Y7A{V6I@{ztYy %o||QIZAfThA:-NM%T^ͫUЏG.'3fǣ*N_W2mZ\ Exؗ q:K'%QJâE] snA `8dѲuu)Z- U( Ҳ\S™}nDHuU ,KV9 DF)$u"Dn+}DϤ*`a ~!!!n9iN}v x𤁛mIC}h`G4(#A̿0IJXtfTNv=xZ>3B-Jw*nfL6M&eAĂFAt-!* !Qu&hPOܽEk ')jTO~ѻ]s~2+3h{7o|NE~kkYÙdP7G)2phzƅQB~ٚendstream endobj 83 0 obj << /Type /Page /Contents 84 0 R /Resources 82 0 R /MediaBox [0 0 595.276 841.89] /Parent 72 0 R >> endobj 82 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F14 43 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 87 0 obj << /Length 2482 /Filter /FlateDecode >> stream xZ[s~У8}Fys9쥒< Ta`O鞋$ў:*3H{njtMrkn-4OZR˘=^2!DzqnxRlz_Fo3PcIN ɅJ&g}BMޞQ"r<Ù"g7gJ*R^!T[bE T+q Ҋ^xiSTpbMKßf?b a &L9_xgyjw_\+\]ܸ~lq',2]kݵ̗h'|~jLVKKd pgLSCM)Yb mߪ(*U#%~ps4&E/{"8z7iog`Tws|X͋m1EQI`FryLЦpPqn=+S4p םan uaˋ \;%E(C hpyG<<̢t6@e#%xOjnlգl8TE޿!UY<۴J(}l`!EH> GRwq$ENDnNC _._hSp 6/84ձ]>|܌rKZu԰ 9+q 1žx!bBNtss?P.ݏ~4/0-?w O"I`=f- ES_reLndK^ΐEL]"=9h UQ `{6G℄ <0L(+{m7a"PSownw,:LR"^Qrxt.:jw'J(Θ60 7v1m !kp[^>ޏצ38X0\OhP!cv ?U]AK%:򪝰^82lhmAdGŁᩭxs?] 5 ʰ#Aq9r۠A%NEYGIg|ƀ(&Nȟ;Rpەѽ]zp ^+kQ7`C W 7WDP}כgŲ]S%{EMl]b(,0d< m9W0^pW,xC -E4.is:i $xt ݧϫV|- f%HΛN"K'PR-] $оx \5}X p &y;8ePh sRGav"=l h K/< 騩M9H "W nN&}G;Pp ٖ?0dXZEIB1 & ^ \ִo`,Ʀ@}yd mA0`]lZu|$g-ꛆ ?+剞P` pT`@pQ'#ʤrA] ˟\(?VeJI0N6{?`Xϰ}{/OY0mU'PӞJjpS#IoI8k( ,6.vĪ*pPx!=9vP{ӫV58\}SJZeJ,*9F\H f?5^~ttq&[Vb1Y+͔Y#P9Uwa.n3>VJAWe;-D]l/Ux]~mp3L$o/om<)~qyK&m2늇mX!7L\;{ I8:Dh=BO ~p M ;LhaT\s (8H.)TצxsRm;iIItiY L O4AEQg )V;TR;):b^hǻE‘9*5D$} يilh{g(6u\U[J:*4?_5C[?[b4J")}(`NݡV*"z㕱 qVе;`hpw[45&طv8t:H]/SC(%]9*Ssܖ2r4No`;'VrVm|ItHNl`Ԁ`'lǎ!˅]P-4Z&w")oNd(mo;;P(Z~Z[u6RB%o !+])!yM/=(1 J2%F^N䣏J$-s(#wȱҋ$xSOP򶿹O7Fa A+ӝWFa SF8:?sq=)nM뻂,mc[&gvE?Bҽ*Sfn_endstream endobj 86 0 obj << /Type /Page /Contents 87 0 R /Resources 85 0 R /MediaBox [0 0 595.276 841.89] /Parent 72 0 R >> endobj 85 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F14 43 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 90 0 obj << /Length 2341 /Filter /FlateDecode >> stream xYYF~_G*Y>c ذ==Yp 8(~Hu. )Yuţvbr0nnb %C!%Քxr[UTlB8:1'⯋d~A'//(N5%̹݅"^._(AHٓ+nZy*Y@ſNնۦ[ꧏaYM\8~5SYԋ(N{b^ݷxau *.x۫W#Y\APJAMJƈS\oi*p椁}]VļI+WI˶[\+2FX:KUu?-1~h _oE nw|ߟ&%[d_)p=!ɁA|؝ Wgp=L.ka r˲e.1zHfҹ'ȧ33pNu{C@5F83q>6$ sPpԤSÓ1Г"hС^zѓV,(5*{24#Ro/bU,@^R4+8ҧ;W;Fe% 6U+5@ȝ"Zc,-@mmZٞE_H\ٓG%Y%d07%e.?<(_ oI\(?R0(4!3-nu2wHW,U?B 5U{[5Fo,}L'"ߪ;RCh[ZCKՆl) 8t+(V\e68{Kzl B=llo6$8k#Nʴ&0UuWC~h$M;CnT=`δ{ G!c"z8!BpJLBkbXWԉ819v!. =ԧhpN$rSe4ڧN1MǸ#T?'ǤW8oru1|G~8 :wҒ=#񝳱 q#&Z3NZCNOaǷ;P հ83G^`d}=A{UIn퉲F inC̘p.v'PW֏QuGBBaf>ɓ2@Iq,$I?$ AQw1sXF35S=Wx/,?o%0[ϣմT8Dw\h~h0-em?rNi|O,bEr3uﱷRyj 8=y[.Q}Xԇ'O@*H$0c_<3#M.?vYÍԏd(nES`Jζ*i444nÄr5:3j@OʞE Qm"E;=۳EaZqc~5puGgx`iIG&Jh8OK0jxWTP"uCh/LƊ'ѵҞ"7WEfþŠwa:߯AV^;i]:z <3'Q܂ 4AQay+2(kٜNhI6*{u :Cd;7RF3 2$tgF$:ep'`}}qaZNIsW@q6vc}6/vRx(֋0Arsl njWhbBf{-/gE3OZADp#ł70Ƴk\lʺP ~Wn40E3l@euskg<8$5JUzrj'4+<&@E;Wݴ$,_DGD/ x*Q'Qwu>aE@[M]t:M3X1Uއd( (p tҥ9\Ng6Wy46#Jɇ|rʝ14,pp*ac1/%8[@]=U5kbjjƬЧ)xhT/a7!6`zTBgEU9Agsr-2F|=- g.y?wendstream endobj 89 0 obj << /Type /Page /Contents 90 0 R /Resources 88 0 R /MediaBox [0 0 595.276 841.89] /Parent 91 0 R >> endobj 88 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F28 52 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 94 0 obj << /Length 2185 /Filter /FlateDecode >> stream xYKsFW8xAnTٵ**eTZzf@Hq%崥*5z',Tr=KtL23z9Y.<}1,WJtiSmfI;\O$%OT&,F}“'G%wLei|t5Or%OBHHM$i]C*9Xɭ4LK^&Ab zI dTHVrtȝKR3Vbwr waEəq{%Ve r 弐o/&,ZP1# V!6_!.W^դMeY$XB47X}1EDܗOZJ-ϗO3GՓGikm*UZp w}})挓>ZZ4H@ MCz޼ k8<ʠtZN`q>: Ȥ)kBF0EQ0m"~ʬM7!"%ʸtU wNEO%4o$xQ6.]ba]'k,Y2gD4:q1n(r3$B3_%g in7p%q*5+M:V?FSmmUO?vPftƤWbgbץljͦڳq| q2 [0)r R~"7E¸}P, dZ3Cڞo5Zm p&mU a/UE-N5ǁ:V%jzEJkV@gs 1L eY15d"DHiyO@TT,W^TENC.FLp\\!4}/ ;hk2ö5ϵ#)ϵGw퀔T8h:(`\@c\ܯ`aRy".rw\9`qt ߜ8H5y^^U^<)jjASz=T3,aeT?G+}aչܟVK>.p 6^E"$n] ܂d !Yf<T= BrN*RAT8  ٹH '9zm Q&RR/A)-O4.(e\ؠ4OJa<};qElEV$|m̟ HAT< K@5յ1?xT\>:,%Jy,,ϸP rE\C4FΞğ'̀|" B\ynixjVJjw[M9Hb5Mnp ˴>.oOfPg1VA%* kh5d7ʹ8hbX.Zִ{RzT^DZ-5&_ :``ٞm"  ԑMB_õ^߫m$U]-^N$Ŵn^F㽲kXfm4=E㛅ۗO7I.DhvmC6gw>g6_oyQ"tT^!RH6/T*&tEU'riݒ$$dk.3SYVZ4kBPfmn;QYU)Q?Ru>?y.!tl;sٳ:k. N7Ԃ@E[u\],ss.ORlI ?1.Ӷz4@b+o^Sbiin !#Y*"VND/b٧vx|oa#ܝ?>T}Kȧ\Ļ7r[hC|;g+iL{L=3={H=`؃i$f@ jG:PR,) Vh4{TETqؚt= EOwdqYm8q @ck;Au\|ºT0{qWSߩ:iLيMŖ բRh/ ._rgT;`!kK)endstream endobj 93 0 obj << /Type /Page /Contents 94 0 R /Resources 92 0 R /MediaBox [0 0 595.276 841.89] /Parent 91 0 R >> endobj 92 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F28 52 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 97 0 obj << /Length 2049 /Filter /FlateDecode >> stream xZ]oF}ׯ#Ն[@Ƣ@6Elɕ$_gHJ-€H;ν3__^h+GuŸ%Jc- ƍi>^U0tvt~9b2 U]ݍ~}DVoGg89Wݍ$vt12kBMpMxN_4p1\7LeKث0AݨQ[%#~t4(Mu­Y>& #N%5pWrb% acṇPxol)p71>Hl]E]qƼfoƂկN"@|hVbPnW7Ļ峐P@ziuCZbۻwTNlk$JKzʲXsV= 9bbi{Zk$ JeUT!#y4bُWJn8 @dR\DZ1r|$( HK|akj.NbG i,YrciK⸂xJ(?dI䪕u*N> >ɏq`Rk6^Ƣ K)q~ WKL2VOn S:k\lD!G?G "0m / /VdnI<|+~h™r:YNZ4߇aT,QzW۝ +fd'&&3*.? vHP4s:Ck> CC" Y@F&JhjpKEc@=atX5?K{B t(r\[ܩ|3P Gh\ =_Z&7\:KxSΰ$qR@DI3G!AK-]ȘMͪ_JESMa~7@v颎{AJE-*A!Z5ow0n1ahg\&QѾj&Ƭ!ʟQ@tckiHUCpy"xodv|=֩gqp#C>:=˶:1jhR t!'TZȩUp 4agA|a6˷k8ۯ񤽻_ѭb184njA MNQ4@g'@(`٪`pcjiD}ơS(fS{<jũÞ1H<\(bcl"Ҙ=)@.?! _o' &&~iറ54/nibrz4fSftt@:?>}3Rj0v+!;ًmSb3d PgpJj|_\޳<\H{)l -Of=Xq*#<8Kا1w"~URU๪(pN' PS5V7i{ʭ <#s"KbTȬ& ?pn蚌c)ȮQO`c4)ظ5ƼG˛S7{tDؑ-N%iZFale1-I?/$.cdJI/#yNPGt#'K}ĩ(83SÉS疊OM4o!TK wJ>dt*D~h%^|:חy*iW?[݌ӝ\|{/.gx̮x3f*Ij^5-?d<!*%4=f߳_G2n'lendstream endobj 96 0 obj << /Type /Page /Contents 97 0 R /Resources 95 0 R /MediaBox [0 0 595.276 841.89] /Parent 91 0 R >> endobj 95 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F28 52 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 100 0 obj << /Length 1946 /Filter /FlateDecode >> stream xKsH:Jy?l@k+;(%a;jYTci=u'/.F׉AF2!T#MFZb1YN8=9H&cEFuZ>]^H$'J(dH&7G?d:ɫFc,G?2rWBߍF %ER8Uo@d ZtrS,2h R b^?SK8SzFYyEXCY@k;Y㲸ȌL[8l-='7M##&Qڴe5L1C-n-pU:FtB`0]i;9|)4Ch>*º#vzv[ O|axo|3, 8q=&*$ ;I#s.t:_ ;v=Yǔ foE_lIbnfZxV.mr^_p">ϖ),(j;W`J3|QJeJ,=0r=ܓq18=3},ۖ%Ӊk\?+=(ҬNChٞ D(OI QS=#Q.j(#GLaLEXg}zLci8 4p@-Y(aQD=Q1K쀯H CWo;|6|%Rj^}{(:{+4;{z4>l^(,"ll'Xy7Б<}RΗ@ҪٕR})d0B#լl]oa?ۮ*X۲䓳70/ >狫8%d)뜒Nđ}qT_]4֣~!`=m=UԂ~-6*BDo0/gN d)fg z "$i~smW] .~.CΝ{sU=6lAfStbN3: 9#!^T*]O@~K^-?EyuyŚG ُ#0or}qCn%(yvfV f(lVu260+Wtl)\; %ne5쪾Dk nc !g̀3Uxf1]BX\aW oh'$Yk0V&!XRkWKIBB?$(rLn",QDe#I D"j} (8"l=4N7]^Tö9ErªiCkjCE,cl vLW >K(,Ģ]@(W [L p/e1߹sh@ FbP_^Z<_g9 xDmpVfmpkl\Z-$@?xFOk+/вmrT6kYSY!K)/%a.endstream endobj 99 0 obj << /Type /Page /Contents 100 0 R /Resources 98 0 R /MediaBox [0 0 595.276 841.89] /Parent 91 0 R >> endobj 98 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 103 0 obj << /Length 1660 /Filter /FlateDecode >> stream xY[oH~ϯ 0Tm^N 0@@ 4zy`t#up=UbOH@yf-W- a),k _l% wY%H%$I,LXqC*@m"Kl<˳WôPObG,ׯv 8AD Y:5XqB-s!'MroklP]*+ۯ}-,2LYl{Pm9sZ A{n%+r( i7BUtyפHχeЫү mA8(eZV כNċ`ݜ8mõsSsR5ef mw:Uyq-X;7sOM@~b["p)\*Z9r./+;TPi_Rh1+ keBEKVBa!Hˬ'b8AǡWvBʹֆ[c"L%-+J@)u@a?_[]@r@@EJ'GXC]rPp u0BwM?~fQJko\HB#9ϖ[)̡\N#U<+^Tsl;lF2۽q7DpJ돽T2Ҕ<1VߘdrQWʳH+ovė}c?qG D0RhTPendstream endobj 102 0 obj << /Type /Page /Contents 103 0 R /Resources 101 0 R /MediaBox [0 0 595.276 841.89] /Parent 91 0 R >> endobj 101 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 106 0 obj << /Length 2553 /Filter /FlateDecode >> stream xZnH}WQډ:{s6pĻɃƢl,Kq2_7l "@KwuUuթE:?z,5rrpL҉ sLΗ_j6Rdz|6wrz 7rȶoNΏ$?>IՖRO.G>5,ɛMp02^_}:G#c!W*ƶY=Bhj} eӋuᢺ0\3)ie; eV\g^KR'NT(Es~OtrIE $St=ksHY/HeHOX!s8SU|sUuF7/pD$ xY:^Ǚ7r͕*3; K.=~_Jit=[̫eێo`qPPzQ]\ʲ$=TW Nnz~2_A27ePЈJ!c)KPYpyJSR>=ggNN!> `ZSE;ҤrPuoEF"㎛ю9n:vX=]Y6E!_d =B}e HԶ! w;GXB?[Y;-=ʹ"jnT(.hti8ӻό2^4`=Q,m>̆FԸda)=KmU ʫ;zWW0B3"D;ZfdmJ%A%yP*!I N<(vR@U>-^w&vC@e)I** >z=\j |aǠ#jKϡWў|M޴, ވN@і 8b 0PE t=>QK`VˁDrQJZ"7u9Rh S頰c%ֺy8&;MUjR]ۑ2SP߲Gns\72RHcZcx²4ף Za努Ŕq2)7[?FSz_um^gvJI/j8K` 0bCBK |dPbE>! p3}" S'% 2\˂F˛ƉQ3~\^?΢;)x?͊۹$J1}})(ғH|nb 3(k`iO[cm|O1nAX&`\=fEQJͽX:Xk@^b:Mxn2> endobj 104 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F27 37 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 109 0 obj << /Length 2507 /Filter /FlateDecode >> stream xZ[s۸~ϯУܭX^EoĝIٝ-'ޱ-l^d)oN5- >}t杉2"" 4Ę4M?r09ϯ,$Bb5&r6E(VdBE?'hzB'DO0eY<\$ - [ۊpAh9W%#d*/h Z7<TOU 5! aT{ӕ|g9vaq^pcuRս(V2.fY}6+eQ`TstdpF2)IkgtA7p_y *T"TX(A0Kt% en x2VO}<;u#qoASr@փ8/j_NzWUEI3,ԲyL0HGȘtѢ@%[];cEUWw߽8^:Ag:juZʷ^^]Fi&*`*7%-9\o.JGj/eQ~ܽBsƉU Y>"&.9YHfJXIFep x ;ִt5IennJJ霓)Cb^9ȁIeB۪|*%K/\=*}/s[_8&/ |pMk4vMU|u s)1_{/ӑSPY=G.J"9.2H_oX%Bw겿ˍpBC.r@}"zE:v`x< t-}@Q:HЕ4]e ӄ`e!Xz6r쉷mjDv ǝ[pOkji  nCy_^ϝ-ke͠餴 w\ⷍdke 5~_EXBs6rkAr+qzDQ^QwQqۤh !!'d!0 Y9PAZ /@[ mV[us~SA~UӜtZz")%?$x;a5uMyqck >}V+k\?`khl oDFPL6煵z&biؑ5֘pHR'^=1KA=iw6/jZ0l,kcͬX@-Ѹh]h|]1% Xp` }NJFdXhC4q> 7}%nYmAh Asy]?HKtE-U[A+,,@Oejc1LBJ;cRz]ICYJاc.y,&QĿz ^S{'n[$]USi\yܯx|=K{~KJ |NwL\z$`_G FYYa%i4z7KKhv'XFRF]*x"c+j7W3&xڑ~oȶaK`ҺW\1-Oi2, ]3Bx `Y;6^;* [wt̀}{MbA& aьWSvkH U!b2^@jgaui-utq`U^fO] >ܹ=z5ZAŅ4i.xT6EO9@wkk[a!\pR]Ak>2 dO` YqXΊ#:8Kqו4u18 2Y`i l׻G&%tske'B[R!2--MEJʺbP)'а[q7U 2f)ƾQ,v(-t0'䮈 = 7ٮ`2a3 N0dy(u L!# !`JGᓻ L~2[{, '~K M]OJ:Gwo,^,(}+ߜ+.i*= O7UujD&aꈧ%nv^_ʒ)Fa(o펲q~8؆_u _f-nNoO/~9@y2BnAUn{i>ϯ~翅Ec{UoLzm#$}NVyq ;6"w8)iUXx6endstream endobj 108 0 obj << /Type /Page /Contents 109 0 R /Resources 107 0 R /MediaBox [0 0 595.276 841.89] /Parent 110 0 R >> endobj 107 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F14 43 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 113 0 obj << /Length 2772 /Filter /FlateDecode >> stream xZnH}W ;}';o$vA#Ѷq{/iRhEM6rN]~[sV BLq7( &3=̅g"0̕RP٪Z\rՁp)Sf0;/|09w)W0L87;R_BHṶuEbPlUjTa,|47qY WU0u>EtqAd(vX;1{Ri]F3'd>nJz\8xzg]ra3\c 3|^uHB(&"@4Zv)6SCM˥ي4&w0%+ JxUD}45w5&Vt6#0KfM -Մ$Ն&LjJ2Jkm=yLP4k6JHx^ fWa9r0(0{4α®k nDH^0eE??^ K]uDU2EbS~{\e(gӶl*wy~r(NR[ۇIV x rpB x MFT_Sw3wLOQ婊M 56L-ԌZD=P4,/HjJLNfh f){k΋޷4 TEYyCXO 8)4TYpan*9rR WɈ,<s=he\2c/#o\%I)iqzd( E(GJʕ)Qm5Uԃଙv+jZJ:VTa) H |'=r$b v+Pĺn2EjoT[Lq/4kK()X'"( Wa UoLF&Wc\kaN 1ERctiU%F{:ʤ|Rb\'a@/&xB=.Hlt?| V]e$'Ѭ_fx+ưҥ55sJ0UZDudIҝ&R.9>]vDZ,,^}z#O@˴2 e-cLPK tP  |8}xzT[rUuU 0#kZҁ4 %!C-FKsBtt?޲&Ѝk."#m%UC0{^${W_P)C UbrN UDNTHy2G긯;[o|c `q[@1Y'>XqMq7=.ҦfMGA3hSXM4܁tzKݠ8zm3=ROzq}T!i6miJMtgv⠦d\G#P90;4{/,!l3 mx(Φ<v1!ldulJ 2s-RjTV}]s}td.9mkLҤmt϶^A3=9ƤFYMF.Ʃ0\iK^LN9(5-R{*(?CDCtPTgDȍv?^2NaI).)"ø(E=PXdLWiW[AoBa{/ڋ> I}87*$ -X`m٪r ە`@! Jn 'YyCXC`\ų3je :COCQM&4!'cŒШʮ0Z3  բA#>QT=\SyP$7|K/lwQE 3Gqf !&C&@wY3_J(Xo\ĺ |CqbK&Ʊ]>Ư?AuPYx{7_|c'> ,4>~SWo~^Z;Aahzbo(w;0O 㫁pixg5UÍ ҩ؅񚖴ȣ}kAg{lCh[,|>.ox_$n3lVH´?o 'yC@![>YãBeH[ '_ U jcމKTj~:^ьeoIɮ^TC~뿤[^=yzO|1WsW}(XNI;ܢe3Y%ihendstream endobj 112 0 obj << /Type /Page /Contents 113 0 R /Resources 111 0 R /MediaBox [0 0 595.276 841.89] /Parent 110 0 R >> endobj 111 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F14 43 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 116 0 obj << /Length 2403 /Filter /FlateDecode >> stream xڭZ[o~У]M~[6I4b}pm9±rdgCŖ"qZ@5h|{9n2c(Vg7/LpN!χ"?[ We=͇̀e(CP~4 ha@p6{5%̹~ zelW\URǏm-RP, }Y )ߠ}^o A`}''h>~/Csx-$/kY+)#q]W7C';Z] hyN%{*zֳL{ʴ"/*z"O1~#Zw64l ,@u>~Z|\-zU {eGQX\*M(Y#oHk/V&Wo/h!V.icPq qA!G(bX-,(xN(P?W4[݅.޺ {57RA1*m/f e8n!E~޶nc{A7T/E7q4{+\xmX×:廨4Nz8\I}|}@(mQؼqTKNRepˮF{piڋ?v5HD";F#\BrbǾV*t5G:cNsT#ΪtIV<9xލ=e)i @Vw[:I']`@(RD|XC9\ $g]xx0fGJ ̒=B YڼUIzثp_g=ۈghNwk^SYBҺPQM;Dk'L eigӾH;,]Vǀ'TgH^$=bX]ՁٲV(\F[ ;GH X~]WX^v'5QBI fa]Cvvv;\1m"$(wG˃vThMZ8OQH5 귲Zx`%K ' ]Ե?_DZU^ʍ"ZK:w/ `Z9xNIޥvZhlV@$q}P6x8MEM5jǫE#aߛ&pqBcL_rxU4u$W6PfMi@yn#,r廈2|E86ޙk- IA{`U: :CHhQ#T7m`z6n\1~v6Uy(?!UG-VUX,3m[ &uPT[َb㳾iZ!Ǜ^ [h8`yR`H `{azw?{b+Rt]9^5,m;FZfhpރ? Jzry-՚`ޫwoN8W?oB[ߖdQ w`#c?BjÕS*ssZendstream endobj 115 0 obj << /Type /Page /Contents 116 0 R /Resources 114 0 R /MediaBox [0 0 595.276 841.89] /Parent 110 0 R >> endobj 114 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F14 43 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 119 0 obj << /Length 2140 /Filter /FlateDecode >> stream xZ[o~ׯ#_>@MkiTt`K>T3{&(^ offgYǛEqs[0n0kuq3Xq紼yJQY-us;՛񧛷+((CPaOhvDpxsJsHrGף_2hQ N]r/KJK/R*P2\ 3SX@b 4&SS8jLܰ^B9WLaDߤ +=DDOqJyԀ¼0T-yۇ[^ta^E adU4#p]W1WJr=IְZb\[ɋ17$Ѳrr]϶ j r&gp?5,,Zv/<Ƃێ߄!VB;NXy[Ueiaj5^6){“`&'RpcyCECN`@K0Ga-8^a4l_jL9S*$f N ڂI+@1/oM7c t6` "[/NYUx +ʏZT擇  D\{ь@Q2PH*UcChId12` '04S䅥$djX$83>-pvO!Sd !*N UWI~7/8>d?8*w{3ӆ(5vc-O#:#FKliT`9t"!EfK ~U@0;X~BDY9|x"QNB3aljr_ \8D#KqZE$kXQ薢ώ05}P<3\ا+gYm1eU083y|W+.&>ŤU / ͖٭beZHw 3>.(a@cgW>> ;yN:߶N@_džnqrdmzh9XPѳϳf:ڜG+rB'_CY_oOY[zCDCLSmnK94o'c1 yF1xnD`>B1^n b} ;NsA2V랭I@2}O9DΖ‚5i5k=L^foW_E¸ w ;NҠsX $%鳀LA 09ȼiOѣ槰:?LfK幡E&$:)1H&q*&&@6~8d}|@ Ւc$jo|iɣ*"*S3jƆ\29= yĈ1:@*vזS&|m6Y?īH]gcK 12ߥd$ʄuʘ#GgF_ F@W͠;iSep _"COWv$JiXx6/6(6 J6mNQ]s 4Lb"Al{1 % #W!;6 (8[X{1 ±Ш))Y>NJWOc`MqxN<5k *o~?E$ Yxǘpշ:ɪAa\(GNWV ]r7]endstream endobj 118 0 obj << /Type /Page /Contents 119 0 R /Resources 117 0 R /MediaBox [0 0 595.276 841.89] /Parent 110 0 R >> endobj 117 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 122 0 obj << /Length 2809 /Filter /FlateDecode >> stream xڭZ[s۶~#q#92NNg<0m#*Eɿ..hRk+㯷Mn(?:(\f볿Ͼ|MFdYBVh'j=Z ]{uvsVF B@[T $F] Jc-|+ޠv̔32 C_ev I溜vKhEmo57,m9Qug5j /qNq*)Rb*F?'hV?><^#"$eIF(;b8\ /z qx&5mDn>_\LnnOIJ8R. l6eQQjΪfU4EjX(eа୸Hw;Xɬf{Ym|SL8=bNԓ T}:>N{}hBڭC @DyAŢYO0D&T%$S u\n tu~MB4N>䃐5L:!=JJ ۜ cmOAbQzZL@*x5xJC"%T4vF~ae ?wm"\^3;tZ lm>ù{ F3M;Y5#"PLh!|*9&9ɴwMSL}s[%B1TX,A׹g?<;`wX tz ~vM1]æVgt9IhcZယ}+([>D*1F?h|}Xuab];pmKU"؛ʶ9'6fTu1'8SR4`@B=qyam^z I;&'Bja2B!s=CKP+7Îu i\[o^4)$Zؾl2a3HB(Ve5u'DE7%X]R U&x)Ѿ2M-&(B.7C`C eo& A'f!馜jΛ6 q(ݽ6TW7<2Cz\>e0[02;0ArWF 9q HlҘ .anus=ޢ0rɳR9B3K 1sb㦄H"* ɂkH4BU#$A'1q2Dd>6^e{mdRI[B7Vkt.Ds ;u0n o'xdY[W4._Qstgc\Hf<]Z`F6`ޡ\bbBO9h'WVk53𲌨'IDSOb)#6h(yC Cβ< NBPCA>*rlKg3[Np Iģ\d޾ӝU~u\[ ^p ĺh'[Ը"U= ʞRh%Nwޚp+M9L ym e婣*C,Y ܭ.3W8o3-GeBl/#s=2~Q| d&4=Cj4cQy>{P?}9,Q޹;0kC?N8Ice:6_&]c f}@,"ӫ7 uz~;Lp|'Tpoi!S6CÝ=`{fL ޿X-]ANǔT195hE ^-xa8Yq l`' ?wJq og`?~> V4ܞaxi&Ӎ)*;}d#l]TM<)+e'j-]Ð^ Ҟepk1rPWC"6> ۞TR.~y'ݱvwZwm-lnb'0lKW'0O?<~DDAs;~NV}Bkh/a fiA*B[A1hvޞlaJ(0)qȀ>g~ȶT"}m8ֳ-@l> endobj 120 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F14 43 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 125 0 obj << /Length 2546 /Filter /FlateDecode >> stream xZr8}W Fy8JSA([[ E'"MQbU>lReA$nPݞ|cTng. dYŒIϑ\ D? y~K)P̋xo_nߞn > R&˳?>Iӳd,aҚ gJ0^ݜCHܐ,IS:Q+ J>:/v+ROg K`&X<__7a<”|-,_, .n_?k+[JgZy6[/e&>s2.(UCqάփkf_ ϺLSZ$c\Qqi7j($qO[^/H|t=a2imȢsݜE^S5SԌHv7cI{mhTĺ^d^N3'q^A)N](3D I9M>_ݎ;I&eʣk^ ZǦk$&JYvܤ /ֿ/;3̈́p{3JyƋ9Cx)D/K]e*Xm79j-ͯ>{%fEj_K**??EK$i`/p9>n>ysyq9(Ng8A f 寭VAΤiTALtF~ ֻ{_0]fukh,7.)\m,~ZUm W~U}:(v*$}U fDP|Q"i bݾ=]OĪjkκz|(tZP>v|E*e4[T_K_ Z.b[emtOFOy-Ywo.u8[E~ m6:2K)iJlOHۣG(P X/ȊzSIUGۂYqn#MY8:OVc`O%748}]!ͨ`=^MBhHX[#c'#,zjT.JxYEDRE6y̆bխ>!ZG|fVAMg`lL,vc5DHWJ+mBewDUP|@('F>?4ՔGAGv,Hxg(HBfO3(L9ATO 3~Az@\Yqbsl$RmS|w9[]j%3 -K[so~ կS$I:i$j7 endstream endobj 124 0 obj << /Type /Page /Contents 125 0 R /Resources 123 0 R /MediaBox [0 0 595.276 841.89] /Parent 110 0 R >> endobj 123 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F14 43 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 128 0 obj << /Length 2708 /Filter /FlateDecode >> stream xZ[ڸ~_AƊuM&jR3= 0;;t%ca9j}2/|0=l*{,aƤHc.HiԴ|TbBϪb_f 3Ο6\5j݋fV9Aj׿|?#(eIƸ8$tU7y5Ч-Dwwm˧,kg lXdQʫ)u嬨1)gԌPz3a[&oTVu6+eg1VA!No߷SϢuT1ڦb_.o/o$2kBG+ ,Z9X( ^ܤ̀/4z ֿ[3̈́p-:3Jq?6lx/ܹi[e kn"h9͇>DYT~_yit{ ;~ ÇW׃}KAtֈ(eW0Sv|w; r&M# e|/4dHL0IRalr) Ahjr3E-ܵM @m)qPlx|7"oo'$$YqCX~쫩ݗS*Mga <:zQU xOAmLZ :6l5 Sz߁;L{Kv/m@X478Zpq%)or@ ܀*փ8t&#PRϹ7u':.( -lb xWĦ`|A{95mU2 Шjjkt/`D8ylfA9<L\r.h)JY%Ntu .#{gt}YYvZ .N$>r"V5!ݩ'RfIM}" Z|:Ԥ!j5:75"PσC? !n'~@IbO-nt' hLՉ?> o; ܡ~6)Ky )$VSa 5X6??Pvz/]🥭>a;,i>#%p8(6wfb2-Nici&~9;'tvr1q`/au^YӁvOYbCiREslE%M2C2`VԸA.yp򊔝rLQ>zAbNjRW+XQM//EYlJn9]k mLv T5`$m4#Usj?G|ERro *+ hL7[o}ށOCjDuYO^Ӫ)k\}hտ-s+>5G> endobj 126 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F14 43 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 132 0 obj << /Length 2535 /Filter /FlateDecode >> stream xڵZYoH~D>漍"AM<2yP$@'~j%ZxtW]_}~yT*j eWbp9|(TJe/٦^]:|pJSJx~߳O`r8S3QU*\>1aBXږW:D* Plu&`Ҫ?yek1e"̖͟6ty/MtRTL۸wP6<[CYfZ:y77#I\yBoip*5.6uDŦu8\GqnvHC! # UkJdfU%"~aSj& +wQWdfź:J+0`Pshfk8&͸OY)K(sL$.5_hV(32[jLfa]FŎkDaqȰy O+?^gn,~wҵ_Y\h";}VV2²&Jq.'dAfC,Nd} IU9kƣ[|q")Xc:e46pl9RE[ςJ} SNܧ^uZq@mW9DF'߮YO.`RnmR5]۞lrZE^{+, |i&˖0IM!@%> OlKMA_=&,M$%SFLY1õ_}ȭ.ᔸ`TP꫘0!_!.?|NnכwcyuF#Z3.Ů"guO| !ҷ T;kN1qA(ZyLܦBhu$ՓTЫU.cI%nIio.U"ޑ(yNL0DQ"Tuo4 U [T4C_q֍pk8pw*m|; # VX:~Mntqnw<&`MT%+%Enu|WGmN/ЄWQzk*ӯ(躑: HCvԂI-CJr?jQ?sSw hAoQ=Np6<(S¸Ψ:ٕbu 0oCoO] }ڴ7rgQpGqL^[{G0!!Qy_`sRy'6HmeکM0Dn8uv&s}toĔ?Jfw 2Xjt܆Gp8hZ<4;ηf:6:!pӉ Ʈh4~Ș3mEZUeƱz%If,e@\jc̢jxȼ1 `2v8K{gIOJ{ǯHW1'#?K08 -dS$ZJx!˞TG;X`*X/(}ܼ 1,G lg !KuEZNvW~+Pη; sA1B=X 7LItX+}x?uzy@ EVUE:RG Mp_Y;MuƆJUvg. ZU+}Y!cW33.1l2'βQ[4ʴB[ WF,|4*V j Uȷ1 '9hг\ll9qw#Ϗ^Ŵ?tjg곥xǯW\AM`憢~ٳI0˥j\_5ԛk7=pQk!ňgS+9/5ȔFwendstream endobj 131 0 obj << /Type /Page /Contents 132 0 R /Resources 130 0 R /MediaBox [0 0 595.276 841.89] /Parent 129 0 R >> endobj 130 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 135 0 obj << /Length 2797 /Filter /FlateDecode >> stream xZ[oI~ٙ7OBD$kH<hH'@xî,Թ~R2>{qZ W- Z=ϾTrX39^ðBToCnMLh|сQ8۳}J3:xwFpvה0gx8,ۮapdV) QT|AiBIzYk1mrH`|kZχǓ_5Y,E 3G A}sPQDq΁-2|]]mՅ*9f{>bׯثA5jvҮY5|v`]YOAJJ:<]qiXxcf YRۀՠoǹ'hsb#GVT 1EX@z!$L2_naf aΓnMTͪ:m;(U/e~HY^Gƙ&"Nz@0\|)$|B Lh1;s5>-5WF5,Ѣ nli{{h bkF8~񞸾G}/~ H:\Nˌi퉴#_qg߿}]&%H0o9o/?ƣ`15"ʫ< `Y8HB~*%qL,K&mV%T/)mBO­C}D:/ Pt,q̌^Lk|8.8NWu/~&mϟ>}ʐl.:̝1)ʹ]%ҥAF2Γy]83gʀkU^{l_k~p3b,܄')#j~)юXSڙώk7oN5KBASھ2ӐUmȪC_5WB+vLX:nt֋*\Xԇl@p ~wZo Xxk">s|8zSgP't Z@欝f 6({N{Xo{=&6mcM R R3ሖ]+> Ip27ر,-ݮ7Vϣb' '$3V (E_/{zƉ{'uJ.*dөSޜRn~]Fj=YJ@N>K8A քyy˜!7B ʽV:J$Y+'h H RS=]jN?ʑRQO圎DB.=!k2#x:LX!Ÿ^~J@k1C \ >T VW) W~5Q$R3Ì+h $8 Ê/8foBJ,hhh,WA_E@Jj?^4r7߀jb j])tRF!wPC x.FA1Xr#GHWATz<|gBjꟀѫ~g= Na@4#"|Ns񸂴$duԄD /_Ug [q-vÐaV`H%TBI@GpDV!B4ब#h"6#A'6!ECx縸&JN\[jc]x~⫟O /:!QմjaY]7d n ~@8p{珫]ƳONrj%DnUendstream endobj 134 0 obj << /Type /Page /Contents 135 0 R /Resources 133 0 R /MediaBox [0 0 595.276 841.89] /Parent 129 0 R >> endobj 133 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F14 43 0 R /F17 34 0 R /F19 6 0 R /F28 52 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 138 0 obj << /Length 2239 /Filter /FlateDecode >> stream xZ[o~ׯ#F_[Ӹq@բ-J"ERb0`Q7O6si]^g["ˌZ]~x4q"?_ͷzzUl\]XFefFʮF~fލ(fOpL s.I.bic Tdw:E jUgXϷqVW?A0&I&p\w+?˷mrx;UYnTjUIXA,t(pq9 gx%lq*ڮ&,onNRV\(Np2w1Vpt"ͧE84GmIO\\h?8࠰7 K1h~+(Nj30#jRsf+~;1RBcrz!%`*w.؜HpYw8DK6 !NI2M+Ϛ `Q RxRHjT<5^Bd'X"iX"ٱov;f2k#Q8"6 @.cXhLJV'_D_ƍlD%p쫃YB!چ XwPFsCG=Ɉ π0+Qn;NH=UMzJ$$a|=uDj&Eָ3pI8Z!%Bb rx K%v-a[{^K2ۏ'`'L^۟3Y 2KX E)A iDJ*ARsr^֙RLO؝RU)B!غհVɚym9ɱaQ,ji/ fT&2sifi,,WdL\ dӜ(¨%N]y6XwdJXSaoM93k彧kZӑܗ3xd%֙'g ǹ s-VY;H`ue$rb˱%آ$;,{6~!!r!p d$U܀o\Χ7?Qg$ h6]FUN,<.ɩ$[MBe;<瀶*6xX/P7=MB4(+ݴ1%҈x:B*ϪmVl×qF] L2 ]u KGZe2"=n Ek'ҹ#IXpz9 |GsLb"֡(Axy^Ybe|mihq =U/|>?PPLཅ5l$:FaVRu^^&0!+L7Obג)q/IAYTFHSi٘J8?~Ǖ:<5 %#\S|)⢁2sd^4WH1?*WEo ,y>~n_[W'V vOendstream endobj 137 0 obj << /Type /Page /Contents 138 0 R /Resources 136 0 R /MediaBox [0 0 595.276 841.89] /Parent 129 0 R >> endobj 136 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 141 0 obj << /Length 2592 /Filter /FlateDecode >> stream xZnH}W𑚱:}d$q&f灑hKLy%ڎ~""uKfY]]utQo#N6cA]f %fW.#&8!? GBm56m1.Wÿo .o,2G3 qBeMɀfgghSœ؞e@Ȩ!5 c7:E jU}e弼/yWheׯO)LI֨!&̵+߆u}}ˏ XUOʏרo{KhU͒(uY8J:f5Td˪Kpy %lq*-/b5_*%ֻUq.o?bߟ^ }s\K?aaq1O⺲\nA^̋v3IO( @mo:P`/eϳz Pv$0@﬋ݠKӰi􉲛,!+,BW?l< % aY!{I^#YWC֮앆t뫫>H{'Γ v&4Ggc149B3%fN%YkJ [tiL_oÝuUBzKpTߍǂ+t@f|DY|q™yZ0͂ӳUw Ax` ePZ⮃J!$%C'w3ج|n2)o y^䶧bףs?C\mr)bDB9ׇȁyX~C.LC'8)&gBɵF@jl9pP{#QXK!deI3 jEÐ>N܋XbN{@p)#/pRn i 7gUkƮJEfz%CA}hȍQbٳmnS0y`t!N97l2RZkY X<nڅiH0ɹy-a֜vbvz..HmtQ MKzoEMkh-L8F@/hK8~?7A.y E} ҋk>G6hgO:"OO<:M:sv-mml-}vP؍~~V)CRk)7FXuٌS9F*l=6m`*0>^z怟-H۞^1 :ӫLG]dVcYOx3xL4BAQCX~EM?yd^"c3ltk35-G9 鎷VER;_ձLUb6fIʳlY˰)nT!!lgM#@# ֞UV5 oSϾ8G)?s(!AͪLz.z$4X$GO\*e$zAï*8Ɵر1ULi#a2sk:;D_^Mi>~@.E帼] Yޕ*c-(~B|^x 9C^+TGV mk|]endstream endobj 140 0 obj << /Type /Page /Contents 141 0 R /Resources 139 0 R /MediaBox [0 0 595.276 841.89] /Parent 129 0 R >> endobj 139 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F27 37 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 144 0 obj << /Length 1925 /Filter /FlateDecode >> stream xՙ[F+h0 on%P)VdH6_sf$7.Udb|/l3GeƸ%JŇ\%_"m]|2 Xhf!Nlys#.4{D8}5%̹f!Żo*;]R*.Y-h㢺^ `)+%^~'~9HJF,<ؽYHa d`]}ή뛺)!22;CMX~Q/ p))%"[ G}%䨯&=WHɴ\Չ*wbrVu{RVUrT*8 /P hv{Si($k\|ۇϛǡFtsZ߅w, .;ksDlڰ;k>> FM8|`8 zV75QjO[ήzvpZ jOHSfD}"rOu%|2YC oԂ*ԇ=K(U'AX)5 ,#NL "ϔK4̇o^-,χBV=(':AU&F zݛ s/7\?Xv\c.h)1SYrFWhy=_+y,ԑ`XF8x)PE_5lTҎhQqDH%x3+n;h\活 ]{!IᱣTA ,2 2BS8q4}Zh~T7~er"pRKcY(|xVM޵u6, NZ)hs4+AHO\G`i ]E<1ŏ_Ub+F=H-kĤw-˟ 2XƔ ҿCm}u<iF;K4g2>D@Y lڵ12rSMpӗfn a p E5pe 4)d6GDt[dS2[,~pF?43}dIM#K_@a46w >1+l|dGD  *5wN5v}OobDhH!O'i>6]+1 ~{Ӱza8ø0 T!1FPI*=ٮUğ6 9%51'OR>d6U_G#@0ګWzY7ń!YUS5O_` ZSkOJy DvGȈQn@Fnr9aI0)VXx cۣXq~ A>>"=(|FGOtg y.3ekGOX렶EsѮ1Tcyj4%PےBzB53܁w1#VaRcƮ0Z$&THj+ ێ0D[Ge-}:YK4N"RKYhGM(͝B2I14d==I^v 3Ls GD;&Hka 0r}­nyq> endobj 142 0 obj << /Font << /F8 19 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 147 0 obj << /Length 2142 /Filter /FlateDecode >> stream xY[s۶~ׯ#Ն:g8N;id4H]b([ӣә3g]P:{[^K9v8V(L[n}olq ~1g(Ӗ*'9kR~BRo* XabܚcD6Y.1WZ6Ʒ몤jp Uw'崜u̪F &mZyM0֦v8$UU GX}U-v *N"cNCXA-\vqGtjW#z W*?wTO`fYOjDŊT 7XG%nzV8 CC:WքgǓ m'.Mޯ!}܈n@4~`ܠ,+j}X{ڗ9w .'a0ଐ2p5NHy)L»(lAI]?m

C'&佉Ox0L:ƫohOE ]ܱpͥ=r<ׄ? d/b6^v/0h; Vwp$elgl}uzodFoPy| ۡ?Q2"j ?Qj?8k!;'議אE|*^4reW94$:Q4 )an=aJ ?-C<'*CiA0Ђ(l5S AA,}.Dc) qAj/cK0իej:3cS 93gz#ŒE3㓝ϣk=й&wӕYBWRm5vbVa#7/88@)3>F^Gaah%h1T{ bk4ɝB#b}1 Sz6fE<lS-Kl6L,)&xG?"ASXPv47裛 YCBp#ۆvEMPYK9gV0؍a9$a')ut30Krx*a46cR2O\SFB>@ _;^f}Ba\Z|,?ʷA1=E(}}Q^@r16.U]I") oRzPGoR3L&A+ l&Npb? aa'BC[QcR{!vx퓘)=#@_0CƱFeAW7֐HY6YZZ^{q0+{4 n F;-riƶi0r':lEnDsŏPSYz|w+b[n`lgxll4/c~&NP.H-iʅBZJ.gD5VaӒ#z Z /h4]%\4r,bp_+ۊT.c`) 7?[A䇦 VE+ VӺ4Ac ^g}l`cGqrΐ} k8h*ҍN0S`F!K]{v` |wsʪ-_Sk폁cBc[rn;7fʥ !Aendstream endobj 146 0 obj << /Type /Page /Contents 147 0 R /Resources 145 0 R /MediaBox [0 0 595.276 841.89] /Parent 148 0 R >> endobj 145 0 obj << /Font << /F8 19 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F14 43 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 151 0 obj << /Length 2660 /Filter /FlateDecode >> stream xڽZ[sH~ϯУ̌D_- dBA`gvL$rLȿE"qEeux;:z/yYdtpas[[$T 2.`~dRd>6]W˫e|}8:OJmRX29bɇ#&f9/H gGGe$"vEZP$VEږAKmH[2[ /K9y*E^24K2ץW2erC{A {, P(pFfH y!3/V51̢!G窰-οdB ??}|<D(kB#a)|E"#x0Mh1D]| y~jEx*g(^#-eɐceuE~_GOq@[h9-Vɸȅ5'\aS4 CI!M]q̪[gr`(Ҫ}AVhYwE$ίVO 9c*_ /*=ۖhfb{,-R O r笳F" %0 2ttהXTvF6͝d[E2-tz^ńivO\ʠEO +!+̩}RZIl#GT ]B[R qά޼fM(T*dnoK OLE͂ʹ7 ~c/U5BAb@_/Nn΂%|ȝ{ҎAz6 _XS_|¬W:SpXa¢!2t10%oϛ..Q+K=YfEOՒ4 cۡ;# I(ECg$o.=Qַ24/T$%T_VzuzG7=*O-J*+g bH(74o.wa_C'7)tu\qURg"xj׌ ! M wPڦj|7IбYQ!u:.bq=`_Ya@}#gN+0l*/J7`N> h-wt*HV NٲOt^kWS܁3:""O~8ŸvkE !=ƙglo|w& eu7ma ;gy6$.,f1 wj L{I$NIazZp-_ydCPO? @'{gexYYC $Р.yC[wID|y,7ҳSVzJ~\@&%MU//YbM/g`^aqSǓs[[7bMݾ φGgݶirf&0Qnj4>5v:9^oDYH>V=G'|[k5vvZ7 BF kH}>wG3rAv%qS]|:>0UifAt v+Ϲi)w|-CQd:i (Y\8Nqs|o\ l'CMT KV=H1垅.Ppl/  c,0/Ώ!KX@ ۋQW7P(dQii3lWB-J%p <={7#ex9C܈! *H կ,xȤ7SzMp/ aJhẃh ǰn=Ɔ@ h{ E R5_tQ~LCʀl A̞xH'F(!"C\e45j 55k5Q/b-Gצ^ JjyX&%V@"KVʸ,c:֊渧LP14s Uyӽ7Zo&PjY;\_Ht:~=eAN䛳NI,w3lODn ZwkW@2:z?ΉSZApUgiMfwGG 9EHܸ7_Ηwwc~yY]-U>H~^G>CWGU2eJ?? endstream endobj 150 0 obj << /Type /Page /Contents 151 0 R /Resources 149 0 R /MediaBox [0 0 595.276 841.89] /Parent 148 0 R >> endobj 149 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F14 43 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 154 0 obj << /Length 2537 /Filter /FlateDecode >> stream xڽZ]}_G{7m@0paXx21Tw AwRU}T7O/&%+N,$9+ ;}Jt %%O~{M)TɮnniM?߼?bRInrV*3.w3.g,&_q͙(BK.LIfb(Bw"&뾔 d4L='E>)`kț[ vVmZ*,|j.S(-F&_\蚾be: ){23dݹmfU*e$YS16C & ;_*JI@Q%+ҧ Yt҆4(^orf~S&-|<“k,H$ŗ1c%LIs⸭L,M*$=8 U䏴4I|yz"/Ï|Zwz҆-ko92ٹ_׍Mmk uͭtg_󠸈UC},K),m v J YJ@ HH!bJ#_ayˬh,rBmn῀ئ-W8ݬ!f֦HH>L.\跷巴-b/g|^gr/찗_6MkV(q݂㺁-7W7WY gۮ-CA/ s-xn6 ~ dUMBh{a*3w*PCX{ AzȔbJBƯ651<0<=Av?,ʄ^hτs2:" 6H@h4=v'cԧŎ6<5p"jSZFLff]2#ϲP T%-w DmEћ6;[boг OZiqxڱ{4hŪca߾ldԧrtCS#ҕt*uҌőߣ6P2H],3H]IQH0DT2} gT"C$d7ؾ/~l'H+V /0t\kЬ\Lռ $KfO%k+^<2)\ɩMfUKbɭ#q±W|~𪹿Xx%G=4wmPwγ%x׀pﱥ[q'%T2LȰW {6$4~Va0jo{o]7K`ICdD]g=6KD3'ixHpj_e|bLe0jځ!l  .mjK12R9'4e.֕JR3u:, kK&YG@E~l{_ Y7CmFύFĜ LXUX56w(uX+ ~-> endobj 152 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F14 43 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 157 0 obj << /Length 2665 /Filter /FlateDecode >> stream xZYsF~ׯ#1scoL*e^JJeMHa~A*fR3x$X-Y¸!$)1F'wϩdLpNӷ,0ȄjM+6v1` XbiX⯋_h2ok'S¬M0^\^ALpr%!+\" dZئ+Y*GB,O H%q0K%cD y7$3=LY@%^@̏Aք((FRNR<ɩ 'OGӻ`?0~֎({-EZYXMO+p8ʢ62 f91\;l^.7A%VݡZyq 8bYR[?;`so_ n-e*6 @8JREcX)*і3l5V\:9ޢX:| 34O <ݽETd6h[H:Ǔ~t]?p41T9Xr!bȉgP;TN(I#~JegWlZ+NCjbN42_P M:ޡBa 4>Woc}xx O0[Jj.>Fck>heV4bG=I,77 "$mEhaoZWB16ـ36h![,nu ~n7*kq:4` y{0&NrAQ*T5܋p}-x nF@Hi*spDgWQnt=LUWE ־rOT{nv?HyUih 2b>dԅ^];7AUyhּlNi^6ce_lo- Xn+$ @Sg]}XhL[r=?y O[g%(R`5S*t4˻罯 *]EWJL#WgV k@!QYVpyM4 ˵=AS}lƻ9-Nz44O1'>]#52;1Ȕ=kb8n~|VB[u7 p]o.GwQ2v!=D@Ь і+~'0aIu[ lۯNJUqW>.;d_ U'Uk]:-7}k@֜\ ̻IlgɗqY7wIP񬝵[! ΘDz%!uު:[ oW !\nw<ӼYC 5-ކnfȾz'Xb ~ސ~ߋzhcRFrﶺ.nРa6Ꮓd.$$c (58}Bƾty5p 56wik{A2p@rӸn;6ٳ; h}9 beNߙbx7Z>e1%?nHnF n]N_*7avV"]n#h[6898\m\gwԜ'>ĎGwWÛ2h ?isIo3a]XfHޔET7q gU/`bYn~|AtWF Bp8"aߣfoS3VMo=ػ÷ϚNZST!4MRP~1Cgԝ-J8*MnwR.-7O,;,jB^Q*YEi$,rHt=~=4mղ_\~MFU_tDy }3yt7_O4^;~3)f%BCAVEM;o}q|9[Y#-endstream endobj 156 0 obj << /Type /Page /Contents 157 0 R /Resources 155 0 R /MediaBox [0 0 595.276 841.89] /Parent 148 0 R >> endobj 155 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F14 43 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 160 0 obj << /Length 2074 /Filter /FlateDecode >> stream xY]s}WQdW(oķʩɵ恀p@v6~Oό@fޭT@zzN %+Jn)^$yΙs6|L0JJz7aJ/CMYMGr=tzp~3 ?cEX׶Lhøׄ` Yvb7. V.~eK=tݢD&">q6¯l:+'qbZ?$"I zQ a4/jg< MZdjaUq)RVgO,y` '<$>>,aBMͤ+٠,R.Ae~)p{ 5mxLX3Bk' k'bF:VʶzY4]?X)P[f ˆPC4™qN)<[t*%*7LhC5L}Cw+;V %A|jZ_!G6%_&s\Wxr/xsZ1Mbe<?wQWRs:g) 5l 0s<}xhI_womZwzE׾7OGy)($I]Gˠ 2.8I+~<|j#j'!]QwOzh&csd=xj~w I8IlDT0G>9}-6:^BCA"g T'8%ݖV媪ǺN8HlSbۖtItͻE.Z%#5H] EWGWF `Dc*:ue-e!UZ)Do@^<2K fUa-RV͌f^z8^ޭ'bwZߏ}pR߇NnY n>d N孲^2go.^u8%N-zZTalϮޞߜ_u w1 Tiխ 0[-E}Bl~*˄!.9`:18(5tZqN%0T0M=u S޼5޲b9Ӹ@;%,O1_ۜ7w)NZQӡ~R l"Ӫ5ؘ&ĀFQ9{ m);FK)L:Tj}ǁbT#wyDzØ"uf x#cQW= ʄoy[d"ljbGeYN–[Zɖŏ&p\0q.ɲQ0[" NE2eݱ%SY 5i[,I$sEծ'-se=|Ct /.->oTt;FJВH Ily~7Ll?\ͅ'Ota,x֥1cKϊB_6t;sߺ@re3A|qDޏ0[",I[ha9ioLIN?C/ OGSɝN_41+=4ɶB6 ΂rXT¿Z8jtۼ$x:j=F2D;Ux݃W^Boh?^<>xh}5.Kme7%fY1˞P:xɹE7ʦ6 _endstream endobj 159 0 obj << /Type /Page /Contents 160 0 R /Resources 158 0 R /MediaBox [0 0 595.276 841.89] /Parent 148 0 R >> endobj 158 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F14 43 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 163 0 obj << /Length 2887 /Filter /FlateDecode >> stream xڭZ[s~v/ysSJ٪l Ta8==%0P2B| ``|339μP FbqT(狑uUߔj5:l|" 3e|>3 9! OTz~ru >(d. !!5@ڦm*@)4L" tzH i/kg% JA1!Dn m4p# -ni2Hk{Yx&,4 ߏ*z ݒ#tu ڨ1{HH>bK_4YwgWW][fE7Y5qz8r=ƇüZgNl(qBUx>>:WS]O1k͑d%[iMvl`^`Kcl,Nmu/$`h6n`jO| -ReUH8$SHu6k;q!^\!|Zʷ z#E?vg^{dT;0"\ܷpEBUGh灂p-pg]uAlLƎ9abOq$+ƱZN` kHھ1_ﯗSÊ)%OfY?nD*hEPi~ܹXYN= zG Jq,mxi 뫳]w `ʆu:_wy?hGZ~ZhyUN9F},›:\W{JISydnMHpAlpRx d& 6gT<& JP_zJ; Z. $ iry[^Qv e|ca,s*>g(aAq byюqMBXiz/K;חqE-Ԡc6%f&+vE_7|;V>w.߻ {'B/wmjX/6n 9ؠAB`Dr*!͝t|qظ7VړaOeNZEx{\u6W:'l4o^4E g]T,A~kx[\ݥc!iH&Ѭ>NCv x%5MjZ:@)h9$p&$u+l |z oj9Il {zU 4s/=*6}.>4 m9w#lPq ZGG>>fcIy ]Zrn!\,(.h:uq|}ދNnd>꜔).\!**eC\>6WȤ@ z\BHejMg ~vaANQ 4T8rUWIϙiNB#LV.)WlS O{z?WmYQ\a\W{%`/:mVW "i&}6H:jwفUַ ma_ ]8T /{20h`5KBqEF+ʚδP.e#yMl wm}q?SX 'BMD`ip9_NyLcq>O4Xv\19<5"1i_[B癁ȗ $&Z!i8g1=\2F\FoØ& ͿbH0w1o^F9֓fb ÚC(4;!F١4F Vendstream endobj 162 0 obj << /Type /Page /Contents 163 0 R /Resources 161 0 R /MediaBox [0 0 595.276 841.89] /Parent 148 0 R >> endobj 161 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F14 43 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 166 0 obj << /Length 2315 /Filter /FlateDecode >> stream xڽZ[6~У^%oM N:3YA匱{$"Kl+S#(x}<={eJn牐)^$yΙYr;D()yj,wR*}Kf^NۑH8DR$79+I>~lē7#Taohs&"iB{9DIfr{(B7"&mWLri29 zN<8kKg0 f c*i<2I[+ya\TaF9T*Dg)ϡLr0:S_zlez{h(qTI5i /Lg!x>GWoIUh%Vm4iQ/&Q=5Vc%zZ-íՌ#{hI۶:VAcTwv\["n?߽ݷIKJ0:?z/ս/򱬖R!H !x$3*}A!ww`U.0 Ƌ}a\'e6ήwo<^H+n_YiB HIYNPqoλ6!MNZa~EbˏlWkfeF" IMU.))UUKEn,VAĪtCk.K/Kg/JMd(Ʊږs4;=B_&Zn/ 9Ji('GWmQŷ{eQ+vuиg9 l'_&Kh;4wƸDƒڧյ]?¤UDž!Q/AFLl^?>z $ƳŜ^ ݏ"35"NbrkMyG{trw,9;AOSsP}Z[8۽ C2},Pg谎is1a 2JW9 ̘0qK3ԾXPnٔ\z0E/Dr IL߷Fܑ7鷻ŔV^)!#9eKXE|#Y:+<ܬ@ : wl,)H[z3K7b!i?`Gp@~(9$苠薰(GҘs(`P4jí=kP`ҨGP4T8]>*yNdȊK2:Jlʹ},gܪųh0\KSe?uGdut;1;) #Op"8f(NQLo6~[LXDbzUPW\Q-vY7`=aM'hP0~@ RU9ޱ$Qvw5fޢzZzh2L-hl:u I-ǽ$򟳯c+c` |(D  ,k ;Mp2ުbO``TƠ` 20T+tjWsZ (.Ebeʰ}ݘ|Brk!y1J徐9jCA}|4`ߣcÿ@z}cKs |M9hA/CUh6Vjlu<|?s5{74^Kl#u0?Cp2=ܵ=ca_׋٧`v'@OdjZ/kFnZ(´cQ [\{;#cu#fp]bTZ<5&Ad'h2-FcdtP~i>1jQAxMYW0^3g̎/C_(t귟j爫Ç_=ƄʹDzH7_*"lBX_;o GX:l> endobj 164 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 170 0 obj << /Length 1840 /Filter /FlateDecode >> stream xՙYoH +(dc߶im }pcYGÖ#ɱ5"@$K#9$?Rg6si]d["ˌZM?r\09_Y~2.q56似={3zu6b?9e*;_}JfoFgpN s.[$jqZ 2-9EHRǟR P0\ z3YX%TVE8D(JmLtcq*,ܛ{7Gm<4 y7YcE黥?'뻫YEu <+c0 7u[:֜hބi`8)chg>Z?0"?kŎ NuYQDQECIl [O~|z7K8U4\ZYєsa}..P$kwD: c "6>*ZTgzBvVojV[UB=tecDl$eCC) 2g\ egTPB fE͜aec3Է E2Tocr~//FE1xb>UWM47quVmd+{",T[03js8'0!՚(( 6 P6xGpҕ1"P0ڡ!l@`44"Op`)蔜V`!kiL( =Ƴ2n[0-CP'!,P ؃DYw۸4Ym˟m$ Xe5 QĵۉE IYW˨"˂WLJԞB*Ʉq+rJv2@CCK|Cɫ .ºlR[iK¹c-'Nrj_CVӐ8kP21cAPZ|@!i j{!XN;GaC`D_U4D: ٟ~{/6U²@H7PS!e*両f=_wlTf;qtH *8}79E[(ƣ.G;ޝ!J= V4^FѾF2P&;Mt`?cL))> i1~paRaw\ p#), Y}% 9 㺰P2UXEFi[XvU.c;+cﶭWIʉܯHRvU4+ᚯCen#d/)hbm]T{0)M[0!!ko;GL}hzqWMcǴؙ'1-ة`u!viAB5v(`T`ǡYu ^إ1^>qEmjᲷ 6H R }jZjᕿBFM56J}vθǗҦϝ}!wmph;i,8ծeBeHOxX', ,&>EX(;(}ē+qј2AԟrXlZGdo$C oA ѐՋ80dJP[_e-H]D9FPʠu'9)@p6ǀG ]Ofi#~ _bp*W \pVIϓW,Ǘ//#p}I@kD&/oWr]*v}̿ Bg7WBg%t.eZendstream endobj 169 0 obj << /Type /Page /Contents 170 0 R /Resources 168 0 R /MediaBox [0 0 595.276 841.89] /Parent 167 0 R >> endobj 168 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F19 6 0 R /F28 52 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 173 0 obj << /Length 2151 /Filter /FlateDecode >> stream xY[o~ׯ#riRAs>(mŕfv)S"eK{0Wpvfwf./Y%dWAYeKB]N~PFk0TaaCM˷7Iw^Te/l2ہ WPUV4 .?muPR"S!{okwFұ?06%L~77H#Q+*Z:Yk % VFzٖ ]fRr_g5N(c2YK*T~5{]Ś ld-=9B Jhh#TlƲ>-F[;_x'O/zD|M3ј#HĸEǣYKˮh{ Zxu'Bf߬I+Qz y隀`eVCR$]ޤ؝BY߲o<**'ːhqo [* Bb3h[|,xhzHmە1r8^B[c'ÿ %y࿥ 72_ Of~)8Gry+ODh)B?AS!(YD`Wp6(uxB9' ;Б.a+慌IsCDtë%MJN.o^4܆<[ 'Х'V ]tF$|t ]oѥ-c? ]F]~ubNG:&pk*FA94*IzC#:O5{=Rd1)8XԲз+r#L.P# EX*oX2wH_Ozz O@2ɪ.!S`SFyRL,6xH,:g\P*OX (WY{Oew7躱G-&w{Pe& P%x.ȼ{&]EKYZ/ET d]7\hб۬<ʊڣMNàC!tŶNrf۟VT0;q;A>WtSx8.dش.FjV>]Px6(bU 00 ې6-y̬NےhY#&</OhA[n vj{tuy 6!Ob }25qadb%ǔk-fJ:F:42¦^6\$3Bh#n(Ƈ7t8"-= -Ƿ yWKW׵Xԛn 'wͤ-Zƫ˔un rendstream endobj 172 0 obj << /Type /Page /Contents 173 0 R /Resources 171 0 R /MediaBox [0 0 595.276 841.89] /Parent 167 0 R >> endobj 171 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 176 0 obj << /Length 2088 /Filter /FlateDecode >> stream xZYs6~ׯ#ٖo=ҙd'MNg<0mk:Ju_] %[v<#RvǷ?8-˂qKu1XRV5w+V|5-Wmw\+((CPtgZGx=D8[=%̹b:\k5)#TƊpAVp@寕Sess~mh*8Trr5ka`b6@`s]$}ZqS~jl0v~9<8ex< MA޴Yj)My@;]Uxe~&hQeKj/ |oZI(\$RǯLyd!$Az.A`iCbJq FdjiUfPpG甤 M/%5D(^h4g^͗cGQc`RD1O :nUm/_}"D`eȅs[1 (W!K^P&b<5O>0 &$S%%Ty%{Y;JncGTn)y]C ӘxR[ՂՌn;U4L *4_<ݢ:q7#mG_a%[Է7.*1eU܄y7<k# I@%m&Z1FxLR+-AeF;UHe_(KfIQ䪛,ʷڇ㗿Yk]Dd%D H XJ\*ކNO&p_j7^-q97&/4VsJg' ogsȗwJ 3"Ɖ82` !rͮ ӦIdmˤ_H=ݼQYOH $H7Ay65مZcFwAC{"`2>qMഄtk!y0gP\:Ef?$\365S|k\=7a4= ^~7-4|7v/\s])uK;]NŖvuKSfY %ְH6AdSTӐD0O6|R`IteEpEdۺl|`z'ID؝ gH.ˁɤ)>x<^ڄˬ@AG`_0"#t|2Ȱ918r4 Z/öʒk4\7ƭDn5$ʈG)B=%.'H=QSQ7AhMܮ<Ux^eЪagD3Bd¹-cBY&7j.js92Vєo f&4D{GzWD Tz-oo;6uĊKyu.9DwE Tz >cap4 ;t !E>52a춽#_z, n|l:,[Cm| w6^ܱp9#]^$6<\NIۖnR|mmU48{Yqr`C-{6Mә#TӵEQ;nwX4~?u^?1뷻gJʡؓrVI xFr` h):97㩁Shl=D #Tޯydô\xqy9$N:scWs^ _ɧESoZg T D MRdhzlÏkV8@yw|`"wp_{ n `};ŋ1ڟ> endobj 174 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 179 0 obj << /Length 1764 /Filter /FlateDecode >> stream xYYo8~J݊}m{)m\[I زq )T$N=- ش8s|/m"'["KZ 'SLpN'K\XUqjb8` KM2 ??d2ɫ%Ɣ0@rQg TEƼhg@QP Y)1 ӯ;^O'E s|/[9 FjXŤ{4ZvX[KYQ)@,&˟Вa\[s"9%X_%,"#s*ͮ'Wix1)}h--QTDeT4 /^N0^/3EWmr&hyc`i\:="(v_8ciXum"E$ͪyAk$EJ~ăT7h }\/}H 9,~ `'QW;w,GX}j{#r:F[/ oMܵ /uO1JRKbVI(t^[k^[[f ;u8T3[nh1)qB}_pU ؂áUAM~}7)7mM+^WӋc-ʋ0K춝5i <0òwD)l2uAci+cԺh2z5->{dLStQE,@nMS<;e{ToӘ;;5ǯq p : 2?}e{JGl3/VdG@3 9`BNw̹ЂTAGv B'w  #+w_<>FEovb㔅V4HD5v{Ch u1 `44 x+Ǫ'wuPx\dV}?m5I6<^{qMݭ=5VFߍDžDk'G̶X91ƺ=5$8V睐\c p{z"Xu,m+vղXp49ܷvq/.0{1ێkmp]I]%BeNLgrj9oO۔ye45?o/$`,kl?g 1q'9qXgޞZZ5ԛp`@pk~nͫ@-$$isj~^\'O FӂiA_\׍n[9旅*H<8p6Pf> 9(GlQkw۫zw;,l EpDySFDg7Ir|a:rtQhw 9t,h=Lo~ԼQ*d ٯW2F*2X.'tM˥%Bո8_IvuQX @hB_aUH>Rt*M+:endstream endobj 178 0 obj << /Type /Page /Contents 179 0 R /Resources 177 0 R /MediaBox [0 0 595.276 841.89] /Parent 167 0 R >> endobj 177 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 182 0 obj << /Length 2324 /Filter /FlateDecode >> stream xڽZr۶}WPmNo3ɴNNLEbwt;ߵ-J }kϮ[U\ !Su͙s+JJ^r$_GR|IWl|;8 JUʠEjϸX8&"5b/&4Wla]j]'8G쬕8L[taZj"wסGJty*ϩj]9ϓ/Bs-yz= qBh#Lz/L!E*t-'936FuطDw.aSFޔts# }2 EE ᩜjLw$b/Ԭ3)8Mx[֛f=6z\I%G|zp(fSmy˷wLw;AEw0$u+oI.rjtEjS W $`ө\ Y5#irknxhoph[.TARo+ɍF.oN@_OF0:^^Dc4x@׀coƓ`l-f.,W^V7 ηG\1M]ºa2%ӿL!n;DN$g9;qCFrh!Cxy"lw? ̄&~г#Gl `JO6xA[ju?S?nrS)Z7C 3aia-Z2 `sC ^jj04}sZم;P> e+V1>4Ì.LL$u,V3hdr QPdlG5z :M|_ uOԋv B\j`^R @h3+€OpC^О?#:,tξ2EjBnm@,~!5K.ԫBh/̃]D{t h*<)Hr?@@1ԝj1[w\i}R 2fSğd߄Ky >hȊkz{_ۻBaB^W˛nf%Ene1ƛ;/hLn{ggGIB`m&Sqr5Ka4$LȦYЙ,HRIx!K*EsyCgnrkpcm +@k&z~ :į-zį ⟴{H(NJ5lGW*/+AŊ N( !"6kӌ3>a=/f"i *xhu:@ q'ϛI~#irJ8,P(&]ֳ4'`v׊9M,}z/T͜0)h&GOvF??TINu+()4N jIx@5v('ul9 })_9l6]`7 )Ln=_O/Z)y\Gح{tJd/էͤ> endobj 180 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 185 0 obj << /Length 2402 /Filter /FlateDecode >> stream xڽZr8}W̄y\jSM[Ah[2h'@)NSxݍͼqZ/["Cz~4cs~] !)IWeI^9l(CP/_|53JopM sn~;\_ d=)/QU銋pAV^͏945(YV$IJwTfk,@< !,8zT`r- 5r u0A}Һ()DbCC&ż ߎ"+,f֟TѩN wqؚVҎ}etݖ" pYbGQyXʆ+⦸.UȒk J(5@J.D P1U0!$TQ(Fu[ 21E:U#߁ `@g~8&Q4#-<I<F`'}zzpTzP;&3$~*QҨ kHR ?!AYr 1;P x&`ɜn9Ku@X1BAθWk=h^^{=%pB/6g³sGdqCxX_(ڋXgj5X5k#ayQj0AUpLI:Uo` Dq1h뎵C1FePnRxb:ˤ!N+?MIfG7}pmG?*x?z&3!~>`wTH;:bvJ:g GcCgДUCP"f`p}eBQȲB+}P % yHq݉oN|zs=k"UH_?O3)]|ожpඥ/.16*lƮ/ ´xB=\o \ p!?mA)=@aspj~;PjK\zndK=ۼ)KX101H{kcsșηiw}^7 7;S=;l6 V!EZ}CN+Z~+@V|@}#O}ymO1N>=B9Jm6MI|=l{>s )7l2}q P+7lC?fT!l^: @lۡA"UWCmհu5wgY$EmCZ&w[*hz_e^/b8ãHVM]xV}o7kPb@܆/V88z_UkuNʼ#F Hh*k:B|~9:u`qmendstream endobj 184 0 obj << /Type /Page /Contents 185 0 R /Resources 183 0 R /MediaBox [0 0 595.276 841.89] /Parent 186 0 R >> endobj 183 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 37 0 R /F17 34 0 R /F19 6 0 R /F28 52 0 R /F24 22 0 R /F20 13 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 189 0 obj << /Length 1524 /Filter /FlateDecode >> stream xXn8}WQV >hXۅcee9m~gHɖ,q6-Q Gy9]#Nd|0n.1ku2}Oe39M_X1˅umZz2r~fYB!w }oQf1o?͈Զ7\Znt9,^\9t62 #u? (\5 ":[${Psa*4$ٲ_jub$9Lá )0}P'%q0܄Po?!D(O +6$kT/BLZu "yc\(?RkE&50W]LWKY(h -$*/I D;SF8u M=MAD qIC70Z" b]*wOxuXB=U! LjBqN *PxGN1RDj su< U9vF9p4Ly;;,bEwT:YmôXIhMC;!8o(o@e:H;Nr t~Yb,{p͉h 'w:Mݣ` p'ƃaؘz,S2^$ ;g3i.Bx㵜bfJUWa|'azQ W; ep;hM2#Lvj)G?ukn͔uǬټβne͹S< QZ I`4n'1n-ƭ/7{\`-Ý5yʩX=]FxJy]݉p̨ m iR`N0ᶊؙU.'eHJAW&!v ege63Zk}aSՏʴL©)Z&V2 9>LA/V=uλ 嚹4xXxwx7g\E9" CgEh}Re\ -0k`= oU`+wrt]`!;5um6&{؇B }]] "(ň@0i,jS8Et)P )AW_wBvD2Io=5a4 hO|'Ŏ 88kxW8VޫN)ɼig&(&jw;\rRmœe]K.xi~3,Qu }qq1øtz{J/_wi9d`] Tʀ~ڴy,JT&9#NJendstream endobj 188 0 obj << /Type /Page /Contents 189 0 R /Resources 187 0 R /MediaBox [0 0 595.276 841.89] /Parent 186 0 R >> endobj 187 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 192 0 obj << /Length 2166 /Filter /FlateDecode >> stream xZKWhޏܬ]J*˻*LHbrտOARp )uƈs"kly+"A-Lf2 v`$̌"=[DRu0P0tdTF1MACK[]].cR0& <3G N3*|vsb(pzGASrGI.Dlpnk͈[cWhA2NqqKxQEoٲ<__7<?.QAQTQe(&Ӏ˟Au)g m6_"~;#Jd74}(תƕ]W啊(ǰ? HbjE(Ş#):>Ѡ~ vf^P6,lՅmx^?U\WY$}+q4h~™az⮃'Kf*_{KݙBJ%1@{ H{\rVj2[в.VM>yb5iP\?T}B0 gm `]t݋cYkv,7YB$fJKę:*;zЗhlI@ ig\ZcXP~ Rh ~@jOOvQ ]XK{x P8s%bX.;$ҋC E(l>/1Ǥ$04;ɁjG; H5W{3eb{P憹g|0 n]?C=a'Tw6cŐ#ufΖ&.߷h؇&FTl:G_ΕΕLU6vi3":Ď$c,`金fyS%u(J iEW&PCy^ue qB|Id{{c)%jf{ bDK<,9+*;\ht`9?IAXB),M,Khy&(YXta^TWfYo S1&W fZy] #)|YwP8qjJ<*;J4[CkN3`ojξ=݁T!͞N: _+5юyDY b.^T]`Dz:r2tQo وآќ`','@34GG)L/D.o*GDZǝpNƱ߬qn ߬6'sm:q g6[McAg|dw| XqXn֡හQ, B&yL*$ ,-`:ϚVc^RH~)ѰIn?cL<Lv[m](خ­8xlbGO M6JAAd$C~(80|3z;CQOU=Q3'y&A±sO_Ʌ_"na!&Qf T~FM^o#3a2kD__Ě F? ylA8_j0؅y aIW;JΗ%o R:endstream endobj 191 0 obj << /Type /Page /Contents 192 0 R /Resources 190 0 R /MediaBox [0 0 595.276 841.89] /Parent 186 0 R >> endobj 190 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 195 0 obj << /Length 2245 /Filter /FlateDecode >> stream xYm6_r[1|oi 4[/{E4vYre IYZ˻{Mz`EQpf8p޿\4E\ڑprQf,SPk iC!Y.ODr]+2*ʅ )8 ͆3蠐'RA wKL oW2ֿIx(&235L3bp|r&EVS<;'?~3xPV"9Viqm{•O}zwQBfLOx)bB JHgA2ZZ?-k9fϡ.~yM&|յٳ iL^ܲO1R`@f]<}S xWfi0"HPs9`jH.xcgo0n3wS)qUW_e{ 66WQkU x_Qol}СY4EANUdž7.|>xeS_D|%FmF 1!e AGVC ) mOq ÙUIǁ97 ez i& #LxVF7GS57RrΑ԰bG}JU2`*,WRTL;`~Czr 0G>zQH /kxeE||Կ=JGRq*.'>lRZZW\Tz.*<=Cs8x!"58gBGmךQ[j N(p:%u]8B̏ss@S\ⷀ츅:2T*lva31CnNqSJf3?e fe}Uib8BβQ`F,EQ hܯL&uͨ ) {gMh(0]> endobj 193 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 198 0 obj << /Length 2341 /Filter /FlateDecode >> stream xZ[s6~ׯ#]"č L3qM;IHYt)v xDnvD 9.g~#/|˫H\GΥ"ϳr!Dm_M |5{y9Q dY'b=uc-gij ƩGQ:Ww4(JX> $ [ϐ[}* 8e J jƢuKHR2C@x,{+9b2D[ထShk xVO^X/{[K2eQV`t[WToՖK "Osub}$:'7h ™.]2toVv>Yсͺ; jL|L :NxӈiH{/d>[9 e ; ݔ5SmTZYQqk:2% țA :eWgܖ\9؎Ьq 0~(hO&Lp{X~X*Be! \zi _xfA;v\dQJt6 x&x,R Q[J8;,;U΄\H ygOȜ>8W9|=`cP}< V;ʨPR(={lC9gf\M)FRp ۚ'\ލ6a &T5-))ErW䙶 &T|"h~}xPF ~˶$/&@eW@h#BZGhB{2W)B3fzAI\*<ԢIuV2"68޼|Y=LJ3>L\%#qA&Et 4t1ϡ`Ž#'aG8ƎhV hR'RbG`my?FŀQ2`< L0F`ѤfR^Ft'^`5)dՊyt6H"Sow}cGLJETyޅ PLm-sŴcY;l#o ?j*v<94 9GrX}X< <x2{x!>zDF mA#qO*ЈOaDi2~p{Zh!ٗ AP{au7V#F=_pZ'?W=> endobj 196 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 201 0 obj << /Length 2442 /Filter /FlateDecode >> stream xYo8~_aAX7շ4MMkE>ha[^Y޶pHY  pq8qz܍ V9pLڜ9g7f\B'.SJ3)Urrs"[mY!x1)ߌQd_3^H ѻѿ;(zZۘ+V(5Bho -yz*;q:ql0nNݤ!N-.Di&Jr- W ͼN_@I{GBdK7%;kkђj4< .7iRɇW4,aP{A4¾[~f*I$jL xh l)ؔ˩׿F<slnЄk +'?'j~j,:ݔ֏HR27#-ߒLqp{KchYȃ]I+İj6|-o.Qhႝ*mC(dq؉aSvĝmBP" (5iJi"Ҝʠs*!6`VbQHhh_NE@lrMu `YRfa>i}N@YyvF9`h _!K nv n„ -FM \Or܎lPn.Xe ̌6[%e>4)ˤeU_A%rͤP\E}z6,Tw3d9&zg c߻S {6 ,ԣu=lrcڇf&:k]𬾂k-*G淜2Č ǔ0MNq;$15ӠۿuqJ^QPP*^06$e=W40 iss;-=i1Y6-̧wZ>\4o #]SW יǬ;WAb*V/w,20W"D0YHlV鋒l Dw B% CAU~:F@G^NcĞn}Gx"^k''=E(ґ{99ڪ \SǦ /-QDPKNI߾-9(p5V!5\ޛ:MY_ـ<; p&OB4zʆJ-d7=T'܄1zz{@n$0PiO'7@X%cLtiPr)r՝^{=⚳>s 0*C0RF :X489P fz3 4ڷԩa}3j= P* {ɫۀ:Ƕa~SvuzdYne=.$Z`p)-m! wމxR'tR{Ud|$IF`Sh~7 2Fޟ_^\$ G10z@<xyv;!S.y]v@@f]b?,+V$eOfkC1D޻*p(;pHB^O2q {e&GX}gcvӚ/'MuZ5~xϲC)\_fBۦ0H(7cO[Ht%rWGW٩o]nɻg҅Tv E.y]0Տ|'=V=#nDUxG;~<=6D|E7LK)Tq?EW4 "xs3]?ܡ˴gOufV7ʹ՘ے-ˡw`H&\C'Dh/+@$Z/aAendstream endobj 200 0 obj << /Type /Page /Contents 201 0 R /Resources 199 0 R /MediaBox [0 0 595.276 841.89] /Parent 186 0 R >> endobj 199 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F27 37 0 R /F14 43 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 204 0 obj << /Length 2005 /Filter /FlateDecode >> stream xYKs8WHfsrSv쵝䠒h[ۍEj$FwnGOmRB.aAJKIY쏋Y.L`|}8ߎXBK eH!T2]9&M>(MØVb$fNMr2v((t!AbJ7Jn"BZLbTM-Kl/mV: ۯІ]j)/,D0?r6D3 #RF0lquyYT%WỌ|-krU_qKik/!*ȅ$}O,&>-elZ',9dCJ UIټC7y1?%1 AK7*8BQ WcCrmw6h)7"{DœVPnWfUʦEA[>~'er]L^~+ZwLղ7Eu2O.a݅7iؠrU.I[K/V+p5W [! W݁B\̀}3`b; A¾S(5UE,Ã674hU@tq23.Zpoڵ>5+3( S!l6ktoMڅWh£ 5buc=qM'4mйm<2m?Gxt~fP;0>}>?B M;y!VKDy[Yi+EŻ`i9A9vA+X"D@п(+ :SX H`Pufa20E8^kc1`,Rhe,I" 29!DW tW.̱B\?<rBCNg013}'0 |Ў t+\ۿP-ʠI`[ԪX[PߦCJE'ڨ\ H[SYEwsHr ;.<5CSwdojTI&?"!#@4Z`=.A%L{Ȇ%FZv܈w}438|U]Ĺ0 C,15^wrg1-dtf](P% bxK-cײ + z⍣q77CCYnd;^l4al|qz8>f?VOiLpIw9tVF yn垰^kb~?:?;At &2@b|;6EP#'a-)t[Pu+f!X ?bm,.feJCJf#fG W!PaӳA! d`_A#i+x100"l/XiO'y8:!Trz컍HaQ7?9l1*_W~k:YU-(mI=߈r쥠 .WPl:$@4}q嚪~"oQ{-magױ7o- d.~BWM?H\5Ws ۘ~Q$$CY1+r !TA`˩&$Od%> gb)G9 k*u> endobj 202 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F14 43 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 208 0 obj << /Length 1278 /Filter /FlateDecode >> stream xڵWnH}+hk֝_m&i&;aW#eIf $ߪn7@&nUէ38HqKu1X&UYΤt*kҋ,B`%N=P(CPO&M{g'XSœKzz=]X۠I.8QƶM8k=m+9@ WD(>$\U jIїN1aI~XB~ɺq`,GJXXyi6h>ra)坤!*W2~OQ" L T$j:=r)DzrzYA>&; s[1 j{~1~"uPubֹIέ#`挃ʀf/(EuS,y0wOr{ mRlR"7/!JD+8l:g`ҧt;)VaVU]eP @ZL;v*6rP6 $Wxp^wBt0Ȇ.~5WѵPh^^Kw( t-"TWu~nM| 3*:G\[̴b:N>Qd Buם,B7cǝ  $6c\Tc_̎-"E&j8$!rmbo> endobj 206 0 obj << /Font << /F8 19 0 R /F17 34 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 37 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 209 0 obj << /Type /Encoding /Differences [ 0 /Gamma/Delta/Theta/Lambda/Xi/Pi/Sigma/Upsilon/Phi/Psi/Omega/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/acute/caron/breve/macron/ring/cedilla/germandbls/ae/oe/oslash/AE/OE/Oslash/suppress/exclam/quotedblright/numbersign/sterling/percent/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon/semicolon/exclamdown/equal/questiondown/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/quotedblleft/bracketright/circumflex/dotaccent/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/endash/emdash/hungarumlaut/tilde/dieresis/suppress 129/.notdef 160/space/Gamma/Delta/Theta/Lambda/Xi/Pi/Sigma/Upsilon/Phi/Psi 171/.notdef 173/Omega/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/acute/caron/breve/macron/ring/cedilla/germandbls/ae/oe/oslash/AE/OE/Oslash/suppress/dieresis 197/.notdef] >> endobj 51 0 obj << /Length1 1086 /Length2 5355 /Length3 532 /Length 6067 /Filter /FlateDecode >> stream xe\T}iC N``SZ@ZBRNii$$p~=~yΫkY+~Y׀OxQF|@~@AP ( + 4W!R$ b JRbRC8*;BPPkBAo5A0 A{a0_}3 0 x rA roM8oMrn-p !F΂:a.06/wAPU .h CPAeN 83p[W uuhk;  ;v!a_wR =o7 u o oYcmBb  xP8:#з-۝ P(@@пH $I h>tۧ&b~PP xk΄Rx+o@ZDۅ;HFdjaM웩,'wyb̭Umԝ,x/3uohM౟ äEW~(JΗ;hr'v%9/ggf;_ 5AZ[,iui~e/sf³) tJ=0lp T0y\ :MظlJ}}V3u|Fۻ퓏c-(]Uc% Vkg$h2KsܱtA肾BYaIvq'cݖSǎ);(8! ^g^0'Z]E#Jj@NTVUcz@g`?c=)#~MMyUu=/D5I bqt#{'.<7//ރj)qw,֟I]$%>01[ݝA1[9zKg}#RY2^e(pbROhc;:llCta`Bc~6]OI+ߦS@nz[_ #}v?oo9Z+Q>h@tJ>ѧHM5skb>7jj}IL^xj^ihc;EYia``=,/4R q:/ڱ b+Fm6ċ$*jWLlcL(Ȅ"f@믷&NXWo*ĕ({J1 C1ZX4/)^\n3ӄNO 5gm۳۶Z.Q1|]j:%>}h3*$ZU=+<6tء-GƬb cyXH'JA'Je,sK ƭ)%R#ꨄIuv3m`b_Y981 khg9 j ˖ "p nB=|ttk'Ī+T;ɧOq.w '9ɧԞ%<jzTzLҳ)껗lA&Rx>z?,L4A)l,`SϞ4 JiP83@~Ĕ+O 8M^ui&] He"/ƿkII4"3ObH:5-H[JU:3̄9#ؐ VN2p)Ϧ}3VÝxO а#Xvh.Һ3㑱>_: Դ[߮..ϡAYvˁ$k51Iѝ'ufGoS&f ӡd@fЄ"_>J}+˨D> !E"|V"͊hl.FIxVfyRu>gCϓ xT|l]$J1bccդPshJmc*Θ%<&<[aY/N-!r@c4xQozI8|)1eGweЖ0H&RsN#h[V2. ]5s\QV~|kzHXH ɓQ͟Rv4nwV#t*cO?'m4njy{সTERH\U|qcNqj9x23_#֋E|z^z(膘A&s<&4Q~ AdvCj5܆OR*u]-tŧt;+EO9 }Rí Hr49'.8iE>GuwWvf,&Ŷa̜rWFñC+QVۙgcКHo+doOu>`tc} -;:\Z{搫Ѹ*\}1+toUM`ϜBAXZ9+H8Yy>|GSxAh$',brLX$ys?P>e>1'?tlmRؼT;656~7WL/ ۿ|E?E$I=9NYCe ٻڀ6OU[tClYޏ [IV6Jvͤޏw`IfAXM.Idb4ڔv`_N\.gnxEx~WSRJh409 E"UяVJO-xROkT; \5哩nҝyY8TSm/%K:cs᭦%˚2fZ dz X>'1skb!C=BPv!33-OlWh=Syv+amHa&Rc--6Fif:H`J#!Bhn=B\fW}F-$PpMǝ 8.# 5 MݏI&z4W/l6GNSWϰD: y9 {m,HQ˲-ǾHذUcEr4<;9k\a0{Ҡ}R 5F{ ڷ﫛%QۉޔDq20M,Z^tz2a,;9EN:@UrhC)qUU=s?c* q#[|cejTqIL}S+Wqzu^H*aT8y u " U|'4cz)^ζ镅iCo~-q4^7ejp7fjWE_ Bݟhgnq`Uy[&$൜bHJݲ&N y/Y^)>3ɋ)8,W  %rV*0NdAE3%~3cG!+ϮW&͊\!z1w<>8RZ_oIӖMwMJ߳d0.;tМ&Q%L*#Z[ub}A5S@sF((|Iq8̚N ̕AK"v]=+K5H5G)S+blgiVYJ+v~bVfu %lbhtxW]+'`Uw x~̟Hyl1~.Rʙx4[FSOd靊PY@WX9XFf {#e]W'CN!iWiC^UVJh {DGi2tuETFT\LzLb5Q*\q4<-Ja'{ܨ a^}9J^ ڎ#F$5^seBdmĮ G|!Êy6WqOjxc?*Uft)/nO`(P2^}e G7>y~gV7 ]/ M0#8'@VNOӠ,rc`:߷ZTQ|qdh@^M;k#_ge)eJft]\8zM=H; Y7\&q8ކnmt;Ersbt%hJ #^Fz^!zaI*2F{i$.VS#/"eN;x!+u5Х3A?oڟZ3%nyL<3ʕ/\IV}z wWl@%Q$4aB_a/^+Rb%q>|ZFށ&S^ 4.@ur<ʶO5PC/5K&qFlueBPZV5׾Usw7D:΋N<"^##{{HkWAj+a 3|%G|Wź$i/s9"WVIJh4td{yc["ik1+NׄyF;[rʇ ?XX1[>LLEi|l!vNJDrS >Bٹi¯sA/@)_tF+,d; <­,)vnHd+.+ݰHX{̖\$cV)h1i!&]Tg}oɂtŎ#Tb,6,"ԯퟩ[t ! < C,~S+_z5]ۜũ0Bw! Z?&O=u%aM xhGv` Bך,E0yRƒzty;i~gƁo!~R"+QٵDn\UL*قW}B~$ĥ<݁w=QY_T8Ǜ&z돭䩛ʁ?'1sVIȚE0ggN vQ&k ^l]DF-ItΧ/'N1L43 o6'iaqQU˅;Ϟ sF?crjy6;{(V504M=J'Ka.A+:_Xd8Ec*GDA L`PE+CyP;0iBa~wuEdoj67&2Q[f<=)զj{+Z?gk4aӠa Y,\l۫9ICߛU,x}{v x` źLp=|W5 B  Nendstream endobj 52 0 obj << /Type /Font /Subtype /Type1 /Encoding 209 0 R /FirstChar 65 /LastChar 117 /Widths 210 0 R /BaseFont /OGKWHE+CMTI12 /FontDescriptor 50 0 R >> endobj 50 0 obj << /Ascent 694 /CapHeight 683 /Descent -194 /FontName /OGKWHE+CMTI12 /ItalicAngle -14 /StemV 63 /XHeight 431 /FontBBox [-36 -251 1103 750] /Flags 4 /CharSet (/A/C/D/E/L/M/N/S/T/a/c/d/e/i/l/m/n/o/p/r/s/t/u) /FontFile 51 0 R >> endobj 210 0 obj [727 0 700 738 663 0 0 0 0 0 0 613 877 727 0 0 0 0 550 700 0 0 0 0 0 0 0 0 0 0 0 0 500 0 450 500 450 0 0 0 300 0 0 250 800 550 500 500 0 413 400 325 525 ] endobj 211 0 obj << /Type /Encoding /Differences [ 0 /minus/periodcentered/multiply/asteriskmath/divide/diamondmath/plusminus/minusplus/circleplus/circleminus/circlemultiply/circledivide/circledot/circlecopyrt/openbullet/bullet/equivasymptotic/equivalence/reflexsubset/reflexsuperset/lessequal/greaterequal/precedesequal/followsequal/similar/approxequal/propersubset/propersuperset/lessmuch/greatermuch/precedes/follows/arrowleft/arrowright/arrowup/arrowdown/arrowboth/arrownortheast/arrowsoutheast/similarequal/arrowdblleft/arrowdblright/arrowdblup/arrowdbldown/arrowdblboth/arrownorthwest/arrowsouthwest/proportional/prime/infinity/element/owner/triangle/triangleinv/negationslash/mapsto/universal/existential/logicalnot/emptyset/Rfractur/Ifractur/latticetop/perpendicular/aleph/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/union/intersection/unionmulti/logicaland/logicalor/turnstileleft/turnstileright/floorleft/floorright/ceilingleft/ceilingright/braceleft/braceright/angbracketleft/angbracketright/bar/bardbl/arrowbothv/arrowdblbothv/backslash/wreathproduct/radical/coproduct/nabla/integral/unionsq/intersectionsq/subsetsqequal/supersetsqequal/section/dagger/daggerdbl/paragraph/club/diamond/heart/spade/arrowleft 129/.notdef 161/minus/periodcentered/multiply/asteriskmath/divide/diamondmath/plusminus/minusplus/circleplus/circleminus 171/.notdef 173/circlemultiply/circledivide/circledot/circlecopyrt/openbullet/bullet/equivasymptotic/equivalence/reflexsubset/reflexsuperset/lessequal/greaterequal/precedesequal/followsequal/similar/approxequal/propersubset/propersuperset/lessmuch/greatermuch/precedes/follows/arrowleft/spade 197/.notdef] >> endobj 42 0 obj << /Length1 772 /Length2 576 /Length3 532 /Length 1127 /Filter /FlateDecode >> stream xSU uLOJu+53Rp 44P03RUu.JM,sI,IR04Tp,MW04U002225RUp/,L(Qp)2WpM-LNSM,HZRQZZTeh\ǥrg^Z9D8&UZT tБ @'T*qJB7ܭ4'/1d<80s3s**s JKR|SRЕB盚Y.Y옗khg`l ,vˬHM ,IPHK)N楠;|`xyjC,WRY`P "P*ʬP6300*B+2׼̼t#S3ĢJ.` L 2RR+R+./jQMBZ~(ZI? % q.L89WTY*Z 644S077EUYX`j```aYriQQj^ 8 OljjEj2k-Yӷs]|a>k_d?nvfJm@%>wX,iG /vRfǝ%ش9QDod;U? ^VNvK{~/t-798 mi"6=!y:I_K-,1{).o *[mF%s_-j(ls~gغ|K~#ﵾӷ&g]p_!GrnM`v^Dl>Z`.xYh.#8w6O~5{ބU7807k4鹇W5ùf՟VRŗm_AXOjW;[(ϴu,n q(ﻰƏA+̻3z^"_ٓO:~UIH$PkR-y'y='sBˉcWdtD?:`w[K_ȀB5j0 9'5$?7( xendstream endobj 43 0 obj << /Type /Font /Subtype /Type1 /Encoding 211 0 R /FirstChar 15 /LastChar 15 /Widths 212 0 R /BaseFont /MSDKNI+CMSY10 /FontDescriptor 41 0 R >> endobj 41 0 obj << /Ascent 750 /CapHeight 683 /Descent -194 /FontName /MSDKNI+CMSY10 /ItalicAngle -14 /StemV 85 /XHeight 431 /FontBBox [-29 -960 1116 775] /Flags 4 /CharSet (/bullet) /FontFile 42 0 R >> endobj 212 0 obj [500 ] endobj 213 0 obj << /Type /Encoding /Differences [ 0 /Gamma/Delta/Theta/Lambda/Xi/Pi/Sigma/Upsilon/Phi/Psi/Omega/arrowup/arrowdown/quotesingle/exclamdown/questiondown/dotlessi/dotlessj/grave/acute/caron/breve/macron/ring/cedilla/germandbls/ae/oe/oslash/AE/OE/Oslash/visiblespace/exclam/quotedbl/numbersign/dollar/percent/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/asciicircum/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/braceleft/bar/braceright/asciitilde/dieresis/visiblespace 129/.notdef 160/space/Gamma/Delta/Theta/Lambda/Xi/Pi/Sigma/Upsilon/Phi/Psi 171/.notdef 173/Omega/arrowup/arrowdown/quotesingle/exclamdown/questiondown/dotlessi/dotlessj/grave/acute/caron/breve/macron/ring/cedilla/germandbls/ae/oe/oslash/AE/OE/Oslash/visiblespace/dieresis 197/.notdef] >> endobj 36 0 obj << /Length1 1596 /Length2 9671 /Length3 532 /Length 10598 /Filter /FlateDecode >> stream xUXڶqw w ,{pw =Cszk.$UTa63J:30DTUY,"@Cg ;[1Cg / l`0󲳂~Q;{G 3sg(Ϳ6@G cC[9Tbglt`[[5 t:MXX&#-ӿ{CJ[<ݻ;|"K=DG)hݘJ%n{;g"#ۏ,3cJ|2z4-v#VeTo@Qn]{='8$Ѹ}~grqb2Tv~@1ݴr߂M=85ɕI)O m2_{;*SbM)FS Ǽ?#Ns<:BW3"a<{8Y6[e'O,^ymgDI\+j CBVGv1sC3'ܟCx$EvT2p)c2EI2z! z!Wُ9o!|GܔCPrl*t%0NSKC|jeL¥Ԏ\serHT_ o/uK"h%RHgepܦDpEY{VIOՑms5_SH(;p)o6pauS,ȬbZ1HABЍ5 䜒g2s6f[[5~\ k183!ǁ!Z3`2ؒ%/GI 6愊TpR!v-.X~I%oaVUJgGCQOj ot8DMD^dxFIcc/knCBq)FG<ʫkz ż<{Œ$-kmC B!Ιoa|(i"4raj=8VF+~}f"ڽ5\ݣݚ}\j Cc8Vf+vHjղ0 h99}BƊc wE]I]5iv(=6'2fiVRvk%Z3a$w j\=mn#HwG i-2/7ti'#&ubta[5zޛD%z;UVj}{kXbdUyIFrac椶c6[U=!fVPrG"tOd“) I%~> Lύ ZQG4P3!%3/yT"dN R Hҙ!j_յnʃr^m\4&(%7 k!h_vMfBi0 6 MqPqC =E^3RINPi#G##<&&}RQit%,l 'Mi?t6#GMh;8WaKf)y&][SDWC(BH܈W8.xFXWHn cghnigvMhC_0.X5#?o^vjEÙ^Gyg#1)=rdLJ2z]ОaV,5~OdH^R"-q7Nfɕw?ٛOیKj@ԼcLz{"c.^@mH?mLb xŃ[ٟ%q-Zi][^X6wjW3PA'R :b0 a?T }65Kn]Zm2d1ȧ ȜO VfL1۲ʩ5:c~>őHj鷫&acpEse@h<%[2#%Q!; +F]z;6ɑCQ[;89u48ck-oJdy6>^}eyDt{'-^f/k ':#M'7צ?sLEZ#UKcL3{&# ҷϬk |`BFRswYh;[NtKI38ͣQvjs(dg_0m詪[!C`i&`菎~iDCBp0Rf~xb;R4ۏ,&l;7BH x݋9Y4|Rk;#۵^z 8reL9agcѺ?O:ڤ@v`SW뻷rWbU9{zk>dot2L"[ RN7@lo%u0y R!+-1mR8v z®Y-|=X&#ʆXWRݎ,yf!Sܟ:ϽL ݜi#)!P)Jch4EPY?hԦg\raE#1?6LX؛$Z숃kIEKDF_\FF|Aracu@5&Pgc F:bir;Σ=o#W Qi>h]N YN*Ma&-'gҬ];'Tݯjg:t{YVC鬘1z"*DCzTGV1=mGrj}?97}\?oɎ,Wk+htjK*AbU2H \ߊJAX_B%F8R'Gx4c7} (?@yX'#7][F/LiMJz6zbyo]EiMn7z=m ] jnOVØ?phLV&oltw4 kGl|}'?6ݬy/?ռ}(#NY'*C_)>w8 w 氢듒dlE["6i6/FǞsE,hc֓mW2M="C"-Ҳ)t<1Q23Ɲ4w8u)"zD/<1IG&{ұ̔ g4?>sYL*̉ p$6Lr+8B"ɿ8e L7>q[xtJP>2$*,?3Cs]xů~{lD , 1wq#ns%)~n`g6–QJZ45i$Cum^] kN^*33GM՝@P?ƳqlT4ůVsl.T1d&VIW_&^l E͟]:\n0K3 bd֔cztxy3 =ZU";l3:Cb,PV0R\ˆnWTHfh-]Ȏ9t<PExoJ.C7;*8b_KnU!y ` ?OeS-oTN'ԮP4џ2#*)UVSF7KQTl$!H<~7mi#q*}PM4xqnQjJH6M)~*m7njѦ-*>sJKvI)9F&tD);5{_A5;ڄUkki( Դy~&jjG< t pskewLawY4ֵYIyM=쀑M.</E\A2+ ٤j+ZB^%;rY$ 탓VgԆN0YƏ$9!9xԂ(b=vKŘq mi/5~ sIÙo8!~-v#Y`No W!~{ɓ*XpqTW\Wz"5֌sFK ڝ } w͡FevXSyVYzD]$9+!ݼġCYM)@Zkq.7{ǎ߫8fE'nΫQYQQy֟_-tZ(9o(ŤKgh6q- -Ww,]Dw3\o.l{'!Bl#)F륦"%w$JeX6RH$1H6ʔDl9MC7Etb*k1o*!<ƴ'{|mq|+(ƍ!o~4r&VyNd[2+`x?ӚE%n=LҌ*K H|PGfrN5 VuPhNzYod@v*͐1zFRG{_kUIR܀T[IF6iχ ~tF(eDh Uo+Cgdqŏ(9d{QFQY\,`U +'fD&COՄ~F% *و "36eZI]gSVgJ$I\"c9v˵J H$Ks#qތ9H_MIKq U<$ S[c49/b»NX%$q9L%l\ ]pg&";Qjd6p%E LCt2f<x+8s> R{VXw/F44&>LyƖLuLǵ%h{Ąǟgv+^[;$Q‹>ڎVӬp*xcN6n" M_jbوǸ}rx΋.sv, #P6I g6o|@kO/)bp!񊞷FcCFόg'ބ\K*lNbAUlPiNɐ&LWCV׊I{{N3Β2~]@8vng!UnfI+I5cpߝ#ӣ['>cdjaf93KSLgJs T?xmEeN5"oݪSWRzs*E#ҧH Ŵw3C-&bcyM3u}G7656ŷz3泏f1>ormubPgr^tNIU6TokCߗ -D$UBG9_2/̇8pzt[$VLf\ 0sZɲPGh/Rf2irB^M|H=Ub:4@ia׫"m4qFTˉF`ԪxJ&wҾ1vxaADfl%e`.o y nV]~7<vlhe5ɖp<+I<b-M{*hֵw?xZ >L bxMlhӠ{_#/g*CEV SO܊PrSGAId:]V`#/'䨄jmD%k % 0c2\ njQ2h1Ja},7O}>](н S|2=}6сC.?CA1{թ54L'/ - ^φ$ VJ`gA  (8 _Ja1 >rsL7Q鼫T 8Ǵq}V$'13r֗t2xRԃ9nq2rB e-f+[Y>S*v& x6tFwlO ª{G}"7\]϶$NR*a9:"$~ NSmsBI+Zbrv-󎡛JH^&X~Ifp4*_OYKYή }x>(/Hf U6eiӼ$cjkw'GyU(8  xCfC":aﵾi/JuAΨ[{x@%Xz%WaKYW&$w~@tJO[B8F`܄=]'}=x8DٛL(2 bL(a8Zf sXj~(ķT}wqzPv Yt9G ? I z*On:_4kZ14Kv~&'ǴG ѵEj~6P:6\h(z䅕")z||)Ãe.],Kq"cc71SQm؇mIzNhh86jLHUdvʸdѡB&jv &VFE-Qу2#t7}L핷Z}\T㻻}WLvlL|N(L~;~ES2Env;lg]ri4a3t ,!l#Beu꿮B-?v6V `l ^endstream endobj 37 0 obj << /Type /Font /Subtype /Type1 /Encoding 213 0 R /FirstChar 34 /LastChar 120 /Widths 214 0 R /BaseFont /DJRNBS+CMTT10 /FontDescriptor 35 0 R >> endobj 35 0 obj << /Ascent 611 /CapHeight 611 /Descent -222 /FontName /DJRNBS+CMTT10 /ItalicAngle 0 /StemV 69 /XHeight 431 /FontBBox [-4 -235 731 800] /Flags 4 /CharSet (/quotedbl/asterisk/hyphen/period/slash/two/three/colon/A/B/C/D/E/F/G/H/I/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/bracketleft/bracketright/a/b/c/d/e/f/g/h/i/l/m/n/o/p/q/r/s/t/u/v/w/x) /FontFile 36 0 R >> endobj 214 0 obj [525 0 0 0 0 0 0 0 525 0 0 525 525 525 0 0 525 525 0 0 0 0 0 0 525 0 0 0 0 0 0 525 525 525 525 525 525 525 525 525 0 0 525 525 525 525 525 525 525 525 525 525 525 525 525 525 0 525 0 525 0 0 0 525 525 525 525 525 525 525 525 525 0 0 525 525 525 525 525 525 525 525 525 525 525 525 525 ] endobj 215 0 obj << /Type /Encoding /Differences [ 0 /Gamma/Delta/Theta/Lambda/Xi/Pi/Sigma/Upsilon/Phi/Psi/Omega/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/acute/caron/breve/macron/ring/cedilla/germandbls/ae/oe/oslash/AE/OE/Oslash/suppress/exclam/quotedblright/numbersign/dollar/percent/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon/semicolon/exclamdown/equal/questiondown/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/quotedblleft/bracketright/circumflex/dotaccent/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/endash/emdash/hungarumlaut/tilde/dieresis/suppress 129/.notdef 160/space/Gamma/Delta/Theta/Lambda/Xi/Pi/Sigma/Upsilon/Phi/Psi 171/.notdef 173/Omega/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/acute/caron/breve/macron/ring/cedilla/germandbls/ae/oe/oslash/AE/OE/Oslash/suppress/dieresis 197/.notdef] >> endobj 33 0 obj << /Length1 931 /Length2 2654 /Length3 532 /Length 3310 /Filter /FlateDecode >> stream xRyd@@HÃ$,E,Qd_́F;" J~؂ z+Ap&^~7dF7%$2M2LӢ7 E@SOnL(ߛ0 % (dXA3OoD?Q8,ZO h d/A1"BPTf:5:Y hf| ESH$@i1XA0DC^Q~51B ˱ib.rY}?:>f/0kE`2',~:Epi6uve3~"pqoYmrC"B&L>-- emtj Ͷr3Y^G׶J<]cݷ#b.^cg(L~~uOf^;f.<>eCu]H]dxMI)6!|M_:sJqgl|eSF7BC~`>_K0sANQ9HqqQrz6`< E_fė| d:fXaYe%-tv+C=VO7M"-  M{Vzn$h~ Qpwv&+ٗp*HJ‰~UYgrܧQYA*O.ȷ*םLf.UIxAnLATR\On_E|0|fyb㗎?t/v6e/ S0~ɦ>cgguH ݚ/R떝ҶQ\ѕZE~vc(d1ZYn(Г-y@*tF:*KV[{Ǵ9Yu)1rm7RX0;kF#:sl"[_M+/E  a%*f9hA ?(pT>7N@|4{JN(ˠb6T_W C{jr^Eћ/" }l#ul g#oF%ù> L)|'$vD3(;.;Nvz0| ӹO\Sl_*׸f8bQ.n͛qhIUʥ*^ޫ$dOSv zF鐧+l =wqe;B-ߛG]ߴW,hąo EU'0 l?BL2sy5 R&]Ge/*'?vf[>m9XK?>XV$5(t{GHԺ}s̶Z!~VxtiSYD~V}*$SGnytHݯ~w۰IxZ:R] <c?7;ADyA2t\ z n홭׮+DK̬:u]GHI[/S<12Ө|+am,p崹etʸ;m&\2c/F+4S䝩d3K^(.6lFzNA+{ F \ml6Π!Y^q!JSODz?5tM_-C8#]ܷ٧pƼTiaXK7w<<;tP'HBMN7=blʬpCS2A"33&[0ʦ%ry <í}51 +Z#q*]N*4e%\xbՇkoK%},2=n0~Q$(&5omt鎩'_V_I[@A "-kfcU 7lxǞx6-.4\re˾ #YӨa)|+Gu2 b5)ɧd(v=^4Ԕ|@ջ]ŰW.6SpO̶ڹMeaQ6!GVXAY18&QJNVbڇ@;f_:dHYIsd"em-fnĉ4%'F{"ay`P%>g]jDo?~&HƁ(G! Iendstream endobj 34 0 obj << /Type /Font /Subtype /Type1 /Encoding 215 0 R /FirstChar 46 /LastChar 57 /Widths 216 0 R /BaseFont /KCMDWL+CMBX9 /FontDescriptor 32 0 R >> endobj 32 0 obj << /Ascent 694 /CapHeight 686 /Descent -194 /FontName /KCMDWL+CMBX9 /ItalicAngle 0 /StemV 117 /XHeight 444 /FontBBox [-58 -250 1195 750] /Flags 4 /CharSet (/period/zero/one/two/three/four/five/six/seven/eight/nine) /FontFile 33 0 R >> endobj 216 0 obj [329 0 592 592 592 592 592 592 592 592 592 592 ] endobj 24 0 obj << /Length1 1125 /Length2 3572 /Length3 532 /Length 4306 /Filter /FlateDecode >> stream xg\SkiAiJ"EHiIt%$!BS"*H)J"EH& i Xh"M6^/{9_33#rBJsE)4ela@!""Zxa 4 *^ap>d<݃ihxh  (oJXh, h`0~9'ҌP(D#+euH. GQD(8, Qn`CԿ1?po48o"qHP/m($o>A#4eBPH341~voӳ35ϟ>38K$#'CaJw" @)/"pH4 )A!y  HT Kcqғ g1N9Y!2(P !"8 e[(1ZůoR`?DD&(G QGPAM܏ #HB#H);B>G) #HR.hj)y! 24ZaѾD6 @ vAQX(T 8PW qjM&U-ML ԘC_JݒtE}^}|o~_$,ڮ|WN6<\6~]~ǽ/+9fbږK:K@nSAV7cQ)*{֜5a\?DPukF"nI7? ;ֿNIr%cSdBߨܜ'Vsz^>x2kPܙ.DZKns(MG}m50pxtXҀ';UV;SH]+; }9WxrA[m=TQ_^C(?mݵZs=ݦחAϺ&LZ> jY :uɕPm,-F|%PMdIߟD|wdZlH4Rgfl9)vae!%1(//4b%S5kcn rN=U `y:[cr  3w5^,a*h9)S'S[Os X,6Q٭[^G3i g0mʥ\2̽s.IJ}#m"ix|ge $ڗKDv lǂ Ŗg5YZ559Rg@ɤ懮_{Nx&ܐ˥u/:7q>V L?PN1csTsʫy;^|I}e"ly؀L~E 1]㗙/ ȻlM/ ŞB=K[xl|ՠDŽƮK0/qU\!*+Avgي?' I|JSX1}Xѿ;oBq vn:ZQG3{ - .K-}L^7:.{ }6-FjU%gC%we5? W5Q>V]Jò[8I߉I+t{,A-nrjW q!gS* PnEnaW若ɫFب@'b{T'g\P qQ2akK{$R™9v"3L[T\%T}z}O-zNq|>KS&Ƈ+(TDڳu*J6R޽S5]Cxt䕑Z}3(fPRlt%;㛴{^i6C_ȼFznYJ9E +du}W|}-!t8sܥrRut/5_{kJzm«˞'ޯ 9JL^h4@Qf'm1MpʿrڭBx "llpMpBb3N﹙);$y£?Ą>%ŷu#Y qxn*1^/R*/~R@?kȝo@[s9oQa8DH;uWmI7}-vo nxF}T k)v@!k^Mݔ*)FgaVLyRMӛ,91ѵi@).ي偧H6QTg`f|`|BN}nqd- "(^ʐ'[A2n7:RtMReleG0{wDCQԂ(qk EUշ=v%z>?*x򦜾.̶TM7ʓErĽ6"a0ʼ?׳ӛ>}7umMݳ x ukF6Q,D&Q*lZt_3))v*g 1*;V:2P$b[Y3Áij c#Ȗl :&N^U~K|;*Q/Vۼ/oQ8@I2bMYl=#jm_,z}6̞@hzs\[zhZjYUs6~ ՛Wd**%eS,l ,d uursɊ٨IV8^034vfpYxE8|MzGI3Cg [l0/Τ"ޗnVڨ%,\i~"Mn9_|FKP֐E4Jx)*L n4͉ gia"pC8%pA/"N4@>ĪվS>eI\2wV4?|\Kߐ0àdyz>FBɳOim 6D=vJ7lwSs2Jmi?{w q|4e5/BbsytvުUvBqsu&06p;A-ޚJ`렉^  |Iī֍> endobj 23 0 obj << /Ascent 694 /CapHeight 694 /Descent -194 /FontName /YHSHHM+CMSS8 /ItalicAngle 0 /StemV 87 /XHeight 444 /FontBBox [-65 -250 1062 761] /Flags 4 /CharSet (/plus/period/slash/colon/C/D/O/T/a/c/d/e/f/g/h/i/l/n/o/p/r/s/t/u/w) /FontFile 24 0 R >> endobj 217 0 obj [826 0 0 295 531 0 0 0 0 0 0 0 0 0 0 295 0 0 0 0 0 0 0 0 679 767 0 0 0 0 0 0 0 0 0 0 785 0 0 0 0 726 0 0 0 0 0 0 0 0 0 0 0 0 510 0 472 549 472 325 531 549 253 0 0 253 0 549 531 549 0 363 407 384 549 0 726 ] endobj 21 0 obj << /Length1 1468 /Length2 11149 /Length3 532 /Length 12021 /Filter /FlateDecode >> stream xUX\֠qڸKC܂B9s9s5t~WUӔdj"v I;[gF  .dXXD))AF`;[q#g/ ]x98y1;{G3F_I\#`lyabd P3="P9]AL@ l 0m$ckfޤ4h$Ml= 3DfE@o.7Ϳөml?3l]A;SjKNd vQg#k5dgba8I2U;X̌@Aiֿ<Ĥ3luVXd?$G;[oo$lMLVN!z#5@oLvo:0sD׾m=?B7&v66F"f { 'mwL|C\f?֗?`7q%YM#j*警ҿz[z[zO]Hͧoz;:6f\LM/|_c YoF=ᛓ_&eYlYoVᛕ_fY9oVᛕ_fYu߬7+>QQ;w/F '_N5Sppr5qqt:{{o/d`glZ+Q0UKDV3!xsαyRDra @O>d65$hRcYBKW?79ՇE _&iLvõZȕOpSrk7jJ&y7t"eW`\4~{wmj%'2Gz>M;ZwqD`v6kM>ӈrڒ" WIC:%,W, |Hzhסr.YP^g{hqާX9҃QTIz֧9@蹼1!1R}s@ܥ,.poc!'en6(wdW#H;ScF~ţgJx<~D]6g N*t ^ 3yU5&VAJ o_'RdC }^EWa)hoŊX`GUIG[ALLzkB "ֽz;H =DVQsr(FĽ/ѳpGASh'6 >Z<|? y  Ym}9iso]H-F4Gf 6]I%޽dr,qD~H2u$vEimJw ڱFMcGӾ/.*ci9M h#1u૱jۓ޿,_+#i(D4kjW}sq€-qUTzwބL:g~0f_40oCb! |wz}U'*IcFti?DQܯ_nEښ`C#d>11a+A |_} yV6x^\'DIWp-gj)6AgXNkq jzv=Әh\-JFqQ}8AaV:.:mN{`JĎ L ZE^׵jTW߁AW V%_"pٞ C֪ 0h:bI)Qi_DfB5B$[U_yP?Ҭ(+B( db'OM3>s2rvji Ci/!KϾL;X=,NS'Hy?8ÿV O"]$eéRᇭGv e ^֛޳3|pc+pL:5k!Xrk%j-j{׀##s%cB`}+h}\@٘p5wa.$~yjA. p{ȗR1o:$R^r'WlTv)\IρCAr =.oL%d<9@HA] zyU S7V‰]Za&utFXcEwz+ ӥBvNgr9M6aЭ /XBuOzm& IvW%ulՕ9pvI#}j; 8*  ie,{l^ I9{N=|tcK9gh 3] + '=y~©QrH6LM "M1\yH!1@ۜJ02*@,ַWlAC r?86la;^7ØУY2\6"?o@;TZs#XYB Or +OÖ%{+d($#][HnNkf+iʃck,6òi /h<!V(!/1@uC0jS1e/j5vAV4t~Y UHnOy OcW=(~ʮJMFǁd+e2Xuv|z<|GWY$:˖Ŕi !Ջ5:v VpФʻ}\iI,߸צ!ƼaUWMKu3XJx=2[-cu3J yf K57"+YNA@F^ x0{n>G΄<1?8ْhARG )4QVcJ._2d\OXk>Q>P xh!d)j~|ܺ'0Ѓ0?u ˋ7+e ~@~6PqNVcV =nyvNeH]BxռUAEN\)x4\lQ;_㻠k3{)f$"͕[^Y% iR8Ga &B(Hպ3N>zFX1og\]8u/;Y*uC+R%y-*4vAS5_(DOB׷YP1yb̜xAyxֲyB-п~>/lY#]yh:K^|0d#5Z&_PWIo%zWhT7H3m~~.;݊A4Yb/nW391F6YPQΤkX-%d EW.m fuNkw$,c1Қ&ʌ фB"uޞTls馀V(YO6roN+\ixj2.K CW}A4WQ]5*KrycӬ.Sdgi$q͋_-|`]d|BټmUYU/% TjHa&ڳIf"U%๵=~âb)u ~W@'*/Nx9ޗ9_/|=߿[/Ep_-Ȉ2֗[ g͝I Ou#gNSXqlIQ!;)g;W#=*g)q5Pkw_.v{ئ0/" %|{J_! %,Jԧ# UMo#wdp]%Y$6/8 1Qs\1ͯwIӂJG{\;ݽƥ`q)wNߴf 3௞ IE/{R<0^0nƻ** .eS%z+^7fO;Ikܳu4uMiM[knTXVEq Fv]bb~v~x$::n|!EH~hLjcw2b,&3LD,a49\G{u 2wIJHJ6ZK/$9\P(NW$S2B]Wב@}QE xXw}4??.=ք~'p +(yOA* k\i۶R~6GPDz4D"A߉Ϸ3QÌCJ9W?M)Byh *otZus5`P\߂V+nBS߬Mzzyd,%20A/;X *f{ 'ղ^CQ\w ܆} 6\3K,8;÷o:huDƈo/ mif>2?pWc+ l?*=ًJ%3V\m<Ӌs3y}}=ya8TQ)n3hQ m y5-8366xkGz&0areROdz2_YwOY'Pa?8X]Tc7iYavo;y DA-w s"^+֓sIlcM_}@*"O`qwZح+j ٘dɤҩJ AE4G{˪Q,P?F*}&|G` =m]rs=T&a-?Kg3&Ut<; Reg" \n"y=:xV=SqNV;m<7^JL;>?PjbS {ԠiH{lxSGI}tk_&y}tYU2)7o$J"fʖ7/ůష3 /Ғ LK[%Ce<%cra֑yY@|Hk/Mڬhpθ )cӆ$m'; ݃žNuR4dQk0Ig_9łvP]Y˼,6}qw; q<\uzWa4@oL$Qٶ vɼ4 OċxÂ9!6kZQfxLHV<:7pH}ɬ* 59~;Dqh< 9jju<\U$&I MP:;JO-nX e~8_l9wqWAH}>B[Iq^ 4O4bNCrZO]Mډ`K7^>|8Kg]n\hؐD\Q9.lU3<, 5"]G3O`]Ə37;, e:Rwn$B F27Gi%:N4DSO;a_1pqdt/emԽ.` 6H+bڄzzn" [Kb'Э V^wgp/=e2xt$zagJ5{UeEB;%؋7+Z2Fq [z%+yR=)ǧ~y6CרU?8l&(_`3@}ͮAy 3@Icc˛#f]/摥b?_dh6'Ȉ86 |rEx0~fd窻dG1 ~RB"1er>.`]tʑSwu3.- )#, )j#^"_R 'I)/G"#\^cnЁ Ę!b)CՋU)ot/^LSv(03&ٶn7͏9x}3K~k]6kl껚A!T3s,6EE( Ga@Z)dس;҇_~ڜG _v21}fnfBkL)L~Y #*.b[v~*\}-7Vީ)J`sheW87qNAEt=̋gX |Mr1\r nב.]NA̔rÐ $kQue@Wjgy@a-H+GW(R}CiO=i$Udik\^mϺ^?d 1/B^D঑kR7D ]FڔPy aoc{mc+=4W]a׈r|nAd<)%2=CsfÓJ*ީ/kӤdݑ9ß`U%ؤV+^pcUSU-V6+3dU`LIcsƝV{_lxf*]}/%*e]9,Q]{aouo0` Տa3:%Tro eUXojAye۽>(5Y\Wbu]m–}3ЈJ1TYIi|}94"d`_¾Pz:0$}-"#='μ;K5-K|*_İ%=ҽkV47BbZvYa1={zH!M߼ϐR3ڲ9W(i~ r0=O8誉v[.zaKH3Y"ϡytag>9DW?Y6ZKCq%3G! ξw~CI·c}󼈈 :WG ?4)QWF|OQd'W* = 8|LpuEnYYsHKp*`:KM_qG"]AU6`HSZF0Ӎ9swf[#R[Q܂d[!E G Ԃ= gyLuQk&}@ FeVMCM-[PEK *fq kiԿd{z~i}#;5D71G?[5y\ AR|'ņgVgГl 1Jcc8Bs Klݣ?R'px|i\lsϗbr#|!埤LϸUui>npsWνJiJ_Q}̝d9P \}7u ¸V6x)+H:fT 2Ѥ,j{:g`ˇÎONAVf_sw}HXH_L\c~.qoo ˛i&ͼǁ%ZR35Iu#,f(Pe>XHE{mm.f)X';.u9jbVR7QJhYUlvn!mcj'!)ثܯ/;$C Wʎ^!_/C4~21O!DS)󢋙h T&ʞΥ v/t`ZYp#\8AvmM#3x۴9FMngq_i(eq׹ю%K'$5mF܇{EZ>1:OHa^ﹰu?μq髞`O~c1/5[|v'cKus,; 1mP9#kk`ps@j,U0PD[UN}SNErl|?vM$Mݚ@)&w"k$Fp|'(;ׯ;6>.l4".Y6%z WmO1Lz^(%4J &RjyG#Ez[`:yY񸼌[B+*^gRMRii+f~FrZf!m@ cNvyj$o|z![~\fDH!Er86gVè f2gnU#uyNq!}=r~O) +N.3#e1`m|6(!JnPP2hQkEsFUyR2۠3w~cöŎ7:D'\? OeatlǰLHqϱKQQ"d>~WcQ=Sԟ3Qp|p~$vI 8z(; UKIzDŐ_|iJ+w$f'*iHiBoУ>Rߘ= 84`nʵ\,<6oyM$r2pa4fJlAr~Vr`IdC ;.dPRE۶-)_Go!z/FP&KB{'\$&fObEn{ XxW'}w` #}O+>AاHzZP K"o"mR߽m={wGto$ X: لp-N_a&j/v7mq] %k>)HlZqmꨐq=w1| VGYWN.KBznJM5uiC O8ranj8Ө0?c3~K[GflҭP0 aC9w~D%^T~gĽti*;? /4_i cxQE z._W-`F09H-͒,A^!kT~PgzA8Ad 68i{e6L+"=mqqMd;= CzE5P[4Fbu9sMTgOgVBiST̀}zAL2%q_eb_'n.vؐpKi#{'.ư._GFLW.}$*ރ ǥ.bօǿW/*\$ҟu*!ήTmÐXc@d7zؔ;y1:n}~ 7fGB+kdt+Y4*/k] 2ީc,*10uȫ!bގ-oթpQxP󣝾Ph>V. WxdWZ>Մhc=xД!yǢO~W>S秄Pv:l0GЬdU(߫a "д܅gڡɦtj ZkEe WS}_(s8? .H[2wPȮ3@EF"&EH*lB5&5X .+,ŰFZ3 vL*1$?J044 2TV,vVt2a5ZH҈ЯgfΛWj[y}g{Qkn?i^jA-hbS:ccl̝qU9&xqx6VAb'I*a|}Na7cacs.ϮTta4tR*5G9ٜq!kچFZd=o1-uLKT ;ݫ%k#p{%EmHwX$Jt|Zܱ,4y,%mQ79 HfyDŽY;"L6:x\Y7kE^P´$͏цj @ ylFL ~jSrsjA"y}f֗_RumDe}l{?_pB֖;DYmmM7c5CᓴLEMT_s\DJ$63({01-uzMJ4r(_~||FukfWR't&ٛRf s^D7Q x|qA~"j$&}]y8B |J(#ګIMRڙV/&x27{t>"̋jVޢ7tǖR<0>F'i1l'ܥ}\^g6pꀢ:_=B.7jbbNEd34v`+_$ޡM aBZKb!t!,3CJUGEzf f+G$\_nD&cj"BL!5 endstream endobj 22 0 obj << /Type /Font /Subtype /Type1 /Encoding 209 0 R /FirstChar 11 /LastChar 122 /Widths 218 0 R /BaseFont /DKCGKC+CMTI10 /FontDescriptor 20 0 R >> endobj 20 0 obj << /Ascent 694 /CapHeight 683 /Descent -194 /FontName /DKCGKC+CMTI10 /ItalicAngle -14 /StemV 68 /XHeight 431 /FontBBox [-163 -250 1146 969] /Flags 4 /CharSet (/ff/fi/comma/hyphen/period/A/C/D/E/F/I/L/M/N/O/P/Q/R/S/T/U/X/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z) /FontFile 21 0 R >> endobj 218 0 obj [613 562 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 307 358 307 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 743 0 716 755 678 653 0 0 386 0 0 627 897 743 767 678 767 729 562 716 743 0 0 743 0 0 0 0 0 0 0 0 511 460 460 511 460 307 460 511 307 307 460 256 818 562 511 511 460 422 409 332 537 460 664 464 486 409 ] endobj 18 0 obj << /Length1 1948 /Length2 14187 /Length3 532 /Length 15270 /Filter /FlateDecode >> stream xeTͶpܡ =h-@pw nA|}N~ =Wճ\Ud tƶ@1[':&z&.#QLhdnk#b0qr2Ā/?.6V.6fx2RIAk @ h ad`P52:J<P:\LLcs#'!%I[ǿv=tpI(IIX& rj@Z;?Yk&Z9;@=Uo7Yt22712w3w+;L mh *#'!B=ט3_A`f-/h"Z6F6f6v;< 01n az['#КxLlPО3+od`l46Ng t @'_dVF hW鿢k2H #[kk?6O!VٟH`'r@N@NffH,_3@ d.6?fژ-埞lz43J.@(eCl!PbԴ5,@J!PRT]!Pu?.@UWC*@.@.!NPC#K<0CF^#FP?!!_ AMBPOf!)ԕ_r ARV! deB_r 9!/Y9 +dוr AV!_߱BBnt̠7Ϫs89LUs{gfd?Q#gl tn@#E[# r (jp!Ӗ8s]V%ϕhHPD/x^bqi o.mx7vO;n'i d_ +P$vi b˰R 'g!Vf_))TE(l+ڵm3s!l^F,Q'5!YYQ'5Se*Ҩd`ZHM֤h%m[+Fɞ Yr1UBmU4 味S:їt 9)?ZMJ ͂Kk #s݃ W*g;wOg ]AGxOBT/>?ysre(a90\o Ÿlh)E)Ⱦʪ@x~0P*Vn,Or d3ρib{ IN 堣:vӃLsv}珜0IVWf`?j(c֡GkbzIiKe2m9Y~3CANHFTv\Z0:7;۾uWBIuWxdxb$.֧f;1IZ:':#S7vX}P0ǭN `@dekH5wx%@k#vTmGM✍ad&3X'2Rg"=`̆l):F7g4QVn04C̍xǚ3lb|9J򢶮ԏo˃ oȎ" S%h℅Cn|DRL ej5tۯz+>fnriZ0}_I'\Q,kbm$UK#FlI U6;=M jCw<*cL0{9e|<w[SPC*.g{k0,2;x"Tƕ$,^·TZ).EH`*7ff Ӎ|<9d>O2:ޠ}^&u_<-D a]gHyҸL9|:. ̞Z(ݾ&֡ʺeayK@l7?c]`\Dan#8%5]1z?ȸZ(^ eٓEy#aȳce8.9rofK_LBLp9% MsX)߿q;yc6F4I7 8OQvᬽ qܺQg^gDb ڡD ێen2TDdPv7̲&ue9vxtwyYL09TCz^xvYTsYqY)ET-O,ay*`Fװ`E"S*1ն}YFU{،KUC\sxKG1T 3`z(d&nr[%%{< 7ݦLĸ3ڤHD'WCDAWI skcώj86V2MSj緡]3"*Jﲊ:/!z ]wS3 ߚawTe']y}>R6 a(.h0}'UA{ &ٙxq{9n *<=5!{e +9˱*$JQ{Y(L>{f4υ͍pXPǤXR 9ZPWgv%HH/pa% UUaͨ(ÐeSo9Xd95;>@*] dVHhJ8^~!2x#NVomhMbvyG34zu~ wLm w4zv,șq){K2Lf)SѻaF6Y*ԡx׃-q1YS7 |窍zQ2+,u ۂߗT)u7by"6DGW GMT;~qpa6#W*ܽLCE]cG%1 y@ .pO`R#kvx 3kx:9Ӫ.|[gy ,Q>K*nèv!&zJQD9iXQ?+%Xw0ydxDG DXv˓Bl(be{&d6\PjY Z(4]=4[RWsPnYc/D2z)BKBeT*aI:qNW1ۗCڥO/ؕ`6V1SisOx2 čJIprc .QS{ jBaZuE{)H'*b0_zT9)x T)~eP 8V&@!O@c>8usfշ&XnyQ,44 aYAyKlN9{)u#A;C_ޞa1TnMYw%k{h}"!?\4O-mKo?YGzy|52J-f-̋D$j/I(i;R]FV7ee~ Ona1(Md \+l fWe*)TpV7|P`"fKmHĆ]P .J֨N_3~1Ьw*[-c\ x\˾xNttrBz߇9FZ]7|F5m*Rr 1'\<#WMi_kpg'ZY+ ,f&j1E䪰7Iٺ p#SFJ5&0Ȥ2+2j2W3=(nS (Ⱥ`&9vpo7=3h٬NґKV#N9ʛ,ÝyCTZh'S%N(tob|8_OVԉ#p6?gK{aˑ=oti8"W]_鼸=!%,*MTC.p#?oY+m[pQw[Od6^ng(y>A/#|/`^X42e94(+_^J52XW0VZxF*M/(PGκ5*luLU)c*[Ir巠XĪۮ8 =}POh5yH5;$w_b'6\p~ܛ.B.aRT+`UVRa:2Yp2hIz3Mw/{o输>C9qUXkxVlSEٺ f PVEfVkS=I'Oxc`KEj[E4^ k~Ża(UO<a*@/@Fg;qfV:! .j`1<)AIcYJa'{!Ի^9]@3s~9卨Ƙn>B6if1u 8&jwjϓ"̐mz /jc!rJާm``e |zKU?-Q%orm*BFr7ϭB{^^9vģ?W&ZQEsn!+^&OgqSFJO{r +rvsVBM2fm32׼f<_KSB4jU2y66[13y< xg a s [Q@qAIM5w>R9gc^^;ߦUuGtgيk_[aG=רXxK@X̲)Xfif (fw]888f{ ̊.=u[= u3τϾR &I}IK߱ ]UQ47˖BUhZWԢư`$/-;1q|o~`p7}=H=W?U"=Nz+h 5KK}jׂU3~{CXsPG@4Γjej4e?0rodXO y¡Nuz= ֬֒g DJp1MJd묯KJKQSvnkwyukNdi^u|4 ~6 ? jbA29(Z 8W}fKQـJ^z*0T֯\4?6"fý…?3:ǭv;wl T]ChW*%$&巕JpmL#AŠ=dAJ5s<_'QAC_Gʄ9nv/d>V_uda%鞿Ar @]7TDfê&^Uk3=,'$pToƶKV^U&O[d9_v&aհt2rWmؒdZ"N'ZВS㹍N~GNТ t8ZZŐX1`, )GZRof!_2XۇƎ /ޑ#{e!a{o(4G2 =2JF }}UIk\.wNYvXi.J(5Q#ߊknb/^$d{! ŝWLr-hx1XN7ץ 7o( k 7"뚛K5zLhӴ}{ EpT`T&.rUbñtO [_Z>b/$u)LlX/uf'j#OV#;36Rys2v/wL]aio K['C\X[׭Z@ΎQUR-7R[tF.եDȥ%X B%!b6D:i,K<h3zbVS[̵C6."P7S֬;J9 S+'>0hjZF"#D%dےiQ0g9rj1+9thK"$%gNTNL0_~{eVآ&bmu8>R4Kowwyk?5Z G(Z=ȓ`fު##,l'1ɒw=iteD҉EAE{AZM1RB`ܵT^al qڿD걎l6Q~)m, ߾f:Qְ9ci<=?njO뀹D·㧭zs~SB E(vP!'W^ r.}ՂRZtbh/IXD:dwNAy[@IT릓,By#mC L/pFՓlYϡnd}A"?$Ux RlndVN!bAu)C%M R6L;u`w3 9fhC^gWAj哗8p:qi{ cHO8I7AFy7JN&Ƨr9Dv-_7 ^pa1P'$frnxib/-?QM}{DXMsz3^LX rI4vkE !JfzG52w%S s+wJjaTޱ#}Ҷ1O6jjﵘ]ItPRݕ~sR~hEtK_2f4..9 +mlN) avJG9\2t?h^`[RRiB3]b'INB 'OL5#k!s*|~)S}F ooj[\*I{PqYnz̹ %Q}AX|_ܷ QIW@&Fj^k±(#B+wYK$UwێLx'kĖ\UUr]bV-X!E5)wXM㽜XYbb+m0ӼK-E`%o]쵎$l'rcvn*þ7}VR{ {CVh|of*r (B9Mv* #Vֆu؊ߑag&)紐mCfFypGr`bYa;W?*`͈S$LUd{?D?'y53|"|CeW1]0Fx7uO*̚0H%g4sVnTOM>dn@Z}|{ZG]g-9*MɈS]Q%"*w!&ڣ/OsyDwTdBkB_Hȓ&uЇqSHJh y)MKՄun9GS_X΋̪8 PZ땫>d>} 66-p8_C \=5C@Ʉ$›wC}FAx b0"%WKv.+c f]!AxO1 \2"x;MP4'"xcF {]`fEߚZ% >X\m5'G).eք (D~_$ҥq>T5P\+@2hVHsR<I|PN1 &qY[tve>SEkGl6c N7A!"K\~,IB{ՄQ`& )YT UL0w/e6w^ :9R~Wp6"Uql\P*l'(&{l;*{[_IZL;p4*Z-"ZR] 2Os!?| 1mmkUn&j /2>+sw:B_4mJGD[>*EE4`r-K:9@S>j"}xL4qYsp̳7ƞTV,L)PG۟JB*TN9r+mv(R$KymAeFalAbrsa̛p_t=*_UxLnp kƓ,T *D͡E*%-JmIQ5"P˙";a!#[ȧQg;cnEޟ|Z\u,q=s%L:z9}OwH]CVAV SO+kcu?Y{i"Y>i" XPNGV36՛Zxld6$9< s5_|.O dQaO>xW;6>{tL?)̄bŃ%#]rAuz6?:|9ٮ<*,|ibȭbrj]g#02M>q*B{jyLZ2#jb}C5\e춞7o=D3h?bZc6XCXTJHJ < ~X 6wh~|#EYfHYQ7),!yp$ ~A(My"f*/ 5sF;ZQ%C@RX4Ŕ"C[yPZB |Ǩ w_&~p1=Zl94TfA}P֣ӨX徼8AE)VX&|\3e=5A[10Wt~ϧP^[CգKzJYQ9Z❢ُ?TM7gI!:6e6m?#"8FHxĢ/ (Xd_<%kgXٻh(5-z^72^7r sw)3;@BO.ƎJrĜL·^<ά5_5 ΕGL$E6>nh8C/V p^>^QC8_KUX'Ds}b16hRw!MK zfvsvj'%Zq-84fQ6VԷ2hFԨGJ{0TL'R[T@l;3!ZSLDXly8_h }J),N2=̪/-yGRoWj2%MĎPf S{rzCBhF#}@{?hqB(MDk֝l-3'ơx,MXGJ~hTF9'[(Loڞ:= vgu[cQٓ5Z~sH귁 Tb.{Js޳>-[p[QJ?O7/2ojBavo5lމ-c5'D͊:JHTESx h \%rNCK_o=8)#7\qCz]p\4Lm:UO'S>3NblD;+D~Lq68gD1vϢռڨw-^c)粩'T9Ⱥ} ak=q8Cш#!@^IC-t%N9,cC=9΂}6rŸ <2Mqss٨0W}UO%3wtu[9aNE^h9f'ͬ{bx窛KKkI(Xm?t.\,$Vը\S:y $2)ag:hڿCJ/ֺ[9ɂYe\{f0f$,vZJQh]/|_.z#ʤNX`T(<,+6JrЧ7N,Oa]_źz=b@Z[aJ;E K I:Ol.>'xw8Ks8C>Ƥؔ,:e}a"Z,s_LeoաsI]9'zCfW8X4jMU{=@1N3 X$lC-|͋jMTX\( ~/lG ܉ño"L(wg 3ߜ@ۊv_Z︕81gXIp:ln9[ߥ@Uԃo{yB*0VJVCv^O)nqaBqQ4 2C֪5_AT^;/O&lAqǟ34S4߉l3'dORr\Vj:IYhd/REG0?QTchLjh6fd}̎: S}Zy'8pq9.y ?7CZSB!qV5;CBӰw!woh- \֪4D@ ^M=R(cV봏,'rM䯏UF/ƖW_F4+f"L*Y޿"WIuҩutELe|{ϱWW$!Y>{HIť,7l : )1^B@4c-i)<[skcjz^R5~Mqe\.supX7pe)wG.qBe5JHr58qUo:$OIp,/ιn,IW4H? K)>|åC2a.ZѯHP迆CF3~s֫a#p1S*s5;a`caTڤCn=i2eCoN{3p+B5dA^so܂!חl0 ^HQv]ܤ)ҲW0lDe:`~|ƶht Q1eXnL~/5*BX՗;ML- ֎5U²5ȴ[Z!)O9&N 5f -~Ơ0ҁ=ЋlqZ]~L%y28߾*,Ǡ2ZWK!U= }"iT7k݄ 1K Q_95R$c:D'fI%%C6pVfddihdUr{&-"2-Fe \><Γk%}) ,+omњìuxԡ[y,wkh;%ix r=0#Kއăf'<&gzM3@:ᛈ[O^ ;FA"UstnqJ!EP_M nP}./nQYZN*&Fesݕ(IY2"~O澗/vm>h"8`1 @0m{gZE- (nucmVV`44/nLS#}ւnflI ?o,W-9>{}Y{˻3^k7hﳋ+Oi qM2G8/x.ǎSa ?'Y l ,:-endstream endobj 19 0 obj << /Type /Font /Subtype /Type1 /Encoding 215 0 R /FirstChar 11 /LastChar 122 /Widths 219 0 R /BaseFont /ELNHHT+CMR10 /FontDescriptor 17 0 R >> endobj 17 0 obj << /Ascent 694 /CapHeight 683 /Descent -194 /FontName /ELNHHT+CMR10 /ItalicAngle 0 /StemV 69 /XHeight 431 /FontBBox [-251 -250 1009 969] /Flags 4 /CharSet (/ff/fi/quotedblright/ampersand/quoteright/parenleft/parenright/asterisk/comma/hyphen/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon/semicolon/A/B/C/D/E/F/G/H/I/J/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/bracketright/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z) /FontFile 18 0 R >> endobj 219 0 obj [583 556 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 500 0 0 0 778 278 389 389 500 0 278 333 278 500 500 500 500 500 500 500 500 500 500 500 278 278 0 0 0 0 0 750 708 722 764 681 653 785 750 361 514 0 625 917 750 778 681 778 736 556 722 750 750 1028 750 750 0 0 0 278 0 0 0 500 556 444 556 444 306 500 556 278 306 528 278 833 556 500 556 528 392 394 389 556 528 722 528 528 444 ] endobj 15 0 obj << /Length1 1549 /Length2 10383 /Length3 532 /Length 11285 /Filter /FlateDecode >> stream xUXͷCpi݂ww @cC'@pA[ K`L?g>x~V}*yZC]l ;{ssp U \\Rhn@ Y( -П0?0=@qyIH:@VU ;t + G6 p$Zph݁n^@k4nn5` 9qI 7yܡLd@MZ!k z\Qjp9BOP[ݜg>I#J]yXl,݁ƁpPS7c?koCa0:n 1D1Yg+5/psAw gku v@K57_E v;pa~.7C=܀e tnj_V`Ga?!WAԙPCP?UPCP?UP*h!LTA8ut~z!C6?bgfB|?BP{v!/:P]?=!TBu]B_u !0!!ԕ_u׎ >RR`Ђ@3T 'uze[KZy=H7 z>@+ `+ ٢JDX)ۖjs]K ʮ, UXT޿ܣ:}5']?{2|Ffp s >hu>>VlXx\$sJ ثKV\nxh/NkE_7Nr"T}8J+%? ):ڝ4bsL"ȯmI]/l':*g-Y&o9iڝ&ʇ*2ѱ^KbCzߺLj?d]Zϣt!%X#ñ! Gĩ"ꉄ-7zx ͡0!!ސĺD۠ct3x֯gAbT,s/Jw5N+ŝ vOI`Դ&pB[!>އ ,x8VݕvM,&[SR<K^|>ߟppxbAhRs2YӀa=רPq~ȟ}T]zK^4ydEP0Cd`ML/ߋ/zӈ:@cٟ(dʾ]>rlV `X֝=Ԙۿi?YdDY5@3>T L ޅh6zn(j6s̉EZ!4IH#zh:wflӭ_!x+D'\SP6ϨaSjBIe>umлC/Z  EY-6| }ZE>EџvLKU#͒c&҄ yp~7H.T qKF]^7Gۄ4Kr8rt/5jtJF[bk %hzy5XT "VmX/}XMsT󔰏\JM馣6zV)f.!~5|b} ݧQO е^97#'}*ggD P fwp9()$5j5ؽ$^<~~YtӢ]R$ŧeo5[8}hJf~kqu3 9 p0e"Z85(}|YeF 7Lt­ޒoCOV9185zl<ӋtjŞL+e~W;Uxy6UT$$4P[nyNo*߷0m^e,.ԋek!'&yzZRDςJf;[Htvqu^Q) UO0Y[,!s.iˀ~"; 9TZ5HMjP6ͼKjVSoᜊ '6Aftr*O)g.^$0]NO]ό1@ unjrF2o#02}?T4P۪R۴h nA ? ""u$C 4*6 >ؐFϢ WPWX*. = krS->ߑ3|j"U2LϲwYڻ[Op14[ Ptw`@s͖}0்%b 'NCzjF)Gf\f*7Nk' m7_:d֥򎖄OØLh@hPXŔϹ/ID|Y]/ ԃG\Ѯ&et-_adlǪnjwR*)?JypurɊ)`/fBqB4e1}dԲV5EՇ֯X'xYvTԤ=~4> D [qV }r7+މ}/$V C$s)DQ~{k'ݗ+28Xtzxz^=LX|QaioSQdd'ՁYxM$$O@3h4֤k&BG^]i3%?5&hY˨ h>{gGd_,VkwJf0Fr m8fV,bB;u6jWO֬ak F/:1q)mi_v8сs9s}MHnjc> hw~D4F˅;}cck,y V 4v“*'3w>]zK&^AlW Z:1;$9D>\= &n08DeuR֎7S;ڐgPB (+= MF$l~jNz\[dȡ~Fi zG1u5 $[꣜:l~^pN ޯ"ЁVM IEGZt::Ĕes[B{vr_22IsSkCJ'Nr}'~3p|zp"IE;˦9;VMY9}HW޽ߍC薿UZu@XAO3nCq٭tv~ Л!p| a5Ep~Y|o7!gpG7s(LqӏjDQ?Hn5Bh5츴7g=5A]4(%G5վ5)N)\'Wd9s>]z`6az45wF& @¦/*[]$U~umV>c_ .]q9~~ 13r)`ͼ?|8rҳdHДq 3tv>Ez?BC:z) k~T1ҍ8=9'7iM0[hѫv`]t-zz!*{K~a(xx1KkϡnKԃ vc/JL_f7/<A mbȣ*y5 Pfؿ)i- ΂Z|,pZi`uagܬiflk̃:NmTT/S̋zu:2N{`LD&3/;k,6%y5+56q_mc߱oEd9eUO'|6L\ ?iՉlV)l;5f~B] seȩґ ʭ~vo=fJ_ׁ\3ixmzM{gNvΦR"]=c^cAr¬+gCVĵ]ߐ֜|J;&0;Qߧ2ǘ=4I79/1jhH"2lm^^rmD]p7"P7aPsZ".i}=/MC!r ^{8+B"懐+T6>sPϻݯ#,me7cNpaΝ^ _/;.^6G ={Plʡ..:~CA,D1]#rp^35NkKJiɳQPG^gm`7S}],.Ӊ˂ V{L9ݵ,b!T4)ax!9IFkv׃tq>-Y]bTs['? LU T EoljmL|/hhzi?Au׋@c.G x2ָ\<c"aۋ" ik~./$v44khs[uP GVQMcW')@K@U~&qٖXLjM@{//)2Li`Ah.z$L0 )3zd|$ B )-솯-ji0_K2O* [z6l7"F#GۋfH$#N2Y/`m78-1 qk^unC)&|g& IJJzş8c@ER߾ 5^OfT%W,.LާœyTxہTZcU7r#N-D@܅HS+AP̉G@$bH9`M%6Ԁg.WW[Iw6D?=vJp+"+SHe[FU [[&A:Y q$Zq]/x0ң !3D]!mGM0t!^R6hZPBb WK!L.˒U)L뢦YCh9d̻`IZ#zq p}w&sֲiW #n`WjI5q5kYH4ȸЮn'x)JbjїD'"~y}Y#I/^0|>%C 7B_zשTܦZާx]˜E92y| ü ˣ&I훹Uޫor \+='}^Q+6HHqiyðY~EoSK%z5&=DH u ;ؘcдbiƲMlV>grjAoP/'|ukSKNx@>osUbR␅p%cş&?<t3!f/QUELkYCؘk}XE{v.:\bh\0/~u^N'"؜bY\+1X[Pc؀5\E3@,fAA EПU9r[a<}0 I,n :V3jQ6wwӬfP},ڙQv3p`az4W*1xuUlUP)pƸMŏ Oe O%DSWZP{W3B0Ȼ৷ˁ,fI9mʨE0!rED5~w'yz&636Nr)]p::W"ۙP䐴_gr|vT5Lnd݅Y-^`Ч  2[- XBS'V+F3?75I7+Rv͹4Ș \<;BnxLeQ?.)dp3qost)7hılmwY.Sk^v<D7v%0 '!(u5u&ⵊ}uχ6UU]d@M|XqPYvb.4{F{0 OX>VW0o%W"Y˽Aa&ި0aW.ݳsT-SOԇ ^7 f/.o*<>i繖PcT Y>,; q7:͝z~tT)ި9OSGS@{DH %>zY-M\>崎V ;aAQVçk8&xuV-y0Gd_/k/g jC;Q$ÇXMOz)} 9iݢ$զ#c*Ąċ󗕮 Ҕ^^H /e'ѦU݋ڞgJD $]݋*@h^#^v5_LʊRI?r Tw%j+V|1vȨsݴ0MMg/'p#6jGameh,|q͘0Q;]숣ni褒Lq 聾j>ZԔiԻA a湽~2OrfE6;e俬B!DZq6vmL/J޷ ?$GXXwHh#X#WncHh} MהcIٔw^ٷrzZ($UZG*#êc%Gvq$ n6EI 6 zx{;+Y"~i  D& пE=HQk9Q%P?bUzg6& ~#f ^ůYRk?Hqu0~ v0..uمN6a;ڄo +;q g `tg0G D曵@⚪M7j*{o*Gꐱ/Xq}-1S 7<>r/Yf %W'D{PP4kFvUi$ž.wIU} q9̔L Q.>ZMG.Z㗥8]b/*2_+yX][G4~(E\V;`CyWL̛C vJGlm@ zX mld#duTG>6$Ň_fهr+Os xa8,?^2}z5q | |4$߈-]LK ޓ\= 8+4$;VHyЁub{H@X RyRIFu6L~]%N>뻖 VYfIIН6՞-; hZ_޳OÈ?[WW5ۄ*03sXa7OaPYg2kQ}(0\Ţ춑f~(~k&aKKb/$, Sb]dj8UڬGJy"ҳR3f3SP>'j%0%y9q FfqKG,'zƱeoxTĥ.v!)1)ŬjSld _@$c;N6b򹰉yj7 !ѴnK +K |> 4FEio2 "!kKFfmV:?vN=U{4rā,p̟ټMA^Q ٍk_?ɘ|"&\ Y~SAɠU)lA@, wY ~> endobj 14 0 obj << /Ascent 694 /CapHeight 686 /Descent -194 /FontName /PNFOZF+CMBX10 /ItalicAngle 0 /StemV 114 /XHeight 444 /FontBBox [-301 -250 1164 946] /Flags 4 /CharSet (/ff/fi/asterisk/hyphen/period/one/two/three/four/five/colon/A/B/C/D/E/F/G/I/L/M/N/O/P/R/S/T/U/V/X/a/b/c/d/e/f/g/h/i/l/m/n/o/p/q/r/s/t/u/v/w/x/y) /FontFile 15 0 R >> endobj 220 0 obj [671 639 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 575 0 0 383 319 0 0 575 575 575 575 575 0 0 0 0 319 0 0 0 0 0 0 869 818 831 882 756 724 904 0 436 0 0 692 1092 900 864 786 0 862 639 800 885 869 0 869 0 0 0 0 0 0 0 0 559 639 511 639 527 351 575 639 319 0 0 319 958 639 575 639 607 474 454 447 639 607 831 607 607 ] endobj 12 0 obj << /Length1 1521 /Length2 9078 /Length3 532 /Length 9975 /Filter /FlateDecode >> stream xUX[qw@ݝ=HPC5{58 tIw5>jr5&13 PdP|`cfEpX%]6>>6ʅD 9x:YYX$:Y],v` Sc[ 3=4cFbcYLVH,7x): @IG4z̀H,J FvU2K&ec;+[spu:Af@'ܪ'"?W\mL-lJVV@3+SK3:?Cw5qY%]ÿm~3;NV=VfVV6F)|!NNƞH&.7 z0ۃ\GANHy RyvcJ,tr)ǫq!^@eߡ_,t`O"+krٝ% ҄b;p=X/|mab% kzku{P8ˤ jomӆgiZm))u:̝E ڷt#_=if<Oc0 #/9 q&Y,St,"'tPUrz'b1GF>N->+bЊ=;21A7 q ԋ,spϑ|Q!fj\L*I̼?WYxu]Et77&dZ}_a6k4*gĕJsZ qPY7.""><2XO@܈R2/1L$ah1檈}ox" C[QvP  CZ ҵRRWoLGݸx:ݩ@'cjյ(jWEy٢~ɠI}.r<ؓ09- 1-XPlSk`% V:A) 8Urg?DܝŇYbZڎO bD[!t ʓTw}gDnN>]Qc`]MB)rK !u?=io5߈b' -D`KSQˡCaofOAt%etiZp.aoj=0YŀԴC읅IB"ޱݧN4p+Z;tLi2>TzOZSqer*)TS%UDY )X!뤙ݻSL[ď7 P<ZL=/ߌ#aՖD+dѯ& _ȩ<"+ }+8>u 5Fh(b&+%򑴤lcF2@&]EqEd-(J%,&ꈂ~JQwFVI=z{\s}^Wt_l&w[DlQ a#kS]vVlv^Ȉ%]үPRIy2 %n}Hf>{d{>O([dlt:iaNuzH;KVABr˘KE/9*wwxIѪJm35 ÇE@,oI"3\WHƢ Ös}A:eHuge_lԷ\Q̐p:ID c6jɍ:%#*_70GF9:7u 6/5irer.($7g9%'rzٳM^YK˂2޻9c. j 8/h/ɋ<{`7v4H4wD ;ۼ4&8NAQ3W4T\LBL{.B).1MɎ-xڧ/njӗ1OpH+]ۼ\ke,HO~g9. gU_]xa)l/PWkveG6ȤDQ(TRk̘C;FFz93@ UݙA~Mue"(p% eJ+f Ӣ?Q+5s}4O}쒸eWCeo^seJck}棊+UFهaL\DeKf"yuܛT;M_*A^pPF΃[q+yv3X<#oQþr-xnQ y( EDT!K;O5B1G#W hXuh:Km ~٬}6=gZ#UBC.̇鷅꧞Jרb]m{OVViibL Vr:2.C-M-ct~FS?`wd԰cTWĺ61ժ**893D}։ w ~s5&׋dHLWD`sQ#EE0c@y"O./הSYʺE{uuu݉mDm%quG(C5NmK}~۽/sw(CUm_Mc"0 Aiz/I 85#a)RD.<T/a)膓 s9㸆rXgx*ղp~s #\'ي}kQ}L^-ԏ׌J*"ƒ:r='%>cxvqI~XmڸĪ52c}KOǐU.  gX~9z#t.E~R/E# K:;@8ԟV3Ǵj=-U K1#`31vipMF(*ļ @d/Ё(S"#IU,Kz-_ }e7߆ʜ9ޚ"rza3nχ^ndE` p9.&Vso}1n Kza4A*&}n]-5wpoJkjg0< b\ų2 Yړ7T|͘E#, еL2Vbڞ.NDtyV}rhhâ9hKpv"W5-t,NkU5XLrt"YQ&Gp6MFKMWԏfo850M p#%\JDoW?~O2*ɦMފEk/+fWx@^6ZIJchZٮx Uϯ3_VPۛ=y8#H0%tVVTFS+d]-MX`^A@ Gz"tsT:tf*$wcO-mA^-¹? n]m48;jH'=JHLh-7^+үNM@_JGF  1*7%Dh ?pI( ]K?cDu` _ Er?h啴:*`)@}:\#{Ϩ*WPV˯-/t8yqO2 3uk+/sWgV4f򼛙ʴ5ȀpyL ^z 'M^ <ӷõ7YXʋ ,@aK/ Tzrtm-_dۧ洈M,cE΋s:?RfFYQZ S(T7;;/_ [HmB]'Z UFBS@KDO\fw%&Yuw/m&QdxC0Iq([6ʸT0,M:`vqeRU:bNA0te> |㎢+8&kIzo!v+4 'Ӄ%1R5Am4fݯ62(=@rf&j2Ez Œ,QKCIGI00nuwM%([k$Q ShB79o|_3T(I^J$xiW~,*wJh;0c"m/b-#˻O5'F8jr< saHOTv)׳UoV,^(a\5ғXMZ}909dDoú[b疟Бn@;aHE]g}zXo=TO9¤ޭe$o3ES1[MiXx8c9VQ=zWA2%Ĝ -*b+fF3-lsl2ReVv2jO:)hȎ/_-?Fq0)BIX>lmczq>$VY搭eH}_YG.ȳGx @# j{bP:1AJ[:Eݲx./=P>bmu17̫<ŕUPy7Ԩ$qs=v;L抆LRIN'$qP|79^hߙ h okYpN$ Rgq/j#kulc=HKۢl,NDE΂Uhq*G0kq x|Ck #Ihz@䄢wo |̋pP5/TEZdJbfL ?)#υW-S^?R7f0`NT8?jֻϢ5F}XH? eu}x޼ȠLh.v|gR禂9'MsY+<JB *ѭl+h7,I:`z=pЎ`9 p 63*,>9h0 C=tcty뚎(b,MRsD>6 dbW^(()}(KHnk.l7L%{?7A& RW T(M̩˂fPXBDbG(xyyT\GiPH*`q66z .Dls U0ӷt20hsIBm`VMpvz2OQv96}]}DVYc?XFtUQJ]q=nGǃy聭g '|+MƵY&>ufM!e*9n~e0f=9zMc*xE'3D&[31Q6]1tR1!"% 2rP*(nBbXSG;u9w!k͒J8¥l݄B'G5xf@VV^7y 3XJйzf|.͵Ȝleqg O] {ƻr(vN1GKN19e&-7^|(m܄/-ӋVuq_B/m$4MհÂdtRl&|px bu]p1Bkk[01w< eټUrgıcp~]\h.W+lFaTgê}O UN̅ бQ\RZ3&wwR*O1f4H8vVnV|`V>g氦b"GY(M3hUA&IJxY]w]2ϕ=m֫R ɬhV9y۾":0s0g%AL*&81S$/尫 s ruN~g#1`V%'D="3@&%€C+g=,,<:Zmm9nٱ_-Ia6XI gnQ @l"~| w|'&HIt1i%#Zǒ_as;.VEl:c۪S :b =@0FȀ0љ.便-~G.".sMK %n%u/-dgd\endstream endobj 13 0 obj << /Type /Font /Subtype /Type1 /Encoding 215 0 R /FirstChar 11 /LastChar 121 /Widths 221 0 R /BaseFont /SPBHNZ+CMR12 /FontDescriptor 11 0 R >> endobj 11 0 obj << /Ascent 694 /CapHeight 683 /Descent -194 /FontName /SPBHNZ+CMR12 /ItalicAngle 0 /StemV 65 /XHeight 431 /FontBBox [-34 -251 988 750] /Flags 4 /CharSet (/ff/fi/parenleft/parenright/asterisk/comma/hyphen/period/one/two/A/B/C/D/E/F/I/L/M/N/O/P/R/S/T/U/V/X/a/b/c/d/e/f/g/h/i/l/m/n/o/p/q/r/s/t/u/v/w/x/y) /FontFile 12 0 R >> endobj 221 0 obj [571 544 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 381 381 490 0 272 326 272 0 0 490 490 0 0 0 0 0 0 0 0 0 0 0 0 0 0 734 693 707 748 666 639 0 0 353 0 0 612 897 734 762 666 0 721 544 707 734 734 0 734 0 0 0 0 0 0 0 0 490 544 435 544 435 299 490 544 272 0 0 272 816 544 490 544 517 381 386 381 544 517 707 517 517 ] endobj 5 0 obj << /Length1 1424 /Length2 7770 /Length3 532 /Length 8613 /Filter /FlateDecode >> stream xe\\Bp'5,C` kp .=q~ު֪z6%(qs dT\율tt2@3W,k p qܬܜ.~a^a>^T: dm `ak@ 0T\mP 3{tbH4z t:-Q W9F+" WC@gh(#4$XP9T!P/ 4P).foj߻_f {qpts:T @gN+4l]AR`k{ _%<hrXٻmWSg~=nj{9#쿙7Cw x}?Kz ff^Г%>z`+tKVgԿ 8ߵ!7A /]p8B]p@*R * 2I!rTU78TS7A5U~TS7A5!Ao.^7A~/C7AW A7TG O܀)=KU-ܜ`׿fЋoA9 @]Xڦ6L!0H[7ūuOw4ļRWC@1&it'ûTv56#X4D^%qz/Ia9g2OX /b02K۹r悰I[t7e>f&l9r=[.N7!(Xg` 3ݏj3 ȧ/;SĜn:SpcrBqNv0Id>ڛXT@@qXgs7Z2o'.;1]Xs rcmFb;7:P29R$~@_PMv9D%qO Ot 0^#Rv e~vqr%hG)4T#_UH0XygYCaBiM߉?(b)cEs@Yyq"HyÀ{_HOy>jqHI32uW܆uS%k$Yt|iV 8Y)folFЇ)vx*[WI6[)fnXnԁ, lUsƗVѾ'9,#3_<徊Q|9&|G>ϧgM^4̻̚\dnB#9تb\ыP^G`Dr!$$3К+.Hca6}˄b.31w݇' y );DR587 7inP@3~G$uK634돥fK )hSۘ37,ГyGvD3oD:ֈ9ʝڍ1&@}[JeeqyX]2abz~>v+ 7|11GP|ʬWDU~YI=mwtF(k%-އ5 ڄNGu)W}JS=6]u$Jn>ωXҒ}Cw|uW9r8acrEgaUk-ٚ >фW+[W#OeO{||~IJK͈4Vi֙4X;r\/&tz^Zx^oZv?ckѱ3:˯U8MViIXp]4{ ݁UjJ >Ԁt etEX+w75&K˥8?Ydf[S~y\gwz)D좕[#AI?ݨsB[PYI-١iv(,.&V@ Ra6 czIxKos$[z|K4/v0O\+1mW`+]*T-x)3FƊ/:,0*W:uf^}^HL#s3:<#MPyRnbH NW\;5 fuڅ!$I. flIvs%4Z@Ht"6$&eİ>7ĶYv>(b/G{O'|<TqV_:epi 3v)7f" "%f7"[A'Ê)mjc'^f}E]<LyVeӠAM" %аnZVlY!WK[TnOU;ս4_wׇA nJ+b- O_-[|&H-K j;9LN0*6:R&hAN%+T">Ɂ7 ܱLykGmUY ۠asj,r"+-5RAЎ˩Gx Q0W" d?+^OAf9U֕tKIc#Mmk2V"ƨ^mSX`V[8[)4^8cXRYP`a#NC xqwap8_|=&Ĺ/އXgH;?:*+=CHp0A\"jp6 &J1nZ쇓[h\Jr>l3FSͼkU\12_eAKW\D!~ /j^M|l<ˮ+Eۛc$a*#>7-mTʇnǨȅ"I52Qx<{q+ ̼:2_5+teoK.+x+m4h-NGuSsd^H*hhO38BU66J7}qאk~uM^ pʽ7cK`SCeoU&GϰΟkj[YC fHB+'wLt]Y꼄Q6T1N1-4n>v[<aD٩+=}+~VUYl_ TT/IcAJ6^^Y +n֑TBAѤH޸}>7wY^K!Ї Ҵ=)'A2h0J w [f%4m1Q~jhQLjq`jo GZa#ar(ĺ2iz^ ]qﴌ؊̝EeDBBiW5̖q!މCdz,ma>/,NW$ :#m+Y.9G_jjfqՔT(ROOFGMP!H<|Z@2Pķv{/Cht7+^R[0#=C{['A/² ڜ3n 9ڲʱ(9Sᬀsz ;ԇ0U%fZěq?fY0x4E޸j%4mr#1A݁.a[l l~p4t>-ː0PB]%IW̻HL?x7[pCWCL$DH r!+/ 9; kl|mId#MOJ^ &N {і9&ֱ&꭪y Zyrz?l>=]nyϵgGh\F5˴3`iX3.bpC;V L;Pi30s xk$XcnŠ'}~sCS-PX)U) /@ٳ@mV/ lջvrܒAy&.! 0[ᯯ*=/^b]T]MfחEMvWIo -qy%.d5?YcFD b%v*ͻ7\!nVz,iyܶ-|>VЕiN^ 7fAECsq@ͼѻG,225wTaD<~ֆ<UebR `˒u#qJ%4i{~BUHo\a(o"^;v6sy^F6'mID:QTuk}^;=}f.ro^3ۥU|l)]i $cHuvE['iј`=5E Gσ[re/ٸZZ{eDN#cTjDZ9'Zi KVv||L! ޭ Xo+B*{}kiي6E{5b1N5+G4 +ůi$#DŻؤ _Wʼn;9O.cĭJ\|s* ]gyUyJxτy]|i-rLMI%/kzHM7 Ⓢa说u:?*r>DƊ`GFK %m\\e+*}~KEN$7Cmno6j=mM'OYҖjRmB[X ׸V*=jQ5j,;tFNHY6n*).%9W N:wd?)af|>La39EGrQk*WWe;pS`HSVq[!vd Os74szVIyz c Wt `T.3umn5M!EؠqbO{~@aV-}!؋U VDY[G%^`YN&\F0(?hl}"V̪ =Ws0:G l5moS5"؎0HLZ U|= gm쨚R>9Yl$=J- `QLubm[%w}V.ir:RA+`B/K);Layw]s g$Fї@FRJYƣ0g:x\RVh/&.-m D0Đqciy SUd0jf |8 k:.zOd"3\dKEl;1!_EtVPz6v|PVGQ#s46P}U}J&1PsB5)쩪SᗙNQ4exp%GWjm}W "jMWp_{HX0P)7U-~Bf~pxpahD1Mb| O! ?ǚ'Y)'{c/D7/Ή\nĔ ^=,"R[cQCDpUAx=ƵS^3jBG:lOZ$JldZgx>=νc8oK?#b$/վ Ty=Pu!f^b2g]P48~, Wfm3~ 6&hL.xr-..u瑂FK^℟ׄ ~XrCD$|(_.{*;lH#s&V9w 601@kjHK|7HBOJi>l{Y:5r%vs;\ACg!wwoo֔8qџ Y^/̣hk.\Ű43ڧs%䋋9? WjE\1\#Wڐ%.ҝr CKD,y۵IݷoZ8/Bea#}-*3+a^AbaoZpjTשYchUWgx7נulҢ#(:)6w;2}מ*` y2(ba[%ј+wh#!=qMHñWyȫ_KWK^Sp$0zxt@b}{ g&0mIdVpy eeG6*ˀ+WtCeN.SBb1GDb2DRu.OiGL-N#ߨl6 ^aުF? g7p|Et>M+]QＶkV+O8TE=CvTUm :ኩ:`вzfѤHl ޘ:_m}ѩr^pŒ? u(VD8G*iO̥!:;'?M#'7iSOeg+覙஛dsz:YJLaV416`VÏk[˚iLjnئ=R'h}5xQܙgHO/Sk/7=8JpY͘Ns|RC2ž9]̑՝"2G<1fVu\d-Ӈ޷\D=/z IG;#<^͘zqZoXSζ=SڨE>6z_ј8jKGoN÷D]^I_>xCI^jxT-3<1.+g*(\h>10 )0_m =bY^`dϓ qMVW a f,px`yAcu?G 0G:pBz9*N/a"Qw>egcqs2ڪO!'!D𪲟NtaXֱHJ}(YM7Ac^c AG]tOdB^O܊\`bbX?Š鵝RmWN~LXr `gY9>RL.`Ќ5.`V6oMOۯ7XAJF˗fQNI܀Ձ대d}~KHVmy<:r݄Z+b]ulç>%@d>!F; /3O,=:W 6n %{r"6~=O0AIJUBh q0sC_>Lxendstream endobj 6 0 obj << /Type /Font /Subtype /Type1 /Encoding 215 0 R /FirstChar 11 /LastChar 121 /Widths 222 0 R /BaseFont /FICWPX+CMBX12 /FontDescriptor 4 0 R >> endobj 4 0 obj << /Ascent 694 /CapHeight 686 /Descent -194 /FontName /FICWPX+CMBX12 /ItalicAngle 0 /StemV 109 /XHeight 444 /FontBBox [-53 -251 1139 750] /Flags 4 /CharSet (/ff/fi/hyphen/period/one/two/A/B/C/D/E/F/I/L/M/N/O/P/R/S/T/U/V/X/a/b/c/d/e/f/g/h/i/l/m/n/o/p/r/s/t/u/v/w/x/y) /FontFile 5 0 R >> endobj 222 0 obj [656 625 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 375 313 0 0 563 563 0 0 0 0 0 0 0 0 0 0 0 0 0 0 850 800 813 862 738 707 0 0 419 0 0 676 1067 880 845 769 0 839 625 782 865 850 0 850 0 0 0 0 0 0 0 0 547 625 500 625 513 344 563 625 313 0 0 313 938 625 563 625 0 459 444 438 625 594 813 594 594 ] endobj 7 0 obj << /Type /Pages /Count 6 /Parent 223 0 R /Kids [2 0 R 9 0 R 27 0 R 30 0 R 39 0 R 45 0 R] >> endobj 53 0 obj << /Type /Pages /Count 6 /Parent 223 0 R /Kids [48 0 R 55 0 R 58 0 R 61 0 R 64 0 R 67 0 R] >> endobj 72 0 obj << /Type /Pages /Count 6 /Parent 223 0 R /Kids [70 0 R 74 0 R 77 0 R 80 0 R 83 0 R 86 0 R] >> endobj 91 0 obj << /Type /Pages /Count 6 /Parent 223 0 R /Kids [89 0 R 93 0 R 96 0 R 99 0 R 102 0 R 105 0 R] >> endobj 110 0 obj << /Type /Pages /Count 6 /Parent 223 0 R /Kids [108 0 R 112 0 R 115 0 R 118 0 R 121 0 R 124 0 R] >> endobj 129 0 obj << /Type /Pages /Count 6 /Parent 223 0 R /Kids [127 0 R 131 0 R 134 0 R 137 0 R 140 0 R 143 0 R] >> endobj 148 0 obj << /Type /Pages /Count 6 /Parent 224 0 R /Kids [146 0 R 150 0 R 153 0 R 156 0 R 159 0 R 162 0 R] >> endobj 167 0 obj << /Type /Pages /Count 6 /Parent 224 0 R /Kids [165 0 R 169 0 R 172 0 R 175 0 R 178 0 R 181 0 R] >> endobj 186 0 obj << /Type /Pages /Count 6 /Parent 224 0 R /Kids [184 0 R 188 0 R 191 0 R 194 0 R 197 0 R 200 0 R] >> endobj 205 0 obj << /Type /Pages /Count 2 /Parent 224 0 R /Kids [203 0 R 207 0 R] >> endobj 223 0 obj << /Type /Pages /Count 36 /Parent 225 0 R /Kids [7 0 R 53 0 R 72 0 R 91 0 R 110 0 R 129 0 R] >> endobj 224 0 obj << /Type /Pages /Count 20 /Parent 225 0 R /Kids [148 0 R 167 0 R 186 0 R 205 0 R] >> endobj 225 0 obj << /Type /Pages /Count 56 /Kids [223 0 R 224 0 R] >> endobj 226 0 obj << /Type /Catalog /Pages 225 0 R /PTEX.Fullbanner (This is pdfTeX, Version 3.14159-1.10b) >> endobj 227 0 obj << /Producer (pdfTeX-1.10b) /Creator (TeX) /CreationDate (D:20060704165800) >> endobj xref 0 228 0000000000 65535 f 0000000270 00000 n 0000000159 00000 n 0000000009 00000 n 0000235422 00000 n 0000226532 00000 n 0000235264 00000 n 0000236058 00000 n 0000001385 00000 n 0000001273 00000 n 0000000338 00000 n 0000225850 00000 n 0000215596 00000 n 0000225691 00000 n 0000214908 00000 n 0000203342 00000 n 0000214748 00000 n 0000202477 00000 n 0000186927 00000 n 0000202318 00000 n 0000186278 00000 n 0000173976 00000 n 0000186118 00000 n 0000173493 00000 n 0000168908 00000 n 0000173334 00000 n 0000002240 00000 n 0000002126 00000 n 0000001512 00000 n 0000004359 00000 n 0000004245 00000 n 0000002345 00000 n 0000168591 00000 n 0000165004 00000 n 0000168433 00000 n 0000163393 00000 n 0000152515 00000 n 0000163233 00000 n 0000006709 00000 n 0000006595 00000 n 0000004487 00000 n 0000151270 00000 n 0000149866 00000 n 0000151111 00000 n 0000007498 00000 n 0000007384 00000 n 0000006825 00000 n 0000010308 00000 n 0000010193 00000 n 0000007614 00000 n 0000147795 00000 n 0000141448 00000 n 0000147635 00000 n 0000236165 00000 n 0000013151 00000 n 0000013036 00000 n 0000010448 00000 n 0000016297 00000 n 0000016182 00000 n 0000013256 00000 n 0000018816 00000 n 0000018701 00000 n 0000016437 00000 n 0000021187 00000 n 0000021072 00000 n 0000018980 00000 n 0000023538 00000 n 0000023423 00000 n 0000021351 00000 n 0000025960 00000 n 0000025845 00000 n 0000023690 00000 n 0000236275 00000 n 0000029029 00000 n 0000028914 00000 n 0000026112 00000 n 0000031955 00000 n 0000031840 00000 n 0000029181 00000 n 0000034848 00000 n 0000034733 00000 n 0000032107 00000 n 0000037548 00000 n 0000037433 00000 n 0000035012 00000 n 0000040388 00000 n 0000040273 00000 n 0000037712 00000 n 0000043087 00000 n 0000042972 00000 n 0000040552 00000 n 0000236385 00000 n 0000045630 00000 n 0000045515 00000 n 0000043251 00000 n 0000048037 00000 n 0000047922 00000 n 0000045794 00000 n 0000050343 00000 n 0000050227 00000 n 0000048201 00000 n 0000052306 00000 n 0000052188 00000 n 0000050448 00000 n 0000055163 00000 n 0000055045 00000 n 0000052412 00000 n 0000058022 00000 n 0000057903 00000 n 0000055316 00000 n 0000236497 00000 n 0000061158 00000 n 0000061039 00000 n 0000058187 00000 n 0000063925 00000 n 0000063806 00000 n 0000061323 00000 n 0000066429 00000 n 0000066310 00000 n 0000064090 00000 n 0000069590 00000 n 0000069471 00000 n 0000066582 00000 n 0000072500 00000 n 0000072381 00000 n 0000069755 00000 n 0000075572 00000 n 0000075453 00000 n 0000072665 00000 n 0000236614 00000 n 0000078471 00000 n 0000078352 00000 n 0000075737 00000 n 0000081620 00000 n 0000081501 00000 n 0000078624 00000 n 0000084223 00000 n 0000084104 00000 n 0000081785 00000 n 0000087120 00000 n 0000087001 00000 n 0000084329 00000 n 0000089397 00000 n 0000089278 00000 n 0000087273 00000 n 0000091891 00000 n 0000091772 00000 n 0000089550 00000 n 0000236731 00000 n 0000094915 00000 n 0000094796 00000 n 0000092056 00000 n 0000097816 00000 n 0000097697 00000 n 0000095080 00000 n 0000100845 00000 n 0000100726 00000 n 0000097981 00000 n 0000103283 00000 n 0000103164 00000 n 0000101010 00000 n 0000106534 00000 n 0000106415 00000 n 0000103448 00000 n 0000109213 00000 n 0000109094 00000 n 0000106699 00000 n 0000236848 00000 n 0000111405 00000 n 0000111286 00000 n 0000109366 00000 n 0000113896 00000 n 0000113777 00000 n 0000111546 00000 n 0000116324 00000 n 0000116205 00000 n 0000114037 00000 n 0000118440 00000 n 0000118321 00000 n 0000116477 00000 n 0000121116 00000 n 0000120997 00000 n 0000118593 00000 n 0000123870 00000 n 0000123751 00000 n 0000121269 00000 n 0000236965 00000 n 0000125758 00000 n 0000125639 00000 n 0000124035 00000 n 0000128276 00000 n 0000128157 00000 n 0000125911 00000 n 0000130849 00000 n 0000130730 00000 n 0000128405 00000 n 0000133542 00000 n 0000133423 00000 n 0000131002 00000 n 0000136336 00000 n 0000136217 00000 n 0000133695 00000 n 0000138705 00000 n 0000138586 00000 n 0000136501 00000 n 0000237082 00000 n 0000140347 00000 n 0000140228 00000 n 0000138870 00000 n 0000140500 00000 n 0000148037 00000 n 0000148209 00000 n 0000151473 00000 n 0000151497 00000 n 0000163754 00000 n 0000164058 00000 n 0000168842 00000 n 0000173752 00000 n 0000186587 00000 n 0000202947 00000 n 0000215247 00000 n 0000226188 00000 n 0000235723 00000 n 0000237167 00000 n 0000237280 00000 n 0000237382 00000 n 0000237452 00000 n 0000237562 00000 n trailer << /Size 228 /Root 226 0 R /Info 227 0 R >> startxref 237658 %%EOF pupnp-release-1.8.0/docs/dist/Makefile.am000066400000000000000000000557231303304015100202310ustar00rootroot00000000000000 EXTRA_DIST = \ ./UPnP_Programming_Guide.pdf \ ./IXML_Programming_Guide.pdf \ ./html/upnp/icon1.gif \ ./html/upnp/icon2.gif \ ./html/upnp/toc.html \ ./html/upnp/General.html \ ./html/upnp/index.html \ ./html/upnp/Introduction.html \ ./html/upnp/License.html \ ./html/upnp/AboutCallbacks.html \ ./html/upnp/TheAPI.html \ ./html/upnp/Errorcodes.html \ ./html/upnp/UPNP_E_SUCCESS0.html \ ./html/upnp/UPNP_E_INVALID_HANDLE-100.html \ ./html/upnp/UPNP_E_INVALID_PARAM-101.html \ ./html/upnp/UPNP_E_OUTOF_HANDLE-102.html \ ./html/upnp/UPNP_E_OUTOF_MEMORY-104.html \ ./html/upnp/UPNP_E_INIT-105.html \ ./html/upnp/UPNP_E_INVALID_DESC-107.html \ ./html/upnp/UPNP_E_INVALID_URL-108.html \ ./html/upnp/UPNP_E_INVALID_SERVICE-111.html \ ./html/upnp/UPNP_E_BAD_RESPONSE-113.html \ ./html/upnp/UPNP_E_INVALID_ACTION-115.html \ ./html/upnp/UPNP_E_FINISH-116.html \ ./html/upnp/UPNP_E_INIT_FAILED-117.html \ ./html/upnp/UPNP_E_BAD_HTTPMSG-119.html \ ./html/upnp/UPNP_E_ALREADY_REGISTERED-120.html \ ./html/upnp/UPNP_E_NETWORK_ERROR-200.html \ ./html/upnp/UPNP_E_SOCKET_WRITE-201.html \ ./html/upnp/UPNP_E_SOCKET_READ-202.html \ ./html/upnp/UPNP_E_SOCKET_BIND-203.html \ ./html/upnp/UPNP_E_SOCKET_CONNECT-204.html \ ./html/upnp/UPNP_E_OUTOF_SOCKET-205.html \ ./html/upnp/UPNP_E_LISTEN-206.html \ ./html/upnp/UPNP_E_TIMEDOUT-207.html \ ./html/upnp/UPNP_E_SOCKET_ERROR-208.html \ ./html/upnp/UPNP_E_CANCELED-210.html \ ./html/upnp/UPNP_E_SUBSCRIBE_UNACCEPTED-301.html \ ./html/upnp/UPNP_E_UNSUBSCRIBE_UNACCEPTED-302.html \ ./html/upnp/UPNP_E_NOTIFY_UNACCEPTED-303.html \ ./html/upnp/UPNP_E_INVALID_ARGUMENT-501.html \ ./html/upnp/UPNP_E_FILE_NOT_FOUND-502.html \ ./html/upnp/UPNP_E_FILE_READ_ERROR-503.html \ ./html/upnp/UPNP_E_EXT_NOT_XML-504.html \ ./html/upnp/UPNP_E_NOT_FOUND-507.html \ ./html/upnp/UPNP_E_INTERNAL_ERROR-911.html \ ./html/upnp/ConstantsStructuresandTypes.html \ ./html/upnp/UpnpClient_Handle.html \ ./html/upnp/UpnpDevice_Handle.html \ ./html/upnp/UPnP_EventType.html \ ./html/upnp/UPNP_CONTROL_ACTION_REQUEST.html \ ./html/upnp/UPNP_CONTROL_ACTION_COMPLETE.html \ ./html/upnp/UPNP_CONTROL_GET_VAR_REQUEST.html \ ./html/upnp/UPNP_CONTROL_GET_VAR_COMPLETE.html \ ./html/upnp/UPNP_DISCOVERY_ADVERTISEMENT_ALIVE.html \ ./html/upnp/UPNP_DISCOVERY_ADVERTISEMENT_BYEBYE.html \ ./html/upnp/UPNP_DISCOVERY_SEARCH_RESULT.html \ ./html/upnp/UPNP_DISCOVERY_SEARCH_TIMEOUT.html \ ./html/upnp/UPNP_EVENT_SUBSCRIPTION_REQUEST.html \ ./html/upnp/UPNP_EVENT_RECEIVED.html \ ./html/upnp/UPNP_EVENT_RENEWAL_COMPLETE.html \ ./html/upnp/UPNP_EVENT_SUBSCRIBE_COMPLETE.html \ ./html/upnp/UPNP_EVENT_UNSUBSCRIBE_COMPLETE.html \ ./html/upnp/UPNP_EVENT_AUTORENEWAL_FAILED.html \ ./html/upnp/UPNP_EVENT_SUBSCRIPTION_EXPIRED.html \ ./html/upnp/Upnp_SID44.html \ ./html/upnp/Upnp_SType.html \ ./html/upnp/UPNP_S_ALL.html \ ./html/upnp/UPNP_S_ROOT.html \ ./html/upnp/UPNP_S_DEVICE.html \ ./html/upnp/UPNP_S_SERVICE.html \ ./html/upnp/Upnp_DescType.html \ ./html/upnp/UPNPREG_URL_DESC.html \ ./html/upnp/UPNPREG_FILENAME_DESC.html \ ./html/upnp/UPNPREG_BUF_DESC.html \ ./html/upnp/Upnp_Action_Request.html \ ./html/upnp/Upnp_State_Var_Request.html \ ./html/upnp/Upnp_State_Var_Complete.html \ ./html/upnp/Upnp_Event.html \ ./html/upnp/Upnp_Discovery.html \ ./html/upnp/Upnp_Event_Subscribe.html \ ./html/upnp/Upnp_Subscription_Request.html \ ./html/upnp/UpnpVirtualDirCallbacks.html \ ./html/upnp/Upnp_FunPtr.html \ ./html/upnp/InitializationandRegistration.html \ ./html/upnp/UpnpInit.html \ ./html/upnp/UpnpFinish.html \ ./html/upnp/UpnpGetServerPort.html \ ./html/upnp/UpnpGetServerIpAddress.html \ ./html/upnp/UpnpRegisterClient.html \ ./html/upnp/UpnpRegisterRootDevice.html \ ./html/upnp/UpnpRegisterRootDevice2.html \ ./html/upnp/UpnpUnRegisterClient.html \ ./html/upnp/UpnpUnRegisterRootDevice.html \ ./html/upnp/UpnpSetContentLength.html \ ./html/upnp/UpnpSetMaxContentLength.html \ ./html/upnp/Discovery.html \ ./html/upnp/UpnpSearchAsync.html \ ./html/upnp/UpnpSendAdvertisement.html \ ./html/upnp/Control.html \ ./html/upnp/UpnpGetServiceVarStatus.html \ ./html/upnp/UpnpGetServiceVarStatusAsync.html \ ./html/upnp/UpnpSendAction.html \ ./html/upnp/UpnpSendActionEx.html \ ./html/upnp/UpnpSendActionAsync.html \ ./html/upnp/UpnpSendActionExAsync.html \ ./html/upnp/Eventing.html \ ./html/upnp/UpnpAcceptSubscription.html \ ./html/upnp/UpnpAcceptSubscriptionExt.html \ ./html/upnp/UpnpNotify.html \ ./html/upnp/UpnpNotifyExt.html \ ./html/upnp/UpnpRenewSubscription.html \ ./html/upnp/UpnpRenewSubscriptionAsync.html \ ./html/upnp/UpnpSetMaxSubscriptions.html \ ./html/upnp/UpnpSetMaxSubscriptionTimeOut.html \ ./html/upnp/UpnpSubscribe.html \ ./html/upnp/UpnpSubscribeAsync.html \ ./html/upnp/UpnpUnSubscribe.html \ ./html/upnp/UpnpUnSubscribeAsync.html \ ./html/upnp/ControlPointHTTPAPI.html \ ./html/upnp/UpnpDownloadUrlItem.html \ ./html/upnp/UpnpOpenHttpGet.html \ ./html/upnp/UpnpOpenHttpGetProxy.html \ ./html/upnp/UpnpOpenHttpGetEx.html \ ./html/upnp/UpnpReadHttpGet.html \ ./html/upnp/UpnpHttpGetProgress.html \ ./html/upnp/UpnpCancelHttpGet.html \ ./html/upnp/UpnpCloseHttpGet.html \ ./html/upnp/UpnpOpenHttpPost.html \ ./html/upnp/UpnpWriteHttpPost.html \ ./html/upnp/UpnpCloseHttpPost.html \ ./html/upnp/UpnpDownloadXmlDoc.html \ ./html/upnp/WebServerAPI.html \ ./html/upnp/UpnpSetWebServerRootDir.html \ ./html/upnp/UpnpSetVirtualDirCallbacks.html \ ./html/upnp/UpnpEnableWebserver.html \ ./html/upnp/UpnpIsWebserverEnabled.html \ ./html/upnp/UpnpAddVirtualDir.html \ ./html/upnp/UpnpRemoveVirtualDir.html \ ./html/upnp/UpnpRemoveAllVirtualDirs.html \ ./html/upnp/OptionalToolAPIs.html \ ./html/upnp/UpnpResolveURL.html \ ./html/upnp/UpnpMakeAction.html \ ./html/upnp/UpnpAddToAction.html \ ./html/upnp/UpnpMakeActionResponse.html \ ./html/upnp/UpnpAddToActionResponse.html \ ./html/upnp/UpnpAddToPropertySet.html \ ./html/upnp/UpnpCreatePropertySet.html \ ./html/upnp/UpnpGetErrorMessage.html \ ./html/ixml/icon1.gif \ ./html/ixml/icon2.gif \ ./html/ixml/toc.html \ ./html/ixml/General.html \ ./html/ixml/index.html \ ./html/ixml/Introduction.html \ ./html/ixml/License.html \ ./html/ixml/DOMInterfaces.html \ ./html/ixml/InterfaceitNode.html \ ./html/ixml/ixmlNode_getNodeName.html \ ./html/ixml/ixmlNode_getNodeValue.html \ ./html/ixml/ixmlNode_setNodeValue.html \ ./html/ixml/ixmlNode_getNodeType.html \ ./html/ixml/ixmlNode_getParentNode.html \ ./html/ixml/ixmlNode_getChildNodes.html \ ./html/ixml/ixmlNode_getFirstChild.html \ ./html/ixml/ixmlNode_getLastChild.html \ ./html/ixml/ixmlNode_getPreviousSibling.html \ ./html/ixml/ixmlNode_getNextSibling.html \ ./html/ixml/ixmlNode_getAttributes.html \ ./html/ixml/ixmlNode_getOwnerDocument.html \ ./html/ixml/ixmlNode_getNamespaceURI.html \ ./html/ixml/ixmlNode_getPrefix.html \ ./html/ixml/ixmlNode_getLocalName.html \ ./html/ixml/ixmlNode_insertBefore.html \ ./html/ixml/ixmlNode_replaceChild.html \ ./html/ixml/ixmlNode_removeChild.html \ ./html/ixml/ixmlNode_appendChild.html \ ./html/ixml/ixmlNode_hasChildNodes.html \ ./html/ixml/ixmlNode_cloneNode.html \ ./html/ixml/ixmlNode_hasAttributes.html \ ./html/ixml/ixmlNode_free.html \ ./html/ixml/InterfaceitAttr.html \ ./html/ixml/ixmlAttr_free.html \ ./html/ixml/InterfaceitCDATASection.html \ ./html/ixml/ixmlCDATASection_init.html \ ./html/ixml/ixmlCDATASection_free.html \ ./html/ixml/InterfaceitDocument.html \ ./html/ixml/ixmlDocument_init.html \ ./html/ixml/ixmlDocument_createDocumentEx.html \ ./html/ixml/ixmlDocument_createDocument.html \ ./html/ixml/ixmlDocument_createElementEx.html \ ./html/ixml/ixmlDocument_createElement.html \ ./html/ixml/ixmlDocument_createTextNodeEx.html \ ./html/ixml/ixmlDocument_createTextNode.html \ ./html/ixml/ixmlDocument_createCDATASectionEx.html \ ./html/ixml/ixmlDocument_createCDATASection.html \ ./html/ixml/ixmlDocument_createAttribute.html \ ./html/ixml/ixmlDocument_createAttributeEx.html \ ./html/ixml/ixmlDocument_getElementsByTagName.html \ ./html/ixml/ixmlDocument_createElementNSEx.html \ ./html/ixml/ixmlDocument_createElementNS.html \ ./html/ixml/ixmlDocument_createAttributeNSEx.html \ ./html/ixml/ixmlDocument_createAttributeNS.html \ ./html/ixml/ixmlDocument_getElementsByTagNameNS.html \ ./html/ixml/ixmlDocument_getElementById.html \ ./html/ixml/ixmlDocument_free.html \ ./html/ixml/ixmlDocument_importNode.html \ ./html/ixml/InterfaceitElement.html \ ./html/ixml/ixmlElement_init.html \ ./html/ixml/ixmlElement_getTagName.html \ ./html/ixml/ixmlElement_getAttribute.html \ ./html/ixml/ixmlElement_setAttribute.html \ ./html/ixml/ixmlElement_removeAttribute.html \ ./html/ixml/ixmlElement_getAttributeNode.html \ ./html/ixml/ixmlElement_setAttributeNode.html \ ./html/ixml/ixmlElement_removeAttributeNode.html \ ./html/ixml/ixmlElement_getElementsByTagName.html \ ./html/ixml/ixmlElement_getAttributeNS.html \ ./html/ixml/ixmlElement_setAttributeNS.html \ ./html/ixml/ixmlElement_removeAttributeNS.html \ ./html/ixml/ixmlElement_getAttributeNodeNS.html \ ./html/ixml/ixmlElement_setAttributeNodeNS.html \ ./html/ixml/ixmlElement_getElementsByTagNameNS.html \ ./html/ixml/ixmlElement_hasAttribute.html \ ./html/ixml/ixmlElement_hasAttributeNS.html \ ./html/ixml/ixmlElement_free.html \ ./html/ixml/InterfaceitNamedNodeMap.html \ ./html/ixml/ixmlNamedNodeMap_getLength.html \ ./html/ixml/ixmlNamedNodeMap_getNamedItem.html \ ./html/ixml/ixmlNamedNodeMap_setNamedItem.html \ ./html/ixml/ixmlNamedNodeMap_removeNamedItem.html \ ./html/ixml/ixmlNamedNodeMap_item.html \ ./html/ixml/ixmlNamedNodeMap_getNamedItemNS.html \ ./html/ixml/ixmlNamedNodeMap_setNamedItemNS.html \ ./html/ixml/ixmlNamedNodeMap_removeNamedItemNS.html \ ./html/ixml/ixmlNamedNodeMap_free.html \ ./html/ixml/InterfaceitNodeList.html \ ./html/ixml/ixmlNodeList_item.html \ ./html/ixml/ixmlNodeList_length.html \ ./html/ixml/ixmlNodeList_free.html \ ./html/ixml/IXMLAPI.html \ ./html/ixml/ixmlPrintDocument.html \ ./html/ixml/ixmlPrintNode.html \ ./html/ixml/ixmlDocumenttoString.html \ ./html/ixml/ixmlNodetoString.html \ ./html/ixml/ixmlRelaxParser.html \ ./html/ixml/ixmlParseBuffer.html \ ./html/ixml/ixmlParseBufferEx.html \ ./html/ixml/ixmlLoadDocument.html \ ./html/ixml/ixmlLoadDocumentEx.html \ ./html/ixml/ixmlCloneDOMString.html \ ./html/ixml/ixmlFreeDOMString.html if WITH_DOCUMENTATION docsdir = @docdir@ nobase_docs_DATA = \ ./UPnP_Programming_Guide.pdf \ ./IXML_Programming_Guide.pdf \ ./html/upnp/icon1.gif \ ./html/upnp/icon2.gif \ ./html/upnp/toc.html \ ./html/upnp/General.html \ ./html/upnp/index.html \ ./html/upnp/Introduction.html \ ./html/upnp/License.html \ ./html/upnp/AboutCallbacks.html \ ./html/upnp/TheAPI.html \ ./html/upnp/Errorcodes.html \ ./html/upnp/UPNP_E_SUCCESS0.html \ ./html/upnp/UPNP_E_INVALID_HANDLE-100.html \ ./html/upnp/UPNP_E_INVALID_PARAM-101.html \ ./html/upnp/UPNP_E_OUTOF_HANDLE-102.html \ ./html/upnp/UPNP_E_OUTOF_MEMORY-104.html \ ./html/upnp/UPNP_E_INIT-105.html \ ./html/upnp/UPNP_E_INVALID_DESC-107.html \ ./html/upnp/UPNP_E_INVALID_URL-108.html \ ./html/upnp/UPNP_E_INVALID_SERVICE-111.html \ ./html/upnp/UPNP_E_BAD_RESPONSE-113.html \ ./html/upnp/UPNP_E_INVALID_ACTION-115.html \ ./html/upnp/UPNP_E_FINISH-116.html \ ./html/upnp/UPNP_E_INIT_FAILED-117.html \ ./html/upnp/UPNP_E_BAD_HTTPMSG-119.html \ ./html/upnp/UPNP_E_ALREADY_REGISTERED-120.html \ ./html/upnp/UPNP_E_NETWORK_ERROR-200.html \ ./html/upnp/UPNP_E_SOCKET_WRITE-201.html \ ./html/upnp/UPNP_E_SOCKET_READ-202.html \ ./html/upnp/UPNP_E_SOCKET_BIND-203.html \ ./html/upnp/UPNP_E_SOCKET_CONNECT-204.html \ ./html/upnp/UPNP_E_OUTOF_SOCKET-205.html \ ./html/upnp/UPNP_E_LISTEN-206.html \ ./html/upnp/UPNP_E_TIMEDOUT-207.html \ ./html/upnp/UPNP_E_SOCKET_ERROR-208.html \ ./html/upnp/UPNP_E_CANCELED-210.html \ ./html/upnp/UPNP_E_SUBSCRIBE_UNACCEPTED-301.html \ ./html/upnp/UPNP_E_UNSUBSCRIBE_UNACCEPTED-302.html \ ./html/upnp/UPNP_E_NOTIFY_UNACCEPTED-303.html \ ./html/upnp/UPNP_E_INVALID_ARGUMENT-501.html \ ./html/upnp/UPNP_E_FILE_NOT_FOUND-502.html \ ./html/upnp/UPNP_E_FILE_READ_ERROR-503.html \ ./html/upnp/UPNP_E_EXT_NOT_XML-504.html \ ./html/upnp/UPNP_E_NOT_FOUND-507.html \ ./html/upnp/UPNP_E_INTERNAL_ERROR-911.html \ ./html/upnp/ConstantsStructuresandTypes.html \ ./html/upnp/UpnpClient_Handle.html \ ./html/upnp/UpnpDevice_Handle.html \ ./html/upnp/UPnP_EventType.html \ ./html/upnp/UPNP_CONTROL_ACTION_REQUEST.html \ ./html/upnp/UPNP_CONTROL_ACTION_COMPLETE.html \ ./html/upnp/UPNP_CONTROL_GET_VAR_REQUEST.html \ ./html/upnp/UPNP_CONTROL_GET_VAR_COMPLETE.html \ ./html/upnp/UPNP_DISCOVERY_ADVERTISEMENT_ALIVE.html \ ./html/upnp/UPNP_DISCOVERY_ADVERTISEMENT_BYEBYE.html \ ./html/upnp/UPNP_DISCOVERY_SEARCH_RESULT.html \ ./html/upnp/UPNP_DISCOVERY_SEARCH_TIMEOUT.html \ ./html/upnp/UPNP_EVENT_SUBSCRIPTION_REQUEST.html \ ./html/upnp/UPNP_EVENT_RECEIVED.html \ ./html/upnp/UPNP_EVENT_RENEWAL_COMPLETE.html \ ./html/upnp/UPNP_EVENT_SUBSCRIBE_COMPLETE.html \ ./html/upnp/UPNP_EVENT_UNSUBSCRIBE_COMPLETE.html \ ./html/upnp/UPNP_EVENT_AUTORENEWAL_FAILED.html \ ./html/upnp/UPNP_EVENT_SUBSCRIPTION_EXPIRED.html \ ./html/upnp/Upnp_SID44.html \ ./html/upnp/Upnp_SType.html \ ./html/upnp/UPNP_S_ALL.html \ ./html/upnp/UPNP_S_ROOT.html \ ./html/upnp/UPNP_S_DEVICE.html \ ./html/upnp/UPNP_S_SERVICE.html \ ./html/upnp/Upnp_DescType.html \ ./html/upnp/UPNPREG_URL_DESC.html \ ./html/upnp/UPNPREG_FILENAME_DESC.html \ ./html/upnp/UPNPREG_BUF_DESC.html \ ./html/upnp/Upnp_Action_Request.html \ ./html/upnp/Upnp_State_Var_Request.html \ ./html/upnp/Upnp_State_Var_Complete.html \ ./html/upnp/Upnp_Event.html \ ./html/upnp/Upnp_Discovery.html \ ./html/upnp/Upnp_Event_Subscribe.html \ ./html/upnp/Upnp_Subscription_Request.html \ ./html/upnp/UpnpVirtualDirCallbacks.html \ ./html/upnp/Upnp_FunPtr.html \ ./html/upnp/InitializationandRegistration.html \ ./html/upnp/UpnpInit.html \ ./html/upnp/UpnpFinish.html \ ./html/upnp/UpnpGetServerPort.html \ ./html/upnp/UpnpGetServerIpAddress.html \ ./html/upnp/UpnpRegisterClient.html \ ./html/upnp/UpnpRegisterRootDevice.html \ ./html/upnp/UpnpRegisterRootDevice2.html \ ./html/upnp/UpnpUnRegisterClient.html \ ./html/upnp/UpnpUnRegisterRootDevice.html \ ./html/upnp/UpnpSetContentLength.html \ ./html/upnp/UpnpSetMaxContentLength.html \ ./html/upnp/Discovery.html \ ./html/upnp/UpnpSearchAsync.html \ ./html/upnp/UpnpSendAdvertisement.html \ ./html/upnp/Control.html \ ./html/upnp/UpnpGetServiceVarStatus.html \ ./html/upnp/UpnpGetServiceVarStatusAsync.html \ ./html/upnp/UpnpSendAction.html \ ./html/upnp/UpnpSendActionEx.html \ ./html/upnp/UpnpSendActionAsync.html \ ./html/upnp/UpnpSendActionExAsync.html \ ./html/upnp/Eventing.html \ ./html/upnp/UpnpAcceptSubscription.html \ ./html/upnp/UpnpAcceptSubscriptionExt.html \ ./html/upnp/UpnpNotify.html \ ./html/upnp/UpnpNotifyExt.html \ ./html/upnp/UpnpRenewSubscription.html \ ./html/upnp/UpnpRenewSubscriptionAsync.html \ ./html/upnp/UpnpSetMaxSubscriptions.html \ ./html/upnp/UpnpSetMaxSubscriptionTimeOut.html \ ./html/upnp/UpnpSubscribe.html \ ./html/upnp/UpnpSubscribeAsync.html \ ./html/upnp/UpnpUnSubscribe.html \ ./html/upnp/UpnpUnSubscribeAsync.html \ ./html/upnp/ControlPointHTTPAPI.html \ ./html/upnp/UpnpDownloadUrlItem.html \ ./html/upnp/UpnpOpenHttpGet.html \ ./html/upnp/UpnpOpenHttpGetProxy.html \ ./html/upnp/UpnpOpenHttpGetEx.html \ ./html/upnp/UpnpReadHttpGet.html \ ./html/upnp/UpnpHttpGetProgress.html \ ./html/upnp/UpnpCancelHttpGet.html \ ./html/upnp/UpnpCloseHttpGet.html \ ./html/upnp/UpnpOpenHttpPost.html \ ./html/upnp/UpnpWriteHttpPost.html \ ./html/upnp/UpnpCloseHttpPost.html \ ./html/upnp/UpnpDownloadXmlDoc.html \ ./html/upnp/WebServerAPI.html \ ./html/upnp/UpnpSetWebServerRootDir.html \ ./html/upnp/UpnpSetVirtualDirCallbacks.html \ ./html/upnp/UpnpEnableWebserver.html \ ./html/upnp/UpnpIsWebserverEnabled.html \ ./html/upnp/UpnpAddVirtualDir.html \ ./html/upnp/UpnpRemoveVirtualDir.html \ ./html/upnp/UpnpRemoveAllVirtualDirs.html \ ./html/upnp/OptionalToolAPIs.html \ ./html/upnp/UpnpResolveURL.html \ ./html/upnp/UpnpMakeAction.html \ ./html/upnp/UpnpAddToAction.html \ ./html/upnp/UpnpMakeActionResponse.html \ ./html/upnp/UpnpAddToActionResponse.html \ ./html/upnp/UpnpAddToPropertySet.html \ ./html/upnp/UpnpCreatePropertySet.html \ ./html/upnp/UpnpGetErrorMessage.html \ ./html/ixml/icon1.gif \ ./html/ixml/icon2.gif \ ./html/ixml/toc.html \ ./html/ixml/General.html \ ./html/ixml/index.html \ ./html/ixml/Introduction.html \ ./html/ixml/License.html \ ./html/ixml/DOMInterfaces.html \ ./html/ixml/InterfaceitNode.html \ ./html/ixml/ixmlNode_getNodeName.html \ ./html/ixml/ixmlNode_getNodeValue.html \ ./html/ixml/ixmlNode_setNodeValue.html \ ./html/ixml/ixmlNode_getNodeType.html \ ./html/ixml/ixmlNode_getParentNode.html \ ./html/ixml/ixmlNode_getChildNodes.html \ ./html/ixml/ixmlNode_getFirstChild.html \ ./html/ixml/ixmlNode_getLastChild.html \ ./html/ixml/ixmlNode_getPreviousSibling.html \ ./html/ixml/ixmlNode_getNextSibling.html \ ./html/ixml/ixmlNode_getAttributes.html \ ./html/ixml/ixmlNode_getOwnerDocument.html \ ./html/ixml/ixmlNode_getNamespaceURI.html \ ./html/ixml/ixmlNode_getPrefix.html \ ./html/ixml/ixmlNode_getLocalName.html \ ./html/ixml/ixmlNode_insertBefore.html \ ./html/ixml/ixmlNode_replaceChild.html \ ./html/ixml/ixmlNode_removeChild.html \ ./html/ixml/ixmlNode_appendChild.html \ ./html/ixml/ixmlNode_hasChildNodes.html \ ./html/ixml/ixmlNode_cloneNode.html \ ./html/ixml/ixmlNode_hasAttributes.html \ ./html/ixml/ixmlNode_free.html \ ./html/ixml/InterfaceitAttr.html \ ./html/ixml/ixmlAttr_free.html \ ./html/ixml/InterfaceitCDATASection.html \ ./html/ixml/ixmlCDATASection_init.html \ ./html/ixml/ixmlCDATASection_free.html \ ./html/ixml/InterfaceitDocument.html \ ./html/ixml/ixmlDocument_init.html \ ./html/ixml/ixmlDocument_createDocumentEx.html \ ./html/ixml/ixmlDocument_createDocument.html \ ./html/ixml/ixmlDocument_createElementEx.html \ ./html/ixml/ixmlDocument_createElement.html \ ./html/ixml/ixmlDocument_createTextNodeEx.html \ ./html/ixml/ixmlDocument_createTextNode.html \ ./html/ixml/ixmlDocument_createCDATASectionEx.html \ ./html/ixml/ixmlDocument_createCDATASection.html \ ./html/ixml/ixmlDocument_createAttribute.html \ ./html/ixml/ixmlDocument_createAttributeEx.html \ ./html/ixml/ixmlDocument_getElementsByTagName.html \ ./html/ixml/ixmlDocument_createElementNSEx.html \ ./html/ixml/ixmlDocument_createElementNS.html \ ./html/ixml/ixmlDocument_createAttributeNSEx.html \ ./html/ixml/ixmlDocument_createAttributeNS.html \ ./html/ixml/ixmlDocument_getElementsByTagNameNS.html \ ./html/ixml/ixmlDocument_getElementById.html \ ./html/ixml/ixmlDocument_free.html \ ./html/ixml/ixmlDocument_importNode.html \ ./html/ixml/InterfaceitElement.html \ ./html/ixml/ixmlElement_init.html \ ./html/ixml/ixmlElement_getTagName.html \ ./html/ixml/ixmlElement_getAttribute.html \ ./html/ixml/ixmlElement_setAttribute.html \ ./html/ixml/ixmlElement_removeAttribute.html \ ./html/ixml/ixmlElement_getAttributeNode.html \ ./html/ixml/ixmlElement_setAttributeNode.html \ ./html/ixml/ixmlElement_removeAttributeNode.html \ ./html/ixml/ixmlElement_getElementsByTagName.html \ ./html/ixml/ixmlElement_getAttributeNS.html \ ./html/ixml/ixmlElement_setAttributeNS.html \ ./html/ixml/ixmlElement_removeAttributeNS.html \ ./html/ixml/ixmlElement_getAttributeNodeNS.html \ ./html/ixml/ixmlElement_setAttributeNodeNS.html \ ./html/ixml/ixmlElement_getElementsByTagNameNS.html \ ./html/ixml/ixmlElement_hasAttribute.html \ ./html/ixml/ixmlElement_hasAttributeNS.html \ ./html/ixml/ixmlElement_free.html \ ./html/ixml/InterfaceitNamedNodeMap.html \ ./html/ixml/ixmlNamedNodeMap_getLength.html \ ./html/ixml/ixmlNamedNodeMap_getNamedItem.html \ ./html/ixml/ixmlNamedNodeMap_setNamedItem.html \ ./html/ixml/ixmlNamedNodeMap_removeNamedItem.html \ ./html/ixml/ixmlNamedNodeMap_item.html \ ./html/ixml/ixmlNamedNodeMap_getNamedItemNS.html \ ./html/ixml/ixmlNamedNodeMap_setNamedItemNS.html \ ./html/ixml/ixmlNamedNodeMap_removeNamedItemNS.html \ ./html/ixml/ixmlNamedNodeMap_free.html \ ./html/ixml/InterfaceitNodeList.html \ ./html/ixml/ixmlNodeList_item.html \ ./html/ixml/ixmlNodeList_length.html \ ./html/ixml/ixmlNodeList_free.html \ ./html/ixml/IXMLAPI.html \ ./html/ixml/ixmlPrintDocument.html \ ./html/ixml/ixmlPrintNode.html \ ./html/ixml/ixmlDocumenttoString.html \ ./html/ixml/ixmlNodetoString.html \ ./html/ixml/ixmlRelaxParser.html \ ./html/ixml/ixmlParseBuffer.html \ ./html/ixml/ixmlParseBufferEx.html \ ./html/ixml/ixmlLoadDocument.html \ ./html/ixml/ixmlLoadDocumentEx.html \ ./html/ixml/ixmlCloneDOMString.html \ ./html/ixml/ixmlFreeDOMString.html endif pupnp-release-1.8.0/docs/dist/UPnP_Programming_Guide.pdf000066400000000000000000013250031303304015100231610ustar00rootroot00000000000000%PDF-1.4 3 0 obj << /Length 108 /Filter /FlateDecode >> stream xs w3T0230WIS4P0327UI446(561v0Ҁ2EvhHYcᢩkZҙ bC "z&!^\!\Cendstream endobj 2 0 obj << /Type /Page /Contents 3 0 R /Resources 1 0 R /MediaBox [0 0 595.276 841.89] /Parent 7 0 R >> endobj 1 0 obj << /Font << /F19 6 0 R >> /ProcSet [ /PDF /Text ] >> endobj 10 0 obj << /Length 4037 /Filter /FlateDecode >> stream x[s6)(MW(oj+˽L4ueǖ~=2EN0m}ĺ@G??pīׯ91FJzw=8=91-\\; ^w]ݸ'G#|ˏg[_M{G땴&P>+w{ǔ'/UBa V$h)RR! 3Ct_ã`׷AJR??䚘 #*y6rU>us~05c}O~l%2䤴U(*1I{iW -'r^;m92zkې556Qؚ==f?ؤߧa ݱِ^KaMZ*|}B(%\qޟ@psc3-!grp? %sǪ/?,[0TB%D J(KĉDJHA6ghnz̶9)M=u,sG ·!AKBKȇJ N1x:>v:JC_ٲZaX$2-[MDGQ6"If MAyPt@!c%Yh0Ƃb#R~DGJd*V \ 2Uh' :9 \evh|;rxWR=a Pp%7h!JgJa`&E.U |A,_7L\.TKs"Dpk\lAz @u*HL6I TeTAA`VAo!n$A4lPt(ruV"i䀪l 6!3e]2P6ΥTz Uif֪g_$PPAT4?_'B)q% >yڣk_tD\}H9*{$="NW#!?M)aiBo:I;$TTpH!9*$C"c@xRᄑT<"L n/Ȳ Ff.y!Iz! TB {!z5jZ@Ib8˃c%ܠO.#Pr' !=ǘLvI!TeTCեkbрxcu=SvO|fxGSh8I"TeT0Ez:b{bS)ڥ\Qֹ:Xr}rs@UM@FPvsKzc% Qघdoeڎ_&g7R EgȎx_$PgP3TjD$ v8z7hD@>ܖ v9ButЄ:#`EҎU9"A0(DkJEt6o>Njɼٝpx.)iu. f QxUHZ9*'#d#N#Waa>}d,)t2d,bd'GN0i73-zxfWA3a* ֦P$,PA)(dr>yH L#b`5i} {®T-i"-ZղҫAp30RlUDZ*DusŖ,  )cJlr7Ja;mo>`M6x38 Z4^k/VyJ EKYEK)>R7coNrI1O>*-{<#.u:V]3Uo' ^52 BRpi.CY,H>Tl0٩Y(B?3V<ȆOz{뾳QV#"i'怪 ^Rf́ܘ vڰ!^<*goT ReV WRu?_+HLKULu^DtGk}w7M)tu,!Jg~;(TMTkE;L4WXA.DP:V{X:Em o& Fwڅ\v47NoqNL ^羔۰:EuTo>ֿ|kӚH?q Z9cX+Yp8(Tf~I!kkV&ЄVgρ߯8Un8!Sm}]jJ-cavA]2'x}Խr_VqO]=ܓ.mO: ;wm6S nz{=sm+o ָ40:69$s1HQ|+o\ɉjQRL&Z7,pCc'#OORDˠ몙9C}J&Y`|E3%=_0n.ŪE$SNWg_vq;tVlb7sef76DZ\MZ{O{dP{2m'NSN=wf}L*$P ÝX~qK4vzVW~g^+W0і!#V @u(Hљ5٣y{CP&~8[qo-4efA҈@fpX$ ́b%(M1~sdת.&[:7Akul71cd*W퍂"FJCc;\PElǼmfKD Z+ $b쇁6qCc% H܎?j(ؚ_x,ڽnsb|pvg4(C?KK䈭ЛqϾ?8}{}SC2"NC5|ѷHez9]C Lg5z,e ئMgXr0/'|+ R@K}*cl1Fo7Ws_b=ZO0CuytzWWQv 0iY_1Ŧkl廫/7-jn节hhm&Ƥ)@*Fuendstream endobj 9 0 obj << /Type /Page /Contents 10 0 R /Resources 8 0 R /MediaBox [0 0 595.276 841.89] /Parent 7 0 R >> endobj 8 0 obj << /Font << /F20 13 0 R /F19 6 0 R /F23 16 0 R /F8 19 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 28 0 obj << /Length 2004 /Filter /FlateDecode >> stream xZmsD_Ҁ7!4&a4~Z~E>Km-/0JG;^\ܬ9.)* X}1/Ϡb+e5= Dm Jܯ'A0{eu+¼Ȁڼ+ v=n 5%T; ( Tx~CtuKj 7є[B}o;]m v}k,-no\8뉏@06\!(Ex*%~>P G]}z`L-[3Ru ]WmX7$@r&A\Ȫ6|r(fTV'@(=m*.CN];GfjzqӤ>1 2D _)U&C0)fAa) Rp0ه'AmO$Am`$A0IP`t4tSztR; cc ~j=ICy.V nÝ$]P% 7qc 9  sBm@,e(4%R k_<:]x (ScJ<NtLm=)i b(XK``!;Ps3'òYX[#LM:!H5 v 6;!|b*CՏb,WChwv 7EsW>b{tjhV[iΡ W!pBq:F`yz:gtgHԾxt!Dz7w4Pop@2Xݵ#`9-}E-{vUT**Jo3x-0sli?CFG40<b{U,%rϮ=MfO3khz8ї}}̰Yns[˸S:O `e~N'g8Yٰ0ט /^DdM'߿YM+(\zy^Դ͵&&F]f ,c<\9Y%t*JSendstream endobj 27 0 obj << /Type /Page /Contents 28 0 R /Resources 26 0 R /MediaBox [0 0 595.276 841.89] /Parent 7 0 R >> endobj 26 0 obj << /Font << /F20 13 0 R /F8 19 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 31 0 obj << /Length 546 /Filter /FlateDecode >> stream xڥSKo@Wq>l/HJ\,`.1I;뱀ʒ{u ndYˊ SfYD9Vb8*@ (cZ 1p&~*ѤI|92 -[=G?'֑dH rX p=GFE#$E뎆fNTR KYkxhEf>!ǂ"T,kC̀2ϹqaweO㑤sE8Ґmzܟ8|D\%ۤ}$Zh:a;<9eF²RRA]`n o yb-L6)vZCo궂ݟ6k1mFgWMկԱr?TdL iLo ʭN yendstream endobj 30 0 obj << /Type /Page /Contents 31 0 R /Resources 29 0 R /MediaBox [0 0 595.276 841.89] /Parent 7 0 R >> endobj 29 0 obj << /Font << /F20 13 0 R /F23 16 0 R /F8 19 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 34 0 obj << /Length 1124 /Filter /FlateDecode >> stream xڥVnF}W#qIͩ nHPF"U\D0 g937\V̗B\ZU,S2Ͻ/>E:NG:L+87z|- %4ME=YL뙒̕E!63glg>Hi/BˢEq$IM3QL3l'&;,zG~f^*T8=%63'\`o>KS4ΈLzbWN3Sd 8v=%l#gte^G:S<_5*prݦf5]s,KLy=I7U.cW5k7>'K,oZX⊮G];ɋ[]u]Pu"H"$Hø⏭Σu3na˹]LE+\pǃ`v~ c`vcͣKdž\)Pۍ(\oI|eLݷ!p;n G2`4ڠAI}M!e?"j 7D-D8+[h8nlDzY3`Sd'^IZ^wCfӒhbק~ʑMpmIC=_$;!mh]P5ykY9)(AbKT2N>H^\MTX'%m4@{&s(-A u8hA!+i~ߡ$I1@r奇G߁EC)#ݡPwTzȯ&lqų}SNhOzˇ4_NM'0 PXpsE$^v(m=Ix/3aA]ׁ4G<>J'*mendstream endobj 33 0 obj << /Type /Page /Contents 34 0 R /Resources 32 0 R /MediaBox [0 0 595.276 841.89] /Parent 7 0 R >> endobj 32 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F14 40 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 43 0 obj << /Length 2029 /Filter /FlateDecode >> stream xڭX[s~W$*F;K9Oі$vJl "uO%TΩtâahzVL# m) c[a>j{9 _L3hgz 9k>9_^W ci@YZM}Ubn5BK5 ;  <:eDٮ36Go<^^n۶ߔVĩ[Jy7kcT}D.۪~5uHw*3)3/⹦eWr2Xiٖ /]$f޶%wή9ӒC-5#V˶ldu_;ձ'`F)'@J8¡2[*8Kjļ?`:nu_LK)[d.uVt(Xx6_>I/ `Splxn#trp֭\5u0V$w?gVLT3HjkwEޏ+prg̪hZTm?:,ΐpeΐn_4USϳIoc\nTщ cX3b3(C99-c$8yNZF٬'CYp\l~`"x6IHds|xLa9Ez dDf6Jdv/s%gp &f'E 8ٝ* $bn!93e|x MPXJOCAbҹY̺@ C4{k ʇL9E SrJHAb4J(OȁaF4JSaqʫIŭ^B/Ma*4{pN0AbQqǓdSݻA؋ME"G #\ 4"S@b)AnRPǐ(e1z=D8# 羘.0N?&L@&'B$ K-SGyLpDYvH1_ ")E{n6΅k.\Td?f9G<6Lc"RX%1ogx$"!§8_єnዟlöL uI38)~`҃3<tjGTq|0{?] Ͼr-F?]Z9 Ƽ;Ú^qj*kk^JcWWY _ #>68R^{]*p#endstream endobj 42 0 obj << /Type /Page /Contents 43 0 R /Resources 41 0 R /MediaBox [0 0 595.276 841.89] /Parent 7 0 R >> endobj 41 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 46 0 obj << /Length 1179 /Filter /FlateDecode >> stream xڝVK8WP @Anav6[=rm6xAΌo?cg-ui-S%křTa. ebY}D*ֱqw_ʏa]>.~]."¿H0JD[5"P< 2s[X9]<-0BX&&AtZ"yD_D~&NJ |˜##2:堵S_TPΏQ&!#w4#ʀ~ ,1n+\K ,'L,(2LFy4w9l[T&Q(tZnj@:ćiMT+92Z:&)嶆q_piYXw= y"{;%J(),RݏPvgv[X,#unk BO0qn6p 1o@-#ac4;Р'>Ȓhac%Cj7{LvzvŞP_By݊G].SيX /Xډ{;ZAbBJde4RuI20M.`ƥ ,h9PF_f|n09dSN⩁9݄R v]ן_|Qw][, /eq_Հوh[NwR"\~ʊX#" ew*ޟ]"z+@qG2GHӮ?>?-> ^4.\`, \ԁaU2r] ݚK9Ԥ~VycD ֘n VyuvL :+~A7Nbp]jvuS*?Oc[*u Ff> endobj 44 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 50 0 obj << /Length 2435 /Filter /FlateDecode >> stream x\r8}W"_M2핔IMൕ[핕~6CX(bbu} P|={3dCFF L)]ʰ|i5.|Lh  ΔP0]~g=ήF8{5ˆ 1"dG2fցQ$ KeF1,[-( e`KMQ8-%ARrWvX- 0ܹ'!X %@JL`lY~yG_{`=w:p]@FҧCx\[e% x S④;v <<.Tb'.[6_Vթ+羥}nMcyb魩Мl9gk닛k{Ŧ<:ƛ>^;΃ kFcL!a?d$PBdΉ7Cmo1$j)uC&$JNL#n8GЈ#YE9W\~|ã cy~n߽Nڷ^.nnXiWD]bh4(=BG̼Xtg(!J iRKmRI}>ymRECMf%XqF:&rwTL*` `<2K  QqAzԷQEG)(_5MT$p!c*e[XþFH>ԁr (Э-oMD):3q0{WVJW( 2N`lҠ FjZ9h:¯¥we}"S y *4UDW_(櫗51TocBU>9w0Od5+hĕi|99=>H* $wHT"6B*!6ۇ/R%F0L)PĎ@DjbUҺ\L'=AdA 593|u*Jy9,eÔ2qʧ@US>S>ufyuNj6 -ԌIy]qltbm=y\"AC7p\!Y'}8N%Z'xl^&jPyr<1lpmln3n]as:KwV@6ݺ\sleOe<2q@U<<5;-E2HR { [٠͒4S=kAAV2Q&AU77Kݝ_UwG;x\KL7)%5>8DO2H*" :bTu+Nt81?夾aZi;Ӏ'."Q ԺC# :"<D;?pt %fv~ BzΗ :Jw Ctf (s=1T.$O! KZ颤6zP]P\>0q h5v''{H5#<D;%W%ޙr*{6WЇUӡRgEt}6E)e"7ʆYe4Oy 'ztx. dϞ.KS1Yo6g%vB05P6J&$*FQ9e¾C'uqA(i{S'[oWk,(AJ6ws_Jʆ6Q GGE TuTP@Ej$< !.{1=U9 H!2H޺eQ"(b<\a{8SyCy-lʅzoQ2 }IPV(Hӂ92[,qĢp｣.c(P,M^F5LY{-Oݱ(f71TS[۳ǿv٫* JW%Q۶njg:KeInMTi ڰDs)T@0ͽL)P44@-Ur^W;m˽ϖp!ޔ(ġt(YSh(-ʆeO&~ '~jgX?"~r>*IQjd/@s:BA% lOK)Q/2`:(48; a$ǿ`_+ןc;yZ_lVW^zɽ|+Ez^ͽ;yώ~Tf ̧}?=_Z?}Y_>܍WvЄJTxeq>gwA -tƺʝKendstream endobj 49 0 obj << /Type /Page /Contents 50 0 R /Resources 48 0 R /MediaBox [0 0 595.276 841.89] /Parent 47 0 R >> endobj 48 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 53 0 obj << /Length 2951 /Filter /FlateDecode >> stream x\r8}W葪!7_wq-oV6,۪8W'I®j'Nʢfq}@99X-9$`r!Ɗlr7eÏ{Ǔ=6 ,ej0zQ"l> ǔ0k_$~r8ռ6"@G5hC4s1 =1Qep)K,QT 2 bB@8 R`, Hm<>>t!drAsJ>s3.K PApuCuל< QTuP&ȞxelW51׫6sAys=g6C/;߅_9'?1T5Pg$ָI,&ǾvQbDh9E]X<$bi嬟&JP@MN!I`<!Q95m2ƈ3O"*MLVQ(Te嬟&NJ"P"@T 'X(  Z8LyǴnpZԚ ݵ j`9*O6HL5Pc̀377D=qcV<ĉXuzB)~8 S*iChXuyup A=8E0 N(uW3rW١KI+c`ב1lV)Y^M{ف m*O4]֜򴰉4 QTuPW+%0YĭE( n87!V,G^v2w1 QaWdԜ:.dԚ0%rO`'c T%ck''U+i_qpV\䊮] )%++g/9!dN t/ +g 6q@U7*t!&?;=jSX*E->cݺWƽZY)П*8"c*I,obǝ5% 'D5g|6q>@U9* ҂fܦ|š lP+Zj-ua'|Eq *6b5l\5UB195,>GH@n91R qO1A_?I<@*/)^K̼"*`ŭvY"8Op^lc{n,.yǤ^7ڍ Rՙol6JA&Jތ+l)UsQT>~k0Af uXrqu;naq4(.XbYo]yX= _]´ȕTJlٮ 6LL5P]ćӀr␌$Z4կLa_4iBLs%:k.;RqdjS"S"2%bBJ@'2D< W` V/1` e|Zts-8 9~X> gΗգ[wuB3bk4v0{?sf[l\-!0"k"x-,6m <=E [4o@!7Bui}rh7Ί.Pߴ &_Я 5Q-|C}OمMpγщ0n~XT)!P&U;Ϛթ] +|'mV|wRD>$lǖt"vM82s_;^9rSr kbw7{ )49.,QVv˝I?]]@U]b`pwu㓖>4}!1Uwi)|j:)תLCqT`_@ۄuyBǗ_~|U1N(hWCVrkzqh(2j ƛ\݀i5dυ M=ר欅1Pik:J*P* cS#a,ʗ<6ߔɢܨY1'P?@\1(4LͮoCv-̻~)dW8c jzx$eMFܪF%ؖdG U(C[q]|bƷ|=Vĝ)$dB.b_p.)*̗ r_ݮ P<\pWkW6w3D\S ([+*CAC?Q䋓>`:>뭷W2gȝ7E2oAwJP˲!JPkwaR޼zz\?S͉/ޅi]s_zwXE ջo-{`ɓ ,|rPG>q#*mhޫ0d>((^Q֫0*FUPuT@.2 4؂86HAy/Oŏbe$uEr㫷 bFcv+9=^lZlr.Ss_3or:X|S/qD[ݨf/ff'ąg/gT9ߴD#xp WM%u((FlNj9Ń6?*5R]|y'BB;ۇys}d l~roSFqBߌy7?g)QP endstream endobj 52 0 obj << /Type /Page /Contents 53 0 R /Resources 51 0 R /MediaBox [0 0 595.276 841.89] /Parent 47 0 R >> endobj 51 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F17 37 0 R /F19 6 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 59 0 obj << /Length 2264 /Filter /FlateDecode >> stream x͚[o6)(c˻eK[.M ]4[N6Im~ËLǖlBQ)O0?M=ϢZDwGiJIn>ӄ4C9Mś)^N&,E9R\h;yF ^N(y=Bj"pJCs%@R}/ HIRP):G(aj;L "obFI`LbfQnXP9Q<.L[g$eZReKuNʂ!c$Wʌ\(hA4:ӏPx`}%#&PՁ,-~$Y YH/Su|SDI>BkX! ^tOi$<ۋxASO\RS͊qBWb[|7^QҢ(y6A(3 ;<a0W41&I c3-8aUG&T2>$bmװ6i{s+wZRcT/$,鲁U.i>E"x[^6uj4qE]X\muNٔsj~^|cY؊št+`-'a|*j4QJķFB%Ю˔4B,n 4Zb M\՞tT\}GVP4 7e=ܛjafMqH|8vPmY7H)# px :}ٺat&Z@9xQYtF壃aY.:e~wAX2!(Ҽai2'.P I? %(R " (Wo@ƐÁ!I.$]LbYՠ,( e0i ˌ E<@g .J[x{- lY Mit0Hl-,dbX(f>GiVZ> 8 68Sfrn{-p,e'}fAlbe-f:؈G][(b}Tk;/ ۡSMWiye):pkoZl]gZ_MkÑ԰lY:pOP\/Gi=,:5H1uiJ-ntٲ~Xڋl /K !ۙ읯^dz=$!IفAd!#{HCv ǐ8 6wYc7Vw#-xlW03uk whW*.P{YC9lYy/M.+aZJlfk6]֠@V>fXS T}yc+'V1 ZҢkiMWz Nkt#ڡr68cZՁ>T{պgj!(I&tRI%(.X'!vyUP6[.5gZ,벘퍹~dInXV_90)ĂILvse>-[Ciq-TmagIo JOVM݃65<]4+sAS,}I_YۖBƊh*`qsm0_IXޔL4p$oc/jn,)ڣd. miਏx$ ^Gu}CqIF08I9/pOP\/F7,/u9 sA9TxioA.Kt~DHeQaNqۍY/Ca\E*PՉ3Q3Am9vy f洤/L]i'v_ëvTD롣Zk-Xu0> endobj 57 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F27 56 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 62 0 obj << /Length 2426 /Filter /FlateDecode >> stream xZ]s۶}ׯ#5|}suu|c7/i5#L'b 9g,\.%oۤ`Ei"eIsfmMz8:/TzP GJf(ҫ׻˻H8InrV(_d2ɇg(s&"Y T<Ѕ޸] R]/#2ʥa R䉅nfM `zɠO^ #YmƥLLHirOrE%2>ŬبE"+q}4:ɹb]Lݘ>aM(EΎ301X`y_'`e".C!w̙ѲW7B~ܤ_`vGuq(fqiIFW *tY% g0yGǀ`wr0vE0 Y; _ #M?nTbªTWdRx&wpPf?3濸#RO6PQ6xaӒ(zP`uΖCiӦ&#硢'P|Z¿17zaC|6 6iS66>*WSbC +t"SJ 5zS]j8y2(Hʳ%Wj]νŶ* 64<) ($HzQM/nxq@NJSsc{(8\4r՚ uH9` $^ovН,rSoy]APBۜFPd\0X^F"Gmj$DjhS#gՈ2٭FL^0sH0EDH U+nX^İQ#} ܨNAo/?B~=KLF*(~~em21x0f蒭VYjU%}@ $`At$#v_ED J-t]5OaK$CQG̟3y WWc>aXs_z!4M5Yq¡uxǸZ5#R/d;\}za0%"=rrVG#-OZAe3]o$]TTTgcWջ$pj2usJ O&V=$Y^iLM% ^*$gAV)6{` ` \![&:v"Zș-Ybբ5ĥ8C J0EDUK U+nX^İ\E}uc\1l.eYx}WT^"RWMhK蓂%X"g%֪YzADK'*ZbTo.ՍK퍋Ւ1.tK*EKcNք,%NߩN{)uUˡ~Kr2U .:`WrO:2맘6x|dF5ɂt\pd3<\!gnr[?xEW\ N}m$oww7e>c}ڕqa˩=rFdEljy>B Yt3Uf0{䬝cp ݰ<ǰGpD1‹ۻ! Fi(t~TVQ,$$^=rJ1VjUNTcT'2` )Nl>'cgwe܁Y|8r$Hy?e8sx$#[Llǥ͸Qv d.v|sVa +?l .98KU=9mt)LI] NTޏ;gSz~,=Rqz͑`#L=z '*oJPO) І=$"Gm*!٦/Qhfu֭$ϙ-sTB0E%DUB U%+nX^%İ_]_ [묕|yA)ݺN:BV򍁵o/vq@pܶAd,/nj92cCJò-1,aŪq9WL`:4nZm\]@grҀ*'[dWe ĴBh =Z5[v{oX>|#7蓄G}{ I4|>!?{N  OcJ60qxƂpb5eì`qxb$EI`1-`kl̤BhP)C1Tst?h@(W(c҇!+f~}| P !fׯ(ZsOq5QP+gDB@6WÓ?B5_ѯ<Q?0(hendstream endobj 61 0 obj << /Type /Page /Contents 62 0 R /Resources 60 0 R /MediaBox [0 0 595.276 841.89] /Parent 47 0 R >> endobj 60 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F27 56 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 65 0 obj << /Length 2768 /Filter /FlateDecode >> stream xZMs8WHDIboXz2xmOe290-"K^JN~рJ$흰R)WY h> G4_]|]$Y#뛄&y0cFcr+j4R#>]v2>I~ʒIv1i3ƭMN<:G`:/] "U_68IW8J' 0K%1q<\&~lR+& ΐT,zfJd2Lc3h6Y8(JL2# 7?p]Lbg Vm8rNlB&G`y_O 2kj¼~d {=BO`o:89tYsL%QS|ד[u&+`τ|Xv C%~a4xvO.d}9q ,o;_30~Tb Tѫ4R yABR3Nq6|+ ڌВnoRGP?W`vZۣhł{iB)vYCղr+6md;E g].^uUn\]/6dS.`PkDE\Fmt@S.X䄣:ޕN`> j0^Wtg4д"~uql09Xű93-gF?c 9\'+pl?,ϱ1W0ggm,[3 6lax?q3MhmF-Y'j&`7F:6I Dۋmq*P5q) z/0lx2!)p!t+,H玪pSTG:7ODI uC WuZ.3ߝjz[ʂĴX]5RsM|i8ot >7@􋺡nK( Af-a\3,i%r]|;V3qPޅ[Uz˷pp{(nTݧ#v[ng*HQ2tTB;,Bo^A{DzAx\z03 4隼bsvPkRZN[7u%Xh 5w&}3A6=[n>SX"8g[S()3qf ?|F%?â 7L"}'nn(pvz e% XnVԨs~z7Dzײc,ߌ^S.WOS%Uz$!Wu9ۘ0 96fZױ.Ltұu ױ 9:6c#g:6שctl?,ccX_N@CBzW?@ L n7W׮pIG&K gz6 G"( ]zV!i vYuAP=ۋ,cVay_`3fF4]N\_iO^ZOH\h5gܟ5͸y8w˺rbjl \A" @ăb-IѬmSN h%H"G뮗ŖPs/Hv;o^ RGx԰s `/iY5^nIMlAwtG4 gm<, /n~.9Y݂iK/ywɥ{Z2/+r[ͬz\ ȥY\uʥA`˥_a޺o,@ ! aA&5!~> endobj 63 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F27 56 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 68 0 obj << /Length 2536 /Filter /FlateDecode >> stream x[o8)(c,-M2;q}Jl43E9Ȕug-0(Pӑv:zs$"'gD<1,t9 &tY'B㘥_GK(cIN ɅJO>bD#JD%ߠL i$蟕L'dMr%@Rú HP^2dM)_Ll/ qϘg"\kJs6n_J \tS用,f0Frl?ȕL DvNf4*SH(t$NIEф8]7di NȂ󺬻Kp'cH %rL%j]+IJ?O8Pr,Y1N(I<:%w&+ʻo\E ]>y (3c%axv'Cc1$rĘ$1֌c#-0~Ub#5U;_ay_`9I v#(.bzX M,vd*H Ζ[鶘-z-Ux³t>c]i ;yv_;h}m=c|*rA| -4 2ivh -uǪocnC y^ox3lnKg6n^<-U;0 X3䙟O5mv><]^^ƴp(k@+>\/.b;q%&hWnXZ8NqLݠ ^nJorGi3RfhB*gD0rԅ .$<[HW3R=gBa9H-!ƒn uj4i: W`n3'¯(\| DQY':!pU{UyUC JKm@7; Pd$ W f="<ൿjnOZoÇ2rRO;zˀ~:+T016{?ȝT!wΙ :m}=BăgpGTi=d=jujTimpvJJ[xi]`N˛p I"4 ‚HyE~Bu<\kˡVEmDY?AjW,DdФ'}PcW*d<#Oht1i  Z˧UȀ&*%@xt.;^^);X6 \Eؖ}.l_O> p'[j/kI L{x^72V] 3ܠ?L <4< Ja7X/*L7 X Nb 6ҕB eǍ;Y޻W?aO6`MCb8߼Y m0Klv^ܗHiۇ`ִfİ,=fJ}xH V^`uS&l?endstream endobj 67 0 obj << /Type /Page /Contents 68 0 R /Resources 66 0 R /MediaBox [0 0 595.276 841.89] /Parent 69 0 R >> endobj 66 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F27 56 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 72 0 obj << /Length 2252 /Filter /FlateDecode >> stream x͚Ks8 AD؅ܹ]R}v P:zdEf5S,Vh#Ö1eg"\vkJnvq9 I/{'_.[KJYfR)NHr% w`j #6k9k7a⮎di =NȂ)}Y zwy @/#)_5+ 2bɝC{Ey@Qfh;/54ϔis;90F#MIcadzCOKՏ*[aĞ*$nT`#Vŷ$̜j Iy}Iማ|r!C^xEbY nbwȫz յqIbnZ y?j sW硵D=FP[ Ͱe$lk̸+n~Clek2I@Z AᮍMd27Ѯ5~r8_j1ia^9f `֕=5eI lI _5jpL(Sp<[ Q𠗲h΁c04cqI8"+[c,%tW8}LJ9LEُ["%1nQP/y)7IG\RdAhO<Y౰${QީNtyBoaT/ nA}CrDZC_= $K-CmBV&&>I` "gI’dEU [*OXL Fp?~@0v7 Y?<>݅et7$も s}EΒ苅%׋NU}{up/}W>摾.EdqpNwaG SDQB2[Kف0v90TLjQi),2<a9J1ѤxD#rHJFl 1rfc,.^d6vle]ߌCճ^_8/zÙ_a.z`O%~ESɢψ +2{W<EgK؃@LL,c;0ª?\v[\C.G?`{{GatVP^ђsS߫Qȍ0aiD/t{ްQ'Q.<ڻbW6!͢w&eֿ~LD7*瘇SkF f2At;?\_N:govendstream endobj 71 0 obj << /Type /Page /Contents 72 0 R /Resources 70 0 R /MediaBox [0 0 595.276 841.89] /Parent 69 0 R >> endobj 70 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 75 0 obj << /Length 2399 /Filter /FlateDecode >> stream xZ]oF} D|o)$vֵ<(m%U!%6 0`;gx\򗛓WEqsW0^AMQUԵ.nfK93YQ<4<}?b͛VPcE*b*O'|D -ޜP"L]|cJ1Ӊ?v--ƂUr %B Sie TWD ~V5S^Bl+ n˘ g % M?9B*ekRrG.Pꨙ`l;+YTT-j[mкކBBaqX9 &wGKKDccL#uyl!Qgar`T#_a0kʏpe(NORYDG:L0^Q^H: GkPY+?{4wphaПc#=NIcbSCOKfaԢ ftdfEnkQ;N}wuIjBaRn(0&,7 r1b=-V/sa9YMf ='kE3OD=mi k7VLr G..'Pcxy5ZHc"-7Pn[8v6Kxa{XZl--CE˃/843\}C&&TPo$=ASELž]#H)u?7˻@J9(BJ#!4G`iy%= ôǴ^_c)ܤYafB!:.n\1Bc & c#+tgc..IM<d :RԕP!x,1bbIULjY-+\<<01 JOXϪ‡3 +R0ܺT xKAr|H8:2kS_jf5_n]s:T:g(L ĒUAV^cVv*_aI 9yarڸEwYz&*n~y݀mqi>g^O}Z;D}t]5kpN%1d>ɃUC(ۿVtrwMW;Z6/,XÆ(%c3~r ·妉am+Y.'>-g_GylolL F|Gʇ0KW=xga|s<``WO;OJ մ[@2o6K3`u!.}_n/~9z4GKhERendstream endobj 74 0 obj << /Type /Page /Contents 75 0 R /Resources 73 0 R /MediaBox [0 0 595.276 841.89] /Parent 69 0 R >> endobj 73 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F27 56 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 78 0 obj << /Length 2821 /Filter /FlateDecode >> stream x[]o8}УomŦi3S`c+1#EKRdYrV"DQ!yὔf{4j#S"$Mu4~e?aX~"_Y|"՘]`a uyʈ n]iܯ6qJU'(+-w_S8SdvUuQ~U(\;׫8mt_P6ЖƂmpcĥFJ!of+V-SG|@ NБ5Ahz.I?m0F ]ߚxt,g~m HY * v!-IbDKIhaY$Bx5dξ/.xMCTP>Ý*~?ߝE凋_-@X4C]ի)~Dj=/wIv_&ddm4, y9_SIg?Bendstream endobj 77 0 obj << /Type /Page /Contents 78 0 R /Resources 76 0 R /MediaBox [0 0 595.276 841.89] /Parent 69 0 R >> endobj 76 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 81 0 obj << /Length 2191 /Filter /FlateDecode >> stream xYOsSHfnNIוߥ큖XR%ʞ?`H}bX,01sVEHȌ)4,l4q"tT<+ƉR:~w9HDDx9eoh6ge#9E#-U/F~ix$$iqz'ₙ(qkx(HdjG&%{U j/qgbӱWmBi&Dษ[ &H%X!3$V]Ac&tlD,+*Gz(W!8ʸZw.RL ȫμH#=sZsߧ_6of ]dNY0Ϡ2j,i98S / ,Q&nUO*3=s\[a@h=2Vݱ`U"RG3fpËYm+ST^-:%RT}{ܰԄs valШZR{)4*i"_k;?Yxt ։P*pA!zF;ӧQ2#ּzglIsjҽR$'(t"ʴ|CF S)@|v6}3!3uNօ2 ˜. 8W 0{-zuXSǕG߇/7@=I*L<[t{_u>E(P#x rp8gR2S7)7OSmԵyi-Qf/ 89{" ~傛b|cP0KDOy9(/w%1Kp{:pylA*i`&*,ڢjy9l˶?%rzɒO>Lu^)'䣛y#X j^ $2l7[k)OG4&xԜEVB`|c.Tk7ZK5i!"_Ox I>_aM$ڥY΋w9n0[dn򚗄{rF7m83'[,0gɭG2X4h;u4kLN`S+ϩ\oQАdL-ZEMB y-NY8v-4w̪W/>0,1~/*ˆ:mIh)_(φ€œJ%GPR |=/GA: NWXB[yIjo:.}QNN֕h.qCJY/ 7uMMgK9nY5KT.+ϟz":e^G븈΀SɎﰂ:||#^x *zkyxn/I?H4d\5M),FϜL.kR_N]Cio,/CT>?a]5r$?rCr…,bSe]g/qVsu찳g8k81kgmxx;g="^z众%*$9FYp&耋B>T̘O -eOetʿ4hDZb'@C }wu*X?}߿cCPfXT};ĞS/c~v=-nY)XY[B֫|?b&^zJCIfEZBendstream endobj 80 0 obj << /Type /Page /Contents 81 0 R /Resources 79 0 R /MediaBox [0 0 595.276 841.89] /Parent 69 0 R >> endobj 79 0 obj << /Font << /F8 19 0 R /F24 22 0 R /F23 16 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 84 0 obj << /Length 2785 /Filter /FlateDecode >> stream x[s6)(NWovIlGAHJ|=^̋;;m3MM;8_O^ 1Mz'DPӚ${/} F'4!7_FNޞ 'gG?3&F췳_~=D0czg :}l Ƞ`52((# 4VV9B$ZA<]8]gxr>Y$F+gb*jiܡ/ H֠1b]K͉_] [' % gqeBbxz8I44۴'DV%\b!:pZK9D48y3PШƚ/Π 3hAAb3@W ZteΠEgЅk}dxC J8#LcR0Y12v QP\LC8/Z`# N.@QZU P8ς8&SfTG~'7w|r|p  Ŗ:\rDoժWPlMUrW%!,hZ5K83S 6 xؐS܄b}p1Y[{bg\*.^Ongjb]Sx˽;7}.W`Pp)buB "& ܱht75B|#]͠m-FhМAۦ9@[!;X:bwvr ϜBc(ܢ-ӹ_<<ӺLC8gϩ%P >ZIGƚeж͠-xJGE%|Z&ݨU*h* Ƿ"6j($B8Ra;uUR\T((;?=u)$ٞsty8aoM,[kEM Bj- JCAn7 Ef M_|m={(dn ևp7^ uX8Ӏ^<[xXd֎=D"]ګƴ&B\NNRiSfڜ´Ƭ#scT2(lqh*$2݈ōo_A[UX5@VTst,u:6D؁kE|ç1oͺΞ~@c%˜f%=gșX3ξQ8w!.ùM\ n4bxop1JSYT=IseJDcxp<-Yc  ;$vH"NH,;Q*k)9NZyF+TO7uSBŻ`U(Ws7'obTyfxMf~>l]8ڶd ol f%nxsXq" d~ kٗ9 .e l< ND["q6$E%duiXڰ:z?z@Ml10_0hL++bmX VSD;C.kt1q( =tUG ¤Db*<Q,I|ĊDfU(\@D9ߴRTzVD ӹ?euМX3Qw!.M\ o'ׅ>qCո^3¡ w7j+ / |7\%uӇon.pJN]f~q`x/1&^纛bjj;&oTEX &!삱f}B\wwA aw!5nK"o.G-#tungBҵ zN=󉢈)\|]f͡N&aQ_g:@ U!>FB5~]vu-*MwP:#{369V˿)]ܕt(ĿݕXXpk.ZmvB3kAѧ ԹudCdRFu]vk qg= _'ĹyjCjJ#bMMd;PASZ5hx+ƌ]L]aUfr]YU^bJyls],fk:dⴵ5P7ڲWR|L Wrmy G$kߠt9 $ %_Plu2j)E\ [^P.;LŦцT@E'ڼvmARōXw0ߵ{J߭ I`6mHkk.{ ,(e o"􆔱[.Zà $'a Cd{?5>*"A݇Eg?Nҹ/<,^pkjNnxi{o b-jq;yawbyһMsJirTj 3o1?X5donF:DgIh%oendstream endobj 83 0 obj << /Type /Page /Contents 84 0 R /Resources 82 0 R /MediaBox [0 0 595.276 841.89] /Parent 69 0 R >> endobj 82 0 obj << /Font << /F8 19 0 R /F24 22 0 R /F23 16 0 R /F17 37 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 87 0 obj << /Length 2519 /Filter /FlateDecode >> stream xZ[o~УsŻxlNvMl 8rwdʺ,rI?&Eţ}DYFxj"Se*dJ6<=ɔs}Nh|50MhLi2?NM+&ianSB'qL~mL43c1EfpE׉qnwVY]_$UKWPmlzm"Y^:[`EY>cQvګ7~s]v1SʝЃp7\KXp,łw@ uMS5Ӡ\fAb.Y.knL{v莍`nzv1x:3|x  <͈B';;+۵S&G+C/hVqCM.pLjVtv׼Y$~߬g6KfLDJKOXHejzIfFC`gs #lQ" [ejc1Ҟ]! -wۧG3gnT8]6@w`STg%[ֹo,QCFͮ:b\JW+ 8[av[/j2Iǎ8#uL 6؅n`Q\V`-bZ(tl\RGik ,ISkL;&#&[&aUk1}r ,Z eϊ[$l3dW̆u!v9QAiL .>eGM c=1M]s1PItQ8<!ZcSՕe-m+q%d$aߢ~:Z鋦0vuS|Y}8pk|GurHpLџG;G:u@(A6,#!*"9nKfS)Ks[!Ҋ@=F 7tM2mXK`)רd}\Az#ҨH 5  =0%RQ(x9/Fb!-H@^5hO*7c ] _)lC#$P_¯'|ޓO#P[) ߷%l' u~ 7k#=4 Kח2 ((༩atF@!k;jͬ/b! cbB !`G\}{wrdv?oy_]R uν*ՈTRH-.9=bW*'ce-LYGbO|Ha-Gzܥ;qNʺ>=]$r (d0-OĎǡcI""t_loUEi`CaWm.wLXrd02Ɉ=-D%1n6Ҩy[ش R5Gچ;D%NI HτsV #pU/> Q//ݘ,MquH"xB]#>[s>N#)Ť7H8lS8_tg}!i8k70~< @FWa5 EQ1 7æ.C"'lZAS!MfiS(:Ԫ"TV!̽ qg__u N1Ֆ˕ {ŪtxrW_#lR/qhD9k=8(T[oKȠ^˛ U{Q ̛̋5̣Vu3:< 1ǬO{{;*}dT ogT;}ʷ8fTQ G2* MWݽRO_aTUQU`Q_*:Gf,(fek&0)B7`O8E_8G}SjqSc1s4]@ b}_QfiK~GX|MgD-UkU<$PrF-JW Y]s^.\qs/n++WPo}+YpVقfCWZװ2GnGؑVb"! څ{b7bz,*!XN*#W*Gp+ݲ7~,MkSmɅCO颜an_ڙCop3; >hԎ$x-!u<ξQdU'ԬR͂V[:>`"x˷`ȍ " _M+"=Q؅. :z9vծrUl6դ yq$\_?A+y@lwwa[l܋tv^ܯ1ܷ_ * f'p+z1:wei&fo_Lp[endstream endobj 86 0 obj << /Type /Page /Contents 87 0 R /Resources 85 0 R /MediaBox [0 0 595.276 841.89] /Parent 88 0 R >> endobj 85 0 obj << /Font << /F8 19 0 R /F24 22 0 R /F23 16 0 R /F17 37 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 91 0 obj << /Length 2413 /Filter /FlateDecode >> stream xZ[o~#=o8'MR[PAhK8Rr\eIQ"%+Lr/|;ʛ٫>6:s(<MJ㼎2I6ω/?g2|96ݟyY4>ˢgо=(ggWg62(JXWtEF2(<|nKIJ:.*@͜4 /tRB_&s)dDƦp#Y6"hf-3=}$֒𪬉\ g4#`VE }~E[ݷi-+m gmp.~J_&sT:Fe lq[0_K!tă+`I@Q1Lo5J>fCs4<-{sF]e6QKi-da<<_&V%+}!Y<᳈ICsͺJ3_RtI9oM,quYТUY}-\^֫ `Ms!V"$J=mU)$ǨRFZW 4,T9T-oC[F+:۰! U劏k?0&2_N&Zщz.(}OJxv). r#(E=$%l?h;RfC)¬)EQ$kJqbM)9;b/hy'3j' xJ(8QG+^* ԏp=/ZNc9,`JoXACS֍5ݢ=Nj0ɤ]omMP$'}T]"k٥B}R#%qջ򰻰HX?_W?'ȁ"ݎ#G,d gU9?q+p"#aF\ Z˱feC ٸj<lj?k -آa2_&MnhMepjg絨j8-y?]8jXN9S!tƳgƷ1qI,13 (gy?&?![K^+2oqW ?Mc/ OgAvvǖ^|ƅN٧ȳK7Ϊ'T4.Y5e$pG%9F @|.r"#Bqo@65 ,|=&dM7w.Øzo_Z7)o-?}zTi0YY/=#GM_> endobj 89 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 94 0 obj << /Length 1852 /Filter /FlateDecode >> stream xYRH}WQ&s*$L!cLp-јu- 9=:a3G"cA]f %lr-ID> !d~yɈeXhf!Nlv=w;G40D8C\v=\TelӅܺ] Ru/@) WD(1Jf2 aY4Q 1*Khx&8+$Ng+gUYT1T1FR>Vhr%3C!f}8?7T`jiUDW8k`*N下ye 1ڙ#%LYzLڌg9 |9'g1 4\ %6 lmv,QNW=OՖ2bMUJAЁ ~g+.U>C8 *8ؔSO`zs|uHauT}˪Xmf&փ\2趎Z^|4r~ H8 30G5GMqXDmZVhFݚ'L i05/"q6 gqS/ CU  )[DEޣ&AKD:]`othl: g ׫UТ:D8Anb} O 0wO EBz~! ^pT9˓j_!v pEqu$9Xk. =X[MO`4ZT4lniϖ/s&)gٻCK#W 1e{l _ɋO(eqO;X[LE şy--)aU'nXP8}:[OaT6 cJU*> endobj 92 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 97 0 obj << /Length 2101 /Filter /FlateDecode >> stream xY]o}У8&շMt1NJlt}%)[NP"yy.=ʇA/>+YiU6τL2s3m6}uڕ*~_E~6ػD#g8V* {~٨dz=Tg9e=T=BIf?47&&TkIÔqdy)\ᦍnj˚!K$S̈́MX˴5YitƸ碱Biƹ4r4@%4&4:s>s~>`/>,[Ep\h`yuyv+>ę?aC&>h%֝tc4h%l%b9Vx&jqڋG`ad\^=ŲoD^jJo}>Oq8i:>V%L|_W4fZ۩EJ ݂Z\B  OC HBJCשcEiE &la MQj8WL(pE%’n+Mh1,iɪp-5Ü()1,f8(93S ô/a$[EXLf8dқvYrr+ѩNDa8m7HQ .'wHOB92S#Z/)B!y]-dmYYהZt iL@ৃCfsrg/NL4u< q2Hpvܓ j0{~h͐`ëOQ_~0Z1}~hE?u66$F?~zpӡ^L_c4HCKVh%V0 ,;;p{WبQXtJ@4R<='y am2&]Q[mGTi*-MUL/b)!Yu_OHUr2۬?=MBH:yBI''ZH8%!Jb6Fe%U{fL "Ty@FS1:w;_H$+EK A ;EK,h^ hyvR T \g2%!-pRǁhdsE#.R5rm)#3q]\SzTXH1)t{BlAoz'[E*K vE ?;O.nt;?3t~OE;eq$zwFs|۲i9}Yˇ{93ŸӆTJ~፲M4iendstream endobj 96 0 obj << /Type /Page /Contents 97 0 R /Resources 95 0 R /MediaBox [0 0 595.276 841.89] /Parent 88 0 R >> endobj 95 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F20 13 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 100 0 obj << /Length 1768 /Filter /FlateDecode >> stream xYo6~_G XĽm֮qAFcy HQlqcoEOywً_@`~0AudYCLZ2o/Xihn,f4x;D,6%Ln&hNG JbOK@&`-+d $RZ :FIL@{(5l R+Dt|mNW)[ uD`{$|8=VaTRQ]\]*{A0]yeXoqŒFbEå}[߫vxm1C!Õm7˜[_d;dB8u %'{pDȅ٘IRX/ ?!$T󄄧l2$8 *Q! }7B@~C65 ֍ άWvq }0r.?eC>XJ!qJ)Jg ^t2C:ʅ%l'7uqq>Voq}a:BBeam#lFwf!Qox3g$aL+V7U͇P9oQ7OOoBl$}Er@+Cn'0& 9s r2xw]^\VpUaj;+  i _&} ]4 Z] xK1ˤ}^{ 4=$eXqM(8芅$I]f&]euʌ(ޯSi`J("h6X3ϲNB$NW)`w$ju= bۇuq{vM1VMt[Jn8M?c(?2cpP{ws-I UcLBۻ۶X Qsޠ@tsjQO2 7 ocɑpKQzɽ#?xMs' dMe->ZGc;YKHa-pI1DZiMY`9: e-"oyF8oeg-!%I29[M5'Neljjsa0Cmj4R# 6rP q H4)!'KCb_i1&!'zMӐnaX- ^_ L{u9E%G\iJTs(T2q}EBwŵZg- jO-LGe\u[}K"~^Kwt}@x}twOKr&JS~z^Hx$&DiasxϿ:v ShMheֶ:W*˵4{x~?s֢k/xUaaJ|)ʛ::|- /.Soo}ysQA^6endstream endobj 99 0 obj << /Type /Page /Contents 100 0 R /Resources 98 0 R /MediaBox [0 0 595.276 841.89] /Parent 88 0 R >> endobj 98 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F17 37 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 103 0 obj << /Length 1819 /Filter /FlateDecode >> stream xYo6~_GXɽM:,I]gF)ohs&nFZԾh1xV(Ɍu}BHM$.6JQ + Sڥ6˸M vɰ',LnM2@/2‰al*f{LJYzef>ycFєFgc\~;:2Kڡ!8S,6 :a]NWg+a= ViYX'cM']!8uUVi7s'lT[;/FVf%6-aa؈|+q6X$>c#->ֳ8L _~M }e:[0kl~^um^$`֜&ad3:-N,dTQ<Ԙ44YMЎ'񱜴Z!5X Tihǡ5!-Dž%r(GKNA4 †I0Z!vcK8z:+wr3e$=^.e<3^ VFgd%vz$ ~.lq67H5e|ST@ ޓ2atu~kUMӳaq{Ȳ,Z?HR*fBxNWBWDvW}KtUjg Eb fȸiػBVԚAju^hV2t^a62s*GˊP"usìiD?>:>9u&$L#Hb!zЈ#4~U N>rxrmup͞8NDqM 9%,$7jIo:RO>/^t}Ԃ VY|c`4AX-!J2Tt%A n @rVFz7؀w4d{#px^$j,5Xʧ[L6YnbZ-#ӮcsޔVuދfJ}:hԂz B9HXKb{Md}CɈ2'l~U0 LbRHPC=,ND~%Mr?urOqa:`{ݯCn( )nGu\6ޕ(dm(57[$>b 8#]J4UυR]| ^#5}Q!i=l9qn k9vf<:6%ZPBDjq x+ϵ|{JVPfR媪D=T^yDEA{$DupxyzQWT7C&_|lU$N)=s["?9c=VO#P" :(#@.J@ . h)RPQTTsUTbLx{xoˢл[ѥO!ls~^ A30 zYIϺNŰ~ B$U>=!K8z |)Nd2I.Qȯc̠u~ z˫W5<]ұv5.XVWu% m6]q)+U N? endstream endobj 102 0 obj << /Type /Page /Contents 103 0 R /Resources 101 0 R /MediaBox [0 0 595.276 841.89] /Parent 88 0 R >> endobj 101 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F24 22 0 R /F20 13 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 106 0 obj << /Length 2284 /Filter /FlateDecode >> stream xZ[o~ׯ#uZnݾ9S84v9y%"KDȿ^x)_b= \vfחWoLbUȻ%k7y|{lʉb/EY(#nqveRbÔMC@ՒqH)QjͥU L+YL xyrOE\EZN+ 3oga޲ت! fDXlOdMg!Lu>k73"5Ib+?X =ܲ:")#]!hc<=tSq}Dkrm žqJ}u$#67O׋FV +0^gP:L"DMi-אDPVfRy4vhk ( ~q6DY5 `P-·ypcL~oGV~<{fԊj:͐y`B9喎6ȟoL=:R."U!y0W/d!A2"ZG̉zG%̛҈Y DsL^.?9Mm%'N}e="8Pa:*9K/O϶PaV@AZws~(M)4F$SW:u &x@NaD9VxRW1hy첈C_BӲoV:qG]4l2(8ױcV`KmU.2tKCb =}k))}Ɉ<]lst&wBzk7aLDa=&t-j{×+eP !˖k O} }!Jo"Thv8فt K {CZ)RJe ^|t=_vXXH.rՓw 9#-(|@(@S|6@o0yDGc0Kfi^ +k  y݅jT:DuAY̾nrӳM& S tِ(W߰CNʓ! ȀHq<^ +k #Ca0m@D 5- @+ؿ(Հı 3ڵd s^'Π t3ee-aa@]8nahE9 ]`VS?n7  쪝G* )&$Fv_GEb/(6OA1#=aʞP̟bPAD0ȃlmZWnc6<ԶʲMŤsR_[1x@Y ~o VJaykrDTUQQTRcOPb:u_a,FK' rFSD%4(#uOzc"ڙ"/n"ss E*rC>o2Hmr)= wu˫W V_nVz_hV7%YIpI.|u_!HR&c4endstream endobj 105 0 obj << /Type /Page /Contents 106 0 R /Resources 104 0 R /MediaBox [0 0 595.276 841.89] /Parent 107 0 R >> endobj 104 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F24 22 0 R /F20 13 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 110 0 obj << /Length 1655 /Filter /FlateDecode >> stream xXnF}Wl/}Su_@Q#D[B$Qh.eJl968;33Y jG6aA]b %d4Ie3iHG2˅*cYyap:KM2 o4 ha@p6cJsb zGNw>$1*1\^C:s2Ϯ2!>L&kL|S?shZbiԥο zegKڌr>ٲ%vzÌ zq*_OgV(zV-IȺUev&&M ΌKs]``? B~#0h;&ҳ??7SF?q8{񕷜D0s2ASV auU~+IT{I< v[-5Ɩ5ؗXZ{ͿΖ"%El|VE\_f\# or\PuF'zs-SnCO#)GTj~<<-6Vm|-3Df-QL'Z8toaMo5q.bг%,b),?p:W'h5$8`{OFg hz:]=pgw~>FԖX޴ϿcDWsi*2]b:>k-G~$2o+ $Pa4#آ&XrU}|}T hÛH5p?L W:4\_&dHkDh@1)D1N(I+/D,Ӟ`WXl+-sMibe nlHc祈 &EZ ra Ltus?oTD*[WCڳ55-GPӘ죆@ѹ@_ԹQ#yhZ_0)CieJq m{Q 2Lxhd{#9ŗ>$E5e6uTW{Zc-|Uʙ BnDQx/.Ê T4Nce9NPѤ u5OJBrb~1[1ǵ8s;< `ܷJ qT  .^`ź\max]7c #ƣdzӎ̊m#DB 2[κ-V,/\Cھ.ë $SRq:\"l굿܅fd<r} ÍL PrzLqG>ooR$eGB!RhLIA s;{1+0cO(d(<c¾(ٻѕk\ ϻ(0"zzPv_IzhD~/i6aZ0SFs^/<eUƣ^@Q @ȉrD)mQXJ$q]4$,XY?mLgEuxċG963}G43U:m$|^ ˓77S~yv" *Zyz\Vw$˲8T#\E>+ߡ")Yn)M5G5endstream endobj 109 0 obj << /Type /Page /Contents 110 0 R /Resources 108 0 R /MediaBox [0 0 595.276 841.89] /Parent 107 0 R >> endobj 108 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 113 0 obj << /Length 1344 /Filter /FlateDecode >> stream xX[o"7~W8_]R٦ Fy0 H03`L`CEH|>m>:gE2ODPC:oS͘4NḮus1谄‡%&FJFM\v(&ߡM s.yH.scALp}!7\"z*u+e3FLb!L”&>J1qbИf$|78ǚ3+v(" QjG(90aRPA>Qt2,0DH!:m-`]joz_DS]~=OXD1޸,+G{w"$+!y[+/:Eۆ)LCY%@0@Me|GoQWm0#t3(#L!^{ZWR~ۓ49Pk}۱d+pM-HXH|XQ5eüTm?+hl RqÏCct Y,S.Wyy7m$ ]a<̋T`ڨZSմPhop:SPVgߞ%NlNaTE` Iv<-hQNJ(O 9VM5ӟ6zF8pp͛,n %pإg/po), w5*PnBW9H<ż\&}*GpLQ+?Z`y#e}t> @rNM j}1-bpo'r8ZPlڕ r덄鿞 @#r`4)"m-#ij8hWLߵ?V+nTx ST`,a %jSd_Q\ۑ¨'3P%_f #]i%RwϢSY_:Ib*,kpS9?9o+|AI\oԿ:CzIZ>o- o/J7k 8MvU ː/@;*b~ l/*714ɏ =NE ہ rQ4 NCb+TdXTbj qP# 'bɐ80'N- c%am{Wt y^ |\L!P7U:2[6$(O Vg&ȣr 0hb/CNy0Ɇm2/C~9Y%t7X~endstream endobj 112 0 obj << /Type /Page /Contents 113 0 R /Resources 111 0 R /MediaBox [0 0 595.276 841.89] /Parent 107 0 R >> endobj 111 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 116 0 obj << /Length 2117 /Filter /FlateDecode >> stream xYYoF~ׯ#ٔ%:4rAؒBQ;(i€cv8~s_m"9HDPC:9Oe3iHϯ,B^g,=>XB%&FJ&7ϣh2ňl)a%7#EGYZJe17\++) EHvveD!T;m؄ʤǯt)lVNb^l~aMg ע)b]Tfʸm)/h \sFrn5HkeKr;p;*texS_u䷫ 5b^]⺑b ^!wT \aUd֔ub=:aRC$۬G%#at`hD@!%"#-1:ƪ֓z` Cq]Η=CKS-y@YA+0 N,%.Mu+g0)Eqf 3nKwiD.vx"I`apokWh} oGn=$G4A\VgXYZ(" -:X\PU]ۢSA-UY&A:2|%X^&< k% 0$$vXaJ*B }uR |hZrς6Foamzm,=w4x_!HR5D&fXRg28XmkǵKWTb64o>F+hL|.\d|5,6E^poE7Řdé)wҵE!_)ԶEg,z:T(ؖM}˓^2H3N!U|5E#ӿN@hSn/x<5Xw2,8s_V}XN?^ǹظU@ }wW۷@'+|vT}jCBVkrB#>C0>7ynZޟ«Rc?C8"` P1$wФ+m ,V&Wa֏ EY ݻR![ _8 4E&f}AK\pDe"}9>Û:Pq.iV+|(%tnSn)KcX~܆>6{6"6cobǭXb-SA#l)Hu`8d{|7v^c?S(N+:z.{t#RDI՚Bg=dޔ˕@Ac*@DG _͢'Zk-Bo8n1?D $nV6b_LB ºe;Xekv6$[X?믗M(±=CcٽlxOa<9I ,PVv #őoѧw(;P0w %#Uv6䋥?2+p1g xOaL! q*MrᚦÏ;e,.ۑLd"D9SN#ͬ W9ȹj0z^7HGO&Fc0W3O4,bź <}.K2o`[#jXB#(w9rJضJ8Co}endstream endobj 115 0 obj << /Type /Page /Contents 116 0 R /Resources 114 0 R /MediaBox [0 0 595.276 841.89] /Parent 107 0 R >> endobj 114 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 119 0 obj << /Length 1344 /Filter /FlateDecode >> stream xX]OF}ϯ𣭭nC%V-mEڇ"B0$$Vwf0&*RlsgΙGE6DPC:](4NiUBOh2 ?9e* ] hu@p60@rg4+'ؗr %B`RMR) WD(@_%3:Д!%NX'|ӌ0u _M(ɱtrcBFu/V8 1[p'J d3C%+LgAP׍601l I!x~[YlE1N(Y's<ᱝ5xz'v% #97HAk80G0S9reղPxõKlpy >3M0bEofx2CBG= "!- pG;(3piw݆lK[H{1oPXjN8 [x:Fe~51rX1qYz 1aeUv^ٳE)uapOR0$\f:B[KUS4܄Y4o@Ut֣ p 7 &x wZz@=C F{?z]^S Lg mȶ)S;}MA]A AXPZWRܗor'ӄ1(K4CN?#V>~1D02w1t*1>$l{JdJLMgx\U=ͼ5L^T=`~O.=f0%b!,F.Pېm[ ؍36 U~iT'Ä(ܼb SU?L쀥Tl 2ީN ]PRiKD-떯u Iü*UNj-U#սs-='훹V0۴qSS8ܻK 3UjA8[gqbTJVkb&흂,3`PJK)Q{a&xΆ4Ɲl|yWBIE/t3=AS4@uAr@P\qgP)I,CqEH2~|.̿psQ 3lZ|~q7Ce>O c!)* a|rFc=wy}SEռ%/m؂PV/ )9(:p/xendstream endobj 118 0 obj << /Type /Page /Contents 119 0 R /Resources 117 0 R /MediaBox [0 0 595.276 841.89] /Parent 107 0 R >> endobj 117 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 122 0 obj << /Length 1939 /Filter /FlateDecode >> stream xY[o6~УM,fnݺ&݀u}p8+-eKNL|G*;̄L2s3mv~.BhWJS?99=J9XL6|{ϳ ^N8S>3QDKoJ2XHM,HRm}.D)4LGejڨ% Z2$&`f=˦pb\8xJ3Q^a'G`҈NO/E2s\ï2hi֨.LMzS1#?Wc6")svqQd\#PHh0'׈|i[ b2uֳٿ7Y=Do<3%,-*d<4-PFfVtZi.:+"6*7!ifMz4)6f^UB M w(iu7q-gXDdR]Gl&U%kw&>xXrdJǬ7O%=FjIKrXKZh]KkHe)12DP_+2YD aʂMm]0*~-N(UI(h*kY } ZCvL9Yrvٴئo1}{i@.x\?cv*ә[rM= SM%!S pG=R$ܢædENwXQf|B֖l2$#/ZYwt;-qA+1QMm[Sf2gx᧸~YW&.77A`k (^)_M) ȯA_Vc%Jϸ)^zWa"KAESqldŰ`#/P@:Ú9zyfKq{2;,:/9'Y3&_8)<ܓ.Ȓ#tԗ.z@8 (}N`: Tژ"U#D&uw@}栃^^sJu}'ȺkM>tAj-Arݤ7PaylXz)](|ǫv$5_ջݫPHej4 @Ox!YUڠl8o|B-x=ˮqp¬Y-ݞs"6BXHr+'j6Gz}d-~' pAj%c.b|׮"Ҩ rǦ,= }ctljI8/-y,YY㙐( Z*NO}B(J$5wE\ x}Χ$dV)DÆ7>݅fKI_6oVxSc))<sN;FtѩESkt:gWݙ?Og @DC@᭫d(0b?F7h4oh+$cCkl={vAQz,F篶\ѽU}Ue %0#x.D[)ɹ(8yo3endstream endobj 121 0 obj << /Type /Page /Contents 122 0 R /Resources 120 0 R /MediaBox [0 0 595.276 841.89] /Parent 107 0 R >> endobj 120 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 125 0 obj << /Length 1869 /Filter /FlateDecode >> stream xYMoFW(5f-.vX92m %.IQ"%+QP73aIԪhx 09ΒFO}=v VJ_]d?-8`lz%xn|*$@d'5&; ᄍg+*FSz/?7",k{˼腜3oC,s;[–1m9 b1vcd&W[K46C/!)&U[tBhGՒ]BP{h=B0&a2}#u~.VD?Rϊn@!&AAvIQk$r↬n9mp KAs 45Q86 3'`~gIv5b%mewez;a~`,17턺NOzC>WKv@hݎBKpi:qZ>ҷ3 b2=0l uQ J`8 oݳ#Nu"GJx\3T#))L.P6#*3mۤio'p;[HimzсIyuMya>1 `TAqaO5-d9[VS3[-;p<6r@_ނ?VL$NlEBx7ej0O98hyT%bh%BJ%P2I7cj$ئ'AំSgjL/d,u`8I6p7B)&*S-}}U]?=E/mEV|+YqCX0B m꓏'0|F XEJA4Œ>7G_6br f w…ߏ逺-K#¿ W8SrE,AqkiHE ʔm/F8h8<ֲU~] Q= 鸊"<  yA/*^2c ◗/Sy b29嫖ۥ́@(_L> endobj 123 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 129 0 obj << /Length 1876 /Filter /FlateDecode >> stream xYrF+p`q iMVIC~4BEy&(˅$^eU ]pU;Fb0R&P DWݚCAY+]yCYe f7-;=9B ]!a/mAwmC2i<(k%FMpB$ZdA2ը.Wm eY>Į m<2 lvt `s-Q5h_oxq kx,.a6a+GzCQ+yP;v])X]a)Y᝝3҆3@2B:,-"S`o`0<:̔D 3J((+*"Ko:G0>Mz`θ嬨˺ ~@֥9 CR1B!PCQ*DP s.G{$#HN|(NDɠ)Uu$9T5l:Z@Et,MDs` f~Q?dNr:|YUAw)説\*:Cʀ*Go^5g) ̇e问 d5"{E1/;Co\6 K;x`u'{ϖE$JٲXfrİ>}On|s׽Um}D h LPDve gp5n]q:({ODP Wr=SwX~:TeE]yCYpa91bh $xw9Wprǃ?׻̩]{%WG17kЂq|e 4Fņe;I;MX7Z@gޢ:^ 1vry_7 EP ) !]OiQ^cDu#)2IPe4嵪V@ (0X- xE9k&(?j(3xTܦIu\Sqg_00HƐ1<诖>y2Ɖ3X|ˋ̋U{ҌfyL_ &|+TgUʶ|}&endstream endobj 128 0 obj << /Type /Page /Contents 129 0 R /Resources 127 0 R /MediaBox [0 0 595.276 841.89] /Parent 126 0 R >> endobj 127 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 132 0 obj << /Length 1954 /Filter /FlateDecode >> stream xYmSF_r[](/iS>8H6 w'[ @H3Lf鴷{쳻۳l"9LDPC:9?r1iH&0B;C / ,%&FJ7σ44y7D8|1%̹f ϕ d-)oQ?. ʈJ j Z)Eu;CR?g?TV&8l2k\THT=ɸSD3D ?8tn)N'zqs}#+k {܂Zm9{l&,L1r[T5J<.h!Z]0-C=y.>Dx:-pAjۊ 툕"F._(+k pb!<%dfx`H.8Pb&7(<OyQ|_"jMQ..gUb n^w=K,֏=\&R&Ī.Z:hYm)jB*@W"zkMX+aXa+W.'TW  ,WU 1잋Ѣ3b+% hBQVA\2ݶг֗I2V]Y0uͨ," ɻd-|rd*T$눤bCa(<V-cD( B"EYYKX QP5K! #ߝP&<ﬦQB\yn;af}4e23̍*D|0iU%5XBэ"zBˠHo:;jE XGabp|SKK}Av$>9Z6]tbS=Yyj鳔A42W)6MS{/ 2mžyd޶tl_ALlBQg1D 3f_|wԹJΊ)_/9xFr}qQq^{Wi`7O\ *n "8ÁKdkA<&25jNXX_|t*de(h:, "k@hŃJyxZ{G?M1-濾ycmK|݂ϖո!{VW);'͠P ;_&_/T3NŊH{endstream endobj 131 0 obj << /Type /Page /Contents 132 0 R /Resources 130 0 R /MediaBox [0 0 595.276 841.89] /Parent 126 0 R >> endobj 130 0 obj << /Font << /F8 19 0 R /F24 22 0 R /F23 16 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 135 0 obj << /Length 1298 /Filter /FlateDecode >> stream xX]OF}ϯG[[ѷnJ MЇ"P0$ةX{qd!)Μ3wu48OdtOpT2Oe9CFw׉J3h*m,NGN8Xmo0r>`TzG~9{4PB6珃_-#T[ Z#U\G MYrK4J%O^g0x7:1͛gnPHGm({'4ɖXYlP0ү<Yl}Q+ o-^3?1(ZiVK+91Q'lM'*V.S\d f c" fB< "0B#=LwuW8}znZlYVGYN-.ě|WZ, ,7.i NI+NSm8GI:`1ICoWҝ;HV%-= G/-X_*E< sLX;h'e-5>5. n5+c5zC1p{]P6倕u""*xq'g]Ơ=QxYINcreWsW1Az_PWi|qXH1{;@}^6RS}%XfT[}Qvw EDrP*B (97XY,"gj^9wyAI/Sg+$Y8i}50\q-vzD??"ܹ/C *#M2ú;\.E#'i0p!pYؾtZ"1,B`*lG0ONvMl}p(xi;Y۶JjNQm}16:`Qɽ6I lF2Fr-a{QЯv1-%q7_OXEQL\r? GˋrVK?k\:Uk=" ׽C_.Ķ9xiطĊC?$f N m#[XpRťԙRT̷a6S_y:iNy8 p/x ?6cLX~=9AυdzY]as5Tzi/SZ`m>c_0_Q0fii~Ws-endstream endobj 134 0 obj << /Type /Page /Contents 135 0 R /Resources 133 0 R /MediaBox [0 0 595.276 841.89] /Parent 126 0 R >> endobj 133 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 138 0 obj << /Length 2309 /Filter /FlateDecode >> stream xZMsWf|7IVزcQ{EJBArz>H)⦒r 3o^}2xV(Ɍ+.ʅ䂐jo7R8i2Pe%´!L Y2Q2$`vlZZN4x.8+fn/&p{g\*!#ebV>@|:ZRelY7ٽ5upDޜuf Ȟ4領7!h9)9Na^'27? c1u֚^-"d^rw(^V0:֌Ң:QE*)ozqr`D^b~G⺞ބk’H&u=R7?ꦦ d$X@P "ҁLft 2|\-m5nI=LyzM@Z|'"yO&`LKq68Bvfy;jf;zH7izj1 A~*$\ p5NIGű4LIrj9QɤQbG=s9V/&) dL!/>OHCUf!J9,wU} a:@(nŁ(p҂&=L"`XJr4{+v~ qKx5i$uhd6b~<+2m0tq߄BQM>ݮɺUDŽL65'0{Yp/ 2@'0 Y>:ƎJn~e5lwYy{ Efvȉh9 Ն$J ^܀8PH9}6p L#R0Ex9BSu젿ֺ|\(G!K).hOnɑM>"n Y`GeGQԪJrS0' 3$V,DBDńQ!߼`cUjse..O.z ?y^)Lb ?qxӡrB[ZŲ/Cܑ7;I4(J/ 7*Z:JLՀ>o~ۑ0HҨKF/vy~q p'Șl8k/B˹M?-^U |]'Tiѵƶ2z}};P2'"CH"|P@IuP! dgLd}{hUl7˞d.^wjq-.f,C0N'WO| 4E;4r!qqפa1Xt b0򧾤T.W i9DXRl- 7Sgt'h#3+dR?w!7Vs>\sہk}ߗxOf=}U!PfkT-W7;M%u|~L''I2f _T\Wr]\Ǣb&K7`+FyXϛpy&]U*)Ľ/q'|Dž2|4io xl6*Yo&OʯڗVvhY g+0+ -n<%MZӻp&m> endobj 136 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 141 0 obj << /Length 1560 /Filter /FlateDecode >> stream xXKo8W(7Ži mkm-'l+)wd%h0`pqf&o>d%Vhψ62,l%Iʤ"I*ߞ',>K.g' (|Xdid!Vh7rIF'E`L 6L$aL':h N*dKTH?jIJj"BToL5}Q#nIN}nLk":JF#W IգV (H\U[FbU90brw P wE{ԇ(6Ҏd’ `wM#0pHr8KgۉTFCE%RQW|<(q4<NdpI# a`1xnS{+8W=.-P<#Z1g7X;! 8YxLeIj cow{`۸c%ou-ǹU>FZ҄G e9 X/S(!DЕvh 'd{ b;d ,&B5Uq·eRk\{~gLI2jR#KQf /?߷ȏϰٰ]}u {롲I*aTRewPM/NNNӞ_$,#Mх/ڻaT8,dd(* |8Ðy-DCX ]TPgPۿz+N iUQW\io{ٿx1wxq 蝍d :3rm kqh^lw_KZ!kT݄)oB&^Y(āws`p1ue?O_8ǂдMF Њ:·'.5˦D 3 @|(=H/ȱdths}fsPjsj4N|8{<7*\ImL+-_Ba|~umׁ˽]&TQ\^wFyă fn"Izށ;Q]wh,!(%4I3m&ZBi P[x7n= ϔDP/][e)?j_?J7 ;;9| _D_Aջ?޼Yb~bsCW%>lk=, K4~<JW2<8JX>Lendstream endobj 140 0 obj << /Type /Page /Contents 141 0 R /Resources 139 0 R /MediaBox [0 0 595.276 841.89] /Parent 126 0 R >> endobj 139 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 144 0 obj << /Length 1778 /Filter /FlateDecode >> stream xYMsFW&|-*jŢ́adHʮzfHɖ*MAMwO,XUL>Bzx({[Lfz\ *'wRJ?\Ey1mnt>O8)nF~/ލ8S_p̙xijKk87[R BmoIÔqd-Rc6mS^,dؓdpgx&*:&OcSF308UJ3QcVc(ب I#ڍJ\,w qʸvxM+X9漆eZuZzp`ZkOǙqPV1Յ$dNzYW[jDW,(`B=?AQno{8E'rߞZ&cUܤ0ΜQ|ҝC-(ưױe>bEM'f(Ɨ{Z.-q:G./Kو>*x4xegYd]#qζ"yRw>VO))U5NSM*]lWou6N"~ r lW3T]΃J-T/ʬײַ?yJ68כt["i*:> /r\PgPb\3^lBt1)';6X!|.:/nǏXR\6wd=砫/+￤ _.0k;!AȯNOz1D8wq߱rN!xZ~DTg ES NSi+}EaPx+ }HRV1PE`$25YMe:j,+:v qr _mYnMۻ8q[KTEWՖ2G+(j3y`bC %DBeKG!#Ÿ8%?0CH% #3ϙyNɏl阵})!m@ .: Ρ` %GO|(ϙ:S({8I}dD#>ilIs ڣ}ؗ;;f׼ptaiB.CGdfWbn]J\U,h5)սW;EYM#foʫO`I98)i7u泮h$vti F:#5ۼ ݊7P\; QJ&tRXtʼn]H6Q SqZSI']YϲUH^Վcdm*D*i*|Jyu8J$.eLqb6 Ḍ Yð4!^"rbt #FG uF\b@{ޟ2ͺg!P,mUcȐOވ=dWg\%d4Վ#B4s8^~'LdKN sI.Fzgߝ+8rz7t0w0Q@ idy4}4g"msE$tg"BVu`oOT;C)*ШE|kXjeZ.W6D2Vsrm Ø򮩓tq)}tf;v7ofK,͊r)u}[EV'|)( MaHߒs;> endobj 142 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 148 0 obj << /Length 2411 /Filter /FlateDecode >> stream xYs۸_G*"xoMLiihIT(ڞ.(N2ӎgL,^x㳒Ve痙)^fqzVJ_׳B)Log;83dٗg8S`̙(luٯghPI聄H96ܧR+)KR̃@/KK dL}(0IySF3i,+fۓ§(ԖI#A%4&H,35VQ}w3QHJ9Zs^e\i tM{ˋj>S2=TqKOMK"Vg*$"lə3j(= d`VAGa,[ST$5np,j DFH`gI 8fFwyW}լ8:.ل%!x]9[z΅^Űk,F; 3-U``]ϸ-٫⢾m,aTA<|7]~xj=BBG9nQeHR[vlBJ'A LI}B4_װQM4 71N RY$x3 -wn? 7<^2.ÑS1d,bD>00]aCdY_Z`RI/AS4;10?(L=BٺZxn:>m@5"cSz,C})阁dJd}P_!O+*F^$D8#=<u S ꎲNjytWz8 .|A?o ¢_n.|gіmB#A|O;Kjؑ!Y%3`ɕ%]<(Ba#\Y+ڠ-7y ۀVa_`O::ܽPHYO("2*QrE*\= b5O>аcAiߝ n ᆙpYwhw0 (|'<G)v*VJ_Tdqk8,΂f/tz '1-(}Cd)fܴSG;*}=Z8h71Pr\.-V1"v` ~T ?w]n ["rͣSh*e }Nϧ2:Dl/[|sE?*Gdư{ yVc6`8A`xs{$Uh hj5A)N0z}|˞F[%pyA͍Ɉk yh6[Tԏ(G=9a,qd{u=>-6d{Io[zΗaE3}ݸmɑ-UJPC!?aYuԷ]~qr mT=1n &s8Ýeq^^8lPuC ONzxwa@6B1NUVH؋iaI5::VC*ڠ#,yI|#]GgQK &CЀaK +R{ۛ#BiavpD2;` j9"nS 77𴱷vC~/"*Y?!ˁW3]ERňYm= J/L5t{+; CLQGa82 UjBaLLtiS9-M(fOu=q5/%%FX͈S7#<=Bsɋ mLԢTZ,DٮIzT61TlH)8L8H.Ҹ'OlP] *T܍6͕1p\6Y<2QPVcJ VyXJL^ëphQ`o~~bH> endobj 146 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 151 0 obj << /Length 2124 /Filter /FlateDecode >> stream xY[۶~УV ض NA]ؒ#1_fx)K56EQ,e8p lUiSV9TGYFIl1ӄLxv_N!d|~O7 (H(SBE'-'4z3D<:BuH.\{3uߎ! ٱY2u>TI2P2dY5Sȓ+ sX(`vze\_dfR`f[z4ET3h4yQNrɌvicp(֛,M! P\U; 0'Xj,X4Md*wQW5<v2)b[~;M4!@K=0$A8ƭ}[ M6%F/|{4ڇVJel=$ee+/G6j%O )SJIrfPl1Vx V<,n͙c9}|): "AIz$B)4O #:j{t;hek;ÕvcL ,pz3/vb_p֔26.]/\TK\دWvI2_h6fncz{p)(̑RƷ9f[\#5Lvyh 4CMidL);>};&$K.09(˙q& (OtF r DsnX  l/Ft!jm@_ Δr Ƃ 32&qrBW\/r[K'FָwL{WQWj$""W u|(#X4f$޿{$A0<P5;TM8XY{ &΢2Adk@f >l$C ̍+$IYXz̬ z O8ѢqNEqFvx1 H䷩V|<> o\[Giw&Ρ՝t Um w!nugaĢD$ +Y6At :a!삋b6*hs.6k֍sٲh %ܾTIf$LAΎJ;34A2LK :w`Zh,w+S ǭSpM\ڠD-&W+5}b&N⮫őX8\^m{+.lV7#YbqhSA/ ,#LXܹ欶 H13"ZS'cCU#PgsxaBĄ2V9QR9ryK/{V LQ.)^HrU_^6 A(S0MFXS8A~R{Ҷno&ώY ӥ҄,$`t4$D^*M}ejrHi&fm…)#bYh_Op'- Mbw_ESc% eoSf pJE@=R |/TP+/U*\FZA? ,mghyM,h|W㓜ٝSŜ`TrqDi:z)E0m')Z4޶N*`&o|w~e1ϟ/q#i3ȯ͢\ՈTe;> endobj 149 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F27 56 0 R /F23 16 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 154 0 obj << /Length 2832 /Filter /FlateDecode >> stream xZKs7W8h{[{ٍR{HrQCe ))_ g(k-VJU"FA~qm= "8=XΤJԵ]\Zy)i֦,xL*Pͼ"h;[ܞq꬚?ڕ!nόұ>=RdT]\'lbw~+_Lmm;4]˓ l[\ܷ\[5k^دv!fY[% pXb^  8e@~7=^{_ U.{fDLa@Sv uUPr/4wQ9}wZn\@Yp>[0"?t? rߣ|] 5 xXymL)e9hVF:|Y5ܠvu}C+uMٌ/HJ6.ꟸJHD mzo gGvH=ٰK/ #GI;4תhݵ۸gJ>Dujt S |$MhB0[th`&X2ny ϔM )rt5U'`ZH0P ʄZD{G bmEe dg0.v'P;cD-9v+ֆȫ 7 &K#:!gfuB$3ZZ3nEꩣ)UQ V^h lzԀ;trj~ko۶m *nT3~/wkVykl7WT#>x]sЃk!2nN EUS0Ĭ,ٚ@7ٻA㑢hl[z6_1:_GPNj}D]͵s"l[t 7q E*6n#F0U|rp0Lс>qNGq08(OhUҁtt)"a=T$etDg բZTzpySGRo#]P#2wWoW;#$Q''tGw[Bz:_Hʌ?L$DCF˿F$eF;S@,d1jlJD[A\i߮>d:T1g+ o):)MQ* HA`N=JXO#ɲ<:DbMDx-ϠȏNMe*44E&HZ<&v+_|HEh/]*AU|[L!BG7'+2z-901l@ C},B\n'p|"#򂑞R)CugA`D"yR{/LA=QPtفZ,hT.lsآ3KQD,~榰HUBa |*jTٯ2 ëeSI\-]:4~ `_m|;aVekM4 _&V!z-ðv30öv#:)aջf䎬?ܩ{QPV!.&*3fA*6J+bX$} @,?Uo/8Q=׵59UχpY{tsUb vA/P_E7G j>_YҸDH _ja{/ )'̈PK`EGTX5]s~ǹE4OnھOfE[mJ'IW?^ߤ|/jA=}ꊂbqw_}hƭu+6SU'`bLc{2,4rJ_@endstream endobj 153 0 obj << /Type /Page /Contents 154 0 R /Resources 152 0 R /MediaBox [0 0 595.276 841.89] /Parent 145 0 R >> endobj 152 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 157 0 obj << /Length 2693 /Filter /FlateDecode >> stream xZYo~ׯrfO<;WY@E@PB#rBrdk}hr832MUu|˳g}<5UFQI}]~"Q6M|.16~~Poo/T$៊re.qg&ՙޞIar}*ϣ3Mhoޟk!h2JŽ$EȩMCJ$v¸ @)Uy3e1-Ћ%$PKZhB˼g+qpWa[oU&Sy_!`l!h%b|SִJ遄wE\`Ȳb0ZO=:~"W hSz^։Lk;Ë*. Ȼ%;*5O%r VOP`0N/@̡ObwˆA7UK+*4#Ąfb oz'>Njk}Z+I=śE$5˅Sq>RgySW]쫦x[i>|6=_8ФU&ʚV8,MIL~ I~MAP Bk,;\~іEcDZZXDƪU96 K83g٘dPc Qpc~16eo7հ7H )W!l />绫0:/F \3^A wx/%ݧܿ9NlŔיpx`ާu 1,Eo }۠Ճ..H屢*d%܏xG:mu} |&s]{SU=?_iFxD88la-]U&12 Zuy `sB#@eTvR`6+"36)lhz&#V3 XP"ڂ;ln*N'AUscKqHCe`kUE7 ꃥAStw)I8:a}5eEn),+ ~_s.H褆"*6nvky>J&"NyD||(Ofw`Y3L4_PDZcC&¹xXF}A; "rt6#e|oPO?/{l3p -zj"ǽ oAQVgUsi f9pnht#o6XxH=IF崡Yiih/ LL^&-|#g3ѦO8B2> ؠĊ;v5]E:8݉9Հ T~2Yl̀@ Xd1~ޛ#W|S'|]vO#- ].2|vA`W&#,O VB\.xx㶧<ºOC=,91I& Ku:Gߓr^HgʝSo ,)@ѧsORi?p;"o4pq^)ps/mS.JSj䘎W03h!NIK2KBX|(&?Y0w8^mo^;D`XRT:zhA~S=,CpPl%S6#a}L@w ({Z$2bVoI q"Pj X qfJ:C}Z@R,&&%اLwŻendstream endobj 156 0 obj << /Type /Page /Contents 157 0 R /Resources 155 0 R /MediaBox [0 0 595.276 841.89] /Parent 145 0 R >> endobj 155 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F27 56 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 160 0 obj << /Length 2409 /Filter /FlateDecode >> stream xZs6_G |D;8u-LDۚ$OTbYn:1ApX,vAGLDۈj"),~e2E !MX|>8z? MF;f#}Q"L=fL0\bt5G LҀ;hE4fw] NAb wq<͖ fV(nwx_cπn{+)D,J#Fn=XSb?]YqI4dJRIeFADx* '΀W (KL/V:E?p>+M_RչtLA$UWƷr̫MqOt7{nwh%CA ,}Yac&{LjaQA>9ȻEYIH؛Q&39JO-4`(!AQP֟Dm5K'dA&\qA^n$7wN '8G|3:c?=!Q9葪ҀYOu9<nIPw(>3 0e\hqǡ"cb8b0=c;sXcp1FN`I]/,YLnZtCOĹǻ+9HpQspKa 6Z UP+ZFKp)D͊$ qkZur{wn@r|Y!HYG:zN!g?EM^y,ԙP0)!Q:ky]IfkI Ű3/ P"̆ Zp1#|Q7ߚ+ 5X61sm|>⩶eƖ|W"Rڔ8ly>S¥ڬg B'LX[Gv({k;&Sa\FGJf4Y徙s/rcE6G:egIp׆TM%@w]]^hVJ)824;^isë-I&?yA\CPm)%y? ,&6$;j J@.M酹!caɈӵvjg%N,HM2ہU{=xQ=܄pP´mi\a([Nlڧ:eq"YICډ ¿^-G2~C< X\d߲+^8ڙX|&gəh^%9 xKZ&gY|%-j߶Ovros ` k)eݓgP>*LB!-Ey~'' e( fp-@G[wClyS-*/Ivl G\+DK ox苫i3SHrj*g?8A쒦 ²琐#[y~Ke>l#UzL` $WH<v\9^i\qJ2:ɕ|W>;v\nb7jG6M0,y׸߮_69۵/}q˰i wY-ҼMk(dpGzh:dFol+= ,W>hI^,r!G2ZwˎK /XΈ̎Y=4`/ڬ73Ū5.pZñ1Cvo (/k q~G@ -_ܐ8gELZ=tm6ye {,Y`1/l2뻶ĥ1ߍf[d2J~7Be-7Oz xu[O%?SHBIOmT$a_ E4d<@a V5=%_YaY,'M۶?iI*C̵{Xݺ8}z0 Fogdh> endobj 158 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 163 0 obj << /Length 2881 /Filter /FlateDecode >> stream xZr8}We! ɼ%FneHԐ$ow ASSlq> w׿ģOW#>Q~| Q½:O8٘yFI0d'\g}gY$}r$= 8R!>LQr?Po ˚s(Ř^LX|Gkݟ> b~dZOοe'ˣؗh8Od#32潉7gsɰW̼f{Ԙ}(:ѓ8=aO Y;Je$C1ݣ/2ġKd6/q-!L7oP%ߌ'y*o[RZ7XB^ZGU, y[t2a22yP]~XK?O jaڋNBTlGs0HӔ6`ino迌jC*/v_"++k鬘_1C6 Cő#](3:#B1T P!D#kh΍.<$,}{fEsLCI>JPYk]90)a Shl%l_ enOD/M[)#̻C! <N}@ )jS_X1r5(2H:~v=X6hk(7aX6#k;ĘU $O: b/{E5 \c(}ͪ6Fj%aDDM>Dca 0͖v4ZOHidx̽m7"5&6 %ͮ"O{cJfC?c ?Ei`-9=wه*vP$ 唫>W%-GSg@ %)NP&I !&␳ȄuN$ ĕ]TwwwC>(_1r>GOBVa|n&qAȞw Qg?DN{ ">;auo)P?Aus?eLp+udFqdA"pCR2HR\A~T#$Q=L4E)Ae&i"Lב4[O٠Mv76|yCINb ONa>Y| T-,vP? Ycon 뉎+d|n,]>y~HM UA?B&20 ~ W2:aoUIPYEeh3#ŋ6 +*(4$?}eNZWiOd*cNGc/Һ,~!6ԉl#0M$>PY;nXTthFqh=h/X JbɻN\{TNo(*(!IE'7c3?r)iNCNa>{ T-yuP]M/:.BX #ĜrYw6=hœtqK؞!,%?-?*GDTs*@R*Kь$lq8\d>Jl:J+afh6o{Gd, a# SmL= *ԣ S]T۫8N:N/)+IF&UuBU.l?T/P^=Lc<#{J3~DגGr?JA' $W <#G =( \&U_,?ͫ=Wt S.X>No(4* 4VjO~t(/wq霻Fꧦ2ŋ)PAnowbG^ғRZP2c/ǔ|~M^(}oUCJ?XB9V7'9_8}N_D{>193/G3p+DBvS0Nrm^ ˘RfXa-T'ä奴G#[H{qs3>ٮQ=Y#1ׯ[lZdo/f͂#B\XبE0ej?uKendstream endobj 162 0 obj << /Type /Page /Contents 163 0 R /Resources 161 0 R /MediaBox [0 0 595.276 841.89] /Parent 164 0 R >> endobj 161 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 167 0 obj << /Length 2409 /Filter /FlateDecode >> stream xYms6_o ;|Kr4jә\>(esFTro PEjdbX.}ٛ"[3! Ϝ(lv3XhU~sWJH䗣O7o/^\?y9W&_qf<{{Eڜ -Ul/./XIf\/Bw"FuWT;i2.+`A^]2ؓb񮄑";2$l4se/9ȢMآbE #ycebVaQ!m`{iT9q5  mbU=- A>՛ E0 60$֋aN,i*VB !Hy"jmT\`0=i^ Rp*aH=a{ C/#VAXk g*:! x" .YI,Q[b&NEٖ@&%-LЯD B~L!gr}'iqǟAGTJnߪtSEE+L!@dAQO1Ń5x@; 1B BK`QQfl;Xh HnхarTtHSzE:TtE\uh98^u0UG}'po[uluu[h@/- "NWl1a쎚W\& 9P~b}nY͎)=NgS^?Po\*.Tn|ǿF xn,:PLbo `ip "0~!Z]&!ƒCey?-ВvGP؛W.BoRZCc xj&hqءT >B]%F(g+"gqTaaIn$0"g$ EN Feb =K[|\s,$!υ|"?z>\X)ڎuIv%+3sDef9i$6@jo'M[ߡE CsߋHf@,IΦH?{>)=A2NqIj#s31Xqnf>kR_#5gC5)lj$<Xm$IDZ(q >2+cVUnD@$@!G$W0E̶k M?Y!ʋSǘͼ\R(rMH V$NK2Z\~?lFfmC0Y \Pdp 28~F6L&FL{:܋c!}8zgGJ 7P #oxLL$o)Opi>K}O0:ŔHa_8oQ3^[T &CtzM;2:_Mn/# 0 x'sZ1y ꗗ?`1gf?x>]fZΗHʛے(2Ho7Ѹ0# Nendstream endobj 166 0 obj << /Type /Page /Contents 167 0 R /Resources 165 0 R /MediaBox [0 0 595.276 841.89] /Parent 164 0 R >> endobj 165 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F27 56 0 R /F23 16 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 170 0 obj << /Length 2517 /Filter /FlateDecode >> stream xڭ]S8_GO6V$YTm drypf s{.LVխoާA&2Wҩe$iL"e,/oI&<Iux9d4OjDWC6BS¸twG`b: 6H&.}6|Y.u [5 TeĪEyVBy VNDEŵ[<tSOQ`0Hm!#&QTn+Q5p,^O2tP T'9JU֦,80zcʌPE=\C`]b6/^QbPZ8[HiSs͸"d@x+`Di;L6D( b@sT4Ǫ)#790IPpÞQO,:!#Xl jh’#qgrY.)i[ޔՂG .084`wmAVl\jZ.yQ Î֝MM t9[Hi09ʹ | p ‡Clň >Щ#c8Ϝ{|XԺ7me0^oq;='.0dʨyxxvwSw( S6ZWB>(`z]ܵBM`sM"ċ]iFnR jOF݂e}|']xX݃ei=Q]^Q:唐#}&7oj q+IX |LU>A7:m^wDOӇ^1)]It A$ )rW^ե~n>˲|@Ǧq~u]TqA׾d+N_C#MQONƷY`,,oru\4o-:~1[lC{+[j%T\wϞ)(,XŖ`Yp6>/xY5UNxvfVbiD8ſhۋ {w^M׳^BKgE}Wīp3_[轼mӷWs zMQcpL=d n;+K9W s7QԺ}K= IzxV5"qjH\"5ƂMQ=o)nƃ?_Mup Y= h`F副!{g~ ifĎ[G#-'Ms@voj⡤wb٠Y2^_1RgOrn2ej{!c>g6*:W\߽ÜF&XI>~}kg=]S)кS`(^5,Op6̬K m36l )_Q.Jy=g)- q;~}"7"ڵ$(PhpQy< dQT: ޚM%Jlׄ5zĒk~+10z]'kNc%/ҋ9> kC7j U,߾y3C :B.ĢhF@HTB?[9tp XL1wendstream endobj 169 0 obj << /Type /Page /Contents 170 0 R /Resources 168 0 R /MediaBox [0 0 595.276 841.89] /Parent 164 0 R >> endobj 168 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 173 0 obj << /Length 2504 /Filter /FlateDecode >> stream xڽZ[o۸~=fE-M\lzIrgnT[I:,733l A!7f7aH gC$L0}$pј81͈{l>aRO |?0H3}t4v_+c BƎw{p@0? Zܔq^?qe2Ǻr5 Rʥ\O악0 ~87g0 @q :ԛΡbj$V2\KDEC^B!#EM1Ceqk^ݗ( A Aٌ9gigAAdlqRd]P\eˢ>/Cb0.fpLeS *G4Yj<"EaPUUJ1Xujz `f2$Al4 È{{J\F,JV29#u*0sR&T5MWeX68BZjeX|`Y'XS7| 1JmV+ }kkD¸.gzh\ϹוQF*VZWzep彪#-{-X\ Lvxt+ҏy$d]^%A 0-XA1t]Ln[[et`XrIX̶$:fB|2xK2 1PAhwk&)}rawY)>,eOToM>PYw2twP{,Ự;wxa/ҔJHBv:Xi')M]k$ }u>>X m(g!!ٍ}*.TSev6lsۛGN|>Â&%lePBa ?HːW,ZE) Xg* )C 2!8Xp\|Gz1@D) [LvOwC+4J14!~v|MN1NT|]TWٟӏ̷l|;itz==mp=ա*{Վȸ&;"V6%y@bn#DOl>PYnv2tP^Z$i4-X;^&FMq9j(\6AK]PYw2 wP`x,û;ЦpDp?}l:IfYߓ5=2< _#~Fqn>v*m nr in'$n'ssG4a1w9viY$ Ѥ#(yMNʐ&@3턦B;N޸@faв_rXٺ6W+J} C!Þܯ#8un2 anvM`DLF&/w5ym(1w祪n_&un1rxC4.d ABa٬tT] Tles2f_'/AzXLXmGݷDy+(<()K}"Ey!t}4t6 nn9;tlg30q|hVeOyWGtZa|-sRcIK,ҳ)ԕּٌn\u9x1FwT.900W;qN9N;V;>_kz|G~7G~Iu{R{TVl6:mk-ۼ?Vkyhw(Ekn[duJv5m |^ʡ', h_c)y%g{j(ZRJ6O*}Oi$AeB.&.qE`be/uU>X,g0_a UJθ8T9m*C*(SmKD$+w\_#ᣲlj\ & !`àU˵jm{q}fW<"7o&FyhW?Kw G>[E;~DmȬ6endstream endobj 172 0 obj << /Type /Page /Contents 173 0 R /Resources 171 0 R /MediaBox [0 0 595.276 841.89] /Parent 164 0 R >> endobj 171 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 176 0 obj << /Length 2280 /Filter /FlateDecode >> stream xڭY[oF~ׯ#՚Εd}hle q]- ZdR )7p8s\34Dt0RBY$HSfId:Hkt5ox  &"6,~-8x?ƱY,Fi?^ ndAIz,t"Aqu_JDBA+e`c3 %dHV,N663s,,.6_F{cƣv 3IEbug/Rd֒qJ H$CGt=LU8>6&6ZXN1jeE=a'sRws5:$,!A5!|Yo% pVż7Tu BdXM= g[6Fvqwc< Y=32!&\GuNAh/4B۝nPAm.9t$jQ ~3) /E ʊzN!ŊX݉].n?@:(e$4-4r)y^Vv #ew"k[]!16&W"U6mHI@8E<;!.?yMiUYCT\"O0s;!:3XVdPlĽ^Vv 0i֝WE eis5e?ŸY(M}D EW^Pˌbiz/TKYs9P]Fei d)(!CUBţ\-"-7S:s}'F(6K9ӊϓ9+d4jJzC0_k:$X H,`}qv!u2%װŢ50‡eQ#x^ FՐ@mu\'?Ÿ]7{Xu_[Ǯ2 YV~;}pwt-߷G?= ?}cC !SV9vtHEK;񰨑&B`=w[8O*6I !$ɰk]FP.3R)ayx[zYndR,+Ƅ\+ŒL>穕/_qτwPEo UDYZi/JmӊvXJYB~o[+6a?q| G+7,#GkeCOf㍍xK_#X,jdmM9&1฼'?4_!=ɖ)`H?8B(CȎawy>b-nUS[wvA`whsD`(j } `>旝B n)6~;ǶME<3’G7̵8lwJZۄN,s$_,JTbp*CRMnhh / ܍aES{_8.:2^z) nOC0Zga9 q'X8ґT k,_spW;3BخyUysG7>qj4OeSjhOmkcCHd[ g}F9,ЙRe_ӿJ~0nzJ߮_g" ?#DXm5d*%'{|t~@B?TM ]<ꭟ sǔr^ID1_;ĞvT‹J3f$S-BŤ :Y 7,N ,ov?TU3§5(; );ԦzNfSA҃f^Aן/껽2+ŋ݇OG웞UNC,DFcVzsUyW`oDb{V˯ ?12]EB 5Wˉv~-n81fw6*P} LQw}Kc$~ŧqֵ@{f+88yZqfRj$f^<>-@uԐȏ'MsOnVtj?&Qendstream endobj 175 0 obj << /Type /Page /Contents 176 0 R /Resources 174 0 R /MediaBox [0 0 595.276 841.89] /Parent 164 0 R >> endobj 174 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 179 0 obj << /Length 2620 /Filter /FlateDecode >> stream xڽ[[w:~ϯѬ3.yʅIBIJ9_?ںrEgF+H;ѓHf7D e/1"M_,4>,JYr&o'I_ړI{Ǔ|{{1J=0Br2>e[p5B&NZ+p&'-TνG T-7c=*Pskr N)MuȤw_Lnƽk1جM7<͝i+궻JYmD$ƽ2x$Aʑd?q0o>>#br@QRqx̌>.lBRĘ J3E@u}s~>n!CYJ3}%L? yBoe\+3C^O9 rs,X Ur }sIpc@rd݃rty{{SD74Ns\`iP0[tb`q|>@ರÆ{,֛E*R GoM$11Ճ,yjg6a@U'Cu9|zuy)$ c㙺 l F5&,wV5FIt\ I%5'09:^i癒0ݒQm VkId0*#vMtk&z TC=TLj[E6Gtۧ63r/ճPeKGOVټOIq=rs e }h#Ut4Zm ltCpR PҺQsjARadԗSٴhNep9$^ q*8uoj4~O>t7 6' 6+LƓpr /,qYR'xמRR6:Uۯ$Q1ɹ pY77M1PU rP]? -hL(yhWy9 h_&aj@ZAyEY|.L6zQwn I*;Sf>Cul:3sur4uLNrXѷvpkfx TC=TGZ4pdxzqtWgfC!f r_2~hs5VL*KLpsmgvTAT>0@sB]s[p-8}#μ"fn/s3 8DY7yM1PU rP!o hyCy=hhx>=ZfT'_/ڜXaًx^;yˍ&C`P n[0cBLfYdWS0k ,gR$Ӿ6=ؘ]D"=5rD\vKxÖ%WF݄Ӿ2c5$"vfkfs TC=Ta6@V9̱CqqU %*oಾ¸T"k !Q!qpY_a\+5Go-P0HvTʢݤO^*yɤ~7.fInv]2vVTvTabu ڄU%*'8ջ˫608C800"ѸT# ƥrwCk5y0wz.2(lKAe4<}[=a,NW֋טTJnz"@SC J'J9TN85*Wl$YWAT[_Jqj)&۷om\ID l\,^/\}ikMf4lU;떛 -Jp!TNq#g-`sAlvfS`*ƸTKzEKhK'P[エpq՞N"M?z_>H%xn( Kܵnq[cB $GY°XJ U\݈e}qqpr$.2Lo U} ෶(PDsҬv~뽡J+,m?`(V^r fgjVD(-ػ@[gaUGmc r?MU*J=;x%w:5~7u4qPY!$/O(.;q8goA0긓LE2&ucz֜%ٽk=)t(˅)t{y?Iuu5.^/AoYYV*0P*o߼4Ky[/60=)Sѣzo]~$ż3%Lsendstream endobj 178 0 obj << /Type /Page /Contents 179 0 R /Resources 177 0 R /MediaBox [0 0 595.276 841.89] /Parent 164 0 R >> endobj 177 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 182 0 obj << /Length 2515 /Filter /FlateDecode >> stream xڭYr۸SRXK]tv9MsfPlԑL eroLDQ  ~wy|Tªl$d/FYY[ǩY˛j*c|tD8QGXhr{ɷ|4=O'"Ø3Q-/N.NHIqym/ n"8J&eWV[A>$˳#ZMzaYysgZxZZ2Kq*϶35oPTֺm$Xɚ MiTV/ҎstUTk+*gͅ^k(H[vĽmz,T8]u(l+.*)K9E2yZUor]Ҩk\2\`9oxi&PuQi"z)|ւ̌s|{Q^.3lZC+o&>Lzݔ#1{'v30>>>JA(Q 4rT" sϏKBXQfn)f4rz4gL9҅(c_ǐ[/he<4bv@>+wq.\%tYܢցElBY6+?_KaHA oHNa g+ʝap :˾tQԔXrݸ;JoA y A0!E3@*0(rQ-YJ˞t`$o2pk=]_EukI_o[L۹Y ڢ>@3B)Vh D6< =>rmi$3RRxAaT14zZ*aɳ.NO_\ 2+B^eV0+1~Q'"R?)7~,/l H"zZ65;}x_ _*˷݊{3h]ڮ274'Ϗ'b Z* =C[p3C9<5W{J㒚8jLXsJoIy؜@Ͱ@ÝP-7"F5Ip(k8-Q Lc9G-0J=p Qp/p=p壆  4"LC 3g;n0#i7'$ q!#CjP. wT `@.J#fT Psv"_y|J1& L5v Z 4ʼn*Z 딾6@,-%ϕ;痰sJ߳;hvAuv~Bb _9[FdX3L lj:D /6ՙw,yʕgHӸ ppbI]ϳ?OBjan>[/߼~=EBY!nI5k t5հ2P'}NhߤPs(>/$iendstream endobj 181 0 obj << /Type /Page /Contents 182 0 R /Resources 180 0 R /MediaBox [0 0 595.276 841.89] /Parent 183 0 R >> endobj 180 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 186 0 obj << /Length 2823 /Filter /FlateDecode >> stream xZKsFWV1DrP$z"i-9UI0 Q%ȯ~ @Pm\% ӯ{?ܟzGȬ?dJsގgDzK2?X)ߎevg39Je'2eFgfgdzD̏>A;2F3^ݝG'R )d4/VS᫴rѺǩ{gc9-纘htfS<^;y)gVZeLiS)w `?lETzVRh"z`Ty.1A[ gF1h'3V]*J@Zcdt4bf1Re.ŷXKP,>fF(c9%",ҼQ S{[PM^ŐRARssQypRDZQ(ѣ_Bs8.4fǩuSn%ŽföKa=(oQW0ȣPgA ~^r]̾`:Zv˿sy{h@F; \.еKqCymS/D2sZdZxU{WˉI?]C'K[ >/H:patJ",hqc^T:o \Q9Q,A`: V 7wT-rUmZ So9 O4?6sTe$E+~@=0#Mn 'VN 0fS>Ƅ&ȌdzG[it"waGTxRVo 0b.K8FY{NԸ"&(g՜'NPއ4S^>z<0.uq6c, 2qk"ݡiPT8P# :}AXbK+cH%NLv"c$D_@8W Ww/.&ww`-~eSNP آ^ES(B?FAla?|msd7Y ؾGY۷s$\?U}?_<(Sw4-P&!XHN=me9X3T$r&yw0VcIw@̎%ʓC%#_? րث%z^K2UF 9~GR=()dBQcǞY `Z vT`%Ṓ$1Dlj;HmEBizp(tEݡtTj6zHqҍ@[r1#OC`R؝ UP($~[+V5:l$ מKu)qY$=`4٤ Dx0I˚+TZPO77F3.n. [ӟT!44ԍ]3o]^a$5v3q쯜3A4' tg MN F3_PIQ9mcy1X)ъ #3,ֈ`IƵ3|CVBm#_-pPZJV@*h4,$8)maWSqr^)6ƨy|/`S_sC2h)`\%SG@UnMF7g'ZK}*wf`lh?>L f1 ?r[V!,PYq[!ro HY'R~-]1~` .;Nl_g=m8Iz._1%+* a;\hve崻HG/ӚsGUz|_|J쫑}Yݥ IV՘/.!;>}ˍ|nI7C"pvwC<=3sefSe^K:J57և hU0W,e?0FYoCU:.JN#dY?59;:a27bW(f4+T):3Cj+]uvvwş@Ex`? PfgQn. 6>uJ W^hwGD)::QC|w'au1%vLZ$Zy\Wy\ᝨ{0HKSl.(-}AAwg9GNUpmidTm)4+/ ӉwX+fwL$Hsv9V-קJA~!9%'zDYx|/o.oZ vfw^ SCo=/DU4L]3#) L$e#]x0(endstream endobj 185 0 obj << /Type /Page /Contents 186 0 R /Resources 184 0 R /MediaBox [0 0 595.276 841.89] /Parent 183 0 R >> endobj 184 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 189 0 obj << /Length 2712 /Filter /FlateDecode >> stream xڭZ]s}ϯ̢A%ix ! !by"Q-r~OOd9V,JFVO>ы#'\GFRB'nett9q,Mtty]cMt|>wGGrdL8mG|MFӣd([!͏a<;8_'#'釵EZXX)W뗤gi%A8-,ꦬe}\3L4VE{5ݐU;Yx_]1rp2ynEu9tEѸ&F>F   BZ1E3j*qWi5K^WvGtW`QK%El<.9x)o@ja34Pu/%OxE`Trٷr"I4OX25@➰2 @|pW[d6g THms(QE9͢Ŧa}}~Y ڴZɹ)Q1GE]/(6+\hЬyO4.fD37M=,(u!W; 'W,*dB^$Q"gNDV LC<Rg8Gzc-rS,ziE*0\aDjܽVfp4vF0I\If&Fa ;vҥ ,] <'l@T ;]{Da,LܡpHܖRINVӝaTxItcuBL}eEi:l$CwoH(sGC9&R֖Y*3.ISbC3 M h79REe q&v? ˘3E[IbFK Ɋi{8w{@JHX^J(ȿ {do@1k n)yLx=n=,tiqx\roX8#FBG1esK:u>G!`+<݄d -7GĪlhjUD/|kBu2833jQf2;5m9ͬlQO7OҒM="&H2srSS)勞lV]`s}+B,'Wq~A 9V$-Q*S!SE7<&LJ- ?nc&LyC ѡ hNl4#Q$<&E ڵ.'՟4>~2XַP86u r-f=ܒk\ׁ{F)JnYP(|&ˈS7;g&Ds]4f,JZ4$ KnI=et23 !`C#n87:$5mY%kNSԓ]c#^1ůASM63F8cB'@4)dtys5?;3 82d~n~yO׋0͈u"-'}MׅN R߫'ڝaDdzye'MV8?Ź; 9$PvT5.qEh>Bi?úD?upJ~O E:}M_ Tuu?rۻ*„ eguXAABՐقy-Aqٿcl<x~v.XPWFZ+2C|%vA1)qyNv=DI k%SalG''CʶнDqп C/'rV6-: 38O[f i#G{͇VS aa?Vi:۳ߏ߿}"Wd qI^\[{siK0-چWba4E.&jzOE( nESsj(p0?V]0Ҫ VS!`v~^,e__> endobj 187 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F19 6 0 R /F24 22 0 R /F20 13 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 192 0 obj << /Length 2548 /Filter /FlateDecode >> stream xڽZs8~_Gyb[b;Mgt7>l%ԑ}%K6ĔD߳1gUtu 1]e_c=INnI/&">|p4:"rF\ ƍ!-*9,< ɤa{<84KsLgbBeJ::KYvAu9=t)4-%Z#k/4ThӃvuq:it́h$b0 -yؒ[%ܩn L ZJY$%㩰nnuPAPK07gNHFsb7چh,KY%3 !pm;v ˵;=h +ȦOg/J:†SgB0ЂRFT=hf'MG"ğ156sFƅm\?7=]mĂ#׃#݋ԈJJ;MA0V#j,=!}k fl U9]/6`iA߫I0Aq 㲘e d txX̊L}V\ԍY}12 3Y^/VYj}Q:9ns9R2j謺uVY^C\=Uk*mb_p@WyxA?ŀ ZkdךVJe ,N1Ť)Z kߗU~L|Q5ЌCL&3/\-IX_)os=ZBVl3W T`R&Cw,K%> C?m9Iْh*<<*vZ_q%{1x+<l6y-`iJ&|?+KV[tEfi/Y ҺMm#5i3ITd9GzAtSj% 0#U+٧sO+:ĝO:k i˱-Ii]>ߒE}t:w^U€0?4+F*4s?7*o zG$xVm,4o˜3-e(Q'[?'΀◍620L9 (W)7zXq](CS^3o߬džߕ7Fr0H`D: B8|tVXe4?HJZQC8bG(!ROdi瓓,oa'CςUCqC$?ˢ.R?ʒ~F /?'nNa goZ[am!Pv߇|ٟ`3@dzlA~l|'u?>{ǰbWeT[xbELmn)T4٥fpJSXEÃ*yVns{!PUT矯 âAYi@~Eqӿ鿩V7 f({tXt$+L>a-:i_MVqա׸.szѶ?^]gj|U꣙L^f:I8;DN5['AETnȋ'Q=2-}=֣ [jv L;FІZM*@&+fE+zbe/I^?%ҔbxbiOHɺ;f)3h4<2l&C Q-̿J=l9?-^4~[Z'T(j. }|؈@$a _jpۈeU-<]@䂢jp6 _6Rx<hlީ]j Gsg|H;td}_Rpnq|.VJ> endobj 190 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 195 0 obj << /Length 1853 /Filter /FlateDecode >> stream xZs8~_GoYVr#) ǃ&C-qf-?iWI>>O#KSxJ1'L+$'BM//{(cQXUKG{4z٣D4 ϔ0k"ObSkII\уsbS]+=!I5Iu'Z`< s?#ƈU^ܫ'h({'Йft1?#N7:ͮP2߆zv>GgAtPe#ƣ[ݮ e?:\6}Gw\o9h- gRkj UƋO[ kwMmg]ئhAc Adl1A-iŅ7LYP94NJ}tAbkDb=[f3-XENf3)Xj:\m"ȍ&xos5SSkiDX+E C|!E1?䵬(:q9 ؆B(=xɬf>F?&K԰mĂ=8#Ey֦(ﴚXՆ. T%9J`܆7wL% \J9D:y'-kļ6W0+ft~Od>>Tȓ,p^+j:vnؽe_񸂅mh;E%,B,ʒT_X*~2VF"vi-aj/r u$]A>CCG ј1Y'ǂEHLTb%5M# .2GҀuCx!(9?:ׯZ(`G~DXkO--FWךw̾yGH_H'"_Jj`-p8vosTp< 9hse@0p_0x IHS_uvՍ=dsK曒:Jĸ(C QDq%ICiJcjѰt/wHe|_ú+"Wۨtjh m XI PF \ DDqVRk'F K'./fiU`׻k g?Zނݩe!zkV7!RPOa+S)Wޔ& LmI$97Kgg8XEqjZnS1aEq>*fM?+n1Wpjc%VRk(r)]|0_d:=.Np4K]w5`%5U@j=P5EL?)i:Jj`m >9٩(++OR0IV8.5iE)wwRJ$H 2kKv7]%svLMѝkV qaƳb#oyYlćU+4ۢv5JmLX YFwkI d ..E`,5d.bq[ W*sE 8YKI>HW2t߾ 8L*&'cc\z~0 ,fdZ,{t_~OͿ^O>2'hai$b/_>-'UBJ74endstream endobj 194 0 obj << /Type /Page /Contents 195 0 R /Resources 193 0 R /MediaBox [0 0 595.276 841.89] /Parent 183 0 R >> endobj 193 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 198 0 obj << /Length 1704 /Filter /FlateDecode >> stream xXrH}WQeBH2ġbxp$#a9EBKdiHU4̙EeyMfb=N O8QJgc?OF"'GXL4}{ϣوG/F">c͙(z|w$ - }N2|I`H{簒خ~ $$qMMk~k;@Cj\!L7,LkW ?]=OIDtj^՚KBFkk鼬^]UnySR/KOnQbz:6JJ"xa]Sv a},a$xGwĝWա YXlVWex\GKˣ^~Ul!qLEH'|O{7*cFdLf{:f9̐^`3]AR~RU,W]4 {Tb(q⣔MPFnoN_sOvULd $bR4ߒь,@Q. |f!Q]VVz>K͸@޶nll־l17oOgIl+,2BNBJOkٞi H#]hf~Ä+P 2F5 M1a TM@p.@h}0!8ػ:DdaQ۰-u EfٞغZ^L.KOA[\䚻@.~#BbC/%G rYCKܽ7\~X{.8Wi8lk k!ϐ>=W6FmPv'-K-wNXrROR{cɜ[iL?g{ =lr#~-tNjʍ0ʛE*/RY]qCVz36Bwo?hHjOR7V$g3Wf8L ȅAXiTOΊZrIkQ`E;;SVtZUYiZЌ]yysЄ=Foi U5ď\C_6x]]am+݀RW쥧9_njok&TOMYwAf6tdy|IM=S%·jV$̇g?4ćp i'D9x:FKmީvB# 2*wi"> endobj 196 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 201 0 obj << /Length 2601 /Filter /FlateDecode >> stream xڽZKs8WHfBxc;;횭LD۬EEɿn4@Q&E6Tbl4>4 ~sC:Xf~Ed$fijF7O #L7yIë盏'7|?>QI=>|=9ǃ,},=(!`|GLq!Ylv xPmVhR܅&M줱=)XdNT,DLGrL E(=+\K\DU,\gYyOcv쾜˼ E|nLQ5˔EW̓遰^]\<#+%q¸˴<ΫH7zAvB%S*ՏddCV 7)wsA-SG4ٛ$c`Rޓw$?$}ܱ7 ^iR ̱ <&?/NșL(M \>N3T(7>eMʊԒ%wrB.9k2xʤ PI1>O+-yvD]k!(;l^{؎OG-1ox8 nPI730+gt3%7~D "+"JFrM5Jr֓bAڏ2L.(]w~0YZnhŲůp:10``WTǡOe,N>[U|0Ϡe:M_G6Д:4mq^L.(b4O8gٞ84=,*)Y2b; ,C~#v4F<ڈPy#nBkdW?2bBtހfoa^ZXQkjJdo)֮(ᣯ 䱵[_QDk`hsxMF:ndU햅BVʸ׎ˤ#y2Jmcveܚp8. z!fYdYefu&9۸#+l8.tUQ44ӴSb<˔h >r OE&9_\X "A֭>~רe^({#>\VEiU\e'- _6kg$hOF7 𿮗oG-< `:n[|~ _ [m:6d&yD[FY[E6i +UPލ*4Pj,'1QC=i|V)𩮆xg<_G*8< IyP-߿{>t])\ܬ}1-OY1[QwJ[+؄Q ?[endstream endobj 200 0 obj << /Type /Page /Contents 201 0 R /Resources 199 0 R /MediaBox [0 0 595.276 841.89] /Parent 202 0 R >> endobj 199 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 205 0 obj << /Length 2392 /Filter /FlateDecode >> stream xڽY[SJ~WQΉ&s%o>@*d `Rg+},6~g$&qmQ|uOѻi,V.2egApq0} (:T8y(FR:_Dx66tt:9?dTTQ.v{}ޣ2p!DKe9<+Ɇc<1;I!'xY9pq%0#"CFUv 2vٍOCjȼ'skd>y2w]ǟ{1= ۅqݔ"y/Ǣ'J'LIx0p,U~rݗ-Ok,ŌkYiHiF=shYR*p~e2Ì>!ӯ~uTޯr~Euy;CSq|dN~dqHgj̈fWXSjz= ΁L -SVxׁ'_}ۿ22c$aEN+]^-P?.f}*r>trؔq9ƥ#:^ '0kT+`SIE$_`Ʊ;kqX2co<%judy sԮ-!5 |atZwA]v:~V.腢]"vk]?Ke<nױFugB(4^Dx Ub8tf>E{ ʽU&=n\VovL OMUcLT'uڲ~O.?| `nw3['ozZ-ы[%`qw~IVoWrԀ[0eendstream endobj 204 0 obj << /Type /Page /Contents 205 0 R /Resources 203 0 R /MediaBox [0 0 595.276 841.89] /Parent 202 0 R >> endobj 203 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 208 0 obj << /Length 2710 /Filter /FlateDecode >> stream xڽZ[o۸~ϯܭX%-dvAGVͿDG FQV(rqH> Rh1 ω (s=M%r2"29t}dtAAH!`po`r@(E>ה<H.F Fʟ.`D,ik4pH #Y4=I(m:oN0.hTd:"i6kWk:s{lqgۚmbC'pq3gPj2E iMY֝o.^HPIfW8J&ͮȘWH=U@vA*gDۣ.4ь58Lv'H ^S%U]6S9^<,gUSM @YxV:wȂ0 >W{ [j/omm}@~A:rxvzy`T/0R>^tȈ#6 M.he9 \ Ɣph,-U^b QOC!N'1TSC2 m(l$VBŭ4v}yT}<#Tl}<#lg*t-D7|\oȝu)ea{Odd `>T]>lãXd4`HʱUxӷ-'PD=V6>l *^T1l 6^l1/G;p*=n\]NCfV8*@V-HвG3L|^Êd-=15ɮO?*0grj-0grCA S=DVr/n -l\' O ~Y.T#| Ztn wMA2?&N T*s,I΢ŸVˋڤbmc++"$H7S<#Y۾]ͽTas;Buy;L "@9ՏL2`v;%:9z+`cr=j[(Y`z%l!IbVLW.)mPgK_q7Bz 'p9g)+8)`)'̆/ 7e]>zi>ƤȰ+m}/xh1BpװÝh_u6j1dk8"-A4a{q)01İx8r: UU.OSt8`yYW3{'*kmKg4譋]`|,qyH Ξ{Aԕs7./3gg]qJpl%ה,@Wӊ C]ݢ%V='V\Ll4LJoZhZu}ە,wlTɢM+͘"A{]걃X6.<-X)7igX~ʸ<畱?ijN vG7d["IF.x``&|jEQdJ,hddI_gYAMqAAn1+i%Z3c)XWi<',ԿyX / 0@T3ޯ MJ#ckb|7W'G(S3^-K'hDgA.8P5hd'}4[ҏ* ۇĸ9MH${m/Ŕé/'ؐx#n ygnoA `5Pϲ~g3, uk!k-dO_ndI'TTA9.Kmg"6 ,s4qQZr$I2&Gy[id(DssS;T0O& \'U' ļbB$yw9!ـhfmV0nB;m%Ln&!;1Տs2XUooTڰ ӹ:w?&1~6RvMaܤ b{9MM(QÉ q;+(~2-*j}0F㱭b@w 4΀V0deKy%^ms溮mQ\?fa>z"h1@^5C;TYa[K+PBʃ3h={+ qK[{ btn-.)i4hLdZ=}#Nhţz(XJf rM]|"Pcrw5Y$d<&{֧8 ?X,BI!9E6ӧyPj_5|:,MzϬ_Cm{s%,S>S` {K)BB0YڛǗG`^9Hf 1t-63/quȼj6d7XO j ʼ7k].|endstream endobj 207 0 obj << /Type /Page /Contents 208 0 R /Resources 206 0 R /MediaBox [0 0 595.276 841.89] /Parent 202 0 R >> endobj 206 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 211 0 obj << /Length 2589 /Filter /FlateDecode >> stream xڽZ[o۸~ϯܭX*o$EӓIb}Jbc{m%3ÛHT(2E ?|~CO@`|; <Ӄva썰's,1!rK oۗBH-=ثl}: *NT1=lgc'6דýʠ% c# WӐ)m@E $hYա.zBa`ʉEOL{ɮO7@܅39B}` La]dPAdI2eu~dT!g3Sv%{fqF3ez';f4 AI#3fAec0B&u$3|if?Rw /@N+_m$}-ӽ@w*#T7O dʹdV72Ȁ1㳋Ldyf?GicmJxN6KX-{1_gW֨?q7BÓ3xT3a)ܦ/L7|ϋi3'i"ªZ,Ŝj ]nQwuimk1d$c qًh2qVܵL Gib18=)&$ ^T*l yUW==H"q#[`nj}~2z|Rs_8 Rgٝ ֕s_n2M^ؕoNcaci%Sy3U9o9řU P'1{\ۋppNUr 8ѥyFݕRlBF>+o .Aymr uu7 `A|oi]_bWyR;ݮ $*|X]|C9-1l ?g&a e(~2cp>>Rj4݋n S莏>òWx)z!%(3ӢYz cBm$$U}~5R'xmA@ګóۅc2f*MCU":CgQv £@9h,4&tTՌ/Q⮏Yn7Y.o?۠~ΰ*7l2$)V:[id$9Èfťa^` ﻈm1LAI#.;rh={VX`R$(J?^Rďe^ߑh_p3@" PfbFmV\z'6<n6]e]>'·ڈ|*׸K]%j I͊ƻj@BYo2SwbcRQY'~Wn`!ND@B]/b֦+Jf3,PI"dU U># }l@Mlt6KLfaϸ0 v| K@jK@<5%{c+Ȑtk2^8+`1mN&~Xcޅ`ǐEL}f ZF|eo>..b `Caje7|\O%*]EUrFLI)̽b~D*9~2ؚi!Jdn+endstream endobj 210 0 obj << /Type /Page /Contents 211 0 R /Resources 209 0 R /MediaBox [0 0 595.276 841.89] /Parent 202 0 R >> endobj 209 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 214 0 obj << /Length 2116 /Filter /FlateDecode >> stream xڽYIs8WHU,HR픷TMs`(QE5ZP)QnVC{d<4JDLj4$T4~%{9 !/_'g(H()BF࿃/_i4Ӏ')aZGσ מu@(| .U@ˇDq>Poy1Y^.lkFKlZG<_,^AwUNl?VQ`Zˍ&QFi|_簈gVe=,0oy_.bsfRc5'MyVafWS=?O.p5*.Z61Ѱ#ƈvVf V0S4~J-nIZ)fg~x#۲ًlh?gSvL>.TTןǗ-lR`sIMC#" h)Z:X|15Iq)61UOF%lh4%YTAo8hZ_Af Ird;ed]<T]<lw-&f5[?%<.;o) I=[=Eb8V**޶U uTڭ#| b[LdL*d0T̸8ܗ>^f8('CWf_Zb`yh׾4S$; V;EF4#]'|2'ppَ(!{*S'ϱSvs8nst#@us]ؼ.k+zw!5-q?v~EEd$U?l ddc/<;Q96n&7-d zAtu#KtHȮήns\b3T/[F#W0F/ܭNΚVUxIY٦q5үy;t^S`#_ty-|?Mi;ji&}0 VzŤ~t4| |oP 5-o Xa k+, h^IMټxogu℉}}y*HpuY3W|2O$ww:~rϔG]9q} /sPnԐ]ۍΞk^@3_bڼL_N6({Ε¶ij\?eayÆOrq^$pe!<a:-4rVroq9U2K k0cE<؁t5~RS05S;`vBbvtsRU?f٢5NMn |~8o~<`Fk;wh,SxZ=>qfI}"'XD<[="e J(&mV螗Dϡȼz.02XZVM)ڜ/q7o;lٴY~\,&ƘG-D TES2HDyy"SLB ?F=endstream endobj 213 0 obj << /Type /Page /Contents 214 0 R /Resources 212 0 R /MediaBox [0 0 595.276 841.89] /Parent 202 0 R >> endobj 212 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 217 0 obj << /Length 2540 /Filter /FlateDecode >> stream xڽZ[S~WQFK7/ZRԞɃc PH>o\dbwJ*ח݇<2ho#s"ha)aD >?>O#FDeyWlDp"s[J PҌ+"T~G-Y堦vjJ!VK:)_j'QK\?. QFSIrJs)Hsoa5DqըɡՓfG$*zUxU*ѯZQN;AVfD| !ЌgqY%aLkDg ;fQ-j6e UG2uWUHg* 1S[yج$Qȝ6)$ mmj6/[9H)F-8WJ&ِ'P2Q<Κ& '̩bTOb_}GU Ҏ@ʪ%~XXN%ⷭ)u* HOM./$,p, BCHNQUJtڽB*!;q,{}J ^t DHf: )Mu<F$d>MaFg|[{0ׄul⇕+/&kM`"-@jO.3VnmmT{o鵇9ݹ2n.H&8.p621X?"@z:hGghO!fq5X{Ut𓜱RepFi[ iZmDXdzffn./;8ce(i[+N.c"S{YiK -HIYfiy6 6/T-lyYayY $4&^lvRC+%`2<2Nɏ#?%Xҍ:ό_sYt@CF(TX&v̾DbbSFa ʻ[ָ~SyଝKƲ&52+ɡ ZYiKXҸ2YО;#Q1Mxuh{(evN}_VSd]rŠ:H ꒮S6 &F~1Uc>T-T'F'Gl * Ǧ4-lΏN!T0YuCKiS6b|T3do vf5U[xbBi9s%-K ]Lk+ ֤D捰dc<}[^#2a dna:ц5L$, RS#LI5۞ TYgYs [ /ϡ0zoAPmz` vt`ܡpN4  uˉU*]GY ;Go^x*"r N@^?Cjۇ*5aoC; SQxU[e~H+xbڌFUSyh'N!V偟 %hƖU̸D\?J:-Ɖx-4 ƷN&9۾Lt9t#ȝwAq7)ϩ? 8lrK e洛ڍ7jkJ5PhdnHR6z ZX3z\?|<#M1bN݀}k߳_qfbaK^1<U b/*6Ň28 Ae# J6㳋E.t|Rn.KwRks4uV\E=h}B["BFWBnT3h% D}=Atbr~ƃDni*f~Wrs UhS0z7l-l`qK׋pci<],#2wyWX(_,Mꯝ?.Jg9:Is4X/YMtendstream endobj 216 0 obj << /Type /Page /Contents 217 0 R /Resources 215 0 R /MediaBox [0 0 595.276 841.89] /Parent 202 0 R >> endobj 215 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 220 0 obj << /Length 1973 /Filter /FlateDecode >> stream xYKSHW(oɼ- B*6V9[ rd=#!,UgIV3:gaG> ge5F4PWH4dU'Z9#`y}z[{ k.ͤbMlPoN}^+Nx1Qfi!6A}6Ma;6-p]xb0]) pDprk:Kysǣ|:=p3\3XnTfy__ N(Bp2D1 SXP-J,ϻO1Q*duI@*HaKv|#eSla)jlS< @V74ۀgGـ4A7u7#"2Eòv/,  ŶJٔewe<w2Vޠv)\.jtI.Bw RdXSmatAi)^}i@wa< O}@w^ jGnǻ__@֞hHF> T%sj`tx])xuvg+J:d)+Q4${I*I;}J^1Siu3 ّfv^newnhT7_TMS}< Bh8yY%^g(!8m<$w.}y7\<2"^I-Bk0@A+kޥf)XT /8Hwl,r&jBH91jTP@x22(HNS/ 9 !2; pY&z̀opއaBj q> endobj 218 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 224 0 obj << /Length 2068 /Filter /FlateDecode >> stream xYs6 ~_GyXMݵ{pl%Ֆ=[N~I)%InED~ FX-uxJ1Fӏ&L+,&BC XDEFFb&߃h:ћ%¦S¬Ej IR^~0^AQP~Vz,s4҂pma*f7 /YnaO]`ӸZFrbSof%+i{BRӲv(J) 6x/Sn<Oβgh- "J#Vywo],3x2?[xnIľ˾.|ׁy1iuP!GWlBjH(;\6bd֐K`;tH JfELfcTd~(f Xer2T`ApS"˥:9a('AС(ؽ -j3q~—[Q"^'9l6<6{dAf+PM`&:^c8k1:]ZJ6AtJVJ-ђfvo4xFCrXC(j` ^Vz@WB=SBUcNcTC/صx\ʵW6!i}xb nslAS@o> endobj 222 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 227 0 obj << /Length 2202 /Filter /FlateDecode >> stream xYr+&C ޏ敊g1\˷*Bh.E5nH#VU&HhqN7a6yMqZ$qKu1XTN3&6fBg?g_&gPcQ8zd9ɗ %ʔ0Dr˫#mt.r.\l `,q;#U `67Sn\!-7SyfNuVXY Šc渊+-NZ&cĩ7]p-}C,Wa$z4ƷY^u`b~wPצcނsG,5q؂T gwq) lemo#`LEܕˎZTa#ӛb_%LDHpw+j u;Rl.~8Zcs]\=.۪2[Ϋbهk&eVއr`}#* 앋_Q\:P ha(p,^οgjf6BCaCf8nP+>PB0ج8'ﱌ?60F` IW#zc1R5=k|Q7|ugz;հ6< W̙X_P9aB6Z΁@lKNz*m 7a?5ⷿСƞPK}~E[Ks`@xekh-8mtZغq{siGl?|g;:B5iN!T]4y\$K&exZmmY̫|ÌA@5ڇ(\AA|,p*%Av]\^.OH^4R !Q9#VѶք ׌7":%DB#H,XY lhmn(\6Â9i:Y>P ė>1w t{(6סr*c}^:5`]o#qN0feUڡf ̿eO:\tTmp?(x[ˉUS85B5lߏ 1Բ`], ȌaIM^#E8[) W@# 9&P'(9be-99MxPdDJrn$G>f'be-N2ь(EVyRׯdUI+A?f 5=SZCamPm@A1-yJoB6nS)k\t,5Dz+QX={:oyrAxŘ ψy*΃`YH/oEdvƯT&Ӊp+k Hf:lTws̮ 0 <fUIIA6$TU>!_í Wg@-y"ênkJ)&h{ TM^Ϋ|m(Uw '.Tx~'SQa2Hpwt> endobj 225 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 230 0 obj << /Length 3028 /Filter /FlateDecode >> stream xڵZ[s۶~#Ֆq%7'Q49#'Rן],@A"-xƄ@pag~FoF\X&b֌&jr2XS)Ur~5Wg3>lRfwgW6eWg}rxQΔ8HAHIym;eF;lVK:lV65zY"NGYzDl 0De&q Uc- r?s/9(̶-k]_Kr)7in'k(F)4$}ku4-JjzFʼZ"ݦrFRKS ۑbE! >bdeү(@=*n*AlcL\QWt ރ7Q'4W2~_a^!"k-(I"KnS=(v}=se6N,KAyEoP@X-hm>эy1rbX Yμr|v愣r =[RcWAj=r+wuyuX茉ǣd h(>Ii'BDdV B\^0k#)0yI0i<4}|śCdS P{;dzskz/ѡCy 9sMw^],X}kz.ghi6[__9oeՂzwל Ŧyk=bR9}aj)J;{؜1|T/o&D.L롅 ,$cP:%~Ԏ4ˡXϕtk?ÆZ:V?KJyUgSgorSC,-\0-Uժ EqU$g$^IAn9O 7PXaMf)-G*}QNVUe3]Нl=H\2@Biǐ^L}K0p3] Xrܭզ#zvxتg=f]ƅ>Ѵ=aѥGE;CXcOa+Nc;aos܄O3c G3S`L`*w6,22UcS>1,a/ؕ §t`BeDLIuSk*oz"§w> dE=)(kOQ=*9Q'A<(*Q1G<$؂G=*6%\&)Λ@0,8Ɋ5؋!5b:g:"c!@ql|LƔ'杰ٷ9nͧ@Y1T#TY)u| [={a6؋`"-ql`ҫl@yԞ0/ #;U$ {86#)PuI"To]LI&9 2/82L!{=y]* iz afa%+w-ZZMv*X}݁ ڪsŰq-`K1zlj,D4[. (&tpp`oVۭ݁q0d}#p:c @]wd u9<'5 ̐V<>@|Ar̀;Z%8ݒCeuFI@D$' " 0HnLjfcsvUyghkzIW nRw9Em]% ~#W*zٳ9Z&p`ͶU7 Rbj3Y&!YQR}nHe"8ZĨ0#endstream endobj 229 0 obj << /Type /Page /Contents 230 0 R /Resources 228 0 R /MediaBox [0 0 595.276 841.89] /Parent 221 0 R >> endobj 228 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 233 0 obj << /Length 2799 /Filter /FlateDecode >> stream xڽZs8_1nP捝S;a`1v%F3뎻roGߥeZήog\LF,I"zvyU{1TgoN,?>ˢY',,?hI紴C Ķ ,nN@MUMOó ޯn9ew][Q,S . ɯ@jsBOޔ޺:?;"K iaH'G!]ctir(h >܇ ~Zu5’kRLK|'rg ⺩ ̳o,c,M2ˉe}0KGrl?Hd"v6źq:Q=j+#; +8 dc ψ'a|y~o?dLǚ)͟7"qG+[Q "*.R4,èfq젺P4\XKYiaנDIP4 kFe^߯WEW,5 ʋ,޵){a Sk j8OU{RObO[bOosx@o!Tn=Tg_?;`%dlal ?>?t(ԓK#Kk\47kQ_ٞ.MH@y䎄ZM{UzعkkŞ)$8N&KCz= s;^tsvuq*+">8(vIZM8KĮU}8[#͒Xٯ!Jy01 ))r1za  -c,|}IS#LJ2/(bXC³iT#.1iTNzF& 6Q>+µ+1ߪ&°A1%ȋThAȍU4;46D̨ײ?) 2iyKiac za> 9a[/̇9a]:8gҥM(+.3&7?}1 eevdQE$I0R2SbEPYg*@UEaqcK;첩Wa@)]lK#H%&27$XI%Yؓ9h&A,AT".>__ SIAfiFYv}gErl(:7gf(2e"Ar*hFNNéT]_<5,&Msji^d`+xs ;&cH4D(#ץ;ݪ'kXpFN@1YTUTBJ۟#v!P!<\9U(%2 k=H^?J_K7j&bƭr$135bԲG>CDd^J$dBC*ĤcQzFiΔNw]]EJ)1f<ZSP :|h_'Q?3#iy0t8Z9"iÐ`aV+4΢ -q@vq#dl"@ "@,='9N!@n./y e1?ZZ-3溵P2Y"@5NRc,% 1l ?H%XHӞ58>6 QLoOLE" zazt+3jH7be-%zpAtBta z &lWYɕ@?uެUW]csm~UgQ) )ߒv8(r$.bk؋C sdzqs`Q2#$m9R:ZRS dgSU F@_K9gCzDj QkGEm.%-o^^rXwgWekĂ<%M6o.m vn+H$ "I_W!?D.";a;"tuA0<[i_Ilލ:l/PXqz2Y]`U` f+Qܛ̔(8E1qwլw~ˈL}M/+LQ Kq ;MOy8՚^'o_ `c ѭ߼~y׆c~iFm Vo ,LHQ1CV(+z(0!1ӱۍ1kSendstream endobj 232 0 obj << /Type /Page /Contents 233 0 R /Resources 231 0 R /MediaBox [0 0 595.276 841.89] /Parent 221 0 R >> endobj 231 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 236 0 obj << /Length 2501 /Filter /FlateDecode >> stream xڽZKs8WH$sĚZ;HÊ,jpۍ(HdF*F7u3ޜ-jps;2g,,f)TPj*ӫH·oޜnNĀ?1( 3+O:&'|3U0LDKӓ4R FT~E`m "8G"Y UqXW "dyVQS=[}E %HT eiwՂ&uKVճ;Z5YsKsf ?Pw_wq#+°B;" HծL5xƄ|*WUFH_C ޙB"cWB1piJXfl_`a$O4<2KEA帹OU5ARTT]-ܮ \'FGӽ .uohռ_rP`)K^KOߞu32; cAƌQSydrFRHpX&hP~cʒKmeI!ah,DzB?'!= )2\_aO8^#~k1jW|#c!ނG]<=ꏨjcÒ[l#JV0n_|Vz32U'2c]y ~]-RҒI Q Kz3z}S| C=vG.t~,Q~a:WG*xTSu Z:[𨈷:)-f4Ѧ:v da !fZ~Ɣ EV*rrؚ/@M`Kΰ,7?& (&ņB *iz`rJxYOh´^J7(2%`S;_B9 C1ިF/SL,DS*?W.U/8"19V WF`(9 W!ʇ7u8ӊ)kÙu3458{7zw'ѥT69-`v P邁ӊ1 1 J]KrG\ycE8JP3EV\{)ڴ 1p"PI)i'9̽;60J (̓J#Z} $@U=ԯBi3;5^hm>LM ?ԉ*PH{iQ0  a/&slk[? 49_mW(+K7ܵb/6Vnش~&݈ʒ5^<'b ScNdx>q-EnQgI}+w%oly?^h%RlNHeY/>1qF8 ehF!9ZDqE+ʝ8]AC0+jL3GӃwRtA AgƆ'̮1+u(C >nY{=g*w ڭKנ5!}prtQsl_t?cl,^bn+b4{$D (%3Bӡ߯.st`c֮~Fn5،˭VB9e-F11t`.}+\P3 e~o:0Lra1z~B;{ ߐDmWc)/_>b2AQX73x8"ha $rU8iGt\(Qq" tlm `)OzZiD uUlX@Px}_y#CieֽtWf~]aMFJ,2!ݭ$b)m{2z@(3lH1`p яGQ՚cy\}qZ.7$nO#>{\mAՏ@N2u~TeܵЁw4e1f1нS[!;C (rjM ldJ@[; 0' -}u.}%!aPˍxB-V8V$wZ!`Wz]@4j8{i,RҠ<";Q[W=_%!**G1/=tC¦(0lZfpBԡa$?/`>PT>kO)|ж/8K^W˗Spx>w77ŸmYUlVz؂e㚒]ܻ~AOɹQ66h㿿mendstream endobj 235 0 obj << /Type /Page /Contents 236 0 R /Resources 234 0 R /MediaBox [0 0 595.276 841.89] /Parent 221 0 R >> endobj 234 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 239 0 obj << /Length 2339 /Filter /FlateDecode >> stream xڽY[o۸~ϯ|byطlŦh.'q=Tcy}Iן)ɖ"@D o1g`t?2gAqv0~I0:s*}/R:9|ult$Af2L:G|339 Ta<;=wM#"iʯcD"Yohr|:gY=%Y98 7)믴%3*tڟP,es+VZPieVoo ^fP3/\p1TG'YA])6j E)&TޯH+m#})3N"*0e&϶Pޝv2+da$O42Kx]z\̊u1ERI#"f2Au+o:ُa}JfKD 5U! Eނt~iQ,AR{ C駳5 5*CH"x>E `LYQ&܀Ԗ])D= ZNuc"å>5\+} mla~=zB[mE na=|~rQUcÒ[l`܈Hfer;>O;G2c]ꚹ<-ORҒI1,, pAp_,W4^W:Ƨ<~} rD.:?G5^fGUQPEjzͣ}آG]_tLSZ&NrVBmc LPŌw9~,1%cK+e9Xiۚ/g &W`C="9dibbR eSP2Ե;Hj:Kq՘EJJ3;r"U-ǎ<i1i9_J;֍"d/B\(I7͊U.r&2`%x PKO}Epec6Z^ WqpuT1\EU204 z ^`|˰n߯XRTaa[U]TT4}Y@FvW0$sc*DQ0* ~as 57wb@  ˅)RiVG_2 L\;(g=ԯbTv hս!^@EqWA4Pu:4[:Oaa 45 `l Y&^.WwweɊbbsC6U|`p(還\/Q &%6Q'K@7a[teLݜj+ܸnPuP2^k^{.[|Db0Ve(]ȫ؇lfX EVhW2)+бik_B32Pyq}u3e22Ƭ^i-b=,4GukLM1/o7Ve0YVޏ(mxY 1]ʢ9-"큺(/" ĭQS: Π I~ϧ\Y'+[-/|3ɨׄHg+\mP@$繗K#(W2&?)@+my!(:oKbYOɮ@b@8T-wRK"ҶW7\ɤCݨOt"@Zp -n(coݦ.|&EWCCİ:mL$J^'c? !`OojCz&bC4 H O2o/k~+}y*FU3UR7_NF*LҢgkBc8МҷHW8Xj 튇2/]fͻ/>0s3N"5+D-ĨϕNXmkCP2X65xGuhLR4?  Xɓ·x~n¢pPyO er!\PåSrn!(\m?˦Cendstream endobj 238 0 obj << /Type /Page /Contents 239 0 R /Resources 237 0 R /MediaBox [0 0 595.276 841.89] /Parent 240 0 R >> endobj 237 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 243 0 obj << /Length 2845 /Filter /FlateDecode >> stream xڽ[]s6}#|̛(SvwyeDTJ{ADy6OfL / b|SHEga<%fc(ISIdǤD2~ʻ=!dr~eeu(cv2$3}>Wڹ?_(YywJXu$}~6:wiFz eKX je K6-\*߻J&m&j$5T-6_] DJ59"-}ڽ;Zn-U_ˉsQu:w?@lpPMp_z\Y\)6H#l;ci4 T%P&GNQ l%2Gn·kd0##CٳufGBiXg@v@v>W0p~UnEp kZbqF2͌nU&TSn[&lUUϊ39:F yalƝSV!W] z')H3b`,ܜ9EiYyԫNˌr:ZlzZ5hˏoU*i;S"2vtJ2STaJ4S"Fu5q=ؔh[px=<{9>@?K tZYbr/Ԭ*\"sd8!}fB$d@`\&Soځm5Ca@cx9c䤅I6xo+\w:$K>&nw%2@K1^5ЉKo뀽q QrwƎ3ܗifxJ7 P`xJ7A u)xDpE3Kp|sEF+꘍I}@mdv{v6=]b`ypy 9!3(Iy;܎v(VPn7܎Q5shۍiEq25EJ GƎR8ip+Qy ǨFDiC$tWfwextG>KOd4 vMH؁xUߏ! 6r߲25&`W/{9DYz'.;F#C31I݌čoYIl!1<}=.2X%a`A!QcS ܛ/}L) QۅJX룔?wd\oR,Aal"ciFN+F7>pjciĻEcdjasB81SR7 ^(k/`+(2BA89Z|ґR٘ K)ZXGz[؁BL`@9\`0i:o2?f~1ۚlL+ '2*7/sdJ.ѯ\a vA(a:G1ُՋ/TFD 'vq6jhB;\Z_8V@2y/WB%X,wEl#ى$wz+ʏp╊W}Y{,;౓(r+*"J_V+ѢEH*1)x5v 2ծz 8mܯps?C{x͕[gjf+{i&yZmBڑ{b[X/@g/OyXjJx+q6F/XqSGr:( ,yGfvIO U&c.tAMGO 6efVJ[v[eZ Ϗ0<]N8 W+c[؜<,Q92{ 1-G '=9ڞDa4x.Xendstream endobj 242 0 obj << /Type /Page /Contents 243 0 R /Resources 241 0 R /MediaBox [0 0 595.276 841.89] /Parent 240 0 R >> endobj 241 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 246 0 obj << /Length 1000 /Filter /FlateDecode >> stream xڭVKsH+07Ln[޵rH"(ZtFI*.Ufz~λEtgN,FŊpS,2FܐSxqI*$<~|^\GW?N,#ΨgF#2Zr)!yFO)3wNш}@eP]rQR BvuO- mKR%T\C@:)Do>],nUD(!Fպװtx7R/ 9t$rNn(e`d|ظ:H}Pc2UZ6}qER` #"NaxmV^ȃi4malb3TBP&d]o,3L p ?PЎ@k_!# !x7TFQɝ@iwXQR&L~SV&`_Հ> endobj 244 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 249 0 obj << /Length 2679 /Filter /FlateDecode >> stream x[]s6}#5]!ɼَ2봱N6$;ȒJIvދ 4E٠N'3^][+I)Yotߣ&,/{JDkM?d?\,}OѻrG{eSBד$; +u+焖e/NnOQ@A Al /R0Ka"mwZ8ͲƋ5_XA*R ӄʅbRƲ_\aVjƍF͗6`m~/UWo<NI)Do@)A i.XOepW\ sذ2yGE%Z5Pޝoo|D= \BBejCoz1Φ qĮ]Y6{1Թ! 5H(YKURI~]HS@=tqOoZ#PITQ`B¡O6)a:`#9IS$kAMCҒkrl%귾:b@m+P+`9rh,1$ O}n8SC:Fj.ǰy2n-D4rI F0(Oݧ z( # * ?!f ǎ ڊ<`og>U > >+k+@a|2Yȑ.-|pk4T*R,8lTSZs K_tB_ 9 'iDl[\L\RE,ʋXM\ Uh.W@1р!g4,(%s\vBxYC?tNflk3<|;GzMەۏ h撢 b[lܭCs/a( K܂ ~wI5rNtBȼ:( dI劣TPI@?ahJjndJj̀&RhE$_D |'Ea $"$A$FQ9 QE0 4/QhNCh7R`4P@t(r`:3BAUB-~g\O .{ X=/caS4OKI\JbM S0+a/%qlLdJbJU1T^ TG0Z cм..+(n" K>1{ *'omIFZk:I*kB>l0%17=U/S,u%zTUyv՛z]"ë^"Uoçռ\BW$'p-˩[rx>:1ᙦs dW&uu[-E < zi18WwfѺ O?p@;ܧ4.|`  :@E cL&$TH$FFQ9 QE%AEt!~GQ^ p $F1@%W9PPN%Rq?̟}o[Q3+TvpANc/й;PD{dbUn1T^TgP e.r7p o.o\Wʚ@@</rH7-=f!ogJ2 }hx_gM[I]^+\'yANc%^z!ʿzd$6:D0 */QTN CTwg7gmtB4\8:ز|x=WDAXjQs4.V0 >o `B*hOD> endobj 247 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 252 0 obj << /Length 2439 /Filter /FlateDecode >> stream xڭY[s۶~#5 FyKmwq|jsf<mi" Eɿ^@(YM܌?EfK2La^ et1|D,8D`4?zs2$'ЙOCXTDJe0iw@*U GzW ''ł[lfO (ZGSVM񑶼^߮.#|qƛfe'ɩߊ,`wⰠWhQ vXYO4rflc0JQ&-ۮ[tJЙ5y:TC=|,݊Η0uq)i8N4Fc4Qsgxr}^Iʼnq(q]#8mS/TqڴqZӘL=ÈBtL9EDpOEV,˥m&lfKYȼˌ&[GIi!|3@@ m 9RWz* ͺD{ʆWa#_*I|W. yAfup""\, L9e n7j!' \|m@X}:YѺs,tT<5ά0ڀVHSvlX^f~"hLF<~-4$]d&Z=V>lIS$̓SA$fqpY˞zHo?& \Ge c5!'; bC]2]PVEUh1 oh99,ۡUOoܱ=BL_cYXt65g+\<_jTzSCQ}ϢymJ4a fi`} Sw܃7M49͌r(CvDxG׳uo\h[©Ғ)-D1G<`ŀ4bDc&;tH<U]̹]1- jJ J% $;f1ӕ~L?W[8]I@M2@SaK# Uw|Ѵ +GBP;tt ͳߙ%25`=O@$H!7$ NT ߃ ÌYG fݐߎTRC^FT2ֻ-:==uT 7xOS6)2İ_89V8$r٭+ZxLl}M$v?KNe~lgRgH;R]\٬^-:,Mid{]B[4iJ:` aFjN* #8s Im:9vm$n֋2|pY^0 ϒtIhZm8S7$" C)O,cĈyw3A$yrzFe;%P+݇gQs.]f܇wL>a*T0 kX9{ .ٍypd_Mg\KO*;J&V?]0WiH:s\GUvNc߽GIBLfѾʎ鑅@"u ep}(d?[i %7dP i:Z;,}oB}dvPIs SB1nmS U3nh4XP ?/^‘pҴDb X*[8˽ُrQ.j襌uZ/ zBVl#֌Xجȓm)m$*O՟}dF*y*QZL@;\ay6s(n|f>`S+la2QPDr{)L8iV6j?̖<ɅC}<izB Fzk,/`gWhUQ pFu_E{ B~==BJt{ õa_wendstream endobj 251 0 obj << /Type /Page /Contents 252 0 R /Resources 250 0 R /MediaBox [0 0 595.276 841.89] /Parent 240 0 R >> endobj 250 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 255 0 obj << /Length 1907 /Filter /FlateDecode >> stream xڭXKs6WH!'I:iL-Qf$Q(;Hђ줭3,b_iߍ#ISQrፋ&O2dn$Etc)jd j{#&O9>@Kd\7T>y\.E:@~5լĭ˰.qPNMa] [7.nӪخ`]H0ee`L(|[P2S@{ZYAGV xOg#q:y!d$c5uqyOar<:^ 2%lV< <n]y}`,fAt D3=Hٰo$VC_v\T$QiTpBBh\I,sP V \Ab?/w7v^5͒e}ΘK0섙B ( lLh1 Z d5ȥ_vZpx['tO"½IC& , $ ;*­۸Jo:|?y1;TιUM wk> endobj 253 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 258 0 obj << /Length 2774 /Filter /FlateDecode >> stream xڽmsڸSUϲ.!tnٽw}AI` #b0ٽLfbcK?Ilx}޲j޷ωe %y[û/lw4VdI#N,h~< OXkY2+TktɗuwB[O(6osJE8 NU耑Nb AR BreM .ml3yi|$7^_} DN5)"fkI/%]\t ,6_[?n/fchU= Iu\ (opQvfnb`׍ejn#b׭Un7ۡۈukScUXpNd'eoQ|' _ \߉!l7o+%JhPT; d(SdJ TE UoaEgfM3҂zivѿȒ~ȀGOg!ұ؜晟wbɢ\1Ϗg ŋC䦪oϯcA87ئ\aCz›PU^*:BxJEiy8 +jxD+K-1o]'?@5fZ4vb ۱L-ۍlת lnDZdVZ`;vvqy\Iv;I0vE䷎~;fbYS[c emBU ooMH+᭓Mu./{enomwvMb>ewhT~ Ɖ2F)ɗ0֔;L~(SO~JTEUW7ëUZ7,تW&A;ʶ}vA]Ͻ6Ϲ;~{'b2Ze_WCq"vk0L=M*SMTV^7+تJ\_]DH.SOMԔ>p% w&dtϹl$!bƍpid6]k~EcejnDUDVU@8U59tgUu0&1c(=t,Q|Q=r]U{yŸܓpYw۠RN Ӱ,VҍZ.n -VG>̫HFba8D2CǁEn\Iz:ui+7yPM[SHړ*GlC).ϻlIƨ4^oF@jK,h߽:W&] *0H "+*C 4~g͋ۮwua'yҺ_E_nϻaHXcx$'UtpqF2K{&~\S=!矙iPc@.J@& 粘n݋ /N{c csR0B=jaI~ )nCxKe[y6~MY…}dIѧYuKGƥҚ,3 |Dڔ!r  "z&)^9nn21meapd+#-QHQmזTPvjIy!>ጰR nRN(/&~[/E6DaDt0FF:Ϧ14.(q=[C[ABWٺ: :j WbB;f~ /7\ WJD[5 .& \8tjt/'|^ QBpGHmucGWu^M& J%K0|enwHf>zn\l= (o1u Xf ;+3t!ϯ_#a1Hz;4i6^.]_l (_\> endobj 256 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 262 0 obj << /Length 1191 /Filter /FlateDecode >> stream xڭWKs8 W(M+o{kt9tӉs r-yey3 ,YNN28]|"K|1Amd %Y{,IcE<(TIX%1]g,"K# BE4Zht=D,z1%h;\fv;HAI:`İ,2\xw p%SDܠT2J GeD|ٺ2qaϷnuNsiKCdtF0PhB R1h@՜(#- "9_;]@ٴsNAvKўU"U S)´쒯)1S]޷͡K2^Df/:C/p]{HRvBQVB%E# .8Q{nޜzSjI#wtM9$$짨 \ڷAt JȲq./no'ME}V?(w?8vKWθZ๾XxO] f$9ҊcRCᓚ*:]@$q&Ќ7U &;`/kk c"d US|Tnق<Ad/02:Ձ?d hX,QJzң"Õ1FM #2c"h׌YaZ)uP*;o;O_wk,X!wgG}}hźN8<i?p <ԨcUrJufJ.(7Xendstream endobj 261 0 obj << /Type /Page /Contents 262 0 R /Resources 260 0 R /MediaBox [0 0 595.276 841.89] /Parent 259 0 R >> endobj 260 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 265 0 obj << /Length 2543 /Filter /FlateDecode >> stream x[]s6}#5]!'ɼَ24N'EMdI{/>(!A<ӝgL<"ɋERRdrPVIg(T2{S5r.M/&oNFdG2KrdxYrw%oN2"e<?M!$zY6&LIm hZ6h 4(e:]쪗ν)n/&{ 4m)&AE}/C BA CfZϡqS!Jl:ӄeͰYcPt~hK]*Js 6| HCl{..:}{LrR< 0*L*ؕ>^z;겑^xl*6ZIQ4 el.Ѫ6[m (|A >`8h̿1$ }~ۘ0cjB:F.92{no;T.Jp$9w}\̵l>U[*'^1Z0m%=BS0sh2xHt'맳 9!Tctst|96LG(5KkI2Ԏ @I \yWRA zPtqt{Ծ %%v.ܙ;s.HTVNyDW~^b/ *lQ]N^wgRq\ad}dFƿuFb3WJ+з`xv̔r%PԬ~o`Qav߷' !u.s{)q\d\1a.@p9qCu9|5o( %Alv(i=j|t(a ]˪63h>;K&m[j>+\fJOw(Q Lw&w2Pbc.:Eֺ3D9Ҽxң<fz:Dw1A6, j|6W(H›GbgGJF0+}: b!`sPE`VXmj;Uu`zJe>NgH@,r zq'1 r"桺:q4yh6W dtXüNT%%uzeg;7 ƻZ |2BP2۩lŨ֕M2v-ns;\SKnrO%LDW7N5rArh>ㄐ;'tP s8% H+2Ih _Cٖ/7V޺hxO;e=lt:@xTW^ozyTWK['WQ7V>^gz#>8… Y -.'o!\V<\We"QjZgٷwղ5m x_GT)>5U~+șQ>U!_c t60Ѻ@Ƙd%1i͇W!]LP"rDeEG|K{KDf|Kr#*L♰ <0E8ʷI2!|d9*b8@/Ut1OvQ9DhG GXHˀd gc Up!TN;qL7&ehOEuz gDyz*s{A(KhI&#-d aTN nnng]tJVq\atdԝ7hhPՂV\H=JwO mmBh52ۙF_kPKHe]Scu}g]1+[A*sB<RZAd+A NV7MdIS\tL>yl2A'@|BBZLAZٝ!/K9Up3oo/ ,~D}uu4wXY:[x_6~> endobj 263 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 268 0 obj << /Length 1489 /Filter /FlateDecode >> stream xڭWYo8~УF O[h6:> %WS̐M€c8㛃o6re*EBZ3kh$:w*.$UJon_%_דDD~"rG ')g0L8'Z0^M>OHI:ڝxTgdIgl]tEӾF>($HZxʹf .^3*wqk=ռ KM$y\쀒:yDq=7o]m:IK~BO4XZW{:~ [yOv'>-mwZqGmW,`~TMWE$܆[,Is4BpZmncA7J|nY_e7gDա0_:t; A2yz E*GdCu0Yx;ԩ{i7 +Kc4'좮iE6' fb11&a^xwbwFݡQzXH~xs;M1e8]s0z4<`DiXeNh෻2&_*0INMͤuDž<3)3:ʁcr >My"hŬ7?%VӱPL~*f<^ {^2tf|sy$'qH9#YME ~Cc8B*9jwn8YOE_?pRi+i!OJcqGy18Q `6Q*R&SXSB_I+0k 8R "_݇λZ98fp?LA7/ -= O$JC9 ə:02$8-"/ՃрulcXqІ) ?MȠ:bDZ< j#}Y8چDz޶X[~-Nv%S |CB lh5sG]ah9௷"/kW ?:̿_jcm \,N=@v(5,* g,`0-0pڣr2|_?xXz6@ c0_/h p !{" [>$u>f?4zkK2_3ldR4`$/=^R }._ݿa~VtgI)!b6nSPc藼v=t'=AZAXe‰Ai 5 > endobj 266 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 271 0 obj << /Length 2814 /Filter /FlateDecode >> stream xڽZ]S}Wq|7V9Bv[<3+m[-e)*<Rϑt[Ǭ[ѳb7EWfw?f{BGˍavH)6ceBb*?TV/2FR P ŴAm5)3A5a)K}ө$O)ۓ6)z ^NY.n`2ǡ!D+d]u6ȂُnV]6T+Cup}ƁoR&H~#HgvvZfˤm7̤pib`O("6" 埠h&Z n/$QO]NovZVq~5,Km@G(ؗiq*"7 LPD6U\naXð4sPDhꗖ@f1["sǞ0˳?#js㤺D7Z+%ӷPjt["a2$oUE&Tϋ_ lɛ=vuuqU#L0bKPc=.E%Nk{A!=ٔݒF2i$d+!QyBƨ_4~4o)hڌk)A?|CGr!rrE+"][,YV NH)zA>p7^ QނeZba2 oU&TM#hWz\!9eDpsGpqEFNG#/2c\y#EɁíg-U-%~eM#T/P hjGN_vfvf37Q0q+d!8.ۘ6>83c[ba2mU&TM{#hAb*i|]G{pcC Dp}O F-LbV/77[JEyߛZ_#6j:SPRA2oU`~#*c4mՌL2wm}qKnx>A]wm_'o`hȉyڒDG՗i&j*6 DPd9Om5AƸˋa=;Ԡ:h.H9.$ıQqKu@z,VKWm9>V2GK7@"2cŠ85vþL3@Uq Up|x}2_Y,uYwѠ/`07ۼB[&XL%  W۵h19k&ՖI)5c,IZnlZ k B>ͦr)r׮D%Xve|9}hN;)~S (* ^A[=ʦnno#c6iVPmD6F$,I|#}_ J3p&`F: t ,3`-ߔOC?ӕ߱DYeر/cU=4;=t҉ɸ?rYOVv 'QFaF|ws%2̘:T7ͅǬqҀogAlto#8vPJM3;Xvvt"티!e/4`{:lrDž 뎇YaD ik}/>2HRy8F1x/AV1D\'ghc\&u6EyVsiC!v:b9L0$/ XY>-r׾ZS/~x[؞(p/780~6nC_*^BDZMʅ$p I!![ؾɘ"n_BK[9~}IjMs Nx_4cmPSnA΄^&23l!?FZ{Q(򰊋3k2xu0qILqOi Vȼ]?dn~V>*nXc} \ΰ Lk*s/esOSg\V>Rq;7G=l@=vփ FXl?M~"ls-\-'{?>qV%9Uƛ{Gm/g$c|Bs[ӝm3C,b8!X1aB{B$?s̛oLcv&e) ]EehV'}X=]űӪrb=wU|lCْ^~O/_tQ0(o<,.=/6-0n- |0"(6?c?($Wr46쉷endstream endobj 270 0 obj << /Type /Page /Contents 271 0 R /Resources 269 0 R /MediaBox [0 0 595.276 841.89] /Parent 259 0 R >> endobj 269 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 274 0 obj << /Length 1093 /Filter /FlateDecode >> stream xڭV]s:}WӢI}KsәM'Som@7] 06i;d&=:{vZbS.!jC)1& &blj2Y1  )P+MPr|~*M@&|1%pH.. 60LG|wN#9hu HvGeT.RWxUu#&[8hmO{x@k5X튪IU-tj8U+VܺϛR8[p8ᖪC{«ɀ? R=ԝZШS1e(beS 4u`pd-vj=\W Մ(p5M^MhzM[,%-1y&6fO8~VYDz"*ZB׻tgIX9p>Unnup9=?Qh0]mͣSKhehkFHtPwEwfɻ(U?S$'|>l܂_AV216sB"s ĮU(M S)R}sHͲA vacalBJ\8d洐?D{x\ziD3JŐ}(1ԀOlTN<9H25~J ¥}TQcN|uu}w7m"<ͪ&"|)r Wjb7<XvvYsj })ǂ*[,`Dh9:d)#pzS/gׁo0W]k>R&]_0ٔSu_r|[j6A8>{ɬDp*KNz;ѐ 2јTPvhL}Wpl3g1یq/NM׍zjJ οq]=fu\#N$muh> KL(-`̠t|뿜4Ni,sendstream endobj 273 0 obj << /Type /Page /Contents 274 0 R /Resources 272 0 R /MediaBox [0 0 595.276 841.89] /Parent 259 0 R >> endobj 272 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 277 0 obj << /Length 2532 /Filter /FlateDecode >> stream x]o8+|)c֬(~H]tIvf±Ĩc{1{?d*t @%Kkգr>y_tQu'w])) ٝ?%קc<9y3th7n.r;w>}NNI SE+*}egGUE^sm+%#Zd؂+XkOdX~4ƉEV 洦Цvq a> endobj 275 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 281 0 obj << /Length 1634 /Filter /FlateDecode >> stream xXo8 _G6kk: koK=xKb?R]I8D("t0<{E9Y$dwQre6M>z:0QJǿ E|4~d7Δˢ s&-Uv<`|@ HŸ5^q^狢)s ӞBJ,u_/'DSY+T*@*yи|3 L tf`/6Ar.ruʗ $\~ h"qwaY~1 ^MTxtM&T%UZq;өsުh̛!xcXN틾{z;nKu%mCs6@Y ٴ cQGQu{yTd bz] 5ޝR6e> 1c˽R̨wh`3zu*u"Q&2g=.( :;Qj{@xNh;SpybZjq-%`eB}( $$VءkJB 9N3Ȧ[ȀLݞC%s۝EzO!Oa@x 94%r^Ӛ<)[63 FNkpjB.EFhf]aCn69>m/ +us>3!Ef>T/;PGA!mD8HX{XN FMJߗsd0(Mf.k  [U ?.f4,ݜS[}ѳEfu 76v -[9/lJų؁2Cg{"7!')~L1 .)Rdi}AS0eF=NZ_S't3A۰SJj1 ^n ߡsypT)iy%=f׏GK8nIfJ,Lav.oD:]݂bsmCt{Nǁz_i) v vslD 4h$',(v7eMB\vBNɂgqfB)hd,$yd/Y$7%7ܾ ܲ/'bDyr-ZF(B=B| 2:s ?*}ˢ43 uc\+_}q|矴q L˚gG_qqVk^}^_ZR- 쯟R dIf3ޞmendstream endobj 280 0 obj << /Type /Page /Contents 281 0 R /Resources 279 0 R /MediaBox [0 0 595.276 841.89] /Parent 278 0 R >> endobj 279 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 284 0 obj << /Length 2014 /Filter /FlateDecode >> stream xݏ6WQJkطKk{hqXrrۿf8,~EJ̏3e6U62g(84~u2:*,dqud$""g^¢V% E7?lJzL, '#G)QgaKoNR[z"7/pf ó~hK?WXm]QaƂs~Ǟ/|îtXz\5nׁjҞdN1'u׶8@wIe`uÿW.{C&UMb`-=o`*MYSvm6k*@qe\=cw-;0%~ ڤkxH8OĤ֌#R88R2fᐮ%9"3L呱 #ƨd6AE;^>اeNN,Ad [U )FY̼(73H.5Oٷ|j%oGTy7;,߶sZ^> ]-\p{D@|pG{\,qEB7|=a|Zn\O"/-±Exbplh!F½- 8 3z I<B-ҧ@[psd B7TP\w93 -aPW\V ܪ ('Xm@Aݑ #w3".8\Z^J5KyI]2B1ŶxM ^Ej*[v&Q]!v]=uGfQ4ņaw 6ؾݠmSgZZkiR}Kt¥HsȆb益uHt0 .w Χg@+jGO#}}5};^awB~ w+ϔAƁ?˔t 8"."jtOੲħ>q-߬>h<7pB Lx"8c" =xE~3Dc| 4-n|)yz)oPnlJ@nQ`X3u6=1WhQ BPO(O 97WOEdvXM,;_KNaj(i>DV oċ\4"0nW/oAàn=><)5}ݼdՙV<+GAh_4E8endstream endobj 283 0 obj << /Type /Page /Contents 284 0 R /Resources 282 0 R /MediaBox [0 0 595.276 841.89] /Parent 278 0 R >> endobj 282 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 287 0 obj << /Length 1602 /Filter /FlateDecode >> stream xXoF _G-ޖ6uM@%'dɳfGO;KDAH#g_1gU4]DBLqegyni1I*tTß21L4_M|̣r£Δˣ;s&V-Uד;)IGRP?+ LIŸ5^ٺu֯궫~edv=whj !'n87ɬv gs[貮^HN`Īٔd wrAkX~ D~Rڒ$Ф_v& NI%ˬ " ^骦d)iI+7#kyҁ}lG'6Y [zzE_HRy6v.T a[e,c D|~ ˋIDf# " $s; AT:u2,սBx:uKGI#2-n6$宩ۢ^at԰ dRbʼmDf M Hp-S@zYeeF17ґ~VY,7PAt v]U]aa+ ܒu@!>JcK `+nt|`W2^!TCz ~XgޝH|ėR萖QѭݭKoC0=QjG,AIKn ow؈X0 D7륌cӊY}k0Aڜ* ݷ.!`y#ϯ=І's.YG-JN(gԇ|ե6@l6Flp6 :$>0%raJ%MERh-&%|-G6yd+>_ko0MJ*@tҺ;vezTٮ0;&m`C6ŵ5JetG㻅bh-:$Y)q= HhR|cPl&# } EgF-?Q5$" xC{Y ,91'?#ah%+VV/\eޘh } -#zp-Pu˂1Rx#unDE9ѾX!L@Ț A ^X;0wɺ^ d%=Qp{S %t2/Sjy\Wސ%^ {3ANgC7ZE? IOA0x%EԇuY^hnVUChtȖ[]hQ0 4mhh7ztNTa .򄃋p[ңmÎ?d9'OMrҽ BA}1PuXTN;$U4KGi6e6gfkl}}9?>7(sܯzzM ͼZ@bMus AAPq}nJ&ins9,endstream endobj 286 0 obj << /Type /Page /Contents 287 0 R /Resources 285 0 R /MediaBox [0 0 595.276 841.89] /Parent 278 0 R >> endobj 285 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 290 0 obj << /Length 2556 /Filter /FlateDecode >> stream xڽZ[w6~#V7qr<(2mTTjw 4)*X`0럲!&݀jZSe`z9ڈdGBjȒ PcCZibO~?nO %doP3x<\(EZ">b%\*mXR pH~̖ u_'X;ʽ>[߹gz 7g7~͸3b"FZdL7 1T@SM}Q̍WH;eXU!;obHiAuub)Q9;;n!%)O G2d #NbV.`qU! BԲ8Rn,X> 3؏\O!`R ^"0]G..9xL q 0Jb`WO 20+ #"VO _Y_lhfp@d~lPл+w]C0*bu  +]fQE8:Z0s^Ja^u/щgPQfd}>L1pzÆe-Tu :fl}` [0c&I [` \52>bcHbB,p>m ~y] N0~\L۩G :s9CtHE|:)yn˃~%nhsPVr"q.)A \. Ѫg0ýL7@U1 U`xV1 Z`xmr~IpJ +YdV23~gõgxy},4'S'n涗v*nw ܎Pv*nwA ܎M11&Dje@z[y\a@Ӟo0L7@U U p3S D31iuf*R%a&|tvOm`7ڞ&ZH{8_1+r(]O~oꞕWqo 'Z9PuD=e^lnFf05DfAnW$d(>o!BՏZ֞دx#[f>r: A.\ ިWiwy:C- M7>s`v[“srνTAE#pɅ|i-ð}Awנrh,m쒌R4XNj˦+efW^(R4ucς5,%KjuIkLI˱pޒU&ۖ"<NݦL˞ KS%YEK2$LRoi&H(f8/jcE-?gj),ҩ¢{F-UX:+@:Y醂=XPMu+w[%|nRa^{!8Bazx,Hrm;j((?u8Y)zމ3RHBoLs>/ѻ̆p?P qzROo&8b!sL8ir8଎쭎WhHEN n' p T}S[|ge,o랗AFxrwnceDgሃy AZX-& u46,sbp-bpqUr+|t\W8T!RIgO :=#̐` ?+K_Cd3 !Eo Oڇˍ{i#vRAo^P&s;0ֿnk>'I4z 釞SڄVd"*N@endstream endobj 289 0 obj << /Type /Page /Contents 290 0 R /Resources 288 0 R /MediaBox [0 0 595.276 841.89] /Parent 278 0 R >> endobj 288 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 293 0 obj << /Length 2739 /Filter /FlateDecode >> stream xڽZ[s6~#Fq#96NƦ-MmQ8= )p<1!<|z42Mx`v9*lGrH/' Gio3$kC ?Grˆ|yJo_dҡ#c@{fύjuUef0 cAXXMd|ƾRрlSLICx `Ӟak:2ZPyPS>хkDCsI (J :tF9I}yӐ``HgpnrN/ޠFEO;LaW})܅S8@54@&`@{Alu#,;>?Nk\p9Ɠ|3k(і(mfye)O(_  }ú_כ^"_MOan2U.TٯYSn5W@sIJxٸaĠPr IU"}Z\LVfy6}P*|nۃ~wp08vwv&b`)[=$"s](&k`P}@9satM+l8*_VV`|E]t;C;hȖ$!aj[d~[ih|wXgM:|h0w;6L P~  Դ~p\ÇM331Lf ּLk2n逹{Yߚq}VL]^;kuf3kbS=gBز aC\:؍{^9 3TP"-6u]}sfZ܏ tdm=ōgH.,~kDSvCVU}*Q 0~4'"&j]܋qÓzj :3h@=k7]7w'*jWϖh!ZhPb/Aur)!QnI?)9XbAℑg|1i[+$ _83?= `:{95f͆*PեH\7(0ւ/D$z \S4 IkV/F:Vs,BONsv7D#Bx]4 &i&KV?!x'2~osYFf7B $r@S@C#M!&T)_|aɶ0`泉oC`T͚gxШ=#tĶhe;g[q> =99cE4ϱL;V hRMr?ߙZ`Ό}omeBIZʝg6⛂NUI=s#Ht7(1؊`~wTY)W,~䎱3+ rj I`!$RҴ1:{X%UvW > endobj 291 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 296 0 obj << /Length 2648 /Filter /FlateDecode >> stream xڽZms8_ᏸv$o.gص6x1$ƹZ. $yazd`:a¸q$7O Gl8\x7~~:Oς@XLq9_u?Og>*Rj dnPtK@:B%pLo+`]̰k=3G|ԠuRB7:'(< #8PaLIRGZ+p\"3`a(t]5_1!-ei>}#P4]IXƦ}ASllג,E9I7hόuYADǝ6k^o? ѱ݌]l^f2jܒ0bIj^kCTL>ݫF}$Xk7?]nT;o˼{jrTTYfꥇL|vŜ4Mݼ@>44 $SB#jR\ݼ<,a'keai@܏TAA6n 84~PYݨ$n޶(N߃LjB" Ll/֛UVe3b9P5}vwg|,Xwm?>R &E܏aGotT]TW&v`3|rEKth?~ 䈐ؒCU;r FQ->jLbxA],Q%'CC1|$>`<Zdjm -RP9/rF &b 𙕇|Dy_R{a}#@U.TG8N>> ɗ|=$.}،D'Ls?p 1rJCҜfo0px/8Mnp*a2 2#dh :z=w;uℹGe3zgsoԣ̪ĪqULM7ecR7JjgUKڵ:gi6zsV1; nz*Ę{IN?!{ant3T5ûPY;N0h5ûY;&m֡Cp+Mp|EFKU(fq{θ&\Ϧ55c- °'fײtH5; YV! ujNwಔpyuщщ/\68ý^敆ǨCڗ8vZw'1臵}:y *KNT.nr! j|1=Cris@K5Ts (?4=A"R1vO7@U %sdv٠pVEo Gé>|F&{|"-3⫓fd鱢#gise[.9B^q6>lU.Tb^pYݸB4pMƷ7WX"\gOC~Alu{DߙoFf@ 잍ٺLy[ǁC7*ɢP'b0 oNX&-uVe佀]:tP_amw:7/\>4gm # Wg6.BX$A,ށ5rJhSQA}]-<<#m~4ꓹ*20n-_Q-۪(3S0f+:/orK/ 9]7E~rMJ,ϛӣ@m& MNX^u XvT7u1KCW yjkPB_ziZev??sXl۳oJSСNDue;0I<}J֦q*!vm&@Ҷ߼Qcyq_Ur'j 0!K)<퓔uL{jTBMe׮93iq V 1  ӡEȃ%`rQ%Q~mFKg qYeb Y4@=9vfll\7Ļ8LJw֒^ 9tE@l4:s8048&l}fL9ޫҙ!IǻVG 5jgϏ`/Zz#}7߽o6ZcbWg[>d Odڻ䰺 yJop=xއDZk `(^endstream endobj 295 0 obj << /Type /Page /Contents 296 0 R /Resources 294 0 R /MediaBox [0 0 595.276 841.89] /Parent 297 0 R >> endobj 294 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 300 0 obj << /Length 2742 /Filter /FlateDecode >> stream xڽZ[w8~ϯ-K~K%d잞~ fLT$#b0>99IOU_]$/,c yyiJ%x4x΅ycuE|E^*0қ.-f" y'8BeBܜ//FeD^P)B"b"H塔i,C.SgRO4=M<ۅfœPqEsĵ2 e&K0P'34`Vf -,̤yF)4C%Mbܜ*Xh{"%1G| EnW@8V̗9&I wf!yK<| #q s}>- O?Es8)]pYb~p7i{f|-s+pƲ,g2I tX*:3L )  @"4;F|ڛ@8$UuU|[eF@H/ x׏,P!î<8pc8ُŋjʋ>Hx[*b--/tPCX"5'e* Pv܃|އ"‘D1 yRMTt#n_Vԣ/ʍVbboLt=|ɧa']X͠!v99 0GI %մiF 7'2&dJ:]BfWen{BZԊ8uMZ3xDDh\_niuP&;;!0wv6 0' -;BW?6& l`3Gu S1ǹhlzZt8Rpg # Az6ݟl=u pkF^SG~l2gl@\$tQ&b!|[ÒI+ 'kj"I-6Y@p\48L CuiИ`.GDPH)ׇ1>giȆ&@ ND,PirA,I(ЗЄ[]cb/5}(--1WF@Gr&I\+@ˀ8] N8J.շT5rigyLO{||SHV'G:1 )0*t2F]? !JPˆ Stܾ̝@| :-AK:Hmd\PAH~)2"4"ea:$Vj:q]TdsgׅY]BDy])8 (F8Nۧ5FtƈVT&FĈNъ,"z^ue%D,=#bCfzCI7%O{c]pX0{a9ls T5PY;w/ d,dFV;2"qK`f($y_;`F2-i]=„֫,31kthK35uȚxʍ']`^iF>U6Tɨ:*aQp8$/4+M9ܗ.74khr$l_]Yk* tma'irT 7]TէnOfdC,L!~^ǩ ; i*-a_HՏ,hQ/|)0; Te5T81{KF:^ LJvDZi~.RH{Hg-,M^ Ú2ʈxD&4:Fh<,` yM/Y 5SC50]Qz/4MvRwfu*Kk^w&v4lVR/B68Ôy)q2.k4w U{NigojuPaojAu] nnW<ֱ[:kh9$pM),Ao/JbݦP\{ȯ~b!n;I`ۧnEejݠݠhEf6(\d{jݠH2եN腾C5'vdN?dOoSWWRy&N${RIlGvͦO;@U eesI7v\`#!p ͨ Vn0ho̿/8y_|c'_델}uώ2_9y{ aV"CuiJ+TCdDE /G7Plm&(zSNݬ꘴}\ժҟF? ~?aM۷3\EG>ŮF1qש)wPGzI&~85_%bendstream endobj 299 0 obj << /Type /Page /Contents 300 0 R /Resources 298 0 R /MediaBox [0 0 595.276 841.89] /Parent 297 0 R >> endobj 298 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 303 0 obj << /Length 2576 /Filter /FlateDecode >> stream xrFLL7Y:r)VR[ h3 (sr9w?A'g!c_ ?xÑQC6)._ǟN'b?1HAd"?Qf0Y|;5LOWImCmC%JYUwHG-( b9v w78P^9xy-yTdyVGH?1LCZLaBN# ~"̋=`guYev9ЄsV=0c*J,292RIYYQV/s(dZ2Epy yDx Mpm5 \9.b`|Jp?GC]nެ_a2N,u)ZTl}NqGB;lBwH1.MkV eeeGH&a-3DS.R`N1;DV(.g&-/.pMYsQ8}h.PZ[W02w(99p(q?bʨ$7SEḓ*X 5|Z1ĐXd$ U]d*xq?:_f~u$GqHzkb098!kQT̆ݐv֩?>0J#DyPߜAIMyB @ Xț9߲39Ţ>I@gD}o*mD"ɱvCٮ[чB-|0D͖|.1*M,un.G4i!DDl'I,*| >$ ~=]$It?a!#^\3\G)wbu_=IDv #5'"πnJ _ٰ h͸_Plps -4KoS9UtO_) "0N6?\)?e/d\#; ~?EҽW?@kK(r(o(j׭ jCnc7ɹ.5b' }6SY3 CL -{^qZ^0|qWU 4Z,VLpdv%%-Zg9foR[cry^ 8Yng$A5f>XF2)cJ҈*VoPK^_;"T.ݪ8mu*5'۪:+~zUS-m4MD]y`#HF B/TQ u $9rS*| 1(TY\!hۻۮ=~(\Nya(ҦCа*s\Ym#ٽWm&\lgX.OXxG=$:\5  ɩ}Ko:2: aALHEce2 U.`DNHvמFR~t OgHD Pce1P<]&$#Jz'[ MQŋnl9PJZ(أ1\ +Hɧ;9UǠqCT9jQT Dq貸;zWu˵TPW1Nt?W>=b9'Ob!6 J垞ZYfZ_`(Q&q[W#a$.V! g U鏯pUda77ƧmR )`(y58l'?e`c.S~dey}668%1]4YA£כԮ7M%C\jd۾O!WԨ:MHXdG!UYZ;Qw0:uUt ]+yY9uh7D\}vW'losSӫt3s-t<. 6I+l_Ol)nuSBӏbLnKR>.uDrG:yJ8ïJpF/Jw/Jpbo2F/xF[D8 {AUpU %u% i! Uly]ȴ`yMz]xgi9={v jEM5f%Zo5'DP$[Eu&bD'VAB'8r/*endstream endobj 302 0 obj << /Type /Page /Contents 303 0 R /Resources 301 0 R /MediaBox [0 0 595.276 841.89] /Parent 297 0 R >> endobj 301 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 306 0 obj << /Length 2054 /Filter /FlateDecode >> stream xY[o~ׯ#ن}7MOOHH%ud:}gBLJ\6;7O7$<^1F%7ϩr*tӛE國*ͻ M Ѥ,-5)L'lR$&IyAhY&`ܟ7ɿ{EsF6CW@B}-9@5K~B+N %AZI&Mcd,L;˒RSNY%Q.;] DIt3JJ),#FPk\} ρyAIr")at呲|חbLuו8=vzuDjZն޸sjQ"˙-c&mRj=kY.)O?|qBUc2J(sV-o $ vசz(zE RDKԾ"TTC;(DȳcM0+w(/ vxo"(i  U#y`IP݌}nufsEof.Q0iҍ(jOPl=o[kwQ\t z govVc׈x\i[Mؔsj7:,\8ֆM: g+*Fbmc Ԇvyt yo Rюq mx{VʴjW^L`tM\w_ |E.Aeʴ7uNj ;-= K-vmMx^d>QP=Нv^+RLOAW)s{0ġvȒ1@E9<㨨"=Tן./___BE6yV1_dZoLJvi-a(]Qw``6N]=30h2#Bݙs9|<{]=D; zܾyLrb> 0(0T.>^6F]0BR԰:Bb:HA!69'Xd^%`#i<%RAW;(LjwK_w0]T]* UUs+ݓ-&m;v00P?#WgiVywO֏(8<(XQ@jEuۺ,ëX9w%\@6't60 rT;:\y -D&CÆ'y}h9zz~_&X>KR+^Le"^: ϻ *Zm+{׏~fgZ#-:VbU`;kVōu;\`>_ÃRX+ l#HiDR6e4!5Th9Z @¾pv|g gj"ei9ς*%3uNH;HO4|c|;$ɒ(ȻpH)S2) հ q{SϏ#Eq9ďO?ǔ`%c D~#eqwqL QҜ!GkÐSGWCXp#MK) 4z]q^M{s=}pW~xj+ϽW^4(A❝oDq $ Ο9T˽ bp xwSe"Hiu*pQ ^O[BD `̷߀5e=9iٸ.?M~!q~|"n6vp~;-mM#x)tu.dY ʊxᎬ(TUj;.Oendstream endobj 305 0 obj << /Type /Page /Contents 306 0 R /Resources 304 0 R /MediaBox [0 0 595.276 841.89] /Parent 297 0 R >> endobj 304 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 309 0 obj << /Length 2593 /Filter /FlateDecode >> stream xZQs6~#Aq/Iصn<mkNNvь췋]?Nl&931LxjH 3&#9Թfw4BF//|L'IDn&_0 ^\AIh l 9BTdsZoMG !% e Dau xKT*DiieMrԲ%Rp}CZ N`aҿb%2Nss *p!5Ňd&/R&2~qauŁ2H$D`gT\0)qP9]èxƔ{OOϮXƽ;2K) LRޜ7TAtHX=osqjdĺƏEY6w ~ TPy|7:ؔ`&`s j˗;L3Վ8,=Y3G a! s3_*(\PT#/XaC#YrUZLϒ+۹L%%2s=n#\v2J `Y6+`駐`a2ߎKX-e,%9?vM@t eY,_ l(r^_N @aJ@fq^W(S*38lA?<E2FM9`l." /cӔidkmiӶqMpW^C諀 njV`4xet~FϠ7\ħn}nqjd@x418`ۚ[i@=YPzL=iw>c$݁L BfQI/?%,t))Q?DyPt֛sXL%?)*L-RKifaJ+`o 5cJF3: &8ѭz)v[ܢQ t/Bo7kw܆]AɶD}I,jؖbh':5 ~CmsTiogx=;QcE r^1ſf<;QK(3/д'uto/Pac qxSN"UaxX/)Mb"z>/Sg-lc ݨT'}Im> 彜MmTx2X5ܩ]CBھs*t NAF`8:bI\aO`SKA* 4U0@N xnG7:n&HAޯ~\"t3[U+G/KvS-u񤹃Ҳ-bN3~]%N_U/Uq꺝eƀ䋺!H m4,5j ~T򃨜CTGQr~+ClT΃ATtzٳU7{/堣V&-H#޵/ei"ҢD{M+܀FAm6({LQfƸg,?ˠT0H~SvϜ̰!TTl l a~`|u Ų^1IKw%F\L3𐽠anr0@= H?e.GNa ;a *O28 2kd@Cdޟ_pxRTmܧ>o]!)7YcjR] rz]mͅm9n_ 9*nycJ-FJze)d)=C<TW秿ͺ6 ǁt CSis{vyy~ٟaYa0Xk&,RE ,DTnG{: 4s{ǂB5FO:9ϟ;-yQA7{;,Drεs,7ljkb@vAR9gE]_]R}r"Ƶ]49>iH?Px;E4jCe: K %MqK/שHM7+ӵ_0 j76tx9}.pI4l8ެpmɪ= 7IQ=~$s&I6 f忉 endstream endobj 308 0 obj << /Type /Page /Contents 309 0 R /Resources 307 0 R /MediaBox [0 0 595.276 841.89] /Parent 297 0 R >> endobj 307 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 312 0 obj << /Length 2427 /Filter /FlateDecode >> stream xڵY[s6~ׯ#Fq#;M6][nw&̓,ѶfeRzRDެv_fџ\ƀJZA>a_gO[b]V py[DX#:҆=+03H"{yxq{iXxM#A`5F =m#6!w[PX haj^|&|Wg`<`-]YyV׫|(c[4 0~TO^ ?c8}ً\ېcLJߛ[`=U)|<t~?Ē >?7ޚ 0ZJ cE;j86Ö|BH!^cc ~EP*e"65Qˠ헪ZQqY4:7m.0,c.#bqʿ $y%=i9LC7۰f.'bK\v]+ C703(`+sAp`2iI6qƟP+4(_!年SHcY*Zc[!@[_wchQd?j4T8dYJT)PmHliVT:OBʆISi)6K喲<^k;wO<߮1W+wN<].t+ UH"KHEƒ"cxȫ;`QI2Z>#٪vF%+iu-Ў*y~˶' @3nw*|5H@`kҰDK5q UMe U ;bQP^QIuP]]]]C"D=Dqo*K:MxX-3$vqƕ2Ō5Z7uPk~̭,|ӇvY(;06@v]\c*ҶRi RL4;1Tt]9Zis!C5;)Nk+/=`TT 5T<4P>Et]p\\l±|Qy V1|K\߳cRW ntu~6 l޶qqarQrQyNm_B::Q7;S#ROQ)rsW%Ztp_M9Ym*gPXv^ӮiQP}U6ϻ /I,:2mdFv3G )UؓF~[iٶ=7cnBKUnOH.@jPϞt!$qg~zz~[y Y5ۡ L_OcN)8~_}J $w-%3_Zi=Wev]:r_UЏHXIpp*!pIZzx[Ahlߤp}{u:[zd= `,Y[dHnRgco=^lTXkj30m(%)21Nx.3kލ@#0x"kZoE6jN~:?#% Zn m"c9n h]&ꩤ䂐 õG:>~LРd4V'Q< wendstream endobj 311 0 obj << /Type /Page /Contents 312 0 R /Resources 310 0 R /MediaBox [0 0 595.276 841.89] /Parent 297 0 R >> endobj 310 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 315 0 obj << /Length 2534 /Filter /FlateDecode >> stream xڽYIoHWH k'ssnL;D5%ŝ?o)R)FZ0K<~oۓ׿eQ.ri$U&tGާ"\t;Q"u|{_M|v=O.oOdŸ4֋\h0 e"5.ܥ++HWR(6i^n!.䅄1gfBIHƦ*sL,V8$-:-=l: nT"En-z"*I^~8T|;d쵻բVzLZZI|N |7ח`fbԗY% 9mVÿU57+1Ё Џu5/̅rLެQ.L!D=si2i%|Yk6UO_Et6{GZ9[UN ,qU.&+bUq92㿲^x,iq1w|nRSgkr8głz~  P^6Oa!4/ X_L:Ɗ5D&1Cta+Oi-_Pԏ*&1+!iC$707er xhd/К_M3;ǦyC"6 -7I8Jz6rg}!D3ͼ\WBOC YN\WI-=ky>z^Aߡ R0~f$,"vgThQ$`nW Vs[t]l!K-JG6wA#ȁ e;+ 6xLn_RY~l\ˎEnWX3!7dIuFT.ϪEn,'Fܷ ^?xfz 9tv҅60"|7NsrJxZ> endobj 313 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 319 0 obj << /Length 2381 /Filter /FlateDecode >> stream xZ]s6}ׯ#]"'9:4t'̓"Ѷ$JTr !qL~#M.,'> : ^3gZ϶Q xNh&ghx2צb߶ZmrewY}vW>c9dy_k;T)RF D הfT!y;Cm%1;^ uRӦC6jAluP5Ѕ{Bj4x=阘͋y'6';_l<\)0gx"8>,*q \. SXROUAҿ7P.zZƎsӵfnv P^4e:Y?Мnhg0s>/' #,,\BRU&rKCM2hPxn.o4d+7I:~c+:of_"PcGt2TᝨCT gx'4xtvqr)a+,2ZsM2dvs?E1n~gii+ 3,JI oƎS۵vjwPvjwA:M\ C\=ƚ ebz_ qw軯Y>r3TO;^צ}jۅʳ7@u}@kͳ7v~}u5:j3tPK@p]L,j ʀp_BtƎ3صfpw Pu8zAS\#DҘι Jdi1Otvs4a%Ar㘎 mlO`4LfD[& zKmt3 .6'쟪v?0Hlڽfݽ6U'^g4 //Ywg=+ ﶭsv0#1\]V[Ec eeTз6Vܢ3Nf i&aM_p> *Qߍ VG`Ik,Д5f~1[r"(al;P_c0\,ǡ֗:UƷEu1 (Aa Fe[0k,?;AcОg8 (+M'0} >.AN(04z h&A"4T;R '>,Tz)+tgDO6η~NގxgmQ!T\|4`@/E%Ah!2}_^YpbS{G9Vr >Nb= <#*Yx +lo E%ZabDKb2{"Kbd/>C`~\ˠF::sմ%pz9'`I 5N┦@d1E/8f`c&]3Ӂ+Tj";gdkȪ ,0ཨQAXE m\hJ~7־齣(=yK٦VX1wmj,5DYk[i"^\Dw<^~ Cy^cS5+J n@;C * I5gԾ/m,MYX3??(endstream endobj 318 0 obj << /Type /Page /Contents 319 0 R /Resources 317 0 R /MediaBox [0 0 595.276 841.89] /Parent 316 0 R >> endobj 317 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 322 0 obj << /Length 2209 /Filter /FlateDecode >> stream xYms6_'*  zԝI.lי^?"es*:'vETĞv@=G)5eFpcECALe&~aM*`!]w~J /F#]W ])4OSHSoڀ%~u8E:Lq> $ ٗxA*g9Kss8̐GnpgSX^&YĴ +u͊KLm]S}6C~ŜBD BHt6M7eΘ0$RVc SJP `*{d䡟<|I+9Mj0:sVͶ))y_?~2۔6DȢ,@?O|e_7$|Xpa9o x !!<&FP0pOS3 #0^v|,3/ ꎸ!`(!;̷xz ~p!u,Qh7 &hjmsYסᭆnFF ƅY7"WR aG 2_C/L!x~d$2aQw̕?$}Lܑ 'Sc\~3If wZy>.K9K)(ngP8?"m6S.BTͼ:T:uHSי@AC9#sU~/0'`}CHYag ¨M?AK8A{/+/LeHjB`vn$4K7W2*7 8j D?q\>BTm0Ps#.Hgg v^Ւ*n%{G2&KS eT0|HhXͳ)t 5;% J~!wg#1hT=mk* apsK_鵾 ƮKe}!h73 CގM0rp aiWKS0K*% ݸi|4Z D2Kzk8Kgl6N>l=eK;`w^Pc AAA̶.}Up~NIyt}NkVNJ߽GC:O{5;|i&001,{ydW¾`q3UW-54:_H` w5D=~&ۭUN4. kCAtܽ)> endobj 320 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 325 0 obj << /Length 2155 /Filter /FlateDecode >> stream xZ[s۶~ׯ#ٖq#{&3ihv4Q$'BA&E; L;xv'ǫɳS͔2MxnJDbz5{4B\}ӌs\4yz59iS%1\NOM޽ϧI>}5 7zz9L?Mz1,#⃱-@\qb{ h6h 4OަF&bW?G0[Ehe`)nl޻A &4W~ Z$]}a/žP%{[G# ~ H!C|#H/ߞED35 0oj,RN^/gW|h|ti1$fDCUybc:C6Jr0sޥ)v>s6C6"d3˨5s1͘Oe^%f}7UӻMdYuTlzEމ["ޣMggSJ{hMYf_Q۞)DDp$M- {J~:.. ep2;fN{6)%$w %Jg'g_:ݍB#!U; X"`++(>wyqv ¤==*i<śhDdn vofWbql?nq]VxX>n!9X]`\渮V R]oͮj\ ; GK Q AԚ9@MIeW )\> xp~}e8<8^ђҦĦXN%0FomӆA5݄#s+-}un \TH!^ e ;i>0? HpPi-?֮ҽ`+N1%&3(Yb#Q~cy!@XDDfk <DŽɘ:#M\<޳Wږ24m[TFP)?=t1aau& ViTc5KW:q' q'N7w/ٕA>ӾK Ϡ?:HRqT@d cu(D@#TbH;{?f8cjc?*>B [Ёؼ}J2&^ zu\EVsI8 ݡXŬL'A߀mɐX>5?KCn{6{QMiiznuoj;g;4>z4?pov[glC#n*ɱCnF0$|2'Mh,Ua"p#Ӡ/D16yef=ڌW16#jSrlY^/B+[jDR_o͡p9K|2(Nd-Ybk\vC 1W@ "W 2hgh[Gaח5C> 0/Vz6=T6pw1e SCbzal0ՅDcn1U]ZV"9q}ѭډP^9f,V%rW=cWD}!+e!sv/m-~Ͽz|@mج?{6CI^ۜWMU߬Xnnkn+ ?Ʌ#W%?p'HfZ"1"DUP1mendstream endobj 324 0 obj << /Type /Page /Contents 325 0 R /Resources 323 0 R /MediaBox [0 0 595.276 841.89] /Parent 316 0 R >> endobj 323 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 328 0 obj << /Length 2069 /Filter /FlateDecode >> stream xYMs8WH rsϖS3-{*-k5e@4)E氕`u5a:y 1)eJ%D4CT("9uDb:Ah`@IE l1cK$4I7:xqB1b"vFĜЄhM0&H׾ĊI¥BCpTe 4S* IzUT2btť!҈q`3sA~[l<$DܡHiט(prmy7ftL,Mr")a؊;F𥔈T^_C1\g:ρ?Rc[/חoh)*9,tËe0/rg@ҿX%It~sb7C ˄qh#wrIxtCp])u l]= Yk \" oaP-7!{xyfzsw1{QK?|K5R/ѧxܸzo!GwqU qP˕Og?ߎ!1DQ IY;%ƿuCx̕$00DK6up&y഻]"lK>Q5\ GajkM₇~6 ED'tRBqcx!#K&CI3#M>ir4P@D %J)M'&cIߛ8.q[1R`? #O$ 2 /ܫgvfk;J^VW٢p_Io>RA 8Ƥ Ԑ 䐫e͚f˪v;93 7s_3l\Fʑ,YBt1z]Z`J1o}B]}\&{._|eUldk ō XRT0ufT۶,}5=[gU%.m+_*§gt%lx4 7,wsWfaŷ̚=W¾xZ,]وԝGFl>oT68 c]5xDi#}7u[^j+%M]TExy#M|mQ p;Y__GjI AUny51L_ihB[|(TcN:;?CJRvOO_3UհjkX~w;lg6Y<.DŽ}ﯮGD{?O!T;.~8 `c3=lg7j:LA a$QMnk#ʴٮܸҤ l[Hb1[cT_!DV-o}x={hz0N-deFވlʤM}:CF:3LC:fJ3KufG:3P+ERУIbf .i͎͚':f]|on w;ô5J MHB5h۠ 4 ^7hxF en㭷vMR:~!) X{.Qb\us.9y.!_ R1 V{[Q5 ȋѶ8"{률E{ Btn  ݥlExҮC_c }զ ] !w> 0d~W&l7LcgeB{;ΐ2,c-+\]D:{>t^"%Xӎ2*e|nZ =Ф-q~]$_mY¶z*ȲG_)QTf^[XQ%OCӞ]endstream endobj 327 0 obj << /Type /Page /Contents 328 0 R /Resources 326 0 R /MediaBox [0 0 595.276 841.89] /Parent 316 0 R >> endobj 326 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 331 0 obj << /Length 1258 /Filter /FlateDecode >> stream xڭWYOH~ϯY7}e]1eJ QbROU80y::F8-}ĸ%Jtq$e8O$BInet6EFFℊѿ;-F42D8=Ø\I.rt5#3⃽-@ B.] Ί&q*-w1ӦW|]݅MK51 " wqo{0Yf'v뇰ah}s%,7 3Q88)G2W0 ⥏D*jp LaW5Ҏ kʱBvC} Zۨ&ʚTW''gWWxD3^8I!IM*ofU,*[(ACn>Gwg[:;ʘ}5kԇ~/U[tG@jH7?O{ Vz0T]`?:Q2bh1rF닼Z˷!Rv ]=%J"I-H9RerI"x<+C۟Rkx%J7xC9q!JYzʑlyKjS~+|R 7=D X:#OYn"h@Ld:ThH= 4얘BAa`:K$uY$Ya6(!^EN:u#x eb{jBLɪЇv ӌHm]MN MBx.5Y \ >@Ǿ OۉmI,~%ߨH㈽4XPՎ?%pao? 64b<*"m̈)|kjךcY.o|oUV)pon%Ѽ2Q( +P6F:%EpGM4s5+ h CɁb=Tm|{ ^#V2aA<8>]~}iȷoЖyUБЭٺaPܰÂYv7bHJ7OWQ|oMt MكJaq*taO#~~×EX_.jcTGG 01> endobj 329 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 334 0 obj << /Length 1641 /Filter /FlateDecode >> stream xY[oH~ϯ xeZ`%PC%K)9sƩ\hJ=>͹~s=UY23Cg۬?XBt0)JT/gE)]>C:?y"ϗ޳~Od~DxcAlxg^8Sg_3BvRIm5J%q~"~#Dk Uvف(AIÔqr yߒi0?wl2u٥rq0o:J@LC"$.=Ƶ]!0͘hLj9.>ZPHR)ngH@A$i Zo.$:ᵵYU4S ZSރޜc7rA.B@!-fy*u`D#(={B95pĀS9?*"]7y冃bΣ8/n851p6]44,>`(u`Y!:>BL1tG 7Cݖxd;hgt9h(ֈMy[Q13[I s/Xz ߣРۉZ\60k:J7tYj(T3q/[1?vCvT˦giL$!#~ | S%>ߒ@!daR -JC \bV_3%_4 m5r YS,47Ap<5@w;TTGAZXvF~:=J6n[]:0_A8~(}4};a'텷C3g7\# ' RiN2R#YhTwIE\/@9o+p>'B\Z YGUŦUQ hhUV(DUݬendstream endobj 333 0 obj << /Type /Page /Contents 334 0 R /Resources 332 0 R /MediaBox [0 0 595.276 841.89] /Parent 335 0 R >> endobj 332 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 338 0 obj << /Length 2342 /Filter /FlateDecode >> stream xYmo8_RbER$C}%΢~Pl%6ζ|^߼Pd;&(PIp8y!v:y,Enu0ʄNDd BR_m$e)VQQ* +|hߧ'Ӊ '< q"&'{'IqgwxO`=I+owнw>7™)-kٞ^Qnd.QTmf kSp`Ѣh쟉Ixj)SiDѥ+g{S۽Ke&4=nOvrK: vHmRܰ.F"b|MgN`a¢~Z~^V |)%~ዲ3|R߼`W, $g0TC$ٙA*%ҬKYQ2[KpZtjEinÂMXP IJ_e#oi9K;˶hnwJe-jiy ;?߂*@Uq*YoSƚ$]J*˛?.N5,r_# ?]kqf*1wG`}q)a"ߙ.0fRzl% $ב/p=q[!|XzE!o3īD\k؛0vI<#>n] ꌸ\Q:Fkj cqW6^c ZJY=k!{"3/ENjrY/?(檻[tpEfŧ:zM^"[EH@Q`Po# }o%@;0g{9)$OOFOx}U{]ʕ0=DcS?\' KdP*a\܇:9j;б,D։! ҇>D jpa ?R%&,P6&Ӵo^Ցj 6pZV<0v?iF]QU'O23 NsOV=/s\"OGc 2./{O# hs*|[4%X#, `B%T|@ɼ7SCA!k{qv.e'W N };#.dkϯT=RGS}PfZCrC`3mwAr ʌ(g BS,?YuX3@tlTm?%~0Mz娣tjծWe20*֐F>!$8"}̪5$:[ME5p4T~G]a=eh5׼ & 4|h]xαzAb5dm2pH<ٔs ^:31ean׬R;:;OHIVrSn~ ċjuo'P"3c#g7Xuo'tP紺CCMGbwLTIb83چy`endstream endobj 337 0 obj << /Type /Page /Contents 338 0 R /Resources 336 0 R /MediaBox [0 0 595.276 841.89] /Parent 335 0 R >> endobj 336 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 341 0 obj << /Length 2558 /Filter /FlateDecode >> stream xڽZr۶}Wl+@ޜKgIb[LZmMtD%ߟ}(ʤe՜ɌEƾxw7z8J(2\>_Il:.9]թLE9KGZd:,ӑ*%2 yIގr?9ٰ'z 2LHQ:\46F`dԲ ]~PJ}Q+θ#m!㖇#@j;HO5q{XpȽܕPPꃝVyW妺q]/ ^2$j&3<(65jAe߹Il˚,+A~62 "GGFeRkg c'1P5uULdF AlFfYf}|0B;αxZS=oUؒ"jƼjev" Zs@ L~1WQ1M.|hS"ńOĖVDZBEiS@ΆL#z>fƄhJtŽ4jZ&5J=g[f[sOG=x7naſT֨eq:sK0n>xk-Fx .{DѰP8\ath(C>v@WAdRc^vB.4dYC-O57u:{ 8T\dMѼPMP!e oCD~ܙ60|:iTkS;8AW _>Q1[1L+qhWveNzESqìr[bZZf)PAߜ2t+sP^x"̓Պ οܮ'YXI#h/>pzO?UY- 3endstream endobj 340 0 obj << /Type /Page /Contents 341 0 R /Resources 339 0 R /MediaBox [0 0 595.276 841.89] /Parent 335 0 R >> endobj 339 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 344 0 obj << /Length 2579 /Filter /FlateDecode >> stream xZKs8WHeBxIƋQ2~;J;!FFi^.Gd $ؽR sEٜӉMdVUQQbRMaE?o&IY3-3ͣh6jB¨Oџ h]=_F.ˋ@q$׭V7) i#VD[6[~G&[?{c"R i\fv,yzr <-].XF g*H8V?0Dc;t0֐`It]MDǎ REA=&㣟_ntM[Gd3sU?$`n5hk4| sDK~EVqޢgV[oDjD^j%p ?k7;-0ȭCm\g5M4dെCͅ6tW$m'|bNτЫmκz$iF{[r,oH57-VĈ;$wQSNS6t (iN-·ˊa}U pt nl Lhat*2e͓D9g߽-PƏm)Kr?=ك&sJҒxC "EAsn !arf0mxS6ٔEs Ѥ7@}}>,'BO`4aR(e*ȼCn/.N0Qp0{Yq 9PH'9DD(Z9Yk%3V_zsyLdKL#:g1y,2S0owc v,L cn{(:U:=tuOTBzX4fzɇ}̈́LԐ>Jn Iʝ]>́`٣c!dYb5JXxv̺11b!|Zh89Ykf@hBV,:]owܧ?G $A(~-T< / _9L]MfP!Ccw* Zg J|9D>d _rnGkJa]Ÿ庪z/aؚ֢zt -8Cdxp[gUPe|rFA}\n%9~_9йLn^x> endobj 342 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 347 0 obj << /Length 2847 /Filter /FlateDecode >> stream xڽZ[o8~ϯУ)RT2mH6$-fj+1夙_Br$A, D4E?.^BVGWQв\ lt9I*c]|j'i<_bhˉr<^T廣Gi$_2M. m|HFЅa,EZQ/.ѐQ0( Id@oYsJ$2B Hȁ, mQXBp)Ni kl#v+mseXk m@G~QBZ]QT% K-ҌS4 O Q &T5œU"{]}Vx^OZdVF(PV6]N 44>ŸzFz]1]VJȅ-ⓏSD MKHi_ G  $xD=GlDV݉v"M/&H1CYTBA0&/F.U<]M ˛-I\#H@mJ7m HC& 0*K}9Wj~h'>Fv50.Dȸ,;bW'.q FCX>־A+69{zX~2Tњꙑ%BxL Oœ`f%N u^uG3B{ش$k eO0? =-pg,,W-\:v'6SXjUЧ8/t<cݖl. j]ls${JI4©RE$l-*[dƒ.I1 R"y5A==A @5xMlZ$;XCBChBIx>Xw/n,=Q ~ YŦ❫ 7(m\xuÊ$K7/Q^攅3jɏŒ"rŬKv6QhJ(o~bhVε^At`AFޔHtyZT-X:e6hUavBz3rBsE^Ye>ѳJaj<۫\y:ɛoFS],yZyT@vv|~axHM*1?b#[W<^6]6ag=TezVgmP9,Qf3lGk ,uz`[N?]9`+B[,lyRق@cTh׳Tm|R7`v^ȞT _^RAL}Bf[@v*:Pof]/nNz#-( 9dX /rtVVmKsF/=/ 1tuUݥz f~P8%?G|U H7c4W(}*1Gw` |tP cT}7 w[>0O٠HDp_=nhϲkszo3ge"ta7-йuGht?'~:~"V? # ?¦1~~Y2mU;C`48> ;}$=@ua S lkEV#6"yGQ"`l?@^=\KqݡL|TU œĉPuylc!^_oo(DbCi`+mI%-ame`{+BC}vH;ơC-L?6kpt-Ka0f6IKBvoA.zfZԗےʷߜyf2}q?VyIJlv{Oa8Uc[ܘPI\ӻVƓ_~r*~G^zdwJAO0HU \ICs-L,CD\yIaB f\ےbv[qѡ%Z?"-l_Jh!X5]۱Ӝu4m v!;cC> endobj 345 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 350 0 obj << /Length 2484 /Filter /FlateDecode >> stream xڭY[s۶~ׯ# u܎rb'35Dw/EI&LL X,_n\iatx;0JImpl$VbFJ6*HfAEC:8Uxwnpv;H1Ky I T"N f]D d&(f J .<]4wL1"3Gr`+L̃v5ebՂh=5{h̪P'x;'"7f%F$3N}ex}y#kfq&;JD~Wy^Q#9'(ٞTZǑ:,U c-n>C*D: #2r'G|9+rP!st֣\Qܯ1 fՁ}oG}R(z!!;"_~:yvO0Qs fRx5]O>\LEb: h^W5B1! K`QŜiY>Vq,"υjrX5ݏfOG9ǐCRHu=ɴ*M#uX2 zK/@a;1+U/Vkt仞o6hXamGc9s-r׍8ER/nENN|B(ɥAHŽ1rRYq]W˛ٳ¤-RH6!gDS'vL0ffwώ*^^)j7a߈l;ke G,䆲ͶY8wطKT\b9hUS4 ΅PRĴѠ\OPЎ'[FBCKj*b{VцF #Oyuq\~|~/;r%]odܣsj)@):P|YtVE(S:I&>.s 3]ڦMGTfs<&>7E=!Ͷ@8AI<ø$a/w E$]S,ƼzJRaa$-O!K" `"R @i~2Ft#_O}a49ތuoesFX ׁ6ڂ|` c[(/;2='uin~+ Qw "*v[|b`F7og% 3vPo;T?V m7!b#@C: 4\a6ŗ'UHI]#AE*4d}Hymairf[XE, n` 5.Zp2ULjjC .-C MJ7Y+ȴcȫmС4,/@ ²zgyϫ@stL9ﹰC֨!2iwcr ny:uIbz=j-T1Vv'x#N~E)9C |͖AO|5^ Σ,FG}Ƭ'XI*k:'R0FAK/endstream endobj 349 0 obj << /Type /Page /Contents 350 0 R /Resources 348 0 R /MediaBox [0 0 595.276 841.89] /Parent 335 0 R >> endobj 348 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 351 0 obj << /Type /Encoding /Differences [ 0 /Gamma/Delta/Theta/Lambda/Xi/Pi/Sigma/Upsilon/Phi/Psi/Omega/arrowup/arrowdown/quotesingle/exclamdown/questiondown/dotlessi/dotlessj/grave/acute/caron/breve/macron/ring/cedilla/germandbls/ae/oe/oslash/AE/OE/Oslash/visiblespace/exclam/quotedbl/numbersign/dollar/percent/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/asciicircum/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/braceleft/bar/braceright/asciitilde/dieresis/visiblespace 129/.notdef 160/space/Gamma/Delta/Theta/Lambda/Xi/Pi/Sigma/Upsilon/Phi/Psi 171/.notdef 173/Omega/arrowup/arrowdown/quotesingle/exclamdown/questiondown/dotlessi/dotlessj/grave/acute/caron/breve/macron/ring/cedilla/germandbls/ae/oe/oslash/AE/OE/Oslash/visiblespace/dieresis 197/.notdef] >> endobj 55 0 obj << /Length1 1792 /Length2 11056 /Length3 532 /Length 12073 /Filter /FlateDecode >> stream xUX\˺qXpݝƵqw.B $kpK{εLڗ\ը &WVc5w4J9:21+ؘYYŐA@WkG W;;@ `d Q@֖VZq&D k3@ u @͙fS_NݜgrKh֤%@ $EGpC?rS4kw[y G{'7W h9T-n9*jbgm&`id"e 4Wv5܀޹ X4ŴUPT6vpUrgտfl= kO+xI:9[;Xع& }aX;=@O0 +xO Nd:-\W:Z.rXM~WW'9.X >{zZ+vTk ^^ n*aםj\~ b"" ,!å~8Y7Se~E7~8]7~8]7ӕ!^po&po&&oh&oh&?vM`S-X ܼ 3G&?CX~787!6VW xC@v X7{?5@p.pn XkxFv~9z0q9]2V`ŬW@;a k!-}w4Io,3ۉiW6"LI: KtʸysB˞^w+U׮ůc湛.H܋BeZ }Ur^=Ͻ١ճvcpcn%#u@?olXZU1=iC d;ȪO>GRPrd /q_^6Ŝ{?/T;,aXEùocUc,#um,|z'@%8X:`@JVmL4F#)׍>"RjJP=3 7vW1 {wPhDX+*haOq913:Ñ@'N.kU~f_Hy2kҸ~'akHͭmsJF@+D},(-Iֹ[Og5 RlΙ U&<Rآ*~pH(_9N`q|I.Ȁqi.J`P5iU~B}P7!\֮ftXa{JDkVOAhW33#QWpmB-+wTiD@}a܍kEj\i(0Z~դ8@2'pלW(T~AR CB9&/n"4Ң,"@;L[˷k]-QhLl;e멭1&-GǏIE^ C@k3fC_]~qZ՘5۩zRЬZnqvR:SN}W:Qj0pңkks2ZNPd!clx~S=zΗLv3C^6#ƠЊ&Q}S#L6хV>ޏ! &TIl E~7hMU褍qt0iw4bNGPs%NL,9ih&jE1ކV#_5ݨ52i gGtJf,Aj=63 wtu!C$AɪHHI PiOB^Ѝ_32Onc+ ܱZ=dY9sl`Tup<*VlN_e&Zyc8ƹs%+#` ݻ &Sr{/.n = +>E| mIPAj|Ɠ׍g8NͶ))"'t]T_p?\M%~J>sߊc'i3 IQݾA *yI#s:J0|Y%e8!y:9 /\ߺtŸ/~M\doԨ~ȹOY"*܄#Ν{mM]xX.@"-: hge'}uƫр^R.c)dzϹJ]v`Rre#VMdO'9K<UGyD'#)f{_՟KA8:X񚴦6&^@#OeHjuk:iu:H E>;f虚CXf70]2dR-}9W |dHTmhI~xn,c5>#A|E7d~X'JDPF!V!@6kd)q,#]jODQ7%Nhɭ}5׏f)ۢk"-GJsax; !kST5W߆ĥ-~-Mﻑ&0XYT҅6. =vFКᕣEnͦS\ThsŃ2g~ *|/Y;$T6aUYeINZӿX)Aς%D` \Y*#f]utX ]㡌M yiR-Qmb7s_4d/)~4%:Ҏ- e[Mȑ:i 9[tmȯKy ["w.p5`~fPx('_bd hԋ<ҷ{%r D/s'Z{FmS)CwG͑/sɄJtC͸0<>20+a\v:,^Z-a#D9e!Ck8މg^6.LN70|c /U%}q36STi34KITaYLt0+g&կH 1 ǯ N.3J^ rXӴ J(,}`% ]׏&>{~vRz .X蓪]Мγ%,By/:/|ߐSj˪B dv! ̷NSO(?6怱(2ڈ#YS<# YG:P?/楹]hW5wtS?铄4<6ex69u \7Ut[|?[g{Ў^D05*Wt/eXQm;_Ȩ.pڏ[甈V*M{v 9Ebb`/:k)#K>kJbHDd\M>SB'ϯ"L; O8\;zc4nƾpLyEy$bet/ZnF*jJ Hs1od*G.\pذ|@K&䧃`TѠjSX-k)7C69zm'CnSV+UIThacN藘]V0>e֥Ο'*b\5󐢭;:GE1NȞV6k@<"Kgzj^SOLosn OrU{KbF`_=zP6^"r1Ճ<S1=|f/EDyʏ}_x{whStV\'E#:rV}K_ߖ&̥|eUfMJ8m1JzTtF˯R ݷy{5r7v 2(8S! V'wC5@GA"'#y|B:rN%>&\LE0Lu|v(cPB3<`B7RaY1o'u /d|?)y0d8Ymw~~"׃Ұ=;cYLH2 mb@U_R)c x(.ʮ<6~TUx{c狩9(M((غ~ݦʿ }C3aSZ!}إb|&8$͕_!k_ww}71?c=i yɶ {w*}1*Ph(FT;(xمϛ}i ~$Zҩ}@`9fZ ! U+ fq2$TJH]tEfUT6≋,ްqXP|iQZzNT/og l:TN7 cMq<tLַ֑7 gvC9j1̌.3KOJt s?f懥ҸĤn@@P>ԉШIG?ol&{yDjS\jTL~PӮWbo:{lcu@ҞU/Օ8 K˨;߿X"e.ˬ Nԏ%s; F!fI(+lT?-Le7YިsL0}n呌uNfOvvQ1G&{i7ρ\:͢aM-aH) іU KWLXs~uz0M%_2?n)`9C5G//5t z.xjwX{^hNq{]5׻%l0W݌VGsnnﴮܟ̝Zw>%R{~I_~{+\jɎޠKP)2\W[u+j#Vucs;5fe)x6xґUQ$4r%PÍ6LyC.b*;UŭufLW'zy9<)L0QwrՁ7c wc~a&+EEO^t3J%|ҍF#R B'eOᯱlΐ83=px<Izݷɰrh8%m )oX\9h3:<˗$ #DY_`ʣ7DM+:?l9Mz`BL&h6*db, nhȕ)~PkIB9 -Wy{V^Y7+gojgĄA"(9 Ć{&ηDgP|_ȃa6򱠗h.T]{rZeeqaz16o2h'e[>ktY$ETNq@Ed~zmu!Ѵ2 v[Ȝt"z`8ѷ'aUJКCÄU*b5+x= Me!4k)ʨEM|BM,5^'XKu=8gJH_ k$|Ի9aٲp~'^""5zS5o)wu, JE}=j+1;]%د"o'뺷,n1֨5{ n5w5H/OT1$aFNL@d0~< BAHyȵ~MhP&O+U(@lڸ灦l,+S\b1|3QFϙ]0@$( #\E7ueД.^!V }Χ!Qy>5=uBz-x类0c'ГB6;)韐`RnU®}B$nL+@*)y-+AbLGy ϝeo9s@T'WWk-n=$>܁ #>*% 'Ӓ][q{D{{AnCeŒXD'Q*ܝޫm=ls B|Sh^ΫdTjbr~+=l '="5WϳX]a6s=𑛿@NO o{ЗVyAz}Ⰷ>I )0)-)9zN{>㝰$KIN $Bwh>+:*HEhEbKu~rٛs{"Wi#Ω*^}\H]2 <*(QZo$ާrM yK ]i/>+瓲DV &,+\t[A0,}=J"YO4<jV{8 PPD@¾zCNq"= Wo#panO84^ {,ׁS՛uW_A$;N@r,G$$87c\c䥞޸@97ys ݋aC'3ި']To}|A-VeP)ހ Kqoaϱ'#/Q #zB1{?z386 S2sr>IƴT=',Wu"䘏Ѝq 7}b3fGg2ۼΈZP`/(i$\I_~u3:J ]BشCi쯈zkgD|? !qv\k}8&xͭ7DL0b:|sSWGƙʀQH; ǂ_c60]:Ϲ1p \WsqL}5)!H}IymmifŸzMF`EHH(t3O~H)\-]P+*Գk(]~uov!QEG KxE,^5^pwHMx]<([Ó v։UsMt5!aL}DY<.NѓhG@-]$Bsr*qRQaj qN†>١,De+-8ICrpYL$=,ϒK:\ ~f4Y[hM~)( =p/a> 16sjFe7{bzb aILoi՜& O[hCJ3=H_M\7A)pCDPj)Xjj҄o&XͿT2het(WaM|uWaj6U2}^}hSO,YVCuǼ51_@HI$*ND1=5S$<AU谵 r L|LquO+%V6[\X6zLu>7eWTԳ*LuW>:*8Ʃ7[ Rr:2Y~jy* ^5%\^^&.@ƺ+Pei7 A+Hfe  R;,_][}YX]Th=Îfچ3 \uߛ1CcF[ux>%1Zh!zד]Q+H[vIQh($œto&rl+,n#Haf0&;sY i,|*Bf܍ s~Lh&G'ɪxUzC 㢃#jMfхE_? Zfr(V h혡FɼHqZxe,br)ԃ4GR$٤λF;w '~|29p`Z (k<8:2Nس 4"9MZ)0H#xd /fv@ aendstream endobj 56 0 obj << /Type /Font /Subtype /Type1 /Encoding 351 0 R /FirstChar 40 /LastChar 122 /Widths 352 0 R /BaseFont /UTBWPQ+CMTT10 /FontDescriptor 54 0 R >> endobj 54 0 obj << /Ascent 611 /CapHeight 611 /Descent -222 /FontName /UTBWPQ+CMTT10 /ItalicAngle 0 /StemV 69 /XHeight 431 /FontBBox [-4 -235 731 800] /Flags 4 /CharSet (/parenleft/parenright/asterisk/comma/period/zero/one/two/three/colon/semicolon/less/equal/greater/A/B/C/D/E/F/G/H/I/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/bracketright/underscore/a/b/c/d/e/f/g/h/i/k/l/m/n/o/p/r/s/t/u/v/w/x/y/z) /FontFile 55 0 R >> endobj 352 0 obj [525 525 525 0 525 0 525 0 525 525 525 525 0 0 0 0 0 0 525 525 525 525 525 0 0 525 525 525 525 525 525 525 525 525 0 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 0 525 0 525 0 525 525 525 525 525 525 525 525 525 0 525 525 525 525 525 525 0 525 525 525 525 525 525 525 525 525 ] endobj 353 0 obj << /Type /Encoding /Differences [ 0 /minus/periodcentered/multiply/asteriskmath/divide/diamondmath/plusminus/minusplus/circleplus/circleminus/circlemultiply/circledivide/circledot/circlecopyrt/openbullet/bullet/equivasymptotic/equivalence/reflexsubset/reflexsuperset/lessequal/greaterequal/precedesequal/followsequal/similar/approxequal/propersubset/propersuperset/lessmuch/greatermuch/precedes/follows/arrowleft/arrowright/arrowup/arrowdown/arrowboth/arrownortheast/arrowsoutheast/similarequal/arrowdblleft/arrowdblright/arrowdblup/arrowdbldown/arrowdblboth/arrownorthwest/arrowsouthwest/proportional/prime/infinity/element/owner/triangle/triangleinv/negationslash/mapsto/universal/existential/logicalnot/emptyset/Rfractur/Ifractur/latticetop/perpendicular/aleph/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/union/intersection/unionmulti/logicaland/logicalor/turnstileleft/turnstileright/floorleft/floorright/ceilingleft/ceilingright/braceleft/braceright/angbracketleft/angbracketright/bar/bardbl/arrowbothv/arrowdblbothv/backslash/wreathproduct/radical/coproduct/nabla/integral/unionsq/intersectionsq/subsetsqequal/supersetsqequal/section/dagger/daggerdbl/paragraph/club/diamond/heart/spade/arrowleft 129/.notdef 161/minus/periodcentered/multiply/asteriskmath/divide/diamondmath/plusminus/minusplus/circleplus/circleminus 171/.notdef 173/circlemultiply/circledivide/circledot/circlecopyrt/openbullet/bullet/equivasymptotic/equivalence/reflexsubset/reflexsuperset/lessequal/greaterequal/precedesequal/followsequal/similar/approxequal/propersubset/propersuperset/lessmuch/greatermuch/precedes/follows/arrowleft/spade 197/.notdef] >> endobj 39 0 obj << /Length1 772 /Length2 576 /Length3 532 /Length 1127 /Filter /FlateDecode >> stream xSU uLOJu+53Rp 44P03RUu.JM,sI,IR04Tp,MW04U002225RUp/,L(Qp)2WpM-LNSM,HZRQZZTeh\ǥrg^Z9D8&UZT tБ @'T*qJB7ܭ4'/1d<80s3s**s JKR|SRЕB盚Y.Y옗khg`l ,vˬHM ,IPHK)N楠;|`;zFhC,WRY`P "P*ʬP6300*B+2׼̼t#S3ĢJ.` L 2RR+R+./jQMBZ~(ZI? % q.L89WTY*Z 644S077EUYX`j```aYriQQj^ 8 OljjEj2k-Yӷs]|a>k_d?nvfJm@%>wX,iG /vRfǝ%ش9QDod;U? ^VNvK{~/t-798 mi"6=!y:I_K-,1{).o *[mF%s_-j(ls~gغ|K~#ﵾӷ&g]p_!GrnM`v^Dl>Z`.xYh.#8w6O~5{ބU7807k4鹇W5ùf՟VRŗm_AXOjW;[(ϴu,n q(ﻰƏA+̻3z^"_ٓO:~UIH$PkR-y'y='sBˉcWdtD?:`w[K_ȀB5j0 9'5$?7( Cxendstream endobj 40 0 obj << /Type /Font /Subtype /Type1 /Encoding 353 0 R /FirstChar 15 /LastChar 15 /Widths 354 0 R /BaseFont /CEISQX+CMSY10 /FontDescriptor 38 0 R >> endobj 38 0 obj << /Ascent 750 /CapHeight 683 /Descent -194 /FontName /CEISQX+CMSY10 /ItalicAngle -14 /StemV 85 /XHeight 431 /FontBBox [-29 -960 1116 775] /Flags 4 /CharSet (/bullet) /FontFile 39 0 R >> endobj 354 0 obj [500 ] endobj 355 0 obj << /Type /Encoding /Differences [ 0 /Gamma/Delta/Theta/Lambda/Xi/Pi/Sigma/Upsilon/Phi/Psi/Omega/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/acute/caron/breve/macron/ring/cedilla/germandbls/ae/oe/oslash/AE/OE/Oslash/suppress/exclam/quotedblright/numbersign/dollar/percent/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon/semicolon/exclamdown/equal/questiondown/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/quotedblleft/bracketright/circumflex/dotaccent/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/endash/emdash/hungarumlaut/tilde/dieresis/suppress 129/.notdef 160/space/Gamma/Delta/Theta/Lambda/Xi/Pi/Sigma/Upsilon/Phi/Psi 171/.notdef 173/Omega/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/acute/caron/breve/macron/ring/cedilla/germandbls/ae/oe/oslash/AE/OE/Oslash/suppress/dieresis 197/.notdef] >> endobj 36 0 obj << /Length1 931 /Length2 2654 /Length3 532 /Length 3309 /Filter /FlateDecode >> stream xRy 64$,~#@"T'M<@o nETҞd?C0H3L <x^(2{rC2DᾧޤQ8 /O&D z%`Qńb:xo,~RCL i!}/6xϿ[`t9[}}[Da$[_Y`/ 8`08C8MPPD"a!p0a'WFG/}*ԟ1w'@/D/B_$8>Dԋ@&"o ex_ b~/F12ώ/#yEC8\"`[hǜ'&G`*?X4HΘ Ø=hț!Z37&vARVYf])M .NeƖtߺssuN-_dm~>}GB+Wi7.}ફX[D0[wNw(zzsۇ25;Q4D^DUI*Zs_9;V9fʝNgV+7L'n>a)1ҵ[r+~\`\4* w®$ H 9gW4W 9nZV.53U@UFlu^+ҕGPp$Ӭi<@cs~t\~M!>d`2+v,0x.aK܌p\]VYH<2rVn KO}%y~OYL{9.ƲVY#Q{|iVsU ^"BEzKɿp>_xǯT9|Vi*70m+<:RF"cJB4V 빹q]Yv (H!q!Uu \7EN3JrplløR̀ZvkKF.Xn4eFf4ТP^ [[8?\30ۯԯ, .$C NSᅁ9FEсGd]¦ű)"Yk`&MǻR.jou o}S8|fibVC [ڗK2rN+lU\A}DYCE{EZv,tjZȯJI"_8sҝTED g/ ETm^!ڎm3@{iUvFZ,#keջ#e:[&"EMbh4XdB^=z-`xsvݳ+Lt's4I+ Cnϒrw$nJ><\{7rD}l&_đAHWm͖vBM$ Ig/@LI嫥34/ڥk.xc{m6?qbƒ#,=L*7I{@@̨LE̕O \;N*J?=ln",PE+yZzI8X2+-N-v1gJ:8ޜU]iӘ^نܻkF,XW6-?D L" a%+J˃LM\4 k'WJ ^?HkA/\x19%sAdi_>սJ3:tR>v8G6bKg;Hy] WNz.kB% EVH+BgcF߻_2;`REhG W0bbeRu!fK B9͘Otimڔ͐CMzFoW.U)Edu^'"T:׬ :L2zŎoJMHpj{jXu%Sf:rfǹ;n`1B֓[V{EKs# AaR1GB BCv. G`C x"^[ǭ>Ax=~,`LuW5Ëך(Z!ƲТ@E;gօiK\_k>"$h.__pLH3ǘv/Y$D[ų(Xy+~c֚(2+h;.NѨ~ytW0F1/wɷޥAtc!G[|J٠?sS%WN1~\h~@\ђ}z2X#\rk#]6׾Ѕt!ªC)b$lh)/LN<H6ߘ~Qw7,strT`qx.3I)eʌ֓Ylʷ▆R\Oʹ55^xwv"(Ǟ$Fz˄)}6o2ezQ#N%n'qs[p4֡jOIOWaeTCv/&jtg6i T:y&)1ċo2^|H oN ~{,U%bC/lbR:k~cͯ\TqsoB=͘{d# 5:>t(2}m_]ɚlzpO&=^0vPҍ5"G=`(@㡪6_:.ނ3DUT ʆ/9Q}>g?"}ޓz R]mPvi3wy5b=O,5p4^wNWD >ٱ3Wݦ,9>{lj }*I 6њ3_kNq>Y4QWxHѹUMS[ .6SNwM² ڱIaU2!KVXNZ2 8aM듔ԏ65ҭ "u~CI+ Awk'uGxycvNњ#/XL^.]Xf MQD"A4*endstream endobj 37 0 obj << /Type /Font /Subtype /Type1 /Encoding 355 0 R /FirstChar 46 /LastChar 57 /Widths 356 0 R /BaseFont /PWTDDT+CMBX9 /FontDescriptor 35 0 R >> endobj 35 0 obj << /Ascent 694 /CapHeight 686 /Descent -194 /FontName /PWTDDT+CMBX9 /ItalicAngle 0 /StemV 117 /XHeight 444 /FontBBox [-58 -250 1195 750] /Flags 4 /CharSet (/period/zero/one/two/three/four/five/six/seven/eight/nine) /FontFile 36 0 R >> endobj 356 0 obj [329 0 592 592 592 592 592 592 592 592 592 592 ] endobj 24 0 obj << /Length1 1125 /Length2 3572 /Length3 532 /Length 4306 /Filter /FlateDecode >> stream xy<}mle%%؅.X3fa3al%H5Ydɒ,B$[Ŗܩ>{{s|真i +m$ ees 0Pp"ӃQ*&r|N^TY Pw" {G2"`p` 'z9p,`G`PD,?N(?B2C n(w C!$]d* < P%"8,@`3<CԿX3?po xoELHP;/m($o! qXe`PH X?O; j~Jؘ\5ϟ> 8G#'Cajw" @/!H J@SA%E  `pHT Dړ'0<~XL mQT<:-JMʪ7(`D 0F"~CC(чzCH-q0RbA(R !!f&BjfCHRG: 1:: %E@FN:B 68/ e(B ȯAnߌPw @!'^jz< T?e1HVǽYUpKx-Wr[ul(|Sdz~z)eGx;|xUEZnwܹc!gt4֌?aXȈJqӖ쩾"o'2L zF\78wK~H5N1"Z·$jvOP?||+ɘX2t\6.zԗV##LJg HT. xrDt"$ZߑθW|&?kͨu8񣴓D?5I {Jh uDo6%^a74ڞ=pVs O:?q٪AI ]!l?U񤢆f ߩTD5},#&NZGW$+']i3'u}NerJaG} JSH9}Hɿ;oBq 67yj#ܨ:%LSD dW~wDQ7:.ʔ{ c=Vf6M%ww%e5t;F T(i,RplVhw;=I`n%úUuXAq7<5b{^Q酺4özߎ4^{!k9 .*qZPLb123;Y!(E񨸚*qKk{4 Rҩ9;N23\4<TCzC_.zN{ł>KSf+(G4$u*6R/޽SҨ5]{xt#< ~HHe;DqpxO o^ivC(&јcLJ9G -fw{[|sIW: oҸj89ޓ㪯N a.m˾KTޭ͋Jh̞k7Bhf'YTo1Ovɿb͵GgTB"Ћl\hMpBrSNs3AקSvH5G̉ '7ڿ/JoՎxh+]|]pTń%mZT oTq2oWa0 }V$ѿ2|!%^f݂`=_sh0.2hcSdBּ)%vUr .cìl⳺Y%]s]c6kI%Ӛ2<%gO6ϑ좲iJYl զ瓕bo"(w:SoaPUaQR*?eE;Rj-J\|{8cHD 93fN2o8{h8ɍ.ͱ%)Y~^7cY35JqGH K -UE'Ǿ7XM#9)y߳ Z`=OAƇGYlkkVW鴀y. ; ׎),K ɒGcIC:E9t ]HMugf8-ݷ1>HLlވT衔x&P-ٱ7Z:Ҧi)/aM3dv}x,uCC_$7] Oi=:ng?7)AzNqB3!B'>}=Sw"Ҹ%(L}if[3Y6٘T*KMiӽG yLc|L*wg3l4)<+Vܖh ?LcG h};KpKp Y13Rr'c+.MZ= $z:VA ũ.:;z` vZ6F5~AtRj d=2?YCبt]$|QUcMI>:eЧqEu1Q!,j64e`# ekںeL[y\ ׼A,q^ıQ62_ 3b"cڂgfb yInlK|ʆ6;[=AfZ\[|:zڲް 1E;=vtBû@OfK(eŪ2Pa^fUpyM čjajr9́xH aC+k1>-LryuyJl>BKkzrƠ;~F9Yނf΀/BJ7þ)}֠J]pFrE6 e ү9 ̎TN*UN^W-Z'*7 Q,W\-EjPUޔ@F)Zz' 3f==U9b\DSAJ2: 0 X@{ ^xendstream endobj 25 0 obj << /Type /Font /Subtype /Type1 /Encoding 355 0 R /FirstChar 43 /LastChar 119 /Widths 357 0 R /BaseFont /UUNLBQ+CMSS8 /FontDescriptor 23 0 R >> endobj 23 0 obj << /Ascent 694 /CapHeight 694 /Descent -194 /FontName /UUNLBQ+CMSS8 /ItalicAngle 0 /StemV 87 /XHeight 444 /FontBBox [-65 -250 1062 761] /Flags 4 /CharSet (/plus/period/slash/colon/C/D/O/T/a/c/d/e/f/g/h/i/l/n/o/p/r/s/t/u/w) /FontFile 24 0 R >> endobj 357 0 obj [826 0 0 295 531 0 0 0 0 0 0 0 0 0 0 295 0 0 0 0 0 0 0 0 679 767 0 0 0 0 0 0 0 0 0 0 785 0 0 0 0 726 0 0 0 0 0 0 0 0 0 0 0 0 510 0 472 549 472 325 531 549 253 0 0 253 0 549 531 549 0 363 407 384 549 0 726 ] endobj 358 0 obj << /Type /Encoding /Differences [ 0 /Gamma/Delta/Theta/Lambda/Xi/Pi/Sigma/Upsilon/Phi/Psi/Omega/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/acute/caron/breve/macron/ring/cedilla/germandbls/ae/oe/oslash/AE/OE/Oslash/suppress/exclam/quotedblright/numbersign/sterling/percent/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon/semicolon/exclamdown/equal/questiondown/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/quotedblleft/bracketright/circumflex/dotaccent/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/endash/emdash/hungarumlaut/tilde/dieresis/suppress 129/.notdef 160/space/Gamma/Delta/Theta/Lambda/Xi/Pi/Sigma/Upsilon/Phi/Psi 171/.notdef 173/Omega/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/acute/caron/breve/macron/ring/cedilla/germandbls/ae/oe/oslash/AE/OE/Oslash/suppress/dieresis 197/.notdef] >> endobj 21 0 obj << /Length1 1585 /Length2 12168 /Length3 532 /Length 13100 /Filter /FlateDecode >> stream xUTͶKp@q'@pww ];+׾<̪YUh2"E:![#-ȉ "*`gd'#q:Y؂D &..f8 bk`af$ 3t2ڼ06[Bp(.@zx&&hfg_agr:8K(ѤK؂&@Sxyjw73Ϳө5nhca3lm윝9[?jKNhblRNB 3k n@E 'cs#8d&ǃAHYXAQ濷AEC g?ߛ`f|2|bb c[ ``~މ @wcz{gLm[`O쿐- ;ZY ζfe0:A@ӿLɬc[?69'ɟ'`YYHC?V,{ ${{?^AWC{{{=?^O7KWWC4MWOKnj{u?{^/|'_B_]/| 5l`Ệ_ak88Vổ_nr ߭w+xaa[7O:&v3\\_j {g(󟨱=qa86xn@c[c䆠bo(*GԢTu9IU I2 &l B^* >Q妩ed/5Ҝ/nt@U2qaA\x\BH1!KnMlČ>H. aݢ.aX"rgA̧=1Rn3[.ifqIU,(.#q[XBsDdlֹM͕ 0ŗ@wJ.@l1vd@@0Rs?F#̙8A7Te~cs%3æp}~ ^& Z5QEs)R\.ţo1#ڄ'_L=RebHɁϏOIg8z~H8xt!dHs.[z/ߪ_Qɍ=C1!- {p:ޟZ\S tw9&"QRcB2JXw5oTZMkXl2KYL8ѡxt[$ꯆT?!huE ?Ǣg!yٕU?uΩm邘|':\{VK+F`pl/ш n>&-2Y1D:R%2>.WBs 6VRu 'Ɲjp3WfTNƾaw#g֧*;f,t_4xs~M7`.;"zóksg]D!B0ffu\d<9qBa!~Dz.O0u$r~C6UL߳, :ֈk qdF?h] > =$9]jMwC:+p-/eZ50JxRVR Q'%_)URajڭԔpxB0hh6`:~%lB5t.U5vh(F]P;q'Mu$xZ5\]^1vY%* ?z-I>/4<, ;p<$jF`T^B"0'ԭ6$!f"ŞgT䵺TzkE,̬V yk})/+@ :% O̚NC=bjm?,T~c]P1 ekz% vx8ar7fT۾%療Rk2o:F4Smlu اzs }D::&C9~NInO_“k8Xles kHfFMQXfS81hjc@,{{ȻƨRʉ3+I|*9?S©<\zG@ mTawHA:3 M]9g4v2&V{]Au#+အ@{j0N"ɡ=G-cBO @^FrVtm1-0ß4]hiXq؜$0,0!W2xSǻs澼)lJ/hUv=[o@~)1+qnda| pZ,dȒVGȄ\䞃3ҍ/dg|f{e8C.;z۔pjkTEgfxn=y g3"1c+|\?#)u7DԤ#펄;\MNDcN&9h=P%%T%^=SMjƘO5жMsw=͠ɞb'n>dLpW{۪⡋mTO&C|!*Tƍ<|pܑfQ - ؞xVzxA91ޢ[o]{-v8'4; JnM8y`&6XgA"nCzno2J{n5C(KVC+k+#Q.N {T=_Zw.q#mfR o#;fONwL|(.B i|ea,i+:ٮ`jz皛sj,Mºm#̆O@9)@cbd~N@MZYw3hÞD$'5D=Lzis>e/6qHLђt3+@i3_!W+=LȣL[: DۉRӷ##0f_z.ēIb;Œx<5Q0Mn4NQd%~0n8C&ڼd.bgDx1i-(85FӆA(d ڟ2ȏR W T:fkԗo^BUl?#tW?:Zr=4W·A17D(X AxJ?bQdC>s+]ȦEDm2.) }p>O˗uyF9r0d|?y,ȱI!:? pFW2;I}ŭB猱QQq樽U)bbnՑ+ETb&YiQ~p7Yh[.L**%Xf$vv2/9šw(2Z /j8aN aV(O,ppi)8 `@VxҞ1c_ѽ.˔ӐcU--QD?X||w*b]X`$]xtw,݌V6(~bj$7ٍ79 4e =Ӵ7Z؋ȉ4]:iZs^b4aQ Vgjk;:?)qͿ,BՏ|GdFx)oh) UR>+0XFT&oNJWI^>M?/3`'Lj6=Υ*̄ <T^ <ͻȺHβB Q&(ifgl t[)+u~/}MC?7%h_]&YE3{JdG ]mQJx.-5YE(@OnFK(0z3O:+šG@14 Rw\;܂aKP1j7v4ZgN!Y)2*_aӋBK$G^Uz %=7s 8޳ ~(Pu22(8.hhp$HI,$Jd_Y7#N#39]SzL:ɦ,M 4aƬ65+]D듖+~K&X!gѦYFlX*,B6Sxi٪HԺ$D.0ga zKH_/J K^q;~1v!hH>Z}Nmtl T475 VY v&"sbG$bEkP_zWKD}%?nU(Wكr,ʮ%0Tol5^e3 t< (OMCƹN0xXQB0|OH.ob,&ئy FL13lR (Y׼>_ !?zIGjyf 4~Δ~)7GS%#u_pd:^Rc"_ Ǡ*̓"m".yt& X5aA}h+VUosݰ.̎Z L[dh.)±\/4NwL7ƺO328>]BvW'cȞ:y4mpZFr[befjײI7'ZDni(%)ZtNmD> -;M l *& ӓR\gM?b\tv;{ yꉓaCQ#4Nw CQ=Ͼb!DX?޸_ka[գ=T+ $ Ҿw籲Z7Ą8d6aI]PNS3k_UPJCN;Շ_gK/>{ܑr fz8n̩wf ʋW1Dmɮܾvp|&c5 ##I^VV>W7k75n{A$th k " % J4`CHTsdӑЀ9TiRHTz$I/'0hl):#~kA.ƦL#Z(0AnHUKʲ)!v?DBW$"-}^cʭjhqUġxtg(#531#riE :$!U/O&ю5N{[ ]+yx܃uOĖy=$e;/ŒI ~cb]q]>b>0(l;F utyc@2;uv"E>Gܴ/P_%wEj]F%N&7;j .5A^Sp1]eWҚط\8*imo-|J p; f IY]FޔZ 7Mބ;ȥȀAדVɔ [~s!괠;}c^y7m dB5SVH-Ae^xnp*-V?j+742W3P4c%q.͂: >X:W_|`m­AT.Te-a|!02ߖ -sՉ^1vtZX%R `hC0/$ms A|4Q6܆qH1/SKȈv<t_8E"”%^i(o 7RuGf#*WFw7ݼ:ҘwJG#pOx^= /%`%|E2OM Ls[Ad}p.[04Pqz-:fS@0o<>5`/J""ĖAo7C# rV7R7TQC^9/9RLr?_ԍoR8,^G$5$? z3Kc ^o_U Cؑp !Ր˘869䚫9WgGS1Zs7mr&$`5¹$NLĈ|pF(dz9&jtzj1ME2L<^Py\ɎnQ-.lX Xw^@n2w>(x>~LZ3 71_]y:1GWs[M ZO/ `\S͈MA/p=IG΄]۽x Ywf׆%ĤCx7vC4-#{Qޓ t #!mn2[ nг>U8ܱnu tf?.;&*|r>͵Toϛf*ntWXk}ݸJvT_s(ckeHX"Y.ޭ1du^zٴe3@һp%$kedHqPO8@)քCChwD/`iw .Usbpח+ɮ+|s51c(jh⃮1Ks+aaFƾʉ;c UR+ 1>];~0, phc$oqu&^-Y(ўz!A@vJogqɳܚ ~椶{.3*6tA žzNj¿dpWpc8Dޮ11C@Lj A5yiBt>uA)[L&!]GÐu5M|Ubzj4NʒFH[U\b<Wt0 = j  LF*a^B<@H.zŜk3EͶ pQk J߭GL}GN6xC+| ^KNtЋԅz=dsZb  8zd]Џ/D)K|̯^6tzg-f}ٖ ?k,,}0bSn ؈%ZKku咭<](' NX/g~<0^aJڷVf=lI7H{7AY¾x dՕ)zUl5$w͡,+,;D tQҒ^'t)+eGWxJҙXlBJԥ=]~`c6Vqt{5>Zwøȏ_誹s!6>$:52p IqxD\MV%@YO`E e mЩϷCEnQFw_}# 4Э~3ЯN6mw `Ab|ph,7 7͌Zh0(=by68:*$B SB|DMaz:^)[!; ;x5$šGJhYH$;N84 4w-ӣj9K4.^-:fp-I/*t7Hg;]Im~)FRc ;EbK}ģ sbE+'lU#溈W$yH `f˹7D>Kv,s b; Z.쀎$Jr˦% Xk=Bb>,솕RVv1:V#-)G][^ x63g6VoEF Xu`n>!7.x GڹSnhE?Ɓ=b_B7T_\a { !brg3?q­ Ғ1`'(dو%th(Ǚ ݛ (Q;.PhrFB>-,bwti\*]x%a=)!g5VxPkךV?gk$SYMIcfNMM#3}˺${_lWU~=|6i~Y`YZ6=S 1_Wbg,19|R"=L7Aׅ6g4.1rFn:UTw3B>c_Li.ڛk8xQ)K/ T Vb4BB(BL+Tbcca(H؝_2RgfH̅46AL~!q$A09 rzM'~)OG"Tx7 h7k)Sit>NzhO[j8Kְ?hNM0yA !yc_ IDž:j$% rr(pS+ED&o@v48dt$vO8K?AUb-TCjdbAE N#`:E'B&j')l vU>6azk6 4Isb\n:(:vL?W3OЅkCؗ9E,k ,k]=EX~AFVp5ϳTeYLn㫪5u=JRK d#"}eMȚif}WmfY`HgDU@ޖLڔ5gq<8zqkU7]$/4ӿgV{/DY[FC[>YhkPP QN jY_G-Wۧciwcyw sՓ [NZb$/Yg!Eͫ )&Y⧝p#HHJ GDE<[rB:CJ競? =o"SFO!&r28Nx84H?NRջL(s`kM_rATJGJ#&SIe^!uAC^)dJ'gOf.RS0ׯ Ev F*:6tŦH#Ǹj6,s&ufѤ>Ĩ.R吹QR+FyxR( %ԝ%Ag.n#hъ #' d(eX 1@z]D)poNpK`8 X3 CIGΜvj'}x"8D{Y:(2_<Ԕ[Ww!PyUaԔB"oTg$q,Ĭ<{SOqwNCSo*_B`\3=bMA!6r:<\ޓ"$MgUNdaJ}S?NU9-;{$_$[<>$ZT+@a{Euj\Q;q|@r@ȡ?⌚/y9*< 2*폱\[3K\J4&nM=y$Ըt?@2?| ?hdkc`Fendstream endobj 22 0 obj << /Type /Font /Subtype /Type1 /Encoding 358 0 R /FirstChar 11 /LastChar 122 /Widths 359 0 R /BaseFont /ARBOPG+CMTI10 /FontDescriptor 20 0 R >> endobj 20 0 obj << /Ascent 694 /CapHeight 683 /Descent -194 /FontName /ARBOPG+CMTI10 /ItalicAngle -14 /StemV 68 /XHeight 431 /FontBBox [-163 -250 1146 969] /Flags 4 /CharSet (/ff/fi/fl/quoteright/parenleft/parenright/comma/hyphen/period/zero/colon/A/B/C/D/E/H/I/K/L/M/N/O/P/R/S/T/U/X/a/b/c/d/e/f/g/h/i/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z) /FontFile 21 0 R >> endobj 359 0 obj [613 562 588 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 307 409 409 0 0 307 358 307 0 511 0 0 0 0 0 0 0 0 0 307 0 0 0 0 0 0 743 704 716 755 678 0 0 743 386 0 769 627 897 743 767 678 0 729 562 716 743 0 0 743 0 0 0 0 0 0 0 0 511 460 460 511 460 307 460 511 307 0 460 256 818 562 511 511 460 422 409 332 537 460 664 464 486 409 ] endobj 18 0 obj << /Length1 2047 /Length2 15003 /Length3 532 /Length 16122 /Filter /FlateDecode >> stream xctͺm۶۶ձ͎mmtwWs~qyUOW]U$#VT27۹13q)31132 Ñ8\,D\DL\\Dc7+73 ?8lN&FvDrF.[&F6D*&Oz"!"p&R8pLLD&.DsK;886uu&73P_TD@IS{;O"S=0\FY::MNvnrSKW*bdci"dgn bwY`hbbAdfd W`g%+/EQY y_mFv.b? \'K"F2;%fgbojigNNdd =@b#f"3x< v.GkKdfOA5g0W D?D?O?,@vtwife$bp0r2Wu93 0џO8 9{?!"g#g?N"/fʺigjX8jٻ: ^n:+:rV?T[9?Z(;Pj`tBJӈ!`?_?\?"K CK!!!.J.*.j..Z!.;X\bOougs!`"?/?/&4 3 S3nB_ǟheW_ V!/Z9h\B_rZy@+Ͽh5}/׸731S .".v.S % 39'j\#,o`dobV'V4SI *l/7 jS:.Hՠ\9GiR*1>}(ӫW&SЁ! e TanGyVEJQc b~vMLrbetMwD`?p6_]E0I_QLYєο## f8A(K~3Ɯsm$~#c*=0`1(^)aN,xz?%J}*Ip僔RK I݊S{f ]@򇷫`o3>0ի1<0I.fn3̐2A]8O]me99U0^2M{-AjBd)63\)t\80o#0GFobPnnGMԙ_ƽx޿)\pMت4t cBW$,\|Ȳi tbvلgj"ޏ+24񅁇Vf4ֱL63$q,QL~^VcΑz MJi[U8*'+DZm.E4WODTDR4&rTk=\ Nʙxi+!$^T a  f$jeuTĠb N^g&BC",+YQć0jmֹaנx87>S L9P;dJ_S-ݻcbߺf4E}}d=OߙFˈ-p>:U(PN#+^;7˛ vO*xJ>UJAo!`,"Me}@=32XlE"%-5`LŚxAwd *;{| GT$T!hcʸ# SU?>~4* hsN0uO&P8_4$q 7[жxR v-{4%#F"RLY:̮]͙]W-&Y\CoF!D '0"tÛ9N0]I*X /99@c6!W[`STׄ0٨SO2/+ /CӯT2m}HL'8Hq>C gg\TGEN2j\󙜧E(ЉL:E]-EnySז:$= B%$/y竉blN ;%ըФFV閰\IETc:4jZ3"eQY}FIZ7+w UHODgBNuY Bvw{f僲ή^ϓ64 5"m2xe!NhlqWڶ,q /o%Y|X95d21uv}+6<:zIWW+^_ >C v)jlL\0sP4E>$@0d>2XAJݼڶ}>@`5]1sW'j7''ܧ! .0o\ڔϮ1IW.i 7*D旞hxGYǐ$5>"F8Q$b-3[4Y>I] Je‰?aT=e3`CZZ]BGN/\>,ӺjUAܨ0Ij[],J14u(ux@0qmڬ%U5^Ejl(|L$ ڼN5^J-ߔK~jpYe?}~8ޅ]K`~G[EINߞr>;Q8Xf%dMQ**ExÔ+&} LFTԜ','u -x &*~{_ǹigL'IޞSg(MI^,i7A@34V9bfH–-SEȶDiZn$"_3Z4q;s_V6*4CoAL R Ԁh'HGg/ G`>J܌^^J}+_2.[o$mWl_ۜa|& c \(lp/&NX`mLEO5 oȣ6Đsd8! 䧚ܦաiu\a/fh.rd5Lh`gݶ9EZ¹[B(b{݋1J eK ݠ~n ;s'E8ǻ+PB' T)Neq>BtARX%A.ܕ$E?3'fnZR:&j%q?]rQcq7 Đ*gɽxwBcz]!eǒibc8|JfEik:{qa$oNbLkK]t(J*~3DO\ُ"iȻ嚞s<^nDe:yK֦&L=T {ԏH@1~wkBy^ y :7ܭ .A;1WnzkF##?%{h77Sl*'xeފYnF6lF78e 0_}Z*BJ#ߊshoe4v?ΧٽQda6۠'Vc =^ʿB1e| Io>ީs@*2U}D,L"kR~pyt]ZhŦ<wYxhe^ot,4V[?c$ ZP+H^Ũ\sxዹD~b Sfe{CUix.FUPRzUA0 x>вD=awP*8d8 PCՓPੑ)>q,zHf6 ƯN"iZ(g2PLs.2/" E OebΡ ݛ 8jR~EjX``=<˾o8G9Uf ^!u*Oy>#2!..}a䠿=D?!rSWser~~Ub2".^#-w#i!iT <ꜟ;S ?ǶT$Q6tzMqy3D(P{.@y&'(N\prQ|2RD!d~-nzWY}T9%`=1 Wh^^ {pjUv߇B7v"1t/u\(oI⪓K-=U}(ЖByi8ka ;:׀xTOmM(_nf pmGH|{y\n_8s/"-l1Cyd~S!TT[aUAjbg1&ȑ$bS\ gYRScPGgڸ:U}ŀz;ˁf-&X\L|Vݗb26JM@ւLIґ D/ Xo'^~f1tQ[UrqLZR)gTXy Rm'u!5?AA?5ŮDXԗ\sN9kϡm3XYC1_C)|c-y,R--kjU{8h bkR~Ap/2^]k e7 >yeo2c8~e8gG6D5\W"̟*#T 1 JRĄe)3m:\|n0x4t=fYbS!GqD1LQ#qUk8J*IuyⰮ}J66u06ċ2pIu‡ç`3"Ox|a!] u@ˆ]᏷uC3Ps%A6|;ɉOE RSR(U\R1SX\<_2R8oWl\d :N&bRr $"`U ծYv6SyP,jIrit'9NM `I aagjfDjtmbxhv"o頃7ͫϛa'!]5Vݎzj j V2KZ4xMf-}0מu.4'gV:[Q'WhfB_àD))0=ײ`VO[8fPCX *)yX o>p^j)[H~óP/0P?I>-\\x'hL=[)^5X=s62s#%k&Zv@p;E}Uuɱcȕ|;eǩe.o2<:/,umYoӥYb=3\eI&|A6&V{o4!n8nfA([Oyd,6x/WMZ?Tt ?D>܂CIjA]eq2}4~ Dg [i6eR2 $$!(Auv!Z&.vHD 㘨)geV?.)'I"> d*xT\Brd爑Ռ늃 O9InNM UU~c K#$*K,:ܑ ]{{/Qu߮2)7.bž]ġۈ-7⺢;LЙT]U!~T+w%$7&J;IG'x".")7xZvhp_4n/)eiu| /Ǎ-mWd/׿PD REF{{ߨI%0b3o״askopV⬸[vÙ3q~pM"?i9?aDbYk6e@h yŒ38 P\ 1Z8c&q0`<ݺ6h2Ļt=E5IjwGa;wJ3 5HtuNYJvquiNVF2J*ϕ,}*RuExfTKaKw-%7SϵךC%㛧8GSz{3Ԧ27KRnTbNW/󳞎Fb5뵨z!&*ꩰ m%=-^-5qHWʦ0 ^1h%3A,`$i v2z|L*gc`؝oaUi`j fisb?i0[Y6ȟ'r0GNDzh^|R;;ʡD ^+mUS-CÈJE\7x^Ej}ltHEqwx^H֚0H γ^`nE7=g[ Ў,Xqݭ3]S]A9mvf duXue+UM5NJ,AUoGpuWfV!LAc1WSz^$ 8? /7ǒ6-7f#{Vg˸3%6 @Nď3+86z ݘӒt"WBEicahox}6;t%0¦B^4~_mE"K$,Ԍ RpT#s}ʪHNa7*Ub[GW HSgQϭKax¸{z9 ,0e .bvHt+)J&8 !hY긻ph2s\iZ,j @[x"zJfO#wR٩RU&C^ ؝<|ѯn74\oАFQUb1.fNSޤz]^olbulҘT=Rxrk"8!`V?T70d _-Ev"]ׂ!ijց? 6yDMm8!ˈ̵>i%Sy=IkHV>8@_kl[nA&ߴr/ńcгSsMż4WKnƊsP>Lrd]+PBv@z*mIB+tµ,*^'x[U(wfǔ$ݻBH%dxЭǢ3{R~6/tַS90g"=IKwl{'-| 1{ݣ5-+-ldV.3&W roj1s.(i xSlj.v^հ- +ҋ%~;Swid^M;4M\1_24XRCnH\6/=jnV_FnoذI(9 /|Z]nju>&ŸQӆGwb1c jF>] ]eBQ1w1ۮe+Ѽx&/P.J)F80;E#/ghW5tePQ*0|!٨.c5c6b7͎>ͫ=,)r "o4]igC+v;Hj*JC$H:jjʴsS "!Lwɘb[VC>4 _XMb( #d~ge'Lūxɐv]=C\;^(j;qN}A\ bdaqی ZIMPHKPi?ڳwut_a](֔W%䍰C5T/[+%NRO¿p,nQExu$ +Idz4 9+ QO&9eܧ`0 !UTR]Kh fi џ, *h[Dԥ+ڪP Z n,HmfZKCA:x~Lu?C>?3ht4jo]3ϵCFٹ~S-Jڶ0mNYx}]cZ];D,Y/O?A.m)]xEw()ܿ۽=K0 9dF_XD wǂdgr 0yAKO;@\cc{erM]6WAAx\R`/mh͒W|b>S`s @9DNM\0gI!6Q<wƀjg4D]@[}c>$0&A<f3 b;Ǎ䙪`T̪8>ݐ:j\&ºt8A*i8uEF ύ9@]ٱz6Ʀ|]}ET=v4Q*!= > 2ZI"Å?._ P#r`T`/'キ_2hkhڴ ;`H<$HG AS Bmy M>2lQ}GwJXfņ#P|ԣi^=&Ġ })g|WD$i.1"VSeAaI4(Lw?x~m~ N(?zX06ej$M\D>1.E7[~*iGvW$X*dPU=?,bv+}pQ+0I4: _IDIm1Gi=Ţh#̧\w[bG/?Ԏf"ɘUޙ%WNpRU%VIfh-ם~ha)G/GmOvKDu+uW)PKf(cG ( t0ZXa|p q5_q_!XgQN M&qB1gqU %Gg`Yq3#ߐt)Ib9h 4B$IQu#osH)<_ˆ8:3Lj䵍#U`'竇 FEy zA#~l d@C.{|Џm2 r_@53W |̀'LA-eP BC]ֱeDPo-RکSG7`A6 8CR ΓcCy ks`΋ u蔊PҨgh`gy,c9I "d^tZgymQS1̪9v 17R[E.w3(f9dY6_0xBM_[x71_-;9zxv/Ge(2'>xB>T J+g]j^"dAKFޛ򧹸Ղre+ӏ]fM0̱%wqJݛ// ucHn)O{' Bnl˄{h>jXRGn,^U~/G}XGb snP !8J* >bOvY5R$/,mvQ%`J{&)G(ҐC9'|{ЎYj7VozLj5LNr]E,촽~L7ArKfL}j΍%g)jcs[ڦ9}J ?3uISߤ]˷+m/Hc*R[,^J68$od*eU~B^G; hN5t I#1]AVD!TH!Z6X0s49Fލ"J4 _p(RPEwW6NS/~ sif` Ȯ-SeU(U5dŴnmV ߎҴaeJnd dVΧa1-xF?J|Sޒ4iw#>B^pSsE*"i‚_\BdՉ&=<͖^1ׯƪߏ$qαi'i76}9W GJHT{Cj?2s6B.$v&5#xDw#U.!A7-om WF獲cEQ*C^7Q έ(tYJn%9#e~2s ԣ*)_-e_G[H]a"1>gG?0 {+6зSebӪׄ8m;a9 B\QhYhpUΌbԜQPk7R>3Ta}M@*:SwnT}HEI5N."IpTRsWl^mv.{gF'1^Iݚz 9OXj6xC_+g^P7XK9 kQ`^?DLPtM b'gU'5awV\s<#~:%X5.%J'$魄z4c^2r*%˜z}bIDwXD8kNK(EU=? CgP fwѾ )s_ ( p͓y"vZjVAMսzmH=r:`rY"mVH4.ĢlC麵Cկ:Ybw{eV_Fˆ$YЈ&ikA*\5$x:/F^giq2*|X5-R;D0.ӌ"veG+]NGwΠ^7/SZrߗ+qKot[Cd ¦Fq{A!$}!T]mc~:sit;> SR(FQtj=r&s՞V^,Fw3d*ns|I?OIN^CInCD*~y1ِ%TF`Ug~* Oe~47]Jo_2:pT?..3YWwSG-9ͳ^yI= 7"yX0"OJ%C]򋑴~\ݲLmt",0n48lAMZ/׼sLXI)2}2^ K*FM*1Q9 \S7y17x's̥c&S+ ĀXADP.7(fV!G'_=qIkVjٞ!i=eS n,I\mendstream endobj 19 0 obj << /Type /Font /Subtype /Type1 /Encoding 355 0 R /FirstChar 11 /LastChar 124 /Widths 360 0 R /BaseFont /PDLWWN+CMR10 /FontDescriptor 17 0 R >> endobj 17 0 obj << /Ascent 694 /CapHeight 683 /Descent -194 /FontName /PDLWWN+CMR10 /ItalicAngle 0 /StemV 69 /XHeight 431 /FontBBox [-251 -250 1009 969] /Flags 4 /CharSet (/ff/fi/fl/ffi/quotedblright/quoteright/parenleft/parenright/asterisk/comma/hyphen/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon/semicolon/equal/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/bracketright/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/emdash) /FontFile 18 0 R >> endobj 360 0 obj [583 556 556 833 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 500 0 0 0 0 278 389 389 500 0 278 333 278 500 500 500 500 500 500 500 500 500 500 500 278 278 0 778 0 0 0 750 708 722 764 681 653 785 750 361 514 778 625 917 750 778 681 778 736 556 722 750 750 1028 750 750 611 278 0 278 0 0 0 500 556 444 556 444 306 500 556 278 306 528 278 833 556 500 556 528 392 394 389 556 528 722 528 528 444 0 1000 ] endobj 15 0 obj << /Length1 1847 /Length2 13050 /Length3 532 /Length 14087 /Filter /FlateDecode >> stream xU\\_ ݝ@ и;4Cp r̓^]Wj$* B@q{;F& 3YB hbio'jpsāƠ Џ3<@@-B'@dibd3rڂbTM,.!?+@gД`ji0[3IfSWtrPK& $` 4ge!w7':Zx go t'loHXٙat*ZX̌lLP%IDKSCI?_7,\T=1u j/ +L0rr2M_Xv@j 9ٿll 7~b099lf.,id j' ;h Zgo`:1pfv4?A\,yٻ:1S_ qΠ>AҜn) ߪd0Y- m,C\֊!Pb&NPT&@uI!Pv?.@(eW7q+!Pv?ʮ@UE!?Ң@ZMܠNF&@6lI4LBwfP!(/gBPBT_*/ A*lB ?:B $/p A2/5/r AB*? RTy U^} {|a`T|pjv@)Q z:b3KI zMMxB}&Khckfbm Fdij4J0_#ڼcR Ҽ 44+pE M;5 -z)8* }%r{rN.itݪ*aAhkN8i5w¾:+ȸDe1Vm$$ /I24%CLM6בRc2De/i:K5ˆ' ů[>b0>k\v^B <-G`'# 擅+}+Q;Z*L|y <RQ_-:g[ke}]|v) Lh Dm0 u?9d3 }P1Aן "C)x˗9VEdo@ ps@ݣQxTzCy3]9}<<ܨaLiKUc驌/ +Wٸ|HZ5jD֬7ƩkMߺNkot+u=17ȭY+R#澒# BW I-]CNeNV\|8%=}@l_fj@^](FokaGs^V.2(V1qi˵TJϫA+ye3¤TvwiӊEՏba>N5)ۃU$/ܩOL:VgnRvH1U}FaVz_ۘno-jP%)o ٖVg]Vޢb %yģ~5Vc}J+v΁?Hm>e*){$xAdI !# #1Q2(z*c?rb`3T?xlB,VAIr)1jUF(A2)S8nCWI%|abͯP`Ѳi~uO%7;{ 8ϵnK_HO1zkb7w:YƬ(}K_wR]$3=J\5],E-6T\Zʪue2s߯yO}ʙZp258N|2nŞbP^+ FdH (䱯 pjY^YyXm{/[Rd3=#+\{kL hN-}'w>R7 ·Fpyy*zs2l}y glt hǷ:nz$⸖@( | KbJf3S@41?.1h$& q˴RqIT&#!xzp҄A$c%LDS|s YRY=U14UfBOΘ'G[g$^s8c_ƨ]7ٓƲT5X#t;n.:bE.,eHW`(v=%f^aXpX⩳j6 "p8%:#jЂi&7הKo*)sCtoJ'afQkQE>=|k̪!Poo"a7y#aҡQPm:&(\G)cq\&m<3[cW4C!ó#됴{U򎇐8fWFc#Y)]ѐRm9צשI{q߶FKFܽI5|`yȪi_|깖OKx1lQR=.`ŃB`T9;xX^\:晾dG_ߓ}KCʹ NO(i0Zڸ@-t^.TB%:sh%ia|+n.?Uz8_)Ԟpo0. rN˵jCi af.{v~/]Dg_c Ͼu?"=AjR, mWހq7'prLyrX:, !"}4CE{Zkc(WJ< =\/IcIz,GcHJHl̫\"(-SH vWYk) 7(׆8[b.vAShPŤF\Rrl(fU'CeB#d{+oCīR\Yq4V)a[6B:WLG멶j{-fc3BH& H y*wtB7c.CM;1][Z?%-on+FMr` OKຽ3jk\b< [o|x'gC-89ϑ }?-i "L&KWsQwU!N^)Jpz3Շط _;`'M#]@xEòӐNRc IQfoڒPZHfZ_Af,^txxN/o*F>%en/6VMD%-`jqB]&ecOS3QoRR*+ws^u/ڎ%`|ٶs4ްB04*+_,B*76v۴/F1NP,u>Rlr:9M?|U%EWi#% !)Gз}HJm o&"' /hL9;NTi ޵>8~UHKh5$W5nFzlK#; ja`i:`*Hu>A6d/0 MlbL @G[W$N!kV`5"I-rSC 01a ?%:RJuOx$TV&oˀ"W@Ƃ6gz#:A4u%ќp_3TG[W58yQ3my "*F;=ĿSK|t"Q*v?]O'&MY#xyYHIy~,}^58V{ K%&F7/?,Y?Ѷc]wwXqa!asS͛|oLՇ+̽K'*%! U ǧMZU,pŒ߰<`n XI}II(6a(K嬏dIe(RN)-bбp|0)HmKƛ[Gv_x;RJqO.d3UmJ~b{>-2-?bye=XeHo(Q9WWb73W.37ӚJR455H&=K͒\4ܩ._ ͜o{X6֣sںaufPG~֯څf Q yTCLF,L!ҁg;Sû Ve߮ .G^?#Iȹ5WsD3*γT u)h:;%\p/*u}0(ʏfsb6]w dcjG'Pp6ߤUz8;*ql((Xqe‡ z).C! }ځ0 ޓeEҩʕRZ_qF* YwԙM;HLUa۔hbqsuf>DPUI N3ouN ~dqG|D J+^1Tc]._%,oGݡms8O.~ ܀8~dW .iQ6q'swĪhP$d<$\'b魊*El)r:{Z}TEdBS S􎼢0 E|]7-Hyx' ,ǻ|N:W(XT¥pқ7trA槥9Դ}W2T]KְOsfn ׾M9\{Γ8LgDלJ ag-i]>D)hѼzfc ׇB(t*|묙o >d~E1g}K|'2]=wC2Su|5Bb,ɽ;~J1Nַl'GXr E$G6 ûrP.n/CDE? FejAcz{FZz#i3 d?:-Ԝݦ~i@I1 Erg¹M%D|'{ȧ9'hk iM>v]FH?QnFe]iUYjO~vm;ھaz([NvcDB >.eB5g+c<|5W< lϖ≤3d܀$VKM7)錃ȅx#aqA Ȃ^UúAudk˩_9G򌲹#1Yj1:u \L'K2rP('k ~|4K&:mII&M6sWibAȢt5|j@C7 J!7J;y~Ѳ1 €Xʵ|پ^_´h:֢Ɔ\gZ$MSħ,f'Қ E .=xW~N %'(sٗgYWۼJc5ބn;5+T)ELW%E"hɫY[qȞ6ʎ&7mqP:P }[~멝Ju4Ns?\"Հ/td2v_5\r4حUVQ48_boev00[6j- {E~Lnqt杓`sa6贑ZRRMi/Mid܍z/8cZWx쓌؅:4D" 4Is*Hhm-ÍݐNηM5 v1~b/S6XSxԛd lj.4'Zrj.D0SpÿFil7~~Ya2!UJƑQ%fAz2t.WAfO>FeqM+jym}e)(c%Aa.T擟GI+8"Fp:_l<\ wXmc0䚉Bo[$QW8.YN4 biBn7Z^,>j ks]k;q9Ůs_acLV#=qznݳ%4 οs%ŷn!2*fk@a:>:JĪs|hI.O+Dڲ; ^K~BMp|2\#;ג^(ק[ECQCW~i(3 U tݘd'#UxHQ/ΐNE=8{+h黉XJCo둑cz8\ַ)vƲN>'pATbGu7Ӂu:GeDco$Y#q|`a>^bUQ!P^eQMST޵jFAquG-T!XNN!PZ,;gcދ[VOw3w 1E)sCcF1EU'&tNB IչqKƪzsuǂ-Kvrfл+zQu}Jң(-`Û ԑEE0r悊$\nVw8_g"fgNű񏒢(0VPޯHnVqVw _5Qp*/鍾L-`Iė'rJjN JQg[ָgC#XTn*-i즒I-U:H|"<$-/%I" w6NQv+AҖ+Ox;<7X{.5݈ڕ|ڐR_B.|Ǹ 5_W)8RhR'%D=+gcطd˱`\֤efLwh0$t*YA^Jd叾P{sOm[bkÊںYfڣ>>i =aݭܒ^Ⲗxm1'첟X(_'O[ HBM};}} Y\.-XvpenO$B^y8 uW Mf8I.Rq5AϧBDn?) ILMBJ`4yNCvk8SH.\3zN-[,`dCbHqsCgʻ&^_+kZ֊spkDj8A1YZAߚz/¼R\fKn)@#CR0{bu-7\9(CJx͂: jrm SL-Zia 1):pֳ*Dbw*pn#x- `65_Z>+hܤXYC$S4*+wb2,\0弸7JYŝ(>,z{Vy> 9-+ك-gU\[tL}#i_}5h&'Q"XDUbaH7>a"M`XZWʾc4$fMfU'u& uYU|f^bY4Yr뙯'a.p@^<|P$1Z9TG++ )Riufo\2A Һao.Sj-Z]knb61~& %>~.YU&yy`~MC>"4ts26#A[-е*Dbl<= p*FݺΏ|U\dC%INYU@NܘmSX,,`*1eČspץoZRK"D ]/fgXӭ &~uy:dx{f#X x뜚t ٯ=בkJ ޟF|I[wX)pȰ.ړ<7"\o ګܵ o~V؜{똤BJE;ZE6mz;s<&8ju Š9Сm7 ü^M?qo -x_~lC:,֔ .X_ա6КK}ޕ{?{2_7ÞFwկuPLi~dN ҅n{.4#DC~/B{6ψ I ML<7XǟZ$B=!0R id<ĿU(M+-JiRM(\;/֞zSEnz3$Ln=kp wA3-́*.@0uFOC <%*NwiPir &,+>N3:Y2# 6Wk;GPqo %[H;1}BTU|> i1+Tl`mfZ`ߖTBz`/RYko{\0j|#!n_-xvvkw9?@o~x):> endobj 14 0 obj << /Ascent 694 /CapHeight 686 /Descent -194 /FontName /CYXWQA+CMBX10 /ItalicAngle 0 /StemV 114 /XHeight 444 /FontBBox [-301 -250 1164 946] /Flags 4 /CharSet (/ff/fl/parenleft/parenright/asterisk/comma/hyphen/period/zero/one/two/three/four/five/six/seven/eight/nine/colon/A/B/C/D/E/F/G/H/I/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/bracketleft/bracketright/a/b/c/d/e/f/g/h/i/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z) /FontFile 15 0 R >> endobj 361 0 obj [671 0 639 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 447 447 575 0 319 383 319 0 575 575 575 575 575 575 575 575 575 575 319 0 0 0 0 0 0 869 818 831 882 756 724 904 900 436 0 901 692 1092 900 864 786 864 862 639 800 885 869 1189 869 869 0 319 0 319 0 0 0 559 639 511 639 527 351 575 639 319 0 607 319 958 639 575 639 607 474 454 447 639 607 831 607 607 511 ] endobj 12 0 obj << /Length1 1657 /Length2 10311 /Length3 532 /Length 11262 /Filter /FlateDecode >> stream xUTʶqCN@pnww gxYUkΪMJ$HodcvaeJ+00hIIf6B@NH``dbg'غٛ:)ڛ[MVEC3- h 4g`: &ft6+ld!gdhdcm0؀ '7Lgr'KK}U5oeflli#NU˛4?G- M,D\Frfc}Kqo tJJ2Tcrf֎JndkAձ7sh3&Zֆ6Ff֠ зw <fF@Wdv:Ngw_BB@go;2w_' J* 3Jw@gfk b%1Xa|8`M  @'tB XbmP7D~ '@zR '@z2 '~HO7pJ @* @jHO7g`oht `'?[ t;Jm@3}pAJF H վ?$hj6ǑA.,@ al  H:*; N ȆǭpA6@ ?#64LFPA'S6s X8:ك673 h`c%<1[8 \)V{!WpˢQI;Z4t]]Bg̘gն_4]4Տb&̏Noi}~̠bj$MΈgn&_ ˑra-tXőQ-R_Y7/15xL[/:Y|Y5nOjHdG\z"ކdme-Z+-*##Kn$~ 6r@4IcqTn2]0W3PW۴{߄#үڳE K-U:TOB+Mw\5[!<A6KZɤK%;, WXӄq*:')-I^It4ی[ndSGX!1 yk58U$~}gNbZ"5BbWʉl+Rt|k2ST"V1:#tWnj55<>^#?$}pǔxV*lE@Ԭ}n |Xb y%˳2CFy[@h{+#DJ]o75jqd$*& lڔ,+ 1kGP^^sI² C58pYrUnuћt|Q']w)egn`yiRO^&bb(`&*{22MAw*<{ aI;vEJz)pą_v}]" ?]=vO!FnFϴpnq.. M4t"Yhߓ+H?^N՚^wݑ 1 76פe*Gm/d(XV*&;0 ؏KAĜz x9ZLI<#bb]b F_ Bu>>vmֿ  HtM7hoZV 6d=Q^K'ZK0#u23J`4KHL Ai`"zFjt<תȢ>s(`~hUo0CD7YV_,qU1}-g*;{z>aMu>6A|vP?@0ghGu5߀t3 SgDDqbd09IP4-[ϟb4YhRȆf.!5[豤~2WD{ߋ8Z%7YJpf)xD [_wxg؈i~KlʹCd dxq;$PQ@&WxUiS[[nP"MZyQwz]<m{>;:#k̼@㓤ʬm$6kW%%,ާRTXl%'OuNgl]X^)"lTg^fs$<>> d|=C?,tc^;S7ɶ@* g.B+F 7^*̡P鵦p1㊦>#C1ܳ@xAqwwʈy)OAy'#)c)zRxf)ꮞ IPUNf<2PKi O3f#nyVe|q|@fWcw^ޏi^ khyb?UʕG#7!gEi1:XW"v߮=D|ֆi"M{yYP$N{OUlo!^^4>wX ,eiRtA9ކ-ZOC|xV* yk@ e1]lk ;V̷=kOV#l 3wLu/My_'\؃S,_teo{[,k5!c]uG--CdQؕyCwK)'l k<˰ܓxqj`07Lz֋qN> ֤)~Wh'Anٍ#=ő\an=/1ܓcӃ|eb&bs-x£4r>uK/va?#V7xt߈_)E0)BxW}ێҐ8&[\_M<Gj:Kmh^Tx,c8r$2[WzG.}2Km8Q aA_1iyeoE{O|!sB`ΤjU.ý2KDu:!W\b`#EԚ9'3e%m|*c`e_¢̅JUj`E[)rr]LQǤ/@c``i 3an3XULT. ,e`{nax#.fE̠ .'Z&6"ؗ+#LT}p؍On=tcg/Ţ׷Ga\q=0= 5(SX_zh1a"'EtȭOu=/ # hv]R=f5? rUD2{e9FWWv7V|e[ F[HSEndC7נ lIw|bf̎퐱`h:!N'xg(X g=u'McV hjp\nz`V26Sv?j0\,};"#G%` ߷(-vHU4\ԪALj9@QCsIԞK[ 3C^ j;Ldw'gD߫pnҬQ1Z\(!˱5Zмupm8cXBZMJQBw#V~H 'TBç\9w> 9s XdxѸNp/:U $~p"O(D"t@ho>,`\* mQ=S(`w#B}szA|0U@ KK &5}AwLpoFTmd飋ށ"<)ڵZs-ZhzWs`SGMg*uJww<9k1 {$O缗ʏ_{<,ˌ2ijJE#@VlKuost InmFUf˛g*O`l}׷e ,in?2':iVȂ_Gܩ[ !$j7bmF"OIXO'9ܠ* o74  * vuI gv$M3BrgFs+\6|o5^u;:=;YHt,uy8^4j@6^K5Eѣ$TPzI=3rNns$AX/}hgYE~o?;hzSAy^҉,Z7cOy$֜Ga| $? &z)-IE:7r(KEjLfp۪׊Egi3I j~`RU\g#S0a "Fl#oew15kY T.6m~E(ؖ `o|81nZ2/0#ы87czӁuQyx9d7}o#hh*ÂhxptcC1̀B?5+vK#USrpoVddcc/:y;I_!)M`F]kMn o1"CnFk2.}ML_h:Jw Ӌ˜刨9ᕍbowulׁHbn͓ڨzekP $s *c>[&I6o#\Cl&%uTV?zN'Ք!)\cؽnC-"ot^q7vrI+֑O,yuO~jID$! V_*s*~"DPQ awvU.=|5e3p`6b[WEg]ZO:$u物dB#24>* 5yY寜PpZM3wr;Slum4S|MƩ`GҿúrղMpWeTm -]c' 93bETBP3B,ah^&JB]@vo<4UrXG?K_x@e=`xLg|HoFt@s}=AhލW.N=wz WC49nG,#=(T&E`Lm6f6FuhӢPydê !RO19§J*<&}2]*҈00-"M$3;]͈'/ ԼCSaMDoV <3 wcc"()їe&=>" fEݼ[Z'G)ewݼfRd,Yj"fv?=^Iv~deVCcHv!J5:g0C%h ꇴ8EA[n=<^[mCKF͙C O NאvC,O[* gwql/nmhҦ0m=uXO2+* z 85%&`P ܩ/(D#.'.K%6dBjx|>{*/1KjRq!H`٨gs(p.ݺk#WE_\gꕇS[0paͅ +g5 lEe'wg4m t2,8pWKnVE:8`ظJE4R { )`I;f@u=Wdm~(l{X~oio)[?bX)OHW9/0Ⱥ!dXo ٥1-"A|P0_K8l(bI>Ia苲wBՌpz3pmƭg㾌ڪci-WH))-Fpĵ}~nM-pٽᲪ.E35hit6Oz:iz}+x -` &|D S̯nF0V_ <+ #Ոr;Xwv9(ZDb&&,"RURIpи(|@#9ۓWcPL~-Nyw0J u7843?Jaqt<tK8 hakJ}׉ 4 b8@GpT:Q boFvZ_tAH=Wd#A^xf`gQ3?} r&~%.a0/ʝ͋$\mסTmr*,IT@٘7/q<'Jijؗ[!Z]|\ j' 3 =e2Wo+x3bPö٥u":Yb?5`!&ϩYe|ck:Fk:(a+o;3_}y"l7c`uv3*E pgGhI7#]}xWLd) #'|;r"rx9LyW%RuTp=i֤,s9QmANt¿F~SSb"N#=nE<gkBQ?R_~AaDt9z9x|J~:l0#wLy$oٺ֎ zGo#~Z֐t PQ1b ЖTCs+m/P %={ A` *$[%ܶhQ͛MCǬ쉴Rm4#D٩8LOG?BrϮ]e5ӓzQ/6L& ؛4ˍǔHڐt<2zuywJTѧ|e *#oTlUpB7~`Է7}}DuT5Q&msP'`̿X!!\9M=O?pN!%*?K2^w l\\t̏~özvqu] f3[4٠q4T蛜 ڹ(T{_ے`9k(=$SЫ^qCFޙ>)p 8oX0OvumUS#9l'w[۾/o477'LHlڭ9QkFYKbH2%ա)2A (4oE6Mf:FZJ!^߲~w%aMw8z-xe嚦._{$B|GG 7S&]P1!_Hux/of+d`Fpyeg$T.K:mȹz[ BI㍝޷6ikڑeԖ EҘ}`bq5Xn_Z&3#ڹmɻ9at_z_v31؛f^+L=+l,i6w"  {YZ ϲ|iXSW[ᖼi 0Oxr bscF40Z/)\P$&6RfдJ=# dD;Ou>CaF2~| .myU0jSgZw*LnAQ{{IXov]?a!h[Bʅ6ViQ :r8Ǫ֪BsZkU)݄K-wYeTC)q25|Hgu@7SO/)9 I=v߷M^Mܙ7Y/Lsf4F>չЧ}Ԋ8=*i)!>2fP'DŽk"b ~X(>sH|<\-#z#_?n(/[e /, (RH E3'ȭC*֢JeacayS 9'"%PJorendstream endobj 13 0 obj << /Type /Font /Subtype /Type1 /Encoding 355 0 R /FirstChar 11 /LastChar 122 /Widths 362 0 R /BaseFont /BQTTNQ+CMR12 /FontDescriptor 11 0 R >> endobj 11 0 obj << /Ascent 694 /CapHeight 683 /Descent -194 /FontName /BQTTNQ+CMR12 /ItalicAngle 0 /StemV 65 /XHeight 431 /FontBBox [-34 -251 988 750] /Flags 4 /CharSet (/ff/fi/fl/parenleft/parenright/asterisk/comma/hyphen/period/one/four/A/B/C/D/E/F/H/I/K/L/M/N/O/P/R/S/T/U/V/W/X/Z/bracketleft/bracketright/a/b/c/d/e/f/g/h/i/k/l/m/n/o/p/r/s/t/u/v/w/x/y/z) /FontFile 12 0 R >> endobj 362 0 obj [571 544 544 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 381 381 490 0 272 326 272 0 0 490 0 0 490 0 0 0 0 0 0 0 0 0 0 0 0 734 693 707 748 666 639 0 734 353 0 761 612 897 734 762 666 0 721 544 707 734 734 1006 734 0 598 272 0 272 0 0 0 490 544 435 544 435 299 490 544 272 0 517 272 816 544 490 544 0 381 386 381 544 517 707 517 517 435 ] endobj 5 0 obj << /Length1 1794 /Length2 10992 /Length3 532 /Length 12003 /Filter /FlateDecode >> stream xUX]MhCpxpN6܃kp&x={_ݗu7YjYVZJ5MqK9P!Tx`eGtۂ܁~~8#%ͅB 9{Z۸J2 wZ9m5, [7+@ 7 dEXŹֶN(l;Y;א "x d@-ANK R 1C..vpP1sg7su 3 PY]g.?$@![7[/ 8*@_lں : L<5ffesaz Y9 vY:A7r2 uz^c6V';d %~++?l trZ3Qw n\6 ٟ7'Y2d'`l '࿙g"n +c pBe@ ;o=2u `sK2IA&H!H$ Ix!!H3҈t! TWC*R] TC C?qC?qCc3w5S?w,m K[8!}ZRB Z^mBH!D/X8 ?p !B4\B_ϑ !B!/XyA7/Xy+$$@^X ;k1懜KvdKA\vv^'jv#~@b+[ z-PAv-ES֭ *=?QCJG]?gbQx>Eu˜$d̽ye]e){:S݅cvޜpCάV^ G\5hՓrЎkpXJI[ @jcZuq _Z)yo<&Gm 3㪟 W)r8 bg鯙ݍ2k8/<"qU~TE.ԆO l]ecjrK>V4Oj(#x#+ m6ͫbR|ꦀLrz;H,*5pœ%Aa) mSdi(Jd,ȧb(FAy_Omu|4&E61otPkE:;#mc=ݨ,VE b'%8t# .Vh˸݋YUYUP%&IVD<{SfvqY-al#Hf'䳣Y]/ hEʷچ6δfJG`5U敔ݯKYf?h$Opj]~m*}o7YBp1', \Z+Dm>VgâO'o[klu]3#r  O>e#/u!9B_(.wލz Oiҽ?)݈t\*⒎XJ&mZlZjMV,fn?c %CB}V&3|S*V^/k9Qg`S5wu  b"kHز>5KȚq{S6oqU5.k "ӗet9T" =Y,TJgRQլo ]Œ_HǾNv2k )Mty(1}ஸG@WN@D*30ija:ZhAw6 ߫0[& !-OAyVn̄׶F$7 LE-/i+-d3ߚy2ξVp,OF4g(S `o)eyOi6NΓ;,T.lE[2.F{iWl\9ӏwT)8{InȈdݿߊd[#$C*CN] |)Y6uS:挝T(sT('%NNF>ґG=J# ܦƔI㴌!6\fwQ]4Qnvbv4VPo=HZ{{XaۡL`L![=EOfʠVnDТ g=LVF 4A)bSf~\rɠwLWr#Rc bKg-ぴIDC?#Ĵ%-y;+ӎ?8Uh/Dk'фO 11;B+?"q"|̱Cp*+p;y2?"i#MZaΉ52L`8OI`{fq+g!y>o ׷.W~%<9CuA*<(X $Y[u$/Rf4S4)|jChtetnX ;dunW񯧢^1 unҮ,@JB휎Sq.j$SJ.3&,"[&qj2I۵:CUKeZk'z|F y"@ys--|X1Y.1KzNZBטYSd8}i?@jkO,Ln!:cC~ "wfVBD*:6°4_O}etwBҠTzg:[SubX9 td uQL`_t.z5J(Lob"4hF2'YvZU4n ~!?C:G=ڃ;aԁۻ V+κ"N?^O,h]Ӆ"}nE{A*yokTOt/KVx>WًVX?),E`\vUCMSe9XLM!ɉۄfP팎UAg\g;Rne9Jܤ')ɒѠXN$4HaE3Z"AV SѽUqNXS$Z6n#gS!LUmC\AKò0s)" |Uo:Ssn֐>P*ǦEu_/KHy;Pbԡ Fw:8fSRƚBR<7FAk0ߦ:ށx0D,[=1De2~FD"NfpLH ЛWTj6sފӔρ%ݼ#BF{asomƆ7k}mɮcA `w2(>cy_蟺;'W1\/H5VDti4MN-tʓOcū[2)Z^_*ЮFPV9 1U!5Τq403TCmFm&!]ӌuDJNtBCYt10!g޼dd~a g0JL04Ϥy-,2k ˵Y3.GKlAJN\(a%wC_*SXȹ*Q̓jzL'-tcABEe2D_arIPeV<^WIgT%p+ZIUO-*&v#H*,H篢 *h&CC5û a[CG˚ NxQW#1%”N)&S4Hh1uRU{4B҇%pvʝM<['ԧI0Ί © $19C;, sޫTmޖh&?0s=ybXwj|tc!Uj[v<.7 ĘvR%s@='V7m̂ &&O2>w$s,L ș19A6yMDТm3@Ȉ[y$ fj?kŧ^;xe>KRhK{GH +-D7؟`?ԏšF }eQE> ou~<%Hl*x ߷DdfW& ^Qzy1vhhtñHMn-%‚ZvF$W`c]0/?۔%c/<*G92PhXzyz!8Ww&;$+`Egʙ&R Aጡ%[ݓsv.yPϡW!PT>dYXn]l?d{7YkOG3¡a) <EkM*-9mtjH,* w [mgq DKQG.m{ _ {" MtBpdPf(qo&tt޺x2L |@W*8&NEcR ^6.cVCPR}cm|'nk=ϔQWH:7 D:;J;m'G\G:zڌ]_ ֨2Ip3cI/po&ymŸP^aߥ3\Av}:D#aZ[?J<Ƒ[MaѢorgbz9-oP<_,t?yv*)7 0QM7 /g_2iCvK96I NJR䲠hD},b^?,U>3Y Sh„kϗxizڔR5᥼3&3JZ-%bud@=pڃsoXO`G؆  k$bJI.(<b?DBNоZPpSr73+RYTm{o]ߕL4prXUEeڦ-Svg FI@.%ߚt ŏrFPA"22s:8yQ6M TҮ+/VrfhΗDҸ_şy1)88}X^LDlOg6V5vw ![e-0r+uǒmr-nMQ{?>m7yZ󶷐2e;+m,+J}&wbѧG$(ANΐA RaGzlH<8g ^JXu X(>+h ݠAcDO]7V{;XiVՒhrˢȦ"ahM]Ϯ1ywbG^MWzS9@ǯ`1Vջ?_$αAbPJ9+bVx1CI;W}sN=к.D7cꭠY MJ޴ak ز _I 0I:E FZ6Rkm6+[f-Yc(?$KRI5ܾOSۢ\TJhYUw ʄfa|8qJZծnFάx o76ęӌ27[WqE=?1BtǨַ=CL6sg,[|9QёQW/_"Tvt5X k^PY<% ҥ4I*ãp8H.Msh%FXTN5e 8g6542eL'dG$֖}dngW 3@n䖩U:_HuQN@1q=׵`nFfG\[q*N{^ ^"(uʕP)޽"Q8y|ZCPHKB{D,@YXghtpnu)f 7 @=ix|'p7sV0}i@k @%%5 ||a \-2O]\, t;Þэ~m4*~5Gxd^}a'. 7b@ؚ [UDRsK?or=ͯqi<*|:`I-Gy)E%960ոqj 2mG|.EձJ;^ 튰jz5Vk|QRZL:H peM#@JH]aG\vx/}73'zNT qu[Iݮ˜t.N4Wlؒe>r 4ϧWr>Hpús3Cs5QF"Hm+p/!xQ|qF 'R&7e6 +|㳦kf{a&g$'*.J6C^-:4cO<_ |Q!-jwR,O / ȏZZ ~J#0S{Kc PD)շ C[(~!QčUs)2Tt$͝jVhL}r,;ohr+M Wo&)bEbq*hbT+C(|hٴz<0c'kUP)bYp#nJY0-ϢYMXz˛`Xg&B%`.\&nWlK%V|+rXx}nIE}gf$]Ps !9%Rp}ع7+CBo`U` c[[t/A* e*O\5ŏIht9! :'noAݻe1Y]"O`A7R&80V Uݥ3ݩ*(A._'q/[bhFs^[[ҠV:3bW䮐~W :vg4;ίٹ" X%4ѝJ/,a`]C#J0'q&6oԶ#X|qLOw*xє zK.P/ 8!Vi~Lk3Uj2#{xylaay?|x! Fymža424ߋd}M,,U:F7dz8}U>5&\,(܉-^7qx.WTF'/Cͦ’OHsm]B/Y\G)$XDOG,y21'IWZ2^ޚ_&Ԑ̈텼u/c 3ج.:͑2[(X`Qȁp#46m :Agʗ/cPOTeރ\vqڸ"~; $VaW_ j` ڭrg"ݖNI8"&_)xP}ɐ XNfx>c5bh{rk#ġZCK%Pm)ڪj}!̴V^p'ܕ_U}6駧"G1/ʗZu™O5B3hˣmbp*X}AᖆVf{-`yxTjRPt bY~»#2~:UffYdahD0_b3h|,"扇Gh$>6JF 4#*pI7 bj=Ew ]>!=JNS)Img)y]NUF k6󎩸%hu0Xt ML*:("@f,ym%7p+dNwƔ*9N 2?[xȁJa<' njR?jN^5/u&F QMQ6S`KLӨprs" { 5OI5oeE&ƾTʛ']cf&6t0aEI]V\:%]PdF^HIex~άspnL4yM1NV #]zbH.E8ʠT g $V3ҹe(NA _hj܃endstream endobj 6 0 obj << /Type /Font /Subtype /Type1 /Encoding 355 0 R /FirstChar 40 /LastChar 122 /Widths 363 0 R /BaseFont /UWIJVJ+CMBX12 /FontDescriptor 4 0 R >> endobj 4 0 obj << /Ascent 694 /CapHeight 686 /Descent -194 /FontName /UWIJVJ+CMBX12 /ItalicAngle 0 /StemV 109 /XHeight 444 /FontBBox [-53 -251 1139 750] /Flags 4 /CharSet (/parenleft/parenright/asterisk/comma/hyphen/period/zero/one/two/three/four/five/six/seven/eight/nine/A/B/C/D/E/F/G/H/I/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/bracketleft/bracketright/a/b/c/d/e/f/g/h/i/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z) /FontFile 5 0 R >> endobj 363 0 obj [438 438 563 0 313 375 313 0 563 563 563 563 563 563 563 563 563 563 0 0 0 0 0 0 0 850 800 813 862 738 707 884 880 419 0 881 676 1067 880 845 769 845 839 625 782 865 850 1162 850 850 0 313 0 313 0 0 0 547 625 500 625 513 344 563 625 313 0 594 313 938 625 563 625 594 459 444 438 625 594 813 594 594 500 ] endobj 7 0 obj << /Type /Pages /Count 6 /Parent 364 0 R /Kids [2 0 R 9 0 R 27 0 R 30 0 R 33 0 R 42 0 R] >> endobj 47 0 obj << /Type /Pages /Count 6 /Parent 364 0 R /Kids [45 0 R 49 0 R 52 0 R 58 0 R 61 0 R 64 0 R] >> endobj 69 0 obj << /Type /Pages /Count 6 /Parent 364 0 R /Kids [67 0 R 71 0 R 74 0 R 77 0 R 80 0 R 83 0 R] >> endobj 88 0 obj << /Type /Pages /Count 6 /Parent 364 0 R /Kids [86 0 R 90 0 R 93 0 R 96 0 R 99 0 R 102 0 R] >> endobj 107 0 obj << /Type /Pages /Count 6 /Parent 364 0 R /Kids [105 0 R 109 0 R 112 0 R 115 0 R 118 0 R 121 0 R] >> endobj 126 0 obj << /Type /Pages /Count 6 /Parent 364 0 R /Kids [124 0 R 128 0 R 131 0 R 134 0 R 137 0 R 140 0 R] >> endobj 145 0 obj << /Type /Pages /Count 6 /Parent 365 0 R /Kids [143 0 R 147 0 R 150 0 R 153 0 R 156 0 R 159 0 R] >> endobj 164 0 obj << /Type /Pages /Count 6 /Parent 365 0 R /Kids [162 0 R 166 0 R 169 0 R 172 0 R 175 0 R 178 0 R] >> endobj 183 0 obj << /Type /Pages /Count 6 /Parent 365 0 R /Kids [181 0 R 185 0 R 188 0 R 191 0 R 194 0 R 197 0 R] >> endobj 202 0 obj << /Type /Pages /Count 6 /Parent 365 0 R /Kids [200 0 R 204 0 R 207 0 R 210 0 R 213 0 R 216 0 R] >> endobj 221 0 obj << /Type /Pages /Count 6 /Parent 365 0 R /Kids [219 0 R 223 0 R 226 0 R 229 0 R 232 0 R 235 0 R] >> endobj 240 0 obj << /Type /Pages /Count 6 /Parent 365 0 R /Kids [238 0 R 242 0 R 245 0 R 248 0 R 251 0 R 254 0 R] >> endobj 259 0 obj << /Type /Pages /Count 6 /Parent 366 0 R /Kids [257 0 R 261 0 R 264 0 R 267 0 R 270 0 R 273 0 R] >> endobj 278 0 obj << /Type /Pages /Count 6 /Parent 366 0 R /Kids [276 0 R 280 0 R 283 0 R 286 0 R 289 0 R 292 0 R] >> endobj 297 0 obj << /Type /Pages /Count 6 /Parent 366 0 R /Kids [295 0 R 299 0 R 302 0 R 305 0 R 308 0 R 311 0 R] >> endobj 316 0 obj << /Type /Pages /Count 6 /Parent 366 0 R /Kids [314 0 R 318 0 R 321 0 R 324 0 R 327 0 R 330 0 R] >> endobj 335 0 obj << /Type /Pages /Count 6 /Parent 366 0 R /Kids [333 0 R 337 0 R 340 0 R 343 0 R 346 0 R 349 0 R] >> endobj 364 0 obj << /Type /Pages /Count 36 /Parent 367 0 R /Kids [7 0 R 47 0 R 69 0 R 88 0 R 107 0 R 126 0 R] >> endobj 365 0 obj << /Type /Pages /Count 36 /Parent 367 0 R /Kids [145 0 R 164 0 R 183 0 R 202 0 R 221 0 R 240 0 R] >> endobj 366 0 obj << /Type /Pages /Count 30 /Parent 367 0 R /Kids [259 0 R 278 0 R 297 0 R 316 0 R 335 0 R] >> endobj 367 0 obj << /Type /Pages /Count 102 /Kids [364 0 R 365 0 R 366 0 R] >> endobj 368 0 obj << /Type /Catalog /Pages 367 0 R /PTEX.Fullbanner (This is pdfTeX, Version 3.14159-1.10b) >> endobj 369 0 obj << /Producer (pdfTeX-1.10b) /Creator (TeX) /CreationDate (D:20060704165800) >> endobj xref 0 370 0000000000 65535 f 0000000306 00000 n 0000000195 00000 n 0000000009 00000 n 0000360394 00000 n 0000348113 00000 n 0000360236 00000 n 0000361132 00000 n 0000004602 00000 n 0000004490 00000 n 0000000374 00000 n 0000347373 00000 n 0000335831 00000 n 0000347214 00000 n 0000335014 00000 n 0000320646 00000 n 0000334854 00000 n 0000319738 00000 n 0000303336 00000 n 0000319579 00000 n 0000302629 00000 n 0000289248 00000 n 0000302469 00000 n 0000287817 00000 n 0000283232 00000 n 0000287658 00000 n 0000006926 00000 n 0000006812 00000 n 0000004729 00000 n 0000007782 00000 n 0000007668 00000 n 0000007043 00000 n 0000009204 00000 n 0000009090 00000 n 0000007887 00000 n 0000282915 00000 n 0000279329 00000 n 0000282757 00000 n 0000278156 00000 n 0000276752 00000 n 0000277997 00000 n 0000011554 00000 n 0000011440 00000 n 0000009332 00000 n 0000013043 00000 n 0000012928 00000 n 0000011670 00000 n 0000361239 00000 n 0000015776 00000 n 0000015661 00000 n 0000013147 00000 n 0000019037 00000 n 0000018922 00000 n 0000015892 00000 n 0000274354 00000 n 0000262000 00000 n 0000274194 00000 n 0000021623 00000 n 0000021508 00000 n 0000019165 00000 n 0000024371 00000 n 0000024256 00000 n 0000021751 00000 n 0000027461 00000 n 0000027346 00000 n 0000024499 00000 n 0000030319 00000 n 0000030204 00000 n 0000027589 00000 n 0000361349 00000 n 0000032893 00000 n 0000032778 00000 n 0000030447 00000 n 0000035602 00000 n 0000035487 00000 n 0000033009 00000 n 0000038745 00000 n 0000038630 00000 n 0000035730 00000 n 0000041258 00000 n 0000041143 00000 n 0000038873 00000 n 0000044377 00000 n 0000044262 00000 n 0000041398 00000 n 0000047218 00000 n 0000047103 00000 n 0000044505 00000 n 0000361459 00000 n 0000049953 00000 n 0000049838 00000 n 0000047346 00000 n 0000052139 00000 n 0000052024 00000 n 0000050093 00000 n 0000054562 00000 n 0000054447 00000 n 0000052267 00000 n 0000056666 00000 n 0000056550 00000 n 0000054702 00000 n 0000058811 00000 n 0000058693 00000 n 0000056794 00000 n 0000061435 00000 n 0000061316 00000 n 0000058952 00000 n 0000361570 00000 n 0000063430 00000 n 0000063311 00000 n 0000061576 00000 n 0000065114 00000 n 0000064995 00000 n 0000063571 00000 n 0000067559 00000 n 0000067440 00000 n 0000065243 00000 n 0000069243 00000 n 0000069124 00000 n 0000067700 00000 n 0000071510 00000 n 0000071391 00000 n 0000069372 00000 n 0000073719 00000 n 0000073600 00000 n 0000071651 00000 n 0000361687 00000 n 0000075935 00000 n 0000075816 00000 n 0000073860 00000 n 0000078229 00000 n 0000078110 00000 n 0000076076 00000 n 0000079867 00000 n 0000079748 00000 n 0000078370 00000 n 0000082504 00000 n 0000082385 00000 n 0000079996 00000 n 0000084404 00000 n 0000084285 00000 n 0000082645 00000 n 0000086534 00000 n 0000086415 00000 n 0000084557 00000 n 0000361804 00000 n 0000089285 00000 n 0000089166 00000 n 0000086675 00000 n 0000091761 00000 n 0000091642 00000 n 0000089438 00000 n 0000094957 00000 n 0000094838 00000 n 0000091926 00000 n 0000098002 00000 n 0000097883 00000 n 0000095110 00000 n 0000100763 00000 n 0000100644 00000 n 0000098155 00000 n 0000103961 00000 n 0000103842 00000 n 0000100881 00000 n 0000361921 00000 n 0000106734 00000 n 0000106615 00000 n 0000104126 00000 n 0000109615 00000 n 0000109496 00000 n 0000106899 00000 n 0000112483 00000 n 0000112364 00000 n 0000109780 00000 n 0000115080 00000 n 0000114961 00000 n 0000112601 00000 n 0000118052 00000 n 0000117933 00000 n 0000115233 00000 n 0000120884 00000 n 0000120765 00000 n 0000118170 00000 n 0000362038 00000 n 0000124071 00000 n 0000123952 00000 n 0000121049 00000 n 0000127147 00000 n 0000127028 00000 n 0000124236 00000 n 0000130059 00000 n 0000129940 00000 n 0000127312 00000 n 0000132276 00000 n 0000132157 00000 n 0000130224 00000 n 0000134285 00000 n 0000134166 00000 n 0000132382 00000 n 0000137226 00000 n 0000137107 00000 n 0000134426 00000 n 0000362155 00000 n 0000139982 00000 n 0000139863 00000 n 0000137391 00000 n 0000143056 00000 n 0000142937 00000 n 0000140147 00000 n 0000146009 00000 n 0000145890 00000 n 0000143221 00000 n 0000148489 00000 n 0000148370 00000 n 0000146174 00000 n 0000151346 00000 n 0000151227 00000 n 0000148607 00000 n 0000153683 00000 n 0000153564 00000 n 0000151511 00000 n 0000362272 00000 n 0000156091 00000 n 0000155972 00000 n 0000153824 00000 n 0000158598 00000 n 0000158479 00000 n 0000156197 00000 n 0000161966 00000 n 0000161847 00000 n 0000158739 00000 n 0000165129 00000 n 0000165010 00000 n 0000162131 00000 n 0000167994 00000 n 0000167875 00000 n 0000165294 00000 n 0000170697 00000 n 0000170578 00000 n 0000168159 00000 n 0000362389 00000 n 0000173906 00000 n 0000173787 00000 n 0000170862 00000 n 0000175270 00000 n 0000175151 00000 n 0000174071 00000 n 0000178254 00000 n 0000178135 00000 n 0000175376 00000 n 0000181010 00000 n 0000180891 00000 n 0000178372 00000 n 0000183281 00000 n 0000183162 00000 n 0000181175 00000 n 0000186419 00000 n 0000186300 00000 n 0000183446 00000 n 0000362506 00000 n 0000187962 00000 n 0000187843 00000 n 0000186572 00000 n 0000190822 00000 n 0000190703 00000 n 0000188080 00000 n 0000192628 00000 n 0000192509 00000 n 0000190940 00000 n 0000195794 00000 n 0000195675 00000 n 0000192781 00000 n 0000197251 00000 n 0000197132 00000 n 0000195959 00000 n 0000200088 00000 n 0000199969 00000 n 0000197357 00000 n 0000362623 00000 n 0000202039 00000 n 0000201920 00000 n 0000200206 00000 n 0000204393 00000 n 0000204274 00000 n 0000202180 00000 n 0000206300 00000 n 0000206181 00000 n 0000204499 00000 n 0000209196 00000 n 0000209077 00000 n 0000206441 00000 n 0000212299 00000 n 0000212180 00000 n 0000209361 00000 n 0000215299 00000 n 0000215180 00000 n 0000212452 00000 n 0000362740 00000 n 0000218370 00000 n 0000218251 00000 n 0000215429 00000 n 0000221310 00000 n 0000221191 00000 n 0000218535 00000 n 0000223728 00000 n 0000223609 00000 n 0000221475 00000 n 0000226685 00000 n 0000226566 00000 n 0000223893 00000 n 0000229476 00000 n 0000229357 00000 n 0000226850 00000 n 0000232374 00000 n 0000232255 00000 n 0000229641 00000 n 0000362857 00000 n 0000235119 00000 n 0000235000 00000 n 0000232539 00000 n 0000237680 00000 n 0000237561 00000 n 0000235272 00000 n 0000240187 00000 n 0000240068 00000 n 0000237833 00000 n 0000242620 00000 n 0000242501 00000 n 0000240352 00000 n 0000244242 00000 n 0000244123 00000 n 0000242785 00000 n 0000246247 00000 n 0000246128 00000 n 0000244407 00000 n 0000362974 00000 n 0000248917 00000 n 0000248798 00000 n 0000246376 00000 n 0000251815 00000 n 0000251696 00000 n 0000249058 00000 n 0000254758 00000 n 0000254639 00000 n 0000251980 00000 n 0000257969 00000 n 0000257850 00000 n 0000254923 00000 n 0000260817 00000 n 0000260698 00000 n 0000258134 00000 n 0000260982 00000 n 0000274777 00000 n 0000275095 00000 n 0000278359 00000 n 0000278383 00000 n 0000283166 00000 n 0000288076 00000 n 0000288300 00000 n 0000302984 00000 n 0000320234 00000 n 0000335445 00000 n 0000347750 00000 n 0000360810 00000 n 0000363091 00000 n 0000363204 00000 n 0000363322 00000 n 0000363432 00000 n 0000363511 00000 n 0000363621 00000 n trailer << /Size 370 /Root 368 0 R /Info 369 0 R >> startxref 363717 %%EOF pupnp-release-1.8.0/docs/dist/html/000077500000000000000000000000001303304015100171255ustar00rootroot00000000000000pupnp-release-1.8.0/docs/dist/html/ixml/000077500000000000000000000000001303304015100200765ustar00rootroot00000000000000pupnp-release-1.8.0/docs/dist/html/ixml/DOMInterfaces.html000066400000000000000000000037601303304015100234150ustar00rootroot00000000000000 DOM Interfaces

DOM Interfaces

The Document Object Model consists of a set of objects and interfaces for accessing and manipulating documents. IXML does not implement all the interfaces documented in the DOM2-Core recommendation but defines a subset of the most useful interfaces. A description of the supported interfaces and methods is presented in this section.

For a complete discussion on the object model, the object hierarchy, etc., refer to section 1.1 of the DOM2-Core recommendation.

o Interface Node
o Interface Attr
o Interface CDATASection
o Interface Document
o Interface Element
o Interface NamedNodeMap
o Interface NodeList

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/General.html000066400000000000000000000005701303304015100223430ustar00rootroot00000000000000 General Bits

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/IXMLAPI.html000066400000000000000000000057271303304015100221020ustar00rootroot00000000000000 IXML API

IXML API

The IXML API contains utility functions that are not part of the standard DOM interfaces. They include functions to create a DOM structure from a file or buffer, create an XML file from a DOM structure, and manipulate DOMString objects.
o ixmlPrintDocument
Renders a Node and all sub-elements into an XML document representation.
o ixmlPrintNode
Renders a Node and all sub-elements into an XML text representation.
o ixmlDocumenttoString
Renders a Node and all sub-elements into an XML document representation.
o ixmlNodetoString
Renders a Node and all sub-elements into an XML text representation.
o ixmlRelaxParser
Makes the XML parser more tolerant to malformed text.
o ixmlParseBuffer
Parses an XML text buffer converting it into an IXML DOM representation.
o ixmlParseBufferEx
Parses an XML text buffer converting it into an IXML DOM representation.
o ixmlLoadDocument
Parses an XML text file converting it into an IXML DOM representation.
o ixmlLoadDocumentEx
Parses an XML text file converting it into an IXML DOM representation.
o ixmlCloneDOMString
Clones an existing DOMString.
o ixmlFreeDOMString
Frees a DOMString.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/InterfaceitAttr.html000066400000000000000000000017011303304015100240530ustar00rootroot00000000000000 Interface <I>Attr</I>

Interface Attr

The Attr interface represents an attribute of an Element. The document type definition (DTD) or schema usually dictate the allowable attributes and values for a particular element. For more information, refer to the Interface Attr section in the DOM2-Core.
o ixmlAttr_free
Frees an Attr node.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/InterfaceitCDATASection.html000066400000000000000000000024101303304015100253000ustar00rootroot00000000000000 Interface <I>CDATASection</I>

Interface CDATASection

The CDATASection is used to escape blocks of text containing characters that would otherwise be regarded as markup. CDATA sections cannot be nested. Their primary purpose is for including material such XML fragments, without needing to escape all the delimiters. For more information, refer to the Interface CDATASection section in the DOM2-Core.
o ixmlCDATASection_init
Initializes a CDATASection node.
o ixmlCDATASection_free
Frees a CDATASection node.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/InterfaceitDocument.html000066400000000000000000000132671303304015100247310ustar00rootroot00000000000000 Interface <I>Document</I>

Interface Document

The Document interface represents the entire XML document. In essence, it is the root of the document tree and provides the primary interface to the elements of the document. For more information, refer to the Interface Document section in the DOM2Core.
o ixmlDocument_init
Initializes a Document node.
o ixmlDocument_createDocumentEx
Creates a new empty Document node.
o ixmlDocument_createDocument
Creates a new empty Document node.
o ixmlDocument_createElementEx
Creates a new Element node with the given tag name.
o ixmlDocument_createElement
Creates a new Element node with the given tag name.
o ixmlDocument_createTextNodeEx
Creates a new Text node with the given data.
o ixmlDocument_createTextNode
Creates a new Text node with the given data.
o ixmlDocument_createCDATASectionEx
Creates a new CDATASection node with given data.
o ixmlDocument_createCDATASection
Creates a new CDATASection node with given data.
o ixmlDocument_createAttribute
Creates a new Attr node with the given name.
o ixmlDocument_createAttributeEx
Creates a new Attr node with the given name.
o ixmlDocument_getElementsByTagName
Returns a NodeList of all Elements that match the given tag name in the order in which they were encountered in a preorder traversal of the Document tree.
o ixmlDocument_createElementNSEx
Creates a new Element node in the given qualified name and namespace URI.
o ixmlDocument_createElementNS
Creates a new Element node in the given qualified name and namespace URI.
o ixmlDocument_createAttributeNSEx
Creates a new Attr node with the given qualified name and namespace URI.
o ixmlDocument_createAttributeNS
Creates a new Attr node with the given qualified name and namespace URI.
o ixmlDocument_getElementsByTagNameNS
Returns a NodeList of Elements that match the given local name and namespace URI in the order they are encountered in a preorder traversal of the Document tree.
o ixmlDocument_getElementById
Returns the Element whose ID matches that given id.
o ixmlDocument_free
Frees a Document object and all Nodes associated with it.
o ixmlDocument_importNode
Imports a Node from another Document into this Document.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/InterfaceitElement.html000066400000000000000000000122471303304015100245410ustar00rootroot00000000000000 Interface <I>Element</I>

Interface Element

The Element interface represents an element in an XML document. Only Elements are allowed to have attributes, which are stored in the attributes member of a Node. The Element interface extends the Node interface and adds more operations to manipulate attributes.
o ixmlElement_init
Initializes a IXML_Element node.
o ixmlElement_getTagName
Returns the name of the tag as a constant string.
o ixmlElement_getAttribute
Retrieves an attribute of an Element by name.
o ixmlElement_setAttribute
Adds a new attribute to an Element.
o ixmlElement_removeAttribute
Removes an attribute by name.
o ixmlElement_getAttributeNode
Retrieves an attribute node by name.
o ixmlElement_setAttributeNode
Adds a new attribute node to an Element.
o ixmlElement_removeAttributeNode
Removes the specified attribute node from an Element.
o ixmlElement_getElementsByTagName
Returns a NodeList of all descendant Elements with a given tag name, in the order in which they are encountered in a pre-order traversal of this Element tree.
o ixmlElement_getAttributeNS
Retrieves an attribute value using the local name and namespace URI.
o ixmlElement_setAttributeNS
Adds a new attribute to an Element using the local name and namespace URI.
o ixmlElement_removeAttributeNS
Removes an attribute using the namespace URI and local name.
o ixmlElement_getAttributeNodeNS
Retrieves an Attr node by local name and namespace URI.
o ixmlElement_setAttributeNodeNS
Adds a new attribute node.
o ixmlElement_getElementsByTagNameNS
Returns a NodeList of all descendant Elements with a given tag name, in the order in which they are encountered in the pre-order traversal of the Element tree.
o ixmlElement_hasAttribute
Queries whether the Element has an attribute with the given name or a default value.
o ixmlElement_hasAttributeNS
Queries whether the Element has an attribute with the given local name and namespace URI or has a default value for that attribute.
o ixmlElement_free
Frees the given Element and any subtree of the Element.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/InterfaceitNamedNodeMap.html000066400000000000000000000060261303304015100254360ustar00rootroot00000000000000 Interface <I>NamedNodeMap</I>

Interface NamedNodeMap

A NamedNodeMap object represents a list of objects that can be accessed by name. A NamedNodeMap maintains the objects in no particular order. The Node interface uses a NamedNodeMap to maintain the attributes of a node.
o ixmlNamedNodeMap_getLength
Returns the number of items contained in this NamedNodeMap.
o ixmlNamedNodeMap_getNamedItem
Retrieves a Node from the NamedNodeMap by name.
o ixmlNamedNodeMap_setNamedItem
Adds a new Node to the NamedNodeMap using the Node name attribute.
o ixmlNamedNodeMap_removeNamedItem
Removes a Node from a NamedNodeMap specified by name.
o ixmlNamedNodeMap_item
Retrieves a Node from a NamedNodeMap specified by a numerical index.
o ixmlNamedNodeMap_getNamedItemNS
Retrieves a Node from a NamedNodeMap specified by namespace URI and local name.
o ixmlNamedNodeMap_setNamedItemNS
Adds a new Node to the NamedNodeMap using the Node local name and namespace URI attributes.
o ixmlNamedNodeMap_removeNamedItemNS
Removes a Node from a NamedNodeMap specified by namespace URI and local name.
o ixmlNamedNodeMap_free
Frees a NamedNodeMap.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/InterfaceitNode.html000066400000000000000000000132711303304015100240330ustar00rootroot00000000000000 Interface <I>Node</I>

Interface Node

The Node interface forms the primary datatype for all other DOM objects. Every other interface is derived from this interface, inheriting its functionality. For more information, refer to DOM2-Core page 34.
o ixmlNode_getNodeName
Returns the name of the Node, depending on what type of Node it is, in a read-only string.
o ixmlNode_getNodeValue
Returns the value of the Node as a string.
o ixmlNode_setNodeValue
Assigns a new value to a Node.
o ixmlNode_getNodeType
Retrieves the type of a Node.
o ixmlNode_getParentNode
Retrieves the parent Node for a Node.
o ixmlNode_getChildNodes
Retrieves the list of children of a Node in a NodeList structure.
o ixmlNode_getFirstChild
Retrieves the first child Node of a Node.
o ixmlNode_getLastChild
Retrieves the last child Node of a Node.
o ixmlNode_getPreviousSibling
Retrieves the sibling Node immediately preceding this Node.
o ixmlNode_getNextSibling
Retrieves the sibling Node immediately following this Node.
o ixmlNode_getAttributes
Retrieves the attributes of a Node, if it is an Element node, in a NamedNodeMap structure.
o ixmlNode_getOwnerDocument
Retrieves the document object associated with this Node.
o ixmlNode_getNamespaceURI
Retrieves the namespace URI for a Node as a DOMString.
o ixmlNode_getPrefix
Retrieves the namespace prefix, if present.
o ixmlNode_getLocalName
Retrieves the local name of a Node, if present.
o ixmlNode_insertBefore
Inserts a new child Node before the existing child Node.
o ixmlNode_replaceChild
Replaces an existing child Node with a new child Node in the list of children of a Node.
o ixmlNode_removeChild
Removes a child from the list of children of a Node.
o ixmlNode_appendChild
Appends a child Node to the list of children of a Node.
o ixmlNode_hasChildNodes
Queries whether or not a Node has children.
o ixmlNode_cloneNode
Clones a Node.
o ixmlNode_hasAttributes
Queries whether this Node has attributes.
o ixmlNode_free
Frees a Node and all Nodes in its subtree.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/InterfaceitNodeList.html000066400000000000000000000025201303304015100246620ustar00rootroot00000000000000 Interface <I>NodeList</I>

Interface NodeList

The NodeList interface abstracts an ordered collection of nodes. Note that changes to the underlying nodes will change the nodes contained in a NodeList. The DOM2-Core refers to this as being live.
o ixmlNodeList_item
Retrieves a Node from a NodeList specified by a numerical index.
o ixmlNodeList_length
Returns the number of Nodes in a NodeList.
o ixmlNodeList_free
Frees a NodeList object.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/Introduction.html000066400000000000000000000034551303304015100234540ustar00rootroot00000000000000 Introduction

Introduction

The Linux DOM2 XML Parser Version 1.2 (IXML) is a lightweight, portable XML parser supporting the standard Document Object Model (DOM) Level 2 interfaces. The parser uses a C-style interface, making it idea for small, embedded applications. This document describes the interfaces supported by IXML 1.2, referencing the W3C DOM2 recommendations when necessary, and the additional utility application programming interfaces (APIs) that it supports.

Note that this document assumes that the reader has a copy of the DOM2-Core recommendation. Refer to the link below to obtain a copy. Only a brief description is included here and the reader is pointed to the DOM2-Core recommendation for more details. This document does, however, clarify IXML-specific behavior when the recommendation is unclear.

About DOM

The Document Object Model (DOM) is a set of interfaces that give a programmatic interface to documents. It provides a platform-neutral and language-neutral interface for random access and updating elements inside XML documents. DOM Level 1 provided the basic interfaces to access document elements. DOM Level 2 extended the interfaces to provide proper support for XML namespaces.

The latest DOM 2 recommendation is maintained by W3C and is available from http://www.w3.org/TR/DOM-Level-2-Core.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/License.html000066400000000000000000000037231303304015100223530ustar00rootroot00000000000000 License

License

Copyright (c) 2000-2003 Intel Corporation All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  • Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
  • Neither name of Intel Corporation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/icon1.gif000066400000000000000000000005061303304015100215770ustar00rootroot00000000000000GIF89a{FAkb{{04 $ ZcZJssJJJdbk21!,c@pH,Ā`0p@$Eh8 (08"IRGァ@2YpyCw !"D #$!%E&''!(G ""HDA;pupnp-release-1.8.0/docs/dist/html/ixml/icon2.gif000066400000000000000000000005061303304015100216000ustar00rootroot00000000000000GIF89autYYtUUsdded_^ONjRQnml~ih\[|?>TmlJJe;:O==MvuZYv44G##0WWwHGa('5KJeED]##0(55C--=(eeq**9RR_!,c@pH,Ā`0p@$Eh8 (08"IRGァ@2YpyCw !"D #$!%E&''!(G ""HDA;pupnp-release-1.8.0/docs/dist/html/ixml/index.html000066400000000000000000000023171303304015100220760ustar00rootroot00000000000000 IXML v1.2

IXML v1.2

Linux DOM2 XML Parser Version 1.2

Copyright (C) 2000-2003 Intel Corporation ALL RIGHTS RESERVED

Revision 1.2.1 (Tue 04 Jul 2006 04:58:36 PM EEST)

o Introduction
o License
o BOOL
o DOM Interfaces
o IXML API

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlAttr_free.html000066400000000000000000000014571303304015100236000ustar00rootroot00000000000000 EXPORT_SPEC void ixmlAttr_free

EXPORT_SPEC void ixmlAttr_free

(IXML_Attr* attrNode )

Frees an Attr node.

Documentation

Frees an Attr node.

Parameters:
attrNode - The Attr node to free.
Returns:
[void] This function does not return a value.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlCDATASection_free.html000066400000000000000000000015321303304015100250210ustar00rootroot00000000000000 EXPORT_SPEC void ixmlCDATASection_free

EXPORT_SPEC void ixmlCDATASection_free

(IXML_CDATASection* nodeptr )

Frees a CDATASection node.

Documentation

Frees a CDATASection node.

Parameters:
nodeptr - The CDATASection node to free.
Returns:
[void] This function does not return a value.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlCDATASection_init.html000066400000000000000000000015551303304015100250500ustar00rootroot00000000000000 EXPORT_SPEC void ixmlCDATASection_init

EXPORT_SPEC void ixmlCDATASection_init

(IXML_CDATASection* nodeptr )

Initializes a CDATASection node.

Documentation

Initializes a CDATASection node.

Parameters:
nodeptr - The CDATASection node to initialize.
Returns:
[void] This function does not return a value.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlCloneDOMString.html000066400000000000000000000016561303304015100244550ustar00rootroot00000000000000 EXPORT_SPEC DOMString ixmlCloneDOMString

EXPORT_SPEC DOMString ixmlCloneDOMString

(const DOMString src )

Clones an existing DOMString.

Documentation

Clones an existing DOMString.

Parameters:
src - The source DOMString to clone.
Returns:
[DOMString] A new DOMString that is a duplicate of the original or NULL if the operation could not be completed.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_createAttribute.html000066400000000000000000000017661303304015100266550ustar00rootroot00000000000000 EXPORT_SPEC IXML_Attr* ixmlDocument_createAttribute

EXPORT_SPEC IXML_Attr* ixmlDocument_createAttribute

(IXML_Document* doc,
  char* name )

Creates a new Attr node with the given name.

Documentation

Creates a new Attr node with the given name.

Parameters:
doc - The owner Document of the new node.
name - The name of the new attribute.
Returns:
[Attr*] A pointer to the new Attr or NULL on failure.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_createAttributeEx.html000066400000000000000000000030571303304015100271450ustar00rootroot00000000000000 EXPORT_SPEC int ixmlDocument_createAttributeEx

EXPORT_SPEC int ixmlDocument_createAttributeEx

(IXML_Document* doc,
  char* name,
  IXML_Attr** attrNode )

Creates a new Attr node with the given name.

Documentation

Creates a new Attr node with the given name.

The ixmlDocument_createAttributeEx API differs from the ixmlDocument_createAttribute API in that it returns an error code describing the reason for failure rather than just NULL.

Parameters:
doc - The owner Document of the new node.
name - The name of the new attribute.
attrNode - A pointer to a Attr where the new object will be stored.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either doc or name is NULL.
  • IXML_INSUFFICIENT_MEMORY: Not enough free memory exists to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_createAttributeNS.html000066400000000000000000000022711303304015100271060ustar00rootroot00000000000000 EXPORT_SPEC IXML_Attr* ixmlDocument_createAttributeNS

EXPORT_SPEC IXML_Attr* ixmlDocument_createAttributeNS

(IXML_Document* doc,
  DOMString namespaceURI,
  DOMString qualifiedName )

Creates a new Attr node with the given qualified name and namespace URI.

Documentation

Creates a new Attr node with the given qualified name and namespace URI.

Parameters:
doc - The owner Document of the new Attr.
namespaceURI - The namespace URI for the attribute.
qualifiedName - The qualified name of the attribute.
Returns:
[Attr*] A pointer to the new Attr or NULL on failure.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_createAttributeNSEx.html000066400000000000000000000034301303304015100274010ustar00rootroot00000000000000 EXPORT_SPEC int ixmlDocument_createAttributeNSEx

EXPORT_SPEC int ixmlDocument_createAttributeNSEx

(IXML_Document* doc,
  DOMString namespaceURI,
  DOMString qualifiedName,
  IXML_Attr** attrNode )

Creates a new Attr node with the given qualified name and namespace URI.

Documentation

Creates a new Attr node with the given qualified name and namespace URI.

The ixmlDocument_createAttributeNSEx API differs from the ixmlDocument_createAttributeNS API in that it returns an error code describing the reason for failure rather than just NULL.

Parameters:
doc - The owner Document of the new Attr.
namespaceURI - The namespace URI for the attribute.
qualifiedName - The qualified name of the attribute.
attrNode - A pointer to an Attr where the new object will be stored.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either doc, namespaceURI, or qualifiedName is NULL.
  • IXML_INSUFFICIENT_MEMORY: Not enough free memory exists to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_createCDATASection.html000066400000000000000000000021071303304015100270410ustar00rootroot00000000000000 EXPORT_SPEC IXML_CDATASection* ixmlDocument_createCDATASection

EXPORT_SPEC IXML_CDATASection* ixmlDocument_createCDATASection

(IXML_Document* doc,
  DOMString data )

Creates a new CDATASection node with given data.

Documentation

Creates a new CDATASection node with given data.

Parameters:
doc - The owner Document of the new node.
data - The data to associate with the new CDATASection node.
Returns:
[CDATASection*] A pointer to the new CDATASection or NULL on failure.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_createCDATASectionEx.html000066400000000000000000000031471303304015100273430ustar00rootroot00000000000000 EXPORT_SPEC int ixmlDocument_createCDATASectionEx

EXPORT_SPEC int ixmlDocument_createCDATASectionEx

(IXML_Document* doc,
  DOMString data,
  IXML_CDATASection** cdNode )

Creates a new CDATASection node with given data.

Documentation

Creates a new CDATASection node with given data.

The ixmlDocument_createCDATASectionEx API differs from the ixmlDocument_createCDATASection API in that it returns an error code describing the reason for failure rather than just NULL.

Parameters:
doc - The owner Document of the new node.
data - The data to associate with the new CDATASection node.
cdNode - A pointer to a Node where the new object will be stored.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either doc or {\bd data} is NULL.
  • IXML_INSUFFICIENT_MEMORY: Not enough free memory exists to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_createDocument.html000066400000000000000000000014701303304015100264600ustar00rootroot00000000000000 EXPORT_SPEC IXML_Document* ixmlDocument_createDocument

EXPORT_SPEC IXML_Document* ixmlDocument_createDocument

()

Creates a new empty Document node.

Documentation

Creates a new empty Document node.

Returns:
[Document*] A pointer to the new Document or NULL on failure.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_createDocumentEx.html000066400000000000000000000024171303304015100267570ustar00rootroot00000000000000 EXPORT_SPEC int ixmlDocument_createDocumentEx

EXPORT_SPEC int ixmlDocument_createDocumentEx

(IXML_Document** doc )

Creates a new empty Document node.

Documentation

Creates a new empty Document node. The ixmlDocument_createDocumentEx API differs from the ixmlDocument_createDocument API in that it returns an error code describing the reason for the failure rather than just NULL.

Parameters:
doc - Pointer to a Document where the new object will be stored.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INSUFFICIENT_MEMORY: Not enough free memory exists to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_createElement.html000066400000000000000000000024501303304015100262720ustar00rootroot00000000000000 EXPORT_SPEC IXML_Element* ixmlDocument_createElement

EXPORT_SPEC IXML_Element* ixmlDocument_createElement

(IXML_Document* doc,
  const DOMString tagName )

Creates a new Element node with the given tag name.

Documentation

Creates a new Element node with the given tag name. The new Element node has a nodeName of tagName and the localName, prefix, and namespaceURI set to NULL. To create an Element with a namespace, see ixmlDocument_createElementNS.

Parameters:
doc - The owner Document of the new node.
tagName - The tag name of the new Element node.
Returns:
[Document*] A pointer to the new Element or NULL on failure.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_createElementEx.html000066400000000000000000000035311303304015100265700ustar00rootroot00000000000000 EXPORT_SPEC int ixmlDocument_createElementEx

EXPORT_SPEC int ixmlDocument_createElementEx

(IXML_Document* doc,
  const DOMString tagName,
  IXML_Element** rtElement )

Creates a new Element node with the given tag name.

Documentation

Creates a new Element node with the given tag name. The new Element node has a nodeName of tagName and the localName, prefix, and namespaceURI set to NULL. To create an Element with a namespace, see ixmlDocument_createElementNS.

The ixmlDocument_createElementEx API differs from the ixmlDocument_createElement API in that it returns an error code describing the reason for failure rather than just NULL.

Parameters:
doc - The owner Document of the new node.
tagName - The tag name of the new Element node.
rtElement - Pointer to an Element where the new object will be stored.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either doc or tagName is NULL.
  • IXML_INSUFFICIENT_MEMORY: Not enough free memory exists to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_createElementNS.html000066400000000000000000000023201303304015100265270ustar00rootroot00000000000000 EXPORT_SPEC IXML_Element* ixmlDocument_createElementNS

EXPORT_SPEC IXML_Element* ixmlDocument_createElementNS

(IXML_Document* doc,
  DOMString namespaceURI,
  DOMString qualifiedName )

Creates a new Element node in the given qualified name and namespace URI.

Documentation

Creates a new Element node in the given qualified name and namespace URI.

Parameters:
doc - The owner Document of the new node.
namespaceURI - The namespace URI for the new Element.
qualifiedName - The qualified name of the new Element.
Returns:
[Element*] A pointer to the new Element or NULL on failure.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_createElementNSEx.html000066400000000000000000000034441303304015100270340ustar00rootroot00000000000000 EXPORT_SPEC int ixmlDocument_createElementNSEx

EXPORT_SPEC int ixmlDocument_createElementNSEx

(IXML_Document* doc,
  DOMString namespaceURI,
  DOMString qualifiedName,
  IXML_Element** rtElement )

Creates a new Element node in the given qualified name and namespace URI.

Documentation

Creates a new Element node in the given qualified name and namespace URI.

The ixmlDocument_createElementNSEx API differs from the ixmlDocument_createElementNS API in that it returns an error code describing the reason for failure rather than just NULL.

Parameters:
doc - The owner Document of the new node.
namespaceURI - The namespace URI for the new Element.
qualifiedName - The qualified name of the new Element.
rtElement - A pointer to an Element where the new object will be stored.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either doc, namespaceURI, or qualifiedName is NULL.
  • IXML_INSUFFICIENT_MEMORY: Not enough free memory exists to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_createTextNode.html000066400000000000000000000020231303304015100264270ustar00rootroot00000000000000 EXPORT_SPEC IXML_Node* ixmlDocument_createTextNode

EXPORT_SPEC IXML_Node* ixmlDocument_createTextNode

(IXML_Document* doc,
  const DOMString data )

Creates a new Text node with the given data.

Documentation

Creates a new Text node with the given data.

Parameters:
doc - The owner Document of the new node.
data - The data to associate with the new Text node.
Returns:
[Node*] A pointer to the new Node or NULL on failure.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_createTextNodeEx.html000066400000000000000000000031071303304015100267300ustar00rootroot00000000000000 EXPORT_SPEC int ixmlDocument_createTextNodeEx

EXPORT_SPEC int ixmlDocument_createTextNodeEx

(IXML_Document* doc,
  const DOMString data,
  IXML_Node** textNode )

Creates a new Text node with the given data.

Documentation

Creates a new Text node with the given data. The ixmlDocument_createTextNodeEx API differs from the ixmlDocument_createTextNode API in that it returns an error code describing the reason for failure rather than just NULL.

Parameters:
doc - The owner Document of the new node.
data - The data to associate with the new Text node.
textNode - A pointer to a Node where the new object will be stored.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either doc or data is NULL.
  • IXML_INSUFFICIENT_MEMORY: Not enough free memory exists to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_free.html000066400000000000000000000020541303304015100244360ustar00rootroot00000000000000 EXPORT_SPEC void ixmlDocument_free

EXPORT_SPEC void ixmlDocument_free

(IXML_Document* doc )

Frees a Document object and all Nodes associated with it.

Documentation

Frees a Document object and all Nodes associated with it. Any Nodes extracted via any other interface function, e.g. ixmlDocument_GetElementById, become invalid after this call unless explicitly cloned.

Parameters:
doc - The Document to free.
Returns:
[void] This function does not return a value.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_getElementById.html000066400000000000000000000020661303304015100263610ustar00rootroot00000000000000 EXPORT_SPEC IXML_Element* ixmlDocument_getElementById

EXPORT_SPEC IXML_Element* ixmlDocument_getElementById

(IXML_Document* doc,
  DOMString tagName )

Returns the Element whose ID matches that given id.

Documentation

Returns the Element whose ID matches that given id.

Parameters:
doc - The owner Document of the Element.
tagName - The name of the Element.
Returns:
[Element*] A pointer to the matching Element or NULL on an error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_getElementsByTagName.html000066400000000000000000000024271303304015100275250ustar00rootroot00000000000000 EXPORT_SPEC IXML_NodeList* ixmlDocument_getElementsByTagName

EXPORT_SPEC IXML_NodeList* ixmlDocument_getElementsByTagName

(IXML_Document* doc,
  DOMString tagName )

Returns a NodeList of all Elements that match the given tag name in the order in which they were encountered in a preorder traversal of the Document tree.

Documentation

Returns a NodeList of all Elements that match the given tag name in the order in which they were encountered in a preorder traversal of the Document tree.

Parameters:
doc - The Document to search.
tagName - The tag name to find.
Returns:
[NodeList*] A pointer to a NodeList containing the matching items or NULL on an error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_getElementsByTagNameNS.html000066400000000000000000000032161303304015100277630ustar00rootroot00000000000000 EXPORT_SPEC IXML_NodeList* ixmlDocument_getElementsByTagNameNS

EXPORT_SPEC IXML_NodeList* ixmlDocument_getElementsByTagNameNS

(IXML_Document* doc,
  DOMString namespaceURI,
  DOMString localName )

Returns a NodeList of Elements that match the given local name and namespace URI in the order they are encountered in a preorder traversal of the Document tree.

Documentation

Returns a NodeList of Elements that match the given local name and namespace URI in the order they are encountered in a preorder traversal of the Document tree. Either namespaceURI or localName can be the special "*" character, which matches any namespace or any local name respectively.

Parameters:
doc - The Document to search.
namespaceURI - The namespace of the elements to find or "*" to match any namespace.
localName - The local name of the elements to find or "*" to match any local name.
Returns:
[NodeList*] A pointer to a NodeList containing the matching items or NULL on an error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_importNode.html000066400000000000000000000040111303304015100256300ustar00rootroot00000000000000 EXPORT_SPEC int ixmlDocument_importNode

EXPORT_SPEC int ixmlDocument_importNode

(IXML_Document* doc,
  IXML_Node* importNode,
  BOOL deep,
  IXML_Node** rtNode )

Imports a Node from another Document into this Document.

Documentation

Imports a Node from another Document into this Document. The new Node does not a have parent node: it is a clone of the original Node with the ownerDocument set to doc. The deep parameter controls whether all the children of the Node are imported. Refer to the DOM2-Core recommendation for details on importing specific node types.

Parameters:
doc - The Document into which to import.
importNode - The Node to import.
deep - TRUE to import all children of importNode or FALSE to import only the root node.
rtNode - A pointer to a new Node owned by doc.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either doc or importNode is not a valid pointer.
  • IXML_NOT_SUPPORTED_ERR: importNode is a Document, which cannot be imported.
  • IXML_FAILED: The import operation failed because the Node to be imported could not be cloned.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocument_init.html000066400000000000000000000015251303304015100244620ustar00rootroot00000000000000 EXPORT_SPEC void ixmlDocument_init

EXPORT_SPEC void ixmlDocument_init

(IXML_Document* nodeptr )

Initializes a Document node.

Documentation

Initializes a Document node.

Parameters:
nodeptr - The Document node to initialize.
Returns:
[void] This function does not return a value.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlDocumenttoString.html000066400000000000000000000026001303304015100251640ustar00rootroot00000000000000 DOMString ixmlDocumenttoString

DOMString ixmlDocumenttoString

(IXML_Document* doc)

Renders a Node and all sub-elements into an XML document representation.

Documentation

Renders a Node and all sub-elements into an XML document representation. The caller is required to free the DOMString returned from this function using ixmlFreeDOMString when it is no longer required.

Note that this function can be used for any Node-derived interface. The difference between ixmlDocumenttoString and ixmlNodetoString is ixmlDocumenttoString includes the XML prolog while ixmlNodetoString only produces XML elements. An XML document is not well formed unless it includes the prolog and at least one element.

Returns:
[DOMString] A DOMString with the XML text representation of the DOM tree or NULL on an error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_free.html000066400000000000000000000016111303304015100242470ustar00rootroot00000000000000 EXPORT_SPEC void ixmlElement_free

EXPORT_SPEC void ixmlElement_free

(IXML_Element* element )

Frees the given Element and any subtree of the Element.

Documentation

Frees the given Element and any subtree of the Element.

Parameters:
element - The Element to free.
Returns:
[void] This function does not return a value.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_getAttribute.html000066400000000000000000000020231303304015100257670ustar00rootroot00000000000000 EXPORT_SPEC DOMString ixmlElement_getAttribute

EXPORT_SPEC DOMString ixmlElement_getAttribute

(IXML_Element* element,
  DOMString name )

Retrieves an attribute of an Element by name.

Documentation

Retrieves an attribute of an Element by name.

Parameters:
element - The Element from which to retrieve the attribute.
name - The name of the attribute to retrieve.
Returns:
[DOMString] A DOMString representing the value of the attribute.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_getAttributeNS.html000066400000000000000000000022471303304015100262400ustar00rootroot00000000000000 EXPORT_SPEC DOMString ixmlElement_getAttributeNS

EXPORT_SPEC DOMString ixmlElement_getAttributeNS

(IXML_Element* element,
  DOMString namespaceURI,
  DOMString localname )

Retrieves an attribute value using the local name and namespace URI.

Documentation

Retrieves an attribute value using the local name and namespace URI.

Parameters:
element - The Element from which to get the attribute value.
namespaceURI - The namespace URI of the attribute.
localname - The local name of the attribute.
Returns:
[DOMString] A DOMString representing the value of the matching attribute.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_getAttributeNode.html000066400000000000000000000021761303304015100266060ustar00rootroot00000000000000 EXPORT_SPEC IXML_Attr* ixmlElement_getAttributeNode

EXPORT_SPEC IXML_Attr* ixmlElement_getAttributeNode

(IXML_Element* element,
  DOMString name )

Retrieves an attribute node by name.

Documentation

Retrieves an attribute node by name. See ixmlElement_getAttributeNodeNS to retrieve an attribute node using a qualified name or namespace URI.

Parameters:
element - The Element from which to get the attribute node.
name - The name of the attribute node to find.
Returns:
[Attr*] A pointer to the attribute matching name or NULL on an error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_getAttributeNodeNS.html000066400000000000000000000022171303304015100270430ustar00rootroot00000000000000 EXPORT_SPEC IXML_Attr* ixmlElement_getAttributeNodeNS

EXPORT_SPEC IXML_Attr* ixmlElement_getAttributeNodeNS

(IXML_Element* element,
  DOMString namespaceURI,
  DOMString localName )

Retrieves an Attr node by local name and namespace URI.

Documentation

Retrieves an Attr node by local name and namespace URI.

Parameters:
element - The Element from which to get the attribute.
namespaceURI - The namespace URI of the attribute.
localName - The local name of the attribute.
Returns:
[Attr*] A pointer to an Attr or NULL on an error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_getElementsByTagName.html000066400000000000000000000025161303304015100273370ustar00rootroot00000000000000 EXPORT_SPEC IXML_NodeList* ixmlElement_getElementsByTagName

EXPORT_SPEC IXML_NodeList* ixmlElement_getElementsByTagName

(IXML_Element* element,
  DOMString tagName )

Returns a NodeList of all descendant Elements with a given tag name, in the order in which they are encountered in a pre-order traversal of this Element tree.

Documentation

Returns a NodeList of all descendant Elements with a given tag name, in the order in which they are encountered in a pre-order traversal of this Element tree.

Parameters:
element - The Element from which to start the search.
tagName - The name of the tag for which to search.
Returns:
[NodeList*] A NodeList of the matching Elements or NULL on an error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_getElementsByTagNameNS.html000066400000000000000000000027151303304015100276010ustar00rootroot00000000000000 EXPORT_SPEC IXML_NodeList* ixmlElement_getElementsByTagNameNS

EXPORT_SPEC IXML_NodeList* ixmlElement_getElementsByTagNameNS

(IXML_Element* element,
  DOMString namespaceURI,
  DOMString localName )

Returns a NodeList of all descendant Elements with a given tag name, in the order in which they are encountered in the pre-order traversal of the Element tree.

Documentation

Returns a NodeList of all descendant Elements with a given tag name, in the order in which they are encountered in the pre-order traversal of the Element tree.

Parameters:
element - The Element from which to start the search.
namespaceURI - The namespace URI of the Elements to find.
localName - The local name of the Elements to find.
Returns:
[NodeList*] A NodeList of matching Elements or NULL on an error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_getTagName.html000066400000000000000000000017011303304015100253420ustar00rootroot00000000000000 EXPORT_SPEC const DOMString ixmlElement_getTagName

EXPORT_SPEC const DOMString ixmlElement_getTagName

(IXML_Element* element )

Returns the name of the tag as a constant string.

Documentation

Returns the name of the tag as a constant string.

Parameters:
element - The Element from which to retrieve the name.
Returns:
[const DOMString] A DOMString representing the name of the Element.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_hasAttribute.html000066400000000000000000000023101303304015100257620ustar00rootroot00000000000000 EXPORT_SPEC BOOL ixmlElement_hasAttribute

EXPORT_SPEC BOOL ixmlElement_hasAttribute

(IXML_Element* element,
  DOMString name )

Queries whether the Element has an attribute with the given name or a default value.

Documentation

Queries whether the Element has an attribute with the given name or a default value.

Parameters:
element - The Element on which to check for an attribute.
name - The name of the attribute for which to check.
Returns:
[BOOL] TRUE if the Element has an attribute with this name or has a default value for that attribute, otherwise FALSE.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_hasAttributeNS.html000066400000000000000000000026451303304015100262360ustar00rootroot00000000000000 EXPORT_SPEC BOOL ixmlElement_hasAttributeNS

EXPORT_SPEC BOOL ixmlElement_hasAttributeNS

(IXML_Element* element,
  DOMString namespaceURI,
  DOMString localName )

Queries whether the Element has an attribute with the given local name and namespace URI or has a default value for that attribute.

Documentation

Queries whether the Element has an attribute with the given local name and namespace URI or has a default value for that attribute.

Parameters:
element - The Element on which to check for the attribute.
namespaceURI - The namespace URI of the attribute.
localName - The local name of the attribute.
Returns:
[BOOL] TRUE if the Element has an attribute with the given namespace and local name or has a default value for that attribute, otherwise FALSE.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_init.html000066400000000000000000000015221303304015100242720ustar00rootroot00000000000000 EXPORT_SPEC void ixmlElement_init

EXPORT_SPEC void ixmlElement_init

(IXML_Element* element )

Initializes a IXML_Element node.

Documentation

Initializes a IXML_Element node.

Parameters:
element - The Element to initialize.
Returns:
[void] This function does not return a value.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_removeAttribute.html000066400000000000000000000021621303304015100265110ustar00rootroot00000000000000 EXPORT_SPEC int ixmlElement_removeAttribute

EXPORT_SPEC int ixmlElement_removeAttribute

(IXML_Element* element,
  DOMString name )

Removes an attribute by name.

Documentation

Removes an attribute by name.

Parameters:
element - The Element from which to remove the attribute.
name - The name of the attribute to remove.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either element or name is NULL.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_removeAttributeNS.html000066400000000000000000000024711303304015100267550ustar00rootroot00000000000000 EXPORT_SPEC int ixmlElement_removeAttributeNS

EXPORT_SPEC int ixmlElement_removeAttributeNS

(IXML_Element* element,
  DOMString namespaceURI,
  DOMString localName )

Removes an attribute using the namespace URI and local name.

Documentation

Removes an attribute using the namespace URI and local name.

Parameters:
element - The Element from which to remove the the attribute.
namespaceURI - The namespace URI of the attribute.
localName - The local name of the attribute.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either element, namespaceURI, or localName is NULL.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_removeAttributeNode.html000066400000000000000000000026561303304015100273270ustar00rootroot00000000000000 EXPORT_SPEC int ixmlElement_removeAttributeNode

EXPORT_SPEC int ixmlElement_removeAttributeNode

(IXML_Element* element,
  IXML_Attr* oldAttr,
  IXML_Attr** rtAttr )

Removes the specified attribute node from an Element.

Documentation

Removes the specified attribute node from an Element.

Parameters:
element - The Element from which to remove the attribute.
oldAttr - The attribute to remove from the Element.
rtAttr - A pointer to an attribute in which to place the removed attribute.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either element or oldAttr is NULL.
  • IXML_NOT_FOUND_ERR: oldAttr is not among the list attributes of element.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_setAttribute.html000066400000000000000000000031141303304015100260050ustar00rootroot00000000000000 EXPORT_SPEC int ixmlElement_setAttribute

EXPORT_SPEC int ixmlElement_setAttribute

(IXML_Element* element,
  DOMString name,
  DOMString value )

Adds a new attribute to an Element.

Documentation

Adds a new attribute to an Element. If an attribute with the same name already exists, the attribute value will be updated with the new value in value.

Parameters:
element - The Element on which to set the attribute.
name - The name of the attribute.
value - The value of the attribute. Note that this is a non-parsed string and any markup must be escaped.
Returns:
[int] An integer representing of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either element, name, or value is NULL.
  • IXML_INVALID_CHARACTER_ERR: name contains an illegal character.
  • IXML_INSUFFICIENT_MEMORY: Not enough free memory exists to complete the operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_setAttributeNS.html000066400000000000000000000040341303304015100262500ustar00rootroot00000000000000 EXPORT_SPEC int ixmlElement_setAttributeNS

EXPORT_SPEC int ixmlElement_setAttributeNS

(IXML_Element* element,
  DOMString namespaceURI,
  DOMString qualifiedName,
  DOMString value )

Adds a new attribute to an Element using the local name and namespace URI.

Documentation

Adds a new attribute to an Element using the local name and namespace URI. If another attribute matches the same local name and namespace, the prefix is changed to be the prefix part of the qualifiedName and the value is changed to value.

Parameters:
element - The Element on which to set the attribute.
namespaceURI - The namespace URI of the new attribute.
qualifiedName - The qualified name of the attribute.
value - The new value for the attribute.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either element, namespaceURI, qualifiedName, or value is NULL.
  • IXML_INVALID_CHARACTER_ERR: qualifiedName contains an invalid character.
  • IXML_NAMESPACE_ERR: Either the qualifiedName or namespaceURI is malformed. Refer to the DOM2-Core for possible reasons.
  • IXML_INSUFFICIENT_MEMORY: Not enough free memory exist to complete the operation.
  • IXML_FAILED: The operation could not be completed.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_setAttributeNode.html000066400000000000000000000032731303304015100266210ustar00rootroot00000000000000 EXPORT_SPEC int ixmlElement_setAttributeNode

EXPORT_SPEC int ixmlElement_setAttributeNode

(IXML_Element* element,
  IXML_Attr* newAttr,
  IXML_Attr** rtAttr )

Adds a new attribute node to an Element.

Documentation

Adds a new attribute node to an Element. If an attribute already exists with newAttr as a name, it will be replaced with the new one and the old one will be returned in rtAttr.

Parameters:
element - The Element in which to add the new attribute.
newAttr - The new Attr to add.
rtAttr - A pointer to an Attr where the old Attr will be stored. This will have a NULL if no prior node existed.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either element or newAttr is NULL.
  • IXML_WRONG_DOCUMENT_ERR: newAttr does not belong to the same one as element.
  • IXML_INUSE_ATTRIBUTE_ERR: newAttr is already an attribute of another Element.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlElement_setAttributeNodeNS.html000066400000000000000000000031751303304015100270630ustar00rootroot00000000000000 EXPORT_SPEC int ixmlElement_setAttributeNodeNS

EXPORT_SPEC int ixmlElement_setAttributeNodeNS

(IXML_Element* element,
  IXML_Attr* newAttr,
  IXML_Attr** rcAttr )

Adds a new attribute node.

Documentation

Adds a new attribute node. If an attribute with the same local name and namespace URI already exists in the Element, the existing attribute node is replaced with newAttr and the old returned in rcAttr.

Parameters:
element - The Element in which to add the attribute node.
newAttr - The new Attr to add.
rcAttr - A pointer to the replaced Attr, if it exists.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either element or newAttr is NULL.
  • IXML_WRONG_DOCUMENT_ERR: newAttr does not belong to the same document as element.
  • IXML_INUSE_ATTRIBUTE_ERR: newAttr already is an attribute of another Element.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlFreeDOMString.html000066400000000000000000000014511303304015100242670ustar00rootroot00000000000000 EXPORT_SPEC void ixmlFreeDOMString

EXPORT_SPEC void ixmlFreeDOMString

(DOMString buf )

Frees a DOMString.

Documentation

Frees a DOMString.

Parameters:
buf - The DOMString to free.
Returns:
[void] This function does not return a value.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlLoadDocument.html000066400000000000000000000017461303304015100242440ustar00rootroot00000000000000 EXPORT_SPEC IXML_Document* ixmlLoadDocument

EXPORT_SPEC IXML_Document* ixmlLoadDocument

(char* xmlFile )

Parses an XML text file converting it into an IXML DOM representation.

Documentation

Parses an XML text file converting it into an IXML DOM representation.

Parameters:
xmlFile - The filename of the XML text to convert to a Document.
Returns:
[Document*] A Document if the file correctly parses or NULL on an error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlLoadDocumentEx.html000066400000000000000000000027611303304015100245370ustar00rootroot00000000000000 EXPORT_SPEC int ixmlLoadDocumentEx

EXPORT_SPEC int ixmlLoadDocumentEx

(char* xmlFile,
  IXML_Document** doc )

Parses an XML text file converting it into an IXML DOM representation.

Documentation

Parses an XML text file converting it into an IXML DOM representation.

The ixmlLoadDocumentEx API differs from the ixmlLoadDocument API in that it returns a an error code representing the actual failure rather than just NULL.

Parameters:
xmlFile - The filename of the XML text to convert to a Document.
doc - A pointer to the Document if file correctly parses or NULL on an error.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: The xmlFile is not a valid pointer.
  • IXML_INSUFFICIENT_MEMORY: Not enough free memory exists to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNamedNodeMap_free.html000066400000000000000000000016341303304015100251530ustar00rootroot00000000000000 EXPORT_SPEC void ixmlNamedNodeMap_free

EXPORT_SPEC void ixmlNamedNodeMap_free

(IXML_NamedNodeMap* nnMap )

Frees a NamedNodeMap.

Documentation

Frees a NamedNodeMap. The Nodes inside the map are not freed, just the NamedNodeMap object.

Parameters:
nnMap - The NamedNodeMap to free.
Returns:
[void] This function does not return a value.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNamedNodeMap_getLength.html000066400000000000000000000017131303304015100261510ustar00rootroot00000000000000 EXPORT_SPEC unsigned long ixmlNamedNodeMap_getLength

EXPORT_SPEC unsigned long ixmlNamedNodeMap_getLength

(IXML_NamedNodeMap* nnMap )

Returns the number of items contained in this NamedNodeMap.

Documentation

Returns the number of items contained in this NamedNodeMap.

Parameters:
nnMap - The NamedNodeMap from which to retrieve the size.
Returns:
[unsigned long] The number of nodes in this map.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNamedNodeMap_getNamedItem.html000066400000000000000000000020131303304015100265650ustar00rootroot00000000000000 EXPORT_SPEC IXML_Node* ixmlNamedNodeMap_getNamedItem

EXPORT_SPEC IXML_Node* ixmlNamedNodeMap_getNamedItem

(IXML_NamedNodeMap* nnMap,
  DOMString name )

Retrieves a Node from the NamedNodeMap by name.

Documentation

Retrieves a Node from the NamedNodeMap by name.

Parameters:
nnMap - The NamedNodeMap to search.
name - The name of the Node to find.
Returns:
[Node*] A Node or NULL if there is an error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNamedNodeMap_getNamedItemNS.html000066400000000000000000000024021303304015100270300ustar00rootroot00000000000000 EXPORT_SPEC IXML_Node* ixmlNamedNodeMap_getNamedItemNS

EXPORT_SPEC IXML_Node* ixmlNamedNodeMap_getNamedItemNS

(IXML_NamedNodeMap* nnMap,
  DOMString* namespaceURI,
  DOMString localName )

Retrieves a Node from a NamedNodeMap specified by namespace URI and local name.

Documentation

Retrieves a Node from a NamedNodeMap specified by namespace URI and local name.

Parameters:
nnMap - The NamedNodeMap from which to remove the Node.
namespaceURI - The namespace URI of the Node to remove.
localName - The local name of the Node to remove.
Returns:
[Node*] A pointer to the Node, if found, or NULL if it wasn't

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNamedNodeMap_item.html000066400000000000000000000021271303304015100251660ustar00rootroot00000000000000 EXPORT_SPEC IXML_Node* ixmlNamedNodeMap_item

EXPORT_SPEC IXML_Node* ixmlNamedNodeMap_item

(IXML_NamedNodeMap* nnMap,
  unsigned long index )

Retrieves a Node from a NamedNodeMap specified by a numerical index.

Documentation

Retrieves a Node from a NamedNodeMap specified by a numerical index.

Parameters:
nnMap - The NamedNodeMap from which to remove the Node.
index - The index into the map to remove.
Returns:
[Node*] A pointer to the Node, if found, or NULL if it wasn't.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNamedNodeMap_removeNamedItem.html000066400000000000000000000021001303304015100273000ustar00rootroot00000000000000 EXPORT_SPEC IXML_Node* ixmlNamedNodeMap_removeNamedItem

EXPORT_SPEC IXML_Node* ixmlNamedNodeMap_removeNamedItem

(IXML_NamedNodeMap* nnMap,
  DOMString name )

Removes a Node from a NamedNodeMap specified by name.

Documentation

Removes a Node from a NamedNodeMap specified by name.

Parameters:
nnMap - The NamedNodeMap from which to remove the item.
name - The name of the item to remove.
Returns:
[Node*] A pointer to the Node, if found, or NULL if it wasn't.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNamedNodeMap_removeNamedItemNS.html000066400000000000000000000024061303304015100275520ustar00rootroot00000000000000 EXPORT_SPEC IXML_Node* ixmlNamedNodeMap_removeNamedItemNS

EXPORT_SPEC IXML_Node* ixmlNamedNodeMap_removeNamedItemNS

(IXML_NamedNodeMap* nnMap,
  DOMString namespaceURI,
  DOMString localName )

Removes a Node from a NamedNodeMap specified by namespace URI and local name.

Documentation

Removes a Node from a NamedNodeMap specified by namespace URI and local name.

Parameters:
nnMap - The NamedNodeMap from which to remove the Node.
namespaceURI - The namespace URI of the Node to remove.
localName - The local name of the Node to remove.
Returns:
[Node*] A pointer to the Node, if found, or NULL if it wasn't.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNamedNodeMap_setNamedItem.html000066400000000000000000000023011303304015100266010ustar00rootroot00000000000000 EXPORT_SPEC IXML_Node* ixmlNamedNodeMap_setNamedItem

EXPORT_SPEC IXML_Node* ixmlNamedNodeMap_setNamedItem

(IXML_NamedNodeMap* nnMap,
  IXML_Node* arg )

Adds a new Node to the NamedNodeMap using the Node name attribute.

Documentation

Adds a new Node to the NamedNodeMap using the Node name attribute.

Parameters:
nnMap - The NamedNodeMap in which to add the new Node.
arg - The new Node to add to the NamedNodeMap.
Returns:
[Node*] The old Node if the new Node replaces it or NULL if the Node was not in the NamedNodeMap before.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNamedNodeMap_setNamedItemNS.html000066400000000000000000000023361303304015100270520ustar00rootroot00000000000000 EXPORT_SPEC IXML_Node* ixmlNamedNodeMap_setNamedItemNS

EXPORT_SPEC IXML_Node* ixmlNamedNodeMap_setNamedItemNS

(IXML_NamedNodeMap* nnMap,
  IXML_Node* arg )

Adds a new Node to the NamedNodeMap using the Node local name and namespace URI attributes.

Documentation

Adds a new Node to the NamedNodeMap using the Node local name and namespace URI attributes.

Parameters:
nnMap - The NamedNodeMap in which to add the Node.
arg - The Node to add to the map.
Returns:
[Node*] The old Node if the new Node replaces it or NULL if the Node was not in the NamedNodeMap before.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNodeList_free.html000066400000000000000000000017071303304015100244050ustar00rootroot00000000000000 EXPORT_SPEC void ixmlNodeList_free

EXPORT_SPEC void ixmlNodeList_free

(IXML_NodeList* nList )

Frees a NodeList object.

Documentation

Frees a NodeList object. Since the underlying Nodes are references, they are not freed using this operating. This only frees the NodeList object.

Parameters:
nList - The NodeList to free.
Returns:
[void] This function does not return a value.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNodeList_item.html000066400000000000000000000021151303304015100244140ustar00rootroot00000000000000 EXPORT_SPEC IXML_Node* ixmlNodeList_item

EXPORT_SPEC IXML_Node* ixmlNodeList_item

(IXML_NodeList* nList,
  unsigned long index )

Retrieves a Node from a NodeList specified by a numerical index.

Documentation

Retrieves a Node from a NodeList specified by a numerical index.

Parameters:
nList - The NodeList from which to retrieve the Node.
index - The index into the NodeList to retrieve.
Returns:
[Node*] A pointer to a Node or NULL if there was an error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNodeList_length.html000066400000000000000000000017041303304015100247420ustar00rootroot00000000000000 EXPORT_SPEC unsigned long ixmlNodeList_length

EXPORT_SPEC unsigned long ixmlNodeList_length

(IXML_NodeList* nList )

Returns the number of Nodes in a NodeList.

Documentation

Returns the number of Nodes in a NodeList.

Parameters:
nList - The NodeList for which to retrieve the number of Nodes.
Returns:
[unsigned long] The number of Nodes in the NodeList.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_appendChild.html000066400000000000000000000031431303304015100250370ustar00rootroot00000000000000 EXPORT_SPEC int ixmlNode_appendChild

EXPORT_SPEC int ixmlNode_appendChild

(IXML_Node* nodeptr,
  IXML_Node* newChild )

Appends a child Node to the list of children of a Node.

Documentation

Appends a child Node to the list of children of a Node. If newChild is already in the tree, it is removed first.

Parameters:
nodeptr - The Node in which to append the new child.
newChild - The new child to append.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either nodeptr or newChild is NULL.
  • IXML_HIERARCHY_REQUEST_ERR: newChild is of a type that cannot be added as a child of nodeptr or newChild is an ancestor of nodeptr.
  • IXML_WRONG_DOCUMENT_ERR: newChild was created from a different document than nodeptr.
  • IXML_NO_MODIFICATION_ALLOWED_ERR: nodeptr is a read-only Node.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_cloneNode.html000066400000000000000000000023141303304015100245310ustar00rootroot00000000000000 EXPORT_SPEC IXML_Node* ixmlNode_cloneNode

EXPORT_SPEC IXML_Node* ixmlNode_cloneNode

(IXML_Node* nodeptr,
  BOOL deep )

Clones a Node.

Documentation

Clones a Node. The new Node does not have a parent. The deep parameter controls whether the subtree of the Node is also cloned. For details on cloning specific types of Nodes, refer to the DOM2-Core recommendation.

Parameters:
nodeptr - The Node to clone.
deep - TRUE to clone the subtree also or FALSE to clone only nodeptr.
Returns:
[Node*] A clone of nodeptr or NULL.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_free.html000066400000000000000000000015471303304015100235530ustar00rootroot00000000000000 EXPORT_SPEC void ixmlNode_free

EXPORT_SPEC void ixmlNode_free

(IXML_Node* IXML_Node )

Frees a Node and all Nodes in its subtree.

Documentation

Frees a Node and all Nodes in its subtree.

Parameters:
IXML_Node - The Node to free.
Returns:
[void] This function does not return a value.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_getAttributes.html000066400000000000000000000020731303304015100254530ustar00rootroot00000000000000 EXPORT_SPEC IXML_NamedNodeMap* ixmlNode_getAttributes

EXPORT_SPEC IXML_NamedNodeMap* ixmlNode_getAttributes

(IXML_Node* nodeptr )

Retrieves the attributes of a Node, if it is an Element node, in a NamedNodeMap structure.

Documentation

Retrieves the attributes of a Node, if it is an Element node, in a NamedNodeMap structure.

Parameters:
nodeptr - The Node from which to retrieve the attributes.
Returns:
[NamedNodeMap*] A NamedNodeMap of the attributes or NULL.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_getChildNodes.html000066400000000000000000000021571303304015100253440ustar00rootroot00000000000000 EXPORT_SPEC IXML_NodeList* ixmlNode_getChildNodes

EXPORT_SPEC IXML_NodeList* ixmlNode_getChildNodes

(IXML_Node* nodeptr )

Retrieves the list of children of a Node in a NodeList structure.

Documentation

Retrieves the list of children of a Node in a NodeList structure. If a Node has no children, ixmlNode_getChildNodes returns a NodeList structure that contains no Nodes.

Parameters:
nodeptr - The Node from which to retrieve the children.
Returns:
[NodeList*] A NodeList of the children of the Node.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_getFirstChild.html000066400000000000000000000017441303304015100253640ustar00rootroot00000000000000 EXPORT_SPEC IXML_Node* ixmlNode_getFirstChild

EXPORT_SPEC IXML_Node* ixmlNode_getFirstChild

(IXML_Node* nodeptr )

Retrieves the first child Node of a Node.

Documentation

Retrieves the first child Node of a Node.

Parameters:
nodeptr - The Node from which to retrieve the first child.
Returns:
[Node*] A pointer to the first child Node or NULL if the Node does not have any children.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_getLastChild.html000066400000000000000000000017351303304015100252000ustar00rootroot00000000000000 EXPORT_SPEC IXML_Node* ixmlNode_getLastChild

EXPORT_SPEC IXML_Node* ixmlNode_getLastChild

(IXML_Node* nodeptr )

Retrieves the last child Node of a Node.

Documentation

Retrieves the last child Node of a Node.

Parameters:
nodeptr - The Node from which to retrieve the last child.
Returns:
[Node*] A pointer to the last child Node or NULL if the Node does not have any children.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_getLocalName.html000066400000000000000000000024231303304015100251570ustar00rootroot00000000000000 EXPORT_SPEC const DOMString ixmlNode_getLocalName

EXPORT_SPEC const DOMString ixmlNode_getLocalName

(IXML_Node* nodeptr )

Retrieves the local name of a Node, if present.

Documentation

Retrieves the local name of a Node, if present. The local name is the tag name without the namespace prefix. Only Nodes of type eELEMENT_NODE or eATTRIBUTE_NODE can have a local name. {\Bf Node}s created through the Document interface will only contain a local name if created using ixmlDocument_createElementNS.

Parameters:
nodeptr - The Node from which to retrieve the local name.
Returns:
[const DOMString] A DOMString representing the local name of the Element or NULL.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_getNamespaceURI.html000066400000000000000000000023571303304015100256060ustar00rootroot00000000000000 EXPORT_SPEC const DOMString ixmlNode_getNamespaceURI

EXPORT_SPEC const DOMString ixmlNode_getNamespaceURI

(IXML_Node* nodeptr )

Retrieves the namespace URI for a Node as a DOMString.

Documentation

Retrieves the namespace URI for a Node as a DOMString. Only Nodes of type eELEMENT_NODE or eATTRIBUTE_NODE can have a namespace URI. Nodes created through the Document interface will only contain a namespace if created using ixmlDocument_createElementNS.

Parameters:
nodeptr - The Node for which to retrieve the namespace.
Returns:
[const DOMString] A DOMString representing the URI of the namespace or NULL.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_getNextSibling.html000066400000000000000000000017731303304015100255610ustar00rootroot00000000000000 EXPORT_SPEC IXML_Node* ixmlNode_getNextSibling

EXPORT_SPEC IXML_Node* ixmlNode_getNextSibling

(IXML_Node* nodeptr )

Retrieves the sibling Node immediately following this Node.

Documentation

Retrieves the sibling Node immediately following this Node.

Parameters:
nodeptr - The Node from which to retrieve the next sibling.
Returns:
[Node*] A pointer to the next sibling Node or NULL if no such Node exists.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_getNodeName.html000066400000000000000000000021551303304015100250140ustar00rootroot00000000000000 EXPORT_SPEC const DOMString ixmlNode_getNodeName

EXPORT_SPEC const DOMString ixmlNode_getNodeName

(IXML_Node* nodeptr )

Returns the name of the Node, depending on what type of Node it is, in a read-only string.

Documentation

Returns the name of the Node, depending on what type of Node it is, in a read-only string. Refer to the table in the DOM2-Core for a description of the node names for various interfaces.

Parameters:
nodeptr - Pointer to the node to retrieve the name.
Returns:
[const DOMString] A constant DOMString of the node name.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_getNodeType.html000066400000000000000000000025141303304015100250540ustar00rootroot00000000000000 EXPORT_SPEC unsigned short ixmlNode_getNodeType

EXPORT_SPEC unsigned short ixmlNode_getNodeType

(IXML_Node* nodeptr )

Retrieves the type of a Node.

Documentation

Retrieves the type of a Node. The defined Node constants are:
  • eATTRIBUTE_NODE
  • eCDATA_SECTION_NODE
  • eCOMMENT_NODE
  • eDOCUMENT_FRAGMENT_NODE
  • eDOCUMENT_NODE
  • eDOCUMENT_TYPE_NODE
  • eELEMENT_NODE
  • eENTITY_NODE
  • eENTITY_REFERENCE_NODE
  • eNOTATION_NODE
  • ePROCESSING_INSTRUCTION_NODE
  • eTEXT_NODE

Parameters:
nodeptr - The Node from which to retrieve the type.
Returns:
[const unsigned short] An integer representing the type of the Node.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_getNodeValue.html000066400000000000000000000017641303304015100252150ustar00rootroot00000000000000 EXPORT_SPEC DOMString ixmlNode_getNodeValue

EXPORT_SPEC DOMString ixmlNode_getNodeValue

(IXML_Node* nodeptr )

Returns the value of the Node as a string.

Documentation

Returns the value of the Node as a string. Note that this string is not a copy and modifying it will modify the value of the Node.

Parameters:
nodeptr - Pointer to the Node to retrieve the value.
Returns:
[DOMString] A DOMString of the Node value.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_getOwnerDocument.html000066400000000000000000000022611303304015100261150ustar00rootroot00000000000000 EXPORT_SPEC IXML_Document* ixmlNode_getOwnerDocument

EXPORT_SPEC IXML_Document* ixmlNode_getOwnerDocument

(IXML_Node* nodeptr )

Retrieves the document object associated with this Node.

Documentation

Retrieves the document object associated with this Node. This owner document Node allows other Nodes to be created in the context of this document. Note that Document nodes do not have an owner document.

Parameters:
nodeptr - The Node from which to retrieve the owner document.
Returns:
[Document*] A pointer to the owning Document or NULL, if the Node does not have an owner.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_getParentNode.html000066400000000000000000000017041303304015100253640ustar00rootroot00000000000000 EXPORT_SPEC IXML_Node* ixmlNode_getParentNode

EXPORT_SPEC IXML_Node* ixmlNode_getParentNode

(IXML_Node* nodeptr )

Retrieves the parent Node for a Node.

Documentation

Retrieves the parent Node for a Node.

Parameters:
nodeptr - The Node from which to retrieve the parent.
Returns:
[Node*] A pointer to the parent Node or NULL if the Node has no parent.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_getPrefix.html000066400000000000000000000023361303304015100245640ustar00rootroot00000000000000 EXPORT_SPEC DOMString ixmlNode_getPrefix

EXPORT_SPEC DOMString ixmlNode_getPrefix

(IXML_Node* nodeptr )

Retrieves the namespace prefix, if present.

Documentation

Retrieves the namespace prefix, if present. The prefix is the name used as an alias for the namespace URI for this element. Only Nodes of type eELEMENT_NODE or eATTRIBUTE_NODE can have a prefix. Nodes created through the Document interface will only contain a prefix if created using ixmlDocument_createElementNS.

Parameters:
nodeptr - The Node from which to retrieve the prefix.
Returns:
[DOMString] A DOMString representing the namespace prefix or NULL.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_getPreviousSibling.html000066400000000000000000000020131303304015100264430ustar00rootroot00000000000000 EXPORT_SPEC IXML_Node* ixmlNode_getPreviousSibling

EXPORT_SPEC IXML_Node* ixmlNode_getPreviousSibling

(IXML_Node* nodeptr )

Retrieves the sibling Node immediately preceding this Node.

Documentation

Retrieves the sibling Node immediately preceding this Node.

Parameters:
nodeptr - The Node for which to retrieve the previous sibling.
Returns:
[Node*] A pointer to the previous sibling Node or NULL if no such Node exists.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_hasAttributes.html000066400000000000000000000017571303304015100254570ustar00rootroot00000000000000 EXPORT_SPEC BOOL ixmlNode_hasAttributes

EXPORT_SPEC BOOL ixmlNode_hasAttributes

(IXML_Node* node )

Queries whether this Node has attributes.

Documentation

Queries whether this Node has attributes. Note that only Element nodes have attributes.

Parameters:
node - The Node to query for attributes.
Returns:
[BOOL] TRUE if the Node has attributes otherwise FALSE.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_hasChildNodes.html000066400000000000000000000017121303304015100253340ustar00rootroot00000000000000 EXPORT_SPEC BOOL ixmlNode_hasChildNodes

EXPORT_SPEC BOOL ixmlNode_hasChildNodes

(IXML_Node* nodeptr )

Queries whether or not a Node has children.

Documentation

Queries whether or not a Node has children.

Parameters:
nodeptr - The Node to query for children.
Returns:
[BOOL] TRUE if the Node has one or more children otherwise FALSE.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_insertBefore.html000066400000000000000000000044711303304015100252600ustar00rootroot00000000000000 EXPORT_SPEC int ixmlNode_insertBefore

EXPORT_SPEC int ixmlNode_insertBefore

(IXML_Node* nodeptr,
  IXML_Node* newChild,
  IXML_Node* refChild )

Inserts a new child Node before the existing child Node.

Documentation

Inserts a new child Node before the existing child Node. refChild can be NULL, which inserts newChild at the end of the list of children. Note that the Node (or Nodes) in newChild must already be owned by the owner document (or have no owner at all) of nodeptr for insertion. If not, the Node (or Nodes) must be imported into the document using ixmlDocument_importNode. If newChild is already in the tree, it is removed first.

Parameters:
nodeptr - The parent of the Node before which to insert the new child.
newChild - The Node to insert into the tree.
refChild - The reference child where the new Node should be inserted. The new Node will appear directly before the reference child.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either nodeptr or newChild is NULL.
  • IXML_HIERARCHY_REQUEST_ERR: The type of the Node does not allow children of the type of newChild.
  • IXML_WRONG_DOCUMENT_ERR: newChild has an owner document that does not match the owner of nodeptr.
  • IXML_NO_MODIFICATION_ALLOWED_ERR: nodeptr is read-only or the parent of the Node being inserted is read-only.
  • IXML_NOT_FOUND_ERR: refChild is not a child of nodeptr.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_removeChild.html000066400000000000000000000031531303304015100250660ustar00rootroot00000000000000 EXPORT_SPEC int ixmlNode_removeChild

EXPORT_SPEC int ixmlNode_removeChild

(IXML_Node* nodeptr,
  IXML_Node* oldChild,
  IXML_Node** returnNode )

Removes a child from the list of children of a Node.

Documentation

Removes a child from the list of children of a Node. returnNode will contain the oldChild Node, appropriately removed from the tree (i.e. it will no longer have an owner document).

Parameters:
nodeptr - The parent of the child to remove.
oldChild - The child Node to remove.
returnNode - Pointer to a Node to place the removed oldChild Node.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: Either nodeptr or oldChild is NULL.
  • IXML_NO_MODIFICATION_ALLOWED_ERR: nodeptr or its parent is read-only.
  • IXML_NOT_FOUND_ERR: oldChild is not among the children of nodeptr.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_replaceChild.html000066400000000000000000000043301303304015100252020ustar00rootroot00000000000000 EXPORT_SPEC int ixmlNode_replaceChild

EXPORT_SPEC int ixmlNode_replaceChild

(IXML_Node* nodeptr,
  IXML_Node* newChild,
  IXML_Node* oldChild,
  IXML_Node** returnNode )

Replaces an existing child Node with a new child Node in the list of children of a Node.

Documentation

Replaces an existing child Node with a new child Node in the list of children of a Node. If newChild is already in the tree, it will first be removed. returnNode will contain the oldChild Node, appropriately removed from the tree (i.e. it will no longer have an owner document).

Parameters:
nodeptr - The parent of the Node which contains the child to replace.
newChild - The child with which to replace oldChild.
oldChild - The child to replace with newChild.
returnNode - Pointer to a Node to place the removed oldChild Node.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMTER: Either nodeptr, newChild, or oldChild is NULL.
  • IXML_HIERARCHY_REQUEST_ERR: The newChild is not a type of Node that can be inserted into this tree or newChild is an ancestor of nodePtr.
  • IXML_WRONG_DOCUMENT_ERR: newChild was created from a different document than nodeptr.
  • IXML_NO_MODIFICATION_ALLOWED_ERR: nodeptr or its parent is read-only.
  • IXML_NOT_FOUND_ERR: oldChild is not a child of nodeptr.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNode_setNodeValue.html000066400000000000000000000025201303304015100252200ustar00rootroot00000000000000 EXPORT_SPEC int ixmlNode_setNodeValue

EXPORT_SPEC int ixmlNode_setNodeValue

(IXML_Node* nodeptr,
  char* newNodeValue )

Assigns a new value to a Node.

Documentation

Assigns a new value to a Node. The newNodeValue string is duplicated and stored in the Node so that the original does not have to persist past this call.

Parameters:
nodeptr - The Node to which to assign a new value.
newNodeValue - The new value of the Node.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: The Node* is not a valid pointer.
  • IXML_INSUFFICIENT_MEMORY: Not enough free memory exists to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlNodetoString.html000066400000000000000000000025721303304015100243030ustar00rootroot00000000000000 EXPORT_SPEC DOMString ixmlNodetoString

EXPORT_SPEC DOMString ixmlNodetoString

(IXML_Node* doc )

Renders a Node and all sub-elements into an XML text representation.

Documentation

Renders a Node and all sub-elements into an XML text representation. The caller is required to free the DOMString returned from this function using ixmlFreeDOMString when it is no longer required.

Note that this function can be used for any Node-derived interface. The difference between ixmlNodetoString and ixmlDocumenttoString is ixmlNodetoString does not include the XML prolog, it only produces XML elements.

Parameters:
doc - The root of the Node tree to render to XML text.
Returns:
[DOMString] A DOMString with the XML text representation of the DOM tree or NULL on an error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlParseBuffer.html000066400000000000000000000017621303304015100240700ustar00rootroot00000000000000 EXPORT_SPEC IXML_Document* ixmlParseBuffer

EXPORT_SPEC IXML_Document* ixmlParseBuffer

(char* buffer )

Parses an XML text buffer converting it into an IXML DOM representation.

Documentation

Parses an XML text buffer converting it into an IXML DOM representation.

Parameters:
buffer - The buffer that contains the XML text to convert to a Document.
Returns:
[Document*] A Document if the buffer correctly parses or NULL on an error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlParseBufferEx.html000066400000000000000000000027711303304015100243660ustar00rootroot00000000000000 EXPORT_SPEC int ixmlParseBufferEx

EXPORT_SPEC int ixmlParseBufferEx

(char* buffer,
  IXML_Document** doc )

Parses an XML text buffer converting it into an IXML DOM representation.

Documentation

Parses an XML text buffer converting it into an IXML DOM representation.

The ixmlParseBufferEx API differs from the ixmlParseBuffer API in that it returns an error code representing the actual failure rather than just NULL.

Parameters:
buffer - The buffer that contains the XML text to convert to a Document.
doc - A point to store the Document if file correctly parses or NULL on an error.
Returns:
[int] An integer representing one of the following:
  • IXML_SUCCESS: The operation completed successfully.
  • IXML_INVALID_PARAMETER: The buffer is not a valid pointer.
  • IXML_INSUFFICIENT_MEMORY: Not enough free memory exists to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlPrintDocument.html000066400000000000000000000027271303304015100244610ustar00rootroot00000000000000 DOMString ixmlPrintDocument

DOMString ixmlPrintDocument

(IXML_Document* doc)

Renders a Node and all sub-elements into an XML document representation.

Documentation

Renders a Node and all sub-elements into an XML document representation. The caller is required to free the DOMString returned from this function using ixmlFreeDOMString when it is no longer required.

Note that this function can be used for any Node-derived interface. The difference between ixmlPrintDocument and ixmlPrintNode is ixmlPrintDocument includes the XML prolog while ixmlPrintNode only produces XML elements. An XML document is not well formed unless it includes the prolog and at least one element.

This function introduces lots of white space to print the DOMString in readable format.

Returns:
[DOMString] A DOMString with the XML document representation of the DOM tree or NULL on an error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlPrintNode.html000066400000000000000000000025701303304015100235640ustar00rootroot00000000000000 DOMString ixmlPrintNode

DOMString ixmlPrintNode

(IXML_Node* doc )

Renders a Node and all sub-elements into an XML text representation.

Documentation

Renders a Node and all sub-elements into an XML text representation. The caller is required to free the DOMString returned from this function using ixmlFreeDOMString when it is no longer required.

Note that this function can be used for any Node-derived interface. A similar ixmlPrintDocument function is defined to avoid casting when printing whole documents. This function introduces lots of white space to print the DOMString in readable format.

Parameters:
doc - The root of the Node tree to render to XML text.
Returns:
[DOMString] A DOMString with the XML text representation of the DOM tree or NULL on an error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/ixmlRelaxParser.html000066400000000000000000000020441303304015100241060ustar00rootroot00000000000000 void ixmlRelaxParser

void ixmlRelaxParser

(char errorChar)

Makes the XML parser more tolerant to malformed text.

Documentation

Makes the XML parser more tolerant to malformed text.

If errorChar is 0 (default), the parser is strict about XML encoding : invalid UTF-8 sequences or "&" entities are rejected, and the parsing aborts. If errorChar is not 0, the parser is relaxed : invalid UTF-8 characters are replaced by the errorChar, and invalid "&" entities are left untranslated. The parsing is then allowed to continue.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/ixml/toc.html000066400000000000000000000006401303304015100215510ustar00rootroot00000000000000 Table of Contents

Table of Contents

General stuff


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/000077500000000000000000000000001303304015100201075ustar00rootroot00000000000000pupnp-release-1.8.0/docs/dist/html/upnp/AboutCallbacks.html000066400000000000000000000022341303304015100236500ustar00rootroot00000000000000 About Callbacks

About Callbacks

The Linux SDK for UPnP Devices contains functions that generate asynchronous callbacks. To simplify the application callback functions, these callbacks are executed on a thread owned by the SDK itself. The SDK executes the application's callback function in a thread context so the application can allocate memory and preserve the information it needs. The application can also use standard thread synchronization methods to ensure data integrity. Due to the possibility of deadlock, the application cannot call back into the SDK during these callbacks unless explicitly noted. There is no restriction in calling into the operating system or any other application interfaces.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/ConstantsStructuresandTypes.html000066400000000000000000000075661303304015100266030ustar00rootroot00000000000000 Constants, Structures, and Types

Constants, Structures, and Types

o UpnpClient_Handle
Returned when a control point application registers with UpnpRegisterClient.
o UpnpDevice_Handle
Returned when a device application registers with UpnpRegisterRootDevice or UpnpRegisterRootDevice2.
o UPnP_EventType
The reason code for an event callback.
o Upnp_SID[44]
The Upnp_SID holds the subscription identifier for a subscription between a client and a device.
o Upnp_SType
Represents the different types of searches that can be performed using the SDK for UPnP Devices API.
o Upnp_DescType
Specifies the type of description in UpnpRegisterRootDevice2.
o Upnp_Action_Request
Returned as part of a UPNP_CONTROL_ACTION_COMPLETE callback.
o Upnp_State_Var_Request
Represents the request for current value of a state variable in a service state table.
o Upnp_State_Var_Complete
Represents the reply for the current value of a state variable in an asynchronous call.
o Upnp_Event
Returned along with a UPNP_EVENT_RECEIVED callback.
o Upnp_Discovery
Returned in a UPNP_DISCOVERY_RESULT callback.
o Upnp_Event_Subscribe
Returned along with a UPNP_EVENT_SUBSCRIBE_COMPLETE or UPNP_EVENT_UNSUBSCRIBE_COMPLETE callback.
o Upnp_Subscription_Request
Returned along with a UPNP_EVENT_SUBSCRIPTION_REQUEST callback.
o UpnpVirtualDirCallbacks
The UpnpVirtualDirCallbacks structure contains the pointers to file-related callback functions a device application can register to virtualize URLs.
o (*Upnp_FunPtr)
All callback functions share the same prototype, documented below.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Control.html000066400000000000000000000040301303304015100224120ustar00rootroot00000000000000 Control

Control

o UpnpGetServiceVarStatus
UpnpGetServiceVarStatus queries the state of a state variable of a service on another device.
o UpnpGetServiceVarStatusAsync
UpnpGetServiceVarStatusAsync queries the state of a variable of a service, generating a callback when the operation is complete.
o UpnpSendAction
UpnpSendAction sends a message to change a state variable in a service.
o UpnpSendActionEx
UpnpSendActionEx sends a message to change a state variable in a service.
o UpnpSendActionAsync
UpnpSendActionAsync sends a message to change a state variable in a service, generating a callback when the operation is complete.
o UpnpSendActionExAsync
UpnpSendActionExAsync sends a message to change a state variable in a service, generating a callback when the operation is complete.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/ControlPointHTTPAPI.html000066400000000000000000000066201303304015100244650ustar00rootroot00000000000000 Control Point HTTP API

Control Point HTTP API

o UpnpDownloadUrlItem
UpnpDownloadUrlItem downloads a file specified in a URL.
o UpnpOpenHttpGet
UpnpOpenHttpGet gets a file specified in a URL.
o UpnpOpenHttpGetProxy
UpnpOpenHttpGetProxy gets a file specified in a URL through the specified proxy.
o UpnpOpenHttpGetEx
UpnpOpenHttpGetEx gets specified number of bytes from a file specified in the URL.
o UpnpReadHttpGet
UpnpReadHttpGet gets specified number of bytes from a file specified in a URL.
o UpnpHttpGetProgress
UpnpHttpGetProgress rettrieve progress information of a http-get transfer.
o UpnpCancelHttpGet
UpnpCancelHttpGet set the cancel flag of the handle parameter.
o UpnpCloseHttpGet
UpnpCloseHttpGet closes the connection and frees memory that was allocated for the handle parameter.
o UpnpOpenHttpPost
UpnpOpenHttpPost makes an HTTP POST request message, opens a connection to the server and sends the POST request to the server if the connection to the server succeeds.
o UpnpWriteHttpPost
UpnpWriteHttpPost sends a request to a server to copy the contents of a buffer to the URI specified in the UpnpOpenHttpPost call.
o UpnpCloseHttpPost
UpnpCloseHttpPost sends and receives any pending data, closes the connection with the server, and frees memory allocated during the UpnpOpenHttpPost call.
o UpnpDownloadXmlDoc
UpnpDownloadXmlDoc downloads an XML document specified in a URL.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Discovery.html000066400000000000000000000016741303304015100227540ustar00rootroot00000000000000 Discovery

Discovery

o UpnpSearchAsync
UpnpSearchAsync searches for devices matching the given search target.
o UpnpSendAdvertisement
UpnpSendAdvertisement sends out the discovery announcements for all devices and services for a device.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Errorcodes.html000066400000000000000000000141161303304015100231070ustar00rootroot00000000000000 Error codes

Error codes

The functions in the SDK API can return a variety of error codes to describe problems encountered during execution. This section lists the error codes and provides a brief description of what each error code means. Refer to the documentation for each function for a description of what an error code means in that context.
o UPNP_E_SUCCESS [0]
o UPNP_E_INVALID_HANDLE [-100]
o UPNP_E_INVALID_PARAM [-101]
o UPNP_E_OUTOF_HANDLE [-102]
o UPNP_E_OUTOF_MEMORY [-104]
o UPNP_E_INIT [-105]
o UPNP_E_INVALID_DESC [-107]
o UPNP_E_INVALID_URL [-108]
o UPNP_E_INVALID_SERVICE [-111]
o UPNP_E_BAD_RESPONSE [-113]
o UPNP_E_INVALID_ACTION [-115]
o UPNP_E_FINISH [-116]
o UPNP_E_INIT_FAILED [-117]
o UPNP_E_BAD_HTTPMSG [-119]
o UPNP_E_ALREADY_REGISTERED [-120]
o UPNP_E_NETWORK_ERROR [-200]
o UPNP_E_SOCKET_WRITE [-201]
o UPNP_E_SOCKET_READ [-202]
o UPNP_E_SOCKET_BIND [-203]
o UPNP_E_SOCKET_CONNECT [-204]
o UPNP_E_OUTOF_SOCKET [-205]
o UPNP_E_LISTEN [-206]
o UPNP_E_TIMEDOUT [-207]
o UPNP_E_SOCKET_ERROR [-208]
o UPNP_E_CANCELED [-210]
o UPNP_E_SUBSCRIBE_UNACCEPTED [-301]
o UPNP_E_UNSUBSCRIBE_UNACCAPTED [-302]
o UPNP_E_NOTIFY_UNACCEPTED [-303]
o UPNP_E_INVALID_ARGUMENT [-501]
o UPNP_E_FILE_NOT_FOUND [-502]
o UPNP_E_FILE_READ_ERROR [-503]
o UPNP_E_EXT_NOT_XML [-504]
o UPNP_E_NOT_FOUND [-507]
o UPNP_E_INTERNAL_ERROR [-911]

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Eventing.html000066400000000000000000000075511303304015100225640ustar00rootroot00000000000000 Eventing

Eventing

o UpnpAcceptSubscription
UpnpAcceptSubscription accepts a subscription request and sends out the current state of the eventable variables for a service.
o UpnpAcceptSubscriptionExt
UpnpAcceptSubscriptionExt is similar to UpnpAcceptSubscription except that it takes a DOM document for the variables to event rather than an array of strings.
o UpnpNotify
UpnpNotify sends out an event change notification to all control points subscribed to a particular service.
o UpnpNotifyExt
UpnpNotifyExt is similar to UpnpNotify except that it takes a DOM document for the event rather than an array of strings.
o UpnpRenewSubscription
UpnpRenewSubscription renews a subscription that is about to expire.
o UpnpRenewSubscriptionAsync
UpnpRenewSubscriptionAsync renews a subscription that is about to expire, generating a callback when the operation is complete.
o UpnpSetMaxSubscriptions
UpnpSetMaxSubscriptions sets the maximum number of subscriptions accepted per service.
o UpnpSetMaxSubscriptionTimeOut
UpnpSetMaxSubscriptionTimeOut sets the maximum time-out accepted for a subscription request or renewal.
o UpnpSubscribe
UpnpSubscribe registers a control point to receive event notifications from another device.
o UpnpSubscribeAsync
UpnpSubscribeAsync performs the same operation as UpnpSubscribe, but returns immediately and calls the registered callback function when the operation is complete.
o UpnpUnSubscribe
UpnpUnSubscribe removes the subscription of a control point from a service previously subscribed to using UpnpSubscribe or UpnpSubscribeAsync.
o UpnpUnSubscribeAsync
UpnpUnSubscribeAsync removes a subscription of a control point from a service previously subscribed to using UpnpSubscribe or UpnpSubscribeAsync, generating a callback when the operation is complete.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/General.html000066400000000000000000000005701303304015100223540ustar00rootroot00000000000000 General Bits

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/InitializationandRegistration.html000066400000000000000000000063011303304015100270420ustar00rootroot00000000000000 Initialization and Registration

Initialization and Registration

o UpnpInit
Initializes the Linux SDK for UPnP Devices.
o UpnpFinish
Terminates the Linux SDK for UPnP Devices.
o UpnpGetServerPort
If '0' is used as the port number in UpnpInit, then this function can be used to retrieve the actual port allocated to the SDK.
o UpnpGetServerIpAddress
If NULL is used as the IP address in UpnpInit, then this function can be used to retrieve the actual interface address on which device is running.
o UpnpRegisterClient
UpnpRegisterClient registers a control point application with the SDK.
o UpnpRegisterRootDevice
UpnpRegisterRootDevice registers a device application with the SDK.
o UpnpRegisterRootDevice2
UpnpRegisterRootDevice2 is similar to UpnpRegisterRootDevice, except that it also allows the description document to be specified as a file or a memory buffer.
o UpnpUnRegisterClient
UpnpUnRegisterClient unregisters a control point application, unsubscribing all active subscriptions.
o UpnpUnRegisterRootDevice
Unregisters a root device registered with UpnpRegisterRootDevice or UpnpRegisterRootDevice2.
o UpnpSetContentLength
OBSOLETE METHOD : use UpnpSetMaxContentLength instead.
o UpnpSetMaxContentLength
Sets the maximum content-length that the SDK will process on an incoming SOAP requests or responses.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Introduction.html000066400000000000000000000020721303304015100234570ustar00rootroot00000000000000 Introduction

Introduction

This document gives a brief description of the Linux SDK for UPnP Devices API. Section 1 covers the license under which the SDK is distributed. Section 2 talks about the callback functions used in many parts of the API. Finally, section 3 details the structures and functions that comprise the API.

The Linux SDK for UPnP Devices version 1.2 supports the following platforms:

  • Linux* running on an Intel Architecture processor
  • Linux running on an Intel StrongARM or XScale processor

* Other brands and names are the property of their respective owners.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/License.html000066400000000000000000000037231303304015100223640ustar00rootroot00000000000000 License

License

Copyright (c) 2000-2003 Intel Corporation All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  • Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
  • Neither name of Intel Corporation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/OptionalToolAPIs.html000066400000000000000000000054641303304015100241460ustar00rootroot00000000000000 Optional Tool APIs

Optional Tool APIs

The Linux SDK for UPnP Devices contains some additional, optional utility APIs that can be helpful in writing applications using the SDK. These additional APIs can be compiled out in order to save code size in the SDK. Refer to the README for details.
o UpnpResolveURL
UpnpResolveURL combines a base URL and a relative URL into a single absolute URL.
o UpnpMakeAction
UpnpMakeAction creates an action request packet based on its input parameters (status variable name and value pair).
o UpnpAddToAction
UpnpAddToAction creates an action request packet based on its input parameters (status variable name and value pair).
o UpnpMakeActionResponse
UpnpMakeActionResponse creates an action response packet based on its output parameters (status variable name and value pair).
o UpnpAddToActionResponse
UpnpAddToActionResponse creates an action response packet based on its output parameters (status variable name and value pair).
o UpnpAddToPropertySet
UpnpAddToPropertySet can be used when an application needs to transfer the status of many variables at once.
o UpnpCreatePropertySet
UpnpCreatePropertySet creates a property set message packet.
o UpnpGetErrorMessage
UpnpGetErrorMessage converts an SDK error code into a string error message suitable for display.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/TheAPI.html000066400000000000000000000027651303304015100220610ustar00rootroot00000000000000 The API

The API

o Error codes
o Constants, Structures, and Types
o Initialization and Registration
o Discovery
o Control
o Eventing
o Control Point HTTP API
o Web Server API

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNPREG_BUF_DESC.html000066400000000000000000000013351303304015100234110ustar00rootroot00000000000000 UPNPREG_BUF_DESC

UPNPREG_BUF_DESC

The description is a pointer to a character array containing the XML description document.

Documentation

The description is a pointer to a character array containing the XML description document.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNPREG_FILENAME_DESC.html000066400000000000000000000013651303304015100241600ustar00rootroot00000000000000 UPNPREG_FILENAME_DESC

UPNPREG_FILENAME_DESC

The description is a file name on the local file system containing the description of the device.

Documentation

The description is a file name on the local file system containing the description of the device.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNPREG_URL_DESC.html000066400000000000000000000012251303304015100234350ustar00rootroot00000000000000 UPNPREG_URL_DESC

UPNPREG_URL_DESC

The description is the URL to the description document.

Documentation

The description is the URL to the description document.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_CONTROL_ACTION_COMPLETE.html000066400000000000000000000014211303304015100253020ustar00rootroot00000000000000 UPNP_CONTROL_ACTION_COMPLETE

UPNP_CONTROL_ACTION_COMPLETE

A UpnpSendActionAsync call completed.

Documentation

A UpnpSendActionAsync call completed. The Event parameter contains a pointer to a Upnp_Action_Complete structure with the results of the action.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_CONTROL_ACTION_REQUEST.html000066400000000000000000000015711303304015100252300ustar00rootroot00000000000000 UPNP_CONTROL_ACTION_REQUEST

UPNP_CONTROL_ACTION_REQUEST

Received by a device when a control point issues a control request.

Documentation

Received by a device when a control point issues a control request. The Event parameter contains a pointer to a Upnp_Action_Request structure containing the action. The application stores the results of the action in this structure.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_CONTROL_GET_VAR_COMPLETE.html000066400000000000000000000014451303304015100254620ustar00rootroot00000000000000 UPNP_CONTROL_GET_VAR_COMPLETE

UPNP_CONTROL_GET_VAR_COMPLETE

A UpnpGetServiceVarStatus call completed.

Documentation

A UpnpGetServiceVarStatus call completed. The Event parameter contains a pointer to a Upnp_State_Var_Complete structure containing the value for the variable.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_CONTROL_GET_VAR_REQUEST.html000066400000000000000000000015341303304015100254010ustar00rootroot00000000000000 UPNP_CONTROL_GET_VAR_REQUEST

UPNP_CONTROL_GET_VAR_REQUEST

Received by a device when a query for a single service variable arrives.

Documentation

Received by a device when a query for a single service variable arrives. The Event parameter contains a pointer to a Upnp_State_Var_Request structure containing the name of the variable and value.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_DISCOVERY_ADVERTISEMENT_ALIVE.html000066400000000000000000000015401303304015100262200ustar00rootroot00000000000000 UPNP_DISCOVERY_ADVERTISEMENT_ALIVE

UPNP_DISCOVERY_ADVERTISEMENT_ALIVE

Received by a control point when a new device or service is available.

Documentation

Received by a control point when a new device or service is available. The Event parameter contains a pointer to a Upnp_Discovery structure with the information about the device or service.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_DISCOVERY_ADVERTISEMENT_BYEBYE.html000066400000000000000000000015321303304015100263400ustar00rootroot00000000000000 UPNP_DISCOVERY_ADVERTISEMENT_BYEBYE

UPNP_DISCOVERY_ADVERTISEMENT_BYEBYE

Received by a control point when a device or service shuts down.

Documentation

Received by a control point when a device or service shuts down. The Event parameter contains a pointer to a Upnp_Discovery structure containing the information about the device or service.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_DISCOVERY_SEARCH_RESULT.html000066400000000000000000000015441303304015100253350ustar00rootroot00000000000000 UPNP_DISCOVERY_SEARCH_RESULT

UPNP_DISCOVERY_SEARCH_RESULT

Received by a control point when a matching device or service responds.

Documentation

Received by a control point when a matching device or service responds. The Event parameter contains a pointer to a Upnp_Discovery structure containing the information about the reply to the search request.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_DISCOVERY_SEARCH_TIMEOUT.html000066400000000000000000000014601303304015100254420ustar00rootroot00000000000000 UPNP_DISCOVERY_SEARCH_TIMEOUT

UPNP_DISCOVERY_SEARCH_TIMEOUT

Received by a control point when the search timeout expires.

Documentation

Received by a control point when the search timeout expires. The SDK generates no more callbacks for this search after this event. The Event parameter is NULL.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_EVENT_AUTORENEWAL_FAILED.html000066400000000000000000000014721303304015100253760ustar00rootroot00000000000000 UPNP_EVENT_AUTORENEWAL_FAILED

UPNP_EVENT_AUTORENEWAL_FAILED

The auto-renewal of a client subscription failed.

Documentation

The auto-renewal of a client subscription failed. The Event parameter is a Upnp_Event_Subscribe structure with the error code set appropriately. The subscription is no longer valid.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_EVENT_RECEIVED.html000066400000000000000000000013741303304015100237730ustar00rootroot00000000000000 UPNP_EVENT_RECEIVED

UPNP_EVENT_RECEIVED

Received by a control point when an event arrives.

Documentation

Received by a control point when an event arrives. The Event parameter contains a Upnp_Event structure with the information about the event.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_EVENT_RENEWAL_COMPLETE.html000066400000000000000000000014171303304015100251700ustar00rootroot00000000000000 UPNP_EVENT_RENEWAL_COMPLETE

UPNP_EVENT_RENEWAL_COMPLETE

A UpnpRenewSubscriptionAsync call completed.

Documentation

A UpnpRenewSubscriptionAsync call completed. The status of the renewal is in the Event parameter as a Upnp_Event_Subscription structure.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_EVENT_SUBSCRIBE_COMPLETE.html000066400000000000000000000014101303304015100254050ustar00rootroot00000000000000 UPNP_EVENT_SUBSCRIBE_COMPLETE

UPNP_EVENT_SUBSCRIBE_COMPLETE

A UpnpSubscribeAsync call completed.

Documentation

A UpnpSubscribeAsync call completed. The status of the subscription is in the Event parameter as a Upnp_Event_Subscription structure.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_EVENT_SUBSCRIPTION_EXPIRED.html000066400000000000000000000014711303304015100257070ustar00rootroot00000000000000 UPNP_EVENT_SUBSCRIPTION_EXPIRED

UPNP_EVENT_SUBSCRIPTION_EXPIRED

A client subscription has expired.

Documentation

A client subscription has expired. This will only occur if auto-renewal of subscriptions is disabled. The Event parameter is a Upnp_Event_Subscribe structure. The subscription is no longer valid.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_EVENT_SUBSCRIPTION_REQUEST.html000066400000000000000000000021221303304015100257310ustar00rootroot00000000000000 UPNP_EVENT_SUBSCRIPTION_REQUEST

UPNP_EVENT_SUBSCRIPTION_REQUEST

Received by a device when a subscription arrives.

Documentation

Received by a device when a subscription arrives. The Event parameter contains a pointer to a Upnp_Subscription_Request structure. At this point, the subscription has already been accepted. UpnpAcceptSubscription needs to be called to confirm the subscription and transmit the initial state table. This can be done during this callback. The SDK generates no events for a subscription unless the device application calls UpnpAcceptSubscription.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_EVENT_UNSUBSCRIBE_COMPLETE.html000066400000000000000000000014151303304015100256550ustar00rootroot00000000000000 UPNP_EVENT_UNSUBSCRIBE_COMPLETE

UPNP_EVENT_UNSUBSCRIBE_COMPLETE

A UpnpUnSubscribeAsync call completed.

Documentation

A UpnpUnSubscribeAsync call completed. The status of the subscription is in the Event parameter as a Upnp_Event_Subscribe structure.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_ALREADY_REGISTERED-120.html000066400000000000000000000013141303304015100252000ustar00rootroot00000000000000 UPNP_E_ALREADY_REGISTERED [-120]

UPNP_E_ALREADY_REGISTERED [-120]

UPNP_E_ALREADY_REGISTERED signifies that a client or a device is already registered. The SDK currently has a limit of one registered client and one registered device per process.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_BAD_HTTPMSG-119.html000066400000000000000000000016571303304015100242200ustar00rootroot00000000000000 UPNP_E_BAD_HTTPMSG [-119]

UPNP_E_BAD_HTTPMSG [-119]

UPNP_E_BAD_HTTPMSG signifies that the HTTP message contains invalid message headers. The error always refers to the HTTP message header received from the remote host. The main areas where this occurs are in SOAP control messages (e.g. UpnpSendAction), GENA subscription message (e.g. UpnpSubscribe), GENA event notifications (e.g. UpnpNotify), and HTTP transfers (e.g. UpnpDownloadXmlDoc).

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_BAD_RESPONSE-113.html000066400000000000000000000013001303304015100243030ustar00rootroot00000000000000 UPNP_E_BAD_RESPONSE [-113]

UPNP_E_BAD_RESPONSE [-113]

UPNP_E_BAD_RESPONSE signifies that the response received from the remote side of a connection is not correct for the protocol. This applies to the GENA, SOAP, and HTTP protocols.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_CANCELED-210.html000066400000000000000000000012171303304015100235420ustar00rootroot00000000000000 UPNP_E_CANCELED [-210]

UPNP_E_CANCELED [-210]

UPNP_E_CANCELED signifies that the operation was canceled. This error can be returned by any function that allows for external cancelation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_EXT_NOT_XML-504.html000066400000000000000000000012261303304015100243120ustar00rootroot00000000000000 UPNP_E_EXT_NOT_XML [-504]

UPNP_E_EXT_NOT_XML [-504]

UPNP_E_EXT_NOT_XML signifies that the file name of the description document passed to UpnpRegisterRootDevice2 does not end in ".xml".

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_FILE_NOT_FOUND-502.html000066400000000000000000000012311303304015100245760ustar00rootroot00000000000000 UPNP_E_FILE_NOT_FOUND [-502]

UPNP_E_FILE_NOT_FOUND [-502]

UPNP_E_FILE_NOT_FOUND signifies that the filename passed to one of the device registration functions was not found or was not accessible.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_FILE_READ_ERROR-503.html000066400000000000000000000011201303304015100246650ustar00rootroot00000000000000 UPNP_E_FILE_READ_ERROR [-503]

UPNP_E_FILE_READ_ERROR [-503]

UPNP_E_FILE_READ_ERROR signifies an error when reading a file.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_FINISH-116.html000066400000000000000000000013061303304015100233700ustar00rootroot00000000000000 UPNP_E_FINISH [-116]

UPNP_E_FINISH [-116]

UPNP_E_FINISH signifies that UpnpInit has not been called, or that UpnpFinish has already been called. None of the API functions operate until UpnpInit successfully completes.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_INIT-105.html000066400000000000000000000013171303304015100231530ustar00rootroot00000000000000 UPNP_E_INIT [-105]

UPNP_E_INIT [-105]

UPNP_E_INIT signifies that the SDK has already been initialized. The SDK needs to be initialied only once per process. Any additional initialization attempts simply return this error with no other ill effects.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_INIT_FAILED-117.html000066400000000000000000000012161303304015100241600ustar00rootroot00000000000000 UPNP_E_INIT_FAILED [-117]

UPNP_E_INIT_FAILED [-117]

UPNP_E_INIT_FAILED signifies that UpnpInit cannot complete. The typical reason is failure to allocate sufficient resources.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_INTERNAL_ERROR-911.html000066400000000000000000000011711303304015100246000ustar00rootroot00000000000000 UPNP_E_INTERNAL_ERROR [-911]

UPNP_E_INTERNAL_ERROR [-911]

UPNP_E_INTERNAL_ERROR is the generic error code for internal conditions not covered by other error codes.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_INVALID_ACTION-115.html000066400000000000000000000013371303304015100245360ustar00rootroot00000000000000 UPNP_E_INVALID_ACTION [-115]

UPNP_E_INVALID_ACTION [-115]

UPNP_E_INVALID_ACTION signifies that the SOAP action message is invalid. This can be because the DOM document passed to the function was malformed or the action message is not correct for the given action.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_INVALID_ARGUMENT-501.html000066400000000000000000000013221303304015100247740ustar00rootroot00000000000000 UPNP_E_INVALID_ARGUMENT [-501]

UPNP_E_INVALID_ARGUMENT [-501]

UPNP_E_INVALID_ARGUMENT signifies that one or more of the parameters passed to a function is invalid. Refer to the individual function descriptions for the acceptable ranges for parameters.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_INVALID_DESC-107.html000066400000000000000000000012701303304015100242740ustar00rootroot00000000000000 UPNP_E_INVALID_DESC [-107]

UPNP_E_INVALID_DESC [-107]

UPNP_E_INVALID_DESC signifies that the description document passed to UpnpRegisterRootDevice or UpnpRegisterRootDevice2 is an invalid description document.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_INVALID_HANDLE-100.html000066400000000000000000000011741303304015100245050ustar00rootroot00000000000000 UPNP_E_INVALID_HANDLE [-100]

UPNP_E_INVALID_HANDLE [-100]

UPNP_E_INVALID_HANDLE signifies that the handle passed to a function is not a recognized as a valid handle.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_INVALID_PARAM-101.html000066400000000000000000000013401303304015100244060ustar00rootroot00000000000000 UPNP_E_INVALID_PARAM [-101]

UPNP_E_INVALID_PARAM [-101]

UPNP_E_INVALID_PARAM signifies that one or more of the parameters passed to the function is not valid. Refer to the documentation for each function for more information on the valid ranges of the parameters.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_INVALID_SERVICE-111.html000066400000000000000000000013741303304015100246560ustar00rootroot00000000000000 UPNP_E_INVALID_SERVICE [-111]

UPNP_E_INVALID_SERVICE [-111]

UPNP_E_INVALID_SERVICE is returned only by UpnpNotify, UpnpNotifyExt, UpnpAcceptSubscription, and UpnpAcceptSubscriptionExt to signify that the device ID/service ID pair does not refer to a valid service.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_INVALID_URL-108.html000066400000000000000000000013671303304015100242300ustar00rootroot00000000000000 UPNP_E_INVALID_URL [-108]

UPNP_E_INVALID_URL [-108]

UPNP_E_INVALID_URL signifies that a URL passed into the function is invalid. The actual cause is function specific, but in general, the URL itself might be malformed (e.g. have invalid characters in it) or the host might be unreachable.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_LISTEN-206.html000066400000000000000000000012601303304015100234050ustar00rootroot00000000000000 UPNP_E_LISTEN [-206]

UPNP_E_LISTEN [-206]

UPNP_E_LISTEN signifies that the SDK had a problem setting the socket to listen for incoming connections. This error only happens during initialization (i.e. UpnpInit).

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_NETWORK_ERROR-200.html000066400000000000000000000014661303304015100245130ustar00rootroot00000000000000 UPNP_E_NETWORK_ERROR [-200]

UPNP_E_NETWORK_ERROR [-200]

UPNP_E_NETWORK_ERROR signifies that a network error occurred. It is the generic error code for network problems that are not covered under one of the more specific error codes. The typical meaning is the SDK failed to read the local IP address or had problems configuring one of the sockets.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_NOTIFY_UNACCEPTED-303.html000066400000000000000000000012031303304015100251050ustar00rootroot00000000000000 UPNP_E_NOTIFY_UNACCEPTED [-303]

UPNP_E_NOTIFY_UNACCEPTED [-303]

UPNP_E_NOTIFY_UNACCEPTED signifies that the remote host did not accept the notify sent from the local device.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_NOT_FOUND-507.html000066400000000000000000000011631303304015100240100ustar00rootroot00000000000000 UPNP_E_NOT_FOUND [-507]

UPNP_E_NOT_FOUND [-507]

UPNP_E_NOT_FOUND signifies that the response to a SOAP request did not contain the required XML constructs.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_OUTOF_HANDLE-102.html000066400000000000000000000012711303304015100243130ustar00rootroot00000000000000 UPNP_E_OUTOF_HANDLE [-102]

UPNP_E_OUTOF_HANDLE [-102]

UPNP_E_OUTOF_HANDLE signifies that the SDK does not have any more space for additional handles. The SDK allocates space for only a few handles in order to conserve memory.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_OUTOF_MEMORY-104.html000066400000000000000000000013031303304015100243660ustar00rootroot00000000000000 UPNP_E_OUTOF_MEMORY [-104]

UPNP_E_OUTOF_MEMORY [-104]

UPNP_E_OUTOF_MEMORY signifies that not enough resources are currently available to complete the operation. Most operations require some free memory in order to complete their work.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_OUTOF_SOCKET-205.html000066400000000000000000000015461303304015100243610ustar00rootroot00000000000000 UPNP_E_OUTOF_SOCKET [-205]

UPNP_E_OUTOF_SOCKET [-205]

UPNP_E_OUTOF_SOCKET signifies that the SDK cannot create any more sockets. This occurs in any function that makes network connections, such as discovery (e.g. UpnpSearchAsync or UpnpSendAdvertisement), control (e.g. UpnpSendAction), eventing (e.g. UpnpNotify), and HTTP functions (e.g. UpnpDownloadXmlDoc).

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_SOCKET_BIND-203.html000066400000000000000000000015721303304015100241760ustar00rootroot00000000000000 UPNP_E_SOCKET_BIND [-203]

UPNP_E_SOCKET_BIND [-203]

UPNP_E_SOCKET_BIND signifies that the SDK had a problem binding a socket to a network interface. This occurs in any function that makes network connections, such as discovery (e.g. UpnpSearchAsync or UpnpSendAdvertisement), control (e.g. UpnpSendAction), eventing (e.g. UpnpNotify), and HTTP functions (e.g. UpnpDownloadXmlDoc).

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_SOCKET_CONNECT-204.html000066400000000000000000000015671303304015100245600ustar00rootroot00000000000000 UPNP_E_SOCKET_CONNECT [-204]

UPNP_E_SOCKET_CONNECT [-204]

UPNP_E_SOCKET_CONNECT signifies that the SDK had a problem connecting to a remote host. This occurs in any function that makes network connections, such as discovery (e.g. UpnpSearchAsync or UpnpSendAdvertisement), control (e.g. UpnpSendAction), eventing (e.g. UpnpNotify), and HTTP functions (e.g. UpnpDownloadXmlDoc).

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_SOCKET_ERROR-208.html000066400000000000000000000012771303304015100243620ustar00rootroot00000000000000 UPNP_E_SOCKET_ERROR [-208]

UPNP_E_SOCKET_ERROR [-208]

UPNP_E_SOCKET_ERROR is the generic socket error code for conditions not covered by other error codes. This error can be returned by any function that performs network operations.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_SOCKET_READ-202.html000066400000000000000000000015251303304015100241720ustar00rootroot00000000000000 UPNP_E_SOCKET_READ [-202]

UPNP_E_SOCKET_READ [-202]

UPNP_E_SOCKET_READ signifies an error reading from a socket. This occurs in any function that makes network connections, such as discovery (e.g. UpnpSearchAsync or UpnpSendAdvertisement), control (e.g. UpnpSendAction), eventing (e.g. UpnpNotify), and HTTP functions (e.g. UpnpDownloadXmlDoc).

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_SOCKET_WRITE-201.html000066400000000000000000000015261303304015100243510ustar00rootroot00000000000000 UPNP_E_SOCKET_WRITE [-201]

UPNP_E_SOCKET_WRITE [-201]

UPNP_E_SOCKET_WRITE signifies an error writing to a socket. This occurs in any function that makes network connections, such as discovery (e.g. UpnpSearchAsync or UpnpSendAdvertisement), control (e.g. UpnpSendAction), eventing (e.g. UpnpNotify), and HTTP functions (e.g. UpnpDownloadXmlDoc).

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_SUBSCRIBE_UNACCEPTED-301.html000066400000000000000000000012021303304015100254130ustar00rootroot00000000000000 UPNP_E_SUBSCRIBE_UNACCEPTED [-301]

UPNP_E_SUBSCRIBE_UNACCEPTED [-301]

UPNP_E_SUBSCRIBE_UNACCEPTED signifies that a subscription request was rejected from the remote side.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_SUCCESS0.html000066400000000000000000000014331303304015100232740ustar00rootroot00000000000000 UPNP_E_SUCCESS [0]

UPNP_E_SUCCESS [0]

UPNP_E_SUCCESS signifies that the operation completed successfully. For asynchronous functions, this only means that the packet generated by the operation was successfully transmitted on the network. The result of the entire operation comes as part of the callback for that operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_TIMEDOUT-207.html000066400000000000000000000013171303304015100236450ustar00rootroot00000000000000 UPNP_E_TIMEDOUT [-207]

UPNP_E_TIMEDOUT [-207]

UPNP_E_TIMEDOUT signifies that too much time elapsed before the required number of bytes were sent or received over a socket. This error can be returned by any function that performs network operations.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_E_UNSUBSCRIBE_UNACCEPTED-302.html000066400000000000000000000012061303304015100256630ustar00rootroot00000000000000 UPNP_E_UNSUBSCRIBE_UNACCAPTED [-302]

UPNP_E_UNSUBSCRIBE_UNACCAPTED [-302]

UPNP_E_UNSUBSCRIBE_UNACCEPTED signifies that an unsubscribe request was rejected from the remote side.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_S_ALL.html000066400000000000000000000012011303304015100225230ustar00rootroot00000000000000 UPNP_S_ALL

UPNP_S_ALL

Search for all devices and services on the network.

Documentation

Search for all devices and services on the network.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_S_DEVICE.html000066400000000000000000000012511303304015100230570ustar00rootroot00000000000000 UPNP_S_DEVICE

UPNP_S_DEVICE

Search for a particular device type or a particular device instance.

Documentation

Search for a particular device type or a particular device instance.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_S_ROOT.html000066400000000000000000000011631303304015100227050ustar00rootroot00000000000000 UPNP_S_ROOT

UPNP_S_ROOT

Search for all root devices on the network.

Documentation

Search for all root devices on the network.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPNP_S_SERVICE.html000066400000000000000000000013401303304015100232170ustar00rootroot00000000000000 UPNP_S_SERVICE

UPNP_S_SERVICE

Search for a particular service type, possibly on a particular device type or device instance.

Documentation

Search for a particular service type, possibly on a particular device type or device instance.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UPnP_EventType.html000066400000000000000000000103231303304015100236210ustar00rootroot00000000000000 enum UPnP_EventType

enum UPnP_EventType

The reason code for an event callback.
The Event parameter will be different depending on the reason for the callback. The descriptions for each event type describe the contents of the Event parameter.
o UPNP_CONTROL_ACTION_REQUEST
Received by a device when a control point issues a control request.
o UPNP_CONTROL_ACTION_COMPLETE
A UpnpSendActionAsync call completed.
o UPNP_CONTROL_GET_VAR_REQUEST
Received by a device when a query for a single service variable arrives.
o UPNP_CONTROL_GET_VAR_COMPLETE
A UpnpGetServiceVarStatus call completed.
o UPNP_DISCOVERY_ADVERTISEMENT_ALIVE
Received by a control point when a new device or service is available.
o UPNP_DISCOVERY_ADVERTISEMENT_BYEBYE
Received by a control point when a device or service shuts down.
o UPNP_DISCOVERY_SEARCH_RESULT
Received by a control point when a matching device or service responds.
o UPNP_DISCOVERY_SEARCH_TIMEOUT
Received by a control point when the search timeout expires.
o UPNP_EVENT_SUBSCRIPTION_REQUEST
Received by a device when a subscription arrives.
o UPNP_EVENT_RECEIVED
Received by a control point when an event arrives.
o UPNP_EVENT_RENEWAL_COMPLETE
A UpnpRenewSubscriptionAsync call completed.
o UPNP_EVENT_SUBSCRIBE_COMPLETE
A UpnpSubscribeAsync call completed.
o UPNP_EVENT_UNSUBSCRIBE_COMPLETE
A UpnpUnSubscribeAsync call completed.
o UPNP_EVENT_AUTORENEWAL_FAILED
The auto-renewal of a client subscription failed.
o UPNP_EVENT_SUBSCRIPTION_EXPIRED
A client subscription has expired.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpAcceptSubscription.html000066400000000000000000000051361303304015100254510ustar00rootroot00000000000000 EXPORT_SPEC int UpnpAcceptSubscription

EXPORT_SPEC int UpnpAcceptSubscription

( IN UpnpDevice_Handle Hnd,
  IN const char* DevID,
  IN const char* ServID,
  IN const char** VarName,
  IN const char** NewVal,
  IN int cVariables,
  IN Upnp_SID SubsId )

UpnpAcceptSubscription accepts a subscription request and sends out the current state of the eventable variables for a service.

Documentation

UpnpAcceptSubscription accepts a subscription request and sends out the current state of the eventable variables for a service. The device application should call this function when it receives a UPNP_EVENT_SUBSCRIPTION_REQUEST callback. This function is synchronous and generates no callbacks.

UpnpAcceptSubscription can be called during the execution of a callback function.

Parameters:
Hnd - The handle of the device.
DevID - The device ID of the subdevice of the service generating the event.
ServID - The unique service identifier of the service generating the event.
VarName - Pointer to an array of event variables.
NewVal - Pointer to an array of values for the event variables.
cVariables - The number of event variables in VarName.
SubsId - The subscription ID of the newly registered control point.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid device handle.
  • UPNP_E_INVALID_SERVICE: The DevId/ServId pair refers to an invalid service.
  • UPNP_E_INVALID_SID: The specified subscription ID is not valid.
  • UPNP_E_INVALID_PARAM: Either VarName, NewVal, DevID, or ServID is not a valid pointer or cVariables is less than zero.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpAcceptSubscriptionExt.html000066400000000000000000000047251303304015100261350ustar00rootroot00000000000000 EXPORT_SPEC int UpnpAcceptSubscriptionExt

EXPORT_SPEC int UpnpAcceptSubscriptionExt

( IN UpnpDevice_Handle Hnd,
  IN const char* DevID,
  IN const char* ServID,
  IN IXML_Document* PropSet,
  IN Upnp_SID SubsId )

UpnpAcceptSubscriptionExt is similar to UpnpAcceptSubscription except that it takes a DOM document for the variables to event rather than an array of strings.

Documentation

UpnpAcceptSubscriptionExt is similar to UpnpAcceptSubscription except that it takes a DOM document for the variables to event rather than an array of strings. This function is sychronous and generates no callbacks.

UpnpAcceptSubscriptionExt can be called during the execution of a callback function.

Parameters:
Hnd - The handle of the device.
DevID - The device ID of the subdevice of the service generating the event.
ServID - The unique service identifier of the service generating the event.
PropSet - The DOM document for the property set. Property set documents must conform to the XML schema defined in section 4.3 of the Universal Plug and Play Device Architecture specification.
SubsId - The subscription ID of the newly registered control point.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid device handle.
  • UPNP_E_INVALID_SERVICE: The DevId/ServId pair refers to an invalid service.
  • UPNP_E_INVALID_SID: The specified subscription ID is not valid.
  • UPNP_E_INVALID_PARAM: Either VarName, NewVal, DevID, ServID, or PropSet is not a valid pointer.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpAddToAction.html000066400000000000000000000037311303304015100237750ustar00rootroot00000000000000 EXPORT_SPEC int UpnpAddToAction

EXPORT_SPEC int UpnpAddToAction

( IN OUT IXML_Document** ActionDoc,
  IN const char* ActionName,
  IN const char* ServType,
  IN const char* ArgName,
  IN const char* ArgVal )

UpnpAddToAction creates an action request packet based on its input parameters (status variable name and value pair).

Documentation

UpnpAddToAction creates an action request packet based on its input parameters (status variable name and value pair). This API is specially suitable inside a loop to add any number input parameters into an existing action. If no action document exists in the beginning then a Upnp_Document variable initialized with NULL should be passed as a parameter.

Parameters:
ActionDoc - A pointer to store the action document node.
- ActionName The action name.
ServType - The service type.
ArgName - The status variable name.
ArgVal - The status variable value.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: One or more of the parameters are invalid.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpAddToActionResponse.html000066400000000000000000000040331303304015100255100ustar00rootroot00000000000000 EXPORT_SPEC int UpnpAddToActionResponse

EXPORT_SPEC int UpnpAddToActionResponse

( IN OUT IXML_Document** ActionResponse,
  IN const char* ActionName,
  IN const char* ServType,
  IN const char* ArgName,
  IN const char* ArgVal )

UpnpAddToActionResponse creates an action response packet based on its output parameters (status variable name and value pair).

Documentation

UpnpAddToActionResponse creates an action response packet based on its output parameters (status variable name and value pair). This API is especially suitable inside a loop to add any number of input parameters into an existing action response. If no action document exists in the beginning, a Upnp_Document variable initialized with NULL should be passed as a parameter.

Parameters:
ActionResponse - Pointer to a document to store the action document node.
- ActionName The action name.
ServType - The service type.
ArgName - The status variable name.
ArgVal - The status variable value.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: One or more of the parameters are invalid.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpAddToPropertySet.html000066400000000000000000000033421303304015100250560ustar00rootroot00000000000000 EXPORT_SPEC int UpnpAddToPropertySet

EXPORT_SPEC int UpnpAddToPropertySet

( IN OUT IXML_Document** PropSet,
  IN const char* ArgName,
  IN const char* ArgVal )

UpnpAddToPropertySet can be used when an application needs to transfer the status of many variables at once.

Documentation

UpnpAddToPropertySet can be used when an application needs to transfer the status of many variables at once. It can be used (inside a loop) to add some extra status variables into an existing property set. If the application does not already have a property set document, the application should create a variable initialized with NULL and pass that as the first parameter.

Parameters:
PropSet - A pointer to the document containing the property set document node.
ArgName - The status variable name.
ArgVal - The status variable value.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: One or more of the parameters are invalid.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpAddVirtualDir.html000066400000000000000000000023361303304015100243420ustar00rootroot00000000000000 EXPORT_SPEC int UpnpAddVirtualDir

EXPORT_SPEC int UpnpAddVirtualDir

( IN const char* dirName )

UpnpAddVirtualDir adds a virtual directory mapping.

Documentation

UpnpAddVirtualDir adds a virtual directory mapping.

All webserver requests containing the given directory are read using functions contained in a UpnpVirtualDirCallbacks structure registered via UpnpSetVirtualDirCallbacks.

Parameters:
dirName - The name of the new directory mapping to add.
Returns:
[int] An integer representing one of the following:
  • UPPN_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_ARGUMENT: dirName is not valid.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpCancelHttpGet.html000066400000000000000000000017441303304015100243330ustar00rootroot00000000000000 EXPORT_SPEC int UpnpCancelHttpGet

EXPORT_SPEC int UpnpCancelHttpGet

(IN void* handle)

UpnpCancelHttpGet set the cancel flag of the handle parameter.

Documentation

UpnpCancelHttpGet set the cancel flag of the handle parameter.

Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: handle is not a valid pointer.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpClient_Handle.html000066400000000000000000000014751303304015100243400ustar00rootroot00000000000000 typedef int UpnpClient_Handle

typedef int UpnpClient_Handle

Returned when a control point application registers with UpnpRegisterClient.

Documentation

Returned when a control point application registers with UpnpRegisterClient. Client handles can only be used with functions that operate with a client handle.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpCloseHttpGet.html000066400000000000000000000020551303304015100242070ustar00rootroot00000000000000 EXPORT_SPEC int UpnpCloseHttpGet

EXPORT_SPEC int UpnpCloseHttpGet

(IN void* handle)

UpnpCloseHttpGet closes the connection and frees memory that was allocated for the handle parameter.

Documentation

UpnpCloseHttpGet closes the connection and frees memory that was allocated for the handle parameter.

Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: handle is not a valid pointer.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpCloseHttpPost.html000066400000000000000000000035151303304015100244170ustar00rootroot00000000000000 EXPORT_SPEC int UpnpCloseHttpPost

EXPORT_SPEC int UpnpCloseHttpPost

( IN void* handle,
  IN OUT int* httpStatus,
  IN int timeout )

UpnpCloseHttpPost sends and receives any pending data, closes the connection with the server, and frees memory allocated during the UpnpOpenHttpPost call.

Documentation

UpnpCloseHttpPost sends and receives any pending data, closes the connection with the server, and frees memory allocated during the UpnpOpenHttpPost call.

Parameters:
handle - The handle of the connection to close, created by the call to UpnpOpenHttpPost.
httpStatus - A pointer to a buffer to store the final status of the connection.
timeout - A time out value sent with the request during which a response is expected from the server, failing which, an error is reported.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: Either handle, or httpStatus is not a valid pointer.
  • UPNP_E_SOCKET_READ: An error or timeout occurred reading from a socket.
  • UPNP_E_OUTOF_SOCKET: Too many sockets are currently allocated.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpCreatePropertySet.html000066400000000000000000000023041303304015100252630ustar00rootroot00000000000000 EXPORT_SPEC IXML_Document* UpnpCreatePropertySet

EXPORT_SPEC IXML_Document* UpnpCreatePropertySet

( IN int NumArg,
  IN const char* Arg,
  IN ... )

UpnpCreatePropertySet creates a property set message packet.

Documentation

UpnpCreatePropertySet creates a property set message packet. Any number of input parameters can be passed to this function but every input variable name should have a matching value input argument.

Parameters:
NumArg - The number of argument pairs passed.
Arg - The status variable name and value pair.
Returns:
[IXML_Document*] NULL on failure, or the property-set document node.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpDevice_Handle.html000066400000000000000000000015731303304015100243200ustar00rootroot00000000000000 typedef int UpnpDevice_Handle

typedef int UpnpDevice_Handle

Returned when a device application registers with UpnpRegisterRootDevice or UpnpRegisterRootDevice2.

Documentation

Returned when a device application registers with UpnpRegisterRootDevice or UpnpRegisterRootDevice2. Device handles can only be used with functions that operate with a device handle.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpDownloadUrlItem.html000066400000000000000000000042051303304015100247120ustar00rootroot00000000000000 EXPORT_SPEC int UpnpDownloadUrlItem

EXPORT_SPEC int UpnpDownloadUrlItem

( IN const char* url,
  OUT char** outBuf,
  OUT char* contentType )

UpnpDownloadUrlItem downloads a file specified in a URL.

Documentation

UpnpDownloadUrlItem downloads a file specified in a URL. The SDK allocates the memory for outBuf and the application is responsible for freeing this memory. Note that the item is passed as a single buffer. Large items should not be transferred using this function.

Parameters:
url - URL of an item to download.
outBuf - Buffer to store the downloaded item.
contentType - HTTP header value content type if present. It should be at least LINE_SIZE bytes in size.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: Either url, outBuf or contentType is not a valid pointer.
  • UPNP_E_INVALID_URL: The url is not a valid URL.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to download this file.
  • UPNP_E_NETWORK_ERROR: A network error occurred.
  • UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket.
  • UPNP_E_SOCKET_READ: An error or timeout occurred reading from a socket.
  • UPNP_E_SOCKET_BIND: An error occurred binding a socket.
  • UPNP_E_SOCKET_CONNECT: An error occurred connecting a socket.
  • UPNP_E_OUTOF_SOCKET: Too many sockets are currently allocated.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpDownloadXmlDoc.html000066400000000000000000000040321303304015100245150ustar00rootroot00000000000000 EXPORT_SPEC int UpnpDownloadXmlDoc

EXPORT_SPEC int UpnpDownloadXmlDoc

( IN const char* url,
  OUT IXML_Document** xmlDoc )

UpnpDownloadXmlDoc downloads an XML document specified in a URL.

Documentation

UpnpDownloadXmlDoc downloads an XML document specified in a URL. The SDK parses the document and returns it in the form of a DOM document. The application is responsible for freeing the DOM document.

Parameters:
url - URL of the XML document.
xmlDoc - A pointer in which to store the XML document.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: Either url or xmlDoc is not a valid pointer.
  • UPNP_E_INVALID_DESC: The XML document was not found or it does not contain a valid XML description.
  • UPNP_E_INVALID_URL: The url is not a valid URL.
  • UPNP_E_OUTOF_MEMORY: There are insufficient resources to download the XML document.
  • UPNP_E_NETWORK_ERROR: A network error occurred.
  • UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket.
  • UPNP_E_SOCKET_READ: An error or timeout occurred reading from a socket.
  • UPNP_E_SOCKET_BIND: An error occurred binding a socket.
  • UPNP_E_SOCKET_CONNECT: An error occurred connecting the socket.
  • UPNP_E_OUTOF_SOCKET: Too many sockets are currently allocated.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpEnableWebserver.html000066400000000000000000000021621303304015100247140ustar00rootroot00000000000000 EXPORT_SPEC int UpnpEnableWebserver

EXPORT_SPEC int UpnpEnableWebserver

( IN int enable )

UpnpEnableWebServer enables or disables the webserver.

Documentation

UpnpEnableWebServer enables or disables the webserver. A value of TRUE enables the webserver, FALSE disables it.

Parameters:
enable - TRUE to enable, FALSE to disable.
Returns:
[int] An integer representing one of the following:
  • UPPN_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_ARGUMENT: enable is not valid.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpFinish.html000066400000000000000000000020541303304015100230610ustar00rootroot00000000000000 EXPORT_SPEC int UpnpFinish

EXPORT_SPEC int UpnpFinish

()

Terminates the Linux SDK for UPnP Devices.

Documentation

Terminates the Linux SDK for UPnP Devices. This function must be the last API function called. It should be called only once. Subsequent calls to this API return a UPNP_E_FINISH error code.

Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_FINISH: The SDK is already terminated or it is not initialized.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpGetErrorMessage.html000066400000000000000000000021231303304015100246740ustar00rootroot00000000000000 EXPORT_SPEC const char* UpnpGetErrorMessage

EXPORT_SPEC const char* UpnpGetErrorMessage

( int errorcode )

UpnpGetErrorMessage converts an SDK error code into a string error message suitable for display.

Documentation

UpnpGetErrorMessage converts an SDK error code into a string error message suitable for display. The memory returned from this function should NOT be freed.

Parameters:
errorcode - The SDK error code to convert.
Returns:
[char*] An ASCII text string representation of the error message associated with the error code.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpGetServerIpAddress.html000066400000000000000000000021461303304015100253500ustar00rootroot00000000000000 EXPORT_SPEC char* UpnpGetServerIpAddress

EXPORT_SPEC char* UpnpGetServerIpAddress

(void)

If NULL is used as the IP address in UpnpInit, then this function can be used to retrieve the actual interface address on which device is running.

Documentation

If NULL is used as the IP address in UpnpInit, then this function can be used to retrieve the actual interface address on which device is running. If UpnpInit has not succeeded then NULL is returned.

Returns:
[char*] The IP address on which an internal server is listening for UPnP related requests.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpGetServerPort.html000066400000000000000000000020551303304015100244150ustar00rootroot00000000000000 EXPORT_SPEC unsigned short UpnpGetServerPort

EXPORT_SPEC unsigned short UpnpGetServerPort

(void)

If '0' is used as the port number in UpnpInit, then this function can be used to retrieve the actual port allocated to the SDK.

Documentation

If '0' is used as the port number in UpnpInit, then this function can be used to retrieve the actual port allocated to the SDK. If UpnpInit has not succeeded then 0 is returned.

Returns:
[unsigned short] The port on which an internal server is listening for UPnP related requests.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpGetServiceVarStatus.html000066400000000000000000000044121303304015100255560ustar00rootroot00000000000000 EXPORT_SPEC int UpnpGetServiceVarStatus

EXPORT_SPEC int UpnpGetServiceVarStatus

( IN UpnpClient_Handle Hnd,
  IN const char* ActionURL,
  IN const char* VarName,
  OUT DOMString* StVarVal )

UpnpGetServiceVarStatus queries the state of a state variable of a service on another device.

Documentation

UpnpGetServiceVarStatus queries the state of a state variable of a service on another device. This is a synchronous call. A positive return value indicates a SOAP error code, whereas a negative return code indicates an SDK error code. Note that the use of this function is deprecated by the UPnP Forum.

Parameters:
Hnd - The handle of the control point.
ActionURL - The URL of the service.
VarName - The name of the variable to query.
StVarVal - The pointer to store the value for VarName. The SDK allocates this string and the caller needs to free it using ixmlFreeDOMString.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle.
  • UPNP_E_INVALID_URL: ActionUrl is not a valid URL.
  • UPNP_E_INVALID_DESC: The XML document was not found or it does not contain a valid XML description.
  • UPNP_E_INVALID_PARAM: StVarVal is not a valid pointer or VarName or ActionUrl is NULL.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.
  • UPNP_SOAP_E_INVALID_VAR: The given variable is invalid according to the device.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpGetServiceVarStatusAsync.html000066400000000000000000000040221303304015100265510ustar00rootroot00000000000000 EXPORT_SPEC int UpnpGetServiceVarStatusAsync

EXPORT_SPEC int UpnpGetServiceVarStatusAsync

( IN UpnpClient_Handle Hnd,
  IN const char* ActionURL,
  IN const char* VarName,
  IN Upnp_FunPtr Fun,
  IN const void* Cookie )

UpnpGetServiceVarStatusAsync queries the state of a variable of a service, generating a callback when the operation is complete.

Documentation

UpnpGetServiceVarStatusAsync queries the state of a variable of a service, generating a callback when the operation is complete. Note that the use of this function is deprecated by the UPnP Forum.

Parameters:
Hnd - The handle of the control point.
ActionURL - The URL of the service.
VarName - The name of the variable to query.
Fun - Pointer to a callback function to be invoked when the operation is complete.
Cookie - Pointer to user data to pass to the callback function when invoked.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle.
  • UPNP_E_INVALID_URL: The ActionUrl is not a valid URL.
  • UPNP_E_INVALID_PARAM: VarName, Fun or ActionUrl is not a valid pointer.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpHttpGetProgress.html000066400000000000000000000025241303304015100247470ustar00rootroot00000000000000 EXPORT_SPEC int UpnpHttpGetProgress

EXPORT_SPEC int UpnpHttpGetProgress

( IN void* handle,
  OUT unsigned int* length,
  OUT unsigned int* total )

UpnpHttpGetProgress rettrieve progress information of a http-get transfer.

Documentation

UpnpHttpGetProgress rettrieve progress information of a http-get transfer.

Parameters:
handle - The token created by the call to UpnpOpenHttpGet.
length - The number of bytes received.
total - The content length.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: Either handle, length or total is not a valid pointer.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpInit.html000066400000000000000000000043171303304015100225500ustar00rootroot00000000000000 EXPORT_SPEC int UpnpInit

EXPORT_SPEC int UpnpInit

( IN const char* HostIP,
  IN unsigned short DestPort )

Initializes the Linux SDK for UPnP Devices.

Documentation

Initializes the Linux SDK for UPnP Devices. This function must be called before any other API function can be called. It should be called only once. Subsequent calls to this API return a UPNP_E_INIT error code.

Optionally, the application can specify a host IP address (in the case of a multi-homed configuration) and a port number to use for all UPnP operations. Since a port number can be used only by one process, multiple processes using the SDK must specify different port numbers.

If unspecified, the SDK will use the first adapter's IP address and an arbitrary port.

This call is synchronous.

Parameters:
HostIP - The host IP address to use, in string format, for example "192.168.0.1", or NULL to use the first adapter's IP address.
DestPort - The destination port number to use. 0 will pick an arbitrary free port.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to initialize the SDK.
  • UPNP_E_INIT: The SDK is already initialized.
  • UPNP_E_INIT_FAILED: The SDK initialization failed for an unknown reason.
  • UPNP_E_SOCKET_BIND: An error occurred binding a socket.
  • UPNP_E_LISTEN: An error occurred listening to a socket.
  • UPNP_E_OUTOF_SOCKET: An error ocurred creating a socket.
  • UPNP_E_INTERNAL_ERROR: An internal error ocurred.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpIsWebserverEnabled.html000066400000000000000000000017661303304015100253650ustar00rootroot00000000000000 EXPORT_SPEC int UpnpIsWebserverEnabled

EXPORT_SPEC int UpnpIsWebserverEnabled

()

UpnpIsWebServerEnabled returns TRUE if the webserver is enabled, or FALSE if it is not.

Documentation

UpnpIsWebServerEnabled returns TRUE if the webserver is enabled, or FALSE if it is not.

Returns:
[int] An integer representing one of the following:
  • TRUE: The webserver is enabled.
  • FALSE: The webserver is not enabled

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpMakeAction.html000066400000000000000000000031161303304015100236540ustar00rootroot00000000000000 EXPORT_SPEC IXML_Document* UpnpMakeAction

EXPORT_SPEC IXML_Document* UpnpMakeAction

( IN const char* ActionName,
  IN const char* ServType,
  IN int NumArg,
  IN const char* Arg,
  IN ... )

UpnpMakeAction creates an action request packet based on its input parameters (status variable name and value pair).

Documentation

UpnpMakeAction creates an action request packet based on its input parameters (status variable name and value pair). Any number of input parameters can be passed to this function but every input variable name should have a matching value argument.

Parameters:
- ActionName The action name.
ServType - The service type.
NumArg - Number of argument pairs to be passed.
Arg - Status variable name and value pair.
Returns:
[IXML_Document*] The action node of Upnp_Document type or NULL if the operation failed.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpMakeActionResponse.html000066400000000000000000000031651303304015100253770ustar00rootroot00000000000000 EXPORT_SPEC IXML_Document* UpnpMakeActionResponse

EXPORT_SPEC IXML_Document* UpnpMakeActionResponse

( IN const char* ActionName,
  IN const char* ServType,
  IN int NumArg,
  IN const char* Arg,
  IN ... )

UpnpMakeActionResponse creates an action response packet based on its output parameters (status variable name and value pair).

Documentation

UpnpMakeActionResponse creates an action response packet based on its output parameters (status variable name and value pair). Any number of input parameters can be passed to this function but every output variable name should have a matching value argument.

Parameters:
- ActionName The action name.
ServType - The service type.
NumArg - The number of argument pairs passed.
Arg - The status variable name and value pair.
Returns:
[IXML_Document*] The action node of Upnp_Document type or NULL if the operation failed.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpNotify.html000066400000000000000000000044561303304015100231210ustar00rootroot00000000000000 EXPORT_SPEC int UpnpNotify

EXPORT_SPEC int UpnpNotify

( IN UpnpDevice_Handle,
  IN const char* DevID,
  IN const char* ServID,
  IN const char** VarName,
  IN const char** NewVal,
  IN int cVariables )

UpnpNotify sends out an event change notification to all control points subscribed to a particular service.

Documentation

UpnpNotify sends out an event change notification to all control points subscribed to a particular service. This function is synchronous and generates no callbacks.

UpnpNotify may be called during a callback function to send out a notification.

Parameters:
- UpnpDevice_Handle The handle to the device sending the event.
DevID - The device ID of the subdevice of the service generating the event.
ServID - The unique identifier of the service generating the event.
VarName - Pointer to an array of variables that have changed.
NewVal - Pointer to an array of new values for those variables.
cVariables - The count of variables included in this notification.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid device handle.
  • UPNP_E_INVALID_SERVICE: The DevId/ServId pair refers to an invalid service.
  • UPNP_E_INVALID_PARAM: Either VarName, NewVal, DevID, or ServID is not a valid pointer or cVariables is less than zero.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpNotifyExt.html000066400000000000000000000044271303304015100236000ustar00rootroot00000000000000 EXPORT_SPEC int UpnpNotifyExt

EXPORT_SPEC int UpnpNotifyExt

( IN UpnpDevice_Handle,
  IN const char* DevID,
  IN const char* ServID,
  IN IXML_Document* PropSet )

UpnpNotifyExt is similar to UpnpNotify except that it takes a DOM document for the event rather than an array of strings.

Documentation

UpnpNotifyExt is similar to UpnpNotify except that it takes a DOM document for the event rather than an array of strings. This function is synchronous and generates no callbacks.

UpnpNotifyExt may be called during a callback function to send out a notification.

Parameters:
- UpnpDevice_Handle The handle to the device sending the event.
DevID - The device ID of the subdevice of the service generating the event.
ServID - The unique identifier of the service generating the event.
PropSet - The DOM document for the property set. Property set documents must conform to the XML schema defined in section 4.3 of the Universal Plug and Play Device Architecture specification.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid device handle.
  • UPNP_E_INVALID_SERVICE: The DevId/ServId pair refers to an invalid service.
  • UPNP_E_INVALID_PARAM: Either VarName, NewVal, DevID, ServID, or PropSet is not a valid pointer or cVariables is less than zero.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpOpenHttpGet.html000066400000000000000000000050421303304015100240420ustar00rootroot00000000000000 EXPORT_SPEC int UpnpOpenHttpGet

EXPORT_SPEC int UpnpOpenHttpGet

( IN const char* url,
  IN OUT void** handle,
  IN OUT char** contentType,
  IN OUT int* contentLength,
  IN OUT int* httpStatus,
  IN int timeout )

UpnpOpenHttpGet gets a file specified in a URL.

Documentation

UpnpOpenHttpGet gets a file specified in a URL. The SDK allocates the memory for handle and contentType, the application is responsible for freeing this memory.

Parameters:
url - The URL of an item to get.
handle - A pointer to store the handle for this connection.
contentType - A buffer to store the media type of the item.
contentLength - A pointer to store the length of the item.
httpStatus - The status returned on receiving a response message.
timeout - The time out value sent with the request during which a response is expected from the server, failing which, an error is reported back to the user.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: Either url, handle, contentType, contentLength or httpStatus is not a valid pointer.
  • UPNP_E_INVALID_URL: The url is not a valid URL.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to download this file.
  • UPNP_E_NETWORK_ERROR: A network error occurred.
  • UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket.
  • UPNP_E_SOCKET_READ: An error or timeout occurred reading from a socket.
  • UPNP_E_SOCKET_BIND: An error occurred binding a socket.
  • UPNP_E_SOCKET_CONNECT: An error occurred connecting a socket.
  • UPNP_E_OUTOF_SOCKET: Too many sockets are currently allocated.
  • UPNP_E_BAD_RESPONSE: A bad response was received from the remote server.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpOpenHttpGetEx.html000066400000000000000000000057651303304015100243530ustar00rootroot00000000000000 EXPORT_SPEC int UpnpOpenHttpGetEx

EXPORT_SPEC int UpnpOpenHttpGetEx

( IN const char* url,
  IN OUT void** handle,
  IN OUT char** contentType,
  IN OUT int* contentLength,
  IN OUT int* httpStatus,
  IN int lowRange,
  IN int highRange,
  IN int timeout )

UpnpOpenHttpGetEx gets specified number of bytes from a file specified in the URL.

Documentation

UpnpOpenHttpGetEx gets specified number of bytes from a file specified in the URL. The number of bytes is specified through a low count and a high count which are passed as a range of bytes for the request. The SDK allocates the memory for handle and contentType, the application is responsible for freeing this memory.

Parameters:
url - The URL of the item to get.
handle - A pointer to store the handle for this connection.
contentType - A buffer to store the media type of the item.
contentLength - A buffer to store the length of the item.
httpStatus - The status returned on receiving a response message from the remote server.
lowRange - An integer value representing the low end of a range to retrieve.
highRange - An integer value representing the high end of a range to retrieve.
timeout - A time out value sent with the request during which a response is expected from the server, failing which, an error is reported back to the user.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: Either url, handle, contentType, contentLength or httpStatus is not a valid pointer.
  • UPNP_E_INVALID_URL: The url is not a valid URL.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to download this file.
  • UPNP_E_NETWORK_ERROR: A network error occurred.
  • UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket.
  • UPNP_E_SOCKET_READ: An error or timeout occurred reading from a socket.
  • UPNP_E_SOCKET_BIND: An error occurred binding a socket.
  • UPNP_E_SOCKET_CONNECT: An error occurred connecting a socket.
  • UPNP_E_OUTOF_SOCKET: Too many sockets are currently allocated.
  • UPNP_E_BAD_RESPONSE: A bad response was received from the remote server.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpOpenHttpGetProxy.html000066400000000000000000000053031303304015100251040ustar00rootroot00000000000000 EXPORT_SPEC int UpnpOpenHttpGetProxy

EXPORT_SPEC int UpnpOpenHttpGetProxy

( IN const char* url,
  IN const char* proxy_str,
  IN OUT void** handle,
  IN OUT char** contentType,
  IN OUT int* contentLength,
  IN OUT int* httpStatus,
  IN int timeout )

UpnpOpenHttpGetProxy gets a file specified in a URL through the specified proxy.

Documentation

UpnpOpenHttpGetProxy gets a file specified in a URL through the specified proxy. The SDK allocates the memory for handle and contentType, the application is responsible for freeing this memory.

Parameters:
url - The URL of an item to get.
proxy_str - The URL of the proxy.
handle - A pointer to store the handle for this connection.
contentType - A buffer to store the media type of the item.
contentLength - A pointer to store the length of the item.
httpStatus - The status returned on receiving a response message.
timeout - The time out value sent with the request during which a response is expected from the server, failing which, an error is reported back to the user.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: Either url, handle, contentType, contentLength or httpStatus is not a valid pointer.
  • UPNP_E_INVALID_URL: The url is not a valid URL.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to download this file.
  • UPNP_E_NETWORK_ERROR: A network error occurred.
  • UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket.
  • UPNP_E_SOCKET_READ: An error or timeout occurred reading from a socket.
  • UPNP_E_SOCKET_BIND: An error occurred binding a socket.
  • UPNP_E_SOCKET_CONNECT: An error occurred connecting a socket.
  • UPNP_E_OUTOF_SOCKET: Too many sockets are currently allocated.
  • UPNP_E_BAD_RESPONSE: A bad response was received from the remote server.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpOpenHttpPost.html000066400000000000000000000050431303304015100242510ustar00rootroot00000000000000 EXPORT_SPEC int UpnpOpenHttpPost

EXPORT_SPEC int UpnpOpenHttpPost

( IN const char* url,
  IN OUT void** handle,
  IN const char* contentType,
  IN int contentLength,
  IN int timeout )

UpnpOpenHttpPost makes an HTTP POST request message, opens a connection to the server and sends the POST request to the server if the connection to the server succeeds.

Documentation

UpnpOpenHttpPost makes an HTTP POST request message, opens a connection to the server and sends the POST request to the server if the connection to the server succeeds. The SDK allocates the memory for handle and contentType, the application is responsible for freeing this memory.

Parameters:
url - The URL in which to send the POST request.
handle - A pointer in which to store the handle for this connection. This handle is required for futher operations over this connection.
contentType - A buffer to store the media type of content being sent.
contentLength - The length of the content, in bytes, being posted.
timeout - The time out value sent with the request during which a response is expected from the receiver, failing which, an error is reported.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: Either url, handle or contentType is not a valid pointer.
  • UPNP_E_INVALID_URL: The url is not a valid URL.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to download this file.
  • UPNP_E_SOCKET_ERROR: Error occured allocating a socket and resources or an error occurred binding a socket.
  • UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket.
  • UPNP_E_SOCKET_CONNECT: An error occurred connecting a socket.
  • UPNP_E_OUTOF_SOCKET: Too many sockets are currently allocated.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpReadHttpGet.html000066400000000000000000000036671303304015100240270ustar00rootroot00000000000000 EXPORT_SPEC int UpnpReadHttpGet

EXPORT_SPEC int UpnpReadHttpGet

( IN void* handle,
  IN OUT char* buf,
  IN OUT unsigned int* size,
  IN int timeout )

UpnpReadHttpGet gets specified number of bytes from a file specified in a URL.

Documentation

UpnpReadHttpGet gets specified number of bytes from a file specified in a URL.

Parameters:
handle - The token created by the call to UpnpOpenHttpGet.
buf - The buffer to store the read item.
size - The size of the buffer to be read.
timeout - The time out value sent with the request during which a response is expected from the server, failing which, an error is reported back to the user.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: Either handle, buf or size is not a valid pointer.
  • UPNP_E_BAD_RESPONSE: A bad response was received from the remote server.
  • UPNP_E_BAD_HTTPMSG: Either the request or response was in the incorrect format.
  • UPNP_E_CANCELED: another thread called UpnpCancelHttpGet.
Note: In case of return values, the status code parameter of the passed in handle value may provide additional information on the return value.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpRegisterClient.html000066400000000000000000000034671303304015100245750ustar00rootroot00000000000000 EXPORT_SPEC int UpnpRegisterClient

EXPORT_SPEC int UpnpRegisterClient

( IN Upnp_FunPtr Callback,
  IN const void* Cookie,
  OUT UpnpClient_Handle* Hnd )

UpnpRegisterClient registers a control point application with the SDK.

Documentation

UpnpRegisterClient registers a control point application with the SDK. A control point application cannot make any other API calls until it registers using this function.

UpnpRegisterClient is a synchronous call and generates no callbacks. Callbacks can occur as soon as this function returns.

Parameters:
Callback - Pointer to a function for receiving asynchronous events.
Cookie - Pointer to user data returned with the callback function when invoked.
Hnd - Pointer to a variable to store the new control point handle.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_FINISH: The SDK is already terminated or is not initialized.
  • UPNP_E_INVALID_PARAM: Either Callback or Hnd is not a valid pointer.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to register this control point.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpRegisterRootDevice.html000066400000000000000000000054261303304015100254170ustar00rootroot00000000000000 EXPORT_SPEC int UpnpRegisterRootDevice

EXPORT_SPEC int UpnpRegisterRootDevice

( IN const char* DescUrl,
  IN Upnp_FunPtr Callback,
  IN const void* Cookie,
  OUT UpnpDevice_Handle* Hnd )

UpnpRegisterRootDevice registers a device application with the SDK.

Documentation

UpnpRegisterRootDevice registers a device application with the SDK. A device application cannot make any other API calls until it registers using this function. Device applications can also register as control points (see UpnpRegisterClient to get a control point handle to perform control point functionality).

UpnpRegisterRootDevice is synchronous and does not generate any callbacks. Callbacks can occur as soon as this function returns.

Parameters:
DescUrl - Pointer to a string containing the description URL for this root device instance.
Callback - Pointer to the callback function for receiving asynchronous events.
Cookie - Pointer to user data returned with the callback function when invoked.
Hnd - Pointer to a variable to store the new device handle.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_FINISH: The SDK is already terminated or is not initialized.
  • UPNP_E_INVALID_DESC: The description document was not a valid device description.
  • UPNP_E_INVALID_URL: The URL for the description document is not valid.
  • UPNP_E_INVALID_PARAM: Either Callback or Hnd is not a valid pointer or DescURL is NULL.
  • UPNP_E_NETWORK_ERROR: A network error occurred.
  • UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket.
  • UPNP_E_SOCKET_READ: An error or timeout occurred reading from a socket.
  • UPNP_E_SOCKET_BIND: An error occurred binding a socket.
  • UPNP_E_SOCKET_CONNECT: An error occurred connecting the socket.
  • UPNP_E_OUTOF_SOCKET: Too many sockets are currently allocated.
  • UPNP_E_OUTOF_MEMORY: There are insufficient resources to register this root device.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpRegisterRootDevice2.html000066400000000000000000000127461303304015100255040ustar00rootroot00000000000000 EXPORT_SPEC int UpnpRegisterRootDevice2

EXPORT_SPEC int UpnpRegisterRootDevice2

( IN Upnp_DescType descriptionType,
  IN const char* description,
  IN size_t bufferLen,
  IN int config_baseURL,
  IN Upnp_FunPtr Fun,
  IN const void* Cookie,
  OUT UpnpDevice_Handle* Hnd )

UpnpRegisterRootDevice2 is similar to UpnpRegisterRootDevice, except that it also allows the description document to be specified as a file or a memory buffer.

Documentation

UpnpRegisterRootDevice2 is similar to UpnpRegisterRootDevice, except that it also allows the description document to be specified as a file or a memory buffer. The description can also be configured to have the correct IP and port address.

NOTE: For the configuration to be functional, the internal web server MUST be present. In addition, the web server MUST be activated (using UpnpSetWebServerRootDir) before calling this function. The only condition where the web server can be absent is if the description document is specified as a URL and no configuration is required (i.e. config_baseURL = 0.)

UpnpRegisterRootDevice2 is synchronous and does not generate any callbacks. Callbacks can occur as soon as this function returns.

Examples of using different types of description documents: 

    1) Description specified as a URL:
          descriptionType == UPNPREG_URL_DESC
          description is the URL
          bufferLen = 0 (ignored)
    2) Description specified as a file:
          descriptionType == UPNPREG_FILENAME_DESC
          description is a filename
          bufferLen = 0 (ignored)
    3) Description specified as a memory buffer:
          descriptionType == UPNPREG_BUF_DESC
          description is pointer to a memory buffer
          bufferLen == length of memory buffer
    

Parameters:
descriptionType - The type of the description document.
description - Treated as a URL, file name or memory buffer depending on description type.
bufferLen - The length of memory buffer if passing a description in a buffer, otherwise it is ignored.
config_baseURL - If nonzero, URLBase of description document is configured and the description is served using the internal web server.
Fun - Pointer to the callback function for receiving asynchronous events.
Cookie - Pointer to user data returned with the callback function when invoked.
Hnd - Pointer to a variable to store the new device handle.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_FINISH: The SDK is already terminated or is not initialized.
  • UPNP_E_INVALID_DESC: The description document is not a valid device description.
  • UPNP_E_INVALID_PARAM: Either Callback or Hnd is not a valid pointer or DescURL is NULL.
  • UPNP_E_NETWORK_ERROR: A network error occurred.
  • UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket.
  • UPNP_E_SOCKET_READ: An error or timeout occurred reading from a socket.
  • UPNP_E_SOCKET_BIND: An error occurred binding a socket.
  • UPNP_E_SOCKET_CONNECT: An error occurred connecting the socket.
  • UPNP_E_OUTOF_SOCKET: Too many sockets are currently allocated.
  • UPNP_E_OUTOF_MEMORY: There are insufficient resources to register this root device.
  • UPNP_E_URL_TOO_BIG: Length of the URL is bigger than the internal buffer.
  • UPNP_E_FILE_NOT_FOUND: The description file could not be found.
  • UPNP_E_FILE_READ_ERROR: An error occurred reading the description file.
  • UPNP_E_INVALID_URL: The URL to the description document is invalid.
  • UPNP_E_EXT_NOT_XML: The URL to the description document or file should have a .xml extension.
  • UPNP_E_NO_WEB_SERVER: The internal web server has been compiled out; the SDK cannot configure itself from the description document.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpRemoveAllVirtualDirs.html000066400000000000000000000014731303304015100257240ustar00rootroot00000000000000 EXPORT_SPEC void UpnpRemoveAllVirtualDirs

EXPORT_SPEC void UpnpRemoveAllVirtualDirs

( )

UpnpRemoveAllVirtualDirs removes all virtual directory mappings.

Documentation

UpnpRemoveAllVirtualDirs removes all virtual directory mappings.

Returns:
[void] This function does not return a value.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpRemoveVirtualDir.html000066400000000000000000000022001303304015100250750ustar00rootroot00000000000000 EXPORT_SPEC int UpnpRemoveVirtualDir

EXPORT_SPEC int UpnpRemoveVirtualDir

( IN const char* dirName )

UpnpRemoveVirtualDir removes a virtual directory mapping made with UpnpAddVirtualDir.

Documentation

UpnpRemoveVirtualDir removes a virtual directory mapping made with UpnpAddVirtualDir.

Parameters:
dirName - The name of the virtual directory mapping to remove.
Returns:
[int] An integer representing one of the following:
  • UPPN_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_ARGUMENT: dirName is not valid.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpRenewSubscription.html000066400000000000000000000047211303304015100253310ustar00rootroot00000000000000 EXPORT_SPEC int UpnpRenewSubscription

EXPORT_SPEC int UpnpRenewSubscription

( IN UpnpClient_Handle Hnd,
  INOUT int* TimeOut,
  IN Upnp_SID SubsId )

UpnpRenewSubscription renews a subscription that is about to expire.

Documentation

UpnpRenewSubscription renews a subscription that is about to expire. This function is synchronous.

Parameters:
Hnd - The handle of the control point that is renewing the subscription.
- TimeOut Pointer to a variable containing the requested subscription time. Upon return, it contains the actual renewal time.
SubsId - The ID for the subscription to renew.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle.
  • UPNP_E_INVALID_PARAM: Timeout is not a valid pointer.
  • UPNP_E_INVALID_SID: The SID being passed to this function is not a valid subscription ID.
  • UPNP_E_NETWORK_ERROR: A network error occured.
  • UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket.
  • UPNP_E_SOCKET_READ: An error or timeout occurred reading from a socket.
  • UPNP_E_SOCKET_BIND: An error occurred binding a socket.
  • UPNP_E_SOCKET_CONNECT: An error occurred connecting to PublisherUrl.
  • UPNP_E_OUTOF_SOCKET: An error occurred creating a socket.
  • UPNP_E_BAD_RESPONSE: An error occurred in response from the publisher.
  • UPNP_E_SUBSCRIBE_UNACCEPTED: The publisher refused the subscription renew.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpRenewSubscriptionAsync.html000066400000000000000000000075241303304015100263330ustar00rootroot00000000000000 EXPORT_SPEC int UpnpRenewSubscriptionAsync

EXPORT_SPEC int UpnpRenewSubscriptionAsync

( IN UpnpClient_Handle Hnd,
  IN int TimeOut,
  IN Upnp_SID SubsId,
  IN Upnp_FunPtr Fun,
  IN const void* Cookie )

UpnpRenewSubscriptionAsync renews a subscription that is about to expire, generating a callback when the operation is complete.

Documentation

UpnpRenewSubscriptionAsync renews a subscription that is about to expire, generating a callback when the operation is complete.

Note that many of the error codes for this function are returned in the Upnp_Event_Subscribe structure. In those cases, the function returns UPNP_E_SUCCESS and the appropriate error code will be in the Upnp_Event_Subscribe.ErrCode field in the Event structure passed to the callback.

Parameters:
Hnd - The handle of the control point that is renewing the subscription.
- TimeOut The requested subscription time. The actual timeout value is returned when the callback function is called.
SubsId - The ID for the subscription to renew.
Fun - Pointer to a callback function to be invoked when the renewal is complete.
Cookie - Pointer to user data passed to the callback function when invoked.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle.
  • UPNP_E_INVALID_SID: The SubsId is not a valid subscription ID.
  • UPNP_E_INVALID_PARAM: Either Fun is not a valid callback function pointer or Timeout is less than zero but is not UPNP_INFINITE.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.
  • UPNP_E_NETWORK_ERROR: A network error occured (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_SOCKET_READ: An error or timeout occurred reading from a socket (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_SOCKET_BIND: An error occurred binding the socket (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_SOCKET_CONNECT: An error occurred connecting to PublisherUrl (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_OUTOF_SOCKET: An error occurred creating socket ( returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_BAD_RESPONSE: An error occurred in response from the publisher (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_SUBSCRIBE_UNACCEPTED: The publisher refused the subscription request (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpResolveURL.html000066400000000000000000000031431303304015100236430ustar00rootroot00000000000000 EXPORT_SPEC int UpnpResolveURL

EXPORT_SPEC int UpnpResolveURL

( IN const char* BaseURL,
  IN const char* RelURL,
  OUT char* AbsURL )

UpnpResolveURL combines a base URL and a relative URL into a single absolute URL.

Documentation

UpnpResolveURL combines a base URL and a relative URL into a single absolute URL. The memory for AbsURL needs to be allocated by the caller and must be large enough to hold the BaseURL and RelURL combined.

Parameters:
BaseURL - The base URL to combine.
RelURL - The relative URL to BaseURL.
AbsURL - A pointer to a buffer to store the absolute URL.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: RelURL is NULL.
  • UPNP_E_INVALID_URL: The BaseURL / RelURL combination does not form a valid URL.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpSearchAsync.html000066400000000000000000000044201303304015100240430ustar00rootroot00000000000000 EXPORT_SPEC int UpnpSearchAsync

EXPORT_SPEC int UpnpSearchAsync

( IN UpnpClient_Handle Hnd,
  IN int Mx,
  IN const char* Target,
  IN const void* Cookie )

UpnpSearchAsync searches for devices matching the given search target.

Documentation

UpnpSearchAsync searches for devices matching the given search target. The function returns immediately and the SDK calls the default callback function, registered during the UpnpRegisterClient call, for each matching root device, device, or service. The application specifies the search type by the Target parameter.

Note that there is no way for the SDK to distinguish which client instance issued a particular search. Therefore, the client can get search callbacks that do not match the original criteria of the search. Also, the application will receive multiple callbacks for each search.

Parameters:
Hnd - The handle of the client performing the search.
Mx - The time, in seconds, to wait for responses. If the time is greater than MAX_SEARCH_TIME then the time is set to MAX_SEARCH_TIME. If the time is less than MIN_SEARCH_TIME then the time is set to MIN_SEARCH_TIME.
Target - The search target as defined in the UPnP Device Architecture v1.0 specification.
Cookie - The user data to pass when the callback function is invoked.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle.
  • UPNP_E_INVALID_PARAM: Target is NULL.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpSendAction.html000066400000000000000000000051561303304015100236760ustar00rootroot00000000000000 EXPORT_SPEC int UpnpSendAction

EXPORT_SPEC int UpnpSendAction

( IN UpnpClient_Handle Hnd,
  IN const char* ActionURL,
  IN const char* ServiceType,
  IN const char* DevUDN,
  IN IXML_Document* Action,
  OUT IXML_Document** RespNode )

UpnpSendAction sends a message to change a state variable in a service.

Documentation

UpnpSendAction sends a message to change a state variable in a service. This is a synchronous call that does not return until the action is complete.

Note that a positive return value indicates a SOAP-protocol error code. In this case, the error description can be retrieved from RespNode. A negative return value indicates an SDK error.

Parameters:
Hnd - The handle of the control point sending the action.
ActionURL - The action URL of the service.
- ServiceType The type of the service.
- DevUDN This parameter is ignored and must be NULL.
Action - The DOM document for the action.
RespNode - The DOM document for the response to the action. The SDK allocates this document and the caller needs to free it.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle.
  • UPNP_E_INVALID_URL: ActionUrl is not a valid URL.
  • UPNP_E_INVALID_ACTION: This action is not valid.
  • UPNP_E_INVALID_DEVICE: DevUDN is not a valid device.
  • UPNP_E_INVALID_PARAM: ServiceType, Action, ActionUrl, or RespNode is not a valid pointer.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpSendActionAsync.html000066400000000000000000000054161303304015100246730ustar00rootroot00000000000000 EXPORT_SPEC int UpnpSendActionAsync

EXPORT_SPEC int UpnpSendActionAsync

( IN UpnpClient_Handle Hnd,
  IN const char* ActionURL,
  IN const char* ServiceType,
  IN const char* DevUDN,
  IN IXML_Document* Action,
  IN Upnp_FunPtr Fun,
  IN const void* Cookie )

UpnpSendActionAsync sends a message to change a state variable in a service, generating a callback when the operation is complete.

Documentation

UpnpSendActionAsync sends a message to change a state variable in a service, generating a callback when the operation is complete. See UpnpSendAction for comments on positive return values. These positive return values are sent in the event struct associated with the UPNP_CONTROL_ACTION_COMPLETE event.

Parameters:
Hnd - The handle of the control point sending the action.
ActionURL - The action URL of the service.
- ServiceType The type of the service.
- DevUDN This parameter is ignored and must be NULL.
Action - The DOM document for the action to perform on this device.
Fun - Pointer to a callback function to be invoked when the operation completes.
Cookie - Pointer to user data that to be passed to the callback when invoked.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle.
  • UPNP_E_INVALID_URL: ActionUrl is an invalid URL.
  • UPNP_E_INVALID_DEVICE: DevUDN is an invalid device.
  • UPNP_E_INVALID_PARAM: Either Fun is not a valid callback function or ServiceType, Act, or ActionUrl is NULL.
  • UPNP_E_INVALID_ACTION: This action is not valid.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpSendActionEx.html000066400000000000000000000054231303304015100241700ustar00rootroot00000000000000 EXPORT_SPEC int UpnpSendActionEx

EXPORT_SPEC int UpnpSendActionEx

( IN UpnpClient_Handle Hnd,
  IN const char* ActionURL,
  IN const char* ServiceType,
  IN const char* DevUDN,
  IN IXML_Document* Header,
  IN IXML_Document* Action,
  OUT IXML_Document** RespNode )

UpnpSendActionEx sends a message to change a state variable in a service.

Documentation

UpnpSendActionEx sends a message to change a state variable in a service. This is a synchronous call that does not return until the action is complete.

Note that a positive return value indicates a SOAP-protocol error code. In this case, the error description can be retrieved from RespNode. A negative return value indicates an SDK error.

Parameters:
Hnd - The handle of the control point sending the action.
ActionURL - The action URL of the service.
- ServiceType The type of the service.
- DevUDN This parameter is ignored and must be NULL.
Header - The DOM document for the SOAP header. This may be NULL if the header is not required.
Action - The DOM document for the action.
RespNode - The DOM document for the response to the action. The SDK allocates this document and the caller needs to free it.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle.
  • UPNP_E_INVALID_URL: ActionUrl is not a valid URL.
  • UPNP_E_INVALID_ACTION: This action is not valid.
  • UPNP_E_INVALID_DEVICE: DevUDN is not a valid device.
  • UPNP_E_INVALID_PARAM: ServiceType, Action, ActionUrl, or RespNode is not a valid pointer.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpSendActionExAsync.html000066400000000000000000000056631303304015100251740ustar00rootroot00000000000000 EXPORT_SPEC int UpnpSendActionExAsync

EXPORT_SPEC int UpnpSendActionExAsync

( IN UpnpClient_Handle Hnd,
  IN const char* ActionURL,
  IN const char* ServiceType,
  IN const char* DevUDN,
  IN IXML_Document* Header,
  IN IXML_Document* Action,
  IN Upnp_FunPtr Fun,
  IN const void* Cookie )

UpnpSendActionExAsync sends a message to change a state variable in a service, generating a callback when the operation is complete.

Documentation

UpnpSendActionExAsync sends a message to change a state variable in a service, generating a callback when the operation is complete. See UpnpSendAction for comments on positive return values. These positive return values are sent in the event struct associated with the UPNP_CONTROL_ACTION_COMPLETE event.

Parameters:
Hnd - The handle of the control point sending the action.
ActionURL - The action URL of the service.
- ServiceType The type of the service.
- DevUDN This parameter is ignored and must be NULL.
Header - The DOM document for the SOAP header. This may be NULL if the header is not required.
Action - The DOM document for the action to perform on this device.
Fun - Pointer to a callback function to be invoked when the operation completes.
Cookie - Pointer to user data that to be passed to the callback when invoked.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle.
  • UPNP_E_INVALID_URL: ActionUrl is an invalid URL.
  • UPNP_E_INVALID_DEVICE: DevUDN is an invalid device.
  • UPNP_E_INVALID_PARAM: Either Fun is not a valid callback function or ServiceType, Act, or ActionUrl is NULL.
  • UPNP_E_INVALID_ACTION: This action is not valid.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpSendAdvertisement.html000066400000000000000000000030061303304015100252630ustar00rootroot00000000000000 EXPORT_SPEC int UpnpSendAdvertisement

EXPORT_SPEC int UpnpSendAdvertisement

( IN UpnpDevice_Handle Hnd,
  IN int Exp )

UpnpSendAdvertisement sends out the discovery announcements for all devices and services for a device.

Documentation

UpnpSendAdvertisement sends out the discovery announcements for all devices and services for a device. Each announcement is made with the same expiration time.

UpnpSendAdvertisement is a synchronous call.

Parameters:
Hnd - The device handle for which to send out the announcements.
Exp - The expiration age, in seconds, of the announcements.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid device handle.
  • UPNP_E_OUTOF_MEMORY: There are insufficient resources to send future advertisements.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpSetContentLength.html000066400000000000000000000017111303304015100250700ustar00rootroot00000000000000 EXPORT_SPEC int UpnpSetContentLength

EXPORT_SPEC int UpnpSetContentLength

( IN UpnpClient_Handle Hnd,
  IN int contentLength )

OBSOLETE METHOD : use UpnpSetMaxContentLength instead.

Documentation

OBSOLETE METHOD : use UpnpSetMaxContentLength instead. Warning: the Handle argument provided here is not used, so the effect of this function is global to the SDK (= same as UpnpSetMaxContentLength ).

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpSetMaxContentLength.html000066400000000000000000000025531303304015100255430ustar00rootroot00000000000000 EXPORT_SPEC int UpnpSetMaxContentLength

EXPORT_SPEC int UpnpSetMaxContentLength

( IN size_t contentLength )

Sets the maximum content-length that the SDK will process on an incoming SOAP requests or responses.

Documentation

Sets the maximum content-length that the SDK will process on an incoming SOAP requests or responses. This API allows devices that have memory constraints to exhibit consistent behaviour if the size of the incoming SOAP message exceeds the memory that device can allocate. The default maximum content-length is DEFAULT_SOAP_CONTENT_LENGTH = 16K bytes.

Parameters:
contentLength - The maximum permissible content length for incoming SOAP actions, in bytes.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpSetMaxSubscriptionTimeOut.html000066400000000000000000000032211303304015100267530ustar00rootroot00000000000000 EXPORT_SPEC int UpnpSetMaxSubscriptionTimeOut

EXPORT_SPEC int UpnpSetMaxSubscriptionTimeOut

( IN UpnpDevice_Handle Hnd,
  IN int MaxSubscriptionTimeOut )

UpnpSetMaxSubscriptionTimeOut sets the maximum time-out accepted for a subscription request or renewal.

Documentation

UpnpSetMaxSubscriptionTimeOut sets the maximum time-out accepted for a subscription request or renewal. The default value accepts the time-out set by the control point. If a control point requests a subscription time-out less than or equal to the maximum, the SDK grants the value requested by the control point. If the time-out is greater, the SDK returns the maximum value.

Parameters:
Hnd - The handle of the device for which the maximum subscription time-out is being set.
MaxSubscriptionTimeOut - The maximum subscription time-out to be accepted.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid device handle.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpSetMaxSubscriptions.html000066400000000000000000000031341303304015100256320ustar00rootroot00000000000000 EXPORT_SPEC int UpnpSetMaxSubscriptions

EXPORT_SPEC int UpnpSetMaxSubscriptions

( IN UpnpDevice_Handle Hnd,
  IN int MaxSubscriptions )

UpnpSetMaxSubscriptions sets the maximum number of subscriptions accepted per service.

Documentation

UpnpSetMaxSubscriptions sets the maximum number of subscriptions accepted per service. The default value accepts as many as system resources allow. If the number of current subscriptions for a service is greater than the requested value, the SDK accepts no new subscriptions or renewals, however, the SDK does not remove any current subscriptions.

Parameters:
Hnd - The handle of the device for which the maximum number of subscriptions is being set.
MaxSubscriptions - The maximum number of subscriptions to be allowed per service.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid device handle.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpSetVirtualDirCallbacks.html000066400000000000000000000025421303304015100262040ustar00rootroot00000000000000 EXPORT_SPEC int UpnpSetVirtualDirCallbacks

EXPORT_SPEC int UpnpSetVirtualDirCallbacks

( IN struct UpnpVirtualDirCallbacks* callbacks )

UpnpSetVirtualDirCallbacks sets the callback function to be used to access a virtual directory.

Documentation

UpnpSetVirtualDirCallbacks sets the callback function to be used to access a virtual directory. Refer to the description of UpnpVirtualDirCallbacks for a description of the functions.

Parameters:
callbacks - Pointer to a structure containing points to the virtual interface functions.
Returns:
[int] An integer representing one of the following:
  • UPPN_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_ARGUMENT: callbacks is not a valid pointer.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpSetWebServerRootDir.html000066400000000000000000000027311303304015100255260ustar00rootroot00000000000000 EXPORT_SPEC int UpnpSetWebServerRootDir

EXPORT_SPEC int UpnpSetWebServerRootDir

( IN const char* rootDir )

UpnpSetWebServerRootDir sets the document root directory for the internal web server.

Documentation

UpnpSetWebServerRootDir sets the document root directory for the internal web server. This directory is considered the root directory (i.e. "/") of the web server.

This function also activates or deactivates the web server. To disable the web server, pass NULL for rootDir; to activate, pass a valid directory string.

Note that this function is not available when the web server is not compiled into the SDK.

Parameters:
rootDir - Path of the root directory of the web server.
Returns:
[int] An integer representing one of the following:
  • UPPN_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_ARGUMENT: rootDir is an invalid directory.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpSubscribe.html000066400000000000000000000054021303304015100235620ustar00rootroot00000000000000 EXPORT_SPEC int UpnpSubscribe

EXPORT_SPEC int UpnpSubscribe

( IN UpnpClient_Handle Hnd,
  IN const char* PublisherUrl,
  INOUT int* TimeOut,
  OUT Upnp_SID SubsId )

UpnpSubscribe registers a control point to receive event notifications from another device.

Documentation

UpnpSubscribe registers a control point to receive event notifications from another device. This operation is synchronous.

Parameters:
Hnd - The handle of the control point.
- PublisherUrl The URL of the service to subscribe to.
- TimeOut Pointer to a variable containing the requested subscription time. Upon return, it contains the actual subscription time returned from the service.
SubsId - Pointer to a variable to receive the subscription ID (SID).
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle.
  • UPNP_E_INVALID_URL: PublisherUrl is not a valid URL.
  • UPNP_E_INVALID_PARAM: Timeout is not a valid pointer or SubsId or PublisherUrl is NULL.
  • UPNP_E_NETWORK_ERROR: A network error occured.
  • UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket.
  • UPNP_E_SOCKET_READ: An error or timeout occurred reading from a socket.
  • UPNP_E_SOCKET_BIND: An error occurred binding a socket.
  • UPNP_E_SOCKET_CONNECT: An error occurred connecting to PublisherUrl.
  • UPNP_E_OUTOF_SOCKET: An error occurred creating a socket.
  • UPNP_E_BAD_RESPONSE: An error occurred in response from the publisher.
  • UPNP_E_SUBSCRIBE_UNACCEPTED: The publisher refused the subscription request.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpSubscribeAsync.html000066400000000000000000000077311303304015100245670ustar00rootroot00000000000000 EXPORT_SPEC int UpnpSubscribeAsync

EXPORT_SPEC int UpnpSubscribeAsync

( IN UpnpClient_Handle Hnd,
  IN const char* PublisherUrl,
  IN int TimeOut,
  IN Upnp_FunPtr Fun,
  IN const void* Cookie )

UpnpSubscribeAsync performs the same operation as UpnpSubscribe, but returns immediately and calls the registered callback function when the operation is complete.

Documentation

UpnpSubscribeAsync performs the same operation as UpnpSubscribe, but returns immediately and calls the registered callback function when the operation is complete.

Note that many of the error codes for this function are returned in the Upnp_Event_Subscribe structure. In those cases, the function returns UPNP_E_SUCCESS and the appropriate error code will be in the Upnp_Event_Subscribe.ErrCode field in the Event structure passed to the callback.

Parameters:
Hnd - The handle of the control point that is subscribing.
- PublisherUrl The URL of the service to subscribe to.
- TimeOut The requested subscription time. Upon return, it contains the actual subscription time returned from the service.
Fun - Pointer to the callback function for this subscribe request.
Cookie - A user data value passed to the callback function when invoked.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle.
  • UPNP_E_INVALID_URL: The PublisherUrl is not a valid URL.
  • UPNP_E_INVALID_PARAM: Either TimeOut or Fun or PublisherUrl is not a valid pointer.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.
  • UPNP_E_NETWORK_ERROR: A network error occured (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_SOCKET_READ: An error or timeout occurred reading from a socket (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_SOCKET_BIND: An error occurred binding the socket (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_SOCKET_CONNECT: An error occurred connecting to PublisherUrl (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_OUTOF_SOCKET: An error occurred creating the socket (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_BAD_RESPONSE: An error occurred in response from the publisher (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_SUBSCRIBE_UNACCEPTED: The publisher refused the subscription request (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpUnRegisterClient.html000066400000000000000000000026511303304015100250720ustar00rootroot00000000000000 EXPORT_SPEC int UpnpUnRegisterClient

EXPORT_SPEC int UpnpUnRegisterClient

( IN UpnpClient_Handle Hnd )

UpnpUnRegisterClient unregisters a control point application, unsubscribing all active subscriptions.

Documentation

UpnpUnRegisterClient unregisters a control point application, unsubscribing all active subscriptions. After this call, the UpnpClient_Handle is no longer valid.

UpnpUnRegisterClient is a synchronous call and generates no callbacks. The SDK generates no more callbacks after this function returns.

Parameters:
Hnd - The handle of the control point instance to unregister.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpUnRegisterRootDevice.html000066400000000000000000000031341303304015100257140ustar00rootroot00000000000000 EXPORT_SPEC int UpnpUnRegisterRootDevice

EXPORT_SPEC int UpnpUnRegisterRootDevice

( IN UpnpDevice_Handle )

Unregisters a root device registered with UpnpRegisterRootDevice or UpnpRegisterRootDevice2.

Documentation

Unregisters a root device registered with UpnpRegisterRootDevice or UpnpRegisterRootDevice2. After this call, the UpnpDevice_Handle is no longer valid. For all advertisements that have not yet expired, the SDK sends a device unavailable message automatically.

UpnpUnRegisterRootDevice is a synchronous call and generates no callbacks. Once this call returns, the SDK will no longer generate callbacks to the application.

Parameters:
- UpnpDevice_Handle The handle of the root device instance to unregister.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid device handle.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpUnSubscribe.html000066400000000000000000000044741303304015100240750ustar00rootroot00000000000000 EXPORT_SPEC int UpnpUnSubscribe

EXPORT_SPEC int UpnpUnSubscribe

( IN UpnpClient_Handle Hnd,
  IN Upnp_SID SubsId )

UpnpUnSubscribe removes the subscription of a control point from a service previously subscribed to using UpnpSubscribe or UpnpSubscribeAsync.

Documentation

UpnpUnSubscribe removes the subscription of a control point from a service previously subscribed to using UpnpSubscribe or UpnpSubscribeAsync. This is a synchronous call.

Parameters:
Hnd - The handle of the subscribed control point.
SubsId - The ID returned when the control point subscribed to the service.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle.
  • UPNP_E_INVALID_SID: The SubsId is not a valid subscription ID.
  • UPNP_E_NETWORK_ERROR: A network error occured.
  • UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket.
  • UPNP_E_SOCKET_READ: An error or timeout occurred reading from a socket.
  • UPNP_E_SOCKET_BIND: An error occurred binding a socket.
  • UPNP_E_SOCKET_CONNECT: An error occurred connecting to PublisherUrl.
  • UPNP_E_OUTOF_SOCKET: An error ocurred creating a socket.
  • UPNP_E_BAD_RESPONSE: An error occurred in response from the publisher.
  • UPNP_E_UNSUBSCRIBE_UNACCEPTED: The publisher refused the unsubscribe request (the client is still unsubscribed and no longer receives events).
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpUnSubscribeAsync.html000066400000000000000000000072161303304015100250700ustar00rootroot00000000000000 EXPORT_SPEC int UpnpUnSubscribeAsync

EXPORT_SPEC int UpnpUnSubscribeAsync

( IN UpnpClient_Handle Hnd,
  IN Upnp_SID SubsId,
  IN Upnp_FunPtr Fun,
  IN const void* Cookie )

UpnpUnSubscribeAsync removes a subscription of a control point from a service previously subscribed to using UpnpSubscribe or UpnpSubscribeAsync, generating a callback when the operation is complete.

Documentation

UpnpUnSubscribeAsync removes a subscription of a control point from a service previously subscribed to using UpnpSubscribe or UpnpSubscribeAsync, generating a callback when the operation is complete.

Note that many of the error codes for this function are returned in the Upnp_Event_Subscribe structure. In those cases, the function returns UPNP_E_SUCCESS and the appropriate error code will be in the Upnp_Event_Subscribe.ErrCode field in the Event structure passed to the callback.

Parameters:
Hnd - The handle of the subscribed control point.
SubsId - The ID returned when the control point subscribed to the service.
Fun - Pointer to a callback function to be called when the operation is complete.
Cookie - Pointer to user data to pass to the callback function when invoked.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle.
  • UPNP_E_INVALID_SID: The SubsId is not a valid SID.
  • UPNP_E_INVALID_PARAM: Fun is not a valid callback function pointer.
  • UPNP_E_OUTOF_MEMORY: Insufficient resources exist to complete this operation.
  • UPNP_E_NETWORK_ERROR: A network error occured (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_SOCKET_READ: An error or timeout occurred reading from a socket (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_SOCKET_BIND: An error occurred binding the socket (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_SOCKET_CONNECT: An error occurred connecting to PublisherUrl (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_OUTOF_SOCKET: An error occurred creating a socket ( returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_BAD_RESPONSE: An error occurred in response from the publisher (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).
  • UPNP_E_UNSUBSCRIBE_UNACCEPTED: The publisher refused the subscription request (returned in the Upnp_Event_Subscribe.ErrCode field as part of the callback).

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpVirtualDirCallbacks.html000066400000000000000000000153021303304015100255260ustar00rootroot00000000000000 struct UpnpVirtualDirCallbacks

struct UpnpVirtualDirCallbacks

The UpnpVirtualDirCallbacks structure contains the pointers to file-related callback functions a device application can register to virtualize URLs.

[more]int (*close)( IN UpnpWebFileHandle fileHnd )
Called by the web server to close a file opened via the open callback.
[more]int (*get_info)( IN const char* filename, OUT struct File_Info* info )
Called by the web server to query information on a file.
[more]UpnpWebFileHandle (*open)( IN const char* filename, IN enum UpnpOpenFileMode Mode )
Called by the web server to open a file.
[more]int (*read)( IN UpnpWebFileHandle fileHnd, OUT char* buf, IN size_t buflen )
Called by the web server to perform a sequential read from an open file.
[more]int (*seek)( IN UpnpWebFileHandle fileHnd, IN long offset, IN int origin )
Called by the web server to move the file pointer, or offset, into an open file.
[more]int (*write)( IN UpnpWebFileHandle fileHnd, IN char* buf, IN size_t buflen )
Called by the web server to perform a sequential write to an open file.

Documentation

The UpnpVirtualDirCallbacks structure contains the pointers to file-related callback functions a device application can register to virtualize URLs.
oint (*get_info)( IN const char* filename, OUT struct File_Info* info )
Called by the web server to query information on a file. The callback should return 0 on success or -1 on an error.
Parameters:
filename - The name of the file to query.
info - Pointer to a structure to store the information on the file.

oUpnpWebFileHandle (*open)( IN const char* filename, IN enum UpnpOpenFileMode Mode )
Called by the web server to open a file. The callback should return a valid handle if the file can be opened. Otherwise, it should return NULL to signify an error.
Parameters:
filename - The name of the file to open.
Mode - The mode in which to open the file. Valid values are UPNP_READ or UPNP_WRITE.

oint (*read)( IN UpnpWebFileHandle fileHnd, OUT char* buf, IN size_t buflen )
Called by the web server to perform a sequential read from an open file. The callback should copy buflen bytes from the file into the buffer.
Parameters:
fileHnd - The handle of the file to read.
buf - The buffer in which to place the data.
buflen - The size of the buffer (i.e. the number of bytes to read).
Returns:
[int] An integer representing one of the following:
  • 0: The file contains no more data (EOF).
  • >0: A successful read of the number of bytes in the return code.
  • <0: An error occurred reading the file. \end{itemzie}

oint (*write)( IN UpnpWebFileHandle fileHnd, IN char* buf, IN size_t buflen )
Called by the web server to perform a sequential write to an open file. The callback should write buflen bytes into the file from the buffer. It should return the actual number of bytes written, which might be less than buflen in the case of a write error.
Parameters:
fileHnd - The handle of the file to write.
buf - The buffer with the bytes to write.
buflen - The number of bytes to write.

oint (*seek)( IN UpnpWebFileHandle fileHnd, IN long offset, IN int origin )
Called by the web server to move the file pointer, or offset, into an open file. The origin parameter determines where to start moving the file pointer. A value of SEEK_CUR moves the file pointer relative to where it is. The offset parameter can be either positive (move forward) or negative (move backward). SEEK_END moves relative to the end of the file. A positive offset extends the file. A negative offset moves backward in the file. Finally, SEEK_SET moves to an absolute position in the file. In this case, offset must be positive. The callback should return 0 on a successful seek or a non-zero value on an error.
Parameters:
fileHnd - The handle of the file to move the file pointer.
offset - The number of bytes to move in the file. Positive values move foward and negative values move backward. Note that this must be positive if the origin is SEEK_SET.
origin - The position to move relative to. It can be SEEK_CUR to move relative to the current position, SEEK_END to move relative to the end of the file, or SEEK_SET to specify an absolute offset.

oint (*close)( IN UpnpWebFileHandle fileHnd )
Called by the web server to close a file opened via the open callback. It should return 0 on success, or a non-zero value on an error.
Parameters:
fileHnd - The handle of the file to close.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/UpnpWriteHttpPost.html000066400000000000000000000034561303304015100244500ustar00rootroot00000000000000 EXPORT_SPEC int UpnpWriteHttpPost

EXPORT_SPEC int UpnpWriteHttpPost

( IN void* handle,
  IN char* buf,
  IN unsigned int* size,
  IN int timeout )

UpnpWriteHttpPost sends a request to a server to copy the contents of a buffer to the URI specified in the UpnpOpenHttpPost call.

Documentation

UpnpWriteHttpPost sends a request to a server to copy the contents of a buffer to the URI specified in the UpnpOpenHttpPost call.

Parameters:
handle - The handle of the connection created by the call to UpnpOpenHttpPost.
buf - The buffer to be posted.
size - The size, in bytes of buf.
timeout - A timeout value sent with the request during which a response is expected from the server, failing which, an error is reported.
Returns:
[int] An integer representing one of the following:
  • UPNP_E_SUCCESS: The operation completed successfully.
  • UPNP_E_INVALID_PARAM: Either handle, buf or size is not a valid pointer.
  • UPNP_E_SOCKET_WRITE: An error or timeout occurred writing to a socket.
  • UPNP_E_OUTOF_SOCKET: Too many sockets are currently allocated.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Upnp_Action_Request.html000066400000000000000000000103021303304015100247200ustar00rootroot00000000000000 struct Upnp_Action_Request

struct Upnp_Action_Request

Returned as part of a UPNP_CONTROL_ACTION_COMPLETE callback.

[more]char ActionName[NAME_SIZE]
The Action Name.
[more]IXML_Document* ActionRequest
The DOM document describing the action.
[more]IXML_Document* ActionResult
The DOM document describing the result of the action.
[more]struct in_addr CtrlPtIPAddr
IP address of the control point requesting this action.
[more]char DevUDN[NAME_SIZE]
The unique device ID.
[more]int ErrCode
The result of the operation.
[more]char ErrStr[LINE_SIZE]
The error string in case of error.
[more]char ServiceID[NAME_SIZE]
The service ID.
[more]IXML_Document* SoapHeader
The DOM document containing the information from the the SOAP header.
[more]int Socket
The socket number of the connection to the requestor.

Documentation

Returned as part of a UPNP_CONTROL_ACTION_COMPLETE callback.
oint ErrCode
The result of the operation.

oint Socket
The socket number of the connection to the requestor.

ochar ErrStr[LINE_SIZE]
The error string in case of error.

ochar ActionName[NAME_SIZE]
The Action Name.

ochar DevUDN[NAME_SIZE]
The unique device ID.

ochar ServiceID[NAME_SIZE]
The service ID.

oIXML_Document* ActionRequest
The DOM document describing the action.

oIXML_Document* ActionResult
The DOM document describing the result of the action.

ostruct in_addr CtrlPtIPAddr
IP address of the control point requesting this action.

oIXML_Document* SoapHeader
The DOM document containing the information from the the SOAP header.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Upnp_DescType.html000066400000000000000000000025701303304015100235230ustar00rootroot00000000000000 enum Upnp_DescType

enum Upnp_DescType

Specifies the type of description in UpnpRegisterRootDevice2.
These values control how UpnpRegisterRootDevice2 interprets the description parameter.
o UPNPREG_URL_DESC
The description is the URL to the description document.
o UPNPREG_FILENAME_DESC
The description is a file name on the local file system containing the description of the device.
o UPNPREG_BUF_DESC
The description is a pointer to a character array containing the XML description document.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Upnp_Discovery.html000066400000000000000000000107421303304015100237520ustar00rootroot00000000000000 struct Upnp_Discovery

struct Upnp_Discovery

Returned in a UPNP_DISCOVERY_RESULT callback.

[more]char Date[LINE_SIZE]
Date when the response was generated.
[more]SOCKADDRIN* DestAddr
The host address of the device responding to the search.
[more]char DeviceId[LINE_SIZE]
The unique device identifier.
[more]char DeviceType[LINE_SIZE]
The device type.
[more]int ErrCode
The result code of the UpnpSearchAsync call.
[more]int Expires
The expiration time of the advertisement.
[more]char Ext[LINE_SIZE]
Confirmation that the MAN header was understood by the device.
[more]char Location[LINE_SIZE]
The URL to the UPnP description document for the device.
[more]char Os[LINE_SIZE]
The operating system the device is running.
[more]char ServiceType[LINE_SIZE]
The service type.
[more]char ServiceVer[LINE_SIZE]
The service version.

Documentation

Returned in a UPNP_DISCOVERY_RESULT callback.
oint ErrCode
The result code of the UpnpSearchAsync call.

oint Expires
The expiration time of the advertisement.

ochar DeviceId[LINE_SIZE]
The unique device identifier.

ochar DeviceType[LINE_SIZE]
The device type.

ochar ServiceType[LINE_SIZE]
The service type.

ochar ServiceVer[LINE_SIZE]
The service version.

ochar Location[LINE_SIZE]
The URL to the UPnP description document for the device.

ochar Os[LINE_SIZE]
The operating system the device is running.

ochar Date[LINE_SIZE]
Date when the response was generated.

ochar Ext[LINE_SIZE]
Confirmation that the MAN header was understood by the device.

oSOCKADDRIN* DestAddr
The host address of the device responding to the search.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Upnp_Event.html000066400000000000000000000033601303304015100230620ustar00rootroot00000000000000 struct Upnp_Event

struct Upnp_Event

Returned along with a UPNP_EVENT_RECEIVED callback.

[more]IXML_Document* ChangedVariables
The DOM tree representing the changes generating the event.
[more]int EventKey
The event sequence number.
[more]Upnp_SID Sid
The subscription ID for this subscription.

Documentation

Returned along with a UPNP_EVENT_RECEIVED callback.
oUpnp_SID Sid
The subscription ID for this subscription.

oint EventKey
The event sequence number.

oIXML_Document* ChangedVariables
The DOM tree representing the changes generating the event.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Upnp_Event_Subscribe.html000066400000000000000000000046271303304015100250720ustar00rootroot00000000000000 struct Upnp_Event_Subscribe

struct Upnp_Event_Subscribe

Returned along with a UPNP_EVENT_SUBSCRIBE_COMPLETE or UPNP_EVENT_UNSUBSCRIBE_COMPLETE callback.

[more]int ErrCode
The result of the operation.
[more]char PublisherUrl[NAME_SIZE]
The event URL being subscribed to or removed from.
[more]Upnp_SID Sid
The SID for this subscription.
[more]int TimeOut
The actual subscription time (for subscriptions only).

Documentation

Returned along with a UPNP_EVENT_SUBSCRIBE_COMPLETE or UPNP_EVENT_UNSUBSCRIBE_COMPLETE callback.
oUpnp_SID Sid
The SID for this subscription. For subscriptions, this only contains a valid SID if the Upnp_EventSubscribe.result field contains a UPNP_E_SUCCESS result code. For unsubscriptions, this contains the SID from which the subscription is being unsubscribed.

oint ErrCode
The result of the operation.

ochar PublisherUrl[NAME_SIZE]
The event URL being subscribed to or removed from.

oint TimeOut
The actual subscription time (for subscriptions only).

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Upnp_FunPtr.html000066400000000000000000000034611303304015100232210ustar00rootroot00000000000000 typedef int (*Upnp_FunPtr)

typedef int (*Upnp_FunPtr)

( IN Upnp_EventType EventType,
  IN void* Event, IN void* Cookie )

All callback functions share the same prototype, documented below.

Documentation

All callback functions share the same prototype, documented below. Note that any memory passed to the callback function is valid only during the callback and should be copied if it needs to persist. This callback function needs to be thread safe. The context of the callback is always on a valid thread context and standard synchronization methods can be used. Note, however, because of this the callback cannot call SDK functions unless explicitly noted. 

      int CallbackFxn( Upnp_EventType EventType, void* Event, void* Cookie );
    

where EventType is the event that triggered the callback, Event is a structure that denotes event-specific information for that event, and Cookie is the user data passed when the callback was registered.

See Upnp_EventType for more information on the callback values and the associated Event parameter.

The return value of the callback is currently ignored. It may be used in the future to communicate results back to the SDK.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Upnp_SID44.html000066400000000000000000000015451303304015100225730ustar00rootroot00000000000000 typedef char Upnp_SID[44]

typedef char Upnp_SID[44]

The Upnp_SID holds the subscription identifier for a subscription between a client and a device.

Documentation

The Upnp_SID holds the subscription identifier for a subscription between a client and a device. The SID is a string representation of a globally unique id (GUID) and should not be modified.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Upnp_SType.html000066400000000000000000000030751303304015100230500ustar00rootroot00000000000000 enum Upnp_SType

enum Upnp_SType

Represents the different types of searches that can be performed using the SDK for UPnP Devices API.
By specifying these different values to UpnpSearchAsync, the control point application can control the scope of the search from all devices to specific devices or services.
o UPNP_S_ALL
Search for all devices and services on the network.
o UPNP_S_ROOT
Search for all root devices on the network.
o UPNP_S_DEVICE
Search for a particular device type or a particular device instance.
o UPNP_S_SERVICE
Search for a particular service type, possibly on a particular device type or device instance.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Upnp_State_Var_Complete.html000066400000000000000000000042161303304015100255220ustar00rootroot00000000000000 struct Upnp_State_Var_Complete

struct Upnp_State_Var_Complete

Represents the reply for the current value of a state variable in an asynchronous call.

[more]char CtrlUrl[NAME_SIZE]
The control URL for the service.
[more]DOMString CurrentVal
The current value of the variable or error string in case of error.
[more]int ErrCode
The result of the operation.
[more]char StateVarName[NAME_SIZE]
The name of the variable.

Documentation

Represents the reply for the current value of a state variable in an asynchronous call.
oint ErrCode
The result of the operation.

ochar CtrlUrl[NAME_SIZE]
The control URL for the service.

ochar StateVarName[NAME_SIZE]
The name of the variable.

oDOMString CurrentVal
The current value of the variable or error string in case of error.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Upnp_State_Var_Request.html000066400000000000000000000070271303304015100254050ustar00rootroot00000000000000 struct Upnp_State_Var_Request

struct Upnp_State_Var_Request

Represents the request for current value of a state variable in a service state table.

[more]struct in_addr CtrlPtIPAddr
IP address of sender requesting the state variable.
[more]DOMString CurrentVal
The current value of the variable.
[more]char DevUDN[NAME_SIZE]
The unique device ID.
[more]int ErrCode
The result of the operation.
[more]char ErrStr[LINE_SIZE]
The error string in case of error.
[more]char ServiceID[NAME_SIZE]
The service ID.
[more]int Socket
The socket number of the connection to the requestor.
[more]char StateVarName[NAME_SIZE]
The name of the variable.

Documentation

Represents the request for current value of a state variable in a service state table.
oint ErrCode
The result of the operation.

oint Socket
The socket number of the connection to the requestor.

ochar ErrStr[LINE_SIZE]
The error string in case of error.

ochar DevUDN[NAME_SIZE]
The unique device ID.

ochar ServiceID[NAME_SIZE]
The service ID.

ochar StateVarName[NAME_SIZE]
The name of the variable.

ostruct in_addr CtrlPtIPAddr
IP address of sender requesting the state variable.

oDOMString CurrentVal
The current value of the variable. This needs to be allocated by the caller. When finished with it, the SDK frees this DOMString.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/Upnp_Subscription_Request.html000066400000000000000000000033561303304015100262020ustar00rootroot00000000000000 struct Upnp_Subscription_Request

struct Upnp_Subscription_Request

Returned along with a UPNP_EVENT_SUBSCRIPTION_REQUEST callback.

[more]char* ServiceId
The identifier for the service being subscribed to.
[more]Upnp_SID Sid
The assigned subscription ID for this subscription.
[more]char* UDN
Universal device name.

Documentation

Returned along with a UPNP_EVENT_SUBSCRIPTION_REQUEST callback.
ochar* ServiceId
The identifier for the service being subscribed to.

ochar* UDN
Universal device name.

oUpnp_SID Sid
The assigned subscription ID for this subscription.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/WebServerAPI.html000066400000000000000000000042241303304015100232350ustar00rootroot00000000000000 Web Server API

Web Server API

o UpnpSetWebServerRootDir
UpnpSetWebServerRootDir sets the document root directory for the internal web server.
o UpnpSetVirtualDirCallbacks
UpnpSetVirtualDirCallbacks sets the callback function to be used to access a virtual directory.
o UpnpEnableWebserver
UpnpEnableWebServer enables or disables the webserver.
o UpnpIsWebserverEnabled
UpnpIsWebServerEnabled returns TRUE if the webserver is enabled, or FALSE if it is not.
o UpnpAddVirtualDir
UpnpAddVirtualDir adds a virtual directory mapping.
o UpnpRemoveVirtualDir
UpnpRemoveVirtualDir removes a virtual directory mapping made with UpnpAddVirtualDir.
o UpnpRemoveAllVirtualDirs
UpnpRemoveAllVirtualDirs removes all virtual directory mappings.

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/icon1.gif000066400000000000000000000005061303304015100216100ustar00rootroot00000000000000GIF89a{FAkb{{04 $ ZcZJssJJJdbk21!,c@pH,Ā`0p@$Eh8 (08"IRGァ@2YpyCw !"D #$!%E&''!(G ""HDA;pupnp-release-1.8.0/docs/dist/html/upnp/icon2.gif000066400000000000000000000005061303304015100216110ustar00rootroot00000000000000GIF89autYYtUUsdded_^ONjRQnml~ih\[|?>TmlJJe;:O==MvuZYv44G##0WWwHGa('5KJeED]##0(55C--=(eeq**9RR_!,c@pH,Ā`0p@$Eh8 (08"IRGァ@2YpyCw !"D #$!%E&''!(G ""HDA;pupnp-release-1.8.0/docs/dist/html/upnp/index.html000066400000000000000000000024461303304015100221120ustar00rootroot00000000000000 Linux SDK for UPnP Devices v1.4

Linux SDK for UPnP Devices v1.4

Linux SDK for UPnP Devices Version 1.4

Copyright (C) 2000-2003 Intel Corporation ALL RIGHTS RESERVED

Revision 1.4.1 (Tue 04 Jul 2006 04:58:36 PM EEST)

o Introduction
o License
o About Callbacks
o The API
o Optional Tool APIs

Alphabetic index


This page was generated with the help of DOC++. pupnp-release-1.8.0/docs/dist/html/upnp/toc.html000066400000000000000000000006651303304015100215710ustar00rootroot00000000000000 Table of Contents

Table of Contents

General stuff


This page was generated with the help of DOC++. pupnp-release-1.8.0/ixml/000077500000000000000000000000001303304015100152375ustar00rootroot00000000000000pupnp-release-1.8.0/ixml/Makefile.am000066400000000000000000000024571303304015100173030ustar00rootroot00000000000000# $Id: Makefile.am,v 1.4 2006/03/27 21:27:31 r3mi Exp $ # # "Makefile.am" for "libupnp/ixml" # # (C) Copyright 2005 Rémi Turboult # SUBDIRS = doc AM_CPPFLAGS = -I$(srcdir)/inc -I$(srcdir)/src/inc \ -I$(top_srcdir)/upnp/inc AM_CFLAGS = LDADD = libixml-1.8.la if ENABLE_DEBUG AM_CPPFLAGS += -DDEBUG else AM_CPPFLAGS += -DNDEBUG endif if ENABLE_SCRIPTSUPPORT AM_CPPFLAGS += -DIXML_HAVE_SCRIPTSUPPORT endif lib_LTLIBRARIES = libixml-1.8.la libixml_1_8_la_LDFLAGS = -version-info $(LT_VERSION_IXML) \ -export-symbols-regex '^ixml.*' libixml_1_8_la_SOURCES = \ src/attr.c \ src/document.c \ src/element.c \ src/inc/ixmlmembuf.h \ src/inc/ixmlparser.h \ src/ixml.c \ src/ixmldebug.c \ src/ixmlparser.c \ src/ixmlmembuf.c \ src/namedNodeMap.c \ src/node.c \ src/nodeList.c upnpincludedir = $(includedir)/upnp-1.8 upnpinclude_HEADERS = \ inc/ixml.h \ inc/ixmldebug.h check_PROGRAMS = test_document-1.8 TESTS = test/test_document.sh test_document_1_8_SOURCES = test/test_document.c EXTRA_DIST = test/test_document.sh test/testdata dist-hook: rm -rf `find $(distdir)/test/testdata/ -type f \! -name '*ml' -print` clean-local: @if [ -d bin ] ; then rm -rf bin ; fi pupnp-release-1.8.0/ixml/doc/000077500000000000000000000000001303304015100160045ustar00rootroot00000000000000pupnp-release-1.8.0/ixml/doc/Makefile.am000066400000000000000000000044511303304015100200440ustar00rootroot00000000000000# $Id: Makefile.am,v 1.1.1.1 2006/02/18 13:47:30 r3mi Exp $ # # "Makefile.am" for "libunp/ixml/doc" # # (C) Copyright 2005 Rmi Turboult # ########################################################################## # # Copyright (c) 2000-2003 Intel Corporation # All rights reserved. # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # * Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # * Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # * Neither name of Intel Corporation nor the names of its contributors # may be used to endorse or promote products derived from this software # without specific prior written permission. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS # ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR # CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, # EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, # PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR # PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY # OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. # ########################################################################## EXTRA_DIST= docxx.sty intro.dxx ixml.dxx license.dxx html-local: @if [ -d html ]; then rm -rf html; fi @doc++ -nd -S -w -j -d html $(srcdir)/ixml.dxx pdf-local: @doc++ -nd -S -w -j -t --package a4wide -o ixml.tex $(srcdir)/ixml.dxx @-pdflatex "\scrollmode\input ixml.tex" > pdflatex.log @-pdflatex "\scrollmode\input ixml.tex" >> pdflatex.log @-pdflatex "\scrollmode\input ixml.tex" >> pdflatex.log clean-local: -rm -rf html -rm -f ixml.tex pdflatex.log ixml.log ixml.aux pupnp-release-1.8.0/ixml/doc/docxx.sty000066400000000000000000000707411303304015100177030ustar00rootroot00000000000000% docxx.sty % % Copyright (c) 1996 Roland Wunderling, Malte Zoeckler % Copyright (c) 1999-2001 Dragos Acostachioaie % % This file is part of DOC++. % % DOC++ is free software; you can redistribute it and/or % modify it under the terms of the GNU General Public % License as published by the Free Software Foundation; either % version 2 of the license, or (at your option) any later version. % % This program is distributed in the hope that it will be useful, % but WITHOUT ANY WARRANTY; without even the implied warranty of % MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU % General Public License for more details. % % You should have received a copy of the GNU General Public % License along with this program; if not, write to the Free % Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. % % % Switch off special characters except {}\ for the rest of the text. % \def\cxxtilde{{\tt\~\relax}} \addtolength{\parskip}{6pt} \catcode`\,=\active% \def,{\char`\,\penalty-8\ } %\def,{++ } \catcode`\,=12 \def\<{{\tt <}} \def\>{{\tt >}} \def\TEX{} \def\cxxExceptionsStr{} \def\cxxParameterStr{} \def\cxxReturnStr{} \def\cxxInvariantsStr{} \def\cxxPreconditionsStr{} \def\cxxPostconditionsStr{} \def\cxxSeeStr{} \def\cxxAuthorStr{} \def\cxxVersionStr{} \def\cxxDeprecatedStr{} \def\cxxSinceStr{} \def\cxxFileStr{} \def\cxxExceptions#1{\def\cxxExceptionsStr{#1}} \def\cxxParameter#1{\def\cxxParameterStr{#1}} \def\cxxReturn#1{\def\cxxReturnStr{#1}} \def\cxxInvariants#1{\def\cxxInvariantsStr{#1}} \def\cxxPreconditions#1{\def\cxxPreconditionsStr{#1}} \def\cxxPostconditions#1{\def\cxxPostconditionsStr{#1}} \def\cxxSee#1{\def\cxxSeeStr{#1}} \def\cxxAuthor#1{\def\cxxAuthorStr{#1}} \def\cxxVersion#1{\def\cxxVersionStr{#1}} \def\cxxDeprecated#1{\def\cxxDeprecatedStr{#1}} \def\cxxSince#1{\def\cxxSinceStr{#1}} \def\cxxFile#1{\def\cxxFileStr{#1}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Define ... to do verbatim listing % \catcode`\=\active \catcode`\=\active {\obeyspaces\gdef {\ }} \def\ccverbatim{\strut\begingroup \catcode`\\=12 \catcode`\{=12 \catcode`\}=12 \catcode`\$=12 \catcode`\&=12 \catcode`\#=12 \catcode`\%=12 \catcode`\~=12 \catcode`\_=12 \catcode`\^=12 \catcode`\|=12 \catcode`\/=12 \obeyspaces\tt} \def{\let\par=\endgraf \ccverbatim \parskip=0pt \ccfinish} {\catcode`\=0 catcode`\=12 gdefccfinish#1{#1endgroup}} % % Definition of structuring comands. % \newcommand{\Section}[1]{\section{#1}} \newcommand{\SubSection}[1]{\subsection{#1}} \newcommand{\SubSubSection}[1]{\subsubsection{#1}} \newcommand{\Paragraph}[1]{\paragraph{#1}} \newcommand{\Ref}[1]{{\bf #1} ($\rightarrow$ \ref{#1})} \newcommand{\URL}[2][]{% \def\name{#1}% \def\empty{}% \ifx\name\empty% {\tt #2}% \else% #1 ({\tt #2})% \fi% } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % printing line #1 of code #2 % \newdimen\cxxcodewidth \cxxcodewidth=\textwidth \advance\cxxcodewidth by -21pt \def\cxxCodeLine#1#2{% {\hbox to 20pt{\tiny\hss#1}\parbox[t]{\cxxcodewidth}{\small#2}}% } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for listing manual entries % \newdimen\cxxIdWidth \newdimen\cxxTypeWidth \newdimen\cxxProtoWidth \newdimen\cxxMemoWidth \newdimen\cxxPageWidth \cxxIdWidth=0.1\textwidth \cxxTypeWidth=0.15\textwidth \cxxProtoWidth=0.25\textwidth \cxxMemoWidth=0.43\textwidth \cxxPageWidth=\textwidth \advance\cxxPageWidth by-\cxxIdWidth \advance\cxxPageWidth by-\cxxTypeWidth \advance\cxxPageWidth by-\cxxProtoWidth \advance\cxxPageWidth by-\cxxMemoWidth \newdimen\cxxProtoMemoWidth \cxxProtoMemoWidth=\cxxProtoWidth \advance\cxxProtoMemoWidth by\cxxMemoWidth \def\cxxStrut{\vrule width0pt height0pt depth9pt} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % 1: type % 2: name % 3: args % 4: memo % 5: id \def\cxxitem#1#2#3#4#5{\noindent{% \setbox5\hbox{#5 }% \ifdim\wd5>\cxxIdWidth% \setbox5\hbox{\hbox to \cxxIdWidth{\hss#5}}% \else \setbox5\hbox{\hbox to \cxxIdWidth{#5\hss}}% \fi% \setbox1\hbox{{% \catcode`\&=4% \catcode`\_=8% \def{\ccverbatim \ccfinish}#1% }}% \setbox2\hbox{{% \catcode`\&=4% \catcode`\_=8% \def{\ccverbatim \ccfinish}\textbf{#2} #3% }}% \setbox4\hbox{\parbox[t]{\cxxMemoWidth}{{% \raggedright\sloppy% \catcode`\&=4% \catcode`\_=8% \def{\ccverbatim \ccfinish}{\em #4} \cxxStrut% \def\page{#5}% \ifx\page\empty% \hss% \else% \ \dotfill% \hbox to 0pt{\hbox to \cxxPageWidth{\hss% \pageref{cxx.#5}% }\hss}% \fi% }}}% % \ifdim\wd1>\cxxTypeWidth% \hbox to \hsize{\unhbox5\hbox to \cxxTypeWidth{\unhbox1\hss}\hss}\\\nopagebreak% \setbox5\hbox{\hskip\cxxIdWidth}% \setbox1\hbox{\hskip\cxxTypeWidth}% \else% \setbox1\hbox{\hbox to \cxxTypeWidth{\unhbox1\hss}}% \fi% \ifdim\wd2>\cxxProtoWidth% \ifdim\wd2<\cxxProtoMemoWidth% \def\tmp{#4}% \ifx\tmp\empty% \def\tmp{#5}% \ifx\tmp\empty% \hbox to \hsize{\unhbox5\unhbox1\unhbox2\hss\cxxStrut}\\% \else% \hbox to \hsize{\unhbox5\unhbox1\unhbox2 \dotfill\hbox to \cxxPageWidth{\hss\pageref{cxx.#5}}% \cxxStrut}\\% \fi% \else% \hbox to \hsize{\unhbox5\unhbox1\unhbox2\hss}\\\nopagebreak% \hbox to \hsize{% \hskip\cxxIdWidth% \hskip\cxxTypeWidth% \hskip\cxxProtoWidth% \unhbox4\hss% }\\% \fi% \else% \hbox to \hsize{% \unhbox5% \unhbox1% \parbox[t]{\cxxProtoMemoWidth}{% \setbox255\hbox{\textbf{#2} (}% \hangindent=\wd255\hangafter=1% \raggedright\sloppy% {\catcode`\&=4\catcode`\_=8% \def{\ccverbatim \ccfinish}\textbf{#2} #3\strut}% }\hss% }\\\nopagebreak% \hbox to \hsize{% \hskip\cxxIdWidth% \hskip\cxxTypeWidth% \hskip\cxxProtoWidth% \unhbox4\hss% }\\% \fi% \else% \hbox to \hsize{% \unhbox5% \unhbox1% \hbox to \cxxProtoWidth{\unhbox2\hss}% \unhbox4\hss% }\\% \fi% }} \newdimen\cxxtypestart \cxxtypestart=0.05\textwidth %\advance\cxxtypestart by \labelsep \newdimen\cxxnamestart \cxxnamestart=\cxxtypestart \advance\cxxnamestart by 0.25\textwidth \newdimen\cxxargsstart \cxxargsstart=\cxxnamestart \advance\cxxargsstart by 0.2\textwidth \newdimen\cxxargswidth \cxxargswidth=\textwidth \advance\cxxargswidth by -\cxxargsstart \advance\cxxargswidth by -\spaceskip \newdimen\cxxmemostart \cxxmemostart=\cxxargsstart \advance\cxxmemostart by 0.12\textwidth \newenvironment{cxxlist}[1]{ \begingroup \catcode`\,=\active% \paragraph{#1}\strut\smallskip\\ }{ \endgroup } \newenvironment{cxxnames}{\begin{cxxlist}{Names}}{\end{cxxlist}} \newenvironment{cxxpublic}{\begin{cxxlist}{Public Members}}{\end{cxxlist}} \newenvironment{cxxprivate}{\begin{cxxlist}{Private Members}}{\end{cxxlist}} \newenvironment{cxxprotected}{\begin{cxxlist}{Protected Members}}{\end{cxxlist}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Numbered Frame box % \newlength{\cxxBoxLen}% \newlength{\cxxBoxHt}% \newlength{\cxxBoxDp}% \newlength{\cxxSideHt}% \newlength{\cxxSideLen}% \newlength{\cxxTitleLen}% \def\empty{} \def\idPos{1cm} % % box with id and name [optional width] % \newcommand{\aBox}[3][1pt]{{% \small% \def\width{#1}% \def\num{#2}% \def\name{#3}% \setbox0\hbox{\hskip\width{ \strut\name\strut} \hskip\width}% % \setlength{\cxxBoxLen}{\wd0}% \addtolength{\cxxBoxLen}{\width}% \addtolength{\cxxBoxLen}{\width}% \setbox2\hbox{\normalsize\strut\rule{\cxxBoxLen}{\width}}% % \ifx\num\empty% \setbox1\hbox{\strut}% \else% \setbox1\hbox{\rule{\idPos}{\width} { \sf\bf\strut #2 } }% \fi% \addtolength{\cxxBoxLen}{-\wd1}% \setbox1\hbox{\unhbox1\rule{\cxxBoxLen}{\width}}% % \setlength{\cxxSideHt}{\dp0}% \addtolength{\cxxSideHt}{\width}% \setlength{\cxxSideLen}{\dp0}% \addtolength{\cxxSideLen}{\ht0}% \addtolength{\cxxSideLen}{\dp1}% \addtolength{\cxxSideLen}{\width}% \addtolength{\cxxSideLen}{\width}% \setbox3\hbox{\hbox to 0pt{\hss\rule[-\cxxSideHt]{\width}{\cxxSideLen}}}% \setbox4\hbox{\hbox to 0pt{\rule[-\cxxSideHt]{\width}{\cxxSideLen}\hss}}% % \setlength{\cxxBoxHt}{\dp1}% \addtolength{\cxxBoxHt}{1pt}% \setlength{\cxxBoxDp}{\ht2}% \addtolength{\cxxBoxDp}{-\width}% \addtolength{\cxxBoxDp}{1pt}% % \setlength{\cxxBoxLen}{\ht3}% \addtolength{\cxxBoxLen}{\ht1}% % \vbox to \cxxBoxLen{% \hbox{\unhbox1}% \vskip-\cxxBoxHt% \hbox{\hskip\width\unhbox3\unhbox0\unhbox4}% %\vskip-\ht2% \vskip-\cxxBoxDp% \hbox{\unhbox2}% \vss% }% }} % % box with id and name [optional width] of size #4 % \newcommand{\sizeBox}[4][3pt]{{% \setbox0\hbox{ }% \setlength{\cxxSideLen}{#4}% \addtolength{\cxxSideLen}{-\wd0}% \addtolength{\cxxSideLen}{-\wd0}% \addtolength{\cxxSideLen}{-#1}% \addtolength{\cxxSideLen}{-#1}% \addtolength{\cxxSideLen}{-#1}% \addtolength{\cxxSideLen}{-#1}% \aBox[#1]{#2}{\hbox to \cxxSideLen{#3}}% }} % % centered box with id and name [optional width] of size #4 % \newcommand{\cBox}[4][3pt]{{% \setbox0\hbox{\aBox[#1]{#2}{#3}}% \ifdim\wd0<#4% \sizeBox[#1]{#2}{\hss#3\hss}{#4}% \else% \setlength{\cxxSideLen}{\wd0}% \advance\cxxSideLen by -#4% \hskip -0.5\cxxSideLen% \unhbox0% \fi% }} % % right expanding box with id and name [optional width] of size at least #4 % \newcommand{\rBox}[4][3pt]{{% \setbox0\hbox{\aBox[#1]{#2}{#3}\hss}% \ifdim\wd0>#4% \unhbox0% \else% \sizeBox[#1]{#2}{\hss#3\hss}{#4}% \fi% }} % % left expanding box with id and name [optional width] of size at least #4 % \newcommand{\lBox}[4][3pt]{{% \setbox0\hbox{\aBox[#1]{#2}{#3}\hss}% \ifdim\wd0>#4% \setlength{\cxxSideLen}{\wd0}% \advance\cxxSideLen by -#4% \hskip -\cxxSideLen% \unhbox0% \else% \sizeBox[#1]{#2}{\hss#3\hss}{#4}% \fi% }} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Pagestyle for documentation. % \newsavebox{\cxxHeadName} \newcommand{\ps@docxx}{% \renewcommand{\@oddhead}{\headlinetext}% \renewcommand{\@evenhead}{\headlinetext}% \renewcommand{\@oddfoot}{\footlinetext}% \renewcommand{\@evenfoot}{\footlinetext}% } \newcommand{\makeHeadLine}[2]{ \global\sbox{\cxxHeadName}{\vbox to 0pt{\vss% \hbox to \textwidth{% \hbox to 0pt{\strut\hbox to 1cm{\hss}\quad#1\hss}% \hfil#2\hfil% }% \vskip 1pt% \hbox to \textwidth{\hrulefill}% }}% } \newcommand{\headlinetext}{\usebox{\cxxHeadName}} \providecommand{\cxxCopyright}{% \vtop{% \hbox to \textwidth{{ \tiny\sf This page was generated with the help of DOC++ \hss}}% \vskip -20pt \hbox to \textwidth{ \hbox{{\tiny\sf http://docpp.sourceforge.net}} \hss}% }% } \def\footlinetext{\hbox to \textwidth{ \vtop{% \hbox to \textwidth{\hrulefill}% \vskip -20pt% \cxxCopyright% }% \hss\vtop{\vskip 10pt\hbox{\today\hspace*{3cm}\textrm{\thepage} }} }} \pagestyle{docxx} \def\cxxTitle#1#2#3#4#5{\noindent{% \thispagestyle{empty} \vfill \begin{center} \Huge\bf \catcode`\&=4% \catcode`\_=8% \def{\ccverbatim \ccfinish}#1% \strut\\ \def{\ccverbatim \ccfinish}#2% \strut\\ \def{\ccverbatim \ccfinish}#3% \strut\\ \end{center} \if\cxxVersionStr\empty% \else% \begin{center} \small\sf --- Version \cxxVersionStr\ --- \end{center} \global\def\cxxVersionStr{} \fi \vfill \large \begin{center} \Large\em \def{\ccverbatim \ccfinish}#4% \end{center} \vfill \if\cxxAuthorStr\empty% \else% \begin{center} \sf\cxxAuthorStr \end{center} \global\def\cxxAuthorStr{} \vfill \fi \pagebreak \makeHeadLine{}{#2} }} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for contents % \newcounter{cxxContentsDepth} \setcounter{cxxContentsDepth}{0} \newdimen\cxxContentsLengthIncr \cxxContentsLengthIncr=18pt \newdimen\cxxContentsLength \cxxContentsLength=\textwidth \advance\cxxContentsLength by -\cxxContentsLengthIncr \makeHeadLine{}{Contents} \newenvironment{cxxContents}{ \ifcase \value{cxxContentsDepth} \vskip 40pt \hbox to \hsize{\hskip 8pt\hskip\cxxContentsLengthIncr\Huge\bf Contents\hss} \vskip 40pt \bf \else % >1 \rm \fi \begingroup \addtocounter{cxxContentsDepth}{1} \advance\cxxContentsLengthIncr by 8pt \advance\cxxContentsLength by -\cxxContentsLengthIncr }{ \addtocounter{cxxContentsDepth}{-1} \advance\cxxContentsLength by \cxxContentsLengthIncr \advance\cxxContentsLengthIncr by -8pt \ifcase \value{cxxContentsDepth} \vskip 12pt \or \vskip 9pt \else \vskip 3pt \fi \endgroup } \newcommand{\cxxContentsEntry}[3]{{ \def\emtpty{} \def\memo{#3} \ifx\memo\empty \setbox0\hbox{\parbox[t]{\cxxContentsLength}{\strut#2 \dotfill }} \else \setbox0\hbox{\parbox[t]{\cxxContentsLength}{\strut#2 --- {\em #3} \dotfill }} \fi \setbox1\hbox{\vtop{\vskip\dp0\vskip-\ht0\vskip-1.5pt\hbox to 20pt{\hss\rm \pageref{cxx.#1}}}} \hbox to \textwidth{% \hss\hbox to \cxxContentsLengthIncr{#1\hss}% \unhbox0\unhbox1% } }} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for class graph % \newdimen\cxxClassGraphShift \newdimen\cxxClassGraphLength \newdimen\cxxClassGraphHeight \newdimen\cxxClassGraphDepth \newdimen\cxxClassGraphTotV \setlength{\cxxClassGraphLength}{0.23\hsize} \setlength{\cxxClassGraphShift}{30pt} \setbox0\vbox{\aBox[5pt]{\strut}{\strut}} \setlength{\cxxClassGraphHeight}{\ht0} \setlength{\cxxClassGraphDepth}{\dp0} \addtolength{\cxxClassGraphDepth}{10pt} \setlength{\cxxClassGraphTotV}{\dp0} \addtolength{\cxxClassGraphTotV}{\ht0} \newenvironment{cxxInheritance}{ \par\medskip \begingroup \newcommand{\cxxCGSpace}[1]{% \vtop to \cxxClassGraphTotV{\hbox to \cxxClassGraphShift{% \vrule width0pt height \cxxClassGraphHeight depth \cxxClassGraphDepth% ##1}}% } \newcommand{\cxxSlashHline}{% \vrule width 0.1\cxxClassGraphShift height 3.5pt depth -3pt% \vrule width 0.1\cxxClassGraphShift height 0pt depth 0pt% \vrule width 0.1\cxxClassGraphShift height 3.5pt depth -3pt% \vrule width 0.1\cxxClassGraphShift height 0pt depth 0pt% \vrule width 0.1\cxxClassGraphShift height 3.5pt depth -3pt% } \newcommand{\cxxDotHline}{% \vrule width 0.06\cxxClassGraphShift height 3.5pt depth -3pt% \vrule width 0.05\cxxClassGraphShift height 0pt depth 0pt% \vrule width 0.06\cxxClassGraphShift height 3.5pt depth -3pt% \vrule width 0.05\cxxClassGraphShift height 0pt depth 0pt% \vrule width 0.06\cxxClassGraphShift height 3.5pt depth -3pt% \vrule width 0.05\cxxClassGraphShift height 0pt depth 0pt% \vrule width 0.06\cxxClassGraphShift height 3.5pt depth -3pt% \vrule width 0.05\cxxClassGraphShift height 0pt depth 0pt% \vrule width 0.06\cxxClassGraphShift height 3.5pt depth -3pt% } \newcommand{\cxxHline}{% \vrule width 0.5\cxxClassGraphShift height 3.5pt depth -3pt% } \newcommand{\cxxVup}{\hbox to 0pt{\hss% \vrule width 0.5pt height \cxxClassGraphHeight depth -3pt% \hss}} \newcommand{\cxxVlow}{\hbox to 0pt{\hss% \vtop to 0pt{\vskip-3pt% \hbox{\vrule width 0.5pt height 13pt depth \cxxClassGraphDepth}% \vss}% \hss}} \newcommand{\cxxLinkUp}{\hbox to 0pt{\hss\hskip 0.5\cxxClassGraphShift% \raise0.7\cxxClassGraphHeight\hbox to 0pt{\hss\textbf{\symbol{94}}\hss}}}% \newcommand{\cxxLinkDown}{\hbox to 0pt{\hss\hskip 0.5\cxxClassGraphShift% \raise-0.6\cxxClassGraphHeight\vbox to 0pt{% \hbox to 0pt{\hss\textbf{$\lor$}\hss}\vss}}}% \newcommand{\cxxLinkLeft}{\hbox to 0pt{\hss\hskip 0.0\cxxClassGraphShift% \raise0.0\cxxClassGraphHeight\hbox to 0pt{\textbf{\tt\<}\hss}}}% \newcommand{\cxxLinkRight}{\hbox to 0pt{\hss\hskip 1.0\cxxClassGraphShift% \raise0.0\cxxClassGraphHeight\hbox to 0pt{\hss\textbf{\tt\>}}}}% \newcommand{\cxxInheritanceEntry}[5][]{ \hbox to \hsize{\hss% \vrule width0pt height \cxxClassGraphHeight depth \cxxClassGraphDepth% ##2% \def\tmp{##1}% \ifx\tmp\empty% \def\tmp{##5}% \ifx\tmp\empty% \rBox[1pt]{##3}{##4}{0.24\hsize}% \else% \lBox[1pt]{##3}{##4}{0.24\hsize}% \fi% \else% \cBox[2pt]{##3}{##4}{0.24\hsize}% \fi% ##5\hfill% }\vskip-1pt } \newcommand{\cxxNone}{\cxxCGSpace{\hss}} \newcommand{\cxxLong}{\cxxCGSpace{\hss\cxxVup\cxxVlow\hss}} % \newcommand{\cxxPubLeft}{\cxxCGSpace{\cxxHline\cxxVup\cxxVlow\hss}} \newcommand{\cxxProLeft}{\cxxCGSpace{\cxxSlashHline\cxxVup\cxxVlow\hss}} \newcommand{\cxxPriLeft}{\cxxCGSpace{\cxxDotHline\cxxVup\cxxVlow\hss}} \newcommand{\cxxPubleft}{\cxxCGSpace{\cxxHline\cxxVlow\hss}} \newcommand{\cxxProleft}{\cxxCGSpace{\cxxSlashHline\cxxVlow\hss}} \newcommand{\cxxPrileft}{\cxxCGSpace{\cxxDotHline\cxxVlow\hss}} \newcommand{\cxxLastPubLeft}{\cxxCGSpace{\cxxHline% \cxxVup\cxxLinkDown\cxxVlow\hss}} \newcommand{\cxxLastProLeft}{\cxxCGSpace{\cxxSlashHline% \cxxVup\cxxLinkDown\cxxVlow\hss}} \newcommand{\cxxLastPriLeft}{\cxxCGSpace{\cxxDotHline% \cxxVup\cxxLinkDown\cxxVlow\hss}} \newcommand{\cxxLastPubleft}{\cxxCGSpace{\cxxHline% \cxxVlow\cxxLinkDown\hss}} \newcommand{\cxxLastProleft}{\cxxCGSpace{\cxxSlashHline% \cxxVlow\cxxLinkDown\hss}} \newcommand{\cxxLastPrileft}{\cxxCGSpace{\cxxDotHline% \cxxVlow\cxxLinkDown\hss}} \newcommand{\cxxLinkPubLeft}{\cxxCGSpace{\cxxLinkLeft\cxxHline\cxxVup\cxxVlow\hss}} \newcommand{\cxxLinkProLeft}{\cxxCGSpace{\cxxLinkLeft\cxxSlashHline% \cxxVup\cxxVlow\hss}} \newcommand{\cxxLinkPriLeft}{\cxxCGSpace{\cxxLinkLeft\cxxDotHline% \cxxVup\cxxVlow\hss}} \newcommand{\cxxLinkPubleft}{\cxxCGSpace{\cxxLinkLeft\cxxHline\cxxVlow\hss}} \newcommand{\cxxLinkProleft}{\cxxCGSpace{\cxxLinkLeft\cxxSlashHline\cxxVlow\hss}} \newcommand{\cxxLinkPrileft}{\cxxCGSpace{\cxxLinkLeft\cxxDotHline\cxxVlow\hss}} % \newcommand{\cxxPubRight}{\cxxCGSpace{\hss\cxxVup\cxxVlow\cxxHline}} \newcommand{\cxxProRight}{\cxxCGSpace{\hss\cxxVup\cxxVlow\cxxSlashHline}} \newcommand{\cxxPriRight}{\cxxCGSpace{\hss\cxxVup\cxxVlow\cxxDotHline}} \newcommand{\cxxPubright}{\cxxCGSpace{\hss\cxxVup\cxxHline}} \newcommand{\cxxProright}{\cxxCGSpace{\hss\cxxVup\cxxSlashHline}} \newcommand{\cxxPriright}{\cxxCGSpace{\hss\cxxVup\cxxDotHline}} \newcommand{\cxxLinkPubRight}{\cxxCGSpace{\hss\cxxVup\cxxVlow\cxxHline\cxxLinkRight}} \newcommand{\cxxLinkProRight}{\cxxCGSpace{\hss\cxxVup\cxxVlow% \cxxSlashHline\cxxLinkRight}} \newcommand{\cxxLinkPriRight}{\cxxCGSpace{\hss\cxxVup\cxxVlow% \cxxDotHline\cxxLinkRight}} \newcommand{\cxxLinkPubright}{\cxxCGSpace{\hss\cxxVup\cxxHline\cxxLinkRight}} \newcommand{\cxxLinkProright}{\cxxCGSpace{\hss\cxxVup\cxxSlashHline\cxxLinkRight}} \newcommand{\cxxLinkPriright}{\cxxCGSpace{\hss\cxxVup\cxxDotHline\cxxLinkRight}} \newcommand{\cxxFirstPubRight}{\cxxCGSpace{\hss\cxxVup\cxxLinkUp\cxxVlow\cxxHline}} \newcommand{\cxxFirstProRight}{\cxxCGSpace{\hss\cxxVup\cxxLinkUp\cxxVlow% \cxxSlashHline}} \newcommand{\cxxFirstPriRight}{\cxxCGSpace{\hss\cxxVup\cxxLinkUp\cxxVlow\cxxDotHline}} \newcommand{\cxxFirstPubright}{\cxxCGSpace{\hss\cxxVup\cxxLinkUp\cxxHline}} \newcommand{\cxxFirstProright}{\cxxCGSpace{\hss\cxxVup\cxxLinkUp\cxxSlashHline}} \newcommand{\cxxFirstPriright}{\cxxCGSpace{\hss\cxxVup\cxxLinkUp\cxxDotHline}} }{ \endgroup } \newenvironment{cxxClassGraph}{ \begin{cxxInheritance} \newcommand{\cxxClassGraphEntry}[4]{ \hbox to \hsize{\hss% \vrule width0pt height \cxxClassGraphHeight depth \cxxClassGraphDepth% ##1% \def\tmp{##4}% \rBox[1pt]{##2}{##3}{0.24\hsize}% ##4% \hskip\cxxClassGraphShift\dotfill% \hbox to \cxxClassGraphShift{\hss\pageref{cxx.##2}}% }\vskip-1pt } \newcommand{\cxxClassGraphEntryUnknownPackage}[3]{ \hbox to \hsize{\hss% \vrule width0pt height \cxxClassGraphHeight depth \cxxClassGraphDepth% ##1% \def\tmp{##3}% \rBox[1pt]{}{##2}{0.24\hsize}% ##3% \hskip\cxxClassGraphShift\hfill% }\vskip-1pt } \clearpage \pagebreak\strut \makeHeadLine{}{Class Graph} \vskip 20pt \hbox to \hsize{\Huge\bf \quad Class Graph\hss} \vskip 40pt } { \end{cxxInheritance} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for generic manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newdimen\cxxgenericstart \cxxgenericstart=\labelwidth \advance\cxxgenericstart by \labelsep \newdimen\cxxgenericwidth \cxxgenericwidth=\textwidth \advance\cxxgenericwidth by -\cxxgenericstart \newcounter{cxxDepth} \setcounter{cxxDepth}{0} \newlength{\cxxSize} \newenvironment{cxxgeneric}[5]{ % % some local definitions % \def\empty{} \def\type{#1} \def\args{#3} \def\memo{#4} \def\id {#5} % % pagebreak ? % \ifcase \value{cxxDepth} \clearpage % 0 \pagebreak \makeHeadLine{#5}{#2} \setlength{\cxxSize}{2pt} \or % 1 \strut\bigskip\bigskip\goodbreak% \setlength{\cxxSize}{1pt} \else % >2 \strut\bigskip\bigskip\goodbreak% \setlength{\cxxSize}{0.5pt} \fi \addtocounter{cxxDepth}{1} % % write synopsis % \setbox0\hbox{ }% \setbox1\hbox{\strut\large #1 {\bf#2} }% \setbox3\hbox{\strut\large #1 {\bf#2} #3}% % % box with id and name [optional width] over entire page width % \setlength{\cxxSideLen}{\hsize}% \addtolength{\cxxSideLen}{-4\cxxSize}% \addtolength{\cxxSideLen}{-2\wd0}% \setlength{\cxxTitleLen}{\cxxSideLen}% \addtolength{\cxxTitleLen}{-8\wd0}% \hbox{\aBox[\cxxSize]{\id}{\vbox{\vskip 1.5\parskip% \hbox to \cxxSideLen{\strut% \hbox to 4\wd0{}% \ifdim\wd3<\cxxTitleLen% \parbox[b]{\cxxTitleLen}{% \begin{raggedright} \noindent\large #1 {\bf#2} #3 \end{raggedright} } \else% \ifdim\wd1>0.7\cxxTitleLen% \parbox[b]{\cxxTitleLen}{% \begin{raggedright} \noindent\large #1 {\bf#2} #3 \end{raggedright} } \else% \addtolength{\cxxTitleLen}{-\wd1}% \unhbox1% \parbox[t]{\cxxTitleLen}{% \advance\lineskip 7pt% \begin{raggedright} \noindent\large\strut #3 \end{raggedright} } \fi% \fi% \hss\strut% }\vskip\parskip}% }} % \parbox[b]{\cxxSideLen}{\begingroup % \catcode`\&=12% % \catcode`\_=12% % \begin{flushleft} % \quad\large% % \ifx\type\empty % \ifx\args\empty % \strut{\bf #2}\\ % \else % \strut{\bf #2}\ \args % \fi % \else % \strut\type\ {\bf #2}\ \args % \fi % \end{flushleft} % \endgroup}}}% \ifx\memo\empty\else \vskip 10pt \begin{flushright} \it\memo \end{flushright} \fi \label{cxx.\id} \begingroup \def\cxxExceptionsStr{} \def\cxxParameterStr{} \def\cxxReturnStr{} \def\cxxInvariantsStr{} \def\cxxPreconditionsStr{} \def\cxxPostconditionsStr{} \def\cxxSeeStr{} \def\cxxAuthorStr{} \def\cxxVersionStr{} \def\cxxDeprecatedStr{} \def\cxxSinceStr{} \def\cxxFileStr{} \def\cxxExceptions##1{\def\cxxExceptionsStr{##1}} \def\cxxParameter##1{\def\cxxParameterStr{##1}} \def\cxxReturn##1{\def\cxxReturnStr{##1}} \def\cxxInvariants##1{\def\cxxInvariantsStr{##1}} \def\cxxPreconditions##1{\def\cxxPreconditionsStr{##1}} \def\cxxPostconditions##1{\def\cxxPostconditionsStr{##1}} \def\cxxSee##1{\def\cxxSeeStr{##1}} \def\cxxAuthor##1{\def\cxxAuthorStr{##1}} \def\cxxVersion##1{\def\cxxVersionStr{##1}} \def\cxxDeprecated##1{\def\cxxDeprecatedStr{##1}} \def\cxxSince##1{\def\cxxSinceStr{##1}} \def\cxxFile##1{\def\cxxFileStr{##1}} }{ \endgroup \addtocounter{cxxDepth}{-1} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for function manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxfunction}[5]{ \begin{cxxgeneric}{#1}{#2}{#3}{#4}{#5} \renewenvironment{cxxnames}{\begin{cxxlist}{Arguments}}{\end{cxxlist}} }{ \end{cxxgeneric} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxentry}[5]{ \begin{cxxgeneric}{#1}{#2}{#3}{#4}{#5}}{\end{cxxgeneric}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for union manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxunion}[5]{ \begin{cxxgeneric}{#1}{#2}{#3}{#4}{#5} \renewenvironment{cxxnames}{\begin{cxxlist}{Members}}{\end{cxxlist}} }{ \end{cxxgeneric} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for typedef manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxtypedef}[5]{ \begin{cxxgeneric}{#1}{#2}{}{#4}{#5} \renewenvironment{cxxnames}{\begin{cxxlist}{Members}}{\end{cxxlist}} }{ \end{cxxgeneric} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for macro manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxmacro}[5]{ \begin{cxxgeneric}{\#define}{#2}{#3}{#4}{#5}}{\end{cxxgeneric}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for class manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxclass}[5]{ \begin{cxxgeneric}{#1}{#2}{#3}{#4}{#5}}{\end{cxxgeneric}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for namespace manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxnamespace}[5]{ \begin{cxxgeneric}{#1}{#2}{#3}{#4}{#5}}{\end{cxxgeneric}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for interface manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxinterface}[5]{ \begin{cxxgeneric}{#1}{#2}{#3}{#4}{#5}}{\end{cxxgeneric}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for variable manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxvariable}[5]{ \begin{cxxgeneric}{#1}{#2}{#3}{#4}{#5} \renewenvironment{cxxnames}{\begin{cxxlist}{Names}}{\end{cxxlist}} }{ \end{cxxgeneric} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for documentation % \newenvironment{cxxdocumentation}{ % % switch on special characters for documentation section % \begingroup \catcode`\&=4 \catcode`\_=8 }{ \endgroup } \newenvironment{cxxdoc}{ % % switch on special characters for documentation section % \begin{cxxdocumentation} \strut\\\noindent% }{ \smallskip \def\empty{}% \ifx\cxxReturnStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Return Value:}\hss}% \parbox[t]{0.7\textwidth}{\cxxReturnStr}\\ \fi \ifx\cxxParameterStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Parameters:}\hss}% \parbox[t]{0.7\textwidth}{\cxxParameterStr}\\ \fi \ifx\cxxExceptionsStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Exceptions:}\hss}% \parbox[t]{0.7\textwidth}{\cxxExceptionsStr}\\ \fi \ifx\cxxInvariantsStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Invariants:}\hss}% \parbox[t]{0.7\textwidth}{\cxxInvariantsStr}\\ \fi \ifx\cxxPreconditionsStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Preconditions:}\hss}% \parbox[t]{0.7\textwidth}{\cxxPreconditionsStr}\\ \fi \ifx\cxxPostconditionsStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Postconditions:}\hss}% \parbox[t]{0.7\textwidth}{\cxxPostconditionsStr}\\ \fi \ifx\cxxSeeStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf See Also:}\hss}% \parbox[t]{0.7\textwidth}{\cxxSeeStr}\\ \fi \ifx\cxxAuthorStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Author:}\hss}% \parbox[t]{0.7\textwidth}{\cxxAuthorStr}\\ \fi \ifx\cxxVersionStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Version:}\hss}% \parbox[t]{0.7\textwidth}{\cxxVersionStr}\\ \fi \ifx\cxxDeprecatedStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf\it Deprecated:}\hss}% \parbox[t]{0.7\textwidth}{\cxxDeprecatedStr}\\ \fi \ifx\cxxSinceStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Since:}\hss}% \parbox[t]{0.7\textwidth}{\cxxSinceStr}\\ \fi \ifx\cxxFileStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf File:}\hss}% \parbox[t]{0.7\textwidth}{\cxxFileStr}\\ \fi \end{cxxdocumentation} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for commented listing % arguments are: % #1 Section title % \newenvironment{cxximplementation}[1]{ \goodbreak \begin{cxxdocumentation} }{ \end{cxxdocumentation} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \def\cxxCodeLine#1{ \strut\hbox to 20pt{\tiny\hss #1}\small %\advance\leftmargin by 20pt %\advance\textwidth by -20pt \ccverbatim \parskip=0pt \cxxCodeFinish} {\catcode`\=0 catcode`\=12 gdefcxxCodeFinish#1{hbox{#1}endgroup}} pupnp-release-1.8.0/ixml/doc/intro.dxx000066400000000000000000000026321303304015100176670ustar00rootroot00000000000000/**@name Introduction * The Linux DOM2 XML Parser Version 1.2 (IXML) is a lightweight, portable XML * parser supporting the standard Document Object Model (DOM) Level 2 * interfaces. The parser uses a C-style interface, making it idea for small, * embedded applications. This document describes the interfaces supported by * IXML 1.2, referencing the W3C DOM2 recommendations when necessary, and the * additional utility application programming interfaces (APIs) that it * supports. * * Note that this document assumes that the reader has a copy of the DOM2-Core * recommendation. Refer to the link below to obtain a copy. Only a brief * description is included here and the reader is pointed to the DOM2-Core * recommendation for more details. This document does, however, clarify * IXML-specific behavior when the recommendation is unclear. * * {\bf About DOM} * * The Document Object Model (DOM) is a set of interfaces that give a * programmatic interface to documents. It provides a platform-neutral and * language-neutral interface for random access and updating elements inside * XML documents. DOM Level 1 provided the basic interfaces to access * document elements. DOM Level 2 extended the interfaces to provide proper * support for XML namespaces. * * The latest DOM 2 recommendation is maintained by W3C and is available from * {\tt http://www.w3.org/TR/DOM-Level-2-Core}. */ pupnp-release-1.8.0/ixml/doc/ixml.dxx000066400000000000000000000004501303304015100175010ustar00rootroot00000000000000/**@name IXML v1.2 * \begin{center} * {\bf Linux DOM2 XML Parser Version 1.2} * * Copyright (C) 2000-2003 Intel Corporation ALL RIGHTS RESERVED * * Revision 1.2.1 (\Date) * \end{center} */ //@{ //@Include: intro.dxx //@Include: license.dxx //@Include: ../inc/ixml.h //@} pupnp-release-1.8.0/ixml/doc/license.dxx000066400000000000000000000032171303304015100201560ustar00rootroot00000000000000/**@name License * * \begin{center} * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * \end{center} * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * \begin{itemize} * \item Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * \item Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * \item Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * \end{itemize} * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * */ pupnp-release-1.8.0/ixml/inc/000077500000000000000000000000001303304015100160105ustar00rootroot00000000000000pupnp-release-1.8.0/ixml/inc/ixml.h000066400000000000000000001655071303304015100171500ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ #ifndef IXML_H #define IXML_H /*! * \file * * \defgroup XMLAPI XML API * * @{ */ #include "UpnpGlobal.h" /* For EXPORT_SPEC */ /* Define BOOL. */ #ifndef __OBJC__ typedef int BOOL; #else /* For Objective C compilers, include objc.h which defines BOOL. */ #include #endif /*! * \brief The type of DOM strings. */ #define DOMString char * /*typedef char *DOMString;*/ #ifndef TRUE #define TRUE 1 #endif #ifndef FALSE #define FALSE 0 #endif #ifndef IN #define IN #endif #ifndef OUT #define OUT #endif #ifndef INOUT #define INOUT #endif /*! * \name DOM Interfaces * * The Document Object Model consists of a set of objects and interfaces * for accessing and manipulating documents. IXML does not implement all * the interfaces documented in the DOM2-Core recommendation but defines * a subset of the most useful interfaces. A description of the supported * interfaces and methods is presented in this section. * * For a complete discussion on the object model, the object hierarchy, * etc., refer to section 1.1 of the DOM2-Core recommendation. * * @{ */ /*! * \brief The type of the DOM node */ typedef enum { eINVALID_NODE = 0, eELEMENT_NODE = 1, eATTRIBUTE_NODE = 2, eTEXT_NODE = 3, eCDATA_SECTION_NODE = 4, eENTITY_REFERENCE_NODE = 5, eENTITY_NODE = 6, ePROCESSING_INSTRUCTION_NODE = 7, eCOMMENT_NODE = 8, eDOCUMENT_NODE = 9, eDOCUMENT_TYPE_NODE = 10, eDOCUMENT_FRAGMENT_NODE = 11, eNOTATION_NODE = 12, } IXML_NODE_TYPE; /*! * \brief Error codes returned by the XML API, see the DOM spec */ typedef enum { IXML_SUCCESS = 0, IXML_INDEX_SIZE_ERR = 1, IXML_DOMSTRING_SIZE_ERR = 2, IXML_HIERARCHY_REQUEST_ERR = 3, IXML_WRONG_DOCUMENT_ERR = 4, IXML_INVALID_CHARACTER_ERR = 5, IXML_NO_DATA_ALLOWED_ERR = 6, IXML_NO_MODIFICATION_ALLOWED_ERR = 7, IXML_NOT_FOUND_ERR = 8, IXML_NOT_SUPPORTED_ERR = 9, IXML_INUSE_ATTRIBUTE_ERR = 10, IXML_INVALID_STATE_ERR = 11, IXML_SYNTAX_ERR = 12, IXML_INVALID_MODIFICATION_ERR = 13, IXML_NAMESPACE_ERR = 14, IXML_INVALID_ACCESS_ERR = 15, IXML_NO_SUCH_FILE = 101, IXML_INSUFFICIENT_MEMORY = 102, IXML_FILE_DONE = 104, IXML_INVALID_PARAMETER = 105, IXML_FAILED = 106, IXML_INVALID_ITEM_NUMBER = 107, } IXML_ERRORCODE; #define DOCUMENTNODENAME "#document" #define TEXTNODENAME "#text" #define CDATANODENAME "#cdata-section" typedef struct _IXML_Document *Docptr; typedef struct _IXML_Node *Nodeptr; #ifdef IXML_HAVE_SCRIPTSUPPORT /*! * \brief Signature for GC support method, called before a node is freed. */ typedef void (*IXML_BeforeFreeNode_t) (Nodeptr obj); #endif /*! * \brief Data structure common to all types of nodes. */ typedef struct _IXML_Node { DOMString nodeName; DOMString nodeValue; IXML_NODE_TYPE nodeType; DOMString namespaceURI; DOMString prefix; DOMString localName; BOOL readOnly; Nodeptr parentNode; Nodeptr firstChild; Nodeptr prevSibling; Nodeptr nextSibling; Nodeptr firstAttr; Docptr ownerDocument; #ifdef IXML_HAVE_SCRIPTSUPPORT void* ctag; /* custom tag */ #endif } IXML_Node; /*! * \brief Data structure representing the DOM Document. */ typedef struct _IXML_Document { IXML_Node n; } IXML_Document; /*! * \brief Data structure representing a CDATA section node. */ typedef struct _IXML_CDATASection { IXML_Node n; } IXML_CDATASection; /*! * \brief Data structure representing an Element node. */ typedef struct _IXML_Element { IXML_Node n; DOMString tagName; } IXML_Element; /*! * \brief Data structure representing an Attribute node. */ typedef struct _IXML_ATTR { IXML_Node n; BOOL specified; IXML_Element *ownerElement; } IXML_Attr; /*! * \brief Data structure representing a Text node. */ typedef struct _IXML_Text { IXML_Node n; } IXML_Text; /*! * \brief Data structure representing a list of nodes. */ typedef struct _IXML_NodeList { IXML_Node *nodeItem; struct _IXML_NodeList *next; } IXML_NodeList; /*! * \brief Data structure representing a list of named nodes. */ typedef struct _IXML_NamedNodeMap { IXML_Node *nodeItem; struct _IXML_NamedNodeMap *next; } IXML_NamedNodeMap; /* @} DOM Interfaces */ #ifdef __cplusplus extern "C" { #endif /*! * \name Interface Node * * The \b Node interface forms the primary datatype for all other DOM * objects. Every other interface is derived from this interface, inheriting * its functionality. For more information, refer to DOM2-Core page 34. * (Note: within the IXML library the NamedNodeMap and NodeList interfaces are * the only interfaces that are not DOM objects and hence do not inherit from Node) * * @{ */ /*! * \brief Returns the name of the \b Node, depending on what type of * \b Node it is, in a read-only string. * * Refer to the table in the * DOM2-Core for a description of the node names for various interfaces. * * \return A constant \b DOMString of the node name. */ EXPORT_SPEC const DOMString ixmlNode_getNodeName( /*! [in] Pointer to the node to retrieve the name. */ IXML_Node *nodeptr); /*! * \brief Returns the value of the \b Node as a string. * * Note that this string is not a copy and modifying it will modify the value * of the \b Node. * * \return A \b DOMString of the \b Node value. */ EXPORT_SPEC const DOMString ixmlNode_getNodeValue( /*! [in] Pointer to the \b Node to retrieve the value. */ IXML_Node *nodeptr); /*! * \brief Assigns a new value to a \b Node. * * The \b newNodeValue string is duplicated and stored in the \b Node so that * the original does not have to persist past this call. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: The Node * is not a valid pointer. * \li \c IXML_INSUFFICIENT_MEMORY: Not enough free memory exists to * complete this operation. */ EXPORT_SPEC int ixmlNode_setNodeValue( /*! [in] The \b Node to which to assign a new value. */ IXML_Node *nodeptr, /*! [in] The new value of the \b Node. */ const char *newNodeValue); /*! * \brief Retrieves the type of a \b Node. Note that not all possible * return values are actually implemented. * * \return An enum IXML_NODE_TYPE representing the type of the \b Node. */ EXPORT_SPEC unsigned short ixmlNode_getNodeType( /*! [in] The \b Node from which to retrieve the type. */ IXML_Node *nodeptr); /*! * \brief Retrieves the parent \b Node for a \b Node. * * \return A pointer to the parent \b Node or \c NULL if the \b Node has no * parent. */ EXPORT_SPEC IXML_Node *ixmlNode_getParentNode( /*! [in] The \b Node from which to retrieve the parent. */ IXML_Node *nodeptr); /*! * \brief Retrieves the list of children of a \b Node in a \b NodeList * structure. * * If a \b Node has no children, \b ixmlNode_getChildNodes * returns a \b NodeList structure that contains no \b Nodes. * * \return A \b NodeList of the children of the \b Node. */ EXPORT_SPEC IXML_NodeList *ixmlNode_getChildNodes( /*! [in] The \b Node from which to retrieve the children. */ IXML_Node *nodeptr); /*! * \brief Retrieves the first child \b Node of a \b Node. * * \return A pointer to the first child \b Node or \c NULL if the \b Node does * not have any children. */ EXPORT_SPEC IXML_Node *ixmlNode_getFirstChild( /*! [in] The \b Node from which to retrieve the first child. */ IXML_Node *nodeptr); /*! * \brief Retrieves the last child \b Node of a \b Node. * * \return A pointer to the last child \b Node or \c NULL if the \b Node does * not have any children. */ EXPORT_SPEC IXML_Node *ixmlNode_getLastChild( /*! [in] The \b Node from which to retrieve the last child. */ IXML_Node *nodeptr); /*! * \brief Retrieves the sibling \b Node immediately preceding this \b Node. * * \return A pointer to the previous sibling \b Node or \c NULL if no such * \b Node exists. */ EXPORT_SPEC IXML_Node *ixmlNode_getPreviousSibling( /*! [in] The \b Node for which to retrieve the previous sibling. */ IXML_Node *nodeptr); /*! * \brief Retrieves the sibling \b Node immediately following this \b Node. * * \return A pointer to the next sibling \b Node or \c NULL if no such * \b Node exists. */ EXPORT_SPEC IXML_Node *ixmlNode_getNextSibling( /*! [in] The \b Node from which to retrieve the next sibling. */ IXML_Node *nodeptr); /*! * \brief Retrieves the attributes of a \b Node, if it is an \b Element node, * in a \b NamedNodeMap structure. * * \return A \b NamedNodeMap of the attributes or \c NULL. */ EXPORT_SPEC IXML_NamedNodeMap *ixmlNode_getAttributes( /*! [in] The \b Node from which to retrieve the attributes. */ IXML_Node *nodeptr); /*! * \brief Retrieves the document object associated with this \b Node. * * This owner document \b Node allows other \b Nodes to be created in the * context of this document. Note that \b Document nodes do not have an * owner document. * * \return A pointer to the owning \b Document or \c NULL, if the \b Node * does not have an owner. */ EXPORT_SPEC IXML_Document *ixmlNode_getOwnerDocument( /*! [in] The \b Node from which to retrieve the owner document. */ IXML_Node *nodeptr); /*! * \brief Retrieves the namespace URI for a \b Node as a \b DOMString. * * Only \b Nodes of type \c eELEMENT_NODE or \c eATTRIBUTE_NODE can have a * namespace URI. \b Nodes created through the \b Document interface will * only contain a namespace if created using \b ixmlDocument_createElementNS. * * \return A \b DOMString representing the URI of the namespace or \c NULL. */ EXPORT_SPEC const DOMString ixmlNode_getNamespaceURI( /*! [in] The \b Node for which to retrieve the namespace. */ IXML_Node *nodeptr); /*! * \brief Retrieves the namespace prefix, if present. * * The prefix is the name used as an alias for the namespace URI for this * element. Only \b Nodes of type \c eELEMENT_NODE or \c eATTRIBUTE_NODE can * have a prefix. \b Nodes created through the \b Document interface will only * contain a prefix if created using \b ixmlDocument_createElementNS. * * \return A \b DOMString representing the namespace prefix or \c NULL. */ EXPORT_SPEC const DOMString ixmlNode_getPrefix( /*! The \b Node from which to retrieve the prefix. */ IXML_Node *nodeptr); /*! * \brief Retrieves the local name of a \b Node, if present. * * The local name is the tag name without the namespace prefix. Only \b Nodes * of type \c eELEMENT_NODE or \c eATTRIBUTE_NODE can have a local name. * \b Nodes created through the \b Document interface will only contain a local * name if created using \b ixmlDocument_createElementNS. * * \return A \b DOMString representing the local name of the \b Element or * \c NULL. */ EXPORT_SPEC const DOMString ixmlNode_getLocalName( /*! [in] The \b Node from which to retrieve the local name. */ IXML_Node *nodeptr); /*! * \brief Inserts a new child \b Node before the existing child \b Node. * * \b refChild can be \c NULL, which inserts \b newChild at the * end of the list of children. Note that the \b Node (or \b Nodes) * in \b newChild must already be owned by the owner document (or have no * owner at all) of \b nodeptr for insertion. If not, the \b Node * (or \b Nodes) must be imported into the document using * \b ixmlDocument_importNode. If \b newChild is already in the tree, * it is removed first. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b nodeptr or * \b newChild is \c NULL. * \li \c IXML_HIERARCHY_REQUEST_ERR: The type of the \b Node * does not allow children of the type of \b newChild. * \li \c IXML_WRONG_DOCUMENT_ERR: \b newChild has an owner * document that does not match the owner of \b nodeptr. * \li \c IXML_NO_MODIFICATION_ALLOWED_ERR: \b nodeptr is * read-only or the parent of the \b Node being inserted is * read-only. * \li \c IXML_NOT_FOUND_ERR: \b refChild is not a child of * \b nodeptr. */ EXPORT_SPEC int ixmlNode_insertBefore( /*! [in] The parent of the \b Node before which to insert the new child. */ IXML_Node *nodeptr, /*! [in] The \b Node to insert into the tree. */ IXML_Node * newChild, /*! [in] The reference child where the new \b Node should be inserted. * The new \b Node will appear directly before the reference child. */ IXML_Node * refChild); /*! * \brief Replaces an existing child \b Node with a new child \b Node in the * list of children of a \b Node. * * If \b newChild is already in the tree, it will first be removed. * \b returnNode will contain the \b oldChild \b Node, appropriately removed * from the tree (i.e. it will no longer have an owner document). * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMTER: Either \b nodeptr, \b newChild, * or \b oldChild is \c NULL. * \li \c IXML_HIERARCHY_REQUEST_ERR: The \b newChild is not * a type of \b Node that can be inserted into this tree or * \b newChild is an ancestor of \b nodePtr. * \li \c IXML_WRONG_DOCUMENT_ERR: \b newChild was created from * a different document than \b nodeptr. * \li \c IXML_NO_MODIFICATION_ALLOWED_ERR: \b nodeptr or * its parent is read-only. * \li \c IXML_NOT_FOUND_ERR: \b oldChild is not a child of * \b nodeptr. */ EXPORT_SPEC int ixmlNode_replaceChild( /*! [in] The parent of the \b Node which contains the child to replace. */ IXML_Node *nodeptr, /*! [in] The child with which to replace \b oldChild. */ IXML_Node *newChild, /*! [in] The child to replace with \b newChild. */ IXML_Node *oldChild, /*! [out] Pointer to a \b Node to place the removed \b oldChild \b Node. */ IXML_Node **returnNode); /*! * \brief Removes a child from the list of children of a \b Node. * * \b returnNode will contain the \b oldChild \b Node, * appropriately removed from the tree (i.e. it will no longer have an * owner document). * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b nodeptr or * \b oldChild is \c NULL. * \li \c IXML_NO_MODIFICATION_ALLOWED_ERR: \b nodeptr or its * parent is read-only. * \li \c IXML_NOT_FOUND_ERR: \b oldChild is not among the * children of \b nodeptr. */ EXPORT_SPEC int ixmlNode_removeChild( /*! [in] The parent of the child to remove. */ IXML_Node *nodeptr, /*! [in] The child \b Node to remove. */ IXML_Node *oldChild, /*! [out] Pointer to a \b Node to place the removed \b oldChild \b Node. */ IXML_Node **returnNode); /*! * \brief Appends a child \b Node to the list of children of a \b Node. * * If \b newChild is already in the tree, it is removed first. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b nodeptr or * \b newChild is \c NULL. * \li \c IXML_HIERARCHY_REQUEST_ERR: \b newChild is of a type * that cannot be added as a child of \b nodeptr or * \b newChild is an ancestor of \b nodeptr. * \li \c IXML_WRONG_DOCUMENT_ERR: \b newChild was created from * a different document than \b nodeptr. * \li \c IXML_NO_MODIFICATION_ALLOWED_ERR: \b nodeptr is a * read-only \b Node. */ EXPORT_SPEC int ixmlNode_appendChild( /*! [in] The \b Node in which to append the new child. */ IXML_Node *nodeptr, /*! [in] The new child to append. */ IXML_Node * newChild); /*! * \brief Queries whether or not a \b Node has children. * * \return \c TRUE if the \b Node has one or more children otherwise \c FALSE. */ EXPORT_SPEC BOOL ixmlNode_hasChildNodes( /*! [in] The \b Node to query for children. */ IXML_Node *nodeptr); /*! * \brief Clones a \b Node. * * The new \b Node does not have a parent. The \b deep parameter controls * whether the subtree of the \b Node is also cloned. * * For details on cloning specific types of \b Nodes, refer to the * DOM2-Core recommendation. * * \return A clone of \b nodeptr or \c NULL. */ EXPORT_SPEC IXML_Node *ixmlNode_cloneNode( /*! [in] The \b Node to clone. */ IXML_Node *nodeptr, /*! [in] \c TRUE to clone the subtree also or \c FALSE to clone only * \b nodeptr. */ BOOL deep); /*! * \brief Queries whether this \b Node has attributes. * * Note that only \b Element nodes have attributes. * * \return \c TRUE if the \b Node has attributes otherwise \c FALSE. */ EXPORT_SPEC BOOL ixmlNode_hasAttributes( /*! [in] The \b Node to query for attributes. */ IXML_Node *nodeptr); /*! * \brief Frees a \b Node and all \b Nodes in its subtree. */ EXPORT_SPEC void ixmlNode_free( /*! [in] The \b Node tree to free. Before it is freed, the handler * set by \b ixmlSetBeforeFree will be called, the order will be * top-down. */ IXML_Node *nodeptr); #ifdef IXML_HAVE_SCRIPTSUPPORT /*! * \brief Sets the custom tag for the node. */ EXPORT_SPEC void ixmlNode_setCTag( /*! [in] The \b Node to which to attach the tag. */ IXML_Node *nodeptr, /*! [in] The \b tag to attach. */ void *ctag); /*! * \brief Gets the custom tag for the node. */ EXPORT_SPEC void* ixmlNode_getCTag( /*! [in] The \b Node from which to get the tag. */ IXML_Node *nodeptr); #endif /* @} Interface Node */ /*! * \name Interface Attr * * The \b Attr interface represents an attribute of an \b Element. The document * type definition (DTD) or schema usually dictate the allowable attributes and * values for a particular element. * * For more information, refer to the Interface Attr section in the * DOM2-Core. * * @{ */ /*! * \brief Frees an \b Attr node. */ EXPORT_SPEC void ixmlAttr_free( /*! The \b Attr node to free. */ IXML_Attr *attrNode); /* @} Interface Attr */ /*! * \name Interface CDATASection * * The \b CDATASection is used to escape blocks of text containing * characters that would otherwise be regarded as markup. CDATA sections * cannot be nested. Their primary purpose is for including material such * XML fragments, without needing to escape all the delimiters. * * For more information, refer to the Interface CDATASection section * in the DOM2-Core. * * @{ */ /*! * \brief Initializes a \b CDATASection node. */ EXPORT_SPEC void ixmlCDATASection_init( /*! [in] The CDATA Section Node to iniatialize. */ IXML_CDATASection *nodeptr); /*! * \brief Frees a \b CDATASection node. */ EXPORT_SPEC void ixmlCDATASection_free( /*! The \b CDATASection node to free. */ IXML_CDATASection *nodeptr); /* @} Interface CDATASection */ /*! * \name Interface Document * * The \b Document interface represents the entire XML document. In essence, it * is the root of the document tree and provides the primary interface to the * elements of the document. * * For more information, refer to the Interface Document section in * the DOM2Core. * * @{ */ /*! * \brief Initializes a \b Document node. */ EXPORT_SPEC void ixmlDocument_init( /*! [in] The \b Document node to initialize. */ IXML_Document *nodeptr); /*! * \brief Creates a new empty \b Document node. * * The \b ixmlDocument_createDocumentEx API differs from the * \b ixmlDocument_createDocument API in that it returns an error code * describing the reason for the failure rather than just \c NULL. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INSUFFICIENT_MEMORY: Not enough free memory exists * to complete this operation. */ EXPORT_SPEC int ixmlDocument_createDocumentEx( /*! [out] Pointer to a \b Document where the new object will be stored. */ IXML_Document **doc); /*! * \brief Creates a new empty \b Document node. * * \return A pointer to the new \b Document object with the nodeName set to * "#document" or \c NULL on failure. */ EXPORT_SPEC IXML_Document *ixmlDocument_createDocument(void); /*! * \brief Creates a new \b Element node with the given tag name. * * The new \b Element node has a \c nodeName of \b tagName and the * \c localName, \c prefix, and \c namespaceURI set to \c NULL. To create an * \b Element with a namespace, see \b ixmlDocument_createElementNS. * * The \b ixmlDocument_createElementEx API differs from the \b * ixmlDocument_createElement API in that it returns an error code * describing the reason for failure rather than just \c NULL. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b doc or * \b tagName is \c NULL. * \li \c IXML_INSUFFICIENT_MEMORY: Not enough free memory exists * to complete this operation. */ EXPORT_SPEC int ixmlDocument_createElementEx( /*! [in] The owner \b Document of the new node. */ IXML_Document *doc, /*! [in] The tag name of the new \b Element node. */ const DOMString tagName, /*! [out] Pointer to an \b Element where the new object will be stored. */ IXML_Element **rtElement); /*! * \brief Creates a new \b Element node with the given tag name. * * The new \b Element node has a \c nodeName of \b tagName and the * \c localName, \c prefix, and \c namespaceURI set to \c NULL. To create an * \b Element with a namespace, see \b ixmlDocument_createElementNS. * * \return A pointer to the new \b Element object with the node name set to * tagName, and localName, prefix and namespaceURI set to \c NULL, or \c NULL * on failure. */ EXPORT_SPEC IXML_Element *ixmlDocument_createElement( /*! [in] The owner \b Document of the new node. */ IXML_Document *doc, /*! [in] The tag name of the new \b Element node (case-sensitive). */ const DOMString tagName); /*! * \brief Creates a new \b Text node with the given data. * * The \b ixmlDocument_createTextNodeEx() API differs from the * \b ixmlDocument_createTextNode API in that it returns an error code * describing the reason for failure rather than just \c NULL. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b doc or \b data * is \c NULL. * \li \c IXML_INSUFFICIENT_MEMORY: Not enough free memory exists * to complete this operation. */ EXPORT_SPEC int ixmlDocument_createTextNodeEx( /*! [in] The owner \b Document of the new node. */ IXML_Document *doc, /*! [in] The data to associate with the new \b Text node. * It is stored in nodeValue field.*/ const DOMString data, /*! [out] A pointer to a \b Node where the new object will be stored. */ IXML_Node **textNode); /*! * \brief Creates a new \b Text node with the given data. * * \return A pointer to the new \b Node or \c NULL on failure. */ EXPORT_SPEC IXML_Node *ixmlDocument_createTextNode( /*! [in] The owner \b Document of the new node. */ IXML_Document *doc, /*! [in] The data to associate with the new \b Text node. It is stored in * the nodeValue field. */ const DOMString data); /*! * \brief Creates a new \b CDATASection node with given data. * * The \b ixmlDocument_createCDATASectionEx API differs from the \b * ixmlDocument_createCDATASection API in that it returns an error code * describing the reason for failure rather than just \c NULL. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b doc or \b data * is \c NULL. * \li \c IXML_INSUFFICIENT_MEMORY: Not enough free memory exists * to complete this operation. */ EXPORT_SPEC int ixmlDocument_createCDATASectionEx( /*! [in] The owner \b Document of the new node. */ IXML_Document *doc, /*! [in] The data to associate with the new \b CDATASection node. */ const DOMString data, /*! [out] A pointer to a \b Node where the new object will be stored. */ IXML_CDATASection** cdNode); /*! * \brief Creates a new \b CDATASection node with given data. * * \return A pointer to the new \b CDATASection or \c NULL on failure. */ EXPORT_SPEC IXML_CDATASection *ixmlDocument_createCDATASection( /*! [in] The owner \b Document of the new node. */ IXML_Document *doc, /*! [in] The data to associate with the new \b CDATASection node. */ const DOMString data); /*! * \brief Creates a new \b Attr node with the given name. * * \return A pointer to the new \b Attr object with the nodeName attribute * set to the given name, and the localName, prefix and namespaceURI set * to NULL or \c NULL on failure. * * The value of the attribute is the empty string. */ EXPORT_SPEC IXML_Attr *ixmlDocument_createAttribute( /*! [in] The owner \b Document of the new node. */ IXML_Document *doc, /*! [in] The name of the new attribute. */ const DOMString name); /*! * \brief Creates a new \b Attr node with the given name. * * The \b ixmlDocument_createAttributeEx API differs from the \b * ixmlDocument_createAttribute API in that it returns an error code * describing the reason for failure rather than just \c NULL. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b doc or \b name * is \c NULL. * \li \c IXML_INSUFFICIENT_MEMORY: Not enough free memory exists * to complete this operation. */ EXPORT_SPEC int ixmlDocument_createAttributeEx( /*! [in] The owner \b Document of the new node. */ IXML_Document *doc, /*! [in] The name of the new attribute. */ const DOMString name, /*! [out] A pointer to a \b Attr where the new object will be stored. */ IXML_Attr **attrNode); /*! * \brief Returns a \b NodeList of all \b Elements that match the given * tag name in the order in which they were encountered in a preorder * traversal of the \b Document tree. * * \return A pointer to a \b NodeList containing the matching items or \c NULL * on an error. */ EXPORT_SPEC IXML_NodeList *ixmlDocument_getElementsByTagName( /*! [in] The \b Document to search. */ IXML_Document *doc, /*! [in] The tag name to find. The special value "*" matches all tags.*/ const DOMString tagName); /* * introduced in DOM level 2 */ /*! * \brief Creates a new \b Element node in the given qualified name and * namespace URI. * * The \b ixmlDocument_createElementNSEx API differs from the \b * ixmlDocument_createElementNS API in that it returns an error code * describing the reason for failure rather than just \c NULL. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b doc, * \b namespaceURI, or \b qualifiedName is \c NULL. * \li \c IXML_INSUFFICIENT_MEMORY: Not enough free memory exists * to complete this operation. */ EXPORT_SPEC int ixmlDocument_createElementNSEx( /*! [in] The owner \b Document of the new node. */ IXML_Document *doc, /*! [in] The namespace URI for the new \b Element. */ const DOMString namespaceURI, /*! [in] The qualified name of the new \b Element. */ const DOMString qualifiedName, /*! [out] A pointer to an \b Element where the new object will be stored. */ IXML_Element **rtElement); /*! * \brief Creates a new \b Element node in the given qualified name and * namespace URI. * * \return A pointer to the new \b Element object with tagName qualifiedName, * prefix and localName extraced from qualfiedName, nodeName of qualfiedName, * namespaceURI of namespaceURI or \c NULL on failure. */ EXPORT_SPEC IXML_Element *ixmlDocument_createElementNS( /*! [in] The owner \b Document of the new node. */ IXML_Document *doc, /*! [in] The namespace URI for the new \b Element. */ const DOMString namespaceURI, /*! [in] The qualified name of the new \b Element. */ const DOMString qualifiedName); /*! * \brief Creates a new \b Attr node with the given qualified name and * namespace URI. * * The \b ixmlDocument_createAttributeNSEx API differs from the \b * ixmlDocument_createAttributeNS API in that it returns an error code * describing the reason for failure rather than just \c NULL. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b doc, * \b namespaceURI, or \b qualifiedName is \c NULL. * \li \c IXML_INSUFFICIENT_MEMORY: Not enough free memory exists * to complete this operation. */ EXPORT_SPEC int ixmlDocument_createAttributeNSEx( /*! [in] The owner \b Document of the new \b Attr. */ IXML_Document *doc, /*! [in] The namespace URI for the attribute. */ const DOMString namespaceURI, /*! [in] The qualified name of the attribute. */ const DOMString qualifiedName, /*! [out] A pointer to an \b Attr where the new object will be stored. */ IXML_Attr **attrNode); /*! * \brief Creates a new \b Attribute node with the given qualified name and * namespace URI. * * \return A pointer to the new \b Attr node with the given namespaceURI and * qualifiedName. The prefix and localname are extracted from * the qualifiedName. The node value is empty. Or \c NULL on failure. */ EXPORT_SPEC IXML_Attr *ixmlDocument_createAttributeNS( /*! [in] The owner \b Document of the new \b Attribute. */ IXML_Document *doc, /*! [in] The namespace URI for the attribute. */ const DOMString namespaceURI, /*! [in] The qualified name of the attribute. */ const DOMString qualifiedName); /*! * \brief Returns a \b NodeList of \b Elements that match the given * local name and namespace URI in the order they are encountered * in a preorder traversal of the \b Document tree. * * Either \b namespaceURI or \b localName can be the special "*" * character, which matches any namespace or any local name respectively. * * \return A pointer to a \b NodeList containing the matching items or \c NULL * on an error. */ EXPORT_SPEC IXML_NodeList *ixmlDocument_getElementsByTagNameNS( /*! [in] The \b Document to search. */ IXML_Document *doc, /*! [in] The namespace of the elements to find or "*" to match any * namespace. */ const DOMString namespaceURI, /*! [in] The local name of the elements to find or "*" to match any * local name. */ const DOMString localName); /*! * \brief Returns the \b Element whose \c ID matches that given id. * * \return A pointer to the matching \b Element or \c NULL on an error. */ EXPORT_SPEC IXML_Element *ixmlDocument_getElementById( /*! [in] The owner \b Document of the \b Element. */ IXML_Document *doc, /*! [in] The name of the \b Element.*/ const DOMString tagName); /*! * \brief Frees a \b Document object and all \b Nodes associated with it. * * Any \b Nodes extracted via any other interface function, e.g. * \b ixmlDocument_GetElementById, become invalid after this call unless * explicitly cloned. */ EXPORT_SPEC void ixmlDocument_free( /*! [in] The \b Document to free. */ IXML_Document *doc); /*! * \brief Imports a \b Node from another \b Document into this \b Document. * * The returned new \b Node does not a have parent node (parentNode is null): * it is a clone of the original \b Node with the \c ownerDocument set to * \b doc. The source node is not altered or removed from the original * document. * * For all nodes, importing a node creates a node object owned by the * importing document, with attribute values identical to the source * node's nodeName and nodeType, plus the attributes related to namespaces * (prefix, localName, and namespaceURI). * * As in the cloneNode operation on a node, the source node is not altered. * * The \b deep parameter controls whether all the children of the \b Node are * imported. * * Refer to the DOM2-Core recommendation for details on importing specific * node types. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b doc or * \b importNode is not a valid pointer. * \li \c IXML_NOT_SUPPORTED_ERR: \b importNode is a * \b Document, which cannot be imported. * \li \c IXML_FAILED: The import operation failed because the * \b Node to be imported could not be cloned. */ EXPORT_SPEC int ixmlDocument_importNode( /*! [in] The \b Document into which to import. */ IXML_Document *doc, /*! [in] The \b Node to import. */ IXML_Node * importNode, /*! [in] \c TRUE to import all children of \b importNode or \c FALSE to * import only the root node. */ BOOL deep, /*! [out] A pointer to a new \b Node owned by \b doc. */ IXML_Node **rtNode); /* @} Interface Document */ /*! * \name Interface Element * * The \b Element interface represents an element in an XML document. * Only \b Elements are allowed to have attributes, which are stored in the * \c attributes member of a \b Node. The \b Element interface * extends the \b Node interface and adds more operations to manipulate * attributes. * * @{ */ /*! * \brief Initializes a \b IXML_Element node. */ EXPORT_SPEC void ixmlElement_init( /*! [in] The \b Element to initialize.*/ IXML_Element *element); /*! * \brief Returns the name of the tag as a constant string. * * \return The name of the \b Element. */ EXPORT_SPEC const DOMString ixmlElement_getTagName( /*! [in] The \b Element from which to retrieve the name. */ IXML_Element *element); /*! * \brief Retrieves an attribute of an \b Element by name. * * \return The value of the attribute, or \b NULL if that attribute * does not have a specified value. */ EXPORT_SPEC const DOMString ixmlElement_getAttribute( /*! [in] The \b Element from which to retrieve the attribute. */ IXML_Element* element, /*! [in] The name of the attribute to retrieve. */ const DOMString name); /*! * \brief Adds a new attribute to an \b Element. * * If an attribute with the same name already exists in the element, the * attribute value will be updated with the new value parameter. Otherwise, * a new attribute is inserted into the element. * * \return An integer representing of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b element, * \b name, or \b value is \c NULL. * \li \c IXML_INVALID_CHARACTER_ERR: \b name contains an * illegal character. * \li \c IXML_INSUFFICIENT_MEMORY: Not enough free memory exists * to complete the operation. */ EXPORT_SPEC int ixmlElement_setAttribute( /*! [in] The \b Element on which to set the attribute. */ IXML_Element *element, /*! [in] The name of the attribute. */ const DOMString name, /*! [in] The value of the attribute. Note that this is a non-parsed string * and any markup must be escaped. */ const DOMString value); /*! * \brief Removes an attribute value by name. The attribute node is not removed. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b element or * \b name is \c NULL. */ EXPORT_SPEC int ixmlElement_removeAttribute( /*! [in] The \b Element from which to remove the attribute. */ IXML_Element *element, /*! [in] The name of the attribute to remove. */ const DOMString name); /*! * \brief Retrieves an attribute node by name. * See \b ixmlElement_getAttributeNodeNS to retrieve an attribute node using * a qualified name or namespace URI. * * \return A pointer to the attribute matching \b name or \c NULL on if there * is no such attribute. */ EXPORT_SPEC IXML_Attr *ixmlElement_getAttributeNode( /*! [in] The \b Element from which to get the attribute node. */ IXML_Element *element, /*! [in] The name of the attribute node to find. */ const DOMString name); /*! * \brief Adds a new attribute node to an \b Element. * * If an attribute already exists with \b newAttr as a name, it will be * replaced with the new one and the old one will be returned in \b rtAttr. * * \return If successfull, the replaced attribute node is returned in rtAttr, * otherwise, \b NULL is returned in this pointer. The function return value * is an integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b element or * \b newAttr is \c NULL. * \li \c IXML_WRONG_DOCUMENT_ERR: \b newAttr does not belong * to the same one as \b element. * \li \c IXML_INUSE_ATTRIBUTE_ERR: \b newAttr is already * an attribute of another \b Element. */ EXPORT_SPEC int ixmlElement_setAttributeNode( /*! [in] The \b Element in which to add the new attribute. */ IXML_Element *element, /*! [in] The new \b Attr to add. */ IXML_Attr* newAttr, /*! [out] A pointer to an \b Attr where the old \b Attr will be stored. * This will have a \c NULL if no prior node existed. */ IXML_Attr** rtAttr); /*! * \brief Removes the specified attribute node from an \b Element. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b element or * \b oldAttr is \c NULL. * \li \c IXML_NOT_FOUND_ERR: \b oldAttr is not among the list * attributes of \b element. */ EXPORT_SPEC int ixmlElement_removeAttributeNode( /*! [in] The \b Element from which to remove the attribute. */ IXML_Element *element, /*! [in] The attribute to remove from the \b Element. */ IXML_Attr* oldAttr, /*! [out] A pointer to an attribute in which to place the removed attribute. */ IXML_Attr** rtAttr); /*! * \brief Returns a \b NodeList of all \em descendant \b Elements with * a given tag name, in the order in which they are encountered in a * pre-order traversal of this \b Element tree. * * \return A \b NodeList of the matching \b Elements or \c NULL on an error. */ EXPORT_SPEC IXML_NodeList *ixmlElement_getElementsByTagName( /*! [in] The \b Element from which to start the search. */ IXML_Element *element, /*! [in] The name of the tag for which to search. */ const DOMString tagName); /* * Introduced in DOM 2 */ /*! * \brief Retrieves an attribute value using the local name and namespace URI. * * \return A \b DOMString representing the value of the matching attribute, or * \b NULL if that attribute does not have the specified value. */ EXPORT_SPEC const DOMString ixmlElement_getAttributeNS( /*! [in] The \b Element from which to get the attribute value. */ IXML_Element *element, /*! [in] The namespace URI of the attribute. */ const DOMString namespaceURI, /*! [in] The local name of the attribute. */ const DOMString localname); /*! * \brief Adds a new attribute to an \b Element using the local name and * namespace URI. * * If another attribute matches the same local name and namespace, the prefix * is changed to be the prefix part of the \c qualifiedName and the value is * changed to \b value. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b element, * \b namespaceURI, \b qualifiedName, or \b value is * \c NULL. * \li \c IXML_INVALID_CHARACTER_ERR: \b qualifiedName contains * an invalid character. * \li \c IXML_NAMESPACE_ERR: Either the \b qualifiedName or * \b namespaceURI is malformed. Refer to the DOM2-Core for * possible reasons. * \li \c IXML_INSUFFICIENT_MEMORY: Not enough free memory exist * to complete the operation. * \li \c IXML_FAILED: The operation could not be completed. */ EXPORT_SPEC int ixmlElement_setAttributeNS( /*! [in] The \b Element on which to set the attribute. */ IXML_Element *element, /*! [in] The namespace URI of the new attribute. */ const DOMString namespaceURI, /*! [in] The qualified name of the attribute. */ const DOMString qualifiedName, /*! [in] The new value for the attribute. */ const DOMString value); /*! * \brief Removes an attribute using the namespace URI and local name. * * The replacing attribute has the same namespace URI and local name, as well * as the original prefix. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b element, * \b namespaceURI, or \b localName is \c NULL. */ EXPORT_SPEC int ixmlElement_removeAttributeNS( /*! [in] The \b Element from which to remove the the attribute. */ IXML_Element *element, /*! [in] The namespace URI of the attribute. */ const DOMString namespaceURI, /*! [in] The local name of the attribute.*/ const DOMString localName); /*! * \brief Retrieves an \b Attr node by local name and namespace URI. * * \return A pointer to an \b Attribute node with the specified attribute * local name and namespace URI or \c NULL if there is no such attribute. */ EXPORT_SPEC IXML_Attr *ixmlElement_getAttributeNodeNS( /*! [in] The \b Element from which to get the attribute. */ IXML_Element *element, /*! [in] The namespace URI of the attribute. */ const DOMString namespaceURI, /*! [in] The local name of the attribute. */ const DOMString localName); /*! * \brief Adds a new attribute node to the element node specified. * * If an attribute with the same local name and namespace URI already exists in * the \b Element, the existing attribute node is replaced with \b newAttr and * the old returned in \b rcAttr. * * \return The output parameter rcAttr receives the replaced attribute node if * the newAttr attribute replaces an existing attribute with the same local name * and namespace, otherwise rcAttr receives \b NULL. * * The function return value is an integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: Either \b element or * \b newAttr is \c NULL. * \li \c IXML_WRONG_DOCUMENT_ERR: \b newAttr does not belong * to the same document as \b element. * \li \c IXML_INUSE_ATTRIBUTE_ERR: \b newAttr already is an * attribute of another \b Element. */ EXPORT_SPEC int ixmlElement_setAttributeNodeNS( /*! [in] The \b Element in which to add the attribute node. */ IXML_Element *element, /*! [in] The new \b Attr to add. */ IXML_Attr *newAttr, /*! [out] A pointer to the replaced \b Attr, if it exists. */ IXML_Attr **rcAttr); /*! * \brief Returns a \b NodeList of all \em descendant \b Elements with a * given local name and namespace in the order in which they are encountered in * the pre-order traversal of the \b Element tree. * * \return A \b NodeList of matching \b Elements or \c NULL on an error. */ EXPORT_SPEC IXML_NodeList *ixmlElement_getElementsByTagNameNS( /*! [in] The \b Element from which to start the search. */ IXML_Element *element, /*! [in] The namespace URI of the \b Elements to find. The special value * "*" matches all namespaces. */ const DOMString namespaceURI, /*! [in] The local name of the \b Elements to find. The special value "*" * matches all local names. */ const DOMString localName); /*! * \brief Queries whether the \b Element has an attribute with the given name * or a default value. * * \return \c TRUE if the \b Element has an attribute with this name or has a * default value for that attribute, otherwise \c FALSE. */ EXPORT_SPEC BOOL ixmlElement_hasAttribute( /*! [in] The \b Element on which to check for an attribute. */ IXML_Element *element, /*! [in] The name of the attribute for which to check. */ const DOMString name); /*! * \brief Queries whether the \b Element has an attribute with the given * local name and namespace URI or has a default value for that attribute. * * \return \c TRUE if the \b Element has an attribute with the given namespace * and local name or has a default value for that attribute, otherwise \c FALSE. */ EXPORT_SPEC BOOL ixmlElement_hasAttributeNS( /*! [in] The \b Element on which to check for the attribute. */ IXML_Element *element, /*! [in] The namespace URI of the attribute. */ const DOMString namespaceURI, /*! [in] The local name of the attribute. */ const DOMString localName); /*! * \brief Frees the given \b Element and any subtree of the \b Element. */ EXPORT_SPEC void ixmlElement_free( /*! [in] The \b Element to free. */ IXML_Element *element); /* @} Interface Element */ /*! * \name Interface NamedNodeMap * * A \b NamedNodeMap object represents a list of objects that can be * accessed by name. A \b NamedNodeMap maintains the objects in * no particular order. The \b Node interface uses a \b NamedNodeMap * to maintain the attributes of a node. * * @{ */ /*! * \brief Returns the number of items contained in this \b NamedNodeMap. * * \return The number of nodes in this map. */ EXPORT_SPEC unsigned long ixmlNamedNodeMap_getLength( /*! [in] The \b NamedNodeMap from which to retrieve the size. */ IXML_NamedNodeMap *nnMap); /*! * \brief Retrieves a \b Node from the \b NamedNodeMap by name. * * \return A Node with the specified nodeName, or \b NULL if it * does not identify any node in this map. */ EXPORT_SPEC IXML_Node *ixmlNamedNodeMap_getNamedItem( /*! [in] The \b NamedNodeMap to search. */ IXML_NamedNodeMap *nnMap, /*! [in] The name of the \b Node to find. */ const DOMString name); /*! * \brief Adds a new \b Node to the \b NamedNodeMap using the \b Node name * attribute. * * \return The old \b Node if the new \b Node replaces it or \c NULL if the * \b Node was not in the \b NamedNodeMap before. */ EXPORT_SPEC IXML_Node *ixmlNamedNodeMap_setNamedItem( /*! The \b NamedNodeMap in which to add the new \b Node. */ IXML_NamedNodeMap *nnMap, /*! The new \b Node to add to the \b NamedNodeMap. */ IXML_Node *arg); /*! * \brief Removes a \b Node from a \b NamedNodeMap specified by name. * * \return A pointer to the \b Node, if found, or \c NULL if it wasn't. */ EXPORT_SPEC IXML_Node *ixmlNamedNodeMap_removeNamedItem( /*! The \b NamedNodeMap from which to remove the item. */ IXML_NamedNodeMap *nnMap, /*! The name of the item to remove. */ const DOMString name); /*! * \brief Retrieves the indexth item in the map. If index is greater than or * equal to the number of nodes in this map, this returns \b NULL. * * \return The node at the indexth position in the map, or \b NULL if that is * not a valid index. */ EXPORT_SPEC IXML_Node *ixmlNamedNodeMap_item( /*! [in] The \b NamedNodeMap from which to remove the \b Node. */ IXML_NamedNodeMap *nnMap, /*! [in] The index into the map to remove. */ unsigned long index); /* * Introduced in DOM level 2 */ /*! * \brief Retrieves a \b Node from a \b NamedNodeMap specified by namespace * URI and local name. * * \return A pointer to the \b Node, if found, or \c NULL if it wasn't */ EXPORT_SPEC IXML_Node *ixmlNamedNodeMap_getNamedItemNS( /*! The \b NamedNodeMap from which to remove the \b Node. */ IXML_NamedNodeMap *nnMap, /*! The namespace URI of the \b Node to remove. */ const DOMString *namespaceURI, /*! The local name of the \b Node to remove. */ const DOMString localName); /*! * \brief Adds a new \b Node to the \b NamedNodeMap using the \b Node * local name and namespace URI attributes. * * \return The old \b Node if the new \b Node replaces it or \c NULL if the * \b Node was not in the \b NamedNodeMap before. */ EXPORT_SPEC IXML_Node *ixmlNamedNodeMap_setNamedItemNS( /*! The \b NamedNodeMap in which to add the \b Node. */ IXML_NamedNodeMap *nnMap, /*! The \b Node to add to the map. */ IXML_Node *arg); /*! * \brief Removes a \b Node from a \b NamedNodeMap specified by * namespace URI and local name. * * \return A pointer to the \b Node, if found, or \c NULL if it wasn't. */ EXPORT_SPEC IXML_Node *ixmlNamedNodeMap_removeNamedItemNS( /*! The \b NamedNodeMap from which to remove the \b Node. */ IXML_NamedNodeMap *nnMap, /*! The namespace URI of the \b Node to remove. */ const DOMString namespaceURI, /*! The local name of the \b Node to remove. */ const DOMString localName); /*! \brief Frees a \b NamedNodeMap. * * The \b Nodes inside the map are not freed, just the \b NamedNodeMap object. */ EXPORT_SPEC void ixmlNamedNodeMap_free( /*! [in] The \b NamedNodeMap to free. */ IXML_NamedNodeMap *nnMap); /* @} Interface NodeMap */ /*! * \name Interface NodeList * * The \b NodeList interface abstracts an ordered collection of * nodes. Note that changes to the underlying nodes will change * the nodes contained in a \b NodeList. The DOM2-Core refers to * this as being \em live. * * @{ */ /*! * \brief Retrieves a \b Node from a \b NodeList specified by a * numerical index. * * \return A pointer to a \b Node or \c NULL if there was an error. */ EXPORT_SPEC IXML_Node *ixmlNodeList_item( /*! [in] The \b NodeList from which to retrieve the \b Node. */ IXML_NodeList *nList, /*! [in] The index into the \b NodeList to retrieve. */ unsigned long index); /*! * \brief Returns the number of \b Nodes in a \b NodeList. * * \return The number of \b Nodes in the \b NodeList. */ EXPORT_SPEC unsigned long ixmlNodeList_length( /*! [in] The \b NodeList for which to retrieve the number of \b Nodes. */ IXML_NodeList *nList); /*! * \brief Frees a \b NodeList object. * * Since the underlying \b Nodes are references, they are not freed using this * operation. This only frees the \b NodeList object. */ EXPORT_SPEC void ixmlNodeList_free( /*! [in] The \b NodeList to free. */ IXML_NodeList *nList); /* @} Interface NodeList */ /*! * \name IXML API * * The IXML API contains utility functions that are not part of the standard * DOM interfaces. They include functions to create a DOM structure from a * file or buffer, create an XML file from a DOM structure, and manipulate * DOMString objects. * * @{ */ /*! * \brief Renders a \b Node and all sub-elements into an XML document * representation. * * The caller is required to free the \b DOMString * returned from this function using \b ixmlFreeDOMString when it * is no longer required. * * Note that this function can be used for any \b Node-derived * interface. The difference between \b ixmlPrintDocument and * \b ixmlPrintNode is \b ixmlPrintDocument includes the XML prolog * while \b ixmlPrintNode only produces XML elements. An XML * document is not well formed unless it includes the prolog * and at least one element. * * This function introduces lots of white space to print the * \b DOMString in readable format. * * \return A \b DOMString with the XML document representation * of the DOM tree or \c NULL on an error. */ EXPORT_SPEC DOMString ixmlPrintDocument( /*! [in] The document node to print. */ IXML_Document *doc); /*! * \brief Renders a \b Node and all sub-elements into an XML text * representation. * * The caller is required to free the \b DOMString * returned from this function using \b ixmlFreeDOMString when it * is no longer required. * * Note that this function can be used for any \b Node-derived * interface. A similar \b ixmlPrintDocument function is defined * to avoid casting when printing whole documents. This function * introduces lots of white space to print the \b DOMString in readable * format. * * \return A \b DOMString with the XML text representation of the DOM tree or * \c NULL on an error. */ EXPORT_SPEC DOMString ixmlPrintNode( /*! [in] The root of the \b Node tree to render to XML text. */ IXML_Node *doc ); /*! * \brief Renders a \b Node and all sub-elements into an XML document * representation. * * The caller is required to free the \b DOMString * returned from this function using \b ixmlFreeDOMString when it * is no longer required. * * Note that this function can be used for any \b Node-derived * interface. The difference between \b ixmlDocumenttoString and * \b ixmlNodetoString is \b ixmlDocumenttoString includes the XML * prolog while \b ixmlNodetoString only produces XML elements. An XML * document is not well formed unless it includes the prolog * and at least one element. * * \return A \b DOMString with the XML text representation of the DOM tree or * \c NULL on an error. */ EXPORT_SPEC DOMString ixmlDocumenttoString( /*! [in] The root of the \b Node tree to render to XML text. */ IXML_Document *doc); /*! * \brief Renders a \b Node and all sub-elements into an XML text * representation. The caller is required to free the \b DOMString * returned from this function using \b ixmlFreeDOMString when it * is no longer required. * * Note that this function can be used for any \b Node-derived * interface. The difference between \b ixmlNodetoString and * \b ixmlDocumenttoString is \b ixmlNodetoString does not include * the XML prolog, it only produces XML elements. * * \return A \b DOMString with the XML text representation of the DOM tree or * \c NULL on an error. */ EXPORT_SPEC DOMString ixmlNodetoString( /*! [in] The root of the \b Node tree to render to XML text. */ IXML_Node *doc); /*! * \brief Makes the XML parser more tolerant to malformed text. */ EXPORT_SPEC void ixmlRelaxParser( /*! [in] If \b errorChar is 0 (default), the parser is strict about XML * encoding : invalid UTF-8 sequences or "&" entities are rejected, and * the parsing aborts. * * If \b errorChar is not 0, the parser is relaxed: invalid UTF-8 * characters are replaced by the \b errorChar, and invalid "&" entities * are left untranslated. The parsing is then allowed to continue. */ char errorChar); #ifdef IXML_HAVE_SCRIPTSUPPORT /*! * \brief Sets the handler to call before a node is freed. */ EXPORT_SPEC void ixmlSetBeforeFree( /*! [in] If \b hndlr is set to a function, it will be called before any * node is freed, with the node as its parameter. This allows scripting * languages to do their garbage collection, without maintaining their * own tree structure. */ IXML_BeforeFreeNode_t hndlr); #endif /*! * \brief Parses an XML text buffer converting it into an IXML DOM representation. * * \return A \b Document if the buffer correctly parses or \c NULL on an error. */ EXPORT_SPEC IXML_Document *ixmlParseBuffer( /*! [in] The buffer that contains the XML text to convert to a \b Document. */ const char *buffer); /*! * \brief Parses an XML text buffer converting it into an IXML DOM representation. * * The \b ixmlParseBufferEx API differs from the \b ixmlParseBuffer * API in that it returns an error code representing the actual failure * rather than just \c NULL. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: The \b buffer is not a valid * pointer. * \li \c IXML_INSUFFICIENT_MEMORY: Not enough free memory exists * to complete this operation. */ EXPORT_SPEC int ixmlParseBufferEx( /*! [in] The buffer that contains the XML text to convert to a \b Document. */ const char *buffer, /*! [out] A point to store the \b Document if file correctly parses or \b NULL on an error. */ IXML_Document** doc); /*! * \brief Parses an XML text file converting it into an IXML DOM representation. * * \return A \b Document if the file correctly parses or \c NULL on an error. */ EXPORT_SPEC IXML_Document *ixmlLoadDocument( /*! [in] The filename of the XML text to convert to a \b Document. */ const char* xmlFile); /*! * \brief Parses an XML text file converting it into an IXML DOM representation. * * The \b ixmlLoadDocumentEx API differs from the \b ixmlLoadDocument * API in that it returns a an error code representing the actual failure * rather than just \c NULL. * * \return An integer representing one of the following: * \li \c IXML_SUCCESS: The operation completed successfully. * \li \c IXML_INVALID_PARAMETER: The \b xmlFile is not a valid * pointer. * \li \c IXML_INSUFFICIENT_MEMORY: Not enough free memory exists * to complete this operation. */ EXPORT_SPEC int ixmlLoadDocumentEx( /*! [in] The filename of the XML text to convert to a \b Document. */ const char *xmlFile, /*! [out] A pointer to the \b Document if file correctly parses or \b NULL * on an error. */ IXML_Document **doc); /*! * \brief Clones an existing \b DOMString. * * \return A new \b DOMString that is a duplicate of the original or \c NULL * if the operation could not be completed. */ EXPORT_SPEC DOMString ixmlCloneDOMString( /*! [in] The source \b DOMString to clone. */ const DOMString src); /*! * \brief Frees a \b DOMString. */ EXPORT_SPEC void ixmlFreeDOMString( /*! [in] The \b DOMString to free. */ DOMString buf); /* @} IXML API */ #ifdef __cplusplus } #endif /* @} XMLAPI XML API */ #endif /* IXML_H */ pupnp-release-1.8.0/ixml/inc/ixmldebug.h000066400000000000000000000025611303304015100201450ustar00rootroot00000000000000 #ifndef IXMLDEBUG_H #define IXMLDEBUG_H #include "UpnpGlobal.h" #include "ixml.h" /*! * \file * * \brief Auxiliar routines to aid debugging. */ /*! * \brief Prints the debug statement either on the standard output or log file * along with the information from where this debug statement is coming. */ #ifdef DEBUG void IxmlPrintf( /*! [in] The file name, usually __FILE__. */ const char *DbgFileName, /*! [in] The line number, usually __LINE__ or a variable that got the * __LINE__ at the appropriate place. */ int DbgLineNo, /*! [in] The function name. */ const char *FunctionName, /*! [in] Printf like format specification. */ const char* FmtStr, /*! [in] Printf like Variable number of arguments that will go in the debug * statement. */ ...) #if (__GNUC__ >= 3) /* This enables printf like format checking by the compiler */ __attribute__((format (__printf__, 4, 5))) #endif ; #else /* DEBUG */ static UPNP_INLINE void IxmlPrintf( const char *FmtStr, ...) { FmtStr = FmtStr; } #endif /* DEBUG */ /*! * \brief Print the node names and values of a XML tree. */ #ifdef DEBUG void printNodes( /*! [in] The root of the tree to print. */ IXML_Node *tmpRoot, /*! [in] The depth to print. */ int depth); #else static UPNP_INLINE void printNodes( IXML_Node *tmpRoot, int depth) { tmpRoot = tmpRoot; depth = depth; } #endif #endif /* IXMLDEBUG_H */ pupnp-release-1.8.0/ixml/src/000077500000000000000000000000001303304015100160265ustar00rootroot00000000000000pupnp-release-1.8.0/ixml/src/attr.c000066400000000000000000000040021303304015100171400ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #include "ixmlparser.h" #include void ixmlAttr_init(IN IXML_Attr *attr) { if (attr != NULL) { memset(attr, 0, sizeof (IXML_Attr)); } } void ixmlAttr_free(IN IXML_Attr *attr) { if (attr != NULL) { ixmlNode_free((IXML_Node *)attr); } } pupnp-release-1.8.0/ixml/src/document.c000066400000000000000000000322531303304015100200150ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \file */ #include "ixmldebug.h" #include "ixmlparser.h" #include #include #include void ixmlDocument_init(IXML_Document *doc) { memset(doc, 0, sizeof(IXML_Document)); } void ixmlDocument_free(IXML_Document *doc) { if (doc != NULL) { ixmlNode_free((IXML_Node *)doc); } } /*! * When this function is called first time, nodeptr is the root of the subtree, * so it is not necessay to do two steps recursion. * * Internal function called by ixmlDocument_importNode */ static void ixmlDocument_setOwnerDocument( /*! [in] The document node. */ IXML_Document *doc, /*! [in] \todo documentation. */ IXML_Node *nodeptr) { if (nodeptr != NULL) { nodeptr->ownerDocument = doc; ixmlDocument_setOwnerDocument( doc, ixmlNode_getFirstChild(nodeptr)); ixmlDocument_setOwnerDocument( doc, ixmlNode_getNextSibling(nodeptr)); } } int ixmlDocument_importNode( IXML_Document *doc, IXML_Node *importNode, BOOL deep, IXML_Node **rtNode) { unsigned short nodeType; IXML_Node *newNode; *rtNode = NULL; if (doc == NULL || importNode == NULL) { return IXML_INVALID_PARAMETER; } nodeType = ixmlNode_getNodeType(importNode); if (nodeType == eDOCUMENT_NODE) { return IXML_NOT_SUPPORTED_ERR; } newNode = ixmlNode_cloneNode(importNode, deep); if (newNode == NULL) { return IXML_FAILED; } ixmlDocument_setOwnerDocument(doc, newNode); *rtNode = newNode; return IXML_SUCCESS; } int ixmlDocument_createElementEx( IXML_Document *doc, const DOMString tagName, IXML_Element **rtElement) { int errCode = IXML_SUCCESS; IXML_Element *newElement = NULL; if (doc == NULL || tagName == NULL) { errCode = IXML_INVALID_PARAMETER; goto ErrorHandler; } newElement = (IXML_Element *) malloc(sizeof(IXML_Element)); if (newElement == NULL) { errCode = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } ixmlElement_init(newElement); newElement->tagName = strdup(tagName); if (newElement->tagName == NULL) { ixmlElement_free(newElement); newElement = NULL; errCode = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } /* set the node fields */ newElement->n.nodeType = eELEMENT_NODE; newElement->n.nodeName = strdup(tagName); if (newElement->n.nodeName == NULL) { free(newElement->tagName); ixmlElement_free(newElement); newElement = NULL; errCode = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } newElement->n.ownerDocument = doc; ErrorHandler: *rtElement = newElement; return errCode; } IXML_Element *ixmlDocument_createElement( IXML_Document *doc, const DOMString tagName) { IXML_Element *newElement = NULL; int ret = IXML_SUCCESS; ret = ixmlDocument_createElementEx(doc, tagName, &newElement); if (ret != IXML_SUCCESS) { IxmlPrintf(__FILE__, __LINE__, "ixmlDocument_createElement", "Error %d\n", ret); return NULL; } return newElement; } int ixmlDocument_createDocumentEx(IXML_Document **rtDoc) { IXML_Document *doc; int errCode = IXML_SUCCESS; doc = NULL; doc = (IXML_Document *)malloc(sizeof (IXML_Document)); if (doc == NULL) { errCode = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } ixmlDocument_init(doc); doc->n.nodeName = strdup((const char*)DOCUMENTNODENAME); if (doc->n.nodeName == NULL) { ixmlDocument_free(doc); doc = NULL; errCode = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } doc->n.nodeType = eDOCUMENT_NODE; doc->n.ownerDocument = doc; ErrorHandler: *rtDoc = doc; return errCode; } IXML_Document *ixmlDocument_createDocument() { IXML_Document *doc = NULL; ixmlDocument_createDocumentEx(&doc); return doc; } int ixmlDocument_createTextNodeEx( IXML_Document *doc, const DOMString data, IXML_Node **textNode) { IXML_Node *returnNode; int rc = IXML_SUCCESS; returnNode = NULL; if (doc == NULL || data == NULL) { rc = IXML_INVALID_PARAMETER; goto ErrorHandler; } returnNode = (IXML_Node *)malloc(sizeof (IXML_Node)); if (returnNode == NULL) { rc = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } /* initialize the node */ ixmlNode_init(returnNode); returnNode->nodeName = strdup((const char*)TEXTNODENAME); if (returnNode->nodeName == NULL) { ixmlNode_free(returnNode); returnNode = NULL; rc = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } /* add in node value */ if (data != NULL) { returnNode->nodeValue = strdup(data); if (returnNode->nodeValue == NULL) { ixmlNode_free(returnNode); returnNode = NULL; rc = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } } returnNode->nodeType = eTEXT_NODE; returnNode->ownerDocument = doc; ErrorHandler: *textNode = returnNode; return rc; } IXML_Node *ixmlDocument_createTextNode( IXML_Document *doc, const DOMString data) { IXML_Node *returnNode = NULL; ixmlDocument_createTextNodeEx(doc, data, &returnNode); return returnNode; } int ixmlDocument_createAttributeEx( IXML_Document *doc, const DOMString name, IXML_Attr **rtAttr) { IXML_Attr *attrNode = NULL; int errCode = IXML_SUCCESS; attrNode = (IXML_Attr *)malloc(sizeof (IXML_Attr)); if (attrNode == NULL) { errCode = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } if (doc == NULL || name == NULL) { ixmlAttr_free(attrNode); attrNode = NULL; errCode = IXML_INVALID_PARAMETER; goto ErrorHandler; } ixmlAttr_init(attrNode); attrNode->n.nodeType = eATTRIBUTE_NODE; /* set the node fields */ attrNode->n.nodeName = strdup(name); if (attrNode->n.nodeName == NULL) { ixmlAttr_free(attrNode); attrNode = NULL; errCode = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } attrNode->n.ownerDocument = doc; ErrorHandler: *rtAttr = attrNode; return errCode; } IXML_Attr *ixmlDocument_createAttribute( IXML_Document *doc, const DOMString name) { IXML_Attr *attrNode = NULL; if(ixmlDocument_createAttributeEx(doc, name, &attrNode) != IXML_SUCCESS) return NULL; return attrNode; } int ixmlDocument_createAttributeNSEx( IXML_Document *doc, const DOMString namespaceURI, const DOMString qualifiedName, IXML_Attr **rtAttr ) { IXML_Attr *attrNode = NULL; int errCode = IXML_SUCCESS; if (doc == NULL || namespaceURI == NULL || qualifiedName == NULL) { errCode = IXML_INVALID_PARAMETER; goto ErrorHandler; } errCode = ixmlDocument_createAttributeEx(doc, qualifiedName, &attrNode); if (errCode != IXML_SUCCESS) { goto ErrorHandler; } /* set the namespaceURI field */ attrNode->n.namespaceURI = strdup(namespaceURI); if (attrNode->n.namespaceURI == NULL) { ixmlAttr_free(attrNode); attrNode = NULL; errCode = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } /* set the localName and prefix */ errCode = ixmlNode_setNodeName((IXML_Node *)attrNode, qualifiedName); if (errCode != IXML_SUCCESS) { ixmlAttr_free(attrNode); attrNode = NULL; goto ErrorHandler; } ErrorHandler: *rtAttr = attrNode; return errCode; } IXML_Attr *ixmlDocument_createAttributeNS( IXML_Document *doc, const DOMString namespaceURI, const DOMString qualifiedName) { IXML_Attr *attrNode = NULL; ixmlDocument_createAttributeNSEx( doc, namespaceURI, qualifiedName, &attrNode); return attrNode; } int ixmlDocument_createCDATASectionEx( IXML_Document *doc, const DOMString data, IXML_CDATASection **rtCD) { int errCode = IXML_SUCCESS; IXML_CDATASection *cDSectionNode = NULL; if(doc == NULL || data == NULL) { errCode = IXML_INVALID_PARAMETER; goto ErrorHandler; } cDSectionNode = (IXML_CDATASection *)malloc(sizeof (IXML_CDATASection)); if (cDSectionNode == NULL) { errCode = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } ixmlCDATASection_init(cDSectionNode); cDSectionNode->n.nodeType = eCDATA_SECTION_NODE; cDSectionNode->n.nodeName = strdup((const char*)CDATANODENAME); if (cDSectionNode->n.nodeName == NULL) { ixmlCDATASection_free(cDSectionNode); cDSectionNode = NULL; errCode = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } cDSectionNode->n.nodeValue = strdup(data); if (cDSectionNode->n.nodeValue == NULL) { ixmlCDATASection_free( cDSectionNode ); cDSectionNode = NULL; errCode = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } cDSectionNode->n.ownerDocument = doc; ErrorHandler: *rtCD = cDSectionNode; return errCode; } IXML_CDATASection *ixmlDocument_createCDATASection( IXML_Document *doc, const DOMString data) { IXML_CDATASection *cDSectionNode = NULL; ixmlDocument_createCDATASectionEx(doc, data, &cDSectionNode); return cDSectionNode; } int ixmlDocument_createElementNSEx( IXML_Document *doc, const DOMString namespaceURI, const DOMString qualifiedName, IXML_Element **rtElement) { IXML_Element *newElement = NULL; int ret = IXML_SUCCESS; int line = 0; if (doc == NULL || namespaceURI == NULL || qualifiedName == NULL) { line = __LINE__; ret = IXML_INVALID_PARAMETER; goto ErrorHandler; } ret = ixmlDocument_createElementEx(doc, qualifiedName, &newElement); if (ret != IXML_SUCCESS) { line = __LINE__; goto ErrorHandler; } /* set the namespaceURI field */ newElement->n.namespaceURI = strdup(namespaceURI); if (newElement->n.namespaceURI == NULL) { line = __LINE__; ixmlElement_free(newElement); newElement = NULL; ret = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } /* set the localName and prefix */ ret = ixmlNode_setNodeName((IXML_Node *)newElement, qualifiedName); if (ret != IXML_SUCCESS) { line = __LINE__; ixmlElement_free(newElement); newElement = NULL; ret = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } newElement->n.nodeValue = NULL; ErrorHandler: *rtElement = newElement; if (ret != IXML_SUCCESS) { IxmlPrintf(__FILE__, line, "ixmlDocument_createElementNSEx", "Error %d\n", ret); } return ret; } IXML_Element *ixmlDocument_createElementNS( IXML_Document *doc, const DOMString namespaceURI, const DOMString qualifiedName) { IXML_Element *newElement = NULL; ixmlDocument_createElementNSEx(doc, namespaceURI, qualifiedName, &newElement); return newElement; } IXML_NodeList *ixmlDocument_getElementsByTagName( IXML_Document *doc, const DOMString tagName) { IXML_NodeList *returnNodeList = NULL; if (doc == NULL || tagName == NULL) { return NULL; } ixmlNode_getElementsByTagName((IXML_Node *)doc, tagName, &returnNodeList); return returnNodeList; } IXML_NodeList *ixmlDocument_getElementsByTagNameNS( IXML_Document *doc, const DOMString namespaceURI, const DOMString localName) { IXML_NodeList *returnNodeList = NULL; if (doc == NULL || namespaceURI == NULL || localName == NULL) { return NULL; } ixmlNode_getElementsByTagNameNS( (IXML_Node *)doc, namespaceURI, localName, &returnNodeList); return returnNodeList; } IXML_Element *ixmlDocument_getElementById( IXML_Document *doc, const DOMString tagName) { IXML_Element *rtElement = NULL; IXML_Node *nodeptr = (IXML_Node *)doc; const char *name; if (nodeptr == NULL || tagName == NULL) { return rtElement; } if (ixmlNode_getNodeType(nodeptr) == eELEMENT_NODE) { name = ixmlNode_getNodeName(nodeptr); if (name == NULL) { return rtElement; } if (strcmp(tagName, name) == 0) { rtElement = (IXML_Element *)nodeptr; return rtElement; } else { rtElement = ixmlDocument_getElementById( (IXML_Document *)ixmlNode_getFirstChild(nodeptr), tagName ); if (rtElement == NULL) { rtElement = ixmlDocument_getElementById( (IXML_Document *)ixmlNode_getNextSibling(nodeptr), tagName); } } } else { rtElement = ixmlDocument_getElementById( (IXML_Document *)ixmlNode_getFirstChild(nodeptr), tagName); if (rtElement == NULL) { rtElement = ixmlDocument_getElementById( (IXML_Document *)ixmlNode_getNextSibling(nodeptr), tagName); } } return rtElement; } pupnp-release-1.8.0/ixml/src/element.c000066400000000000000000000405451303304015100176330ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \file */ #include "ixmlparser.h" #include #include /* for free() */ #include void ixmlElement_init(IXML_Element *element) { if (element != NULL) { memset(element, 0, sizeof (IXML_Element)); } } const DOMString ixmlElement_getTagName(IXML_Element *element) { if( element != NULL ) { return element->tagName; } else { return NULL; } } int ixmlElement_setTagName(IXML_Element *element, const char *tagName) { int rc = IXML_SUCCESS; assert(element != NULL && tagName != NULL); if (element == NULL || tagName == NULL) { return IXML_FAILED; } if (element->tagName != NULL) { free(element->tagName); } element->tagName = strdup(tagName); if (element->tagName == NULL) { rc = IXML_INSUFFICIENT_MEMORY; } return rc; } const DOMString ixmlElement_getAttribute(IXML_Element *element, const DOMString name) { IXML_Node *attrNode; if (element == NULL || name == NULL) { return NULL; } attrNode = element->n.firstAttr; while (attrNode != NULL) { if (strcmp(attrNode->nodeName, name) == 0) { return attrNode->nodeValue; } else { attrNode = attrNode->nextSibling; } } return NULL; } int ixmlElement_setAttribute( IXML_Element *element, const DOMString name, const DOMString value) { IXML_Node *attrNode; IXML_Attr *newAttrNode; int errCode = IXML_SUCCESS; if (element == NULL || name == NULL || value == NULL) { errCode = IXML_INVALID_PARAMETER; goto ErrorHandler; } if (Parser_isValidXmlName(name) == FALSE) { errCode = IXML_INVALID_CHARACTER_ERR; goto ErrorHandler; } attrNode = element->n.firstAttr; while (attrNode != NULL) { if (strcmp(attrNode->nodeName, name) == 0) { /* Found it */ break; } else { attrNode = attrNode->nextSibling; } } if (attrNode == NULL) { /* Add a new attribute */ errCode = ixmlDocument_createAttributeEx( (IXML_Document *)element->n.ownerDocument, name, &newAttrNode); if (errCode != IXML_SUCCESS) { goto ErrorHandler; } attrNode = (IXML_Node *)newAttrNode; attrNode->nodeValue = strdup(value); if (attrNode->nodeValue == NULL) { ixmlAttr_free(newAttrNode); errCode = IXML_INSUFFICIENT_MEMORY; goto ErrorHandler; } errCode = ixmlElement_setAttributeNode(element, newAttrNode, NULL); if (errCode != IXML_SUCCESS) { ixmlAttr_free(newAttrNode); goto ErrorHandler; } } else { if (attrNode->nodeValue != NULL) { /* Attribute name has a value already */ free(attrNode->nodeValue); } attrNode->nodeValue = strdup(value); if (attrNode->nodeValue == NULL) { errCode = IXML_INSUFFICIENT_MEMORY; } } ErrorHandler: return errCode; } int ixmlElement_removeAttribute(IXML_Element *element, const DOMString name) { IXML_Node *attrNode; if (element == NULL || name == NULL) { return IXML_INVALID_PARAMETER; } attrNode = element->n.firstAttr; while (attrNode != NULL) { if (strcmp(attrNode->nodeName, name) == 0) { /* Found it */ break; } else { attrNode = attrNode->nextSibling; } } if (attrNode != NULL) { /* Has the attribute */ if (attrNode->nodeValue != NULL) { free(attrNode->nodeValue); attrNode->nodeValue = NULL; } } return IXML_SUCCESS; } IXML_Attr *ixmlElement_getAttributeNode(IXML_Element *element, const DOMString name) { IXML_Node *attrNode; if (element == NULL || name == NULL) { return NULL; } attrNode = element->n.firstAttr; while (attrNode != NULL) { if (strcmp(attrNode->nodeName, name) == 0) { /* found it */ break; } else { attrNode = attrNode->nextSibling; } } return (IXML_Attr *)attrNode; } int ixmlElement_setAttributeNode( IXML_Element *element, IXML_Attr *newAttr, IXML_Attr **rtAttr) { IXML_Node *attrNode = NULL; IXML_Node *node = NULL; IXML_Node *nextAttr = NULL; IXML_Node *prevAttr = NULL; IXML_Node *preSib = NULL; IXML_Node *nextSib = NULL; if (!element || !newAttr) return IXML_INVALID_PARAMETER; if (newAttr->n.ownerDocument != element->n.ownerDocument) return IXML_WRONG_DOCUMENT_ERR; if (newAttr->ownerElement) return IXML_INUSE_ATTRIBUTE_ERR; newAttr->ownerElement = element; node = (IXML_Node *)newAttr; attrNode = element->n.firstAttr; while (attrNode) { if (!strcmp(attrNode->nodeName, node->nodeName)) /* Found it */ break; else attrNode = attrNode->nextSibling; } if (attrNode) { /* Already present, will replace by newAttr */ preSib = attrNode->prevSibling; nextSib = attrNode->nextSibling; if (preSib) preSib->nextSibling = node; if (nextSib) nextSib->prevSibling = node; if (element->n.firstAttr == attrNode) element->n.firstAttr = node; if (rtAttr) *rtAttr = (IXML_Attr *)attrNode; else ixmlAttr_free((IXML_Attr *)attrNode); } else { /* Add this attribute */ if (element->n.firstAttr) { prevAttr = element->n.firstAttr; nextAttr = prevAttr->nextSibling; while (nextAttr) { prevAttr = nextAttr; nextAttr = prevAttr->nextSibling; } prevAttr->nextSibling = node; node->prevSibling = prevAttr; } else { /* This is the first attribute node */ element->n.firstAttr = node; node->prevSibling = NULL; node->nextSibling = NULL; } if (rtAttr) *rtAttr = NULL; } return IXML_SUCCESS; } /*! * \brief Find a attribute node whose contents are the same as the oldAttr. * * \return If found, the attribute node is returned, otherwise \b NULL is * returned. */ static IXML_Node *ixmlElement_findAttributeNode( /*! [in] The element to search for the attribute. */ IXML_Element *element, /*! [in] The attribute node to match. */ IXML_Attr *oldAttr) { IXML_Node *attrNode; IXML_Node *oldAttrNode = (IXML_Node *)oldAttr; assert(element != NULL && oldAttr != NULL); attrNode = element->n.firstAttr; while (attrNode != NULL) { /* parentNode, prevSib, nextSib and ownerDocument doesn't matter */ if (ixmlNode_compare(attrNode, oldAttrNode) == TRUE) { /* Found it */ break; } else { attrNode = attrNode->nextSibling; } } return attrNode; } int ixmlElement_removeAttributeNode( IXML_Element *element, IXML_Attr *oldAttr, IXML_Attr **rtAttr) { IXML_Node *attrNode; IXML_Node *preSib; IXML_Node *nextSib; if(element == NULL || oldAttr == NULL) { return IXML_INVALID_PARAMETER; } attrNode = ixmlElement_findAttributeNode( element, oldAttr ); if (attrNode != NULL) { /* Has the attribute */ preSib = attrNode->prevSibling; nextSib = attrNode->nextSibling; if (preSib != NULL) { preSib->nextSibling = nextSib; } if (nextSib != NULL) { nextSib->prevSibling = preSib; } if (element->n.firstAttr == attrNode) { element->n.firstAttr = nextSib; } attrNode->parentNode = NULL; attrNode->prevSibling = NULL; attrNode->nextSibling = NULL; *rtAttr = (IXML_Attr *)attrNode; return IXML_SUCCESS; } else { return IXML_NOT_FOUND_ERR; } } IXML_NodeList *ixmlElement_getElementsByTagName( IXML_Element *element, const DOMString tagName) { IXML_NodeList *returnNodeList = NULL; if (element != NULL && tagName != NULL) { ixmlNode_getElementsByTagName( (IXML_Node *)element, tagName, &returnNodeList); } return returnNodeList; } const DOMString ixmlElement_getAttributeNS( IN IXML_Element *element, IN const DOMString namespaceURI, IN const DOMString localName) { IXML_Node *attrNode; if (element == NULL || namespaceURI == NULL || localName == NULL) { return NULL; } attrNode = element->n.firstAttr; while (attrNode != NULL) { if (strcmp(attrNode->localName, localName) == 0 && strcmp(attrNode->namespaceURI, namespaceURI) == 0) { /* Found it */ return attrNode->nodeValue; } else { attrNode = attrNode->nextSibling; } } return NULL; } int ixmlElement_setAttributeNS( IXML_Element *element, const DOMString namespaceURI, const DOMString qualifiedName, const DOMString value) { IXML_Node *attrNode = NULL; IXML_Node newAttrNode; IXML_Attr *newAttr; int rc; if (element == NULL || namespaceURI == NULL || qualifiedName == NULL || value == NULL) { return IXML_INVALID_PARAMETER; } if (Parser_isValidXmlName(qualifiedName) == FALSE) { return IXML_INVALID_CHARACTER_ERR; } ixmlNode_init(&newAttrNode); newAttrNode.nodeName = strdup(qualifiedName); if (newAttrNode.nodeName == NULL) { return IXML_INSUFFICIENT_MEMORY; } rc = Parser_setNodePrefixAndLocalName(&newAttrNode); if (rc != IXML_SUCCESS) { Parser_freeNodeContent(&newAttrNode); return rc; } /* see DOM 2 spec page 59 */ if ((newAttrNode.prefix != NULL && namespaceURI == NULL) || (newAttrNode.prefix != NULL && strcmp(newAttrNode.prefix, "xml") == 0 && strcmp(namespaceURI, "http://www.w3.org/XML/1998/namespace") != 0) || (strcmp(qualifiedName, "xmlns") == 0 && strcmp(namespaceURI, "http://www.w3.org/2000/xmlns/") != 0)) { Parser_freeNodeContent( &newAttrNode ); return IXML_NAMESPACE_ERR; } attrNode = element->n.firstAttr; while (attrNode != NULL) { if (strcmp(attrNode->localName, newAttrNode.localName) == 0 && strcmp(attrNode->namespaceURI, namespaceURI) == 0) { /* Found it */ break; } else { attrNode = attrNode->nextSibling; } } if (attrNode != NULL) { if (attrNode->prefix != NULL) { /* Remove the old prefix */ free(attrNode->prefix); } /* replace it with the new prefix */ if (newAttrNode.prefix != NULL) { attrNode->prefix = strdup( newAttrNode.prefix ); if (attrNode->prefix == NULL) { Parser_freeNodeContent(&newAttrNode); return IXML_INSUFFICIENT_MEMORY; } } else attrNode->prefix = newAttrNode.prefix; if (attrNode->nodeValue != NULL) { free(attrNode->nodeValue); } attrNode->nodeValue = strdup(value); if (attrNode->nodeValue == NULL) { free(attrNode->prefix); Parser_freeNodeContent(&newAttrNode); return IXML_INSUFFICIENT_MEMORY; } } else { /* Add a new attribute */ rc = ixmlDocument_createAttributeNSEx( (IXML_Document *)element->n.ownerDocument, namespaceURI, qualifiedName, &newAttr); if (rc != IXML_SUCCESS) { Parser_freeNodeContent(&newAttrNode); return rc; } newAttr->n.nodeValue = strdup(value); if (newAttr->n.nodeValue == NULL) { ixmlAttr_free(newAttr); Parser_freeNodeContent(&newAttrNode); return IXML_INSUFFICIENT_MEMORY; } if (ixmlElement_setAttributeNodeNS(element, newAttr, &newAttr) != IXML_SUCCESS) { ixmlAttr_free(newAttr); Parser_freeNodeContent(&newAttrNode); return IXML_FAILED; } } Parser_freeNodeContent(&newAttrNode); return IXML_SUCCESS; } int ixmlElement_removeAttributeNS( IXML_Element *element, const DOMString namespaceURI, const DOMString localName) { IXML_Node *attrNode = NULL; if (element == NULL || namespaceURI == NULL || localName == NULL) { return IXML_INVALID_PARAMETER; } attrNode = element->n.firstAttr; while (attrNode != NULL) { if (strcmp(attrNode->localName, localName) == 0 && strcmp(attrNode->namespaceURI, namespaceURI) == 0) { /* Found it */ break; } else { attrNode = attrNode->nextSibling; } } if(attrNode != NULL) { /* Has the attribute */ if(attrNode->nodeValue != NULL) { free(attrNode->nodeValue); attrNode->nodeValue = NULL; } } return IXML_SUCCESS; } IXML_Attr *ixmlElement_getAttributeNodeNS( IXML_Element *element, const DOMString namespaceURI, const DOMString localName) { IXML_Node *attrNode = NULL; if (element == NULL || namespaceURI == NULL || localName == NULL) { return NULL; } attrNode = element->n.firstAttr; while (attrNode != NULL) { if (strcmp(attrNode->localName, localName) == 0 && strcmp(attrNode->namespaceURI, namespaceURI) == 0) { /* found it */ break; } else { attrNode = attrNode->nextSibling; } } return (IXML_Attr *)attrNode; } int ixmlElement_setAttributeNodeNS( IN IXML_Element *element, IN IXML_Attr *newAttr, OUT IXML_Attr **rtAttr) { IXML_Node *attrNode = NULL; IXML_Node *node = NULL; IXML_Node *prevAttr = NULL; IXML_Node *nextAttr = NULL; IXML_Node *preSib = NULL; IXML_Node *nextSib = NULL; if (element == NULL || newAttr == NULL) { return IXML_INVALID_PARAMETER; } if (newAttr->n.ownerDocument != element->n.ownerDocument) { return IXML_WRONG_DOCUMENT_ERR; } if (newAttr->ownerElement != NULL && newAttr->ownerElement != element) { return IXML_INUSE_ATTRIBUTE_ERR; } newAttr->ownerElement = element; node = (IXML_Node *)newAttr; attrNode = element->n.firstAttr; while (attrNode != NULL) { if (strcmp(attrNode->localName, node->localName) == 0 && strcmp(attrNode->namespaceURI, node->namespaceURI) == 0) { /* Found it */ break; } else { attrNode = attrNode->nextSibling; } } if (attrNode != NULL) { /* already present, will replace by newAttr */ preSib = attrNode->prevSibling; nextSib = attrNode->nextSibling; if (preSib != NULL) { preSib->nextSibling = node; } if (nextSib != NULL) { nextSib->prevSibling = node; } if (element->n.firstAttr == attrNode) { element->n.firstAttr = node; } *rtAttr = (IXML_Attr *)attrNode; } else { /* Add this attribute */ if (element->n.firstAttr != NULL) { /* Element has attribute already */ prevAttr = element->n.firstAttr; nextAttr = prevAttr->nextSibling; while (nextAttr != NULL) { prevAttr = nextAttr; nextAttr = prevAttr->nextSibling; } prevAttr->nextSibling = node; } else { /* This is the first attribute node */ element->n.firstAttr = node; node->prevSibling = NULL; node->nextSibling = NULL; } if (rtAttr != NULL) { *rtAttr = NULL; } } return IXML_SUCCESS; } IXML_NodeList *ixmlElement_getElementsByTagNameNS( IXML_Element *element, const DOMString namespaceURI, const DOMString localName) { IXML_Node *node = (IXML_Node *)element; IXML_NodeList *nodeList = NULL; if(element != NULL && namespaceURI != NULL && localName != NULL) { ixmlNode_getElementsByTagNameNS( node, namespaceURI, localName, &nodeList); } return nodeList; } BOOL ixmlElement_hasAttribute( IXML_Element *element, const DOMString name) { IXML_Node *attrNode = NULL; if (element == NULL || name == NULL) { return FALSE; } attrNode = element->n.firstAttr; while (attrNode != NULL) { if (strcmp(attrNode->nodeName, name) == 0) { return TRUE; } else { attrNode = attrNode->nextSibling; } } return FALSE; } BOOL ixmlElement_hasAttributeNS( IXML_Element * element, const DOMString namespaceURI, const DOMString localName ) { IXML_Node *attrNode = NULL; if (element == NULL || namespaceURI == NULL || localName == NULL) { return FALSE; } attrNode = element->n.firstAttr; while (attrNode != NULL) { if (strcmp(attrNode->localName, localName) == 0 && strcmp(attrNode->namespaceURI, namespaceURI) == 0) { return TRUE; } else { attrNode = attrNode->nextSibling; } } return FALSE; } void ixmlElement_free(IXML_Element *element) { if (element != NULL) { ixmlNode_free((IXML_Node *)element); } } pupnp-release-1.8.0/ixml/src/inc/000077500000000000000000000000001303304015100165775ustar00rootroot00000000000000pupnp-release-1.8.0/ixml/src/inc/ixmlmembuf.h000066400000000000000000000114611303304015100211200ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ #ifndef IXML_MEMBUF_H #define IXML_MEMBUF_H /*! * \file */ #include "ixml.h" #include /* for size_t */ #define MINVAL(a, b) ( (a) < (b) ? (a) : (b) ) #define MAXVAL(a, b) ( (a) > (b) ? (a) : (b) ) #define MEMBUF_DEF_SIZE_INC 20u /*! * \brief The ixml_membuf type. */ typedef struct { char *buf; size_t length; size_t capacity; size_t size_inc; } ixml_membuf; /*! * \brief ixml_membuf initialization routine. */ void ixml_membuf_init( /*! [in,out] The memory buffer to initializa. */ ixml_membuf *m); /*! * \brief ixml_membuf clearing routine. * * The internal buffer is deleted and ixml_membuf_init() is called in the end * to reinitialize the buffer. */ void ixml_membuf_destroy( /*! [in,out] The memory buffer to clear. */ ixml_membuf *m); /*! * \brief Copies the contents o a buffer to the designated ixml_membuf. * * The previous contents of the ixml_membuf are destroyed. * * \return IXML_SUCCESS if successfull, or the error code returned * by ixml_membuf_set_size(). * * \sa ixml_membuf_assign_str(). */ int ixml_membuf_assign( /*! [in,out] The memory buffer on which to operate. */ ixml_membuf *m, /*! [in] The input buffer to copy from. */ const void *buf, /*! [in] The number of bytes to copy from the input buffer. */ size_t buf_len); /*! * \brief Copies a \b NULL terminated string to the ixml_buffer. * * This is a convenience function that internally uses ixml_membuf_assign(). * * \return The return value of ixml_membuf_assign(). * * \sa ixml_membuf_assign(). */ int ixml_membuf_assign_str( /*! [in,out] The memory buffer on which to operate. */ ixml_membuf *m, /*! [in] The input string to copy from. */ const char *c_str); /*! * \brief Appends one byte to the designated ixml_membuffer. * * This is a convenience function that internally uses ixml_membuf_insert(). * * \return The return value of ixml_membuf_insert(). * * \sa ixml_membuf_insert() */ int ixml_membuf_append( /*! [in,out] The memory buffer on which to operate. */ ixml_membuf *m, /*! [in] The pointer to the byte to append. */ const void *buf); /*! * \brief Appends the contents of a \b NULL terminated string to the designated * ixml_membuf. * * This is a convenience function that internally uses ixml_membuf_insert(). * * \return The return value of ixml_membuf_insert(). * * \sa ixml_membuf_insert(). */ int ixml_membuf_append_str( /*! [in,out] The memory buffer on which to operate. */ ixml_membuf *m, /*! [in] The input string to copy from. */ const char *c_str); /*! * \brief * * \return * \li 0 if successfull. * \li IXML_INDEX_SIZE_ERR if the index parameter is out of range. * \li Or the return code of ixml_membuf_set_size() * * \sa ixml_membuf_set_size() */ int ixml_membuf_insert( /*! [in,out] The memory buffer on which to operate. */ ixml_membuf *m, /*! [in] The pointer to the input buffer. */ const void *buf, /*! [in] The buffer length. */ size_t buf_len, /*! [in] The point of insertion relative to the beggining of the * ixml_membuf internal buffer. */ size_t index); #endif /* IXML_MEMBUF_H */ pupnp-release-1.8.0/ixml/src/inc/ixmlparser.h000066400000000000000000000160411303304015100211400ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ #ifndef IXMLPARSER_H #define IXMLPARSER_H /*! * \file */ #include "ixml.h" #include "ixmlmembuf.h" /* Parser definitions */ #define QUOT """ #define LT "<" #define GT ">" #define APOS "'" #define AMP "&" #define ESC_HEX "&#x" #define ESC_DEC "&#" typedef struct _IXML_NamespaceURI { char *nsURI; char *prefix; struct _IXML_NamespaceURI *nextNsURI; } IXML_NamespaceURI; typedef struct _IXML_ElementStack { char *element; char *prefix; char *namespaceUri; IXML_NamespaceURI *pNsURI; struct _IXML_ElementStack *nextElement; } IXML_ElementStack; typedef enum { eELEMENT, eATTRIBUTE, eCONTENT, } PARSER_STATE; typedef struct _Parser { /*! Data buffer. */ char *dataBuffer; /*! Pointer to the token parsed. */ char *curPtr; /*! Saves for backup. */ char *savePtr; ixml_membuf lastElem; ixml_membuf tokenBuf; IXML_Node *pNeedPrefixNode; IXML_ElementStack *pCurElement; IXML_Node *currentNodePtr; PARSER_STATE state; BOOL bHasTopLevel; } Parser; /*! * \brief Check to see whether name is a valid xml name. */ BOOL Parser_isValidXmlName( /*! [in] The string to be checked. */ const DOMString name); /*! * \brief Sets the error character. * * If 'c' is 0 (default), the parser is strict about XML encoding: * invalid UTF-8 sequences or "&" entities are rejected, and the parsing * aborts. * * If 'c' is not 0, the parser is relaxed: invalid UTF-8 characters * are replaced by this character, and invalid "&" entities are left * untranslated. The parsing is then allowed to continue. */ void Parser_setErrorChar( /*! [in] The character to become the error character. */ char c); #ifdef IXML_HAVE_SCRIPTSUPPORT /*! * \brief Sets the handler to call before a node is freed. * * If \b hndlr is set to a function, it will be called before any * node is freed, with the node as its parameter. This allows scripting * languages to do their garbage collection, without maintaining their * own tree structure. */ void Parser_setBeforeFree( /*! [in] The handler callback to call before each node to be freed. */ IXML_BeforeFreeNode_t hndlr); /*! * \brief Gets the handler to call before a node is freed. */ IXML_BeforeFreeNode_t Parser_getBeforeFree(); #endif /*! * \brief Fees a node contents. */ void Parser_freeNodeContent( /*! [in] The Node to process. */ IXML_Node *IXML_Nodeptr); int Parser_LoadDocument(IXML_Document **retDoc, const char * xmlFile, BOOL file); int Parser_setNodePrefixAndLocalName(IXML_Node *newIXML_NodeIXML_Attr); void ixmlAttr_init(IXML_Attr *attrNode); /*! * \brief Set the given element's tagName. * * \return One of the following: * \li \b IXML_SUCCESS, if successfull. * \li \b IXML_FAILED, if element of tagname is \b NULL. * \li \b IXML_INSUFFICIENT_MEMORY, if there is no memory to allocate the * buffer for the element's tagname. */ int ixmlElement_setTagName( /*! [in] The element to change the tagname. */ IXML_Element *element, /*! [in] The new tagName for the element. */ const char *tagName); /*! * \brief Initializes a NamedNodeMap object. */ void ixmlNamedNodeMap_init( /*! [in] The named node map to process. */ IXML_NamedNodeMap *nnMap); /*! * \brief Add a node to a NamedNodeMap. * * \return IXML_SUCCESS or failure. */ int ixmlNamedNodeMap_addToNamedNodeMap( /* [in] The named node map. */ IXML_NamedNodeMap **nnMap, /* [in] The node to add. */ IXML_Node *add); /*! * \brief Add a node to nodelist. */ int ixmlNodeList_addToNodeList( /*! [in] The pointer to the nodelist. */ IXML_NodeList **nList, /*! [in] The node to add. */ IXML_Node *add); /*! * \brief Intializes a node. */ void ixmlNode_init( /*! [in] The \b Node to iniatialize. */ IN IXML_Node *nodeptr); /*! * \brief Compare two nodes to see whether they are the same node. * Parent, sibling and children node are ignored. * * \return * \li TRUE, the two nodes are the same. * \li FALSE, the two nodes are not the same. */ BOOL ixmlNode_compare( /*! [in] The first \b Node. */ IXML_Node *srcNode, /*! [in] The second \b Node. */ IXML_Node *destNode); /*! * \brief Returns a nodeList of all descendant Elements with a given tagName, * in the order in which they are encountered in a traversal of this element * tree. */ void ixmlNode_getElementsByTagName( /*! [in] The \b Node tree. */ IXML_Node *n, /*! [in] The tag name to match. */ const char *tagname, /*! [out] The output \b NodeList. */ IXML_NodeList **list); /*! * \brief Returns a nodeList of all the descendant Elements with a given local * name and namespace URI in the order in which they are encountered in a * preorder traversal of this Elememt tree. */ void ixmlNode_getElementsByTagNameNS( /*! [in] The \b Element tree. */ IXML_Node *n, /*! [in] The name space to match. */ const char *namespaceURI, /*! [in] The local name to match. */ const char *localName, /*! [out] The output \b NodeList. */ IXML_NodeList **list); /*! * \brief * * \return */ int ixmlNode_setNodeName( /*! [in] The \b Node. */ IXML_Node *node, /*! [in] . */ const DOMString qualifiedName); /*! * \brief * * \return */ int ixmlNode_setNodeProperties( /*! [in] . */ IXML_Node *destNode, /*! [in] . */ IXML_Node *src); /*! * \brief Initializes a nodelist */ void ixmlNodeList_init( /*! [in,out] The \b NodeList to initialize. */ IXML_NodeList *nList); #endif /* IXMLPARSER_H */ pupnp-release-1.8.0/ixml/src/ixml.c000066400000000000000000000255421303304015100171530ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ /*! * \file */ #include "ixmldebug.h" #include "ixmlmembuf.h" #include "ixmlparser.h" #include /* for free() */ #include /*! * \brief Appends a string to a buffer, substituting some characters by escape * sequences. */ static void copy_with_escape( /*! [in,out] The input/output buffer. */ ixml_membuf *buf, /*! [in] The string to copy from. */ const char *p) { size_t i; size_t plen; if (p == NULL) return; plen = strlen(p); for (i = (size_t)0; i < plen; ++i) { switch (p[i]) { case '<': ixml_membuf_append_str(buf, "<"); break; case '>': ixml_membuf_append_str(buf, ">"); break; case '&': ixml_membuf_append_str(buf, "&"); break; case '\'': ixml_membuf_append_str(buf, "'"); break; case '\"': ixml_membuf_append_str(buf, """); break; default: ixml_membuf_append(buf, &p[i]); break; } } } /*! * \brief Recursive function to print all the node in a tree. * Internal to parser only. */ static void ixmlPrintDomTreeRecursive( /*! [in] \todo documentation. */ IXML_Node *nodeptr, /*! [in] \todo documentation. */ ixml_membuf *buf) { const char *nodeName = NULL; const char *nodeValue = NULL; IXML_Node *child = NULL, *sibling = NULL; if (nodeptr != NULL) { nodeName = (const char *)ixmlNode_getNodeName(nodeptr); nodeValue = ixmlNode_getNodeValue(nodeptr); switch (ixmlNode_getNodeType(nodeptr)) { case eTEXT_NODE: copy_with_escape(buf, nodeValue); break; case eCDATA_SECTION_NODE: ixml_membuf_append_str(buf, ""); break; case ePROCESSING_INSTRUCTION_NODE: ixml_membuf_append_str(buf, "\n"); break; case eDOCUMENT_NODE: ixmlPrintDomTreeRecursive( ixmlNode_getFirstChild(nodeptr), buf); break; case eATTRIBUTE_NODE: ixml_membuf_append_str(buf, nodeName); ixml_membuf_append_str(buf, "=\""); copy_with_escape(buf, nodeValue); ixml_membuf_append_str(buf, "\""); if (nodeptr->nextSibling != NULL) { ixml_membuf_append_str(buf, " "); ixmlPrintDomTreeRecursive(nodeptr->nextSibling, buf); } break; case eELEMENT_NODE: ixml_membuf_append_str(buf, "<"); ixml_membuf_append_str(buf, nodeName); if (nodeptr->firstAttr != NULL) { ixml_membuf_append_str(buf, " "); ixmlPrintDomTreeRecursive(nodeptr->firstAttr, buf); } child = ixmlNode_getFirstChild(nodeptr); if (child != NULL && ixmlNode_getNodeType(child) == eELEMENT_NODE) { ixml_membuf_append_str(buf, ">\r\n"); } else { ixml_membuf_append_str(buf, ">"); } /* output the children */ ixmlPrintDomTreeRecursive( ixmlNode_getFirstChild(nodeptr), buf); /* Done with children. Output the end tag. */ ixml_membuf_append_str(buf, "" ); } else { ixml_membuf_append_str( buf, ">\r\n" ); } ixmlPrintDomTreeRecursive( ixmlNode_getNextSibling(nodeptr), buf); break; default: IxmlPrintf(__FILE__, __LINE__, "ixmlPrintDomTreeRecursive", "Warning, unknown node type %d\n", (int)ixmlNode_getNodeType(nodeptr)); break; } } } /*! * \brief Print a DOM tree. * * Element, and Attribute nodes are handled differently. We don't want to print * the Element and Attribute nodes' sibling. */ static void ixmlPrintDomTree( /*! [in] \todo documentation. */ IXML_Node *nodeptr, /*! [in] \todo documentation. */ ixml_membuf *buf) { const char *nodeName = NULL; const char *nodeValue = NULL; IXML_Node *child = NULL; if (nodeptr == NULL || buf == NULL) { return; } nodeName = (const char *)ixmlNode_getNodeName(nodeptr); nodeValue = ixmlNode_getNodeValue(nodeptr); switch (ixmlNode_getNodeType(nodeptr)) { case eTEXT_NODE: case eCDATA_SECTION_NODE: case ePROCESSING_INSTRUCTION_NODE: case eDOCUMENT_NODE: ixmlPrintDomTreeRecursive(nodeptr, buf); break; case eATTRIBUTE_NODE: ixml_membuf_append_str(buf, nodeName); ixml_membuf_append_str(buf, "=\""); copy_with_escape(buf, nodeValue); ixml_membuf_append_str(buf, "\""); break; case eELEMENT_NODE: ixml_membuf_append_str(buf, "<"); ixml_membuf_append_str(buf, nodeName); if (nodeptr->firstAttr != NULL) { ixml_membuf_append_str(buf, " "); ixmlPrintDomTreeRecursive(nodeptr->firstAttr, buf); } child = ixmlNode_getFirstChild(nodeptr); if (child != NULL && ixmlNode_getNodeType(child) == eELEMENT_NODE) { ixml_membuf_append_str(buf, ">\r\n"); } else { ixml_membuf_append_str(buf, ">"); } /* output the children */ ixmlPrintDomTreeRecursive( ixmlNode_getFirstChild(nodeptr), buf); /* Done with children. Output the end tag. */ ixml_membuf_append_str(buf, "\r\n"); break; default: IxmlPrintf(__FILE__, __LINE__, "ixmlPrintDomTree", "Warning, unknown node type %d\n", (int)ixmlNode_getNodeType(nodeptr)); break; } } /*! * \brief Converts a DOM tree into a text string. * * Element, and Attribute nodes are handled differently. We don't want to print * the Element and Attribute nodes' sibling. */ static void ixmlDomTreetoString( /*! [in] \todo documentation. */ IXML_Node *nodeptr, /*! [in] \todo documentation. */ ixml_membuf *buf) { const char *nodeName = NULL; const char *nodeValue = NULL; IXML_Node *child = NULL; if (nodeptr == NULL || buf == NULL) { return; } nodeName = (const char *)ixmlNode_getNodeName(nodeptr); nodeValue = ixmlNode_getNodeValue(nodeptr); switch (ixmlNode_getNodeType(nodeptr)) { case eTEXT_NODE: case eCDATA_SECTION_NODE: case ePROCESSING_INSTRUCTION_NODE: case eDOCUMENT_NODE: ixmlPrintDomTreeRecursive(nodeptr, buf); break; case eATTRIBUTE_NODE: ixml_membuf_append_str(buf, nodeName); ixml_membuf_append_str(buf, "=\""); copy_with_escape(buf, nodeValue ); ixml_membuf_append_str(buf, "\""); break; case eELEMENT_NODE: ixml_membuf_append_str(buf, "<"); ixml_membuf_append_str(buf, nodeName); if (nodeptr->firstAttr != NULL) { ixml_membuf_append_str(buf, " "); ixmlPrintDomTreeRecursive(nodeptr->firstAttr, buf); } child = ixmlNode_getFirstChild(nodeptr); if (child != NULL && ixmlNode_getNodeType(child) == eELEMENT_NODE) { ixml_membuf_append_str(buf, ">"); } else { ixml_membuf_append_str(buf, ">"); } /* output the children */ ixmlPrintDomTreeRecursive(ixmlNode_getFirstChild(nodeptr), buf); /* Done with children. Output the end tag. */ ixml_membuf_append_str(buf, ""); break; default: IxmlPrintf(__FILE__, __LINE__, "ixmlPrintDomTreeRecursive", "Warning, unknown node type %d\n", (int)ixmlNode_getNodeType(nodeptr)); break; } } int ixmlLoadDocumentEx(const char *xmlFile, IXML_Document **doc) { if (xmlFile == NULL || doc == NULL) { return IXML_INVALID_PARAMETER; } return Parser_LoadDocument(doc, xmlFile, TRUE); } IXML_Document *ixmlLoadDocument(const char *xmlFile) { IXML_Document *doc = NULL; ixmlLoadDocumentEx(xmlFile, &doc); return doc; } DOMString ixmlPrintDocument(IXML_Document *doc) { IXML_Node* rootNode = (IXML_Node *)doc; ixml_membuf memBuf; ixml_membuf *buf = &memBuf; if(rootNode == NULL) { return NULL; } ixml_membuf_init(buf); ixml_membuf_append_str(buf, "\r\n"); ixmlPrintDomTree(rootNode, buf); return buf->buf; } DOMString ixmlPrintNode(IXML_Node *node) { ixml_membuf memBuf; ixml_membuf *buf = &memBuf; if (node == NULL) { return NULL; } ixml_membuf_init(buf); ixmlPrintDomTree(node, buf); return buf->buf; } DOMString ixmlDocumenttoString(IXML_Document *doc) { IXML_Node* rootNode = (IXML_Node *)doc; ixml_membuf memBuf; ixml_membuf *buf = &memBuf; if(rootNode == NULL) { return NULL; } ixml_membuf_init(buf); ixml_membuf_append_str(buf, "\r\n"); ixmlDomTreetoString(rootNode, buf); return buf->buf; } DOMString ixmlNodetoString(IXML_Node *node) { ixml_membuf memBuf; ixml_membuf *buf = &memBuf; if (node == NULL) { return NULL; } ixml_membuf_init(buf); ixmlDomTreetoString(node, buf); return buf->buf; } void ixmlRelaxParser(char errorChar) { Parser_setErrorChar(errorChar); } #ifdef IXML_HAVE_SCRIPTSUPPORT void ixmlSetBeforeFree(IXML_BeforeFreeNode_t hndlr) { Parser_setBeforeFree(hndlr); } #endif int ixmlParseBufferEx(const char *buffer, IXML_Document **retDoc) { if (buffer == NULL || retDoc == NULL) { return IXML_INVALID_PARAMETER; } if (buffer[0] == '\0') { return IXML_INVALID_PARAMETER; } return Parser_LoadDocument(retDoc, buffer, FALSE); } IXML_Document *ixmlParseBuffer(const char *buffer) { IXML_Document *doc = NULL; ixmlParseBufferEx(buffer, &doc); return doc; } DOMString ixmlCloneDOMString(const DOMString src) { if (src == NULL) { return NULL; } return strdup(src); } void ixmlFreeDOMString(DOMString buf) { if (buf != NULL) { free(buf); } } pupnp-release-1.8.0/ixml/src/ixmldebug.c000066400000000000000000000025211303304015100201520ustar00rootroot00000000000000 /*! * \file */ #include "autoconfig.h" #include "ixmldebug.h" #include #include #ifdef DEBUG void IxmlPrintf( const char *DbgFileName, int DbgLineNo, const char *FunctionName, const char *FmtStr, ...) { va_list ArgList; FILE *fp = stdout; fprintf(fp, "(%s::%s), line %d", DbgFileName, FunctionName, DbgLineNo); if (FmtStr) { fprintf(fp, ": "); va_start(ArgList, FmtStr); vfprintf(fp, FmtStr, ArgList); fflush(fp); va_end(ArgList); } else { fprintf(fp, "\n"); } } void printNodes(IXML_Node *tmpRoot, int depth) { unsigned long i; IXML_NodeList *NodeList1; IXML_Node *ChildNode1; unsigned short NodeType; const DOMString NodeValue; const DOMString NodeName; NodeList1 = ixmlNode_getChildNodes(tmpRoot); for (i = 0; i < 100; ++i) { ChildNode1 = ixmlNodeList_item(NodeList1, i); if (ChildNode1 == NULL) { break; } printNodes(ChildNode1, depth+1); NodeType = ixmlNode_getNodeType(ChildNode1); NodeValue = ixmlNode_getNodeValue(ChildNode1); NodeName = ixmlNode_getNodeName(ChildNode1); IxmlPrintf(__FILE__, __LINE__, "printNodes", "DEPTH-%2d-IXML_Node Type %d, " "IXML_Node Name: %s, IXML_Node Value: %s\n", depth, NodeType, NodeName, NodeValue); } } #endif pupnp-release-1.8.0/ixml/src/ixmlmembuf.c000066400000000000000000000115721303304015100203450ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ /*! * \file */ #include "ixmlmembuf.h" #include "ixml.h" #include #include #include /*! * \brief Increases or decreases buffer capacity so that at least 'new_length' * bytes can be stored. * * On error, m's fields do not change. * * \return * \li UPNP_E_SUCCESS * \li UPNP_E_OUTOF_MEMORY */ static int ixml_membuf_set_size( /*! [in,out] The memory buffer. */ INOUT ixml_membuf *m, /*! [in] The new lenght. */ IN size_t new_length) { size_t diff; size_t alloc_len; char *temp_buf; if (new_length >= m->length) { /* increase length */ /* need more mem? */ if (new_length <= m->capacity) { /* have enough mem; done */ return 0; } diff = new_length - m->length; alloc_len = MAXVAL(m->size_inc, diff) + m->capacity; } else { /* decrease length */ assert(new_length <= m->length); /* if diff is 0..m->size_inc, don't free */ if ((m->capacity - new_length) <= m->size_inc) { return 0; } alloc_len = new_length + m->size_inc; } assert(alloc_len >= new_length); temp_buf = realloc(m->buf, alloc_len + (size_t)1); if (temp_buf == NULL) { /* try smaller size */ alloc_len = new_length; temp_buf = realloc(m->buf, alloc_len + (size_t)1); if (temp_buf == NULL) { return IXML_INSUFFICIENT_MEMORY; } } /* save */ m->buf = temp_buf; m->capacity = alloc_len; return 0; } void ixml_membuf_init(ixml_membuf *m) { assert(m != NULL); m->size_inc = MEMBUF_DEF_SIZE_INC; m->buf = NULL; m->length = (size_t)0; m->capacity = (size_t)0; } void ixml_membuf_destroy(ixml_membuf *m) { if (m == NULL) { return; } free(m->buf); ixml_membuf_init(m); } int ixml_membuf_assign( ixml_membuf *m, const void *buf, size_t buf_len) { int return_code; assert(m != NULL); /* set value to null */ if (buf == NULL) { ixml_membuf_destroy(m); return IXML_SUCCESS; } /* alloc mem */ return_code = ixml_membuf_set_size(m, buf_len); if (return_code != 0) { return return_code; } /* copy */ memcpy(m->buf, buf, buf_len); /* null-terminate */ m->buf[buf_len] = 0; m->length = buf_len; return IXML_SUCCESS; } int ixml_membuf_assign_str( ixml_membuf *m, const char *c_str) { return ixml_membuf_assign(m, c_str, strlen(c_str)); } int ixml_membuf_append( INOUT ixml_membuf *m, IN const void *buf) { assert(m != NULL); return ixml_membuf_insert(m, buf, (size_t)1, m->length); } int ixml_membuf_append_str( INOUT ixml_membuf *m, IN const char *c_str) { return ixml_membuf_insert(m, c_str, strlen(c_str), m->length); } int ixml_membuf_insert( INOUT ixml_membuf *m, IN const void *buf, IN size_t buf_len, size_t index) { int return_code = 0; assert(m != NULL); if (index > m->length) { return IXML_INDEX_SIZE_ERR; } if (buf == NULL || buf_len == (size_t)0) { return 0; } /* alloc mem */ return_code = ixml_membuf_set_size(m, m->length + buf_len); if (return_code != 0) { return return_code; } /* insert data */ /* move data to right of insertion point */ memmove(m->buf + index + buf_len, m->buf + index, m->length - index); memcpy(m->buf + index, buf, buf_len); m->length += buf_len; /* Null terminate */ m->buf[m->length] = 0; return 0; } pupnp-release-1.8.0/ixml/src/ixmlparser.c000066400000000000000000002116021303304015100203620ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \file */ #include "ixmlparser.h" #include "ixmldebug.h" #include #include /* for ptrdiff_t */ #include #include /* for free(), malloc() */ #include #ifdef WIN32 #define strncasecmp strnicmp #endif static char g_error_char = '\0'; #ifdef IXML_HAVE_SCRIPTSUPPORT static IXML_BeforeFreeNode_t Before_Free_callback; #endif static const char LESSTHAN = '<'; static const char GREATERTHAN = '>'; static const char SLASH = '/'; static const char EQUALS = '='; static const char QUOTE = '\"'; static const char SINGLEQUOTE = '\''; static const char *WHITESPACE = "\n\t\r "; static const char *COMPLETETAG = "/>"; static const char *ENDTAG = ""; static const char *BEGIN_PI = ""; static const char *BEGIN_DOCTYPE = ""; static const char *DEC_NUMBERS = "0123456789"; static const char *HEX_NUMBERS = "0123456789ABCDEFabcdef"; typedef struct char_info { unsigned short l; unsigned short h; } char_info_t; typedef char utf8char[8]; /*! * \brief The letter table contains all characters in XML 1.0 plus ":", "_" and * ideographic. * * This table contains all the characters that an element name can start with. * See XML 1.0 (2nd Edition) for more details. */ static char_info_t Letter[] = { {0x003A, 0x003A}, /* character ":" */ {0x0041, 0x005A}, {0x005F, 0x005F}, /* character "_" */ {0x0061, 0x007A}, {0x00C0, 0x00D6}, {0x00D8, 0x00F6}, {0x00F8, 0x00FF}, {0x0100, 0x0131}, {0x0134, 0x013E}, {0x0141, 0x0148}, {0x014A, 0x017E}, {0x0180, 0x01C3}, {0x01CD, 0x01F0}, {0x01F4, 0x01F5}, {0x01FA, 0x0217}, {0x0250, 0x02A8}, {0x02BB, 0x02C1}, {0x0386, 0x0386}, {0x0388, 0x038A}, {0x038C, 0x038C}, {0x038E, 0x03A1}, {0x03A3, 0x03CE}, {0x03D0, 0x03D6}, {0x03DA, 0x03DA}, {0x03DC, 0x03DC}, {0x03DE, 0x03DE}, {0x03E0, 0x03E0}, {0x03E2, 0x03F3}, {0x0401, 0x040C}, {0x040E, 0x044F}, {0x0451, 0x045C}, {0x045E, 0x0481}, {0x0490, 0x04C4}, {0x04C7, 0x04C8}, {0x04CB, 0x04CC}, {0x04D0, 0x04EB}, {0x04EE, 0x04F5}, {0x04F8, 0x04F9}, {0x0531, 0x0556}, {0x0559, 0x0559}, {0x0561, 0x0586}, {0x05D0, 0x05EA}, {0x05F0, 0x05F2}, {0x0621, 0x063A}, {0x0641, 0x064A}, {0x0671, 0x06B7}, {0x06BA, 0x06BE}, {0x06C0, 0x06CE}, {0x06D0, 0x06D3}, {0x06D5, 0x06D5}, {0x06E5, 0x06E6}, {0x0905, 0x0939}, {0x093D, 0x093D}, {0x0958, 0x0961}, {0x0985, 0x098C}, {0x098F, 0x0990}, {0x0993, 0x09A8}, {0x09AA, 0x09B0}, {0x09B2, 0x09B2}, {0x09B6, 0x09B9}, {0x09DC, 0x09DD}, {0x09DF, 0x09E1}, {0x09F0, 0x09F1}, {0x0A05, 0x0A0A}, {0x0A0F, 0x0A10}, {0x0A13, 0x0A28}, {0x0A2A, 0x0A30}, {0x0A32, 0x0A33}, {0x0A35, 0x0A36}, {0x0A38, 0x0A39}, {0x0A59, 0x0A5C}, {0x0A5E, 0x0A5E}, {0x0A72, 0x0A74}, {0x0A85, 0x0A8B}, {0x0A8D, 0x0A8D}, {0x0A8F, 0x0A91}, {0x0A93, 0x0AA8}, {0x0AAA, 0x0AB0}, {0x0AB2, 0x0AB3}, {0x0AB5, 0x0AB9}, {0x0ABD, 0x0ABD}, {0x0AE0, 0x0AE0}, {0x0B05, 0x0B0C}, {0x0B0F, 0x0B10}, {0x0B13, 0x0B28}, {0x0B2A, 0x0B30}, {0x0B32, 0x0B33}, {0x0B36, 0x0B39}, {0x0B3D, 0x0B3D}, {0x0B5C, 0x0B5D}, {0x0B5F, 0x0B61}, {0x0B85, 0x0B8A}, {0x0B8E, 0x0B90}, {0x0B92, 0x0B95}, {0x0B99, 0x0B9A}, {0x0B9C, 0x0B9C}, {0x0B9E, 0x0B9F}, {0x0BA3, 0x0BA4}, {0x0BA8, 0x0BAA}, {0x0BAE, 0x0BB5}, {0x0BB7, 0x0BB9}, {0x0C05, 0x0C0C}, {0x0C0E, 0x0C10}, {0x0C12, 0x0C28}, {0x0C2A, 0x0C33}, {0x0C35, 0x0C39}, {0x0C60, 0x0C61}, {0x0C85, 0x0C8C}, {0x0C8E, 0x0C90}, {0x0C92, 0x0CA8}, {0x0CAA, 0x0CB3}, {0x0CB5, 0x0CB9}, {0x0CDE, 0x0CDE}, {0x0CE0, 0x0CE1}, {0x0D05, 0x0D0C}, {0x0D0E, 0x0D10}, {0x0D12, 0x0D28}, {0x0D2A, 0x0D39}, {0x0D60, 0x0D61}, {0x0E01, 0x0E2E}, {0x0E30, 0x0E30}, {0x0E32, 0x0E33}, {0x0E40, 0x0E45}, {0x0E81, 0x0E82}, {0x0E84, 0x0E84}, {0x0E87, 0x0E88}, {0x0E8A, 0x0E8A}, {0x0E8D, 0x0E8D}, {0x0E94, 0x0E97}, {0x0E99, 0x0E9F}, {0x0EA1, 0x0EA3}, {0x0EA5, 0x0EA5}, {0x0EA7, 0x0EA7}, {0x0EAA, 0x0EAB}, {0x0EAD, 0x0EAE}, {0x0EB0, 0x0EB0}, {0x0EB2, 0x0EB3}, {0x0EBD, 0x0EBD}, {0x0EC0, 0x0EC4}, {0x0F40, 0x0F47}, {0x0F49, 0x0F69}, {0x10A0, 0x10C5}, {0x10D0, 0x10F6}, {0x1100, 0x1100}, {0x1102, 0x1103}, {0x1105, 0x1107}, {0x1109, 0x1109}, {0x110B, 0x110C}, {0x110E, 0x1112}, {0x113C, 0x113C}, {0x113E, 0x113E}, {0x1140, 0x1140}, {0x114C, 0x114C}, {0x114E, 0x114E}, {0x1150, 0x1150}, {0x1154, 0x1155}, {0x1159, 0x1159}, {0x115F, 0x1161}, {0x1163, 0x1163}, {0x1165, 0x1165}, {0x1167, 0x1167}, {0x1169, 0x1169}, {0x116D, 0x116E}, {0x1172, 0x1173}, {0x1175, 0x1175}, {0x119E, 0x119E}, {0x11A8, 0x11A8}, {0x11AB, 0x11AB}, {0x11AE, 0x11AF}, {0x11B7, 0x11B8}, {0x11BA, 0x11BA}, {0x11BC, 0x11C2}, {0x11EB, 0x11EB}, {0x11F0, 0x11F0}, {0x11F9, 0x11F9}, {0x1E00, 0x1E9B}, {0x1EA0, 0x1EF9}, {0x1F00, 0x1F15}, {0x1F18, 0x1F1D}, {0x1F20, 0x1F45}, {0x1F48, 0x1F4D}, {0x1F50, 0x1F57}, {0x1F59, 0x1F59}, {0x1F5B, 0x1F5B}, {0x1F5D, 0x1F5D}, {0x1F5F, 0x1F7D}, {0x1F80, 0x1FB4}, {0x1FB6, 0x1FBC}, {0x1FBE, 0x1FBE}, {0x1FC2, 0x1FC4}, {0x1FC6, 0x1FCC}, {0x1FD0, 0x1FD3}, {0x1FD6, 0x1FDB}, {0x1FE0, 0x1FEC}, {0x1FF2, 0x1FF4}, {0x1FF6, 0x1FFC}, {0x2126, 0x2126}, {0x212A, 0x212B}, {0x212E, 0x212E}, {0x2180, 0x2182}, {0x3007, 0x3007}, {0x3021, 0x3029}, /* these two are ideographic */ {0x3041, 0x3094}, {0x30A1, 0x30FA}, {0x3105, 0x312C}, {0x4E00, 0x9FA5}, /* ideographic */ {0xAC00, 0xD7A3} }; /*! * \brief The size of the letter table array. */ #define LETTERTABLESIZE (sizeof(Letter)/sizeof(Letter[0])) /*! * \brief The NameChar table contains CombiningChar, Extender, Digit, * '-', '.', less '_', ':' * * NameChar ::= Digit | '-' | '.' | CombiningChar | Extender * See XML 1.0 2nd Edition */ static char_info_t NameChar[] = { {0x002D, 0x002D}, /* character "-" */ {0x002E, 0x002E}, /* character "." */ {0x0030, 0x0039}, /* digit */ {0x00B7, 0x00B7}, {0x02D0, 0x02D0}, {0x02D1, 0x02D1}, /* extended */ {0x0300, 0x0345}, {0x0360, 0x0361}, {0x0387, 0x0387}, /* extended */ {0x0483, 0x0486}, {0x0591, 0x05A1}, {0x05A3, 0x05B9}, {0x05BB, 0x05BD}, {0x05BF, 0x05BF}, {0x05C1, 0x05C2}, {0x05C4, 0x05C4}, {0x0640, 0x0640}, /* extended */ {0x064B, 0x0652}, {0x0660, 0x0669}, /* digit */ {0x0670, 0x0670}, {0x06D6, 0x06DC}, {0x06DD, 0x06DF}, {0x06E0, 0x06E4}, {0x06E7, 0x06E8}, {0x06EA, 0x06ED}, {0x06F0, 0x06F9}, /* digit */ {0x0901, 0x0903}, {0x093C, 0x093C}, {0x093E, 0x094C}, {0x094D, 0x094D}, {0x0951, 0x0954}, {0x0962, 0x0963}, {0x0966, 0x096F}, /* digit */ {0x0981, 0x0983}, {0x09BC, 0x09BC}, {0x09BE, 0x09BE}, {0x09BF, 0x09BF}, {0x09C0, 0x09C4}, {0x09C7, 0x09C8}, {0x09CB, 0x09CD}, {0x09D7, 0x09D7}, {0x09E2, 0x09E3}, {0x09E6, 0x09EF}, /* digit */ {0x0A02, 0x0A02}, {0x0A3C, 0x0A3C}, {0x0A3E, 0x0A3E}, {0x0A3F, 0x0A3F}, {0x0A40, 0x0A42}, {0x0A47, 0x0A48}, {0x0A4B, 0x0A4D}, {0x0A66, 0x0A6F}, /* digit */ {0x0A70, 0x0A71}, {0x0A81, 0x0A83}, {0x0ABC, 0x0ABC}, {0x0ABE, 0x0AC5}, {0x0AC7, 0x0AC9}, {0x0ACB, 0x0ACD}, {0x0AE6, 0x0AEF}, /* digit */ {0x0B01, 0x0B03}, {0x0B3C, 0x0B3C}, {0x0B3E, 0x0B43}, {0x0B47, 0x0B48}, {0x0B4B, 0x0B4D}, {0x0B56, 0x0B57}, {0x0B66, 0x0B6F}, /* digit */ {0x0B82, 0x0B83}, {0x0BBE, 0x0BC2}, {0x0BC6, 0x0BC8}, {0x0BCA, 0x0BCD}, {0x0BD7, 0x0BD7}, {0x0BE7, 0x0BEF}, /* digit */ {0x0C01, 0x0C03}, {0x0C3E, 0x0C44}, {0x0C46, 0x0C48}, {0x0C4A, 0x0C4D}, {0x0C55, 0x0C56}, {0x0C66, 0x0C6F}, /* digit */ {0x0C82, 0x0C83}, {0x0CBE, 0x0CC4}, {0x0CC6, 0x0CC8}, {0x0CCA, 0x0CCD}, {0x0CD5, 0x0CD6}, {0x0CE6, 0x0CEF}, /* digit */ {0x0D02, 0x0D03}, {0x0D3E, 0x0D43}, {0x0D46, 0x0D48}, {0x0D4A, 0x0D4D}, {0x0D57, 0x0D57}, {0x0D66, 0x0D6F}, /* digit */ {0x0E31, 0x0E31}, {0x0E34, 0x0E3A}, {0x0E46, 0x0E46}, /* extended */ {0x0E47, 0x0E4E}, {0x0E50, 0x0E59}, /* digit */ {0x0EB1, 0x0EB1}, {0x0EB4, 0x0EB9}, {0x0EBB, 0x0EBC}, {0x0EC6, 0x0EC6}, /* extended */ {0x0EC8, 0x0ECD}, {0x0ED0, 0x0ED9}, /* digit */ {0x0F18, 0x0F19}, {0x0F20, 0x0F29}, /* digit */ {0x0F35, 0x0F35}, {0x0F37, 0x0F37}, {0x0F39, 0x0F39}, {0x0F3E, 0x0F3E}, {0x0F3F, 0x0F3F}, {0x0F71, 0x0F84}, {0x0F86, 0x0F8B}, {0x0F90, 0x0F95}, {0x0F97, 0x0F97}, {0x0F99, 0x0FAD}, {0x0FB1, 0x0FB7}, {0x0FB9, 0x0FB9}, {0x20D0, 0x20DC}, {0x20E1, 0x20E1}, {0x3005, 0x3005}, /* extended */ {0x302A, 0x302F}, {0x3031, 0x3035}, /* extended */ {0x3099, 0x3099}, {0x309A, 0x309A}, /* combining char */ {0x309D, 0x309E}, {0x30FC, 0x30FE} /* extended */ }; /*! * \brief The name char table array size. */ #define NAMECHARTABLESIZE (sizeof(NameChar)/sizeof(NameChar[0])) /*! * \brief Frees one ElementStack item. */ static void Parser_freeElementStackItem( /*! [in] The element stack item to free. */ IXML_ElementStack *pItem) { assert( pItem != NULL ); if( pItem->element != NULL ) { free( pItem->element ); pItem->element = NULL; } if( pItem->namespaceUri != NULL ) { free( pItem->namespaceUri ); pItem->namespaceUri = NULL; } if( pItem->prefix != NULL ) { free( pItem->prefix ); pItem->prefix = NULL; } } /*! * \brief Frees namespaceURI item. */ static void Parser_freeNsURI( /*! [in] The name space URI item to free. */ IXML_NamespaceURI *pNsURI) { assert( pNsURI != NULL ); if( pNsURI->nsURI != NULL ) { free( pNsURI->nsURI ); } if( pNsURI->prefix != NULL ) { free( pNsURI->prefix ); } } /*! * \brief Frees all temporary memory allocated by xmlparser. */ static void Parser_free( /*! [in] The XML parser. */ Parser *xmlParser) { IXML_ElementStack *pElement; IXML_ElementStack *pNextElement; IXML_NamespaceURI *pNsURI; IXML_NamespaceURI *pNextNsURI; if( xmlParser == NULL ) { return; } if( xmlParser->dataBuffer != NULL ) { free( xmlParser->dataBuffer ); } ixml_membuf_destroy( &( xmlParser->tokenBuf ) ); ixml_membuf_destroy( &( xmlParser->lastElem ) ); pElement = xmlParser->pCurElement; while( pElement != NULL ) { Parser_freeElementStackItem( pElement ); pNsURI = pElement->pNsURI; while( pNsURI != NULL ) { pNextNsURI = pNsURI->nextNsURI; Parser_freeNsURI( pNsURI ); free( pNsURI ); pNsURI = pNextNsURI; } pNextElement = pElement->nextElement; free( pElement ); pElement = pNextElement; } free( xmlParser ); } /*! * \brief Skips document type declaration */ static int Parser_skipDocType( /*! [in,out] The pointer to the skipped point. */ char **pstr) { char *pCur = *pstr; /* default there is no nested < */ char *pNext = NULL; int num = 1; assert( ( *pstr ) != NULL ); if( *pstr == NULL ) { return IXML_FAILED; } while( ( pCur != NULL ) && ( num != 0 ) && ( *pCur != 0 ) ) { if( *pCur == '<' ) { num++; } else if( *pCur == '>' ) { num--; } else if( *pCur == '"' ) { pNext = strchr( pCur + 1, '"' ); if( pNext == NULL ) { return IXML_SYNTAX_ERR; } pCur = pNext; } pCur++; } if( num == 0 ) { *pstr = pCur; return IXML_SUCCESS; } else { return IXML_SYNTAX_ERR; } } /*! * \brief Skips all characters in the string until it finds the skip key. * Then it skips the skip key and returns. */ static int Parser_skipString( /*! [in,out] The pointer to the skipped point. */ char **pstrSrc, /*! [in] The skip key. */ const char *strSkipKey) { if( !( *pstrSrc ) || !strSkipKey ) { return IXML_FAILED; } while( ( **pstrSrc ) && strncmp( *pstrSrc, strSkipKey, strlen( strSkipKey ) ) != 0 ) { ( *pstrSrc )++; } if( **pstrSrc == '\0' ) { return IXML_SYNTAX_ERR; } *pstrSrc = *pstrSrc + strlen( strSkipKey ); return IXML_SUCCESS; } /*! * \brief Skip white spaces. */ static void Parser_skipWhiteSpaces( /*! [in] The XML parser. */ Parser *xmlParser) { while( ( *( xmlParser->curPtr ) != 0 ) && ( strchr( WHITESPACE, ( int ) *( xmlParser->curPtr ) ) != NULL ) ) { xmlParser->curPtr++; } } /*! * \brief Skips XML declarations. */ static int Parser_skipXMLDecl( /*! [in,out] The XML parser. */ Parser *xmlParser) { int rc = IXML_FAILED; assert( xmlParser ); if( xmlParser == NULL ) { return rc; } rc = Parser_skipString( &( xmlParser->curPtr ), END_PI ); Parser_skipWhiteSpaces( xmlParser ); return rc; } /*! * \brief Skips all characters in the string until it finds the skip key. * Then it skips the skip key and returns. */ static int Parser_skipComment( /*! [in,out] The pointer to the skipped point. */ char **pstrSrc) { char *pStrFound = NULL; assert( ( *pstrSrc ) != NULL ); if( *pstrSrc == NULL ) { return IXML_FAILED; } pStrFound = strstr( *pstrSrc, END_COMMENT ); if( ( pStrFound != NULL ) && ( pStrFound != *pstrSrc ) && ( *( pStrFound - 1 ) != '-' ) ) { *pstrSrc = pStrFound + strlen( END_COMMENT ); } else { return IXML_SYNTAX_ERR; } return IXML_SUCCESS; } /*! * \brief Skip comment, PI and white space. */ static int Parser_skipMisc( /*! [in] The XML parser. */ Parser *xmlParser) { int rc = IXML_SUCCESS; int done = FALSE; while( ( done == FALSE ) && ( rc == IXML_SUCCESS ) ) { if( strncasecmp( xmlParser->curPtr, ( char * )BEGIN_COMMENT, strlen( BEGIN_COMMENT ) ) == 0 ) { /* } for (i = 1; i < argc; i++) { int rc; IXML_Document* doc = NULL; DOMString s; char* p; printf ("Test \"%s\" \n", argv[i]); printf (" Loading ... "); fflush (stdout); rc = ixmlLoadDocumentEx (argv[i], &doc); if (rc != IXML_SUCCESS) { fprintf (stderr, "** error : can't load document %s : " "error %d (%s)\n", argv[i], rc, get_ixml_error_string (rc)); exit (EXIT_FAILURE); // ----------> } printf ("OK\n"); printf (" Printing ... "); fflush (stdout); s = ixmlPrintDocument (doc); if (s == NULL || s[0] == '\0') { fprintf (stderr, "** error : can't print loaded document %s\n", argv[i]); exit (EXIT_FAILURE); // ----------> } p = s + strlen(s)-1; while (isspace(*p) && p > s) p--; if (*s != '<' || *p != '>') { fprintf (stderr, "** error : malformed printed document '%s' :" "%s\n", argv[i], s); exit (EXIT_FAILURE); // ----------> } printf ("OK\n"); ixmlFreeDOMString (s); ixmlDocument_free (doc); } exit (EXIT_SUCCESS); } pupnp-release-1.8.0/ixml/test/test_document.sh000077500000000000000000000001111303304015100214230ustar00rootroot00000000000000#!/bin/sh ./test_document-1.8 `find $srcdir/test/testdata -name *.xml` pupnp-release-1.8.0/ixml/test/testdata/000077500000000000000000000000001303304015100200275ustar00rootroot00000000000000pupnp-release-1.8.0/ixml/test/testdata/empty_attribute.xml000066400000000000000000000002201303304015100237640ustar00rootroot00000000000000 Empty XML Attribute pupnp-release-1.8.0/ixml/test/testdata/p43pass1.xml000066400000000000000000000006061303304015100221310ustar00rootroot00000000000000 CharData"> ]> CharData CharData é" CharData ]]> CharData é" CharData ]]> >" CharData pupnp-release-1.8.0/ixml/test/testdata/tvcontrolSCPD.xml000066400000000000000000000071731303304015100232650ustar00rootroot00000000000000 1 0 PowerOn Power Power out PowerOff Power Power out SetChannel NewChannel Channel out Channel Channel in IncreaseChannel Channel Channel out DecreaseChannel Channel Channel out SetVolume NewVolume Volume out Volume Volume in IncreaseVolume Volume Volume out DecreaseVolume Volume Volume out Power Boolean 0 Channel i4 1 100 1 1 Volume i4 0 10 1 5 pupnp-release-1.8.0/ixml/test/testdata/tvdevicedesc.xml000066400000000000000000000027661303304015100232340ustar00rootroot00000000000000 1 0 urn:schemas-upnp-org:device:tvdevice:1 UPnP Television Emulator TV Manufacturer Name http://www.manufacturer.com UPnP Television Device Emulator 1.0 TVEmulator 1.0 http://www.manufacturer.com/TVEmulator/ 123456789001 uuid:Upnp-TVEmulator-1_0-1234567890001 123456789 urn:schemas-upnp-org:service:tvcontrol:1 urn:upnp-org:serviceId:tvcontrol1 /upnp/control/tvcontrol1 /upnp/event/tvcontrol1 /tvcontrolSCPD.xml urn:schemas-upnp-org:service:tvpicture:1 urn:upnp-org:serviceId:tvpicture1 /upnp/control/tvpicture1 /upnp/event/tvpicture1 /tvpictureSCPD.xml /tvdevicepres.html pupnp-release-1.8.0/ixml/test/testdata/tvpictureSCPD.xml000066400000000000000000000131121303304015100232460ustar00rootroot00000000000000 1 0 SetColor NewColor Color out Color Color in IncreaseColor Color Color out DecreaseColor Color Color out SetTint NewTint Tint out Tint Tint in IncreaseTint Tint Tint out DecreaseTint Tint Tint out SetContrast NewContrast Contrast out Contrast Contrast in IncreaseContrast Contrast Contrast out DecreaseContrast Contrast Contrast out SetBrightness NewBrightness Brightness out Brightness Brightness in IncreaseBrightness Brightness Brightness out DecreaseBrightness Brightness Brightness out Color i4 1 10 1 5 Tint i4 1 10 1 5 Contrast i4 1 10 1 5 Brightness i4 1 10 1 5 pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/000077500000000000000000000000001303304015100223245ustar00rootroot00000000000000pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/legal.html000066400000000000000000000066231303304015100243050ustar00rootroot00000000000000 LEGAL NOTICES

LEGAL NOTICES

Unless otherwise stated, pages hosted on the website
Chinese XML Now!
are copyright (C) 1998 the designated authors and translators,
and the Computing Center, Academia Sinica.

Unless otherwise stated, permission is granted to use, copy, link to,
translate and republish in any form, including for commercial use,
providing due acknowledgement of the copyright holder
and the Chinese XML Now! website is made.

If you believe any pages here are subject to another copyright,
please email us (mailto: ricko@gate.sinica.edu.tw)
with the appropriate correction.

The "Chinese Numberplate" logos copyright (C) 1998 Rick Jelliffe and Computing Center, Academia Sinica.

The logo is provided as a public service for information,
and does not represent a test result or endorsement.

For integrity, we do reserve the right to ask makers who use
an incorrect version of the logo to correct it or to abstain from using the logo.

The Chinese XML Test pages do not represent
an exhaustive test of some software's Chinese capability.
The tests merely represent a base-level which may
identify particular important characteristics quickly.

Permission is granted to copy and use the test files
as part of any test suite. However, copiers must take
the utmost care to ensure that the test files
are maintained in the encoding given in their
XML encoding header.

Caveat: Information provided about products at this site is
provided as a public service only, and does not imply
an endorsement of any product, any company, or any technology.

Information at this site should be treated as an indication only:
products and capabilities change quickly, so information
may only be correct at the time of publication.
Furthermore, due to the technical complexity and novelty
of XML technology, and the poor state of product documentation,
it is possible that some information may be incorrect,
despite our best endevours.

If you believe any information here is incorrect,
please email us (mailto: ricko@gate.sinica.edu.tw)
with the appropriate correction.

pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wf/000077500000000000000000000000001303304015100227405ustar00rootroot00000000000000pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wf/zh-utf8-0.xml000066400000000000000000000010201303304015100251150ustar00rootroot00000000000000 Chinese Test #0: utf-8 This file is the null test. It is a UTF-8 encoded file with no non-ASCII characters (i.e. it is also an ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="utf-8"?>. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wf/zh-utf8-1.xml000066400000000000000000000010201303304015100251160ustar00rootroot00000000000000 Chinese Test #1: UTF-8 This file is the null test. It is a UTF-8 encoded file with no non-ASCII characters (i.e. it is also an ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="UTF-8"?>. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wf/zh-utf8-10.xml000066400000000000000000000007701303304015100252110ustar00rootroot00000000000000 Chinese Test #10: UTF-8 This file has 1 Chinese character, directly entered. The XML header of this file is <?xml encoding="UTF-8"?>. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wf/zh-utf8-11.xml000066400000000000000000000010321303304015100252020ustar00rootroot00000000000000 Chinese Test #11: UTF-8 This file has 1 Chinese character, directly entered. This tests Native Language Markup (NLM). The XML header of this file is <?xml encoding="UTF-8"?>. The character is here: <中 />. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wf/zh-utf8-12.xml000066400000000000000000000013431303304015100252100ustar00rootroot00000000000000 Chinese Test #12: UTF-8 This file has two attributes with Chinese characters, directly entered. This tests Native Language Markup (NLM). The XML header of this file is <?xml encoding="UTF-8"?>. (In the DOCTYPE test, the name element has an ID attribute, and this element has an IDREF attribute.) pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wf/zh-utf8-2.xml000066400000000000000000000013731303304015100251320ustar00rootroot00000000000000 Chinese Test #2: UTF-8 This file has 1 Chinese character, encoded using a decimal numeric character reference. It is a UTF-8 encoded file with no non-ASCII characters (i.e. it is also an ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="UTF-8"?>. The character is here: [中]. It is the Chinese character for middle. It should look like a box with a vertical line through its middle. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wf/zh-utf8-3.xml000066400000000000000000000013771303304015100251370ustar00rootroot00000000000000 Chinese Test #3: UTF-8 This file has 1 Chinese character, encoded using a hexadecimal numeric character reference. It is a UTF-8 encoded file with no non-ASCII characters (i.e. it is also an ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="UTF-8"?>. The character is here: [中]. It is the Chinese character for middle. It should look like a box with a vertical line through its middle. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wf/zh-utf8-4.xml000066400000000000000000000014031303304015100251260ustar00rootroot00000000000000 Chinese Test #4: UTF-8 This file has 1 Chinese character, encoded using a decimal numeric character reference. It is a UTF-8 encoded file with no non-ASCII characters (i.e. it is also an ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="UTF-8"?>. It is the Chinese character for middle. It should look like a box with a vertical line through its middle. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wf/zh-utf8-5.xml000066400000000000000000000014031303304015100251270ustar00rootroot00000000000000 Chinese Test #5: UTF-8 This file has 1 Chinese character, encoded using a decimal numeric character reference. It is a UTF-8 encoded file with no non-ASCII characters (i.e. it is also an ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="UTF-8"?>. It is the Chinese character for middle. It should look like a box with a vertical line through its middle. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wf/zh-utf8-6.xml000066400000000000000000000013761303304015100251410ustar00rootroot00000000000000 Chinese Test #6: UTF-8 This file has CDATA which looks like a decimal numeric character reference. It is a file with no non-ASCII characters (i.e. it is also a UTF-8, ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="UTF-8"?>. This is not the Chinese character for middle. It should not look like a box with a vertical line through its middle. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wf/zh-utf8-7.xml000066400000000000000000000014031303304015100251310ustar00rootroot00000000000000 Chinese Test #7: UTF-8 This file has CDATA which looks like a hexadecimal numeric character reference. It is a file with no non-ASCII characters (i.e. it is also a UTF-8, ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="UTF-8"?>. This is not the Chinese character for middle. It should not look like a box with a vertical line through its middle. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wf/zh-utf8-8.xml000066400000000000000000000011371303304015100251360ustar00rootroot00000000000000 Chinese Test #8: UTF-8 This file has 1 Chinese character, directly entered. The XML header of this file is <?xml encoding="UTF-8"?>. The character is here: [中] It is the Chinese character for middle. It should look like a box with a vertical line through its middle. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wf/zh-utf8-9.xml000066400000000000000000000007531303304015100251420ustar00rootroot00000000000000 Chinese Test #9: UTF-8 This file has 1 Chinese character, directly entered. The XML header of this file is <?xml encoding="UTF-8"?>. The character is here: [究]. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wfns/000077500000000000000000000000001303304015100233015ustar00rootroot00000000000000pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wfns/zh-utf8-0.xml000066400000000000000000000010741303304015100254670ustar00rootroot00000000000000 Chinese Test #0: utf-8 This file is the null test. It is a UTF-8 encoded file with no non-ASCII characters (i.e. it is also an ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="utf-8"?>. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wfns/zh-utf8-1.xml000066400000000000000000000010741303304015100254700ustar00rootroot00000000000000 Chinese Test #1: UTF-8 This file is the null test. It is a UTF-8 encoded file with no non-ASCII characters (i.e. it is also an ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="UTF-8"?>. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wfns/zh-utf8-10.xml000066400000000000000000000010441303304015100255450ustar00rootroot00000000000000 Chinese Test #10: UTF-8 This file has 1 Chinese character, directly entered. The XML header of this file is <?xml encoding="UTF-8"?>. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wfns/zh-utf8-11.xml000066400000000000000000000011061303304015100255450ustar00rootroot00000000000000 Chinese Test #11: UTF-8 This file has 1 Chinese character, directly entered. This tests Native Language Markup (NLM). The XML header of this file is <?xml encoding="UTF-8"?>. The character is here: <中 />. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wfns/zh-utf8-12.xml000066400000000000000000000014171303304015100255530ustar00rootroot00000000000000 Chinese Test #12: UTF-8 This file has two attributes with Chinese characters, directly entered. This tests Native Language Markup (NLM). The XML header of this file is <?xml encoding="UTF-8"?>. (In the DOCTYPE test, the name element has an ID attribute, and this element has an IDREF attribute.) pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wfns/zh-utf8-2.xml000066400000000000000000000014471303304015100254750ustar00rootroot00000000000000 Chinese Test #2: UTF-8 This file has 1 Chinese character, encoded using a decimal numeric character reference. It is a UTF-8 encoded file with no non-ASCII characters (i.e. it is also an ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="UTF-8"?>. The character is here: [中]. It is the Chinese character for middle. It should look like a box with a vertical line through its middle. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wfns/zh-utf8-3.xml000066400000000000000000000014531303304015100254730ustar00rootroot00000000000000 Chinese Test #3: UTF-8 This file has 1 Chinese character, encoded using a hexadecimal numeric character reference. It is a UTF-8 encoded file with no non-ASCII characters (i.e. it is also an ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="UTF-8"?>. The character is here: [中]. It is the Chinese character for middle. It should look like a box with a vertical line through its middle. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wfns/zh-utf8-4.xml000066400000000000000000000014571303304015100255000ustar00rootroot00000000000000 Chinese Test #4: UTF-8 This file has 1 Chinese character, encoded using a decimal numeric character reference. It is a UTF-8 encoded file with no non-ASCII characters (i.e. it is also an ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="UTF-8"?>. It is the Chinese character for middle. It should look like a box with a vertical line through its middle. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wfns/zh-utf8-5.xml000066400000000000000000000014571303304015100255010ustar00rootroot00000000000000 Chinese Test #5: UTF-8 This file has 1 Chinese character, encoded using a decimal numeric character reference. It is a UTF-8 encoded file with no non-ASCII characters (i.e. it is also an ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="UTF-8"?>. It is the Chinese character for middle. It should look like a box with a vertical line through its middle. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wfns/zh-utf8-6.xml000066400000000000000000000014521303304015100254750ustar00rootroot00000000000000 Chinese Test #6: UTF-8 This file has CDATA which looks like a decimal numeric character reference. It is a file with no non-ASCII characters (i.e. it is also a UTF-8, ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="UTF-8"?>. This is not the Chinese character for middle. It should not look like a box with a vertical line through its middle. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wfns/zh-utf8-7.xml000066400000000000000000000014571303304015100255030ustar00rootroot00000000000000 Chinese Test #7: UTF-8 This file has CDATA which looks like a hexadecimal numeric character reference. It is a file with no non-ASCII characters (i.e. it is also a UTF-8, ASCII or iso-8859-n file). The XML header of this file is <?xml encoding="UTF-8"?>. This is not the Chinese character for middle. It should not look like a box with a vertical line through its middle. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wfns/zh-utf8-8.xml000066400000000000000000000012131303304015100254720ustar00rootroot00000000000000 Chinese Test #8: UTF-8 This file has 1 Chinese character, directly entered. The XML header of this file is <?xml encoding="UTF-8"?>. The character is here: [中] It is the Chinese character for middle. It should look like a box with a vertical line through its middle. pupnp-release-1.8.0/ixml/test/testdata/xml.ascc.net/wfns/zh-utf8-9.xml000066400000000000000000000010271303304015100254760ustar00rootroot00000000000000 Chinese Test #9: UTF-8 This file has 1 Chinese character, directly entered. The XML header of this file is <?xml encoding="UTF-8"?>. The character is here: [究]. pupnp-release-1.8.0/ixml/test/testdata/xmlconf/000077500000000000000000000000001303304015100214755ustar00rootroot00000000000000pupnp-release-1.8.0/ixml/test/testdata/xmlconf/014.xml000066400000000000000000000002331303304015100225210ustar00rootroot00000000000000 ]> pupnp-release-1.8.0/ixml/test/testdata/xmlconf/040.xml000066400000000000000000000002021303304015100225140ustar00rootroot00000000000000 ]> pupnp-release-1.8.0/ixml/test/testdata/xmlconf/059.xml000066400000000000000000000003551303304015100225370ustar00rootroot00000000000000 ]> pupnp-release-1.8.0/ixml/test/testdata/xmlconf/111.xml000066400000000000000000000002001303304015100225110ustar00rootroot00000000000000 ]> pupnp-release-1.8.0/ixml/test/testdata/xmlconf/element.xml000066400000000000000000000013021303304015100236440ustar00rootroot00000000000000 ]> allowed ]]> also ]]> moreover allowed & stuff also moreover moreover too pupnp-release-1.8.0/libupnp-1.8.pc.in000066400000000000000000000004541303304015100171770ustar00rootroot00000000000000prefix=@prefix@ exec_prefix=@exec_prefix@ libdir=@libdir@ includedir=@includedir@ Name: libupnp-1.8 Description: Linux SDK for UPnP Devices Version: @VERSION@ Libs: @PTHREAD_CFLAGS@ @PTHREAD_LIBS@ -L${libdir} -lupnp-1.8 -lthreadutil-1.8 -lixml-1.8 Cflags: @PTHREAD_CFLAGS@ -I${includedir}/upnp-1.8 pupnp-release-1.8.0/libupnp.spec000066400000000000000000000072151303304015100166200ustar00rootroot00000000000000Version: 1.8.0 Summary: Universal Plug and Play (UPnP) SDK Name: libupnp-1.8 Release: 1%{?dist} License: BSD Group: System Environment/Libraries URL: http://www.libupnp.org/ Source: http://puzzle.dl.sourceforge.net/sourceforge/pupnp/%{name}-%{version}.tar.bz2 Buildroot: %{_tmppath}/%{name}-%{version}-%{release}-root-%(%{__id_u} -n) %define docdeveldir %{_docdir}/%{name}-devel-%{version} %description The Universal Plug and Play (UPnP) SDK for Linux provides support for building UPnP-compliant control points, devices, and bridges on Linux. %package devel Group: Development/Libraries Summary: Include files needed for development with %{name} Requires: %{name} = %{version}-%{release} %description devel The %{name}-devel package contains the files necessary for development with the UPnP SDK libraries. %prep %setup -q %build %configure --with-documentation make %{?_smp_mflags} %install test "$RPM_BUILD_ROOT" != "/" && rm -rf $RPM_BUILD_ROOT make install DESTDIR=$RPM_BUILD_ROOT #create the doc devel dir %{__mkdir_p} %{buildroot}%{docdeveldir} #mv examples dir and pdf file to the doc devel dir %{__mv} %{buildroot}%{docdir}/examples \ %{buildroot}%{docdeveldir}/ %{__mv} %{buildroot}%{docdir}/UPnP_Programming_Guide.pdf \ %{buildroot}%{docdeveldir}/ %{__mv} %{buildroot}%{docdir}/IXML_Programming_Guide.pdf \ %{buildroot}%{docdeveldir}/ %{__mv} %{buildroot}%{docdir}/html \ %{buildroot}%{docdeveldir}/ %{__rm} %{buildroot}%{_libdir}/{libixml-1.8.la,libthreadutil-1.8.la,libupnp-1.8.la} %post -p /sbin/ldconfig %postun -p /sbin/ldconfig %files %defattr(-,root,root,-) %doc %{docdir} %{_libdir}/libixml-1.8.so.* %{_libdir}/libthreadutil-1.8.so.* %{_libdir}/libupnp-1.8.so.* %files devel %defattr(0644,root,root,0755) %doc %{docdeveldir} %{_includedir}/upnp-1.8/ %{_libdir}/libixml-1.8.so %{_libdir}/libthreadutil-1.8.so %{_libdir}/libupnp-1.8.so %{_libdir}/libixml-1.8.a %{_libdir}/libthreadutil-1.8.a %{_libdir}/libupnp-1.8.a %{_libdir}/pkgconfig/libupnp-1.8.pc %clean rm -rf %{buildroot} %changelog * Mon Nov 19 2007 Marcelo Jimenez - 1.6.2-1 - Update to version 1.6.2 * Mon Nov 19 2007 Marcelo Jimenez - 1.4.7-1 - Update to version 1.4.7 * Fri Feb 02 2007 Eric Tanguy - 1.4.2-1 - Update to version 1.4.2 * Wed Jul 05 2006 Eric Tanguy - 1.4.1-1 - Update to version 1.4.1 * Fri Jun 23 2006 Eric Tanguy - 1.4.0-3 - modified patch for x86_64 arch * Fri Jun 23 2006 Eric Tanguy - 1.4.0-2 - Add a patch for x86_64 arch * Sun Jun 11 2006 Eric Tanguy - 1.4.0-1 - Update to 1.4.0 * Sun Mar 05 2006 Eric Tanguy - 1.3.1-1 - Update to 1.3.1 * Tue Feb 14 2006 Eric Tanguy - 1.2.1a-6 - Rebuild for FC5 * Fri Feb 10 2006 Eric Tanguy - 1.2.1a-5 - Rebuild for FC5 * Mon Jan 9 2006 Eric Tanguy 1.2.1a-4 - Include libupnp.so symlink in package to take care of non versioning of libupnp.so.1.2.1 * Sun Jan 8 2006 Paul Howarth 1.2.1a-3 - Disable stripping of object code for sane debuginfo generation - Edit makefiles to hnnor RPM optflags - Install libraries in %%{_libdir} rather than hardcoded /usr/lib - Fix libupnp.so symlink - Own directory %%{_includedir}/upnp - Fix permissions in -devel package * Fri Jan 06 2006 Eric Tanguy 1.2.1a-2 - Use 'install -p' to preserve timestamps - Devel now require full version-release of main package * Thu Dec 22 2005 Eric Tanguy 1.2.1a-1 - Modify spec file from http://rpm.pbone.net/index.php3/stat/4/idpl/2378737/com/libupnp-1.2.1a_DSM320-3.i386.rpm.html pupnp-release-1.8.0/m4/000077500000000000000000000000001303304015100146065ustar00rootroot00000000000000pupnp-release-1.8.0/m4/acx_pthread.m4000066400000000000000000000253661303304015100173460ustar00rootroot00000000000000##### http://autoconf-archive.cryp.to/acx_pthread.html # # SYNOPSIS # # ACX_PTHREAD([ACTION-IF-FOUND[, ACTION-IF-NOT-FOUND]]) # # DESCRIPTION # # This macro figures out how to build C programs using POSIX threads. # It sets the PTHREAD_LIBS output variable to the threads library and # linker flags, and the PTHREAD_CFLAGS output variable to any special # C compiler flags that are needed. (The user can also force certain # compiler flags/libs to be tested by setting these environment # variables.) # # Also sets PTHREAD_CC to any special C compiler that is needed for # multi-threaded programs (defaults to the value of CC otherwise). # (This is necessary on AIX to use the special cc_r compiler alias.) # # NOTE: You are assumed to not only compile your program with these # flags, but also link it with them as well. e.g. you should link # with $PTHREAD_CC $CFLAGS $PTHREAD_CFLAGS $LDFLAGS ... $PTHREAD_LIBS # $LIBS # # If you are only building threads programs, you may wish to use # these variables in your default LIBS, CFLAGS, and CC: # # LIBS="$PTHREAD_LIBS $LIBS" # CFLAGS="$CFLAGS $PTHREAD_CFLAGS" # CC="$PTHREAD_CC" # # In addition, if the PTHREAD_CREATE_JOINABLE thread-attribute # constant has a nonstandard name, defines PTHREAD_CREATE_JOINABLE to # that name (e.g. PTHREAD_CREATE_UNDETACHED on AIX). # # ACTION-IF-FOUND is a list of shell commands to run if a threads # library is found, and ACTION-IF-NOT-FOUND is a list of commands to # run it if it is not found. If ACTION-IF-FOUND is not specified, the # default action will define HAVE_PTHREAD. # # Please let the authors know if this macro fails on any platform, or # if you have any other suggestions or comments. This macro was based # on work by SGJ on autoconf scripts for FFTW (http://www.fftw.org/) # (with help from M. Frigo), as well as ac_pthread and hb_pthread # macros posted by Alejandro Forero Cuervo to the autoconf macro # repository. We are also grateful for the helpful feedback of # numerous users. # # LAST MODIFICATION # # 2006-05-29 # # COPYLEFT # # Copyright (c) 2006 Steven G. Johnson # # This program is free software; you can redistribute it and/or # modify it under the terms of the GNU General Public License as # published by the Free Software Foundation; either version 2 of the # License, or (at your option) any later version. # # This program is distributed in the hope that it will be useful, but # WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU # General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA # 02111-1307, USA. # # As a special exception, the respective Autoconf Macro's copyright # owner gives unlimited permission to copy, distribute and modify the # configure scripts that are the output of Autoconf when processing # the Macro. You need not follow the terms of the GNU General Public # License when using or distributing such scripts, even though # portions of the text of the Macro appear in them. The GNU General # Public License (GPL) does govern all other use of the material that # constitutes the Autoconf Macro. # # This special exception to the GPL applies to versions of the # Autoconf Macro released by the Autoconf Macro Archive. When you # make and distribute a modified version of the Autoconf Macro, you # may extend this special exception to the GPL to apply to your # modified version as well. AC_DEFUN([ACX_PTHREAD], [ AC_REQUIRE([AC_CANONICAL_HOST]) AC_LANG_SAVE AC_LANG_C acx_pthread_ok=no # We used to check for pthread.h first, but this fails if pthread.h # requires special compiler flags (e.g. on True64 or Sequent). # It gets checked for in the link test anyway. # First of all, check if the user has set any of the PTHREAD_LIBS, # etcetera environment variables, and if threads linking works using # them: if test x"$PTHREAD_LIBS$PTHREAD_CFLAGS" != x; then save_CFLAGS="$CFLAGS" CFLAGS="$CFLAGS $PTHREAD_CFLAGS" save_LIBS="$LIBS" LIBS="$PTHREAD_LIBS $LIBS" AC_MSG_CHECKING([for pthread_join in LIBS=$PTHREAD_LIBS with CFLAGS=$PTHREAD_CFLAGS]) AC_TRY_LINK_FUNC(pthread_join, acx_pthread_ok=yes) AC_MSG_RESULT($acx_pthread_ok) if test x"$acx_pthread_ok" = xno; then PTHREAD_LIBS="" PTHREAD_CFLAGS="" fi LIBS="$save_LIBS" CFLAGS="$save_CFLAGS" fi # We must check for the threads library under a number of different # names; the ordering is very important because some systems # (e.g. DEC) have both -lpthread and -lpthreads, where one of the # libraries is broken (non-POSIX). # Create a list of thread flags to try. Items starting with a "-" are # C compiler flags, and other items are library names, except for "none" # which indicates that we try without any flags at all, and "pthread-config" # which is a program returning the flags for the Pth emulation library. acx_pthread_flags="pthreads none -Kthread -kthread lthread -pthread -pthreads -mthreads pthread --thread-safe -mt pthread-config" # The ordering *is* (sometimes) important. Some notes on the # individual items follow: # pthreads: AIX (must check this before -lpthread) # none: in case threads are in libc; should be tried before -Kthread and # other compiler flags to prevent continual compiler warnings # -Kthread: Sequent (threads in libc, but -Kthread needed for pthread.h) # -kthread: FreeBSD kernel threads (preferred to -pthread since SMP-able) # lthread: LinuxThreads port on FreeBSD (also preferred to -pthread) # -pthread: Linux/gcc (kernel threads), BSD/gcc (userland threads) # -pthreads: Solaris/gcc # -mthreads: Mingw32/gcc, Lynx/gcc # -mt: Sun Workshop C (may only link SunOS threads [-lthread], but it # doesn't hurt to check since this sometimes defines pthreads too; # also defines -D_REENTRANT) # ... -mt is also the pthreads flag for HP/aCC # pthread: Linux, etcetera # --thread-safe: KAI C++ # pthread-config: use pthread-config program (for GNU Pth library) case "${host_cpu}-${host_os}" in *solaris*) # On Solaris (at least, for some versions), libc contains stubbed # (non-functional) versions of the pthreads routines, so link-based # tests will erroneously succeed. (We need to link with -pthreads/-mt/ # -lpthread.) (The stubs are missing pthread_cleanup_push, or rather # a function called by this macro, so we could check for that, but # who knows whether they'll stub that too in a future libc.) So, # we'll just look for -pthreads and -lpthread first: acx_pthread_flags="-pthreads pthread -mt -pthread $acx_pthread_flags" ;; esac if test x"$acx_pthread_ok" = xno; then for flag in $acx_pthread_flags; do case $flag in none) AC_MSG_CHECKING([whether pthreads work without any flags]) ;; -*) AC_MSG_CHECKING([whether pthreads work with $flag]) PTHREAD_CFLAGS="$flag" ;; pthread-config) AC_CHECK_PROG(acx_pthread_config, pthread-config, yes, no) if test x"$acx_pthread_config" = xno; then continue; fi PTHREAD_CFLAGS="`pthread-config --cflags`" PTHREAD_LIBS="`pthread-config --ldflags` `pthread-config --libs`" ;; *) AC_MSG_CHECKING([for the pthreads library -l$flag]) PTHREAD_LIBS="-l$flag" ;; esac save_LIBS="$LIBS" save_CFLAGS="$CFLAGS" LIBS="$PTHREAD_LIBS $LIBS" CFLAGS="$CFLAGS $PTHREAD_CFLAGS" # Check for various functions. We must include pthread.h, # since some functions may be macros. (On the Sequent, we # need a special flag -Kthread to make this header compile.) # We check for pthread_join because it is in -lpthread on IRIX # while pthread_create is in libc. We check for pthread_attr_init # due to DEC craziness with -lpthreads. We check for # pthread_cleanup_push because it is one of the few pthread # functions on Solaris that doesn't have a non-functional libc stub. # We try pthread_create on general principles. AC_TRY_LINK([#include ], [pthread_t th; pthread_join(th, 0); pthread_attr_init(0); pthread_cleanup_push(0, 0); pthread_create(0,0,0,0); pthread_cleanup_pop(0); ], [acx_pthread_ok=yes]) LIBS="$save_LIBS" CFLAGS="$save_CFLAGS" AC_MSG_RESULT($acx_pthread_ok) if test "x$acx_pthread_ok" = xyes; then break; fi PTHREAD_LIBS="" PTHREAD_CFLAGS="" done fi # Various other checks: if test "x$acx_pthread_ok" = xyes; then save_LIBS="$LIBS" LIBS="$PTHREAD_LIBS $LIBS" save_CFLAGS="$CFLAGS" CFLAGS="$CFLAGS $PTHREAD_CFLAGS" # Detect AIX lossage: JOINABLE attribute is called UNDETACHED. AC_MSG_CHECKING([for joinable pthread attribute]) attr_name=unknown for attr in PTHREAD_CREATE_JOINABLE PTHREAD_CREATE_UNDETACHED; do AC_TRY_LINK([#include ], [int attr=$attr; return attr;], [attr_name=$attr; break]) done AC_MSG_RESULT($attr_name) if test "$attr_name" != PTHREAD_CREATE_JOINABLE; then AC_DEFINE_UNQUOTED(PTHREAD_CREATE_JOINABLE, $attr_name, [Define to necessary symbol if this constant uses a non-standard name on your system.]) fi AC_MSG_CHECKING([if more special flags are required for pthreads]) flag=no case "${host_cpu}-${host_os}" in *-aix* | *-freebsd* | *-darwin*) flag="-D_THREAD_SAFE";; *solaris* | *-osf* | *-hpux*) flag="-D_REENTRANT";; esac AC_MSG_RESULT(${flag}) if test "x$flag" != xno; then PTHREAD_CFLAGS="$flag $PTHREAD_CFLAGS" fi LIBS="$save_LIBS" CFLAGS="$save_CFLAGS" # More AIX lossage: must compile with xlc_r or cc_r if test x"$GCC" != xyes; then AC_CHECK_PROGS(PTHREAD_CC, xlc_r cc_r, ${CC}) else PTHREAD_CC=$CC fi else PTHREAD_CC="$CC" fi AC_SUBST(PTHREAD_LIBS) AC_SUBST(PTHREAD_CFLAGS) AC_SUBST(PTHREAD_CC) # Finally, execute ACTION-IF-FOUND/ACTION-IF-NOT-FOUND: if test x"$acx_pthread_ok" = xyes; then ifelse([$1],,AC_DEFINE(HAVE_PTHREAD,1,[Define if you have POSIX threads libraries and header files.]),[$1]) : else acx_pthread_ok=no $2 fi AC_LANG_RESTORE ])dnl ACX_PTHREAD pupnp-release-1.8.0/m4/ax_cflags_gcc_option.m4000066400000000000000000000207411303304015100212070ustar00rootroot00000000000000##### http://autoconf-archive.cryp.to/ax_cflags_gcc_option.html # # SYNOPSIS # # AX_CFLAGS_GCC_OPTION (optionflag [,[shellvar][,[A][,[NA]]]) # # DESCRIPTION # # AX_CFLAGS_GCC_OPTION(-fvomit-frame) would show a message as like # "checking CFLAGS for gcc -fvomit-frame ... yes" and adds the # optionflag to CFLAGS if it is understood. You can override the # shellvar-default of CFLAGS of course. The order of arguments stems # from the explicit macros like AX_CFLAGS_WARN_ALL. # # The cousin AX_CXXFLAGS_GCC_OPTION would check for an option to add # to CXXFLAGS - and it uses the autoconf setup for C++ instead of C # (since it is possible to use different compilers for C and C++). # # The macro is a lot simpler than any special AX_CFLAGS_* macro (or # ac_cxx_rtti.m4 macro) but allows to check for arbitrary options. # However, if you use this macro in a few places, it would be great # if you would make up a new function-macro and submit it to the # ac-archive. # # - $1 option-to-check-for : required ("-option" as non-value) # - $2 shell-variable-to-add-to : CFLAGS (or CXXFLAGS in the other case) # - $3 action-if-found : add value to shellvariable # - $4 action-if-not-found : nothing # # note: in earlier versions, $1-$2 were swapped. We try to detect the # situation and accept a $2=~/-/ as being the old # option-to-check-for. # # also: there are other variants that emerged from the original macro # variant which did just test an option to be possibly added. # However, some compilers accept an option silently, or possibly for # just another option that was not intended. Therefore, we have to do # a generic test for a compiler family. For gcc we check "-pedantic" # being accepted which is also understood by compilers who just want # to be compatible with gcc even when not being made from gcc # sources. # # see also: # # AX_CFLAGS_SUN_OPTION AX_CFLAGS_HPUX_OPTION # AX_CFLAGS_AIX_OPTION AX_CFLAGS_IRIX_OPTION # # LAST MODIFICATION # # 2006-12-12 # # COPYLEFT # # Copyright (c) 2006 Guido U. Draheim # # This program is free software; you can redistribute it and/or # modify it under the terms of the GNU General Public License as # published by the Free Software Foundation; either version 2 of the # License, or (at your option) any later version. # # This program is distributed in the hope that it will be useful, but # WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU # General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA # 02111-1307, USA. # # As a special exception, the respective Autoconf Macro's copyright # owner gives unlimited permission to copy, distribute and modify the # configure scripts that are the output of Autoconf when processing # the Macro. You need not follow the terms of the GNU General Public # License when using or distributing such scripts, even though # portions of the text of the Macro appear in them. The GNU General # Public License (GPL) does govern all other use of the material that # constitutes the Autoconf Macro. # # This special exception to the GPL applies to versions of the # Autoconf Macro released by the Autoconf Macro Archive. When you # make and distribute a modified version of the Autoconf Macro, you # may extend this special exception to the GPL to apply to your # modified version as well. AC_DEFUN([AX_CFLAGS_GCC_OPTION_OLD], [dnl AS_VAR_PUSHDEF([FLAGS],[CFLAGS])dnl AS_VAR_PUSHDEF([VAR],[ac_cv_cflags_gcc_option_$2])dnl AC_CACHE_CHECK([m4_ifval($1,$1,FLAGS) for gcc m4_ifval($2,$2,-option)], VAR,[VAR="no, unknown" AC_LANG_SAVE AC_LANG_C ac_save_[]FLAGS="$[]FLAGS" for ac_arg dnl in "-pedantic -Werror % m4_ifval($2,$2,-option)" dnl GCC "-pedantic % m4_ifval($2,$2,-option) %% no, obsolete" dnl new GCC # do FLAGS="$ac_save_[]FLAGS "`echo $ac_arg | sed -e 's,%%.*,,' -e 's,%,,'` AC_TRY_COMPILE([],[return 0;], [VAR=`echo $ac_arg | sed -e 's,.*% *,,'` ; break]) done FLAGS="$ac_save_[]FLAGS" AC_LANG_RESTORE ]) case ".$VAR" in .ok|.ok,*) m4_ifvaln($3,$3) ;; .|.no|.no,*) m4_ifvaln($4,$4) ;; *) m4_ifvaln($3,$3,[ if echo " $[]m4_ifval($1,$1,FLAGS) " | grep " $VAR " 2>&1 >/dev/null then AC_RUN_LOG([: m4_ifval($1,$1,FLAGS) does contain $VAR]) else AC_RUN_LOG([: m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $VAR"]) m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $VAR" fi ]) ;; esac AS_VAR_POPDEF([VAR])dnl AS_VAR_POPDEF([FLAGS])dnl ]) dnl the only difference - the LANG selection... and the default FLAGS AC_DEFUN([AX_CXXFLAGS_GCC_OPTION_OLD], [dnl AS_VAR_PUSHDEF([FLAGS],[CXXFLAGS])dnl AS_VAR_PUSHDEF([VAR],[ac_cv_cxxflags_gcc_option_$2])dnl AC_CACHE_CHECK([m4_ifval($1,$1,FLAGS) for gcc m4_ifval($2,$2,-option)], VAR,[VAR="no, unknown" AC_LANG_SAVE AC_LANG_CPLUSPLUS ac_save_[]FLAGS="$[]FLAGS" for ac_arg dnl in "-pedantic -Werror % m4_ifval($2,$2,-option)" dnl GCC "-pedantic % m4_ifval($2,$2,-option) %% no, obsolete" dnl new GCC # do FLAGS="$ac_save_[]FLAGS "`echo $ac_arg | sed -e 's,%%.*,,' -e 's,%,,'` AC_TRY_COMPILE([],[return 0;], [VAR=`echo $ac_arg | sed -e 's,.*% *,,'` ; break]) done FLAGS="$ac_save_[]FLAGS" AC_LANG_RESTORE ]) case ".$VAR" in .ok|.ok,*) m4_ifvaln($3,$3) ;; .|.no|.no,*) m4_ifvaln($4,$4) ;; *) m4_ifvaln($3,$3,[ if echo " $[]m4_ifval($1,$1,FLAGS) " | grep " $VAR " 2>&1 >/dev/null then AC_RUN_LOG([: m4_ifval($1,$1,FLAGS) does contain $VAR]) else AC_RUN_LOG([: m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $VAR"]) m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $VAR" fi ]) ;; esac AS_VAR_POPDEF([VAR])dnl AS_VAR_POPDEF([FLAGS])dnl ]) dnl ------------------------------------------------------------------------- AC_DEFUN([AX_CFLAGS_GCC_OPTION_NEW], [dnl AS_VAR_PUSHDEF([FLAGS],[CFLAGS])dnl AS_VAR_PUSHDEF([VAR],[ac_cv_cflags_gcc_option_$1])dnl AC_CACHE_CHECK([m4_ifval($2,$2,FLAGS) for gcc m4_ifval($1,$1,-option)], VAR,[VAR="no, unknown" AC_LANG_SAVE AC_LANG_C ac_save_[]FLAGS="$[]FLAGS" for ac_arg dnl in "-pedantic -Werror % m4_ifval($1,$1,-option)" dnl GCC "-pedantic % m4_ifval($1,$1,-option) %% no, obsolete" dnl new GCC # do FLAGS="$ac_save_[]FLAGS "`echo $ac_arg | sed -e 's,%%.*,,' -e 's,%,,'` AC_TRY_COMPILE([],[return 0;], [VAR=`echo $ac_arg | sed -e 's,.*% *,,'` ; break]) done FLAGS="$ac_save_[]FLAGS" AC_LANG_RESTORE ]) case ".$VAR" in .ok|.ok,*) m4_ifvaln($3,$3) ;; .|.no|.no,*) m4_ifvaln($4,$4) ;; *) m4_ifvaln($3,$3,[ if echo " $[]m4_ifval($2,$2,FLAGS) " | grep " $VAR " 2>&1 >/dev/null then AC_RUN_LOG([: m4_ifval($2,$2,FLAGS) does contain $VAR]) else AC_RUN_LOG([: m4_ifval($2,$2,FLAGS)="$m4_ifval($2,$2,FLAGS) $VAR"]) m4_ifval($2,$2,FLAGS)="$m4_ifval($2,$2,FLAGS) $VAR" fi ]) ;; esac AS_VAR_POPDEF([VAR])dnl AS_VAR_POPDEF([FLAGS])dnl ]) dnl the only difference - the LANG selection... and the default FLAGS AC_DEFUN([AX_CXXFLAGS_GCC_OPTION_NEW], [dnl AS_VAR_PUSHDEF([FLAGS],[CXXFLAGS])dnl AS_VAR_PUSHDEF([VAR],[ac_cv_cxxflags_gcc_option_$1])dnl AC_CACHE_CHECK([m4_ifval($2,$2,FLAGS) for gcc m4_ifval($1,$1,-option)], VAR,[VAR="no, unknown" AC_LANG_SAVE AC_LANG_CPLUSPLUS ac_save_[]FLAGS="$[]FLAGS" for ac_arg dnl in "-pedantic -Werror % m4_ifval($1,$1,-option)" dnl GCC "-pedantic % m4_ifval($1,$1,-option) %% no, obsolete" dnl new GCC # do FLAGS="$ac_save_[]FLAGS "`echo $ac_arg | sed -e 's,%%.*,,' -e 's,%,,'` AC_TRY_COMPILE([],[return 0;], [VAR=`echo $ac_arg | sed -e 's,.*% *,,'` ; break]) done FLAGS="$ac_save_[]FLAGS" AC_LANG_RESTORE ]) case ".$VAR" in .ok|.ok,*) m4_ifvaln($3,$3) ;; .|.no|.no,*) m4_ifvaln($4,$4) ;; *) m4_ifvaln($3,$3,[ if echo " $[]m4_ifval($2,$2,FLAGS) " | grep " $VAR " 2>&1 >/dev/null then AC_RUN_LOG([: m4_ifval($2,$2,FLAGS) does contain $VAR]) else AC_RUN_LOG([: m4_ifval($2,$2,FLAGS)="$m4_ifval($2,$2,FLAGS) $VAR"]) m4_ifval($2,$2,FLAGS)="$m4_ifval($2,$2,FLAGS) $VAR" fi ]) ;; esac AS_VAR_POPDEF([VAR])dnl AS_VAR_POPDEF([FLAGS])dnl ]) AC_DEFUN([AX_CFLAGS_GCC_OPTION],[ifelse(m4_bregexp([$2],[-]),-1, [AX_CFLAGS_GCC_OPTION_NEW($@)],[AX_CFLAGS_GCC_OPTION_OLD($@)])]) AC_DEFUN([AX_CXXFLAGS_GCC_OPTION],[ifelse(m4_bregexp([$2],[-]),-1, [AX_CXXFLAGS_GCC_OPTION_NEW($@)],[AX_CXXFLAGS_GCC_OPTION_OLD($@)])]) pupnp-release-1.8.0/m4/ax_cflags_warn_all.m4000066400000000000000000000143551303304015100206660ustar00rootroot00000000000000##### http://autoconf-archive.cryp.to/ax_cflags_warn_all.html # # SYNOPSIS # # AX_CFLAGS_WARN_ALL [(shellvar [,default, [A/NA]])] # # DESCRIPTION # # Try to find a compiler option that enables most reasonable # warnings. This macro is directly derived from VL_PROG_CC_WARNINGS # which is split up into two AX_CFLAGS_WARN_ALL and # AX_CFLAGS_WARN_ALL_ANSI # # For the GNU CC compiler it will be -Wall (and -ansi -pedantic) The # result is added to the shellvar being CFLAGS by default. # # Currently this macro knows about GCC, Solaris C compiler, Digital # Unix C compiler, C for AIX Compiler, HP-UX C compiler, IRIX C # compiler, NEC SX-5 (Super-UX 10) C compiler, and Cray J90 (Unicos # 10.0.0.8) C compiler. # # - $1 shell-variable-to-add-to : CFLAGS # - $2 add-value-if-not-found : nothing # - $3 action-if-found : add value to shellvariable # - $4 action-if-not-found : nothing # # LAST MODIFICATION # # 2006-12-12 # # COPYLEFT # # Copyright (c) 2006 Guido U. Draheim # # This program is free software; you can redistribute it and/or # modify it under the terms of the GNU General Public License as # published by the Free Software Foundation; either version 2 of the # License, or (at your option) any later version. # # This program is distributed in the hope that it will be useful, but # WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU # General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA # 02111-1307, USA. # # As a special exception, the respective Autoconf Macro's copyright # owner gives unlimited permission to copy, distribute and modify the # configure scripts that are the output of Autoconf when processing # the Macro. You need not follow the terms of the GNU General Public # License when using or distributing such scripts, even though # portions of the text of the Macro appear in them. The GNU General # Public License (GPL) does govern all other use of the material that # constitutes the Autoconf Macro. # # This special exception to the GPL applies to versions of the # Autoconf Macro released by the Autoconf Macro Archive. When you # make and distribute a modified version of the Autoconf Macro, you # may extend this special exception to the GPL to apply to your # modified version as well. AC_DEFUN([AX_CFLAGS_WARN_ALL],[dnl AS_VAR_PUSHDEF([FLAGS],[CFLAGS])dnl AS_VAR_PUSHDEF([VAR],[ac_cv_cflags_warn_all])dnl AC_CACHE_CHECK([m4_ifval($1,$1,FLAGS) for maximum warnings], VAR,[VAR="no, unknown" AC_LANG_SAVE AC_LANG_C ac_save_[]FLAGS="$[]FLAGS" for ac_arg dnl in "-pedantic % -Wall" dnl GCC "-xstrconst % -v" dnl Solaris C "-std1 % -verbose -w0 -warnprotos" dnl Digital Unix "-qlanglvl=ansi % -qsrcmsg -qinfo=all:noppt:noppc:noobs:nocnd" dnl AIX "-ansi -ansiE % -fullwarn" dnl IRIX "+ESlit % +w1" dnl HP-UX C "-Xc % -pvctl[,]fullmsg" dnl NEC SX-5 (Super-UX 10) "-h conform % -h msglevel 2" dnl Cray C (Unicos) # do FLAGS="$ac_save_[]FLAGS "`echo $ac_arg | sed -e 's,%%.*,,' -e 's,%,,'` AC_TRY_COMPILE([],[return 0;], [VAR=`echo $ac_arg | sed -e 's,.*% *,,'` ; break]) done FLAGS="$ac_save_[]FLAGS" AC_LANG_RESTORE ]) case ".$VAR" in .ok|.ok,*) m4_ifvaln($3,$3) ;; .|.no|.no,*) m4_ifvaln($4,$4,[m4_ifval($2,[ AC_RUN_LOG([: m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $2"]) m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $2"])]) ;; *) m4_ifvaln($3,$3,[ if echo " $[]m4_ifval($1,$1,FLAGS) " | grep " $VAR " 2>&1 >/dev/null then AC_RUN_LOG([: m4_ifval($1,$1,FLAGS) does contain $VAR]) else AC_RUN_LOG([: m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $VAR"]) m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $VAR" fi ]) ;; esac AS_VAR_POPDEF([VAR])dnl AS_VAR_POPDEF([FLAGS])dnl ]) dnl the only difference - the LANG selection... and the default FLAGS AC_DEFUN([AX_CXXFLAGS_WARN_ALL],[dnl AS_VAR_PUSHDEF([FLAGS],[CXXFLAGS])dnl AS_VAR_PUSHDEF([VAR],[ac_cv_cxxflags_warn_all])dnl AC_CACHE_CHECK([m4_ifval($1,$1,FLAGS) for maximum warnings], VAR,[VAR="no, unknown" AC_LANG_SAVE AC_LANG_CPLUSPLUS ac_save_[]FLAGS="$[]FLAGS" for ac_arg dnl in "-pedantic % -Wall" dnl GCC "-xstrconst % -v" dnl Solaris C "-std1 % -verbose -w0 -warnprotos" dnl Digital Unix "-qlanglvl=ansi % -qsrcmsg -qinfo=all:noppt:noppc:noobs:nocnd" dnl AIX "-ansi -ansiE % -fullwarn" dnl IRIX "+ESlit % +w1" dnl HP-UX C "-Xc % -pvctl[,]fullmsg" dnl NEC SX-5 (Super-UX 10) "-h conform % -h msglevel 2" dnl Cray C (Unicos) # do FLAGS="$ac_save_[]FLAGS "`echo $ac_arg | sed -e 's,%%.*,,' -e 's,%,,'` AC_TRY_COMPILE([],[return 0;], [VAR=`echo $ac_arg | sed -e 's,.*% *,,'` ; break]) done FLAGS="$ac_save_[]FLAGS" AC_LANG_RESTORE ]) case ".$VAR" in .ok|.ok,*) m4_ifvaln($3,$3) ;; .|.no|.no,*) m4_ifvaln($4,$4,[m4_ifval($2,[ AC_RUN_LOG([: m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $2"]) m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $2"])]) ;; *) m4_ifvaln($3,$3,[ if echo " $[]m4_ifval($1,$1,FLAGS) " | grep " $VAR " 2>&1 >/dev/null then AC_RUN_LOG([: m4_ifval($1,$1,FLAGS) does contain $VAR]) else AC_RUN_LOG([: m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $VAR"]) m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $VAR" fi ]) ;; esac AS_VAR_POPDEF([VAR])dnl AS_VAR_POPDEF([FLAGS])dnl ]) dnl implementation tactics: dnl the for-argument contains a list of options. The first part of dnl these does only exist to detect the compiler - usually it is dnl a global option to enable -ansi or -extrawarnings. All other dnl compilers will fail about it. That was needed since a lot of dnl compilers will give false positives for some option-syntax dnl like -Woption or -Xoption as they think of it is a pass-through dnl to later compile stages or something. The "%" is used as a dnl delimimiter. A non-option comment can be given after "%%" marks dnl which will be shown but not added to the respective C/CXXFLAGS. pupnp-release-1.8.0/m4/ax_cflags_warn_all_ansi.m4000066400000000000000000000145271303304015100217010ustar00rootroot00000000000000##### http://autoconf-archive.cryp.to/ax_cflags_warn_all_ansi.html # # SYNOPSIS # # AX_CFLAGS_WARN_ALL_ANSI [(shellvar [,default, [A/NA]])] # # DESCRIPTION # # Try to find a compiler option that enables most reasonable # warnings. This macro is directly derived from VL_PROG_CC_WARNINGS # which is split up into two AX_CFLAGS_WARN_ALL and # AX_CFLAGS_WARN_ALL_ANSI # # For the GNU CC compiler it will be -Wall (and -ansi -pedantic) The # result is added to the shellvar being CFLAGS by default. # # Currently this macro knows about GCC, Solaris C compiler, Digital # Unix C compiler, C for AIX Compiler, HP-UX C compiler, IRIX C # compiler, NEC SX-5 (Super-UX 10) C compiler, and Cray J90 (Unicos # 10.0.0.8) C compiler. # # - $1 shell-variable-to-add-to : CFLAGS # - $2 add-value-if-not-found : nothing # - $3 action-if-found : add value to shellvariable # - $4 action-if-not-found : nothing # # LAST MODIFICATION # # 2006-12-12 # # COPYLEFT # # Copyright (c) 2006 Guido U. Draheim # # This program is free software; you can redistribute it and/or # modify it under the terms of the GNU General Public License as # published by the Free Software Foundation; either version 2 of the # License, or (at your option) any later version. # # This program is distributed in the hope that it will be useful, but # WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU # General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA # 02111-1307, USA. # # As a special exception, the respective Autoconf Macro's copyright # owner gives unlimited permission to copy, distribute and modify the # configure scripts that are the output of Autoconf when processing # the Macro. You need not follow the terms of the GNU General Public # License when using or distributing such scripts, even though # portions of the text of the Macro appear in them. The GNU General # Public License (GPL) does govern all other use of the material that # constitutes the Autoconf Macro. # # This special exception to the GPL applies to versions of the # Autoconf Macro released by the Autoconf Macro Archive. When you # make and distribute a modified version of the Autoconf Macro, you # may extend this special exception to the GPL to apply to your # modified version as well. AC_DEFUN([AX_CFLAGS_WARN_ALL_ANSI],[dnl AS_VAR_PUSHDEF([FLAGS],[CFLAGS])dnl AS_VAR_PUSHDEF([VAR],[ac_cv_cflags_warn_all_ansi])dnl AC_CACHE_CHECK([m4_ifval($1,$1,FLAGS) for maximum ansi warnings], VAR,[VAR="no, unknown" AC_LANG_SAVE AC_LANG_C ac_save_[]FLAGS="$[]FLAGS" # IRIX C compiler: # -use_readonly_const is the default for IRIX C, # puts them into .rodata, but they are copied later. # need to be "-G0 -rdatashared" for strictmode but # I am not sure what effect that has really. - guidod for ac_arg dnl in "-pedantic % -Wall -ansi -pedantic" dnl GCC "-xstrconst % -v -Xc" dnl Solaris C "-std1 % -verbose -w0 -warnprotos -std1" dnl Digital Unix " % -qlanglvl=ansi -qsrcmsg -qinfo=all:noppt:noppc:noobs:nocnd" dnl AIX " % -ansi -ansiE -fullwarn" dnl IRIX "+ESlit % +w1 -Aa" dnl HP-UX C "-Xc % -pvctl[,]fullmsg -Xc" dnl NEC SX-5 (Super-UX 10) "-h conform % -h msglevel 2 -h conform" dnl Cray C (Unicos) # do FLAGS="$ac_save_[]FLAGS "`echo $ac_arg | sed -e 's,%%.*,,' -e 's,%,,'` AC_TRY_COMPILE([],[return 0;], [VAR=`echo $ac_arg | sed -e 's,.*% *,,'` ; break]) done FLAGS="$ac_save_[]FLAGS" AC_LANG_RESTORE ]) case ".$VAR" in .ok|.ok,*) m4_ifvaln($3,$3) ;; .|.no|.no,*) m4_ifvaln($4,$4,[m4_ifval($2,[ AC_RUN_LOG([: m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $2"]) m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $2"])]) ;; *) m4_ifvaln($3,$3,[ if echo " $[]m4_ifval($1,$1,FLAGS) " | grep " $VAR " 2>&1 >/dev/null then AC_RUN_LOG([: m4_ifval($1,$1,FLAGS) does contain $VAR]) else AC_RUN_LOG([: m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $VAR"]) m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $VAR" fi ]) ;; esac AS_VAR_POPDEF([VAR])dnl AS_VAR_POPDEF([FLAGS])dnl ]) dnl the only difference - the LANG selection... and the default FLAGS AC_DEFUN([AX_CXXFLAGS_WARN_ALL_ANSI],[dnl AS_VAR_PUSHDEF([FLAGS],[CXXFLAGS])dnl AS_VAR_PUSHDEF([VAR],[ac_cv_cxxflags_warn_all_ansi])dnl AC_CACHE_CHECK([m4_ifval($1,$1,FLAGS) for maximum ansi warnings], VAR,[VAR="no, unknown" AC_LANG_SAVE AC_LANG_CPLUSPLUS ac_save_[]FLAGS="$[]FLAGS" # IRIX C compiler: # -use_readonly_const is the default for IRIX C, # puts them into .rodata, but they are copied later. # need to be "-G0 -rdatashared" for strictmode but # I am not sure what effect that has really. - guidod for ac_arg dnl in "-pedantic % -Wall -ansi -pedantic" dnl GCC "-xstrconst % -v -Xc" dnl Solaris C "-std1 % -verbose -w0 -warnprotos -std1" dnl Digital Unix " % -qlanglvl=ansi -qsrcmsg -qinfo=all:noppt:noppc:noobs:nocnd" dnl AIX " % -ansi -ansiE -fullwarn" dnl IRIX "+ESlit % +w1 -Aa" dnl HP-UX C "-Xc % -pvctl[,]fullmsg -Xc" dnl NEC SX-5 (Super-UX 10) "-h conform % -h msglevel 2 -h conform" dnl Cray C (Unicos) # do FLAGS="$ac_save_[]FLAGS "`echo $ac_arg | sed -e 's,%%.*,,' -e 's,%,,'` AC_TRY_COMPILE([],[return 0;], [VAR=`echo $ac_arg | sed -e 's,.*% *,,'` ; break]) done FLAGS="$ac_save_[]FLAGS" AC_LANG_RESTORE ]) case ".$VAR" in .ok|.ok,*) m4_ifvaln($3,$3) ;; .|.no|.no,*) m4_ifvaln($4,$4,[m4_ifval($2,[ AC_RUN_LOG([: m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $2"]) m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $2"])]) ;; *) m4_ifvaln($3,$3,[ if echo " $[]m4_ifval($1,$1,FLAGS) " | grep " $VAR " 2>&1 >/dev/null then AC_RUN_LOG([: m4_ifval($1,$1,FLAGS) does contain $VAR]) else AC_RUN_LOG([: m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $VAR"]) m4_ifval($1,$1,FLAGS)="$m4_ifval($1,$1,FLAGS) $VAR" fi ]) ;; esac AS_VAR_POPDEF([VAR])dnl AS_VAR_POPDEF([FLAGS])dnl ]) pupnp-release-1.8.0/m4/rt_bool_arg_enable.m4000066400000000000000000000035061303304015100206530ustar00rootroot00000000000000dnl @synopsis RT_BOOL_ARG_ENABLE([FLAG],[DEFAULT],[HELP STRING]) dnl dnl This macro declares a configure option with 'AC_ARG_ENABLE'. dnl It is a boolean argument (yes or no values only), and dnl the corresponding shell variable 'enable_arg' is guaranteed to dnl be one or the other. dnl A message is also printed. dnl dnl Arguments dnl $1 = flag name e.g. [debug] dnl $2 = default value, shall be m4 constant, either [yes] or [no] dnl $3 = help string (default value is appended) e.g. [compile debugging code] dnl dnl @version $Id: rt_bool_arg_enable.m4,v 1.2 2006/02/18 14:35:09 r3mi Exp $ dnl @author Rmi Turboult dnl @license GPLWithACException dnl dnl This file is free software, distributed under the terms of the GNU dnl General Public License. As a special exception to the GNU General dnl Public License, this file may be distributed as part of a program dnl that contains a configuration script generated by Autoconf, under dnl the same distribution terms as the rest of that program. dnl AC_DEFUN([RT_BOOL_ARG_ENABLE],[ dnl m4_pushdef([Name],AS_TR_SH($1))dnl m4_pushdef([NAME],AS_TR_CPP($1))dnl dnl AC_MSG_CHECKING([for --enable-]Name) dnl dnl use some m4 sugar to have only one 'AC_ARG_ENABLE' declaration, dnl else "configure --help" is confused dnl AC_ARG_ENABLE(Name, [m4_case([$2], [yes],AS_HELP_STRING([--disable-]Name, [disable $3 @<:@default=enabled@:>@]), [no],AS_HELP_STRING([--enable-]Name, [enable $3 @<:@default=disabled@:>@]), [m4_fatal([incorrect boolean argument '$2'])] )]) test "x$enable_[$1]" != [x]m4_if([$2],[yes],[no],[yes]) dnl && enable_[]Name=[$2] AC_MSG_RESULT($enable_[]Name) AM_CONDITIONAL([ENABLE_]NAME, test x"$enable_[]Name" = xyes) dnl m4_popdef([NAME])dnl m4_popdef([Name])dnl dnl ])dnl pupnp-release-1.8.0/m4/type_socklen_t.m4000066400000000000000000000044001303304015100200700ustar00rootroot00000000000000##### http://autoconf-archive.cryp.to/type_socklen_t.html # # SYNOPSIS # # TYPE_SOCKLEN_T # # DESCRIPTION # # Check whether sys/socket.h defines type socklen_t. Please note that # some systems require sys/types.h to be included before sys/socket.h # can be compiled. # # LAST MODIFICATION # # 2005-01-11 # # COPYLEFT # # Copyright (c) 2005 Lars Brinkhoff # # This program is free software; you can redistribute it and/or # modify it under the terms of the GNU General Public License as # published by the Free Software Foundation; either version 2 of the # License, or (at your option) any later version. # # This program is distributed in the hope that it will be useful, but # WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU # General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA # 02111-1307, USA. # # As a special exception, the respective Autoconf Macro's copyright # owner gives unlimited permission to copy, distribute and modify the # configure scripts that are the output of Autoconf when processing # the Macro. You need not follow the terms of the GNU General Public # License when using or distributing such scripts, even though # portions of the text of the Macro appear in them. The GNU General # Public License (GPL) does govern all other use of the material that # constitutes the Autoconf Macro. # # This special exception to the GPL applies to versions of the # Autoconf Macro released by the Autoconf Macro Archive. When you # make and distribute a modified version of the Autoconf Macro, you # may extend this special exception to the GPL to apply to your # modified version as well. AC_DEFUN([TYPE_SOCKLEN_T], [AC_CACHE_CHECK([for socklen_t], ac_cv_type_socklen_t, [ AC_TRY_COMPILE( [#include #include ], [socklen_t len = 42; return 0;], ac_cv_type_socklen_t=yes, ac_cv_type_socklen_t=no) ]) if test $ac_cv_type_socklen_t != yes; then AC_DEFINE(socklen_t, int, [Substitute for socklen_t]) fi ]) pupnp-release-1.8.0/svnignore000066400000000000000000000002021303304015100162150ustar00rootroot00000000000000.deps .dirstamp .libs .*.swp *~ Makefile Makefile.in aclocal.m4 autoconfig.h* autom4te.cache config* libtool libupnp*.pc stamp-h* pupnp-release-1.8.0/threadutil/000077500000000000000000000000001303304015100164335ustar00rootroot00000000000000pupnp-release-1.8.0/threadutil/Makefile.am000066400000000000000000000013231303304015100204660ustar00rootroot00000000000000# # "Makefile.am" for "libupnp/threadutil" # # (C) Copyright 2005 Remi Turboult # AM_CPPFLAGS = -I$(srcdir)/inc -I$(srcdir)/src/inc \ -I$(top_srcdir)/upnp/inc if ENABLE_DEBUG AM_CPPFLAGS += -DDEBUG -DSTATS else AM_CPPFLAGS += -DNO_DEBUG -DNDEBUG endif lib_LTLIBRARIES = libthreadutil-1.8.la libthreadutil_1_8_la_LDFLAGS = -version-info $(LT_VERSION_THREADUTIL) libthreadutil_1_8_la_SOURCES = \ inc/FreeList.h \ src/FreeList.c \ inc/LinkedList.h \ src/LinkedList.c \ inc/ThreadPool.h \ src/ThreadPool.c \ inc/TimerThread.h \ src/TimerThread.c upnpincludedir = $(includedir)/upnp-1.8 upnpinclude_HEADERS = \ inc/ithread.h pupnp-release-1.8.0/threadutil/inc/000077500000000000000000000000001303304015100172045ustar00rootroot00000000000000pupnp-release-1.8.0/threadutil/inc/FreeList.h000066400000000000000000000072661303304015100211050ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * * Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef FREE_LIST_H #define FREE_LIST_H /*! * \file */ #ifdef __cplusplus extern "C" { #endif #include "ithread.h" #include /*! * Free list node. points to next free item. * Memory for node is borrowed from allocated items. * \internal */ typedef struct FREELISTNODE { struct FREELISTNODE *next; } FreeListNode; /*! * Stores head and size of free list, as well as mutex for protection. * \internal */ typedef struct FREELIST { FreeListNode *head; size_t element_size; int maxFreeListLength; int freeListLength; } FreeList; /*! * \brief Initializes Free List. * * Must be called first and only once for FreeList. * * \return: * \li \c 0 on success. * \li \c EINVAL on failure. */ int FreeListInit( /*! Must be valid, non null, pointer to a linked list. */ FreeList *free_list, /*! Size of elements to store in free list. */ size_t elementSize, /*! Max size that the free list can grow to before returning * memory to O.S. */ int maxFreeListLength); /*! * \brief Allocates chunk of set size. * * If a free item is available in the list, returnes the stored item, * otherwise calls the O.S. to allocate memory. * * \return Non NULL on success. NULL on failure. */ void *FreeListAlloc( /*! Must be valid, non null, pointer to a linked list. */ FreeList *free_list); /*! * \brief Returns an item to the Free List. * * If the free list is smaller than the max size then adds the item to the * free list, otherwise returns the item to the O.S. * * \return: * \li \c 0 on success. * \li \c EINVAL on failure. */ int FreeListFree( /*! Must be valid, non null, pointer to a free list. */ FreeList *free_list, /*! Must be a pointer allocated by FreeListAlloc. */ void *element); /*! * \brief Releases the resources stored with the free list. * * \return: * \li \c 0 on success. * \li \c EINVAL on failure. */ int FreeListDestroy( /*! Must be valid, non null, pointer to a linked list. */ FreeList *free_list); #ifdef __cplusplus } #endif #endif /* FREE_LIST_H */ pupnp-release-1.8.0/threadutil/inc/LinkedList.h000066400000000000000000000176351303304015100214330ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * * Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef LINKED_LIST_H #define LINKED_LIST_H /*! * \file */ #include "FreeList.h" #ifdef __cplusplus extern "C" { #endif #define EOUTOFMEM (-7 & 1<<29) #define FREELISTSIZE 100 #define LIST_SUCCESS 1 #define LIST_FAIL 0 /*! Function for freeing list items. */ typedef void (*free_function)(void *arg); /*! Function for comparing list items. Returns 1 if itemA==itemB */ typedef int (*cmp_routine)(void *itemA,void *itemB); /*! Linked list node. Stores generic item and pointers to next and prev. * \internal */ typedef struct LISTNODE { struct LISTNODE *prev; struct LISTNODE *next; void *item; } ListNode; /*! * Linked list (no protection). * * Because this is for internal use, parameters are NOT checked for validity. * The first item of the list is stored at node: head->next * The last item of the list is stored at node: tail->prev * If head->next=tail, then list is empty. * To iterate through the list: * * LinkedList g; * ListNode *temp = NULL; * for (temp = ListHead(g);temp!=NULL;temp = ListNext(g,temp)) { * } * * \internal */ typedef struct LINKEDLIST { /*! head, first item is stored at: head->next */ ListNode head; /*! tail, last item is stored at: tail->prev */ ListNode tail; /*! size of list */ long size; /*! free list to use */ FreeList freeNodeList; /*! free function to use */ free_function free_func; /*! compare function to use */ cmp_routine cmp_func; } LinkedList; /*! * \brief Initializes LinkedList. Must be called first and only once for List. * * \return * \li \c 0 on success. * \li \c EOUTOFMEM on failure. */ int ListInit( /*! Must be valid, non null, pointer to a linked list. */ LinkedList *list, /*! Function used to compare items. (May be NULL). */ cmp_routine cmp_func, /*! Function used to free items. (May be NULL). */ free_function free_func); /*! * \brief Adds a node to the head of the list. Node gets immediately after * list head. * * Precondition: * The list has been initialized. * * \return The pointer to the ListNode on success, NULL on failure. */ ListNode *ListAddHead( /*! Must be valid, non null, pointer to a linked list. */ LinkedList *list, /*! Item to be added. */ void *item); /*! * \brief Adds a node to the tail of the list. Node gets added immediately * before list.tail. * * Precondition: The list has been initialized. * * \return The pointer to the ListNode on success, NULL on failure. */ ListNode *ListAddTail( /*! Must be valid, non null, pointer to a linked list. */ LinkedList *list, /*! Item to be added. */ void *item); /*! * \brief Adds a node after the specified node. Node gets added immediately * after bnode. * * Precondition: The list has been initialized. * * \return The pointer to the ListNode on success, NULL on failure. */ ListNode *ListAddAfter( /*! Must be valid, non null, pointer to a linked list. */ LinkedList *list, /*! Item to be added. */ void *item, /*! Node to add after. */ ListNode *bnode); /*! * \brief Adds a node before the specified node. Node gets added immediately * before anode. * * Precondition: The list has been initialized. * * \return The pointer to the ListNode on success, NULL on failure. */ ListNode *ListAddBefore( /*! Must be valid, non null, pointer to a linked list. */ LinkedList *list, /*! Item to be added. */ void *item, /*! Node to add in front of. */ ListNode *anode); /*! * \brief Removes a node from the list. The memory for the node is freed. * * Precondition: The list has been initialized. * * \return The pointer to the item stored in the node or NULL if the item * is freed. */ void *ListDelNode( /*! Must be valid, non null, pointer to a linked list. */ LinkedList *list, /*! Node to delete. */ ListNode *dnode, /*! if !0 then item is freed using free function. If 0 (or free * function is NULL) then item is not freed. */ int freeItem); /*! * \brief Removes all memory associated with list nodes. Does not free * LinkedList *list. * * Precondition: The list has been initialized. * * \return 0 on success, EINVAL on failure. */ int ListDestroy( /*! Must be valid, non null, pointer to a linked list. */ LinkedList *list, /*! if !0 then item is freed using free function. If 0 (or free * function is NULL) then item is not freed. */ int freeItem); /*! * \brief Returns the head of the list. * * Precondition: The list has been initialized. * * \return The head of the list. NULL if list is empty. */ ListNode *ListHead( /*! Must be valid, non null, pointer to a linked list. */ LinkedList *list); /*! * \brief Returns the tail of the list. * * Precondition: The list has been initialized. * * \return The tail of the list. NULL if list is empty. */ ListNode *ListTail( /*! Must be valid, non null, pointer to a linked list. */ LinkedList *list); /*! * \brief Returns the next item in the list. * * Precondition: The list has been initialized. * * \return The next item in the list. NULL if there are no more items in list. */ ListNode *ListNext( /*! Must be valid, non null, pointer to a linked list. */ LinkedList *list, /*! Node from the list. */ ListNode *node); /*! * \brief Returns the previous item in the list. * * Precondition: The list has been initialized. * * \return The previous item in the list. NULL if there are no more items in list. */ ListNode *ListPrev( /*! Must be valid, non null, pointer to a linked list. */ LinkedList *list, /*! Node from the list. */ ListNode *node); /*! * \brief Finds the specified item in the list. * * Uses the compare function specified in ListInit. If compare function * is NULL then compares items as pointers. * * Precondition: The list has been initialized. * * \return The node containing the item. NULL if no node contains the item. */ ListNode* ListFind( /*! Must be valid, non null, pointer to a linked list. */ LinkedList *list, /*! The node to start from, NULL if to start from beginning. */ ListNode *start, /*! The item to search for. */ void *item); /*! * \brief Returns the size of the list. * * Precondition: The list has been initialized. * * \return The number of items in the list. */ long ListSize( /*! Must be valid, non null, pointer to a linked list. */ LinkedList* list); #ifdef __cplusplus } #endif #endif /* LINKED_LIST_H */ pupnp-release-1.8.0/threadutil/inc/ThreadPool.h000066400000000000000000000337631303304015100214320ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * * Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef THREADPOOL_H #define THREADPOOL_H /*! * \file */ #include "FreeList.h" #include "ithread.h" #include "LinkedList.h" #include "UpnpInet.h" #include "UpnpGlobal.h" /* for UPNP_INLINE, EXPORT_SPEC */ #include #ifdef WIN32 #include struct timezone { int tz_minuteswest; /* minutes W of Greenwich */ int tz_dsttime; /* type of dst correction */ }; int gettimeofday(struct timeval *tv, struct timezone *tz); #else /* WIN32 */ #include #include /* for gettimeofday() */ #if defined(__OSX__) || defined(__APPLE__) || defined(__NetBSD__) #include /* for setpriority() */ #endif #endif #ifdef __cplusplus extern "C" { #endif /*! Size of job free list */ #define JOBFREELISTSIZE 100 #define INFINITE_THREADS -1 #define EMAXTHREADS (-8 & 1<<29) /*! Invalid Policy */ #define INVALID_POLICY (-9 & 1<<29) /*! Invalid JOB Id */ #define INVALID_JOB_ID (-2 & 1<<29) typedef enum duration { SHORT_TERM, PERSISTENT } Duration; typedef enum priority { LOW_PRIORITY, MED_PRIORITY, HIGH_PRIORITY } ThreadPriority; /*! default priority used by TPJobInit */ #define DEFAULT_PRIORITY MED_PRIORITY /*! default minimum used by TPAttrInit */ #define DEFAULT_MIN_THREADS 1 /*! default max used by TPAttrInit */ #define DEFAULT_MAX_THREADS 10 /*! default stack size used by TPAttrInit */ #define DEFAULT_STACK_SIZE 0u /*! default jobs per thread used by TPAttrInit */ #define DEFAULT_JOBS_PER_THREAD 10 /*! default starvation time used by TPAttrInit */ #define DEFAULT_STARVATION_TIME 500 /*! default idle time used by TPAttrInit */ #define DEFAULT_IDLE_TIME 10 * 1000 /*! default free routine used TPJobInit */ #define DEFAULT_FREE_ROUTINE NULL /*! default max jobs used TPAttrInit */ #define DEFAULT_MAX_JOBS_TOTAL 100 /*! * \brief Statistics. * * Always include stats because code change is minimal. */ #define STATS 1 #ifdef _DEBUG #define DEBUG 1 #endif typedef int PolicyType; #define DEFAULT_POLICY SCHED_OTHER /*! Function for freeing a thread argument. */ typedef void (*free_routine)(void *arg); /*! Attributes for thread pool. Used to set and change parameters of thread * pool. */ typedef struct THREADPOOLATTR { /*! ThreadPool will always maintain at least this many threads. */ int minThreads; /*! ThreadPool will never have more than this number of threads. */ int maxThreads; /*! This is the minimum stack size allocated for each thread. */ size_t stackSize; /*! This is the maximum time a thread will * remain idle before dying (in milliseconds). */ int maxIdleTime; /*! Jobs per thread to maintain. */ int jobsPerThread; /*! Maximum number of jobs that can be queued totally. */ int maxJobsTotal; /*! the time a low priority or med priority job waits before getting * bumped up a priority (in milliseconds). */ int starvationTime; /*! scheduling policy to use. */ PolicyType schedPolicy; } ThreadPoolAttr; /*! Internal ThreadPool Job. */ typedef struct THREADPOOLJOB { start_routine func; void *arg; free_routine free_func; struct timeval requestTime; ThreadPriority priority; int jobId; } ThreadPoolJob; /*! Structure to hold statistics. */ typedef struct TPOOLSTATS { double totalTimeHQ; int totalJobsHQ; double avgWaitHQ; double totalTimeMQ; int totalJobsMQ; double avgWaitMQ; double totalTimeLQ; int totalJobsLQ; double avgWaitLQ; double totalWorkTime; double totalIdleTime; int workerThreads; int idleThreads; int persistentThreads; int totalThreads; int maxThreads; int currentJobsHQ; int currentJobsLQ; int currentJobsMQ; } ThreadPoolStats; /*! * \brief A thread pool similar to the thread pool in the UPnP SDK. * * Allows jobs to be scheduled for running by threads in a * thread pool. The thread pool is initialized with a * minimum and maximum thread number as well as a max idle time * and a jobs per thread ratio. If a worker thread waits the whole * max idle time without receiving a job and the thread pool * currently has more threads running than the minimum * then the worker thread will exit. If when * scheduling a job the current job to thread ratio * becomes greater than the set ratio and the thread pool currently has * less than the maximum threads then a new thread will * be created. */ typedef struct THREADPOOL { /*! Mutex to protect job qs. */ ithread_mutex_t mutex; /*! Condition variable to signal Q. */ ithread_cond_t condition; /*! Condition variable for start and stop. */ ithread_cond_t start_and_shutdown; /*! ids for jobs */ int lastJobId; /*! whether or not we are shutting down */ int shutdown; /*! total number of threads */ int totalThreads; /*! flag that's set when waiting for a new worker thread to start */ int pendingWorkerThreadStart; /*! number of threads that are currently executing jobs */ int busyThreads; /*! number of persistent threads */ int persistentThreads; /*! free list of jobs */ FreeList jobFreeList; /*! low priority job Q */ LinkedList lowJobQ; /*! med priority job Q */ LinkedList medJobQ; /*! high priority job Q */ LinkedList highJobQ; /*! persistent job */ ThreadPoolJob *persistentJob; /*! thread pool attributes */ ThreadPoolAttr attr; /*! statistics */ ThreadPoolStats stats; } ThreadPool; /*! * \brief Initializes and starts ThreadPool. Must be called first and * only once for ThreadPool. * * \return * \li \c 0 on success. * \li \c EAGAIN if not enough system resources to create minimum threads. * \li \c INVALID_POLICY if schedPolicy can't be set. * \li \c EMAXTHREADS if minimum threads is greater than maximum threads. */ int ThreadPoolInit( /*! Must be valid, non null, pointer to ThreadPool. */ ThreadPool *tp, /*! Can be null. if not null then attr contains the following fields: * \li \c minWorkerThreads - minimum number of worker threads thread * pool will never have less than this number of threads. * \li \c maxWorkerThreads - maximum number of worker threads thread * pool will never have more than this number of threads. * \li \c maxIdleTime - maximum time that a worker thread will spend * idle. If a worker is idle longer than this time and there are more * than the min number of workers running, then the worker thread * exits. * \li \c jobsPerThread - ratio of jobs to thread to try and maintain * if a job is scheduled and the number of jobs per thread is greater * than this number,and if less than the maximum number of workers are * running then a new thread is started to help out with efficiency. * \li \c schedPolicy - scheduling policy to try and set (OS dependent). */ ThreadPoolAttr *attr); /*! * \brief Adds a persistent job to the thread pool. * * Job will be run as soon as possible. Call will block until job is scheduled. * * \return * \li \c 0 on success. * \li \c EOUTOFMEM not enough memory to add job. * \li \c EMAXTHREADS not enough threads to add persistent job. */ int ThreadPoolAddPersistent( /*! Valid thread pool pointer. */ ThreadPool*tp, /*! Valid thread pool job. */ ThreadPoolJob *job, /*! . */ int *jobId); /*! * \brief Gets the current set of attributes associated with the thread pool. * * \return * \li \c 0 on success, nonzero on failure. */ int ThreadPoolGetAttr( /*! valid thread pool pointer. */ ThreadPool *tp, /*! non null pointer to store attributes. */ ThreadPoolAttr *out); /*! * \brief Sets the attributes for the thread pool. * Only affects future calculations. * * \return * \li \c 0 on success, nonzero on failure. * \li \c INVALID_POLICY if policy can not be set. */ int ThreadPoolSetAttr( /*! valid thread pool pointer. */ ThreadPool *tp, /*! pointer to attributes, null sets attributes to default. */ ThreadPoolAttr *attr); /*! * \brief Adds a job to the thread pool. Job will be run as soon as possible. * * \return * \li \c 0 on success, nonzero on failure. * \li \c EOUTOFMEM if not enough memory to add job. */ int ThreadPoolAdd( /*! valid thread pool pointer. */ ThreadPool*tp, /*! . */ ThreadPoolJob *job, /*! id of job. */ int *jobId); /*! * \brief Removes a job from the thread pool. Can only remove jobs which * are not currently running. * * \return * \li \c 0 on success, nonzero on failure. * \li \c INVALID_JOB_ID if job not found. */ int ThreadPoolRemove( /*! valid thread pool pointer. */ ThreadPool *tp, /*! id of job. */ int jobId, /*! space for removed job. */ ThreadPoolJob *out); /*! * \brief Shuts the thread pool down. Waits for all threads to finish. * May block indefinitely if jobs do not exit. * * \return 0 on success, nonzero on failure */ int ThreadPoolShutdown( /*! must be valid tp. */ ThreadPool *tp); /*! * \brief Initializes thread pool job. Sets the priority to default defined * in ThreadPool.h. Sets the free_routine to default defined in ThreadPool.h. * * \return Always returns 0. */ int TPJobInit( /*! must be valid thread pool attributes. */ ThreadPoolJob *job, /*! function to run, must be valid. */ start_routine func, /*! argument to pass to function. */ void *arg); /*! * \brief Sets the max threads for the thread pool attributes. * * \return Always returns 0. */ int TPJobSetPriority( /*! must be valid thread pool attributes. */ ThreadPoolJob *job, /*! value to set. */ ThreadPriority priority); /*! * \brief Sets the max threads for the thread pool attributes. * * \return Always returns 0. */ int TPJobSetFreeFunction( /*! must be valid thread pool attributes. */ ThreadPoolJob *job, /*! value to set. */ free_routine func); /*! * \brief Initializes thread pool attributes. Sets values to defaults defined * in ThreadPool.h. * * \return Always returns 0. */ int TPAttrInit( /*! must be valid thread pool attributes. */ ThreadPoolAttr *attr); /*! * \brief Sets the max threads for the thread pool attributes. * * \return Always returns 0. */ int TPAttrSetMaxThreads( /*! must be valid thread pool attributes. */ ThreadPoolAttr *attr, /*! value to set. */ int maxThreads); /*! * \brief Sets the min threads for the thread pool attributes. * * \return Always returns 0. */ int TPAttrSetMinThreads( /*! must be valid thread pool attributes. */ ThreadPoolAttr *attr, /*! value to set. */ int minThreads); /*! * \brief Sets the stack size for the thread pool attributes. * * \return Always returns 0. */ int TPAttrSetStackSize( /*! must be valid thread pool attributes. */ ThreadPoolAttr *attr, /*! value to set. */ size_t stackSize); /*! * \brief Sets the idle time for the thread pool attributes. * * \return Always returns 0. */ int TPAttrSetIdleTime( /*! must be valid thread pool attributes. */ ThreadPoolAttr *attr, /*! . */ int idleTime); /*! * \brief Sets the jobs per thread ratio * * \return Always returns 0. */ int TPAttrSetJobsPerThread( /*! must be valid thread pool attributes. */ ThreadPoolAttr *attr, /*! number of jobs per thread to maintain. */ int jobsPerThread); /*! * \brief Sets the starvation time for the thread pool attributes. * * \return Always returns 0. */ int TPAttrSetStarvationTime( /*! must be valid thread pool attributes. */ ThreadPoolAttr *attr, /*! milliseconds. */ int starvationTime); /*! * \brief Sets the scheduling policy for the thread pool attributes. * * \return Always returns 0. */ int TPAttrSetSchedPolicy( /*! must be valid thread pool attributes. */ ThreadPoolAttr *attr, /*! must be a valid policy type. */ PolicyType schedPolicy); /*! * \brief Sets the maximum number jobs that can be qeued totally. * * \return Always returns 0. */ int TPAttrSetMaxJobsTotal( /*! must be valid thread pool attributes. */ ThreadPoolAttr *attr, /*! maximum number of jobs. */ int maxJobsTotal); /*! * \brief Returns various statistics about the thread pool. * * Only valid if STATS has been defined. * * \return Always returns 0. */ #ifdef STATS EXPORT_SPEC int ThreadPoolGetStats( /*! Valid initialized threadpool. */ ThreadPool *tp, /*! Valid stats, out parameter. */ ThreadPoolStats *stats); #else static UPNP_INLINE int ThreadPoolGetStats( /*! Valid initialized threadpool. */ ThreadPool *tp, /*! Valid stats, out parameter. */ ThreadPoolStats *stats) {} #endif /*! * \brief */ #ifdef STATS EXPORT_SPEC void ThreadPoolPrintStats( /*! . */ ThreadPoolStats *stats); #else static UPNP_INLINE void ThreadPoolPrintStats( /*! . */ ThreadPoolStats *stats) {} #endif #ifdef __cplusplus } #endif #endif /* THREADPOOL_H */ pupnp-release-1.8.0/threadutil/inc/TimerThread.h000066400000000000000000000112601303304015100215650ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * * Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef TIMERTHREAD_H #define TIMERTHREAD_H /*! * \file */ #include "FreeList.h" #include "ithread.h" #include "LinkedList.h" #include "ThreadPool.h" #ifdef __cplusplus extern "C" { #endif #define INVALID_EVENT_ID (-10 & 1<<29) /*! Timeout Types. */ typedef enum timeoutType { /*! seconds from Jan 1, 1970. */ ABS_SEC, /*! seconds from current time. */ REL_SEC } TimeoutType; /*! * A timer thread similar to the one in the Upnp SDK that allows * the scheduling of a job to run at a specified time in the future. * * Because the timer thread uses the thread pool there is no * gurantee of timing, only approximate timing. * * Uses ThreadPool, Mutex, Condition, Thread. */ typedef struct TIMERTHREAD { ithread_mutex_t mutex; ithread_cond_t condition; int lastEventId; LinkedList eventQ; int shutdown; FreeList freeEvents; ThreadPool *tp; } TimerThread; /*! * Struct to contain information for a timer event. * * Internal to the TimerThread. */ typedef struct TIMEREVENT { ThreadPoolJob job; /*! [in] Absolute time for event in seconds since Jan 1, 1970. */ time_t eventTime; /*! [in] Long term or short term job. */ Duration persistent; int id; } TimerEvent; /*! * \brief Initializes and starts timer thread. * * \return 0 on success, nonzero on failure. Returns error from * ThreadPoolAddPersistent on failure. */ int TimerThreadInit( /*! [in] Valid timer thread pointer. */ TimerThread *timer, /*! [in] Valid thread pool to use. Must be started. Must be valid for * lifetime of timer. Timer must be shutdown BEFORE thread pool. */ ThreadPool *tp); /*! * \brief Schedules an event to run at a specified time. * * \return 0 on success, nonzero on failure, EOUTOFMEM if not enough memory * to schedule job. */ int TimerThreadSchedule( /*! [in] Valid timer thread pointer. */ TimerThread* timer, /*! [in] time of event. Either in absolute seconds, or relative * seconds in the future. */ time_t time, /*! [in] either ABS_SEC, or REL_SEC. If REL_SEC, then the event * will be scheduled at the current time + REL_SEC. */ TimeoutType type, /*! [in] Valid Thread pool job with following fields. */ ThreadPoolJob *job, /*! [in] . */ Duration duration, /*! [in] Id of timer event. (out, can be null). */ int *id); /*! * \brief Removes an event from the timer Q. * * Events can only be removed before they have been placed in the thread pool. * * \return 0 on success, INVALID_EVENT_ID on failure. */ int TimerThreadRemove( /*! [in] Valid timer thread pointer. */ TimerThread *timer, /*! [in] Id of event to remove. */ int id, /*! [in] Space for thread pool job. */ ThreadPoolJob *out); /*! * \brief Shutdown the timer thread. * * Events scheduled in the future will NOT be run. * * Timer thread should be shutdown BEFORE it's associated thread pool. * * \return 0 if succesfull, nonzero otherwise. Always returns 0. */ int TimerThreadShutdown( /*! [in] Valid timer thread pointer. */ TimerThread *timer); #ifdef __cplusplus } #endif #endif /* TIMER_THREAD_H */ pupnp-release-1.8.0/threadutil/inc/ithread.h000066400000000000000000001015441303304015100210020ustar00rootroot00000000000000#ifndef ITHREAD_H #define ITHREAD_H /******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * * Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \file */ #if !defined(WIN32) #include #endif #include "UpnpGlobal.h" /* For UPNP_INLINE, EXPORT_SPEC */ #include "UpnpUniStd.h" /* for close() */ #ifdef __cplusplus extern "C" { #endif #include #if defined(BSD) && !defined(__GNU__) #define PTHREAD_MUTEX_RECURSIVE_NP PTHREAD_MUTEX_RECURSIVE #endif #if defined(PTHREAD_MUTEX_RECURSIVE) || defined(__DragonFly__) /* This system has SuS2-compliant mutex attributes. * E.g. on Cygwin, where we don't have the old nonportable (NP) symbols */ #define ITHREAD_MUTEX_FAST_NP PTHREAD_MUTEX_NORMAL #define ITHREAD_MUTEX_RECURSIVE_NP PTHREAD_MUTEX_RECURSIVE #define ITHREAD_MUTEX_ERRORCHECK_NP PTHREAD_MUTEX_ERRORCHECK #else /* PTHREAD_MUTEX_RECURSIVE */ #define ITHREAD_MUTEX_FAST_NP PTHREAD_MUTEX_FAST_NP #define ITHREAD_MUTEX_RECURSIVE_NP PTHREAD_MUTEX_RECURSIVE_NP #define ITHREAD_MUTEX_ERRORCHECK_NP PTHREAD_MUTEX_ERRORCHECK_NP #endif /* PTHREAD_MUTEX_RECURSIVE */ #define ITHREAD_PROCESS_PRIVATE PTHREAD_PROCESS_PRIVATE #define ITHREAD_PROCESS_SHARED PTHREAD_PROCESS_SHARED #define ITHREAD_CANCELED PTHREAD_CANCELED #define ITHREAD_STACK_MIN PTHREAD_STACK_MIN #define ITHREAD_CREATE_DETACHED PTHREAD_CREATE_DETACHED #define ITHREAD_CREATE_JOINABLE PTHREAD_CREATE_JOINABLE /*************************************************************************** * Name: ithread_t * * Description: * Thread handle. * typedef to pthread_t. * Internal Use Only. ***************************************************************************/ typedef pthread_t ithread_t; /**************************************************************************** * Name: ithread_attr_t * * Description: * Thread attribute. * typedef to pthread_attr_t * Internal Use Only ***************************************************************************/ typedef pthread_attr_t ithread_attr_t; /**************************************************************************** * Name: start_routine * * Description: * Thread start routine * Internal Use Only. ***************************************************************************/ typedef void *(*start_routine)(void *arg); /**************************************************************************** * Name: ithread_cond_t * * Description: * condition variable. * typedef to pthread_cond_t * Internal Use Only. ***************************************************************************/ typedef pthread_cond_t ithread_cond_t; /**************************************************************************** * Name: ithread_mutexattr_t * * Description: * Mutex attribute. * typedef to pthread_mutexattr_t * Internal Use Only ***************************************************************************/ typedef pthread_mutexattr_t ithread_mutexattr_t; /**************************************************************************** * Name: ithread_mutex_t * * Description: * Mutex. * typedef to pthread_mutex_t * Internal Use Only. ***************************************************************************/ typedef pthread_mutex_t ithread_mutex_t; /**************************************************************************** * Name: ithread_condattr_t * * Description: * Condition attribute. * typedef to pthread_condattr_t * NOT USED * Internal Use Only ***************************************************************************/ typedef pthread_condattr_t ithread_condattr_t; /**************************************************************************** * Name: ithread_rwlockattr_t * * Description: * Mutex attribute. * typedef to pthread_rwlockattr_t * Internal Use Only ***************************************************************************/ #if UPNP_USE_RWLOCK typedef pthread_rwlockattr_t ithread_rwlockattr_t; #endif /* UPNP_USE_RWLOCK */ /**************************************************************************** * Name: ithread_rwlock_t * * Description: * Condition attribute. * typedef to pthread_rwlock_t * Internal Use Only ***************************************************************************/ #if UPNP_USE_RWLOCK typedef pthread_rwlock_t ithread_rwlock_t; #else /* Read-write locks aren't available: use mutex instead. */ typedef ithread_mutex_t ithread_rwlock_t; #endif /* UPNP_USE_RWLOCK */ /**************************************************************************** * Function: ithread_initialize_library * * Description: * Initializes the library. Does nothing in all implementations, except * when statically linked for WIN32. * Parameters: * none. * Returns: * 0 on success, Nonzero on failure. ***************************************************************************/ static UPNP_INLINE int ithread_initialize_library(void) { int ret = 0; return ret; } /**************************************************************************** * Function: ithread_cleanup_library * * Description: * Clean up library resources. Does nothing in all implementations, except * when statically linked for WIN32. * Parameters: * none. * Returns: * 0 on success, Nonzero on failure. ***************************************************************************/ static UPNP_INLINE int ithread_cleanup_library(void) { int ret = 0; return ret; } /**************************************************************************** * Function: ithread_initialize_thread * * Description: * Initializes the thread. Does nothing in all implementations, except * when statically linked for WIN32. * Parameters: * none. * Returns: * 0 on success, Nonzero on failure. ***************************************************************************/ static UPNP_INLINE int ithread_initialize_thread(void) { int ret = 0; #if defined(WIN32) && defined(PTW32_STATIC_LIB) ret = !pthread_win32_thread_attach_np(); #endif return ret; } /**************************************************************************** * Function: ithread_cleanup_thread * * Description: * Clean up thread resources. Does nothing in all implementations, except * when statically linked for WIN32. * Parameters: * none. * Returns: * 0 on success, Nonzero on failure. ***************************************************************************/ static UPNP_INLINE int ithread_cleanup_thread(void) { int ret = 0; #if defined(WIN32) && defined(PTW32_STATIC_LIB) ret = !pthread_win32_thread_detach_np(); #endif return ret; } /**************************************************************************** * Function: ithread_mutexattr_init * * Description: * Initializes a mutex attribute variable. * Used to set the type of the mutex. * Parameters: * ithread_mutexattr_init * attr (must be valid non NULL pointer to * pthread_mutexattr_t) * Returns: * 0 on success, Nonzero on failure. * Always returns 0. * See man page for pthread_mutexattr_init ***************************************************************************/ #define ithread_mutexattr_init pthread_mutexattr_init /**************************************************************************** * Function: ithread_mutexattr_destroy * * Description: * Releases any resources held by the mutex attribute. * Currently there are no resources associated with the attribute * Parameters: * ithread_mutexattr_t * attr (must be valid non NULL pointer to * pthread_mutexattr_t) * Returns: * 0 on success, Nonzero on failure. * Always returns 0. * See man page for pthread_mutexattr_destroy ***************************************************************************/ #define ithread_mutexattr_destroy pthread_mutexattr_destroy /**************************************************************************** * Function: ithread_mutexattr_setkind_np * * Description: * Sets the mutex type in the attribute. * Valid types are: ITHREAD_MUTEX_FAST_NP * ITHREAD_MUTEX_RECURSIVE_NP * ITHREAD_MUTEX_ERRORCHECK_NP * * Parameters: * ithread_mutexattr_t * attr (must be valid non NULL pointer to * ithread_mutexattr_t) * int kind (one of ITHREAD_MUTEX_FAST_NP or ITHREAD_MUTEX_RECURSIVE_NP * or ITHREAD_MUTEX_ERRORCHECK_NP) * Returns: * 0 on success. Nonzero on failure. * Returns EINVAL if the kind is not supported. * See man page for pthread_mutexattr_setkind_np *****************************************************************************/ #if defined(PTHREAD_MUTEX_RECURSIVE) || defined(__DragonFly__) #define ithread_mutexattr_setkind_np pthread_mutexattr_settype #else #define ithread_mutexattr_setkind_np pthread_mutexattr_setkind_np #endif /* UPNP_USE_RWLOCK */ /**************************************************************************** * Function: ithread_mutexattr_getkind_np * * Description: * Gets the mutex type in the attribute. * Valid types are: ITHREAD_MUTEX_FAST_NP * ITHREAD_MUTEX_RECURSIVE_NP * ITHREAD_MUTEX_ERRORCHECK_NP * * Parameters: * ithread_mutexattr_t * attr (must be valid non NULL pointer to * pthread_mutexattr_t) * int *kind (one of ITHREAD_MUTEX_FAST_NP or ITHREAD_MUTEX_RECURSIVE_NP * or ITHREAD_MUTEX_ERRORCHECK_NP) * Returns: * 0 on success. Nonzero on failure. * Always returns 0. * See man page for pthread_mutexattr_getkind_np *****************************************************************************/ #if defined(PTHREAD_MUTEX_RECURSIVE) || defined(__DragonFly__) #define ithread_mutexattr_getkind_np pthread_mutexattr_gettype #else #define ithread_mutexattr_getkind_np pthread_mutexattr_getkind_np #endif /* UPNP_USE_RWLOCK */ /**************************************************************************** * Function: ithread_mutex_init * * Description: * Initializes mutex. * Must be called before use. * * Parameters: * ithread_mutex_t * mutex (must be valid non NULL pointer to pthread_mutex_t) * const ithread_mutexattr_t * mutex_attr * Returns: * 0 on success, Nonzero on failure. * Always returns 0. * See man page for pthread_mutex_init *****************************************************************************/ #define ithread_mutex_init pthread_mutex_init /**************************************************************************** * Function: ithread_mutex_lock * * Description: * Locks mutex. * Parameters: * ithread_mutex_t * mutex (must be valid non NULL pointer to pthread_mutex_t) * mutex must be initialized. * * Returns: * 0 on success, Nonzero on failure. * Always returns 0. * See man page for pthread_mutex_lock *****************************************************************************/ #define ithread_mutex_lock pthread_mutex_lock /**************************************************************************** * Function: ithread_mutex_unlock * * Description: * Unlocks mutex. * * Parameters: * ithread_mutex_t * mutex (must be valid non NULL pointer to pthread_mutex_t) * mutex must be initialized. * * Returns: * 0 on success, Nonzero on failure. * Always returns 0. * See man page for pthread_mutex_unlock *****************************************************************************/ #define ithread_mutex_unlock pthread_mutex_unlock /**************************************************************************** * Function: ithread_mutex_destroy * * Description: * Releases any resources held by the mutex. * Mutex can no longer be used after this call. * Mutex is only destroyed when there are no longer any threads waiting on it. * Mutex cannot be destroyed if it is locked. * Parameters: * ithread_mutex_t * mutex (must be valid non NULL pointer to pthread_mutex_t) * mutex must be initialized. * Returns: * 0 on success. Nonzero on failure. * Always returns 0. * See man page for pthread_mutex_destroy *****************************************************************************/ #define ithread_mutex_destroy pthread_mutex_destroy /**************************************************************************** * Function: ithread_rwlockattr_init * * Description: * Initializes a rwlock attribute variable to default values. * Parameters: * const ithread_rwlockattr_init *attr (must be valid non NULL pointer to * pthread_rwlockattr_t) * Returns: * 0 on success, Nonzero on failure. * Always returns 0. * See man page for pthread_rwlockattr_init ***************************************************************************/ #if UPNP_USE_RWLOCK #define ithread_rwlockattr_init pthread_rwlockattr_init #endif /* UPNP_USE_RWLOCK */ /**************************************************************************** * Function: ithread_rwlockattr_destroy * * Description: * Releases any resources held by the rwlock attribute. * Parameters: * ithread_rwlockattr_t *attr (must be valid non NULL pointer to * pthread_rwlockattr_t) * Returns: * 0 on success, Nonzero on failure. * Always returns 0. * See man page for pthread_rwlockattr_destroy ***************************************************************************/ #if UPNP_USE_RWLOCK #define ithread_rwlockattr_destroy pthread_rwlockattr_destroy #endif /* UPNP_USE_RWLOCK */ /**************************************************************************** * Function: ithread_rwlockatttr_setpshared * * Description: * Sets the rwlock type in the attribute. * Valid types are: ITHREAD_PROCESS_PRIVATE * ITHREAD_PROCESS_SHARED * * Parameters: * ithread_rwlockattr_t * attr (must be valid non NULL pointer to * ithread_rwlockattr_t) * int kind (one of ITHREAD_PROCESS_PRIVATE or ITHREAD_PROCESS_SHARED) * * Returns: * 0 on success. Nonzero on failure. * Returns EINVAL if the kind is not supported. * See man page for pthread_rwlockattr_setkind_np *****************************************************************************/ #if UPNP_USE_RWLOCK #define ithread_rwlockatttr_setpshared pthread_rwlockatttr_setpshared #endif /* UPNP_USE_RWLOCK */ /**************************************************************************** * Function: ithread_rwlockatttr_getpshared * * Description: * Gets the rwlock type in the attribute. * Valid types are: ITHREAD_PROCESS_PRIVATE * ITHREAD_PROCESS_SHARED * * Parameters: * ithread_rwlockattr_t * attr (must be valid non NULL pointer to * pthread_rwlockattr_t) * int *kind (one of ITHREAD_PROCESS_PRIVATE or ITHREAD_PROCESS_SHARED) * * Returns: * 0 on success. Nonzero on failure. * Always returns 0. * See man page for pthread_rwlockatttr_getpshared *****************************************************************************/ #if UPNP_USE_RWLOCK #define ithread_rwlockatttr_getpshared pthread_rwlockatttr_getpshared #endif /* UPNP_USE_RWLOCK */ /**************************************************************************** * Function: ithread_rwlock_init * * Description: * Initializes rwlock. * Must be called before use. * * Parameters: * ithread_rwlock_t *rwlock (must be valid non NULL pointer to pthread_rwlock_t) * const ithread_rwlockattr_t *rwlock_attr * Returns: * 0 on success, Nonzero on failure. * Always returns 0. * See man page for pthread_rwlock_init *****************************************************************************/ #if UPNP_USE_RWLOCK #define ithread_rwlock_init pthread_rwlock_init #else /* Read-write locks aren't available: use mutex instead. */ #define ithread_rwlock_init ithread_mutex_init #endif /**************************************************************************** * Function: ithread_rwlock_rdlock * * Description: * Locks rwlock for reading. * Parameters: * ithread_rwlock_t *rwlock (must be valid non NULL pointer to pthread_rwlock_t) * rwlock must be initialized. * * Returns: * 0 on success, Nonzero on failure. * Always returns 0. * See man page for pthread_rwlock_rdlock *****************************************************************************/ #if UPNP_USE_RWLOCK #define ithread_rwlock_rdlock pthread_rwlock_rdlock #else /* Read-write locks aren't available: use mutex instead. */ #define ithread_rwlock_rdlock ithread_mutex_lock #endif /* UPNP_USE_RWLOCK */ /**************************************************************************** * Function: ithread_rwlock_wrlock * * Description: * Locks rwlock for writting. * Parameters: * ithread_rwlock_t *rwlock (must be valid non NULL pointer to pthread_rwlock_t) * rwlock must be initialized. * * Returns: * 0 on success, Nonzero on failure. * Always returns 0. * See man page for pthread_rwlock_wrlock *****************************************************************************/ #if UPNP_USE_RWLOCK #define ithread_rwlock_wrlock pthread_rwlock_wrlock #else /* Read-write locks aren't available: use mutex instead. */ #define ithread_rwlock_wrlock ithread_mutex_lock #endif /* UPNP_USE_RWLOCK */ /**************************************************************************** * Function: ithread_rwlock_unlock * * Description: * Unlocks rwlock. * * Parameters: * ithread_rwlock_t *rwlock (must be valid non NULL pointer to pthread_rwlock_t) * rwlock must be initialized. * * Returns: * 0 on success, Nonzero on failure. * Always returns 0. * See man page for pthread_rwlock_unlock *****************************************************************************/ #if UPNP_USE_RWLOCK #define ithread_rwlock_unlock pthread_rwlock_unlock #else /* Read-write locks aren't available: use mutex instead. */ #define ithread_rwlock_unlock ithread_mutex_unlock #endif /* UPNP_USE_RWLOCK */ /**************************************************************************** * Function: ithread_rwlock_destroy * * Description: * Releases any resources held by the rwlock. * rwlock can no longer be used after this call. * rwlock is only destroyed when there are no longer any threads waiting on it. * rwlock cannot be destroyed if it is locked. * Parameters: * ithread_rwlock_t *rwlock (must be valid non NULL pointer to pthread_rwlock_t) * rwlock must be initialized. * Returns: * 0 on success. Nonzero on failure. * Always returns 0. * See man page for pthread_rwlock_destroy *****************************************************************************/ #if UPNP_USE_RWLOCK #define ithread_rwlock_destroy pthread_rwlock_destroy #else /* Read-write locks aren't available: use mutex instead. */ #define ithread_rwlock_destroy ithread_mutex_destroy #endif /* UPNP_USE_RWLOCK */ /**************************************************************************** * Function: ithread_cond_init * * Description: * Initializes condition variable. * Must be called before use. * Parameters: * ithread_cond_t *cond (must be valid non NULL pointer to pthread_cond_t) * const ithread_condattr_t *cond_attr (ignored) * Returns: * 0 on success, Nonzero on failure. * See man page for pthread_cond_init *****************************************************************************/ #define ithread_cond_init pthread_cond_init /**************************************************************************** * Function: ithread_cond_signal * * Description: * Wakes up exactly one thread waiting on condition. * Associated mutex MUST be locked by thread before entering this call. * Parameters: * ithread_cond_t *cond (must be valid non NULL pointer to * ithread_cond_t) * cond must be initialized * Returns: * 0 on success, Nonzero on failure. * See man page for pthread_cond_signal *****************************************************************************/ #define ithread_cond_signal pthread_cond_signal /**************************************************************************** * Function: ithread_cond_broadcast * * Description: * Wakes up all threads waiting on condition. * Associated mutex MUST be locked by thread before entering this call. * Parameters: * ithread_cond_t *cond (must be valid non NULL pointer to * ithread_cond_t) * cond must be initialized * Returns: * 0 on success, Nonzero on failure. * See man page for pthread_cond_broadcast *****************************************************************************/ #define ithread_cond_broadcast pthread_cond_broadcast /**************************************************************************** * Function: ithread_cond_wait * * Description: * Atomically releases mutex and waits on condition. * Associated mutex MUST be locked by thread before entering this call. * Mutex is reacquired when call returns. * Parameters: * ithread_cond_t *cond (must be valid non NULL pointer to * ithread_cond_t) * cond must be initialized * ithread_mutex_t *mutex (must be valid non NULL pointer to * ithread_mutex_t) * Mutex must be locked. * Returns: * 0 on success, Nonzero on failure. * See man page for pthread_cond_wait *****************************************************************************/ #define ithread_cond_wait pthread_cond_wait /**************************************************************************** * Function: pthread_cond_timedwait * * Description: * Atomically releases the associated mutex and waits on the * condition. * If the condition is not signaled in the specified time than the * call times out and returns. * Associated mutex MUST be locked by thread before entering this call. * Mutex is reacquired when call returns. * Parameters: * ithread_cond_t *cond (must be valid non NULL pointer to ithread_cond_t) * cond must be initialized * ithread_mutex_t *mutex (must be valid non NULL pointer to ithread_mutex_t) * Mutex must be locked. * const struct timespec *abstime (absolute time, measured from Jan 1, 1970) * Returns: * 0 on success. ETIMEDOUT on timeout. Nonzero on failure. * See man page for pthread_cond_timedwait ***************************************************************************/ #define ithread_cond_timedwait pthread_cond_timedwait /**************************************************************************** * Function: ithread_cond_destroy * * Description: * Releases any resources held by the condition variable. * Condition variable can no longer be used after this call. * Parameters: * ithread_cond_t *cond (must be valid non NULL pointer to * ithread_cond_t) * cond must be initialized. * Returns: * 0 on success. Nonzero on failure. * See man page for pthread_cond_destroy ***************************************************************************/ #define ithread_cond_destroy pthread_cond_destroy /**************************************************************************** * Function: ithread_attr_init * * Description: * Initialises thread attribute object. * Parameters: * ithread_attr_t *attr (must be valid non NULL pointer to * ithread_attr_t) * Returns: * 0 on success. Nonzero on failure. * See man page for pthread_attr_init ***************************************************************************/ #define ithread_attr_init pthread_attr_init /**************************************************************************** * Function: ithread_attr_destroy * * Description: * Destroys thread attribute object. * Parameters: * ithread_attr_t *attr (must be valid non NULL pointer to * ithread_attr_t) * Returns: * 0 on success. Nonzero on failure. * See man page for pthread_attr_destroy ***************************************************************************/ #define ithread_attr_destroy pthread_attr_destroy /**************************************************************************** * Function: ithread_attr_setstacksize * * Description: * Sets stack size of a thread attribute object. * Parameters: * ithread_attr_t *attr (must be valid non NULL pointer to * ithread_attr_t) * size_t stacksize (value of stacksize must be greater than * ITHREAD_STACK_MIN and lower than system-imposed limits * Returns: * 0 on success. Nonzero on failure. * See man page for pthread_attr_setstacksize ***************************************************************************/ #define ithread_attr_setstacksize pthread_attr_setstacksize /**************************************************************************** * Function: ithread_attr_setdetachstate * * Description: * Sets detach state of a thread attribute object. * Parameters: * ithread_attr_t *attr (must be valid non NULL pointer to * ithread_attr_t) * int detachstate (value of detachstate must be ITHREAD_CREATE_DETACHED * or ITHREAD_CREATE_JOINABLE) * Returns: * 0 on success. Nonzero on failure. * See man page for pthread_attr_setdetachstate ***************************************************************************/ #define ithread_attr_setdetachstate pthread_attr_setdetachstate /**************************************************************************** * Function: ithread_create * * Description: * Creates a thread with the given start routine * and argument. * Parameters: * ithread_t * thread (must be valid non NULL pointer to pthread_t) * ithread_attr_t *attr * void * (start_routine) (void *arg) (start routine) * void * arg - argument. * Returns: * 0 on success. Nonzero on failure. * Returns EAGAIN if a new thread can not be created. * Returns EINVAL if there is a problem with the arguments. * See man page fore pthread_create ***************************************************************************/ #define ithread_create pthread_create /**************************************************************************** * Function: ithread_cancel * * Description: * Cancels a thread. * Parameters: * ithread_t * thread (must be valid non NULL pointer to ithread_t) * Returns: * 0 on success. Nonzero on failure. * See man page for pthread_cancel ***************************************************************************/ #define ithread_cancel pthread_cancel /**************************************************************************** * Function: ithread_exit * * Description: * Returns a return code from a thread. * Implicitly called when the start routine returns. * Parameters: * void * return_code return code to return * See man page for pthread_exit ***************************************************************************/ #define ithread_exit pthread_exit /**************************************************************************** * Function: ithread_get_current_thread_id * * Description: * Returns the handle of the currently running thread. * Returns: * The handle of the currently running thread. * See man page for pthread_self ***************************************************************************/ #define ithread_get_current_thread_id pthread_self /**************************************************************************** * Function: ithread_self * * Description: * Returns the handle of the currently running thread. * Returns: * The handle of the currently running thread. * See man page for pthread_self ***************************************************************************/ #define ithread_self pthread_self /**************************************************************************** * Function: ithread_detach * * Description: * Makes a thread's resources reclaimed immediately * after it finishes * execution. * Returns: * 0 on success, Nonzero on failure. * See man page for pthread_detach ***************************************************************************/ #define ithread_detach pthread_detach /**************************************************************************** * Function: ithread_join * * Description: * Suspends the currently running thread until the * specified thread * has finished. * Returns the return code of the thread, or ITHREAD_CANCELED * if the thread has been canceled. * Parameters: * ithread_t *thread (valid non null thread identifier) * void ** return (space for return code) * Returns: * 0 on success, Nonzero on failure. * See man page for pthread_join ***************************************************************************/ #define ithread_join pthread_join /**************************************************************************** * Function: isleep * * Description: * Suspends the currently running thread for the specified number * of seconds * Always returns 0. * Parameters: * unsigned int seconds - number of seconds to sleep. * Returns: * 0 on success, Nonzero on failure. * See man page for sleep (man 3 sleep) *****************************************************************************/ #ifdef WIN32 #define isleep(x) Sleep((x)*1000) #else #define isleep sleep #endif /**************************************************************************** * Function: isleep * * Description: * Suspends the currently running thread for the specified number * of milliseconds * Always returns 0. * Parameters: * unsigned int milliseconds - number of milliseconds to sleep. * Returns: * 0 on success, Nonzero on failure. * See man page for sleep (man 3 sleep) *****************************************************************************/ #ifdef WIN32 #define imillisleep Sleep #else #define imillisleep(x) usleep(1000*x) #endif #if !defined(PTHREAD_MUTEX_RECURSIVE) && !defined(__DragonFly__) && !defined(UPNP_USE_MSVCPP) /* !defined(UPNP_USE_MSVCPP) should probably also have pthreads version check - but it's not clear if that is possible */ /* NK: Added for satisfying the gcc compiler */ EXPORT_SPEC int pthread_mutexattr_setkind_np(pthread_mutexattr_t *attr, int kind); #endif #ifdef __cplusplus } #endif #endif /* ITHREAD_H */ pupnp-release-1.8.0/threadutil/src/000077500000000000000000000000001303304015100172225ustar00rootroot00000000000000pupnp-release-1.8.0/threadutil/src/FreeList.c000066400000000000000000000061341303304015100211070ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ #include "FreeList.h" #include #include int FreeListInit(FreeList *free_list, size_t elementSize, int maxFreeListLength) { assert(free_list != NULL); if (free_list == NULL) return EINVAL; free_list->element_size = elementSize; free_list->maxFreeListLength = maxFreeListLength; free_list->head = NULL; free_list->freeListLength = 0; return 0; } void *FreeListAlloc(FreeList *free_list) { FreeListNode *ret = NULL; assert(free_list != NULL); if (free_list == NULL) return NULL; if (free_list->head) { ret = free_list->head; free_list->head = free_list->head->next; free_list->freeListLength--; } else { ret = malloc(free_list->element_size); } return ret; } int FreeListFree(FreeList *free_list, void *element) { FreeListNode *temp = NULL; assert(free_list != NULL); if (free_list == NULL) return EINVAL; if (element != NULL && free_list->freeListLength + 1 < free_list->maxFreeListLength) { free_list->freeListLength++; temp = (FreeListNode *)element; temp->next = free_list->head; free_list->head = temp; } else { free(element); } return 0; } int FreeListDestroy(FreeList *free_list) { FreeListNode *temp = NULL; int i = 0; assert(free_list != NULL); if (!free_list) return EINVAL; while (free_list->head) { i++; temp = free_list->head->next; free(free_list->head); free_list->head = temp; } free_list->freeListLength = 0; return 0; } pupnp-release-1.8.0/threadutil/src/LinkedList.c000066400000000000000000000144551303304015100214410ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ #include "LinkedList.h" #ifdef WIN32 /* Do not #include */ #else #include #endif #if (defined(BSD) && BSD >= 199306) || defined(__OSX__) || defined(__APPLE__) #include #else #include #endif #include static int freeListNode(ListNode *node, LinkedList *list) { assert(list != NULL); return FreeListFree(&list->freeNodeList, node); } /*! * \brief Dynamically creates a list node. * * Parameters: * void * item - the item to store * Returns: * The new node, NULL on failure. */ static ListNode *CreateListNode( /*! the item to store. */ void *item, /*! The list to add it to. */ LinkedList *list) { ListNode *temp = NULL; assert(list != NULL); temp = (ListNode *)FreeListAlloc(&list->freeNodeList); if (temp) { temp->prev = NULL; temp->next = NULL; temp->item = item; } return temp; } int ListInit(LinkedList *list, cmp_routine cmp_func, free_function free_func) { int retCode = 0; assert(list != NULL); if (!list) return EINVAL; list->size = 0; list->cmp_func = cmp_func; list->free_func = free_func; retCode = FreeListInit(&list->freeNodeList, sizeof(ListNode), FREELISTSIZE); assert(retCode == 0); list->head.item = NULL; list->head.next = &list->tail; list->head.prev = NULL; list->tail.item = NULL; list->tail.prev = &list->head; list->tail.next = NULL; return retCode; } ListNode *ListAddHead(LinkedList *list, void *item) { assert(list != NULL); if (list == NULL) return NULL; return ListAddAfter(list, item, &list->head); } ListNode *ListAddTail(LinkedList *list, void *item) { assert(list != NULL); if (!list) return NULL; return ListAddBefore(list, item, &list->tail); } ListNode *ListAddAfter(LinkedList *list, void *item, ListNode *bnode) { ListNode *newNode = NULL; assert(list != NULL); if (!list || !bnode) return NULL; newNode = CreateListNode(item, list); if (newNode) { ListNode *temp = bnode->next; bnode->next = newNode; newNode->prev = bnode; newNode->next = temp; temp->prev = newNode; list->size++; return newNode; } return NULL; } ListNode *ListAddBefore(LinkedList *list, void *item, ListNode *anode) { ListNode *newNode = NULL; assert(list != NULL); if (!list || !anode) return NULL; newNode = CreateListNode(item, list); if (newNode) { ListNode *temp = anode->prev; anode->prev = newNode; newNode->next = anode; newNode->prev = temp; temp->next = newNode; list->size++; return newNode; } return NULL; } void *ListDelNode(LinkedList *list, ListNode *dnode, int freeItem) { void *temp; assert(list != NULL); assert(dnode != &list->head); assert(dnode != &list->tail); if (!list || dnode == &list->head || dnode == &list->tail || !dnode) return NULL; temp = dnode->item; dnode->prev->next = dnode->next; dnode->next->prev = dnode->prev; freeListNode(dnode, list); list->size--; if (freeItem && list->free_func) { list->free_func(temp); temp = NULL; } return temp; } int ListDestroy(LinkedList *list, int freeItem) { ListNode *dnode = NULL; ListNode *temp = NULL; if(!list) return EINVAL; for (dnode = list->head.next; dnode != &list->tail; ) { temp = dnode->next; ListDelNode(list, dnode, freeItem); dnode = temp; } list->size = 0; FreeListDestroy(&list->freeNodeList); return 0; } ListNode *ListHead(LinkedList *list) { assert(list != NULL); if (!list) return NULL; if (!list->size) return NULL; else return list->head.next; } ListNode *ListTail(LinkedList *list) { assert(list != NULL); if (!list) return NULL; if (!list->size) return NULL; else return list->tail.prev; } ListNode *ListNext(LinkedList *list, ListNode *node) { assert(list != NULL); assert(node != NULL); if (!list || !node) return NULL; if (node->next == &list->tail) return NULL; else return node->next; } ListNode *ListPrev(LinkedList *list, ListNode *node) { assert(list != NULL); assert(node != NULL); if (!list || !node) return NULL; if (node->prev == &list->head) return NULL; else return node->prev; } ListNode *ListFind(LinkedList *list, ListNode *start, void *item) { ListNode *finger = NULL; if (!list) return NULL; if (!start) start = &list->head; assert(start); finger = start->next; assert(finger); while (finger != &list->tail) { if (list->cmp_func) { if (list->cmp_func(item, finger->item)) return finger; } else { if (item == finger->item) return finger; } finger = finger->next; } return NULL; } long ListSize(LinkedList *list) { assert(list != NULL); if (!list) return EINVAL; return list->size; } pupnp-release-1.8.0/threadutil/src/ThreadPool.c000066400000000000000000000733641303304015100214440ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \file */ #if !defined(WIN32) #include #endif #include "ThreadPool.h" #include "FreeList.h" #include #include #include #include /* for memset()*/ /*! * \brief Returns the difference in milliseconds between two timeval structures. * * \internal * * \return The difference in milliseconds, time1-time2. */ static long DiffMillis( /*! . */ struct timeval *time1, /*! . */ struct timeval *time2) { double temp = 0.0; temp = (double)time1->tv_sec - (double)time2->tv_sec; /* convert to milliseconds */ temp *= 1000.0; /* convert microseconds to milliseconds and add to temp */ /* implicit flooring of unsigned long data type */ temp += ((double)time1->tv_usec - (double)time2->tv_usec) / 1000.0; return (long)temp; } #ifdef STATS /*! * \brief Initializes the statistics structure. * * \internal */ static void StatsInit( /*! Must be valid non null stats structure. */ ThreadPoolStats *stats) { stats->totalIdleTime = 0.0; stats->totalJobsHQ = 0; stats->totalJobsLQ = 0; stats->totalJobsMQ = 0; stats->totalTimeHQ = 0.0; stats->totalTimeMQ = 0.0; stats->totalTimeLQ = 0.0; stats->totalWorkTime = 0.0; stats->totalIdleTime = 0.0; stats->avgWaitHQ = 0.0; stats->avgWaitMQ = 0.0; stats->avgWaitLQ = 0.0; stats->workerThreads = 0; stats->idleThreads = 0; stats->persistentThreads = 0; stats->maxThreads = 0; stats->totalThreads = 0; } /*! * \brief * * \internal */ static void StatsAccountLQ( /*! . */ ThreadPool *tp, /*! . */ long diffTime) { tp->stats.totalJobsLQ++; tp->stats.totalTimeLQ += (double)diffTime; } /*! * \brief * * \internal */ static void StatsAccountMQ( /*! . */ ThreadPool *tp, /*! . */ long diffTime) { tp->stats.totalJobsMQ++; tp->stats.totalTimeMQ += (double)diffTime; } /*! * \brief * * \internal */ static void StatsAccountHQ( /*! . */ ThreadPool *tp, /*! . */ long diffTime) { tp->stats.totalJobsHQ++; tp->stats.totalTimeHQ += (double)diffTime; } /*! * \brief Calculates the time the job has been waiting at the specified * priority. * * Adds to the totalTime and totalJobs kept in the thread pool statistics * structure. * * \internal */ static void CalcWaitTime( /*! . */ ThreadPool *tp, /*! . */ ThreadPriority p, /*! . */ ThreadPoolJob *job) { struct timeval now; long diff; assert(tp != NULL); assert(job != NULL); gettimeofday(&now, NULL); diff = DiffMillis(&now, &job->requestTime); switch (p) { case LOW_PRIORITY: StatsAccountLQ(tp, diff); break; case MED_PRIORITY: StatsAccountMQ(tp, diff); break; case HIGH_PRIORITY: StatsAccountHQ(tp, diff); break; default: assert(0); } } /*! * \brief * * \internal */ static time_t StatsTime( /*! . */ time_t *t) { struct timeval tv; gettimeofday(&tv, NULL); if (t) *t = tv.tv_sec; return tv.tv_sec; } #else /* STATS */ static UPNP_INLINE void StatsInit(ThreadPoolStats *stats) {} static UPNP_INLINE void StatsAccountLQ(ThreadPool *tp, long diffTime) {} static UPNP_INLINE void StatsAccountMQ(ThreadPool *tp, long diffTime) {} static UPNP_INLINE void StatsAccountHQ(ThreadPool *tp, long diffTime) {} static UPNP_INLINE void CalcWaitTime(ThreadPool *tp, ThreadPriority p, ThreadPoolJob *job) {} static UPNP_INLINE time_t StatsTime(time_t *t) { return 0; } #endif /* STATS */ /*! * \brief Compares thread pool jobs. * * \internal */ static int CmpThreadPoolJob( void *jobA, void *jobB) { ThreadPoolJob *a = (ThreadPoolJob *)jobA; ThreadPoolJob *b = (ThreadPoolJob *)jobB; return a->jobId == b->jobId; } /*! * \brief Deallocates a dynamically allocated ThreadPoolJob. * * \internal */ static void FreeThreadPoolJob( /*! . */ ThreadPool *tp, /*! Must be allocated with CreateThreadPoolJob. */ ThreadPoolJob *tpj) { FreeListFree(&tp->jobFreeList, tpj); } /*! * \brief Sets the scheduling policy of the current process. * * \internal * * \return * \li \c 0 on success. * \li \c result of GetLastError() on failure. * */ static int SetPolicyType( /*! . */ PolicyType in) { int retVal = 0; #ifdef __CYGWIN__ /* TODO not currently working... */ retVal = 0; #elif defined(__OSX__) || defined(__APPLE__) || defined(__NetBSD__) setpriority(PRIO_PROCESS, 0, 0); retVal = 0; #elif defined(WIN32) retVal = sched_setscheduler(0, in); #elif defined(_POSIX_PRIORITY_SCHEDULING) && _POSIX_PRIORITY_SCHEDULING > 0 struct sched_param current; int sched_result; memset(¤t, 0, sizeof(current)); sched_getparam(0, ¤t); current.sched_priority = sched_get_priority_min(DEFAULT_POLICY); sched_result = sched_setscheduler(0, in, ¤t); retVal = (sched_result != -1 || errno == EPERM) ? 0 : errno; #else retVal = 0; #endif return retVal; } /*! * \brief Sets the priority of the currently running thread. * * \internal * * \return * \li \c 0 on success. * \li \c EINVAL invalid priority or the result of GerLastError. */ static int SetPriority( /*! . */ ThreadPriority priority) { #if defined(_POSIX_PRIORITY_SCHEDULING) && _POSIX_PRIORITY_SCHEDULING > 0 int retVal = 0; int currentPolicy; int minPriority = 0; int maxPriority = 0; int actPriority = 0; int midPriority = 0; struct sched_param newPriority; int sched_result; pthread_getschedparam(ithread_self(), ¤tPolicy, &newPriority); minPriority = sched_get_priority_min(currentPolicy); maxPriority = sched_get_priority_max(currentPolicy); midPriority = (maxPriority - minPriority) / 2; switch (priority) { case LOW_PRIORITY: actPriority = minPriority; break; case MED_PRIORITY: actPriority = midPriority; break; case HIGH_PRIORITY: actPriority = maxPriority; break; default: retVal = EINVAL; goto exit_function; }; newPriority.sched_priority = actPriority; sched_result = pthread_setschedparam(ithread_self(), currentPolicy, &newPriority); retVal = (sched_result == 0 || errno == EPERM) ? 0 : sched_result; exit_function: return retVal; #else return 0; priority = priority; #endif } /*! * \brief Determines whether any jobs need to be bumped to a higher priority Q * and bumps them. * * tp->mutex must be locked. * * \internal * * \return */ static void BumpPriority( /*! . */ ThreadPool *tp) { int done = 0; struct timeval now; long diffTime = 0; ThreadPoolJob *tempJob = NULL; gettimeofday(&now, NULL); while (!done) { if (tp->medJobQ.size) { tempJob = (ThreadPoolJob *)tp->medJobQ.head.next->item; diffTime = DiffMillis(&now, &tempJob->requestTime); if (diffTime >= tp->attr.starvationTime) { /* If job has waited longer than the starvation time * bump priority (add to higher priority Q) */ StatsAccountMQ(tp, diffTime); ListDelNode(&tp->medJobQ, tp->medJobQ.head.next, 0); ListAddTail(&tp->highJobQ, tempJob); continue; } } if (tp->lowJobQ.size) { tempJob = (ThreadPoolJob *)tp->lowJobQ.head.next->item; diffTime = DiffMillis(&now, &tempJob->requestTime); if (diffTime >= tp->attr.maxIdleTime) { /* If job has waited longer than the starvation time * bump priority (add to higher priority Q) */ StatsAccountLQ(tp, diffTime); ListDelNode(&tp->lowJobQ, tp->lowJobQ.head.next, 0); ListAddTail(&tp->medJobQ, tempJob); continue; } } done = 1; } } /*! * \brief Sets the fields of the passed in timespec to be relMillis * milliseconds in the future. * * \internal */ static void SetRelTimeout( /*! . */ struct timespec *time, /*! milliseconds in the future. */ int relMillis) { struct timeval now; int sec = relMillis / 1000; int milliSeconds = relMillis % 1000; gettimeofday(&now, NULL); time->tv_sec = now.tv_sec + sec; time->tv_nsec = (now.tv_usec / 1000 + milliSeconds) * 1000000; } /*! * \brief Sets seed for random number generator. Each thread sets the seed * random number generator. * * \internal */ static void SetSeed(void) { struct timeval t; gettimeofday(&t, NULL); #if defined(WIN32) srand((unsigned int)t.tv_usec + (unsigned int)ithread_get_current_thread_id().p); #elif defined(BSD) || defined(__OSX__) || defined(__APPLE__) || defined(__FreeBSD_kernel__) srand((unsigned int)t.tv_usec + (unsigned int)ithread_get_current_thread_id()); #elif defined(__linux__) || defined(__sun) || defined(__CYGWIN__) || defined(__GLIBC__) srand((unsigned int)t.tv_usec + (unsigned int)ithread_get_current_thread_id()); #else { volatile union { volatile pthread_t tid; volatile unsigned i; } idu; idu.tid = ithread_get_current_thread_id(); srand((unsigned int)t.millitm + idu.i); } #endif } /*! * \brief Implements a thread pool worker. Worker waits for a job to become * available. Worker picks up persistent jobs first, high priority, * med priority, then low priority. * * If worker remains idle for more than specified max, the worker is released. * * \internal */ static void *WorkerThread( /*! arg -> is cast to (ThreadPool *). */ void *arg) { time_t start = 0; ThreadPoolJob *job = NULL; ListNode *head = NULL; struct timespec timeout; int retCode = 0; int persistent = -1; ThreadPool *tp = (ThreadPool *) arg; ithread_initialize_thread(); /* Increment total thread count */ ithread_mutex_lock(&tp->mutex); tp->totalThreads++; tp->pendingWorkerThreadStart = 0; ithread_cond_broadcast(&tp->start_and_shutdown); ithread_mutex_unlock(&tp->mutex); SetSeed(); StatsTime(&start); while (1) { ithread_mutex_lock(&tp->mutex); if (job) { tp->busyThreads--; FreeThreadPoolJob(tp, job); job = NULL; } retCode = 0; tp->stats.idleThreads++; tp->stats.totalWorkTime += (double)StatsTime(NULL) - (double)start; StatsTime(&start); if (persistent == 0) { tp->stats.workerThreads--; } else if (persistent == 1) { /* Persistent thread becomes a regular thread */ tp->persistentThreads--; } /* Check for a job or shutdown */ while (tp->lowJobQ.size == 0 && tp->medJobQ.size == 0 && tp->highJobQ.size == 0 && !tp->persistentJob && !tp->shutdown) { /* If wait timed out and we currently have more than the * min threads, or if we have more than the max threads * (only possible if the attributes have been reset) * let this thread die. */ if ((retCode == ETIMEDOUT && tp->totalThreads > tp->attr.minThreads) || (tp->attr.maxThreads != -1 && tp->totalThreads > tp->attr.maxThreads)) { tp->stats.idleThreads--; goto exit_function; } SetRelTimeout(&timeout, tp->attr.maxIdleTime); /* wait for a job up to the specified max time */ retCode = ithread_cond_timedwait( &tp->condition, &tp->mutex, &timeout); } tp->stats.idleThreads--; /* idle time */ tp->stats.totalIdleTime += (double)StatsTime(NULL) - (double)start; /* work time */ StatsTime(&start); /* bump priority of starved jobs */ BumpPriority(tp); /* if shutdown then stop */ if (tp->shutdown) { goto exit_function; } else { /* Pick up persistent job if available */ if (tp->persistentJob) { job = tp->persistentJob; tp->persistentJob = NULL; tp->persistentThreads++; persistent = 1; ithread_cond_broadcast(&tp->start_and_shutdown); } else { tp->stats.workerThreads++; persistent = 0; /* Pick the highest priority job */ if (tp->highJobQ.size > 0) { head = ListHead(&tp->highJobQ); if (head == NULL) { tp->stats.workerThreads--; goto exit_function; } job = (ThreadPoolJob *) head->item; CalcWaitTime(tp, HIGH_PRIORITY, job); ListDelNode(&tp->highJobQ, head, 0); } else if (tp->medJobQ.size > 0) { head = ListHead(&tp->medJobQ); if (head == NULL) { tp->stats.workerThreads--; goto exit_function; } job = (ThreadPoolJob *) head->item; CalcWaitTime(tp, MED_PRIORITY, job); ListDelNode(&tp->medJobQ, head, 0); } else if (tp->lowJobQ.size > 0) { head = ListHead(&tp->lowJobQ); if (head == NULL) { tp->stats.workerThreads--; goto exit_function; } job = (ThreadPoolJob *) head->item; CalcWaitTime(tp, LOW_PRIORITY, job); ListDelNode(&tp->lowJobQ, head, 0); } else { /* Should never get here */ tp->stats.workerThreads--; goto exit_function; } } } tp->busyThreads++; ithread_mutex_unlock(&tp->mutex); /* In the future can log info */ if (SetPriority(job->priority) != 0) { } else { } /* run the job */ job->func(job->arg); /* return to Normal */ SetPriority(DEFAULT_PRIORITY); } exit_function: tp->totalThreads--; ithread_cond_broadcast(&tp->start_and_shutdown); ithread_mutex_unlock(&tp->mutex); ithread_cleanup_thread(); return NULL; } /*! * \brief Creates a Thread Pool Job. (Dynamically allocated) * * \internal * * \return ThreadPoolJob *on success, NULL on failure. */ static ThreadPoolJob *CreateThreadPoolJob( /*! job is copied. */ ThreadPoolJob *job, /*! id of job. */ int id, /*! . */ ThreadPool *tp) { ThreadPoolJob *newJob = NULL; newJob = (ThreadPoolJob *)FreeListAlloc(&tp->jobFreeList); if (newJob) { *newJob = *job; newJob->jobId = id; gettimeofday(&newJob->requestTime, NULL); } return newJob; } /*! * \brief Creates a worker thread, if the thread pool does not already have * max threads. * * \remark The ThreadPool object mutex must be locked prior to calling this * function. * * \internal * * \return * \li \c 0 on success, < 0 on failure. * \li \c EMAXTHREADS if already max threads reached. * \li \c EAGAIN if system can not create thread. */ static int CreateWorker( /*! A pointer to the ThreadPool object. */ ThreadPool *tp) { ithread_t temp; int rc = 0; ithread_attr_t attr; /* if a new worker is the process of starting, wait until it fully starts */ while (tp->pendingWorkerThreadStart) { ithread_cond_wait(&tp->start_and_shutdown, &tp->mutex); } if (tp->attr.maxThreads != INFINITE_THREADS && tp->totalThreads + 1 > tp->attr.maxThreads) { return EMAXTHREADS; } ithread_attr_init(&attr); ithread_attr_setstacksize(&attr, tp->attr.stackSize); ithread_attr_setdetachstate(&attr, ITHREAD_CREATE_DETACHED); rc = ithread_create(&temp, &attr, WorkerThread, tp); ithread_attr_destroy(&attr); if (rc == 0) { rc = ithread_detach(temp); /* ithread_detach will return EINVAL if thread has been successfully detached by ithread_create */ if (rc == EINVAL) rc = 0; tp->pendingWorkerThreadStart = 1; /* wait until the new worker thread starts */ while (tp->pendingWorkerThreadStart) { ithread_cond_wait(&tp->start_and_shutdown, &tp->mutex); } } if (tp->stats.maxThreads < tp->totalThreads) { tp->stats.maxThreads = tp->totalThreads; } return rc; } /*! * \brief Determines whether or not a thread should be added based on the * jobsPerThread ratio. Adds a thread if appropriate. * * \remark The ThreadPool object mutex must be locked prior to calling this * function. * * \internal */ static void AddWorker( /*! A pointer to the ThreadPool object. */ ThreadPool *tp) { long jobs = 0; int threads = 0; jobs = tp->highJobQ.size + tp->lowJobQ.size + tp->medJobQ.size; threads = tp->totalThreads - tp->persistentThreads; while (threads == 0 || (jobs / threads) >= tp->attr.jobsPerThread || (tp->totalThreads == tp->busyThreads) ) { if (CreateWorker(tp) != 0) { return; } threads++; } } int ThreadPoolInit(ThreadPool *tp, ThreadPoolAttr *attr) { int retCode = 0; int i = 0; if (!tp) { return EINVAL; } retCode += ithread_mutex_init(&tp->mutex, NULL); retCode += ithread_mutex_lock(&tp->mutex); retCode += ithread_cond_init(&tp->condition, NULL); retCode += ithread_cond_init(&tp->start_and_shutdown, NULL); if (retCode) { ithread_mutex_unlock(&tp->mutex); ithread_mutex_destroy(&tp->mutex); ithread_cond_destroy(&tp->condition); ithread_cond_destroy(&tp->start_and_shutdown); return EAGAIN; } if (attr) { tp->attr = *attr; } else { TPAttrInit(&tp->attr); } if (SetPolicyType(tp->attr.schedPolicy) != 0) { ithread_mutex_unlock(&tp->mutex); ithread_mutex_destroy(&tp->mutex); ithread_cond_destroy(&tp->condition); ithread_cond_destroy(&tp->start_and_shutdown); return INVALID_POLICY; } retCode += FreeListInit( &tp->jobFreeList, sizeof(ThreadPoolJob), JOBFREELISTSIZE); StatsInit(&tp->stats); retCode += ListInit(&tp->highJobQ, CmpThreadPoolJob, NULL); retCode += ListInit(&tp->medJobQ, CmpThreadPoolJob, NULL); retCode += ListInit(&tp->lowJobQ, CmpThreadPoolJob, NULL); if (retCode) { retCode = EAGAIN; } else { tp->persistentJob = NULL; tp->lastJobId = 0; tp->shutdown = 0; tp->totalThreads = 0; tp->busyThreads = 0; tp->persistentThreads = 0; tp->pendingWorkerThreadStart = 0; for (i = 0; i < tp->attr.minThreads; ++i) { retCode = CreateWorker(tp); if (retCode) { break; } } } ithread_mutex_unlock(&tp->mutex); if (retCode) { /* clean up if the min threads could not be created */ ThreadPoolShutdown(tp); } return retCode; } int ThreadPoolAddPersistent(ThreadPool *tp, ThreadPoolJob *job, int *jobId) { int ret = 0; int tempId = -1; ThreadPoolJob *temp = NULL; if (!tp || !job) { return EINVAL; } if (!jobId) { jobId = &tempId; } *jobId = INVALID_JOB_ID; ithread_mutex_lock(&tp->mutex); /* Create A worker if less than max threads running */ if (tp->totalThreads < tp->attr.maxThreads) { CreateWorker(tp); } else { /* if there is more than one worker thread * available then schedule job, otherwise fail */ if (tp->totalThreads - tp->persistentThreads - 1 == 0) { ret = EMAXTHREADS; goto exit_function; } } temp = CreateThreadPoolJob(job, tp->lastJobId, tp); if (!temp) { ret = EOUTOFMEM; goto exit_function; } tp->persistentJob = temp; /* Notify a waiting thread */ ithread_cond_signal(&tp->condition); /* wait until long job has been picked up */ while (tp->persistentJob) ithread_cond_wait(&tp->start_and_shutdown, &tp->mutex); *jobId = tp->lastJobId++; exit_function: ithread_mutex_unlock(&tp->mutex); return ret; } int ThreadPoolAdd(ThreadPool *tp, ThreadPoolJob *job, int *jobId) { int rc = EOUTOFMEM; int tempId = -1; long totalJobs; ThreadPoolJob *temp = NULL; if (!tp || !job) return EINVAL; ithread_mutex_lock(&tp->mutex); totalJobs = tp->highJobQ.size + tp->lowJobQ.size + tp->medJobQ.size; if (totalJobs >= tp->attr.maxJobsTotal) { fprintf(stderr, "total jobs = %ld, too many jobs", totalJobs); goto exit_function; } if (!jobId) jobId = &tempId; *jobId = INVALID_JOB_ID; temp = CreateThreadPoolJob(job, tp->lastJobId, tp); if (!temp) goto exit_function; switch (job->priority) { case HIGH_PRIORITY: if (ListAddTail(&tp->highJobQ, temp)) rc = 0; break; case MED_PRIORITY: if (ListAddTail(&tp->medJobQ, temp)) rc = 0; break; default: if (ListAddTail(&tp->lowJobQ, temp)) rc = 0; } /* AddWorker if appropriate */ AddWorker(tp); /* Notify a waiting thread */ if (rc == 0) ithread_cond_signal(&tp->condition); else FreeThreadPoolJob(tp, temp); *jobId = tp->lastJobId++; exit_function: ithread_mutex_unlock(&tp->mutex); return rc; } int ThreadPoolRemove(ThreadPool *tp, int jobId, ThreadPoolJob *out) { int ret = INVALID_JOB_ID; ThreadPoolJob *temp = NULL; ListNode *tempNode = NULL; ThreadPoolJob dummy; if (!tp) return EINVAL; if (!out) out = &dummy; dummy.jobId = jobId; ithread_mutex_lock(&tp->mutex); tempNode = ListFind(&tp->highJobQ, NULL, &dummy); if (tempNode) { temp = (ThreadPoolJob *)tempNode->item; *out = *temp; ListDelNode(&tp->highJobQ, tempNode, 0); FreeThreadPoolJob(tp, temp); ret = 0; goto exit_function; } tempNode = ListFind(&tp->medJobQ, NULL, &dummy); if (tempNode) { temp = (ThreadPoolJob *)tempNode->item; *out = *temp; ListDelNode(&tp->medJobQ, tempNode, 0); FreeThreadPoolJob(tp, temp); ret = 0; goto exit_function; } tempNode = ListFind(&tp->lowJobQ, NULL, &dummy); if (tempNode) { temp = (ThreadPoolJob *)tempNode->item; *out = *temp; ListDelNode(&tp->lowJobQ, tempNode, 0); FreeThreadPoolJob(tp, temp); ret = 0; goto exit_function; } if (tp->persistentJob && tp->persistentJob->jobId == jobId) { *out = *tp->persistentJob; FreeThreadPoolJob(tp, tp->persistentJob); tp->persistentJob = NULL; ret = 0; goto exit_function; } exit_function: ithread_mutex_unlock(&tp->mutex); return ret; } int ThreadPoolGetAttr(ThreadPool *tp, ThreadPoolAttr *out) { if (!tp || !out) return EINVAL; if (!tp->shutdown) ithread_mutex_lock(&tp->mutex); *out = tp->attr; if (!tp->shutdown) ithread_mutex_unlock(&tp->mutex); return 0; } int ThreadPoolSetAttr(ThreadPool *tp, ThreadPoolAttr *attr) { int retCode = 0; ThreadPoolAttr temp; int i = 0; if (!tp) return EINVAL; ithread_mutex_lock(&tp->mutex); if (attr) temp = *attr; else TPAttrInit(&temp); if (SetPolicyType(temp.schedPolicy) != 0) { ithread_mutex_unlock(&tp->mutex); return INVALID_POLICY; } tp->attr = temp; /* add threads */ if (tp->totalThreads < tp->attr.minThreads) { for (i = tp->totalThreads; i < tp->attr.minThreads; i++) { retCode = CreateWorker(tp); if (retCode != 0) { break; } } } /* signal changes */ ithread_cond_signal(&tp->condition); ithread_mutex_unlock(&tp->mutex); if (retCode != 0) /* clean up if the min threads could not be created */ ThreadPoolShutdown(tp); return retCode; } int ThreadPoolShutdown(ThreadPool *tp) { ListNode *head = NULL; ThreadPoolJob *temp = NULL; if (!tp) return EINVAL; ithread_mutex_lock(&tp->mutex); /* clean up high priority jobs */ while (tp->highJobQ.size) { head = ListHead(&tp->highJobQ); if (head == NULL) { ithread_mutex_unlock(&tp->mutex); return EINVAL; } temp = (ThreadPoolJob *)head->item; if (temp->free_func) temp->free_func(temp->arg); FreeThreadPoolJob(tp, temp); ListDelNode(&tp->highJobQ, head, 0); } ListDestroy(&tp->highJobQ, 0); /* clean up med priority jobs */ while (tp->medJobQ.size) { head = ListHead(&tp->medJobQ); if (head == NULL) { ithread_mutex_unlock(&tp->mutex); return EINVAL; } temp = (ThreadPoolJob *)head->item; if (temp->free_func) temp->free_func(temp->arg); FreeThreadPoolJob(tp, temp); ListDelNode(&tp->medJobQ, head, 0); } ListDestroy(&tp->medJobQ, 0); /* clean up low priority jobs */ while (tp->lowJobQ.size) { head = ListHead(&tp->lowJobQ); if (head == NULL) { ithread_mutex_unlock(&tp->mutex); return EINVAL; } temp = (ThreadPoolJob *)head->item; if (temp->free_func) temp->free_func(temp->arg); FreeThreadPoolJob(tp, temp); ListDelNode(&tp->lowJobQ, head, 0); } ListDestroy(&tp->lowJobQ, 0); /* clean up long term job */ if (tp->persistentJob) { temp = tp->persistentJob; if (temp->free_func) temp->free_func(temp->arg); FreeThreadPoolJob(tp, temp); tp->persistentJob = NULL; } /* signal shutdown */ tp->shutdown = 1; ithread_cond_broadcast(&tp->condition); /* wait for all threads to finish */ while (tp->totalThreads > 0) ithread_cond_wait(&tp->start_and_shutdown, &tp->mutex); /* destroy condition */ while (ithread_cond_destroy(&tp->condition) != 0) {} while (ithread_cond_destroy(&tp->start_and_shutdown) != 0) {} FreeListDestroy(&tp->jobFreeList); ithread_mutex_unlock(&tp->mutex); /* destroy mutex */ while (ithread_mutex_destroy(&tp->mutex) != 0) {} return 0; } int TPAttrInit(ThreadPoolAttr *attr) { if (!attr) return EINVAL; attr->jobsPerThread = DEFAULT_JOBS_PER_THREAD; attr->maxIdleTime = DEFAULT_IDLE_TIME; attr->maxThreads = DEFAULT_MAX_THREADS; attr->minThreads = DEFAULT_MIN_THREADS; attr->stackSize = DEFAULT_STACK_SIZE; attr->schedPolicy = DEFAULT_POLICY; attr->starvationTime = DEFAULT_STARVATION_TIME; attr->maxJobsTotal = DEFAULT_MAX_JOBS_TOTAL; return 0; } int TPJobInit(ThreadPoolJob *job, start_routine func, void *arg) { if (!job || !func) return EINVAL; job->func = func; job->arg = arg; job->priority = DEFAULT_PRIORITY; job->free_func = DEFAULT_FREE_ROUTINE; return 0; } int TPJobSetPriority(ThreadPoolJob *job, ThreadPriority priority) { if (!job) return EINVAL; switch (priority) { case LOW_PRIORITY: case MED_PRIORITY: case HIGH_PRIORITY: job->priority = priority; return 0; default: return EINVAL; } } int TPJobSetFreeFunction(ThreadPoolJob *job, free_routine func) { if(!job) return EINVAL; job->free_func = func; return 0; } int TPAttrSetMaxThreads(ThreadPoolAttr *attr, int maxThreads) { if (!attr) return EINVAL; attr->maxThreads = maxThreads; return 0; } int TPAttrSetMinThreads(ThreadPoolAttr *attr, int minThreads) { if (!attr) return EINVAL; attr->minThreads = minThreads; return 0; } int TPAttrSetStackSize(ThreadPoolAttr *attr, size_t stackSize) { if (!attr) return EINVAL; attr->stackSize = stackSize; return 0; } int TPAttrSetIdleTime(ThreadPoolAttr *attr, int idleTime) { if (!attr) return EINVAL; attr->maxIdleTime = idleTime; return 0; } int TPAttrSetJobsPerThread(ThreadPoolAttr *attr, int jobsPerThread) { if (!attr) return EINVAL; attr->jobsPerThread = jobsPerThread; return 0; } int TPAttrSetStarvationTime(ThreadPoolAttr *attr, int starvationTime) { if (!attr) return EINVAL; attr->starvationTime = starvationTime; return 0; } int TPAttrSetSchedPolicy(ThreadPoolAttr *attr, PolicyType schedPolicy) { if (!attr) return EINVAL; attr->schedPolicy = schedPolicy; return 0; } int TPAttrSetMaxJobsTotal(ThreadPoolAttr *attr, int maxJobsTotal) { if (!attr) return EINVAL; attr->maxJobsTotal = maxJobsTotal; return 0; } #ifdef STATS void ThreadPoolPrintStats(ThreadPoolStats *stats) { if (!stats) return; /* some OSses time_t length may depending on platform, promote it to long for safety */ printf("ThreadPoolStats at Time: %ld\n", (long)StatsTime(NULL)); printf("High Jobs pending: %d\n", stats->currentJobsHQ); printf("Med Jobs Pending: %d\n", stats->currentJobsMQ); printf("Low Jobs Pending: %d\n", stats->currentJobsLQ); printf("Average Wait in High Priority Q in milliseconds: %f\n", stats->avgWaitHQ); printf("Average Wait in Med Priority Q in milliseconds: %f\n", stats->avgWaitMQ); printf("Averate Wait in Low Priority Q in milliseconds: %f\n", stats->avgWaitLQ); printf("Max Threads Active: %d\n", stats->maxThreads); printf("Current Worker Threads: %d\n", stats->workerThreads); printf("Current Persistent Threads: %d\n", stats->persistentThreads); printf("Current Idle Threads: %d\n", stats->idleThreads); printf("Total Threads : %d\n", stats->totalThreads); printf("Total Time spent Working in seconds: %f\n", stats->totalWorkTime); printf("Total Time spent Idle in seconds : %f\n", stats->totalIdleTime); } int ThreadPoolGetStats(ThreadPool *tp, ThreadPoolStats *stats) { if (tp == NULL || stats == NULL) return EINVAL; /* if not shutdown then acquire mutex */ if (!tp->shutdown) ithread_mutex_lock(&tp->mutex); *stats = tp->stats; if (stats->totalJobsHQ > 0) stats->avgWaitHQ = stats->totalTimeHQ / (double)stats->totalJobsHQ; else stats->avgWaitHQ = 0.0; if (stats->totalJobsMQ > 0) stats->avgWaitMQ = stats->totalTimeMQ / (double)stats->totalJobsMQ; else stats->avgWaitMQ = 0.0; if (stats->totalJobsLQ > 0) stats->avgWaitLQ = stats->totalTimeLQ / (double)stats->totalJobsLQ; else stats->avgWaitLQ = 0.0; stats->totalThreads = tp->totalThreads; stats->persistentThreads = tp->persistentThreads; stats->currentJobsHQ = (int)ListSize(&tp->highJobQ); stats->currentJobsLQ = (int)ListSize(&tp->lowJobQ); stats->currentJobsMQ = (int)ListSize(&tp->medJobQ); /* if not shutdown then release mutex */ if (!tp->shutdown) ithread_mutex_unlock(&tp->mutex); return 0; } #endif /* STATS */ #ifdef WIN32 #if defined(_MSC_VER) || defined(_MSC_EXTENSIONS) #define DELTA_EPOCH_IN_MICROSECS 11644473600000000Ui64 #else #define DELTA_EPOCH_IN_MICROSECS 11644473600000000ULL #endif int gettimeofday(struct timeval *tv, struct timezone *tz) { FILETIME ft; unsigned __int64 tmpres = 0; static int tzflag; if (tv) { GetSystemTimeAsFileTime(&ft); tmpres |= ft.dwHighDateTime; tmpres <<= 32; tmpres |= ft.dwLowDateTime; /*converting file time to unix epoch*/ tmpres /= 10; /*convert into microseconds*/ tmpres -= DELTA_EPOCH_IN_MICROSECS; tv->tv_sec = (long)(tmpres / 1000000UL); tv->tv_usec = (long)(tmpres % 1000000UL); } if (tz) { if (!tzflag) { _tzset(); tzflag++; } tz->tz_minuteswest = _timezone / 60; tz->tz_dsttime = _daylight; } return 0; } #endif /* WIN32 */ pupnp-release-1.8.0/threadutil/src/TimerThread.c000066400000000000000000000247311303304015100216050ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \file */ #include "TimerThread.h" #include /*! * \brief Deallocates a dynamically allocated TimerEvent. */ static void FreeTimerEvent( /*! [in] Valid timer thread pointer. */ TimerThread *timer, /*! [in] Must be allocated with CreateTimerEvent*/ TimerEvent *event) { assert(timer != NULL); FreeListFree(&timer->freeEvents, event); } /*! * \brief Implements timer thread. * * Waits for next event to occur and schedules associated job into threadpool. */ static void *TimerThreadWorker( /*! [in] arg is cast to (TimerThread *). */ void *arg) { TimerThread *timer = ( TimerThread * ) arg; ListNode *head = NULL; TimerEvent *nextEvent = NULL; time_t currentTime = 0; time_t nextEventTime = 0; struct timespec timeToWait; int tempId; assert( timer != NULL ); ithread_mutex_lock( &timer->mutex ); while (1) { /* mutex should always be locked at top of loop */ /* Check for shutdown. */ if (timer->shutdown) { timer->shutdown = 0; ithread_cond_signal( &timer->condition ); ithread_mutex_unlock( &timer->mutex ); return NULL; } nextEvent = NULL; /* Get the next event if possible. */ if (timer->eventQ.size > 0) { head = ListHead( &timer->eventQ ); if (head == NULL) { ithread_mutex_unlock( &timer->mutex ); return NULL; } nextEvent = ( TimerEvent * ) head->item; nextEventTime = nextEvent->eventTime; } currentTime = time(NULL); /* If time has elapsed, schedule job. */ if (nextEvent && currentTime >= nextEventTime) { if( nextEvent->persistent ) { if (ThreadPoolAddPersistent( timer->tp, &nextEvent->job, &tempId ) != 0) { if (nextEvent->job.arg != NULL && nextEvent->job.free_func != NULL) { nextEvent->job.free_func(nextEvent->job.arg); } } } else { if (ThreadPoolAdd( timer->tp, &nextEvent->job, &tempId ) != 0) { if (nextEvent->job.arg != NULL && nextEvent->job.free_func != NULL) { nextEvent->job.free_func(nextEvent->job.arg); } } } ListDelNode( &timer->eventQ, head, 0 ); FreeTimerEvent( timer, nextEvent ); continue; } if (nextEvent) { timeToWait.tv_nsec = 0; timeToWait.tv_sec = (long)nextEvent->eventTime; ithread_cond_timedwait( &timer->condition, &timer->mutex, &timeToWait ); } else { ithread_cond_wait( &timer->condition, &timer->mutex ); } } } /*! * \brief Calculates the appropriate timeout in absolute seconds * since Jan 1, 1970. * * \return */ static int CalculateEventTime( /*! [in] Timeout. */ time_t *timeout, /*! [in] Timeout type. */ TimeoutType type) { time_t now; assert( timeout != NULL ); switch (type) { case ABS_SEC: return 0; default: /* REL_SEC) */ time(&now); ( *timeout ) += now; return 0; } return -1; } /*! * \brief Creates a Timer Event. (Dynamically allocated). * * \return (TimerEvent *) on success, NULL on failure. */ static TimerEvent *CreateTimerEvent( /*! [in] Valid timer thread pointer. */ TimerThread *timer, /*! [in] . */ ThreadPoolJob *job, /*! [in] . */ Duration persistent, /*! [in] The absoule time of the event in seconds from Jan, 1970. */ time_t eventTime, /*! [in] Id of job. */ int id) { TimerEvent *temp = NULL; assert( timer != NULL ); assert( job != NULL ); temp = ( TimerEvent * ) FreeListAlloc( &timer->freeEvents ); if( temp == NULL ) return temp; temp->job = ( *job ); temp->persistent = persistent; temp->eventTime = eventTime; temp->id = id; return temp; } int TimerThreadInit(TimerThread *timer, ThreadPool *tp) { int rc = 0; ThreadPoolJob timerThreadWorker; assert( timer != NULL ); assert( tp != NULL ); if( ( timer == NULL ) || ( tp == NULL ) ) { return EINVAL; } rc += ithread_mutex_init( &timer->mutex, NULL ); assert( rc == 0 ); rc += ithread_mutex_lock( &timer->mutex ); assert( rc == 0 ); rc += ithread_cond_init( &timer->condition, NULL ); assert( rc == 0 ); rc += FreeListInit( &timer->freeEvents, sizeof( TimerEvent ), 100 ); assert( rc == 0 ); timer->shutdown = 0; timer->tp = tp; timer->lastEventId = 0; rc += ListInit( &timer->eventQ, NULL, NULL ); assert( rc == 0 ); if( rc != 0 ) { rc = EAGAIN; } else { TPJobInit( &timerThreadWorker, TimerThreadWorker, timer ); TPJobSetPriority( &timerThreadWorker, HIGH_PRIORITY ); rc = ThreadPoolAddPersistent( tp, &timerThreadWorker, NULL ); } ithread_mutex_unlock( &timer->mutex ); if( rc != 0 ) { ithread_cond_destroy( &timer->condition ); ithread_mutex_destroy( &timer->mutex ); FreeListDestroy( &timer->freeEvents ); ListDestroy( &timer->eventQ, 0 ); } return rc; } int TimerThreadSchedule( TimerThread *timer, time_t timeout, TimeoutType type, ThreadPoolJob *job, Duration duration, int *id) { int rc = EOUTOFMEM; int found = 0; int tempId = 0; ListNode *tempNode = NULL; TimerEvent *temp = NULL; TimerEvent *newEvent = NULL; assert( timer != NULL ); assert( job != NULL ); if( ( timer == NULL ) || ( job == NULL ) ) { return EINVAL; } CalculateEventTime( &timeout, type ); ithread_mutex_lock( &timer->mutex ); if( id == NULL ) id = &tempId; ( *id ) = INVALID_EVENT_ID; newEvent = CreateTimerEvent( timer, job, duration, timeout, timer->lastEventId ); if( newEvent == NULL ) { ithread_mutex_unlock( &timer->mutex ); return rc; } tempNode = ListHead( &timer->eventQ ); /* add job to Q. Q is ordered by eventTime with the head of the Q being * the next event. */ while( tempNode != NULL ) { temp = ( TimerEvent * ) tempNode->item; if( temp->eventTime >= timeout ) { if (ListAddBefore( &timer->eventQ, newEvent, tempNode)) rc = 0; found = 1; break; } tempNode = ListNext( &timer->eventQ, tempNode ); } /* add to the end of Q. */ if (!found) { if( ListAddTail( &timer->eventQ, newEvent ) != NULL ) rc = 0; } /* signal change in Q. */ if( rc == 0 ) { ithread_cond_signal( &timer->condition ); } else { FreeTimerEvent( timer, newEvent ); } ( *id ) = timer->lastEventId++; ithread_mutex_unlock( &timer->mutex ); return rc; } int TimerThreadRemove( TimerThread *timer, int id, ThreadPoolJob *out) { int rc = INVALID_EVENT_ID; ListNode *tempNode = NULL; TimerEvent *temp = NULL; assert( timer != NULL ); if( timer == NULL ) { return EINVAL; } ithread_mutex_lock( &timer->mutex ); tempNode = ListHead( &timer->eventQ ); while( tempNode != NULL ) { temp = ( TimerEvent * ) tempNode->item; if( temp->id == id ) { ListDelNode( &timer->eventQ, tempNode, 0 ); if( out != NULL ) ( *out ) = temp->job; FreeTimerEvent( timer, temp ); rc = 0; break; } tempNode = ListNext( &timer->eventQ, tempNode ); } ithread_mutex_unlock( &timer->mutex ); return rc; } int TimerThreadShutdown(TimerThread *timer) { ListNode *tempNode2 = NULL; ListNode *tempNode = NULL; assert( timer != NULL ); if( timer == NULL ) { return EINVAL; } ithread_mutex_lock( &timer->mutex ); timer->shutdown = 1; tempNode = ListHead( &timer->eventQ ); /* Delete nodes in Q. Call registered free function on argument. */ while( tempNode != NULL ) { TimerEvent *temp = ( TimerEvent * ) tempNode->item; tempNode2 = ListNext( &timer->eventQ, tempNode ); ListDelNode( &timer->eventQ, tempNode, 0 ); if( temp->job.free_func ) { temp->job.free_func( temp->job.arg ); } FreeTimerEvent( timer, temp ); tempNode = tempNode2; } ListDestroy( &timer->eventQ, 0 ); FreeListDestroy( &timer->freeEvents ); ithread_cond_broadcast( &timer->condition ); while (timer->shutdown) { /* wait for timer thread to shutdown. */ ithread_cond_wait( &timer->condition, &timer->mutex ); } ithread_mutex_unlock(&timer->mutex); /* destroy condition. */ while(ithread_cond_destroy(&timer->condition) != 0) { } /* destroy mutex. */ while (ithread_mutex_destroy(&timer->mutex) != 0) { } return 0; } pupnp-release-1.8.0/upnp/000077500000000000000000000000001303304015100152505ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/LICENSE000066400000000000000000000027331303304015100162620ustar00rootroot00000000000000Copyright (c) 2000-2003 Intel Corporation All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither name of Intel Corporation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. pupnp-release-1.8.0/upnp/Makefile.am000066400000000000000000000100661303304015100173070ustar00rootroot00000000000000# # "Makefile.am" for "libupnp/upnp" # # Copyright (C) 2005 Rémi Turboult # SUBDIRS = doc . sample unittest AM_CPPFLAGS = \ -I$(srcdir)/inc \ -I$(top_srcdir)/threadutil/inc \ -I$(top_srcdir)/ixml/inc LDADD = \ libupnp-1.8.la \ $(top_builddir)/threadutil/libthreadutil-1.8.la \ $(top_builddir)/ixml/libixml-1.8.la upnpincludedir = $(includedir)/upnp-1.8 upnpinclude_HEADERS = \ inc/ActionComplete.h \ inc/ActionRequest.h \ inc/Callback.h \ inc/Discovery.h \ inc/Event.h \ inc/EventSubscribe.h \ inc/FileInfo.h \ inc/list.h \ inc/poison.h \ inc/StateVarComplete.h \ inc/StateVarRequest.h \ inc/SubscriptionRequest.h \ inc/TemplateInclude.h \ inc/TemplateSource.h \ inc/TemplateUndef.h \ inc/UpnpString.h \ inc/upnp.h \ inc/upnpdebug.h \ inc/UpnpGlobal.h \ inc/UpnpInet.h \ inc/UpnpIntTypes.h \ inc/UpnpStdInt.h \ inc/UpnpUniStd.h nodist_upnpinclude_HEADERS = inc/upnpconfig.h if ENABLE_TOOLS upnpinclude_HEADERS += inc/upnptools.h endif lib_LTLIBRARIES = libupnp-1.8.la libupnp_1_8_la_CPPFLAGS = $(AM_CPPFLAGS) -I$(srcdir)/src/inc libupnp_1_8_la_LDFLAGS = \ -version-info $(LT_VERSION_UPNP) \ -export-symbols-regex '^Upnp.*' \ $(top_builddir)/threadutil/libthreadutil-1.8.la \ $(top_builddir)/ixml/libixml-1.8.la libupnp_1_8_la_SOURCES = \ src/inc/config.h \ src/inc/client_table.h \ src/inc/ClientSubscription.h \ src/inc/gena.h \ src/inc/gena_ctrlpt.h \ src/inc/gena_device.h \ src/inc/global.h \ src/inc/gmtdate.h \ src/inc/httpparser.h \ src/inc/httpreadwrite.h \ src/inc/md5.h \ src/inc/membuffer.h \ src/inc/miniserver.h \ src/inc/netall.h \ src/inc/parsetools.h \ src/inc/server.h \ src/inc/service_table.h \ src/inc/soaplib.h \ src/inc/sock.h \ src/inc/statcodes.h \ src/inc/statuscodes.h \ src/inc/strintmap.h \ src/inc/ssdplib.h \ src/inc/sysdep.h \ src/inc/unixutil.h \ src/inc/upnpapi.h \ src/inc/upnp_timeout.h \ src/inc/uri.h \ src/inc/urlconfig.h \ src/inc/upnputil.h \ src/inc/uuid.h \ src/inc/VirtualDir.h \ src/inc/webserver.h # ssdp if ENABLE_SSDP libupnp_1_8_la_SOURCES += \ src/ssdp/ssdp_ResultData.c \ src/ssdp/ssdp_ResultData.h \ src/ssdp/ssdp_device.c \ src/ssdp/ssdp_ctrlpt.c \ src/ssdp/ssdp_server.c endif # soap if ENABLE_SOAP libupnp_1_8_la_SOURCES += \ src/soap/soap_device.c \ src/soap/soap_ctrlpt.c \ src/soap/soap_common.c endif # genlib libupnp_1_8_la_SOURCES += \ src/genlib/miniserver/miniserver.c \ src/genlib/client_table/client_table.c \ src/genlib/client_table/ClientSubscription.c \ src/genlib/service_table/service_table.c \ src/genlib/util/membuffer.c \ src/genlib/util/strintmap.c \ src/genlib/util/upnp_timeout.c \ src/genlib/util/util.c \ src/genlib/net/sock.c \ src/genlib/net/http/httpparser.c \ src/genlib/net/http/httpreadwrite.c \ src/genlib/net/http/statcodes.c \ src/genlib/net/http/webserver.c \ src/genlib/net/http/parsetools.c \ src/genlib/net/uri/uri.c # gena if ENABLE_GENA libupnp_1_8_la_SOURCES += \ src/gena/gena_device.c \ src/gena/gena_ctrlpt.c \ src/gena/gena_callback2.c endif # api libupnp_1_8_la_SOURCES += \ src/api/ActionComplete.c \ src/api/ActionRequest.c \ src/api/Discovery.c \ src/api/Event.c \ src/api/EventSubscribe.c \ src/api/FileInfo.c \ src/api/StateVarComplete.c \ src/api/StateVarRequest.c \ src/api/SubscriptionRequest.c \ src/api/UpnpString.c \ src/api/upnpapi.c if ENABLE_TOOLS libupnp_1_8_la_SOURCES += src/api/upnptools.c endif if ENABLE_DEBUG libupnp_1_8_la_SOURCES += src/api/upnpdebug.c endif # uuid if ENABLE_UUID libupnp_1_8_la_SOURCES += \ src/uuid/md5.c \ src/uuid/sysdep.c \ src/uuid/uuid.c endif # urlconfig libupnp_1_8_la_SOURCES += src/urlconfig/urlconfig.c # inet_pton (needed on Win32, compiles to nothing elsewhere) libupnp_1_8_la_SOURCES += \ src/inet_pton.c \ src/inc/inet_pton.h # check / distcheck tests check_PROGRAMS = test_init-1.8 test_url-1.8 TESTS = test_init-1.8 test_url-1.8 test_init_1_8_SOURCES = test/test_init.c test_url_1_8_SOURCES = test/test_url.c EXTRA_DIST = \ LICENSE \ m4/libupnp.m4 \ src/win_dll.c CLEANFILES = \ IUpnpErrFile.txt \ IUpnpInfoFile.txt pupnp-release-1.8.0/upnp/doc/000077500000000000000000000000001303304015100160155ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/doc/Makefile.am000066400000000000000000000045631303304015100200610ustar00rootroot00000000000000# $Id: Makefile.am,v 1.2 2006/03/28 21:07:01 r3mi Exp $ # # "Makefile.am" for "libunp/upnp/doc" # # (C) Copyright 2005 Rmi Turboult # ########################################################################## # # Copyright (c) 2000-2003 Intel Corporation # All rights reserved. # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # * Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # * Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # * Neither name of Intel Corporation nor the names of its contributors # may be used to endorse or promote products derived from this software # without specific prior written permission. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS # ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR # CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, # EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, # PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR # PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY # OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. # ########################################################################## EXTRA_DIST = callback.dxx docxx.sty intro.dxx \ license.dxx upnpsdk.dxx html-local: @if [ -d html ]; then rm -rf html; fi @doc++ -nd -S -w -j -d html $(srcdir)/upnpsdk.dxx pdf-local: @doc++ -nd -S -w -j -t --package a4wide -o upnpsdk.tex \ $(srcdir)/upnpsdk.dxx @-pdflatex "\scrollmode\input upnpsdk.tex" > latex.log @-pdflatex "\scrollmode\input upnpsdk.tex" >> latex.log @-pdflatex "\scrollmode\input upnpsdk.tex" >> latex.log clean-local: -rm -rf html -rm -f upnpsdk.tex upnpsdk.dvi upnpsdk.ps upnpsdk.log upnpsdk.aux -rm -f latex.log pupnp-release-1.8.0/upnp/doc/UPnP_Programming_Guide.pdf000066400000000000000000013312441303304015100230210ustar00rootroot00000000000000%PDF-1.4 3 0 obj << /Length 110 /Filter /FlateDecode >> stream xs w3T02307TIS4P03275QI46(561v04 55u 5 @^cH-LN1!ez flk&endstream endobj 2 0 obj << /Type /Page /Contents 3 0 R /Resources 1 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 7 0 R >> endobj 1 0 obj << /Font << /F19 6 0 R >> /ProcSet [ /PDF /Text ] >> endobj 10 0 obj << /Length 4145 /Filter /FlateDecode >> stream x]]s#}ׯ#Y a|M+qmZJ(')_?ȒUe-wTǧ3`H.0Xaytcfu[NG~qƉÉ5VV?On&܌?c2\Ϗ'l>7gwgͥOW7OOɏof6F2 GWvÏtt}@GP"|z />9i F\c _Ø"r72Lʙ?~2e㻉`M B#NsNM#*㝰ɔSÏַwalL5_6o)x'm!4-1N@wO/ݾ_#ip҈4?f#Fe4raI ƇXgsOؗep-ڍI¨ x0dzGh}& ny9wj<ޫ×$8е$.6=H 1l3íi*  9qD4uc3b#>uU< N]tvިd*-3MinflN+ljʁN]~*z"{' ÓT 1J=Pc}.Of iG_@TCnC ҇QYSˌ>UAuH G5QYQ)г $wDHDIZTF[(E.AJі(#yM$.3J VT)%/*%wz:}Q;"1!cDR%~U$fՔH2#`UH5|DDR|TI$1J$n λ%v'CHJ1uId`')DJ50BB/櫎t7v.W˶)qJg b7ԦR2`U`w5|"S|jHc21vG'5 H/!=A%U%.3 VTש'/'7H=ՐFdF@/'!hdcX@tVА! O:h(X4T _, UC55=h~??RvZRPvz#pQRtX)jg.?hWJ=|Q)y|A)=|o$Be.\̚~eMp6H/*ښc[ˌ^UA/uzzI Y! =KhYz@'܎VOlmNAB1PiJ]f BJ_J|1?(U" .kpmLej:.gE.p(II+B  !JRBm: ǛZ\%QCK$%iJ]f$ T_T/wTCY1H~ZÜs#n_dRd C65Rd$%;z!WOUJ\f _o1[n8mEclr 2^)_ndY{y[Bt *[q PM2`UB5|R|oq֮EƸQAI+^ exB  -*C7 ],bߤ|%˿kh+ONj4'+5GR~NYQ)DHoKxoN+B  #JJV>T/bF)vФ4X^7L\f Sl_Tl_wne̊B3wv=B(#뻓N J_Dm7/yМ<Yut0qQs*NY|Q)]Zr!  S;f*uy%qjc8(A+p1Wu82qQ*ȨNFY|QF)b5[.Ovmc&a$.gnf{ҽо'lb̨€Bb%&mUCɎ֗wX\?6uƓ>^?>dl^36n)C3 lƓcNv4j 2i ir[ oF+Oȯe+O4jZ'-~]?ZQD1|c{+|yo+?O0ekyn|OTxTDwnj!Rjyn@*7pUP4jղiqQ@+/ 6+T yk.S#vx;v399瓮zb-NUMVǷvrbQz(%޽-"++ btwD{|6s+dD o<{Kً7OW7gزIN2 4-%~ۧiS=,C%^<.5X,mf@4K_ZO_#./rd* ~mC 'mD;cJ<6` zM*4mvhӆKtݦ-qiڂ r}ݸQsaRH+-faGK7 sW, B I34X _$ 7eE>6Oo^tcD`!f/wH oo/^hOx u|[Ը̯; HQ 0hZn7y갲)LtCX*;)MoMFY&l&Z ȵV"\(9~}\Lˆ޸M2p}IN͛ G GG?}5t|yҽM> endobj 8 0 obj << /Font << /F20 13 0 R /F19 6 0 R /F23 16 0 R /F8 19 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 28 0 obj << /Length 2072 /Filter /FlateDecode >> stream xZYs~#Pg>6c])I(sI+?>3!m`UJ f ӈ1*É5VE:&5 iཉ609a4˖>L1“fـEXhd!NH-? ~.4z7D8xgPœѧ!)Ƴ0iZ I8qɐ3)v >ψTo|Pj}kEqX'y3CuxE(\0K0 J[ӄ1"^P*Gc}2؁Rs-}̓ͧd2g*9(4mW8GMt}Aùq~xa^ or|`y 8ɻEK:2 y$+-e^LQ;bULd0\;e%d iX x/Ⴜd TF816 497ԨK0$&sDnZGw S?G+ubh(W[8n%ĕNn~Ɵzu!ܰ +`4 =ƾFs,KSsD ^>35MF'#GޝVKP 6,v\㖜p,n z笎τκ =%Z֧H1rB>K-<㌳ R#jdsgpm3hR0Sicw0;paQ;(M{ <SH4KA, zM)KUiV_4(*ͪ1AY:s֊q24⮃=9ߍc|ZtIU +ͮM4N>Gؒ2OUr[Q@+4%RSD۩P `TOJ=0 (ԡJm?Shuj$ĿrUkLb/0ꌁ؁kN)k➤ߨ ,fzh+ 2#(h2=+_n Zm!6RN W~V1U.vZaqӪClÁ TG%BKbCsYӶ &T=\KChMK6]Gl[fju_)gl>;jp+-PnapkEiNlR9/=J/ x3W>ߡq/[a~`~:;2E.:l &ETM2J?Kpy+ļ^]Y˾_s#O؆cjAaׄv~ =y@gxo.ViX1ǹ}[Jl/=vB0) o|k'5r5ϐe<"C<@oehsQ<,|{(=F,c,HSQ""^\Nu\aT0'NmW_\ė9ŏ.tч!PkLUh0'AZ}}fa1~2US{TĶ / cLƃ|{/;p$?pJ1) |Vf84SLҰ˟ziiJ"wN`U# [jݏV bR$◝i%3EڴlJ(oסG*|ֹnڴºWsVބMRSMx e|z~7eóxx7H(~%*>[l*!n/ҫs.C?4H@/. b2f/rJ!JX4Hendstream endobj 27 0 obj << /Type /Page /Contents 28 0 R /Resources 26 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 7 0 R >> endobj 26 0 obj << /Font << /F20 13 0 R /F8 19 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 31 0 obj << /Length 569 /Filter /FlateDecode >> stream xڥRMs0W(OjՇmqktK> endobj 29 0 obj << /Font << /F20 13 0 R /F23 16 0 R /F8 19 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 34 0 obj << /Length 1142 /Filter /FlateDecode >> stream xڥVIoFW̑J$'7n; P ́(EeoRJE ۗm! l))UAE yYQHr7v`red8h L݀ZzZⵒ^+NkxD4E%g-J܇ȤǔN1,2s r``늓@!$5q \bZ}̚h ,8hJ(ٯ*-zcP1w?ݶpyD䪊]^h!f|`;b~l>_q&VISϫv/{vQux˓ OMrxǫwLZ*ݣA )=慱+K{(O6l{WJ[.heG\|_MUz'k) OHɒm!禂.oL5:K^secw[ԗm/, aDBBw YR(Ȣ˞/zL99\!8Lܷ0qH_6`,=FO%<0҅TLf>at#,x(EwSa1z `a05:{El̤_^Vxo |!&S4EP.y1%؟c@BGG B6Flf7iendstream endobj 33 0 obj << /Type /Page /Contents 34 0 R /Resources 32 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 7 0 R >> endobj 32 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F14 40 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 43 0 obj << /Length 2067 /Filter /FlateDecode >> stream xڭXK+TY RZdŀȅ¾SI4U+4q2Wק[w;qx<9ڍ=+ ]'VñgTًjWm}FY|$\صB:kwwև827xq/uJw/z[ǵZ9& #t< |s@XMi=cXv*hV %;~lJߢtK_(aqoXJ;ې(rT*}ȱ偕1b|GaBW9A=8oxcX[1_XW׋~\ _A)ic@'4OO硊 D_}}BqwcշPvKXcZ7ñ ٶO,DUNk{KxPzB' R{ 6 ^UT[ {MlKfV'ffWv>ΜǺ9GU-XP7l '\egd1?\ϧmѰOȷiYXmtYn3X=hRhmţJQp o+S05k!3K/ @޿ C)z..vOS~E1@͹bwnDsHu#L]}F}A",OVQBǴq+ y\O6#i$h/+yzFGB= RKd~G Ț́GV{hJ*u \Krnna@CLO `+^-7Q[c ȏQ% K&0-b0&ToϾt+59Qz[%$S BmTۃD̓=h< A޾[FˋT_ٲ$~ =Sm<:2 XBu[ I֍ȏ[B~)̒4eqٚ%Y2ڮGrfLJcy2b~|;8HE6 Y8&|ǘԛXMtjPEZ<XvŠwa~kN@ 0!t[H{ZT>R|8bg)rpJ-9,J=a]'(R .X,!Z,sTel&L/R.B޻B>H~ yR&~a{F09ϘMEEc&<ǮwI@tl7w"-6Eʲٚ$S[3q{~J_Yi/f*` U 3ֿj͋LxI[v͖ͅsQS"> X$rLؼ]Wl$ayn2ڕ¦qOM$8f>ЗLh'0wr~a2h^B#m"4"cy+1k1|B]k;BsS 5&9nX5A7`1I=?M(t3:Aq n"oD|dX@Ld+;[ȱ{ nΌ7Cy+vrcĎ1_4;g oc2\<"Oӥ3p -bЦMl%]g P'ȅkYlkƳ; vTu'oOᙅt%,s׷ =wtwXo` Y:b歠DaK;rQM0GtJendstream endobj 42 0 obj << /Type /Page /Contents 43 0 R /Resources 41 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 7 0 R >> endobj 41 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 46 0 obj << /Length 1198 /Filter /FlateDecode >> stream xڥVKs6WVrRx{kv=er%XU)۝::h}~Ǜů>kDS:fJ{ad26_rShoR|x(Tj{mׅv=SjJe~*kd*'cl}XUf̮VRW#|HFg&}W׫?g;2+skk)U6vv.mt%LUGUCCZal\_EL-4u,j!onViHYp:}r5!7BcKbjl ,cWMK*%E%-gxVG2E%-RCkݜYm+VͮL @O-_?\~}`bz ;{!^d1*]A1"F k'X cD$N@{AEi߯C+n1㚤{80FÎ$۰Ca7&6I`/UE3BPύ>Ldp%EY91$=uYZW3lmO\Y.MJ-5 ro1U 1{7v&ىPɇs ByPǜ%zgVi&NcEaTQ|=ØPb>ѷ#n`ؑMBv@Y/oA#)6v? L"A>Bݴ#"dcQHڍT5dr|3FnVwӆ-wcb!fD.2==-x'a@@^¨c_fQʊ Epr2"pŗ! 0{&QCuM98m{#Ї=7p?0 J]+#>oi!>f<?ͼTFjy/)twL >OgPD|w=0Z6YՈ2z^XF5\p[yenjQ[xFYj@k'u0tŕ:Y `>XeMU 45ǧRM ۡpb \`zOGPPM?Z4y%*ˏ+:~+jLW]wendstream endobj 45 0 obj << /Type /Page /Contents 46 0 R /Resources 44 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 47 0 R >> endobj 44 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 50 0 obj << /Length 2516 /Filter /FlateDecode >> stream x]s۶+xIM+o;V#)t2pm'LbLί? @\ ӉR'3E-W/},@b),bf )1+pB[Q..·#y9>/^ &Cai& U~9xgZP­W@ Xˊi07ň3"6΍;$ % h-y!XgGI¥NxJ0X$<* ."Zj uќ5g5hW20&A-ϒUAHSF E׵U9Bm Hjy(FQc֜$6s+ӡ(vFR@BN['m j@mrT-ԙLXYy69`+1 4G](iEInW'WClÑV_NW_4P6N\a7L({1;vQVj*hd7ɚ*szuBɧ'KqM r掞]-֡Tؑc#?Х#TbIT؃`(^ΗߞzGE>"݈|H7*]11|765u~y)ЏB]\WCLr8 fl 'Syʸ&fSZUQ| k2EBOf) Tf*dҧ́vvYe.{`TGq-y\ib0G'#. ^=63 ̱x{MrHYs-\]&NN>ϔj;5.G͹ܐ&`}>7ܒ>aAW N{тA$: Yc%adf;L@$rě1ɦ/`0= lRטLbofmDL"8R %P0עg~d#Eb%IJ2E7KM_ %-/{)٤IIk Zn@UrvݶƤ@ kd]2 k$>H9wb)&YliyXq`Χ{$ emKMGRfvwZFVi0klv8 jheo!@CZ^!"FX]RGKwc=e^O2\ۂf{!sn4.S8x4ekTn骵h/ǁOp6m:@8^o l|즵ЍUK}e>}8ь8Θr<=[4ҚhǼOj[[ߧ!:xnc;s1,L6}M,/ S }2В^==}"aG!\hK'In$#\@Νe o"EZ^"7>nsK2=n]͜rwCJ 7T)hM~YajZX߅y? 4D8g琶/nb:U\"ܛ#<iy!cy[wQvC[Ôɧ6x c`2ڜ͆ʣj4^u 1ތIbmI7n?rn.Sx4 [e b dT8ܤֺ]cjΦ֎Ti.*N$О3n8ʳ^eL`dH ` F6Fv6렜d{٩r7 gQsC$g\nw6Ս! ʸqsOFy4.-ȷ"R7'Rԟ9-O?׷+Ų:VPZH^~G/3VƝ,/O?U= Ҹ?ϞiyzsGmD/A2!VH*nT1"m} 8^9GWch?G¹~kvnendstream endobj 49 0 obj << /Type /Page /Contents 50 0 R /Resources 48 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 47 0 R >> endobj 48 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 53 0 obj << /Length 3056 /Filter /FlateDecode >> stream x\r8}W葪!_qx-oV6MǪ-,' hQg\*U6[ޫv\&W-Ա1X m+91i&p$O&?N؀?6pt`!NH=tpG?Q"U'B sn$?8^?LjZ0px^Yg"FW:?<̹N2Ha(wЂƅ Y@Ɉ 6xRg(k;{w0d/@ʪZ 6N,o}}4~lzG$9!HsS1H F` W&&`8.&˾4fiR _J~x)Mrx/NbhSMi=xÃI,#ΩH'f8qW)e1:RZ @'Yo S` -x'Hk(-PP [f ae*d Tu 7^e*|h4S%3#sٗѬ?3K/eFl\;fߺ,Y("Dh:+v#qJ7sGhObq%&G"oVզ ʯ1ъɆJ#1fEN9"q^>rF~r×/3R]m[FP iS\]!7J:J ɠ옽n , Kh֟ 釗$w?>8sxn-eM]{VwpSM$%w3}lY \e/D 볃0 T8OjaM `g\ x(xuO&oXZveӪ"gv5 v^+Ee,HeY/ /R||v"v1XP P`&[ Tσx{2iUAy'_QIjMk\qUk”%j4j1|WsxwZnjH m($LbD+/ &~s.gnP*iasѬ%~K9dTGoYL=nꀜ6}UTT#L/.ˡL ۵]vQ , vrѬ%K=:Yr aDZe ZaBYSF'EmAL@T#@byJnĐCʾ1h/2;NKvKT1At%s}3Rfj1L퇙25yzf=Ud#׍ʣӷ:!+Ђ1ZJ)qTunJA}-wٓɬ7C^6h/Ra  rks+Kr8X!q[v=H9}O1WSOځ8[e_F-/eo?90#UF I0 [c{~Nq jza"vo.5pI+yKƪ?cJK Ӌ-Kh<9<-ug2ÙJv7=XsSٯtqƹV-GwxPPE+.gp4{fw ؟./ic`hNu 81/ >U8O[] <8}Q?m..;9T`gO0!0!x?n0lu٘,,]G{#A{o<`V6ëm AD*?]OHV(aBTSlQW5R?Pzu0xh6ካ#8GS4|F&p4m΄Yt$1HL R-uy5ӭ?Ob e8c,*#Z|Z ٰ- \5}W(,wa.*FձP7 E2|lXpkG?7Dv q]lf"8|~0J|oU*,ur M[݄Pgx =4Yb~ECL}`|U8(8 ćwU+2 !Q"$L#""YEvH`-{HHDBO$pn & a - eF۠rEӆӾ);>lԌ_3ifQ5Zn6i)5[EM2,&jr=p)/-iwi>6̟=פ^U9 _pp60nӇ5$L)qQH>P|2_A}s:}X> endobj 51 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F17 37 0 R /F19 6 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 59 0 obj << /Length 2305 /Filter /FlateDecode >> stream xZ[o~ׯ#VsyEֱ8(rJMJ)5_ߙi)H`3oC~Of\Bs=3n9%C&'S&BfOd*.'_GlLᏍ :UN !x9#:~=DF%(x9\ѻo1O'*qYp #+ PS4͹"BiLcWBq4 2IAAPQ;jr*$uwtBq"g]PL9cHI>WBs*۴Aocc%WPzOciN̅h:B%1 R*o#~ :,9Q5Jmw/¿[;Wٳ)a+ Pi܇zU(3g{HMgc @$̴+us`փ 絣|ich0R=8T3MI7`Cpj[.a8mU?$ɮvO0P܏;.My{?)\bjW50ڡ>{nٮ^ܑ{;Lae`(zd2UJdo*rRƸfj;ҟޱ*ggO~0a2 0PѦ\=V[w!QfBN2np09!R4eDrQiNuu!;ŗ*BiMbO] 9ŋE4N]!ϩnu1¨.uBxf#u aRƈ}`9P23Ww¾IqyP ɋh8H#- c8|Qb q3Op C> @RZA|a+Hf@m2 RC!nxv/q㖩ĉgHkT"}s ^daːfz)g~774+,]XjEgUrR ;2nAX83t/w]' v->{G0Գ~*hq敏dp'aj ybI MAdbF ( S/| GNt^* / x8<Z8p^CB ``zl -7W-%~G [Av̾IрY.ThPIDDChh! ዢ` -Ep hDC T'ECքi[ݱV|z|rC5.ܛY vؙ}Bl|R08zMkt_{+N@׵v H' [[d~kGA&`\d7-dVk"X8ބy1Ŕ#rF6#!zkɬpp{F #VZA!`"$ Bw*/@UB>!I h<,^.8VO< YEw I׭!n5w@ Sx,b|c?X Ci|kM_|OsG`)nvKo.<]mur"ln*޼jlpq( j}w_pg>*iOQBy'~ ¨jbh(^Dx8BMC#nBa$>P[_}`X=P-v=}Iu}D&DJ`F> endobj 57 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F27 56 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 62 0 obj << /Length 2489 /Filter /FlateDecode >> stream x͚Ks8:R5!'IM83L,[k%:|ˤ$N rE/h~oƖ؂ۇ1jXkJOLj+| !oSccKZib,Ƴ迣O~Dǿ(֨W8Yǫ",G7$?t N؍7\BƂ4+"TἽ2=6^+8 1-dKAAe@,QVEp ItauK_pkhsa)QF61c*]+ƚ R]f_]/]BtΓǼN̅h@;(wW$\7Uvp_2|q žyܸ} ͆͂7'/;(YfCLM"9SO['$N?~TQB1G?J[)/d<4]nNa>~Z _B?iM#5OKG*3M⊼lci9~JBL ݉CJ">JQ"j)F%&%Gf䢖LM^iT#d,į #3lg; k߼/xvfoٟ[ ۫Mp!ZhcEK Y6v51 ã|[^l1oWm#K&9@R +.L G¢-B63 b {aj< q>,&V{swݖO|[TmԺ<#ΌMak/>ݗjS_SMo<JTj)f%Y%>08(=c*eBcBpJ7#o9+QYcPmqG%n̑h>զ.|Ww<{p!}v<2m@.{jo)xZ ݦHk.$X.rͽߗi.^|`\\OB)u3j7voS!@vhzdt G =}!E@~@$@tvp @)RMMiS%b"x6cn1~Ls B[֋p0hz<-1=#Bm '3mȌ1-oT?0iΥ4*w/ .((Zy7ǹ/t *}*qY,.jV_wK) ` %66{c BdF?ZLTȵNA%c>/eA |ŤPWWىItPV6\w y=]{,*lҐv)dN%+w!5%B-P(g։(Qx'|(JbqFx8Di<(-݈2„(} #^Mo~l9b?e /ZK2,7= -8})%0LH*\$u߲>/ ZSuB( 67"nC\.P!,O b@)x_yIXHD0B=Tn^w /e!p|}Ym)39B>)샋ʮ]쯖R'*%Riis.6,|3fnb?$9U ol o~ 1> endobj 60 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F27 56 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 65 0 obj << /Length 2847 /Filter /FlateDecode >> stream x͛[o۸)(ckw-ݺݴ=mŞE$B}ɱgY-+E(K9s4D/fҡ%Vs=]O $Ml)1dvB`2!lh(Cz8_ 7:|3DT f-x\ SڡñD6e r5@RXP75McJ;k/p S/4r`uXVr%#0hp&jKP45-*u09mMIߜp[԰ø1bnp̕PCC"n~Axa6aEYzfΣ@TqP&?h'<n rq0$Lk#b;qTȚQ.0e v 5|tzHtvͺ2 O7K*-d{kϻ5T\xܝXM zc"cns2kz)Nň;(җmlY" Ʀ*oPp)d |&l܌`܉!G4ϋ|=)q׷Eבk&h&hO.ZkeF.{D\LJ4ն++ˈV`)_.q*Yd*Gik. v&boټjL:)l+zk_\GG`@ V$mx0qNLJZ)ݟ11j'+vMO.ϮlmS(/!1" K4f3Dhp\H,$8?`Rpup \4t?TQwNn $DV:^Ņ澀ގ6UF{Y F;S^.ZO{#LoN~tYI;g~{oH}F s1ÓԏaQ+68ObmRj|/0 H [bR+ft8]F]nEc1`%7܌&[X-_ ?5_KkXתCOak)(\`k ('LiGTSъ:uRDDT avM\IEx?eMc5Fzyp:>^؂GYn \~xKZ- ?}íLIkV0>扥=c naҰ݁@jK +XͳX[-C T\^-}C¹"bT-YәM/ݳlmWyj;UWD=! VFcbow U-vNO_ j#?d &G`FxR5>9jFi~y Jpj3?aYkٸdwթ?a-> endobj 63 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F27 56 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 68 0 obj << /Length 2627 /Filter /FlateDecode >> stream x[o8)(c,}m,AĨ#gmwsHl]VE@,QះOl1y:4qKulj %B]&gs&⶘ͅ7f'/6MeROwL޽ՄN_O(Ϊg9ǧwEu\M\pf,DMPԲJhg\f |{%XLd2FdJnPɹhgML˪DKDYÎvSƈS5WBM D }߾F_9o5c0\dq^7٦SM/j EQaeqP!suW{ &[J9ƍdqH*Xq߽Χ/`t9ߟWJ#Uhr>bPaE(ZMm 0 :^=a֎5D[b㉫ 9VȆ:YCx 0C[(R7$ C?K& nOp+պpbX,!l9&8@f0XLW$dXb]yk >Ċ>AryXom~A baxa!ͺCEBˬ,5mQǐb_بr7xqAoF(fLա`hAnHXkkꆷ=*r&xvtP.;)µ`42LTQv4 v﯊rա?u(&G拃/!8(\@P)vreiJECp2*;ć?B :TqEV!jNx=`ù刱0L4Xt 6 w>.f,Ee@[fxP:N '-#Z_Cukt2Щ/CT) 9NN?NSnN:t2&^CO+CFo<MoCg70  /%,2WGBLPJo]ZDy]ކUX *><^G KޏaEC?yBJ>'Gڟ7]PHCmI,03 m)!tD}7endstream endobj 67 0 obj << /Type /Page /Contents 68 0 R /Resources 66 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 69 0 R >> endobj 66 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F27 56 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 72 0 obj << /Length 2317 /Filter /FlateDecode >> stream x͚]s6+xIM> `ǝIS[BX[Kr$9n}DҞrXqpxl2Kll7DP2)1?r\0'ոBgߏL>.&#QcVX!l}}BfFkT J<[$!q7Ь(ͱi p "W#+Kn4]\J-V@}Y4r%c38%Sp&x)$ݢ]B]Zಾ %NԻ(SmJqWqJLSAJaPˏǵfXd&T@Ӟ"z,Rt*hg.DSőRB#T<*DpWxkwW&ht)/PJ~g@eQ}P22B@jll  "ڏ NAgt ۵jEXcFaġbÉ {q:FȆ:B~,-APg[~]/GwѵWnLub3.7>s?@ /nNΫι]jgs__oã2&1~X,׾ywt'hx -aQw(]Cr[0Z~wu.&'god\H &˝/⽠J\Ϧk5ծ}j=v6k/7]'u^jO YNjGU7?\sЎ̵>m>/79Ksꭕβ/*tV +L >s4Ω.87ty8}  osC}r(CX퐍=I#u^ϯ H$Cl8G(I H( ,Elo$  %RDCa{01M DCCA7E4\m;lkGG"WR: i]z`J*]乮ye;kNjYűzq.)7w>#xn,S̼y Al 0M \J{EeymU(zQx L,Nxq^u  gBQ,(H P!KDJH!KM*B i(1T?/Åˮ=Na )܅\k`mtm?ro_KHD?`N=v`鋘0FS~ۗzW> 34hi]Mצ:9JMk_qt|nMB R \.Xíq~ZBbzwֹc3?v=SoF)[BQr"n>o9e~:3ˆ>? 7BSޜG9(5O07ʃgu=;q8L92?A!!*JlV +~V4 a?SyL\gT7?ӌ#YѨ%hv)|]ׄǫ=mc\9bm!#Ý[0=Zm><WBW-6azkk4:nKD ]*1ѕ7La0JaO":b_80J9ߗ lyMendstream endobj 71 0 obj << /Type /Page /Contents 72 0 R /Resources 70 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 69 0 R >> endobj 70 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 75 0 obj << /Length 2424 /Filter /FlateDecode >> stream x͛[o8)y1k˾eA6z>xl'18~--Y @",IFUVF~y#ZQ"U7A sW#Eq7}V2βKy?BRtj&+"~2SY/FdjF8|Z2e gWMC"[kzTr"$1ڙ~80訷v(kS]qJq_q8JPAWTqV@>? *i;${4]vT\#ZB+ *LsDSᛋٻ7rnpH* Fvmgӱo0+xf0؍?N ??VF1N(jv}%.'3Q3 1L DB1 %P, o D~|)32lB,~?tC9&~h+5FsIFN9pơ BpPYwz<?$,x5Ψ^Xza1Xhz< -PN_ ;hyA@ ^$=ht-0y;qaթ%+]H|1g?c|*ip='Yb֋/+д%.t͜%XGG0hnNqъ ?n+눦.%pӠf%_ ב~"{zS6G4NE6^lzM\SbCāYؔaS)ljǦr 36 )LR5:$FC 9 ʵ^1pY?r @ap½$pR'e8%G(0ɀ'- %LpeB? O Gh`|>/]o}ϸ#lw@NX/q x,qdӡhAUtyU`)e_΍BTP7g ,{KD~ ̔ RwW=/wSA?S[ \Bwd;^Zy9^.5a-ڷQ퇌Lqa7&3n|8a 1?&ӗc[}߿8ᠷ:!`!{X!X ߧ oVvMvMz_<12܍l|~l6o\3 5ޱ-mq18 u'0# C"lp~Tj%Dj F:+Y?o"ocAx囜XmtM(Q[ӖVU&p+_?kŽ[tW-GLߦ~6yx^۠x`):yMV!?BbSJendstream endobj 74 0 obj << /Type /Page /Contents 75 0 R /Resources 73 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 69 0 R >> endobj 73 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F27 56 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 78 0 obj << /Length 2908 /Filter /FlateDecode >> stream x[YoH~#v>-Xg3ǖ,ye%F ﷪iQ3 .~WՇ_ ^qcqKug %³L'dυ˛Qz2 {g_3{}FpV %9|&H7 ; N1n9-,3WjTM)7\ LB{oo.鳌﷏IIRW6OhC,tH3<-BF:2hhvpvu=ƈS3N8*R&/`z36_a6+|mb^l8 ,} 7v|YQ{%PPh1uɁPhih5E=w^%Dh~m:a8)#8a3GM[KdcGϵt%6fی*bF9T\Ϧ~4`xTt2KKC gD Ú]2/,e~$̀g,ql,.tlm_A6o|fdgs_eW<[‹17rEf`u 7!KV4]oƫ5ٷf04$R:V[?2y PuPJ]BRs9pdb7#)hf` ^z uAPY{:żl}iv_>>ժ} #t(=)c,e ޯ&EI$#A?<ɷ[q7hp&ƘhgjT h !hwFHQ? )T=“HVojDpMR>9b^6@tA4(/D>*ã!ܱt }a|/A]cqXiʧ> )sa4| B1Lb䱂6Û <ː]*Pz@Oh1/la` }a]]Cxw1L2MJ#] -M8 ~5aR%1,fks_HeX?Go%b3M ?hoU@)ca4=^zQAC >Q>4JN0>v:(BL8A|aqEL"ƚ"m^ژ.d򐗦b[q֐x,@e)t oyDJq(_/[Du?i5K-  @9p>@Nyٮs; ^|&Po<n/jbK|{s՛<r ̗j4e_CϑnYdۑG&as1FB/袸 Yx^0sy .~\(ޔ?.\@k Ꙩ01~D'=d**JC*Lb*0_B Rl;bRp~*Ho||enZ 空'\9{X@0ה6BAaN_Y*,e ١0e)e˷-A}SC_8l4؂UR]qV|pz8dw@ mH#qЫݼe#s&Usg}E,wX˸ "KX"l%9D&pQGp3nZVt 2YlT仾SqhL`Z 5LpFѬM bz/[b:m1:lVZ"JCVgk?p5>bEx0W&~*-B0-">YHcJ&y]*vuruA^Wuyaוa/>/g!笊>(ʄO>5~Po;nr;l)V\%swch j:< n"2@Z m{cbJC2v!Jj;G5mA+O/"Y*qT;NtJLtR)c.5XZdJe*o/qp-#)3 G)*3[qendstream endobj 77 0 obj << /Type /Page /Contents 78 0 R /Resources 76 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 69 0 R >> endobj 76 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 81 0 obj << /Length 2248 /Filter /FlateDecode >> stream xYMs8WḦ́ -xj:90"S+ REVn 2%y+m2ItLq/<96#Lt2+ǙR*}sn|2 ?x&g^i\ߎO#q3=p&HKռ,F~kd (Juₙ$qkTP5` YQ2"]Iz[,αgbX&J.+f{mf^g84Ʉq%7FAv=62\c#e żzW{^ZO.H֢K9 fA K` <~Mf[]%=<+j1G:kL+ijh5I-7`L0.X;.arm Rr*G4#iL2api=.9 w@PͪpP=7 r0$Q\'z[I¹8OĬ+, r΂0Tױ鶺1K@kKZp:7]SCޡ[,U*?Rɼs}K*A|`n\I74Zq_(a*׺'z |5m8֌>UayiBe**1.JvKnfź)j<u+PP|jd0to۲j*\Ar,q*M§Z `=so?xw"BuyVl u$("Ԩ ASchXCEf9,s͌!5E*AW-X6s1V 1$PY4-H 9БdL\,`rP /f|Sx P)H螪R(=YTEPK#$ =yeŹO nPPI܁R0%UHP.ln] zt՟u*2i"bay="23@hJb@gc,MɖLw5leZrә; Supc{|cڝ?I(keRN"ݍ૆Bll8tp<*(H9N'T}N؈6]@@l" ZX4Z|.o:tJк>B_ϐ5>B$>`]Gl4 aPWA ju0HĠS`=A{f/AoW%j!w >z+qyrk>=]_B*H@N&*L[=;CCL ]HR84Wx kjЕcX+p2J~|ښrpQ<"S8El%X..uBn҃q!K ltKAhkey9cWLpKntpIXdQi8҉ܠ ȕ X /;VBoD:h>V TbCjNJ& )1mdE=4DpJqgWAluSS<897Zf ,-pJeCze@*ôޕKdW{3mމ}.<|N1'Iz 2#'c^lvA ro]U6ʴӲ ;WlأZшXĎì",v螊 AfLP 9eIB;-\Ĕ]~ J)P,xm#1ULA`VF>%+ɏbϼQczy(E_7x;xwK ä|1E[haJO'<'jqJD 8kso,N@6ACq \7xQ-7C%9C׮PÄP^rR# eQe9ָ^"%2Ry,a'$)&q]DD~)E;|T]"y_0'{6-ANex{(,H#5M#ʨqO. 7:]_{dEK;ȝV/3QϚmp =~<禬ıQPS],8pw [7ݗI8sFTPendstream endobj 80 0 obj << /Type /Page /Contents 81 0 R /Resources 79 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 69 0 R >> endobj 79 0 obj << /Font << /F8 19 0 R /F24 22 0 R /F23 16 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 84 0 obj << /Length 2874 /Filter /FlateDecode >> stream x[]s6}#5]!7Q$#i3>(kVUI$EJDiE x1:{84םXJk_1iLFi'Ho^GgCueRw&gLh%YyJsp&Ogó8=] F.K eDu j% ] n&cNʼnUqo7%dBE+WtdۓZ'Jt>͂Y8Oxdr?UV*\{׳ŧy&t40µ /Q0?lǫuDݘdDfN70 lqn3`UِɆnGnS6J.d#7 h l!X (cdV6e5[٨Yksc?Z:bg *\M7Y $@(}u+xeoj:IEu6HCD)@Yp0"R:kDAքcux1PFZyJ.+7C/,7]y;# D)aۃ^xl.U >հN{:'#rc| 9U=" (ɰJn;u8i oYuO| 0DjJ.Y`b6$dr@2bl>QI, Vo5S ->p!ڴHfJ֠oI^ y5[/H^h7M.Dr(˱ cb9E7f%rt3*7xETC{_t9 ˙HnN#`DZ$yeso&y[K$%y_k0[{lXx޽:Sʱ"~BFFh(+3l}pT|o&;uŧ^ƠnCc o#w@KGqړH+%F=Җ]֐0VҶ}Kzi+Џ'm{ 6I[60of@WIq"S:Bb\iB(6Nr3fD+[{li,N*݅ޫ! Y2܅\}%EHХQ25z-q)36<&a|u#j{$@ӈ;k%u͎ ~k įY rпD]!8R*^$2rM6q>P+s)XI-lSe5*̚9ȂS sNU@|oPC=BR qUk]՚׺4X^YA3}Ƒ3H\=| υ6X&WppCGpD;] y {G^A;ŁJ"A`[#D=dz~( f"약y3ӱ -Fno f\_ffi* ,$;d.{BJceNev׈ܻ?{0.qʯ F!J%| l˛~ȃ5ߣ/^L&%fHpCC;VRR@;xREhWh 5# %RU:a6a/"endstream endobj 83 0 obj << /Type /Page /Contents 84 0 R /Resources 82 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 69 0 R >> endobj 82 0 obj << /Font << /F8 19 0 R /F24 22 0 R /F23 16 0 R /F17 37 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 87 0 obj << /Length 2566 /Filter /FlateDecode >> stream x͚[o۸)(cY/ms)M78X먉vm'AEr6Z%?MDPFPb-Id6!Dvr(# qB?D8FpB s$dyvsgag&eKF.K"9Di%F BU^r7G'r ;|_mj<3p+ kozlbݘe*Zn M LB"s1?{8 88T+l *H,AP;l~bQhŁdb- Չ<xa&|%>_< =%VXy3~ϷUgF_%%\ }͈S{8rG;X_Yj d :6aVg(bĉ R*Id/XT3W;JWezČ QLqBl"5-Pr(/V}sEҲk5M:u+2ek~ȘY|h V;iLވTHP d.&&#&Cs &ajrVۍ+8Npsk)$tOG'6 V'X:^}^ˮ>4_NkaO+VtgZqs~zy!r wM{JDpwf84fTb62{$QԵ`h ` LcCM=Dk?BG 1h³ X~"Yz,q5 __RX-l+ݭpuWq=)gKYŽ)+*;OSs3O$#Iu'U2B J \Vsh . #X Q ٣" 8ض@,N&[v҄S-T,)ũ**}=Vin!0E=Q#Th7A< ekQTč!!&^ހgqbIHH2, O ਹ&{= 5vcP1 v)OCuWɆSt(IWT^~Tuq38O=(6[ӑ0ϩ gS~fTxƖ_ۊbuC.z{a5v1;n1Z3N,zT"|7IO7IgGb#0K ;JޝPB'|W{+y<;oQgxm{rMR-P{"Q B nQ֚U3 ΂3'ZrMXiu845x +H9#8l-ᡁn*o}(/tiL4*NUNd+ZeاH4pHEf#0z\;*R~R…Uʉwfq0\ 8"eVk?[QM>aJ#@NÑekYTsȗ!) PHkq4,*ǒehL({LYG,Og"ˊSr8]iM|Yӓk@)1rdGvrbTn^`=M0v8Rbזr^p)7כr܅`0e% '$ܦ}uep:9qf-ܽFX8 ?mo Y|;2oF )ؗe8e:V6y$VTdC&-L@3dO$!Wop ej8bLCWyJnPuJ2Ņd E3 ڞ>b:T>Չ}/QCj`8nblM<Mþw7/4J/LTTs &Mw!^eA̦7䏋 20`Ёbaq~ʓD,ȅ<'0&/~UB5ʟ+"woۊ8 IߛEO2I=O wHISrS|na[ bENP-OV:fxS@|r *# <yrɞ= > endobj 85 0 obj << /Font << /F8 19 0 R /F24 22 0 R /F23 16 0 R /F17 37 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 91 0 obj << /Length 2512 /Filter /FlateDecode >> stream xZ[s۶~#5-A-9Iԗd>mi-)$7 $ʒ' o@^]Ox歴M"d"q<eB;i9ʔRˏg?/ߞ^?x8W&/'ɓ Oޞp|nGxLx/-Upwrq['8o>QjێuU`ʜ4LK^%9 ^ ZNe#J/f +\'}P*#EҌsw 9vĀG +}"H(8.LFe4y;C&qS44d7g!"#%O#ϛL cA,5Lv~}fD {2, z&zeqw W:W[௠tPrZFY{*1d`=d5#W@^@c"yb-$2Y>2"-ϘZ0Lh$7ޅwKz͛ 󈞜NʯQеo euzzqNz6-ʔgK0KF2O"Ǝo]1^GҧMEArqZ&e8oAȬ`LoLGz7`[U/tϿhl~]57 A1v!|`vz1ڂ*##I_Sd (P8)YC}qynA#Bm5`V);"O;9H/̎JA(cEAz0FgEQeWP١yO({(@G6 }gzh!96BjP]Xd&-Y/DmwWN`_UP#B `B+16y@drtܐRos= S)8:J<КL śe{|}f${X*{`V,^n! 1! +KUqۃ-rPkG?}#?Qj1 #ONջw۪%g^VPU9Tྶ%ڬ~g ~R%&WF+R NxE"-X"Ӹmx /]8?H go]`@U&h;+l7N/v~+0TE{r[6Cfxv/򉓂u=-[T8US(nZ#j-8:fݪkKE-ٲiqdEOadc/HH<]Ell0kk5J/au{h^߳x!ED Ƭrr,,N5DY 1V? rqd _]|NîBk&'teL_vV6C"Jml =$ѭ3IXN:]Uo7ܟ}C (߼eSN@iF|=^j 1-7 a-X7gU#+Vw@B{jk9zo!}WbުU;iΚHZ'Pw'BUV3+pԺ)24$V70xTCg*>L }6j:Kж7?\@7 83(9]қpF 2D]Dfs[PdϖHC~@w*2=|[o Գ뺋.J=`=kgwƥaNqCOY,i $iP[f5x Bs9mܶ~Ǒ6׽aEMo% Jgm4ܘ[~jÂx5_^`ttęeu´߄V!#TB9 'EE:BDrnGYnf;}zendstream endobj 90 0 obj << /Type /Page /Contents 91 0 R /Resources 89 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 88 0 R >> endobj 89 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 94 0 obj << /Length 1882 /Filter /FlateDecode >> stream xZrH}WQ.V/B C\8^[$Ke;ĻPTE>bLH"s3q\ ]l\(..F"'3g Jlz=g>x|ę dL 둖jpxV(Ɍs y="FIÔ +\/E5P("L/Z1YxMpd\ td4܄a4:Glzs\jUMAW %޽[`i99HJ ɥ'94tr؛wc|<ц%9:B~I΀bd:S60vdhQ>Y @UVZVd=;9UU v\Td[}tƌid3d^ k30#8ߝ-Sxa*F}wv+f{a%N}nEX! Bፏ6䎍l|&[o|to&_`ၧHL;PW|_(j<+*C5S{rJ#55hϘ2r%xu;VH6? b5)S뻗iDʘ\yL?F:}(pTS]PO7tIbO]ϔ]kEjiF39F <'ELRIlE Mendstream endobj 93 0 obj << /Type /Page /Contents 94 0 R /Resources 92 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 88 0 R >> endobj 92 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 97 0 obj << /Length 2218 /Filter /FlateDecode >> stream xYnH}W,_-{o,.-іYHTFdtpr.G0g6Rd8}K&|\z'x`9^$%d0 $"ֺC0BUF] 8eV\jCh\n Wjt"s!OE.վܘ\6)1g(O!3rƴ?3zDs rp{e%` oOFkjdbEGR$ );$/}iOQ0;^|. )۝C)/wO0Tϐ QIۿJD,}1q7b/T+I0JcK;D8mk U-Ai=<-Voyx>+Ux=[U"TC]15qn8<ʤLhqfLZNrXCE]x GԨ/r&cw}y Vf{ G"MTi0FqE&@4oϬɹ]f(:4BǾ*EeU#YF3F:`d= gfu͸˵hl5 =-?jĬ |Nv+8f V2~F5){Kf{܁GE|F%TB],}US(qpi\-k^/סu [y;lG z?YQC1bqCMa>zR=:/h ɝgJ%C$I"P7gaC!m.+ΣchGuL@:54/:FKpqJBi:Oɴ!2k܉,5aysg/W8#,^}t(cD8,٨7KظJi_Rhr@HqD3+ EJ4 FE=Q@Ŗ ClR-Rp6AҔfA h[l)/ l: "t]H 4(rCzRP=_0z jM"OXRR4(>5EhLqG)>5 Al3}`g^ &n}4ǔz{qU.$qp♷]7<%g=i3M9!(Q(duiF،Qse}Wjn`[B+C?h;b*'%"%Thørr3>8,2jĬ '2 Ssm\]|EUxݘ~;[%ejL =R(hs~>srǸ`X#fmȞ!!Z-i 弭M./ g?x8*لR4 xрuh{:'*Aw/RDw(ZJy*Ngо8btEx'w7&> Kؿ9L^] ᐮ,KYJ{sgu]wqtb` /3=M'UISJ4tiU20/c?'"v 1B<peo1V/&v\q\XZp<>lLRz ,[JXWG"\CZFnZR"ㅢ5|پŊ-m]P}{uE`a3]nŲ 6[=K>BAgJGюjSK裚5_ wmNQC+ /xc_:Wpz&sk6x;1kC݁8vv͹ cWrA&T%HϝDCDBdHu-2h 2~vb+L GljPP~dqȮWȵE$V,]8S"n(fxsP nE׋P}4P~btb` L{ˇZhaÂKZ&Ga0`>F{46މ(8a?FaUf]eR耗u4h<_I+Td9,0攀tYh„ ss  :]I@ *ofNK Q/ߟ_endstream endobj 96 0 obj << /Type /Page /Contents 97 0 R /Resources 95 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 88 0 R >> endobj 95 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F20 13 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 100 0 obj << /Length 1851 /Filter /FlateDecode >> stream xYo6_G XGJ6Zkd}NmԱ}dģ# gZݍe1^IQQ0t>%L[q7^PP*~L2 /Q)f%$nOJ!dsÄMS5m ˄zB9Xi<P3<7]WWUKY)A_O-bMdz$U\ķ?$x2>ZO/' tFݙ-~r(/f:._پ㨌I=H~*&h6䒢/IIŀVy$^j2:^NC"~qۄ?:b2.IN0 n=VھA+ݨ)#婁&nMLc 4xZiΔ2f@k<h؉@ `hց#9W5-OQPOvo [k v~VFoO _p٢XywWCr\zݧ3 Tz-uy矊EP۝&( jܻBX-zxsUֈ@uRYTGE=6r" ZB'}JK ]|"Ld\= %h0!yPbk{X_QexVl\ECF51Yj@YH<)pӢalP1méqe]e\€+'bf.‹+<ɫ]ZH4Q:OAe֞ᐴFsač2?z6.-0t܇6xzy,$4MKU[$ !'L솘j#Ҷ6NvwMtߌI%Ph`FP2_ER U{MuT1 &h2 e2L_O( LoW Ҟke/ω5 5\7~Y 9egcXҡop2u*zb ax U2YInS&)P,R#cyԆCX)u$G~G6$ϙΔ=PI܇G! >OD˺nz+}ŵvZRasgY5b[zN;‡BτޑgVXxwLAY/  \#cBU(d'j)̫dAK|O{˅/[CEsGؾ+!W3nZh*O~ٳ3mWx1ǫW[wH=B nHj#˄VޒeϽ$Y YhbX'endstream endobj 99 0 obj << /Type /Page /Contents 100 0 R /Resources 98 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 88 0 R >> endobj 98 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F17 37 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 103 0 obj << /Length 1893 /Filter /FlateDecode >> stream xYn7}W 2_N u]. yP%TINrw+,.9g Wo|Xfי)Dgޣc.|\ T@dDxcAi] |ij 8S+>8!n?n4zxV(Ɍs~[^TjȻV]U0N^vFJu@~>,pjYǬr l)߾FǛ86=ĵTopKcD ##u-A!*r 0>1fyZM0ty;._/$z$?f-lڧ+:E/:j$f2]Fd Z& 07MFˡ9oAQ'hF4MrYmZ`Bh-CN_,Ro-yV[#$)tYd %qEIm֓sAm'7B-*ۄ&Y@= X?B[<,-t֬w;LR.C].g)ôVF$teD:̧ƢP=t{98<*=TQ<ն~HZ5Z0T8VT!D!?NBˊ48nv]SrA0oJrd#6sf!47\0]注(u6l"ֳZ{j1';lnZa8Im6ŷ7lӓӳ_7E8rFI|_%i7mxؤA+ GgzZN"5-àB<:?;j:l\XNo 2 uLRy zgQcɼԜuwtՓk#yVլ$I x0=PJ TB|OcƴYxQHP H1*jeEK[:Ci\U: ܨ >5ǓBu2iJ#[)j&SϷTuRӌxX3TϞG<VcRYX.tv,"AÇ2䋄Em?X<.&NFxG < ot|"Qcendstream endobj 102 0 obj << /Type /Page /Contents 103 0 R /Resources 101 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 88 0 R >> endobj 101 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F24 22 0 R /F20 13 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 106 0 obj << /Length 2365 /Filter /FlateDecode >> stream xZnH}WYv~7'Nb'8`yPd&6bKI ?)Q ; EVWWW>Uѓ,Xiυ)DgŇR+]e=Rћ#Qp"ǂҶތ~}ȋ/^8S~p&BHKËJIfjt"Fތ\musM)c\ bP\֢ecQJf2LX}V*#`e*+&Vs̗͈ۀI 녇Bq帖Fq˸o3xA/|ϙj|<UXu45sU4 >4V9lm1UZɤgq4ݳMrE7\ Ye4pl#HRwK(Ŏp+-:q-^"Lj>Z?\:]&7^]3(ug0dwn'ID,ޛ\錮ڋ/I*>g//IYf>V"R9> @G3>I-r&Z7VF?etOߤS(jrEf_6ԭͼ%fFrBFl ]l}c9 wVhN?A̘`iiI_`bG xltZvJ2pdJ 1|OwD!v×b\z*̛M&cRGI&V9axm'Bw[f$ <@l6հ6$ GYahCk悡pZ3=BR QhjStg&Ukg6G{VXu5r;%C/h %o;+giq(ᙷM}[vW/W;Ow2P8nv;Po{+ȍēYM7.2e/;>Y;$S4빂eY ʑ' uG iiGUWeC6 hóT5+Q~i2 8pֶX 3Gc%g'6-hLQYjc9_Oߠ .,m@IuJZO+5vd"3@N9NY֋vN7x򌠳0&oψ5YJX]oD[JR^]wvf7]R){=T<ܗޖҼ A42Q>̏QHiCLW"0xjc){/5tE$KYj)6Z"xc/c|#zb&Iq % c;k/ɽiAcV820TRrMn**?/W'g at!Xԋp2DyN5V]O7,m"OM4q* IuIB]ضAl+T$uI<|:PqDf4 \?&H%bZB*8x4mU ׭όuzPfWH>Sau ~Q'GRr.#0d0B^A@Z3aF*+$1h*0b[}Ay0c6],ZDd2) U*(LE т>sBf['J) }>RhV][QT1 י7.M~m$*Jcqi:> endobj 104 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F24 22 0 R /F20 13 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 110 0 obj << /Length 1687 /Filter /FlateDecode >> stream xXێ6}WQj*Kߜ {iyPlmlk;̐-Rh D39C ^nG:=$["c1X mr&hZf"]eFK(Xhb!NH?d2ɻ%Y|JslWܽʺpm$?%$݄B(&ned?=Rsdv@xYk-e6'-cH FuXMbK_Ss;W= Gc->Yy ߰8 m^o:_'hgO 0S>Q0fC1ƈO\mކ{_ noλ_\v[*c}żm(ǥSVe!S2v&%P> a‘TSde>DZU8t"*nmQ"ݢM=%=ND[hEqe+GZV]!3mk/+WVNAy 3Pqgj>_WmqS<]+gl+7C]QYl1XVmKU@w?*E)eM0[V0bߕahv2d4] [D9P/z-ksHk(&MKhSh+U+x ]\WU46HϚiJM* /^j> 6 h^4j5uu_5pE* $b}8zK)$Gewhh#!lRV r݄Uendstream endobj 109 0 obj << /Type /Page /Contents 110 0 R /Resources 108 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 107 0 R >> endobj 108 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 113 0 obj << /Length 1423 /Filter /FlateDecode >> stream x͘moF)՛}~ܑJD]ڤR(/!);!8aߎwMq!aAKZ6Ke3iLo',B׃wqc ?8eR'swwOQ&=J*yJsb$A>^ ȇK2rbfL34I]wB1puid.$1ڙn0d,~I9>@YEs2`Jf>|D1Һxb^l Lh3oz' gI%8;QGߵAj6lY+o4$DkK,GZt='bu .2x٦8:8ht. Q\P,<2/д t4袜4y,:1jbAwb/ b:s2=Ʊ(qA ×.:^R@aؚ\GD`$6x0Y-O@ 2T ~*tH.8#$Bb="NV$i1xZfG'3Jৗ_Y0,x웤N6 "XJ uۼkj!Xgi%K(.7!8{ g#ƈa؂,@$ ]tR?-ͰV`"ogg/bS9 ,'Li<$RJK@ؐ\dq!0k>TgUB|f?ZJendstream endobj 112 0 obj << /Type /Page /Contents 113 0 R /Resources 111 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 107 0 R >> endobj 111 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 116 0 obj << /Length 2188 /Filter /FlateDecode >> stream xYr}W_f[NE%vk+.?$$V"iO @R$g+)UQAOos}XW)DgcnJhtyWJ˷7#Qp"ǂҶގ>}lċ#TDiڇ^TJ2?dvDjۉ]Vd4L"u+<Ţע#겱(%se)eS222JilpY,]1 D+12p\1ʟU`M"D. 9@ʔշc%/X a^\3 $RX(1/ 0=7S·fu^uv%[ty*EOb➧O! $T*S-1Y|r1#>[xvE2ߔ;ԛRPS{M㩨E—lH(Sbm ^aihE"<'{GX̀o [?䨢dH!Q(Yin`S멌J&4VU{?~䃒 -i>c?v8V}dε~8F@*XnRݴ׽2WO.һ]>Xl0CJ;+9qCTx?Uch;;tFPh$t#q~[UQqGuᨡu[`g,s< 9%B?m$e! C Gy|\z>?Z*1W)]b~z>ˁ1L :S1b~t>2)=(56xHAPqÊm=h29F І<@o“èXY8SD'LRl.bCVH~J;YR?XzR; T[p)җ Qcgʆu9{Sfdv> &01brI}`x4C~ܜ95jiPV=c=kT1 %Nʋs"QƂc`N57P2?(c@K tyeC& {Mgt$Իy1u{O=NuZuw: t3@&ު!Vpw|Ο@viܴQy({D˶LccaļE$KhR {UD7mmym k5Kjvb^ "?FJeG2K7#|:vqŀtbק"hf}He<_T 4Qx4[ŞQ4lEfQAHPh.[*0&a<O^*W{0Avw;p!K 1> endobj 114 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 119 0 obj << /Length 1391 /Filter /FlateDecode >> stream xX]S6}ϯ=[ o v}(CH +ىclЁaplK::Wv>8%y&9N8&9rWr)eQvy~28>H^G4ho¼h_wj_+`5ǒ0q 82xM\Pg㲋vƹeXg0B  q;6~m|6$"Pˑb 83^-F3Ǘ2 a dL\nƑ1B|eeVOrB4G*,5~\$䝂DWsXD7|5e2ŶU˲KRGRhԖ+)X!dB%)J4{j0KRcSK_K k`M&dHeݪҌTJu"4lbK꾐Lb9c.͐PAwj( Šf 擆P] c;3hԖ+ X! 9R) gE5^b4 Xo˂UƆeB̛- ͨ~JY\";u*(QXLE\k ]tbHp9L0u6M/C.LZ] Un_aQy}Etz乑 {Xr0kļ scAfl?%υEs҉(ZpB>yS;|wʀ2,z |؜NTLk\ST4kL"q_J} f^ :(Iꆶa ;y^;EO!>o:ghU7@Q!N:~;#6Y!6t/_P46d"uF@ti[ؔ-"+cuM۹ |ZF Y0q:s㢦c I( )&87YNC endstream endobj 118 0 obj << /Type /Page /Contents 119 0 R /Resources 117 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 107 0 R >> endobj 117 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 122 0 obj << /Length 2025 /Filter /FlateDecode >> stream xY[۸~УI-@f7M&[ifƀʚ e[^Oow1-S˼<*VYiLHDgcm)E)t~}WR*uDd"xc6O~|̳go&ʛ ~p&Jf-Uc90gχg8ʋFjy?!q>2N ^uKhXa|ÃNy8sF eeV(k+fAzZ3"6o^놞]ׇȃ"x\FVHm4ԋ/˚E; TrL#8bX*Yf9ҌVf)U9 ?Q%cޞhKdU_C_)tq s<' {4qTJ`31<+y&moB][lS&6Ohj4 3#Ss 1UPPnR)[mWllus@HWإAqX|_~|O?qGf41f'Rp+nb4۝aU֜!fR5=rnw(= ߫z{G.@ZCW:ه~U+;wp7% ޡwtx(`"Lh/mtP׎4[ [=PXmm=!𢎭^N6pA{)Q [ ?Ly*ξb"N &TuLХJ*C)M9,UM5ʼnEPBB4c1 ljۯPDNGIc=P7vz>89)pCЃ26~HAkPhOى&@U$ :~eיthKݴyw*V5:JLæ~z4mq)$/3F/Z1+ܢRMQEV#5CxnRo8P_ Żf&,ܦi6ju82*V^l/4?t&Qgsrx6,p@& P4ʛ(! "vF39ܝJ7h'dImQz_lh> endobj 120 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 125 0 obj << /Length 1939 /Filter /FlateDecode >> stream xYs۸~_GW" oĝqzI\&L[eE9MIdlH$,v} JVZiLH/EgcKЮŢJӯo&gq3Jl~3c+.'<{3Ld™(KLTe58G'g8ҋVPfBj:N ^ebQWCjM 沩%+䡙 &,Y_CZ*#Sӵ" slӊməNtK$Xi sW*/tbVpU_| *zEovw?=;t3SGO}K=?F}=8W.{yge+h>"hx'/=x+p3,K6oD~&4WOzq[&.!X >ҷ uW:coioH_E/ݶxnҪm"?- )J_(tYES1ҺX8R'fxDZ B;~K'S\_=bFvuHDSd5r3mDh#zmRg\3;H:d*f1]A|ƍ/aV+M :N6)Iu۞cIClH؅U,ci%f<؇UؖU]m[%0l|M[ڧA֨FQ8.4җ6(ݤ|#B#|h&w#ZV$ |Šei~O&r鶩wfBתO33[{lFxHx{ /8=S٪os<"dE*rj&ɱ-@7;غH'mK0',ڦ~ %iz?f ywhu_7~ g]ꈆYt$>C98Wg8ϡCy5C. 5(w6phyHM&l*`B08 Y^a1p'ӢЎc s<. J1'E_ˣ7C{>Ay ҩeZ^xu ;Zݷ. PUw{ⶢ]w8qt  @56%:LaJ#I&ȡ`3}kv_A ȯrcH[ɔp}C{s P!n OC'–"a*ǫu> vJWlL# 6q|[C<5MryL R&j] Nb#g?u>#Pm>T;(KuO AFnSV&4>eQ*Vco~;EOqҧ6K}G 頃E#r2 4t.cU/J'jm6'H~)Ӎ.NgHŠh4hGkL*yK<j@Iu׻Tu:{B RCaFqEHij Hm l%H7_ <! *6G$ 9FG'!A{Vs;-Q"߿4endstream endobj 124 0 obj << /Type /Page /Contents 125 0 R /Resources 123 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 126 0 R >> endobj 123 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 129 0 obj << /Length 1945 /Filter /FlateDecode >> stream xYrF}WH_[*y)x@ZbHJN~O "lbWF_N^^L^+mq3Ń({ܛ/uU ./.VJ߾;>\^LD_8z^'x=Lo/L 뉖OE$3C1:xH %'+N)cdpՐZtdpNa-֘/!5#jTOEJ3q2*2mO 4BuK<,#Aa 5b.u4ru`L)D[+f1;u_䐒*0oĮg'"Bk%^i=`-v!}E-u֤q⶧Ҥ ohw+s5DMp4yd|gbwLg⋞Qhe#t<,878Cf\IYW2ھXVҕۡdCwe? oWiAib5+Kivkb:ms5/rV(]^j8/N殒mʭKM|Q^ŏUHi#peCZ=O8:9"M )`~4m;5W?H)L`(́JIm!5}@r-f=I;v7gߝ/Ti Bd! qwȗޥSK ݪg*2p\.].0y"RËp{n7{n%#OUV0L>lrOMv!<ĺ/(@o ax:0` @Qr0?C%ܖJg* h@H5:45ї$hŋ95Vԇŏ7qIA8ICUk=Gp0- !>rHmU{ bendstream endobj 128 0 obj << /Type /Page /Contents 129 0 R /Resources 127 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 126 0 R >> endobj 127 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 132 0 obj << /Length 2032 /Filter /FlateDecode >> stream xYrF }Wj/}Klwi6̓*2}HEiLD.wXX8=f8uv1cAˌZ+r\0igոBO_G,efFj#Q"U-PœHr^.Gg_r Tt%@()(#*3\*͔ɛONJqc Al%a6^k?k gwhԸ`H41'1O3x`򎧩"FCyUNUk"2Gw-%PT/'Z;$J|q }y?Y"`;FsS|聍3DKp.!„r1{#kCjD;b%76pI$]1Xf Mhؐ\oO_eh_cN'sY5DWV~F35|*h!]UAg: E(Uf?7A#nhE"4ڽٵDJpejc`XtEBPrnT`1#X {X=V<6ܴծ9DȀUL>Ib j6Bo6~:-two,{W<(˛q$øff({ h@`S(kޛѡ~viWl9e{3'cp!ٿBho;4hcoѷeêieW w`KseՈE_10~}!ڗN[Bv_( &ޯz\ 1܈mLm OV<-fz.nZ]JaO)_,Q%" PZbZ-X: < _O<>;3CÃ"Übn@uOZs-?m~ztؙDqe:s9[ 8ܚHe8![L=7']i,d4Cx-߀сrpph^jA=MYI԰ȰV\*"k/§D7tPJ 3 6q\4dC]Y>[Ჺk+h d]Uw0ɣ"E%P Xᆮ8hoR Z}EW6 ܧt6z OMm꬚Sdbړ"Bmc'KXBBc[4}}9Ne7a?#>V.lwx0i+m֓v>j' :vуPqO'dOJ Hcb#jq蒌n*0gXn~i#tIySg2n/^հ8>JW=q*Sqھ؃<^W`'Ğ}#vf?='gP<CkL$wlS}}ޑ7|Ve$mD6hxo 9zv;I,"{J9mh}aaV}R xW+2y<^iz1:+Ly 1+6_İ)G8M;_ed YVc:L9pPhVt;BUN#h "aSH2&?(v,(tD']wл,hgU>K/Wc|9t==CAgJ,i>]!:#RbߵB)8z3*s&endstream endobj 131 0 obj << /Type /Page /Contents 132 0 R /Resources 130 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 126 0 R >> endobj 130 0 obj << /Font << /F8 19 0 R /F24 22 0 R /F23 16 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 135 0 obj << /Length 1383 /Filter /FlateDecode >> stream x͘Ko6:J؊[ nqzhC`;7A}gHJm)^ r~swq1nePb-<(4N(o}wﱌ͌2 of.{gU70x6I.｛޷FfDcwe,p FN{hԲ~)UMgt̂+A5kywIrNgDnɴ&R+ v(Y Iv[2t /-kG5sxňS{ש D ˽󃂛|P+ l˟!J`fG .<ߎ.hnڨK(lt*2l0‰x\ޝo[' a>n$e3 (4Zv[& /k#(-@C+FyP(Wxl 3ޑ0)A}T,!hZPH"q |`ʪO [xQDR~.j\hpAur3߅ J3 U hpͨ;D+ ;`B -: bJB^XgB4 A;#JZ)p؀rT6800ΝTQ2PM,x& hԆ(.ihuҠiCIC|Hm%@JE,Uv,`}sc`? XcXm H F C IO+e;iZB(({<5ETjld3f~r԰|֙M79vۛiLu`_r?xX`>ky)yWA;ZL%rO#!~4P`Ӛ\A$K׭[X/>hq=B⡚,V11b`V#[K[>W/4v| 677nkއ*a}=,_Rei,j1B4x&Sֵj ?z]SnD_&qрY|\7/?}PQh ebBUpWBM\NK) aJ \_8rJuQZ%t.CAu endstream endobj 134 0 obj << /Type /Page /Contents 135 0 R /Resources 133 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 126 0 R >> endobj 133 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 138 0 obj << /Length 2361 /Filter /FlateDecode >> stream xZr"}+|5/~ӂ#4Z@FHOVu7u(z:y2uß}Xf3!=S<9μdz׮Bדq/WJu.z߮?vq,ǂ6ug>v8S7dvR7U篕J2Cp僦r' SFiǤpՐU' | 62mFN+͜ n4CdqYhΌw\42FFչ~a3˨']w2XڰUπ{ZFV8l al1맳V(f펓W%oA_Djd+ Ѳs_C4._'܇ںJkƭ4Eh[twIxVgdwp3Әzn\8$3F,Gcri $ƬӾD$ D7\\zCXsO#x QY0S_1[B|+4`_JsP;Baa,< 窍\0_& zɥE)Pz?m$]"X\{T9,rwtQ1 %|>:OH8$K}jY(Kz~3qO%j4~iy*P(k%DU1]'Q`T^-ӛ=S#sQyۓs{JWsm\fJY]N6ҙIgo?32g6Y^՗^B?Zae4.h7F˝PM;xņZZÔS# ! (~})(c8Y@M?9\ I+=lːp_Ċcb7hb@" Jŋ#҄T )Ybh[+BL&v~5h#VϤPM  Cہ")7o 8Mo۰/&j8\:Z~s?ߦC$`*yi<;*B^^Lxɜ Ggs\my8JR f@o)E-"h;[ ”"LPrܻv¤}8p*eHr1au/ܤ6=%--KkQdP_(C> endobj 136 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 141 0 obj << /Length 1624 /Filter /FlateDecode >> stream xXKo8W(com)mN.rl#Aΐ"YR#Yt pfC}#NsL-ԱJɷTf9fVd"}w}8KM2 rL48D8Gx9Ǔ@rQ>,_emβKpr9@wDSU>+"vI,JКTB~$c)',?'ӚHTRW#OUBFaЫ2,2;׎v#N)N tbs7YmZ[$!(lwJc^Wp*qxu.B*]]Im|r8TY2kQǦh("k 6mN6I(hp2^A^Mmx9م7v|W$D9wV3A-8S8f.d)ځ1S¹CfeZ.r+nQf׫,7H׵50mkFUhϧ5 ਧP@ZB( D9@f@BT0*¼1Ԅh7"-ˇLX0$pهiRvxbtZj 35EgM Q:-jLຣV)lGe\iQk{@7]TwQnx{~~9%1֧ۢfroE ,?l|L gs_kmD*V#{S-0?%5FʂA ]=3K˭sH&E_wUO~J'z;80T shbx7nG/lGT#{ BaB[ DLR<@ӘW,rSyf߷Ie cжq9qzFK9hSsMx-ۯSx``uQ`R6_w ́L0:9jaGƭPW"^bZ&{7K;"gkp(mj<݋e'$sރ e$:"1ko {.2*Z}p@~+> endobj 139 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 144 0 obj << /Length 1812 /Filter /FlateDecode >> stream xY[SF~УT_V!3%$y0`O8)ٕdɖc(Ia^ɻs?G]6ɄL 28F_r/vAqPJ応^|\D'3g J+F=}q7.8!쾧.zާg8at𢄑${DW[]hCT8i26ePW57EqY_ |M)L %&>h&w;XP nnt\V':A0iI`sfkX\(rx^ShW9ar>oyfY> WP#`DL&lQ^2'Ch2xZ^/p|_MCk9׈HK+PڷI{/W^s٘niχw۴|&H!kF*=?;߲,~3 ʉ].&bLz )R~rvIQIƱFCR! Lh6L9=8xIY dP}H5ZWI9R=O9(}釆 3\ p*^_:P27K~A;/`"4 HĠ(3_A|Mc;/^OG6rmͧl5 =^;7bUY*Dm{4yt*Q*QT[ Ca.Y2EfID1V/>{_ ɣqh o)J& FS2S?*R _Nh_с :TMAJvh ,ܳZQɂ~WR ģ1NO; 5Rϋbu>\.ɶMĝӡFr:SXM˴mDwE3Z%+렖IZ(4@V-eEfXKK )RmzTImL3ᇜ1Ycbv|}#S!MȎNF:f'd hGBG!h$(יCRPV(MyG'ۍndwwWCec>Uf^c-#5>7L[|`1l'CWHlp/.|{Gj8 bjptւ]5hu96N1Ph $*H=*)i FC*WRJk D˞ƥ:vIS{Q_,T`B&K#9`Ku r%F<3q6/A|#^\AQފ*;T7vxi+  J6 s%:A|gl7m"(ݱ!*d2HLH1[x9xe܉;QXnj:d J&th;C޴:jg輄 Bp/G ~deBY|V/f9UE$XroqHU{ fPa-&TxmLq] iQӴ;I'V~ gIn~|I߿}[ftބV߽=`'ϯsaQQM1/C)Bz WatR^!Oɸs/o;endstream endobj 143 0 obj << /Type /Page /Contents 144 0 R /Resources 142 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 145 0 R >> endobj 142 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 148 0 obj << /Length 2508 /Filter /FlateDecode >> stream xZKsFW:xޏκbzCDAIT AɲR =1=zy2{+mqr^Aq=Vy% 0m'²v{8QOۦ>$eoq$wpgs9 Bd_ϧv JKةpJTm,@uA'X (hd8e)EVOڠ C#݋>O~N?@OUOfWq^_횽="kqu]T'9ϥ*pO(ڂa\ 1v"%vKv75]s$\DidPJ#=E~@ɝ!( \%Q$'|Ų[[ECYnv⸏ܛvR@OOUH]yr qx5ͧK,׫x a_BO-|ZZ"^ xv8"MZAI7Q)4' pG@M0LT/uŎc=1f5/a>k jwњ)e C*ք ]6-"oHh:/q&bݔ :,rosk w%aT0}lh<6L:i0 > l.Xl{Zpo5gAr=h-:NIPPE)y2g5h:^ҪͲܹ;#K" W v#zHKpAN[~AY:۱0Ͷhc+% ʢjK E~w~ ^5Ԏ6I&Zž̘G <2Il;ZŔB1Qֿ0rq3ּhH@d8昮2{ՐdQ >윂 pNqtKt; 0rgq$_l@Fà.L)4DQ `SQbFcyOPUc5?%ƚzJrEE 8zf3/:nB$>us[û[MƔ}i-d?}dQc $!HXp5i لxCi7NC5P'yDD_1.ۦަBy$W]/D~,lRDL'95$S2BԱ ;> endobj 146 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F23 16 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 151 0 obj << /Length 2201 /Filter /FlateDecode >> stream xYYF~ׯ#c$땓5#D"edaoU)Q31 X}V]_q~#NsMXf %c.|rBɛɈe(C:mFG?l>ٛ%Y`B sg"M֣ҡY!8Qs2Yp LnFȮ2-ISa"BiÔp+j19a$TN5ZK!6GBE>M$Y(Mj"p8L7$崼#N)Eg:3+Vǖ`iO_Vk?q5 hz8U<0@.pu4}~guu17m*7Dž6Ro1ѷ8#`[-W 㯵7y qB0YWnGE;2{O Pvt z!qRLKIQc`p9A|5gX8Ӱzh,x70qE2` h@[M$G7\E 5k<[Nb /l|x[U2 <b*fAؘr{<:Om+O8je52i*yuPiCy" |dRoalC~_/ʳ<´YPƦ[6 N0/ƄTWw|E=T 0 ᚺ! &ON,xȻ1d̰k)ܽ5EOιG4ΤsJT< LRlͅu$`HLk=$GLL\9PLەw۰~U3q%,oc+u\}r!,Ő5т(wN3,<QP@IK8gA0x\-C1d.gq"_^W͐p*}r>rЙ=y9 &Lx R'P? pRCgM\n_ܤ7 + CW(/Yc=9k941ܨ4 #T ai?Ws()1VfgtP85P JXQXi)]xr,4 bPQC koD"jA$ :0 ꁚ=6+"-;+P‰2J+lhz{lpVo~QièSƂȃؔ;"qqΏ0ŭX9ݱ:ŲK3bLz,HZǭ&rxX6&lۂ0m.G0zԋ Qg|q:^svVSWHȼ,ex,p&-N+N19SdNA8!Q0~;B¡G`Ώji@~ UJCWGI<(o]DoYW责'T`^x밪n"Az%b5`f@8 ,J2D͠+U6u!-we"KXx S-` zi9 LG8_Aנp0 ^Qu8,|l`\ y`zD< _O([U19z>6s>qkۆŠ >? }sLޔ} 4ԿUZ 7pPE%næ/.U[$۾x|Jl嫛oy#oijDQ2AA oPj9z\X%t.\2`endstream endobj 150 0 obj << /Type /Page /Contents 151 0 R /Resources 149 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 145 0 R >> endobj 149 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F27 56 0 R /F23 16 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 154 0 obj << /Length 2858 /Filter /FlateDecode >> stream xrίqkF/yR'+ۇ!8$Q04-ݳ Roߚ^^~fNLPi{Qs׿f^J).y.o./L?9b歯6nX_~obv}!f/DcGJƨf t.~{@ҷ8MRVR E}WV5 bq5>n. BXsv0)->4`)KnMV[w~h6d O?n&!zvyK iyi*.;8:a^=u {]`^wu-@;l֦21xiIVQ,G{R@V CktR+uh [3!uHŶpΚX?d1!w î"A&ښcO2+dά nwlxg(Ѱwx6̇z3!!)pOIHhӾ冯GDV0씄F \RvV*0-nu N*Cfj~\eBe'c u1S"챚@̷%gի6݅\ e l{&noVS:q 1H:\<\ǹ#_oclD&_ DLCh寧 QPB믤TNScsq~#Y<}YZLFVd W _i+z[Ye#۳=m#V|N|L5;cG@?/}P|<(vWoQQٓPn$6 |xUnjkG{2IvIڍJAW"d屴-8L! 2 3X!SjIc/m3>:-8X% x%ЧYlSo r">}[)DO^i{wxA؊aϵ[0ig?8 5թ*C0<=IN H0~$uΖ-*2N6^ +"_uDY4|(Oc6E+`_Vl5zȁ9arq ]mß?=1KakԈ8ؒt6K^>03H{3T@Cّ_^G FFh9ULA, N0f۟q*% +1T?eLdaPemV~U,]\dRXo TtSO(?ˠ_rTY%$@/6͇'LTO++cZ:7X#}\]k6TTsUunJ@4ֽUIg(+ Ey׻c FźrD׎PuzQ)>iY(H` Dl2qo*Wp{:`)Zxv|;fF:F0; pW^8^N5Z󼤄XFXX_ali;ĖRHTXqTAM*)zC;=nNrBUQB|rNtt#MRB;fy~Z%D\Aq*vw} ԩI iӰN4D/RJ4|L[C~E{6ձ5lZG\B@}M-:6m]ɾahc0~k~{s22L#D)q49\2)NLEc+.sU9ľeNQ?ut)ܐVA1" xvdxDV#4Sc(!f.>S:}Zx|y[< ƮMM6򓥊2hMr>h+HDҕ db99h4C@c+ev#nqwga즱ϸD7f=cg27ܽoAu#+)!G9%2!\E(Q5$҉rTd֮lF.=2?6xX8{d~H˘_#Ri=ݻWRI^/ݻ9zWOv9hzX}yA!#=ʩȯc|ehwmQ\xqɯtC?zd(I?mFzt}=b(Pm%Sƞa5P)cٕ8+e 4D^CzAY =Q"Zl-)iҕVߗ+k}_/%` ;38M*EKaB1^?ހ[ZͶNgu̳w|㒵Ex_"~w_}O 'twhה~{TK-+j` +Bq?eMGya&G@$:Rfp2X # 62endstream endobj 153 0 obj << /Type /Page /Contents 154 0 R /Resources 152 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 145 0 R >> endobj 152 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 157 0 obj << /Length 2674 /Filter /FlateDecode >> stream xYs]oa'hVS$$r,,J}cD(U⾥}˓|R2yry(텑JB amSjEiuȌ1/O^D2)\!Jcd=Odu"'Rһ&Rj'7''$3Z`lU- =AtmnT8ev¸"@/\"z-@MCDXT c*B+1qVh' ϟ% xc_+> p8[|CFVGL\Q6 pBO*p{]TI D:^FJdT֙iХţp0v-+ZLP`^R1T쇌}rp/x?;_xRʀ0ރb !fp9ur6w8к` 0Qbp756,@Ms q ?MUQ?<0\ᣕ)Rkbz\guY.]~aeFyC)cew vendstream endobj 156 0 obj << /Type /Page /Contents 157 0 R /Resources 155 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 145 0 R >> endobj 155 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F27 56 0 R /F23 16 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 160 0 obj << /Length 2676 /Filter /FlateDecode >> stream xZIsW&x%XrrY)Ɂ"!  dHrޯݳ9rYKU83z^8uqvY0nPb-(b8Y]דJQzr<VPcQ8!u19h1?J0xqs H?ҩP5 yrpAV³x|:3ǁK>{ qIt,.j6JRYn&'sP4Nt8'qn>_z5mHTke*tpQQ1A#NnWmePcL*lJ1w(bmg]3p\L_M"~n Ǯm *s;`?vn/p3XzXy4;l9?7[B* [ܱMO+t82rFF wpN])eT2p@ h͈ V2Gт86cFTFԂO^Wׇͦ0*<O%*^%Ev]\HЛ`ሾ9qhy_R$_J~cGmOn8.LAݸrlYAV~ZZ3~F/9 tr>c{ǥ/YprM㈖pJk3Q$i9B~cdʹEiu ?)VP2@c*Yv@]܉r.mW-Hс1bZ-?8\].Gz9=="R4 pO ` y`|Zg=0[.9 tݻQwsZSI `pP"<#R$a0a3,:Ԥ H+M:(J} 0 dH)"x1FH""#ŏP0 Ӑrb5&l ,%Jrܠ V2\0G$cdrB|IFq;Au@bĻxQ\,6axHQ>|3D*7uKD,6^$4`)MEz[L⣲\YbVo3.neu&#(΅ffɏpJip QQiy#η7k,TZh˴o|(VCo<³t 9!NcK|ۮCoT*0M*HG~ۏL΃ly%"6^]4U;(u؛ O37n'@?9.<a{?>!ՇyR BQ @ 1\0IQZGՐ~V) j 8=l8\o {/4 M|(>`?<16A-1W.2-9 I5> p9ʸHPTq`Tmw7j K/u+ Ij nKP9rx #iB=#A*^Og0pGe ^E%AT}ͯ ~ fVM > endobj 158 0 obj << /Font << /F8 19 0 R /F24 22 0 R /F27 56 0 R /F23 16 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 163 0 obj << /Length 2861 /Filter /FlateDecode >> stream xZ[o8~ϯ0eeL]T:MqI3$8vjf~ )KcgQ1G9{ZZ%=NY}3 Up Hd,/+,a e`,@4V ܮq'ܵS‘  R&Êq8ڍC9Jϟβ4H9\N4jd]dM!R+WaXSBe NlMbi$T&9ö3%;GR{MФ4tv)Ҭ_x lmi^ ǻ{OT=RjE;dI҆ Js/@a>o fSuGg"l#˘ >Fnf󞸰`D䒉CQ(V̂pV tfWplD`+t`ts$>p \*.fE͹jɿk 7w {ʡ.Ql1 n $44*D]M>YKIb(9j?H/d MX1&W\ŠvN {Hu/krd@266 UדIFcd7']f ϻ6] Ph`ػ"WqHa|haqU!-P`XMW(XrS bb[}&ۼ*VO[,h,,O0;0'wH{błWti qRA'JmG@ $^7Rg"4[TjKS)\&L!ɾ>Zjܦ-/ އ<[}6Ҵlﱁ0 DٞQ* R01inKUK4EZ*-ozkJԩ1>`x xÊ^]}{vu.umנ|b8_Esu@Ǫ'' ۬mz_6I4IS5Leis ;PV͡{95Xf󑑜'&[:"NelipuM QLI%Q"%V;Bnr`M&HFt;%hd2- NSrCg[zL@5*Q}fV6QŌ3/d?le}VD0 !zg7D? &zgT7\(c(Dgvk^@o{k޸tm%$?jˑ~:N.H0Y(2>_¦<6U6\ywpk7g/P(>=!,iLMQ9X-Mcf9۹OM%e.OKMTW;LT:0Ri;ixZjç%t&IWp_i˭oIp&Os]"m* PCQ/WôJߖe54˳XF'Kdj턢1(+R| **0gB0[bh·t>)ʟ@tv—@aT{֦ڂ:n6iV! (Bu&/n (YqeZ9c2/ZH^S5[5<>BZeh?@ _ {p8_VfK0+zzZ3D^wq M@%(|b{^4aAY. Qj'8nqB *1#tA$l4syHn.@dH{,H}vѫ  S's 4*, DyAzo/|x|HVh*G%m /oͧ* oT9m_B p$K4󞃥~;EC?y Z@!"DiL RpMLЅ&=~$V Iʅ)~4m"Ukyߌ)43B0E4~}JS(v6," g~Y7ByRm$1 GKgxđ`֍yQ *+(<)`aK tASfw]m3kZu/H<vy bx۞c/Z eJ=V| xLÍKsfĈ< ;gw1`5=쩋k B|sET/ m^! ݣ/ɄY;7}V0%>Ϥ^0 1jC%+@ￇ Zendstream endobj 162 0 obj << /Type /Page /Contents 163 0 R /Resources 161 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 164 0 R >> endobj 161 0 obj << /Font << /F8 19 0 R /F24 22 0 R /F27 56 0 R /F23 16 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 167 0 obj << /Length 2343 /Filter /FlateDecode >> stream xY[s۶~ׯ[Dp'INv\KFmNeJx_vDɔ4>ьb/G߸gJ; ^3o!ӓ\Jˑs+mӻx6w#Δwf|/ nJ/>90~Dz+$.%֨ {Jdݺ~xs_Co x"_%+Ӈ>Y_+1m"zِf"}7UKmlUau5 uC&Ogk`6]C{1/p}Dq+7$ o\[ "|u~vo15Fq &$}p,ɀ}vebZ L$8W''/.2+~1ɵ,ڂ՗\eW/.w sr3\d,O_SVF߳ɣ'<3)}Ngyi6dǝ8LN#ӳӋ>#,)>3PO f9or'wU{W'`:Ի~Ҕ=wT犞͢4u9U ^6cr$W^{'vJr7šN-(VcI(풡&1O1/0P2WvȣK΁el{6`Z)u&>X6 c`సuo )m]] xߟ[8$z eGա-/DM[|;(-BZlD)|~괨g7B2A},89 w U۪~rƥ 0)VlSdBǸ/1(@bKDK'}¾+@h>0l#.O*MKu4jT$x])U"쟢@e|![г DV\m7 [a^*1NJI%10D2+VߨOaz fҥ*J(coXTŃq<0XjHF3;fM ZnSJoh)0v ` j." @zQۦEyBJJ H2򀭡4%Lˮ)X@pS dDh(4_)nJ煠iU[Cw,|4Tm+6A.9`y)Sh6%6AK=`^g#tuŎCp'G H-xtQZ$_mo! _'3W],r;EruIkjh.vlzE-_#(kB~ (̾FR$G) F %r| f>AȂ%_XD,(J@,xJރPY/lu5O)p 3%9xA10q|68*:tm:trPHSN*]N{+&}ITzf?NjT(N!T$< DTtSxJc'%'E:XoJ'O k#UOꕖ'`Б*CPhZF:>tBF z(uZdfL g`&iw.fm!4'{f[QB}gv-C5a%c08-X_5V5K'wduf)LD*^m',fM>_RHa#/)DKO+(>eD(ʒ/5Xfm"24N= 1;Mp+{,3]@#0x,mAg ,E6xo$ 82~nxh*'?yH>S-3jj=܊[HrYhJ)lOOo&NB58O%w _?)uEe3.UG̈́<+Z,&O' :a0Fe\]R:D-פ:sU}Cs Bvޖl^=#61}7Ao{E Y( 냓!Nn0z r pB,aATuX aC"`e&Ҙxsg\  p_wfMp"=pSØ272{Hf Xi2!#1|.CK@lY$o 1PB4^}oשf$6q~9T6'yQ| <.2PᆈP(Z!!0.xi&Ty%v;l7ezHendstream endobj 166 0 obj << /Type /Page /Contents 167 0 R /Resources 165 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 164 0 R >> endobj 165 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 170 0 obj << /Length 2495 /Filter /FlateDecode >> stream xڽr8]_G*3Bp`LzvQZ"_pt?PMU&jڒKb0hW |vgTZhX=V{°^a=N`gX}?_G5¤PSDZ RZM?P3+&':\j9o:Et|.@2&&*vF+0n +2"&)N*H僛p20w2!+xTeSEeճPeےXuE'n6;d-[nG._-M*VtU2,̋u#*2'IH(߅A(Z2c?/6CA U`[os zg)H]|[t)Ms&4&hz3{,d@2khA.8Q6*(m܌fS'Zc}l l{MԿ`oڌHwIS(;C1%9,A]0;l^v/ǝH T:6>XR_P[?*ڐ m/"]T&KAgsMtJoO[hXa* ϛu`v.~=[ǟj%yG~n1>ΟYsqG9 45ns4UX$h&D?*s(-!px0ȴj!Vy0& *,$bJ\HYE:6~ vg%l_ʽp8jmR{VDH{S2ܤ{Mq+FWϬi1wlǍV: )Ŵ7^\rq|OD{ρm> endobj 168 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 173 0 obj << /Length 2860 /Filter /FlateDecode >> stream x[[s۶~#F,$:mbv;g>0ck>O뻋A!Ն9 7'tSw3MgYF</ȴHnsy Gg2 5[}8~>!)׹=RÉ`؞\'YE,[)Q|K@E汞ds:*)XDex9K,5J}kYyJNwv69Icdߕˇܛ:x'A̟ٗHw¯6;.M0ITZfAh34S7o'"YF2{ĺ}fE,.` [IR gRV*U 7B1,B?,Dͦ6>@֒ؓu ̔i x?Vئwxf0-iTSt6!ib ͆I3@4?^\^\B gxƓkXҗ2Z-ۺ,֟l㦬?l'J9]슈N9+j-ɦ[/îW$OIH|2M%0@寧.^?{Y۞腭8 ٝjˏs=@1O AɄlD&j0 1Qm f 060o4ͿΝ~b YWҩALM`P#q*( LU ze*W>9l Y8`֏|s<}TJ%"' 9>Xx@b}[&oת>q PQڅ ~h6Lt(GPzwP.O_iDi,gT()8ku Hxjy~o2_K QD7d[ 2-Q(<,?9d~.5t_vBBG<9slly> 0<8P<Fx<W3ʠa(sC+>Mp`#kɷrfoP2;`|a\ cPؓw_d)$. {TۤjhN2m|ح˴/%R3| +71[v+{ߘb6V棙ŻXO;#6ǸգvpUt Z&G{N[.–g]1VKJz|'q.щ\tn"v;g h"SRgJ3 mԾqE@Aީn^OAA3F^E̞4PhcuIJk7a _o1ei&稻ǹv`@W!aNH:vK44X/q,fAO/1bñu<`2SW0**Ѣ d >`]%7>O8j<޲BWƆmؙHPh-q¨47`m5( `9q\/ER&8bޖL'_u'#}>,I1 #;^C0'r>>¹7qnGpeB~'xiO%*gYB o*Aw֘a*EP~=9'+uv8'O_{o4)mKG|yu>rYwn$}endstream endobj 172 0 obj << /Type /Page /Contents 173 0 R /Resources 171 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 164 0 R >> endobj 171 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 176 0 obj << /Length 1673 /Filter /FlateDecode >> stream xڭXnH+x$޸CY<9$A@QDDjHʎ~jiJ,'N2Сz~UדыKEț=Tzq$'ciet2^?饡XD^;%f{; N݂ [ҽ]Pk XD6^# ~(ۮh.kñ Aӱ RT~[KиIK Ա4`C#O-MQ,3'!@pbrK2\*H6[c [:tЙmlʺrc5bȷaN M`JCݙ`bӈm{kY`hS)(NEbɐpHe\"!hXړ`D5:Irj6T~r?ں ZIqAUĿEc<)oJ:Yș` [r߂&+T""SZ4|b EÑ8dCp낎fqX_<䬽 ˳ Q2וC6C 1.3tM\ih| n3dS!M[fZ“FFJӗ? MCnĶ7cdSh;Q*Gex/1{}%h28x< QO=Wë9:#|eOŲ$VWӘT OYhwt!ET /CB|oMʺbßC+ZI$BEA*('ꯘQA8h/x?L(B&@%lo)\bHQ'~V%^oA He U Er\x 1]r{8l)(Z)D"6V **GF, zƳ oH+ZLڎ WX8ECNbH0N0gM+DGrH5xm3A2d= 76EGd~:VfU8ml}:2rߋ3{i_ (+86PhC'tHN,*MCEOCjݦp!b_Aדӫ7G!O98VMyѼ+0͢dև1/;f^ޟq{ l]s!Zo%3O볟gҦ.:UOC_@L} GB ^xP%@bփH!DddXj>@ݗ7ق2 KM7jGciaV7Ϟ>u/^`yX fF JʈJ =|5" CA]` ;-= GtUF8:M_šendstream endobj 175 0 obj << /Type /Page /Contents 176 0 R /Resources 174 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 164 0 R >> endobj 174 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 179 0 obj << /Length 2714 /Filter /FlateDecode >> stream x[Ms8WHլ|̜[qXYYNf*"6+d%Tՠ\[ )l>5ɫjLR9U #tK‡#ӌ'pKN?^ ޝg'd?2 )N|Ń ;eJ H X\iCG V!,3IʧbHxid'jT"L,}7W;,|*L!t! iݪXLVI;۹ݘǓm(u}vϷz7w\CeBD8Ͽ1I[4sVo>^}c sPmayФ}!4{EU}g8>H\:}DB7x}sv6nDP^=ԊK#ZEe1>ֵ%#0̈́k߼}ủƬv^jޣҌ*&%L3DiF$Mh4~X7iHoIjΰ KYr_{{dgOb5_U,Owț<:YTy|gm}I2n5Z ~d Lv !S45z2/>^^ )0>Bs0ge^*o) KEzIh1YT\8׭o~zX6$8O֖<ۮ?BIOPv pCLvi D4&zM{5 fn^!̏-X?spE#ָ l^/$n̍HfJ5UfYߚh[s~*JcJFBۼt'mn[qQ|[p!6텨 *P:W&&˫>*~?~BLj_(hC~Xx5}LT`zto>t2=F'p94iw۾* `dsZ$X &OEQ#Ac:!(1CbQ=o':xv+H3QTm@< .KAk =?7jTFs|~Sjy.rcŕTm0dW] Y/4KeL&8>=C}&~7Jt|z~D#pf7é;Q^e(EyH*-h GARc'}UqT^jTc9߉S>@Xkw"|~L{X~vܝݓ&upz,m;` .i-Vw>`[(ZZ{/bDhC~X$Dx3<ȨY샨3M&ESUx>Bhbل⟇%P WͥJ.+N4 6XuWbZjrwJzI"ۨ׏|r/VCW1k,G`Ca D-,Bd m;9Rkq̌ۇ  MO^ p^P~endstream endobj 178 0 obj << /Type /Page /Contents 179 0 R /Resources 177 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 164 0 R >> endobj 177 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 182 0 obj << /Length 2815 /Filter /FlateDecode >> stream xZ[sJ~\J#Bg)p^8<(p$ˌ,JbHt}'/ߺiJS\E.Y&`l-2X,7U9ɧNޜOT?94YkNדO}DLDNoE$2zb/ɗɿ::1^#z$t"RO3)Q32J\r8-YmU]mJ%F ۛ)!Y O~_aV?y ÿub\D`~s]VHMFInQgNGMYb#b/IBuɣ0Z\#~nxtxW0{Pb^~nx;l;a{|qsyY6(+:lpTwDi'V0l-]+ ]!%Iǂ;Ov8\~ֿ#Uݔ%8r5$T'׉NcŸO]@Ke]"Tv'm h>ԲJZ~9֨2ň0}Y_ L_V{C i^ 2"P zY~ %lШUFE]`|Ԗp Bes. 9PE-r +ϲ7ƚv;CC-a{{~B5rGǩQab(\e9 \~sC꧷Vl*voa%ߓ=WHOǪKӥb'E[SS7*0p~ R9\@dCX=̒X]n#, aͶ0l |QEC\b#U~1M@&v=̤& K}j,e6u #DI#)K;}$\ ybsaI$YgHǰc9X.@T \ZdʍVp$ "oWDgRrEH0*pε 4A1k$+C量cmYD>O[O޶BVm+ t i+qj82d:M/? 9x+g!uyr!P$ǚ AdxWԳ3A K eTHr=l |Bo]lJ&@[ $FvEHoY-LbNY;BIuH3Z3|rR{] 9 2?5G^/~^{ĐrC,r!y'xȼC;Ξ8J޾p3ۡ کF+v [8vrUcnCUm)mŪ||\sր6:>FtF쑆Fj D(qM e$̷X k| }B׽BNUMaLQ\3n t_;KrVc7%󅖂# QFěŅpŸ׋?ikSi-D+O1ɰ>?xbq#N!UuRxSu65׈ܧ(cM ^ngHt={%V hnr OR~y!"wͫ/?/ *5!i-6aB,4i ORקT.Jt;tS%endstream endobj 181 0 obj << /Type /Page /Contents 182 0 R /Resources 180 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 183 0 R >> endobj 180 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 186 0 obj << /Length 2594 /Filter /FlateDecode >> stream xZKs8WHՄS5l2㱳céhYt RD[{J @ѯדQ2+hr3331r3an!Thdr[STrףɑq'F9XMWG>|zęʼ},Ց<:{G'BikVeZT[7X$H拺)?Liy޻8BXӱm.e\py8' ʛvkZ89$!pɿj6Ne9-hqs TX\H`1"yTEsW5}A-N`x5 hw\M`7{qmև bGpY&)3Su8 -k9z)*d,âl>*\y&m,izZ)TŦ*( V庌\ě8w\qחE9 g72 ?pW #y~ݾ* mY^? {C}I]؞rIbJ9.'K!=qALUff?CVFy*83t@N_h8zcDT`,bn_YsI!+f]53 & 0 EǾΞf{( ̘|Bp Y'g+ `]@Dw+=EHZ:!ۏ" rj-RPfdI?7H( Ey|.J:xHW֠w ϧЎ;# 0l7LҮCe8(XD]ԃ2d6V~`YA0SBw1oDIߒFm!5n<=)[C,OwQZ^UQLi]k,[ ZqtlΒw_7F(#8)*]o$Z7UN2GLٮoEjufqK.h={B [YE%iHkE2U+NoZzPSҥT&GrݯӢLj"'ߗ 1ݳ6ʅlhcz%mȱ'L*o PsY aVPc%ںKb>v걷]5MaB%LPszA2Bs$ƙwLZi@[ f{r]Lǜwx(>#$P@J{&ll)>&l󳋿M t DlsҟɄ_ʾ5m<hZ~1 zǏעN[&1u`m0#YRy_ U3_{LZ _/=ɐp3CPO+~^8uV}X>C"!4Qe"G ӌ@k^`iZ`{X1fHm ftm~}+׽UgtO;{K;ؘmf!䧟Z"fY$SF!"Y`941 ekhP*dT(qoQendstream endobj 185 0 obj << /Type /Page /Contents 186 0 R /Resources 184 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 183 0 R >> endobj 184 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 189 0 obj << /Length 2573 /Filter /FlateDecode >> stream xڽYKs8WḦ́$d+&l%#іj$+v炙PDصf?>?z/8r')DRY sodBNj)'?=? "q<)Ly2]w̎x3In3LVGZ<:;o''\1u@)h( &WΤ[D沉wZ> f! 1S .sqLjL%B0g$dD$Wr7 q6%қi]/eɓWAb>­ZBPց~xVd9?-Wmf9.4L E=6mh + l-_jYU殞WL®?>ޟ9 N0.K,(Bjrƃ.X!yLFJ欵Iu׻C9 խB{ޕ 4^Vޘw PsLTG͂']@("Ad5E'4(p6"dϜO˪Ry'!5khoބps-`.Q#xșVAXHDžaV"bSM 412QA-&PzѬ`V,r!H*|Q_|NUCLK*s.R#G0bsɍK<4D01Z7xj}A ̇i1.oH &(MRSq>97Ĭ/r/75ǗP-UV͵. 4=ͪlXm') 9U3;I6)MԒJIHȤ`#,z-P!=>ݗvu=f4q 5̃L!>(otqǘ`U-5 "Oh̶"ŴZlk^+ k-X Ex(dq ;5XlTL1Y$IIE13eIv9,fçtoM P_ ܟ <(ׁYcx"Mh K nl%Fbq!rsȷ%ܙ$fa#Ƿ1'  93: p  ;R{`s/_=&lqWٿuEϼ ??EIa,Ir5;R6k ܗ ʹ//kr'b@Ցqk-oZU/ʶѬg~NgHr%3._ֿ ?pKU=+0MUD7HbV*(4^ˠc T 2 6?5DhExa*dDӪO+Oi21\Z?3 h ct2B<$3B5y8 r1-["h[şp(ZlaY4~p~-hOfTxU Mr.6+ʕ]AY \ ҌaҷӦb:mE0n-PbpBb C KѶ>׋MH۹6y;S&3ߵJ v5KA`~@4cYWiB yÿB,]WG"8GB }@̏Xh.Y&L"p +l0~KRjh_ʰ"npܽwrӼ@.1]□e\X|.2V8^Ϋeջs5Vj E ZG\MG˦ZZ:\6nPW !0 \-ho|~>Gh#M"5Fe7wEzWMyhe3*%>r7T۳т 3Z!]/:t1\3mV_)CQ7'@ٹ9\O;tAUry7ܳd a+鉼4qy6_4}ߟq=5bV?Y(!5 X |w|hyJy0q8(G&<71=Ux!n i<цnB n %..܅xFEnp>;?`@|jvp@GCBѡ}0Zh.6c܃3ޝN~8^*$w =e, zҼ;M];d : x t._?Y8y{}ʝqg~Gw@rѝvW%)}L8d67GAի/.S:O2 };%n5dHlrh((;!ɖ;5덞endstream endobj 188 0 obj << /Type /Page /Contents 189 0 R /Resources 187 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 183 0 R >> endobj 187 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F20 13 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 192 0 obj << /Length 2531 /Filter /FlateDecode >> stream xڽZrH}WQ _I<OMoLV&\IY)/)ۓ_Me+eVٍ> (^^>F՘ KZ;_'jqe\,rrr~6vr gcm2?x>bG,#|a9^oGJe9+W7 q+!sf ΧRL]S>i @Xh"wy׽4%s)Sd0OtWlY.p5feQ_U}[ViMTdxE= `g Syڇ4|Rކ^c&%<`(}0ÿ ϛ8g x\ӷUM S$,ͧ5brv0Q/zQ$S֤!r ?s/WΎ99NV`֑HN&͝7]|~~s4!* H)׃xytױ΅IzCh܌{C{l223ddxkz0`'k$BqEM[7I̺"k Wn6o^@րe$>R1frYO,py[DKյɭ2о! ows}>(B6d16\Pa^$1`a6;?ab#h9X>=6W )%K* Iadw uۇ/Dgn!h9\$xbյ] ޶Ӟ/Tal%>{(LKp}tE}XD' lxDLM拿WUr9,+&9x<bs 4'Mnb#zvrMpbW!v^.\c. +mwE#J* 'Npj.W€8hh;'cׅbve2*=a˹C3& B Cё*m\\Å`OCv<%\bѳW$-g 2ӊ3t6^%܌5.6\k@rG7rW], 2$7]Rҍnt (t ey 1 D[ ]{;JeÎhz2O!1.5˜D(2kd\Yދ|{jgJ+F+ &S 3m9V=RsՀL?"T`^6!k>"l›l"qfzIazT1@ i!(VnJ]m˂TyACnKLNXOqw4TQ8nS*e?z~cP; Tf)B"D)\\`>d쏄9M{8I#s%(2vAC[`AshaINSP1Aԉ65%6\DƱ%1X)G6?*Fuhʬza!bœ9hS?ބ H}-ݓHsB4$$ ׋ ^4O &6Vvg.V,Dr:} [01p;p8Nzd̴!YɋK$1(Yh 4@.s="$9ځ{/}{zq1&7椈MV ?]"0g<8Dd!YȢ^~hgM z1& C{؃Fb^9l$>2q3s,ty]/tg<F Ptc F yh? u(aChiXe;V4(NnqZctuP> X5sNWiϸnicw~re0FdH }N?|}l9z6vgpXAY5Q&u%'|ߟgep뚢r{u 6T )jPc_DRӃ5h.!ǚ<2 E?GIasDlr>ShxORH m ).2Amp]3aK'<ϟI!__ѷ2>%8[t&S/Js&6|(yE:Pwh@qߕNjhzT> endobj 190 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 195 0 obj << /Length 1632 /Filter /FlateDecode >> stream xY[s8~ϯXo@a[ KR&CmHc5]LmKGt.Αl<{i#G:DP"c(ڦb9L4NY6LwW((C:>}t@WJ*Js<:H.`4I(i"=F BayD6L8s4CnhhF1 !ǫ|X .5> Slim-[ EQ*sxO =G3|EȦ%e78k5&dǠjb5Xeփ4ŠYP-6}8F&J#N)ED6@@? 4{{<oߌ``q6GГr(--BxD(vZ2{yԲ-e0xvsqr,|^gˢlhud1 ߗI %BxU#IwiQKI`QN$Jop@fDx<#pքk*vYT%J9BL](f6g]OS^ D!z/=AtR j,DŪ<$qhe5Q$1iB$LՖo&ƥZ<ÆUMeP= v[f9G= | ھ!yy:&mZ}%Z7?*z-6| d\j>@IНdHGK+(Ll*l/{-^β<Xr3=9G "+^9bf}b*gDj%雚ŃHSlmCZbrpTLG:b H4!;"4 +HݪOR}>ᾜdckv}.xFC$_w\,QHj?pd]#&MȮJCL+=9?Ƹo*]H"mԵ7]e%#RIV*J 항&dWY\0n3q}BXL!~mOeuX8 s2>$ m2XԲd(~Sfvyo*H_*uBޒ-84V:U 1;r VMu;` 1iBv#T{ٝX 6x϶=9I4x iI,>kՖܥ Ԯ5I H)B u(JĤ UVYBsw(O{- &ĵSA~$dH ràBkgB8I-#4ְBL8 pt-ut஼ G0c XZ/WI''6oy0^!;JUBØ-IGW8>B?=Y7> endobj 193 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 198 0 obj << /Length 1886 /Filter /FlateDecode >> stream xXo6_GX~JҦ]۵i7'ŀɓtw#e)Ut-0`>c.yr!2ŝH3kzy&ttzR*=y|L$DxR9dy=k=OV3q5GpN&3-U-fr2 %=Bₙ(Ůt h.MS% bVE{ػgƘV &Yϝ A+p4E54.ei% P@)[)/z^7X {UUe`U~7 ~W x?uU̫dJM`4׻-ca60dTp0\_)rK!sr4Әna9r:1Ni8f +Ld?dߧZbJr6 |~q QFkS qͰ5V.Nܱ"Xߣ%s; E>v4,簽B{ 4Vd3t͊!+@nqVXO`~u*t IJ}ژg(/~{yĿ]Vi/(|#wӳ/J|ΗC T.Lc?|s{Pg!VEx0j|]ӦuEl}m-1~ֆk47v:B2Ji@̎\_2;&φiǑ~V8qqw5H̆"'l9{<5}::=o%)2_S7fzcrh2iD͔`4\{61v1c D01d$! 8/ii'@4Dv_u8nCLp#zCK f+ Fy^2eqO5T\\1d!M@\m5jgE()@CIֹ ;Iw&OHMmՄ( 8˵+I9 Ӹcfnka),K' U)<< 7/>~&+KL__CӀբkWQ×y@WZD-#,f޷屖Adޣp6K9“^PPgMtkp# e._/gSaڷz?\HtU+==(KR`K݄iKGȦnހL9n9otQ7=Q&n ^$2*/;g?,Q+O1s94 kxgR4% ޒO#mS7-Rnp_j'<~m6.]B>~mPPH[@C\HML^kȇ}V0Hp4)qeU I˹'y/@79OtAsV64\%1ҨU Ws4!঒Ơʫ9y|UE/TmVy5;1i-x? N,zk~zpY)o<ϖ ~iICV" @A1a49 cJ%97*Oendstream endobj 197 0 obj << /Type /Page /Contents 198 0 R /Resources 196 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 183 0 R >> endobj 196 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 201 0 obj << /Length 2646 /Filter /FlateDecode >> stream xڽZ[s۶~#FNԱ}";sΤy`$TTvqE$wd& [3HH= 7DЄ c`n9q"Y6 !ᗻ'w'l@$t$B_`zBO(QgA K>x:\*=#P4jj 1t oZ #bQ),ѧato2+81I֨PyA{X0MG̚aVto¼xu NXuǗf*1cX_*T *ȣk(έk<{< cq\+d=+)* Ď75x~fE&.99% gEP!g>$+7bu DSuN$I O ~F`aJ>u;W˺V +Υs'? 5ںl5Va'VL=zUS{U+:0xU 1fUG`j=xí4a>3%TFiD&j+,#G^'voV5V/iաy3K։3ѐ`݊NM1ؤgP8 %Gu3 :[}}u//!v})H,bӧ7Tr v{Xa7ݼ Bk#ȠH Tm.>|߾ROe{%< TME8weStrJAH Ox "R탘 7y7oc'<6]ĦPIc%1 aA1 `~:`h a*W =οcfؕJ`F|ne?xv~ pw9Em[얨v:V6;'kIG pjצ ()+^Mw#BhvԾVv&ᆭw:Aa}@u\6f7Yq_SZ@哽0o)k6,Z, d{͆A,i~@qu,`VxJ7*KBO3"| P,΀@[C h|$Z״h]'خ, 1ЇϦ3eاߧ,:Jlxb8\k[|wUdX8F؏1rq48S88ttdb\B`|:~R0Jb8kkCIuCҐxE6.0voA҂.=h 'F~n9~Vt<0a1M}蠢6O1 jX(i-`*_cHsL2pr1.7S|FuSRExϬM-pT;m-C\zJz%SuVǰ}$!FQ߆0do`#Tn[|[ƺ*Aei6qjo-Zk:Am2zntg4RųT>c@1; Ӑ>`.6:Xzi E5 w,W+94sxO"=c!,io濯OR]աJ:R6O]% 46|o&%~6啍\R'1a{7h Ă&nZRh>V!1ജ6.?f @V=̭hbo~5$ccBx3TT޼~/d#;3{O XeG(x.S}+x_S# aendstream endobj 200 0 obj << /Type /Page /Contents 201 0 R /Resources 199 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 202 0 R >> endobj 199 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 205 0 obj << /Length 2445 /Filter /FlateDecode >> stream xڽYr8}WD$򦉓J%5S<0c"Rr&h"-nT[$lt_x sVS܉Are06HzV GJd|n1'R2LN>'|323?8݉*X\3A#ނĭb]*7P$K$_FD*ɲ4s5J<_вVTqxIJ/%k/h*VUQ1ΒAdI09 c{Xԏ6 W0g (I4_\=GҀLi)O )&T&1]#qIlCS0k϶;#;bZgF LyU?,BÑE[j8)q)L;]H:]&^<L& XYiF %MҥG$M[i=MlH`$MOw;0bl/eQ>wtj [-!y9]kɼe& n@{v)SaȤY  )4Lc| L:&["{\G`n4̆m7g\X'Z\"MQLZW}D~1~+JЖ O=2(@2CnY`9?|2|(o|q OlGe0a^/v)-F w!L6<L+QLI@OO<r9+Ͳ`YXVV=8nuTH!>+qL.ԍb 0M}L)wo3`r=oE>Ͳ}x0fǛov@jŔ } 5tA~x埏`۬$M- zϋXTEmA]Akf.[5|]ՕC{!ՃtZzq,$-b$ďغM}@v9qbǸltP֪uB c{Mփi7q<񁦯x k\ކEu1(>` p%-4Ͽ.#[U<@Wo|GK1wȰ#IX|#L`4Zm\I_#sQɿ{}+b3!*)/:Cpk*җ^$ Lu]kU3B$,XmQvQ m5Vb{˃{EtVf7i+|'#"we1TvӾ"IN[ [k5Xm{)+i{!+;}o+pfVLIw e~}|6jIP Gji.wD2[,~ & A#m(z&?qtFO47mbEӏ~-> endobj 203 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 208 0 obj << /Length 2773 /Filter /FlateDecode >> stream xڽZr8}W葚"_=gKj2yH*YJt2ƅUUtSÎqݗJ٧Ls&c1΅#6F2 Gӧ}LG#:zDpVJs|t$H_GGn`(Z1$> B bYl>&s^?-BS;_5ҧrQú",aTANjb]V{*tX>lDPb'Kcj>o!e ,SI=?)3S-1__^oHPC{ LX5ɰ]h*Gmdx DJk0Yi,x?4ь˸oǹ<aח㜛A.E3w @D>a ;6|)Zfrň҆h ~@wLncz2};];~0-ӷlޅy}|s%C&L1Pon,xT3|/jFpoFqx& ':?uC BSmj*z aJec0Vej0g44=:`tyYjͺz*5l4j ̆ZHZbNzCC{nq栱crHvxl=vH)Кd T>gnZ$l:;_=ڟHY3^ZzQU* yN;IOr]d]Scݲ~:6/~V 2p@s8q#Szk<uS/[Q} :GmӛE X۾ijzwK^Ji΀Nn:jъ 'L_ [EJt*@'0г @}`^,V~G Kj^i!>zMm"y B%wVm_~3xjU1@aB//6S8KAip\S{q >D5[>?ݢۗj3{|kij=UvASʈ/ym UhDt.־[]ؽJa4>]v{/lXP>I#ahݤe YtW0~6=XajQD~6M˪VdFf@)Z:b1wPj:uHR>ME# >ҿg$Y ) _r Hy&a%du~ 6ce`\Fֶt 2I(G ۇ6C׻kevmBMk+ϕ? TĻ56;Ǜ.Cm.64^zH1f_Cb59^BXBzѻ!C)'n|E=DA94"+ @6t_Jx[=MGޟ#\xX5-ņ59M0.ĸ2;χBnq Oc1)41`nW!j\x`ř/Ȼb2+V8SF]M9lt:CZbw6&yRjt=~)o©#T% vWJb6Łr *zu`JcPgE6zHp]WWh37 E*8dXvBX/F^Zgxr(iMWis¬u(OS%})x t֩7ٺj#~V-'͋p\oaha !VQ{M5o&dIX[O;q9Ő^K> endobj 206 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 211 0 obj << /Length 2958 /Filter /FlateDecode >> stream xڽZ]s۶}УF(I͵s7;NUb,MdR],Ա`qv_O~~sV)S܉Ap6}Gcl4VJ Oo/G?\ܟb 1 sJ䯓?>p\jg99x:R˓v`hܶ+b H|T[Y_fp\1)]rDҴM Mm7i&4׿^]o40}0ktj  a99-ʊᢤ;yQ70{v)f=0#k;0/~<;@Ei%Dγo=@8mZYib[|>P̲o?(FM0Gdz.n{~4 wG0}7̚mN?n3TZ&Hv0.E]Fޏ mV0\4רT:hqXd;]KTmJ\)Ȇ9׵NͰXWS,UkSD0Vkdg6Fr;BȄ%.9^2+Bn{"6b7:B<߼S#kͧ6M*;g`kiŬo^T`h HN3JץtEYQi*br*WUnYͱYf5"g= t,drvni&SV|i݅n-ŗco5oڦ!Lho-mb8[PDf,F$wF8;ԫoZS*ѱ!BGDP=%;ϏUv0 et)K@aD7^|^qC=7^<ź)T0X3, ',lUS%gN)\ZLQ>xMf0_3e%HفF~´SM a? 5/}Ѷh.y_XvûE l8YI]?P^$~4=x$g5_~e-*sdҦ=RRN[mul9Tm[r _zy?eRMh @e(D:-y&=f狰S0lЭ;#S 9*uy aica|v 5*zMhlh3oKE6FE,&{fM@t'=Ѓ,1Q-0 7CS Iq>cBr< LLgE^-bPKNTi|\+(kt Bמ{xU_m7ZY麛B$>Y=ʾ RäY !pc aJ [m4^hq6B tUJ4FF>8}Mء֐롖ǥh{ܜ|OT_7%,6'@kGW4-qxgAbs6%ҩfl2u">T/+pJxs yroO)E wOeEyhb2cĈqzdO7}BD)%H.`JPӯdo?}Θx7U꫻ `@= Ia48n[ܮ wSH5nնjQvW4]ͱte0# aE|c*?^]CjÄUq/"#9*3FW~#Hf\OFPNC1 rgȋN^M}<_G[aw=B`9=QW#L \M_݃7g?Ux8@xs4T~g,z lr+ X]B!V= Y9U&pE[>-o)١I %endstream endobj 210 0 obj << /Type /Page /Contents 211 0 R /Resources 209 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 202 0 R >> endobj 209 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 214 0 obj << /Length 2721 /Filter /FlateDecode >> stream xڽZ[SH~WQw~ɛH6@j2yplb$0=/l\)j}}&ys94׽=-Ա1X c/4Nf7i ȆWg7NoX93'{+Mh%Y{0xHr~,UASҟf Q\>*>rhet6Z# o22 NkԊQ& y.+2 .ʏesu.ן̊a8΋Ţ]d.#N)PSI=(3Kg&bZHUPC{M&,tASd0`Q[?1ndHi&2M^^_wC͸~Hfp8"s=>"8uOA;xW1Ι;2|xIi %6pI4մ94;&Ҵ]|lTXޜ0]0st iGBdt'ZY6_+yQ3@{B)< 﩯ioFEpb)a8F92YL!(BHqH7Dn{X};M;~05ݷìބy|@Xfa7"e0:[tMJCqkH%`(dFH670Ivq Cz%Ed{C6i;~05۷Y};̊M'ώpDS|2}=9'*֠9h iحAs)dw'ӧg@)0DM[^Mؾ`b{ .f0[07Y5GkIs,eˎ- Fx;,,YD[IYxX|j܇GI~> ]XTP\Ong/Ga \3؞.?:2>ƿ8j NVCۉf:(D厊j.n;`ķtᘒ < Tix|OR29[gsIZ+${=Pg ܵ\0IB!#zjb'0ѳwta7ug^6k9 K*"U{zYG}96Z o jrbY7y =, AaBG#N{\S^Zg'#lRx{ӫOts,ô2ݛp&]Āgc TTJ qfE.@9=\UTiVXޱRV*clsfoGE8?Qo|-~NCڨjVVe6DAR̫P?A\6hH {@„h iT.F_y%Ԧw~~JӰϑc=,QJՙ!\e8O.=Dx3T>}E2~l|2 $bǛ$'LɠuTCΔK#9`endstream endobj 213 0 obj << /Type /Page /Contents 214 0 R /Resources 212 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 202 0 R >> endobj 212 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 217 0 obj << /Length 2781 /Filter /FlateDecode >> stream xڽZYs8~#! c;cc;U[<(c"7~qiIVRS f`UL n (3N16 mEr G|l:R˅L>-Lǣpk~ZGc~tsJĈ_bJro~8&ccx>> I~gC3|X`NJ˗IVY#fy_OpL_fd8R&7YxS#dé !%"\d1ayxL ~EKN 0n|5f4r0X)VΞp0Ib贀?R%:*gsj܇}75n6e:@prY%`q-0 +čH(2w$4W1we6/gjӨ+Wz:HaJ908[(Dͪ"W:%L5bE e$pmJ|CןnϺPHB;A+`%ZrtF7>Q4|Z^w=M4_g[*7*v:^x<ɾ Xd"[5xq_ gE nӄ9z-\*Z<8CHU+gjIGسx* haW8j2Hˈr"%HV榇(D;y.\r)= w:NbfnzwxOzH3 L80iksH4Dn#M춃4Xf;4M_?v`J\XaF`J@Ǘz4>Ikjsяy%++f4=- EqS2ɽ,oЬ baatAwv ){C6n;~05ݷY};̊Mw?uQ\ 0#_Fc~f}(ѩ2?n !!F/I`98qcv Qd{SWݶp+퇃Y}ӳ/'{.Q>͞N/{hΈ06hB{v+gno#њ{OE@2%R}H7Dnc{춃X};M;~05۷ìބy}R ):;\Vժg pK1O}座 +QDIM57-=t%5 &C|~F/&!u+ea}/PAkCx8ؤ = ” kd:nq%[s7x=MUz'y(' nit*llUn\F8 ^;VSq١*7GEo\a0J]Ie4,YVH9.G0.S\kHs< 4E`7\QO;$4dT/”܍a.IT=8KXC!;8Bs?)ͅXT |Z[![u JJqA O#4](OAbx#& 9`j0>:{rg9n75 &F*ՠ,l ` V^^si}) o:.%8Uw!!"B [F&(I_U w=I,oW{N~LcT~K_zt;uՈ:Dȫ%16.c^J]QSddD+0[U/@q"\& Û>[Ob<{~9/*2tt^I?{]Snúo|kb6^]bXm*za:  ּiQ)4adW\r~Vo}_vxH0TZ"%Ҽ,K@(~HXE*Ix~=U %ϳGTql-{zuqC =r[?d&t.SdfL ú . Pyfi##JTbkendstream endobj 216 0 obj << /Type /Page /Contents 217 0 R /Resources 215 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 202 0 R >> endobj 215 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 220 0 obj << /Length 2173 /Filter /FlateDecode >> stream xZ[s۶~ׯ#՚%q;ucLg>0mqbS*E_ )ҎcLg΄ |.v݅l84y¸%:Cз#Idz*"}dٛg3P%&Fj쏿h͌JnOfrv:(#=&eD% B~7՜t(66Mpǀ$ M(VF|1W0-̤9NLnlqJ1?e * kdښsumBg^Ne[TmhacvY\$tMs|*?w70,tY. mpu=T7e CDMعfĢ3DMz phZVsGͫo`>ĨǘwXLjpE*#ΟT')@*@\`R BXt#Fá?W9q{ܵCErJ "wP_j ZI۹[DnK}B/7 :гS 6q44{$Ӣ99>/[S3h!u| bևp8¸5X*)G!?k4ӢG"%Ts$`ߛ(d9̐R=1C(enaq<> d^؄fT (v?Fi g,q &5yyU,F8f˼Fvi&vG3xh ![`RܵQ0nK)CiV9xr"-À|8yzkc| whT5odU FF? on#k%|h:mwcv" JF}Qxt1<*pW{œ㻵?XZx8Á^ URf;ZĬ9&&a-6^`>WQooAq h 1Fmz K4bs@Ms|)Ec|FbWc* (R&=7]@dOXW'ƿUj]k,Y&/ ^Xyݔ 4+eN@ X""L AA'2}y M&y6%R^fYc.*cwqYws|qՇ=f}ı9ne'\tfk)r֓Gz/ǔw6! =$㭐rdžtF%졤u rZiyiwfCOT8kø/So~&)U ŠSUS%pzדmUܢWE oO HYj8[ك%f}ĉ[ &ߍ] < F:+fATP\(T`` ji>X/!-KmEȳ-nNԩR! F.㰇/KEb x>lsX?4]\7كhþ?ঢsh(ǡ3l/C"/bBeHz.P&1B9<{>U#Z2[xS)\sweG\:C :pʋYrJ T&c%SNe`(/s+Rv|Lv}f.D~:e(PBoi@M.a 넊BEWn;bvƀ.-WmJ[ez28H=__X>0_#_|_oCY{.Q׾Hh LjpMp,z]Ȇ85$l[CIAJNcrL?t'ㅨc?tYrL/lA b[Чі8ЛKʖK1A.Q(d e=G*B,}1HD G5٪502\B|?z]dx9mŒfRt܄ړPхh@/tAkGuPBRRʼn;*aJ%A*ZGl9Y%tendstream endobj 219 0 obj << /Type /Page /Contents 220 0 R /Resources 218 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 221 0 R >> endobj 218 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 224 0 obj << /Length 2061 /Filter /FlateDecode >> stream xYKFWH%v{c^|Jrh8#"L﷪IȖ0buuu}_UofW?Nf Xb %ïfL'2fB&,G qBd9w~ zr н|d<#sM C.e՘U\pA wۇp{%1<`blC"ɷ8~D lP u΢["Q񜇉9GxYVMlKcaST00QyȿPHZRP;AIdc.#(J_6s4źA1j*1% 4/Π98cac- 3TԘUd(N hOS+] Vǡo UB}[UGC8[8UTO% 2lJkbWmh.smLۣaՇ9#vRKaZрqpExvyz aZ2CEWzݎk1o8y& @YthSӣA0B<{݇.ӏrі4}Y 99>f1uCr]oVy3T)OZFd(H7]׶ݝ$jF0.gVcWy̌Z. .JB/~ m j*GdM4|7Ɋ0T2F'Cee.aYzV(@|x7@0YĐEZ#^[*a"m wQG#]m–1)VWĈ W]ݙ4N8N!?[3 DeDvluN2 aМAѱH-KhSR Hږ̞uH,"T=Х ؿ]Igھ/c]#hĐig1MXjɢ(Gok<,O.6f%~"+" XXHOyy؁3w6G]w oUu`K;w/5|0o8=WLc 갫Q˾FeYO[B(-8(&%3!Ҹٲ=SnOûmbDxsKю.2R^m$B}|-> endobj 222 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 227 0 obj << /Length 2907 /Filter /FlateDecode >> stream xڽZ[s۶~УԖ ęqc'3gr K92Pݜ_v-'gLo/XכW僂Vׁ9S8s~Q&+eJϛw'7'bO >pƱBi;<|;'LO g~p&BNTD2%q.&\2R'Ȯ:vtIeSaX+nWAI_ Tim2Ca$+8p&Ae f ^p/9 4gVLN]Kx%Xams;vd6^#+7LpKOzq BL 1~]N ='LXPon(N/.)Oդܔ9X>e!~eb&#-sRގlB5A>EAhL $X L˺! 9e8Or\z#og%I&4 z)@1 2DI@B;Ҹ3kx\La? 81B2Wf&p$CAI:D`A;głȂHBoĢ&8dd`>KEآ2Ĩ#*|pNN̲Z0`EaGr5&̿&ݓע@O/F~ɇO{5Ǟs?%^8aAVmg2&L,7Mo&Z2 ])JHb3 pH75-AΦHՁI\i?h:$ Auд{ZcN ԁHk|~ "j%p+Gxox`Z |!QWS˨=^,REPUp?}ͦd<z3T*&=80rm˅V $9sܞe0y\A`b&}`RX<>8 FHqF1N_|pɫJXkW ^~<ͶOРD @q< L]j@c|AvhO#Dr 8 ;L!DB]kn3sB3Hp:Q@?I?݂!?ϒ)~$_U<Вf6>ܳd G4 ]h A6O`slF4D:l=<ڂb mecR |X<2 ?1H8Dž c?ed3G 3-A\#~7 m"hl̈́6WOoc^Z&$ΫUx5=A`IxH4kҝ/nǀ~==A(8?-| ËD s):>YRL c 4Xm>Hx=-'Hƌmlu7<\C|/oӅd* 9bu6t|W/{{ WdqEu^}Rs*7,DޭnXM; e_@`J0Zݮ0dv$?za(pyX4R(N5c[%FӇ 0ukx.1(ț6S,=ew?61?ҥsחy&oi#MW}D3~ҟed2ܿ4j'NL}G'Bh3^!X!ްgAOvm2\ |ﾧ) h.d^*yg^f|0zׁ%5Q懾"EGyB8ˬx3OB1z)>^ߥo4g\{?#I $Uf Tϳo~94|{$Z~j̇medsȈU1 Rsȶ8Q$/^s;r)UQ}endstream endobj 226 0 obj << /Type /Page /Contents 227 0 R /Resources 225 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 221 0 R >> endobj 225 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 230 0 obj << /Length 2783 /Filter /FlateDecode >> stream xڽZr۸+Ğb7vRs+7 FmVdJCvӍII)R^A WGdqKJٗDS&M&b !՟GWGlDᏍ2:2ʐLH=}+͎#JDf~P²$迭:J'-Ff1\Ȼ#+RPIza[v[.DB8( PL' 2$!O 24㌁5k>%sxHwk3=2+w.17Iek PApe< MŲf$VӺqEu0*@`8z"4O&硁_9)i BgMŘf\JL"4'&J ͽ˫ټUWxHfƩ'.(Ljj%%Sm|r gYobrJEKa1'9̯AW'EP.u~KBni \Qb9S0\bjwE%.ʫU4닿rnf"6W+2EPr j%}YFӈrrh3%deMR(=+ːb>_Gi֜wǔ)!#ef`ie;8,(4 e bSEEpڇ& WPJt_F[!ՕҚŽ?4P]ɵ?]_:GYhc 5+l:3s [)wޱ;rF3iF ꐤE8li#n-i'矏Cʼ S VaF`Bip"k0?6Üuh JZ}07բ %U=)"$ 4̋qŗ#qBrCx"=!v %w^r fG0[ra^~},|Z5Xyap[0}w8o 楇a Š Ʌl|RfMH%{tRB uAf는e,Bx2Γ¯U HX7t~!n"w1>`>?̎aü8x|y HNx8N|;"DVsܟ Cbxx5XF[(r^<ƲyvՄٙһp<E iŐ%Jeqd|SX/_:T{`vѮlO`Ud vGj|Bф¬-εܝw=uz2N_r^wEqVʍ൉ru;XI}x 5 iǰ@$Թ\/xM"&|Y?mgk '<4)aݺ+)=klUgɡgr[5I9 ^Kk)ĚNq(M֠Q92zg[Wl(!#e>_xPulMQ^97nPEoX)9$GJGV=i>*"\ZK'+3w-e~<z I_wWXA$e3Z-+Y|_k|xoQDx(Yy`.q_VwIj8+I,@a"t.9W~9nF˸}BBendstream endobj 229 0 obj << /Type /Page /Contents 230 0 R /Resources 228 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 221 0 R >> endobj 228 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 233 0 obj << /Length 2890 /Filter /FlateDecode >> stream xڽZs8_G[طnMMsMڹ^\[5^IILۊn|; iɋ%Vs=0A-CICP2&Y1ʄW/oNήO؀X:0+LN<'tas5?(a݉"\CDo6g + 2)3\+ yaWAɉKFlؔ)N,ReyCHfF-yNd=2C;1԰NfJq'45?C9%Nq3lQjP]` TX ~TF #Ke\9uwZčhjRpqʸePTi2WWV(?TJ} E 88<΋]p~Ui6boAAKI ru[N;t7KSAT*5RΡDIv4feR`A#Խr,F<P 'Xe7`fu=/+{~j@3 $} A /oteGg4L|G2QTak P*iPx&%n%.ߣO(K qq9}嶨z?B' [i&2Ђ0FyX1~ʯN/So]_LZMcCqTD#&ਝa$*C {nrBs?5֬G n3_e hR}B|C>N+tz i}[Ծ.u$nM|+X-VV]@TL<#EwrsG>l-fa9$(f)I |dz- R FdHsX5>~}vuՃM4A/ah Rê/yG|!,܃8u}@UfGOkr84Y@qA#sM GMJrhnAs<;a0fOޞnylFTD۳h3S NB3U=!R> (@#qV9Qpm ܻ2GcslvNټ:S3<۱fz" 6rp>ݞ Thy=s@tw}d$ĭ`n9,D7E:`XbWᘰ@lkh1/!b=w4WƷR\n6;Kټ|ջmsMʜBtVUBg>%` !QE"L`-p!<`;*br;_i )Q .ĆӞ~ᴗ+@{zFq#v/Pe~\XX4Dzg^$LuZ <.}Zr+\/znpEW$༙s?+JIpE]ݮx vh1߶1R3y,MbUsn+.jrɌ:Ü-YܾFF^6ms򤧾X=9UoBYY/"M,0PV,q3te]eou9`+qƭ>s=koR_ttB[_T:鲥PV7t1Lm|ˠ־2Ĩt_'Ò=}Kڞu#(̪匿]VlݕIqև4bU;AJѧ]䩁|0xS8|q%j'3}j5HO ΰ}"I-j@CCV/(Œݧ>8(f)M ppZT@cd- UTh8-MDd/R}a`υ L8xS XLрk Տ<=8> NKwezO"=Ђ/s⻿_w ~KZ[M|`* $lJ7g1aPc9 16}J@qo2BfD|/q Sdo/)A#:ubۓ}S_`(pDS+፻=SGYjf^endstream endobj 232 0 obj << /Type /Page /Contents 233 0 R /Resources 231 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 221 0 R >> endobj 231 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 236 0 obj << /Length 2631 /Filter /FlateDecode >> stream xڽZYs8~ׯ#" {jکLYkHNo7hٙ\e f73j7wC ԲaQb M?'r2YFsY8X_v' aTGMk8H},UWFY,9q[)[fK2م?e d!X`^ֳ r *T\ Dh^c XÆb%mbQvex "A0R| Dm7^߾r}#he;0#{#5*(nd q֩7|ظU٦ݫozUNf#{#4kfUB,ZC M>^lf?FhO?}<=ށ1;aF/TuGOzDX B+h`1τ/etTJGJyWD?`F9­!J%Gap~` / `6(0O>?yTa7+8O|gd|D?NwWfJ@m\e/ Vc0 J]^V1>1 ƧWh~o|S>fz_ R>iH!=K>^Plo?F_Tlo?F0/vkZu 1IvCX3L$O>Qn)ljy|*jՄ)Ax?C35}d\5dR!d=&Q8\dB^m휁Lc'C7Cdzs|HnióI{ j+HI`NfQ^spW7B6_'@y;vIHf-vKrksعF;R@bAF/J N!tr =9֢)tRR$ω؀M οUXrH)ICi#r[maK1v:վr94s<&^Q\]-V>:L)bs,ӇPL$wg`ʥa.œϙ&ySє6ل[wN%p8HY7]3&ŕI`KjK@q>^[Zt>.wᵘFVH. óa01f e߸E?%?t|'٫#s `\^dy[n_F{ :YޜeU8 7󤡁e5X^{kfOpUc>Q3<? ݇| cIs4b5/l98K"|Eq}z̟tY.1Y;k`-&t8qQo#:CZeX'Hĕ$I-[Sy%I6sS֥l1`5LryvIwG"mhLg2 e!3u bP׉ϒ) 8g`&M߅߁$d,] @i Ƅ p:> lk5)]ވl)-h+LhsFg.8 @6sLCLUTD\CwÌvΓA(gT?BkD)F}׍Ac_ ?5/Wo 4ђa W<C!BƷ^P`<=޺t~*bjJ%Mmݕ3>o|)գ(1?$3endstream endobj 235 0 obj << /Type /Page /Contents 236 0 R /Resources 234 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 221 0 R >> endobj 234 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 239 0 obj << /Length 2908 /Filter /FlateDecode >> stream x[[s۶~#uZSbr;g>(2ckH*EBCL8NfL .͛7INrd~¸%lb %BoΘ4Ot&o,~8\ lӉQBٟgA'gt%"j?(ay'$ߵ F݀OqAV*Ue[he4r:|AI+8iz[ụZ0cWz;yV9ُEb_mVԣ:l7T)f÷^.#R$H.)wx~t ݙxD*&8}ż „埘Z,'0&ʩm/O2AfDQ@0-wwwD3.ΤXYOgx"Ez}Vغ֍'q$~a+gOy>#7{AY`¸&'fDҤ"{HSw'xk i'0 ?f8SiJ`~~j3d a'aY+4d<U=^zߩR߲yY6n}r qo|@)/詹!&7zL'"8 ~4 ִO~4 QOQ/;"NIYQ4wkpx]? f(_ˇ4m =HuAK}A_2ݭ?0p㡬?2kotm{~|r꣼d-stH?Î\1yy66<X<8P6۬]ޝ4TLuAJi"%agMEYH6`!l,`m!)w"К2J)$ 1㮌~cx<ɠytnV벬k+gc>^4 ]^t5toOsCx|m/no:v+y˥//Sd+WBPzmKrۘL't9cNǤ}*u~fH7w7@amvjC$WG>]\vAEiiZ|-mw֌k@ư˟ok ю"w.4]APO IN >rU^i2X'X !18|joݷSeXTuxEۇU6[L8vku)EaBmZ5UFͿyRmn[Q#5q%vҽڡU8["M!}K+8]Zׇ@9xz.n)Ak-]$b 7esqivxq&g3X\$hv_GCʱ5P3K_ 27:ƌd#J'Tàa "tthLi?hP& X+c~ۂ󱕻:{ k`fbmTQ55^~q@@΁ WslusY*Ck%m[ic]]G :7 )sqG֋g粜ÍF2d9==Lq:V0?fy?_Q,٥ S\n>KTP u*N,\ $.L2)XK";( 94BnjyXayh,ʀu%c9Œ1\\10 }F E1̬/IA, (t)9O@Q0JH]3n0wz\P+oƿJVGWUN.CU>KX\u2MpBk.Cox.C}`MI+ª0>W/O^_o `Q"d_Cuw.fӅV5 i~u&^U]y':X3e 12y dO:PU*A{Ѕp}{sW1 {V|SIJN%. ˆrΑUDz%B>@jw3mMtDendstream endobj 238 0 obj << /Type /Page /Contents 239 0 R /Resources 237 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 240 0 R >> endobj 237 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 243 0 obj << /Length 1042 /Filter /FlateDecode >> stream xڭVr6+$'!7ם[ɫ4 ,Ne% Գvь}܏<|J.eb ?[eRKW+W#JU%ZDF'#rxc1ǮIY4Y잆FXl 0)ŕ%\j {Lrɰ{JPʾ~nަ}xJ3'NZjdW!{*y#b.򌳙[J[vT)6Ag2i;cwFH%nh_mXC oV}5z\7z&nNI@8l󑱧;zr"m }AףF̎!/sqNp2Ҽ;W d#FPdkd"L~Js4u/R+ͧ~WNDnOS-sPa)jr@HyLO-M߸Taq&s3K- WO3MyFbcrRf,&.rb 4ܜn~&iI. $TTGw}bAmP$zܱ}y/ؕRS6TSK,u}* ܌C^@ɯЌPoۑ W>`C89FWWdZ(BA3й`49={l/ wz WU _^"|tpIp-|緝\TZjkˎмT ⛃ѠhL,a=M(PpU`Oi~L"г=/ua:5Obuߟ}*P7:*e@c 8?wƮ.8 !q8kSHyB%{QNN\ <;2)Tendstream endobj 242 0 obj << /Type /Page /Contents 243 0 R /Resources 241 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 240 0 R >> endobj 241 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 246 0 obj << /Length 2754 /Filter /FlateDecode >> stream x[s~_GjR_poO7u][NsYm$}w%Tzu:xƢ[<y{C2MxnhOh mӏPFdY9N/Fߟ G'홼"7rOyoz? 7Z^KN1D0,NnO tz/8 -@Es٧j7E6^`3Z\rF.>ΗO, ott0_ɶtl]6 u#G׹Z5lj{b³^ .1\J0HT#rfS쑪0]_^1 "$=+B=qBfܺqt70ơW\ﮌ)'BhDj5wۆ(HAm EpS.1Djl&/غօ bS $Hmfy_,ه' A3"!mƌJ4˖ fA`>hj/.:LɉfW`!k0zzaChSE^pἜ.\fY.i.axQR"MyS2Y9,W g5wͮiS7 w O˶pf .pv{2po=y I CX74!>w+bFWg>obڨ +Xehİ xu*]$*!]yr'δ?)8{).FIy9 -vh 3Z H $4K{)d.dᇫi#>Ev)m-+OnBG.n~xu O1^coevj?Aζ8a`Ͼh EvY8:3[QZ_r~w¬@>4Ly}[/ׇA -YpE_ t7.:r Ɏ>0@{ȇJtH.B\a`J{`M }{Ou:kr 1[TKTTR+ؐeUeOl{f~C!JJ~6f ^0Ƹ*>J %:ʟoP^9.~GMcg¿ZM4Z_ ¬kuȭ 6' *ei p f  z]`ԤE.`s%DkQ* |Z-:x)—ʄDl!`N"艴Hӡ Dځi a0=钹<W[- 4Аd{9zR%QEPbQGc*bI&XJ&\17L I&/%uJ&\17`dwL00i I1i;1ʳcTKaTK+` {qoHO^R ]eܲ+i-^yaI\NUZJ`v|)i(;RR7qSnd]f0ktovYP@yrx>:bgNr_::LVli !ɡ1?ü~_=+-)]a¡+`Hk3A4**]`v*M6^SD=+n]k0kgtvZl4l6ZڟRaV8( lhyyԅ9ځB|RƎSUfWbȅJ.ɺ'S H%>#w-[/= ʳ1?ug#3ˆj`CMČ6ff̘ f㌘\ !z]AFsS>BRNuj_ubOl|&{NKs&{@_vS`؍7߱IKLB3v"13 1;zY^\c-Dډ4@=ޝݞ\-$* ^z4lXx'5{}ᄢ[#a]1'`N>iune)~DK%^av S%P":n)v_Rq4*L`vPM4(^iPܱ!RrV77*rKP z %*ف[p ?pX 9> ݏ՛}B#m^ɝ&)wɼXN;|V {BG7ox7l;@6ڗkq a> s@RAWw), o߿ o:endstream endobj 245 0 obj << /Type /Page /Contents 246 0 R /Resources 244 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 240 0 R >> endobj 244 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 249 0 obj << /Length 2373 /Filter /FlateDecode >> stream xڵY[s~W(j\Q޲qM6ػ/9yA6Tq/3B[2o~X"vFjRx}M(5$/?\>]?5,0w(͆'9 @ Sx7)TQb`࿭]I"FFadtRE>G*ټ@0jg/Er“^,dZ.AdG%-ڢHo\/G' "r5Ju3Ƨex!\^fQ*Y w J9EU8`jPt=HAfugmsU\n5aoV&<ްZ`lfơ"`De6I9n|_OkL%_G.KGmulQ%BjɭfqgEqkc.w M.Zj{߶ǰ}@O&'.ծ Ѩ2)y3TZW %?ؚfOw'呣Ay 6֋yUןg?2Y4<۸uUM-ɒ6Qko)Qq¸ߥKw8c?.˄(|mUB:Y 0ƎF1_C5,m_HiIL䇸Ӣ@g\!\a 0 iH^.Adh} KtkwYN2*:k7#ѧU mUp?WUռ`>cf@_n8"wANBVYrQEu6mor/-3N)Ӯsi\N0J#l@m ľg%-`r醩VBiYw%i|tBNi!%xTwg"Ӱ 5NuO;h̜ [^Xk7'> 4v#8cA[:r47GsQLq7#&t ~ps@/DEN+hSH k `NҀS` -)\flk ‰ bꡍYIX.Lu23X1F;՞8 6$BgD ZΑr8ʼnG86?.JR;`S-{TFkgQ=v `p˲q:=CnKN:\L?;mr[RLt4:L@ }- ]{W(*lZKYW_qQ~|˷ _A?Nހe~۫JݫuXu쐲ͳ>2 1j,B9 ȁ- kKڮ>HNe [m袥(?>|;eFEF%ӄ3ngq1^(I/#ϻj-]t$wǃ2؅f}. pzf˻WEϩrըG#.!9T<*Q`ڑ r@"G蔁C>Ney.?_z}uȀ:+x`6^ucFq/Mt ESَ9?݅.zxq4@pDYx=tD>0q#dw.0g/ˋ#NiQc0=o^uk+εM&C <)&&/!=ߗ ;: IH/|X-xkDpw-d=}p"rfbeĦ}< hyYJ&!и20垖.2'3!SQȻB, jmI6/p94%oh&҅%cufa/W\P{+6.rudWŒwyPnƻ)t״:`#ϭps?p+ztVX딨NlTBj/kgF^+ҋc0To KPOWovBANv=vl@޳[, b*pyƊ܂_!.C"y(䠩a#ŏU)WhH*>X9ҿTA|ҁm86|.㥋kjv>tr(_СRO 6G>X惂8̚ (˶ڄ7Gkz7^OWXj gO~ Ҏ4?7DRk1ꅲ4&.r|>-N$ uw+{6c|Ń\y~%@ Ջ'd2^a ]Ż R;+@!X6[xҡ@Fwsoay5[endstream endobj 248 0 obj << /Type /Page /Contents 249 0 R /Resources 247 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 240 0 R >> endobj 247 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 252 0 obj << /Length 2002 /Filter /FlateDecode >> stream xڭX[s۶~ׯ#Ն$4ə8u|j/ih8C]Bv. )nI3.v{߮f/c\.jiN$E0y&ttzR*}}q6|aj&"q<)Lyr}}̓Ō'f)gM diG3l,7%q+!\z۹HMq-δ0q?Իnw2-A. iXmmz`W"\zi,*zTC%PڰJ?nz-jdv! yU;15凹6ό48s.eyQྟȂT,舅|#`XT7^"&k!<-2gKZ,}Ï}r,؜  U].baQz @D@yXS6 W4ؔ_1lzy1ϴ%/ [%o8gC4 1CQOpR; A٩ pv<M &~WmU/Иh1?v۝cZ1i9OU3'Mq@ i4K-kO6?#0(o)u[r{U6{rMTt&R;+BRJ c:qb4Qw?7ls 4=UM v( (xB<˵+IDa䘲 5'}P̕yfP`Qi  X:և2>d|bh/us!FKϐ(MSpƗBs7hmO6 1po#cH}([-`]{}SkLf(Y2'CKKhOSw몽neY>.Vq#{ENxUCjܰxԪ3LY0L *"Icd DzI 29)<{=Y8gFP|rNUPhBQo82Nچkۚ骆lÊ) 6." -"̈=z > endobj 250 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 255 0 obj << /Length 2990 /Filter /FlateDecode >> stream x[[s۶~#F( 8m"r;g>cs"KD%?PE 'IG.|3=tLs=~0A3604ŇDGLL&|8B$ח??gl@ 2:0ʐLH=?y:Xg,U/e|t&?gg@(1$> B bIYL~f:-}V5BU&~_Ij >'H :\'!ϒ~ȷqoζ4) .WdJ>z\]_Ճd L)$H&)x~4=3 *T\ 5qP{¸ D_J(V0&hzx2bdH]&*6C͸}z8;cF}3q8zd'l@ґ8uOAg w(#2|{' y&Km2yfz$M4X;iX` M wo`*AR 5̠ p|ݸڌ#فBS?#yX: ͒b箬֥c0 zO:g}*n[ڹz g+e̿!tOG*:Vtvҽ7ìüywu ؁/qo \vޡs_RqXf <@$Z,k7@~EO0K zd}A<``'{y`};̊10Up6hX4TDdJ$讁|iyF{;Hvɕu)8a}e/MHt)PohƘ^iu%S}"N3tECA hx]Wd%DRLOelJX~`5_^`V3~onnm!x;\^dtkϷ[i%@A„3拗,7oN}j6zVte#tWG%xL !.3 [t|[IzlNU'-$Yʳ:U=ah uaחmar3xw|Bo(nɌ6vc] (+(oo`e>Cpl|>|W/?m'v~oWea{X;X` `CYe )OO!{~rg po龈CrEбzV O{,Y >a0Ma V(jw?jB秌/6/œؖşPQ;^r;}vmh6[ߩoHCy1 aaFf)Λˌ*fehh0Y {l4`T5^@sl ۞  &!jqdѲ:0tSPOM/LGiG@`5!BAz€2Zr#U>j72LmV_p1Wyj\&ψ2UMR`8JL|<Ԋ&w v`X!?iW/n{XeC ׆;'ݛ\iK|kw+Ra 8uCjS/U$T`ƪ1{ޙ<o$J(VЙH'#)OPm=56Czo+,]=la/s-aF'OE<pVAl1_g{# NQv~ RFy BJR e2oRvEl52, RY~}`Qn' ߗclXqe7b6`4>$=W">P$K= (fe۩ Ӫw˝sܔ6.$?Tܵrg>` "U`J 8c%W~㕍"mj 6`& F1|قfPws]~Ϟ}>Rɗ">; ܸ66۫? ғa,0:Bl9D)0A ]'‡BrTN͒endstream endobj 254 0 obj << /Type /Page /Contents 255 0 R /Resources 253 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 240 0 R >> endobj 253 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 258 0 obj << /Length 1081 /Filter /FlateDecode >> stream xڭVnH+x${82H>er%" IOU/(gCKuu}&WNjYj %e ko &tY"p%>Mn K)Xjij!VH6w&[ &0kyI$qN&_{=(*5}D }W1F69˶C?` YnfNF08 ۼ&*Xݦg2 ja֞Uם@fn 1XTTAL ʮv Wu"!*]W Ǵj~0B:~;7t<C5+?N'p pe/9VSnfIb#1qF~mak*pfy=i!#u׵]ؘí}X_%QDΞFhq݉v]U&IJ95έboQ`CW)c%QVTkK6Ԫ Rrk,UqNp3¼c7F`#FP`*E6,+Ʋ[X BamJlB!&;@L5 fc8@ L}L3_ Z7N?F;9'JHtw_,$\ ? ܼx6ɳ4pi_+JsdBAdY$'ֺ2 Dx;yZۺU 2ey%8DHN_sWeojjxcKn8V9.9!<5_5\Q#~ztw׹ $/І2YgAsiDsheNrn RcNVKot(^XX׿~Qk(6U(%oAYqH@%̤,.cM3)4CEYz%ҟ;FCM.ӟ޹^]ߥ,QѰj~w A\ZzRCB9F%.T;5!x(Й1|g=endstream endobj 257 0 obj << /Type /Page /Contents 258 0 R /Resources 256 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 259 0 R >> endobj 256 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 262 0 obj << /Length 2615 /Filter /FlateDecode >> stream x[]s6}#5]!ț(N+t<ȲlkH.%׻~/%T4;;xF˫#\<z{Ieo|#T# )pc•a0Ɗ˳0=%2oG?;ˆ-zFr) , tb1Bt ~eK"b 5/~YLu-dH(Jj|^a,Cw|٧ظ,glA.6s 7x6Pbg=ϗ\S!@cܞ0___n_19₊  in  .f)L1h-@Ze2v$ WtxuIByׯ.,\Ul櫥أptIzkD민s}gXG{H34RDQIl!M k'M>4i:~f`H4a]0}t?߼6A𕤦6`yyeoY6 =&x/i8l?jc%r}G YN'): `Mv)NgYӽf{ z~@iHuj'NjA@1Z^>,N|^^[_~T+M8 !<Am?H& Y& LRF')۸: `v)NgYsf~ xtaT""/)soQ=c3d '.6~bj_V‘&0]oZAˑ!\Ta-WQp\ Qс0G3GE$iskVqv z|v$pII3 @rh0p1%wLXLgGa> 6bXق %cjj{t ,)X6UyE*mjg4!$Ӧ%H_Eup>"t_aT;0G5zp40EQDq춴X6}`޳% c[.K2ya`' _QQ߾W,pk_B#Ⱥ59]?.wAƱ3e^M7H.1\އ>ͮr$]`FXz߀ld/^)rzg0+S2jޤ\y\ +>u7cڇaiUm:/ZFL^]8r\Ï2#ʐ %DApϣ]H+]~+惖~}) rhOx.]10 v7p&||Ղk'ͥN3w eAhsj+'j{\J Ue)GN}1[a 9xF!cXX4qur_AhƺZۣR"i) )| (i!aB`AH;4((6Po(F䞍V:jwISA[~ r['qo⮴Eݛ͋JjJJ5Ds*iMICW(i6Jk+-94I٦!CI`T`fCY+i;ʨ)ʓCT T Vvj[vqz&޸(n$PeTEXFWciUʧZJvx)i,;RR~nھ |$'M٢1]70f`nCueӋ&i[:sr9npIl+r-nCZ!";c]'K4W(GBѕ)[\i ;ܕ]iJ`R]iq'>̓lQ֮FuԵh>hpoJUmi-ҺjY?JMK:|)DKRʻ|)TQp<-Mҵu)3zvHv{5zTD$efvQ3S'ǻ1 2#Đ "LVWW{n.ќ?K4k'OTH-#$|MqgsQrcӍ}*%Q|R5h>Ӕ-3n>l0 %Qb‚|6M"1]HB0id0P4d*}8t'ϏOO឵QAì.UTlU (Rć f ࠜ/Yu>\;.7< ߬zm޸KpT""Zei7F6X;xe>MO$hld(zօd GNT+xz]&N+#b{3lN('[/٧y8ψ`^> endobj 260 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 265 0 obj << /Length 1474 /Filter /FlateDecode >> stream xڭWKs8 W(M+Oꭏ4mw㜺=(kj[$'HR4t'31 |ꃋrg2HHEd-gm5I*u<_I|H?DOD9,W:ُo6Mծٜ鬎>job"&:&hWoږY6k)~vomú MDA,I-prqsT١fr2!GiN&VfAEw(6^ljG ?c#|V]oC3{._]B61ܽTf@I!u@iu@hCC1D(f_i!]]\P񡷥D[]/KAQ1JQB1( -+[;}|MTkeLA}TuD(RC+ΰ)L=PFZA@0p&c 㘄R+*t>ab4La[{R2,{)9CS>%6`"sʚCNC]HB"j_a/}@\ڕ6ke^_n_w~ԘUN 3Rq>B݄ef953p Z;݃L_^C}/O%hk-<'bk>$m0èl4DaWˠ2 g\01"d u eV.0gA_ȓ8c\>YR$mXUo5-"12ZlTvl]yHA[ Xo@cy[Շk=%1GxL;,Rv7!Ð:r5X/y_08>s3iwC ezlT #xv0&;X0r S+ Fވ`;hh+b hNYq8 *><+lvJ)'?9Vg#Eĸk0 ʏ[,{?@B>֔]}81.`z<)o>YtW@u4i2 < U0 #MKR o0h~``P]S^at3o~WDŋ~lX2oW,/QFA7_7 &ADmx'Vr%3*:endstream endobj 264 0 obj << /Type /Page /Contents 265 0 R /Resources 263 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 259 0 R >> endobj 263 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 268 0 obj << /Length 3014 /Filter /FlateDecode >> stream x[Ys۶~Уtؗ9;uK;w>Ȓk"K*E9Ϳ`!A 'LH;pܽ0n Zh>1|4B O/Fxr~w qB䯓 xBpV >Js|t"H?''A81B$~ B brWp:rz8YbZ}22x'XFI/V埡[>+Fut X^yo}땟?9\ %<|m~\OՇ.#N)${<PfZL|}ybJ"WC aľba8E̡ x@&0I<i,xm ?4ь8ߍR,RêoFcnr^>nuH:ï LaÂow)o{dry'-G&KmܙI Mխ4Hs`"M寧?_;<0c0{t~>o6#IVS[h<"We`l؆'ųII#L{2]Y!(zCd̖Hw!.nG+ҽ75ݻaVta{"ڱ >z7pg-tFk;z%q|,^~E)b%x glwb#|vJ!zR ¤GDv)EvD)zX+E7J)rw]RVnR4搻\Ղ}? Dǫ#| 󢀟.v8'w 鮘^)'\donݼ`#oo~:;@)- FQ&P 7й򷛋WVr7㞦$]1_|I,w&zr(Lbᥤ\$$z&GԞy VGg"~okw0w`w*;2p ru1zxdh)y:GG}#^vi2u:zΊ1EP._WrL|izEZr1s1u}Hᤘ$Ul8ajL5^nJ;ZXrWp7~z]7*~vzf{ܺ/S[|4q,RI:ˢNqI-SCK\.ͫ3 /Z=̝OR=CЄ|S?) "͖$u "mze)bY'A(8Xcpiѳ;metBF2oV{ܼCbqEa3>Fn7 aDV d zgމ{4*CP5W^Ř}1 ǹĖ9%mX3ʼIYQ2qX1Tь0}3#*9&;#KǹȶQECRKpP1Ʋ />hĊ xlRP@Y~d9xש8@25IE#VJ5c7 [#C-zCb,#t' 3˴](r}IwDYBœa f (u6ƿ_*_O604jrB_](F g3:Me[IzhYg3W}z5|%a%S)3z塄Mv92GH0l "\w[:|,&yզ'5ZLlU9U>nKhB>’^B# ZM6a.yX%Od1< _lޱ_J|ZXV5 kW0<ǜmVk&eiުKkolzYl7RI|Woe_ a3~d}㷫5sJKo*[p{~(~L񴺅*j&3xC?#=/˝ L> |.r0;Ӿ%pQ1ŌZ{@:v1AnsE ¿ƙ` k%ab+n&ק8QlV^}WOި,-&< ^]}MC{DAoO2["!˖p-˓a~DA/QS mendstream endobj 267 0 obj << /Type /Page /Contents 268 0 R /Resources 266 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 259 0 R >> endobj 266 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 271 0 obj << /Length 3056 /Filter /FlateDecode >> stream x\r6}W葪DN:KR[y%yFr()N~q#(Ѥ6r*-W4A7@ɛ@ZR9}ZdT%}pD<}G|ۓ G(r͸L?zc1oOR ȉtS'7'~Fh{z{|( )x6B"I8Quy2%ZW̦\4s&]勍v+1o^9I5w{|Voj"z}j~`}p\ A=f ̅P;` 1ry=QҴJ%4/!|$!X967؈xN}cZp7`v1JCJ^Z*7s<ҖY}=) ܲh]97*DS!گf.yNc5Ó9xl \ljkPɜj7wgg㛛ٻh'+\8>4.&[wա ,Vۏ-Y椐teCRGOʞO>d + p=ϡ5^X}rpA"nHh̪̞j :v|B _[aT z}E -P3KBoIjW.՟@V Rtb\?Y&KK:^xRT 쒛;oC}BcBb@9&$M䲋4ެ4֤HXAd}ib^b^)E䲫[xn `-n|It >@\4A0?/@@WG(|1 U6(_,G0&/6[l]r}\9= "ILc]f=O}7@^ Gna4huh0l!ro@gdŇM Վs6{gBO< i,+'#@ x L_YL$ĕtH>)˲ OF9t]%j+M4oXl/L@7Ui =D B"`-E!*L{Ci^5t}~;>B%D8+𺆻v+d磎A@R/x^W(wZTgNf4q]CS&iŢga&K+=:WV= =@0g'(&Y2p$W2w؃T)s @0KHŠʤSHZ4Zw2WPP4uez MnABc} e-((ǧ-Sjv.Z6 [FJ -Aݛ;$t .\L9OxZfU75 R ?9c%ee4ؠ=`6SRSR&Ken%M0(i@ =JeP^I(ߞ_FIKe#Xr{+˭zoVȓ@6h._:TMcbC[Ed~6QHI|:!'Y0ӒenzLnA7c} e(n(./.gGè Bׯ X+4L׫|5©%P0ѥ_C/o|;-.-Cj1aIM"2* 'aTJQi:!*tTJf%)Gc̺5=6v/G{@z^%\ #t51:Z˸ul:fC$fL\g`Ҽpf4(Q eG̎8Ӂ gXp6ŃcznM.h7:17gomLVdpz=8ǥ{8OW㖉PAsHy*BA{3Q;ȞP0vR?*cA2͋V'g6lߏg!oVWx'r*FjEyk SXyJԗHA RcAj0;>HM4=`}*m_hYB09El-}D F5ԮaO.!+0 şd;8|1{^0Qw-45wg_};G#:>} [Ȧ]M&~YY,> endobj 269 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 274 0 obj << /Length 1701 /Filter /FlateDecode >> stream xX[w8~ϯBwYm,@'M&4:~g$ٱ 잞S9f>|3xEYb52b<#ZCIA},Ice<I*?;I>_G,"K# Bhr=k##Q"l-YˣIAPڕt:읒j%~gq^E JX~ BӵNpFr'uax, d0ŋS^z,j }JLEr;~\&ei^ ʽnG.4UFh{yBC 5R J@QIt\!M9 g"BZ6\ԕ済(Ta#L +w[:$Z1&%Je?Іd 0ʲ%$fŀ dL6j ,f>ȈTF:8?0nF{n.QVte*tU̓1 $RD`44n8S@W6b|zV"̧.wc@TQm'Z됵0g9& C8r, Jُ7am  .nrHUK0 a8B[ve1E, 6-Ω߉bIxhXڮ2y^!ԏϗ}s zJ 1B5@`hé5qFN X5Noᐊ˺nr.=CX0B-|?s{!S|:V<*$h~ysqJp+WEW0zm誾33%n)1hVCx2p}raj^?@nP((ͱU8Y~5k ?y}K)4ʋr.]AoxQ>`xm<e>MǍp*lsߜENܠw$. f_ي8![Y4/[V@ /W>g_jg/\޺񈯜GIjm(l{4_G{D#G ,H/*Pm`&ZBHd h,*ܨdʯ|NpckݛP"Λޙ_>*ot>{ѣc[Ʃ7CASVOVdB\ty8kHL$(emLI+ OS$͔бɚ}endstream endobj 273 0 obj << /Type /Page /Contents 274 0 R /Resources 272 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 259 0 R >> endobj 272 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 277 0 obj << /Length 2248 /Filter /FlateDecode >> stream xZے6}WJ,Wطu'\IUD]j%R~vũTJ$ts Ϋ?2$."!3QrelsSOR߯ގ};ß,R2tͶϣ|ģw#ΔLt ΄2ڎT}}ꙀIW+FT\0R1L+"}؁}2.7MF;xͷp toƜ6rT,z<:kT86 ?/\hw;G-Ѥ1ɗڣ%*xs65,8R+Nj%1I pkWX F`$/|huVX?iWH8ӴRk 2條Hu9,M77, Ay|oRp NoW*\WԳQ|Sݜs?T>MIf2|0~MP,ժg8˲SO?P}A5IT z|C~dV4\.LaW pzЁ~@ģ8ͪa!, aW ف JoA@w9p? Ls瘿\l),mi Y~EվZ ^.BVCUŇҽL&As+޸^lV}ަjͽ`SmZd걮c[f,ҡh=TaPob;&,fmˎȭۼYW%=Cx5 fLBƩz2PPiY}"LD?u%iSL] QX*׍^kἀt>lћeg{*fc>YDQqȯ S~ p {]=erp: T{VefS%}V,\,~ʲXȖ/}9egeLZoJc/T'llB9se,'a/g}B)0j[qmBw4_vTX*c=!ɌF. WT4U/ՇSB-o?C*|I⊪`G5 4nNG"5^}:j?'\Ov>,p^/ zIg.lMpG@z %rm:A[$q>V肣ēDZMNX 40Ѧ[Ez>ܱC6nbm ] QhuZ4SOHr49&c-c},/^$Ӄ6I#':=ڄ/2wA9]*>D:m|7tޓE{Az r!aF@K! zv=3.UX J0¤k0 mR`A<[Y re?*%Z )G疕k4hSg-O8# ;<~Lr 3K۵o:Ѓy(/ :i30G IE J2tɳ$;BFW> +$rSp1.DJ&efP.O?C$"04{rGمIG/*MYMV9> endobj 275 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 281 0 obj << /Length 2699 /Filter /FlateDecode >> stream xZKs8WHeBo9y^[LL۪% E>,nX)H@k׍Ffo~N'dv;a<%6IJnDr3i,O_gglB&N#ר!_e6/@I=_5s |'lQ;@?/3a4Ѭ>ҤۇK@j:lԔfmĒI `a[ RWZP?!{ИP@eD ڋA@"SNA #tЇ7h O, ՙ&D('ZHBJyyΜ̴'b2(l"O5^2o'%^O%' * eitr5HZmQB- ϊWXƩP̏q=``Zw`B8#Ծ*A0{Zb)`'#s¢DF`Q`pY+<-S25H.kE) 1SH*Ē]_PH%WpA~ IޝbVHV@[ 1d&# BLQ)X^r-6J VafH/g~p<ɑֹaJap[mZG\B[Z=F&DbL4D&t hkHxr᧓{0 )ovnAL܌*`^~g6|Jf6WbvX92qw$)pBP}!6 ,jxKtG3N8d^r)̚fKkByRa\ӿ ~i˜p]A˦],Y"eEQ]籾׀Î^t6 zXkgXj#; X)X&R@Vt y%?/WLةӤYa$M=,|<]~)~ZAC %RA~>|v񏎄jU::YmwvQ2%c)Bd k$1)7m^lK?Y}c=bͷOn#@kA |L7D1>t`hkxz<7cx0>3D<^\]$4: dyiwHP[Qõösmy4 Xy?E裰°MǤpCdC p?MgGgQ;ee8R1@6_/Nf/`HRWLIcX|%^mr{)>EX,P Qg[?tћBE#R!GXS`E&!ꏆ~?ʊMLJ;o2>HmvQ> /YzEjS NnD `M~ћ.ぬ. Cݥ6i4kǾkKf 0O#+dظS>pbw[KT9"{gŝUSmL.Xu7 GU` h`i|SoҘ@r]x_ 2,2_M>o4F:*?ɗٳŝûN[r״uW> endobj 279 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 284 0 obj << /Length 2933 /Filter /FlateDecode >> stream xZ[s۶~#F . qbr;g<(ms*K*EͿ?hJi8N&&EoYTR&wd̉,#l)J#d*&p9N.'N''t@(2D+ɟ'> ޝ+)OT)6x l8jf [mS[=NSM\hMFjֹɔLq'Ѐg*o!FT8UR6;A[P{nxƭq7⤼to58 67/: ZP/6 O ݎW(2&B9]&;<WA f<00! oMi;BnBxT w(I4ьߎv\/~~4 +Z^d]d `Mn!d_A:@&$ ZGXc ؓHȍܚW V.Ԅ vbS\/i!(}B_sCi3#pdL|I>좾+v S?xߍS?Dy}~$V](|Z[wmTq&E2ÝTgHyf"}iw~\P2']w75z75Qz(\\))}VlMy&3ET%c&;xu?:7y(=ti_[b-u}9߉S>@tocrH :MM5LXtUzK}{pcw}RRWQܕѴen$ "F^dq@T.[@^YkZNXjsDGyAZʝL\VT1u ~:0{o6x$5N|3q {W׍(X0xoC|b /p~v0{wګ|YM { "7> endobj 282 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 287 0 obj << /Length 1371 /Filter /FlateDecode >> stream xWKSFW(hW#lH6s݃c [URdߧ{f$d0a+r5o5z;2ϼ&]eB:9c/B[ٺJogq̂e^i-'N|r³Δwb3̮'Z\L~pxV(ZF{'hFPTX L ho]a3FlXeS[{(@2т1K* Xhd!f R;QO 6nvLJN 8:<0thGu]7oH ƒ F2aiwT<:ggƍQ]7[}S01FٝcԐzS)* |LoQDh.*lNSt7u?Pƀ*QzjrT[SXwb% dG!=a%" a Vp$wPY%/ X."UZPRgIT5%1C}di"&{J0Pa~Sh|f_~LIf=Xê08bDjLj%{q >"|]Hr0{F$8A ؍ ِRR3Y(dM"g>I D6ھ:WI'9 6^!}Z)$f }JW}^=X1B0UPD7hRY0, /2|\)^U2lx7* T~[cP;@-o8Y_OodF@],Bib!t=ІW1Y>E Y0{ 9o:e{Xrn. Nu"endstream endobj 286 0 obj << /Type /Page /Contents 287 0 R /Resources 285 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 278 0 R >> endobj 285 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 290 0 obj << /Length 2356 /Filter /FlateDecode >> stream x]s\.Ӣ{9qv:i.(`)e7XiHt9e:Sxa+"?cޟ@e jCACDKIr0$gW7ѴPKVI(?=ӃHG1q{׽| 4 #Ҍu  7QT*6 Pl?KB%RHuhjS³B@Fg{VEmb.+ZW˝٦v^i[s1V;m7vO=6 .!.1uBlx~<̻a~uyHeKXU#K#ÐhDeȚqT] u;G#Lsr0B!.ZYnlzNօ>X2k໇\Yw7@yH3lL+ /%X CF$4˟^d6fL1ɸz`^M훍9@ ٜbyj s3@5x13M?AMfh{%P=JvBuC)ృ )ws% Vܾ5ﾨKt;Ǡ[Vwm}\]!]=D.p';gJR&jg~j;,Q=-D5c|R;x:ÏUč1Qcߌ@|2*gfՑ "AȘYBlq@/{8~?IgtSTABʺFƓ_0tc‹ALoo} a%R'ծ<~&:&w:7#::]QWЌƇ!#fqzhxW{>L.wd21gEM- ւn}YUOrk&"s7/6I%job 3=|c7ky{~pL 2Jնb::B\R [*{|#^/u$[7f]骪Mr~}U\2of擺ϲ~ƤKuU!cλf !`lqJo~H9>`>Š4&7B|{r 7o隙~fٹs_4bOj q{0d,>@Ltw(_]\`/y}vߍ0@UvOK6Biԗfʜ!cҸf i4!`i>L_YO`zdd㿽dYJ3O>@y.tS'< Ly:CK6/\e1՛V sѵG]h ℮dVj#:@$g S5K =mS+5aY=z< Wj`'"s0dLa,p6V8W8LB wglzCx%$ ]٥yZq:(g^"~ߴJd?](~@[ϯԈ!J??$`o@` ="ӨA"Y+j+> endobj 288 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 293 0 obj << /Length 1872 /Filter /FlateDecode >> stream xɒFQ&UjqB$`NAcklUlˑefnY1S!Tj/ɏ>)D,^%J{ad<{8Kxl^tcL/FϦ#HB&Eal֣?F>d>ɋ.Rzd?V7z: 4Ry6BfN˶\WvSdtF B}br" Ab}Eox-7FϮ7]T8$1QJ)zj67wm!2uRR[#)N$YC&"/2{xu}9)*떬*ܶ&7{*bYnsv<хLiSoڧ]iCˑ OT%q oU8"@cYŬl'̺ٜ/vզnϑ 5yKe5"5A]52`JnYA"}9H,y2!Sq,NudjV@(2oABmt :l{3Fէm5#kYmK[ɛ]ŤDh7A#wzͺz]5QP|Р?]% *,"^"^Yf_$9/(zāv4]ͱY8Z1q͚ ʪ#WpyB(IDӢK^#-d9,O@ Ɇ̎!zڮP~WJgTHW(/W!$B`_+W! /WH VB\3Z  ~}W@PP_pP wHJH4[zxp+Od| 4öG9!z5*(-sa\[_{OCة!XWn7ۋ1dsבT&D 4K'|mh&O%KG }g7M=t^HFl- )Xns5-#V)`g>G}BgcN@„YG٬IQ${kIPQLEWG q_n(-IGz.7#8)1dhtu7BJ_"4'ωTqR%ȡ5ƝZt. GNxU?Q6FSVJƠn;vEϬr)0g `Z_0ns;ח\ f7W-ay_%!U^?U df;T| ;rn}grC+aԶ8qX\ՠ_pP_q/bHT](NHWѐxɏ:E# rlqBɀgx@^%E=]"<0΂ /Iz뱑5B4{e0nK{fpe^mMobX09b>}d-LgdB룸i?5b ʒjgY /(C+ Rwhendstream endobj 292 0 obj << /Type /Page /Contents 293 0 R /Resources 291 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 278 0 R >> endobj 291 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 296 0 obj << /Length 2837 /Filter /FlateDecode >> stream xZ[s۶~#V9nS;GV9hSYR)nί?"1:d:1)p|Xfq;3IH,&"h&qL1P%q":΄o/lBM:UL!dt/ND$FM^%,IBr~l..S陁YS5Hl BP|.,@# ?CxAU&Q/͉5GE¨B[7vʓپ >ԣq}K}ple$Q )H-_);fb3&$Rq5iLg̛ L4Κ*6 j @&&`8i x ݇o:f\~=I͝H x8M|u2tHȺV&n݄K l>N43τqIp#4X?iXf` M O﮿=1)0!J;PSfsMbql-Mt;Ux5}$ͩN& *xo:0J(cKY1Jj$Nk-u@{a-#@ )pc2G`/5߱EWWSm#Z1(A ظ#ǷD/;ns=(2_ iRp>Z?h5dty?MC< e~ϛ(\]q!s"pr U0v-&ѥ$1wM}DbD `M~ћ]Y .-5D};WbC|t%vLZkft6=7iMzl1 /mEf%\Jy|B;t<f/w|Mm%6$'pNw̶>ݣc%gK2"*OCJ *墕ms2iMPG>}c;^6>Ep׵p98^Ш la*[[1 ۮ{tTd.={ICT۫d2<ӛ<>xTy3 `s26'a f*I,\l_PrSи!V7i{,핊,*>@{D_UQJUs4(Xd{P@x]oP S82fVڽarDGͼA'Rmu-ZdT/臭c^ֹP:5Dŏ Y[-+ޔ3Ŷ,+sWn(QZi_,7VHMI9zA]׮=k-e2eSOE(\}<8JoeF8;.J)Mm6cBM4\!\>E*[ğ@ a'UTP"ahNǴa,Ә"FDog,iU12d|o,]OeQ+PsjJyOxJYWxMӱr:i??Xa]#FxC :+6 dbc#S-]5;fbxޜϛRɽʙ{ﰎYO`Z鋭:Xj=OlD{~n=@c[xULM8zĝL{O]&r2۰wZ?N )*vb6""F;{vwD ШP< nG hb7vIB2ڧ~-_/SA'jϊ(` kWGf>yѷo:?p/W+t`{:I6̓ Huرs%K`7QQHgpJ)Б< Oendstream endobj 295 0 obj << /Type /Page /Contents 296 0 R /Resources 294 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 297 0 R >> endobj 294 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 300 0 obj << /Length 2314 /Filter /FlateDecode >> stream xYr8}W葚1 qSmQIP_?ݸP$˚vkUHti]ͿLߍ"e,7Adfer7)"9|Ի>?ַX!uq;{GFf-{x1~m`(m[z$1r1`+L|v'g)-Gz .)ϒ)`!vbMjkQ>Â\W_'Z~G~c{7O:if)= )#V' Ynߦ Cձy Mjg{W*UrܪS5˹WtRlVJ<]\&pJ"Vf{ZY|s}jA%$c-@b6Iކ&hFffx "N0Z| D=D3.ZRsP]GN EzZ.|Gt<7o`A Z?:_*wF!MpbHM!ʄ^0T69K o矯`TW0* mm7_%4ׄ)mͅՆ]O f!I&t?CBm3 zk#eLu]q7VZEӐ0u++i0`8K*K]o<|JA@ FO-1v{Op㊇6|![ {:k!a1͗]JF-w&tl}*Zb\%H|ӉnSyeVLk=B"GqWO6*\*렗[w HHoΉJD*䏑|&pq"Мh)ݣe{nn0=/ί/.?_?"T^8]IU`ƶ|6Xq3,ꃯ Ųtq iE+,%/Ǩ/E L ju@(,9H#zj.g Le1qa@:[`cS 5:kA0g4JP="sGi&O&YN]^.@ T rJ1_uNjR]xT0܀hW؈/)ji f* 'leƮzy fucܑhoVQG |=!X,֤Sg!'pt:gmR@w> !ŠxjUuYYS hڬ|/Ҏ>^:wZj@xW΋r]"sy̓pD`owxܑ6y,[uR>Cuy2}D`+dv|n.F>Bh!xg:NϬ$mj|!sXu?,/1 3vJF8MbUٚ#f~8<& ^TZ ma;|]83lթu7q <_ WNBLn=dGAX(%~Җ5 TOpu>)1Q27 O)I7+$|~4NF'@hγD&\s<(h^}f&K6I׹M*8{t'b(O~>3R 5r4 oZYoendstream endobj 299 0 obj << /Type /Page /Contents 300 0 R /Resources 298 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 297 0 R >> endobj 298 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 303 0 obj << /Length 1809 /Filter /FlateDecode >> stream xZ]wF}УTe?x pZHIx0Ա\Gÿ̮V2E-9Zޝsgw_l\' Xb %Bm*Idz~5r!Dztz?>zz>b ,q41'N&ףFod:%Y|Js<I.bt6i1b8j%͗\&pqJ"NRtL_ +&$Rqj`u w,]m1o ؄&rnFFOdHì>Lea[^?=;&qYQKCH rnr^,CIq+h]GNqIS7|XnX|΀4yńaI#;3 i&4I0śN܁aF}0kt ѫ2k3f3f 8*ru]FQ)n;;9X&m;‚xua[vq©U(!ct0;oZET|>f s 4qzhP6Ҳ], t٨AQ40u`M3-}h8u6Q }6&٨5U5JQ]L&x:^go8YDUS Sg~JؽZ{`Te1WKRάЛ.l,*u; g1518,rKXg8~5c;8UXǠGi'8䖻:YޤHwy:GdaYIX {'9IgYt ֱԴ,c͐F,648$ BAs@+9$dx21gfՃw4ljb:N[ IȤk`d x9۳ 7\BakHUw諸'/04d0O Їm/I)x9ïɼzEwev턓fGe# @6tScgElpP77ofV \L2^p2VKCBbXё[0yc/nv8Fh ??@- ]4;60@@¡ ʎ3V;% ?CC5!b!"6ְd6zj5 u-0)miK*qaL4LPw_&`]&-&i0|sCarib pCk4ՖYזz`R 恵|OI=\*m]]q;#qʵOj(:" WLSB4?h3+M{"?bXGl-2$ I}zH3 iI'efT|&gUւsU"pAoHjuU Pͥp)Bԏ/#xKp!;֫F bSL<~ m8kգdzD-6>Aa[C8Lr%H PLVS:uoX!@endstream endobj 302 0 obj << /Type /Page /Contents 303 0 R /Resources 301 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 297 0 R >> endobj 301 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 306 0 obj << /Length 1956 /Filter /FlateDecode >> stream xڵXIwHW(jz_e0 Åqol qB)@84@<,{$Q[ R붰Ղ1f˴D@6s%tF^PʈE@p*8+*̧ Χƞ[P6C㢝* +ؽZ5ϡ̲ ?8EKxSv^RݴQJl"-^\0Aȋ,槯]U]Ղ2ddBMp* c8w?aq C{uf"8]+8 sz3 r8,0ViX{msN9=A =1K *c 9YG_w +S=oX~ x%!_uPUa :M:CXB˾Veljd\*y`WXԗQ]s## G7̈ie=phdJ+t0t%C9 UDΨ&Ji#*$ޥ w<՛~~1-!}N} znˊs*e .Ow^|7xOFHSD&<2i[4&M44+ؓfG_|8LRSihQџ0LC_4bS:EV[cLl.ߙtĀR>Uk,M7&D"u( ?Jv?vcvOd! 77h>4BߕKɉd<^*sEgwYpZ JnS"1 L$?Lg 8ŪmClncMԷB][쉇(|i]k&#(ϟf[B`H=B_ʍc,2- *wtpqJĊSqX BMMqDF!kʏ02<Q;@ [?hjgw֔k_,8AdgC'\+^<zXNLaq(!G+`"f'DpڿŷHŠ@Te§PA:ILhfސx?A×Urt{VvJ4a4WO&Ƃ͓ uϟ;*'em_E4$^=JZ*  ,RrNV S,p~endstream endobj 305 0 obj << /Type /Page /Contents 306 0 R /Resources 304 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 297 0 R >> endobj 304 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 309 0 obj << /Length 2670 /Filter /FlateDecode >> stream xZ[s۶~#F9c͜I K92Rt\ן]\xhJh2g4#v "e4(}Npdje2~Ȇ#!Dr|y62~t:>b ?6tX!`x/t0;Gk(a">,]QS/Z +.J8|W%S1dILZLX; x'&5FIy7kΊ0Q~ۤt٪֮ MRԽ\nd%T>;_.K|yL62bIbXI'ei]0\_njLPIjҔ0bЛ L*H&4RSO2A4F2M^ߜ^_wC͸ sn8{cx9eLX҅'q$ {A[xO)C//C= (0ᰤѩ%i!Mլ4XfH??S bxwÌwT-W5a5U"HM MXldp7}!DUa85Fq,P1N8^OpF4ƻ0T՗քrk9z{/:Tӟ 4~,2tڪo0V*F86DklX6~64փfeM7W:Jmk*S +B, iJ$eIz;3ϑabBhbxIheP H>f;~05Vdo_R%)$ Njt\`e$;:9O킣yݭ*|P#n|K˥3tC/taE"p?*d|Sdf?;FƷ^_tMy(](xc.btOC**' Q'}1sUE{/TŷQ>աҥU~I<_Qm/`e4gq>?.R CW }ZC]e{ tLPkX^⧫>)PjPH bMb4w}|*{u?.Ѫk+֧?<%M4Dq>6AY}. eM~(O.OO{l n=5\bTdB^wyMK.-M=Dp+؟MdM mM2ط%ΛO\ZK:\Op~t>MY/Ú_cK)ZYCD+ަ/qKkRLziH^@ ƽq\0VU rG[zC!w*ʠV&l> -qD/C`Cc&%crF5˒:epύx-L K4l6lhZ q'(lroUlEuU ;>q/ϕ#~)>Qx,WB7ezsu7 (6[S#O h'~/՛ ++)$l*䨜QJ.5y-$L Md6[ѝ$ W& PPTPU}_q)+&_#5\PTR/_/N~9.aen(\{v4tONћM 8J@O.g!h่Q}?endstream endobj 308 0 obj << /Type /Page /Contents 309 0 R /Resources 307 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 297 0 R >> endobj 307 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 312 0 obj << /Length 2568 /Filter /FlateDecode >> stream xZKsFWn)Rkov,998>0$$"6{zD(_*4|'vty53Ń9Ǚ06XDhtq(Tq1O9XPڎf7'|G>z}™ ތ3ݜhFMښ~D qkTPb{WE^-+(!*מ;ӨrDbUQ naPl벦MǾ.5=qtQ].\WUo/ mc`aAs΅Zr wo=15F jo #[hU)xj/#=B1`x xgg= ZOd,®ߎ'Z̬[]3Yd0v6|s7L+djxzH3IL4&epiä`C#3i:_W/`żl 5̬Lc(݁?--F2Xn@m߬4s&t=^ 8?}֣@* qwc"bӵLm$Sd 95:-9) } -U7kZ1ڣ (Ry{ l ?/Pjv@Y1ԁpo_]?󔏸V_*inK%h z(U]0u8~_/lQlқctB(OEj C2$qRpGp}V2k<RHM> df {8[H$4zh0SӶaW+ I-~5>&"H8ƉrKջM ')Ut9500\S#Tb 8Ra[:.՚$g_I3&?R%˄̻GoΚlk̈B\)ns +6c̔/`ҩJg!'JƅbM0zSÄT⃔ AN/AOu؟<* '5)ʴ;rӔkĔƲzwp] xtcdcM8q:t$]8ٖBđP4u 21ٔqzD#b9ePaFB]!}ŗ}IO1]߭ZoM\|CrQ0sK`r5b$n$qSQ281@ J|ͩmDiN549:xA@\#mu9ik!#RPx$8/fCGi I UIsP.}m&Q:t];A UMfؙd>"t^p{-Z,vU2]H|Y) *[p CPgP!=2d#]$Qf{{"M~ AĆKHH3o{{` tp3h/mI$N;@?`HA y_am틂sHY>Wzo|E=6h>zXn|EсQa;!L ѥ)0L:q$JY+f baUAG7n:ǃ_xc‚?IC-NXZ)BX=, qTI.mU7aQk-87qֳwd4ᔋM+E9b9!䖞]p 4"bp/iX+=|mgi[S]eFaմu;'cPXu,?'GσMp `?`Vyol#s&9$MK!d# 46i> endobj 310 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 315 0 obj << /Length 2686 /Filter /FlateDecode >> stream xZ]S8WnT}[v@_۾텛lHX',ÖcS -9s>$׿AF2`|3`A36HSJ{/L3fÑ"9x::~wp2>` lAR |;DdF e|p r`$8Qijv0/KypF]0RPJ{t`@_d uP!KR?֒)C8|)$ܘڋ)M"t "}3h[kRo]dJq8M?Ӄrb$VrdZBe )A#px5,yr$ rX^d2q.JaPEa<9ũbZ7╿~,Q6}*b4vTJ"\PA2)Lh Mg~Y.N_åR\-bP*AC{#?wEB=gPUK$b9RZJb?@6X7<g ,Nd8<{MWv5R.k$_I3]O<]xAױ~332iS9^`~/Qa8ĤyTfKL0Y<9*g&/h6(g|0*eι#PCll\XZD;*-@o#!Y ˾!v:S. lسv=s?:hoV8]n7gzZKp 5GEDj>,qv|jY ׮o EœSw/Mljb0Nv!BOۨżAd9],>t/"o4 nS|KTa: :\:sYnbwy:WK}yp]睿gqpF0_z#1rXڠm!}<Xw) |z88$:U/B';\ 9HotLY U34ѐU~ŽGX6 9иpde  ph:uYnP$b}' tyLX!4%F01(L ;0 ǃf2L+Vl\XZ1LCK&V.'/͸<5I'zXdm?u Vek,mf㓫\& "KLȶ(,m<(9$r$?[3$] ;>tڰյO1 v4m6h]6*`3 3"۬* 밪VV`UvU0a/hcQ15ݘwD.8e0]?b[i|h\l#{AVdoX=xq=m5dRH*U!Gm۱|~FQK®n8l(lV/4·;:#\OG"xu7<v7Qv箞*I}-AUb<ܽs3@sX> endobj 313 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 319 0 obj << /Length 2183 /Filter /FlateDecode >> stream xYs۸_'*!$)w$ͤm{E:D]bh7q.xbw~:_mF0Cz0YpZ@׷7@i?bj5 5'&[x>ϧ w C3" +!~Å %  V<$WMG3 't :oSo{Af7]rbȆU1h-9Uؑi70+4ߣI|U&'&̌=Gb[EwbN?a`L<;bplᙕ"2X}hd\yBFUy3i#`+Ea'h U΀Md AL!'ҏBЫ!Dg+gPB]9 <BoөS:KGӴ ߽9C8V'KHJT F| } M>҆c)2/ߜͲ0{KEPsOy\R0)dO*3Uz7fvyПbrug [&%&-+t!9A) !<^@pS .:Iܗ5#vzq[N0w%//-w5ta>uʇ^x2uJx+HSٟRA.mwp,F쥥A7XG)"HZ[jfe|s nHLY =`0ӧX˷. 栫.)Ela)*>HL^P > endobj 317 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 322 0 obj << /Length 2197 /Filter /FlateDecode >> stream xZr+p %Z>H.rr>oggf}K?#FKqAhPSɇfI{hu^#d0m,,>.V'?aYtNXRnپ)kXl\t] YdR]:oC5\FR$;<RGt|yvvD*j8}ƹ „[8؇&WYj6+#Ɠ' R}@>,#_##2u:EfptƵ R4oʏ);l]Cғ8u L­7Ec6k '#& Ҝm%M-oriaIs8i|{跷oTb>*g_/?9xJnɈtcXWxRo1N,]0Ilg&)9/ˆt|QRUތYX `v̼ʶ3rD]mۛ!** ;Cy{" }TnDztPj]Yqc7I e׸o$oI&L!A+||(]Wi\@uۑvּ_(Q:&~on8tjCqm(9Mn &wݰeve { I74ݰݤ94{F ӆi=06|6Osc?{+IF!1.Ⱦ)d@w-@ݘ% maO5^{ BKnE巕/0=.0വה.f1j>& ӫ/΋6Q3&3U+̾2ԓbϕB}U#{pF!vyʯ|N#2)ҩ/pcRCaAXz1r-Ww2!\!J C x'd0w{_5gyu^ ĺUQyA*Zrh5}\w %qbBrW;G8UևX`kd=NX]W|Q!Iz#baC $xy8D ߁|' B;as` @&G\v>yt|˯ q=،A2”0b&wTݰUvU.}KX*E8lipC;>I=0|bA,GG_N؄_Ġ6F 9ū"tKj̀ƫV>xlYeG W;zdzX[<"w% GJ06YRSpavrD~$zb:q!ʿ= XY22`l3E6^}˧??e_e ׯ^ѭ4)s S>$i؎wT;S!3?@RΌYb;?Oendstream endobj 321 0 obj << /Type /Page /Contents 322 0 R /Resources 320 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 316 0 R >> endobj 320 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 325 0 obj << /Length 2044 /Filter /FlateDecode >> stream xYr+o)+Qt-wx _A RRTRu+ƙ=ݧG?\hG:0n%Pb-<~J8c8^L\?_]XB?8eR'ѧ4h~DpV%pC s'"FWvh N1vߌt5f•Z}S` WD(e&^+j%cZ"wW' r@hg )l.㌁5kGk3*e17i\oX xZNŗuQݏK $=[_fxQLo+MoTQvVJR^FɬE=_ZZt 5ƨ@| j ȑ;5&+ jnƛxAjnb[_a+ѕM'{0>-f. Ls&QDx G lMY}vilt9τQDKHCp*ڒWO pΕs[r}9UwN;Sƹk~ ōuVat#z2p}x`K:|3.$S8 5_H2}؄ tN1?>ta ::Y4!o#U@bk\ao8b/g_z9-qCm6m]q&13hxc zLL`}(4a *KQ]Y0{uG`0Jn;(☎jPU3#[) `jZg`h:XzPoWV:4QRvtDt\hr, OeuϋpsT_tWPZ͇XD*IR8 '(LȰ tT<ܗ b 7շPjiq.p|*%8-GyH=prK|-GpW`T.  MiYx-jXFT§QiQ+LS";5o`gnqI`xẄ́ȧ{uk+&a4 Qg(MTc4?3&`Uu]+##{K>AmzHQ1P*Ju]m&A6š*nuݒܨ\f(@Pd /Qu 1UQN  zG!tnBAnz! suMړP@& X2 <xuszzvu5h'[%!Sx%a/W X^y]Bfc&9>]=E~>=RNכ/!ﭿbfB49؊ftL 8쑠y5۠9 .'?ۃwfLlb}'~z?%#Vr@)zԁ{v:V,$`Xg/+L%V s_$kL^mQ[?!.AGiv1ehxoEDX4 e7\kvlAK캞i`c]EChÉE>F`HC=TICɿ%C|Cgr ᱽF'͗~j`PӞlRl٢|ri<-뻁T|^n$ M~?tiђ`"6bA뵔x?AgMm4){TA1alfFae~SvmEȕ3]{i r~ЙwY4u=΅1~@JH.,ˇLWp{ i_߶EUd hOŒ].K_1ݯ}穦XExwh^}fU~@]6`:a3VCH$R^)Hxbcxs)*SYO6endstream endobj 324 0 obj << /Type /Page /Contents 325 0 R /Resources 323 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 316 0 R >> endobj 323 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 328 0 obj << /Length 1290 /Filter /FlateDecode >> stream xڭWYSF~УT syB Vm9`,cqd£9z6qi}¸%:C07Me3iLGY !iv7:,G qBd;t@%YJsL԰8oa\.%YLv2#1EAQ͏LD*C a~o0a+k%]]hVv{3b<Қ/%i,x|U?4ьևY.5"5x}"EuQžI5.#Yx $)<yLpl79ޓ ~4FG8w Iimoy`$៧{0 w7fLa ށ9>%#Vrے;F$QBMdپ税*6B=w*2iI9s \P.2q066Hb(mt-D6n#L[Cj M,CJ̇n]"簰1X&SmCQBfK lbFz꯲2I:&q }92/=%#sĂ=o f]{o`y)? ԅyn$BS >%/7b54iI *CD!8c =RMuC\yz_fa'387EspwwmDBp# qB)&y#2o~xFQf"[oX&{ I2cZ˂ /}U0Qio и8>.h؝&K ]LPΞ e}H+26eaRIлm}[}Wi2 *pf* b>,ЎQupm'azs{Xa{)qnb6wPIpbZn[hXlw*Ur??ݜo!{(>Fji!VTu7sЖB$)J^JT x,?4OQ_trS%ÉXR> endobj 326 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 331 0 obj << /Length 1663 /Filter /FlateDecode >> stream xݙKoF ,XiE&g9Ǚ06ؐ, .YQ*aU(JE3tuqfp 2DxcAi>l2ٛg*x}D2hl~Gkg8 ኵՙ` mU]%L[:i2a2yY+YPilm _)g^ϮR9*i5it{&-K-c$Yh&1DKy\ɲBŜR,&hLi@z }23Ãʶ'sZ6Ze#(i YNIzܖ!V0k0nt]т V A5& t^@9QcXpÜET8[b!/O16z1) Rb ( ^u>^uW~Vֺx) 4),lS 6%T6)u[5FOYk'S"VRΓat)6d0;LJqa)G #ߏSʝĸlzIs/+4PF#Ck jG~ݮrw(AP-ۯڧ:a g{<[)d^=nB< |< D}?dܶx)ť_溊|xSJoR^F0cB27∌"cqEˏ4E(=\._7*;ksﮟ1'0Lu.ϼ9NX^) }4PAqp5m{0R͠|F#IwRNV8Cn{/M_>ꪣ?3pP}8jDqנd"(YZaKv I A> Ix%$|'}q&:AfCG ^E`l]Q^tS*}HL ͫ|&9E鍲y)}endstream endobj 330 0 obj << /Type /Page /Contents 331 0 R /Resources 329 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 316 0 R >> endobj 329 0 obj << /Font << /F8 19 0 R /F17 37 0 R /F19 6 0 R /F23 16 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 334 0 obj << /Length 2880 /Filter /FlateDecode >> stream xZKs8WHe"x9g3N쵭ne@KZIԒ3_ "-1Tm _wpug7Xf]݌pLY2o5 df̓fQ'_'RjdR'%e:6]zDc pZMcR]f *~W8x;N$Ȩ3ИŌ5S.Fto]7#nz)|{[Y=˿ѮlRrxўqǴ3z]"k?)7EC[^7w*_=d"A-h요*ȉkDc' r4(C.ǁFqj~IWÁLrYw@) XySW-1yx4u%,<@y:nJR޻)mAa8{'S-S3J1Ep8gÒ0w_5:$/}y`piʳW68<8RHoYty8]rg7"UU>} [r[ X38Lasd$y {!%>!.2?kP..{u6r0縗G[G/H=54福ja6` LO6$5&iw܌؞/ !TrøK3I);`2ጏWwW',idhAczvŌrOc"`; *#拆"+Md[(,7ȂʇIg0Z[5Euxpd0Kop%CIU^E 8v{ֵ0$K0;yW8.&zTH{2˃^a\mb_X?a#PVs`drExƼ͊s\pY|b2ܴd!*s QcjJۑ7I] f, !A6'2{\3A/k x!a ̂F1QٌdacmQ;LpJ梨҅04eeY?ِ_YED 6H9Fȑ20^@-9\m<qzSP' hQy*LO5ѫUT i3A$}ȸ\+)Xo"s,xB\_G2Nt`uH/Qg)pJ<4b }C}f ,~ )f~ o6|q,0[ۭrFs, FY=;v q``H ޴ʖaBgz̏ $j 1+rUYa6o8ID7<(ȭU;j]ګ绠HV,҆P]8 g0v؁K1aYmh+#DO!uYTp=ڿ&Jc9$Ӷ|4^o0 @^NЉ঳FBjToyrm D۫.j\}EMt6Y@ CUl.| ,!;$Y߀W>d*!Lq;`"M?^NhG?/ N9<=9SSKDw%>6y~xqiق.l}N6,uN#.!6NY~O;82NE7_;O=zOjׂݳX-wPR 81;wtw!_E)ؠ ݀<$AZ}>/ٌT-2uM>K\F7aeJqsŸJq' LŦJ3vD>q3j i[*x6:yOI%QsJ*P2UOg@3g)MrC ТU!* R1sound/kx]%\.^ n}ΘRa4zvWnpHAj!LpZjlXӷLE?Fs,w~F{~y/f}x\QPy2γS$RZ2Rqޥ) )o/['q֟~> endobj 332 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F27 56 0 R /F14 40 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 338 0 obj << /Length 2354 /Filter /FlateDecode >> stream xYKHQbPQOjnͲ1ӰLlA~t[6G,w`bODcTOzz}_~D(u9(텑AMJ am.sy+Crm6kWyaɮsoM^hm^_jrƖNjwd~!'/.0gB'wVtxsO!>Gi#d *7:wݢ]&a5Th+ {Zo_F^*նl$'f\WٴH DpN$MW(Q|9YɠL|鴰5;t=^xe\[-*Z5yeҟRrĮW~;&\Ϊͪk#!\:)|!& ^Ac&Ҧ0r0Vă1RHD)kE.LY )4.DiL-a#:` )vPWãDUΑo5!Jg#RDMI !1D|կfb1[!y.|y]o?`qZ\C*+'J'1J}g(v)CL+y Wh%qFgSbW4D|̏Y5ts@wrw3 =匄  |9}BcN~@']9~8 "=+@Cx68g@>[=U)RDBͨ]sPJoIvD*[jE;ܺ@݂x_>,vKibȉ3]܂o붣bJE2㨥|w!H*w ^(:^u |jhQ}ZO.Hp ƒ1N{؂z[2nSE_hE3w]C6}&9&.dr$mH. ;j7)w.#¦FI#D*H_uR] :]R»麻4 p[/ Gr`HZ/~zSۜ. +.;<)'W,#K_=imt'd5COV$Ƣs]~8fdIKێmēՉ6eL2N˹4xOzƄnk`zbby] o=bȒP:L_6nGuivhT) l4D-EU`>okJaWik*u6= eToq\)+UT2n8T0 ;hGo#e -5ęy7eǠSPVj1PthCB4vV(Q|[őhn==4uWy8P{Ʊ2q!51TvK=1bi)Y<=Cdnk$ڍM ̎'!`ԃMsl~x{"oM#W.uf/#M%Xg>7*7 c.BLX뱖 Qs,,G  <6(EQ190wqiuB}<FMach%oڄo2u 8u4,.X, WGzBio"#lh ԬV3I`U될NU-l)DK(2UY &JoO gXÈ6?9o_60n[#0Gc#ظuΗȗL Gȩqp^cĦ]#zæmeK|+5;/{7޽[Kuj͞\|$^Շ4[} H5ma,Z3*~-D$|u cP*&~ o8$h@|y!c?Ia!v/jӔ{zUo5߬oq\8FM̡cp0Laܗ_Af=brB}ƔEfVƳSSrt6ޒsA<fҫs~0 ݌k'4m2LTEg~̊7vX RflK8Df8oB >?di JC'%S\?n!A*}ҝ-yO`+-XA`(74A5ٱD 1 1%!#l}d?*=,;Sf'r"endstream endobj 337 0 obj << /Type /Page /Contents 338 0 R /Resources 336 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 335 0 R >> endobj 336 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 341 0 obj << /Length 2419 /Filter /FlateDecode >> stream xZ[:~_GCx*( [,&13)r[ǁÿn؉3m[v49>{x歴) 9sڦ_23 i.Cճ~pCp$]MWo7ïwgogb?1|y`8ٗ|0=wg)p&ř*>3C?q 0zT[K?x> +ZÀ2Py4Z2[_iX;h1mt(̖C:ؾ)+juUnBt;&:uCe:[}:ocwx^+k vW0o I5s,-<뫋S\3mewt՛OzaRX7V[50- c&⩛XtIo_yv214ӂIm4l@s 4^|>F1'ۃfx3@Ȗ #%W.VUjN1 8Juq.qGjC0Ƥ8 I`6M8n)2yӰ{~2wm/Ǘ8S:,'6]'?p_='f !JUQ]aʭRy'}B8U٦&$+*_G׷H";by-!*eԜ 0JV3 J  !_kֳ͊cnSL)#D(+*eZ CKPܷq[/²Oes{/n`lD|v^TcBkfqrOٜ9?hʪe$`2>6Sz1wT4 kV\95s!4HOGm}.Bd|,,ߞn%6Oz\(~`6-1ĿHINMM0--l]7ڔSG~#IOypl1G\6g%xH'!i'9jARԉ nԱ(jʱkDʖ.%%sԗ}AjeC(dZ #Bx3D. -IL)4xa=gE:c!i#cU.ĦoC&8S D5!U9wOtq}TYQ]xax^HP6s=S>?@l2dϢ XSq]l61azq#ID4Jmm5JUqJN<)=KversyΔ$хt[NCHmiHzXyׁesѕ<"ܰ_鹯ZBՃs[Svcq6<,بceWǎc:W]51@k7Q $IciiGm=u2(qRXVxHntD=dwMr,Sc%q\Ƿ0Gu0vN^MJk8})3?߲_zK3:*6 38}}?ҮǿO{uP /_"d "M{h8 FSm?LT !Qe3 Kendstream endobj 340 0 obj << /Type /Page /Contents 341 0 R /Resources 339 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 335 0 R >> endobj 339 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 344 0 obj << /Length 2747 /Filter /FlateDecode >> stream xZKs8WHeBxDn$ST{c'[90mFDF)HFwяOo tru=*:qres4ʦ.:_Oe,V<4ZGW\GihN/6߯^:%fiNfw';{2$'.霚ܝ_-}N @Ag"M$SZ$դÇ5 >Ujhu:ky_n VJ>W$1@~zjЪ@&M6 󨘑FR.%g1l3},<<, wI7O(XJᬕ$(@weS@aMlif뿿OKW I54K _ O`&[4bXlk'rq (qiuLǂ93wiE%zZ3kVY&\p3ILg:|YmEMCר: )~p D_C6]QFوnݝ Pxv$ChpOa-20|10V.YTtL h8ChA>D>@yYyݜA{'C%C3Ko5>hQ33aŢ"CGY~[lEuGՅ1Wck&XG^II4ggۻ!շE`H~68~g v7 ܷ"nr-FMEe/ ܽnxZzjxqF>&Hkat&-Ǹr$ZgRkQƗ+l4xiC$J[jy O:9,̖$Ӟo﬌PF)O]mޏg:?fߵذ`E;xx4<ǀ*6޽tr}`ٙo*<SU+gy0E$V,8V%)k5ܔ::%O*&|Y5[?vg\᪯pr}@$ڇNFo!7|xw:1Xe'j]\-Ǹϒݽ/N2a]w;pLQ!e*l'>Ë./G#T*zQ1UI5.Xc4}d r6vF=| ^8M=N:;tzc%]0k'ٻo^h5=ڟ10|@FH.xqHpOmasd%j~ޭ0rOҸK}ܽj_q΂(+żK#VGrlDfdzL<ځ>shTQ!!5C!߾z{?#[ 2itVm=)mS5F:^rqXéfO[#}ݼ/4QPݰF pLJ"%)z%"]yDsJE>vԑ*Bf.P_UV#2R4% cKMÁm4c ]b Wy)FԎ"\ڿͯBuEڷ$cd/w,8 =gyƧiJ y硣E!7:?g)vP7 HC\}42N3 #["Ȕ9=- < io#RkOMzxs3(Ius p"-^xIV.2PRCDZVP @ܨ^'~:T/\sy$C7՘T²{11b x7u1  5؂T6LQ,벘 RKqQd:TC=f~9<|eKv젶pUHeUW6S3+TGxB3̝S ]\݂a_B鬜eDTdRʎY@TZÈl @|,H'iz,9M {i&`4l/C(la 8@}4Qb{Xu}Pֹ{&a00} ,[j=nlX;A}=?j u5po?שN􍯈1*vF.x-hEk@\$x</r7Żm?Ϟ?{872A"]X, [Ą  &oJt^8jendstream endobj 343 0 obj << /Type /Page /Contents 344 0 R /Resources 342 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 335 0 R >> endobj 342 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F24 22 0 R /F27 56 0 R /F14 40 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 347 0 obj << /Length 2002 /Filter /FlateDecode >> stream xڽXYs6~ׯ#ٖ6n3i4Dwd:'iG3"].G?.BEy.0x$Uں"~KTܭ-|ucěNR: =ys&.^^\T$᧢BFEa27g?h1˙6)TQh3˴;ٯcNOQX}FHg &1:.rSuh7 }|羀woya]²'MZ^0]_wK&m+`br:Ww*ԻyRDa"C>xwY(hGA˪b1a7BR-sLvAfmWvx:8UA- Aށ~K9xp?ʉ;m/ ggWh /1#'WyA@̀pؐThT*˄?D6r!ea Qh<q'G&14{ myDA_A e%={#R3LĎpR)P0!T;*N r\v!/9I(`C'͐N%ʅAYHCBah|]~H@U3,v}J( :"9/ˆ4JvvHlu|ҝ :=.0Һh_N,SqLk!+m^\bh`<H")+jĻ{q &NA rٲ3h^QD:=T0X(m(-U5 Ys\bp,Sryo#P 퓰l:uTr2-6d v3#jC`]\/G}C8+%#8 ޽*:+ye8t8c?iE^@qq}1^ݎrO&VKr&[U 7[@u"V tpY#&-o-t!YZ1$** mg1Ce@~+:<߲@0+W-ʖSZgN!E} N# H)kM0۝ vX4X'}xƊܹ@0 T% wB_^Q9TQQlF_0lj%)@Eb t8y85*3G`-(O_E 0였nF2^,k(?s`#GjYlN@i_&Ǩʏ0Vbxȏb֨d6Pp\'Q OU8_Ã2M &~ ch=lp+狊+5JPUMeW`Eܿ1Z2^䲈 {Nln.zH~SQ'Ӆכ&`_ؾ:Q"5ILtMw0Ҳ=5+ߐtč2PQpePѠrV?"RtJ+z ^-|?dѬ'=uǏ /2a: |a 8qW $mi+$N\zk\ endstream endobj 346 0 obj << /Type /Page /Contents 347 0 R /Resources 345 0 R /MediaBox [0 0 595.2756 841.8898] /Parent 335 0 R >> endobj 345 0 obj << /Font << /F8 19 0 R /F23 16 0 R /F27 56 0 R /F17 37 0 R /F20 13 0 R /F19 6 0 R /F24 22 0 R /F25 25 0 R >> /ProcSet [ /PDF /Text ] >> endobj 55 0 obj << /Length1 1770 /Length2 11056 /Length3 532 /Length 12054 /Filter /FlateDecode >> stream xUX˶qXp]7C. @pgkIڗ\хP+19]ؘXl̬bH  sXq + K8_xv@=@h^`jtdTz t܀fHll3+S /'Y{sϿf39kf398 vK*;ƍl={ Pp0s_r @3+Wu12XUr)[Z\@@{t,R5$UPT6wQtgտfl @lIڛ:Y[ع '}fXٛ=@0 xO| Nh ]W:cgZ9ۼ9,vvƯnIf%^Z8a.8c_9^hgUnJ@gx)+__,poS%E"xRN~%p+qXd_ .JtW+8]J/8]*NW}%p+P.v|%+]_ ]t_ b26[qSVKlzmh||WCl`?.a=,@X`?,a-l@+, Xk8\uG5\@pEv^<8L\ewM3u Joas+ zM;X7UIOUCY|IPlD^L-s_}_mv9Ge\,)!cyh7˫H2KsǑwz{1heNIQ2*9Dnm,[Oo9U12*#81R`&ZV.:\ !LᢃLZ g1KXܭ| @4uPdfFϵ/^Tkk{hB?N7(O ?u_- sNG g`PVrkl CnI:MgL`&P./Q$/%zt}Q&Cvi=cq\w&"`Nc+|?v,ݾ-<~ E&f+zhfJZ ]u9ě?MOoOU"\Vh؅Y5u11 2Xتt q\D@OtH9OUIS E0ej8|u$-a_<}G {߇RuaGJ#u@_olXZUѥ=i>vFU[e!m~1[r~mҋ9~^XOkgYN8?sƪTǼѳYFXN J2` u YCL5\7B\BNp9(5\Ds3M <>-oH]5 `7!CVPG :I:Vco"=GY +{Umkݖ24Xխ$ciՠMj$7x+ }FzaQ`t=Vv[IXsدI%'7-n?$B,kO`C FwS1mȠgUX~6*T=W9B{sVO]kY1AꫤMߧE}UO(_9L`q|I.Ȁqn*J`P5nU~DڹW7&\Үb_a{JHkZGAhS35%+BJ6&V;4~ ">0ݱZ5H.{GMlP{%LBjVp HK΋V* upb ]cb~!\]'HG iQ ny@s[Lˣk]-hLWl^eN멭v!-GIE ؃ A^~~k3C__q|8$1ekUQuoYID9fs^z*G釁]+r$şcnWWs>d2ݵh:_Ni67NVX7Qdקf{}Ե .g~ au6i-җN*fcM/ ceAnB'm5ݧI㾻+-pt8ʘ+I&wdDff(cMcE3yPK/&*$0|)Z%ALI?,Sr=mG7cSmPᬐ[;ѻ8 k"qb[݋i:5/vpwcoݲS&gtDkOI>pj*VTӠ8Mk pK\GHBT'=d WK v ґPr Sy2+)uR ͓tiYx+mk {F}Փy5]ʒ{?F Qa&tl-VKK^?mr oyי;@/S ﳮ2^$vfw3N8ϤWZ,*0ulpzN|$g\7ar3€øG`?b)<GVU+N䠢X“w( xIo@M3 NW{"62_' =3hws߆,5 Xjo:!5m}9-,Ό #r oSj(T~HJ1 @"*ncX#Eɾ=k%%Z}g]װ>Ӕ-5U#%b0ܦ)rښWocӖQF]{|XUT҅6. =vZЊYnͦcldhS2G~*|/i$T=6aUYeINZïX)AϜ%De \Y*#fmUtX ]が/u YiR-a)Mb7so4d/ n49:Җ- e[M:i 9tmȯ6{aKy [=vq4`~ePx('_`d h=׋<з%r D-Yu'Z{Jm])C{K͑/sJtM͸0<><0;a\v*4NZ-aD9e}kޱ+g^6.LN70|c U%};3/^֌S{;Ti34KITYLt'0!+~/QH 0 ǯ N.3J^ rXѴ J+F/ų.Gz>g;* U,I.hN}A[Ing)uweU!Em+[U'\|s|#m3l)C;M(_4v:vvk$!-il^pWMF%V0f}~+Q2BڝpM\yسVI/wio>}M80\[ 5ʶ7~ֹx|􉰵h9*pS[JfЗ6JJޣBO•K]-J(*i&k2G7LNFGԍ 4ҝ'C&EV# UW5$&oZr0K2HҶdT 8^Y]W- asJDsVh=:u To#0JR0t%5%'"vU&r)ǽW ~g{+vmޘ0+sœ.<nU^b.hz-(]˼qD%K AL1kNJ{ƑsgD)6,oK*(;@iU4ZuEabھʍmh; k[9mJr%u<sX&hm%?Fu WbMƢט|޼ !V2lD?8V27/ ;dK@MU ҃hUEuf$3vJ=DaBXIƋE+#1OWVú挑ZdGEfށnEKJpӛkKQ{fCma]rPGXEs?c*Ңmp9Eknwӗ$ 5s)y/sYE=>Nۅs0pT0ـQ;Cwޮ;oMPuno}; TȂxs]q4 zH P-O"݂RmW>S$S$:0E'pa$̸(O9ЍT"qZu۴|KF=q#l?Aló;OJ}2cp&ĝ(4&cNϾbLC~wU1<׀H45^>K% p\`jua [uޭ[WbR=wsh&lJ+;W]E$-%镢lKMP|dvd|Am<5P^e-ЎcJ> G_.*3Z9v*n^5DbvaIwb»ecID&tp,[ Z#ׄjY,:R +tܬjtc滛}!1hJ98$!έjD`M`T4bJDHi!hznvXI-R'F$GJ+$#zN-S=&Y+^= :[T1CaJYܠP`6Ւ??Ε\` sF!Dړ7p1[^oƗWIwVP7ͽDjCLjTLzPӮ[bg:{lmOܞU/Յ8 K˰+߯XzI(+tT?-TEiިSL0}N塌UNf/9vva1G&[iϾ!\:͢aM{-aH) іU L3~uwzPM%~2?n)`95F/-5t z,xhwXykNp{5׻!l WݔVGsvn冷̏̍ZwR[~IO~gZo娣-./@hB`rs_qo3ibFXAֵM{ܩ1.s^O)u6œ$bGᆇKnarS^.-5l:QejMXe*-tNA=^.,?7OfRtE7,EQ&])a4"/pQޏˎ*v] NÆC;#y_7} +wqCZrӖrRŅg{%\GrA(gyԽf=qn~e^z<{ W]38IwL[[9}]LE-- R7 23-I>RAعe*wtw}s5fEg 9>H#E1'0 y0,݆,l /4rϓ;yNp,76?7.sHi 3rIFyI l\ :3L#X1+^koPPg/ oKz.v"-@ƫJVqJaHTxw1f]gM+Cˀn.UO¬}Wu+94L1_W)М͌o1/ rz^kґ_JZ?O[tFɞ꠿g7Y .]-ar|79'<[KDf<#qQXTo"%"άZȻG͠b)F_dU^'d]On27>9s 5j;/7]*/k K+Ui-;sX7Q7׺S#v7 >/Ϧĥ)VHwdsiEh-fe?w(rt g9: P 6ny+4~ >Nƒapo rtt wKd#\5vexӔ.\+TC?Sz< A=TwUWu}NbKȋA0o*a[cf>a7M&%uF~”x*% '_Ӓ;]kQ[x{{AneŒDGQ*-]l3 Bk|и(^d{T&jbrw1Ⱦ+=l Ǫ&="5OX]!saw=A o{ЗVyAz}F7I ~)0{)-a)69zf>$}KN N$Lwh6+:*HEhEbKU~r3;"iCΩ*߽cI2 ~<*(QZ%ާrMyI ]j/>)瓲?GT &,+ow[A0,}=J"YO8<bZ{0 PPD@¾zMFq,= Wo#` anO(4^+1[ ׾cuA$[N@r G$$XW#_\c^@9Wy3ݨ ԝafn/EF=2zs'% j*w煪Lx: 985qumz3 c},^O}7f` ե)cG3F^Kjw&e62BMWq6b`,4#GmG|p)VgzI""D2g`OպL= W&a'mUDz4`!'ɲ 2酾~-i#.EU⬾qdoQ18{'O 5 /[^еBWHOt 'iL1^e8Df/"Ka@YՑ3SJ۲?[#5] q@.46]UeI/f=U2 e vi"vĝ( uL7v}#}7l͟s>ݟ'P^V6#ItbTmw]] qSPnb${9PypI"o4=q\ap3Hk]F;i1 v u;c9ӐIln=R֡0uޭZv)M<o(7E1&!{N,#m>}Yl^O,Y:!X3sv6McЄ|`(z^Iˡo,-6~2}iPf4; ~SKb M`A \@Kw:F=X˚rJu84A`KVYMÌE Sao8 BzYަ _D+mx%h훵n5SB< )i}Ŵg#De5aDTٚ 2dJ9&.KR:\zH+ [.zoc=:t+5߲ *G{;;PzfDpy;|x%}uĚN<҄eRBR1&d6E'_!ϧ?5Cev!2Eq*'Wj"L#3H!$~^ONV}`5u:崋p04ǜನ9rjv1ށ >ތjڶ*td GjQ٢3Gm]@f3`f"I3o#˼7 Y{~?i ,T"Ь&O9ĵ$u _݅ñ qOBa-9 v,Jl5<5%\^^&.@ƺ PEI7 AKfe  R;,f]N?Z޳;+$8 =U^ktt*f3Tqo@z˴fv aͧr!I3GT֜>l$̵gBLq٬ Z4+keNK9"<%x*8alUm!}xHɉ@. f䛌Wr8Ɛ ww ۼݸI|]!K\s槙IHy)i+*!9 <0X~nrECH ?S2bR2E|Vk*Upf$gOE~!MC'aǙ%ZAyi?1!p$&wvJM 6[|8F#j3u}Eț:zcSl m-w=Z9u={O]lEԽ;:YRWq]bU2UHEkBzf_>+(!T0KԎ4<1M۬fNJ[@v]{i飇 >X{7Fkb_MwEV#HjG38zxKTOҽ>[ȱnB;3ʺ ']#PJ> endobj 54 0 obj << /Ascent 611 /CapHeight 611 /Descent -222 /FontName /FVJUEQ+CMTT10 /ItalicAngle 0 /StemV 69 /XHeight 431 /FontBBox [-4 -235 731 800] /Flags 4 /CharSet (/parenleft/parenright/asterisk/comma/period/zero/one/two/three/colon/semicolon/less/equal/greater/A/B/C/D/E/F/G/H/I/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/bracketright/underscore/a/b/c/d/e/f/g/h/i/k/l/m/n/o/p/r/s/t/u/v/w/x/y/z) /FontFile 55 0 R >> endobj 349 0 obj [525 525 525 0 525 0 525 0 525 525 525 525 0 0 0 0 0 0 525 525 525 525 525 0 0 525 525 525 525 525 525 525 525 525 0 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 0 525 0 525 0 525 525 525 525 525 525 525 525 525 0 525 525 525 525 525 525 0 525 525 525 525 525 525 525 525 525 ] endobj 348 0 obj << /Type /Encoding /Differences [ 0 /.notdef 40/parenleft/parenright/asterisk 43/.notdef 44/comma 45/.notdef 46/period 47/.notdef 48/zero/one/two/three 52/.notdef 58/colon/semicolon/less/equal/greater 63/.notdef 65/A/B/C/D/E/F/G/H/I 74/.notdef 75/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft 92/.notdef 93/bracketright 94/.notdef 95/underscore 96/.notdef 97/a/b/c/d/e/f/g/h/i 106/.notdef 107/k/l/m/n/o/p 113/.notdef 114/r/s/t/u/v/w/x/y/z 123/.notdef] >> endobj 39 0 obj << /Length1 750 /Length2 576 /Length3 532 /Length 1110 /Filter /FlateDecode >> stream xSU uLOJu+53Rp 44P03RUu.JM,sI,IR04Tp,MW04U002225RUp/,L(Qp)2WpM-LNSM,HZRQZZTeh\ǥrg^Z9D8&UZT tБ @'T*qJB7ܭ4'/1d<80s3s**s JKR|SRЕB盚Y.Y옗khg`l ,vˬHM ,IPHK)N楠;|`iC,WRY`P "P*ʬP6300*B+2׼̼t#S3ĢJ.` L 2RR+R+./jQMBZ~(ZI? % q.L89WTY*Z 644S077EQ\ZTWN+2AZuZ~uKmm+\_XŪڗ7D쨛Rl:/P1dɫϾ(l=Uhd_OܗEkv-X1tލ`i_y. 1dz:un~Q?3/S}] $e~s]F1ʻ/Q?m򻳷|<ċݺ/q'}I+6EgxT.GgtvՏGU|~]Rޅ_k9:{pG d}dN<6-uBoH=cMvHzqaRK~,K̞}˛myo~v _s>.#ҭߦ{/əkܗ\m|rXϾadj|ǝR/,2p0, HIM,*M,&irendstream endobj 40 0 obj << /Type /Font /Subtype /Type1 /Encoding 350 0 R /FirstChar 15 /LastChar 15 /Widths 351 0 R /BaseFont /EPPRQN+CMSY10 /FontDescriptor 38 0 R >> endobj 38 0 obj << /Ascent 750 /CapHeight 683 /Descent -194 /FontName /EPPRQN+CMSY10 /ItalicAngle -14.035 /StemV 85 /XHeight 431 /FontBBox [-29 -960 1116 775] /Flags 4 /CharSet (/bullet) /FontFile 39 0 R >> endobj 351 0 obj [500 ] endobj 350 0 obj << /Type /Encoding /Differences [ 0 /.notdef 15/bullet 16/.notdef] >> endobj 36 0 obj << /Length1 909 /Length2 2654 /Length3 532 /Length 3295 /Filter /FlateDecode >> stream xRy<{ߦ(gBP)nىUel)m,g_J"K,%!V٢lIMC$ީszs|߿s~ߟ7 D*\06r01Pp$ p8`H`\SW]SW I 2׏(+~ib5X p aq A=i*qX @DY v(@R`G& @Q$v/#͑T<!|>1/Hd f3"ł㰆D_<~R $.Q~A##ehs?jrw ٳ!4L/2%bI8": 4 a@Y8#z U%(#{" L M;g@2@ID/P Wgc?2o 5ClG7 b_ $b~/F q ωϪ 5vB8\h!`K .' zՋϬfZ[n*NS_îs.ruXVvZuY{Z! y:5k`s9}}q֌C>쮯_GpuLw.~[3;G8ѴhM-'ec\L@qtt&hϹ08{ T"´MNzZ}{粞ڵ*Tv#:|zD2/&/fW4U(5KúUEiu]+jh)bJiTKb ;Ņ]ixg Wý ֘|'ƣ; s(6م+%;CnL96nJB2c3즫NH~ ܵ+b6uNCg^O7"Z!uϟ,Hpͤ!B|lv`Î(<3z++=,zjdi_wnMWnUya5,Tj@%i/ڧ˕D \[ѓr||<% 1W 5sen1E[ev)NTxvٵ]ňA'קckfQV;45҂Dg2^kT:C4]倉*n>-G]RO[R&:;]p^{|Otq-*Cc)6{;:c?*5;e1@x7nt1z7C6o\o>ep |AX v%2V鯛h0Xh-;.ŹN=nEP [;ᗲY`m5ZtZRzOjJ*!#x킔kg*n>bu,`|Neī(Sr.v4wd5ofVIY)W{I/wx'\9el$::'wkCs9 EnMWBN^}z!usfSdv[Z:j9z%H.\2TdBQi2m7iwaO_ϜipH;g5)1U"SQj7y4imoQ9;]vZuؔ|t 6/.,wà t5sѲ'r+_m׹Q ]xP-ީ}("HZB anV߇9Uh첝>O1WżqFrcY΋<"MG\߶iEV(:vңYz˛`Aju;mRf1&BNwr"FI!Cq̍ T6p/Pﶷ EI7cD>Z?B`̽2=51C:M /<69laW>c=p26X^14/|kKLŻk\V}yA݀P+4"e gf{Mr>L5["/ojbU'-|NXvB ZlVQBKp%3$p.,B^IkIC]~ qJl'_4 A<>l נIx9c74U0|Hׇx.5X[M\rn\Ӯ(TƗI㓖A> endobj 35 0 obj << /Ascent 694 /CapHeight 686 /Descent -194 /FontName /AMNBUI+CMBX9 /ItalicAngle 0 /StemV 117 /XHeight 444 /FontBBox [-58 -250 1195 750] /Flags 4 /CharSet (/period/zero/one/two/three/four/five/six/seven/eight/nine) /FontFile 36 0 R >> endobj 353 0 obj [329 0 592 592 592 592 592 592 592 592 592 592 ] endobj 352 0 obj << /Type /Encoding /Differences [ 0 /.notdef 46/period 47/.notdef 48/zero/one/two/three/four/five/six/seven/eight/nine 58/.notdef] >> endobj 24 0 obj << /Length1 1103 /Length2 3572 /Length3 532 /Length 4289 /Filter /FlateDecode >> stream xy<}mle)Y/[kȮ첎5c1ØVd Y!K,ɒ-AZlȝz>{{s|真 +m$ ee 󀮩*c%D '55Mryyf1@C!`=A*7Aq)@A)6 X<XP2 ) H 18fOA84Pˌ$"~TQU9*a)f᩵PT%܀Ś٤{c {(`GڡfBbHX BEr0~CDxh8ˎ!-ڷ_v0sgYb?L8A/!H J@SA%% `pHT Dړ'0~Z2(S !Tۢ x,u[1կToRUֿ`?DD&FBFBy>ԛBjC1*BpZ|!53R3Bjz?!^(+2J)*ʐ (Hݻn) B0O#x<0T?U1HVǽYUpKx-Wr[ul(|sdz~z)eGx;|xÓU%Zwҹc!gt34֌?U`XȈJq3쩾#$2L zF\78wOaHuN1"F·$jvOP ?rBkɘX2tK\6.zV##Gg JT.xrDt"$Z?OκA+OWjM}O5C3>D|[0N9r|c(**f8d1)aONͦR~KïsP׏m?q0TakS+c%߸ѭ"zZ*N|GKvEC^6-!+ ;Zsﲷ n/uL;y|SϳtR,Oˡ!)YJ9̄6k Ț7 ^#kv!D &FUN<dLEռH_ƢDiJVL7PNp>`鴕W6t5AP`ΕZ˺ؘͣW3czG/V-7\uUrݤ7+ GJĹAI ]!_xRQCW*uT#ꚾ rRErpΕ4ęΎ>i9?' 0H;?JC X%}Hɿ;oBqln:Fܨ:%LSDЏeW~wDI7:.ʔ{ c=VfM%wCUwee5t{F T(k,RplVh;=I`n%9uI܃zU/ozoufmԽ 酺4özߍ4^{)k .*I&4(&tɝ"xTF&͠j!>+½|zΎL:& ~,(@kPy7G㽞ޤC{ҔJ014La끺*MwT4jbM(n2A=#2RkhRQC*\|2{az{ldWЗA! %4X"sǽb6AQ"/_\Cg2ŕg4nN%O^uЩ6q M|ws;x8yW V( P$҃O-iڮ2V^ҼZB_H?Rz NQywGn&ti~{O91FEIm߻lEk|7GUZLXViLNe Kel بx\gER3#7Qĝ6۫Ҭ[>Gc-ƠE_ Vz VqP(ؚWc?.JNel-Sz^T&KDkΣkft-D|Z3P`w\ y9]T6Y Ŷx.:={UǹA[}| bj2)To}7umM˳ xϴmkZ&vQl$Q꾕`U-)vͪf 6*u`8V62P$b:I4Mw&ԱkmByI}3YQi* ?%mހ((s!O{"1l0ψa;lZh(sW"7<7t3V%݌eԬ*9o+&/,%W?b`6[f䜡TąD*Ey ꯬.7>:f(Y[ZUgNܼWsE4UqSi@Y= 2v{aBytIPX&*6o~+@RX w]O=Y,k X t}4cN,{}mc (驣ƀ^x P۝s5! E;V%FJ^#J;d-nOFr\/!@xCCz]Z'zxBFǚ'Dl^ww|>ؼC8LZZ#=Sw"Ҹ%(L}if;Y6湘T*KMiӽǵ yLc|Lg3n4)<+Vܖh0?LcG hs;KpKx Y13R]ܗrcͫ.MZ= $z:VA ũ.:;z` wZ6F5~зAtR_wݍgଡTlԍ?!o{*ѱ$~23%ႸډMd\db2U[Mm]2&vAeC-- Y--nt{mY[oYO"L]ٝ;:]gfq5bUeS(O u?@r*~#Lry}eJl>B[kzrƠ;~F9Yf΀B ʷþ)ѠJ]pFrE6 e ү9 ̎RI*U^AWθ-Z'*7.InɩYSZ"Uޔ@F)Zzڧ 3f==8b\DSAj2:،a' (8'endstream endobj 25 0 obj << /Type /Font /Subtype /Type1 /Encoding 354 0 R /FirstChar 43 /LastChar 119 /Widths 355 0 R /BaseFont /AWYFXO+CMSS8 /FontDescriptor 23 0 R >> endobj 23 0 obj << /Ascent 694 /CapHeight 694 /Descent -194 /FontName /AWYFXO+CMSS8 /ItalicAngle 0 /StemV 87 /XHeight 444 /FontBBox [-65 -250 1062 761] /Flags 4 /CharSet (/plus/period/slash/colon/C/D/O/T/a/c/d/e/f/g/h/i/l/n/o/p/r/s/t/u/w) /FontFile 24 0 R >> endobj 355 0 obj [826 0 0 295 531 0 0 0 0 0 0 0 0 0 0 295 0 0 0 0 0 0 0 0 679 767 0 0 0 0 0 0 0 0 0 0 785 0 0 0 0 726 0 0 0 0 0 0 0 0 0 0 0 0 510 0 472 549 472 325 531 549 253 0 0 253 0 549 531 549 0 363 407 384 549 0 726 ] endobj 354 0 obj << /Type /Encoding /Differences [ 0 /.notdef 43/plus 44/.notdef 46/period/slash 48/.notdef 58/colon 59/.notdef 67/C/D 69/.notdef 79/O 80/.notdef 84/T 85/.notdef 97/a 98/.notdef 99/c/d/e/f/g/h/i 106/.notdef 108/l 109/.notdef 110/n/o/p 113/.notdef 114/r/s/t/u 118/.notdef 119/w 120/.notdef] >> endobj 21 0 obj << /Length1 1563 /Length2 12168 /Length3 532 /Length 13076 /Filter /FlateDecode >> stream xSx߶tбm۶ٱ*I:mtl۶mulW9W9UuQs֘s"!W01X;02p (K03 Bl /NVNVh|![7{3SG|r!Mb؛[;>s[+h,-_wB30:L̬$aml_a#'r;|JI)idcmo0tC?:YZ[+?_Vfn=`/ccϩj9Y稄%ff#y3GCS|c}K?q|:E5Uyͬlf If]foQL_^ } iLGkm3?m[OgO쿐 'Z8l>O'LOgoeLfƧ3a3u5X ~bc'ĎOw_,mbL$>s!6|:?V},g g$g?YA}VCdggg=?YO}6K}VWCMWOK9> gu?{JY/'_~B_S/ ?5煠 ?5lO ۿS/԰ ?5}q ?O+i~ZV64 L4,rd`4tx{!oY=CvyA>eIЮ| -U"tkT΅V{wjl.4Skt;A#mpl9 fθphRy1b.gO[;ӥ巻1dh)spA PQd@*lyR=Pywwٷl SXk/.A1S***c)f0Y`FOg5bGn'&Q>BդOI~AȄ -R=yB oSֶfaQmt }FQQ/ʖ2R?-KC%L4V%mk]HmCR~%FLdjs1O7 E.n6N'T")}U႔_;&ld_GCy-ϔvM" i.M+.qp(՛XuM㐋k:$ CDz L2Kn{]oa,UY>Ƶ[p)p1Zȅ,j -$G"%NϚ"ȎZl#pO&raCNj`1{08q=?rk+yKyɷLuPnׂ*<=WɎCQ~S'oVI NM%lPQ@ak @ !Zi~#j k`pRպRzQN&uFXFƚ4rةa{jpwT{FgFww? ^,4}Qe9xT=rs~D>Gㅜ.J_&%e@."؝=&$ҥ>VGDTZ&sY4Ԭvڌu WRr"]17' @ 29W̺V*}#RJm$Tnc]`!s銥g=婂kѡK>l764&k cM#ŎrEQĺO[BNp;:.+Q-֩l7rD!_\N`X{,=ϔ$4H~[+ӎN)dQ\d%4b2 qAG +s jcZR); 2F1ppf%EǗJ8-{jpdp۳"s49~蛌|,Tk>Dᅙ Q^?*JuSJGC¢K [)H1{T%9wmdX/"%oFތA О3G릭L_.C MKh ͩeq0PI#\yjMJvG WV 5vڨ Q~W ڴ[8E3qȢ:9?1 _ٱXʋ#unU =?=pH7^;>ds_0@S:{3lHf5o]c._뗿m1_r6xddmx']\k1u~Պ`~@Jd8cW Y[^7 E &SU1X$3ͭ%h' k9Fx(,]ayOa{!Opj}K_!E/v o=Ȭu_@39CXAb`rvIA6I#ALLp+v JyRhX {;1D:Mi/-%mQ L0rN/ZWA2SVu ޯ-qnFνxS<:qV6D},ֈ( c?=$"/Oj5BUA$ǚF7Œ1M7CfA#ẃ-2cxjmHXh #ooۉ[]nWw(K)-&[g>F0?zQ h%X3enKix lL%?@jZiIIUf'|'w:-; {qF"豻 38 =BQ,V\'͊]X+$͵rP!S$m ʐB$IX59/<H55tr$XR#_`e԰P__B-MP_вRyA1"2= zFI+؉a6ZO4e{~ {^)(#D- 1!4X7'AO^ƽlrI46@'w&>ޣ{L1G}ֺȫvQʂL?j\`es?<;ebmݸ.3@7p¸ae`=L}خS9w%o^lqI&(Mǫ 3~ [a9 >^cG6K܌ azpEJ,Ԫ 7:l#kdwXR!;=hy6BJc( At>zX(| !*6^<$rvI7{9Rs~v-w;SHK o s[< Mjo^hAMvbЙ 6,0׫]JtJު]81Sбy`rU{ }=Oc qp)#яą@ *E=uX ֏xLDj-~o < "%ǨdXCb̂b3sGѰe.q URf)M Q8ߍ5JY)AB3u Kn|tfv8^)_޾(D:yuumߺdwQrN0 dɑ'l ^?Fϙ澃MKrOnYRAakmk#/1lvD_60GiXNtŪ4TA3c\ ".w-(8xfp#Ԯ`;SU#c5UEzUv*,BCj⩆xRty~yd00.]@5`2.8O5d )q-voAVcܣ (4P-ق|:cwt9Y႔+$U`;BC⌗./'-^'|D&D.a]ʼnp.zXiztՋA?8Bg}.Jݓ8Ȩט2I'ΓzIng$-`ʸoFpK*J]nu3Aab:MCe^:TȤ$Jxy+QBA;\9^Ln_Um[)egX+=Ie[Κ1NWq5.. bN0z45,L'N}m2"uex[g R\ovu,)]vDlf3_)"óy[I 9OTޱ1׾G rW֋6:T: Ft6ǢxV1Hcؖr)~;}3y*%Ec ٜ 䡞?@sEW^)HiyXqh)+ ]Dž8 S6l\7+?9vk~Ϫt?Mۂ@0hXP z}SBƾt21deӍy)D*݂<}`<:xr= /MTqP ]v9Z'e#+ejS [pLҭ)`"SYZy2{j`ժ|wf'r%"7Sg|-H"ʸA*d뽩g]T܂XjbqSpJP56WDr)7QBrg~S9I,W|[>ݩ%.P%xު)Xy~, 慣@6W(2=pbc(];~m: 3[UiWsC(<1LlGCϹPxѯjng4^!F ۼ*&L8[oKHTkdӱ)5XY!\pDj(Q; pl12=~cA6ڪL-JΛ0 n^pU>[Ηʲ)V_HpKYx_ClZ'\˽,elIz C4TO `uxu|LH* LJKBrlM67;ٌtgtUEv6$eZt) Wu׸䶾]Af䩶t;^ !]CnyWMɮxUMx"cf{P "~nhN` f_j"\ -$wkW"$C#Ql: H:w@]^T6 Te-^7wrY"ȶ9@eH+wNtXN8)aweAx-334 Շe롊KboӚTc䷠4s)ZU#ᕫ~IG7[^ uN7lm$z`Άk8rgr ~vU\eb_UFSkJ~$ Bp-b"Y?358xRϩ [wTlS3Χrz_3]qx?ɾ\e/0]Vve^`&y'cLS a>S--li/[yjW=.w7Z,<؆Ng+]+*;Jf\7Ta}n)7)\tRO&Ob*8,6vG$ &~Q^CMMF3Sc~½/ x/p@X:xn8*e ;l:[l2l?De3ܢ(XhMU49V9ICY,8ja IPbp"ޘ#deSl*5OZ=hBFݲoM$wnfW V̂zL0t@ot֮u2vy>MZ7 ;00rPS灄sKgѣ>"b \O' 句oX]MAF -p3+NK΀U۽tZwnۆ.ED7vK0%5W q&΋x.?3o]V;gS+-3n5EYq \:c9E۫Ny$l(йJyc. nJ"$}fXz8GdjR⽪Cqf_G}gWL\S :PbZg{U Y>nWH=h8}zZ#6Y6h^5)m.tQׄݓ]׈ɭWOl%: @ޮ%O>OB)$o?g,*G6N tʹ"TbUGMi ^|Wjpymcs3, T [Evl%ل,jG B0YrH=f#Ko~&a'2feBT>,+4`oF6LK;vR>4MgUBvwY4F: =|2#(i﮵̫vAhngZx+1K𽳙n:N]}K:Հh|xĔ܁g[')kT:hَL)>J+`V}Ԭ񖦤e%j;cX =v(Cȕ/]yE ڷg &M%p^!"5sL~ddhed3[GvGuxt嗖-kYW^BWP n-Htt4~'R@8wdžU2g3L6E}@MN<z+q*VeZ VO6Njs>1dkDv"Ҧ* W7þJm^s8+M5;Y=͘fLn+&]^!iL{%qXQ. Y(n^&#嬳u_W%>渃(tMZ] YC&p>+pIn> LYrk` 'DI/{*i_BkmoK-ޕWg/ [C6hda S\NC18Y1|I&"TaT|PU/27좵I^W;VUL߁:9<_s ,GcL5myr)=Ns2UvO؏ߋu~ )sQAFBD3oDLb!W5TU,ѹBҌ6-rU5<=otPt\JKD:ʏI3 67PEj?k%;w3D8<MgF4u m!EyW@v0P/{ˑWCo$g4e8U Rc hJ3u֯7I]`)r}5&8 |~-aRwbZ} tPgà[(imdxqGpM@Ak+I=oM^{)s =빒m=L8Yueae7,H~)a2T{_ +g/H.3R6YX ߩ0 x3gjen 5?j>F] 7 wL$UǙC3q&i{P4~,P\̺<̦c)?n^KiXg^C!w(G?bTk v\Z2`gGY KOs+o%qϰшHbe;0!mT(I-@$4۟D-SGK#} Sn?yb#1 |݂'#7L;*,}TnihhƁo\nw7BA0ގے.,җd(*CAiN)e^K~hR'{"#RZ)ˏY^y[@|z6!|5k&<3&BTzGݪN7eꅓr/8 Vژ˵fCq.t5'[m`ݙbd*iV|8P>]%io g՜]+E|xWxSu;_n4i{&]I*?K4G>,^yBCpM,1uulR If昌A+rGfO=Ƣu2ɼ坓qd[cпǗP׍9X;TY]MMmc3H&2xЂ%~*\|qRuF:^*Iud.r|)#8u1~ L7P9,:9$:{fhqBQh,\H$9+ܩ{KG<0ر\dN{ mXn͌*䰖ٜL`,dnq҄WO2<$x0pR]0Z:%;"M> endobj 20 0 obj << /Ascent 694 /CapHeight 683 /Descent -194 /FontName /RAWUVP+CMTI10 /ItalicAngle -14.04 /StemV 68 /XHeight 431 /FontBBox [-163 -250 1146 969] /Flags 4 /CharSet (/ff/fi/fl/quoteright/parenleft/parenright/comma/hyphen/period/zero/colon/A/B/C/D/E/H/I/K/L/M/N/O/P/R/S/T/U/X/a/b/c/d/e/f/g/h/i/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z) /FontFile 21 0 R >> endobj 357 0 obj [613 562 588 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 307 409 409 0 0 307 358 307 0 511 0 0 0 0 0 0 0 0 0 307 0 0 0 0 0 0 743 704 716 755 678 0 0 743 386 0 769 627 897 743 767 678 0 729 562 716 743 0 0 743 0 0 0 0 0 0 0 0 511 460 460 511 460 307 460 511 307 0 460 256 818 562 511 511 460 422 409 332 537 460 664 464 486 409 ] endobj 356 0 obj << /Type /Encoding /Differences [ 0 /.notdef 11/ff/fi/fl 14/.notdef 39/quoteright/parenleft/parenright 42/.notdef 44/comma/hyphen/period 47/.notdef 48/zero 49/.notdef 58/colon 59/.notdef 65/A/B/C/D/E 70/.notdef 72/H/I 74/.notdef 75/K/L/M/N/O/P 81/.notdef 82/R/S/T/U 86/.notdef 88/X 89/.notdef 97/a/b/c/d/e/f/g/h/i 106/.notdef 107/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z 123/.notdef] >> endobj 18 0 obj << /Length1 2025 /Length2 15003 /Length3 532 /Length 16102 /Filter /FlateDecode >> stream xcx]Qcm۶1c۶llF4Ic|yߵv޿9y9xO2bE:!S{c =72#=#0NML$0~qr1Ñ;x:Y[QPA$d p41#3r01!R7x )320cb"24q!2[1$egfOﰩ7RDҤ"Jx@7w66FtD_F6`op"78T UD@TĂ8Kg_ ҲB4^)Yڹz:L8;ND:e&%fgbojigNNdd =@b#f"3x< v.GsKdfςל_#3- m ?Yj05BZg `g0+_ t1r g?A`I{[[?6" O ݟ;CsBD 6F"D ^'??uqtplٻ: 3_neu+:r jg?c!Qv ς !`)?,#5Dp"N_/.2".r". !N(!!!h!h.bddb p?!ßm,dL;F`%ӿ ن!___8vd:@+?B_r V!/\@+hB_7/Zy@+5{ƅ=阁g"b&N_oI<&pK&+PU= qk aϴQ m g!VFNw,` tGNN؜ iYe\ŤEyMX[q82Rh`Tp/1k)9+.M72vb"X'SG.$/;W>HI.TڐğڭH1gf͠y1!e8$x f :Y#?[ S)# *b6 )c:1 VQF{S%CD0T.Vi* <Lb3ÕB(ȅC6R sd;(/ vDnۋċNCP>F)teN5̗+, x J'8aMqگ&"#N_xieAc d3/@J^w;DEm5(HФu\! ߊ]9Ө+Iq2^rR;NLJM$E`"8|OHK5м$)}"BE@v/OAb&M"n_yVV@@uH *p#&}"T? 2[*H4Kp5EUeߺ|n`7v.^_mټqnΖCDrd-MtyVM/kSix`*<Su=0iBs{`tQAo3`XũdH<-fB V"T3;kJ*V$O\R\&˄pxX'0IGypWr$@EBEB Q?ˏ=;@:%NXN|@6#\h2@9EsʍOHRy;qq@m ) bIohw"\>JS^2b)[/Ŕ՜O~b?H<kBԐ@~b +B7ّSӾە \s 4fB~|eۺno fQP:EaaM:(#R i0?߾OE Q!֧kdtG<peH5y>@Qd^,S5yP4B8ͤSQղ ^4I얗=um)w|CS)["AΞrI}(ԟ̰\pa] Mn^`n ;o̕n_D5&ANJU;#[בgŝ~ryP]Dt k1Pp!dGqyWjV>(5ɝ1aaHD_u#S3QZZ\}𥊳.'` )r(‘~#HFIS&D? Fx-`e&Kksթ\mծ3 P+m/[+Y;l3`l*n$e 3Ϩ IS@b~ 8 H1H3/͛mK烋 tn:^C_3wuyC{r}}OF0Mӑ$y2nʠ" iHh~鉆zhu IR#B]`J"2c5LO1ѕAڛm! Z/CN) _:3^ f;.1%tbË(-R>{I[Vuč 4KҸL)qC]RJצ1\RUe^ ƦII"K ^SMDWZ ^g]صLͿ}޿I\(c S=%ЌeL]^rJn<Ǖ">~&<˨")S / qiӐR9tY).Z4́ *1$_Jɣܜ|=`b_8&:扑TURkaL5HTW7̸pl:^W1z^棢"^=Lb"AoO;}4]l4~KeA~@yiArRg-Y|`bi7|vȄ2m41?iOM;eqԙ$0EҌv=+Mcc/m$l 2]4lkH%kON|O/b;E=;Nw{39oeB3!kO|/(U0_ xM vtz}&Kmp 3ԗ2,s@_>y Aȗn106:ma j5;TMWhQS <^=~amC y?G_@@~mZV&!ޞb"j\NVsO.̄O vfm;_Do?MM% _!"ڽP6) J`3wRkc z[® e!tB(Ts-$oM' /uQ]I"IZ3s`ep-.^*=aV.G5fwN ix܋w)0w+hfYF߯I |&Hr($tEL."_4Ѱ[&Z!нQ[:_L܀L!\6c ލ|3\5j֟R9"sRgaK+K#"7o~5W,jW?Q-F.**O5}'82ʻFL"kM5)܀I@ - #j_9rP=slKER!EaS!L(T7*OռD']`r2+zTU '.C/AiB)J&W`pߗMY#p6O%ΰk V] *aYo}(tcW/SAR!%4*: Tz.SUPه m/Ρ3C z H`OY.dքE k׶}d'ݼGxs9r,2S NN>$y:z8N7eo BEV`1 O!vfm/I.6EQpe-85f u4xۮSNZ hnl"ߋU(*]Nn})l !j4ɞԏJo-q DD~( NQ€vgO5ᑡU%)4-bFk ux=\RczDqSS:A$L}5w^䟃 &O68E[ P15Q8VZ<`.5>@ҲV8>Sf+P~A~.*&"(.ѵP{H_1 3ƿOWV~|DjChY[E}%2HO5  $e@LX2<Å-f8GAA޳`}~%f>}Gd8.5W3NިIT'ڧjcS`C(np[*|XO <|: &L>QMJ>#vҕQ>\@ $8P!:4_Hb2Ģs1-%lUMX@(~ \. V{EhMq[O~#+3)P IեhQ@@aG2zWX=KH.k|}3aRDzTx~͎)"j}nE"\PvYW˗r`ŽFpEfq+ yip? E 5}_dM' |[T*6vM&?xa$*V^:bOꬢ k&QCRڍ$yl`C )[[B1tG2PٛJ(mN(gx6)A1/~n]vbZ;'&NØAsecy"st D q`ۦt]0nnpS`3E7jhl9A ,o?`'WCd՚|(TviJP<2l _0׮6!ݫeAJ+MUWVf$ 6keSW[RabQ·Ws*9Ad=IεBeȈreͨO+j=~4&#pMd!Z^}s" a?1K<VgMӉ-zs&_Q08 s(Aae'2}׍`U*f :-K+IAriEKmƪRאnm e[񪫸T=Be@$|:<-Ti9^3G7(hfbf|51?R>z7HU:K&4)R} ]HXn.fMٴy/}Stsۊ*[;s:5T6ng@VUZ8^%TĢ Tfq4/  X |eVazD>{=Eb)"s,icrc;gux;Sm#Dx;ӼcsY [K؍i/>-I'++%T䝖:FWLoCY #x,l(EV?&P}̭0( /[:bc|=Ɩl3.I({3 r@NA36TyJN׎+)8aHL9-ġHkA,1B8 I :;0,7 J51w۷4apvp.R,ut5;uܺwI)G笟pQ|ρr* SA!Y fDw\o)Ӏ˝Y 79K&Sn:)T'"a>x'*Up[]e2Ah q5و)ꦞ}sK͕ iY-#2hMav4M .WhVߎ*Vw&H%+u,FY(sY FkEsIu3 CQoG!z-fjKPچ~\1XBmp Z8u󗴆$` UnKFthqM+bPL1 =91$]̛Mc/yTVKi>E$H9< %!kw1Ҷ$dK'\2oe|w[u\ul{GavLIؽ)^hLWx J[q,x=g!unӽB7`};y&a܃aʞ$mzWK: ʶ~ɇg=XcNزBH&IoU;cByŮ-7>c1Pˁ☛PO1)8bU r.X◺3uWvAUtOC% J%5verأfed' t("9/R§V }O*o"1ab5"bm-c]4+;rvZCA׻_ uH˟19[30V}~`3~ |)N{ch=Ӽ*HÂ!+w K*q=ߕv6I`7{D,<4T1K&L>8 2"a̔iq qgIh+vOeE{LO8?CE:{>T/r:0BwVvD^ n;ÙLڍ2'ɕ(L7J)͸Q՟4kHc=+Zyx+^G EbM>||u[K;TC)["$T`^ { U'YMҸj輒y<[JPؠ[,_4jiS} R]K5/յ֛`1&.OTjN] u ]p&cnVC+GlK`2J~k扞˿ گ UtN[y $i61@qEd9DǛ^$_;3FG_p7j>e;\K=d8k/>:ۢm[>cHhXץi>ecL˒I"rv{r݅gPqׯ!OX2۳S{M̾oEpH~,Hv!'ΪĚ?{ 5P1Q&%`sDT߈%deC̩:Flʝ䋱AmZYd"6{V,I}@p'#J<ʉ6| /Cĕ_. ck}F, kwgh vF#@tI_5tՇ0C s`ɏSa6 &N|H*VNŬڏC 9cn"LCS_d @ܘԕgcl ^w^nYMcW;H3uoȫ~} C(|;\ 1RZ*\FCէ}[]N3]S m:\8h /tɟ UH>;| nɹO@-e nQj+\o|W^ `RDk)rJՔi^K2"s=]`r񿴀_O{Yyq>$mdI=й׾pʎwV%h"fXjU]/D4~7A`񣍇G &8,bí7ݎ%ɾ O( Q>`SFnLEd#RtU2\,v`wE2rHKU]u"Fo|Pսi νZODc o}ms/^,ʎf:|u710,,IIcAXlV,2L[Y ~5t }qQ/,UUbU:l&rr\i}D:aDT2Xwzκd֍2v r`J(Ո6AQ0g^E*ѺiY]{D`*'sW50ZälN^X=.Xevrz@aT<41~@8z&3L"T1sw xbɄTR d}0hYe[]K$"寝J8u|# tZa3t+ > <16Ě@=7P(N%zf6 Xz'>2!i㪑"O&H%q5Şìcps#5UPD*r';SoCeS%Z/ '-?+5G|ۢL񧡇gWqT*sӎ'CTݿrfE+Z-MIk) *]-!Wo`_?kv Po\p<Խ0 ^>vԱ6Q~,$;&̶LHg>#%E{o֨U"~a{u$V0Հ$A٩r'#f)-dњ_,E"i)rfUѨǾm2r" 9mA!휣a8}ʇL qlwh[$l^?eA늑FYewm@ß!_+e3Uz[fg % F mQ1Ï$IUq} dk?\WCj Ӷ yxR9b5:n{sK0дc "u?t-ڎі}Vٱ@,2~u"IJH٧7Ynb,ǻWg\%3om O\kMݱr$[U-]pL3.b_ ܖ_h+B{^][8-.]tARkN wz8t㨱iq*ltmiЧܘ\r®61ya.,ڵ}mp[J$"Ku+ey 9GcT(/J#U9: sj7~UIV\kwc^w0 q#TGi860eh{gx)hdjQTm0 ]&힣nC ^ /DCL:?! O8եf|KI(5Zxv TmXcsz}V3_d4biESYP3'Kżv d ڐN*%NR[W~"OC =WJqɤ*yE-UE['GՔK焾Zh!Lpn CܦۊQxv3cf}in]xk? r+e={G?VCȹ948xz4tr ƚCT Ԏ?O! TOm)S(W(OE<l艰R۸t=gM[-^Z\Wf⹌^f C:.q$\GJa:e<Tyg`HmtvhXxQ|bc` bHʐ@~|W8!l; "M@WЧyb@Igu\ @DlAl je-qxl\g$Em|1oLR6}kYa)UBO~8tK<1xK {uYؐ_~@j)tg0lk&Kjx()J)K Eo;OXtWxet90h9@î .Ȏjk1' Jf-.022{nqK3rz){:TאyP"*>^ߴ+86&Q }N.q=oInO8"ӟ6k)l#(Q?(T3"21Kla{"tz |x͵x!mM aHאi龴cI`! Uk8#M2D1۫V& m~G".EP'44hs,r:=6Ur 0W2!+,ŵ!TLV+a,Sls:.aʣuc~Fl{7(܍q-܎6xjSpB'ם}KtlO5fUƬ|K= b s [侷YkHv&}cgs՟}>d9J74ƙC] ;hl,2H2n7)aAnXo=rwAt?2PžqaFophy(;1LQ(R9d|ps*B'V3r\-#}1@=ڜeR{u5tصQ9-s{ཷBik}K?U,x-6zM(Ӷӝ 2n H{EʊW(FƱ~#3KGD- c>uFEz@c44ME'Nu! -yof{ޭZt #[|`2X!mKE'&x#sJ;rc}i$ƢO"cjO& Ǫ4ܫ%PYҪl+Wk3u2V:N6 йGT#K%Bwv\%8m궡 m~mQbUOIo#06<Eӵz6mLZuKӇT$T/d"Z>+)`{G; Y.X?'~Ev jJꢾ7zmtS ^%A߭yG忪6a(:D2{jMuspPqpV?k^% 5j{NȮHĔ Eׄ YA F){rYuҪ]fxg5!/#|.1S5[PK]t"N2q J詇jI3(/)h!RK*'#o.q;_l-<]H+H|?'Ppy%}!@THh7:uJ |b:*iocB;bJlQgT9DT$nhO%n+v<JkyV+"[MvPٿ $v unw+'n/]mHP7tDn:|тW`ÊhTq 3OO]6q's~s,}.ab#MtE[TڹaoXTXN 2dqv0`vG~n Q2n9ՠ @.<'aEfDYݻ K4#wP&7%fDB,ZɆ=[;}.;Y%fx/W&nui$hI8l2iUCʭ`u6}(U^"+{CA Cy2?*bjQvE~a~7!8 u~2u-G}7N5>D6;,lj1'?HJ WBUF:>GטF305!RmJ#: `2W)a%\ji[Px1X Lh;Ƿę56D"釞 YbNl4aK!Vu'- RPQ~ XGsOM_ߥ+G2L~eq7uߒ<7Qљԃp-% \b=%I?o'5;-+(4Fgy)^r c*}@o*r;̄u>"Gz8,%ˀtl2L5z{~aN+sw}2\^@|<~9ij_p=[mbO }L ٍUX_$ItUqhi͍h}trC*f5~SoY > endobj 17 0 obj << /Ascent 694 /CapHeight 683 /Descent -194 /FontName /JLATRJ+CMR10 /ItalicAngle 0 /StemV 69 /XHeight 431 /FontBBox [-251 -250 1009 969] /Flags 4 /CharSet (/ff/fi/fl/ffi/quotedblright/quoteright/parenleft/parenright/asterisk/comma/hyphen/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon/semicolon/equal/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/bracketright/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/emdash) /FontFile 18 0 R >> endobj 359 0 obj [583 556 556 833 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 500 0 0 0 0 278 389 389 500 0 278 333 278 500 500 500 500 500 500 500 500 500 500 500 278 278 0 778 0 0 0 750 708 722 764 681 653 785 750 361 514 778 625 917 750 778 681 778 736 556 722 750 750 1028 750 750 611 278 0 278 0 0 0 500 556 444 556 444 306 500 556 278 306 528 278 833 556 500 556 528 392 394 389 556 528 722 528 528 444 0 1000 ] endobj 358 0 obj << /Type /Encoding /Differences [ 0 /.notdef 11/ff/fi/fl/ffi 15/.notdef 34/quotedblright 35/.notdef 39/quoteright/parenleft/parenright/asterisk 43/.notdef 44/comma/hyphen/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon/semicolon 60/.notdef 61/equal 62/.notdef 65/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft 92/.notdef 93/bracketright 94/.notdef 97/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z 123/.notdef 124/emdash 125/.notdef] >> endobj 15 0 obj << /Length1 1825 /Length2 13050 /Length3 532 /Length 14067 /Filter /FlateDecode >> stream xUXM ݝ@ и;4Cp fKfS]DQA(noda023 SP8\,D\<nnV8 bding'@dibd3rڂrTM,.!?3@gД`ji0[3$egf=r:9Ҥ$Ml<@3x&y{P5 \Fzndki#m\]N9{S9a{UFD`T`fd Whg?@"*Yڹz:;?,'K3,?ٙ؛ZڙX9FNNF"v)31ٻ@-;=g2W? 6O&#' O?At`25a0Yx:X8@ AML^@'?nRsq$bkOY5$  t S&[%;'oVhcg(C"4W(o-P'@KCuI!Pu?.@UW7q+!Pu?@U@.@.oU7v22s?ρ6C&;3h!/!h!h!H/Y ?B_p A!H/ +׿d +/Yy +=0 ,>?q&NK_\@%=&&AV !žby%P1]3 6#2k5Oi{P{/mJc1)so{n{i^Wir( 7' k Z?\ (Rìuuqpj٨P(8} ]uGM\ m[osEʃ͎3{4t킀tJ Ӽ^_P\?.TAеA".|KRG-:\J7eyPqmj;5t0<Vs.}W.w2PGn^76myw1D ;(&724m)`dSy&V}FPbUn($C}I E't'?.җbDƘ`[{'= ,-"<D6aVsi;-to׺BR* rȔ %g u˼.3HvϹ,9!- ˄"8w]?ݙu!IS`2|*h39>evWވ˟ 0wPiscQW N=\p8g$/ В$;)C}DEmSйbٿwT˫4,(7f틒]4Cl'k%.S- <`CЯYeU]RyY^gQ@A9Gy{aMATh=9'q}enՂHxC@F DGw'4ښ;za_pd\S+6XhOp$] L!&&H D p~uy4 eÓ-L 1OG5h.\f/TK#wDJ]Ckei&>]<lB5a>?.>Ct4Jen Ίdv_>\p(ySܠ{x!bZ"CEb8C9r(`O*PGԮ>kTnR4êTFȗBl\>{{D$Wm[vyKl"kԵo]7:ܕ牺|,Fx>v϶Kc{^8g7A@ 0KAm{jEaVpゖמj(5w,;sԷ [l3|}ُz n,F47+C^|ޥDus}fOT~ ֆz_ܯ#D xroa ܒc'xvLF+#7cRUʅ&PE#U\&vʩ чc='cjuXX E co s_ɑ vmB+ᄤ^2PaD'UyzV>T /3dNj .#@7D]}sXN+ƀlP] oZPBJUG@wqּ^aR{*;iRGuL0LJLX\Td*mX٧&GuC+Oh7`B);>0+mG5ՄlK+y.b\oQEesƆ`<kJBjyXju!VXpʹJ^nh\cjax*:âzm+x?so`1~_fY`G38RtOgE^㓭;!3/MKh8@Eh{]Fw`3b/=Ωs,[.8ҹ7?4=j'FD~{jzR Yk0sѻ]4P#}Oҫޔ#`n=ֻAd<^9TvcH~ER0P\;NrjXP`27Xc#2m/ ;).^%..GYMB*P-eպ2۹G{޼t >lL8MXN'>yRWS1Y|(f_hb2$ׄk8{5Հ,/v,\<6ƽ׭w)ϙVk.W=y5Q4Wfwh`;ZEeɼ|vQ%B|A1%)l ho48eZq8r$X*摇< ={iB Pt`Ir~O&F}vڹkWWs)լq Xg3'g̓#Dѭ3G9cTWIfcYI``f` TQ7P1ޏ"2$+0y; 0,NV8,r5Y CȒ?vXh4Gl}kʁ%d7Ź!7%ړ0S3Ǩ5kxmuqn "x <1lOo)Ov%'QɪX3+-N~e2D$y[g/s$V'墍N+2.C*2yd{*ITG+ 4v +帡'Eμ=|hzʵ f.zxy3_TJ:fU2/ǘ+׈L >Rio2{?rk9F pY΍6MW6gbEeZEZKXzluD/{=rb PK=?}X5.c gS5fUT (E770qЛ^<c@P[XcdEöH Mcln 1އu.oG‹-1+VّuHZ=تXyCH+,ݮhHr]}kӈܤ=иo[hH`#GT^N>yA0X7 fޟ*=jO _9R~'kyZ540}=z?." ^UB_Y1ŅvgߺNGUNCt5)]bq+Ho88EN9&Xc9,n>I" o˵c+%֞q1$uɱ|$ {je`.)񆈊IT;ލ,brAkCSŭd1 XbbR#.^s9B63킪2nYyaʽ!U)˿C﬌8JNfɰSewP+T[Ǎʼn\籙a!T$ap$O <{∈3I!Hp STzo&ޥY+9(Uq {K}o0t4}BXԲ R"|ndfFՆ9"o>oїKc2Vw`+æOp05n8!._Q '7)x)Gۻ 9:{mk@Lkl[x[9 oX! zNY/!A{urk mZz zY~o'}GyQ)hul69N뜦Wƪ4Pꔌ#S[pp>O6c{~K7F瓅4'4Fp\Z`f*ޥ[@I_7 @#d{åw0`40L$: KF|Մ&WO1Oģ-Db+j'5+ugũ!IݰId~AM)'<vX*eŷe@J+ cAkSj qͺihDZ/C#]xYwߎɶnb BSwj])˥V>B(^Zր.k'ì{,$c荥[#ėoF}џh[αT;8ǰ㰏G`TЩf>zII7zG%L*NӦX C8a|oXV]EJq,$X>ɤ$M _0%rGxCÇ2)|oVBX8>RC}6ta%}ͭs/XNiM'w[26Q?1T۽ksHirż2ߞG,t2$߷Պd{Ϋ+AkL+q_i%d_Z]$SͥfIZ.qpmp/fη=,S~Z9m]s0:z3E?}}W\s3L^Bm G 9 1a.Ȼ~IE1#G(8KoR*=gj us]g utx868KÄ]=nhӐ>Y@vaɲtGTO)8#φ,r̦U$Kx&l wV]FD0mJ4:3G"(͙t^'g?8#g>"nY^~ oB/q[ַd9{W]qn[V[V+ Aʃ(Ӌ;QbUJA( 2Z CoMVEOעoV9k>J"2 R)zG^Qw"j^tAJ D>S{'ka+kpW`KtRE8M@:9 RjZ~[>+*ɮ%Hkاi3ak_MZ&``=IpkN[4.yw@4hXB=F3ͱԅ\qC!e:zuL7p2?"%pin;!DRѩ:lM!sygl1tnrGu^?ј[s'[#,"#ʆec9(!Af2 1==#qJ-=HБԴ qIjnh?ڴNk"NO\ڦYD{{=Ӝa45Ilg;. #Y}ŋ(UJ2ꮴ,5'?YmOgHMj̭Xr Gs`'1I!~2g!BsĚó1R RKKgKSDҙN2n@%⦛tWJBaӑVz\ sdsi`a]eӵUiԯ#yF\wU,Cy5X`{Xu9 (Tnj_¿f?>Ol%gǤ$ƦnkdQurm>5FȡYțh%EhK{ ʼs?MhYlg ba@owZAXl_/{ yjaZ 4kQCc K^Z  ۏq&PSfe{ba sḯ"rA+?'τ[ l¹K3㬫mb1foB S|ts*p"Т,P魸odOdeG8P((>x dNdce:c G.]j}}I:2/.9KV*+Ĩh/zu y17`e+o{V뿍-j+2p&u,m'⳿G3T.*c1MU2߿Xz;tG-^5OO҇"?&78:I 90o QXtHk- xP)&^4P2F=ӗy1a~\CIFB|^kjIns$Bnr'[禚ˈ^O;AX?d)x)v~rM65zJGZ M9q \["q _G4qGMcKӰ Cؐ*%Hq3 =F :n '#&Z5䃼X?ܠyZ NAG}\^ O#ܤAS8h`S/6TwE].k\;C6b1VrP7 έpC+Bv,^jduwx[V14!7pAY-H/u] S.ѵWh\{bHչ&+8=]ْmmEV߹T[I A]ZWyLp{%bZK~J >$'ӕNriEm Snu"vnиX})p*^VR/;f:-7l[= #:ҲȖo͒!A9epvn?[R50䧃Tl3XxML<ݘ ,On>Kڨ=@<1HָtѺ0m0˅r"܏t0: ӪˊY)}ѤB,X"[%72eF>.Nj[EĬo֏FSz!Diuk|ʗt<т[C moեrs_7xfiT,K c>^5ןz|9B5›z {Dq:w/]U6I"w,%`=/@ѹFL~c3qd7M m9|q7F-I~빲xC!됪+o]H(␔z"ۖ,oai \=s e)~^:ꋪᒘAb6yJ.|E&˶q6a4e/go)@ lT|*t] ~/fXof&'%z!Ym\)%wP#ؙmxNLO$ϸqJXMbfD`JWЇܷ6Z"UbRӋg^.ޑkh/qaӭ"ޡ(i+Zg4}E]ϙq:nL*l" ~t|g,yb9DYMCmU\5!į̂< ^h;LuX&oNNJSX.]kG&)*ZI5#Ը:y*X'e (I-i1 -'p;ǻ"ʔc!1y*IL[:'$L~\@8[%cUA=ܹcb%hFTR|N3r稺>H%NQGFyMzZ"QsAgc.7+;qm]@s3XEwGIQIW|u+^e(b W$7Q@+;/rߚ(8jFdf$˓v9%['YXZ-GkܳXGO74vSɏ}F*_|>}Q’$͍qQrNӻCv_(;AqiKVI'<sg=LOenDY>mH)/SzHRIOcR넚/R)4x{Ԓgݳ1XX0yk23 y4 YsyFެI/oitG_˹6-aōTm,_eemx }QG4RVnI/XqY@P<6mb\y vO,NXQO姭 HBM};}} Y\.-XvpenO$B^y8 uW Mf8I.Rq5AϧBDn?) ILMBJ`4yNCvk8SH.\3zN-[,`dCbHqsCgʻ&^_+kZ֊spkDj8A1YZAߚz/¼R\fKn)@#CR0{bu-7\9(CJx͂: jrm SL-Zia 1):pֳ*Dbw*pn#x- `65_Z>+hܤXYC$S4*+wb2,\0弸7JYŝ(>,z{Vy> 9-+ك-gU\[tL}#i_}5h&'Q"XDUbaH7>a"M`XZWʾc4$fMfU'u& uYU|f^bY4Yr뙯'a.p@^<|P$1Z9TG++ )Riufo\2A Һao.Sj-Z]knb61~& %>~.YU&yy`~MC>"4ts26#A[-е*Dbl<= p*FݺΏ|U\dC%INYU@NܘmSX,,`*1eČspץoZRK"D ]/fgXӭ &~uy:dx{f#X x뜚t ٯ=בkJ ޟF|I[wX)pȰ.ړ<7"\o ګܵ o~V؜{똤BJE;ZE6mz;s<&8ju Š9Сm7 ü^M?qo -x_~lC:,֔ .X_ա6КK}ޕ{?{2_7ÞFwկuPLi~dN ҅n{.4#DC~/B{6ψ I ML<7XǟZ$B=!0R id<ĿU(M+-JiRM(\;/֞zSEnz3$Ln=kp wA3-́*.@0uFOC <%*NwiPir &,+>N3:Y2# 6Wk;GPqo %[H;1}BTU|> i1+Tl`mfZ`ߖTBz`/RYko{\0j|#!n_-xvvkw9?@o~x):> endobj 14 0 obj << /Ascent 694 /CapHeight 686 /Descent -194 /FontName /KYGTTP+CMBX10 /ItalicAngle 0 /StemV 114 /XHeight 444 /FontBBox [-301 -250 1164 946] /Flags 4 /CharSet (/ff/fl/parenleft/parenright/asterisk/comma/hyphen/period/zero/one/two/three/four/five/six/seven/eight/nine/colon/A/B/C/D/E/F/G/H/I/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/bracketleft/bracketright/a/b/c/d/e/f/g/h/i/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z) /FontFile 15 0 R >> endobj 361 0 obj [671 0 639 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 447 447 575 0 319 383 319 0 575 575 575 575 575 575 575 575 575 575 319 0 0 0 0 0 0 869 818 831 882 756 724 904 900 436 0 901 692 1092 900 864 786 864 862 639 800 885 869 1189 869 869 0 319 0 319 0 0 0 559 639 511 639 527 351 575 639 319 0 607 319 958 639 575 639 607 474 454 447 639 607 831 607 607 511 ] endobj 360 0 obj << /Type /Encoding /Differences [ 0 /.notdef 11/ff 12/.notdef 13/fl 14/.notdef 40/parenleft/parenright/asterisk 43/.notdef 44/comma/hyphen/period 47/.notdef 48/zero/one/two/three/four/five/six/seven/eight/nine/colon 59/.notdef 65/A/B/C/D/E/F/G/H/I 74/.notdef 75/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y 90/.notdef 91/bracketleft 92/.notdef 93/bracketright 94/.notdef 97/a/b/c/d/e/f/g/h/i 106/.notdef 107/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z 123/.notdef] >> endobj 12 0 obj << /Length1 1634 /Length2 10337 /Length3 532 /Length 11271 /Filter /FlateDecode >> stream xUXqii]친go]UZi(4-A@] `gaCtmANRf` n `p q$A^6`$?&fNe3  X<]=,(K[ 0hmCNV –=tuAL -AN^K 8a?˸;89#? 9:x; PY]s_ޔ9*6swvuZق-lVfnƁNiRZ`WVgW?9ffrwL'aHu\m=l,ll쐉2-i' dCp\]ͼP ;Bv%feq! 5X\QNHYr@rB`u6s:9W2sO jrt4x9x !ρ, '࿙odC*RW * CR!)!!꿉 z uCu?Q :o!H],O~gG!O!da D/H첿"hBjB׎d !.B ?BlB BtBH!Ć_Bl|PAlx^!Ć?E$$@>̜\fnvH ;̳pw=?/hUle @OB0.1_` Zº)^[t;jghE:݇ ]]Onmc2.i/-ĺ^;ΔAo7\qCN(M+>8SLmQߝë+RGIR3)ne". 9)7jJm,͜YT#ytAlfKCe$g#m|ӌpVt3Uo}?˧噐J8XvKݖ UK3oY.ޯ85B/r6SWuCv\~"gb& ZYgoUٷ6dupX?Pa.ǩ?ͱT6\§zP@dda"eSgXۢLn3TnkYBr#ExZ<]gAbIsu)Zַorބx\$ez]UfO鴤eMΙ?|r#hݴs }E롐3YA7xRKX?q貍•LmUiʥ$SY6^z WV!^3)+|ؖ5':1N/ /̛8mp˙xS;Y>*YKXJQmWXc?U_# 7⮌yk|Xv͑ GIn~O T5 FXm_\%R6ImQ"aWJ#jfLY$ p!$z\W݇q9TͺX֣~,B̍=kL_ECYR*,wa~f=k^Dhm j#b3p( ?'lk8 T3Cɠ|H>\Ft^mrabGI'] i0}-&(U e<֢o)\\"g|0<ޘsJmg_sU~PfoȁF27yrwydCe Oƺ'M[,șl0o-˞a:gu[zqvW{nST!>TdAѱp-hK|9gӠ~1w|݋Ǒ5ⓧۋOgoV 'DwTQl00i!Pݻ޿9oKNFE(~AM c&oza KrTU n]R&ʒ4Q. ԪXɷm+&{FLȾLGYmOnʽřv`'@dfGJz^@ ֔Pɓ4|\72Rq?PPמx0´*5L0 BX֕C9nV"MQs4Og%"1u)&"S>S^N|4"0 /隟=ט-|ހŽD(po |+gz_w?KrpmcEZ+m >}l-XpxSRq R]4T>6ݔ)[̓_daIل Q6Z~Gڣp8_8c~"m'4S%b4J 6<=O_pUޫsٜ̰v'zAQ7"Kުd`{ ])V|yXAu(K//6f1&K#޴+i9t8`鏌5~ѽk3pqE`i8??>I$6!Wzg"\Ox 6Oִwb_);ZMVNL_;aEQlb0풜+{fͯ|QO6CZ-eri=z#q~{lJs _h߽=FC߳ 9z`pIˌC>l嵸iGYl]2c 88ץ|G\^POv.VO*wT~|V!o9J 忭$!Z1V,'mI5`aFUkx,qչKz,hDiYdam_x-Lqy LÏuil_I8w̌ -@}E89I?&-݂#aL^lV*g4+K:/|Rna *7̏wH[5weG~2BYR{svq=$7@uM7 iX8d~]F|E41P/$yRW ]E (a]9nX 0=+5i1LEy \(y;%(J0f9[D^\1Ct s<-~hD`Ö&2 @f7H_#}x_V\?ƌ8IP#dqf .Lթ(ץG.Hx[t[~҆bߛb0PJ#.gEUw/gy:p)?Zr=C>sޞi?;ZZkD0JfR!}}ZH'96q輤Ff>L+rE/BnYi+ LIϠO2#WxOnY[$ĨefHI?P3T%M+AG;8;:AvK\eiys&2=E0 ՂtI%9DJ#o;fBoZ~RUl.br#)QU2jqA 7 s+0[{^\??=Hh8Lt{_ڠr(ǚL4n79B6%ֹ3 @2[ť;GYfAdgo$6 OaQ[h/Rq(< 2 Ar xpfpG^Ȝ`q/X, +lԽPoib+WRsG(R<~məS9DV ~P&s*|tV#S\8cBcSMӒ_Oթ-.э}z8u9b 2ӪvO7 b 98[#YY"mܶq|nF=pj2Vrv5# :ZwVj$`L^eeGѪ{sH>qkSV*av {5XEf32E&xVG`iտ˵\vO5o_E&3ׂ-B<f9S4S86t*o%Cz0[Yc:&Ϗ4`SJBhjKi*-Ďܟ>y{Lo| Y}RsxeFQza+bt1B$yJ米+'cWg4l3R;Pt]?=&ˍޖ맾 h{u w$ %Nu=,zޠVN stZp댴99a~ ҇ҬrQ$#7^5$5]MhpQ>\֋`47oM%ܨuPRIN$83\+$[!>?eu)mˎ󓙼Y!Dܚ 9fPfen`;? "BOg0ۤ6x ^Ӈ!_w,$/=m~e"Xn "ěhE+z}+vTFHJSI޼%kBJ5͙UI; , /ՏɱBL WoHU{WƷ66i}S7Ѥ,5fUV'DW?VІV=l 四5]0ԘRls`<>PK:]]O}_.~fGHmшdLaϻl3Q{(yLqCG#Υ ? .\w:DzAɰ~] ^ۢ C%YؾnkV 3A\5w3Fj 6 ᔳ-䮪*-goğLʜB&&Z r9WՈbR_4OX4-3Ee s{L5oa2x I}Œ#r^ҩ cE?vP.&ojYo+Ah  Yo•.r.y9EZiWXsTOYrUr=^hxKDlWE _^΁0OsaL7S)>3$Rt )]EkNT$v zn$?[A4c7m5WYb̔5Ф(W?\e.ܪ| 4 1<Ȗ!:@oX;m yFapD]q ox gJHt>$GHUr,c2׫MV9c^n{(]ekO2Nc\ߋ*"GXEFkS{d9yG] 9ǭxs Ҩl" ɷԌF|\:TRɴ%'VSV'R wDSdX`*aiFP4d.\,澋|^ dG݈l]H:邠hXf4#ĘFT ztVPǺM bT=^MՃN=*iҹ/7<.ZObO6᤯DYOJ3"w6R]e]eksyok@=]<^ 8,WGR)%)g@iض+}N# z?𳙪"jFe,bĆw !JoJRljm-TW2q%% uɾ@-qϮn T?H79IPx h_*tT0y'4<@ȔPZd:Zg _- ވ1,Y@YܨV*@Ʀl>[Ui!@4;thM1u#çʗ-묔)ofDo8\lKx/^5'}x⡅)=T(뮕&5'B{O7 *rrbGn.-7rgB=By$j3LiޕU3n(^\$'MxiOmy^m пV!9 ldŲ3\6 gua~n[ĉ{Ŧ\\]ѩELވ 4} TͲ]ʘyYA킢͑-% .Bb@}0mb5ݢTr=Z1pS+N6寱s{n1xӀEĥoO~\z k"ʾ ;`x8#"SSdqvf7FO M?0]7"{y~v3h:4b˭fwE=F 0 c7npw{Bc«<&8VXo_Fу iPF #JILqarzX;Cv4c2$ 3(^)LRj̰G)Wzm#2EtB-ʑ${t9,4۬i]KbVǜ֠ަ2{`33Ydk8>Y0 m_DHrX500 ܃Z3y* /:?~/kwx_pf|8=gN)j{J7&=_k¾HS=1T"*Ts'Oezx7xI4oi6o<}ߏX7C'a15dfXe(þ6n%@7}Gʈ%:ׁgo i/ldwC6B4JP z<(n69L7ApeuVd{(;Hs A"&0yiBB,>ïPȜjeW Œ߂U*] Tldc Ӗl!x_ssYw1,-ɳt*8Ii˒( eq7Uhnd5^6]cV=aJi@ ||Fqc-.4x( vBd*z DÅM+bNl+?:lUp 3=:.C ėAMF}&I@A Xv5/m&m{sQB_%?Śۋ%?&iS"p'~Q;w+B ]PNA,4 <뷪?E^I߷gB<Dcrx )R ҏO-'tR"~'bo c Vz0xo8n+Wxd#310P♲{B6脫(4.$ʉzJsPXO}Y Z=7 |5#7*Ÿ)M̴ɿef6$˕Ϲ툿3Bb f>ψ{JPjڸ4:NB8bu=%7dF#RRlR~DǮ}o`S//4MH`XOA0~H2k{;됗4J\&;-xךQ4j)$3v#zW?ЊKQc%g/Ck~w+7y0-s#-OWJe8x>!\W\y+bCM*o%РvDA))=>(H8?.i1IX^O Hooa1&ْ Ĺ$'_h6Tӝ D3K(W?Te"!{Xڋ~I#Ewx1]p+Bu4E°P>Ѵ-81#x2\8M,Ȅg/Wv%k FXj%C1DO_}Mw`o*TGq_wMvT Z:+7R|/47_:؊jxڌq~ww 0ImVxmWa~fWDޟ`zF+# 5AC> .eV!'<7D?(NBk/&v2q[֏nTbUEGDze-MnQ;Z|]R Id($߫-|>?^FmوFU][򎉙."+rݝ z=@4VB;U~n8OI6غ eE-EuUYx%qSj?L06..J3zpއuʮ~S썈J㜘gmŗ:\XJtܴZ /#\mlp'5~/4x6GP, lo"yZbU*6ܖھd\UufY[k(+^N =\o<{DSޏ|GZ8!e!@eg*h ;}l؊s1zx|6_m|1`ҀP5wYke%&/ r/mY\W D_^8Ld8-}tU:UfҒpv$K!mp8Ybepk벞^keyR͝wbg u%Eј8^w9bã2,kEoVT(X!wp.0`򙏵X=ZY%_`f8|n0 SG*_|HUeTFpͯ+|YY|c: F&vYYH=/]9ȅ[HJ+Ncl{vNي~inV=}‰:#(n6ɕPo5z]~j *9 JJIgHX9>Q?tq-{}nt񮢪蠕@.Nz(wRSоmq|e4Eۆk8ݭKކmFwcf?vJ顨U4KeIC;k!3| .@1!4k!vZ!+uf_GpK+h*>3>nBhךV;ȕWf(:Cn6}.҄v0-$j1qN}LU5ubkw6Qn@>e$M̚0J-moV}) O8o ~EQxo[>騦;}R9yn* "q(zƁt8Nfݻ~ ,Vc*Ҭ&>8*W`ݻ%7ڿG,MhhweQX<D T6Ʉa.b1t<׽ !pf?O$pAf( s9zendstream endobj 13 0 obj << /Type /Font /Subtype /Type1 /Encoding 362 0 R /FirstChar 11 /LastChar 122 /Widths 363 0 R /BaseFont /IRZJUQ+CMR12 /FontDescriptor 11 0 R >> endobj 11 0 obj << /Ascent 694 /CapHeight 683 /Descent -194 /FontName /IRZJUQ+CMR12 /ItalicAngle 0 /StemV 65 /XHeight 431 /FontBBox [-34 -251 988 750] /Flags 4 /CharSet (/ff/fi/fl/parenleft/parenright/asterisk/comma/hyphen/period/one/two/A/B/C/D/E/F/H/I/K/L/M/N/O/P/R/S/T/U/V/W/X/Z/bracketleft/bracketright/a/b/c/d/e/f/g/h/i/k/l/m/n/o/p/r/s/t/u/v/w/x/y/z) /FontFile 12 0 R >> endobj 363 0 obj [571 544 544 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 381 381 490 0 272 326 272 0 0 490 490 0 0 0 0 0 0 0 0 0 0 0 0 0 0 734 693 707 748 666 639 0 734 353 0 761 612 897 734 762 666 0 721 544 707 734 734 1006 734 0 598 272 0 272 0 0 0 490 544 435 544 435 299 490 544 272 0 517 272 816 544 490 544 0 381 386 381 544 517 707 517 517 435 ] endobj 362 0 obj << /Type /Encoding /Differences [ 0 /.notdef 11/ff/fi/fl 14/.notdef 40/parenleft/parenright/asterisk 43/.notdef 44/comma/hyphen/period 47/.notdef 49/one/two 51/.notdef 65/A/B/C/D/E/F 71/.notdef 72/H/I 74/.notdef 75/K/L/M/N/O/P 81/.notdef 82/R/S/T/U/V/W/X 89/.notdef 90/Z/bracketleft 92/.notdef 93/bracketright 94/.notdef 97/a/b/c/d/e/f/g/h/i 106/.notdef 107/k/l/m/n/o/p 113/.notdef 114/r/s/t/u/v/w/x/y/z 123/.notdef] >> endobj 5 0 obj << /Length1 1772 /Length2 10992 /Length3 532 /Length 11984 /Filter /FlateDecode >> stream xUXACpi<8 58]<gfIf:in]UֻꫮRUEd9prH(rpJMl@n~~ =7 -@bcex+I1#@anjݼXbp].@ V he#9GK_a ]\!RIDhZ) ?gri?s׸98݀.%NKNdȹۘ9Z ٸJx-Tm̭ƁSm`TScAUSG7M/2쎋'2ߌG1)Gs#@pL]\LP 'B܀G ' 1fcuA [ qr؜L]@K +_=L]!jj'`398pجB7'`957?)7k_3 > ˟'$` +d'5W_f]cGܼ6GDx dLC$!/?iFAC.TWCJR]A UTWC . .o`lf.v@8u繃\l?$67qC !?_)hBz ! baB4 D/hB_p !.?_tb !V!Bl!/Xyu&.y !s.o ȥliB@O9\ 69OpZܪ%^{ 5x)ھdDq^K&.3kdڸys|˞^wU׮]1fG 7hy^@q[I}5Jƞ^]L{z:NJutuD`?pVKP')?ŸɝYcN]QY68_)C/`"*:k0J\n W'y^t"J-:ɖϝ&ʷc 2Mht5oh^9BB~W5gaJDXvcQm4-,Y;Kjc]n KaGu7TH%a)C^ 2ȋ~Wyo+bxH6)jmyX)1aߑjD~g,XmRG?).xJ[Vb*9EL*Lѓ\;z{$c*}5ksKF'Gb I6DAVPs;ꋮŠ11l y!휿 aPVLUeգ{adK܇ *lc̶sŔ-?rr.^˵>FPdN<}ȳˑ/pԚ?waLӐz;sرl2cI ONgp"Om毜y@;$&5Dd4g`H .ж1c=RA쵯N+BKM"yvʮ1/"pPӛ_{%0tN#ݖϤ\FT UiPm=J_+Hi@\:v(e/OFs~QTSrׁ6 H{\qvXe^Ǡ;&,IK1+JlzE@إgV35^{qlw7?s̮siuz$PmQwԷw6Q:RUa^MzY4rY=q5nSrL-C37f ׉0R<&llGO<\[#t0q*xEieFr=ă5>ejnJ  ,}G_V13ErmQ \ ӠpR#%bK*|9-DqU/ɢs.ܳ%Iqob>S*d7 Mrunkψr)L[x=eD_ZO_̺;6ҫq $-  SW铚!axV_*%kLHfؼLUR\M}ch`CL_aF@bdYjpkiHکφ9*~Bq_HǾLv0 *M[w+2}.G@SJ}Tqovny،&dܷWnBLA0+%GAqVfĄ׺N$w7 ΉZNFJzyϊy2ƾ^ p(KB4gȧgo.a~Oi2Jʕ=(P*hA[2,EoxͫPbT9݇{D1({Y nАdïϒd[=c/*CNmט4| YKU;`F# a흷wJǝlWѫ\l*r3ܦI_ô×6a\f7+&!4Q,n¬sJ KE;5+(tvU8_k-=_ vR|ѵ;fu@3Hb7kYD_3}rU8f~GߎW\KWJdä &m=>wX0LS9?r>&eI(%i* dPFhWGxo闲JpG]O .An#h,9,[LQh* Yci3OM;nVoX#s?hRs?by J^n]vۘvTmt17A "v]ǶեA,]fBᑅSi/|g ϒPX^KAlQ4grGI=%֛=Wo}-K/ _sXFHo)̥j%K\kf" gn9q@uE)M &%6(PD<>t,dsv/dTpd}IQ|2Î [M=w pd7H_~C.+t3i 1U=|;u֞vbOpv>At~?; C?>$ pk͕bq9ܿZG$;CȎ>q~!s^ܛ]I:XzmOIXf6 =eRMLbNm62  `645v@59<;sA} 'Ŕ 'GrHl͡ j5Mޓ*Uu]= 0k8aq1K,e"-,fyHX1IHzg޿r4\LB/y~r!XƓ5pHPē]4@UCM1*iNc2E2׻&6SGZgEء;8vb#Q/|D80'銉V4pxnRm¢-b(F]EҞ#"\;U?.i“)i*է) ҌER,L|YyC؉.S]CL_{%5\2d3%/gI8f͈ 6q$oNicƥ$ADT!{ m-)-q98HS9mSqL=Ó ϭ ͵01 \~O,_ydA»(jnb}Fjp1w1FWwX@2!y3P'PPV^-㈾]%Q'{ ;܆PqLD!Օ> G\)V ä<~"eq#%oBP6dX$m25, f9].yCZ#[XlPZհs tҴ92Ndg^pO6e i<7m0k]D<<_NKTuńg|q~ 7!/(ʚvk5dk1tvZeYгf;>uD)^"KNP^{`QgVw \ڏ(wh.=X ]+Mk BsS}٘#綤9(m2¿+]2kƅ}d^VpIl$CJi_VGK>by4:=7Šw (n{-WR- D"#~Qf_Oi҄l"doDz@ʹoO\.yTډ:V&=T"wE`\zUMM]i1PM.ɉۈfP儎יQgL{+Bne%R̸;1тQHV8$HaU 3J<AV+S"eQvhcʪZ 6nu >~Bª!Airk?OF@YiӬ (ĸHAhx7HbR#;T aǯG%)MQjQ"F:`()c+CYdlq瀞mSZv@x0L,S51L<~FD"FfxL@ߓ[Xb:sdiJgOۜf !SOMR߭v%:='((lIT4y;zCD*f_ɔ(PQY꫅S;G|s;)#Gn6yfE#Dsh`{}L)LASiD(~>B {P@GD 5\Of]#v=*)- eGߐgX&Ahw͂K#S`J?Zrǵͷӯ,NgM,es!#4ɡ;%֣<#X>07T姰l4'U{WuOv#[iKJ>lBelJ- *y<)7Ψ‹VV5+ܛ/Q׈WlGvڕIYxzgtJoV ϴKע̥')ްuJ˥}ZСQ 71vyzM |w_ITL@fCûЅt![CG46cK)SL<A>,(EHH15{TBee0J<['1 ԧ05eN 2 Eè%0;#9B r?VS-HR9%jf{Ќ>gҚT-aˋCvih(cfrScQarHJO_x!n6<Jpܞıt63- gDN[q4\@K6DY"Cn s˦P(*zav<&vpЖ֎$VkfOA?~=/}h^B&)K|^jx&Two? KϭN| tw*e&QLCic `<[B#H  ԳhVwz)I+Kp:_y2%7 UrstBaLfPc1g/u3,EMK'+3v.qP ǡ[1@ddYhNmLG_d{W9+wGS!It\/EKM-9ommtFmH L%R6X1bX/QR^oe!3ٵGrȌ |v[%b.ݭF/l ]LTV8d{pw\V"\('Вa톢?e|Cn6W>(U}Vg8&HyfI3;WYq6sSpzlETЙnvm\Hz;ml3lJ ;LT C+fYLaPk)y3D{GÅ1F>;/#;R`+f3x aǣ ! )~})L|k3a%\6f*+qyNx*!kO~I';RyKIe)~/(@&Luf,lƑ}~Zp3O:B+ Vb'ej( բ<=ٰBarvbGs݅KcܝaaѮpPv^M`{˽{ѹ[06i0 .x1C1?=nr{ E Tƕr^7w0?' p1[O@^AFvJ##/B n5x~ wE&*RI@˨/&RNtQYQ i۔uJw'α0]߫9 pcub+^Uz )Oz_W*Rjoas:ԛ$kyuFsfu"ꝿ]g Ro\-?[}}`ƆET`#JJSIi#6(`WbnAmCYhjk :0(,H%:0T}NseLMR)R Efu'(c񡼏ɩ:}R?O5||'g"Ϻߴ&Zfnْb#- JXc!.Ϝ&^FrUN,B;Aַt/hVG3m’JW )?>N @a[" sn:rt|5EmR<}α9sw_^ zۀ7Qsk'^DDаUeUI2[DOPc\o{z$qEj1\;$Hg~tцuȿYOG}|p%FxA|YBQD|  Tku ԭ9S|Ӝ?C)uk)~r>?-NýǮ(ugVK|WL=`(}x| dgۢ|12"m)a ;Zݳm-c6_c5ϧpv;P)_*˪EYD,!lߛrt|WXdٯ8ucvG`*6zTmS^p9pKʗ_cu+FU%E) 8.ZvUvO{ûQ&M k3Jt^fq)vfS |9euFJ? z sҙ4/vߏ7Fo]3{+ Ëcˋ5eG>7* a X: 5~\7 0NA?#9iӋSvV,S,Аj֞Yti@beRh| @~آ;G;|ljCmJ-c;Mx'J:e(b nx9XbW}tw(AL̜Ƴe)}pPT_䗅kgp xVj"L!]N -xp"ˋJczuzF?> :Ƭ V\S|:秳n0Q~`NO֢\Ȳ,J6lBY?-ϢEUXj 'FE ⏕97`k9 p+3>wC9S9F܂<#,P*5rA*w}RK Šs[nBtnʸfЧ+Si>_3KE͞0貛eOa]߂vK. 2&J@3DAX}3Y|o$y^LOzMw4M";1ǀRa/mE8{τe[O^S>ʂ r7G~X An=De[&8 VM͹ݩ7 (A6O;q/KbGq)=z֨W-t<ыE.CGISq}.tN̳r_屸iP:<^`mXB):`bloIǩިnG1 ,.ryYY, !U\nOzQ`B%#F1AͰ%N E`ցx:&f\ Ve8c-ṭ̌iXe+bBnRWV+|/;#?73-2U1qLϵUzWp1r'75yĎ9_5ʙPW;)ho2xJ :e7VYr U~­E~.'XBkH01SR3W^)/Th=ދ &E=尚 ]wF #[Je+`ZjPa_jQC61]u KPs} q\jBy/憃MdXr[8 Qd7T^s>mhnӣ\!8< *~qϚ0ǺXNKV3:ȱkHN_jOg|k:&=BQP D<X m}Pc°-,E}#)@^ L?4MdfŠ[$-DayLK2!Y"s lqsnLԋzN1NV!^z`H,F8HW eؾOCbsMWbA H`n4uq9ءWendstream endobj 6 0 obj << /Type /Font /Subtype /Type1 /Encoding 364 0 R /FirstChar 40 /LastChar 122 /Widths 365 0 R /BaseFont /ITKGAQ+CMBX12 /FontDescriptor 4 0 R >> endobj 4 0 obj << /Ascent 694 /CapHeight 686 /Descent -194 /FontName /ITKGAQ+CMBX12 /ItalicAngle 0 /StemV 109 /XHeight 444 /FontBBox [-53 -251 1139 750] /Flags 4 /CharSet (/parenleft/parenright/asterisk/comma/hyphen/period/zero/one/two/three/four/five/six/seven/eight/nine/A/B/C/D/E/F/G/H/I/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/bracketleft/bracketright/a/b/c/d/e/f/g/h/i/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z) /FontFile 5 0 R >> endobj 365 0 obj [437 437 562 0 312 375 312 0 562 562 562 562 562 562 562 562 562 562 0 0 0 0 0 0 0 850 800 812 862 738 707 884 880 419 0 881 676 1067 880 845 769 845 839 625 782 865 850 1162 850 850 0 312 0 312 0 0 0 547 625 500 625 513 344 562 625 312 0 594 312 937 625 562 625 594 459 444 437 625 594 812 594 594 500 ] endobj 364 0 obj << /Type /Encoding /Differences [ 0 /.notdef 40/parenleft/parenright/asterisk 43/.notdef 44/comma/hyphen/period 47/.notdef 48/zero/one/two/three/four/five/six/seven/eight/nine 58/.notdef 65/A/B/C/D/E/F/G/H/I 74/.notdef 75/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y 90/.notdef 91/bracketleft 92/.notdef 93/bracketright 94/.notdef 97/a/b/c/d/e/f/g/h/i 106/.notdef 107/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z 123/.notdef] >> endobj 7 0 obj << /Type /Pages /Count 6 /Parent 366 0 R /Kids [2 0 R 9 0 R 27 0 R 30 0 R 33 0 R 42 0 R] >> endobj 47 0 obj << /Type /Pages /Count 6 /Parent 366 0 R /Kids [45 0 R 49 0 R 52 0 R 58 0 R 61 0 R 64 0 R] >> endobj 69 0 obj << /Type /Pages /Count 6 /Parent 366 0 R /Kids [67 0 R 71 0 R 74 0 R 77 0 R 80 0 R 83 0 R] >> endobj 88 0 obj << /Type /Pages /Count 6 /Parent 366 0 R /Kids [86 0 R 90 0 R 93 0 R 96 0 R 99 0 R 102 0 R] >> endobj 107 0 obj << /Type /Pages /Count 6 /Parent 366 0 R /Kids [105 0 R 109 0 R 112 0 R 115 0 R 118 0 R 121 0 R] >> endobj 126 0 obj << /Type /Pages /Count 6 /Parent 366 0 R /Kids [124 0 R 128 0 R 131 0 R 134 0 R 137 0 R 140 0 R] >> endobj 145 0 obj << /Type /Pages /Count 6 /Parent 367 0 R /Kids [143 0 R 147 0 R 150 0 R 153 0 R 156 0 R 159 0 R] >> endobj 164 0 obj << /Type /Pages /Count 6 /Parent 367 0 R /Kids [162 0 R 166 0 R 169 0 R 172 0 R 175 0 R 178 0 R] >> endobj 183 0 obj << /Type /Pages /Count 6 /Parent 367 0 R /Kids [181 0 R 185 0 R 188 0 R 191 0 R 194 0 R 197 0 R] >> endobj 202 0 obj << /Type /Pages /Count 6 /Parent 367 0 R /Kids [200 0 R 204 0 R 207 0 R 210 0 R 213 0 R 216 0 R] >> endobj 221 0 obj << /Type /Pages /Count 6 /Parent 367 0 R /Kids [219 0 R 223 0 R 226 0 R 229 0 R 232 0 R 235 0 R] >> endobj 240 0 obj << /Type /Pages /Count 6 /Parent 367 0 R /Kids [238 0 R 242 0 R 245 0 R 248 0 R 251 0 R 254 0 R] >> endobj 259 0 obj << /Type /Pages /Count 6 /Parent 368 0 R /Kids [257 0 R 261 0 R 264 0 R 267 0 R 270 0 R 273 0 R] >> endobj 278 0 obj << /Type /Pages /Count 6 /Parent 368 0 R /Kids [276 0 R 280 0 R 283 0 R 286 0 R 289 0 R 292 0 R] >> endobj 297 0 obj << /Type /Pages /Count 6 /Parent 368 0 R /Kids [295 0 R 299 0 R 302 0 R 305 0 R 308 0 R 311 0 R] >> endobj 316 0 obj << /Type /Pages /Count 6 /Parent 368 0 R /Kids [314 0 R 318 0 R 321 0 R 324 0 R 327 0 R 330 0 R] >> endobj 335 0 obj << /Type /Pages /Count 5 /Parent 368 0 R /Kids [333 0 R 337 0 R 340 0 R 343 0 R 346 0 R] >> endobj 366 0 obj << /Type /Pages /Count 36 /Parent 369 0 R /Kids [7 0 R 47 0 R 69 0 R 88 0 R 107 0 R 126 0 R] >> endobj 367 0 obj << /Type /Pages /Count 36 /Parent 369 0 R /Kids [145 0 R 164 0 R 183 0 R 202 0 R 221 0 R 240 0 R] >> endobj 368 0 obj << /Type /Pages /Count 29 /Parent 369 0 R /Kids [259 0 R 278 0 R 297 0 R 316 0 R 335 0 R] >> endobj 369 0 obj << /Type /Pages /Count 101 /Kids [366 0 R 367 0 R 368 0 R] >> endobj 370 0 obj << /Type /Catalog /Pages 369 0 R >> endobj 371 0 obj << /Producer (pdfeTeX-1.21a) /Creator (TeX) /CreationDate (D:20060612084547+02'00') /PTEX.Fullbanner (This is pdfeTeX, Version 3.141592-1.21a-2.2 (Web2C 7.5.4) kpathsea version 3.5.4) >> endobj xref 0 372 0000000000 65535 f 0000000311 00000 n 0000000197 00000 n 0000000009 00000 n 0000362026 00000 n 0000349764 00000 n 0000361868 00000 n 0000363182 00000 n 0000004718 00000 n 0000004603 00000 n 0000000379 00000 n 0000348588 00000 n 0000337037 00000 n 0000348429 00000 n 0000335762 00000 n 0000321414 00000 n 0000335602 00000 n 0000320009 00000 n 0000303627 00000 n 0000319850 00000 n 0000302522 00000 n 0000289165 00000 n 0000302362 00000 n 0000288373 00000 n 0000283805 00000 n 0000288214 00000 n 0000007113 00000 n 0000006996 00000 n 0000004845 00000 n 0000007995 00000 n 0000007878 00000 n 0000007230 00000 n 0000009438 00000 n 0000009321 00000 n 0000008100 00000 n 0000283337 00000 n 0000279765 00000 n 0000283179 00000 n 0000279447 00000 n 0000278060 00000 n 0000279288 00000 n 0000011829 00000 n 0000011712 00000 n 0000009566 00000 n 0000013340 00000 n 0000013222 00000 n 0000011945 00000 n 0000363289 00000 n 0000016157 00000 n 0000016039 00000 n 0000013444 00000 n 0000019526 00000 n 0000019408 00000 n 0000016273 00000 n 0000276849 00000 n 0000264514 00000 n 0000276689 00000 n 0000022156 00000 n 0000022038 00000 n 0000019654 00000 n 0000024970 00000 n 0000024852 00000 n 0000022284 00000 n 0000028142 00000 n 0000028024 00000 n 0000025098 00000 n 0000031094 00000 n 0000030976 00000 n 0000028270 00000 n 0000363399 00000 n 0000033736 00000 n 0000033618 00000 n 0000031222 00000 n 0000036473 00000 n 0000036355 00000 n 0000033852 00000 n 0000039706 00000 n 0000039588 00000 n 0000036601 00000 n 0000042279 00000 n 0000042161 00000 n 0000039834 00000 n 0000045490 00000 n 0000045372 00000 n 0000042419 00000 n 0000048381 00000 n 0000048263 00000 n 0000045618 00000 n 0000363509 00000 n 0000051218 00000 n 0000051100 00000 n 0000048509 00000 n 0000053437 00000 n 0000053319 00000 n 0000051358 00000 n 0000055980 00000 n 0000055862 00000 n 0000053565 00000 n 0000058170 00000 n 0000058051 00000 n 0000056120 00000 n 0000060392 00000 n 0000060271 00000 n 0000058298 00000 n 0000063100 00000 n 0000062978 00000 n 0000060533 00000 n 0000363620 00000 n 0000065130 00000 n 0000065008 00000 n 0000063241 00000 n 0000066896 00000 n 0000066774 00000 n 0000065271 00000 n 0000069415 00000 n 0000069293 00000 n 0000067025 00000 n 0000071149 00000 n 0000071027 00000 n 0000069556 00000 n 0000073505 00000 n 0000073383 00000 n 0000071278 00000 n 0000075787 00000 n 0000075665 00000 n 0000073646 00000 n 0000363737 00000 n 0000078075 00000 n 0000077953 00000 n 0000075928 00000 n 0000080450 00000 n 0000080328 00000 n 0000078216 00000 n 0000082176 00000 n 0000082054 00000 n 0000080591 00000 n 0000084868 00000 n 0000084746 00000 n 0000082305 00000 n 0000086835 00000 n 0000086713 00000 n 0000085009 00000 n 0000089002 00000 n 0000088880 00000 n 0000086988 00000 n 0000363854 00000 n 0000091853 00000 n 0000091731 00000 n 0000089143 00000 n 0000094409 00000 n 0000094287 00000 n 0000092006 00000 n 0000097634 00000 n 0000097512 00000 n 0000094574 00000 n 0000100663 00000 n 0000100541 00000 n 0000097787 00000 n 0000103694 00000 n 0000103572 00000 n 0000100816 00000 n 0000106910 00000 n 0000106788 00000 n 0000103847 00000 n 0000363971 00000 n 0000109620 00000 n 0000109498 00000 n 0000107075 00000 n 0000112482 00000 n 0000112360 00000 n 0000109785 00000 n 0000115709 00000 n 0000115587 00000 n 0000112647 00000 n 0000117737 00000 n 0000117615 00000 n 0000115862 00000 n 0000120771 00000 n 0000120649 00000 n 0000117855 00000 n 0000123906 00000 n 0000123784 00000 n 0000120889 00000 n 0000364088 00000 n 0000126867 00000 n 0000126745 00000 n 0000124071 00000 n 0000129807 00000 n 0000129685 00000 n 0000127032 00000 n 0000132705 00000 n 0000132583 00000 n 0000129972 00000 n 0000134704 00000 n 0000134582 00000 n 0000132870 00000 n 0000136898 00000 n 0000136776 00000 n 0000134810 00000 n 0000139887 00000 n 0000139765 00000 n 0000137039 00000 n 0000364205 00000 n 0000142699 00000 n 0000142577 00000 n 0000140052 00000 n 0000145839 00000 n 0000145717 00000 n 0000142864 00000 n 0000149164 00000 n 0000149042 00000 n 0000146004 00000 n 0000152252 00000 n 0000152130 00000 n 0000149329 00000 n 0000155400 00000 n 0000155278 00000 n 0000152417 00000 n 0000157916 00000 n 0000157794 00000 n 0000155541 00000 n 0000364322 00000 n 0000160285 00000 n 0000160163 00000 n 0000158022 00000 n 0000163500 00000 n 0000163378 00000 n 0000160391 00000 n 0000166650 00000 n 0000166528 00000 n 0000163665 00000 n 0000169907 00000 n 0000169785 00000 n 0000166815 00000 n 0000172905 00000 n 0000172783 00000 n 0000170072 00000 n 0000176180 00000 n 0000176058 00000 n 0000173070 00000 n 0000364439 00000 n 0000177589 00000 n 0000177467 00000 n 0000176345 00000 n 0000180651 00000 n 0000180529 00000 n 0000177695 00000 n 0000183344 00000 n 0000183222 00000 n 0000180769 00000 n 0000185713 00000 n 0000185591 00000 n 0000183509 00000 n 0000189070 00000 n 0000188948 00000 n 0000185878 00000 n 0000190518 00000 n 0000190396 00000 n 0000189235 00000 n 0000364556 00000 n 0000193441 00000 n 0000193319 00000 n 0000190624 00000 n 0000195235 00000 n 0000195113 00000 n 0000193559 00000 n 0000198604 00000 n 0000198482 00000 n 0000195388 00000 n 0000202027 00000 n 0000201905 00000 n 0000198769 00000 n 0000204048 00000 n 0000203926 00000 n 0000202145 00000 n 0000206639 00000 n 0000206517 00000 n 0000204189 00000 n 0000364673 00000 n 0000209646 00000 n 0000209524 00000 n 0000206745 00000 n 0000212946 00000 n 0000212824 00000 n 0000209811 00000 n 0000214684 00000 n 0000214562 00000 n 0000213111 00000 n 0000217383 00000 n 0000217261 00000 n 0000214825 00000 n 0000219575 00000 n 0000219453 00000 n 0000217501 00000 n 0000222767 00000 n 0000222645 00000 n 0000219728 00000 n 0000364790 00000 n 0000225448 00000 n 0000225326 00000 n 0000222932 00000 n 0000227624 00000 n 0000227502 00000 n 0000225613 00000 n 0000229947 00000 n 0000229825 00000 n 0000227789 00000 n 0000232984 00000 n 0000232862 00000 n 0000230112 00000 n 0000235919 00000 n 0000235797 00000 n 0000233149 00000 n 0000238972 00000 n 0000238850 00000 n 0000236084 00000 n 0000364907 00000 n 0000241522 00000 n 0000241400 00000 n 0000239137 00000 n 0000244074 00000 n 0000243952 00000 n 0000241675 00000 n 0000246485 00000 n 0000246363 00000 n 0000244239 00000 n 0000248142 00000 n 0000248020 00000 n 0000246650 00000 n 0000250172 00000 n 0000250050 00000 n 0000248307 00000 n 0000253383 00000 n 0000253261 00000 n 0000250301 00000 n 0000365024 00000 n 0000256104 00000 n 0000255982 00000 n 0000253548 00000 n 0000258878 00000 n 0000258756 00000 n 0000256257 00000 n 0000261992 00000 n 0000261870 00000 n 0000259043 00000 n 0000264361 00000 n 0000264239 00000 n 0000262157 00000 n 0000277590 00000 n 0000277272 00000 n 0000279678 00000 n 0000279654 00000 n 0000283654 00000 n 0000283588 00000 n 0000288856 00000 n 0000288632 00000 n 0000303232 00000 n 0000302880 00000 n 0000320917 00000 n 0000320505 00000 n 0000336579 00000 n 0000336193 00000 n 0000349327 00000 n 0000348964 00000 n 0000362764 00000 n 0000362442 00000 n 0000365133 00000 n 0000365246 00000 n 0000365364 00000 n 0000365474 00000 n 0000365553 00000 n 0000365606 00000 n trailer << /Size 372 /Root 370 0 R /Info 371 0 R /ID [<78AE4FB03CCDDF3DFC1A68F13FD71D54> <78AE4FB03CCDDF3DFC1A68F13FD71D54>] >> startxref 365810 %%EOF pupnp-release-1.8.0/upnp/doc/callback.dxx000066400000000000000000000013551303304015100203020ustar00rootroot00000000000000/**@name About Callbacks * * The Linux SDK for UPnP Devices contains functions that generate * asynchronous callbacks. To simplify the application callback functions, * these callbacks are executed on a thread owned by the SDK itself. The * SDK executes the application's callback function in a thread * context so the application can allocate memory and preserve the information * it needs. The application can also use standard thread synchronization * methods to ensure data integrity. Due to the possibility of deadlock, the * application cannot call back into the SDK during these callbacks * unless explicitly noted. There is no restriction in calling into the * operating system or any other application interfaces. */ pupnp-release-1.8.0/upnp/doc/docxx.sty000066400000000000000000000707401303304015100177130ustar00rootroot00000000000000% docxx.sty % % Copyright (c) 1996 Roland Wunderling, Malte Zoeckler % Copyright (c) 1999-2001 Dragos Acostachioaie % % This file is part of DOC++. % % DOC++ is free software; you can redistribute it and/or % modify it under the terms of the GNU General Public % License as published by the Free Software Foundation; either % version 2 of the license, or (at your option) any later version. % % This program is distributed in the hope that it will be useful, % but WITHOUT ANY WARRANTY; without even the implied warranty of % MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU % General Public License for more details. % % You should have received a copy of the GNU General Public % License along with this program; if not, write to the Free % Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. % % % Switch off special characters except {}\ for the rest of the text. % \def\cxxtilde{{\tt\~\relax}} \addtolength{\parskip}{6pt} \catcode`\,=\active% \def,{\char`\,\penalty-8\ } %\def,{++ } \catcode`\,=12 \def\<{{\tt <}} \def\>{{\tt >}} \def\TEX{} \def\cxxExceptionsStr{} \def\cxxParameterStr{} \def\cxxReturnStr{} \def\cxxInvariantsStr{} \def\cxxPreconditionsStr{} \def\cxxPostconditionsStr{} \def\cxxSeeStr{} \def\cxxAuthorStr{} \def\cxxVersionStr{} \def\cxxDeprecatedStr{} \def\cxxSinceStr{} \def\cxxFileStr{} \def\cxxExceptions#1{\def\cxxExceptionsStr{#1}} \def\cxxParameter#1{\def\cxxParameterStr{#1}} \def\cxxReturn#1{\def\cxxReturnStr{#1}} \def\cxxInvariants#1{\def\cxxInvariantsStr{#1}} \def\cxxPreconditions#1{\def\cxxPreconditionsStr{#1}} \def\cxxPostconditions#1{\def\cxxPostconditionsStr{#1}} \def\cxxSee#1{\def\cxxSeeStr{#1}} \def\cxxAuthor#1{\def\cxxAuthorStr{#1}} \def\cxxVersion#1{\def\cxxVersionStr{#1}} \def\cxxDeprecated#1{\def\cxxDeprecatedStr{#1}} \def\cxxSince#1{\def\cxxSinceStr{#1}} \def\cxxFile#1{\def\cxxFileStr{#1}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Define ... to do verbatim listing % \catcode`\=\active \catcode`\=\active {\obeyspaces\gdef {\ }} \def\ccverbatim{\strut\begingroup \catcode`\\=12 \catcode`\{=12 \catcode`\}=12 \catcode`\$=12 \catcode`\&=12 \catcode`\#=12 \catcode`\%=12 \catcode`\~=12 \catcode`\_=12 \catcode`\^=12 \catcode`\|=12 \catcode`\/=12 \obeyspaces\tt} \def{\let\par=\endgraf \ccverbatim \parskip=0pt \ccfinish} {\catcode`\=0 catcode`\=12 gdefccfinish#1{#1endgroup}} % % Definition of structuring comands. % \newcommand{\Section}[1]{\section{#1}} \newcommand{\SubSection}[1]{\subsection{#1}} \newcommand{\SubSubSection}[1]{\subsubsection{#1}} \newcommand{\Paragraph}[1]{\paragraph{#1}} \newcommand{\Ref}[1]{{\bf #1} ($\rightarrow$ \ref{#1})} \newcommand{\URL}[2][]{% \def\name{#1}% \def\empty{}% \ifx\name\empty% {\tt #2}% \else% #1 ({\tt #2})% \fi% } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % printing line #1 of code #2 % \newdimen\cxxcodewidth \cxxcodewidth=\textwidth \advance\cxxcodewidth by -21pt \def\cxxCodeLine#1#2{% {\hbox to 20pt{\tiny\hss#1}\parbox[t]{\cxxcodewidth}{\small#2}}% } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for listing manual entries % \newdimen\cxxIdWidth \newdimen\cxxTypeWidth \newdimen\cxxProtoWidth \newdimen\cxxMemoWidth \newdimen\cxxPageWidth \cxxIdWidth=0.1\textwidth \cxxTypeWidth=0.15\textwidth \cxxProtoWidth=0.25\textwidth \cxxMemoWidth=0.43\textwidth \cxxPageWidth=\textwidth \advance\cxxPageWidth by-\cxxIdWidth \advance\cxxPageWidth by-\cxxTypeWidth \advance\cxxPageWidth by-\cxxProtoWidth \advance\cxxPageWidth by-\cxxMemoWidth \newdimen\cxxProtoMemoWidth \cxxProtoMemoWidth=\cxxProtoWidth \advance\cxxProtoMemoWidth by\cxxMemoWidth \def\cxxStrut{\vrule width0pt height0pt depth9pt} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % 1: type % 2: name % 3: args % 4: memo % 5: id \def\cxxitem#1#2#3#4#5{\noindent{% \setbox5\hbox{#5 }% \ifdim\wd5>\cxxIdWidth% \setbox5\hbox{\hbox to \cxxIdWidth{\hss#5}}% \else \setbox5\hbox{\hbox to \cxxIdWidth{#5\hss}}% \fi% \setbox1\hbox{{% \catcode`\&=4% \catcode`\_=8% \def{\ccverbatim \ccfinish}#1% }}% \setbox2\hbox{{% \catcode`\&=4% \catcode`\_=8% \def{\ccverbatim \ccfinish}\textbf{#2} #3% }}% \setbox4\hbox{\parbox[t]{\cxxMemoWidth}{{% \raggedright\sloppy% \catcode`\&=4% \catcode`\_=8% \def{\ccverbatim \ccfinish}{\em #4} \cxxStrut% \def\page{#5}% \ifx\page\empty% \hss% \else% \ \dotfill% \hbox to 0pt{\hbox to \cxxPageWidth{\hss% \pageref{cxx.#5}% }\hss}% \fi% }}}% % \ifdim\wd1>\cxxTypeWidth% \hbox to \hsize{\unhbox5\hbox to \cxxTypeWidth{\unhbox1\hss}\hss}\\\nopagebreak% \setbox5\hbox{\hskip\cxxIdWidth}% \setbox1\hbox{\hskip\cxxTypeWidth}% \else% \setbox1\hbox{\hbox to \cxxTypeWidth{\unhbox1\hss}}% \fi% \ifdim\wd2>\cxxProtoWidth% \ifdim\wd2<\cxxProtoMemoWidth% \def\tmp{#4}% \ifx\tmp\empty% \def\tmp{#5}% \ifx\tmp\empty% \hbox to \hsize{\unhbox5\unhbox1\unhbox2\hss\cxxStrut}\\% \else% \hbox to \hsize{\unhbox5\unhbox1\unhbox2 \dotfill\hbox to \cxxPageWidth{\hss\pageref{cxx.#5}}% \cxxStrut}\\% \fi% \else% \hbox to \hsize{\unhbox5\unhbox1\unhbox2\hss}\\\nopagebreak% \hbox to \hsize{% \hskip\cxxIdWidth% \hskip\cxxTypeWidth% \hskip\cxxProtoWidth% \unhbox4\hss% }\\% \fi% \else% \hbox to \hsize{% \unhbox5% \unhbox1% \parbox[t]{\cxxProtoMemoWidth}{% \setbox255\hbox{\textbf{#2} (}% \hangindent=\wd255\hangafter=1% \raggedright\sloppy% {\catcode`\&=4\catcode`\_=8% \def{\ccverbatim \ccfinish}\textbf{#2} #3\strut}% }\hss% }\\\nopagebreak% \hbox to \hsize{% \hskip\cxxIdWidth% \hskip\cxxTypeWidth% \hskip\cxxProtoWidth% \unhbox4\hss% }\\% \fi% \else% \hbox to \hsize{% \unhbox5% \unhbox1% \hbox to \cxxProtoWidth{\unhbox2\hss}% \unhbox4\hss% }\\% \fi% }} \newdimen\cxxtypestart \cxxtypestart=0.05\textwidth %\advance\cxxtypestart by \labelsep \newdimen\cxxnamestart \cxxnamestart=\cxxtypestart \advance\cxxnamestart by 0.25\textwidth \newdimen\cxxargsstart \cxxargsstart=\cxxnamestart \advance\cxxargsstart by 0.2\textwidth \newdimen\cxxargswidth \cxxargswidth=\textwidth \advance\cxxargswidth by -\cxxargsstart \advance\cxxargswidth by -\spaceskip \newdimen\cxxmemostart \cxxmemostart=\cxxargsstart \advance\cxxmemostart by 0.12\textwidth \newenvironment{cxxlist}[1]{ \begingroup \catcode`\,=\active% \paragraph{#1}\strut\smallskip\\ }{ \endgroup } \newenvironment{cxxnames}{\begin{cxxlist}{Names}}{\end{cxxlist}} \newenvironment{cxxpublic}{\begin{cxxlist}{Public Members}}{\end{cxxlist}} \newenvironment{cxxprivate}{\begin{cxxlist}{Private Members}}{\end{cxxlist}} \newenvironment{cxxprotected}{\begin{cxxlist}{Protected Members}}{\end{cxxlist}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Numbered Frame box % \newlength{\cxxBoxLen}% \newlength{\cxxBoxHt}% \newlength{\cxxBoxDp}% \newlength{\cxxSideHt}% \newlength{\cxxSideLen}% \newlength{\cxxTitleLen}% \def\empty{} \def\idPos{1cm} % % box with id and name [optional width] % \newcommand{\aBox}[3][1pt]{{% \small% \def\width{#1}% \def\num{#2}% \def\name{#3}% \setbox0\hbox{\hskip\width{ \strut\name\strut} \hskip\width}% % \setlength{\cxxBoxLen}{\wd0}% \addtolength{\cxxBoxLen}{\width}% \addtolength{\cxxBoxLen}{\width}% \setbox2\hbox{\normalsize\strut\rule{\cxxBoxLen}{\width}}% % \ifx\num\empty% \setbox1\hbox{\strut}% \else% \setbox1\hbox{\rule{\idPos}{\width} { \sf\bf\strut #2 } }% \fi% \addtolength{\cxxBoxLen}{-\wd1}% \setbox1\hbox{\unhbox1\rule{\cxxBoxLen}{\width}}% % \setlength{\cxxSideHt}{\dp0}% \addtolength{\cxxSideHt}{\width}% \setlength{\cxxSideLen}{\dp0}% \addtolength{\cxxSideLen}{\ht0}% \addtolength{\cxxSideLen}{\dp1}% \addtolength{\cxxSideLen}{\width}% \addtolength{\cxxSideLen}{\width}% \setbox3\hbox{\hbox to 0pt{\hss\rule[-\cxxSideHt]{\width}{\cxxSideLen}}}% \setbox4\hbox{\hbox to 0pt{\rule[-\cxxSideHt]{\width}{\cxxSideLen}\hss}}% % \setlength{\cxxBoxHt}{\dp1}% \addtolength{\cxxBoxHt}{1pt}% \setlength{\cxxBoxDp}{\ht2}% \addtolength{\cxxBoxDp}{-\width}% \addtolength{\cxxBoxDp}{1pt}% % \setlength{\cxxBoxLen}{\ht3}% \addtolength{\cxxBoxLen}{\ht1}% % \vbox to \cxxBoxLen{% \hbox{\unhbox1}% \vskip-\cxxBoxHt% \hbox{\hskip\width\unhbox3\unhbox0\unhbox4}% %\vskip-\ht2% \vskip-\cxxBoxDp% \hbox{\unhbox2}% \vss% }% }} % % box with id and name [optional width] of size #4 % \newcommand{\sizeBox}[4][3pt]{{% \setbox0\hbox{ }% \setlength{\cxxSideLen}{#4}% \addtolength{\cxxSideLen}{-\wd0}% \addtolength{\cxxSideLen}{-\wd0}% \addtolength{\cxxSideLen}{-#1}% \addtolength{\cxxSideLen}{-#1}% \addtolength{\cxxSideLen}{-#1}% \addtolength{\cxxSideLen}{-#1}% \aBox[#1]{#2}{\hbox to \cxxSideLen{#3}}% }} % % centered box with id and name [optional width] of size #4 % \newcommand{\cBox}[4][3pt]{{% \setbox0\hbox{\aBox[#1]{#2}{#3}}% \ifdim\wd0<#4% \sizeBox[#1]{#2}{\hss#3\hss}{#4}% \else% \setlength{\cxxSideLen}{\wd0}% \advance\cxxSideLen by -#4% \hskip -0.5\cxxSideLen% \unhbox0% \fi% }} % % right expanding box with id and name [optional width] of size at least #4 % \newcommand{\rBox}[4][3pt]{{% \setbox0\hbox{\aBox[#1]{#2}{#3}\hss}% \ifdim\wd0>#4% \unhbox0% \else% \sizeBox[#1]{#2}{\hss#3\hss}{#4}% \fi% }} % % left expanding box with id and name [optional width] of size at least #4 % \newcommand{\lBox}[4][3pt]{{% \setbox0\hbox{\aBox[#1]{#2}{#3}\hss}% \ifdim\wd0>#4% \setlength{\cxxSideLen}{\wd0}% \advance\cxxSideLen by -#4% \hskip -\cxxSideLen% \unhbox0% \else% \sizeBox[#1]{#2}{\hss#3\hss}{#4}% \fi% }} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Pagestyle for documentation. % \newsavebox{\cxxHeadName} \newcommand{\ps@docxx}{% \renewcommand{\@oddhead}{\headlinetext}% \renewcommand{\@evenhead}{\headlinetext}% \renewcommand{\@oddfoot}{\footlinetext}% \renewcommand{\@evenfoot}{\footlinetext}% } \newcommand{\makeHeadLine}[2]{ \global\sbox{\cxxHeadName}{\vbox to 0pt{\vss% \hbox to \textwidth{% \hbox to 0pt{\strut\hbox to 1cm{\hss}\quad#1\hss}% \hfil#2\hfil% }% \vskip 1pt% \hbox to \textwidth{\hrulefill}% }}% } \newcommand{\headlinetext}{\usebox{\cxxHeadName}} \providecommand{\cxxCopyright}{% \vtop{% \hbox to \textwidth{{ \tiny\sf This page was generated with the help of DOC++ \hss}}% \vskip -20pt \hbox to \textwidth{ \hbox{{\tiny\sf http://docpp.sourceforge.net}} \hss}% }% } \def\footlinetext{\hbox to \textwidth{ \vtop{% \hbox to \textwidth{\hrulefill}% \vskip -20pt% \cxxCopyright% }% \hss\vtop{\vskip 10pt\hbox{\today\hspace*{3cm}\textrm{\thepage} }} }} \pagestyle{docxx} \def\cxxTitle#1#2#3#4#5{\noindent{% \thispagestyle{empty} \vfill \begin{center} \Huge\bf \catcode`\&=4% \catcode`\_=8% \def{\ccverbatim \ccfinish}#1% \strut\\ \def{\ccverbatim \ccfinish}#2% \strut\\ \def{\ccverbatim \ccfinish}#3% \strut\\ \end{center} \if\cxxVersionStr\empty% \else% \begin{center} \small\sf --- Version \cxxVersionStr\ --- \end{center} \global\def\cxxVersionStr{} \fi \vfill \large \begin{center} \Large\em \def{\ccverbatim \ccfinish}#4% \end{center} \vfill \if\cxxAuthorStr\empty% \else% \begin{center} \sf\cxxAuthorStr \end{center} \global\def\cxxAuthorStr{} \vfill \fi \pagebreak \makeHeadLine{}{#2} }} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for contents % \newcounter{cxxContentsDepth} \setcounter{cxxContentsDepth}{0} \newdimen\cxxContentsLengthIncr \cxxContentsLengthIncr=18pt \newdimen\cxxContentsLength \cxxContentsLength=\textwidth \advance\cxxContentsLength by -\cxxContentsLengthIncr \makeHeadLine{}{Contents} \newenvironment{cxxContents}{ \ifcase \value{cxxContentsDepth} \vskip 40pt \hbox to \hsize{\hskip 8pt\hskip\cxxContentsLengthIncr\Huge\bf Contents\hss} \vskip 40pt \bf \else % >1 \rm \fi \begingroup \addtocounter{cxxContentsDepth}{1} \advance\cxxContentsLengthIncr by 8pt \advance\cxxContentsLength by -\cxxContentsLengthIncr }{ \addtocounter{cxxContentsDepth}{-1} \advance\cxxContentsLength by \cxxContentsLengthIncr \advance\cxxContentsLengthIncr by -8pt \ifcase \value{cxxContentsDepth} \vskip 12pt \or \vskip 9pt \else \vskip 3pt \fi \endgroup } \newcommand{\cxxContentsEntry}[3]{{ \def\emtpty{} \def\memo{#3} \ifx\memo\empty \setbox0\hbox{\parbox[t]{\cxxContentsLength}{\strut#2 \dotfill }} \else \setbox0\hbox{\parbox[t]{\cxxContentsLength}{\strut#2 --- {\em #3} \dotfill }} \fi \setbox1\hbox{\vtop{\vskip\dp0\vskip-\ht0\vskip-1.5pt\hbox to 20pt{\hss\rm \pageref{cxx.#1}}}} \hbox to \textwidth{% \hss\hbox to \cxxContentsLengthIncr{#1\hss}% \unhbox0\unhbox1% } }} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for class graph % \newdimen\cxxClassGraphShift \newdimen\cxxClassGraphLength \newdimen\cxxClassGraphHeight \newdimen\cxxClassGraphDepth \newdimen\cxxClassGraphTotV \setlength{\cxxClassGraphLength}{0.23\hsize} \setlength{\cxxClassGraphShift}{30pt} \setbox0\vbox{\aBox[5pt]{\strut}{\strut}} \setlength{\cxxClassGraphHeight}{\ht0} \setlength{\cxxClassGraphDepth}{\dp0} \addtolength{\cxxClassGraphDepth}{10pt} \setlength{\cxxClassGraphTotV}{\dp0} \addtolength{\cxxClassGraphTotV}{\ht0} \newenvironment{cxxInheritance}{ \par\medskip \begingroup \newcommand{\cxxCGSpace}[1]{% \vtop to \cxxClassGraphTotV{\hbox to \cxxClassGraphShift{% \vrule width0pt height \cxxClassGraphHeight depth \cxxClassGraphDepth% ##1}}% } \newcommand{\cxxSlashHline}{% \vrule width 0.1\cxxClassGraphShift height 3.5pt depth -3pt% \vrule width 0.1\cxxClassGraphShift height 0pt depth 0pt% \vrule width 0.1\cxxClassGraphShift height 3.5pt depth -3pt% \vrule width 0.1\cxxClassGraphShift height 0pt depth 0pt% \vrule width 0.1\cxxClassGraphShift height 3.5pt depth -3pt% } \newcommand{\cxxDotHline}{% \vrule width 0.06\cxxClassGraphShift height 3.5pt depth -3pt% \vrule width 0.05\cxxClassGraphShift height 0pt depth 0pt% \vrule width 0.06\cxxClassGraphShift height 3.5pt depth -3pt% \vrule width 0.05\cxxClassGraphShift height 0pt depth 0pt% \vrule width 0.06\cxxClassGraphShift height 3.5pt depth -3pt% \vrule width 0.05\cxxClassGraphShift height 0pt depth 0pt% \vrule width 0.06\cxxClassGraphShift height 3.5pt depth -3pt% \vrule width 0.05\cxxClassGraphShift height 0pt depth 0pt% \vrule width 0.06\cxxClassGraphShift height 3.5pt depth -3pt% } \newcommand{\cxxHline}{% \vrule width 0.5\cxxClassGraphShift height 3.5pt depth -3pt% } \newcommand{\cxxVup}{\hbox to 0pt{\hss% \vrule width 0.5pt height \cxxClassGraphHeight depth -3pt% \hss}} \newcommand{\cxxVlow}{\hbox to 0pt{\hss% \vtop to 0pt{\vskip-3pt% \hbox{\vrule width 0.5pt height 13pt depth \cxxClassGraphDepth}% \vss}% \hss}} \newcommand{\cxxLinkUp}{\hbox to 0pt{\hss\hskip 0.5\cxxClassGraphShift% \raise0.7\cxxClassGraphHeight\hbox to 0pt{\hss\textbf{\symbol{94}}\hss}}}% \newcommand{\cxxLinkDown}{\hbox to 0pt{\hss\hskip 0.5\cxxClassGraphShift% \raise-0.6\cxxClassGraphHeight\vbox to 0pt{% \hbox to 0pt{\hss\textbf{$\lor$}\hss}\vss}}}% \newcommand{\cxxLinkLeft}{\hbox to 0pt{\hss\hskip 0.0\cxxClassGraphShift% \raise0.0\cxxClassGraphHeight\hbox to 0pt{\textbf{\tt\<}\hss}}}% \newcommand{\cxxLinkRight}{\hbox to 0pt{\hss\hskip 1.0\cxxClassGraphShift% \raise0.0\cxxClassGraphHeight\hbox to 0pt{\hss\textbf{\tt\>}}}}% \newcommand{\cxxInheritanceEntry}[5][]{ \hbox to \hsize{\hss% \vrule width0pt height \cxxClassGraphHeight depth \cxxClassGraphDepth% ##2% \def\tmp{##1}% \ifx\tmp\empty% \def\tmp{##5}% \ifx\tmp\empty% \rBox[1pt]{##3}{##4}{0.24\hsize}% \else% \lBox[1pt]{##3}{##4}{0.24\hsize}% \fi% \else% \cBox[2pt]{##3}{##4}{0.24\hsize}% \fi% ##5\hfill% }\vskip-1pt } \newcommand{\cxxNone}{\cxxCGSpace{\hss}} \newcommand{\cxxLong}{\cxxCGSpace{\hss\cxxVup\cxxVlow\hss}} % \newcommand{\cxxPubLeft}{\cxxCGSpace{\cxxHline\cxxVup\cxxVlow\hss}} \newcommand{\cxxProLeft}{\cxxCGSpace{\cxxSlashHline\cxxVup\cxxVlow\hss}} \newcommand{\cxxPriLeft}{\cxxCGSpace{\cxxDotHline\cxxVup\cxxVlow\hss}} \newcommand{\cxxPubleft}{\cxxCGSpace{\cxxHline\cxxVlow\hss}} \newcommand{\cxxProleft}{\cxxCGSpace{\cxxSlashHline\cxxVlow\hss}} \newcommand{\cxxPrileft}{\cxxCGSpace{\cxxDotHline\cxxVlow\hss}} \newcommand{\cxxLastPubLeft}{\cxxCGSpace{\cxxHline% \cxxVup\cxxLinkDown\cxxVlow\hss}} \newcommand{\cxxLastProLeft}{\cxxCGSpace{\cxxSlashHline% \cxxVup\cxxLinkDown\cxxVlow\hss}} \newcommand{\cxxLastPriLeft}{\cxxCGSpace{\cxxDotHline% \cxxVup\cxxLinkDown\cxxVlow\hss}} \newcommand{\cxxLastPubleft}{\cxxCGSpace{\cxxHline% \cxxVlow\cxxLinkDown\hss}} \newcommand{\cxxLastProleft}{\cxxCGSpace{\cxxSlashHline% \cxxVlow\cxxLinkDown\hss}} \newcommand{\cxxLastPrileft}{\cxxCGSpace{\cxxDotHline% \cxxVlow\cxxLinkDown\hss}} \newcommand{\cxxLinkPubLeft}{\cxxCGSpace{\cxxLinkLeft\cxxHline\cxxVup\cxxVlow\hss}} \newcommand{\cxxLinkProLeft}{\cxxCGSpace{\cxxLinkLeft\cxxSlashHline% \cxxVup\cxxVlow\hss}} \newcommand{\cxxLinkPriLeft}{\cxxCGSpace{\cxxLinkLeft\cxxDotHline% \cxxVup\cxxVlow\hss}} \newcommand{\cxxLinkPubleft}{\cxxCGSpace{\cxxLinkLeft\cxxHline\cxxVlow\hss}} \newcommand{\cxxLinkProleft}{\cxxCGSpace{\cxxLinkLeft\cxxSlashHline\cxxVlow\hss}} \newcommand{\cxxLinkPrileft}{\cxxCGSpace{\cxxLinkLeft\cxxDotHline\cxxVlow\hss}} % \newcommand{\cxxPubRight}{\cxxCGSpace{\hss\cxxVup\cxxVlow\cxxHline}} \newcommand{\cxxProRight}{\cxxCGSpace{\hss\cxxVup\cxxVlow\cxxSlashHline}} \newcommand{\cxxPriRight}{\cxxCGSpace{\hss\cxxVup\cxxVlow\cxxDotHline}} \newcommand{\cxxPubright}{\cxxCGSpace{\hss\cxxVup\cxxHline}} \newcommand{\cxxProright}{\cxxCGSpace{\hss\cxxVup\cxxSlashHline}} \newcommand{\cxxPriright}{\cxxCGSpace{\hss\cxxVup\cxxDotHline}} \newcommand{\cxxLinkPubRight}{\cxxCGSpace{\hss\cxxVup\cxxVlow\cxxHline\cxxLinkRight}} \newcommand{\cxxLinkProRight}{\cxxCGSpace{\hss\cxxVup\cxxVlow% \cxxSlashHline\cxxLinkRight}} \newcommand{\cxxLinkPriRight}{\cxxCGSpace{\hss\cxxVup\cxxVlow% \cxxDotHline\cxxLinkRight}} \newcommand{\cxxLinkPubright}{\cxxCGSpace{\hss\cxxVup\cxxHline\cxxLinkRight}} \newcommand{\cxxLinkProright}{\cxxCGSpace{\hss\cxxVup\cxxSlashHline\cxxLinkRight}} \newcommand{\cxxLinkPriright}{\cxxCGSpace{\hss\cxxVup\cxxDotHline\cxxLinkRight}} \newcommand{\cxxFirstPubRight}{\cxxCGSpace{\hss\cxxVup\cxxLinkUp\cxxVlow\cxxHline}} \newcommand{\cxxFirstProRight}{\cxxCGSpace{\hss\cxxVup\cxxLinkUp\cxxVlow% \cxxSlashHline}} \newcommand{\cxxFirstPriRight}{\cxxCGSpace{\hss\cxxVup\cxxLinkUp\cxxVlow\cxxDotHline}} \newcommand{\cxxFirstPubright}{\cxxCGSpace{\hss\cxxVup\cxxLinkUp\cxxHline}} \newcommand{\cxxFirstProright}{\cxxCGSpace{\hss\cxxVup\cxxLinkUp\cxxSlashHline}} \newcommand{\cxxFirstPriright}{\cxxCGSpace{\hss\cxxVup\cxxLinkUp\cxxDotHline}} }{ \endgroup } \newenvironment{cxxClassGraph}{ \begin{cxxInheritance} \newcommand{\cxxClassGraphEntry}[4]{ \hbox to \hsize{\hss% \vrule width0pt height \cxxClassGraphHeight depth \cxxClassGraphDepth% ##1% \def\tmp{##4}% \rBox[1pt]{##2}{##3}{0.24\hsize}% ##4% \hskip\cxxClassGraphShift\dotfill% \hbox to \cxxClassGraphShift{\hss\pageref{cxx.##2}}% }\vskip-1pt } \newcommand{\cxxClassGraphEntryUnknownPackage}[3]{ \hbox to \hsize{\hss% \vrule width0pt height \cxxClassGraphHeight depth \cxxClassGraphDepth% ##1% \def\tmp{##3}% \rBox[1pt]{}{##2}{0.24\hsize}% ##3% \hskip\cxxClassGraphShift\hfill% }\vskip-1pt } \clearpage \pagebreak\strut \makeHeadLine{}{Class Graph} \vskip 20pt \hbox to \hsize{\Huge\bf \quad Class Graph\hss} \vskip 40pt } { \end{cxxInheritance} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for generic manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newdimen\cxxgenericstart \cxxgenericstart=\labelwidth \advance\cxxgenericstart by \labelsep \newdimen\cxxgenericwidth \cxxgenericwidth=\textwidth \advance\cxxgenericwidth by -\cxxgenericstart \newcounter{cxxDepth} \setcounter{cxxDepth}{0} \newlength{\cxxSize} \newenvironment{cxxgeneric}[5]{ % % some local definitions % \def\empty{} \def\type{#1} \def\args{#3} \def\memo{#4} \def\id {#5} % % pagebreak ? % \ifcase \value{cxxDepth} \clearpage % 0 \pagebreak \makeHeadLine{#5}{#2} \setlength{\cxxSize}{2pt} \or % 1 \strut\bigskip\bigskip\goodbreak% \setlength{\cxxSize}{1pt} \else % >2 \strut\bigskip\bigskip\goodbreak% \setlength{\cxxSize}{0.5pt} \fi \addtocounter{cxxDepth}{1} % % write synopsis % \setbox0\hbox{ }% \setbox1\hbox{\strut\large #1 {\bf#2} }% \setbox3\hbox{\strut\large #1 {\bf#2} #3}% % % box with id and name [optional width] over entire page width % \setlength{\cxxSideLen}{\hsize}% \addtolength{\cxxSideLen}{-4\cxxSize}% \addtolength{\cxxSideLen}{-2\wd0}% \setlength{\cxxTitleLen}{\cxxSideLen}% \addtolength{\cxxTitleLen}{-8\wd0}% \hbox{\aBox[\cxxSize]{\id}{\vbox{\vskip 1.5\parskip% \hbox to \cxxSideLen{\strut% \hbox to 4\wd0{}% \ifdim\wd3<\cxxTitleLen% \parbox[b]{\cxxTitleLen}{% \begin{raggedright} \noindent\large #1 {\bf#2} #3 \end{raggedright} } \else% \ifdim\wd1>0.7\cxxTitleLen% \parbox[b]{\cxxTitleLen}{% \begin{raggedright} \noindent\large #1 {\bf#2} #3 \end{raggedright} } \else% \addtolength{\cxxTitleLen}{-\wd1}% \unhbox1% \parbox[t]{\cxxTitleLen}{% \advance\lineskip 7pt% \begin{raggedright} \noindent\large\strut #3 \end{raggedright} } \fi% \fi% \hss\strut% }\vskip\parskip}% }} % \parbox[b]{\cxxSideLen}{\begingroup % \catcode`\&=12% % \catcode`\_=12% % \begin{flushleft} % \quad\large% % \ifx\type\empty % \ifx\args\empty % \strut{\bf #2}\\ % \else % \strut{\bf #2}\ \args % \fi % \else % \strut\type\ {\bf #2}\ \args % \fi % \end{flushleft} % \endgroup}}}% \ifx\memo\empty\else \vskip 10pt \begin{flushright} \it\memo \end{flushright} \fi \label{cxx.\id} \begingroup \def\cxxExceptionsStr{} \def\cxxParameterStr{} \def\cxxReturnStr{} \def\cxxInvariantsStr{} \def\cxxPreconditionsStr{} \def\cxxPostconditionsStr{} \def\cxxSeeStr{} \def\cxxAuthorStr{} \def\cxxVersionStr{} \def\cxxDeprecatedStr{} \def\cxxSinceStr{} \def\cxxFileStr{} \def\cxxExceptions##1{\def\cxxExceptionsStr{##1}} \def\cxxParameter##1{\def\cxxParameterStr{##1}} \def\cxxReturn##1{\def\cxxReturnStr{##1}} \def\cxxInvariants##1{\def\cxxInvariantsStr{##1}} \def\cxxPreconditions##1{\def\cxxPreconditionsStr{##1}} \def\cxxPostconditions##1{\def\cxxPostconditionsStr{##1}} \def\cxxSee##1{\def\cxxSeeStr{##1}} \def\cxxAuthor##1{\def\cxxAuthorStr{##1}} \def\cxxVersion##1{\def\cxxVersionStr{##1}} \def\cxxDeprecated##1{\def\cxxDeprecatedStr{##1}} \def\cxxSince##1{\def\cxxSinceStr{##1}} \def\cxxFile##1{\def\cxxFileStr{##1}} }{ \endgroup \addtocounter{cxxDepth}{-1} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for function manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxfunction}[5]{ \begin{cxxgeneric}{#1}{#2}{#3}{#4}{#5} \renewenvironment{cxxnames}{\begin{cxxlist}{Arguments}}{\end{cxxlist}} }{ \end{cxxgeneric} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxentry}[5]{ \begin{cxxgeneric}{#1}{#2}{#3}{#4}{#5}}{\end{cxxgeneric}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for union manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxunion}[5]{ \begin{cxxgeneric}{#1}{#2}{#3}{#4}{#5} \renewenvironment{cxxnames}{\begin{cxxlist}{Members}}{\end{cxxlist}} }{ \end{cxxgeneric} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for typedef manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxtypedef}[5]{ \begin{cxxgeneric}{#1}{#2}{}{#4}{#5} \renewenvironment{cxxnames}{\begin{cxxlist}{Members}}{\end{cxxlist}} }{ \end{cxxgeneric} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for macro manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxmacro}[5]{ \begin{cxxgeneric}{\#define}{#2}{#3}{#4}{#5}}{\end{cxxgeneric}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for class manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxclass}[5]{ \begin{cxxgeneric}{#1}{#2}{#3}{#4}{#5}}{\end{cxxgeneric}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for namespace manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxnamespace}[5]{ \begin{cxxgeneric}{#1}{#2}{#3}{#4}{#5}}{\end{cxxgeneric}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for interface manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxinterface}[5]{ \begin{cxxgeneric}{#1}{#2}{#3}{#4}{#5}}{\end{cxxgeneric}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for variable manual entries % arguments are: % #1 type % #2 name % #3 args % #4 memo % #5 number % \newenvironment{cxxvariable}[5]{ \begin{cxxgeneric}{#1}{#2}{#3}{#4}{#5} \renewenvironment{cxxnames}{\begin{cxxlist}{Names}}{\end{cxxlist}} }{ \end{cxxgeneric} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for documentation % \newenvironment{cxxdocumentation}{ % % switch on special characters for documentation section % \begingroup \catcode`\&=4 \catcode`\_=8 }{ \endgroup } \newenvironment{cxxdoc}{ % % switch on special characters for documentation section % \begin{cxxdocumentation} \strut\\\noindent% }{ \smallskip \def\empty{}% \ifx\cxxReturnStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Return Value:}\hss}% \parbox[t]{0.7\textwidth}{\cxxReturnStr}\\ \fi \ifx\cxxParameterStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Parameters:}\hss}% \parbox[t]{0.7\textwidth}{\cxxParameterStr}\\ \fi \ifx\cxxExceptionsStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Exceptions:}\hss}% \parbox[t]{0.7\textwidth}{\cxxExceptionsStr}\\ \fi \ifx\cxxInvariantsStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Invariants:}\hss}% \parbox[t]{0.7\textwidth}{\cxxInvariantsStr}\\ \fi \ifx\cxxPreconditionsStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Preconditions:}\hss}% \parbox[t]{0.7\textwidth}{\cxxPreconditionsStr}\\ \fi \ifx\cxxPostconditionsStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Postconditions:}\hss}% \parbox[t]{0.7\textwidth}{\cxxPostconditionsStr}\\ \fi \ifx\cxxSeeStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf See Also:}\hss}% \parbox[t]{0.7\textwidth}{\cxxSeeStr}\\ \fi \ifx\cxxAuthorStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Author:}\hss}% \parbox[t]{0.7\textwidth}{\cxxAuthorStr}\\ \fi \ifx\cxxVersionStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Version:}\hss}% \parbox[t]{0.7\textwidth}{\cxxVersionStr}\\ \fi \ifx\cxxDeprecatedStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf\it Deprecated:}\hss}% \parbox[t]{0.7\textwidth}{\cxxDeprecatedStr}\\ \fi \ifx\cxxSinceStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf Since:}\hss}% \parbox[t]{0.7\textwidth}{\cxxSinceStr}\\ \fi \ifx\cxxFileStr\empty\else \noindent\hbox to 0.3\textwidth{{\bf File:}\hss}% \parbox[t]{0.7\textwidth}{\cxxFileStr}\\ \fi \end{cxxdocumentation} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % environment for commented listing % arguments are: % #1 Section title % \newenvironment{cxximplementation}[1]{ \goodbreak \begin{cxxdocumentation} }{ \end{cxxdocumentation} } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \def\cxxCodeLine#1{ \strut\hbox to 20pt{\tiny\hss #1}\small %\advance\leftmargin by 20pt %\advance\textwidth by -20pt \ccverbatim \parskip=0pt \cxxCodeFinish} {\catcode`\=0 catcode`\=12 gdefcxxCodeFinish#1{hbox{#1}endgroup}} pupnp-release-1.8.0/upnp/doc/intro.dxx000066400000000000000000000012541303304015100176770ustar00rootroot00000000000000/**@name Introduction * This document gives a brief description of the Linux SDK for UPnP * Devices API. Section 1 covers the license under which the SDK is * distributed. Section 2 talks about the callback functions used * in many parts of the API. Finally, section 3 details the structures and * functions that comprise the API. * * The Linux SDK for UPnP Devices version 1.2 supports the following * platforms: * \begin{itemize} * \item Linux* running on an Intel Architecture processor * \item Linux running on an Intel StrongARM or XScale processor * \end{itemize} * * {\bf *} Other brands and names are the property of their respective * owners. */ pupnp-release-1.8.0/upnp/doc/license.dxx000066400000000000000000000032171303304015100201670ustar00rootroot00000000000000/**@name License * * \begin{center} * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * \end{center} * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * \begin{itemize} * \item Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * \item Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * \item Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * \end{itemize} * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * */ pupnp-release-1.8.0/upnp/doc/upnpsdk.dxx000066400000000000000000000006311303304015100202260ustar00rootroot00000000000000/**@name Linux SDK for UPnP Devices v1.4 * *\begin{center} * {\bf Linux SDK for UPnP Devices Version 1.4} * * Copyright (C) 2000-2003 Intel Corporation ALL RIGHTS RESERVED * * Revision 1.4.1 (\Date) *\end{center} */ //@{ //@Include: intro.dxx //@Include: license.dxx //@Include: callback.dxx //@Include: ../inc/upnp.h //@Include: ../inc/upnptools.h //@Include: ../inc/config.h //@} pupnp-release-1.8.0/upnp/inc/000077500000000000000000000000001303304015100160215ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/inc/ActionComplete.h000066400000000000000000000010111303304015100210710ustar00rootroot00000000000000 #ifndef ACTIONCOMPLETE_H #define ACTIONCOMPLETE_H /*! * \file * * \brief UpnpActionComplete object declaration. * * \author Marcelo Roberto Jimenez */ #define CLASS UpnpActionComplete #define EXPAND_CLASS_MEMBERS(CLASS) \ EXPAND_CLASS_MEMBER_INT(CLASS, ErrCode, int) \ EXPAND_CLASS_MEMBER_STRING(CLASS, CtrlUrl) \ EXPAND_CLASS_MEMBER_INT(CLASS, ActionRequest, IXML_Document *) \ EXPAND_CLASS_MEMBER_INT(CLASS, ActionResult, IXML_Document *) \ #include "TemplateInclude.h" #endif /* ACTIONCOMPLETE_H */ pupnp-release-1.8.0/upnp/inc/ActionRequest.h000066400000000000000000000017121303304015100207610ustar00rootroot00000000000000 #ifndef ACTIONREQUEST_H #define ACTIONREQUEST_H /*! * \file * * \brief UpnpActionRequest object declaration. * * Returned as part of a \b UPNP_CONTROL_ACTION_COMPLETE callback. * * \author Marcelo Roberto Jimenez */ #include "UpnpInet.h" /* for struct sockaddr_storage */ #define CLASS UpnpActionRequest #define EXPAND_CLASS_MEMBERS(CLASS) \ EXPAND_CLASS_MEMBER_INT(CLASS, ErrCode, int) \ EXPAND_CLASS_MEMBER_INT(CLASS, Socket, int) \ EXPAND_CLASS_MEMBER_STRING(CLASS, ErrStr) \ EXPAND_CLASS_MEMBER_STRING(CLASS, ActionName) \ EXPAND_CLASS_MEMBER_STRING(CLASS, DevUDN) \ EXPAND_CLASS_MEMBER_STRING(CLASS, ServiceID) \ EXPAND_CLASS_MEMBER_INT(CLASS, ActionRequest, IXML_Document *) \ EXPAND_CLASS_MEMBER_INT(CLASS, ActionResult, IXML_Document *) \ EXPAND_CLASS_MEMBER_INT(CLASS, SoapHeader, IXML_Document *) \ EXPAND_CLASS_MEMBER_BUFFER(CLASS, CtrlPtIPAddr, struct sockaddr_storage) \ #include "TemplateInclude.h" #endif /* ACTIONREQUEST_H */ pupnp-release-1.8.0/upnp/inc/Callback.h000066400000000000000000000125441303304015100176740ustar00rootroot00000000000000 #ifndef CALLBACK_H #define CALLBACK_H /*! * \file */ /*! * \brief The reason code for an event callback. * * The \b Event parameter will be different depending on the reason for the * callback. The descriptions for each event type describe the contents of the * \b Event parameter. */ enum Upnp_EventType_e { /* * Control callbacks */ /*! Received by a device when a control point issues a control * request. The \b Event parameter contains a pointer to a \b * UpnpActionRequest structure containing the action. The application * stores the results of the action in this structure. */ UPNP_CONTROL_ACTION_REQUEST, /*! A \b UpnpSendActionAsync call completed. The \b Event * parameter contains a pointer to a \b UpnpActionComplete structure * with the results of the action. */ UPNP_CONTROL_ACTION_COMPLETE, /*! Received by a device when a query for a single service variable * arrives. The \b Event parameter contains a pointer to a \b * UpnpStateVarRequest structure containing the name of the variable * and value. */ UPNP_CONTROL_GET_VAR_REQUEST, /*! A \b UpnpGetServiceVarStatus call completed. The \b Event * parameter contains a pointer to a \b UpnpStateVarComplete structure * containing the value for the variable. */ UPNP_CONTROL_GET_VAR_COMPLETE, /* * Discovery callbacks */ /*! Received by a control point when a new device or service is available. * The \b Event parameter contains a pointer to a \b * UpnpDiscovery structure with the information about the device * or service. */ UPNP_DISCOVERY_ADVERTISEMENT_ALIVE, /*! Received by a control point when a device or service shuts down. The \b * Event parameter contains a pointer to a \b UpnpDiscovery * structure containing the information about the device or * service. */ UPNP_DISCOVERY_ADVERTISEMENT_BYEBYE, /*! Received by a control point when a matching device or service responds. * The \b Event parameter contains a pointer to a \b * UpnpDiscovery structure containing the information about * the reply to the search request. */ UPNP_DISCOVERY_SEARCH_RESULT, /*! Received by a control point when the search timeout expires. The * SDK generates no more callbacks for this search after this * event. The \b Event parameter is \c NULL. */ UPNP_DISCOVERY_SEARCH_TIMEOUT, /* * Eventing callbacks */ /*! Received by a device when a subscription arrives. * The \b Event parameter contains a pointer to a \b * UpnpSubscriptionRequest structure. At this point, the * subscription has already been accepted. \b UpnpAcceptSubscription * needs to be called to confirm the subscription and transmit the * initial state table. This can be done during this callback. The SDK * generates no events for a subscription unless the device * application calls \b UpnpAcceptSubscription. */ UPNP_EVENT_SUBSCRIPTION_REQUEST, /*! Received by a control point when an event arrives. The \b * Event parameter contains a \b UpnpEvent structure * with the information about the event. */ UPNP_EVENT_RECEIVED, /*! A \b UpnpRenewSubscriptionAsync call completed. The status of * the renewal is in the \b Event parameter as a \b * Upnp_Event_Subscription structure. */ UPNP_EVENT_RENEWAL_COMPLETE, /*! A \b UpnpSubscribeAsync call completed. The status of the * subscription is in the \b Event parameter as a \b * Upnp_Event_Subscription structure. */ UPNP_EVENT_SUBSCRIBE_COMPLETE, /*! A \b UpnpUnSubscribeAsync call completed. The status of the * subscription is in the \b Event parameter as a \b * UpnpEventSubscribe structure. */ UPNP_EVENT_UNSUBSCRIBE_COMPLETE, /*! The auto-renewal of a client subscription failed. * The \b Event parameter is a \b UpnpEventSubscribe structure * with the error code set appropriately. The subscription is no longer * valid. */ UPNP_EVENT_AUTORENEWAL_FAILED, /*! A client subscription has expired. This will only occur * if auto-renewal of subscriptions is disabled. * The \b Event parameter is a \b UpnpEventSubscribe * structure. The subscription is no longer valid. */ UPNP_EVENT_SUBSCRIPTION_EXPIRED }; typedef enum Upnp_EventType_e Upnp_EventType; /*! * All callback functions share the same prototype, documented below. * Note that any memory passed to the callback function * is valid only during the callback and should be copied if it * needs to persist. This callback function needs to be thread * safe. The context of the callback is always on a valid thread * context and standard synchronization methods can be used. Note, * however, because of this the callback cannot call SDK functions * unless explicitly noted. * * \verbatim int CallbackFxn(Upnp_EventType EventType, void *Event, void *Cookie); \endverbatim * * where \b EventType is the event that triggered the callback, * \b Event is a structure that denotes event-specific information for that * event, and \b Cookie is the user data passed when the callback was * registered. * * See \b Upnp_EventType for more information on the callback values and * the associated \b Event parameter. * * The return value of the callback is currently ignored. It may be used * in the future to communicate results back to the SDK. */ typedef int (*Upnp_FunPtr)( /*! [in] .*/ Upnp_EventType EventType, /*! [in] .*/ const void *Event, /*! [in] .*/ void *Cookie); #endif /* CALLBACK_H */ pupnp-release-1.8.0/upnp/inc/Discovery.h000066400000000000000000000016251303304015100201450ustar00rootroot00000000000000 #ifndef DISCOVERY_H #define DISCOVERY_H /*! * \file * * \brief UpnpDiscovery object declararion. * * Returned in a \b UPNP_DISCOVERY_RESULT callback. * * \author Marcelo Roberto Jimenez */ #include "UpnpInet.h" /* for struct sockaddr_storage */ #define CLASS UpnpDiscovery #define EXPAND_CLASS_MEMBERS(CLASS) \ EXPAND_CLASS_MEMBER_INT(CLASS, ErrCode, int) \ EXPAND_CLASS_MEMBER_INT(CLASS, Expires, int) \ EXPAND_CLASS_MEMBER_STRING(CLASS, DeviceID) \ EXPAND_CLASS_MEMBER_STRING(CLASS, DeviceType) \ EXPAND_CLASS_MEMBER_STRING(CLASS, ServiceType) \ EXPAND_CLASS_MEMBER_STRING(CLASS, ServiceVer) \ EXPAND_CLASS_MEMBER_STRING(CLASS, Location) \ EXPAND_CLASS_MEMBER_STRING(CLASS, Os) \ EXPAND_CLASS_MEMBER_STRING(CLASS, Date) \ EXPAND_CLASS_MEMBER_STRING(CLASS, Ext) \ EXPAND_CLASS_MEMBER_BUFFER(CLASS, DestAddr, struct sockaddr_storage) \ #include "TemplateInclude.h" #endif /* DISCOVERY_H */ pupnp-release-1.8.0/upnp/inc/Event.h000066400000000000000000000007301303304015100172530ustar00rootroot00000000000000 #ifndef EVENT_H #define EVENT_H /*! * \file * * \brief UpnpEvent object declararion. * * Returned along with a \b UPNP_EVENT_RECEIVED callback. * * \author Marcelo Roberto Jimenez */ #define CLASS UpnpEvent #define EXPAND_CLASS_MEMBERS(CLASS) \ EXPAND_CLASS_MEMBER_INT(CLASS, EventKey, int) \ EXPAND_CLASS_MEMBER_INT(CLASS, ChangedVariables, IXML_Document *) \ EXPAND_CLASS_MEMBER_STRING(CLASS, SID) \ #include "TemplateInclude.h" #endif /* EVENT_H */ pupnp-release-1.8.0/upnp/inc/EventSubscribe.h000066400000000000000000000011251303304015100211140ustar00rootroot00000000000000 #ifndef EVENTSUBSCRIBE_H #define EVENTSUBSCRIBE_H /*! * \file * * \brief UpnpEventSubscribe object declararion. * * Returned along with a \b UPNP_EVENT_SUBSCRIBE_COMPLETE or * \b UPNP_EVENT_UNSUBSCRIBE_COMPLETE callback. * * \author Marcelo Roberto Jimenez */ #define CLASS UpnpEventSubscribe #define EXPAND_CLASS_MEMBERS(CLASS) \ EXPAND_CLASS_MEMBER_INT(CLASS, ErrCode, int) \ EXPAND_CLASS_MEMBER_INT(CLASS, TimeOut, int) \ EXPAND_CLASS_MEMBER_STRING(CLASS, SID) \ EXPAND_CLASS_MEMBER_STRING(CLASS, PublisherUrl) \ #include "TemplateInclude.h" #endif /* EVENTSUBSCRIBE_H */ pupnp-release-1.8.0/upnp/inc/FileInfo.h000066400000000000000000000013541303304015100176700ustar00rootroot00000000000000 #ifndef FILEINFO_H #define FILEINFO_H /*! * \file * * \brief UpnpFileInfo object declararion. * * Detailed description of this class should go here * * \author Marcelo Roberto Jimenez */ #include "upnpconfig.h" #include /* for off_t */ #include /* for time_t */ #define CLASS UpnpFileInfo #define EXPAND_CLASS_MEMBERS(CLASS) \ EXPAND_CLASS_MEMBER_INT(CLASS, FileLength, off_t) \ EXPAND_CLASS_MEMBER_INT(CLASS, LastModified, time_t) \ EXPAND_CLASS_MEMBER_INT(CLASS, IsDirectory, int) \ EXPAND_CLASS_MEMBER_INT(CLASS, IsReadable, int) \ EXPAND_CLASS_MEMBER_DOMSTRING(CLASS, ContentType) \ EXPAND_CLASS_MEMBER_DOMSTRING(CLASS, ExtraHeaders) \ #include "TemplateInclude.h" #endif /* FILEINFO_H */ pupnp-release-1.8.0/upnp/inc/StateVarComplete.h000066400000000000000000000011301303304015100214070ustar00rootroot00000000000000 #ifndef STATEVARCOMPLETE_H #define STATEVARCOMPLETE_H /*! * \file * * \brief UpnpStateVarComplete object declararion. * * Represents the reply for the current value of a state variable in an * asynchronous call. * * \author Marcelo Roberto Jimenez */ #define CLASS UpnpStateVarComplete #define EXPAND_CLASS_MEMBERS(CLASS) \ EXPAND_CLASS_MEMBER_INT(CLASS, ErrCode, int) \ EXPAND_CLASS_MEMBER_STRING(CLASS, CtrlUrl) \ EXPAND_CLASS_MEMBER_STRING(CLASS, StateVarName) \ EXPAND_CLASS_MEMBER_DOMSTRING(CLASS, CurrentVal) \ #include "TemplateInclude.h" #endif /* STATEVARCOMPLETE_H */ pupnp-release-1.8.0/upnp/inc/StateVarRequest.h000066400000000000000000000015421303304015100212760ustar00rootroot00000000000000 #ifndef STATEVARREQUEST_H #define STATEVARREQUEST_H /*! * \file * * \brief UpnpStateVarRequest object declararion. * * Represents the request for current value of a state variable in a service * state table. * * \author Marcelo Roberto Jimenez */ #include "UpnpInet.h" /* for struct sockaddr_storage */ #define CLASS UpnpStateVarRequest #define EXPAND_CLASS_MEMBERS(CLASS) \ EXPAND_CLASS_MEMBER_INT(CLASS, ErrCode, int) \ EXPAND_CLASS_MEMBER_INT(CLASS, Socket, int) \ EXPAND_CLASS_MEMBER_STRING(CLASS, ErrStr) \ EXPAND_CLASS_MEMBER_STRING(CLASS, DevUDN) \ EXPAND_CLASS_MEMBER_STRING(CLASS, ServiceID) \ EXPAND_CLASS_MEMBER_STRING(CLASS, StateVarName) \ EXPAND_CLASS_MEMBER_BUFFER(CLASS, CtrlPtIPAddr, struct sockaddr_storage) \ EXPAND_CLASS_MEMBER_DOMSTRING(CLASS, CurrentVal) \ #include "TemplateInclude.h" #endif /* STATEVARREQUEST_H */ pupnp-release-1.8.0/upnp/inc/SubscriptionRequest.h000066400000000000000000000010171303304015100222260ustar00rootroot00000000000000 #ifndef SUBSCRIPTIONREQUEST_H #define SUBSCRIPTIONREQUEST_H /*! * \file * * \brief UpnpSubscriptionRequest object declararion. * * Returned along with a \b UPNP_EVENT_SUBSCRIPTION_REQUEST callback. * * \author Marcelo Roberto Jimenez */ #define CLASS UpnpSubscriptionRequest #define EXPAND_CLASS_MEMBERS(CLASS) \ EXPAND_CLASS_MEMBER_STRING(CLASS, ServiceId) \ EXPAND_CLASS_MEMBER_STRING(CLASS, UDN) \ EXPAND_CLASS_MEMBER_STRING(CLASS, SID) \ #include "TemplateInclude.h" #endif /* SUBSCRIPTIONREQUEST_H */ pupnp-release-1.8.0/upnp/inc/TemplateInclude.h000066400000000000000000000126751303304015100212640ustar00rootroot00000000000000/* * C Template objects. * * Copyright (C) 2010 Marcelo Roberto Jimenez */ #ifndef TEMPLATEINCLUDE_H #define TEMPLATEINCLUDE_H /*! * \file * * \brief Templates for include files of objects. * * Usage: * * - In the include file Token.h: * #include "Token_def.h" * #include "TemplateInclude.h" * * - In the source file Token.c: * #include "Token.h" * #include "TemplateSource.h" * * \author Marcelo Roberto Jimenez */ /******************************************************************************/ #define TEMPLATE_PROTOTYPE_COMMON(CLASS) \ TEMPLATE_PROTOTYPE_COMMON_AUX(CLASS) #define TEMPLATE_PROTOTYPE_COMMON_AUX(CLASS) \ /*! * DOC_##CLASS */ \ typedef struct s_##CLASS CLASS; \ \ /*! Constructor */ \ EXPORT_SPEC CLASS *CLASS##_new(); \ \ /*! Destructor */ \ EXPORT_SPEC void CLASS##_delete(CLASS *p); \ \ /*! Copy Constructor */ \ EXPORT_SPEC CLASS *CLASS##_dup(const CLASS *p); \ \ /*! Assignment operator */ \ EXPORT_SPEC int CLASS##_assign(CLASS *p, const CLASS *q); \ /******************************************************************************/ #define TEMPLATE_PROTOTYPE_INT(CLASS, MEMBER, TYPE) \ TEMPLATE_PROTOTYPE_INT_AUX(CLASS, MEMBER, TYPE) #define TEMPLATE_PROTOTYPE_INT_AUX(CLASS, MEMBER, TYPE) \ /*! DOC_##CLASS##_##MEMBER */ \ EXPORT_SPEC TYPE CLASS##_get_##MEMBER(const CLASS *p); \ EXPORT_SPEC int CLASS##_set_##MEMBER(CLASS *p, TYPE n); \ /******************************************************************************/ #define TEMPLATE_PROTOTYPE_BUFFER(CLASS, MEMBER, TYPE) \ TEMPLATE_PROTOTYPE_BUFFER_AUX(CLASS, MEMBER, TYPE) #define TEMPLATE_PROTOTYPE_BUFFER_AUX(CLASS, MEMBER, TYPE) \ /*! DOC_##CLASS_##MEMBER */ \ EXPORT_SPEC const TYPE *CLASS##_get_##MEMBER(const CLASS *p); \ EXPORT_SPEC int CLASS##_set_##MEMBER(CLASS *p, const TYPE *buf); \ EXPORT_SPEC void CLASS##_clear_##MEMBER(CLASS *p); \ /******************************************************************************/ #define TEMPLATE_PROTOTYPE_LIST(CLASS, MEMBER) \ TEMPLATE_PROTOTYPE_LIST_AUX(CLASS, MEMBER) #define TEMPLATE_PROTOTYPE_LIST_AUX(CLASS, MEMBER) \ /*! DOC_##CLASS_##MEMBER */ \ EXPORT_SPEC const struct list_head *CLASS##_get_##MEMBER(const CLASS *p); \ EXPORT_SPEC void CLASS##_add_to_list_##MEMBER(CLASS *p, struct list_head *head); \ EXPORT_SPEC void CLASS##_remove_from_list_##MEMBER(CLASS *p); \ EXPORT_SPEC void CLASS##_replace_in_list_##MEMBER(CLASS *p, struct list_head *new); \ /******************************************************************************/ #define TEMPLATE_PROTOTYPE_OBJECT(CLASS, MEMBER, TYPE) \ TEMPLATE_PROTOTYPE_OBJECT_AUX(CLASS, MEMBER, TYPE) #define TEMPLATE_PROTOTYPE_OBJECT_AUX(CLASS, MEMBER, TYPE) \ /*! DOC_##CLASS##_##MEMBER */ \ EXPORT_SPEC const TYPE *CLASS##_get_##MEMBER(const CLASS *p); \ EXPORT_SPEC int CLASS##_set_##MEMBER(CLASS *p, const TYPE *n); \ /******************************************************************************/ #define TEMPLATE_PROTOTYPE_STRING(CLASS, MEMBER) \ TEMPLATE_PROTOTYPE_STRING_AUX(CLASS, MEMBER) #define TEMPLATE_PROTOTYPE_STRING_AUX(CLASS, MEMBER) \ /*! DOC_##CLASS##_##MEMBER */ \ EXPORT_SPEC const UpnpString *CLASS##_get_##MEMBER(const CLASS *p); \ EXPORT_SPEC int CLASS##_set_##MEMBER(CLASS *p, const UpnpString *s); \ EXPORT_SPEC size_t CLASS##_get_##MEMBER##_Length(const CLASS *p); \ EXPORT_SPEC const char *CLASS##_get_##MEMBER##_cstr(const CLASS *p); \ EXPORT_SPEC int CLASS##_strcpy_##MEMBER(CLASS *p, const char *s); \ EXPORT_SPEC int CLASS##_strncpy_##MEMBER(CLASS *p, const char *s, size_t n); \ EXPORT_SPEC void CLASS##_clear_##MEMBER(CLASS *p); \ /******************************************************************************/ #define TEMPLATE_PROTOTYPE_DOMSTRING(CLASS, MEMBER) \ TEMPLATE_PROTOTYPE_DOMSTRING_AUX(CLASS, MEMBER) #define TEMPLATE_PROTOTYPE_DOMSTRING_AUX(CLASS, MEMBER) \ /*! DOC_##CLASS_##MEMBER */ \ EXPORT_SPEC const DOMString CLASS##_get_##MEMBER(const CLASS *p); \ EXPORT_SPEC int CLASS##_set_##MEMBER(CLASS *p, const DOMString s); \ EXPORT_SPEC const char *CLASS##_get_##MEMBER##_cstr(const CLASS *p); \ #endif /* TEMPLATEINCLUDE_H */ /****************************************************************************** * * Actual source starts here. * ******************************************************************************/ #include /* for size_t */ #include "ixml.h" /* for DOMString, IXML_Document */ #include "list.h" /* for struct list_head */ #include "UpnpGlobal.h" /* for EXPORT_SPEC */ #include "UpnpString.h" #ifdef __cplusplus extern "C" { #endif /* __cplusplus */ TEMPLATE_PROTOTYPE_COMMON(CLASS) #define EXPAND_CLASS_MEMBER_INT(CLASS, MEMBER, TYPE) TEMPLATE_PROTOTYPE_INT(CLASS, MEMBER, TYPE) #define EXPAND_CLASS_MEMBER_BUFFER(CLASS, MEMBER, TYPE) TEMPLATE_PROTOTYPE_BUFFER(CLASS, MEMBER, TYPE) #define EXPAND_CLASS_MEMBER_LIST(CLASS, MEMBER) TEMPLATE_PROTOTYPE_LIST(CLASS, MEMBER) #define EXPAND_CLASS_MEMBER_OBJECT(CLASS, MEMBER, TYPE) TEMPLATE_PROTOTYPE_OBJECT(CLASS, MEMBER, TYPE) #define EXPAND_CLASS_MEMBER_STRING(CLASS, MEMBER) TEMPLATE_PROTOTYPE_STRING(CLASS, MEMBER) #define EXPAND_CLASS_MEMBER_DOMSTRING(CLASS, MEMBER) TEMPLATE_PROTOTYPE_DOMSTRING(CLASS, MEMBER) EXPAND_CLASS_MEMBERS(CLASS) #include "TemplateUndef.h" #ifdef __cplusplus } #endif /* __cplusplus */ #ifdef TEMPLATE_GENERATE_SOURCE #include "TemplateSource.h" #endif /* TEMPLATE_GENERATE_SOURCE */ /* Cleanup the template mess. */ #undef PREFIX #undef CLASS #undef EXPAND_CLASS_MEMBERS pupnp-release-1.8.0/upnp/inc/TemplateSource.h000066400000000000000000000271741303304015100211410ustar00rootroot00000000000000/* * C Template objects. * * Copyright (C) 2010 Marcelo Roberto Jimenez */ #ifndef TEMPLATESOURCE_H #define TEMPLATESOURCE_H /*! * \file * * \brief Templates for source files of objects. * * Usage: * * - In the include file Token.h: * #include "Token_def.h" * #include "TemplateInclude.h" * * - In the source file Token.c: * #include "Token.h" * #include "TemplateSource.h" * * \author Marcelo Roberto Jimenez */ /******************************************************************************/ #define TEMPLATE_DEFINITION_INT(MEMBER, TYPE) TYPE m_##MEMBER; #define TEMPLATE_DEFINITION_BUFFER(MEMBER, TYPE) TYPE m_##MEMBER; #define TEMPLATE_DEFINITION_LIST(MEMBER) struct list_head m_##MEMBER; #define TEMPLATE_DEFINITION_OBJECT(MEMBER, TYPE) TYPE *m_##MEMBER; #define TEMPLATE_DEFINITION_STRING(MEMBER) UpnpString *m_##MEMBER; #define TEMPLATE_DEFINITION_DOMSTRING(MEMBER) DOMString m_##MEMBER; /******************************************************************************/ #define TEMPLATE_CONSTRUCTOR_INT(MEMBER, TYPE) /* p->m_##MEMBER = 0; */ #define TEMPLATE_CONSTRUCTOR_BUFFER(MEMBER, TYPE) \ /* memset(&p->m_##MEMBER, 0, sizeof (TYPE)); */ #define TEMPLATE_CONSTRUCTOR_LIST(MEMBER, TYPE) INIT_LIST_HEAD(&p->m_##MEMBER); #define TEMPLATE_CONSTRUCTOR_OBJECT(MEMBER, TYPE) p->m_##MEMBER = TYPE##_new(); #define TEMPLATE_CONSTRUCTOR_STRING(MEMBER) p->m_##MEMBER = UpnpString_new(); #define TEMPLATE_CONSTRUCTOR_DOMSTRING(MEMBER) p->m_##MEMBER = NULL; /******************************************************************************/ #define TEMPLATE_DESTRUCTOR_INT(MEMBER, TYPE) p->m_##MEMBER = 0; #define TEMPLATE_DESTRUCTOR_BUFFER(MEMBER, TYPE) memset(&p->m_##MEMBER, 0, sizeof (TYPE)); #define TEMPLATE_DESTRUCTOR_LIST(MEMBER) list_del(&p->m_##MEMBER); #define TEMPLATE_DESTRUCTOR_OBJECT(MEMBER, TYPE) TYPE##_delete(p->m_##MEMBER); p->m_##MEMBER = NULL; #define TEMPLATE_DESTRUCTOR_STRING(MEMBER) UpnpString_delete(p->m_##MEMBER); p->m_##MEMBER = NULL; #define TEMPLATE_DESTRUCTOR_DOMSTRING(MEMBER) ixmlFreeDOMString(p->m_##MEMBER); p->m_##MEMBER = NULL; /******************************************************************************/ #define TEMPLATE_ASSIGNMENT(CLASS, MEMBER) ok = ok && CLASS##_set_##MEMBER(p, CLASS##_get_##MEMBER(q)); /******************************************************************************/ #define TEMPLATE_METHODS_INT(CLASS, MEMBER, TYPE) \ TEMPLATE_METHODS_INT_AUX(CLASS, MEMBER, TYPE) #define TEMPLATE_METHODS_INT_AUX(CLASS, MEMBER, TYPE) \ TYPE CLASS##_get_##MEMBER(const CLASS *p) \ { \ return ((struct S##CLASS *)p)->m_##MEMBER; \ } \ \ int CLASS##_set_##MEMBER(CLASS *p, TYPE n) \ { \ ((struct S##CLASS *)p)->m_##MEMBER = n; \ return 1; \ } \ /******************************************************************************/ #define TEMPLATE_METHODS_BUFFER(CLASS, MEMBER, TYPE) \ TEMPLATE_METHODS_BUFFER_AUX(CLASS, MEMBER, TYPE) #define TEMPLATE_METHODS_BUFFER_AUX(CLASS, MEMBER, TYPE) \ const TYPE *CLASS##_get_##MEMBER(const CLASS *p) \ { \ return (TYPE *)&((struct S##CLASS *)p)->m_##MEMBER; \ } \ \ int CLASS##_set_##MEMBER(CLASS *p, const TYPE *buf) \ { \ ((struct S##CLASS *)p)->m_##MEMBER = *(TYPE *)buf; \ return 1; \ } \ \ void CLASS##_clear_##MEMBER(CLASS *p) \ { \ memset(&((struct S##CLASS *)p)->m_##MEMBER, 0, sizeof(TYPE)); \ } \ /******************************************************************************/ #define TEMPLATE_METHODS_LIST(CLASS, MEMBER) \ TEMPLATE_METHODS_LIST_AUX(CLASS, MEMBER) #define TEMPLATE_METHODS_LIST_AUX(CLASS, MEMBER) \ const struct list_head *CLASS##_get_##MEMBER(const CLASS *p) \ { \ return (struct list_head *)&((struct S##CLASS *)p)->m_##MEMBER; \ } \ \ void CLASS##_add_to_list_##MEMBER(CLASS *p, struct list_head *head) \ { \ list_add(&((struct S##CLASS *)p)->m_##MEMBER, head); \ } \ \ void CLASS##_remove_from_list_##MEMBER(CLASS *p) \ { \ list_del_init(&((struct S##CLASS *)p)->m_##MEMBER); \ } \ \ void CLASS##_replace_in_list_##MEMBER(CLASS *p, struct list_head *new) \ { \ list_replace_init(&((struct S##CLASS *)p)->m_##MEMBER, new); \ } \ /******************************************************************************/ #define TEMPLATE_METHODS_OBJECT(CLASS, MEMBER, TYPE) \ TEMPLATE_METHODS_OBJECT_AUX(CLASS, MEMBER, TYPE) #define TEMPLATE_METHODS_OBJECT_AUX(CLASS, MEMBER, TYPE) \ const TYPE *CLASS##_get_##MEMBER(const CLASS *p) \ { \ return ((struct S##CLASS *)p)->m_##MEMBER; \ } \ \ int CLASS##_set_##MEMBER(CLASS *p, const TYPE *s) \ { \ TYPE *q = TYPE##_dup(s); \ if (!q) return 0; \ TYPE##_delete(((struct S##CLASS *)p)->m_##MEMBER); \ ((struct S##CLASS *)p)->m_##MEMBER = q; \ return 1; \ } \ /******************************************************************************/ #define TEMPLATE_METHODS_STRING(CLASS, MEMBER) \ TEMPLATE_METHODS_STRING_AUX(CLASS, MEMBER) #define TEMPLATE_METHODS_STRING_AUX(CLASS, MEMBER) \ const UpnpString *CLASS##_get_##MEMBER(const CLASS *p) \ { \ return ((struct S##CLASS *)p)->m_##MEMBER; \ } \ \ int CLASS##_set_##MEMBER(CLASS *p, const UpnpString *s) \ { \ const char *q = UpnpString_get_String(s); \ return UpnpString_set_String(((struct S##CLASS *)p)->m_##MEMBER, q); \ } \ \ size_t CLASS##_get_##MEMBER##_Length(const CLASS *p) \ { \ return UpnpString_get_Length(CLASS##_get_##MEMBER(p)); \ } \ const char *CLASS##_get_##MEMBER##_cstr(const CLASS *p) \ { \ return UpnpString_get_String(CLASS##_get_##MEMBER(p)); \ } \ \ int CLASS##_strcpy_##MEMBER(CLASS *p, const char *s) \ { \ return UpnpString_set_String(((struct S##CLASS *)p)->m_##MEMBER, s); \ } \ \ int CLASS##_strncpy_##MEMBER(CLASS *p, const char *s, size_t n) \ { \ return UpnpString_set_StringN(((struct S##CLASS *)p)->m_##MEMBER, s, n); \ } \ \ void CLASS##_clear_##MEMBER(CLASS *p) \ { \ UpnpString_clear(((struct S##CLASS *)p)->m_##MEMBER); \ } \ /******************************************************************************/ #define TEMPLATE_METHODS_DOMSTRING(CLASS, MEMBER) \ TEMPLATE_METHODS_DOMSTRING_AUX(CLASS, MEMBER) #define TEMPLATE_METHODS_DOMSTRING_AUX(CLASS, MEMBER) \ const DOMString CLASS##_get_##MEMBER(const CLASS *p) \ { \ return ((struct S##CLASS *)p)->m_##MEMBER; \ } \ \ int CLASS##_set_##MEMBER(CLASS *p, const DOMString s) \ { \ DOMString q = ixmlCloneDOMString(s); \ if (!q) return 0; \ ixmlFreeDOMString(((struct S##CLASS *)p)->m_##MEMBER); \ ((struct S##CLASS *)p)->m_##MEMBER = q; \ return 1; \ } \ \ const char *CLASS##_get_##MEMBER##_cstr(const CLASS *p) \ { \ return (const char *)CLASS##_get_##MEMBER(p); \ } \ /****************************************************************************** * * Actual source starts here. * ******************************************************************************/ #include "config.h" #include /* for calloc(), free() */ #include /* for strlen(), strdup() */ /******************************************************************************/ #define EXPAND_CLASS_MEMBER_INT(CLASS, MEMBER, TYPE) TEMPLATE_DEFINITION_INT(MEMBER, TYPE) #define EXPAND_CLASS_MEMBER_BUFFER(CLASS, MEMBER, TYPE) TEMPLATE_DEFINITION_BUFFER(MEMBER, TYPE) #define EXPAND_CLASS_MEMBER_LIST(CLASS, MEMBER) TEMPLATE_DEFINITION_LIST(MEMBER) #define EXPAND_CLASS_MEMBER_OBJECT(CLASS, MEMBER, TYPE) TEMPLATE_DEFINITION_OBJECT(MEMBER, TYPE) #define EXPAND_CLASS_MEMBER_STRING(CLASS, MEMBER) TEMPLATE_DEFINITION_STRING(MEMBER) #define EXPAND_CLASS_MEMBER_DOMSTRING(CLASS, MEMBER) TEMPLATE_DEFINITION_DOMSTRING(MEMBER) #define TEMPLATE_DECLARATION_STRUCT(CLASS) \ TEMPLATE_DECLARATION_STRUCT_AUX(CLASS) #define TEMPLATE_DECLARATION_STRUCT_AUX(CLASS) \ struct S##CLASS { \ EXPAND_CLASS_MEMBERS(CLASS) \ }; TEMPLATE_DECLARATION_STRUCT(CLASS) #include "TemplateUndef.h" /******************************************************************************/ #define EXPAND_CLASS_MEMBER_INT(CLASS, MEMBER, TYPE) TEMPLATE_CONSTRUCTOR_INT(MEMBER, TYPE) #define EXPAND_CLASS_MEMBER_BUFFER(CLASS, MEMBER, TYPE) TEMPLATE_CONSTRUCTOR_BUFFER(MEMBER, TYPE) #define EXPAND_CLASS_MEMBER_LIST(CLASS, MEMBER) TEMPLATE_CONSTRUCTOR_LIST(MEMBER, MEMBER) #define EXPAND_CLASS_MEMBER_OBJECT(CLASS, MEMBER, TYPE) TEMPLATE_CONSTRUCTOR_OBJECT(MEMBER, TYPE) #define EXPAND_CLASS_MEMBER_STRING(CLASS, MEMBER) TEMPLATE_CONSTRUCTOR_STRING(MEMBER) #define EXPAND_CLASS_MEMBER_DOMSTRING(CLASS, MEMBER) TEMPLATE_CONSTRUCTOR_DOMSTRING(MEMBER) #define TEMPLATE_DEFINITION_CONSTRUCTOR(CLASS) \ TEMPLATE_DEFINITION_CONSTRUCTOR_AUX(CLASS) #define TEMPLATE_DEFINITION_CONSTRUCTOR_AUX(CLASS) \ CLASS *CLASS##_new() \ { \ struct S##CLASS *p = calloc(1, sizeof (struct S##CLASS)); \ \ if (!p) return NULL; \ \ EXPAND_CLASS_MEMBERS(CLASS) \ \ return (CLASS *)p; \ } TEMPLATE_DEFINITION_CONSTRUCTOR(CLASS) #include "TemplateUndef.h" /******************************************************************************/ #define EXPAND_CLASS_MEMBER_INT(CLASS, MEMBER, TYPE) TEMPLATE_DESTRUCTOR_INT(MEMBER, TYPE) #define EXPAND_CLASS_MEMBER_BUFFER(CLASS, MEMBER, TYPE) TEMPLATE_DESTRUCTOR_BUFFER(MEMBER, TYPE) #define EXPAND_CLASS_MEMBER_LIST(CLASS, MEMBER) TEMPLATE_DESTRUCTOR_LIST(MEMBER) #define EXPAND_CLASS_MEMBER_OBJECT(CLASS, MEMBER, TYPE) TEMPLATE_DESTRUCTOR_OBJECT(MEMBER, TYPE) #define EXPAND_CLASS_MEMBER_STRING(CLASS, MEMBER) TEMPLATE_DESTRUCTOR_STRING(MEMBER) #define EXPAND_CLASS_MEMBER_DOMSTRING(CLASS, MEMBER) TEMPLATE_DESTRUCTOR_DOMSTRING(MEMBER) #define TEMPLATE_DEFINITION_DESTRUCTOR(CLASS) \ TEMPLATE_DEFINITION_DESTRUCTOR_AUX(CLASS) #define TEMPLATE_DEFINITION_DESTRUCTOR_AUX(CLASS) \ void CLASS##_delete(CLASS *q) \ { \ struct S##CLASS *p = (struct S##CLASS *)q; \ \ if (!p) return; \ \ EXPAND_CLASS_MEMBERS(CLASS) \ \ free(p); \ } TEMPLATE_DEFINITION_DESTRUCTOR(CLASS) #include "TemplateUndef.h" /******************************************************************************/ #define TEMPLATE_DEFINITION_COPY_CONSTRUCTOR(CLASS) \ TEMPLATE_DEFINITION_COPY_CONSTRUCTOR_AUX(CLASS) #define TEMPLATE_DEFINITION_COPY_CONSTRUCTOR_AUX(CLASS) \ CLASS *CLASS##_dup(const CLASS *q) \ { \ CLASS *p = CLASS##_new(); \ \ if (!p) return NULL; \ \ CLASS##_assign(p, q); \ \ return p; \ } TEMPLATE_DEFINITION_COPY_CONSTRUCTOR(CLASS) /******************************************************************************/ #define EXPAND_CLASS_MEMBER_INT(CLASS, MEMBER, TYPE) TEMPLATE_ASSIGNMENT(CLASS, MEMBER) #define EXPAND_CLASS_MEMBER_BUFFER(CLASS, MEMBER, TYPE) TEMPLATE_ASSIGNMENT(CLASS, MEMBER) #define EXPAND_CLASS_MEMBER_LIST(CLASS, MEMBER) /* Do not assing. */ #define EXPAND_CLASS_MEMBER_OBJECT(CLASS, MEMBER, TYPE) TEMPLATE_ASSIGNMENT(CLASS, MEMBER) #define EXPAND_CLASS_MEMBER_STRING(CLASS, MEMBER) TEMPLATE_ASSIGNMENT(CLASS, MEMBER) #define EXPAND_CLASS_MEMBER_DOMSTRING(CLASS, MEMBER) TEMPLATE_ASSIGNMENT(CLASS, MEMBER) #define TEMPLATE_DEFINITION_ASSIGNMENT(CLASS) \ TEMPLATE_DEFINITION_ASSIGNMENT_AUX(CLASS) #define TEMPLATE_DEFINITION_ASSIGNMENT_AUX(CLASS) \ int CLASS##_assign(CLASS *p, const CLASS *q) \ { \ int ok = 1; \ if (p != q) { \ EXPAND_CLASS_MEMBERS(CLASS) \ } \ return ok; \ } TEMPLATE_DEFINITION_ASSIGNMENT(CLASS) #include "TemplateUndef.h" /******************************************************************************/ #define EXPAND_CLASS_MEMBER_INT(CLASS, MEMBER, TYPE) TEMPLATE_METHODS_INT(CLASS, MEMBER, TYPE) #define EXPAND_CLASS_MEMBER_BUFFER(CLASS, MEMBER, TYPE) TEMPLATE_METHODS_BUFFER(CLASS, MEMBER, TYPE) #define EXPAND_CLASS_MEMBER_LIST(CLASS, MEMBER) TEMPLATE_METHODS_LIST(CLASS, MEMBER) #define EXPAND_CLASS_MEMBER_OBJECT(CLASS, MEMBER, TYPE) TEMPLATE_METHODS_OBJECT(CLASS, MEMBER, TYPE) #define EXPAND_CLASS_MEMBER_STRING(CLASS, MEMBER) TEMPLATE_METHODS_STRING(CLASS, MEMBER) #define EXPAND_CLASS_MEMBER_DOMSTRING(CLASS, MEMBER) TEMPLATE_METHODS_DOMSTRING(CLASS, MEMBER) EXPAND_CLASS_MEMBERS(CLASS) #include "TemplateUndef.h" #endif /* TEMPLATESOURCE_H */ pupnp-release-1.8.0/upnp/inc/TemplateUndef.h000066400000000000000000000005161303304015100207310ustar00rootroot00000000000000/* * C Template objects. * * Copyright (C) 2010 Marcelo Roberto Jimenez */ /*! * \file */ #undef EXPAND_CLASS_MEMBER_INT #undef EXPAND_CLASS_MEMBER_BUFFER #undef EXPAND_CLASS_MEMBER_LIST #undef EXPAND_CLASS_MEMBER_OBJECT #undef EXPAND_CLASS_MEMBER_STRING #undef EXPAND_CLASS_MEMBER_DOMSTRING pupnp-release-1.8.0/upnp/inc/UpnpGlobal.h000066400000000000000000000056471303304015100202510ustar00rootroot00000000000000#ifndef UPNPGLOBAL_H #define UPNPGLOBAL_H /*! * \file * * \brief Defines constants that for some reason are not defined on some systems. */ #if defined MYLIB_LARGEFILE_SENSITIVE && _FILE_OFFSET_BITS+0 != 64 #if defined __GNUC__ #warning libupnp requires largefile mode - use AC_SYS_LARGEFILE #else #error libupnp requires largefile mode - use AC_SYS_LARGEFILE #endif #endif #ifdef WIN32 /* * EXPORT_SPEC */ #ifdef UPNP_STATIC_LIB #define EXPORT_SPEC #else /* UPNP_STATIC_LIB */ #ifdef LIBUPNP_EXPORTS /*! set up declspec for dll export to make functions * visible to library users */ #define EXPORT_SPEC __declspec(dllexport) #else /* LIBUPNP_EXPORTS */ #define EXPORT_SPEC __declspec(dllimport) #endif /* LIBUPNP_EXPORTS */ #endif /* UPNP_STATIC_LIB */ /* * UPNP_INLINE * PRId64 * PRIzd * PRIzu * PRIzx */ #ifdef UPNP_USE_MSVCPP /* define some things the M$ VC++ doesn't know */ #define UPNP_INLINE _inline typedef __int64 int64_t; #define PRId64 "I64d" #define PRIzd "ld" #define PRIzu "lu" #define PRIzx "lx" #endif /* UPNP_USE_MSVCPP */ #ifdef UPNP_USE_BCBPP /* define some things Borland Builder doesn't know */ #define UPNP_INLINE inline typedef __int64 int64_t; #warning The Borland C compiler is probably broken on PRId64, #warning please someone provide a proper fix here #define PRId64 "I64d" #define PRIzd "zd" #define PRIzu "zu" #define PRIzx "zx" #endif /* UPNP_USE_BCBPP */ #ifdef __GNUC__ #define UPNP_INLINE inline /* Note with PRIzu that in the case of Mingw32, it's the MS C * runtime printf which ends up getting called, not the glibc * printf, so it genuinely doesn't have "zu" */ #define PRIzd "ld" #define PRIzu "lu" #define PRIzx "lx" #endif /* __GNUC__ */ #else /*! * \brief Export functions on WIN32 DLLs. * * Every funtion that belongs to the library API must use this * definition upon declaration or it will not be exported on WIN32 * DLLs. */ #define EXPORT_SPEC /*! * \brief Declares an inline function. * * Surprisingly, there are some compilers that do not understand the * inline keyword. This definition makes the use of this keyword * portable to these systems. */ #ifdef __STRICT_ANSI__ #define UPNP_INLINE __inline__ #else #define UPNP_INLINE inline #endif /*! * \brief Supply the PRId64 printf() macro. * * MSVC still does not know about this. */ /* #define PRId64 PRId64 */ /*! * \brief Supply the PRIz* printf() macros. * * These macros were invented so that we can live a little longer with * MSVC lack of C99. "z" is the correct printf() size specifier for * the size_t type. */ #define PRIzd "zd" #define PRIzu "zu" #define PRIzx "zx" #endif /* * Defining this macro here gives some interesting information about unused * functions in the code. Of course, this should never go uncommented on a * release. */ /*#define inline*/ #endif /* UPNPGLOBAL_H */ pupnp-release-1.8.0/upnp/inc/UpnpInet.h000066400000000000000000000027421303304015100177410ustar00rootroot00000000000000#ifndef UPNPINET_H #define UPNPINET_H /*! * \addtogroup Sock * * @{ * * \file * * \brief Provides a platform independent way to include TCP/IP types and functions. */ #include "UpnpUniStd.h" /* for close() */ #ifdef WIN32 #include #ifndef UPNP_USE_MSVCPP /* Removed: not required (and cause compilation issues) */ #include #include #endif #include #include #include #define UpnpCloseSocket closesocket #if(_WIN32_WINNT < 0x0600) typedef short sa_family_t; #else typedef ADDRESS_FAMILY sa_family_t; #endif #else /* WIN32 */ #include #if defined(__sun) #include #include #elif (defined(BSD) && BSD >= 199306) || defined (__FreeBSD_kernel__) #include /* Do not move or remove the include below for "sys/socket"! * Will break FreeBSD builds. */ #include #endif #include /* for inet_pton() */ #include #include /*! This typedef makes the code slightly more WIN32 tolerant. * On WIN32 systems, SOCKET is unsigned and is not a file * descriptor. */ typedef int SOCKET; /*! INVALID_SOCKET is unsigned on win32. */ #define INVALID_SOCKET (-1) /*! select() returns SOCKET_ERROR on win32. */ #define SOCKET_ERROR (-1) /*! Alias to close() to make code more WIN32 tolerant. */ #define UpnpCloseSocket close #endif /* WIN32 */ /* @} Sock */ #endif /* UPNPINET_H */ pupnp-release-1.8.0/upnp/inc/UpnpIntTypes.h000066400000000000000000000003111303304015100206070ustar00rootroot00000000000000#ifndef UPNPINTTYPES_H #define UPNPINTTYPES_H #if !defined(UPNP_USE_BCBPP) /* Printf format for integers. */ #include #endif /* !defined(UPNP_USE_BCBPP) */ #endif /* UPNPINTTYPES_H */ pupnp-release-1.8.0/upnp/inc/UpnpStdInt.h000066400000000000000000000005171303304015100202450ustar00rootroot00000000000000#ifndef UPNPSTDINT_H #define UPNPSTDINT_H #if !defined(UPNP_USE_BCBPP) /* Sized integer types. */ #include #ifdef UPNP_USE_MSVCPP /* no ssize_t defined for VC */ #ifdef _WIN64 typedef int64_t ssize_t; #else typedef int32_t ssize_t; #endif #endif #endif /* !defined(UPNP_USE_BCBPP) */ #endif /* UPNPSTDINT_H */ pupnp-release-1.8.0/upnp/inc/UpnpString.h000066400000000000000000000061201303304015100203020ustar00rootroot00000000000000 #ifndef STRING_H #define STRING_H /*! * \defgroup UpnpString The UpnpString Class * * \brief Implements string operations in the UPnP library. * * \author Marcelo Roberto Jimenez * * \version 1.0 * * @{ * * \file * * \brief UpnpString object declaration. */ #include "UpnpGlobal.h" /* for EXPORT_SPEC */ #include /* for size_t */ #ifdef __cplusplus extern "C" { #endif /* __cplusplus */ /*! * \brief Type of the string objects inside libupnp. */ typedef struct s_UpnpString UpnpString; /*! * \brief Constructor. * * \return A pointer to a new allocated object. */ EXPORT_SPEC UpnpString *UpnpString_new(); /*! * \brief Destructor. */ EXPORT_SPEC void UpnpString_delete( /*! [in] The \em \b this pointer. */ UpnpString *p); /*! * \brief Copy Constructor. * * \return A pointer to a new allocated copy of the original object. */ EXPORT_SPEC UpnpString *UpnpString_dup( /*! [in] The \em \b this pointer. */ const UpnpString *p); /*! * \brief Assignment operator. */ EXPORT_SPEC void UpnpString_assign( /*! [in] The \em \b this pointer. */ UpnpString *p, /*! [in] The \em \b that pointer. */ const UpnpString *q); /*! * \brief Returns the length of the string. * * \return The length of the string. * */ EXPORT_SPEC size_t UpnpString_get_Length( /*! [in] The \em \b this pointer. */ const UpnpString *p); /*! * \brief Truncates the string to the specified lenght, or does nothing * if the current lenght is less than or equal to the requested length. * */ EXPORT_SPEC void UpnpString_set_Length( /*! [in] The \em \b this pointer. */ UpnpString *p, /*! [in] The requested length. */ size_t n); /*! * \brief Returns the pointer to char. * * \return The pointer to char. */ EXPORT_SPEC const char *UpnpString_get_String( /*! [in] The \em \b this pointer. */ const UpnpString *p); /*! * \brief Sets the string from a pointer to char. */ EXPORT_SPEC int UpnpString_set_String( /*! [in] The \em \b this pointer. */ UpnpString *p, /*! [in] (char *) to copy from. */ const char *s); /*! * \brief Sets the string from a pointer to char using a maximum of N chars. */ EXPORT_SPEC int UpnpString_set_StringN( /*! [in] The \em \b this pointer. */ UpnpString *p, /*! [in] (char *) to copy from. */ const char *s, /*! Maximum number of chars to copy.*/ size_t n); /*! * \brief Clears the string, sets its size to zero. */ EXPORT_SPEC void UpnpString_clear( /*! [in] The \em \b this pointer. */ UpnpString *p); /*! * \brief Compares two strings for equality. Case matters. * * \return The result of strcmp(). */ EXPORT_SPEC int UpnpString_cmp( /*! [in] The \em \b the first string. */ UpnpString *p, /*! [in] The \em \b the second string. */ UpnpString *q); /*! * \brief Compares two strings for equality. Case does not matter. * * \return The result of strcasecmp(). */ EXPORT_SPEC int UpnpString_casecmp( /*! [in] The \em \b the first string. */ UpnpString *p, /*! [in] The \em \b the second string. */ UpnpString *q); #ifdef __cplusplus } #endif /* __cplusplus */ /* @} UpnpString The UpnpString API */ #endif /* STRING_H */ pupnp-release-1.8.0/upnp/inc/UpnpUniStd.h000066400000000000000000000003131303304015100202400ustar00rootroot00000000000000#ifndef UPNPUNISTD_H #define UPNPUNISTD_H #ifdef WIN32 /* Do not #include on WIN32. */ #else /* WIN32 */ #include /* for close() */ #endif /* WIN32 */ #endif /* UPNPUNISTD_H */ pupnp-release-1.8.0/upnp/inc/list.h000066400000000000000000000515461303304015100171600ustar00rootroot00000000000000#ifndef _LINUX_LIST_H #define _LINUX_LIST_H #if 0 #include #include #include #include #endif #include "poison.h" #ifdef __APPLE__ /* Apple systems define these macros in system headers, so we undef * them prior to inclusion of this file */ #undef LIST_HEAD #undef LIST_HEAD_INIT #undef INIT_LIST_HEAD #endif /* * Simple doubly linked list implementation. * * Some of the internal functions ("__xxx") are useful when * manipulating whole lists rather than single entries, as * sometimes we already know the next/prev entries and we can * generate better code by using them directly rather than * using the generic single-entry routines. */ struct list_head { struct list_head *next, *prev; }; #define LIST_HEAD_INIT(name) { &(name), &(name) } #define LIST_HEAD(name) \ struct list_head name = LIST_HEAD_INIT(name) static UPNP_INLINE void INIT_LIST_HEAD(struct list_head *list) { list->next = list; list->prev = list; } /* * Insert a new entry between two known consecutive entries. * * This is only for internal list manipulation where we know * the prev/next entries already! */ #ifndef CONFIG_DEBUG_LIST static UPNP_INLINE void __list_add(struct list_head *new_, struct list_head *prev, struct list_head *next) { next->prev = new_; new_->next = next; new_->prev = prev; prev->next = new_; } #else extern void __list_add(struct list_head *new_, struct list_head *prev, struct list_head *next); #endif /** * list_add - add a new entry * @new_: new entry to be added * @head: list head to add it after * * Insert a new entry after the specified head. * This is good for implementing stacks. */ static UPNP_INLINE void list_add(struct list_head *new_, struct list_head *head) { __list_add(new_, head, head->next); } /** * list_add_tail - add a new entry * @new_: new entry to be added * @head: list head to add it before * * Insert a new entry before the specified head. * This is useful for implementing queues. */ static UPNP_INLINE void list_add_tail(struct list_head *new_, struct list_head *head) { __list_add(new_, head->prev, head); } /* * Delete a list entry by making the prev/next entries * point to each other. * * This is only for internal list manipulation where we know * the prev/next entries already! */ static UPNP_INLINE void __list_del(struct list_head * prev, struct list_head * next) { next->prev = prev; prev->next = next; } /** * list_del - deletes entry from list. * @entry: the element to delete from the list. * Note: list_empty() on entry does not return true after this, the entry is * in an undefined state. */ #ifndef CONFIG_DEBUG_LIST static UPNP_INLINE void list_del(struct list_head *entry) { __list_del(entry->prev, entry->next); entry->next = (struct list_head *)LIST_POISON1; entry->prev = (struct list_head *)LIST_POISON2; } #else extern void list_del(struct list_head *entry); #endif /** * list_replace - replace old entry by new one * @old : the element to be replaced * @new_ : the new element to insert * * If @old was empty, it will be overwritten. */ static UPNP_INLINE void list_replace(struct list_head *old, struct list_head *new_) { new_->next = old->next; new_->next->prev = new_; new_->prev = old->prev; new_->prev->next = new_; } static UPNP_INLINE void list_replace_init(struct list_head *old, struct list_head *new_) { list_replace(old, new_); INIT_LIST_HEAD(old); } /** * list_del_init - deletes entry from list and reinitialize it. * @entry: the element to delete from the list. */ static UPNP_INLINE void list_del_init(struct list_head *entry) { __list_del(entry->prev, entry->next); INIT_LIST_HEAD(entry); } /** * list_move - delete from one list and add as another's head * @list: the entry to move * @head: the head that will precede our entry */ static UPNP_INLINE void list_move(struct list_head *list, struct list_head *head) { __list_del(list->prev, list->next); list_add(list, head); } /** * list_move_tail - delete from one list and add as another's tail * @list: the entry to move * @head: the head that will follow our entry */ static UPNP_INLINE void list_move_tail(struct list_head *list, struct list_head *head) { __list_del(list->prev, list->next); list_add_tail(list, head); } /** * list_is_last - tests whether @list is the last entry in list @head * @list: the entry to test * @head: the head of the list */ static UPNP_INLINE int list_is_last(const struct list_head *list, const struct list_head *head) { return list->next == head; } /** * list_empty - tests whether a list is empty * @head: the list to test. */ static UPNP_INLINE int list_empty(const struct list_head *head) { return head->next == head; } /** * list_empty_careful - tests whether a list is empty and not being modified * @head: the list to test * * Description: * tests whether a list is empty _and_ checks that no other CPU might be * in the process of modifying either member (next or prev) * * NOTE: using list_empty_careful() without synchronization * can only be safe if the only activity that can happen * to the list entry is list_del_init(). Eg. it cannot be used * if another CPU could re-list_add() it. */ static UPNP_INLINE int list_empty_careful(const struct list_head *head) { struct list_head *next = head->next; return (next == head) && (next == head->prev); } /** * list_rotate_left - rotate the list to the left * @head: the head of the list */ static UPNP_INLINE void list_rotate_left(struct list_head *head) { struct list_head *first; if (!list_empty(head)) { first = head->next; list_move_tail(first, head); } } /** * list_is_singular - tests whether a list has just one entry. * @head: the list to test. */ static UPNP_INLINE int list_is_singular(const struct list_head *head) { return !list_empty(head) && (head->next == head->prev); } static UPNP_INLINE void __list_cut_position(struct list_head *list, struct list_head *head, struct list_head *entry) { struct list_head *new_first = entry->next; list->next = head->next; list->next->prev = list; list->prev = entry; entry->next = list; head->next = new_first; new_first->prev = head; } /** * list_cut_position - cut a list into two * @list: a new list to add all removed entries * @head: a list with entries * @entry: an entry within head, could be the head itself * and if so we won't cut the list * * This helper moves the initial part of @head, up to and * including @entry, from @head to @list. You should * pass on @entry an element you know is on @head. @list * should be an empty list or a list you do not care about * losing its data. * */ static UPNP_INLINE void list_cut_position(struct list_head *list, struct list_head *head, struct list_head *entry) { if (list_empty(head)) return; if (list_is_singular(head) && (head->next != entry && head != entry)) return; if (entry == head) INIT_LIST_HEAD(list); else __list_cut_position(list, head, entry); } static UPNP_INLINE void __list_splice(const struct list_head *list, struct list_head *prev, struct list_head *next) { struct list_head *first = list->next; struct list_head *last = list->prev; first->prev = prev; prev->next = first; last->next = next; next->prev = last; } /** * list_splice - join two lists, this is designed for stacks * @list: the new list to add. * @head: the place to add it in the first list. */ static UPNP_INLINE void list_splice(const struct list_head *list, struct list_head *head) { if (!list_empty(list)) __list_splice(list, head, head->next); } /** * list_splice_tail - join two lists, each list being a queue * @list: the new list to add. * @head: the place to add it in the first list. */ static UPNP_INLINE void list_splice_tail(struct list_head *list, struct list_head *head) { if (!list_empty(list)) __list_splice(list, head->prev, head); } /** * list_splice_init - join two lists and reinitialise the emptied list. * @list: the new list to add. * @head: the place to add it in the first list. * * The list at @list is reinitialised */ static UPNP_INLINE void list_splice_init(struct list_head *list, struct list_head *head) { if (!list_empty(list)) { __list_splice(list, head, head->next); INIT_LIST_HEAD(list); } } /** * list_splice_tail_init - join two lists and reinitialise the emptied list * @list: the new list to add. * @head: the place to add it in the first list. * * Each of the lists is a queue. * The list at @list is reinitialised */ static UPNP_INLINE void list_splice_tail_init(struct list_head *list, struct list_head *head) { if (!list_empty(list)) { __list_splice(list, head->prev, head); INIT_LIST_HEAD(list); } } /** * list_entry - get the struct for this entry * @ptr: the &struct list_head pointer. * @type: the type of the struct this is embedded in. * @member: the name of the list_struct within the struct. */ #define list_entry(ptr, type, member) \ container_of(ptr, type, member) /** * list_first_entry - get the first element from a list * @ptr: the list head to take the element from. * @type: the type of the struct this is embedded in. * @member: the name of the list_struct within the struct. * * Note, that list is expected to be not empty. */ #define list_first_entry(ptr, type, member) \ list_entry((ptr)->next, type, member) /** * list_for_each - iterate over a list * @pos: the &struct list_head to use as a loop cursor. * @head: the head for your list. */ #define list_for_each(pos, head) \ for (pos = (head)->next; prefetch(pos->next), pos != (head); \ pos = pos->next) /** * __list_for_each - iterate over a list * @pos: the &struct list_head to use as a loop cursor. * @head: the head for your list. * * This variant differs from list_for_each() in that it's the * simplest possible list iteration code, no prefetching is done. * Use this for code that knows the list to be very short (empty * or 1 entry) most of the time. */ #define __list_for_each(pos, head) \ for (pos = (head)->next; pos != (head); pos = pos->next) /** * list_for_each_prev - iterate over a list backwards * @pos: the &struct list_head to use as a loop cursor. * @head: the head for your list. */ #define list_for_each_prev(pos, head) \ for (pos = (head)->prev; prefetch(pos->prev), pos != (head); \ pos = pos->prev) /** * list_for_each_safe - iterate over a list safe against removal of list entry * @pos: the &struct list_head to use as a loop cursor. * @n: another &struct list_head to use as temporary storage * @head: the head for your list. */ #define list_for_each_safe(pos, n, head) \ for (pos = (head)->next, n = pos->next; pos != (head); \ pos = n, n = pos->next) /** * list_for_each_prev_safe - iterate over a list backwards safe against removal of list entry * @pos: the &struct list_head to use as a loop cursor. * @n: another &struct list_head to use as temporary storage * @head: the head for your list. */ #define list_for_each_prev_safe(pos, n, head) \ for (pos = (head)->prev, n = pos->prev; \ prefetch(pos->prev), pos != (head); \ pos = n, n = pos->prev) /** * list_for_each_entry - iterate over list of given type * @pos: the type * to use as a loop cursor. * @head: the head for your list. * @member: the name of the list_struct within the struct. */ #define list_for_each_entry(pos, head, member) \ for (pos = list_entry((head)->next, typeof(*pos), member); \ prefetch(pos->member.next), &pos->member != (head); \ pos = list_entry(pos->member.next, typeof(*pos), member)) /** * list_for_each_entry_reverse - iterate backwards over list of given type. * @pos: the type * to use as a loop cursor. * @head: the head for your list. * @member: the name of the list_struct within the struct. */ #define list_for_each_entry_reverse(pos, head, member) \ for (pos = list_entry((head)->prev, typeof(*pos), member); \ prefetch(pos->member.prev), &pos->member != (head); \ pos = list_entry(pos->member.prev, typeof(*pos), member)) /** * list_prepare_entry - prepare a pos entry for use in list_for_each_entry_continue() * @pos: the type * to use as a start point * @head: the head of the list * @member: the name of the list_struct within the struct. * * Prepares a pos entry for use as a start point in list_for_each_entry_continue(). */ #define list_prepare_entry(pos, head, member) \ ((pos) ? : list_entry(head, typeof(*pos), member)) /** * list_for_each_entry_continue - continue iteration over list of given type * @pos: the type * to use as a loop cursor. * @head: the head for your list. * @member: the name of the list_struct within the struct. * * Continue to iterate over list of given type, continuing after * the current position. */ #define list_for_each_entry_continue(pos, head, member) \ for (pos = list_entry(pos->member.next, typeof(*pos), member); \ prefetch(pos->member.next), &pos->member != (head); \ pos = list_entry(pos->member.next, typeof(*pos), member)) /** * list_for_each_entry_continue_reverse - iterate backwards from the given point * @pos: the type * to use as a loop cursor. * @head: the head for your list. * @member: the name of the list_struct within the struct. * * Start to iterate over list of given type backwards, continuing after * the current position. */ #define list_for_each_entry_continue_reverse(pos, head, member) \ for (pos = list_entry(pos->member.prev, typeof(*pos), member); \ prefetch(pos->member.prev), &pos->member != (head); \ pos = list_entry(pos->member.prev, typeof(*pos), member)) /** * list_for_each_entry_from - iterate over list of given type from the current point * @pos: the type * to use as a loop cursor. * @head: the head for your list. * @member: the name of the list_struct within the struct. * * Iterate over list of given type, continuing from current position. */ #define list_for_each_entry_from(pos, head, member) \ for (; prefetch(pos->member.next), &pos->member != (head); \ pos = list_entry(pos->member.next, typeof(*pos), member)) /** * list_for_each_entry_safe - iterate over list of given type safe against removal of list entry * @pos: the type * to use as a loop cursor. * @n: another type * to use as temporary storage * @head: the head for your list. * @member: the name of the list_struct within the struct. */ #define list_for_each_entry_safe(pos, n, head, member) \ for (pos = list_entry((head)->next, typeof(*pos), member), \ n = list_entry(pos->member.next, typeof(*pos), member); \ &pos->member != (head); \ pos = n, n = list_entry(n->member.next, typeof(*n), member)) /** * list_for_each_entry_safe_continue - continue list iteration safe against removal * @pos: the type * to use as a loop cursor. * @n: another type * to use as temporary storage * @head: the head for your list. * @member: the name of the list_struct within the struct. * * Iterate over list of given type, continuing after current point, * safe against removal of list entry. */ #define list_for_each_entry_safe_continue(pos, n, head, member) \ for (pos = list_entry(pos->member.next, typeof(*pos), member), \ n = list_entry(pos->member.next, typeof(*pos), member); \ &pos->member != (head); \ pos = n, n = list_entry(n->member.next, typeof(*n), member)) /** * list_for_each_entry_safe_from - iterate over list from current point safe against removal * @pos: the type * to use as a loop cursor. * @n: another type * to use as temporary storage * @head: the head for your list. * @member: the name of the list_struct within the struct. * * Iterate over list of given type from current point, safe against * removal of list entry. */ #define list_for_each_entry_safe_from(pos, n, head, member) \ for (n = list_entry(pos->member.next, typeof(*pos), member); \ &pos->member != (head); \ pos = n, n = list_entry(n->member.next, typeof(*n), member)) /** * list_for_each_entry_safe_reverse - iterate backwards over list safe against removal * @pos: the type * to use as a loop cursor. * @n: another type * to use as temporary storage * @head: the head for your list. * @member: the name of the list_struct within the struct. * * Iterate backwards over list of given type, safe against removal * of list entry. */ #define list_for_each_entry_safe_reverse(pos, n, head, member) \ for (pos = list_entry((head)->prev, typeof(*pos), member), \ n = list_entry(pos->member.prev, typeof(*pos), member); \ &pos->member != (head); \ pos = n, n = list_entry(n->member.prev, typeof(*n), member)) /* * Double linked lists with a single pointer list head. * Mostly useful for hash tables where the two pointer list head is * too wasteful. * You lose the ability to access the tail in O(1). */ struct hlist_head { struct hlist_node *first; }; struct hlist_node { struct hlist_node *next, **pprev; }; #define HLIST_HEAD_INIT { .first = NULL } #define HLIST_HEAD(name) struct hlist_head name = { .first = NULL } #define INIT_HLIST_HEAD(ptr) ((ptr)->first = NULL) static UPNP_INLINE void INIT_HLIST_NODE(struct hlist_node *h) { h->next = NULL; h->pprev = NULL; } static UPNP_INLINE int hlist_unhashed(const struct hlist_node *h) { return !h->pprev; } static UPNP_INLINE int hlist_empty(const struct hlist_head *h) { return !h->first; } static UPNP_INLINE void __hlist_del(struct hlist_node *n) { struct hlist_node *next = n->next; struct hlist_node **pprev = n->pprev; *pprev = next; if (next) next->pprev = pprev; } static UPNP_INLINE void hlist_del(struct hlist_node *n) { __hlist_del(n); n->next = (struct hlist_node *)LIST_POISON1; n->pprev = (struct hlist_node **)LIST_POISON2; } static UPNP_INLINE void hlist_del_init(struct hlist_node *n) { if (!hlist_unhashed(n)) { __hlist_del(n); INIT_HLIST_NODE(n); } } static UPNP_INLINE void hlist_add_head(struct hlist_node *n, struct hlist_head *h) { struct hlist_node *first = h->first; n->next = first; if (first) first->pprev = &n->next; h->first = n; n->pprev = &h->first; } /* next must be != NULL */ static UPNP_INLINE void hlist_add_before(struct hlist_node *n, struct hlist_node *next) { n->pprev = next->pprev; n->next = next; next->pprev = &n->next; *(n->pprev) = n; } static UPNP_INLINE void hlist_add_after(struct hlist_node *n, struct hlist_node *next) { next->next = n->next; n->next = next; next->pprev = &n->next; if(next->next) next->next->pprev = &next->next; } /* * Move a list from one list head to another. Fixup the pprev * reference of the first entry if it exists. */ static UPNP_INLINE void hlist_move_list(struct hlist_head *old, struct hlist_head *new_) { new_->first = old->first; if (new_->first) new_->first->pprev = &new_->first; old->first = NULL; } #define hlist_entry(ptr, type, member) container_of(ptr,type,member) #define hlist_for_each(pos, head) \ for (pos = (head)->first; pos && ({ prefetch(pos->next); 1; }); \ pos = pos->next) #define hlist_for_each_safe(pos, n, head) \ for (pos = (head)->first; pos && ({ n = pos->next; 1; }); \ pos = n) /** * hlist_for_each_entry - iterate over list of given type * @tpos: the type * to use as a loop cursor. * @pos: the &struct hlist_node to use as a loop cursor. * @head: the head for your list. * @member: the name of the hlist_node within the struct. */ #define hlist_for_each_entry(tpos, pos, head, member) \ for (pos = (head)->first; \ pos && ({ prefetch(pos->next); 1;}) && \ ({ tpos = hlist_entry(pos, typeof(*tpos), member); 1;}); \ pos = pos->next) /** * hlist_for_each_entry_continue - iterate over a hlist continuing after current point * @tpos: the type * to use as a loop cursor. * @pos: the &struct hlist_node to use as a loop cursor. * @member: the name of the hlist_node within the struct. */ #define hlist_for_each_entry_continue(tpos, pos, member) \ for (pos = (pos)->next; \ pos && ({ prefetch(pos->next); 1;}) && \ ({ tpos = hlist_entry(pos, typeof(*tpos), member); 1;}); \ pos = pos->next) /** * hlist_for_each_entry_from - iterate over a hlist continuing from current point * @tpos: the type * to use as a loop cursor. * @pos: the &struct hlist_node to use as a loop cursor. * @member: the name of the hlist_node within the struct. */ #define hlist_for_each_entry_from(tpos, pos, member) \ for (; pos && ({ prefetch(pos->next); 1;}) && \ ({ tpos = hlist_entry(pos, typeof(*tpos), member); 1;}); \ pos = pos->next) /** * hlist_for_each_entry_safe - iterate over list of given type safe against removal of list entry * @tpos: the type * to use as a loop cursor. * @pos: the &struct hlist_node to use as a loop cursor. * @n: another &struct hlist_node to use as temporary storage * @head: the head for your list. * @member: the name of the hlist_node within the struct. */ #define hlist_for_each_entry_safe(tpos, pos, n, head, member) \ for (pos = (head)->first; \ pos && ({ n = pos->next; 1; }) && \ ({ tpos = hlist_entry(pos, typeof(*tpos), member); 1;}); \ pos = n) #endif pupnp-release-1.8.0/upnp/inc/poison.h000066400000000000000000000050621303304015100175040ustar00rootroot00000000000000#ifndef _LINUX_POISON_H #define _LINUX_POISON_H /********** include/linux/list.h **********/ /* * Architectures might want to move the poison pointer offset * into some well-recognized area such as 0xdead000000000000, * that is also not mappable by user-space exploits: */ #ifdef CONFIG_ILLEGAL_POINTER_VALUE # define POISON_POINTER_DELTA _AC(CONFIG_ILLEGAL_POINTER_VALUE, UL) #else # define POISON_POINTER_DELTA 0 #endif /* * These are non-NULL pointers that will result in page faults * under normal circumstances, used to verify that nobody uses * non-initialized list entries. */ #define LIST_POISON1 ((void *) (0x00100100 + POISON_POINTER_DELTA)) #define LIST_POISON2 ((void *) (0x00200200 + POISON_POINTER_DELTA)) /********** include/linux/timer.h **********/ /* * Magic number "tsta" to indicate a static timer initializer * for the object debugging code. */ #define TIMER_ENTRY_STATIC ((void *) 0x74737461) /********** mm/debug-pagealloc.c **********/ #define PAGE_POISON 0xaa /********** mm/slab.c **********/ /* * Magic nums for obj red zoning. * Placed in the first word before and the first word after an obj. */ #define RED_INACTIVE 0x09F911029D74E35BULL /* when obj is inactive */ #define RED_ACTIVE 0xD84156C5635688C0ULL /* when obj is active */ #define SLUB_RED_INACTIVE 0xbb #define SLUB_RED_ACTIVE 0xcc /* ...and for poisoning */ #define POISON_INUSE 0x5a /* for use-uninitialised poisoning */ #define POISON_FREE 0x6b /* for use-after-free poisoning */ #define POISON_END 0xa5 /* end-byte of poisoning */ /********** arch/$ARCH/mm/init.c **********/ #define POISON_FREE_INITMEM 0xcc /********** arch/ia64/hp/common/sba_iommu.c **********/ /* * arch/ia64/hp/common/sba_iommu.c uses a 16-byte poison string with a * value of "SBAIOMMU POISON\0" for spill-over poisoning. */ /********** fs/jbd/journal.c **********/ #define JBD_POISON_FREE 0x5b #define JBD2_POISON_FREE 0x5c /********** drivers/base/dmapool.c **********/ #define POOL_POISON_FREED 0xa7 /* !inuse */ #define POOL_POISON_ALLOCATED 0xa9 /* !initted */ /********** drivers/atm/ **********/ #define ATM_POISON_FREE 0x12 #define ATM_POISON 0xdeadbeef /********** net/ **********/ #define NEIGHBOR_DEAD 0xdeadbeef #define NETFILTER_LINK_POISON 0xdead57ac /********** kernel/mutexes **********/ #define MUTEX_DEBUG_INIT 0x11 #define MUTEX_DEBUG_FREE 0x22 /********** lib/flex_array.c **********/ #define FLEX_ARRAY_FREE 0x6c /* for use-after-free poisoning */ /********** security/ **********/ #define KEY_DESTROY 0xbd /********** sound/oss/ **********/ #define OSS_POISON_FREE 0xAB #endif pupnp-release-1.8.0/upnp/inc/upnp.h000066400000000000000000003310371303304015100171630ustar00rootroot00000000000000#ifndef UPNP_H #define UPNP_H /******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (C) 2011-2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * * Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \defgroup UPnPAPI UPnP API * * @{ * * \file */ #include "ixml.h" #include "upnpconfig.h" #include "UpnpGlobal.h" #include "UpnpInet.h" /* * \todo Document the exact reason of these include files and solve this * include mess in an include file like UpnpTime.h */ #ifdef WIN32 #include #ifdef UPNP_USE_MSVCPP #include /* needed for off_t */ #endif #elif (defined(BSD) && BSD >= 199306) #include #else /* Other systems ??? */ #endif #ifdef UPNP_ENABLE_OPEN_SSL #include #endif #define LINE_SIZE (size_t)180 #define NAME_SIZE (size_t)256 #define MNFT_NAME_SIZE 64 #define MODL_NAME_SIZE 32 #define SERL_NUMR_SIZE 64 #define MODL_DESC_SIZE 64 #define UPNP_INFINITE -1 #define UPNP_USING_CHUNKED -3 #define UPNP_UNTIL_CLOSE -4 /*! * \name Error codes * * The functions in the SDK API can return a variety of error * codes to describe problems encountered during execution. This section * lists the error codes and provides a brief description of what each error * code means. Refer to the documentation for each function for a * description of what an error code means in that context. * * @{ */ /*! * \brief The operation completed successfully. * * For asynchronous functions, this only means that the packet generated by * the operation was successfully transmitted on the network. The result of * the entire operation comes as part of the callback for that operation. */ #define UPNP_E_SUCCESS 0 /*! * \brief The handle passed to a function is not a recognized as a valid handle. */ #define UPNP_E_INVALID_HANDLE -100 /*! * \brief One or more of the parameters passed to the function is not valid. * * Refer to the documentation for each function for more information on the * valid ranges of the parameters. */ #define UPNP_E_INVALID_PARAM -101 /*! * \brief The SDK does not have any more space for additional handles. * * The SDK allocates space for only a few handles in order to conserve memory. */ #define UPNP_E_OUTOF_HANDLE -102 #define UPNP_E_OUTOF_CONTEXT -103 /*! * \brief Not enough resources are currently available to complete the operation. * * Most operations require some free memory in order to complete their work. */ #define UPNP_E_OUTOF_MEMORY -104 /*! * \brief The SDK has already been initialized. * * The SDK needs to be initialied only once per process. Any additional * initialization attempts simply return this error with no other ill effects. */ #define UPNP_E_INIT -105 #define UPNP_E_BUFFER_TOO_SMALL -106 /*! * \brief The description document passed to \b UpnpRegisterRootDevice, * \b UpnpRegisterRootDevice2 \b UpnpRegisterRootDevice3 or * \b UpnpRegisterRootDevice4 is invalid. */ #define UPNP_E_INVALID_DESC -107 /*! * \brief An URL passed into the function is invalid. * * The actual cause is function specific, but in general, the URL itself * might be malformed (e.g. have invalid characters in it) or the host might * be unreachable. */ #define UPNP_E_INVALID_URL -108 #define UPNP_E_INVALID_SID -109 #define UPNP_E_INVALID_DEVICE -110 /*! * \brief The device ID/service ID pair does not refer to a valid service. * * Returned only by \b UpnpNotify, \b UpnpNotifyExt, \b UpnpAcceptSubscription, * and \b UpnpAcceptSubscriptionExt. */ #define UPNP_E_INVALID_SERVICE -111 /*! * \brief The response received from the remote side of a connection is not correct * for the protocol. * * This applies to the GENA, SOAP, and HTTP protocols. */ #define UPNP_E_BAD_RESPONSE -113 #define UPNP_E_BAD_REQUEST -114 /*! * \brief The SOAP action message is invalid. * * This can be because the DOM document passed to the function was malformed or * the action message is not correct for the given action. */ #define UPNP_E_INVALID_ACTION -115 /*! * \brief \b UpnpInit has not been called, or \b UpnpFinish has already been called. * * None of the API functions operate until \b UpnpInit successfully completes. */ #define UPNP_E_FINISH -116 /*! * \brief \b UpnpInit cannot complete. * * The typical reason is failure to allocate sufficient resources. */ #define UPNP_E_INIT_FAILED -117 /*! * \brief The URL passed into a function is too long. * * The SDK limits URLs to 180 characters in length. */ #define UPNP_E_URL_TOO_BIG -118 /*! * \brief The HTTP message contains invalid message headers. * * The error always refers to the HTTP message header received from the remote * host. The main areas where this occurs are in SOAP control messages (e.g. * \b UpnpSendAction), GENA subscription message (e.g. \b UpnpSubscribe), * GENA event notifications (e.g. \b UpnpNotify), and HTTP transfers (e.g. * \b UpnpDownloadXmlDoc). */ #define UPNP_E_BAD_HTTPMSG -119 /*! * \brief A client or a device is already registered. * * The SDK currently has a limit of one registered client and one registered * device per process. */ #define UPNP_E_ALREADY_REGISTERED -120 /*! * \brief The interface provided to \b UpnpInit2 is unknown or does not have a valid * IPv4 or IPv6 address configured. */ #define UPNP_E_INVALID_INTERFACE -121 /*! * \brief A network error occurred. * * It is the generic error code for network problems that are not covered under * one of the more specific error codes. The typical meaning is the SDK failed * to read the local IP address or had problems configuring one of the sockets. */ #define UPNP_E_NETWORK_ERROR -200 /*! * \brief An error happened while writing to a socket. * * This occurs in any function that makes network connections, such as discovery * (e.g. \b UpnpSearchAsync or \b UpnpSendAdvertisement), control (e.g. * \b UpnpSendAction), eventing (e.g. \b UpnpNotify), and HTTP functions (e.g. * \b UpnpDownloadXmlDoc). */ #define UPNP_E_SOCKET_WRITE -201 /*! * \brief An error happened while reading from a socket. * * This occurs in any function that makes network connections, such as discovery * (e.g. \b UpnpSearchAsync or \b UpnpSendAdvertisement), control (e.g. * \b UpnpSendAction), eventing (e.g. \b UpnpNotify), and HTTP functions (e.g. * \b UpnpDownloadXmlDoc). */ #define UPNP_E_SOCKET_READ -202 /*! * \brief The SDK had a problem binding a socket to a network interface. * * This occurs in any function that makes network connections, such as discovery * (e.g. \b UpnpSearchAsync or \b UpnpSendAdvertisement), control (e.g. * \b UpnpSendAction), eventing (e.g. \b UpnpNotify), and HTTP functions (e.g. * \b UpnpDownloadXmlDoc). */ #define UPNP_E_SOCKET_BIND -203 /*! * \brief The SDK had a problem connecting to a remote host. * * This occurs in any function that makes network connections, such as discovery * (e.g. \b UpnpSearchAsync or \b UpnpSendAdvertisement), control (e.g. * \b UpnpSendAction), eventing (e.g. \b UpnpNotify), and HTTP functions (e.g. * \b UpnpDownloadXmlDoc). */ #define UPNP_E_SOCKET_CONNECT -204 /*! * \brief The SDK cannot create any more sockets. * * This occurs in any function that makes network connections, such as discovery * (e.g. \b UpnpSearchAsync or \b UpnpSendAdvertisement), control (e.g. * \b UpnpSendAction), eventing (e.g. \b UpnpNotify), and HTTP functions (e.g. * \b UpnpDownloadXmlDoc). */ #define UPNP_E_OUTOF_SOCKET -205 /*! * \brief The SDK had a problem setting the socket to listen for incoming * connections. * * This error only happens during initialization (i.e. \b UpnpInit). */ #define UPNP_E_LISTEN -206 /*! * \brief Too much time elapsed before the required number of bytes were sent * or received over a socket. * * This error can be returned by any function that performs network operations. */ #define UPNP_E_TIMEDOUT -207 /*! * \brief Generic socket error code for conditions not covered by other error * codes. * * This error can be returned by any function that performs network operations. */ #define UPNP_E_SOCKET_ERROR -208 #define UPNP_E_FILE_WRITE_ERROR -209 /*! \brief The operation was canceled. * * This error can be returned by any function that allows for external cancelation. */ #define UPNP_E_CANCELED -210 #define UPNP_E_EVENT_PROTOCOL -300 /*! * \brief A subscription request was rejected from the remote side. */ #define UPNP_E_SUBSCRIBE_UNACCEPTED -301 /*! * \brief An unsubscribe request was rejected from the remote side. */ #define UPNP_E_UNSUBSCRIBE_UNACCEPTED -302 /*! * \brief The remote host did not accept the notify sent from the local device. */ #define UPNP_E_NOTIFY_UNACCEPTED -303 /*! * \brief One or more of the parameters passed to a function is invalid. * * Refer to the individual function descriptions for the acceptable ranges for * parameters. */ #define UPNP_E_INVALID_ARGUMENT -501 /*! * \brief The filename passed to one of the device registration functions was * not found or was not accessible. */ #define UPNP_E_FILE_NOT_FOUND -502 /*! * \brief An error happened while reading a file. */ #define UPNP_E_FILE_READ_ERROR -503 /*! * \brief The file name of the description document passed to * \b UpnpRegisterRootDevice2 does not end in ".xml". */ #define UPNP_E_EXT_NOT_XML -504 #define UPNP_E_NO_WEB_SERVER -505 #define UPNP_E_OUTOF_BOUNDS -506 /*! * \brief The response to a SOAP request did not contain the required XML * constructs. */ #define UPNP_E_NOT_FOUND -507 /*! * \brief Generic error code for internal conditions not covered by other * error codes. */ #define UPNP_E_INTERNAL_ERROR -911 /* SOAP-related error codes */ #define UPNP_SOAP_E_INVALID_ACTION 401 #define UPNP_SOAP_E_INVALID_ARGS 402 #define UPNP_SOAP_E_OUT_OF_SYNC 403 #define UPNP_SOAP_E_INVALID_VAR 404 #define UPNP_SOAP_E_ACTION_FAILED 501 /* @} ErrorCodes */ /* * Opaque data structures. The following includes are data structures that * must be externally visible. Since version 1.8.0, only an opaque typedef * is visible from the outside world. Any operation on these data types * must be done using the appropriate interface functions. * * This policy has the great advantage that it is now possible to change * the internal implementation of these data structures without breaking * the API. */ #include "ActionComplete.h" #include "ActionRequest.h" #include "Discovery.h" #include "Event.h" #include "EventSubscribe.h" #include "FileInfo.h" #include "StateVarComplete.h" #include "StateVarRequest.h" #include "SubscriptionRequest.h" /*! * \name Constants and Types * * @{ */ enum UpnpOpenFileMode { UPNP_READ, UPNP_WRITE }; /*! * \brief Returned when a control point application registers with * \b UpnpRegisterClient. * * Client handles can only be used with functions that operate with a client * handle. */ typedef int UpnpClient_Handle; /*! * \brief Returned when a device application registers with * \b UpnpRegisterRootDevice, \b UpnpRegisterRootDevice2, * \b UpnpRegisterRootDevice3 or \b UpnpRegisterRootDevice4. * * Device handles can only be used with functions that operate with a device * handle. */ typedef int UpnpDevice_Handle; /*! * \brief Holds the subscription identifier for a subscription between a * client and a device. * * The SID is a string representation of a globally unique id (GUID) and should * not be modified. */ typedef char Upnp_SID[44]; /*! * \brief Represents the different types of searches that can be performed * using the SDK for UPnP Devices API. * * By specifying these different values to \b UpnpSearchAsync, the control * point application can control the scope of the search from all devices * to specific devices or services. */ enum Upnp_SType_e { /*! Search for all devices and services on the network. */ UPNP_S_ALL, /*! Search for all root devices on the network. */ UPNP_S_ROOT, /*! Search for a particular device type or a particular device instance. */ UPNP_S_DEVICE, /*! Search for a particular service type, possibly on a particular * device type or device instance. */ UPNP_S_SERVICE }; typedef enum Upnp_SType_e Upnp_SType; /*! * \brief Specifies the type of description in \b UpnpRegisterRootDevice2. * * These values control how \b UpnpRegisterRootDevice2 interprets the * \b description parameter. */ enum Upnp_DescType_e { /*! The description is the URL to the description document. */ UPNPREG_URL_DESC, /*! The description is a file name on the local file system containing the description of the device. */ UPNPREG_FILENAME_DESC, /*! The description is a pointer to a character array containing the XML description document. */ UPNPREG_BUF_DESC }; typedef enum Upnp_DescType_e Upnp_DescType; #include "Callback.h" /* @} Constants and Types */ #ifdef __cplusplus extern "C" { #endif /* __cplusplus */ /*! * \name Initialization and Registration * * @{ */ /*! * \brief Initializes the Linux SDK for UPnP Devices (IPv4 only). * * \deprecated Kept for backwards compatibility. Use UpnpInit2 for new * implementations or where IPv6 is required. * * This function must be called before any other API function can be called. * It should be called only once. Subsequent calls to this API return a * \c UPNP_E_INIT error code. * * Optionally, the application can specify a host IPv4 address (in the * case of a multi-homed configuration) and a port number to use for * all UPnP operations. Since a port number can be used only by one * process, multiple processes using the SDK must specify * different port numbers. * * If unspecified, the SDK will use the first IPv4-capable adapter's IP address * and an arbitrary port. * * This call is synchronous. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist * to initialize the SDK. * \li \c UPNP_E_INIT: The SDK is already initialized. * \li \c UPNP_E_INIT_FAILED: The SDK initialization * failed for an unknown reason. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_LISTEN: An error occurred listening to a socket. * \li \c UPNP_E_OUTOF_SOCKET: An error ocurred creating a socket. * \li \c UPNP_E_INTERNAL_ERROR: An internal error ocurred. */ EXPORT_SPEC int UpnpInit( /*! The host local IPv4 address to use, in string format, for example * "192.168.0.1", or \c NULL to use the first IPv4 adapter's IP address. */ const char *HostIP, /*! Local Port to listen for incoming connections * \c NULL will pick an arbitrary free port. */ unsigned short DestPort); /*! * \brief Initializes the Linux SDK for UPnP Devices (IPv4 or IPv6). * * This function must be called before any other API function can be called. * It should be called only once. Subsequent calls to this API return a * \c UPNP_E_INIT error code. * * Optionally, the application can specify an interface name (in the * case of a multi-homed configuration) and a port number to use for * all UPnP operations. Since a port number can be used only by one * process, multiple processes using the SDK must specify * different port numbers. * * If unspecified, the SDK will use the first suitable interface and an * arbitrary port. * * This call is synchronous. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist * to initialize the SDK. * \li \c UPNP_E_INIT: The SDK is already initialized. * \li \c UPNP_E_INIT_FAILED: The SDK initialization * failed for an unknown reason. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_LISTEN: An error occurred listening to a socket. * \li \c UPNP_E_OUTOF_SOCKET: An error ocurred creating a socket. * \li \c UPNP_E_INTERNAL_ERROR: An internal error ocurred. * \li \c UPNP_E_INVALID_INTERFACE: IfName is invalid or does not * have a valid IPv4 or IPv6 addresss configured. */ #ifdef UPNP_ENABLE_IPV6 EXPORT_SPEC int UpnpInit2( /*! The interface name to use by the UPnP SDK operations. * Examples: "eth0", "xl0", "Local Area Connection", \c NULL to * use the first suitable interface. */ const char *IfName, /*! Local Port to listen for incoming connections. * \c NULL will pick an arbitrary free port. */ unsigned short DestPort); #endif /*! * \brief Initializes the OpenSSL library, and the OpenSSL context for use * with pupnp * * \note This method is only enabled if pupnp is compiled with open-ssl support. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INIT: The SDK is already initialized. * \li \c UPNP_E_INIT_FAILED: The SDK initialization * failed for an unknown reason. */ #ifdef UPNP_ENABLE_OPEN_SSL EXPORT_SPEC int UpnpInitSslContext( /*! If set to 1 initializes the OpenSSL library. Otherwise the application * is responsible for initializing it. If set to 1, then OpenSSL is intialized * with all error strings, and all ciphers loaded. */ int initOpenSslLib, /*! The SSL_METHOD to use to create the context. See OpenSSL docs * for more info */ const SSL_METHOD *sslMethod); #endif /*! * \brief Terminates the Linux SDK for UPnP Devices. * * \li Checks for pending jobs and threads * \li Unregisters either the client or device * \li Shuts down the Timer Thread * \li Stops the Mini Server * \li Uninitializes the Thread Pool * \li For Win32 cleans up Winsock Interface * \li Cleans up mutex objects * * This function must be the last API function called. It should be called only * once. Subsequent calls to this API return a \c UPNP_E_FINISH error code. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_FINISH: The SDK is already terminated or * it is not initialized. */ EXPORT_SPEC int UpnpFinish(void); /*! * \brief Returns the internal server IPv4 UPnP listening port. * * If '0' is used as the port number in \b UpnpInit, then this function can be * used to retrieve the actual port allocated to the SDK. * * \return * \li On success: The port on which an internal server is listening for IPv4 UPnP * related requests. * \li On error: 0 is returned if \b UpnpInit has not succeeded. */ EXPORT_SPEC unsigned short UpnpGetServerPort(void); /*! * \brief Returns the internal server IPv6 UPnP listening port. * * If '0' is used as the port number in \b UpnpInit, then this function can be * used to retrieve the actual port allocated to the SDK. * * \return * \li On success: The port on which an internal server is listening for IPv6 UPnP * related requests. * \li On error: 0 is returned if \b UpnpInit has not succeeded. */ #ifdef UPNP_ENABLE_IPV6 EXPORT_SPEC unsigned short UpnpGetServerPort6(void); #endif /*! * \brief Returns the local IPv4 listening ip address. * * If \c NULL is used as the IPv4 address in \b UpnpInit, then this function can * be used to retrieve the actual interface address on which device is running. * * \return * \li On success: The IPv4 address on which an internal server is * listening for UPnP related requests. * \li On error: \c NULL is returned if \b UpnpInit has not succeeded. */ EXPORT_SPEC char *UpnpGetServerIpAddress(void); /*! * \brief Returns the local IPv6 listening ip address. * * If \c NULL is used as the IPv6 address in \b UpnpInit, then this function can * be used to retrieve the actual interface address on which device is running. * * \return * \li On success: The IPv6 address on which an internal server is * listening for UPnP related requests. * \li On error: \c NULL is returned if \b UpnpInit has not succeeded. */ #ifdef UPNP_ENABLE_IPV6 EXPORT_SPEC char *UpnpGetServerIp6Address(void); EXPORT_SPEC char *UpnpGetServerUlaGuaIp6Address(void); #endif /*! * \brief Registers a device application with the UPnP Library. * * A device application cannot make any other API calls until it registers * using this function. * * Device applications can also register as control points (see * \b UpnpRegisterClient to get a control point handle to perform control * point functionality). * * This is a synchronous call and does not generate any callbacks. Callbacks * can occur as soon as this function returns. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_FINISH: The SDK is already terminated or is not * initialized. * \li \c UPNP_E_INVALID_DESC: The description document was not * a valid device description. * \li \c UPNP_E_INVALID_URL: The URL for the description document * is not valid. * \li \c UPNP_E_INVALID_PARAM: Either \b Callback or \b Hnd * is not a valid pointer or \b DescURL is \c NULL. * \li \c UPNP_E_NETWORK_ERROR: A network error occurred. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting the * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. * \li \c UPNP_E_OUTOF_MEMORY: There are insufficient resources to * register this root device. */ EXPORT_SPEC int UpnpRegisterRootDevice( /*! [in] Pointer to a string containing the description URL for this root device * instance. */ const char *DescUrl, /*! [in] Pointer to the callback function for receiving asynchronous events. */ Upnp_FunPtr Callback, /*! [in] Pointer to user data returned with the callback function when invoked. */ const void *Cookie, /*! [out] Pointer to a variable to store the new device handle. */ UpnpDevice_Handle *Hnd); /*! * \brief Registers a device application with the UPnP Library. Similar to * \b UpnpRegisterRootDevice, except that it also allows the description * document to be specified as a file or a memory buffer. * * The description can also be configured to have the correct IP and port * address. * * NOTE: For the configuration to be functional, the internal web server * MUST be present. In addition, the web server MUST be activated * (using \b UpnpSetWebServerRootDir) before calling this function. * The only condition where the web server can be absent is if the * description document is specified as a URL and no configuration is * required (i.e. config_baseURL = 0.) * * This is a synchronous call and does not generate any callbacks. Callbacks * can occur as soon as this function returns. * * Examples of using different types of description documents: * \verbatim 1) Description specified as a URL: descriptionType == UPNPREG_URL_DESC description is the URL bufferLen = 0 (ignored) 2) Description specified as a file: descriptionType == UPNPREG_FILENAME_DESC description is a filename bufferLen = 0 (ignored) 3) Description specified as a memory buffer: descriptionType == UPNPREG_BUF_DESC description is pointer to a memory buffer bufferLen == length of memory buffer \endverbatim * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_FINISH: The SDK is already terminated or * is not initialized. * \li \c UPNP_E_INVALID_DESC: The description document is not * a valid device description. * \li \c UPNP_E_INVALID_PARAM: Either \b Callback or \b Hnd * is not a valid pointer or \b DescURL is \c NULL. * \li \c UPNP_E_NETWORK_ERROR: A network error occurred. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting the * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. * \li \c UPNP_E_OUTOF_MEMORY: There are insufficient resources to * register this root device. * \li \c UPNP_E_URL_TOO_BIG: Length of the URL is bigger than the * internal buffer. * \li \c UPNP_E_FILE_NOT_FOUND: The description file could not * be found. * \li \c UPNP_E_FILE_READ_ERROR: An error occurred reading the * description file. * \li \c UPNP_E_INVALID_URL: The URL to the description document * is invalid. * \li \c UPNP_E_EXT_NOT_XML: The URL to the description document * or file should have a .xml extension. * \li \c UPNP_E_NO_WEB_SERVER: The internal web server has been * compiled out; the SDK cannot configure itself from the * description document. */ EXPORT_SPEC int UpnpRegisterRootDevice2( /*! [in] The type of the description document. */ Upnp_DescType descriptionType, /*! [in] Treated as a URL, file name or memory buffer depending on * description type. */ const char* description, /*! [in] The length of memory buffer if passing a description in a buffer, * otherwise it is ignored. */ size_t bufferLen, /*! [in] If nonzero, \c URLBase of description document is configured and * the description is served using the internal web server. */ int config_baseURL, /*! [in] Pointer to the callback function for receiving asynchronous events. */ Upnp_FunPtr Fun, /*! [in] Pointer to user data returned with the callback function when * invoked. */ const void* Cookie, /*! [out] Pointer to a variable to store the new device handle. */ UpnpDevice_Handle* Hnd); /*! * \brief Registers a device application for a specific address family with * the UPnP library. * * A device application cannot make any other API calls until it registers * using this function. Device applications can also register as control * points (see \b UpnpRegisterClient to get a control point handle to perform * control point functionality). * * This is synchronous and does not generate any callbacks. Callbacks can occur * as soon as this function returns. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_FINISH: The SDK is already terminated or * is not initialized. * \li \c UPNP_E_INVALID_DESC: The description document was not * a valid device description. * \li \c UPNP_E_INVALID_URL: The URL for the description document * is not valid. * \li \c UPNP_E_INVALID_PARAM: Either \b Callback or \b Hnd * is not a valid pointer or \b DescURL is \c NULL. * \li \c UPNP_E_NETWORK_ERROR: A network error occurred. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting the * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. * \li \c UPNP_E_OUTOF_MEMORY: There are insufficient resources to * register this root device. */ EXPORT_SPEC int UpnpRegisterRootDevice3( /*! [in] Pointer to a string containing the description URL for this root * device instance. */ const char *DescUrl, /*! [in] Pointer to the callback function for receiving asynchronous events. */ Upnp_FunPtr Callback, /*! [in] Pointer to user data returned with the callback function when invoked. */ const void *Cookie, /*! [out] Pointer to a variable to store the new device handle. */ UpnpDevice_Handle *Hnd, /*! [in] Address family of this device. Can be AF_INET for an IPv4 device, or * AF_INET6 for an IPv6 device. Defaults to AF_INET. */ int AddressFamily); /*! * \brief Registers a device application for a specific address family with * the UPnP library. This function can also be used to specify a dedicated * description URL to be returned for legacy CPs. * * A device application cannot make any other API calls until it registers * using this function. Device applications can also register as control * points (see \b UpnpRegisterClient to get a control point handle to perform * control point functionality). * * This is synchronous and does not generate any callbacks. Callbacks can occur * as soon as this function returns. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_FINISH: The SDK is already terminated or * is not initialized. * \li \c UPNP_E_INVALID_DESC: The description document was not * a valid device description. * \li \c UPNP_E_INVALID_URL: The URL for the description document * is not valid. * \li \c UPNP_E_INVALID_PARAM: Either \b Callback or \b Hnd * is not a valid pointer or \b DescURL is \c NULL. * \li \c UPNP_E_NETWORK_ERROR: A network error occurred. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting the * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. * \li \c UPNP_E_OUTOF_MEMORY: There are insufficient resources to * register this root device. */ EXPORT_SPEC int UpnpRegisterRootDevice4( /*! [in] Pointer to a string containing the description URL for this root * device instance. */ const char *DescUrl, /*! [in] Pointer to the callback function for receiving asynchronous events. */ Upnp_FunPtr Callback, /*! [in] Pointer to user data returned with the callback function when invoked. */ const void *Cookie, /*! [out] Pointer to a variable to store the new device handle. */ UpnpDevice_Handle *Hnd, /*! [in] Address family of this device. Can be AF_INET for an IPv4 device, or * AF_INET6 for an IPv6 device. Defaults to AF_INET. */ int AddressFamily, /*! [in] Pointer to a string containing the description URL to be returned for * legacy CPs for this root device instance. */ const char *LowerDescUrl); /*! * \brief Unregisters a root device registered with \b UpnpRegisterRootDevice, * \b UpnpRegisterRootDevice2, \b UpnpRegisterRootDevice3 or * \b UpnpRegisterRootDevice4. * * After this call, the \b UpnpDevice_Handle is no longer valid. For all * advertisements that have not yet expired, the SDK sends a device unavailable * message automatically. * * This is a synchronous call and generates no callbacks. Once this call * returns, the SDK will no longer generate callbacks to the application. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid device handle. */ EXPORT_SPEC int UpnpUnRegisterRootDevice( /*! [in] The handle of the root device instance to unregister. */ UpnpDevice_Handle Hnd); /*! * \brief Unregisters a root device registered with \b UpnpRegisterRootDevice, * \b UpnpRegisterRootDevice2, \b UpnpRegisterRootDevice3 or * \b UpnpRegisterRootDevice4. * * After this call, the \b UpnpDevice_Handle is no longer valid. For all * advertisements that have not yet expired, the SDK sends a device unavailable * message automatically. * * This is a synchronous call and generates no callbacks. Once this call * returns, the SDK will no longer generate callbacks to the application. * * This function allow a device to specify the SSDP extensions defined by UPnP * Low Power. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid device handle. */ EXPORT_SPEC int UpnpUnRegisterRootDeviceLowPower( /*! [in] The handle of the root device instance to unregister. */ UpnpDevice_Handle Hnd, /*! PowerState as defined by UPnP Low Power. */ int PowerState, /*! SleepPeriod as defined by UPnP Low Power. */ int SleepPeriod, /*! RegistrationState as defined by UPnP Low Power. */ int RegistrationState); /*! * \brief Registers a control point application with the UPnP Library. * * A control point application cannot make any other API calls until it * registers using this function. * * \b UpnpRegisterClient is a synchronous call and generates no callbacks. * Callbacks can occur as soon as this function returns. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_FINISH: The SDK is already terminated or * is not initialized. * \li \c UPNP_E_INVALID_PARAM: Either \b Callback or \b Hnd * is not a valid pointer. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * register this control point. */ EXPORT_SPEC int UpnpRegisterClient( /*! [in] Pointer to a function for receiving asynchronous events. */ Upnp_FunPtr Callback, /*! [in] Pointer to user data returned with the callback function when invoked. */ const void *Cookie, /*! [out] Pointer to a variable to store the new control point handle. */ UpnpClient_Handle *Hnd); /*! * \brief Unregisters a control point application, unsubscribing all active * subscriptions. * * This function unregisters a client registered with UpnpRegisterclient or * UpnpRegisterclient2. After this call, the \b UpnpClient_Handle is no longer * valid. The UPnP Library generates no more callbacks after this function * returns. * * \b UpnpUnRegisterClient is a synchronous call and generates no * callbacks. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid control point handle. */ EXPORT_SPEC int UpnpUnRegisterClient( /*! [in] The handle of the control point instance to unregister. */ UpnpClient_Handle Hnd); /*! * \deprecated Use \b UpnpSetMaxContentLength instead. * * Warning: the Handle argument provided here is not used, so the effect * of this function is global to the SDK (= same as \b UpnpSetMaxContentLength). */ EXPORT_SPEC int UpnpSetContentLength( /*! [in] The handle of the device instance for which the coincoming content * length needs to be set. */ UpnpClient_Handle Hnd, /*! [in] Permissible content length */ size_t contentLength); /*! * \brief Sets the maximum content-length that the SDK will process on an * incoming SOAP requests or responses. * * This API allows devices that have memory constraints to exhibit consistent * behaviour if the size of the incoming SOAP message exceeds the memory that * device can allocate. * * If set to 0 then checking will be disabled. * * The default maximum content-length is \c DEFAULT_SOAP_CONTENT_LENGTH * = 16K bytes. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. */ EXPORT_SPEC int UpnpSetMaxContentLength( /*! [in] The maximum permissible content length for incoming SOAP actions, * in bytes. */ size_t contentLength); /* @} Initialization and Registration */ /****************************************************************************** ****************************************************************************** * * * D I S C O V E R Y * * * ****************************************************************************** ******************************************************************************/ /*! * \name Discovery * * @{ */ /*! * \brief Searches for devices matching the given search target. * * The function returns immediately and the SDK calls the default callback * function, registered during the \b UpnpRegisterClient call, for each * matching root device, device, or service. The application specifies the * search type by the \b Target parameter. * * This function searches for the devices for the provided maximum time. * It is an asynchronous function. It schedules a search job and returns. * The client is notified about the search results after search timer. * * Note that there is no way for the SDK to distinguish which client * instance issued a particular search. Therefore, the client can get * search callbacks that do not match the original criteria of the search. * Also, the application will receive multiple callbacks for each search. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid control * point handle. * \li \c UPNP_E_INVALID_PARAM: \b Target is \c NULL. */ EXPORT_SPEC int UpnpSearchAsync( /*! The handle of the client performing the search. */ UpnpClient_Handle Hnd, /*! The time, in seconds, to wait for responses. If the time is greater * than \c MAX_SEARCH_TIME then the time is set to \c MAX_SEARCH_TIME. * If the time is less than \c MIN_SEARCH_TIME then the time is set to * \c MIN_SEARCH_TIME. */ int Mx, /*! The search target as defined in the UPnP Device Architecture v1.0 * specification. */ const char *TTarget_constarget_const, /*! The user data to pass when the callback function is invoked. */ const void *Cookie_const); /*! * \brief Sends out the discovery announcements for all devices and services * for a device. * * Each announcement is made with the same expiration time. * * This is a synchronous call. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid * device handle. * \li \c UPNP_E_OUTOF_MEMORY: There are insufficient resources to * send future advertisements. */ EXPORT_SPEC int UpnpSendAdvertisement( /*! The device handle for which to send out the announcements. */ UpnpDevice_Handle Hnd, /*! The expiration age, in seconds, of the announcements. If the * expiration age is less than 1 then the expiration age is set to * \c DEFAULT_MAXAGE. If the expiration age is less than or equal to * \c AUTO_ADVERTISEMENT_TIME * 2 then the expiration age is set to * ( \c AUTO_ADVERTISEMENT_TIME + 1 ) * 2. */ int Exp); /*! * \brief Sends out the discovery announcements for all devices and services * for a device. * * Each announcement is made with the same expiration time. * * This is a synchronous call. * * This function allow a device to specify the SSDP extensions defined by UPnP * Low Power. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid * device handle. * \li \c UPNP_E_OUTOF_MEMORY: There are insufficient resources to * send future advertisements. */ EXPORT_SPEC int UpnpSendAdvertisementLowPower( /*! The device handle for which to send out the announcements. */ UpnpDevice_Handle Hnd, /*! The expiration age, in seconds, of the announcements. If the * expiration age is less than 1 then the expiration age is set to * \c DEFAULT_MAXAGE. If the expiration age is less than or equal to * \c AUTO_ADVERTISEMENT_TIME * 2 then the expiration age is set to * ( \c AUTO_ADVERTISEMENT_TIME + 1 ) * 2. */ int Exp, /*! PowerState as defined by UPnP Low Power. */ int PowerState, /*! SleepPeriod as defined by UPnP Low Power. */ int SleepPeriod, /*! RegistrationState as defined by UPnP Low Power. */ int RegistrationState); /* @} Discovery */ /****************************************************************************** ****************************************************************************** * * * C O N T R O L * * * ****************************************************************************** ******************************************************************************/ /*! * \name Control * * @{ */ /*! * \brief Queries the state of a state variable of a service on another device. * * \deprecated * The use of this function is deprecated by the UPnP Forum. * * This is a synchronous call. * * A positive return value indicates a SOAP error code, whereas a negative * return code indicates an SDK error code. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid control * point handle. * \li \c UPNP_E_INVALID_URL: \b ActionUrl is not a valid URL. * \li \c UPNP_E_INVALID_DESC: The XML document was not * found or it does not contain a valid XML description. * \li \c UPNP_E_INVALID_PARAM: \b StVarVal is not a valid * pointer or \b VarName or \b ActionUrl is \c NULL. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. * \li \c UPNP_SOAP_E_INVALID_VAR: The given variable is invalid * according to the device. */ EXPORT_SPEC int UpnpGetServiceVarStatus( /*! [in] The handle of the control point. */ UpnpClient_Handle Hnd, /*! [in] The URL of the service. */ const char *ActionURL, /*! [in] The name of the variable to query. */ const char *VarName, /*! [out] The pointer to store the value for \b VarName. The SDK allocates * this string and the caller needs to free it using * \b ixmlFreeDOMString. */ DOMString *StVarVal); /*! * \brief Queries the state of a variable of a service, generating a callback * when the operation is complete. * * \deprecated * The use of this function is deprecated by the UPnP Forum. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid control * point handle. * \li \c UPNP_E_INVALID_URL: The \b ActionUrl is not a valid URL. * \li \c UPNP_E_INVALID_PARAM: \b VarName, \b Fun or * \b ActionUrl is not a valid pointer. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpGetServiceVarStatusAsync( /*! [in] The handle of the control point. */ UpnpClient_Handle Hnd, /*! [in] The URL of the service. */ const char *ActionURL, /*! [in] The name of the variable to query. */ const char *VarName, /*! [in] Pointer to a callback function to be invoked when the operation * is complete. */ Upnp_FunPtr Fun, /*! [in] Pointer to user data to pass to the callback function when invoked. */ const void *Cookie); /*! * \brief Sends a message to change a state variable in a service. * * This is a synchronous call that does not return until the action is complete. * * Note that a positive return value indicates a SOAP-protocol error code. * In this case, the error description can be retrieved from \b RespNode. * A negative return value indicates an SDK error. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid control * point handle. * \li \c UPNP_E_INVALID_URL: \b ActionUrl is not a valid URL. * \li \c UPNP_E_INVALID_ACTION: This action is not valid. * \li \c UPNP_E_INVALID_DEVICE: \b DevUDN is not a * valid device. * \li \c UPNP_E_INVALID_PARAM: \b ServiceType, \b Action, * \b ActionUrl, or * \b RespNode is not a valid pointer. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpSendAction( /*! [in] The handle of the control point sending the action. */ UpnpClient_Handle Hnd, /*! [in] The action URL of the service. */ const char *ActionURL, /*! [in] The type of the service. */ const char *ServiceType, /*! [in] This parameter is ignored and must be \c NULL. */ const char *DevUDN, /*! [in] The DOM document for the action. */ IXML_Document *Action, /*! [out] The DOM document for the response to the action. The SDK allocates * this document and the caller needs to free it. */ IXML_Document **RespNode); /*! * \brief Sends a message to change a state variable in a service. * * This is a synchronous call that does not return until the action is complete. * * Note that a positive return value indicates a SOAP-protocol error code. * In this case, the error description can be retrieved from \b RespNode. * A negative return value indicates an SDK error. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid control * point handle. * \li \c UPNP_E_INVALID_URL: \b ActionUrl is not a valid URL. * \li \c UPNP_E_INVALID_ACTION: This action is not valid. * \li \c UPNP_E_INVALID_DEVICE: \b DevUDN is not a * valid device. * \li \c UPNP_E_INVALID_PARAM: \b ServiceType, \b Action, * \b ActionUrl, or * \b RespNode is not a valid pointer. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpSendActionEx( /*! [in] The handle of the control point sending the action. */ UpnpClient_Handle Hnd, /*! [in] The action URL of the service. */ const char *ActionURL, /*! [in] The type of the service. */ const char *ServiceType, /*! [in] This parameter is ignored and must be \c NULL. */ const char *DevUDN, /*! [in] The DOM document for the SOAP header. This may be \c NULL if the * header is not required. */ IXML_Document *Header, /*! [in] The DOM document for the action. */ IXML_Document *Action, /*! [out] The DOM document for the response to the action. The SDK allocates * this document and the caller needs to free it. */ IXML_Document **RespNode); /*! * \brief Sends a message to change a state variable in a service, generating a * callback when the operation is complete. * * See \b UpnpSendAction for comments on positive return values. These * positive return values are sent in the event struct associated with the * \c UPNP_CONTROL_ACTION_COMPLETE event. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid control * point handle. * \li \c UPNP_E_INVALID_URL: \b ActionUrl is an invalid URL. * \li \c UPNP_E_INVALID_DEVICE: \b DevUDN is an invalid device. * \li \c UPNP_E_INVALID_PARAM: Either \b Fun is not a valid * callback function or \b ServiceType, \b Act, or * \b ActionUrl is \c NULL. * \li \c UPNP_E_INVALID_ACTION: This action is not valid. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpSendActionAsync( /*! [in] The handle of the control point sending the action. */ UpnpClient_Handle Hnd, /*! [in] The action URL of the service. */ const char *ActionURL, /*! [in] The type of the service. */ const char *ServiceType, /*! [in] This parameter is ignored and must be \c NULL. */ const char *DevUDN, /*! [in] The DOM document for the action to perform on this device. */ IXML_Document *Action, /*! [in] Pointer to a callback function to be invoked when the operation * completes. */ Upnp_FunPtr Fun, /*! [in] Pointer to user data that to be passed to the callback when * invoked. */ const void *Cookie); /*! * \brief Sends a message to change a state variable in a service, generating a * callback when the operation is complete. * * See \b UpnpSendAction for comments on positive return values. These * positive return values are sent in the event struct associated with the * \c UPNP_CONTROL_ACTION_COMPLETE event. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid control * point handle. * \li \c UPNP_E_INVALID_URL: \b ActionUrl is an invalid URL. * \li \c UPNP_E_INVALID_DEVICE: \b DevUDN is an invalid device. * \li \c UPNP_E_INVALID_PARAM: Either \b Fun is not a valid * callback function or \b ServiceType, \b Act, or * \b ActionUrl is \c NULL. * \li \c UPNP_E_INVALID_ACTION: This action is not valid. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpSendActionExAsync( /*! [in] The handle of the control point sending the action. */ UpnpClient_Handle Hnd, /*! [in] The action URL of the service. */ const char *ActionURL, /*! [in] The type of the service. */ const char *ServiceType, /*! [in] This parameter is ignored and must be \c NULL. */ const char *DevUDN, /*! [in] The DOM document for the SOAP header. This may be \c NULL if the * header is not required. */ IXML_Document *Header, /*! [in] The DOM document for the action to perform on this device. */ IXML_Document *Action, /*! [in] Pointer to a callback function to be invoked when the operation * completes. */ Upnp_FunPtr Fun, /*! [in] Pointer to user data that to be passed to the callback when * invoked. */ const void *Cookie); /*! @} Control */ /****************************************************************************** ****************************************************************************** * * * E V E N T I N G * * * ****************************************************************************** ******************************************************************************/ /*! * \name Eventing * * @{ */ /*! * \brief Accepts a subscription request and sends out the current state of the * eventable variables for a service. * * The device application should call this function when it receives a * \c UPNP_EVENT_SUBSCRIPTION_REQUEST callback. * * This function is synchronous and generates no callbacks. * * This function can be called during the execution of a callback function. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid device * handle. * \li \c UPNP_E_INVALID_SERVICE: The \b DevId/\b ServId * pair refers to an invalid service. * \li \c UPNP_E_INVALID_SID: The specified subscription ID is not * valid. * \li \c UPNP_E_INVALID_PARAM: Either \b VarName, * \b NewVal, \b DevID, or \b ServID is not a valid * pointer or \b cVariables is less than zero. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpAcceptSubscription( /*! [in] The handle of the device. */ UpnpDevice_Handle Hnd, /*! [in] The device ID of the subdevice of the service generating the event. */ const char *DevID, /*! [in] The unique service identifier of the service generating the event. */ const char *ServID, /*! [in] Pointer to an array of event variables. */ const char **VarName, /*! [in] Pointer to an array of values for the event variables. */ const char **NewVal, /*! [in] The number of event variables in \b VarName. */ int cVariables, /*! [in] The subscription ID of the newly registered control point. */ const Upnp_SID SubsId); /*! * \brief Similar to \b UpnpAcceptSubscription() except that it takes a DOM * document for the variables to event rather than an array of strings. * * This function is sychronous and generates no callbacks. * * This function can be called during the execution of a callback function. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid device * handle. * \li \c UPNP_E_INVALID_SERVICE: The \b DevId/\b ServId * pair refers to an invalid service. * \li \c UPNP_E_INVALID_SID: The specified subscription ID is not * valid. * \li \c UPNP_E_INVALID_PARAM: Either \b VarName, * \b NewVal, \b DevID, \b ServID, or \b PropSet * is not a valid pointer. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpAcceptSubscriptionExt( /*! [in] The handle of the device. */ UpnpDevice_Handle Hnd, /*! [in] The device ID of the subdevice of the service generating the event. */ const char *DevID, /*! [in] The unique service identifier of the service generating the event. */ const char *ServID, /*! [in] The DOM document for the property set. Property set documents must * conform to the XML schema defined in section 4.3 of the Universal * Plug and Play Device Architecture specification. */ IXML_Document *PropSet, /*! [in] The subscription ID of the newly registered control point. */ const Upnp_SID SubsId); /*! * \brief Sends out an event change notification to all control points * subscribed to a particular service. * * This function is synchronous and generates no callbacks. * * This function may be called during a callback function to send out a * notification. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid device * handle. * \li \c UPNP_E_INVALID_SERVICE: The \b DevId/\b ServId * pair refers to an invalid service. * \li \c UPNP_E_INVALID_PARAM: Either \b VarName, \b NewVal, * \b DevID, or \b ServID is not a valid pointer or * \b cVariables is less than zero. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpNotify( /*! [in] The handle to the device sending the event. */ UpnpDevice_Handle, /*! [in] The device ID of the subdevice of the service generating the event. */ const char *DevID, /*! [in] The unique identifier of the service generating the event. */ const char *ServID, /*! [in] Pointer to an array of variables that have changed. */ const char **VarName, /*! [in] Pointer to an array of new values for those variables. */ const char **NewVal, /*! [in] The count of variables included in this notification. */ int cVariables); /*! * \brief Similar to \b UpnpNotify except that it takes a DOM document for the * event rather than an array of strings. * * This function is synchronous and generates no callbacks. * * This function may be called during a callback function to send out a * notification. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid device * handle. * \li \c UPNP_E_INVALID_SERVICE: The \b DevId/\b ServId * pair refers to an invalid service. * \li \c UPNP_E_INVALID_PARAM: Either \b VarName, \b NewVal, * \b DevID, \b ServID, or \b PropSet * is not a valid pointer or \b cVariables is less than zero. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpNotifyExt( /*! [in] The handle to the device sending the event. */ UpnpDevice_Handle, /*! [in] The device ID of the subdevice of the service generating the event. */ const char *DevID, /*! [in] The unique identifier of the service generating the event. */ const char *ServID, /*! [in] The DOM document for the property set. Property set documents must * conform to the XML schema defined in section 4.3 of the Universal * Plug and Play Device Architecture specification. */ IXML_Document *PropSet); /*! * \brief Renews a subscription that is about to expire. * * This function is synchronous. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid control * point handle. * \li \c UPNP_E_INVALID_PARAM: \b Timeout is not a valid pointer. * \li \c UPNP_E_INVALID_SID: The SID being passed to this function * is not a valid subscription ID. * \li \c UPNP_E_NETWORK_ERROR: A network error occured. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting to * \b PublisherUrl. * \li \c UPNP_E_OUTOF_SOCKET: An error occurred creating a socket. * \li \c UPNP_E_BAD_RESPONSE: An error occurred in response from * the publisher. * \li \c UPNP_E_SUBSCRIBE_UNACCEPTED: The publisher refused * the subscription renew. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpRenewSubscription( /*! [in] The handle of the control point that is renewing the subscription. */ UpnpClient_Handle Hnd, /*! [in,out] Pointer to a variable containing the requested subscription time. * Upon return, it contains the actual renewal time. */ int *TimeOut, /*! [in] The ID for the subscription to renew. */ const Upnp_SID SubsId); /*! * \brief Renews a subscription that is about to expire, generating a callback * when the operation is complete. * * Note that many of the error codes for this function are returned in * the \b UpnpEventSubscribe structure. In those cases, the function * returns \c UPNP_E_SUCCESS and the appropriate error code will * be in the UpnpEventSubscribe.ErrCode field in the \b Event * structure passed to the callback. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid control * point handle. * \li \c UPNP_E_INVALID_SID: The \b SubsId is not a valid * subscription ID. * \li \c UPNP_E_INVALID_PARAM: Either \b Fun is not a valid * callback function pointer or \b Timeout is less than zero * but is not \c UPNP_INFINITE. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. * \li \c UPNP_E_NETWORK_ERROR: A network error occured (returned in * the UpnpEventSubscribe.ErrCode field as part of the * callback). * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket (returned in the UpnpEventSubscribe.ErrCode * field as part of the callback). * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket (returned in the * UpnpEventSubscribe.ErrCode field as part of the * callback). * \li \c UPNP_E_SOCKET_BIND: An error occurred binding the socket * (returned in the UpnpEventSubscribe.ErrCode field as * part of the callback). * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting to * \b PublisherUrl (returned in the \b * UpnpEventSubscribe.ErrCode field as part of the callback). * \li \c UPNP_E_OUTOF_SOCKET: An error occurred creating socket ( * returned in the UpnpEventSubscribe.ErrCode field as * part of the callback). * \li \c UPNP_E_BAD_RESPONSE: An error occurred in response from * the publisher (returned in the \b * UpnpEventSubscribe.ErrCode field as part of the callback). * \li \c UPNP_E_SUBSCRIBE_UNACCEPTED: The publisher refused * the subscription request (returned in the \b * UpnpEventSubscribe.ErrCode field as part of the callback). */ EXPORT_SPEC int UpnpRenewSubscriptionAsync( /*! [in] The handle of the control point that is renewing the subscription. */ UpnpClient_Handle Hnd, /*! [in] The requested subscription time. The actual timeout value is * returned when the callback function is called. */ int TimeOut, /*! [in] The ID for the subscription to renew. */ Upnp_SID SubsId, /*! [in] Pointer to a callback function to be invoked when the renewal is * complete. */ Upnp_FunPtr Fun, /*! [in] Pointer to user data passed to the callback function when invoked. */ const void *Cookie); /*! * \brief Sets the maximum number of subscriptions accepted per service. * * The default value accepts as many as system resources allow. If the number * of current subscriptions for a service is greater than the requested value, * the SDK accepts no new subscriptions or renewals, however, the SDK does not * remove any current subscriptions. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid device * handle. */ EXPORT_SPEC int UpnpSetMaxSubscriptions( /*! The handle of the device for which the maximum number of * subscriptions is being set. */ UpnpDevice_Handle Hnd, /*! The maximum number of subscriptions to be allowed per service. */ int MaxSubscriptions); /*! * \brief Sets the maximum time-out accepted for a subscription request or * renewal. * * The default value accepts the time-out set by the control point. * If a control point requests a subscription time-out less than or equal to * the maximum, the SDK grants the value requested by the control point. If the * time-out is greater, the SDK returns the maximum value. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid device * handle. */ EXPORT_SPEC int UpnpSetMaxSubscriptionTimeOut( /*! The handle of the device for which the maximum subscription * time-out is being set. */ UpnpDevice_Handle Hnd, /*! The maximum subscription time-out to be accepted. */ int MaxSubscriptionTimeOut); /*! * \brief Registers a control point to receive event notifications from another * device. * * This operation is synchronous. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid control * point handle. * \li \c UPNP_E_INVALID_URL: \b PublisherUrl is not a valid URL. * \li \c UPNP_E_INVALID_PARAM: \b Timeout is not a valid pointer * or \b SubsId or \b PublisherUrl is \c NULL. * \li \c UPNP_E_NETWORK_ERROR: A network error occured. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting to * \b PublisherUrl. * \li \c UPNP_E_OUTOF_SOCKET: An error occurred creating a socket. * \li \c UPNP_E_BAD_RESPONSE: An error occurred in response from * the publisher. * \li \c UPNP_E_SUBSCRIBE_UNACCEPTED: The publisher refused * the subscription request. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpSubscribe( /*! [in] The handle of the control point. */ UpnpClient_Handle Hnd, /*! [in] The URL of the service to subscribe to. */ const char *PublisherUrl, /*! [in,out]Pointer to a variable containing the requested subscription time. * Upon return, it contains the actual subscription time returned from * the service. */ int *TimeOut, /*! [out] Pointer to a variable to receive the subscription ID (SID). */ Upnp_SID SubsId); /*! * \brief Performs the same operation as \b UpnpSubscribe, but returns * immediately and calls the registered callback function when the operation * is complete. * * Note that many of the error codes for this function are returned in * the \b UpnpEventSubscribe structure. In those cases, the function * returns \c UPNP_E_SUCCESS and the appropriate error code will * be in the UpnpEventSubscribe.ErrCode field in the \b Event * structure passed to the callback. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid control * point handle. * \li \c UPNP_E_INVALID_URL: The \b PublisherUrl is not a valid * URL. * \li \c UPNP_E_INVALID_PARAM: Either \b TimeOut or \b Fun or * \b PublisherUrl is not a valid pointer. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. * \li \c UPNP_E_NETWORK_ERROR: A network error occured (returned in * the UpnpEventSubscribe.ErrCode field as part of the * callback). * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket (returned in the * UpnpEventSubscribe.ErrCode field as part of the * callback). * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket (returned in the * UpnpEventSubscribe.ErrCode field as part of the * callback). * \li \c UPNP_E_SOCKET_BIND: An error occurred binding the socket * (returned in the UpnpEventSubscribe.ErrCode field as * part of the callback). * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting to * \b PublisherUrl (returned in the \b * UpnpEventSubscribe.ErrCode field as part of the callback). * \li \c UPNP_E_OUTOF_SOCKET: An error occurred creating the * socket (returned in the UpnpEventSubscribe.ErrCode * field as part of the callback). * \li \c UPNP_E_BAD_RESPONSE: An error occurred in response from * the publisher (returned in the \b * UpnpEventSubscribe.ErrCode field as part of the callback). * \li \c UPNP_E_SUBSCRIBE_UNACCEPTED: The publisher refused * the subscription request (returned in the \b * UpnpEventSubscribe.ErrCode field as part of the callback). */ EXPORT_SPEC int UpnpSubscribeAsync( /*! The handle of the control point that is subscribing. */ UpnpClient_Handle Hnd, /*! The URL of the service to subscribe to. */ const char *PublisherUrl, /*! The requested subscription time. Upon return, it contains the actual * subscription time returned from the service. */ int TimeOut, /*! Pointer to the callback function for this subscribe request. */ Upnp_FunPtr Fun, /*! A user data value passed to the callback function when invoked. */ const void *Cookie); /*! * \brief Removes the subscription of a control point from a service previously * subscribed to using \b UpnpSubscribe or \b UpnpSubscribeAsync. * * This is a synchronous call. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid control * point handle. * \li \c UPNP_E_INVALID_SID: The \b SubsId is not a valid * subscription ID. * \li \c UPNP_E_NETWORK_ERROR: A network error occured. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting to * \b PublisherUrl. * \li \c UPNP_E_OUTOF_SOCKET: An error ocurred creating a socket. * \li \c UPNP_E_BAD_RESPONSE: An error occurred in response from * the publisher. * \li \c UPNP_E_UNSUBSCRIBE_UNACCEPTED: The publisher refused * the unsubscribe request (the client is still unsubscribed and * no longer receives events). * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpUnSubscribe( /*! [in] The handle of the subscribed control point. */ UpnpClient_Handle Hnd, /*! [in] The ID returned when the control point subscribed to the service. */ const Upnp_SID SubsId); /*! * \brief Removes a subscription of a control point from a service previously * subscribed to using \b UpnpSubscribe or \b UpnpSubscribeAsync, generating * a callback when the operation is complete. * * Note that many of the error codes for this function are returned in * the \b UpnpEventSubscribe structure. In those cases, the function * returns \c UPNP_E_SUCCESS and the appropriate error code will * be in the UpnpEventSubscribe.ErrCode field in the \b Event * structure passed to the callback. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_HANDLE: The handle is not a valid control * point handle. * \li \c UPNP_E_INVALID_SID: The \b SubsId is not a valid SID. * \li \c UPNP_E_INVALID_PARAM: \b Fun is not a valid callback * function pointer. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. * \li \c UPNP_E_NETWORK_ERROR: A network error occured (returned in * the UpnpEventSubscribe.ErrCode field as part of the * callback). * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket (returned in the UpnpEventSubscribe.ErrCode * field as part of the callback). * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket (returned in the * UpnpEventSubscribe.ErrCode field as part of the * callback). * \li \c UPNP_E_SOCKET_BIND: An error occurred binding the socket * (returned in the UpnpEventSubscribe.ErrCode field as * part of the callback). * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting to * \b PublisherUrl (returned in the UpnpEventSubscribe.ErrCode * field as part of the callback). * \li \c UPNP_E_OUTOF_SOCKET: An error occurred creating a socket ( * returned in the UpnpEventSubscribe.ErrCode field as * part of the callback). * \li \c UPNP_E_BAD_RESPONSE: An error occurred in response from * the publisher (returned in the UpnpEventSubscribe.ErrCode * field as part of the callback). * \li \c UPNP_E_UNSUBSCRIBE_UNACCEPTED: The publisher refused * the subscription request (returned in the * UpnpEventSubscribe.ErrCode field as part of the callback). */ EXPORT_SPEC int UpnpUnSubscribeAsync( /*! [in] The handle of the subscribed control point. */ UpnpClient_Handle Hnd, /*! [in] The ID returned when the control point subscribed to the service. */ Upnp_SID SubsId, /*! [in] Pointer to a callback function to be called when the operation is * complete. */ Upnp_FunPtr Fun, /*! [in] Pointer to user data to pass to the callback function when invoked. */ const void *Cookie); /*! @} Eventing */ /****************************************************************************** ****************************************************************************** * * * C L I E N T - A P I * * * ****************************************************************************** ******************************************************************************/ /*! * \name Control Point HTTP API * * @{ */ /*! * \brief Different HTTP methods. */ enum Upnp_HttpMethod_e { UPNP_HTTPMETHOD_PUT = 0, UPNP_HTTPMETHOD_DELETE = 1, UPNP_HTTPMETHOD_GET = 2, UPNP_HTTPMETHOD_HEAD = 3, UPNP_HTTPMETHOD_POST = 4 }; typedef enum Upnp_HttpMethod_e Upnp_HttpMethod; /*! * \brief Downloads a file specified in a URL. * * The SDK allocates the memory for \b outBuf and the application is * responsible for freeing this memory. Note that the item is passed as a * single buffer. Large items should not be transferred using this function. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b url, \b outBuf * or \b contentType is not a valid pointer. * \li \c UPNP_E_INVALID_URL: The \b url is not a valid * URL. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * download this file. * \li \c UPNP_E_NETWORK_ERROR: A network error occurred. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting a * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. */ EXPORT_SPEC int UpnpDownloadUrlItem( /*! [in] URL of an item to download. */ const char *url, /*! [out] Buffer to store the downloaded item. */ char **outBuf, /*! [out] HTTP header value content type if present. It should be at least * \c LINE_SIZE bytes in size. */ char *contentType); /*! * \brief Gets a file specified in a URL. * * The SDK allocates the memory for \b handle and \b contentType, the * application is responsible for freeing this memory. * * \note Memory for \b contentType is freed when freeing the memory * for handle. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b url, \b handle, * is not a valid pointer. * \li \c UPNP_E_INVALID_URL: The \b url is not a valid * URL. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * download this file. * \li \c UPNP_E_NETWORK_ERROR: A network error occurred. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting a * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. * \li \c UPNP_E_BAD_RESPONSE: A bad response was received from the * remote server. */ EXPORT_SPEC int UpnpOpenHttpGet( /*! [in] The URL of an item to get. */ const char *url, /*! [in,out] A pointer to store the handle for this connection. */ void **handle, /*! [in,out] A buffer to store the media type of the item. */ char **contentType, /*! [in,out] A pointer to store the length of the item. */ int *contentLength, /*! [in,out] The status returned on receiving a response message. */ int *httpStatus, /*! [in] The time out value sent with the request during which a response * is expected from the server, failing which, an error is reported * back to the user. If value is negative, timeout is infinite. */ int timeout); /*! * \brief Gets a file specified in a URL through the specified proxy. * * The SDK allocates the memory for \b handle and \b contentType, the * application is responsible for freeing this memory. * * \note Memory for \b contentType is freed when freeing the memory * for handle. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b url, \b handle, * is not a valid pointer. * \li \c UPNP_E_INVALID_URL: The \b url is not a valid * URL. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * download this file. * \li \c UPNP_E_NETWORK_ERROR: A network error occurred. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting a * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. * \li \c UPNP_E_BAD_RESPONSE: A bad response was received from the * remote server. */ EXPORT_SPEC int UpnpOpenHttpGetProxy( /*! [in] The URL of an item to get. */ const char *url, /*! [in] The URL of the proxy. */ const char *proxy_str, /*! [in,out] A pointer to store the handle for this connection. */ void **handle, /*! [in,out] A buffer to store the media type of the item. */ char **contentType, /*! [in,out] A pointer to store the length of the item. */ int *contentLength, /*! [in,out] The status returned on receiving a response message. */ int *httpStatus, /*! [in] The time out value sent with the request during which a response * is expected from the server, failing which, an error is reported * back to the user. If value is negative, timeout is infinite. */ int timeout); /*! * \brief Gets specified number of bytes from a file specified in the URL. * * The number of bytes is specified through a low count and a high count which * are passed as a range of bytes for the request. The SDK allocates the memory * for \b handle and \b contentType, the application is responsible for freeing * this memory. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b url, \b handle, * \b contentType, \b contentLength or \b httpStatus * is not a valid pointer. * \li \c UPNP_E_INVALID_URL: The \b url is not a valid * URL. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * download this file. * \li \c UPNP_E_NETWORK_ERROR: A network error occurred. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting a * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. * \li \c UPNP_E_BAD_RESPONSE: A bad response was received from the * remote server. */ EXPORT_SPEC int UpnpOpenHttpGetEx( /*! [in] The URL of the item to get. */ const char *url, /*! [in,out] A pointer to store the handle for this connection. */ void **handle, /*! [in,out] A buffer to store the media type of the item. */ char **contentType, /*! [in,out] A buffer to store the length of the item. */ int *contentLength, /*! [in,out] The status returned on receiving a response message from the remote server. */ int *httpStatus, /*! [in] An integer value representing the low end of a range to retrieve. */ int lowRange, /*! [in] An integer value representing the high end of a range to retrieve. */ int highRange, /*! [in] A time out value sent with the request during which a response is * expected from the server, failing which, an error is reported back * to the user. If value is negative, timeout is infinite. */ int timeout); /*! * \brief Gets specified number of bytes from a file specified in a URL. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b handle, \b buf * or \b size is not a valid pointer. * \li \c UPNP_E_BAD_RESPONSE: A bad response was received from the * remote server. * \li \c UPNP_E_BAD_HTTPMSG: Either the request or response was in * the incorrect format. * \li \c UPNP_E_CANCELED: another thread called UpnpCancelHttpGet. * * Note: In case of return values, the status code parameter of the passed * in handle value may provide additional information on the return * value. */ EXPORT_SPEC int UpnpReadHttpGet( /*! [in] The token created by the call to \b UpnpOpenHttpGet. */ void *handle, /*! [in,out] The buffer to store the read item. */ char *buf, /*! [in,out] The size of the buffer to be read. */ size_t *size, /*! [in] The time out value sent with the request during which a response is * expected from the server, failing which, an error is reported back to * the user. If value is negative, timeout is infinite. */ int timeout); /*! * \brief Retrieve progress information of a http-get transfer. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b handle, \b length * or \b total is not a valid pointer. */ EXPORT_SPEC int UpnpHttpGetProgress( /*! [in] The token created by the call to \b UpnpOpenHttpGet. */ void *handle, /*! [out] The number of bytes received. */ size_t *length, /*! [out] The content length. */ size_t *total); /*! * \brief Set the cancel flag of the \b handle parameter. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: \b handle is not a valid pointer. */ EXPORT_SPEC int UpnpCancelHttpGet( /*! [in] The handle of the connection created by the call to * \b UpnpOpenHttpGet. */ void *handle); /*! * \brief Closes the connection and frees memory that was allocated for the * \b handle parameter. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: \b handle is not a valid pointer. */ EXPORT_SPEC int UpnpCloseHttpGet( /*! [in] The handle of the connection created by the call to * \b UpnpOpenHttpGet. */ void *handle); /*! * \brief Makes an HTTP POST request message, opens a connection to the server * and sends the POST request to the server if the connection to the server * succeeds. * * The SDK allocates the memory for \b handle, the * application is responsible for freeing this memory. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b url, \b handle * or \b contentType is not a valid pointer. * \li \c UPNP_E_INVALID_URL: The \b url is not a valid * URL. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * download this file. * \li \c UPNP_E_SOCKET_ERROR: Error occured allocating a socket and * resources or an error occurred binding a socket. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting a * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. */ EXPORT_SPEC int UpnpOpenHttpPost( /*! [in] The URL in which to send the POST request. */ const char *url, /*! [in,out] A pointer in which to store the handle for this connection. This * handle is required for futher operations over this connection. */ void **handle, /*! [in] A buffer to store the media type of content being sent. Can be NULL. */ const char *contentType, /*! [in] The length of the content, in bytes, being posted. */ int contentLength, /*! [in] The time out value sent with the request during which a response * is expected from the receiver, failing which, an error is reported. * If value is negative, timeout is infinite. */ int timeout); /*! * \brief Sends a request to a server to copy the contents of a buffer to the * URI specified in the \b UpnpOpenHttpPost call. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b handle, \b buf * or \b size is not a valid pointer. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. */ EXPORT_SPEC int UpnpWriteHttpPost( /*! [in] The handle of the connection created by the call to * \b UpnpOpenHttpPost. */ void *handle, /*! [in] The buffer to be posted. */ char *buf, /*! [in] The size, in bytes of \b buf. */ size_t *size, /*! [in] A timeout value sent with the request during which a response is * expected from the server, failing which, an error is reported. If * value is negative, timeout is infinite. */ int timeout); /*! * \brief Sends and receives any pending data, closes the connection with the * server, and frees memory allocated during the \b UpnpOpenHttpPost call. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b handle, or * \b httpStatus is not a valid pointer. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. */ EXPORT_SPEC int UpnpCloseHttpPost( /*! [in] The handle of the connection to close, created by the call to * \b UpnpOpenHttpPost. */ void *handle, /*! [in,out] A pointer to a buffer to store the final status of the connection. */ int *httpStatus, /*! [in] A time out value sent with the request during which a response is * expected from the server, failing which, an error is reported. If * value is negative, timeout is infinite. */ int timeout); /*! * \brief Opens a connection to the server. * * The SDK allocates the memory for \b handle, the * application is responsible for freeing this memory. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b url, or \b handle * is not a valid pointer. * \li \c UPNP_E_INVALID_URL: The \b url is not a valid * URL. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * download this file. * \li \c UPNP_E_SOCKET_ERROR: Error occured allocating a socket and * resources or an error occurred binding a socket. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting a * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. */ EXPORT_SPEC int UpnpOpenHttpConnection( /*! [in] The URL which contains the host, and the scheme to make the connection. */ const char *url, /*! [in,out] A pointer in which to store the handle for this connection. This * handle is required for futher operations over this connection. */ void **handle, /*! [in] The time out value sent with the request during which a response * is expected from the receiver, failing which, an error is reported. * If value is negative, timeout is infinite. */ int timeout); /*! * \brief Makes a HTTP request using a connection previously created by * \b UpnpOpenHttpConnection. * * \note Trying to make another request while a request is already being processed * results in undefined behavior. It's up to the user to end a previous * request by calling \b UpnpEndHttpRequest. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b url, \b handle * or \b contentType is not a valid pointer. * \li \c UPNP_E_INVALID_URL: The \b url is not a valid * URL. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * download this file. * \li \c UPNP_E_SOCKET_ERROR: Error occured allocating a socket and * resources or an error occurred binding a socket. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting a * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. */ EXPORT_SPEC int UpnpMakeHttpRequest( /* ![in] The method to use to make the request. */ Upnp_HttpMethod method, /*! [in] The URL to use to make the request. The URL should use the same * scheme used to create the connection, but the host can be different * if the request is being proxied. */ const char *url, /*! [in] The handle to the connection. */ void *handle, /*! [in] Headers to be used for the request. Each header should be terminated by a CRLF as specified * in the HTTP specification. If NULL then the default headers will be used. */ UpnpString *headers, /*! [in] The media type of content being sent. Can be NULL. */ const char *contentType, /*! [in] The length of the content being sent, in bytes. Set to \b UPNP_USING_CHUNKED to use * chunked encoding, or \b UPNP_UNTIL_CLOSE to avoid specifying the content length to the server. * In this case the request is considered unfinished until the connection is closed. */ int contentLength, /*! [in] The time out value sent with the request during which a response * is expected from the receiver, failing which, an error is reported. * If value is negative, timeout is infinite. */ int timeout); /*! * \brief Writes the content of a HTTP request initiated by a \b UpnpMakeHttpRequest call. * The end of the content should be indicated by a call to \b UpnpEndHttpRequest * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b handle, \b buf * or \b size is not a valid pointer. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. */ EXPORT_SPEC int UpnpWriteHttpRequest( /*! [in] The handle of the connection created by the call to * \b UpnpOpenHttpConnection. */ void *handle, /*! [in] The buffer containing date to be written. */ char *buf, /*! [in] The size, in bytes of \b buf. */ size_t *size, /*! [in] A timeout value sent with the request during which a response is * expected from the server, failing which, an error is reported. If * value is negative, timeout is infinite. */ int timeout); /*! * \brief Indicates the end of a HTTP request previously made by * \b UpnpMakeHttpRequest. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: \b handle is not a valid pointer. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * download this file. * \li \c UPNP_E_SOCKET_ERROR: Error occured allocating a socket and * resources or an error occurred binding a socket. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting a * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. */ EXPORT_SPEC int UpnpEndHttpRequest( /*! [in] The handle to the connection. */ void *handle, /*! [in] The time out value sent with the request during which a response * is expected from the receiver, failing which, an error is reported. * If value is negative, timeout is infinite. */ int timeout); /*! * \brief Gets the response from the server using a connection previously created * by \b UpnpOpenHttpConnection * * \note Memory for \b contentType is only valid until the next call to the HTTP API * for the same connection. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b handle, * is not a valid pointer. * \li \c UPNP_E_INVALID_URL: The \b url is not a valid * URL. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * download this file. * \li \c UPNP_E_NETWORK_ERROR: A network error occurred. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting a * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. * \li \c UPNP_E_BAD_RESPONSE: A bad response was received from the * remote server. */ EXPORT_SPEC int UpnpGetHttpResponse( /*! [in] The handle of the connection created by the call to * \b UpnpOpenHttpConnection. */ void *handle, /*! [in] Headers sent by the server for the response. If NULL then the * headers are not copied. */ UpnpString *headers, /*! [out] A buffer to store the media type of the item. */ char **contentType, /*! [out] A pointer to store the length of the item. */ int *contentLength, /*! [out] The status returned on receiving a response message. */ int *httpStatus, /*! [in] The time out value sent with the request during which a response * is expected from the server, failing which, an error is reported * back to the user. If value is negative, timeout is infinite. */ int timeout); /*! * \brief Reads the content of a response using a connection previously created * by \b UpnpOpenHttpConnection. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b handle, \b buf * or \b size is not a valid pointer. * \li \c UPNP_E_BAD_RESPONSE: A bad response was received from the * remote server. * \li \c UPNP_E_BAD_HTTPMSG: Either the request or response was in * the incorrect format. * \li \c UPNP_E_CANCELED: another thread called UpnpCancelHttpGet. * * Note: In case of return values, the status code parameter of the passed * in handle value may provide additional information on the return * value. */ EXPORT_SPEC int UpnpReadHttpResponse( /*! [in] The handle of the connection created by the call to * \b UpnpOpenHttpConnection. */ void *handle, /*! [in,out] The buffer to store the read item. */ char *buf, /*! [in,out] The size of the buffer to be read. */ size_t *size, /*! [in] The time out value sent with the request during which a response is * expected from the server, failing which, an error is reported back to * the user. If value is negative, timeout is infinite. */ int timeout); /*! * \brief Closes the connection created with \b UpnpOpenHttpConnection * and frees any memory associated with the connection. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: \b handle, or is not a valid pointer. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. */ EXPORT_SPEC int UpnpCloseHttpConnection( /*! [in] The handle of the connection to close, created by the call to * \b UpnpOpenHttpPost. */ void *handle); /*! * \brief Downloads an XML document specified in a URL. * * The SDK parses the document and returns it in the form of a * DOM document. The application is responsible for freeing the DOM document. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b url or \b xmlDoc * is not a valid pointer. * \li \c UPNP_E_INVALID_DESC: The XML document was not * found or it does not contain a valid XML description. * \li \c UPNP_E_INVALID_URL: The \b url is not a valid * URL. * \li \c UPNP_E_OUTOF_MEMORY: There are insufficient resources to * download the XML document. * \li \c UPNP_E_NETWORK_ERROR: A network error occurred. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting the * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. */ EXPORT_SPEC int UpnpDownloadXmlDoc( /*! [in] URL of the XML document. */ const char *url, /*! [out] A pointer in which to store the XML document. */ IXML_Document **xmlDoc); /*! @} Control Point HTTP API */ /****************************************************************************** ****************************************************************************** * * * W E B S E R V E R A P I * * * ****************************************************************************** ******************************************************************************/ /*! * \name Web Server API * * @{ */ /*! * \brief Sets the document root directory for the internal web server. * * This directory is considered the root directory (i.e. "/") of the web server. * * This function also activates or deactivates the web server. To disable the * web server, pass \c NULL for \b rootDir; to activate, pass a valid directory * string. * * \note This function is not available when the web server is not compiled * into the UPnP Library. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_ARGUMENT: \b rootDir is an invalid directory. */ EXPORT_SPEC int UpnpSetWebServerRootDir( /*! [in] Path of the root directory of the web server. */ const char *rootDir); /*! * \brief The type of handle returned by the web server for open requests. */ typedef void *UpnpWebFileHandle; /*! * \brief Get-info callback function prototype. */ typedef int (*VDCallback_GetInfo)( /*! [in] The name of the file to query. */ const char *filename, /*! [out] Pointer to a structure to store the information on the file. */ UpnpFileInfo *info); /*! * \brief Sets the get_info callback function to be used to access a virtual * directory. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_ARGUMENT: \b callback is not a valid pointer. */ EXPORT_SPEC int UpnpVirtualDir_set_GetInfoCallback(VDCallback_GetInfo callback); /*! * \brief Open callback function prototype. */ typedef UpnpWebFileHandle (*VDCallback_Open)( /*! [in] The name of the file to open. */ const char *filename, /*! [in] The mode in which to open the file. * Valid values are \c UPNP_READ or \c UPNP_WRITE. */ enum UpnpOpenFileMode Mode); /*! * \brief Sets the open callback function to be used to access a virtual * directory. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_ARGUMENT: \b callback is not a valid pointer. */ EXPORT_SPEC int UpnpVirtualDir_set_OpenCallback(VDCallback_Open callback); /*! * \brief Read callback function prototype. */ typedef int (*VDCallback_Read)( /*! [in] The handle of the file to read. */ UpnpWebFileHandle fileHnd, /*! [out] The buffer in which to place the data. */ char *buf, /*! [in] The size of the buffer (i.e. the number of bytes to read). */ size_t buflen); /*! * \brief Sets the read callback function to be used to access a virtual * directory. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_ARGUMENT: \b callback is not a valid pointer. */ EXPORT_SPEC int UpnpVirtualDir_set_ReadCallback(VDCallback_Read callback); /*! * \brief Write callback function prototype. */ typedef int (*VDCallback_Write)( /*! [in] The handle of the file to write. */ UpnpWebFileHandle fileHnd, /*! [in] The buffer with the bytes to write. */ char *buf, /*! [in] The number of bytes to write. */ size_t buflen); /*! * \brief Sets the write callback function to be used to access a virtual * directory. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_ARGUMENT: \b callback is not a valid pointer. */ EXPORT_SPEC int UpnpVirtualDir_set_WriteCallback(VDCallback_Write callback); /*! * \brief Seek callback function prototype. */ typedef int (*VDCallback_Seek) ( /*! [in] The handle of the file to move the file pointer. */ UpnpWebFileHandle fileHnd, /*! [in] The number of bytes to move in the file. Positive values * move foward and negative values move backward. Note that * this must be positive if the \b origin is \c SEEK_SET. */ off_t offset, /*! [in] The position to move relative to. It can be \c SEEK_CUR * to move relative to the current position, \c SEEK_END to * move relative to the end of the file, or \c SEEK_SET to * specify an absolute offset. */ int origin); /*! * \brief Sets the seek callback function to be used to access a virtual * directory. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_ARGUMENT: \b callback is not a valid pointer. */ EXPORT_SPEC int UpnpVirtualDir_set_SeekCallback(VDCallback_Seek callback); /*! * \brief Close callback function prototype. */ typedef int (*VDCallback_Close)( /*! [in] The handle of the file to close. */ UpnpWebFileHandle fileHnd); /*! * \brief Sets the close callback function to be used to access a virtual * directory. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_ARGUMENT: \b callback is not a valid pointer. */ EXPORT_SPEC int UpnpVirtualDir_set_CloseCallback(VDCallback_Close callback); /*! * \brief Enables or disables the webserver. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_ARGUMENT: \b enable is not valid. */ EXPORT_SPEC int UpnpEnableWebserver( /*! [in] \c TRUE to enable, \c FALSE to disable. */ int enable); /*! * \brief Returns \c TRUE if the webserver is enabled, or \c FALSE if it is not. * * \return An integer representing one of the following: * \li \c TRUE: The webserver is enabled. * \li \c FALSE: The webserver is not enabled */ EXPORT_SPEC int UpnpIsWebserverEnabled(void); /*! * \brief Adds a virtual directory mapping. * * All webserver requests containing the given directory are read using * functions contained in a \b VirtualDirCallbacks structure registered * via \b UpnpSetVirtualDirCallbacks. * * \note This function is not available when the web server is not * compiled into the UPnP Library. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_ARGUMENT: \b dirName is not valid. */ EXPORT_SPEC int UpnpAddVirtualDir( /*! [in] The name of the new directory mapping to add. */ const char *dirName); /*! * \brief Removes a virtual directory mapping made with \b UpnpAddVirtualDir. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_ARGUMENT: \b dirName is not valid. */ EXPORT_SPEC int UpnpRemoveVirtualDir( /*! [in] The name of the virtual directory mapping to remove. */ const char *dirName); /*! * \brief Removes all virtual directory mappings. */ EXPORT_SPEC void UpnpRemoveAllVirtualDirs(void); /* @} Web Server API */ #ifdef __cplusplus } #endif /* __cplusplus */ /* @} UPnPAPI UPnP API */ #endif /* UPNP_H */ pupnp-release-1.8.0/upnp/inc/upnpconfig.h.in000066400000000000000000000120061303304015100207460ustar00rootroot00000000000000/* -*- C -*- */ /******************************************************************************* * * Copyright (c) 2006 Rémi Turboult * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * * Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef UPNP_CONFIG_H #define UPNP_CONFIG_H /*************************************************************************** * Library version ***************************************************************************/ /** The library version (string) e.g. "1.3.0" */ #undef UPNP_VERSION_STRING /** Major version of the library */ #undef UPNP_VERSION_MAJOR /** Minor version of the library */ #undef UPNP_VERSION_MINOR /** Patch version of the library */ #undef UPNP_VERSION_PATCH /** The library version (numeric) e.g. 10300 means version 1.3.0 */ #define UPNP_VERSION \ ((UPNP_VERSION_MAJOR * 100 + UPNP_VERSION_MINOR) * 100 + UPNP_VERSION_PATCH) /*************************************************************************** * Large file support ***************************************************************************/ /** File Offset size */ #undef _FILE_OFFSET_BITS /** Define to 1 to make fseeko visible on some hosts (e.g. glibc 2.2). */ #undef _LARGEFILE_SOURCE /** Large files support */ #undef _LARGE_FILE_SOURCE /*************************************************************************** * Library optional features ***************************************************************************/ /* * The following defines can be tested in order to know which * optional features have been included in the installed library. */ /** Defined to 1 if the library has been compiled with DEBUG enabled * (i.e. configure --enable-debug) : file is available */ #undef UPNP_HAVE_DEBUG /** Defined to 1 if the library has been compiled with client API enabled * (i.e. configure --enable-client) */ #undef UPNP_HAVE_CLIENT /** Defined to 1 if the library has been compiled with device API enabled * (i.e. configure --enable-device) */ #undef UPNP_HAVE_DEVICE /** Defined to 1 if the library has been compiled with integrated web server * (i.e. configure --enable-webserver --enable-device) */ #undef UPNP_HAVE_WEBSERVER /** Defined to 1 if the library has been compiled with the SSDP part enabled * (i.e. configure --enable-ssdp) */ #undef UPNP_HAVE_SSDP /** Defined to 1 if the library has been compiled with optional SSDP headers * support (i.e. configure --enable-optssdp) */ #undef UPNP_HAVE_OPTSSDP /** Defined to 1 if the library has been compiled with the SOAP part enabled * (i.e. configure --enable-soap) */ #undef UPNP_HAVE_SOAP /** Defined to 1 if the library has been compiled with the GENA part enabled * (i.e. configure --enable-gena) */ #undef UPNP_HAVE_GENA /** Defined to 1 if the library has been compiled with helper API * (i.e. configure --enable-tools) : file is available */ #undef UPNP_HAVE_TOOLS /** Defined to 1 if the library has been compiled with ipv6 support * (i.e. configure --enable-ipv6) */ #undef UPNP_ENABLE_IPV6 /** Defined to 1 if the library has been compiled with unspecified SERVER * header (i.e. configure --enable-unspecified_server) */ #undef UPNP_ENABLE_UNSPECIFIED_SERVER /** Defined to 1 if the library has been compiled with OpenSSL support * (i.e. configure --enable-open_ssl) */ #undef UPNP_ENABLE_OPEN_SSL /** Defined to 1 if the library has been compiled to support filesystem writes on POST * (i.e. configure --enable-postwrite) */ #undef UPNP_ENABLE_POST_WRITE #endif /* UPNP_CONFIG_H */ pupnp-release-1.8.0/upnp/inc/upnpdebug.h000066400000000000000000000173051303304015100201710ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * Copyright (c) 2006 Rémi Turboult * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef UPNP_DEBUG_H #define UPNP_DEBUG_H /*! * \file */ #include "ThreadPool.h" #include "upnpconfig.h" #include "UpnpGlobal.h" /* for UPNP_INLINE */ #include #ifdef __cplusplus extern "C" { #endif /*! \name Other debugging features * * The UPnP SDK contains other features to aid in debugging. */ /*@{*/ /*! \name Upnp_LogLevel * The user has the option to select 4 different types of debugging levels, * see \c UpnpSetLogLevel. * The critical level will show only those messages * which can halt the normal processing of the library, like memory * allocation errors. The remaining three levels are just for debugging * purposes. Packet level will display all the incoming and outgoing * packets that are flowing between the control point and the device. * Info Level displays the other important operational information * regarding the working of the library. If the user selects All, * then the library displays all the debugging information that it has. * \li \c UPNP_CRITICAL [0] * \li \c UPNP_PACKET [1] * \li \c UPNP_INFO [2] * \li \c UPNP_ALL [3] */ typedef enum Upnp_Module { SSDP, SOAP, GENA, TPOOL, MSERV, DOM, API, HTTP } Dbg_Module; /*@{*/ typedef enum Upnp_LogLevel_e { UPNP_CRITICAL, UPNP_PACKET, UPNP_INFO, UPNP_ALL } Upnp_LogLevel; /*@}*/ /*! * Default log level : see \c Upnp_LogLevel */ #define UPNP_DEFAULT_LOG_LEVEL UPNP_ALL /*! * \brief Initialize the log files. * * \return -1 if fails or UPNP_E_SUCCESS if succeeds. */ #ifdef DEBUG int UpnpInitLog(void); #else static UPNP_INLINE int UpnpInitLog(void) { return UPNP_E_SUCCESS; } #endif /*! * \brief Set the log level (see \c Upnp_LogLevel). */ #ifdef DEBUG void UpnpSetLogLevel( /*! [in] Log level. */ Upnp_LogLevel log_level); #else static UPNP_INLINE void UpnpSetLogLevel(Upnp_LogLevel log_level) { return; log_level = log_level; } #endif /*! * \brief Closes the log files. */ #ifdef DEBUG void UpnpCloseLog(void); #else static UPNP_INLINE void UpnpCloseLog(void) { } #endif /*! * \brief Set the name for error and information files, respectively. */ #ifdef DEBUG void UpnpSetLogFileNames( /*! [in] Name of the error file. */ const char *ErrFileName, /*! [in] Name of the information file. */ const char *InfoFileName); #else static UPNP_INLINE void UpnpSetLogFileNames(const char *ErrFileName, const char *InfoFileName) { return; ErrFileName = ErrFileName; InfoFileName = InfoFileName; } #endif /*! * \brief Check if the module is turned on for debug and returns the file * descriptor corresponding to the debug level * * \return NULL if the module is turn off for debug otheriwse returns the * right file descriptor. */ #ifdef DEBUG FILE *UpnpGetDebugFile( /*! [in] The level of the debug logging. It will decide whether debug * statement will go to standard output, or any of the log files. */ Upnp_LogLevel level, /*! [in] debug will go in the name of this module. */ Dbg_Module module); #else static UPNP_INLINE FILE *UpnpGetDebugFile(Upnp_LogLevel level, Dbg_Module module) { return NULL; level = level; module = module; } #endif /*! * \brief Returns true if debug output should be done in this module. * * \return Nonzero value if true, zero if false. */ #ifdef DEBUG int DebugAtThisLevel( /*! [in] The level of the debug logging. It will decide whether debug * statement will go to standard output, or any of the log files. */ Upnp_LogLevel DLevel, /*! [in] Debug will go in the name of this module. */ Dbg_Module Module); #else static UPNP_INLINE int DebugAtThisLevel(Upnp_LogLevel DLevel, Dbg_Module Module) { return 0; DLevel = DLevel; Module = Module; } #endif /*! * \brief Prints the debug statement either on the standard output or log file * along with the information from where this debug statement is coming. */ #ifdef DEBUG void UpnpPrintf( /*! [in] The level of the debug logging. It will decide whether debug * statement will go to standard output, or any of the log files. */ Upnp_LogLevel DLevel, /*! [in] debug will go in the name of this module. */ Dbg_Module Module, /*! [in] Name of the file from where debug statement is coming. */ const char *DbgFileName, /*! [in] Line number of the file from where debug statement is coming. */ int DbgLineNo, /*! [in] Printf like format specification. */ const char *FmtStr, /*! [in] Printf like Variable number of arguments that will go in the * debug statement. */ ...) #if (__GNUC__ >= 3) /* This enables printf like format checking by the compiler. */ __attribute__ ((format(__printf__, 5, 6))) #endif ; #else /* DEBUG */ static UPNP_INLINE void UpnpPrintf(Upnp_LogLevel DLevel, Dbg_Module Module, const char *DbgFileName, int DbgLineNo, const char *FmtStr, ...) { return; DLevel = DLevel; Module = Module; DbgFileName = DbgFileName; DbgLineNo = DbgLineNo; FmtStr = FmtStr; } #endif /* DEBUG */ /*! * \brief Writes the file name and file number from where debug statement is * coming to the log file. */ #ifdef DEBUG void UpnpDisplayFileAndLine( /*! [in] File descriptor where line number and file name will be * written. */ FILE * fd, /*! [in] Name of the file. */ const char *DbgFileName, /*! [in] Line number of the file. */ int DbgLineNo); #else static UPNP_INLINE void UpnpDisplayFileAndLine(FILE *fd, const char *DbgFileName, int DbgLineNo) { return; fd = fd; DbgFileName = DbgFileName; DbgLineNo = DbgLineNo; } #endif /*! * \brief Writes the buffer in the file as per the requested banner */ #ifdef DEBUG void UpnpDisplayBanner( /*! [in] file descriptor where the banner will be written. */ FILE * fd, /*! [in] The buffer that will be written. */ const char **lines, /*! [in] Size of the buffer. */ size_t size, /*! [in] This parameter provides the width of the banner. */ size_t starlength); #else static UPNP_INLINE void UpnpDisplayBanner(FILE *fd, const char **lines, size_t size, int starlength) { return; fd = fd; lines = lines; size = size; starlength = starlength; } #endif /*@}*/ #ifdef __cplusplus } #endif #endif /* UPNP_DEBUG_H */ pupnp-release-1.8.0/upnp/inc/upnptools.h000066400000000000000000000235441303304015100202450ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * * Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef UPNP_TOOLS_H #define UPNP_TOOLS_H /*! * \file * * \defgroup UPnPTools Optional Tool API * * \brief Additional, optional utility API that can be helpful in writing * applications. * * This additional API can be compiled out in order to save code size in the * library. Refer to the file README for details. * * @{ */ #include "ixml.h" /* for IXML_Document */ #include "upnpconfig.h" /* for UPNP_HAVE_TOOLS */ /* Function declarations only if tools compiled into the library */ #if UPNP_HAVE_TOOLS #ifdef __cplusplus extern "C" { #endif /*! * \brief Converts an SDK error code into a string error message suitable for * display. The memory returned from this function should NOT be freed. * * \return An ASCII text string representation of the error message associated * with the error code or the string "Unknown error code" */ EXPORT_SPEC const char *UpnpGetErrorMessage( /*! [in] The SDK error code to convert. */ int errorcode); /*! * \brief Combines a base URL and a relative URL into a single absolute URL. * * The memory for \b AbsURL needs to be allocated by the caller and must * be large enough to hold the \b BaseURL and \b RelURL combined. * * \return An integer representing one of the following: * \li UPNP_E_SUCCESS: The operation completed successfully. * \li UPNP_E_INVALID_PARAM: \b RelURL is NULL. * \li UPNP_E_INVALID_URL: The \b BaseURL / \b RelURL * combination does not form a valid URL. * \li UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpResolveURL( /*! [in] The base URL to combine. */ const char *BaseURL, /*! [in] The relative URL to \b BaseURL. */ const char *RelURL, /*! [out] A pointer to a buffer to store the absolute URL. */ char *AbsURL); /*! * \brief Combines a base URL and a relative URL into a single absolute URL. * * The memory for \b AbsURL becomes owned by the caller and should be freed * later. * * \return An integer representing one of the following: * \li UPNP_E_SUCCESS: The operation completed successfully. * \li UPNP_E_INVALID_PARAM: \b RelURL is NULL. * \li UPNP_E_INVALID_URL: The \b BaseURL / \b RelURL * combination does not form a valid URL. * \li UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpResolveURL2( /*! [in] The base URL to combine. */ const char *BaseURL, /*! [in] The relative URL to \b BaseURL. */ const char *RelURL, /*! [out] A pointer to a pointer to a buffer to store the * absolute URL. Must be freed later by the caller. */ char **AbsURL); /*! * \brief Creates an action request packet based on its input parameters * (status variable name and value pair). * * Any number of input parameters can be passed to this function but every * input variable name should have a matching value argument. * * It is a wrapper function that calls makeAction() function to create the * action request. * * \return The action node of \b Upnp_Document type or NULL if the * operation failed. */ EXPORT_SPEC IXML_Document *UpnpMakeAction( /*! [in] Name of the action request or response. */ const char *ActionName, /*! [in] The service type. */ const char *ServType, /*! [in] Number of argument pairs to be passed. */ int NumArg, /*! [in] pointer to the first argument. */ const char *Arg, /*! [in] Argument list. */ ...); /*! * \brief Ceates an action response packet based on its output parameters * (status variable name and value pair). * * Any number of input parameters can be passed to this function but every * output variable name should have a matching value argument. * * It is a wrapper function that calls makeAction() function to create the * action request. * * \return The action node of \b Upnp_Document type or NULL if the * operation failed. */ EXPORT_SPEC IXML_Document *UpnpMakeActionResponse( /*! [in] The action name. */ const char *ActionName, /*! [in] The service type.. */ const char *ServType, /*! [in] The number of argument pairs passed. */ int NumArg, /*! [in] The status variable name and value pair. */ const char *Arg, /*! [in] Other status variable name and value pairs. */ ...); /*! * \brief Adds the argument in the action request. * * This API is specially suitable inside a loop to add any number input * parameters into an existing action. If no action document exists in the * beginning then a Upnp_Document variable initialized with NULL * should be passed as a parameter. * * It is a wrapper function that calls addToAction() function to add the * argument in the action request. * * \return An integer representing one of the following: * \li UPNP_E_SUCCESS: The operation completed successfully. * \li UPNP_E_INVALID_PARAM: One or more of the parameters are invalid. * \li UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpAddToAction( /*! [in,out] A pointer to store the action document node. */ IXML_Document **ActionDoc, /*! [in] The action name. */ const char *ActionName, /*! [in] The service type. */ const char *ServType, /*! [in] The status variable name. */ const char *ArgName, /*! [in] The status variable value. */ const char *ArgVal); /*! * \brief Creates an action response packet based on its output parameters * (status variable name and value pair). * * This API is especially suitable inside a loop to add any number of input * parameters into an existing action response. If no action document exists * in the beginning, a \b Upnp_Document variable initialized with NULL * should be passed as a parameter. * * It is a wrapper function that calls addToAction() function to add the * argument in the action request. * * \return An integer representing one of the following: * \li UPNP_E_SUCCESS: The operation completed successfully. * \li UPNP_E_INVALID_PARAM: One or more of the parameters are invalid. * \li UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpAddToActionResponse( /*! [in,out] Pointer to a document to store the action document node. */ IXML_Document **ActionResponse, /*! [in] The action name. */ const char *ActionName, /*! [in] The service type. */ const char *ServType, /*! [in] The status variable name. */ const char *ArgName, /*! [in] The status variable value. */ const char *ArgVal); /*! * \brief Creates a property set message packet. * * Any number of input parameters can be passed to this function but every * input variable name should have a matching value input argument. * * \return NULL on failure, or the property-set document node. */ EXPORT_SPEC IXML_Document *UpnpCreatePropertySet( /*! [in] The number of argument pairs passed. */ int NumArg, /*! [in] The status variable name and value pair. */ const char *Arg, /*! [in] Variable sized list with the rest of the parameters. */ ...); /*! * \brief Can be used when an application needs to transfer the status of many * variables at once. * * It can be used (inside a loop) to add some extra status variables into an * existing property set. If the application does not already have a property * set document, the application should create a variable initialized with * NULL and pass that as the first parameter. * * \return An integer representing one of the following: * \li UPNP_E_SUCCESS: The operation completed successfully. * \li UPNP_E_INVALID_PARAM: One or more of the parameters are invalid. * \li UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * complete this operation. */ EXPORT_SPEC int UpnpAddToPropertySet( /*! [in,out] A pointer to the document containing the property set document node. */ IXML_Document **PropSet, /*! [in] The status variable name. */ const char *ArgName, /*! [in] The status variable value. */ const char *ArgVal); #ifdef __cplusplus } #endif /*! @} */ #endif /* UPNP_HAVE_TOOLS */ #endif /* UPNP_TOOLS_H */ pupnp-release-1.8.0/upnp/m4/000077500000000000000000000000001303304015100155705ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/m4/libupnp.m4000066400000000000000000000065111303304015100175060ustar00rootroot00000000000000# -*- Autoconf -*- # This file is part of the aMule project. # This file is part of the libupnp library project. # # Copyright (c) 2003-2008 aMule Team ( admin@amule.org / http://www.amule.org ) # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA # dnl -------------------------------------------------------------------------- dnl LIBUPNP_CHECK([VERSION = 1.6.6], [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND]) dnl dnl Check for the libupnp library dnl -------------------------------------------------------------------------- dnl dnl This macro sets these variables: dnl - LIBUPNP_VERSION dnl Something like "1.6.7" dnl - LIBUPNP_CPPFLAGS dnl Flags to be added to CPPFLAGS dnl - LIBUPNP_CFLAGS dnl Flags to be added to CFLAGS dnl - LIBUPNP_LDFLAGS dnl Flags to be added to LDFLAGS dnl - LIBUPNP_LIBS dnl Library to be added to LIBS dnl dnl The LIBUPNP_CPPFLAGS, LIBUPNP_CFLAGS, LIBUPNP_LDFLAGS and LIBUPNP_LIBS variables are also substituted. dnl AC_DEFUN([LIBUPNP_CHECK], [AC_REQUIRE([PKG_PROG_PKG_CONFIG])dnl m4_define([MIN_LIBUPNP_VERSION], [m4_ifval([$1], [$1], [1.6.6])])dnl dnl Test for --with-libupnp-prefix AC_ARG_WITH( [libupnp-prefix], [AS_HELP_STRING( [--with-libupnp-prefix=PREFIX], [UPnP library location])], [export PKG_CONFIG_PATH=$withval/lib/pkgconfig]) dnl Check for libupnp >= MIN_LIBUPNP_VERSION AS_IF([test $cross_compiling = no], [ AC_MSG_CHECKING([for libupnp version >= MIN_LIBUPNP_VERSION]) AS_IF([test -n "$PKG_CONFIG"], [ AS_IF([$PKG_CONFIG libupnp --exists], [ LIBUPNP_VERSION=`$PKG_CONFIG libupnp --modversion` AS_IF([$PKG_CONFIG libupnp --atleast-version=MIN_LIBUPNP_VERSION], [ result=yes resultstr=" (version $LIBUPNP_VERSION)" LIBUPNP_CPPFLAGS=`$PKG_CONFIG libupnp --cflags-only-I` LIBUPNP_CFLAGS=`$PKG_CONFIG libupnp --cflags-only-other` LIBUPNP_LDFLAGS=`$PKG_CONFIG libupnp --libs-only-L` LIBUPNP_LIBS=`$PKG_CONFIG libupnp --libs-only-other` LIBUPNP_LIBS="$LIBUPNP_LIBS `$PKG_CONFIG libupnp --libs-only-l`" ], [ result=no resultstr=" (version $LIBUPNP_VERSION is not new enough)" ]) ], [ result=no resultstr=" (try to use --with-libupnp-prefix=PREFIX)" ]) ], [ result=no resultstr=" (pkg-config not found)" ]) AC_MSG_RESULT([$result$resultstr]) libupnp_error="libupnp >= MIN_LIBUPNP_VERSION not found$resultstr" ], [ dnl Currently cross-compilation with libupnp is not supported. result=no libupnp_error="cross compiling" ]) dnl Execute the right action. AS_IF([test ${result:-no} = yes], [$2], [$3]) dnl Exported symbols AC_SUBST([LIBUPNP_CPPFLAGS])dnl AC_SUBST([LIBUPNP_CFLAGS])dnl AC_SUBST([LIBUPNP_LDFLAGS])dnl AC_SUBST([LIBUPNP_LIBS])dnl m4_undefine([MIN_LIBUPNP_VERSION])dnl ]) pupnp-release-1.8.0/upnp/sample/000077500000000000000000000000001303304015100165315ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/sample/Makefile.am000066400000000000000000000030741303304015100205710ustar00rootroot00000000000000# # "Makefile.am" for "libupnp/upnp/sample" # # Copyright (C) 2007 Marcelo Roberto Jimenez # AM_CPPFLAGS = \ -I$(top_srcdir)/upnp/inc \ -I$(top_srcdir)/threadutil/inc \ -I$(top_srcdir)/ixml/inc LDADD = \ $(top_builddir)/upnp/libupnp-1.8.la \ $(top_builddir)/threadutil/libthreadutil-1.8.la \ $(top_builddir)/ixml/libixml-1.8.la # samples noinst_PROGRAMS = if ENABLE_SAMPLES if ENABLE_CLIENT noinst_PROGRAMS += tv_ctrlpt-1.8 tv_ctrlpt_1_8_CPPFLAGS = \ $(AM_CPPFLAGS) \ -I$(srcdir)/common/ \ -I$(srcdir)/tvctrlpt if ENABLE_DEVICE noinst_PROGRAMS += tv_combo-1.8 tv_combo_1_8_CPPFLAGS = $(AM_CPPFLAGS) \ -I$(srcdir)/common/ \ -I$(srcdir)/tvcombo endif endif if ENABLE_DEVICE noinst_PROGRAMS += tv_device-1.8 tv_device_1_8_CPPFLAGS = \ $(AM_CPPFLAGS) \ -I$(srcdir)/common/ \ -I$(srcdir)/tvdevice endif endif tv_device_1_8_SOURCES = \ common/sample_util.c \ common/sample_util.h \ common/tv_device.c \ common/tv_device.h \ linux/tv_device_main.c tv_ctrlpt_1_8_SOURCES = \ common/sample_util.c \ common/sample_util.h \ common/tv_ctrlpt.c \ common/tv_ctrlpt.h \ linux/tv_ctrlpt_main.c tv_combo_1_8_SOURCES = \ common/sample_util.c \ common/sample_util.h \ common/tv_ctrlpt.c \ common/tv_ctrlpt.h \ common/tv_device.c \ common/tv_device.h \ linux/tv_combo_main.c if WITH_DOCUMENTATION examplesdir = $(docdir)/examples examples_DATA = \ $(tv_ctrlpt_1_8_SOURCES) \ $(tv_device_1_8_SOURCES) endif EXTRA_DIST = \ web/tvcombodesc.xml \ web/tvcontrolSCPD.xml \ web/tvdevicedesc.xml \ web/tvdevicepres.html \ web/tvpictureSCPD.xml pupnp-release-1.8.0/upnp/sample/common/000077500000000000000000000000001303304015100200215ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/sample/common/sample_util.c000066400000000000000000000501011303304015100225000ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \addtogroup UpnpSamples * * @{ * * \file */ #define SAMPLE_UTIL_C #include "sample_util.h" #include #include #if !UPNP_HAVE_TOOLS # error "Need upnptools.h to compile samples ; try ./configure --enable-tools" #endif static int initialize_init = 1; static int initialize_register = 1; /*! Function pointers to use for displaying formatted strings. * Set on Initialization of device. */ print_string gPrintFun = NULL; state_update gStateUpdateFun = NULL; /*! mutex to control displaying of events */ ithread_mutex_t display_mutex; int SampleUtil_Initialize(print_string print_function) { if (initialize_init) { ithread_mutexattr_t attr; ithread_mutexattr_init(&attr); ithread_mutexattr_setkind_np(&attr, ITHREAD_MUTEX_RECURSIVE_NP); ithread_mutex_init(&display_mutex, &attr); ithread_mutexattr_destroy(&attr); /* To shut up valgrind mutex warning. */ ithread_mutex_lock(&display_mutex); gPrintFun = print_function; ithread_mutex_unlock(&display_mutex); /* Finished initializing. */ initialize_init = 0; } return UPNP_E_SUCCESS; } int SampleUtil_RegisterUpdateFunction(state_update update_function) { if (initialize_register) { gStateUpdateFun = update_function; initialize_register = 0; } return UPNP_E_SUCCESS; } int SampleUtil_Finish() { ithread_mutex_destroy(&display_mutex); gPrintFun = NULL; gStateUpdateFun = NULL; initialize_init = 1; initialize_register = 1; return UPNP_E_SUCCESS; } char *SampleUtil_GetElementValue(IXML_Element *element) { IXML_Node *child = ixmlNode_getFirstChild((IXML_Node *)element); char *temp = NULL; if (child != 0 && ixmlNode_getNodeType(child) == eTEXT_NODE) temp = strdup(ixmlNode_getNodeValue(child)); return temp; } IXML_NodeList *SampleUtil_GetFirstServiceList(IXML_Document *doc) { IXML_NodeList *ServiceList = NULL; IXML_NodeList *servlistnodelist = NULL; IXML_Node *servlistnode = NULL; servlistnodelist = ixmlDocument_getElementsByTagName(doc, "serviceList"); if (servlistnodelist && ixmlNodeList_length(servlistnodelist)) { /* we only care about the first service list, from the root * device */ servlistnode = ixmlNodeList_item(servlistnodelist, 0); /* create as list of DOM nodes */ ServiceList = ixmlElement_getElementsByTagName( (IXML_Element *)servlistnode, "service"); } if (servlistnodelist) ixmlNodeList_free(servlistnodelist); return ServiceList; } #define OLD_FIND_SERVICE_CODE #ifdef OLD_FIND_SERVICE_CODE #else /* * Obtain the service list * n == 0 the first * n == 1 the next in the device list, etc.. */ static IXML_NodeList *SampleUtil_GetNthServiceList( /*! [in] . */ IXML_Document *doc, /*! [in] . */ unsigned int n) { IXML_NodeList *ServiceList = NULL; IXML_NodeList *servlistnodelist = NULL; IXML_Node *servlistnode = NULL; /* ixmlDocument_getElementsByTagName() * Returns a NodeList of all Elements that match the given * tag name in the order in which they were encountered in a preorder * traversal of the Document tree. * * return (NodeList*) A pointer to a NodeList containing the * matching items or NULL on an error. */ SampleUtil_Print("SampleUtil_GetNthServiceList called : n = %d\n", n); servlistnodelist = ixmlDocument_getElementsByTagName(doc, "serviceList"); if (servlistnodelist && ixmlNodeList_length(servlistnodelist) && n < ixmlNodeList_length(servlistnodelist)) { /* For the first service list (from the root device), * we pass 0 */ /*servlistnode = ixmlNodeList_item( servlistnodelist, 0 );*/ /* Retrieves a Node from a NodeList} specified by a * numerical index. * * return (Node*) A pointer to a Node or NULL if there was an * error. */ servlistnode = ixmlNodeList_item(servlistnodelist, n); if (!servlistnode) { /* create as list of DOM nodes */ ServiceList = ixmlElement_getElementsByTagName( (IXML_Element *)servlistnode, "service"); } else SampleUtil_Print("%s(%d): ixmlNodeList_item(nodeList, n) returned NULL\n", __FILE__, __LINE__); } if (servlistnodelist) ixmlNodeList_free(servlistnodelist); return ServiceList; } #endif char *SampleUtil_GetFirstDocumentItem(IXML_Document *doc, const char *item) { IXML_NodeList *nodeList = NULL; IXML_Node *textNode = NULL; IXML_Node *tmpNode = NULL; char *ret = NULL; nodeList = ixmlDocument_getElementsByTagName(doc, (char *)item); if (nodeList) { tmpNode = ixmlNodeList_item(nodeList, 0); if (tmpNode) { textNode = ixmlNode_getFirstChild(tmpNode); if (!textNode) { SampleUtil_Print("%s(%d): (BUG) ixmlNode_getFirstChild(tmpNode) returned NULL\n", __FILE__, __LINE__); ret = strdup(""); goto epilogue; } ret = strdup(ixmlNode_getNodeValue(textNode)); if (!ret) { SampleUtil_Print("%s(%d): ixmlNode_getNodeValue returned NULL\n", __FILE__, __LINE__); ret = strdup(""); } } else SampleUtil_Print("%s(%d): ixmlNodeList_item(nodeList, 0) returned NULL\n", __FILE__, __LINE__); } else SampleUtil_Print("%s(%d): Error finding %s in XML Node\n", __FILE__, __LINE__, item); epilogue: if (nodeList) ixmlNodeList_free(nodeList); return ret; } char *SampleUtil_GetFirstElementItem(IXML_Element *element, const char *item) { IXML_NodeList *nodeList = NULL; IXML_Node *textNode = NULL; IXML_Node *tmpNode = NULL; char *ret = NULL; nodeList = ixmlElement_getElementsByTagName(element, (char *)item); if (nodeList == NULL) { SampleUtil_Print("%s(%d): Error finding %s in XML Node\n", __FILE__, __LINE__, item); return NULL; } tmpNode = ixmlNodeList_item(nodeList, 0); if (!tmpNode) { SampleUtil_Print("%s(%d): Error finding %s value in XML Node\n", __FILE__, __LINE__, item); ixmlNodeList_free(nodeList); return NULL; } textNode = ixmlNode_getFirstChild(tmpNode); ret = strdup(ixmlNode_getNodeValue(textNode)); if (!ret) { SampleUtil_Print("%s(%d): Error allocating memory for %s in XML Node\n", __FILE__, __LINE__, item); ixmlNodeList_free(nodeList); return NULL; } ixmlNodeList_free(nodeList); return ret; } void SampleUtil_PrintEventType(Upnp_EventType S) { switch (S) { /* Discovery */ case UPNP_DISCOVERY_ADVERTISEMENT_ALIVE: SampleUtil_Print("UPNP_DISCOVERY_ADVERTISEMENT_ALIVE\n"); break; case UPNP_DISCOVERY_ADVERTISEMENT_BYEBYE: SampleUtil_Print("UPNP_DISCOVERY_ADVERTISEMENT_BYEBYE\n"); break; case UPNP_DISCOVERY_SEARCH_RESULT: SampleUtil_Print( "UPNP_DISCOVERY_SEARCH_RESULT\n"); break; case UPNP_DISCOVERY_SEARCH_TIMEOUT: SampleUtil_Print( "UPNP_DISCOVERY_SEARCH_TIMEOUT\n"); break; /* SOAP */ case UPNP_CONTROL_ACTION_REQUEST: SampleUtil_Print("UPNP_CONTROL_ACTION_REQUEST\n"); break; case UPNP_CONTROL_ACTION_COMPLETE: SampleUtil_Print("UPNP_CONTROL_ACTION_COMPLETE\n"); break; case UPNP_CONTROL_GET_VAR_REQUEST: SampleUtil_Print("UPNP_CONTROL_GET_VAR_REQUEST\n"); break; case UPNP_CONTROL_GET_VAR_COMPLETE: SampleUtil_Print("UPNP_CONTROL_GET_VAR_COMPLETE\n"); break; /* GENA */ case UPNP_EVENT_SUBSCRIPTION_REQUEST: SampleUtil_Print("UPNP_EVENT_SUBSCRIPTION_REQUEST\n"); break; case UPNP_EVENT_RECEIVED: SampleUtil_Print("UPNP_EVENT_RECEIVED\n"); break; case UPNP_EVENT_RENEWAL_COMPLETE: SampleUtil_Print("UPNP_EVENT_RENEWAL_COMPLETE\n"); break; case UPNP_EVENT_SUBSCRIBE_COMPLETE: SampleUtil_Print("UPNP_EVENT_SUBSCRIBE_COMPLETE\n"); break; case UPNP_EVENT_UNSUBSCRIBE_COMPLETE: SampleUtil_Print("UPNP_EVENT_UNSUBSCRIBE_COMPLETE\n"); break; case UPNP_EVENT_AUTORENEWAL_FAILED: SampleUtil_Print("UPNP_EVENT_AUTORENEWAL_FAILED\n"); break; case UPNP_EVENT_SUBSCRIPTION_EXPIRED: SampleUtil_Print("UPNP_EVENT_SUBSCRIPTION_EXPIRED\n"); break; } } int SampleUtil_PrintEvent(Upnp_EventType EventType, const void *Event) { ithread_mutex_lock(&display_mutex); SampleUtil_Print( "======================================================================\n" "----------------------------------------------------------------------\n"); SampleUtil_PrintEventType(EventType); switch (EventType) { /* SSDP */ case UPNP_DISCOVERY_ADVERTISEMENT_ALIVE: case UPNP_DISCOVERY_ADVERTISEMENT_BYEBYE: case UPNP_DISCOVERY_SEARCH_RESULT: { UpnpDiscovery *d_event = (UpnpDiscovery *)Event; SampleUtil_Print( "ErrCode = %d\n" "Expires = %d\n" "DeviceId = %s\n" "DeviceType = %s\n" "ServiceType = %s\n" "ServiceVer = %s\n" "Location = %s\n" "OS = %s\n" "Date = %s\n" "Ext = %s\n", UpnpDiscovery_get_ErrCode(d_event), UpnpDiscovery_get_Expires(d_event), UpnpString_get_String(UpnpDiscovery_get_DeviceID(d_event)), UpnpString_get_String(UpnpDiscovery_get_DeviceType(d_event)), UpnpString_get_String(UpnpDiscovery_get_ServiceType(d_event)), UpnpString_get_String(UpnpDiscovery_get_ServiceVer(d_event)), UpnpString_get_String(UpnpDiscovery_get_Location(d_event)), UpnpString_get_String(UpnpDiscovery_get_Os(d_event)), UpnpString_get_String(UpnpDiscovery_get_Date(d_event)), UpnpString_get_String(UpnpDiscovery_get_Ext(d_event))); break; } case UPNP_DISCOVERY_SEARCH_TIMEOUT: /* Nothing to print out here */ break; /* SOAP */ case UPNP_CONTROL_ACTION_REQUEST: { UpnpActionRequest *a_event = (UpnpActionRequest *)Event; IXML_Document *actionRequestDoc = NULL; IXML_Document *actionResultDoc = NULL; char *xmlbuff = NULL; SampleUtil_Print( "ErrCode = %d\n" "ErrStr = %s\n" "ActionName = %s\n" "UDN = %s\n" "ServiceID = %s\n", UpnpActionRequest_get_ErrCode(a_event), UpnpString_get_String(UpnpActionRequest_get_ErrStr(a_event)), UpnpString_get_String(UpnpActionRequest_get_ActionName(a_event)), UpnpString_get_String(UpnpActionRequest_get_DevUDN(a_event)), UpnpString_get_String(UpnpActionRequest_get_ServiceID(a_event))); actionRequestDoc = UpnpActionRequest_get_ActionRequest(a_event); if (actionRequestDoc) { xmlbuff = ixmlPrintNode((IXML_Node *)actionRequestDoc); if (xmlbuff) { SampleUtil_Print("ActRequest = %s\n", xmlbuff); ixmlFreeDOMString(xmlbuff); } xmlbuff = NULL; } else { SampleUtil_Print("ActRequest = (null)\n"); } actionResultDoc = UpnpActionRequest_get_ActionResult(a_event); if (actionResultDoc) { xmlbuff = ixmlPrintNode((IXML_Node *)actionResultDoc); if (xmlbuff) { SampleUtil_Print("ActResult = %s\n", xmlbuff); ixmlFreeDOMString(xmlbuff); } xmlbuff = NULL; } else { SampleUtil_Print("ActResult = (null)\n"); } break; } case UPNP_CONTROL_ACTION_COMPLETE: { UpnpActionComplete *a_event = (UpnpActionComplete *)Event; char *xmlbuff = NULL; int errCode = UpnpActionComplete_get_ErrCode(a_event); const char *ctrlURL = UpnpString_get_String( UpnpActionComplete_get_CtrlUrl(a_event)); IXML_Document *actionRequest = UpnpActionComplete_get_ActionRequest(a_event); IXML_Document *actionResult = UpnpActionComplete_get_ActionResult(a_event); SampleUtil_Print( "ErrCode = %d\n" "CtrlUrl = %s\n", errCode, ctrlURL); if (actionRequest) { xmlbuff = ixmlPrintNode((IXML_Node *)actionRequest); if (xmlbuff) { SampleUtil_Print("ActRequest = %s\n", xmlbuff); ixmlFreeDOMString(xmlbuff); } xmlbuff = NULL; } else { SampleUtil_Print("ActRequest = (null)\n"); } if (actionResult) { xmlbuff = ixmlPrintNode((IXML_Node *)actionResult); if (xmlbuff) { SampleUtil_Print("ActResult = %s\n", xmlbuff); ixmlFreeDOMString(xmlbuff); } xmlbuff = NULL; } else { SampleUtil_Print("ActResult = (null)\n"); } break; } case UPNP_CONTROL_GET_VAR_REQUEST: { UpnpStateVarRequest *sv_event = (UpnpStateVarRequest *)Event; SampleUtil_Print( "ErrCode = %d\n" "ErrStr = %s\n" "UDN = %s\n" "ServiceID = %s\n" "StateVarName= %s\n" "CurrentVal = %s\n", UpnpStateVarRequest_get_ErrCode(sv_event), UpnpString_get_String(UpnpStateVarRequest_get_ErrStr(sv_event)), UpnpString_get_String(UpnpStateVarRequest_get_DevUDN(sv_event)), UpnpString_get_String(UpnpStateVarRequest_get_ServiceID(sv_event)), UpnpString_get_String(UpnpStateVarRequest_get_StateVarName(sv_event)), UpnpStateVarRequest_get_CurrentVal(sv_event)); break; } case UPNP_CONTROL_GET_VAR_COMPLETE: { UpnpStateVarComplete *sv_event = (UpnpStateVarComplete *)Event; SampleUtil_Print( "ErrCode = %d\n" "CtrlUrl = %s\n" "StateVarName= %s\n" "CurrentVal = %s\n", UpnpStateVarComplete_get_ErrCode(sv_event), UpnpString_get_String(UpnpStateVarComplete_get_CtrlUrl(sv_event)), UpnpString_get_String(UpnpStateVarComplete_get_StateVarName(sv_event)), UpnpStateVarComplete_get_CurrentVal(sv_event)); break; } /* GENA */ case UPNP_EVENT_SUBSCRIPTION_REQUEST: { UpnpSubscriptionRequest *sr_event = (UpnpSubscriptionRequest *)Event; SampleUtil_Print( "ServiceID = %s\n" "UDN = %s\n" "SID = %s\n", UpnpString_get_String(UpnpSubscriptionRequest_get_ServiceId(sr_event)), UpnpString_get_String(UpnpSubscriptionRequest_get_UDN(sr_event)), UpnpString_get_String(UpnpSubscriptionRequest_get_SID(sr_event))); break; } case UPNP_EVENT_RECEIVED: { UpnpEvent *e_event = (UpnpEvent *)Event; char *xmlbuff = NULL; xmlbuff = ixmlPrintNode( (IXML_Node *)UpnpEvent_get_ChangedVariables(e_event)); SampleUtil_Print( "SID = %s\n" "EventKey = %d\n" "ChangedVars = %s\n", UpnpString_get_String(UpnpEvent_get_SID(e_event)), UpnpEvent_get_EventKey(e_event), xmlbuff); ixmlFreeDOMString(xmlbuff); break; } case UPNP_EVENT_RENEWAL_COMPLETE: { UpnpEventSubscribe *es_event = (UpnpEventSubscribe *)Event; SampleUtil_Print( "SID = %s\n" "ErrCode = %d\n" "TimeOut = %d\n", UpnpString_get_String(UpnpEventSubscribe_get_SID(es_event)), UpnpEventSubscribe_get_ErrCode(es_event), UpnpEventSubscribe_get_TimeOut(es_event)); break; } case UPNP_EVENT_SUBSCRIBE_COMPLETE: case UPNP_EVENT_UNSUBSCRIBE_COMPLETE: { UpnpEventSubscribe *es_event = (UpnpEventSubscribe *)Event; SampleUtil_Print( "SID = %s\n" "ErrCode = %d\n" "PublisherURL= %s\n" "TimeOut = %d\n", UpnpString_get_String(UpnpEventSubscribe_get_SID(es_event)), UpnpEventSubscribe_get_ErrCode(es_event), UpnpString_get_String(UpnpEventSubscribe_get_PublisherUrl(es_event)), UpnpEventSubscribe_get_TimeOut(es_event)); break; } case UPNP_EVENT_AUTORENEWAL_FAILED: case UPNP_EVENT_SUBSCRIPTION_EXPIRED: { UpnpEventSubscribe *es_event = (UpnpEventSubscribe *)Event; SampleUtil_Print( "SID = %s\n" "ErrCode = %d\n" "PublisherURL= %s\n" "TimeOut = %d\n", UpnpString_get_String(UpnpEventSubscribe_get_SID(es_event)), UpnpEventSubscribe_get_ErrCode(es_event), UpnpString_get_String(UpnpEventSubscribe_get_PublisherUrl(es_event)), UpnpEventSubscribe_get_TimeOut(es_event)); break; } } SampleUtil_Print( "----------------------------------------------------------------------\n" "======================================================================\n" "\n\n\n"); ithread_mutex_unlock(&display_mutex); return 0; } int SampleUtil_FindAndParseService(IXML_Document *DescDoc, const char *location, const char *serviceType, char **serviceId, char **eventURL, char **controlURL) { unsigned int i; unsigned long length; int found = 0; int ret; #ifdef OLD_FIND_SERVICE_CODE #else /* OLD_FIND_SERVICE_CODE */ unsigned int sindex = 0; #endif /* OLD_FIND_SERVICE_CODE */ char *tempServiceType = NULL; char *baseURL = NULL; const char *base = NULL; char *relcontrolURL = NULL; char *releventURL = NULL; IXML_NodeList *serviceList = NULL; IXML_Element *service = NULL; baseURL = SampleUtil_GetFirstDocumentItem(DescDoc, "URLBase"); if (baseURL) base = baseURL; else base = location; #ifdef OLD_FIND_SERVICE_CODE serviceList = SampleUtil_GetFirstServiceList(DescDoc); #else /* OLD_FIND_SERVICE_CODE */ for (sindex = 0; (serviceList = SampleUtil_GetNthServiceList(DescDoc , sindex)) != NULL; sindex++) { tempServiceType = NULL; relcontrolURL = NULL; releventURL = NULL; service = NULL; #endif /* OLD_FIND_SERVICE_CODE */ length = ixmlNodeList_length(serviceList); for (i = 0; i < length; i++) { service = (IXML_Element *)ixmlNodeList_item(serviceList, i); tempServiceType = SampleUtil_GetFirstElementItem( (IXML_Element *)service, "serviceType"); if (tempServiceType && strcmp(tempServiceType, serviceType) == 0) { SampleUtil_Print("Found service: %s\n", serviceType); *serviceId = SampleUtil_GetFirstElementItem(service, "serviceId"); SampleUtil_Print("serviceId: %s\n", *serviceId); relcontrolURL = SampleUtil_GetFirstElementItem(service, "controlURL"); releventURL = SampleUtil_GetFirstElementItem(service, "eventSubURL"); *controlURL = malloc(strlen(base) + strlen(relcontrolURL) + 1); if (*controlURL) { ret = UpnpResolveURL(base, relcontrolURL, *controlURL); if (ret != UPNP_E_SUCCESS) SampleUtil_Print("Error generating controlURL from %s + %s\n", base, relcontrolURL); } *eventURL = malloc(strlen(base) + strlen(releventURL) + 1); if (*eventURL) { ret = UpnpResolveURL(base, releventURL, *eventURL); if (ret != UPNP_E_SUCCESS) SampleUtil_Print("Error generating eventURL from %s + %s\n", base, releventURL); } free(relcontrolURL); free(releventURL); relcontrolURL = NULL; releventURL = NULL; found = 1; break; } free(tempServiceType); tempServiceType = NULL; } free(tempServiceType); tempServiceType = NULL; if (serviceList) ixmlNodeList_free(serviceList); serviceList = NULL; #ifdef OLD_FIND_SERVICE_CODE #else /* OLD_FIND_SERVICE_CODE */ } #endif /* OLD_FIND_SERVICE_CODE */ free(baseURL); return found; } int SampleUtil_Print(const char *fmt, ...) { #define MAX_BUF (8 * 1024) va_list ap; static char buf[MAX_BUF]; int rc; /* Protect both the display and the static buffer with the mutex */ ithread_mutex_lock(&display_mutex); va_start(ap, fmt); rc = vsnprintf(buf, MAX_BUF, fmt, ap); va_end(ap); if (gPrintFun) gPrintFun("%s", buf); ithread_mutex_unlock(&display_mutex); return rc; } void SampleUtil_StateUpdate(const char *varName, const char *varValue, const char *UDN, eventType type) { /* TBD: Add mutex here? */ if (gStateUpdateFun) gStateUpdateFun(varName, varValue, UDN, type); } /*! * \brief Prints a string to standard out. */ void linux_print(const char *format, ...) { va_list argList; va_start(argList, format); vfprintf(stdout, format, argList); fflush(stdout); va_end(argList); } /*! @} UpnpSamples */ pupnp-release-1.8.0/upnp/sample/common/sample_util.h000066400000000000000000000172341303304015100225170ustar00rootroot00000000000000#ifndef SAMPLE_UTIL_H #define SAMPLE_UTIL_H /******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \defgroup UpnpSamples Sample Code * * @{ * * \file */ #ifdef __cplusplus extern "C" { #endif /* __cplusplus */ #include "ithread.h" #include "ixml.h" /* for IXML_Document, IXML_Element */ #include "upnp.h" /* for Upnp_EventType */ #include "upnptools.h" #include #include #ifdef SAMPLE_UTIL_C /*! Service types for tv services. */ const char *TvServiceType[] = { "urn:schemas-upnp-org:service:tvcontrol:1", "urn:schemas-upnp-org:service:tvpicture:1" }; #else /* SAMPLE_UTIL_C */ extern const char *TvServiceType[]; #endif /* SAMPLE_UTIL_C */ /* mutex to control displaying of events */ extern ithread_mutex_t display_mutex; typedef enum { STATE_UPDATE = 0, DEVICE_ADDED = 1, DEVICE_REMOVED = 2, GET_VAR_COMPLETE = 3 } eventType; /*! * \brief Given a DOM node such as 11, this routine * extracts the value (e.g., 11) from the node and returns it as * a string. The string must be freed by the caller using free. * * \return The DOM node as a string. */ char *SampleUtil_GetElementValue( /*! [in] The DOM node from which to extract the value. */ IXML_Element *element); /*! * \brief Given a DOM node representing a UPnP Device Description Document, * this routine parses the document and finds the first service list * (i.e., the service list for the root device). The service list * is returned as a DOM node list. The NodeList must be freed using * NodeList_free. * * \return The service list is returned as a DOM node list. */ IXML_NodeList *SampleUtil_GetFirstServiceList( /*! [in] The DOM node from which to extract the service list. */ IXML_Document *doc); /*! * \brief Given a document node, this routine searches for the first element * named by the input string item, and returns its value as a string. * String must be freed by caller using free. */ char *SampleUtil_GetFirstDocumentItem( /*! [in] The DOM document from which to extract the value. */ IXML_Document *doc, /*! [in] The item to search for. */ const char *item); /*! * \brief Given a DOM element, this routine searches for the first element * named by the input string item, and returns its value as a string. * The string must be freed using free. */ char *SampleUtil_GetFirstElementItem( /*! [in] The DOM element from which to extract the value. */ IXML_Element *element, /*! [in] The item to search for. */ const char *item); /*! * \brief Prints a callback event type as a string. */ void SampleUtil_PrintEventType( /*! [in] The callback event. */ Upnp_EventType S); /*! * \brief Prints callback event structure details. */ int SampleUtil_PrintEvent( /*! [in] The type of callback event. */ Upnp_EventType EventType, /*! [in] The callback event structure. */ const void *Event); /*! * \brief This routine finds the first occurance of a service in a DOM * representation of a description document and parses it. Note that this * function currently assumes that the eventURL and controlURL values in * the service definitions are full URLs. Relative URLs are not handled here. */ int SampleUtil_FindAndParseService ( /*! [in] The DOM description document. */ IXML_Document *DescDoc, /*! [in] The location of the description document. */ const char *location, /*! [in] The type of service to search for. */ const char *serviceType, /*! [out] The service ID. */ char **serviceId, /*! [out] The event URL for the service. */ char **eventURL, /*! [out] The control URL for the service. */ char **controlURL); /*! * \brief Prototype for displaying strings. All printing done by the device, * control point, and sample util, ultimately use this to display strings * to the user. */ typedef void (*print_string)( /*! [in] Format. */ const char *string, /*! [in] Arguments. */ ...) #if (__GNUC__ >= 3) /* This enables printf like format checking by the compiler */ __attribute__((format (__printf__, 1, 2))) #endif ; /*! global print function used by sample util */ extern print_string gPrintFun; /*! * \brief Prototype for passing back state changes. */ typedef void (*state_update)( /*! [in] . */ const char *varName, /*! [in] . */ const char *varValue, /*! [in] . */ const char *UDN, /*! [in] . */ eventType type); /*! global state update function used by smaple util */ extern state_update gStateUpdateFun; /*! * \brief Initializes the sample util. Must be called before any sample util * functions. May be called multiple times. */ int SampleUtil_Initialize( /*! [in] Print function to use in SampleUtil_Print. */ print_string print_function); /*! * \brief Releases Resources held by sample util. */ int SampleUtil_Finish(); /*! * \brief Function emulating printf that ultimately calls the registered print * function with the formatted string. * * Provides platform-specific print functionality. This function should be * called when you want to print content suitable for console output (i.e., * in a large text box or on a screen). If your device/operating system is * not supported here, you should add a port. * * \return The same as printf. */ int SampleUtil_Print( /*! [in] Format (see printf). */ const char *fmt, /*! [in] Format data. */ ...) #if (__GNUC__ >= 3) /* This enables printf like format checking by the compiler */ __attribute__((format (__printf__, 1, 2))) #endif ; /*! * \brief */ int SampleUtil_RegisterUpdateFunction( /*! [in] . */ state_update update_function); /*! * \brief */ void SampleUtil_StateUpdate( /*! [in] . */ const char *varName, /*! [in] . */ const char *varValue, /*! [in] . */ const char *UDN, /*! [in] . */ eventType type); /*! * \brief Prints a string to standard out. */ void linux_print(const char *format, ...) #if (__GNUC__ >= 3) /* This enables printf like format checking by the compiler */ __attribute__((format (__printf__, 1, 2))) #endif ; #ifdef __cplusplus }; #endif /* __cplusplus */ #ifdef WIN32 #define snprintf _snprintf #define strcasecmp stricmp #endif /*! @} UpnpSamples */ #endif /* SAMPLE_UTIL_H */ pupnp-release-1.8.0/upnp/sample/common/tv_ctrlpt.c000066400000000000000000001312511303304015100222110ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \addtogroup UpnpSamples * * @{ * * \name Control Point Sample Module * * @{ * * \file */ #include "tv_ctrlpt.h" #include "upnp.h" /*! * Mutex for protecting the global device list in a multi-threaded, * asynchronous environment. All functions should lock this mutex before * reading or writing the device list. */ ithread_mutex_t DeviceListMutex; UpnpClient_Handle ctrlpt_handle = -1; /*! Device type for tv device. */ const char TvDeviceType[] = "urn:schemas-upnp-org:device:tvdevice:1"; /*! Service names.*/ const char *TvServiceName[] = { "Control", "Picture" }; /*! Global arrays for storing variable names and counts for TvControl and TvPicture services */ const char *TvVarName[TV_SERVICE_SERVCOUNT][TV_MAXVARS] = { {"Power", "Channel", "Volume", ""}, {"Color", "Tint", "Contrast", "Brightness"} }; char TvVarCount[TV_SERVICE_SERVCOUNT] = { TV_CONTROL_VARCOUNT, TV_PICTURE_VARCOUNT }; /*! Timeout to request during subscriptions */ int default_timeout = 1801; /*! The first node in the global device list, or NULL if empty */ struct TvDeviceNode *GlobalDeviceList = NULL; /******************************************************************************** * TvCtrlPointDeleteNode * * Description: * Delete a device node from the global device list. Note that this * function is NOT thread safe, and should be called from another * function that has already locked the global device list. * * Parameters: * node -- The device node * ********************************************************************************/ int TvCtrlPointDeleteNode( struct TvDeviceNode *node ) { int rc, service, var; if (NULL == node) { SampleUtil_Print ("ERROR: TvCtrlPointDeleteNode: Node is empty\n"); return TV_ERROR; } for (service = 0; service < TV_SERVICE_SERVCOUNT; service++) { /* If we have a valid control SID, then unsubscribe */ if (strcmp(node->device.TvService[service].SID, "") != 0) { rc = UpnpUnSubscribe(ctrlpt_handle, node->device.TvService[service]. SID); if (UPNP_E_SUCCESS == rc) { SampleUtil_Print ("Unsubscribed from Tv %s EventURL with SID=%s\n", TvServiceName[service], node->device.TvService[service].SID); } else { SampleUtil_Print ("Error unsubscribing to Tv %s EventURL -- %d\n", TvServiceName[service], rc); } } for (var = 0; var < TvVarCount[service]; var++) { if (node->device.TvService[service].VariableStrVal[var]) { free(node->device. TvService[service].VariableStrVal[var]); } } } /*Notify New Device Added */ SampleUtil_StateUpdate(NULL, NULL, node->device.UDN, DEVICE_REMOVED); free(node); node = NULL; return TV_SUCCESS; } /******************************************************************************** * TvCtrlPointRemoveDevice * * Description: * Remove a device from the global device list. * * Parameters: * UDN -- The Unique Device Name for the device to remove * ********************************************************************************/ int TvCtrlPointRemoveDevice(const char *UDN) { struct TvDeviceNode *curdevnode; struct TvDeviceNode *prevdevnode; ithread_mutex_lock(&DeviceListMutex); curdevnode = GlobalDeviceList; if (!curdevnode) { SampleUtil_Print( "WARNING: TvCtrlPointRemoveDevice: Device list empty\n"); } else { if (0 == strcmp(curdevnode->device.UDN, UDN)) { GlobalDeviceList = curdevnode->next; TvCtrlPointDeleteNode(curdevnode); } else { prevdevnode = curdevnode; curdevnode = curdevnode->next; while (curdevnode) { if (strcmp(curdevnode->device.UDN, UDN) == 0) { prevdevnode->next = curdevnode->next; TvCtrlPointDeleteNode(curdevnode); break; } prevdevnode = curdevnode; curdevnode = curdevnode->next; } } } ithread_mutex_unlock(&DeviceListMutex); return TV_SUCCESS; } /******************************************************************************** * TvCtrlPointRemoveAll * * Description: * Remove all devices from the global device list. * * Parameters: * None * ********************************************************************************/ int TvCtrlPointRemoveAll(void) { struct TvDeviceNode *curdevnode, *next; ithread_mutex_lock(&DeviceListMutex); curdevnode = GlobalDeviceList; GlobalDeviceList = NULL; while (curdevnode) { next = curdevnode->next; TvCtrlPointDeleteNode(curdevnode); curdevnode = next; } ithread_mutex_unlock(&DeviceListMutex); return TV_SUCCESS; } /******************************************************************************** * TvCtrlPointRefresh * * Description: * Clear the current global device list and issue new search * requests to build it up again from scratch. * * Parameters: * None * ********************************************************************************/ int TvCtrlPointRefresh(void) { int rc; TvCtrlPointRemoveAll(); /* Search for all devices of type tvdevice version 1, * waiting for up to 5 seconds for the response */ rc = UpnpSearchAsync(ctrlpt_handle, 5, TvDeviceType, NULL); if (UPNP_E_SUCCESS != rc) { SampleUtil_Print("Error sending search request%d\n", rc); return TV_ERROR; } return TV_SUCCESS; } /******************************************************************************** * TvCtrlPointGetVar * * Description: * Send a GetVar request to the specified service of a device. * * Parameters: * service -- The service * devnum -- The number of the device (order in the list, * starting with 1) * varname -- The name of the variable to request. * ********************************************************************************/ int TvCtrlPointGetVar(int service, int devnum, const char *varname) { struct TvDeviceNode *devnode; int rc; ithread_mutex_lock(&DeviceListMutex); rc = TvCtrlPointGetDevice(devnum, &devnode); if (TV_SUCCESS == rc) { rc = UpnpGetServiceVarStatusAsync( ctrlpt_handle, devnode->device.TvService[service].ControlURL, varname, TvCtrlPointCallbackEventHandler, NULL); if (rc != UPNP_E_SUCCESS) { SampleUtil_Print( "Error in UpnpGetServiceVarStatusAsync -- %d\n", rc); rc = TV_ERROR; } } ithread_mutex_unlock(&DeviceListMutex); return rc; } int TvCtrlPointGetPower(int devnum) { return TvCtrlPointGetVar(TV_SERVICE_CONTROL, devnum, "Power"); } int TvCtrlPointGetChannel(int devnum) { return TvCtrlPointGetVar(TV_SERVICE_CONTROL, devnum, "Channel"); } int TvCtrlPointGetVolume(int devnum) { return TvCtrlPointGetVar(TV_SERVICE_CONTROL, devnum, "Volume"); } int TvCtrlPointGetColor(int devnum) { return TvCtrlPointGetVar(TV_SERVICE_PICTURE, devnum, "Color"); } int TvCtrlPointGetTint(int devnum) { return TvCtrlPointGetVar(TV_SERVICE_PICTURE, devnum, "Tint"); } int TvCtrlPointGetContrast(int devnum) { return TvCtrlPointGetVar(TV_SERVICE_PICTURE, devnum, "Contrast"); } int TvCtrlPointGetBrightness(int devnum) { return TvCtrlPointGetVar(TV_SERVICE_PICTURE, devnum, "Brightness"); } /******************************************************************************** * TvCtrlPointSendAction * * Description: * Send an Action request to the specified service of a device. * * Parameters: * service -- The service * devnum -- The number of the device (order in the list, * starting with 1) * actionname -- The name of the action. * param_name -- An array of parameter names * param_val -- The corresponding parameter values * param_count -- The number of parameters * ********************************************************************************/ int TvCtrlPointSendAction( int service, int devnum, const char *actionname, const char **param_name, char **param_val, int param_count) { struct TvDeviceNode *devnode; IXML_Document *actionNode = NULL; int rc = TV_SUCCESS; int param; ithread_mutex_lock(&DeviceListMutex); rc = TvCtrlPointGetDevice(devnum, &devnode); if (TV_SUCCESS == rc) { if (0 == param_count) { actionNode = UpnpMakeAction(actionname, TvServiceType[service], 0, NULL); } else { for (param = 0; param < param_count; param++) { if (UpnpAddToAction (&actionNode, actionname, TvServiceType[service], param_name[param], param_val[param]) != UPNP_E_SUCCESS) { SampleUtil_Print ("ERROR: TvCtrlPointSendAction: Trying to add action param\n"); /*return -1; // TBD - BAD! leaves mutex locked */ } } } rc = UpnpSendActionAsync(ctrlpt_handle, devnode->device. TvService[service].ControlURL, TvServiceType[service], NULL, actionNode, TvCtrlPointCallbackEventHandler, NULL); if (rc != UPNP_E_SUCCESS) { SampleUtil_Print("Error in UpnpSendActionAsync -- %d\n", rc); rc = TV_ERROR; } } ithread_mutex_unlock(&DeviceListMutex); if (actionNode) ixmlDocument_free(actionNode); return rc; } /******************************************************************************** * TvCtrlPointSendActionNumericArg * * Description:Send an action with one argument to a device in the global device list. * * Parameters: * devnum -- The number of the device (order in the list, starting with 1) * service -- TV_SERVICE_CONTROL or TV_SERVICE_PICTURE * actionName -- The device action, i.e., "SetChannel" * paramName -- The name of the parameter that is being passed * paramValue -- Actual value of the parameter being passed * ********************************************************************************/ int TvCtrlPointSendActionNumericArg(int devnum, int service, const char *actionName, const char *paramName, int paramValue) { char param_val_a[50]; char *param_val = param_val_a; sprintf(param_val_a, "%d", paramValue); return TvCtrlPointSendAction( service, devnum, actionName, ¶mName, ¶m_val, 1); } int TvCtrlPointSendPowerOn(int devnum) { return TvCtrlPointSendAction( TV_SERVICE_CONTROL, devnum, "PowerOn", NULL, NULL, 0); } int TvCtrlPointSendPowerOff(int devnum) { return TvCtrlPointSendAction( TV_SERVICE_CONTROL, devnum, "PowerOff", NULL, NULL, 0); } int TvCtrlPointSendSetChannel(int devnum, int channel) { return TvCtrlPointSendActionNumericArg( devnum, TV_SERVICE_CONTROL, "SetChannel", "Channel", channel); } int TvCtrlPointSendSetVolume(int devnum, int volume) { return TvCtrlPointSendActionNumericArg( devnum, TV_SERVICE_CONTROL, "SetVolume", "Volume", volume); } int TvCtrlPointSendSetColor(int devnum, int color) { return TvCtrlPointSendActionNumericArg( devnum, TV_SERVICE_PICTURE, "SetColor", "Color", color); } int TvCtrlPointSendSetTint(int devnum, int tint) { return TvCtrlPointSendActionNumericArg( devnum, TV_SERVICE_PICTURE, "SetTint", "Tint", tint); } int TvCtrlPointSendSetContrast(int devnum, int contrast) { return TvCtrlPointSendActionNumericArg( devnum, TV_SERVICE_PICTURE, "SetContrast", "Contrast", contrast); } int TvCtrlPointSendSetBrightness(int devnum, int brightness) { return TvCtrlPointSendActionNumericArg( devnum, TV_SERVICE_PICTURE, "SetBrightness", "Brightness", brightness); } /******************************************************************************** * TvCtrlPointGetDevice * * Description: * Given a list number, returns the pointer to the device * node at that position in the global device list. Note * that this function is not thread safe. It must be called * from a function that has locked the global device list. * * Parameters: * devnum -- The number of the device (order in the list, * starting with 1) * devnode -- The output device node pointer * ********************************************************************************/ int TvCtrlPointGetDevice(int devnum, struct TvDeviceNode **devnode) { int count = devnum; struct TvDeviceNode *tmpdevnode = NULL; if (count) tmpdevnode = GlobalDeviceList; while (--count && tmpdevnode) { tmpdevnode = tmpdevnode->next; } if (!tmpdevnode) { SampleUtil_Print("Error finding TvDevice number -- %d\n", devnum); return TV_ERROR; } *devnode = tmpdevnode; return TV_SUCCESS; } /******************************************************************************** * TvCtrlPointPrintList * * Description: * Print the universal device names for each device in the global device list * * Parameters: * None * ********************************************************************************/ int TvCtrlPointPrintList() { struct TvDeviceNode *tmpdevnode; int i = 0; ithread_mutex_lock(&DeviceListMutex); SampleUtil_Print("TvCtrlPointPrintList:\n"); tmpdevnode = GlobalDeviceList; while (tmpdevnode) { SampleUtil_Print(" %3d -- %s\n", ++i, tmpdevnode->device.UDN); tmpdevnode = tmpdevnode->next; } SampleUtil_Print("\n"); ithread_mutex_unlock(&DeviceListMutex); return TV_SUCCESS; } /******************************************************************************** * TvCtrlPointPrintDevice * * Description: * Print the identifiers and state table for a device from * the global device list. * * Parameters: * devnum -- The number of the device (order in the list, * starting with 1) * ********************************************************************************/ int TvCtrlPointPrintDevice(int devnum) { struct TvDeviceNode *tmpdevnode; int i = 0, service, var; char spacer[15]; if (devnum <= 0) { SampleUtil_Print( "Error in TvCtrlPointPrintDevice: " "invalid devnum = %d\n", devnum); return TV_ERROR; } ithread_mutex_lock(&DeviceListMutex); SampleUtil_Print("TvCtrlPointPrintDevice:\n"); tmpdevnode = GlobalDeviceList; while (tmpdevnode) { i++; if (i == devnum) break; tmpdevnode = tmpdevnode->next; } if (!tmpdevnode) { SampleUtil_Print( "Error in TvCtrlPointPrintDevice: " "invalid devnum = %d -- actual device count = %d\n", devnum, i); } else { SampleUtil_Print( " TvDevice -- %d\n" " | \n" " +- UDN = %s\n" " +- DescDocURL = %s\n" " +- FriendlyName = %s\n" " +- PresURL = %s\n" " +- Adver. TimeOut = %d\n", devnum, tmpdevnode->device.UDN, tmpdevnode->device.DescDocURL, tmpdevnode->device.FriendlyName, tmpdevnode->device.PresURL, tmpdevnode->device.AdvrTimeOut); for (service = 0; service < TV_SERVICE_SERVCOUNT; service++) { if (service < TV_SERVICE_SERVCOUNT - 1) sprintf(spacer, " | "); else sprintf(spacer, " "); SampleUtil_Print( " | \n" " +- Tv %s Service\n" "%s+- ServiceId = %s\n" "%s+- ServiceType = %s\n" "%s+- EventURL = %s\n" "%s+- ControlURL = %s\n" "%s+- SID = %s\n" "%s+- ServiceStateTable\n", TvServiceName[service], spacer, tmpdevnode->device.TvService[service].ServiceId, spacer, tmpdevnode->device.TvService[service].ServiceType, spacer, tmpdevnode->device.TvService[service].EventURL, spacer, tmpdevnode->device.TvService[service].ControlURL, spacer, tmpdevnode->device.TvService[service].SID, spacer); for (var = 0; var < TvVarCount[service]; var++) { SampleUtil_Print( "%s +- %-10s = %s\n", spacer, TvVarName[service][var], tmpdevnode->device.TvService[service].VariableStrVal[var]); } } } SampleUtil_Print("\n"); ithread_mutex_unlock(&DeviceListMutex); return TV_SUCCESS; } /******************************************************************************** * TvCtrlPointAddDevice * * Description: * If the device is not already included in the global device list, * add it. Otherwise, update its advertisement expiration timeout. * * Parameters: * DescDoc -- The description document for the device * location -- The location of the description document URL * expires -- The expiration time for this advertisement * ********************************************************************************/ void TvCtrlPointAddDevice( IXML_Document *DescDoc, const char *location, int expires) { char *deviceType = NULL; char *friendlyName = NULL; char presURL[200]; char *baseURL = NULL; char *relURL = NULL; char *UDN = NULL; char *serviceId[TV_SERVICE_SERVCOUNT] = { NULL, NULL }; char *eventURL[TV_SERVICE_SERVCOUNT] = { NULL, NULL }; char *controlURL[TV_SERVICE_SERVCOUNT] = { NULL, NULL }; Upnp_SID eventSID[TV_SERVICE_SERVCOUNT]; int TimeOut[TV_SERVICE_SERVCOUNT] = { default_timeout, default_timeout }; struct TvDeviceNode *deviceNode; struct TvDeviceNode *tmpdevnode; int ret = 1; int found = 0; int service; int var; ithread_mutex_lock(&DeviceListMutex); /* Read key elements from description document */ UDN = SampleUtil_GetFirstDocumentItem(DescDoc, "UDN"); deviceType = SampleUtil_GetFirstDocumentItem(DescDoc, "deviceType"); friendlyName = SampleUtil_GetFirstDocumentItem(DescDoc, "friendlyName"); baseURL = SampleUtil_GetFirstDocumentItem(DescDoc, "URLBase"); relURL = SampleUtil_GetFirstDocumentItem(DescDoc, "presentationURL"); ret = UpnpResolveURL((baseURL ? baseURL : location), relURL, presURL); if (UPNP_E_SUCCESS != ret) SampleUtil_Print("Error generating presURL from %s + %s\n", baseURL, relURL); if (strcmp(deviceType, TvDeviceType) == 0) { SampleUtil_Print("Found Tv device\n"); /* Check if this device is already in the list */ tmpdevnode = GlobalDeviceList; while (tmpdevnode) { if (strcmp(tmpdevnode->device.UDN, UDN) == 0) { found = 1; break; } tmpdevnode = tmpdevnode->next; } if (found) { /* The device is already there, so just update */ /* the advertisement timeout field */ tmpdevnode->device.AdvrTimeOut = expires; } else { for (service = 0; service < TV_SERVICE_SERVCOUNT; service++) { if (SampleUtil_FindAndParseService (DescDoc, location, TvServiceType[service], &serviceId[service], &eventURL[service], &controlURL[service])) { SampleUtil_Print ("Subscribing to EventURL %s...\n", eventURL[service]); ret = UpnpSubscribe(ctrlpt_handle, eventURL[service], &TimeOut[service], eventSID[service]); if (ret == UPNP_E_SUCCESS) { SampleUtil_Print ("Subscribed to EventURL with SID=%s\n", eventSID[service]); } else { SampleUtil_Print ("Error Subscribing to EventURL -- %d\n", ret); strcpy(eventSID[service], ""); } } else { SampleUtil_Print ("Error: Could not find Service: %s\n", TvServiceType[service]); } } /* Create a new device node */ deviceNode = (struct TvDeviceNode *) malloc(sizeof(struct TvDeviceNode)); strcpy(deviceNode->device.UDN, UDN); strcpy(deviceNode->device.DescDocURL, location); strcpy(deviceNode->device.FriendlyName, friendlyName); strcpy(deviceNode->device.PresURL, presURL); deviceNode->device.AdvrTimeOut = expires; for (service = 0; service < TV_SERVICE_SERVCOUNT; service++) { if (serviceId[service] == NULL) { /* not found */ continue; } strcpy(deviceNode->device.TvService[service]. ServiceId, serviceId[service]); strcpy(deviceNode->device.TvService[service]. ServiceType, TvServiceType[service]); strcpy(deviceNode->device.TvService[service]. ControlURL, controlURL[service]); strcpy(deviceNode->device.TvService[service]. EventURL, eventURL[service]); strcpy(deviceNode->device.TvService[service]. SID, eventSID[service]); for (var = 0; var < TvVarCount[service]; var++) { deviceNode->device. TvService[service].VariableStrVal [var] = (char *)malloc(TV_MAX_VAL_LEN); strcpy(deviceNode->device. TvService[service].VariableStrVal [var], ""); } } deviceNode->next = NULL; /* Insert the new device node in the list */ if ((tmpdevnode = GlobalDeviceList)) { while (tmpdevnode) { if (tmpdevnode->next) { tmpdevnode = tmpdevnode->next; } else { tmpdevnode->next = deviceNode; break; } } } else { GlobalDeviceList = deviceNode; } /*Notify New Device Added */ SampleUtil_StateUpdate(NULL, NULL, deviceNode->device.UDN, DEVICE_ADDED); } } ithread_mutex_unlock(&DeviceListMutex); if (deviceType) free(deviceType); if (friendlyName) free(friendlyName); if (UDN) free(UDN); if (baseURL) free(baseURL); if (relURL) free(relURL); for (service = 0; service < TV_SERVICE_SERVCOUNT; service++) { if (serviceId[service]) free(serviceId[service]); if (controlURL[service]) free(controlURL[service]); if (eventURL[service]) free(eventURL[service]); } } void TvStateUpdate(char *UDN, int Service, IXML_Document *ChangedVariables, char **State) { IXML_NodeList *properties; IXML_NodeList *variables; IXML_Element *property; IXML_Element *variable; long unsigned int length; long unsigned int length1; long unsigned int i; int j; char *tmpstate = NULL; SampleUtil_Print("Tv State Update (service %d):\n", Service); /* Find all of the e:property tags in the document */ properties = ixmlDocument_getElementsByTagName(ChangedVariables, "e:property"); if (properties) { length = ixmlNodeList_length(properties); for (i = 0; i < length; i++) { /* Loop through each property change found */ property = (IXML_Element *)ixmlNodeList_item( properties, i); /* For each variable name in the state table, * check if this is a corresponding property change */ for (j = 0; j < TvVarCount[Service]; j++) { variables = ixmlElement_getElementsByTagName( property, TvVarName[Service][j]); /* If a match is found, extract * the value, and update the state table */ if (variables) { length1 = ixmlNodeList_length(variables); if (length1) { variable = (IXML_Element *) ixmlNodeList_item(variables, 0); tmpstate = SampleUtil_GetElementValue(variable); if (tmpstate) { strcpy(State[j], tmpstate); SampleUtil_Print( " Variable Name: %s New Value:'%s'\n", TvVarName[Service][j], State[j]); } if (tmpstate) free(tmpstate); tmpstate = NULL; } ixmlNodeList_free(variables); variables = NULL; } } } ixmlNodeList_free(properties); } return; UDN = UDN; } /******************************************************************************** * TvCtrlPointHandleEvent * * Description: * Handle a UPnP event that was received. Process the event and update * the appropriate service state table. * * Parameters: * sid -- The subscription id for the event * eventkey -- The eventkey number for the event * changes -- The DOM document representing the changes * ********************************************************************************/ void TvCtrlPointHandleEvent( const char *sid, int evntkey, IXML_Document *changes) { struct TvDeviceNode *tmpdevnode; int service; ithread_mutex_lock(&DeviceListMutex); tmpdevnode = GlobalDeviceList; while (tmpdevnode) { for (service = 0; service < TV_SERVICE_SERVCOUNT; ++service) { if (strcmp(tmpdevnode->device.TvService[service].SID, sid) == 0) { SampleUtil_Print("Received Tv %s Event: %d for SID %s\n", TvServiceName[service], evntkey, sid); TvStateUpdate( tmpdevnode->device.UDN, service, changes, (char **)&tmpdevnode->device.TvService[service].VariableStrVal); break; } } tmpdevnode = tmpdevnode->next; } ithread_mutex_unlock(&DeviceListMutex); } /******************************************************************************** * TvCtrlPointHandleSubscribeUpdate * * Description: * Handle a UPnP subscription update that was received. Find the * service the update belongs to, and update its subscription * timeout. * * Parameters: * eventURL -- The event URL for the subscription * sid -- The subscription id for the subscription * timeout -- The new timeout for the subscription * ********************************************************************************/ void TvCtrlPointHandleSubscribeUpdate( const char *eventURL, const Upnp_SID sid, int timeout) { struct TvDeviceNode *tmpdevnode; int service; ithread_mutex_lock(&DeviceListMutex); tmpdevnode = GlobalDeviceList; while (tmpdevnode) { for (service = 0; service < TV_SERVICE_SERVCOUNT; service++) { if (strcmp (tmpdevnode->device.TvService[service].EventURL, eventURL) == 0) { SampleUtil_Print ("Received Tv %s Event Renewal for eventURL %s\n", TvServiceName[service], eventURL); strcpy(tmpdevnode->device.TvService[service]. SID, sid); break; } } tmpdevnode = tmpdevnode->next; } ithread_mutex_unlock(&DeviceListMutex); return; timeout = timeout; } void TvCtrlPointHandleGetVar( const char *controlURL, const char *varName, const DOMString varValue) { struct TvDeviceNode *tmpdevnode; int service; ithread_mutex_lock(&DeviceListMutex); tmpdevnode = GlobalDeviceList; while (tmpdevnode) { for (service = 0; service < TV_SERVICE_SERVCOUNT; service++) { if (strcmp (tmpdevnode->device.TvService[service].ControlURL, controlURL) == 0) { SampleUtil_StateUpdate(varName, varValue, tmpdevnode->device.UDN, GET_VAR_COMPLETE); break; } } tmpdevnode = tmpdevnode->next; } ithread_mutex_unlock(&DeviceListMutex); } /******************************************************************************** * TvCtrlPointCallbackEventHandler * * Description: * The callback handler registered with the SDK while registering * the control point. Detects the type of callback, and passes the * request on to the appropriate function. * * Parameters: * EventType -- The type of callback event * Event -- Data structure containing event data * Cookie -- Optional data specified during callback registration * ********************************************************************************/ int TvCtrlPointCallbackEventHandler(Upnp_EventType EventType, const void *Event, void *Cookie) { int errCode = 0; SampleUtil_PrintEvent(EventType, Event); switch ( EventType ) { /* SSDP Stuff */ case UPNP_DISCOVERY_ADVERTISEMENT_ALIVE: case UPNP_DISCOVERY_SEARCH_RESULT: { const UpnpDiscovery *d_event = (UpnpDiscovery *)Event; IXML_Document *DescDoc = NULL; const char *location = NULL; int errCode = UpnpDiscovery_get_ErrCode(d_event); if (errCode != UPNP_E_SUCCESS) { SampleUtil_Print( "Error in Discovery Callback -- %d\n", errCode); } location = UpnpString_get_String(UpnpDiscovery_get_Location(d_event)); errCode = UpnpDownloadXmlDoc(location, &DescDoc); if (errCode != UPNP_E_SUCCESS) { SampleUtil_Print( "Error obtaining device description from %s -- error = %d\n", location, errCode); } else { TvCtrlPointAddDevice( DescDoc, location, UpnpDiscovery_get_Expires(d_event)); } if (DescDoc) { ixmlDocument_free(DescDoc); } TvCtrlPointPrintList(); break; } case UPNP_DISCOVERY_SEARCH_TIMEOUT: /* Nothing to do here... */ break; case UPNP_DISCOVERY_ADVERTISEMENT_BYEBYE: { UpnpDiscovery *d_event = (UpnpDiscovery *)Event; int errCode = UpnpDiscovery_get_ErrCode(d_event); const char *deviceId = UpnpString_get_String( UpnpDiscovery_get_DeviceID(d_event)); if (errCode != UPNP_E_SUCCESS) { SampleUtil_Print( "Error in Discovery ByeBye Callback -- %d\n", errCode); } SampleUtil_Print("Received ByeBye for Device: %s\n", deviceId); TvCtrlPointRemoveDevice(deviceId); SampleUtil_Print("After byebye:\n"); TvCtrlPointPrintList(); break; } /* SOAP Stuff */ case UPNP_CONTROL_ACTION_COMPLETE: { UpnpActionComplete *a_event = (UpnpActionComplete *)Event; int errCode = UpnpActionComplete_get_ErrCode(a_event); if (errCode != UPNP_E_SUCCESS) { SampleUtil_Print("Error in Action Complete Callback -- %d\n", errCode); } /* No need for any processing here, just print out results. * Service state table updates are handled by events. */ break; } case UPNP_CONTROL_GET_VAR_COMPLETE: { UpnpStateVarComplete *sv_event = (UpnpStateVarComplete *)Event; int errCode = UpnpStateVarComplete_get_ErrCode(sv_event); if (errCode != UPNP_E_SUCCESS) { SampleUtil_Print( "Error in Get Var Complete Callback -- %d\n", errCode); } else { TvCtrlPointHandleGetVar( UpnpString_get_String(UpnpStateVarComplete_get_CtrlUrl(sv_event)), UpnpString_get_String(UpnpStateVarComplete_get_StateVarName(sv_event)), UpnpStateVarComplete_get_CurrentVal(sv_event)); } break; } /* GENA Stuff */ case UPNP_EVENT_RECEIVED: { UpnpEvent *e_event = (UpnpEvent *)Event; TvCtrlPointHandleEvent( UpnpEvent_get_SID_cstr(e_event), UpnpEvent_get_EventKey(e_event), UpnpEvent_get_ChangedVariables(e_event)); break; } case UPNP_EVENT_SUBSCRIBE_COMPLETE: case UPNP_EVENT_UNSUBSCRIBE_COMPLETE: case UPNP_EVENT_RENEWAL_COMPLETE: { UpnpEventSubscribe *es_event = (UpnpEventSubscribe *)Event; errCode = UpnpEventSubscribe_get_ErrCode(es_event); if (errCode != UPNP_E_SUCCESS) { SampleUtil_Print( "Error in Event Subscribe Callback -- %d\n", errCode); } else { TvCtrlPointHandleSubscribeUpdate( UpnpString_get_String(UpnpEventSubscribe_get_PublisherUrl(es_event)), UpnpString_get_String(UpnpEventSubscribe_get_SID(es_event)), UpnpEventSubscribe_get_TimeOut(es_event)); } break; } case UPNP_EVENT_AUTORENEWAL_FAILED: case UPNP_EVENT_SUBSCRIPTION_EXPIRED: { UpnpEventSubscribe *es_event = (UpnpEventSubscribe *)Event; int TimeOut = default_timeout; Upnp_SID newSID; errCode = UpnpSubscribe( ctrlpt_handle, UpnpString_get_String(UpnpEventSubscribe_get_PublisherUrl(es_event)), &TimeOut, newSID); if (errCode == UPNP_E_SUCCESS) { SampleUtil_Print("Subscribed to EventURL with SID=%s\n", newSID); TvCtrlPointHandleSubscribeUpdate( UpnpString_get_String(UpnpEventSubscribe_get_PublisherUrl(es_event)), newSID, TimeOut); } else { SampleUtil_Print("Error Subscribing to EventURL -- %d\n", errCode); } break; } /* ignore these cases, since this is not a device */ case UPNP_EVENT_SUBSCRIPTION_REQUEST: case UPNP_CONTROL_GET_VAR_REQUEST: case UPNP_CONTROL_ACTION_REQUEST: break; } return 0; Cookie = Cookie; } void TvCtrlPointVerifyTimeouts(int incr) { struct TvDeviceNode *prevdevnode; struct TvDeviceNode *curdevnode; int ret; ithread_mutex_lock(&DeviceListMutex); prevdevnode = NULL; curdevnode = GlobalDeviceList; while (curdevnode) { curdevnode->device.AdvrTimeOut -= incr; /*SampleUtil_Print("Advertisement Timeout: %d\n", curdevnode->device.AdvrTimeOut); */ if (curdevnode->device.AdvrTimeOut <= 0) { /* This advertisement has expired, so we should remove the device * from the list */ if (GlobalDeviceList == curdevnode) GlobalDeviceList = curdevnode->next; else prevdevnode->next = curdevnode->next; TvCtrlPointDeleteNode(curdevnode); if (prevdevnode) curdevnode = prevdevnode->next; else curdevnode = GlobalDeviceList; } else { if (curdevnode->device.AdvrTimeOut < 2 * incr) { /* This advertisement is about to expire, so * send out a search request for this device * UDN to try to renew */ ret = UpnpSearchAsync(ctrlpt_handle, incr, curdevnode->device.UDN, NULL); if (ret != UPNP_E_SUCCESS) SampleUtil_Print ("Error sending search request for Device UDN: %s -- err = %d\n", curdevnode->device.UDN, ret); } prevdevnode = curdevnode; curdevnode = curdevnode->next; } } ithread_mutex_unlock(&DeviceListMutex); } /*! * \brief Function that runs in its own thread and monitors advertisement * and subscription timeouts for devices in the global device list. */ static int TvCtrlPointTimerLoopRun = 1; void *TvCtrlPointTimerLoop(void *args) { /* how often to verify the timeouts, in seconds */ int incr = 30; while (TvCtrlPointTimerLoopRun) { isleep((unsigned int)incr); TvCtrlPointVerifyTimeouts(incr); } return NULL; args = args; } /*! * \brief Call this function to initialize the UPnP library and start the TV * Control Point. This function creates a timer thread and provides a * callback handler to process any UPnP events that are received. * * \return TV_SUCCESS if everything went well, else TV_ERROR. */ int TvCtrlPointStart(print_string printFunctionPtr, state_update updateFunctionPtr, int combo) { ithread_t timer_thread; int rc; unsigned short port = 0; char *ip_address = NULL; SampleUtil_Initialize(printFunctionPtr); SampleUtil_RegisterUpdateFunction(updateFunctionPtr); ithread_mutex_init(&DeviceListMutex, 0); SampleUtil_Print("Initializing UPnP Sdk with\n" "\tipaddress = %s port = %u\n", ip_address ? ip_address : "{NULL}", port); rc = UpnpInit(ip_address, port); if (rc != UPNP_E_SUCCESS) { SampleUtil_Print("WinCEStart: UpnpInit() Error: %d\n", rc); if (!combo) { UpnpFinish(); return TV_ERROR; } } if (!ip_address) { ip_address = UpnpGetServerIpAddress(); } if (!port) { port = UpnpGetServerPort(); } SampleUtil_Print("UPnP Initialized\n" "\tipaddress = %s port = %u\n", ip_address ? ip_address : "{NULL}", port); SampleUtil_Print("Registering Control Point\n"); rc = UpnpRegisterClient(TvCtrlPointCallbackEventHandler, &ctrlpt_handle, &ctrlpt_handle); if (rc != UPNP_E_SUCCESS) { SampleUtil_Print("Error registering CP: %d\n", rc); UpnpFinish(); return TV_ERROR; } SampleUtil_Print("Control Point Registered\n"); TvCtrlPointRefresh(); /* start a timer thread */ ithread_create(&timer_thread, NULL, TvCtrlPointTimerLoop, NULL); ithread_detach(timer_thread); return TV_SUCCESS; } int TvCtrlPointStop(void) { TvCtrlPointTimerLoopRun = 0; TvCtrlPointRemoveAll(); UpnpUnRegisterClient( ctrlpt_handle ); UpnpFinish(); SampleUtil_Finish(); return TV_SUCCESS; } void TvCtrlPointPrintShortHelp(void) { SampleUtil_Print( "Commands:\n" " Help\n" " HelpFull\n" " ListDev\n" " Refresh\n" " PrintDev \n" " PowerOn \n" " PowerOff \n" " SetChannel \n" " SetVolume \n" " SetColor \n" " SetTint \n" " SetContrast \n" " SetBrightness \n" " CtrlAction \n" " PictAction \n" " CtrlGetVar \n" " PictGetVar \n" " Exit\n"); } void TvCtrlPointPrintLongHelp(void) { SampleUtil_Print( "\n" "******************************\n" "* TV Control Point Help Info *\n" "******************************\n" "\n" "This sample control point application automatically searches\n" "for and subscribes to the services of television device emulator\n" "devices, described in the tvdevicedesc.xml description document.\n" "It also registers itself as a tv device.\n" "\n" "Commands:\n" " Help\n" " Print this help info.\n" " ListDev\n" " Print the current list of TV Device Emulators that this\n" " control point is aware of. Each device is preceded by a\n" " device number which corresponds to the devnum argument of\n" " commands listed below.\n" " Refresh\n" " Delete all of the devices from the device list and issue new\n" " search request to rebuild the list from scratch.\n" " PrintDev \n" " Print the state table for the device .\n" " e.g., 'PrintDev 1' prints the state table for the first\n" " device in the device list.\n" " PowerOn \n" " Sends the PowerOn action to the Control Service of\n" " device .\n" " PowerOff \n" " Sends the PowerOff action to the Control Service of\n" " device .\n" " SetChannel \n" " Sends the SetChannel action to the Control Service of\n" " device , requesting the channel to be changed\n" " to .\n" " SetVolume \n" " Sends the SetVolume action to the Control Service of\n" " device , requesting the volume to be changed\n" " to .\n" " SetColor \n" " Sends the SetColor action to the Control Service of\n" " device , requesting the color to be changed\n" " to .\n" " SetTint \n" " Sends the SetTint action to the Control Service of\n" " device , requesting the tint to be changed\n" " to .\n" " SetContrast \n" " Sends the SetContrast action to the Control Service of\n" " device , requesting the contrast to be changed\n" " to .\n" " SetBrightness \n" " Sends the SetBrightness action to the Control Service of\n" " device , requesting the brightness to be changed\n" " to .\n" " CtrlAction \n" " Sends an action request specified by the string \n" " to the Control Service of device . This command\n" " only works for actions that have no arguments.\n" " (e.g., \"CtrlAction 1 IncreaseChannel\")\n" " PictAction \n" " Sends an action request specified by the string \n" " to the Picture Service of device . This command\n" " only works for actions that have no arguments.\n" " (e.g., \"PictAction 1 DecreaseContrast\")\n" " CtrlGetVar \n" " Requests the value of a variable specified by the string \n" " from the Control Service of device .\n" " (e.g., \"CtrlGetVar 1 Volume\")\n" " PictGetVar \n" " Requests the value of a variable specified by the string \n" " from the Picture Service of device .\n" " (e.g., \"PictGetVar 1 Tint\")\n" " Exit\n" " Exits the control point application.\n"); } /*! Tags for valid commands issued at the command prompt. */ enum cmdloop_tvcmds { PRTHELP = 0, PRTFULLHELP, POWON, POWOFF, SETCHAN, SETVOL, SETCOL, SETTINT, SETCONT, SETBRT, CTRLACTION, PICTACTION, CTRLGETVAR, PICTGETVAR, PRTDEV, LSTDEV, REFRESH, EXITCMD }; /*! Data structure for parsing commands from the command line. */ struct cmdloop_commands { /* the string */ const char *str; /* the command */ int cmdnum; /* the number of arguments */ int numargs; /* the args */ const char *args; } cmdloop_commands; /*! Mappings between command text names, command tag, * and required command arguments for command line * commands */ static struct cmdloop_commands cmdloop_cmdlist[] = { {"Help", PRTHELP, 1, ""}, {"HelpFull", PRTFULLHELP, 1, ""}, {"ListDev", LSTDEV, 1, ""}, {"Refresh", REFRESH, 1, ""}, {"PrintDev", PRTDEV, 2, ""}, {"PowerOn", POWON, 2, ""}, {"PowerOff", POWOFF, 2, ""}, {"SetChannel", SETCHAN, 3, " "}, {"SetVolume", SETVOL, 3, " "}, {"SetColor", SETCOL, 3, " "}, {"SetTint", SETTINT, 3, " "}, {"SetContrast", SETCONT, 3, " "}, {"SetBrightness", SETBRT, 3, " "}, {"CtrlAction", CTRLACTION, 2, " "}, {"PictAction", PICTACTION, 2, " "}, {"CtrlGetVar", CTRLGETVAR, 2, " "}, {"PictGetVar", PICTGETVAR, 2, " "}, {"Exit", EXITCMD, 1, ""} }; void TvCtrlPointPrintCommands(void) { int i; int numofcmds = (sizeof cmdloop_cmdlist) / sizeof (cmdloop_commands); SampleUtil_Print("Valid Commands:\n"); for (i = 0; i < numofcmds; ++i) { SampleUtil_Print(" %-14s %s\n", cmdloop_cmdlist[i].str, cmdloop_cmdlist[i].args); } SampleUtil_Print("\n"); } void *TvCtrlPointCommandLoop(void *args) { char cmdline[100]; while (1) { SampleUtil_Print("\n>> "); char *s = fgets(cmdline, 100, stdin); if (!s) break; TvCtrlPointProcessCommand(cmdline); } return NULL; args = args; } int TvCtrlPointProcessCommand(char *cmdline) { char cmd[100]; char strarg[100]; int arg_val_err = -99999; int arg1 = arg_val_err; int arg2 = arg_val_err; int cmdnum = -1; int numofcmds = (sizeof cmdloop_cmdlist) / sizeof (cmdloop_commands); int cmdfound = 0; int i; int rc; int invalidargs = 0; int validargs; validargs = sscanf(cmdline, "%s %d %d", cmd, &arg1, &arg2); for (i = 0; i < numofcmds; ++i) { if (strcasecmp(cmd, cmdloop_cmdlist[i].str ) == 0) { cmdnum = cmdloop_cmdlist[i].cmdnum; cmdfound++; if (validargs != cmdloop_cmdlist[i].numargs) invalidargs++; break; } } if (!cmdfound) { SampleUtil_Print("Command not found; try 'Help'\n"); return TV_SUCCESS; } if (invalidargs) { SampleUtil_Print("Invalid arguments; try 'Help'\n"); return TV_SUCCESS; } switch (cmdnum) { case PRTHELP: TvCtrlPointPrintShortHelp(); break; case PRTFULLHELP: TvCtrlPointPrintLongHelp(); break; case POWON: TvCtrlPointSendPowerOn(arg1); break; case POWOFF: TvCtrlPointSendPowerOff(arg1); break; case SETCHAN: TvCtrlPointSendSetChannel(arg1, arg2); break; case SETVOL: TvCtrlPointSendSetVolume(arg1, arg2); break; case SETCOL: TvCtrlPointSendSetColor(arg1, arg2); break; case SETTINT: TvCtrlPointSendSetTint(arg1, arg2); break; case SETCONT: TvCtrlPointSendSetContrast(arg1, arg2); break; case SETBRT: TvCtrlPointSendSetBrightness(arg1, arg2); break; case CTRLACTION: /* re-parse commandline since second arg is string. */ validargs = sscanf(cmdline, "%s %d %s", cmd, &arg1, strarg); if (validargs == 3) TvCtrlPointSendAction(TV_SERVICE_CONTROL, arg1, strarg, NULL, NULL, 0); else invalidargs++; break; case PICTACTION: /* re-parse commandline since second arg is string. */ validargs = sscanf(cmdline, "%s %d %s", cmd, &arg1, strarg); if (validargs == 3) TvCtrlPointSendAction(TV_SERVICE_PICTURE, arg1, strarg, NULL, NULL, 0); else invalidargs++; break; case CTRLGETVAR: /* re-parse commandline since second arg is string. */ validargs = sscanf(cmdline, "%s %d %s", cmd, &arg1, strarg); if (validargs == 3) TvCtrlPointGetVar(TV_SERVICE_CONTROL, arg1, strarg); else invalidargs++; break; case PICTGETVAR: /* re-parse commandline since second arg is string. */ validargs = sscanf(cmdline, "%s %d %s", cmd, &arg1, strarg); if (validargs == 3) TvCtrlPointGetVar(TV_SERVICE_PICTURE, arg1, strarg); else invalidargs++; break; case PRTDEV: TvCtrlPointPrintDevice(arg1); break; case LSTDEV: TvCtrlPointPrintList(); break; case REFRESH: TvCtrlPointRefresh(); break; case EXITCMD: rc = TvCtrlPointStop(); exit(rc); break; default: SampleUtil_Print("Command not implemented; see 'Help'\n"); break; } if(invalidargs) SampleUtil_Print("Invalid args in command; see 'Help'\n"); return TV_SUCCESS; } /*! @} Control Point Sample Module */ /*! @} UpnpSamples */ pupnp-release-1.8.0/upnp/sample/common/tv_ctrlpt.h000066400000000000000000000151211303304015100222130ustar00rootroot00000000000000#ifndef UPNP_TV_CTRLPT_H #define UPNP_TV_CTRLPT_H /************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ /*! * \addtogroup UpnpSamples * * @{ * * \name Contro Point Sample API * * @{ * * \file */ #ifdef __cplusplus extern "C" { #endif #include "sample_util.h" #include "upnp.h" #include "UpnpString.h" #include "upnptools.h" #include #include #include #define TV_SERVICE_SERVCOUNT 2 #define TV_SERVICE_CONTROL 0 #define TV_SERVICE_PICTURE 1 #define TV_CONTROL_VARCOUNT 3 #define TV_CONTROL_POWER 0 #define TV_CONTROL_CHANNEL 1 #define TV_CONTROL_VOLUME 2 #define TV_PICTURE_VARCOUNT 4 #define TV_PICTURE_COLOR 0 #define TV_PICTURE_TINT 1 #define TV_PICTURE_CONTRAST 2 #define TV_PICTURE_BRIGHTNESS 3 #define TV_MAX_VAL_LEN 5 #define TV_SUCCESS 0 #define TV_ERROR (-1) #define TV_WARNING 1 /* This should be the maximum VARCOUNT from above */ #define TV_MAXVARS TV_PICTURE_VARCOUNT extern const char *TvServiceName[]; extern const char *TvVarName[TV_SERVICE_SERVCOUNT][TV_MAXVARS]; extern char TvVarCount[]; struct tv_service { char ServiceId[NAME_SIZE]; char ServiceType[NAME_SIZE]; char *VariableStrVal[TV_MAXVARS]; char EventURL[NAME_SIZE]; char ControlURL[NAME_SIZE]; char SID[NAME_SIZE]; }; extern struct TvDeviceNode *GlobalDeviceList; struct TvDevice { char UDN[250]; char DescDocURL[250]; char FriendlyName[250]; char PresURL[250]; int AdvrTimeOut; struct tv_service TvService[TV_SERVICE_SERVCOUNT]; }; struct TvDeviceNode { struct TvDevice device; struct TvDeviceNode *next; }; extern ithread_mutex_t DeviceListMutex; extern UpnpClient_Handle ctrlpt_handle; void TvCtrlPointPrintHelp(void); int TvCtrlPointDeleteNode(struct TvDeviceNode *); int TvCtrlPointRemoveDevice(const char *); int TvCtrlPointRemoveAll(void); int TvCtrlPointRefresh(void); int TvCtrlPointSendAction(int, int, const char *, const char **, char **, int); int TvCtrlPointSendActionNumericArg(int devnum, int service, const char *actionName, const char *paramName, int paramValue); int TvCtrlPointSendPowerOn(int devnum); int TvCtrlPointSendPowerOff(int devnum); int TvCtrlPointSendSetChannel(int, int); int TvCtrlPointSendSetVolume(int, int); int TvCtrlPointSendSetColor(int, int); int TvCtrlPointSendSetTint(int, int); int TvCtrlPointSendSetContrast(int, int); int TvCtrlPointSendSetBrightness(int, int); int TvCtrlPointGetVar(int, int, const char *); int TvCtrlPointGetPower(int devnum); int TvCtrlPointGetChannel(int); int TvCtrlPointGetVolume(int); int TvCtrlPointGetColor(int); int TvCtrlPointGetTint(int); int TvCtrlPointGetContrast(int); int TvCtrlPointGetBrightness(int); int TvCtrlPointGetDevice(int, struct TvDeviceNode **); int TvCtrlPointPrintList(void); int TvCtrlPointPrintDevice(int); void TvCtrlPointAddDevice(IXML_Document *, const char *, int); void TvCtrlPointHandleGetVar(const char *, const char *, const DOMString); /*! * \brief Update a Tv state table. Called when an event is received. * * Note: this function is NOT thread save. It must be called from another * function that has locked the global device list. **/ void TvStateUpdate( /*! [in] The UDN of the parent device. */ char *UDN, /*! [in] The service state table to update. */ int Service, /*! [out] DOM document representing the XML received with the event. */ IXML_Document *ChangedVariables, /*! [out] pointer to the state table for the Tv service to update. */ char **State); void TvCtrlPointHandleEvent(const char *, int, IXML_Document *); void TvCtrlPointHandleSubscribeUpdate(const char *, const Upnp_SID, int); int TvCtrlPointCallbackEventHandler(Upnp_EventType, const void *, void *); /*! * \brief Checks the advertisement each device in the global device list. * * If an advertisement expires, the device is removed from the list. * * If an advertisement is about to expire, a search request is sent for that * device. */ void TvCtrlPointVerifyTimeouts( /*! [in] The increment to subtract from the timeouts each time the * function is called. */ int incr); void TvCtrlPointPrintCommands(void); void* TvCtrlPointCommandLoop(void *); int TvCtrlPointStart(print_string printFunctionPtr, state_update updateFunctionPtr, int combo); int TvCtrlPointStop(void); int TvCtrlPointProcessCommand(char *cmdline); /*! * \brief Print help info for this application. */ void TvCtrlPointPrintShortHelp(void); /*! * \brief Print long help info for this application. */ void TvCtrlPointPrintLongHelp(void); /*! * \briefPrint the list of valid command line commands to the user */ void TvCtrlPointPrintCommands(void); /*! * \brief Function that receives commands from the user at the command prompt * during the lifetime of the device, and calls the appropriate * functions for those commands. */ void *TvCtrlPointCommandLoop(void *args); /*! * \brief */ int TvCtrlPointProcessCommand(char *cmdline); #ifdef __cplusplus }; #endif /*! @} Device Sample */ /*! @} UpnpSamples */ #endif /* UPNP_TV_CTRLPT_H */ pupnp-release-1.8.0/upnp/sample/common/tv_device.c000066400000000000000000001226451303304015100221470ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \addtogroup UpnpSamples * * @{ * * \name Device Sample Module * * @{ * * \file */ #include "tv_device.h" #include #define DEFAULT_WEB_DIR "./web" #define DESC_URL_SIZE 200 /*! Global arrays for storing Tv Control Service variable names, values, * and defaults. */ const char *tvc_varname[] = { "Power", "Channel", "Volume" }; char tvc_varval[TV_CONTROL_VARCOUNT][TV_MAX_VAL_LEN]; const char *tvc_varval_def[] = { "1", "1", "5" }; /*! Global arrays for storing Tv Picture Service variable names, values, * and defaults. */ const char *tvp_varname[] = { "Color", "Tint", "Contrast", "Brightness" }; char tvp_varval[TV_PICTURE_VARCOUNT][TV_MAX_VAL_LEN]; const char *tvp_varval_def[] = { "5", "5", "5", "5" }; /*! The amount of time (in seconds) before advertisements will expire. */ int default_advr_expire = 100; /*! Global structure for storing the state table for this device. */ struct TvService tv_service_table[2]; /*! Device handle supplied by UPnP SDK. */ UpnpDevice_Handle device_handle = -1; /*! Mutex for protecting the global state table data * in a multi-threaded, asynchronous environment. * All functions should lock this mutex before reading * or writing the state table data. */ ithread_mutex_t TVDevMutex; /*! Color constants */ #define MAX_COLOR 10 #define MIN_COLOR 1 /*! Brightness constants */ #define MAX_BRIGHTNESS 10 #define MIN_BRIGHTNESS 1 /*! Power constants */ #define POWER_ON 1 #define POWER_OFF 0 /*! Tint constants */ #define MAX_TINT 10 #define MIN_TINT 1 /*! Volume constants */ #define MAX_VOLUME 10 #define MIN_VOLUME 1 /*! Contrast constants */ #define MAX_CONTRAST 10 #define MIN_CONTRAST 1 /*! Channel constants */ #define MAX_CHANNEL 100 #define MIN_CHANNEL 1 /*! * \brief Initializes the service table for the specified service. */ static int SetServiceTable( /*! [in] one of TV_SERVICE_CONTROL or, TV_SERVICE_PICTURE. */ int serviceType, /*! [in] UDN of device containing service. */ const char *UDN, /*! [in] serviceId of service. */ const char *serviceId, /*! [in] service type (as specified in Description Document) . */ const char *serviceTypeS, /*! [in,out] service containing table to be set. */ struct TvService *out) { int i = 0; strcpy(out->UDN, UDN); strcpy(out->ServiceId, serviceId); strcpy(out->ServiceType, serviceTypeS); switch (serviceType) { case TV_SERVICE_CONTROL: out->VariableCount = TV_CONTROL_VARCOUNT; for (i = 0; i < tv_service_table[TV_SERVICE_CONTROL].VariableCount; i++) { tv_service_table[TV_SERVICE_CONTROL].VariableName[i] = tvc_varname[i]; tv_service_table[TV_SERVICE_CONTROL].VariableStrVal[i] = tvc_varval[i]; strcpy(tv_service_table[TV_SERVICE_CONTROL]. VariableStrVal[i], tvc_varval_def[i]); } break; case TV_SERVICE_PICTURE: out->VariableCount = TV_PICTURE_VARCOUNT; for (i = 0; i < tv_service_table[TV_SERVICE_PICTURE].VariableCount; i++) { tv_service_table[TV_SERVICE_PICTURE].VariableName[i] = tvp_varname[i]; tv_service_table[TV_SERVICE_PICTURE].VariableStrVal[i] = tvp_varval[i]; strcpy(tv_service_table[TV_SERVICE_PICTURE]. VariableStrVal[i], tvp_varval_def[i]); } break; default: assert(0); } return SetActionTable(serviceType, out); } int SetActionTable(int serviceType, struct TvService *out) { if (serviceType == TV_SERVICE_CONTROL) { out->ActionNames[0] = "PowerOn"; out->actions[0] = TvDevicePowerOn; out->ActionNames[1] = "PowerOff"; out->actions[1] = TvDevicePowerOff; out->ActionNames[2] = "SetChannel"; out->actions[2] = TvDeviceSetChannel; out->ActionNames[3] = "IncreaseChannel"; out->actions[3] = TvDeviceIncreaseChannel; out->ActionNames[4] = "DecreaseChannel"; out->actions[4] = TvDeviceDecreaseChannel; out->ActionNames[5] = "SetVolume"; out->actions[5] = TvDeviceSetVolume; out->ActionNames[6] = "IncreaseVolume"; out->actions[6] = TvDeviceIncreaseVolume; out->ActionNames[7] = "DecreaseVolume"; out->actions[7] = TvDeviceDecreaseVolume; out->ActionNames[8] = NULL; return 1; } else if (serviceType == TV_SERVICE_PICTURE) { out->ActionNames[0] = "SetColor"; out->ActionNames[1] = "IncreaseColor"; out->ActionNames[2] = "DecreaseColor"; out->actions[0] = TvDeviceSetColor; out->actions[1] = TvDeviceIncreaseColor; out->actions[2] = TvDeviceDecreaseColor; out->ActionNames[3] = "SetTint"; out->ActionNames[4] = "IncreaseTint"; out->ActionNames[5] = "DecreaseTint"; out->actions[3] = TvDeviceSetTint; out->actions[4] = TvDeviceIncreaseTint; out->actions[5] = TvDeviceDecreaseTint; out->ActionNames[6] = "SetBrightness"; out->ActionNames[7] = "IncreaseBrightness"; out->ActionNames[8] = "DecreaseBrightness"; out->actions[6] = TvDeviceSetBrightness; out->actions[7] = TvDeviceIncreaseBrightness; out->actions[8] = TvDeviceDecreaseBrightness; out->ActionNames[9] = "SetContrast"; out->ActionNames[10] = "IncreaseContrast"; out->ActionNames[11] = "DecreaseContrast"; out->actions[9] = TvDeviceSetContrast; out->actions[10] = TvDeviceIncreaseContrast; out->actions[11] = TvDeviceDecreaseContrast; return 1; } return 0; } int TvDeviceStateTableInit(char *DescDocURL) { IXML_Document *DescDoc = NULL; int ret = UPNP_E_SUCCESS; char *servid_ctrl = NULL; char *evnturl_ctrl = NULL; char *ctrlurl_ctrl = NULL; char *servid_pict = NULL; char *evnturl_pict = NULL; char *ctrlurl_pict = NULL; char *udn = NULL; /*Download description document */ if (UpnpDownloadXmlDoc(DescDocURL, &DescDoc) != UPNP_E_SUCCESS) { SampleUtil_Print("TvDeviceStateTableInit -- Error Parsing %s\n", DescDocURL); ret = UPNP_E_INVALID_DESC; goto error_handler; } udn = SampleUtil_GetFirstDocumentItem(DescDoc, "UDN"); /* Find the Tv Control Service identifiers */ if (!SampleUtil_FindAndParseService(DescDoc, DescDocURL, TvServiceType[TV_SERVICE_CONTROL], &servid_ctrl, &evnturl_ctrl, &ctrlurl_ctrl)) { SampleUtil_Print("TvDeviceStateTableInit -- Error: Could not find Service: %s\n", TvServiceType[TV_SERVICE_CONTROL]); ret = UPNP_E_INVALID_DESC; goto error_handler; } /* set control service table */ SetServiceTable(TV_SERVICE_CONTROL, udn, servid_ctrl, TvServiceType[TV_SERVICE_CONTROL], &tv_service_table[TV_SERVICE_CONTROL]); /* Find the Tv Picture Service identifiers */ if (!SampleUtil_FindAndParseService(DescDoc, DescDocURL, TvServiceType[TV_SERVICE_PICTURE], &servid_pict, &evnturl_pict, &ctrlurl_pict)) { SampleUtil_Print("TvDeviceStateTableInit -- Error: Could not find Service: %s\n", TvServiceType[TV_SERVICE_PICTURE]); ret = UPNP_E_INVALID_DESC; goto error_handler; } /* set picture service table */ SetServiceTable(TV_SERVICE_PICTURE, udn, servid_pict, TvServiceType[TV_SERVICE_PICTURE], &tv_service_table[TV_SERVICE_PICTURE]); error_handler: /* clean up */ if (udn) free(udn); if (servid_ctrl) free(servid_ctrl); if (evnturl_ctrl) free(evnturl_ctrl); if (ctrlurl_ctrl) free(ctrlurl_ctrl); if (servid_pict) free(servid_pict); if (evnturl_pict) free(evnturl_pict); if (ctrlurl_pict) free(ctrlurl_pict); if (DescDoc) ixmlDocument_free(DescDoc); return (ret); } int TvDeviceHandleSubscriptionRequest(const UpnpSubscriptionRequest *sr_event) { unsigned int i = 0; int cmp1 = 0; int cmp2 = 0; const char *l_serviceId = NULL; const char *l_udn = NULL; const char *l_sid = NULL; /* lock state mutex */ ithread_mutex_lock(&TVDevMutex); l_serviceId = UpnpString_get_String(UpnpSubscriptionRequest_get_ServiceId(sr_event)); l_udn = UpnpSubscriptionRequest_get_UDN_cstr(sr_event); l_sid = UpnpSubscriptionRequest_get_SID_cstr(sr_event); for (i = 0; i < TV_SERVICE_SERVCOUNT; ++i) { cmp1 = strcmp(l_udn, tv_service_table[i].UDN); cmp2 = strcmp(l_serviceId, tv_service_table[i].ServiceId); if (cmp1 == 0 && cmp2 == 0) { #if 0 PropSet = NULL; for (j = 0; j < tv_service_table[i].VariableCount; ++j) { /* add each variable to the property set */ /* for initial state dump */ UpnpAddToPropertySet(&PropSet, tv_service_table[i]. VariableName[j], tv_service_table[i]. VariableStrVal[j]); } /* dump initial state */ UpnpAcceptSubscriptionExt(device_handle, l_udn, l_serviceId, PropSet, l_sid); /* free document */ Document_free(PropSet); #endif UpnpAcceptSubscription(device_handle, l_udn, l_serviceId, (const char **) tv_service_table[i].VariableName, (const char **) tv_service_table [i].VariableStrVal, tv_service_table[i]. VariableCount, l_sid); } } ithread_mutex_unlock(&TVDevMutex); return 1; } int TvDeviceHandleGetVarRequest(UpnpStateVarRequest *cgv_event) { unsigned int i = 0; int j = 0; int getvar_succeeded = 0; UpnpStateVarRequest_set_CurrentVal(cgv_event, NULL); ithread_mutex_lock(&TVDevMutex); for (i = 0; i < TV_SERVICE_SERVCOUNT; i++) { /* check udn and service id */ const char *devUDN = UpnpString_get_String(UpnpStateVarRequest_get_DevUDN(cgv_event)); const char *serviceID = UpnpString_get_String(UpnpStateVarRequest_get_ServiceID(cgv_event)); if (strcmp(devUDN, tv_service_table[i].UDN) == 0 && strcmp(serviceID, tv_service_table[i].ServiceId) == 0) { /* check variable name */ for (j = 0; j < tv_service_table[i].VariableCount; j++) { const char *stateVarName = UpnpString_get_String( UpnpStateVarRequest_get_StateVarName(cgv_event)); if (strcmp(stateVarName, tv_service_table[i].VariableName[j]) == 0) { getvar_succeeded = 1; UpnpStateVarRequest_set_CurrentVal(cgv_event, tv_service_table[i].VariableStrVal[j]); break; } } } } if (getvar_succeeded) { UpnpStateVarRequest_set_ErrCode(cgv_event, UPNP_E_SUCCESS); } else { SampleUtil_Print("Error in UPNP_CONTROL_GET_VAR_REQUEST callback:\n" " Unknown variable name = %s\n", UpnpString_get_String(UpnpStateVarRequest_get_StateVarName(cgv_event))); UpnpStateVarRequest_set_ErrCode(cgv_event, 404); UpnpStateVarRequest_strcpy_ErrStr(cgv_event, "Invalid Variable"); } ithread_mutex_unlock(&TVDevMutex); return UpnpStateVarRequest_get_ErrCode(cgv_event) == UPNP_E_SUCCESS; } int TvDeviceHandleActionRequest(UpnpActionRequest *ca_event) { /* Defaults if action not found. */ int action_found = 0; int i = 0; int service = -1; int retCode = 0; const char *errorString = NULL; const char *devUDN = NULL; const char *serviceID = NULL; const char *actionName = NULL; IXML_Document *actionResult = NULL; UpnpActionRequest_set_ErrCode(ca_event, 0); UpnpActionRequest_set_ActionResult(ca_event, NULL); devUDN = UpnpString_get_String(UpnpActionRequest_get_DevUDN( ca_event)); serviceID = UpnpString_get_String(UpnpActionRequest_get_ServiceID( ca_event)); actionName = UpnpString_get_String(UpnpActionRequest_get_ActionName(ca_event)); if (strcmp(devUDN, tv_service_table[TV_SERVICE_CONTROL].UDN) == 0 && strcmp(serviceID, tv_service_table[TV_SERVICE_CONTROL].ServiceId) == 0) { /* Request for action in the TvDevice Control Service. */ service = TV_SERVICE_CONTROL; } else if (strcmp(devUDN, tv_service_table[TV_SERVICE_PICTURE].UDN) == 0 && strcmp(serviceID, tv_service_table[TV_SERVICE_PICTURE].ServiceId) == 0) { /* Request for action in the TvDevice Picture Service. */ service = TV_SERVICE_PICTURE; } /* Find and call appropriate procedure based on action name. * Each action name has an associated procedure stored in the * service table. These are set at initialization. */ for (i = 0; i < TV_MAXACTIONS && tv_service_table[service].ActionNames[i] != NULL; i++) { if (!strcmp(actionName, tv_service_table[service].ActionNames[i])) { if (!strcmp(tv_service_table[TV_SERVICE_CONTROL]. VariableStrVal[TV_CONTROL_POWER], "1") || !strcmp(actionName, "PowerOn")) { retCode = tv_service_table[service].actions[i]( UpnpActionRequest_get_ActionRequest(ca_event), &actionResult, &errorString); UpnpActionRequest_set_ActionResult(ca_event, actionResult); } else { errorString = "Power is Off"; retCode = UPNP_E_INTERNAL_ERROR; } action_found = 1; break; } } if (!action_found) { UpnpActionRequest_set_ActionResult(ca_event, NULL); UpnpActionRequest_strcpy_ErrStr(ca_event, "Invalid Action"); UpnpActionRequest_set_ErrCode(ca_event, 401); } else { if (retCode == UPNP_E_SUCCESS) { UpnpActionRequest_set_ErrCode(ca_event, UPNP_E_SUCCESS); } else { /* copy the error string */ UpnpActionRequest_strcpy_ErrStr(ca_event, errorString); switch (retCode) { case UPNP_E_INVALID_PARAM: UpnpActionRequest_set_ErrCode(ca_event, 402); break; case UPNP_E_INTERNAL_ERROR: default: UpnpActionRequest_set_ErrCode(ca_event, 501); break; } } } return UpnpActionRequest_get_ErrCode(ca_event); } int TvDeviceSetServiceTableVar(unsigned int service, int variable, char *value) { /* IXML_Document *PropSet= NULL; */ if (service >= TV_SERVICE_SERVCOUNT || variable >= tv_service_table[service].VariableCount || strlen(value) >= TV_MAX_VAL_LEN) return (0); ithread_mutex_lock(&TVDevMutex); strcpy(tv_service_table[service].VariableStrVal[variable], value); #if 0 /* Using utility api */ PropSet = UpnpCreatePropertySet(1, tv_service_table[service].VariableName[variable], tv_service_table[service].VariableStrVal[variable]); UpnpNotifyExt(device_handle, tv_service_table[service].UDN, tv_service_table[service].ServiceId, PropSet); /* Free created property set */ Document_free(PropSet); #endif UpnpNotify(device_handle, tv_service_table[service].UDN, tv_service_table[service].ServiceId, (const char **)&tv_service_table[service].VariableName[variable], (const char **)&tv_service_table[service].VariableStrVal[variable], 1); ithread_mutex_unlock(&TVDevMutex); return 1; } /*! * \brief Turn the power on/off, update the TvDevice control service * state table, and notify all subscribed control points of the * updated state. */ static int TvDeviceSetPower( /*! [in] If 1, turn power on. If 0, turn power off. */ int on) { char value[TV_MAX_VAL_LEN]; int ret = 0; if (on != POWER_ON && on != POWER_OFF) { SampleUtil_Print("error: can't set power to value %d\n", on); return 0; } /* Vendor-specific code to turn the power on/off goes here. */ sprintf(value, "%d", on); ret = TvDeviceSetServiceTableVar(TV_SERVICE_CONTROL, TV_CONTROL_POWER, value); return ret; } int TvDevicePowerOn(IXML_Document * in,IXML_Document **out, const char **errorString) { (*out) = NULL; (*errorString) = NULL; if (TvDeviceSetPower(POWER_ON)) { /* create a response */ if (UpnpAddToActionResponse(out, "PowerOn", TvServiceType[TV_SERVICE_CONTROL], "Power", "1") != UPNP_E_SUCCESS) { (*out) = NULL; (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } return UPNP_E_SUCCESS; } else { (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } in = in; } int TvDevicePowerOff(IXML_Document *in, IXML_Document **out, const char **errorString) { (*out) = NULL; (*errorString) = NULL; if (TvDeviceSetPower(POWER_OFF)) { /*create a response */ if (UpnpAddToActionResponse(out, "PowerOff", TvServiceType[TV_SERVICE_CONTROL], "Power", "0") != UPNP_E_SUCCESS) { (*out) = NULL; (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } return UPNP_E_SUCCESS; } (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; in = in; } int TvDeviceSetChannel(IXML_Document * in, IXML_Document ** out, const char **errorString) { char *value = NULL; int channel = 0; (*out) = NULL; (*errorString) = NULL; if (!(value = SampleUtil_GetFirstDocumentItem(in, "Channel"))) { (*errorString) = "Invalid Channel"; return UPNP_E_INVALID_PARAM; } channel = atoi(value); if (channel < MIN_CHANNEL || channel > MAX_CHANNEL) { free(value); SampleUtil_Print("error: can't change to channel %d\n", channel); (*errorString) = "Invalid Channel"; return UPNP_E_INVALID_PARAM; } /* Vendor-specific code to set the channel goes here. */ if (TvDeviceSetServiceTableVar(TV_SERVICE_CONTROL, TV_CONTROL_CHANNEL, value)) { if (UpnpAddToActionResponse(out, "SetChannel", TvServiceType[TV_SERVICE_CONTROL], "NewChannel", value) != UPNP_E_SUCCESS) { (*out) = NULL; (*errorString) = "Internal Error"; free(value); return UPNP_E_INTERNAL_ERROR; } free(value); return UPNP_E_SUCCESS; } else { free(value); (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } } int IncrementChannel(int incr, IN IXML_Document * in, IXML_Document ** out, const char **errorString) { int curchannel; int newchannel; const char *actionName = NULL; char value[TV_MAX_VAL_LEN]; if (incr > 0) { actionName = "IncreaseChannel"; } else { actionName = "DecreaseChannel"; } ithread_mutex_lock(&TVDevMutex); curchannel = atoi(tv_service_table[TV_SERVICE_CONTROL].VariableStrVal [TV_CONTROL_CHANNEL]); ithread_mutex_unlock(&TVDevMutex); newchannel = curchannel + incr; if (newchannel < MIN_CHANNEL || newchannel > MAX_CHANNEL) { SampleUtil_Print("error: can't change to channel %d\n", newchannel); (*errorString) = "Invalid Channel"; return UPNP_E_INVALID_PARAM; } /* Vendor-specific code to set the channel goes here. */ sprintf(value, "%d", newchannel); if (TvDeviceSetServiceTableVar(TV_SERVICE_CONTROL, TV_CONTROL_CHANNEL, value)) { if (UpnpAddToActionResponse(out, actionName, TvServiceType[TV_SERVICE_CONTROL], "Channel", value) != UPNP_E_SUCCESS) { (*out) = NULL; (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } return UPNP_E_SUCCESS; } else { (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } in = in; } int TvDeviceDecreaseChannel(IXML_Document * in, IXML_Document ** out, const char **errorString) { return IncrementChannel(-1, in, out, errorString); } int TvDeviceIncreaseChannel(IXML_Document * in, IXML_Document ** out, const char **errorString) { return IncrementChannel(1, in, out, errorString); } int TvDeviceSetVolume(IXML_Document * in, IXML_Document ** out, const char **errorString) { char *value = NULL; int volume = 0; (*out) = NULL; (*errorString) = NULL; if (!(value = SampleUtil_GetFirstDocumentItem(in, "Volume"))) { (*errorString) = "Invalid Volume"; return UPNP_E_INVALID_PARAM; } volume = atoi(value); if (volume < MIN_VOLUME || volume > MAX_VOLUME) { SampleUtil_Print("error: can't change to volume %d\n", volume); (*errorString) = "Invalid Volume"; return UPNP_E_INVALID_PARAM; } /* Vendor-specific code to set the volume goes here. */ if (TvDeviceSetServiceTableVar(TV_SERVICE_CONTROL, TV_CONTROL_VOLUME, value)) { if (UpnpAddToActionResponse(out, "SetVolume", TvServiceType[TV_SERVICE_CONTROL], "NewVolume", value) != UPNP_E_SUCCESS) { (*out) = NULL; (*errorString) = "Internal Error"; free(value); return UPNP_E_INTERNAL_ERROR; } free(value); return UPNP_E_SUCCESS; } else { free(value); (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } } /*! * \brief Increment the volume. Read the current volume from the state table, * add the increment, and then change the volume. */ static int IncrementVolume( /*! [in] The increment by which to change the volume. */ int incr, /*! [in] Action request document. */ IXML_Document * in, /*! [out] Action result document. */ IXML_Document ** out, /*! [out] Error string in case action was unsuccessful. */ const char **errorString) { int curvolume; int newvolume; const char *actionName = NULL; char value[TV_MAX_VAL_LEN]; if (incr > 0) { actionName = "IncreaseVolume"; } else { actionName = "DecreaseVolume"; } ithread_mutex_lock(&TVDevMutex); curvolume = atoi(tv_service_table[TV_SERVICE_CONTROL].VariableStrVal [TV_CONTROL_VOLUME]); ithread_mutex_unlock(&TVDevMutex); newvolume = curvolume + incr; if (newvolume < MIN_VOLUME || newvolume > MAX_VOLUME) { SampleUtil_Print("error: can't change to volume %d\n", newvolume); (*errorString) = "Invalid Volume"; return UPNP_E_INVALID_PARAM; } /* Vendor-specific code to set the volume goes here. */ sprintf(value, "%d", newvolume); if (TvDeviceSetServiceTableVar(TV_SERVICE_CONTROL, TV_CONTROL_VOLUME, value)) { if (UpnpAddToActionResponse(out, actionName, TvServiceType[TV_SERVICE_CONTROL], "Volume", value) != UPNP_E_SUCCESS) { (*out) = NULL; (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } return UPNP_E_SUCCESS; } else { (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } in = in; } int TvDeviceIncreaseVolume(IXML_Document * in, IXML_Document ** out, const char **errorString) { return IncrementVolume(1, in, out, errorString); } int TvDeviceDecreaseVolume(IXML_Document * in, IXML_Document ** out, const char **errorString) { return IncrementVolume(-1, in, out, errorString); } int TvDeviceSetColor(IXML_Document * in, IXML_Document ** out, const char **errorString) { char *value = NULL; int color = 0; (*out) = NULL; (*errorString) = NULL; if (!(value = SampleUtil_GetFirstDocumentItem(in, "Color"))) { (*errorString) = "Invalid Color"; return UPNP_E_INVALID_PARAM; } color = atoi(value); if (color < MIN_COLOR || color > MAX_COLOR) { SampleUtil_Print("error: can't change to color %d\n", color); (*errorString) = "Invalid Color"; return UPNP_E_INVALID_PARAM; } /* Vendor-specific code to set the volume goes here. */ if (TvDeviceSetServiceTableVar(TV_SERVICE_PICTURE, TV_PICTURE_COLOR, value)) { if (UpnpAddToActionResponse(out, "SetColor", TvServiceType[TV_SERVICE_PICTURE], "NewColor", value) != UPNP_E_SUCCESS) { (*out) = NULL; (*errorString) = "Internal Error"; free(value); return UPNP_E_INTERNAL_ERROR; } free(value); return UPNP_E_SUCCESS; } else { free(value); (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } } /*! * \brief Increment the color. Read the current color from the state * table, add the increment, and then change the color. */ static int IncrementColor( /*! [in] The increment by which to change the volume. */ int incr, /*! [in] Action request document. */ IXML_Document * in, /*! [out] Action result document. */ IXML_Document ** out, /*! [out] Error string in case action was unsuccessful. */ const char **errorString) { int curcolor; int newcolor; const char *actionName; char value[TV_MAX_VAL_LEN]; if (incr > 0) { actionName = "IncreaseColor"; } else { actionName = "DecreaseColor"; } ithread_mutex_lock(&TVDevMutex); curcolor = atoi(tv_service_table[TV_SERVICE_PICTURE].VariableStrVal [TV_PICTURE_COLOR]); ithread_mutex_unlock(&TVDevMutex); newcolor = curcolor + incr; if (newcolor < MIN_COLOR || newcolor > MAX_COLOR) { SampleUtil_Print("error: can't change to color %d\n", newcolor); (*errorString) = "Invalid Color"; return UPNP_E_INVALID_PARAM; } /* Vendor-specific code to set the volume goes here. */ sprintf(value, "%d", newcolor); if (TvDeviceSetServiceTableVar(TV_SERVICE_PICTURE, TV_PICTURE_COLOR, value)) { if (UpnpAddToActionResponse(out, actionName, TvServiceType[TV_SERVICE_PICTURE], "Color", value) != UPNP_E_SUCCESS) { (*out) = NULL; (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } return UPNP_E_SUCCESS; } else { (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } in = in; } int TvDeviceDecreaseColor(IXML_Document * in, IXML_Document ** out, const char **errorString) { return IncrementColor(-1, in, out, errorString); } int TvDeviceIncreaseColor(IXML_Document * in, IXML_Document ** out, const char **errorString) { return IncrementColor(1, in, out, errorString); } int TvDeviceSetTint(IXML_Document * in, IXML_Document ** out, const char **errorString) { char *value = NULL; int tint = -1; (*out) = NULL; (*errorString) = NULL; if (!(value = SampleUtil_GetFirstDocumentItem(in, "Tint"))) { (*errorString) = "Invalid Tint"; return UPNP_E_INVALID_PARAM; } tint = atoi(value); if (tint < MIN_TINT || tint > MAX_TINT) { SampleUtil_Print("error: can't change to tint %d\n", tint); (*errorString) = "Invalid Tint"; return UPNP_E_INVALID_PARAM; } /* Vendor-specific code to set the volume goes here. */ if (TvDeviceSetServiceTableVar(TV_SERVICE_PICTURE, TV_PICTURE_TINT, value)) { if (UpnpAddToActionResponse(out, "SetTint", TvServiceType[TV_SERVICE_PICTURE], "NewTint", value) != UPNP_E_SUCCESS) { (*out) = NULL; (*errorString) = "Internal Error"; free(value); return UPNP_E_INTERNAL_ERROR; } free(value); return UPNP_E_SUCCESS; } else { free(value); (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } } /****************************************************************************** * IncrementTint * * Description: * Increment the tint. Read the current tint from the state * table, add the increment, and then change the tint. * * Parameters: * incr -- The increment by which to change the tint. * * IXML_Document * in - action request document * IXML_Document **out - action result document * char **errorString - errorString (in case action was unsuccessful) *****************************************************************************/ int IncrementTint(IN int incr, IN IXML_Document *in, OUT IXML_Document **out, OUT const char **errorString) { int curtint; int newtint; const char *actionName = NULL; char value[TV_MAX_VAL_LEN]; if (incr > 0) { actionName = "IncreaseTint"; } else { actionName = "DecreaseTint"; } ithread_mutex_lock(&TVDevMutex); curtint = atoi(tv_service_table[TV_SERVICE_PICTURE].VariableStrVal [TV_PICTURE_TINT]); ithread_mutex_unlock(&TVDevMutex); newtint = curtint + incr; if (newtint < MIN_TINT || newtint > MAX_TINT) { SampleUtil_Print("error: can't change to tint %d\n", newtint); (*errorString) = "Invalid Tint"; return UPNP_E_INVALID_PARAM; } /* Vendor-specific code to set the volume goes here. */ sprintf(value, "%d", newtint); if (TvDeviceSetServiceTableVar(TV_SERVICE_PICTURE, TV_PICTURE_TINT, value)) { if (UpnpAddToActionResponse(out, actionName, TvServiceType[TV_SERVICE_PICTURE], "Tint", value) != UPNP_E_SUCCESS) { (*out) = NULL; (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } return UPNP_E_SUCCESS; } else { (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } in = in; } /****************************************************************************** * TvDeviceIncreaseTint * * Description: * Increase tint. * * Parameters: * * IXML_Document * in - action request document * IXML_Document **out - action result document * char **errorString - errorString (in case action was unsuccessful) * *****************************************************************************/ int TvDeviceIncreaseTint(IN IXML_Document *in, OUT IXML_Document **out, OUT const char **errorString) { return IncrementTint(1, in, out, errorString); } /****************************************************************************** * TvDeviceDecreaseTint * * Description: * Decrease tint. * * Parameters: * * IXML_Document * in - action request document * IXML_Document **out - action result document * char **errorString - errorString (in case action was unsuccessful) * *****************************************************************************/ int TvDeviceDecreaseTint(IN IXML_Document *in, OUT IXML_Document **out, OUT const char **errorString) { return IncrementTint(-1, in, out, errorString); } /***************************************************************************** * TvDeviceSetContrast * * Description: * Change the contrast, update the TvDevice picture service * state table, and notify all subscribed control points of the * updated state. * * Parameters: * * IXML_Document * in - action request document * IXML_Document **out - action result document * char **errorString - errorString (in case action was unsuccessful) * ****************************************************************************/ int TvDeviceSetContrast(IN IXML_Document *in, OUT IXML_Document **out, OUT const char **errorString) { char *value = NULL; int contrast = -1; (*out) = NULL; (*errorString) = NULL; if (!(value = SampleUtil_GetFirstDocumentItem(in, "Contrast"))) { (*errorString) = "Invalid Contrast"; return UPNP_E_INVALID_PARAM; } contrast = atoi(value); if (contrast < MIN_CONTRAST || contrast > MAX_CONTRAST) { SampleUtil_Print("error: can't change to contrast %d\n", contrast); (*errorString) = "Invalid Contrast"; return UPNP_E_INVALID_PARAM; } /* Vendor-specific code to set the volume goes here. */ if (TvDeviceSetServiceTableVar(TV_SERVICE_PICTURE, TV_PICTURE_CONTRAST, value)) { if (UpnpAddToActionResponse(out, "SetContrast", TvServiceType[TV_SERVICE_PICTURE], "NewContrast", value) != UPNP_E_SUCCESS) { (*out) = NULL; (*errorString) = "Internal Error"; free(value); return UPNP_E_INTERNAL_ERROR; } free(value); return UPNP_E_SUCCESS; } else { free(value); (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } } /*! * \brief Increment the contrast. Read the current contrast from the state * table, add the increment, and then change the contrast. */ static int IncrementContrast( /*! [in] The increment by which to change the volume. */ int incr, /*! [in] Action request document. */ IXML_Document * in, /*! [out] Action result document. */ IXML_Document ** out, /*! [out] Error string in case action was unsuccessful. */ const char **errorString) { int curcontrast; int newcontrast; const char *actionName = NULL; char value[TV_MAX_VAL_LEN]; if (incr > 0) { actionName = "IncreaseContrast"; } else { actionName = "DecreaseContrast"; } ithread_mutex_lock(&TVDevMutex); curcontrast = atoi(tv_service_table[TV_SERVICE_PICTURE].VariableStrVal [TV_PICTURE_CONTRAST]); ithread_mutex_unlock(&TVDevMutex); newcontrast = curcontrast + incr; if (newcontrast < MIN_CONTRAST || newcontrast > MAX_CONTRAST) { SampleUtil_Print("error: can't change to contrast %d\n", newcontrast); (*errorString) = "Invalid Contrast"; return UPNP_E_INVALID_PARAM; } /* Vendor-specific code to set the channel goes here. */ sprintf(value, "%d", newcontrast); if (TvDeviceSetServiceTableVar(TV_SERVICE_PICTURE, TV_PICTURE_CONTRAST, value)) { if (UpnpAddToActionResponse(out, actionName, TvServiceType[TV_SERVICE_PICTURE], "Contrast", value) != UPNP_E_SUCCESS) { (*out) = NULL; (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } return UPNP_E_SUCCESS; } else { (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } in = in; } int TvDeviceIncreaseContrast(IXML_Document * in, IXML_Document ** out, const char **errorString) { return IncrementContrast(1, in, out, errorString); } int TvDeviceDecreaseContrast(IXML_Document * in, IXML_Document ** out, const char **errorString) { return IncrementContrast(-1, in, out, errorString); } int TvDeviceSetBrightness(IXML_Document * in, IXML_Document ** out, const char **errorString) { char *value = NULL; int brightness = -1; (*out) = NULL; (*errorString) = NULL; if (!(value = SampleUtil_GetFirstDocumentItem(in, "Brightness"))) { (*errorString) = "Invalid Brightness"; return UPNP_E_INVALID_PARAM; } brightness = atoi(value); if (brightness < MIN_BRIGHTNESS || brightness > MAX_BRIGHTNESS) { SampleUtil_Print("error: can't change to brightness %d\n", brightness); (*errorString) = "Invalid Brightness"; return UPNP_E_INVALID_PARAM; } /* Vendor-specific code to set the volume goes here. */ if (TvDeviceSetServiceTableVar(TV_SERVICE_PICTURE, TV_PICTURE_BRIGHTNESS, value)) { if (UpnpAddToActionResponse(out, "SetBrightness", TvServiceType[TV_SERVICE_PICTURE], "NewBrightness", value) != UPNP_E_SUCCESS) { (*out) = NULL; (*errorString) = "Internal Error"; free(value); return UPNP_E_INTERNAL_ERROR; } free(value); return UPNP_E_SUCCESS; } else { free(value); (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } } /*! * \brief Increment the brightness. Read the current brightness from the state * table, add the increment, and then change the brightness. */ static int IncrementBrightness( /*! [in] The increment by which to change the brightness. */ int incr, /*! [in] action request document. */ IXML_Document * in, /*! [out] action result document. */ IXML_Document ** out, /*! [out] errorString (in case action was unsuccessful). */ const char **errorString) { int curbrightness; int newbrightness; const char *actionName = NULL; char value[TV_MAX_VAL_LEN]; if (incr > 0) { actionName = "IncreaseBrightness"; } else { actionName = "DecreaseBrightness"; } ithread_mutex_lock(&TVDevMutex); curbrightness = atoi(tv_service_table[TV_SERVICE_PICTURE].VariableStrVal [TV_PICTURE_BRIGHTNESS]); ithread_mutex_unlock(&TVDevMutex); newbrightness = curbrightness + incr; if (newbrightness < MIN_BRIGHTNESS || newbrightness > MAX_BRIGHTNESS) { SampleUtil_Print("error: can't change to brightness %d\n", newbrightness); (*errorString) = "Invalid Brightness"; return UPNP_E_INVALID_PARAM; } /* Vendor-specific code to set the channel goes here. */ sprintf(value, "%d", newbrightness); if (TvDeviceSetServiceTableVar(TV_SERVICE_PICTURE, TV_PICTURE_BRIGHTNESS, value)) { if (UpnpAddToActionResponse(out, actionName, TvServiceType[TV_SERVICE_PICTURE], "Brightness", value) != UPNP_E_SUCCESS) { (*out) = NULL; (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } return UPNP_E_SUCCESS; } else { (*errorString) = "Internal Error"; return UPNP_E_INTERNAL_ERROR; } in = in; } int TvDeviceIncreaseBrightness(IXML_Document * in, IXML_Document ** out, const char **errorString) { return IncrementBrightness(1, in, out, errorString); } int TvDeviceDecreaseBrightness(IXML_Document * in, IXML_Document ** out, const char **errorString) { return IncrementBrightness(-1, in, out, errorString); } int TvDeviceCallbackEventHandler(Upnp_EventType EventType, const void *Event, void *Cookie) { switch (EventType) { case UPNP_EVENT_SUBSCRIPTION_REQUEST: TvDeviceHandleSubscriptionRequest((UpnpSubscriptionRequest *)Event); break; case UPNP_CONTROL_GET_VAR_REQUEST: TvDeviceHandleGetVarRequest((UpnpStateVarRequest *)Event); break; case UPNP_CONTROL_ACTION_REQUEST: TvDeviceHandleActionRequest((UpnpActionRequest *)Event); break; /* ignore these cases, since this is not a control point */ case UPNP_DISCOVERY_ADVERTISEMENT_ALIVE: case UPNP_DISCOVERY_SEARCH_RESULT: case UPNP_DISCOVERY_SEARCH_TIMEOUT: case UPNP_DISCOVERY_ADVERTISEMENT_BYEBYE: case UPNP_CONTROL_ACTION_COMPLETE: case UPNP_CONTROL_GET_VAR_COMPLETE: case UPNP_EVENT_RECEIVED: case UPNP_EVENT_RENEWAL_COMPLETE: case UPNP_EVENT_SUBSCRIBE_COMPLETE: case UPNP_EVENT_UNSUBSCRIBE_COMPLETE: break; default: SampleUtil_Print ("Error in TvDeviceCallbackEventHandler: unknown event type %d\n", EventType); } /* Print a summary of the event received */ SampleUtil_PrintEvent(EventType, Event); return 0; Cookie = Cookie; } int TvDeviceStart(char *ip_address, unsigned short port, const char *desc_doc_name, const char *web_dir_path, print_string pfun, int combo) { int ret = UPNP_E_SUCCESS; char desc_doc_url[DESC_URL_SIZE]; ithread_mutex_init(&TVDevMutex, NULL); SampleUtil_Initialize(pfun); SampleUtil_Print("Initializing UPnP Sdk with\n" "\tipaddress = %s port = %u\n", ip_address ? ip_address : "{NULL}", port); ret = UpnpInit(ip_address, port); if (ret != UPNP_E_SUCCESS) { SampleUtil_Print("Error with UpnpInit -- %d\n", ret); UpnpFinish(); return ret; } ip_address = UpnpGetServerIpAddress(); port = UpnpGetServerPort(); SampleUtil_Print("UPnP Initialized\n" "\tipaddress = %s port = %u\n", ip_address ? ip_address : "{NULL}", port); if (!desc_doc_name) { if (combo) { desc_doc_name = "tvcombodesc.xml"; } else { desc_doc_name = "tvdevicedesc.xml"; } } if (!web_dir_path) { web_dir_path = DEFAULT_WEB_DIR; } snprintf(desc_doc_url, DESC_URL_SIZE, "http://%s:%d/%s", ip_address, port, desc_doc_name); SampleUtil_Print("Specifying the webserver root directory -- %s\n", web_dir_path); ret = UpnpSetWebServerRootDir(web_dir_path); if (ret != UPNP_E_SUCCESS) { SampleUtil_Print ("Error specifying webserver root directory -- %s: %d\n", web_dir_path, ret); UpnpFinish(); return ret; } SampleUtil_Print("Registering the RootDevice\n" "\t with desc_doc_url: %s\n", desc_doc_url); ret = UpnpRegisterRootDevice(desc_doc_url, TvDeviceCallbackEventHandler, &device_handle, &device_handle); if (ret != UPNP_E_SUCCESS) { SampleUtil_Print("Error registering the rootdevice : %d\n", ret); UpnpFinish(); return ret; } else { SampleUtil_Print("RootDevice Registered\n" "Initializing State Table\n"); TvDeviceStateTableInit(desc_doc_url); SampleUtil_Print("State Table Initialized\n"); ret = UpnpSendAdvertisement(device_handle, default_advr_expire); if (ret != UPNP_E_SUCCESS) { SampleUtil_Print("Error sending advertisements : %d\n", ret); UpnpFinish(); return ret; } SampleUtil_Print("Advertisements Sent\n"); } return UPNP_E_SUCCESS; } int TvDeviceStop(void) { UpnpUnRegisterRootDevice(device_handle); UpnpFinish(); SampleUtil_Finish(); ithread_mutex_destroy(&TVDevMutex); return UPNP_E_SUCCESS; } void *TvDeviceCommandLoop(void *args) { int stoploop = 0; char cmdline[100]; char cmd[100]; while (!stoploop) { sprintf(cmdline, " "); sprintf(cmd, " "); SampleUtil_Print("\n>> "); /* Get a command line */ char *s = fgets(cmdline, 100, stdin); if (!s) break; sscanf(cmdline, "%s", cmd); if (strcasecmp(cmd, "exit") == 0) { SampleUtil_Print("Shutting down...\n"); TvDeviceStop(); exit(0); } else { SampleUtil_Print("\n Unknown command: %s\n\n", cmd); SampleUtil_Print(" Valid Commands:\n" " Exit\n\n"); } } return NULL; args = args; } int device_main(int argc, char *argv[]) { unsigned int portTemp = 0; char *ip_address = NULL; char *desc_doc_name = NULL; char *web_dir_path = NULL; unsigned short port = 0; int i = 0; SampleUtil_Initialize(linux_print); /* Parse options */ for (i = 1; i < argc; i++) { if (strcmp(argv[i], "-ip") == 0) { ip_address = argv[++i]; } else if (strcmp(argv[i], "-port") == 0) { sscanf(argv[++i], "%u", &portTemp); } else if (strcmp(argv[i], "-desc") == 0) { desc_doc_name = argv[++i]; } else if (strcmp(argv[i], "-webdir") == 0) { web_dir_path = argv[++i]; } else if (strcmp(argv[i], "-help") == 0) { SampleUtil_Print("Usage: %s -ip ipaddress -port port" " -desc desc_doc_name -webdir web_dir_path" " -help (this message)\n", argv[0]); SampleUtil_Print ("\tipaddress: IP address of the device" " (must match desc. doc)\n" "\t\te.g.: 192.168.0.4\n" "\tport: Port number to use for" " receiving UPnP messages (must match desc. doc)\n" "\t\te.g.: 5431\n" "\tdesc_doc_name: name of device description document\n" "\t\te.g.: tvdevicedesc.xml\n" "\tweb_dir_path: Filesystem path where web files" " related to the device are stored\n" "\t\te.g.: /upnp/sample/tvdevice/web\n"); return 1; } } port = (unsigned short)portTemp; return TvDeviceStart(ip_address, port, desc_doc_name, web_dir_path, linux_print, 0); } /*! @} Device Sample Module */ /*! @} UpnpSamples */ pupnp-release-1.8.0/upnp/sample/common/tv_device.h000066400000000000000000000366531303304015100221570ustar00rootroot00000000000000#ifndef UPNP_TV_DEVICE_H #define UPNP_TV_DEVICE_H /************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ /*! * \addtogroup UpnpSamples * * @{ * * \name Device Sample API * * @{ * * \file */ #include #include #ifdef __cplusplus extern "C" { #endif #include "sample_util.h" #include "ithread.h" #include "upnp.h" #include #include /*! Color constants */ #define MAX_COLOR 10 #define MIN_COLOR 1 /*! Brightness constants */ #define MAX_BRIGHTNESS 10 #define MIN_BRIGHTNESS 1 /*! Power constants */ #define POWER_ON 1 #define POWER_OFF 0 /*! Tint constants */ #define MAX_TINT 10 #define MIN_TINT 1 /*! Volume constants */ #define MAX_VOLUME 10 #define MIN_VOLUME 1 /*! Contrast constants */ #define MAX_CONTRAST 10 #define MIN_CONTRAST 1 /*! Channel constants */ #define MAX_CHANNEL 100 #define MIN_CHANNEL 1 /*! Number of services. */ #define TV_SERVICE_SERVCOUNT 2 /*! Index of control service */ #define TV_SERVICE_CONTROL 0 /*! Index of picture service */ #define TV_SERVICE_PICTURE 1 /*! Number of control variables */ #define TV_CONTROL_VARCOUNT 3 /*! Index of power variable */ #define TV_CONTROL_POWER 0 /*! Index of channel variable */ #define TV_CONTROL_CHANNEL 1 /*! Index of volume variable */ #define TV_CONTROL_VOLUME 2 /*! Number of picture variables */ #define TV_PICTURE_VARCOUNT 4 /*! Index of color variable */ #define TV_PICTURE_COLOR 0 /*! Index of tint variable */ #define TV_PICTURE_TINT 1 /*! Index of contrast variable */ #define TV_PICTURE_CONTRAST 2 /*! Index of brightness variable */ #define TV_PICTURE_BRIGHTNESS 3 /*! Max value length */ #define TV_MAX_VAL_LEN 5 /*! Max actions */ #define TV_MAXACTIONS 12 /*! This should be the maximum VARCOUNT from above */ #define TV_MAXVARS TV_PICTURE_VARCOUNT /*! * \brief Prototype for all actions. For each action that a service * implements, there is a corresponding function with this prototype. * * Pointers to these functions, along with action names, are stored * in the service table. When an action request comes in the action * name is matched, and the appropriate function is called. * Each function returns UPNP_E_SUCCESS, on success, and a nonzero * error code on failure. */ typedef int (*upnp_action)( /*! [in] Document of action request. */ IXML_Document *request, /*! [out] Action result. */ IXML_Document **out, /*! [out] Error string in case action was unsuccessful. */ const char **errorString); /*! Structure for storing Tv Service identifiers and state table. */ struct TvService { /*! Universally Unique Device Name. */ char UDN[NAME_SIZE]; /*! . */ char ServiceId[NAME_SIZE]; /*! . */ char ServiceType[NAME_SIZE]; /*! . */ const char *VariableName[TV_MAXVARS]; /*! . */ char *VariableStrVal[TV_MAXVARS]; /*! . */ const char *ActionNames[TV_MAXACTIONS]; /*! . */ upnp_action actions[TV_MAXACTIONS]; /*! . */ int VariableCount; }; /*! Array of service structures */ extern struct TvService tv_service_table[]; /*! Device handle returned from sdk */ extern UpnpDevice_Handle device_handle; /*! Mutex for protecting the global state table data * in a multi-threaded, asynchronous environment. * All functions should lock this mutex before reading * or writing the state table data. */ extern ithread_mutex_t TVDevMutex; /*! * \brief Initializes the action table for the specified service. * * Note that knowledge of the service description is assumed. * Action names are hardcoded. */ int SetActionTable( /*! [in] one of TV_SERVICE_CONTROL or, TV_SERVICE_PICTURE. */ int serviceType, /*! [in,out] service containing action table to set. */ struct TvService *out); /*! * \brief Initialize the device state table for this TvDevice, pulling * identifier info from the description Document. * * Note that knowledge of the service description is assumed. * State table variables and default values are currently hardcoded in * this file rather than being read from service description documents. */ int TvDeviceStateTableInit( /*! [in] The description document URL. */ char *DescDocURL); /*! * \brief Called during a subscription request callback. * * If the subscription request is for this device and either its * control service or picture service, then accept it. */ int TvDeviceHandleSubscriptionRequest( /*! [in] The subscription request event structure. */ const UpnpSubscriptionRequest *sr_event); /*! * \brief Called during a get variable request callback. * * If the request is for this device and either its control service or * picture service, then respond with the variable value. */ int TvDeviceHandleGetVarRequest( /*! [in,out] The control get variable request event structure. */ UpnpStateVarRequest *cgv_event); /*! * \brief Called during an action request callback. * * If the request is for this device and either its control service * or picture service, then perform the action and respond. */ int TvDeviceHandleActionRequest( /*! [in,out] The control action request event structure. */ UpnpActionRequest *ca_event); /*! * \brief The callback handler registered with the SDK while registering * root device. * * Dispatches the request to the appropriate procedure * based on the value of EventType. The four requests handled by the * device are: * \li 1) Event Subscription requests. * \li 2) Get Variable requests. * \li 3) Action requests. */ int TvDeviceCallbackEventHandler( /*! [in] The type of callback event. */ Upnp_EventType, /*! [in] Data structure containing event data. */ const void *Event, /*! [in] Optional data specified during callback registration. */ void *Cookie); /*! * \brief Update the TvDevice service state table, and notify all subscribed * control points of the updated state. * * Note that since this function blocks on the mutex TVDevMutex, * to avoid a hang this function should not be called within any other * function that currently has this mutex locked. */ int TvDeviceSetServiceTableVar( /*! [in] The service number (TV_SERVICE_CONTROL or TV_SERVICE_PICTURE). */ unsigned int service, /*! [in] The variable number (TV_CONTROL_POWER, TV_CONTROL_CHANNEL, * TV_CONTROL_VOLUME, TV_PICTURE_COLOR, TV_PICTURE_TINT, * TV_PICTURE_CONTRAST, or TV_PICTURE_BRIGHTNESS). */ int variable, /*! [in] The string representation of the new value. */ char *value); /* Control Service Actions */ /*! * \brief Turn the power on. */ int TvDevicePowerOn( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Turn the power off. */ int TvDevicePowerOff( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Change the channel, update the TvDevice control service * state table, and notify all subscribed control points of the * updated state. */ int TvDeviceSetChannel( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Increase the channel. */ int TvDeviceIncreaseChannel( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Decrease the channel. */ int TvDeviceDecreaseChannel( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Change the volume, update the TvDevice control service * state table, and notify all subscribed control points of the * updated state. */ int TvDeviceSetVolume( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Increase the volume. */ int TvDeviceIncreaseVolume( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Decrease the volume. */ int TvDeviceDecreaseVolume( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*Picture Service Actions */ /*! * \brief Change the color, update the TvDevice picture service * state table, and notify all subscribed control points of the * updated state. */ int TvDeviceSetColor( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Increase the color. */ int TvDeviceIncreaseColor( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Decrease the color. */ int TvDeviceDecreaseColor( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Change the tint, update the TvDevice picture service * state table, and notify all subscribed control points of the * updated state. */ int TvDeviceSetTint( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Increase tint. */ int TvDeviceIncreaseTint( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Decrease tint. */ int TvDeviceDecreaseTint( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Change the contrast, update the TvDevice picture service * state table, and notify all subscribed control points of the * updated state. */ int TvDeviceSetContrast( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Increase the contrast. */ int TvDeviceIncreaseContrast( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Decrease the contrast. */ int TvDeviceDecreaseContrast( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Change the brightness, update the TvDevice picture service * state table, and notify all subscribed control points of the * updated state. */ int TvDeviceSetBrightness( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Increase brightnesss. */ int TvDeviceIncreaseBrightness( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Decrease brightnesss. */ int TvDeviceDecreaseBrightness( /*! [in] Document of action request. */ IXML_Document *in, /*! [in] Action result. */ IXML_Document **out, /*! [out] ErrorString in case action was unsuccessful. */ const char **errorString); /*! * \brief Initializes the UPnP Sdk, registers the device, and sends out * advertisements. */ int TvDeviceStart( /*! [in] ip address to initialize the sdk (may be NULL) * if null, then the first non null loopback address is used. */ char *ip_address, /*! [in] port number to initialize the sdk (may be 0) * if zero, then a random number is used. */ unsigned short port, /*! [in] name of description document. * may be NULL. Default is tvdevicedesc.xml. */ const char *desc_doc_name, /*! [in] path of web directory. * may be NULL. Default is ./web (for Linux) or ../tvdevice/web. */ const char *web_dir_path, /*! [in] print function to use. */ print_string pfun, /*! [in] Non-zero if called from the combo application. */ int combo); /*! * \brief Stops the device. Uninitializes the sdk. */ int TvDeviceStop(void); /*! * \brief Function that receives commands from the user at the command prompt * during the lifetime of the device, and calls the appropriate * functions for those commands. Only one command, exit, is currently * defined. */ void *TvDeviceCommandLoop(void *args); /*! * \brief Main entry point for tv device application. * * Initializes and registers with the sdk. * Initializes the state stables of the service. * Starts the command loop. * * Accepts the following optional arguments: * \li \c -ip ipaddress * \li \c -port port * \li \c -desc desc_doc_name * \li \c -webdir web_dir_path * \li \c -help */ int device_main(int argc, char *argv[]); #ifdef __cplusplus } #endif /*! @} Control Point Sample API */ /*! @} UpnpSamples */ #endif /* UPNP_TV_DEVICE_H */ pupnp-release-1.8.0/upnp/sample/linux/000077500000000000000000000000001303304015100176705ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/sample/linux/tv_combo_main.c000066400000000000000000000051271303304015100226550ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #include "sample_util.h" #include "tv_ctrlpt.h" #include "tv_device.h" #include #include int main(int argc, char *argv[]) { int rc; ithread_t cmdloop_thread; #ifdef WIN32 #else int sig; sigset_t sigs_to_catch; #endif int code; device_main(argc, argv); rc = TvCtrlPointStart(linux_print, NULL, 1); if (rc != TV_SUCCESS) { SampleUtil_Print("Error starting UPnP TV Control Point\n"); return rc; } /* start a command loop thread */ code = ithread_create(&cmdloop_thread, NULL, TvCtrlPointCommandLoop, NULL); if (code != 0) { return UPNP_E_INTERNAL_ERROR; } #ifdef WIN32 ithread_join(cmdloop_thread, NULL); #else /* Catch Ctrl-C and properly shutdown */ sigemptyset(&sigs_to_catch); sigaddset(&sigs_to_catch, SIGINT); sigwait(&sigs_to_catch, &sig); SampleUtil_Print("Shutting down on signal %d...\n", sig); #endif TvDeviceStop(); rc = TvCtrlPointStop(); return rc; } pupnp-release-1.8.0/upnp/sample/linux/tv_ctrlpt_main.c000066400000000000000000000051041303304015100230610ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #include "sample_util.h" #include "tv_ctrlpt.h" #include #include #include int main(int argc, char **argv) { int rc; ithread_t cmdloop_thread; #ifdef WIN32 #else int sig; sigset_t sigs_to_catch; #endif int code; rc = TvCtrlPointStart(linux_print, NULL, 0); if (rc != TV_SUCCESS) { SampleUtil_Print("Error starting UPnP TV Control Point\n"); return rc; } /* start a command loop thread */ code = ithread_create(&cmdloop_thread, NULL, TvCtrlPointCommandLoop, NULL); if (code != 0) { return UPNP_E_INTERNAL_ERROR; } #ifdef WIN32 ithread_join(cmdloop_thread, NULL); #else /* Catch Ctrl-C and properly shutdown */ sigemptyset(&sigs_to_catch); sigaddset(&sigs_to_catch, SIGINT); sigwait(&sigs_to_catch, &sig); SampleUtil_Print("Shutting down on signal %d...\n", sig); #endif rc = TvCtrlPointStop(); return rc; argc = argc; argv = argv; } pupnp-release-1.8.0/upnp/sample/linux/tv_device_main.c000066400000000000000000000047071303304015100230200ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #include "sample_util.h" #include "tv_device.h" #include #include int main(int argc, char *argv[]) { int rc; ithread_t cmdloop_thread; #ifdef WIN32 #else int sig; sigset_t sigs_to_catch; #endif int code; rc = device_main(argc, argv); if (rc != UPNP_E_SUCCESS) { return rc; } /* start a command loop thread */ code = ithread_create(&cmdloop_thread, NULL, TvDeviceCommandLoop, NULL); if (code != 0) { return UPNP_E_INTERNAL_ERROR; } #ifdef WIN32 ithread_join(cmdloop_thread, NULL); #else /* Catch Ctrl-C and properly shutdown */ sigemptyset(&sigs_to_catch); sigaddset(&sigs_to_catch, SIGINT); sigwait(&sigs_to_catch, &sig); SampleUtil_Print("Shutting down on signal %d...\n", sig); #endif rc = TvDeviceStop(); return rc; } pupnp-release-1.8.0/upnp/sample/web/000077500000000000000000000000001303304015100173065ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/sample/web/tvcombodesc.xml000066400000000000000000000027661303304015100223530ustar00rootroot00000000000000 1 0 urn:schemas-upnp-org:device:tvdevice:1 UPnP Television Emulator TV Manufacturer Name http://www.manufacturer.com UPnP Television Device Emulator 1.0 TVEmulator 1.0 http://www.manufacturer.com/TVEmulator/ 123456789001 uuid:Upnp-TVEmulator-1_0-1234567890002 123456789 urn:schemas-upnp-org:service:tvcontrol:1 urn:upnp-org:serviceId:tvcontrol1 /upnp/control/tvcontrol1 /upnp/event/tvcontrol1 /tvcontrolSCPD.xml urn:schemas-upnp-org:service:tvpicture:1 urn:upnp-org:serviceId:tvpicture1 /upnp/control/tvpicture1 /upnp/event/tvpicture1 /tvpictureSCPD.xml /tvdevicepres.html pupnp-release-1.8.0/upnp/sample/web/tvcontrolSCPD.xml000066400000000000000000000071701303304015100225410ustar00rootroot00000000000000 1 0 PowerOn Power Power out PowerOff Power Power out SetChannel Channel Channel in NewChannel Channel out IncreaseChannel Channel Channel out DecreaseChannel Channel Channel out SetVolume Volume Volume in NewVolume Volume out IncreaseVolume Volume Volume out DecreaseVolume Volume Volume out Power Boolean 0 Channel i4 1 100 1 1 Volume i4 0 10 1 5 pupnp-release-1.8.0/upnp/sample/web/tvdevicedesc.xml000066400000000000000000000027661303304015100225130ustar00rootroot00000000000000 1 0 urn:schemas-upnp-org:device:tvdevice:1 UPnP Television Emulator TV Manufacturer Name http://www.manufacturer.com UPnP Television Device Emulator 1.0 TVEmulator 1.0 http://www.manufacturer.com/TVEmulator/ 123456789001 uuid:Upnp-TVEmulator-1_0-1234567890001 123456789 urn:schemas-upnp-org:service:tvcontrol:1 urn:upnp-org:serviceId:tvcontrol1 /upnp/control/tvcontrol1 /upnp/event/tvcontrol1 /tvcontrolSCPD.xml urn:schemas-upnp-org:service:tvpicture:1 urn:upnp-org:serviceId:tvpicture1 /upnp/control/tvpicture1 /upnp/event/tvpicture1 /tvpictureSCPD.xml /tvdevicepres.html pupnp-release-1.8.0/upnp/sample/web/tvdevicepres.html000066400000000000000000000222041303304015100226770ustar00rootroot00000000000000 Presentation page for Controlling a UPnP Television

Device Name

TvDevice Control State Table

Variable Value Actions
Power

        
Channel

        
Volume

        









TvDevice Picture State Table

Variable Value Actions
Color

        
Tint

        
Contrast

        
Brightness

        

 

pupnp-release-1.8.0/upnp/sample/web/tvpictureSCPD.xml000066400000000000000000000130721303304015100225320ustar00rootroot00000000000000 1 0 SetColor Color Color in NewColor Color out IncreaseColor Color Color out DecreaseColor Color Color out SetTint Tint Tint in NewTint Tint out IncreaseTint Tint Tint out DecreaseTint Tint Tint out SetContrast Contrast Contrast in NewContrast Contrast out IncreaseContrast Contrast Contrast out DecreaseContrast Contrast Contrast out SetBrightness Brightness Brightness in NewBrightness Brightness out IncreaseBrightness Brightness Brightness out DecreaseBrightness Brightness Brightness out Color i4 1 10 1 5 Tint i4 1 10 1 5 Contrast i4 1 10 1 5 Brightness i4 1 10 1 5 pupnp-release-1.8.0/upnp/src/000077500000000000000000000000001303304015100160375ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/api/000077500000000000000000000000001303304015100166105ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/api/ActionComplete.c000066400000000000000000000003031303304015100216560ustar00rootroot00000000000000 /*! * \file * * \brief UpnpActionComplete object implementation. * * \author Marcelo Roberto Jimenez */ #include "config.h" #define TEMPLATE_GENERATE_SOURCE #include "ActionComplete.h" pupnp-release-1.8.0/upnp/src/api/ActionRequest.c000066400000000000000000000003011303304015100215340ustar00rootroot00000000000000 /*! * \file * * \brief UpnpActionRequest object implementation. * * \author Marcelo Roberto Jimenez */ #include "config.h" #define TEMPLATE_GENERATE_SOURCE #include "ActionRequest.h" pupnp-release-1.8.0/upnp/src/api/Discovery.c000066400000000000000000000002711303304015100207230ustar00rootroot00000000000000 /*! * \file * * \brief UpnpDiscovery object implementation. * * \author Marcelo Roberto Jimenez */ #include "config.h" #define TEMPLATE_GENERATE_SOURCE #include "Discovery.h" pupnp-release-1.8.0/upnp/src/api/Event.c000066400000000000000000000002611303304015100200340ustar00rootroot00000000000000 /*! * \file * * \brief UpnpEvent object implementation. * * \author Marcelo Roberto Jimenez */ #include "config.h" #define TEMPLATE_GENERATE_SOURCE #include "Event.h" pupnp-release-1.8.0/upnp/src/api/EventSubscribe.c000066400000000000000000000003031303304015100216730ustar00rootroot00000000000000 /*! * \file * * \brief UpnpEventSubscribe object implementation. * * \author Marcelo Roberto Jimenez */ #include "config.h" #define TEMPLATE_GENERATE_SOURCE #include "EventSubscribe.h" pupnp-release-1.8.0/upnp/src/api/FileInfo.c000066400000000000000000000002671303304015100204540ustar00rootroot00000000000000 /*! * \file * * \brief UpnpFileInfo object implementation. * * \author Marcelo Roberto Jimenez */ #include "config.h" #define TEMPLATE_GENERATE_SOURCE #include "FileInfo.h" pupnp-release-1.8.0/upnp/src/api/StateVarComplete.c000066400000000000000000000003071303304015100221760ustar00rootroot00000000000000 /*! * \file * * \brief UpnpStateVarComplete object implementation. * * \author Marcelo Roberto Jimenez */ #include "config.h" #define TEMPLATE_GENERATE_SOURCE #include "StateVarComplete.h" pupnp-release-1.8.0/upnp/src/api/StateVarRequest.c000066400000000000000000000003051303304015100220540ustar00rootroot00000000000000 /*! * \file * * \brief UpnpStateVarRequest object implementation. * * \author Marcelo Roberto Jimenez */ #include "config.h" #define TEMPLATE_GENERATE_SOURCE #include "StateVarRequest.h" pupnp-release-1.8.0/upnp/src/api/SubscriptionRequest.c000066400000000000000000000003151303304015100230100ustar00rootroot00000000000000 /*! * \file * * \brief UpnpSubscriptionRequest object implementation. * * \author Marcelo Roberto Jimenez */ #include "config.h" #define TEMPLATE_GENERATE_SOURCE #include "SubscriptionRequest.h" pupnp-release-1.8.0/upnp/src/api/UpnpString.c000066400000000000000000000106551303304015100210740ustar00rootroot00000000000000/*! * \addtogroup UpnpString * * Due to its heavy use, this class is coded for efficiency, not for beauty. * Do not use this as example to other classes. Please take a look at any * other one. * * \todo Always alloc a minimum size like 64 bytes or so and when shrinking * do not perform a new memory allocation. * * @{ * * \file * * \brief UpnpString object implementation. */ #include "config.h" #include "UpnpString.h" #include /* for calloc(), free() */ #include /* for strlen(), strdup() */ #ifdef WIN32 #define strcasecmp stricmp #else /* Other systems have strncasecmp */ #endif #ifndef UPNP_USE_MSVCPP /* VC has strnlen which is already included but with (potentially) different linkage */ /* strnlen() is a GNU extension. */ #if !HAVE_STRNLEN static size_t strnlen(const char *s, size_t n) { const char *p = (const char *)memchr(s, 0, n); return p ? p - s : n; } #endif /* !HAVE_STRNLEN */ #endif /* WIN32 */ /* strndup() is a GNU extension. */ #if !HAVE_STRNDUP || defined(WIN32) static char *strndup(const char *__string, size_t __n) { size_t strsize = strnlen(__string, __n); char *newstr = (char *)malloc(strsize + 1); if (newstr == NULL) return NULL; strncpy(newstr, __string, strsize); newstr[strsize] = 0; return newstr; } #endif /* HAVE_STRNDUP && !defined(WIN32) */ /*! * \brief Internal implementation of the class UpnpString. * * \internal */ struct SUpnpString { /*! \brief Length of the string. */ size_t m_length; /*! \brief Pointer to a dynamically allocated area that holds the NULL * terminated string. */ char *m_string; }; UpnpString *UpnpString_new() { /* All bytes are zero, and so is the length of the string. */ struct SUpnpString *p = calloc((size_t)1, sizeof (struct SUpnpString)); if (p == NULL) { goto error_handler1; } #if 0 p->m_length = 0; #endif /* This byte is zero, calloc does initialize it. */ p->m_string = calloc((size_t)1, (size_t)1); if (p->m_string == NULL) { goto error_handler2; } return (UpnpString *)p; /*free(p->m_string); */ error_handler2: free(p); error_handler1: return NULL; } void UpnpString_delete(UpnpString *p) { struct SUpnpString *q = (struct SUpnpString *)p; if (!q) return; q->m_length = (size_t)0; free(q->m_string); q->m_string = NULL; free(p); } UpnpString *UpnpString_dup(const UpnpString *p) { struct SUpnpString *q = calloc((size_t)1, sizeof (struct SUpnpString)); if (q == NULL) { goto error_handler1; } q->m_length = ((struct SUpnpString *)p)->m_length; q->m_string = strdup(((struct SUpnpString *)p)->m_string); if (q->m_string == NULL) { goto error_handler2; } return (UpnpString *)q; /*free(q->m_string); */ error_handler2: free(q); error_handler1: return NULL; } void UpnpString_assign(UpnpString *p, const UpnpString *q) { if (p != q) { UpnpString_set_String(p, UpnpString_get_String(q)); } } size_t UpnpString_get_Length(const UpnpString *p) { return ((struct SUpnpString *)p)->m_length; } void UpnpString_set_Length(UpnpString *p, size_t n) { if (((struct SUpnpString *)p)->m_length > n) { ((struct SUpnpString *)p)->m_length = n; /* No need to realloc now, will do later when needed. */ ((struct SUpnpString *)p)->m_string[n] = 0; } } const char *UpnpString_get_String(const UpnpString *p) { return ((struct SUpnpString *)p)->m_string; } int UpnpString_set_String(UpnpString *p, const char *s) { char *q = strdup(s); if (!q) goto error_handler1; free(((struct SUpnpString *)p)->m_string); ((struct SUpnpString *)p)->m_length = strlen(q); ((struct SUpnpString *)p)->m_string = q; error_handler1: return q != NULL; } int UpnpString_set_StringN(UpnpString *p, const char *s, size_t n) { char *q = strndup(s, n); if (!q) goto error_handler1; free(((struct SUpnpString *)p)->m_string); ((struct SUpnpString *)p)->m_length = strlen(q); ((struct SUpnpString *)p)->m_string = q; error_handler1: return q != NULL; } void UpnpString_clear(UpnpString *p) { ((struct SUpnpString *)p)->m_length = (size_t)0; /* No need to realloc now, will do later when needed. */ ((struct SUpnpString *)p)->m_string[0] = 0; } int UpnpString_cmp(UpnpString *p, UpnpString *q) { const char *cp = UpnpString_get_String(p); const char *cq = UpnpString_get_String(q); return strcmp(cp, cq); } int UpnpString_casecmp(UpnpString *p, UpnpString *q) { const char *cp = UpnpString_get_String(p); const char *cq = UpnpString_get_String(q); return strcasecmp(cp, cq); } /* @} UpnpString */ pupnp-release-1.8.0/upnp/src/api/upnpapi.c000066400000000000000000003363221303304015100204410ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (C) 2011-2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \addtogroup UPnPAPI * * @{ * * \file */ #include "config.h" #include "upnpapi.h" #include "httpreadwrite.h" #include "membuffer.h" #include "ssdplib.h" #include "soaplib.h" #include "sysdep.h" #include "ThreadPool.h" #include "UpnpStdInt.h" #include "UpnpUniStd.h" /* for close() */ #include "uuid.h" /* Needed for GENA */ #include "gena.h" #include "miniserver.h" #include "service_table.h" #ifdef INTERNAL_WEB_SERVER #include "urlconfig.h" #include "VirtualDir.h" #include "webserver.h" #endif /* INTERNAL_WEB_SERVER */ #include #include #include #include #include #ifdef WIN32 /* Do not include these files */ #else #include #include #include #endif #ifdef UPNP_ENABLE_OPEN_SSL #include #endif #ifndef IN6_IS_ADDR_GLOBAL #define IN6_IS_ADDR_GLOBAL(a) \ ((((__const uint32_t *) (a))[0] & htonl((uint32_t)0x70000000)) \ == htonl ((uint32_t)0x20000000)) #endif /* IS ADDR GLOBAL */ #ifndef IN6_IS_ADDR_ULA #define IN6_IS_ADDR_ULA(a) \ ((((__const uint32_t *) (a))[0] & htonl((uint32_t)0xfe000000)) \ == htonl ((uint32_t)0xfc000000)) #endif /* IS ADDR ULA */ /*! This structure is for virtual directory callbacks */ struct VirtualDirCallbacks virtualDirCallback; /*! Pointer to the virtual directory list. */ virtualDirList *pVirtualDirList; #ifdef INCLUDE_CLIENT_APIS /*! Mutex to synchronize the subscription handling at the client side. */ ithread_mutex_t GlobalClientSubscribeMutex; #endif /* INCLUDE_CLIENT_APIS */ /*! rwlock to synchronize handles (root device or control point handle). */ ithread_rwlock_t GlobalHndRWLock; /*! Mutex to synchronize the uuid creation process. */ ithread_mutex_t gUUIDMutex; /*! Initialization mutex. */ ithread_mutex_t gSDKInitMutex = PTHREAD_MUTEX_INITIALIZER; /*! Global timer thread. */ TimerThread gTimerThread; /*! Send thread pool. */ ThreadPool gSendThreadPool; /*! Receive thread pool. */ ThreadPool gRecvThreadPool; /*! Mini server thread pool. */ ThreadPool gMiniServerThreadPool; /*! Flag to indicate the state of web server */ WebServerState bWebServerState = WEB_SERVER_DISABLED; /*! Static buffer to contain interface name. (extern'ed in upnp.h) */ char gIF_NAME[LINE_SIZE] = { '\0' }; /*! Static buffer to contain interface IPv4 address. (extern'ed in upnp.h) */ char gIF_IPV4[INET_ADDRSTRLEN] = { '\0' }; /*! Static buffer to contain interface IPv6 address. (extern'ed in upnp.h) */ char gIF_IPV6[INET6_ADDRSTRLEN] = { '\0' }; /*! Static buffer to contain interface ULA or GUA IPv6 address. (extern'ed in upnp.h) */ char gIF_IPV6_ULA_GUA[INET6_ADDRSTRLEN] = { '\0' }; /*! Contains interface index. (extern'ed in upnp.h) */ unsigned gIF_INDEX = (unsigned)-1; /*! local IPv4 port for the mini-server */ unsigned short LOCAL_PORT_V4; /*! local IPv6 port for the mini-server */ unsigned short LOCAL_PORT_V6; /*! UPnP device and control point handle table */ #define NUM_HANDLE 200 static void *HandleTable[NUM_HANDLE]; /*! a local dir which serves as webserver root */ extern membuffer gDocumentRootDir; /*! Maximum content-length (in bytes) that the SDK will process on an incoming * packet. Content-Length exceeding this size will be not processed and * error 413 (HTTP Error Code) will be returned to the remote end point. */ size_t g_maxContentLength = DEFAULT_SOAP_CONTENT_LENGTH; /*! Global variable to denote the state of Upnp SDK == 0 if uninitialized, * == 1 if initialized. */ int UpnpSdkInit = 0; /*! Global variable to denote the state of Upnp SDK client registration. * == 0 if unregistered, == 1 if registered. */ int UpnpSdkClientRegistered = 0; /*! Global variable to denote the state of Upnp SDK IPv4 device registration. * == 0 if unregistered, == 1 if registered. */ int UpnpSdkDeviceRegisteredV4 = 0; /*! Global variable to denote the state of Upnp SDK IPv6 device registration. * == 0 if unregistered, == 1 if registered. */ int UpnpSdkDeviceregisteredV6 = 0; #ifdef UPNP_HAVE_OPTSSDP /*! Global variable used in discovery notifications. */ Upnp_SID gUpnpSdkNLSuuid; #endif /* UPNP_HAVE_OPTSSDP */ /*! Global variable used as to store the OpenSSL context object * to be used for all SSL/TLS connections */ #ifdef UPNP_ENABLE_OPEN_SSL SSL_CTX *gSslCtx = NULL; #endif /*! * \brief (Windows Only) Initializes the Windows Winsock library. * * \return UPNP_E_SUCCESS on success, UPNP_E_INIT_FAILED on failure. */ static int WinsockInit(void) { int retVal = UPNP_E_SUCCESS; #ifdef WIN32 WORD wVersionRequested; WSADATA wsaData; int err; wVersionRequested = MAKEWORD(2, 2); err = WSAStartup(wVersionRequested, &wsaData); if (err != 0) { /* Tell the user that we could not find a usable */ /* WinSock DLL. */ retVal = UPNP_E_INIT_FAILED; goto exit_function; } /* Confirm that the WinSock DLL supports 2.2. * Note that if the DLL supports versions greater * than 2.2 in addition to 2.2, it will still return * 2.2 in wVersion since that is the version we * requested. */ if (LOBYTE(wsaData.wVersion) != 2 || HIBYTE(wsaData.wVersion) != 2) { /* Tell the user that we could not find a usable * WinSock DLL. */ WSACleanup(); retVal = UPNP_E_INIT_FAILED; goto exit_function; } /* The WinSock DLL is acceptable. Proceed. */ exit_function: #else #endif return retVal; } /*! * \brief Initializes the global mutexes used by the UPnP SDK. * * \return UPNP_E_SUCCESS on success or UPNP_E_INIT_FAILED if a mutex could not * be initialized. */ static int UpnpInitMutexes(void) { #ifdef __CYGWIN__ /* On Cygwin, pthread_mutex_init() fails without this memset. */ /* TODO: Fix Cygwin so we don't need this memset(). */ memset(&GlobalHndRWLock, 0, sizeof(GlobalHndRWLock)); #endif if (ithread_rwlock_init(&GlobalHndRWLock, NULL) != 0) { return UPNP_E_INIT_FAILED; } if (ithread_mutex_init(&gUUIDMutex, NULL) != 0) { return UPNP_E_INIT_FAILED; } /* initialize subscribe mutex. */ #ifdef INCLUDE_CLIENT_APIS if (ithread_mutex_init(&GlobalClientSubscribeMutex, NULL) != 0) { return UPNP_E_INIT_FAILED; } #endif return UPNP_E_SUCCESS; } /*! * \brief Initializes the global threadm pools used by the UPnP SDK. * * \return UPNP_E_SUCCESS on success or UPNP_E_INIT_FAILED if a mutex could not * be initialized. */ static int UpnpInitThreadPools(void) { int ret = UPNP_E_SUCCESS; ThreadPoolAttr attr; TPAttrInit(&attr); TPAttrSetMaxThreads(&attr, MAX_THREADS); TPAttrSetMinThreads(&attr, MIN_THREADS); TPAttrSetStackSize(&attr, THREAD_STACK_SIZE); TPAttrSetJobsPerThread(&attr, JOBS_PER_THREAD); TPAttrSetIdleTime(&attr, THREAD_IDLE_TIME); TPAttrSetMaxJobsTotal(&attr, MAX_JOBS_TOTAL); if (ThreadPoolInit(&gSendThreadPool, &attr) != UPNP_E_SUCCESS) { ret = UPNP_E_INIT_FAILED; goto exit_function; } if (ThreadPoolInit(&gRecvThreadPool, &attr) != UPNP_E_SUCCESS) { ret = UPNP_E_INIT_FAILED; goto exit_function; } if (ThreadPoolInit(&gMiniServerThreadPool, &attr) != UPNP_E_SUCCESS) { ret = UPNP_E_INIT_FAILED; goto exit_function; } exit_function: if (ret != UPNP_E_SUCCESS) { UpnpSdkInit = 0; UpnpFinish(); } return ret; } /*! * \brief Performs the initial steps in initializing the UPnP SDK. * * \li Winsock library is initialized for the process (Windows specific). * \li The logging (for debug messages) is initialized. * \li Mutexes, Handle table and thread pools are allocated and initialized. * \li Callback functions for SOAP and GENA are set, if they're enabled. * \li The SDK timer thread is initialized. * * \return UPNP_E_SUCCESS on success. */ static int UpnpInitPreamble(void) { int retVal = UPNP_E_SUCCESS; int i; #ifdef UPNP_HAVE_OPTSSDP uuid_upnp nls_uuid; #endif /* UPNP_HAVE_OPTSSDP */ retVal = WinsockInit(); if (retVal != UPNP_E_SUCCESS) { return retVal; } /* needed by SSDP or other parts. */ srand((unsigned int)time(NULL)); /* Initialize debug output. */ retVal = UpnpInitLog(); if (retVal != UPNP_E_SUCCESS) { /* UpnpInitLog does not return a valid UPNP_E_*. */ return UPNP_E_INIT_FAILED; } UpnpPrintf( UPNP_INFO, API, __FILE__, __LINE__, "Inside UpnpInitPreamble\n" ); /* Initialize SDK global mutexes. */ retVal = UpnpInitMutexes(); if (retVal != UPNP_E_SUCCESS) { return retVal; } #ifdef UPNP_HAVE_OPTSSDP /* Create the NLS uuid. */ uuid_create(&nls_uuid); uuid_unpack(&nls_uuid, gUpnpSdkNLSuuid); #endif /* UPNP_HAVE_OPTSSDP */ /* Initializes the handle list. */ HandleLock(); for (i = 0; i < NUM_HANDLE; ++i) { HandleTable[i] = NULL; } HandleUnlock(); /* Initialize SDK global thread pools. */ retVal = UpnpInitThreadPools(); if (retVal != UPNP_E_SUCCESS) { return retVal; } #ifdef INCLUDE_DEVICE_APIS #if EXCLUDE_SOAP == 0 SetSoapCallback(soap_device_callback); #endif #endif /* INCLUDE_DEVICE_APIS */ #ifdef INTERNAL_WEB_SERVER #if EXCLUDE_GENA == 0 SetGenaCallback(genaCallback); #endif #endif /* INTERNAL_WEB_SERVER */ /* Initialize the SDK timer thread. */ retVal = TimerThreadInit( &gTimerThread, &gSendThreadPool ); if (retVal != UPNP_E_SUCCESS) { UpnpFinish(); return retVal; } return UPNP_E_SUCCESS; } /*! * \brief Finishes initializing the UPnP SDK. * \li The MiniServer is started, if enabled. * \li The WebServer is started, if enabled. * * \return UPNP_E_SUCCESS on success or UPNP_E_INIT_FAILED if a mutex could not * be initialized. */ static int UpnpInitStartServers( /*! [in] Local Port to listen for incoming connections. */ unsigned short DestPort) { #if EXCLUDE_MINISERVER == 0 || EXCLUDE_WEB_SERVER == 0 int retVal = 0; #endif UpnpPrintf( UPNP_INFO, API, __FILE__, __LINE__, "Entering UpnpInitStartServers\n" ); #if EXCLUDE_MINISERVER == 0 LOCAL_PORT_V4 = DestPort; LOCAL_PORT_V6 = DestPort; retVal = StartMiniServer(&LOCAL_PORT_V4, &LOCAL_PORT_V6); if (retVal != UPNP_E_SUCCESS) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "Miniserver failed to start"); UpnpFinish(); return retVal; } #endif #if EXCLUDE_WEB_SERVER == 0 membuffer_init(&gDocumentRootDir); retVal = UpnpEnableWebserver(WEB_SERVER_ENABLED); if (retVal != UPNP_E_SUCCESS) { UpnpFinish(); return retVal; } #endif UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Exiting UpnpInitStartServers\n"); return UPNP_E_SUCCESS; } int UpnpInit(const char *HostIP, unsigned short DestPort) { int retVal = UPNP_E_SUCCESS; /* Initializes the ithread library */ ithread_initialize_library(); ithread_mutex_lock(&gSDKInitMutex); /* Check if we're already initialized. */ if (UpnpSdkInit == 1) { retVal = UPNP_E_INIT; goto exit_function; } /* Perform initialization preamble. */ retVal = UpnpInitPreamble(); if (retVal != UPNP_E_SUCCESS) { goto exit_function; } UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "UpnpInit with HostIP=%s, DestPort=%d.\n", HostIP ? HostIP : "", (int)DestPort); /* Verify HostIP, if provided, or find it ourselves. */ memset(gIF_IPV4, 0, sizeof(gIF_IPV4)); if (HostIP != NULL) { strncpy(gIF_IPV4, HostIP, sizeof(gIF_IPV4) - 1); } else { if( getlocalhostname( gIF_IPV4, sizeof(gIF_IPV4) - 1 ) != UPNP_E_SUCCESS ) { retVal = UPNP_E_INIT_FAILED; goto exit_function; } } /* Set the UpnpSdkInit flag to 1 to indicate we're successfully initialized. */ UpnpSdkInit = 1; /* Finish initializing the SDK. */ retVal = UpnpInitStartServers(DestPort); if (retVal != UPNP_E_SUCCESS) { UpnpSdkInit = 0; goto exit_function; } UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Host Ip: %s Host Port: %d\n", gIF_IPV4, (int)LOCAL_PORT_V4); exit_function: ithread_mutex_unlock(&gSDKInitMutex); return retVal; } #ifdef UPNP_ENABLE_IPV6 int UpnpInit2(const char *IfName, unsigned short DestPort) { int retVal; /* Initializes the ithread library */ ithread_initialize_library(); ithread_mutex_lock(&gSDKInitMutex); /* Check if we're already initialized. */ if (UpnpSdkInit == 1) { retVal = UPNP_E_INIT; goto exit_function; } /* Perform initialization preamble. */ retVal = UpnpInitPreamble(); if (retVal != UPNP_E_SUCCESS) { goto exit_function; } UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "UpnpInit2 with IfName=%s, DestPort=%d.\n", IfName ? IfName : "", DestPort); /* Retrieve interface information (Addresses, index, etc). */ retVal = UpnpGetIfInfo( IfName ); if (retVal != UPNP_E_SUCCESS) { goto exit_function; } /* Set the UpnpSdkInit flag to 1 to indicate we're successfully initialized. */ UpnpSdkInit = 1; /* Finish initializing the SDK. */ retVal = UpnpInitStartServers(DestPort); if (retVal != UPNP_E_SUCCESS) { UpnpSdkInit = 0; goto exit_function; } exit_function: ithread_mutex_unlock(&gSDKInitMutex); return retVal; } #endif #ifdef UPNP_ENABLE_OPEN_SSL int UpnpInitSslContext(int initOpenSslLib, const SSL_METHOD *sslMethod) { if (gSslCtx) return UPNP_E_INIT; if (initOpenSslLib) { SSL_load_error_strings(); SSL_library_init(); OpenSSL_add_all_algorithms(); } gSslCtx = SSL_CTX_new(sslMethod); if (!gSslCtx) { return UPNP_E_INIT_FAILED; } return UPNP_E_SUCCESS; } #endif #ifdef DEBUG /*! * \brief Prints thread pool statistics. */ void PrintThreadPoolStats( /*! [in] The thread pool. */ ThreadPool *tp, /*! [in] The file name that called this function, use the macro * __FILE__. */ const char *DbgFileName, /*! [in] The line number that the function was called, use the macro * __LINE__. */ int DbgLineNo, /*! [in] The message. */ const char *msg) { ThreadPoolStats stats; ThreadPoolGetStats(tp, &stats); UpnpPrintf(UPNP_INFO, API, DbgFileName, DbgLineNo, "%s\n" "High Jobs pending: %d\n" "Med Jobs Pending: %d\n" "Low Jobs Pending: %d\n" "Average wait in High Q in milliseconds: %lf\n" "Average wait in Med Q in milliseconds: %lf\n" "Average wait in Low Q in milliseconds: %lf\n" "Max Threads Used: %d\n" "Worker Threads: %d\n" "Persistent Threads: %d\n" "Idle Threads: %d\n" "Total Threads: %d\n" "Total Work Time: %lf\n" "Total Idle Time: %lf\n", msg, stats.currentJobsHQ, stats.currentJobsMQ, stats.currentJobsLQ, stats.avgWaitHQ, stats.avgWaitMQ, stats.avgWaitLQ, stats.maxThreads, stats.workerThreads, stats.persistentThreads, stats.idleThreads, stats.totalThreads, stats.totalWorkTime, stats.totalIdleTime); } #else static UPNP_INLINE void PrintThreadPoolStats(ThreadPool *tp, const char *DbgFileName, int DbgLineNo, const char *msg) { return; tp = tp; DbgFileName = DbgFileName; DbgLineNo = DbgLineNo; msg = msg; } #endif /* DEBUG */ int UpnpFinish(void) { #ifdef INCLUDE_DEVICE_APIS UpnpDevice_Handle device_handle; #endif #ifdef INCLUDE_CLIENT_APIS UpnpClient_Handle client_handle; #endif struct Handle_Info *temp; #ifdef UPNP_ENABLE_OPEN_SSL if (gSslCtx) { SSL_CTX_free(gSslCtx); gSslCtx = NULL; } #endif if (UpnpSdkInit != 1) return UPNP_E_FINISH; UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Inside UpnpFinish: UpnpSdkInit is %d\n", UpnpSdkInit); if (UpnpSdkInit == 1) UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "UpnpFinish: UpnpSdkInit is ONE\n"); PrintThreadPoolStats(&gSendThreadPool, __FILE__, __LINE__, "Send Thread Pool"); PrintThreadPoolStats(&gRecvThreadPool, __FILE__, __LINE__, "Recv Thread Pool"); PrintThreadPoolStats(&gMiniServerThreadPool, __FILE__, __LINE__, "MiniServer Thread Pool"); #ifdef INCLUDE_DEVICE_APIS switch (GetDeviceHandleInfo(AF_INET, &device_handle, &temp)) { case HND_DEVICE: UpnpUnRegisterRootDevice(device_handle); break; default: break; } switch (GetDeviceHandleInfo(AF_INET6, &device_handle, &temp)) { case HND_DEVICE: UpnpUnRegisterRootDevice(device_handle); break; default: break; } #endif #ifdef INCLUDE_CLIENT_APIS switch (GetClientHandleInfo(&client_handle, &temp)) { case HND_CLIENT: UpnpUnRegisterClient(client_handle); break; default: break; } #endif TimerThreadShutdown(&gTimerThread); #if EXCLUDE_MINISERVER == 0 StopMiniServer(); #endif #if EXCLUDE_WEB_SERVER == 0 web_server_destroy(); #endif ThreadPoolShutdown(&gMiniServerThreadPool); PrintThreadPoolStats(&gMiniServerThreadPool, __FILE__, __LINE__, "MiniServer Thread Pool"); ThreadPoolShutdown(&gRecvThreadPool); PrintThreadPoolStats(&gSendThreadPool, __FILE__, __LINE__, "Send Thread Pool"); ThreadPoolShutdown(&gSendThreadPool); PrintThreadPoolStats(&gRecvThreadPool, __FILE__, __LINE__, "Recv Thread Pool"); #ifdef INCLUDE_CLIENT_APIS ithread_mutex_destroy(&GlobalClientSubscribeMutex); #endif ithread_rwlock_destroy(&GlobalHndRWLock); ithread_mutex_destroy(&gUUIDMutex); /* remove all virtual dirs */ UpnpRemoveAllVirtualDirs(); UpnpSdkInit = 0; UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Exiting UpnpFinish: UpnpSdkInit is :%d:\n", UpnpSdkInit); UpnpCloseLog(); /* Clean-up ithread library resources */ ithread_cleanup_library(); return UPNP_E_SUCCESS; } unsigned short UpnpGetServerPort(void) { if (UpnpSdkInit != 1) return 0u; return LOCAL_PORT_V4; } #ifdef UPNP_ENABLE_IPV6 unsigned short UpnpGetServerPort6(void) { if (UpnpSdkInit != 1) return 0u; return LOCAL_PORT_V6; } #endif char *UpnpGetServerIpAddress(void) { if (UpnpSdkInit != 1) return NULL; return gIF_IPV4; } char *UpnpGetServerIp6Address(void) { if (UpnpSdkInit != 1) return NULL; return gIF_IPV6; } char *UpnpGetServerUlaGuaIp6Address(void) { if (UpnpSdkInit != 1) return NULL; return gIF_IPV6_ULA_GUA; } /*! * \brief Get a free handle. * * \return On success, an integer greater than zero or UPNP_E_OUTOF_HANDLE on * failure. */ static int GetFreeHandle() { /* Handle 0 is not used as NULL translates to 0 when passed as a handle */ int i = 1; while (i < NUM_HANDLE && HandleTable[i] != NULL) ++i; if (i == NUM_HANDLE) return UPNP_E_OUTOF_HANDLE; else return i; } /*! * \brief Free handle. * * \return UPNP_E_SUCCESS if successful or UPNP_E_INVALID_HANDLE if not */ static int FreeHandle( /*! [in] Handle index. */ int Upnp_Handle) { int ret = UPNP_E_INVALID_HANDLE; UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "FreeHandle: entering, Handle is %d\n", Upnp_Handle); if (Upnp_Handle < 1 || Upnp_Handle >= NUM_HANDLE) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "FreeHandle: Handle %d is out of range\n", Upnp_Handle); } else if (HandleTable[Upnp_Handle] == NULL) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "FreeHandle: HandleTable[%d] is NULL\n", Upnp_Handle); } else { free( HandleTable[Upnp_Handle] ); HandleTable[Upnp_Handle] = NULL; ret = UPNP_E_SUCCESS; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "FreeHandle: exiting, ret = %d.\n", ret); return ret; } #ifdef INCLUDE_DEVICE_APIS int UpnpRegisterRootDevice( const char *DescUrl, Upnp_FunPtr Fun, const void *Cookie, UpnpDevice_Handle *Hnd) { struct Handle_Info *HInfo = NULL; int retVal = 0; #if EXCLUDE_GENA == 0 int hasServiceTable = 0; #endif /* EXCLUDE_GENA */ HandleLock(); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpRegisterRootDevice\n"); if (UpnpSdkInit != 1) { retVal = UPNP_E_FINISH; goto exit_function; } if (Hnd == NULL || Fun == NULL || DescUrl == NULL || strlen(DescUrl) == (size_t)0) { retVal = UPNP_E_INVALID_PARAM; goto exit_function; } if (UpnpSdkDeviceRegisteredV4 == 1) { retVal = UPNP_E_ALREADY_REGISTERED; goto exit_function; } *Hnd = GetFreeHandle(); if (*Hnd == UPNP_E_OUTOF_HANDLE) { retVal = UPNP_E_OUTOF_MEMORY; goto exit_function; } HInfo = (struct Handle_Info *)malloc(sizeof (struct Handle_Info)); if (HInfo == NULL) { retVal = UPNP_E_OUTOF_MEMORY; goto exit_function; } memset(HInfo, 0, sizeof(struct Handle_Info)); HandleTable[*Hnd] = HInfo; UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Root device URL is %s\n", DescUrl ); HInfo->aliasInstalled = 0; HInfo->HType = HND_DEVICE; strncpy(HInfo->DescURL, DescUrl, sizeof(HInfo->DescURL) - 1); strncpy(HInfo->LowerDescURL, DescUrl, sizeof(HInfo->LowerDescURL) - 1); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Following Root Device URL will be used when answering to legacy CPs %s\n", HInfo->LowerDescURL); HInfo->Callback = Fun; HInfo->Cookie = (void *)Cookie; HInfo->MaxAge = DEFAULT_MAXAGE; HInfo->DeviceList = NULL; HInfo->ServiceList = NULL; HInfo->DescDocument = NULL; #ifdef INCLUDE_CLIENT_APIS ListInit(&HInfo->SsdpSearchList, NULL, NULL); HInfo->ClientSubList = NULL; #endif /* INCLUDE_CLIENT_APIS */ HInfo->MaxSubscriptions = UPNP_INFINITE; HInfo->MaxSubscriptionTimeOut = UPNP_INFINITE; HInfo->DeviceAf = AF_INET; retVal = UpnpDownloadXmlDoc(HInfo->DescURL, &(HInfo->DescDocument)); if (retVal != UPNP_E_SUCCESS) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice: error downloading Document: %d\n", retVal); #ifdef INCLUDE_CLIENT_APIS ListDestroy(&HInfo->SsdpSearchList, 0); #endif /* INCLUDE_CLIENT_APIS */ FreeHandle(*Hnd); goto exit_function; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice: Valid Description\n" "UpnpRegisterRootDevice: DescURL : %s\n", HInfo->DescURL); HInfo->DeviceList = ixmlDocument_getElementsByTagName(HInfo->DescDocument, "device"); if (!HInfo->DeviceList) { #ifdef INCLUDE_CLIENT_APIS ListDestroy(&HInfo->SsdpSearchList, 0); #endif /* INCLUDE_CLIENT_APIS */ ixmlDocument_free(HInfo->DescDocument); FreeHandle(*Hnd); UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice: No devices found for RootDevice\n"); retVal = UPNP_E_INVALID_DESC; goto exit_function; } HInfo->ServiceList = ixmlDocument_getElementsByTagName( HInfo->DescDocument, "serviceList"); if (!HInfo->ServiceList) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice: No services found for RootDevice\n"); } #if EXCLUDE_GENA == 0 /* * GENA SET UP */ UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice: Gena Check\n"); memset(&HInfo->ServiceTable, 0, sizeof(HInfo->ServiceTable)); hasServiceTable = getServiceTable( (IXML_Node *)HInfo->DescDocument, &HInfo->ServiceTable, HInfo->DescURL); if (hasServiceTable) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice: GENA Service Table\n" "Here are the known services:\n"); printServiceTable( &HInfo->ServiceTable, UPNP_ALL, API ); } else { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "\nUpnpRegisterRootDevice: Empty service table\n"); } #endif /* EXCLUDE_GENA */ UpnpSdkDeviceRegisteredV4 = 1; retVal = UPNP_E_SUCCESS; exit_function: UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting RegisterRootDevice, return value == %d\n", retVal); HandleUnlock(); return retVal; } #endif /* INCLUDE_DEVICE_APIS */ /*! * \brief Fills the sockadr_in with miniserver information. */ static int GetDescDocumentAndURL( /* [in] pointer to server address structure. */ Upnp_DescType descriptionType, /* [in] . */ char *description, /* [in] . */ int config_baseURL, /* [in] . */ int AddressFamily, /* [out] . */ IXML_Document **xmlDoc, /* [out] . */ char descURL[LINE_SIZE]); #ifdef INCLUDE_DEVICE_APIS int UpnpRegisterRootDevice2( Upnp_DescType descriptionType, const char *description_const, size_t bufferLen, /* ignored */ int config_baseURL, Upnp_FunPtr Fun, const void *Cookie, UpnpDevice_Handle *Hnd) { struct Handle_Info *HInfo = NULL; int retVal = 0; #if EXCLUDE_GENA == 0 int hasServiceTable = 0; #endif /* EXCLUDE_GENA */ char *description = (char *)description_const; HandleLock(); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpRegisterRootDevice2\n"); if (UpnpSdkInit != 1) { retVal = UPNP_E_FINISH; goto exit_function; } if (Hnd == NULL || Fun == NULL) { retVal = UPNP_E_INVALID_PARAM; goto exit_function; } if (UpnpSdkDeviceRegisteredV4 == 1) { retVal = UPNP_E_ALREADY_REGISTERED; goto exit_function; } *Hnd = GetFreeHandle(); if (*Hnd == UPNP_E_OUTOF_HANDLE) { retVal = UPNP_E_OUTOF_MEMORY; goto exit_function; } HInfo = (struct Handle_Info *)malloc(sizeof (struct Handle_Info)); if (HInfo == NULL) { retVal = UPNP_E_OUTOF_MEMORY; goto exit_function; } memset(HInfo, 0, sizeof(struct Handle_Info)); HandleTable[*Hnd] = HInfo; /* prevent accidental removal of a non-existent alias */ HInfo->aliasInstalled = 0; retVal = GetDescDocumentAndURL( descriptionType, description, config_baseURL, AF_INET, &HInfo->DescDocument, HInfo->DescURL); if (retVal != UPNP_E_SUCCESS) { FreeHandle(*Hnd); goto exit_function; } strncpy(HInfo->LowerDescURL, HInfo->DescURL, sizeof(HInfo->LowerDescURL) - 1); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Following Root Device URL will be used when answering to legacy CPs %s\n", HInfo->LowerDescURL); HInfo->aliasInstalled = config_baseURL != 0; HInfo->HType = HND_DEVICE; HInfo->Callback = Fun; HInfo->Cookie = (void *)Cookie; HInfo->MaxAge = DEFAULT_MAXAGE; HInfo->DeviceList = NULL; HInfo->ServiceList = NULL; #ifdef INCLUDE_CLIENT_APIS ListInit(&HInfo->SsdpSearchList, NULL, NULL); HInfo->ClientSubList = NULL; #endif /* INCLUDE_CLIENT_APIS */ HInfo->MaxSubscriptions = UPNP_INFINITE; HInfo->MaxSubscriptionTimeOut = UPNP_INFINITE; HInfo->DeviceAf = AF_INET; UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice2: Valid Description\n" "UpnpRegisterRootDevice2: DescURL : %s\n", HInfo->DescURL); HInfo->DeviceList = ixmlDocument_getElementsByTagName( HInfo->DescDocument, "device" ); if (!HInfo->DeviceList) { #ifdef INCLUDE_CLIENT_APIS ListDestroy(&HInfo->SsdpSearchList, 0); #endif /* INCLUDE_CLIENT_APIS */ ixmlDocument_free(HInfo->DescDocument); FreeHandle(*Hnd); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice2: No devices found for RootDevice\n" ); retVal = UPNP_E_INVALID_DESC; goto exit_function; } HInfo->ServiceList = ixmlDocument_getElementsByTagName( HInfo->DescDocument, "serviceList" ); if (!HInfo->ServiceList) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice2: No services found for RootDevice\n"); } #if EXCLUDE_GENA == 0 /* * GENA SET UP */ UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice2: Gena Check\n" ); memset(&HInfo->ServiceTable, 0, sizeof(HInfo->ServiceTable)); hasServiceTable = getServiceTable( (IXML_Node *)HInfo->DescDocument, &HInfo->ServiceTable, HInfo->DescURL); if (hasServiceTable) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice2: GENA Service Table\n" "Here are the known services: \n"); printServiceTable(&HInfo->ServiceTable, UPNP_ALL, API); } else { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "\nUpnpRegisterRootDevice2: Empty service table\n"); } #endif /* EXCLUDE_GENA */ UpnpSdkDeviceRegisteredV4 = 1; retVal = UPNP_E_SUCCESS; exit_function: UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting RegisterRootDevice2, return value == %d\n", retVal); HandleUnlock(); return retVal; bufferLen = bufferLen; } #endif /* INCLUDE_DEVICE_APIS */ #ifdef INCLUDE_DEVICE_APIS int UpnpRegisterRootDevice3( const char *DescUrl, Upnp_FunPtr Fun, const void *Cookie, UpnpDevice_Handle *Hnd, int AddressFamily) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpRegisterRootDevice3\n"); return UpnpRegisterRootDevice4(DescUrl, Fun, Cookie, Hnd, AddressFamily, NULL); } #endif /* INCLUDE_DEVICE_APIS */ #ifdef INCLUDE_DEVICE_APIS int UpnpRegisterRootDevice4( const char *DescUrl, Upnp_FunPtr Fun, const void *Cookie, UpnpDevice_Handle *Hnd, int AddressFamily, const char *LowerDescUrl) { struct Handle_Info *HInfo; int retVal = 0; #if EXCLUDE_GENA == 0 int hasServiceTable = 0; #endif /* EXCLUDE_GENA */ int handler_index = 0; HandleLock(); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpRegisterRootDevice4\n"); if (UpnpSdkInit != 1) { retVal = UPNP_E_FINISH; goto exit_function; } if (Hnd == NULL || Fun == NULL || DescUrl == NULL || strlen(DescUrl) == (size_t)0 || (AddressFamily != AF_INET && AddressFamily != AF_INET6)) { retVal = UPNP_E_INVALID_PARAM; goto exit_function; } /* Test for already regsitered IPV4. */ if (AddressFamily == AF_INET && UpnpSdkDeviceRegisteredV4 == 1) { retVal = UPNP_E_ALREADY_REGISTERED; goto exit_function; } /* Test for already registered IPV6. IPV6 devices might register on multiple * IPv6 addresses (link local and GUA or ULA), so we must to check the * description URL in the HandleTable. */ while (handler_index < NUM_HANDLE && HandleTable[handler_index] != NULL) { if (strcmp(((struct Handle_Info *)HandleTable[handler_index])->DescURL, DescUrl)) { retVal = UPNP_E_ALREADY_REGISTERED; goto exit_function; } handler_index++; } *Hnd = GetFreeHandle(); if (*Hnd == UPNP_E_OUTOF_HANDLE) { retVal = UPNP_E_OUTOF_MEMORY; goto exit_function; } HInfo = (struct Handle_Info *)malloc(sizeof (struct Handle_Info)); if (HInfo == NULL) { retVal = UPNP_E_OUTOF_MEMORY; goto exit_function; } memset(HInfo, 0, sizeof(struct Handle_Info)); HandleTable[*Hnd] = HInfo; UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Root device URL is %s\n", DescUrl); HInfo->aliasInstalled = 0; HInfo->HType = HND_DEVICE; strncpy(HInfo->DescURL, DescUrl, sizeof(HInfo->DescURL) - 1); if (LowerDescUrl == NULL) strncpy(HInfo->LowerDescURL, DescUrl, sizeof(HInfo->LowerDescURL) - 1); else strncpy(HInfo->LowerDescURL, LowerDescUrl, sizeof(HInfo->LowerDescURL) - 1); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Following Root Device URL will be used when answering to legacy CPs %s\n", HInfo->LowerDescURL); HInfo->Callback = Fun; HInfo->Cookie = (void *)Cookie; HInfo->MaxAge = DEFAULT_MAXAGE; HInfo->DeviceList = NULL; HInfo->ServiceList = NULL; HInfo->DescDocument = NULL; #ifdef INCLUDE_CLIENT_APIS ListInit(&HInfo->SsdpSearchList, NULL, NULL); HInfo->ClientSubList = NULL; #endif /* INCLUDE_CLIENT_APIS */ HInfo->MaxSubscriptions = UPNP_INFINITE; HInfo->MaxSubscriptionTimeOut = UPNP_INFINITE; HInfo->DeviceAf = AddressFamily; retVal = UpnpDownloadXmlDoc(HInfo->DescURL, &(HInfo->DescDocument)); if (retVal != UPNP_E_SUCCESS) { #ifdef INCLUDE_CLIENT_APIS ListDestroy(&HInfo->SsdpSearchList, 0); #endif /* INCLUDE_CLIENT_APIS */ FreeHandle(*Hnd); goto exit_function; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice4: Valid Description\n" "UpnpRegisterRootDevice4: DescURL : %s\n", HInfo->DescURL); HInfo->DeviceList = ixmlDocument_getElementsByTagName( HInfo->DescDocument, "device"); if (!HInfo->DeviceList) { #ifdef INCLUDE_CLIENT_APIS ListDestroy(&HInfo->SsdpSearchList, 0); #endif /* INCLUDE_CLIENT_APIS */ ixmlDocument_free(HInfo->DescDocument); FreeHandle(*Hnd); UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice4: No devices found for RootDevice\n"); retVal = UPNP_E_INVALID_DESC; goto exit_function; } HInfo->ServiceList = ixmlDocument_getElementsByTagName( HInfo->DescDocument, "serviceList" ); if (!HInfo->ServiceList) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice4: No services found for RootDevice\n"); } #if EXCLUDE_GENA == 0 /* * GENA SET UP */ UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice4: Gena Check\n" ); memset(&HInfo->ServiceTable, 0, sizeof(HInfo->ServiceTable)); hasServiceTable = getServiceTable( (IXML_Node *)HInfo->DescDocument, &HInfo->ServiceTable, HInfo->DescURL); if (hasServiceTable) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "UpnpRegisterRootDevice4: GENA Service Table \n" "Here are the known services: \n" ); printServiceTable(&HInfo->ServiceTable, UPNP_ALL, API); } else { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "\nUpnpRegisterRootDevice4: Empty service table\n"); } #endif /* EXCLUDE_GENA */ switch (AddressFamily) { case AF_INET: UpnpSdkDeviceRegisteredV4 = 1; break; default: UpnpSdkDeviceregisteredV6 = 1; } retVal = UPNP_E_SUCCESS; exit_function: UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting RegisterRootDevice4, return value == %d\n", retVal); HandleUnlock(); return retVal; } #endif /* INCLUDE_DEVICE_APIS */ #ifdef INCLUDE_DEVICE_APIS int UpnpUnRegisterRootDevice(UpnpDevice_Handle Hnd) { UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Inside UpnpUnRegisterRootDevice\n"); return UpnpUnRegisterRootDeviceLowPower(Hnd, -1, -1, -1); } int UpnpUnRegisterRootDeviceLowPower(UpnpDevice_Handle Hnd, int PowerState, int SleepPeriod, int RegistrationState) { int retVal = 0; struct Handle_Info *HInfo = NULL; if (UpnpSdkInit != 1) return UPNP_E_FINISH; UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Inside UpnpUnRegisterRootDeviceLowPower\n"); #if EXCLUDE_GENA == 0 if (genaUnregisterDevice(Hnd) != UPNP_E_SUCCESS) return UPNP_E_INVALID_HANDLE; #endif HandleLock(); switch (GetHandleInfo(Hnd, &HInfo)) { case HND_INVALID: HandleUnlock(); return UPNP_E_INVALID_HANDLE; default: break; } HInfo->PowerState = PowerState; if( SleepPeriod < 0 ) SleepPeriod = -1; HInfo->SleepPeriod = SleepPeriod; HInfo->RegistrationState = RegistrationState; HandleUnlock(); #if EXCLUDE_SSDP == 0 retVal = AdvertiseAndReply(-1, Hnd, (enum SsdpSearchType)0, (struct sockaddr *)NULL, (char *)NULL, (char *)NULL, (char *)NULL, HInfo->MaxAge); #endif HandleLock(); switch (GetHandleInfo(Hnd, &HInfo)) { case HND_INVALID: HandleUnlock(); return UPNP_E_INVALID_HANDLE; default: break; } ixmlNodeList_free(HInfo->DeviceList); ixmlNodeList_free(HInfo->ServiceList); ixmlDocument_free(HInfo->DescDocument); #ifdef INCLUDE_CLIENT_APIS ListDestroy(&HInfo->SsdpSearchList, 0); #endif /* INCLUDE_CLIENT_APIS */ #ifdef INTERNAL_WEB_SERVER if (HInfo->aliasInstalled) web_server_set_alias(NULL, NULL, 0, 0); #endif /* INTERNAL_WEB_SERVER */ switch (HInfo->DeviceAf) { case AF_INET: UpnpSdkDeviceRegisteredV4 = 0; break; case AF_INET6: UpnpSdkDeviceregisteredV6 = 0; break; default: break; } FreeHandle(Hnd); HandleUnlock(); UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Exiting UpnpUnRegisterRootDeviceLowPower\n"); return retVal; } #endif /* INCLUDE_DEVICE_APIS */ #ifdef INCLUDE_CLIENT_APIS int UpnpRegisterClient(Upnp_FunPtr Fun, const void *Cookie, UpnpClient_Handle *Hnd) { struct Handle_Info *HInfo; if (UpnpSdkInit != 1) return UPNP_E_FINISH; UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpRegisterClient \n"); if (Fun == NULL || Hnd == NULL) return UPNP_E_INVALID_PARAM; HandleLock(); if (UpnpSdkClientRegistered) { HandleUnlock(); return UPNP_E_ALREADY_REGISTERED; } if ((*Hnd = GetFreeHandle()) == UPNP_E_OUTOF_HANDLE) { HandleUnlock(); return UPNP_E_OUTOF_MEMORY; } HInfo = (struct Handle_Info *)malloc(sizeof(struct Handle_Info)); if (HInfo == NULL) { HandleUnlock(); return UPNP_E_OUTOF_MEMORY; } HInfo->HType = HND_CLIENT; HInfo->Callback = Fun; HInfo->Cookie = (void *)Cookie; HInfo->ClientSubList = NULL; ListInit(&HInfo->SsdpSearchList, NULL, NULL); #ifdef INCLUDE_DEVICE_APIS HInfo->MaxAge = 0; HInfo->MaxSubscriptions = UPNP_INFINITE; HInfo->MaxSubscriptionTimeOut = UPNP_INFINITE; #endif HandleTable[*Hnd] = HInfo; UpnpSdkClientRegistered = 1; HandleUnlock(); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpRegisterClient \n"); return UPNP_E_SUCCESS; } #endif /* INCLUDE_CLIENT_APIS */ #ifdef INCLUDE_CLIENT_APIS int UpnpUnRegisterClient(UpnpClient_Handle Hnd) { struct Handle_Info *HInfo; ListNode *node = NULL; SsdpSearchArg *searchArg = NULL; if (UpnpSdkInit != 1) return UPNP_E_FINISH; UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpUnRegisterClient \n"); HandleLock(); if (!UpnpSdkClientRegistered) { HandleUnlock(); return UPNP_E_INVALID_HANDLE; } HandleUnlock(); #if EXCLUDE_GENA == 0 if (genaUnregisterClient(Hnd) != UPNP_E_SUCCESS) return UPNP_E_INVALID_HANDLE; #endif HandleLock(); switch (GetHandleInfo(Hnd, &HInfo)) { case HND_INVALID: HandleUnlock(); return UPNP_E_INVALID_HANDLE; default: break; } /* clean up search list */ node = ListHead(&HInfo->SsdpSearchList); while (node != NULL) { searchArg = (SsdpSearchArg *) node->item; if (searchArg) { free(searchArg->searchTarget); free(searchArg); } ListDelNode(&HInfo->SsdpSearchList, node, 0); node = ListHead(&HInfo->SsdpSearchList); } ListDestroy(&HInfo->SsdpSearchList, 0); FreeHandle(Hnd); UpnpSdkClientRegistered = 0; HandleUnlock(); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpUnRegisterClient \n"); return UPNP_E_SUCCESS; } #endif /* INCLUDE_CLIENT_APIS */ #ifdef INCLUDE_DEVICE_APIS #ifdef INTERNAL_WEB_SERVER /*! * \brief Determines alias for given name which is a file name or URL. * * \return UPNP_E_SUCCESS on success, nonzero on failure. */ static int GetNameForAlias( /*! [in] Name of the file. */ char *name, /*! [out] Pointer to alias string. */ char **alias) { char *ext; char *al; ext = strrchr( name, '.' ); if( ext == NULL || strcasecmp( ext, ".xml" ) != 0 ) { return UPNP_E_EXT_NOT_XML; } al = strrchr( name, '/' ); if( al == NULL ) { *alias = name; } else { *alias = al; } return UPNP_E_SUCCESS; } /*! * \brief Fill the sockadr with IPv4 miniserver information. */ static void get_server_addr( /*! [out] pointer to server address structure. */ struct sockaddr *serverAddr) { struct sockaddr_in* sa4 = (struct sockaddr_in*)serverAddr; memset( serverAddr, 0, sizeof(struct sockaddr_storage) ); sa4->sin_family = AF_INET; inet_pton( AF_INET, gIF_IPV4, &sa4->sin_addr ); sa4->sin_port = htons( LOCAL_PORT_V4 ); } /*! * \brief Fill the sockadr with IPv6 miniserver information. */ static void get_server_addr6( /*! [out] pointer to server address structure. */ struct sockaddr *serverAddr) { struct sockaddr_in6* sa6 = (struct sockaddr_in6*)serverAddr; memset( serverAddr, 0, sizeof(struct sockaddr_storage) ); sa6->sin6_family = AF_INET6; inet_pton(AF_INET6, gIF_IPV6, &sa6->sin6_addr ); sa6->sin6_port = htons( LOCAL_PORT_V6 ); } static int GetDescDocumentAndURL( Upnp_DescType descriptionType, char *description, int config_baseURL, int AddressFamily, IXML_Document **xmlDoc, char descURL[LINE_SIZE]) { int retVal = 0; char *membuf = NULL; char aliasStr[LINE_SIZE]; char *temp_str = NULL; FILE *fp = NULL; size_t fileLen; size_t num_read; time_t last_modified; struct stat file_info; struct sockaddr_storage serverAddr; int rc = UPNP_E_SUCCESS; memset(aliasStr, 0, sizeof(aliasStr)); if (description == NULL) return UPNP_E_INVALID_PARAM; /* non-URL description must have configuration specified */ if (descriptionType != (enum Upnp_DescType_e)UPNPREG_URL_DESC && !config_baseURL) return UPNP_E_INVALID_PARAM; /* Get XML doc and last modified time */ if (descriptionType == (enum Upnp_DescType_e)UPNPREG_URL_DESC) { retVal = UpnpDownloadXmlDoc(description, xmlDoc); if (retVal != UPNP_E_SUCCESS) return retVal; last_modified = time(NULL); } else if (descriptionType == (enum Upnp_DescType_e)UPNPREG_FILENAME_DESC) { retVal = stat(description, &file_info); if (retVal == -1) return UPNP_E_FILE_NOT_FOUND; fileLen = (size_t)file_info.st_size; last_modified = file_info.st_mtime; fp = fopen(description, "rb"); if (fp == NULL) return UPNP_E_FILE_NOT_FOUND; membuf = (char *)malloc(fileLen + (size_t)1); if (membuf == NULL) { fclose(fp); return UPNP_E_OUTOF_MEMORY; } num_read = fread(membuf, (size_t)1, fileLen, fp); if (num_read != fileLen) { fclose(fp); free(membuf); return UPNP_E_FILE_READ_ERROR; } membuf[fileLen] = 0; fclose(fp); rc = ixmlParseBufferEx(membuf, xmlDoc); free(membuf); } else if (descriptionType == (enum Upnp_DescType_e)UPNPREG_BUF_DESC) { last_modified = time(NULL); rc = ixmlParseBufferEx(description, xmlDoc); } else { return UPNP_E_INVALID_PARAM; } if (rc != IXML_SUCCESS && descriptionType != (enum Upnp_DescType_e)UPNPREG_URL_DESC) { if (rc == IXML_INSUFFICIENT_MEMORY) return UPNP_E_OUTOF_MEMORY; else return UPNP_E_INVALID_DESC; } /* Determine alias */ if (config_baseURL) { if (descriptionType == (enum Upnp_DescType_e)UPNPREG_BUF_DESC) { strncpy(aliasStr, "description.xml", sizeof(aliasStr) - 1); } else { /* URL or filename */ retVal = GetNameForAlias(description, &temp_str); if (retVal != UPNP_E_SUCCESS) { ixmlDocument_free(*xmlDoc); return retVal; } if (strlen(temp_str) > (LINE_SIZE - 1)) { ixmlDocument_free(*xmlDoc); return UPNP_E_URL_TOO_BIG; } strncpy(aliasStr, temp_str, sizeof(aliasStr) - 1); } if (AddressFamily == AF_INET) { get_server_addr((struct sockaddr *)&serverAddr); } else { get_server_addr6((struct sockaddr *)&serverAddr); } /* config */ retVal = configure_urlbase(*xmlDoc, (struct sockaddr *)&serverAddr, aliasStr, last_modified, descURL); if (retVal != UPNP_E_SUCCESS) { ixmlDocument_free(*xmlDoc); return retVal; } } else { /* Manual */ if (strlen(description) > LINE_SIZE - 1) { ixmlDocument_free(*xmlDoc); return UPNP_E_URL_TOO_BIG; } strncpy(descURL, description, LINE_SIZE - 1); descURL[LINE_SIZE - 1] = '\0'; } assert(*xmlDoc != NULL); return UPNP_E_SUCCESS; } #else /* INTERNAL_WEB_SERVER */ /* no web server */ static int GetDescDocumentAndURL( Upnp_DescType descriptionType, char *description, int config_baseURL, int AddressFamily, IXML_Document **xmlDoc, char descURL[LINE_SIZE]) { int retVal = 0; if (descriptionType != (enum Upnp_DescType_e)UPNPREG_URL_DESC || config_baseURL) { return UPNP_E_NO_WEB_SERVER; } if (description == NULL) { return UPNP_E_INVALID_PARAM; } if (strlen(description) > LINE_SIZE - (size_t)1) { return UPNP_E_URL_TOO_BIG; } strncpy(descURL, description, LINE_SIZE - 1); descURL[LINE_SIZE - 1] = '\0'; retVal = UpnpDownloadXmlDoc(description, xmlDoc); if (retVal != UPNP_E_SUCCESS) { return retVal; } return UPNP_E_SUCCESS; } #endif /* INTERNAL_WEB_SERVER */ #endif /* INCLUDE_DEVICE_APIS */ /******************************************************************************* * * SSDP interface * ******************************************************************************/ #ifdef INCLUDE_DEVICE_APIS #if EXCLUDE_SSDP == 0 int UpnpSendAdvertisement(UpnpDevice_Handle Hnd, int Exp) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpSendAdvertisement \n"); return UpnpSendAdvertisementLowPower (Hnd, Exp, -1, -1, -1); } int UpnpSendAdvertisementLowPower(UpnpDevice_Handle Hnd, int Exp, int PowerState, int SleepPeriod, int RegistrationState) { struct Handle_Info *SInfo = NULL; int retVal = 0, *ptrMx; upnp_timeout *adEvent; ThreadPoolJob job; memset(&job, 0, sizeof(job)); if( UpnpSdkInit != 1 ) { return UPNP_E_FINISH; } UpnpPrintf( UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpSendAdvertisementLowPower \n" ); HandleLock(); switch( GetHandleInfo( Hnd, &SInfo ) ) { case HND_DEVICE: break; default: HandleUnlock(); return UPNP_E_INVALID_HANDLE; } if( Exp < 1 ) Exp = DEFAULT_MAXAGE; if( Exp <= AUTO_ADVERTISEMENT_TIME * 2 ) Exp = ( AUTO_ADVERTISEMENT_TIME + 1 ) * 2; SInfo->MaxAge = Exp; SInfo->PowerState = PowerState; if( SleepPeriod < 0 ) SleepPeriod = -1; SInfo->SleepPeriod = SleepPeriod; SInfo->RegistrationState = RegistrationState; HandleUnlock(); retVal = AdvertiseAndReply( 1, Hnd, ( enum SsdpSearchType )0, ( struct sockaddr * )NULL, ( char * )NULL, ( char * )NULL, ( char * )NULL, Exp ); if( retVal != UPNP_E_SUCCESS ) return retVal; ptrMx = ( int * )malloc( sizeof( int ) ); if( ptrMx == NULL ) return UPNP_E_OUTOF_MEMORY; adEvent = ( upnp_timeout * ) malloc( sizeof( upnp_timeout ) ); if( adEvent == NULL ) { free( ptrMx ); return UPNP_E_OUTOF_MEMORY; } *ptrMx = Exp; adEvent->handle = Hnd; adEvent->Event = ptrMx; HandleLock(); switch( GetHandleInfo( Hnd, &SInfo ) ) { case HND_DEVICE: break; default: HandleUnlock(); free( adEvent ); free( ptrMx ); return UPNP_E_INVALID_HANDLE; } #ifdef SSDP_PACKET_DISTRIBUTE TPJobInit( &job, ( start_routine ) AutoAdvertise, adEvent ); TPJobSetFreeFunction( &job, ( free_routine ) free_upnp_timeout ); TPJobSetPriority( &job, MED_PRIORITY ); if( ( retVal = TimerThreadSchedule( &gTimerThread, ( ( Exp / 2 ) - ( AUTO_ADVERTISEMENT_TIME ) ), REL_SEC, &job, SHORT_TERM, &( adEvent->eventId ) ) ) != UPNP_E_SUCCESS ) { HandleUnlock(); free( adEvent ); free( ptrMx ); return retVal; } #else TPJobInit( &job, ( start_routine ) AutoAdvertise, adEvent ); TPJobSetFreeFunction( &job, ( free_routine ) free_upnp_timeout ); TPJobSetPriority( &job, MED_PRIORITY ); if( ( retVal = TimerThreadSchedule( &gTimerThread, Exp - AUTO_ADVERTISEMENT_TIME, REL_SEC, &job, SHORT_TERM, &( adEvent->eventId ) ) ) != UPNP_E_SUCCESS ) { HandleUnlock(); free( adEvent ); free( ptrMx ); return retVal; } #endif HandleUnlock(); UpnpPrintf( UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpSendAdvertisementLowPower \n" ); return retVal; } #endif /* EXCLUDE_SSDP == 0 */ #endif /* INCLUDE_DEVICE_APIS */ #if EXCLUDE_SSDP == 0 #ifdef INCLUDE_CLIENT_APIS int UpnpSearchAsync( UpnpClient_Handle Hnd, int Mx, const char *Target_const, const void *Cookie_const ) { struct Handle_Info *SInfo = NULL; char *Target = ( char * )Target_const; int retVal; if( UpnpSdkInit != 1 ) { return UPNP_E_FINISH; } UpnpPrintf( UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpSearchAsync\n" ); HandleReadLock(); switch( GetHandleInfo( Hnd, &SInfo ) ) { case HND_CLIENT: break; default: HandleUnlock(); return UPNP_E_INVALID_HANDLE; } if( Mx < 1 ) Mx = DEFAULT_MX; if( Target == NULL ) { HandleUnlock(); return UPNP_E_INVALID_PARAM; } HandleUnlock(); retVal = SearchByTarget( Mx, Target, ( void * )Cookie_const ); if (retVal != 1) return retVal; UpnpPrintf( UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpSearchAsync \n" ); return UPNP_E_SUCCESS; } #endif /* INCLUDE_CLIENT_APIS */ #endif /******************************************************************************* * * GENA interface * ******************************************************************************/ #if EXCLUDE_GENA == 0 #ifdef INCLUDE_DEVICE_APIS int UpnpSetMaxSubscriptions(UpnpDevice_Handle Hnd, int MaxSubscriptions) { struct Handle_Info *SInfo = NULL; if( UpnpSdkInit != 1 ) { return UPNP_E_FINISH; } UpnpPrintf( UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpSetMaxSubscriptions \n" ); HandleLock(); switch( GetHandleInfo( Hnd, &SInfo ) ) { case HND_DEVICE: break; default: HandleUnlock(); return UPNP_E_INVALID_HANDLE; } if( ( MaxSubscriptions != UPNP_INFINITE ) && ( MaxSubscriptions < 0 ) ) { HandleUnlock(); return UPNP_E_INVALID_HANDLE; } SInfo->MaxSubscriptions = MaxSubscriptions; HandleUnlock(); UpnpPrintf( UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpSetMaxSubscriptions \n" ); return UPNP_E_SUCCESS; } #endif /* INCLUDE_DEVICE_APIS */ #ifdef INCLUDE_DEVICE_APIS int UpnpSetMaxSubscriptionTimeOut(UpnpDevice_Handle Hnd, int MaxSubscriptionTimeOut) { struct Handle_Info *SInfo = NULL; if( UpnpSdkInit != 1 ) { return UPNP_E_FINISH; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpSetMaxSubscriptionTimeOut\n" ); HandleLock(); switch( GetHandleInfo( Hnd, &SInfo ) ) { case HND_DEVICE: break; default: HandleUnlock(); return UPNP_E_INVALID_HANDLE; } if( ( MaxSubscriptionTimeOut != UPNP_INFINITE ) && ( MaxSubscriptionTimeOut < 0 ) ) { HandleUnlock(); return UPNP_E_INVALID_HANDLE; } SInfo->MaxSubscriptionTimeOut = MaxSubscriptionTimeOut; HandleUnlock(); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpSetMaxSubscriptionTimeOut\n"); return UPNP_E_SUCCESS; } #endif /* INCLUDE_DEVICE_APIS */ #ifdef INCLUDE_CLIENT_APIS int UpnpSubscribeAsync( UpnpClient_Handle Hnd, const char *EvtUrl_const, int TimeOut, Upnp_FunPtr Fun, const void *Cookie_const) { struct Handle_Info *SInfo = NULL; struct UpnpNonblockParam *Param; char *EvtUrl = ( char * )EvtUrl_const; ThreadPoolJob job; memset(&job, 0, sizeof(job)); if( UpnpSdkInit != 1 ) { return UPNP_E_FINISH; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpSubscribeAsync\n"); HandleReadLock(); switch( GetHandleInfo( Hnd, &SInfo ) ) { case HND_CLIENT: break; default: HandleUnlock(); return UPNP_E_INVALID_HANDLE; } if( EvtUrl == NULL ) { HandleUnlock(); return UPNP_E_INVALID_PARAM; } if( TimeOut != UPNP_INFINITE && TimeOut < 1 ) { HandleUnlock(); return UPNP_E_INVALID_PARAM; } if( Fun == NULL ) { HandleUnlock(); return UPNP_E_INVALID_PARAM; } HandleUnlock(); Param = (struct UpnpNonblockParam *) malloc(sizeof (struct UpnpNonblockParam)); if( Param == NULL ) { return UPNP_E_OUTOF_MEMORY; } memset( Param, 0, sizeof( struct UpnpNonblockParam ) ); Param->FunName = SUBSCRIBE; Param->Handle = Hnd; strncpy( Param->Url, EvtUrl, sizeof( Param->Url ) - 1 ); Param->TimeOut = TimeOut; Param->Fun = Fun; Param->Cookie = (void *)Cookie_const; TPJobInit(&job, (start_routine)UpnpThreadDistribution, Param); TPJobSetFreeFunction(&job, (free_routine)free); TPJobSetPriority(&job, MED_PRIORITY); if (ThreadPoolAdd(&gSendThreadPool, &job, NULL) != 0) { free(Param); } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpSubscribeAsync\n"); return UPNP_E_SUCCESS; } #endif /* INCLUDE_CLIENT_APIS */ #ifdef INCLUDE_CLIENT_APIS int UpnpSubscribe( UpnpClient_Handle Hnd, const char *EvtUrl_const, int *TimeOut, Upnp_SID SubsId) { int retVal; struct Handle_Info *SInfo = NULL; UpnpString *EvtUrl = UpnpString_new(); UpnpString *SubsIdTmp = UpnpString_new(); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpSubscribe\n"); if (UpnpSdkInit != 1) { retVal = UPNP_E_FINISH; goto exit_function; } if (EvtUrl == NULL) { retVal = UPNP_E_OUTOF_MEMORY; goto exit_function; } if (EvtUrl_const == NULL) { retVal = UPNP_E_INVALID_PARAM; goto exit_function; } UpnpString_set_String(EvtUrl, EvtUrl_const); if (SubsIdTmp == NULL) { retVal = UPNP_E_OUTOF_MEMORY; goto exit_function; } if (SubsId == NULL) { retVal = UPNP_E_INVALID_PARAM; goto exit_function; } UpnpString_set_String(SubsIdTmp, SubsId); if (TimeOut == NULL) { retVal = UPNP_E_INVALID_PARAM; goto exit_function; } HandleReadLock(); switch (GetHandleInfo(Hnd, &SInfo)) { case HND_CLIENT: break; default: HandleUnlock(); retVal = UPNP_E_INVALID_HANDLE; goto exit_function; } HandleUnlock(); retVal = genaSubscribe(Hnd, EvtUrl, TimeOut, SubsIdTmp); memset(SubsId, 0, sizeof(Upnp_SID)); strncpy(SubsId, UpnpString_get_String(SubsIdTmp), sizeof(Upnp_SID) - 1); exit_function: UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpSubscribe, retVal=%d\n", retVal); UpnpString_delete(SubsIdTmp); UpnpString_delete(EvtUrl); return retVal; } #endif /* INCLUDE_CLIENT_APIS */ #ifdef INCLUDE_CLIENT_APIS int UpnpUnSubscribe(UpnpClient_Handle Hnd, const Upnp_SID SubsId) { struct Handle_Info *SInfo = NULL; int retVal; UpnpString *SubsIdTmp = UpnpString_new(); UpnpPrintf( UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpUnSubscribe\n"); if (UpnpSdkInit != 1) { retVal = UPNP_E_FINISH; goto exit_function; } if (SubsIdTmp == NULL) { retVal = UPNP_E_OUTOF_MEMORY; goto exit_function; } if (SubsId == NULL) { retVal = UPNP_E_INVALID_PARAM; goto exit_function; } UpnpString_set_String(SubsIdTmp, SubsId); HandleReadLock(); switch (GetHandleInfo(Hnd, &SInfo)) { case HND_CLIENT: break; default: HandleUnlock(); retVal = UPNP_E_INVALID_HANDLE; goto exit_function; } HandleUnlock(); retVal = genaUnSubscribe(Hnd, SubsIdTmp); exit_function: UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpUnSubscribe, retVal=%d\n", retVal); UpnpString_delete(SubsIdTmp); return retVal; } #endif /* INCLUDE_CLIENT_APIS */ #ifdef INCLUDE_CLIENT_APIS int UpnpUnSubscribeAsync( UpnpClient_Handle Hnd, Upnp_SID SubsId, Upnp_FunPtr Fun, const void *Cookie_const) { int retVal = UPNP_E_SUCCESS; ThreadPoolJob job; struct Handle_Info *SInfo = NULL; struct UpnpNonblockParam *Param; memset(&job, 0, sizeof(job)); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpUnSubscribeAsync\n"); if (UpnpSdkInit != 1) { retVal = UPNP_E_FINISH; goto exit_function; } if (SubsId == NULL) { retVal = UPNP_E_INVALID_PARAM; goto exit_function; } if (Fun == NULL) { retVal = UPNP_E_INVALID_PARAM; goto exit_function; } HandleReadLock(); switch (GetHandleInfo(Hnd, &SInfo)) { case HND_CLIENT: break; default: HandleUnlock(); retVal = UPNP_E_INVALID_HANDLE; goto exit_function; } HandleUnlock(); Param = (struct UpnpNonblockParam *)malloc(sizeof(struct UpnpNonblockParam)); if (Param == NULL) { retVal = UPNP_E_OUTOF_MEMORY; goto exit_function; } memset( Param, 0, sizeof( struct UpnpNonblockParam ) ); Param->FunName = UNSUBSCRIBE; Param->Handle = Hnd; strncpy( Param->SubsId, SubsId, sizeof( Param->SubsId ) - 1 ); Param->Fun = Fun; Param->Cookie = (void *)Cookie_const; TPJobInit( &job, ( start_routine ) UpnpThreadDistribution, Param ); TPJobSetFreeFunction( &job, ( free_routine ) free ); TPJobSetPriority( &job, MED_PRIORITY ); if (ThreadPoolAdd( &gSendThreadPool, &job, NULL ) != 0) { free(Param); } exit_function: UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpUnSubscribeAsync\n"); return retVal; } #endif /* INCLUDE_CLIENT_APIS */ #ifdef INCLUDE_CLIENT_APIS int UpnpRenewSubscription( UpnpClient_Handle Hnd, int *TimeOut, const Upnp_SID SubsId) { struct Handle_Info *SInfo = NULL; int retVal; UpnpString *SubsIdTmp = UpnpString_new(); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpRenewSubscription\n"); if (UpnpSdkInit != 1) { retVal = UPNP_E_FINISH; goto exit_function; } if (SubsIdTmp == NULL) { retVal = UPNP_E_OUTOF_MEMORY; goto exit_function; } if (SubsId == NULL) { retVal = UPNP_E_INVALID_PARAM; goto exit_function; } UpnpString_set_String(SubsIdTmp, SubsId); if (TimeOut == NULL) { retVal = UPNP_E_INVALID_PARAM; goto exit_function; } HandleReadLock(); switch (GetHandleInfo(Hnd, &SInfo)) { case HND_CLIENT: break; default: HandleUnlock(); retVal = UPNP_E_INVALID_HANDLE; goto exit_function; } HandleUnlock(); retVal = genaRenewSubscription(Hnd, SubsIdTmp, TimeOut); exit_function: UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpRenewSubscription, retVal=%d\n", retVal); UpnpString_delete(SubsIdTmp); return retVal; } #endif /* INCLUDE_CLIENT_APIS */ #ifdef INCLUDE_CLIENT_APIS int UpnpRenewSubscriptionAsync( UpnpClient_Handle Hnd, int TimeOut, Upnp_SID SubsId, Upnp_FunPtr Fun, const void *Cookie_const) { ThreadPoolJob job; struct Handle_Info *SInfo = NULL; struct UpnpNonblockParam *Param; memset(&job, 0, sizeof(job)); if( UpnpSdkInit != 1 ) { return UPNP_E_FINISH; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpRenewSubscriptionAsync\n"); HandleReadLock(); switch( GetHandleInfo( Hnd, &SInfo ) ) { case HND_CLIENT: break; default: HandleUnlock(); return UPNP_E_INVALID_HANDLE; } if( TimeOut != UPNP_INFINITE && TimeOut < 1 ) { HandleUnlock(); return UPNP_E_INVALID_PARAM; } if( SubsId == NULL ) { HandleUnlock(); return UPNP_E_INVALID_PARAM; } if( Fun == NULL ) { HandleUnlock(); return UPNP_E_INVALID_PARAM; } HandleUnlock(); Param = ( struct UpnpNonblockParam * ) malloc( sizeof( struct UpnpNonblockParam ) ); if( Param == NULL ) { return UPNP_E_OUTOF_MEMORY; } memset(Param, 0, sizeof( struct UpnpNonblockParam ) ); Param->FunName = RENEW; Param->Handle = Hnd; strncpy( Param->SubsId, SubsId, sizeof( Param->SubsId ) - 1 ); Param->Fun = Fun; Param->Cookie = ( void * )Cookie_const; Param->TimeOut = TimeOut; TPJobInit( &job, ( start_routine ) UpnpThreadDistribution, Param ); TPJobSetFreeFunction( &job, ( free_routine ) free ); TPJobSetPriority( &job, MED_PRIORITY ); if (ThreadPoolAdd( &gSendThreadPool, &job, NULL ) != 0) { free(Param); } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpRenewSubscriptionAsync\n"); return UPNP_E_SUCCESS; } #endif /* INCLUDE_CLIENT_APIS */ #ifdef INCLUDE_DEVICE_APIS int UpnpNotify( UpnpDevice_Handle Hnd, const char *DevID_const, const char *ServName_const, const char **VarName_const, const char **NewVal_const, int cVariables) { struct Handle_Info *SInfo = NULL; int retVal; char *DevID = (char *)DevID_const; char *ServName = (char *)ServName_const; char **VarName = (char **)VarName_const; char **NewVal = (char **)NewVal_const; if( UpnpSdkInit != 1 ) { return UPNP_E_FINISH; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpNotify\n"); HandleReadLock(); switch( GetHandleInfo( Hnd, &SInfo ) ) { case HND_DEVICE: break; default: HandleUnlock(); return UPNP_E_INVALID_HANDLE; } if( DevID == NULL ) { HandleUnlock(); return UPNP_E_INVALID_PARAM; } if( ServName == NULL ) { HandleUnlock(); return UPNP_E_INVALID_PARAM; } if( VarName == NULL || NewVal == NULL || cVariables < 0 ) { HandleUnlock(); return UPNP_E_INVALID_PARAM; } HandleUnlock(); retVal = genaNotifyAll( Hnd, DevID, ServName, VarName, NewVal, cVariables ); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpNotify\n"); return retVal; } int UpnpNotifyExt( UpnpDevice_Handle Hnd, const char *DevID_const, const char *ServName_const, IXML_Document *PropSet) { struct Handle_Info *SInfo = NULL; int retVal; char *DevID = (char *)DevID_const; char *ServName = (char *)ServName_const; if( UpnpSdkInit != 1 ) { return UPNP_E_FINISH; } UpnpPrintf( UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpNotify \n" ); HandleReadLock(); switch( GetHandleInfo( Hnd, &SInfo ) ) { case HND_DEVICE: break; default: HandleUnlock(); return UPNP_E_INVALID_HANDLE; } if( DevID == NULL ) { HandleUnlock(); return UPNP_E_INVALID_PARAM; } if( ServName == NULL ) { HandleUnlock(); return UPNP_E_INVALID_PARAM; } HandleUnlock(); retVal = genaNotifyAllExt( Hnd, DevID, ServName, PropSet ); UpnpPrintf( UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpNotify \n" ); return retVal; } #endif /* INCLUDE_DEVICE_APIS */ #ifdef INCLUDE_DEVICE_APIS int UpnpAcceptSubscription( UpnpDevice_Handle Hnd, const char *DevID_const, const char *ServName_const, const char **VarName_const, const char **NewVal_const, int cVariables, const Upnp_SID SubsId) { int ret = 0; int line = 0; struct Handle_Info *SInfo = NULL; char *DevID = (char *)DevID_const; char *ServName = (char *)ServName_const; char **VarName = (char **)VarName_const; char **NewVal = (char **)NewVal_const; UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpAcceptSubscription\n"); if (UpnpSdkInit != 1) { line = __LINE__; ret = UPNP_E_FINISH; goto exit_function; } HandleReadLock(); switch (GetHandleInfo(Hnd, &SInfo)) { case HND_DEVICE: break; default: HandleUnlock(); line = __LINE__; ret = UPNP_E_INVALID_HANDLE; goto exit_function; } if (DevID == NULL) { HandleUnlock(); line = __LINE__; ret = UPNP_E_INVALID_PARAM; goto exit_function; } if (ServName == NULL) { HandleUnlock(); line = __LINE__; ret = UPNP_E_INVALID_PARAM; goto exit_function; } if (SubsId == NULL) { HandleUnlock(); line = __LINE__; ret = UPNP_E_INVALID_PARAM; goto exit_function; } /* Now accepts an empty state list, so the code below is commented out */ #if 0 if (VarName == NULL || NewVal == NULL || cVariables < 0) { HandleUnlock(); line = __LINE__; ret = UPNP_E_INVALID_PARAM; goto exit_function; } #endif HandleUnlock(); line = __LINE__; ret = genaInitNotify( Hnd, DevID, ServName, VarName, NewVal, cVariables, SubsId); exit_function: UpnpPrintf(UPNP_ALL, API, __FILE__, line, "Exiting UpnpAcceptSubscription, ret = %d\n", ret); return ret; } int UpnpAcceptSubscriptionExt( UpnpDevice_Handle Hnd, const char *DevID_const, const char *ServName_const, IXML_Document *PropSet, const Upnp_SID SubsId) { int ret = 0; int line = 0; struct Handle_Info *SInfo = NULL; char *DevID = (char *)DevID_const; char *ServName = (char *)ServName_const; UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpAcceptSubscription\n"); if (UpnpSdkInit != 1) { line = __LINE__; ret = UPNP_E_FINISH; goto exit_function; } HandleReadLock(); switch (GetHandleInfo(Hnd, &SInfo)) { case HND_DEVICE: break; default: HandleUnlock(); line = __LINE__; ret = UPNP_E_INVALID_HANDLE; goto exit_function; } if (DevID == NULL) { HandleUnlock(); line = __LINE__; ret = UPNP_E_INVALID_PARAM; goto exit_function; } if (ServName == NULL) { HandleUnlock(); line = __LINE__; ret = UPNP_E_INVALID_PARAM; goto exit_function; } if (SubsId == NULL) { HandleUnlock(); line = __LINE__; ret = UPNP_E_INVALID_PARAM; goto exit_function; } /* Now accepts an empty state list, so the code below is commented out */ #if 0 if (PropSet == NULL) { HandleUnlock(); line = __LINE__; ret = UPNP_E_INVALID_PARAM; goto exit_function; } #endif HandleUnlock(); line = __LINE__; ret = genaInitNotifyExt(Hnd, DevID, ServName, PropSet, SubsId); exit_function: UpnpPrintf(UPNP_ALL, API, __FILE__, line, "Exiting UpnpAcceptSubscription, ret = %d.\n", ret); return ret; } #endif /* INCLUDE_DEVICE_APIS */ #endif /* EXCLUDE_GENA == 0 */ /******************************************************************************* * * SOAP interface * ******************************************************************************/ #if EXCLUDE_SOAP == 0 #ifdef INCLUDE_CLIENT_APIS int UpnpSendAction( UpnpClient_Handle Hnd, const char *ActionURL_const, const char *ServiceType_const, const char *DevUDN_const, IXML_Document *Action, IXML_Document **RespNodePtr) { struct Handle_Info *SInfo = NULL; int retVal = 0; char *ActionURL = (char *)ActionURL_const; char *ServiceType = (char *)ServiceType_const; /* udn not used? */ /*char *DevUDN = (char *)DevUDN_const;*/ if( UpnpSdkInit != 1 ) { return UPNP_E_FINISH; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpSendAction\n"); if (DevUDN_const !=NULL) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "non NULL DevUDN is ignored\n"); } DevUDN_const = NULL; HandleReadLock(); switch( GetHandleInfo( Hnd, &SInfo ) ) { case HND_CLIENT: break; default: HandleUnlock(); return UPNP_E_INVALID_HANDLE; } HandleUnlock(); if( ActionURL == NULL ) { return UPNP_E_INVALID_PARAM; } if( ServiceType == NULL || Action == NULL || RespNodePtr == NULL || DevUDN_const != NULL ) { return UPNP_E_INVALID_PARAM; } retVal = SoapSendAction( ActionURL, ServiceType, Action, RespNodePtr ); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpSendAction\n"); return retVal; } int UpnpSendActionEx( UpnpClient_Handle Hnd, const char *ActionURL_const, const char *ServiceType_const, const char *DevUDN_const, IXML_Document *Header, IXML_Document *Action, IXML_Document **RespNodePtr) { struct Handle_Info *SInfo = NULL; int retVal = 0; char *ActionURL = (char *)ActionURL_const; char *ServiceType = (char *)ServiceType_const; /* udn not used? */ /*char *DevUDN = (char *)DevUDN_const;*/ if( UpnpSdkInit != 1 ) { return UPNP_E_FINISH; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpSendActionEx\n"); if( Header == NULL ) { retVal = UpnpSendAction( Hnd, ActionURL_const, ServiceType_const, DevUDN_const, Action, RespNodePtr ); return retVal; } HandleReadLock(); switch( GetHandleInfo( Hnd, &SInfo ) ) { case HND_CLIENT: break; default: HandleUnlock(); return UPNP_E_INVALID_HANDLE; } HandleUnlock(); if( ActionURL == NULL ) { return UPNP_E_INVALID_PARAM; } if( ServiceType == NULL || Action == NULL || RespNodePtr == NULL ) { return UPNP_E_INVALID_PARAM; } retVal = SoapSendActionEx( ActionURL, ServiceType, Header, Action, RespNodePtr ); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpSendAction \n"); return retVal; } int UpnpSendActionAsync( UpnpClient_Handle Hnd, const char *ActionURL_const, const char *ServiceType_const, const char *DevUDN_const, IXML_Document *Act, Upnp_FunPtr Fun, const void *Cookie_const) { int rc; ThreadPoolJob job; struct Handle_Info *SInfo = NULL; struct UpnpNonblockParam *Param; DOMString tmpStr; char *ActionURL = (char *)ActionURL_const; char *ServiceType = (char *)ServiceType_const; /* udn not used? */ /*char *DevUDN = (char *)DevUDN_const;*/ memset(&job, 0, sizeof(job)); if(UpnpSdkInit != 1) { return UPNP_E_FINISH; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpSendActionAsync\n"); HandleReadLock(); switch( GetHandleInfo( Hnd, &SInfo ) ) { case HND_CLIENT: break; default: HandleUnlock(); return UPNP_E_INVALID_HANDLE; } HandleUnlock(); if( ActionURL == NULL ) { return UPNP_E_INVALID_PARAM; } if( ServiceType == NULL || Act == NULL || Fun == NULL || DevUDN_const != NULL ) { return UPNP_E_INVALID_PARAM; } tmpStr = ixmlPrintNode( ( IXML_Node * ) Act ); if( tmpStr == NULL ) { return UPNP_E_INVALID_ACTION; } Param = ( struct UpnpNonblockParam * ) malloc( sizeof( struct UpnpNonblockParam ) ); if( Param == NULL ) { ixmlFreeDOMString( tmpStr ); return UPNP_E_OUTOF_MEMORY; } memset( Param, 0, sizeof( struct UpnpNonblockParam ) ); Param->FunName = ACTION; Param->Handle = Hnd; strncpy( Param->Url, ActionURL, sizeof ( Param->Url ) - 1 ); strncpy( Param->ServiceType, ServiceType, sizeof ( Param->ServiceType ) - 1 ); rc = ixmlParseBufferEx( tmpStr, &( Param->Act ) ); if( rc != IXML_SUCCESS ) { free( Param ); ixmlFreeDOMString( tmpStr ); if( rc == IXML_INSUFFICIENT_MEMORY ) { return UPNP_E_OUTOF_MEMORY; } else { return UPNP_E_INVALID_ACTION; } } ixmlFreeDOMString( tmpStr ); Param->Cookie = ( void * )Cookie_const; Param->Fun = Fun; TPJobInit( &job, ( start_routine ) UpnpThreadDistribution, Param ); TPJobSetFreeFunction( &job, ( free_routine ) free ); TPJobSetPriority( &job, MED_PRIORITY ); if (ThreadPoolAdd( &gSendThreadPool, &job, NULL ) != 0) { free(Param); } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpSendActionAsync \n"); return UPNP_E_SUCCESS; } int UpnpSendActionExAsync( UpnpClient_Handle Hnd, const char *ActionURL_const, const char *ServiceType_const, const char *DevUDN_const, IXML_Document *Header, IXML_Document *Act, Upnp_FunPtr Fun, const void *Cookie_const) { struct Handle_Info *SInfo = NULL; struct UpnpNonblockParam *Param; DOMString tmpStr; DOMString headerStr = NULL; char *ActionURL = ( char * )ActionURL_const; char *ServiceType = ( char * )ServiceType_const; ThreadPoolJob job; int retVal = 0; memset(&job, 0, sizeof(job)); if( UpnpSdkInit != 1 ) { return UPNP_E_FINISH; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpSendActionExAsync\n"); if( Header == NULL ) { retVal = UpnpSendActionAsync( Hnd, ActionURL_const, ServiceType_const, DevUDN_const, Act, Fun, Cookie_const ); return retVal; } HandleReadLock(); switch( GetHandleInfo( Hnd, &SInfo ) ) { case HND_CLIENT: break; default: HandleUnlock(); return UPNP_E_INVALID_HANDLE; } HandleUnlock(); if( ActionURL == NULL ) { return UPNP_E_INVALID_PARAM; } if( ServiceType == NULL || Act == NULL || Fun == NULL ) { return UPNP_E_INVALID_PARAM; } headerStr = ixmlPrintNode( ( IXML_Node * ) Header ); tmpStr = ixmlPrintNode( ( IXML_Node * ) Act ); if( tmpStr == NULL ) { ixmlFreeDOMString( headerStr ); return UPNP_E_INVALID_ACTION; } Param = ( struct UpnpNonblockParam * ) malloc( sizeof( struct UpnpNonblockParam ) ); if( Param == NULL ) { ixmlFreeDOMString( tmpStr ); ixmlFreeDOMString( headerStr ); return UPNP_E_OUTOF_MEMORY; } memset( Param, 0, sizeof( struct UpnpNonblockParam ) ); Param->FunName = ACTION; Param->Handle = Hnd; strncpy( Param->Url, ActionURL, sizeof( Param->Url ) - 1 ); strncpy( Param->ServiceType, ServiceType, sizeof ( Param->ServiceType ) - 1 ); retVal = ixmlParseBufferEx( headerStr, &( Param->Header ) ); if( retVal != IXML_SUCCESS ) { free( Param ); ixmlFreeDOMString( tmpStr ); ixmlFreeDOMString( headerStr ); if( retVal == IXML_INSUFFICIENT_MEMORY ) { return UPNP_E_OUTOF_MEMORY; } else { return UPNP_E_INVALID_ACTION; } } retVal = ixmlParseBufferEx( tmpStr, &( Param->Act ) ); if( retVal != IXML_SUCCESS ) { ixmlDocument_free( Param->Header ); free( Param ); ixmlFreeDOMString( tmpStr ); ixmlFreeDOMString( headerStr ); if( retVal == IXML_INSUFFICIENT_MEMORY ) { return UPNP_E_OUTOF_MEMORY; } else { return UPNP_E_INVALID_ACTION; } } ixmlFreeDOMString( tmpStr ); ixmlFreeDOMString( headerStr ); Param->Cookie = ( void * )Cookie_const; Param->Fun = Fun; TPJobInit( &job, ( start_routine ) UpnpThreadDistribution, Param ); TPJobSetFreeFunction( &job, ( free_routine ) free ); TPJobSetPriority( &job, MED_PRIORITY ); if (ThreadPoolAdd( &gSendThreadPool, &job, NULL ) != 0) { free(Param); } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpSendActionAsync\n"); return UPNP_E_SUCCESS; } int UpnpGetServiceVarStatusAsync( UpnpClient_Handle Hnd, const char *ActionURL_const, const char *VarName_const, Upnp_FunPtr Fun, const void *Cookie_const) { ThreadPoolJob job; struct Handle_Info *SInfo = NULL; struct UpnpNonblockParam *Param; char *ActionURL = (char *)ActionURL_const; char *VarName = (char *)VarName_const; memset(&job, 0, sizeof(job)); if( UpnpSdkInit != 1 ) { return UPNP_E_FINISH; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpGetServiceVarStatusAsync\n"); HandleReadLock(); switch( GetHandleInfo( Hnd, &SInfo ) ) { case HND_CLIENT: break; default: HandleUnlock(); return UPNP_E_INVALID_HANDLE; } HandleUnlock(); if( ActionURL == NULL ) { return UPNP_E_INVALID_PARAM; } if( VarName == NULL || Fun == NULL ) return UPNP_E_INVALID_PARAM; Param = ( struct UpnpNonblockParam * ) malloc( sizeof( struct UpnpNonblockParam ) ); if( Param == NULL ) { return UPNP_E_OUTOF_MEMORY; } memset( Param, 0, sizeof( struct UpnpNonblockParam ) ); Param->FunName = STATUS; Param->Handle = Hnd; strncpy( Param->Url, ActionURL, sizeof( Param->Url ) - 1); strncpy( Param->VarName, VarName, sizeof( Param->VarName ) - 1 ); Param->Fun = Fun; Param->Cookie = ( void * )Cookie_const; TPJobInit( &job, ( start_routine ) UpnpThreadDistribution, Param ); TPJobSetFreeFunction( &job, ( free_routine ) free ); TPJobSetPriority( &job, MED_PRIORITY ); if (ThreadPoolAdd( &gSendThreadPool, &job, NULL ) != 0) { free(Param); } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpGetServiceVarStatusAsync\n"); return UPNP_E_SUCCESS; } int UpnpGetServiceVarStatus( UpnpClient_Handle Hnd, const char *ActionURL_const, const char *VarName_const, DOMString *StVar) { struct Handle_Info *SInfo = NULL; int retVal = 0; char *StVarPtr; char *ActionURL = (char *)ActionURL_const; char *VarName = (char *)VarName_const; if(UpnpSdkInit != 1) { return UPNP_E_FINISH; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpGetServiceVarStatus\n"); HandleReadLock(); switch( GetHandleInfo( Hnd, &SInfo ) ) { case HND_CLIENT: break; default: HandleUnlock(); return UPNP_E_INVALID_HANDLE; } HandleUnlock(); if( ActionURL == NULL ) { return UPNP_E_INVALID_PARAM; } if( VarName == NULL || StVar == NULL ) { return UPNP_E_INVALID_PARAM; } retVal = SoapGetServiceVarStatus( ActionURL, VarName, &StVarPtr ); *StVar = StVarPtr; UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpGetServiceVarStatus \n"); return retVal; } #endif /* INCLUDE_CLIENT_APIS */ #endif /* EXCLUDE_SOAP */ /******************************************************************************* * * Client API * ******************************************************************************/ int UpnpOpenHttpPost( const char *url, void **handle, const char *contentType, int contentLength, int timeout) { int status = http_OpenHttpConnection(url, handle, timeout); if (status == UPNP_E_SUCCESS) { return http_MakeHttpRequest(HTTPMETHOD_POST, url, handle, NULL, contentType, contentLength, timeout); } return status; } int UpnpWriteHttpPost( void *handle, char *buf, size_t *size, int timeout) { return http_WriteHttpRequest(handle, buf, size, timeout); } int UpnpCloseHttpPost( void *handle, int *httpStatus, int timeout) { int status = http_EndHttpRequest(handle, timeout); if (status == UPNP_E_SUCCESS) { status = http_GetHttpResponse(handle, NULL, NULL, NULL, httpStatus, timeout); } status = http_CloseHttpConnection(handle); return status;} int UpnpOpenHttpGet( const char *url, void **handle, char **contentType, int *contentLength, int *httpStatus, int timeout) { int status = UpnpOpenHttpConnection(url, handle, timeout); if (status == UPNP_E_SUCCESS) { status = UpnpMakeHttpRequest(HTTPMETHOD_GET, url, *handle, NULL, NULL, 0, timeout); } if (status == UPNP_E_SUCCESS) { status = UpnpEndHttpRequest(*handle, timeout); } if (status == UPNP_E_SUCCESS) { status = UpnpGetHttpResponse(*handle, NULL, contentType, contentLength, httpStatus, timeout); } return status; } int UpnpOpenHttpGetProxy( const char *url, const char *proxy_str, void **handle, char **contentType, int *contentLength, int *httpStatus, int timeout) { int status = UpnpOpenHttpConnection(proxy_str, handle, timeout); if (status == UPNP_E_SUCCESS) { status = UpnpMakeHttpRequest(HTTPMETHOD_GET, url, *handle, NULL, NULL, 0, timeout); } if (status == UPNP_E_SUCCESS) { status = UpnpEndHttpRequest(*handle, timeout); } if (status == UPNP_E_SUCCESS) { status = UpnpGetHttpResponse(*handle, NULL, contentType, contentLength, httpStatus, timeout); } return status; } int UpnpOpenHttpGetEx( const char *url_str, void **Handle, char **contentType, int *contentLength, int *httpStatus, int lowRange, int highRange, int timeout) { return http_OpenHttpGetEx( url_str, Handle, contentType, contentLength, httpStatus, lowRange, highRange, timeout); } int UpnpCancelHttpGet(void *Handle) { return http_CancelHttpGet(Handle); } int UpnpCloseHttpGet(void *Handle) { return UpnpCloseHttpConnection(Handle); } int UpnpReadHttpGet(void *Handle, char *buf, size_t *size, int timeout) { return http_ReadHttpResponse(Handle, buf, size, timeout); } int UpnpHttpGetProgress(void *Handle, size_t *length, size_t *total) { return http_HttpGetProgress(Handle, length, total); } int UpnpOpenHttpConnection(const char *url, void **handle, int timeout) { return http_OpenHttpConnection(url, handle, timeout); } int UpnpMakeHttpRequest(Upnp_HttpMethod method, const char *url, void *handle, UpnpString *headers, const char *contentType, int contentLength, int timeout) { return http_MakeHttpRequest(method, url, handle, headers, contentType, contentLength, timeout); } int UpnpWriteHttpRequest(void *handle, char *buf, size_t *size, int timeout) { return http_WriteHttpRequest(handle, buf, size, timeout); } int UpnpEndHttpRequest(void *handle, int timeout) { return http_EndHttpRequest(handle, timeout); } int UpnpGetHttpResponse(void *handle, UpnpString *headers, char **contentType, int *contentLength, int *httpStatus, int timeout) { return http_GetHttpResponse(handle, headers, contentType, contentLength, httpStatus, timeout); } int UpnpReadHttpResponse(void *handle, char *buf, size_t *size, int timeout) { return http_ReadHttpResponse(handle, buf, size, timeout); } int UpnpCloseHttpConnection(void *handle) { return http_CloseHttpConnection(handle); } int UpnpDownloadUrlItem(const char *url, char **outBuf, char *contentType) { int ret_code; size_t dummy; if (url == NULL || outBuf == NULL || contentType == NULL) return UPNP_E_INVALID_PARAM; ret_code = http_Download(url, HTTP_DEFAULT_TIMEOUT, outBuf, &dummy, contentType); if (ret_code > 0) /* error reply was received */ ret_code = UPNP_E_INVALID_URL; return ret_code; } int UpnpDownloadXmlDoc(const char *url, IXML_Document **xmlDoc) { int ret_code; char *xml_buf; char content_type[LINE_SIZE]; if (url == NULL || xmlDoc == NULL) { return UPNP_E_INVALID_PARAM; } ret_code = UpnpDownloadUrlItem(url, &xml_buf, content_type); if (ret_code != UPNP_E_SUCCESS) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "Error downloading document, retCode: %d\n", ret_code); return ret_code; } if (strncasecmp(content_type, "text/xml", strlen("text/xml"))) { UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Not text/xml\n"); /* Linksys WRT54G router returns * "CONTENT-TYPE: application/octet-stream". * Let's be nice to Linksys and try to parse document anyway. * If the data sended is not a xml file, ixmlParseBufferEx * will fail and the function will return UPNP_E_INVALID_DESC too. */ #if 0 free(xml_buf); return UPNP_E_INVALID_DESC; #endif } ret_code = ixmlParseBufferEx(xml_buf, xmlDoc); free(xml_buf); if (ret_code != IXML_SUCCESS) { if (ret_code == IXML_INSUFFICIENT_MEMORY) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "Out of memory, ixml error code: %d\n", ret_code); return UPNP_E_OUTOF_MEMORY; } else { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "Invalid Description, ixml error code: %d\n", ret_code); return UPNP_E_INVALID_DESC; } } else { #ifdef DEBUG xml_buf = ixmlPrintNode((IXML_Node *)*xmlDoc); UpnpPrintf( UPNP_ALL, API, __FILE__, __LINE__, "Printing the Parsed xml document \n %s\n", xml_buf); UpnpPrintf( UPNP_ALL, API, __FILE__, __LINE__, "****************** END OF Parsed XML Doc *****************\n"); ixmlFreeDOMString(xml_buf); #endif UpnpPrintf( UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpDownloadXmlDoc\n"); return UPNP_E_SUCCESS; } } int UpnpGetIfInfo(const char *IfName) { #ifdef WIN32 /* ---------------------------------------------------- */ /* WIN32 implementation will use the IpHlpAPI library. */ /* ---------------------------------------------------- */ PIP_ADAPTER_ADDRESSES adapts = NULL; PIP_ADAPTER_ADDRESSES adapts_item; PIP_ADAPTER_UNICAST_ADDRESS uni_addr; SOCKADDR *ip_addr; struct in_addr v4_addr; struct in6_addr v6_addr; ULONG adapts_sz = 0; ULONG ret; int ifname_found = 0; int valid_addr_found = 0; /* Get Adapters addresses required size. */ ret = GetAdaptersAddresses(AF_UNSPEC, GAA_FLAG_SKIP_ANYCAST | GAA_FLAG_SKIP_DNS_SERVER, NULL, adapts, &adapts_sz); if (ret != ERROR_BUFFER_OVERFLOW) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "GetAdaptersAddresses failed to find list of adapters\n"); return UPNP_E_INIT; } /* Allocate enough memory. */ adapts = (PIP_ADAPTER_ADDRESSES) malloc(adapts_sz); if (adapts == NULL) { return UPNP_E_OUTOF_MEMORY; } /* Do the call that will actually return the info. */ ret = GetAdaptersAddresses(AF_UNSPEC, GAA_FLAG_SKIP_ANYCAST | GAA_FLAG_SKIP_DNS_SERVER, NULL, adapts, &adapts_sz); if (ret != ERROR_SUCCESS) { free(adapts); UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "GetAdaptersAddresses failed to find list of adapters\n"); return UPNP_E_INIT; } /* Copy interface name, if it was provided. */ if (IfName != NULL) { if (strlen(IfName) > sizeof(gIF_NAME)) return UPNP_E_INVALID_INTERFACE; memset(gIF_NAME, 0, sizeof(gIF_NAME)); strncpy(gIF_NAME, IfName, sizeof(gIF_NAME) - 1); ifname_found = 1; } adapts_item = adapts; while (adapts_item != NULL) { if (adapts_item->Flags & IP_ADAPTER_NO_MULTICAST) { adapts_item = adapts_item->Next; continue; } if (ifname_found == 0) { /* We have found a valid interface name. Keep it. */ #ifdef UPNP_USE_MSVCPP /* * Partial fix for VC - friendly name is wchar string, * but currently gIF_NAME is char string. For now try * to convert it, which will work with many (but not * all) adapters. A full fix would require a lot of * big changes (gIF_NAME to wchar string?). */ wcstombs(gIF_NAME, adapts_item->FriendlyName, sizeof(gIF_NAME)); #else memset(gIF_NAME, 0, sizeof(gIF_NAME)); strncpy(gIF_NAME, adapts_item->FriendlyName, sizeof(gIF_NAME) - 1); #endif ifname_found = 1; } else { #ifdef UPNP_USE_MSVCPP /* * Partial fix for VC - friendly name is wchar string, * but currently gIF_NAME is char string. For now try * to convert it, which will work with many (but not * all) adapters. A full fix would require a lot of * big changes (gIF_NAME to wchar string?). */ char tmpIfName[LINE_SIZE] = { 0 }; wcstombs(tmpIfName, adapts_item->FriendlyName, sizeof(tmpIfName)); if (strncmp (gIF_NAME, tmpIfName, sizeof(gIF_NAME)) != 0) { /* This is not the interface we're looking for. */ continue; } #else if (strncmp (gIF_NAME, adapts_item->FriendlyName, sizeof(gIF_NAME)) != 0) { /* This is not the interface we're looking for. */ continue; } #endif } /* Loop thru this adapter's unicast IP addresses. */ uni_addr = adapts_item->FirstUnicastAddress; while (uni_addr) { ip_addr = uni_addr->Address.lpSockaddr; switch (ip_addr->sa_family) { case AF_INET: memcpy(&v4_addr, &((struct sockaddr_in *)ip_addr)-> sin_addr, sizeof(v4_addr)); valid_addr_found = 1; break; case AF_INET6: /* Only keep IPv6 link-local addresses. */ if (IN6_IS_ADDR_LINKLOCAL (&((struct sockaddr_in6 *)ip_addr)-> sin6_addr)) { memcpy(&v6_addr, &((struct sockaddr_in6 *) ip_addr)->sin6_addr, sizeof(v6_addr)); valid_addr_found = 1; } break; default: if (valid_addr_found == 0) { /* Address is not IPv4 or IPv6 and no valid address has */ /* yet been found for this interface. Discard interface name. */ ifname_found = 0; } break; } /* Next address. */ uni_addr = uni_addr->Next; } if (valid_addr_found == 1) { gIF_INDEX = adapts_item->IfIndex; break; } /* Next adapter. */ adapts_item = adapts_item->Next; } /* Failed to find a valid interface, or valid address. */ if (ifname_found == 0 || valid_addr_found == 0) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "Failed to find an adapter with valid IP addresses for use.\n"); return UPNP_E_INVALID_INTERFACE; } inet_ntop(AF_INET, &v4_addr, gIF_IPV4, sizeof(gIF_IPV4)); inet_ntop(AF_INET6, &v6_addr, gIF_IPV6, sizeof(gIF_IPV6)); #elif (defined(BSD) && BSD >= 199306) || defined(__FreeBSD_kernel__) struct ifaddrs *ifap, *ifa; struct in_addr v4_addr; struct in6_addr v6_addr; int ifname_found = 0; int valid_addr_found = 0; /* Copy interface name, if it was provided. */ if (IfName != NULL) { if (strlen(IfName) > sizeof(gIF_NAME)) return UPNP_E_INVALID_INTERFACE; memset(gIF_NAME, 0, sizeof(gIF_NAME)); strncpy(gIF_NAME, IfName, sizeof(gIF_NAME) - 1); ifname_found = 1; } /* Get system interface addresses. */ if (getifaddrs(&ifap) != 0) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "getifaddrs failed to find list of addresses\n"); return UPNP_E_INIT; } /* cycle through available interfaces and their addresses. */ for (ifa = ifap; ifa != NULL; ifa = ifa->ifa_next) { /* Skip LOOPBACK interfaces, DOWN interfaces and interfaces that */ /* don't support MULTICAST. */ if ((ifa->ifa_flags & IFF_LOOPBACK) || (!(ifa->ifa_flags & IFF_UP)) || (!(ifa->ifa_flags & IFF_MULTICAST))) { continue; } if (ifname_found == 0) { /* We have found a valid interface name. Keep it. */ memset(gIF_NAME, 0, sizeof(gIF_NAME)); strncpy(gIF_NAME, ifa->ifa_name, sizeof(gIF_NAME) - 1); ifname_found = 1; } else { if (strncmp(gIF_NAME, ifa->ifa_name, sizeof(gIF_NAME)) != 0) { /* This is not the interface we're looking for. */ continue; } } /* Keep interface addresses for later. */ switch (ifa->ifa_addr->sa_family) { case AF_INET: memcpy(&v4_addr, &((struct sockaddr_in *)(ifa->ifa_addr))-> sin_addr, sizeof(v4_addr)); valid_addr_found = 1; break; case AF_INET6: /* Only keep IPv6 link-local addresses. */ if (IN6_IS_ADDR_LINKLOCAL (&((struct sockaddr_in6 *)(ifa->ifa_addr))-> sin6_addr)) { memcpy(&v6_addr, &((struct sockaddr_in6 *)(ifa-> ifa_addr))-> sin6_addr, sizeof(v6_addr)); valid_addr_found = 1; } break; default: if (valid_addr_found == 0) { /* Address is not IPv4 or IPv6 and no valid address has */ /* yet been found for this interface. Discard interface name. */ ifname_found = 0; } break; } } freeifaddrs(ifap); /* Failed to find a valid interface, or valid address. */ if (ifname_found == 0 || valid_addr_found == 0) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "Failed to find an adapter with valid IP addresses for use.\n"); return UPNP_E_INVALID_INTERFACE; } inet_ntop(AF_INET, &v4_addr, gIF_IPV4, sizeof(gIF_IPV4)); inet_ntop(AF_INET6, &v6_addr, gIF_IPV6, sizeof(gIF_IPV6)); gIF_INDEX = if_nametoindex(gIF_NAME); #else char szBuffer[MAX_INTERFACES * sizeof(struct ifreq)]; struct ifconf ifConf; struct ifreq ifReq; FILE *inet6_procfd; size_t i; int LocalSock; struct in6_addr v6_addr; unsigned if_idx; char addr6[8][5]; char buf[INET6_ADDRSTRLEN]; int ifname_found = 0; int valid_addr_found = 0; /* Copy interface name, if it was provided. */ if (IfName != NULL) { if (strlen(IfName) > sizeof(gIF_NAME)) return UPNP_E_INVALID_INTERFACE; memset(gIF_NAME, 0, sizeof(gIF_NAME)); strncpy(gIF_NAME, IfName, sizeof(gIF_NAME) - 1); ifname_found = 1; } /* Create an unbound datagram socket to do the SIOCGIFADDR ioctl on. */ if ((LocalSock = socket(AF_INET, SOCK_DGRAM, IPPROTO_UDP)) == INVALID_SOCKET) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Can't create addrlist socket\n"); return UPNP_E_INIT; } /* Get the interface configuration information... */ ifConf.ifc_len = (int)sizeof szBuffer; ifConf.ifc_ifcu.ifcu_buf = (caddr_t) szBuffer; if (ioctl(LocalSock, SIOCGIFCONF, &ifConf) < 0) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "DiscoverInterfaces: SIOCGIFCONF returned error\n"); close(LocalSock); return UPNP_E_INIT; } /* Cycle through the list of interfaces looking for IP addresses. */ for (i = (size_t)0; i < (size_t)ifConf.ifc_len;) { struct ifreq *pifReq = (struct ifreq *)((caddr_t) ifConf.ifc_req + i); i += sizeof *pifReq; /* See if this is the sort of interface we want to deal with. */ memset(ifReq.ifr_name, 0, sizeof(ifReq.ifr_name)); strncpy(ifReq.ifr_name, pifReq->ifr_name, sizeof(ifReq.ifr_name) - 1); if (ioctl(LocalSock, SIOCGIFFLAGS, &ifReq) < 0) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Can't get interface flags for %s:\n", ifReq.ifr_name); } /* Skip LOOPBACK interfaces, DOWN interfaces and interfaces that */ /* don't support MULTICAST. */ if ((ifReq.ifr_flags & IFF_LOOPBACK) || (!(ifReq.ifr_flags & IFF_UP)) || (!(ifReq.ifr_flags & IFF_MULTICAST))) { continue; } if (ifname_found == 0) { /* We have found a valid interface name. Keep it. */ memset(gIF_NAME, 0, sizeof(gIF_NAME)); strncpy(gIF_NAME, pifReq->ifr_name, sizeof(gIF_NAME) - 1); ifname_found = 1; } else { if (strncmp (gIF_NAME, pifReq->ifr_name, sizeof(gIF_NAME)) != 0) { /* This is not the interface we're looking for. */ continue; } } /* Check address family. */ if (pifReq->ifr_addr.sa_family == AF_INET) { /* Copy interface name, IPv4 address and interface index. */ memset(gIF_NAME, 0, sizeof(gIF_NAME)); strncpy(gIF_NAME, pifReq->ifr_name, sizeof(gIF_NAME) - 1); inet_ntop(AF_INET, &((struct sockaddr_in *)&pifReq->ifr_addr)-> sin_addr, gIF_IPV4, sizeof(gIF_IPV4)); gIF_INDEX = if_nametoindex(gIF_NAME); valid_addr_found = 1; break; } else { /* Address is not IPv4 */ ifname_found = 0; } } close(LocalSock); /* Failed to find a valid interface, or valid address. */ if (ifname_found == 0 || valid_addr_found == 0) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "Failed to find an adapter with valid IP addresses for use.\n"); return UPNP_E_INVALID_INTERFACE; } /* Try to get the IPv6 address for the same interface */ /* from "/proc/net/if_inet6", if possible. */ inet6_procfd = fopen("/proc/net/if_inet6", "r"); if (inet6_procfd) { while (fscanf(inet6_procfd, "%4s%4s%4s%4s%4s%4s%4s%4s %02x %*02x %*02x %*02x %*20s\n", addr6[0], addr6[1], addr6[2], addr6[3], addr6[4], addr6[5], addr6[6], addr6[7], &if_idx) != EOF) { /* Get same interface as IPv4 address retrieved. */ if (gIF_INDEX == if_idx) { snprintf(buf, sizeof(buf), "%s:%s:%s:%s:%s:%s:%s:%s", addr6[0], addr6[1], addr6[2], addr6[3], addr6[4], addr6[5], addr6[6], addr6[7]); /* Validate formed address and check for link-local. */ if (inet_pton(AF_INET6, buf, &v6_addr) > 0) { if (IN6_IS_ADDR_ULA(&v6_addr)) { /* Got valid IPv6 ula. */ memset(gIF_IPV6_ULA_GUA, 0, sizeof(gIF_IPV6_ULA_GUA)); strncpy(gIF_IPV6_ULA_GUA, buf, sizeof (gIF_IPV6_ULA_GUA) - 1); } else if (IN6_IS_ADDR_GLOBAL(&v6_addr) && strlen(gIF_IPV6_ULA_GUA) == (size_t)0) { /* got a GUA, should store it while no ULA is found */ memset(gIF_IPV6_ULA_GUA, 0, sizeof(gIF_IPV6_ULA_GUA)); strncpy(gIF_IPV6_ULA_GUA, buf, sizeof (gIF_IPV6_ULA_GUA) - 1); } else if (IN6_IS_ADDR_LINKLOCAL(&v6_addr) && strlen(gIF_IPV6) == (size_t)0) { /* got a Link local IPv6 address. */ memset(gIF_IPV6, 0, sizeof(gIF_IPV6)); strncpy(gIF_IPV6, buf, sizeof(gIF_IPV6) - 1); } } } } fclose(inet6_procfd); } #endif UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Interface name=%s, index=%d, v4=%s, v6=%s, ULA or GUA v6=%s\n", gIF_NAME, gIF_INDEX, gIF_IPV4, gIF_IPV6, gIF_IPV6_ULA_GUA); return UPNP_E_SUCCESS; } /*! * \brief Schedule async functions in threadpool. */ #ifdef INCLUDE_CLIENT_APIS void UpnpThreadDistribution(struct UpnpNonblockParam *Param) { int errCode = 0; UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside UpnpThreadDistribution \n"); switch (Param->FunName) { #if EXCLUDE_GENA == 0 case SUBSCRIBE: { UpnpEventSubscribe *evt = UpnpEventSubscribe_new(); UpnpString *Sid = UpnpString_new(); UpnpEventSubscribe_strcpy_PublisherUrl(evt, Param->Url); errCode = genaSubscribe( Param->Handle, UpnpEventSubscribe_get_PublisherUrl(evt), (int *)&Param->TimeOut, Sid); UpnpEventSubscribe_set_ErrCode(evt, errCode); UpnpEventSubscribe_set_TimeOut(evt, Param->TimeOut); UpnpEventSubscribe_set_SID(evt, Sid); Param->Fun(UPNP_EVENT_SUBSCRIBE_COMPLETE, evt, Param->Cookie); UpnpString_delete(Sid); UpnpEventSubscribe_delete(evt); free(Param); break; } case UNSUBSCRIBE: { UpnpEventSubscribe *evt = UpnpEventSubscribe_new(); UpnpEventSubscribe_strcpy_SID(evt, Param->SubsId); errCode = genaUnSubscribe( Param->Handle, UpnpEventSubscribe_get_SID(evt)); UpnpEventSubscribe_set_ErrCode(evt, errCode); UpnpEventSubscribe_strcpy_PublisherUrl(evt, ""); UpnpEventSubscribe_set_TimeOut(evt, 0); Param->Fun(UPNP_EVENT_UNSUBSCRIBE_COMPLETE, evt, Param->Cookie); UpnpEventSubscribe_delete(evt); free(Param); break; } case RENEW: { UpnpEventSubscribe *evt = UpnpEventSubscribe_new(); UpnpEventSubscribe_strcpy_SID(evt, Param->SubsId); errCode = genaRenewSubscription( Param->Handle, UpnpEventSubscribe_get_SID(evt), &Param->TimeOut); UpnpEventSubscribe_set_ErrCode(evt, errCode); UpnpEventSubscribe_set_TimeOut(evt, Param->TimeOut); Param->Fun(UPNP_EVENT_RENEWAL_COMPLETE, evt, Param->Cookie); UpnpEventSubscribe_delete(evt); free(Param); break; } #endif /* EXCLUDE_GENA == 0 */ #if EXCLUDE_SOAP == 0 case ACTION: { UpnpActionComplete *Evt = UpnpActionComplete_new(); IXML_Document *actionResult = NULL; int errCode = SoapSendAction( Param->Url, Param->ServiceType, Param->Act, &actionResult); UpnpActionComplete_set_ErrCode(Evt, errCode); UpnpActionComplete_set_ActionRequest(Evt, Param->Act); UpnpActionComplete_set_ActionResult(Evt, actionResult); UpnpActionComplete_strcpy_CtrlUrl(Evt, Param->Url); Param->Fun(UPNP_CONTROL_ACTION_COMPLETE, Evt, Param->Cookie); free(Param); UpnpActionComplete_delete(Evt); break; } case STATUS: { UpnpStateVarComplete *Evt = UpnpStateVarComplete_new(); DOMString currentVal = NULL; int errCode = SoapGetServiceVarStatus( Param->Url, Param->VarName, ¤tVal); UpnpStateVarComplete_set_ErrCode(Evt, errCode); UpnpStateVarComplete_strcpy_CtrlUrl(Evt, Param->Url); UpnpStateVarComplete_strcpy_StateVarName(Evt, Param->VarName); UpnpStateVarComplete_set_CurrentVal(Evt, currentVal); Param->Fun(UPNP_CONTROL_GET_VAR_COMPLETE, Evt, Param->Cookie); free(Param); UpnpStateVarComplete_delete(Evt); break; } #endif /* EXCLUDE_SOAP == 0 */ default: break; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting UpnpThreadDistribution\n"); } #endif /* INCLUDE_CLIENT_APIS */ /*! * \brief Get callback function ptr from a handle. * * \return Upnp_FunPtr */ Upnp_FunPtr GetCallBackFn(UpnpClient_Handle Hnd) { return ((struct Handle_Info *)HandleTable[Hnd])->Callback; } /* Assumes at most one client */ Upnp_Handle_Type GetClientHandleInfo( UpnpClient_Handle *client_handle_out, struct Handle_Info **HndInfo) { Upnp_Handle_Type ret = HND_CLIENT; UpnpClient_Handle client; switch (GetHandleInfo(1, HndInfo)) { case HND_CLIENT: client = 1; break; default: switch (GetHandleInfo(2, HndInfo)) { case HND_CLIENT: client = 2; break; default: client = -1; ret = HND_INVALID; } } *client_handle_out = client; return ret; } Upnp_Handle_Type GetDeviceHandleInfo( int AddressFamily, UpnpDevice_Handle *device_handle_out, struct Handle_Info **HndInfo) { #ifdef INCLUDE_DEVICE_APIS /* Check if we've got a registered device of the address family specified. */ if ((AddressFamily == AF_INET && UpnpSdkDeviceRegisteredV4 == 0) || (AddressFamily == AF_INET6 && UpnpSdkDeviceregisteredV6 == 0)) { *device_handle_out = -1; return HND_INVALID; } /* Find it. */ for (*device_handle_out=1; *device_handle_out < NUM_HANDLE; (*device_handle_out)++) { switch (GetHandleInfo(*device_handle_out, HndInfo)) { case HND_DEVICE: if ((*HndInfo)->DeviceAf == AddressFamily) { return HND_DEVICE; } break; default: break; } } #endif /* INCLUDE_DEVICE_APIS */ *device_handle_out = -1; return HND_INVALID; } Upnp_Handle_Type GetHandleInfo( UpnpClient_Handle Hnd, struct Handle_Info **HndInfo) { Upnp_Handle_Type ret = HND_INVALID; UpnpPrintf( UPNP_INFO, API, __FILE__, __LINE__, "GetHandleInfo: entering, Handle is %d\n", Hnd); if (Hnd < 1 || Hnd >= NUM_HANDLE) { UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "GetHandleInfo: Handle out of range\n"); } else if (HandleTable[Hnd] == NULL) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "GetHandleInfo: HandleTable[%d] is NULL\n", Hnd); } else if (HandleTable[Hnd] != NULL) { *HndInfo = (struct Handle_Info *)HandleTable[Hnd]; ret = ((struct Handle_Info *)*HndInfo)->HType; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "GetHandleInfo: exiting\n"); return ret; } int PrintHandleInfo(UpnpClient_Handle Hnd) { struct Handle_Info * HndInfo; if (HandleTable[Hnd] != NULL) { HndInfo = HandleTable[Hnd]; UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Printing information for Handle_%d\n", Hnd); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "HType_%d\n", HndInfo->HType); #ifdef INCLUDE_DEVICE_APIS switch(HndInfo->HType) { case HND_CLIENT: break; default: UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "DescURL_%s\n", HndInfo->DescURL); } #endif /* INCLUDE_DEVICE_APIS */ } else { return UPNP_E_INVALID_HANDLE; } return UPNP_E_SUCCESS; } int getlocalhostname(char *out, size_t out_len) { int ret = UPNP_E_SUCCESS; char tempstr[INET_ADDRSTRLEN]; const char *p = NULL; #ifdef WIN32 struct hostent *h = NULL; struct sockaddr_in LocalAddr; memset(&LocalAddr, 0, sizeof(LocalAddr)); gethostname(out, out_len); h = gethostbyname(out); if (h != NULL) { memcpy(&LocalAddr.sin_addr, h->h_addr_list[0], 4); p = inet_ntop(AF_INET, &LocalAddr.sin_addr, tempstr, sizeof(tempstr)); if (p) { strncpy(out, p, out_len); } else { UpnpPrintf( UPNP_ALL, API, __FILE__, __LINE__, "getlocalhostname: inet_ntop returned error\n" ); ret = UPNP_E_INIT; } } else { UpnpPrintf( UPNP_ALL, API, __FILE__, __LINE__, "getlocalhostname: gethostbyname returned error\n" ); ret = UPNP_E_INIT; } #elif (defined(BSD) && BSD >= 199306) || defined(__FreeBSD_kernel__) struct ifaddrs *ifap, *ifa; if (getifaddrs(&ifap) != 0) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "DiscoverInterfaces: getifaddrs() returned error\n"); return UPNP_E_INIT; } /* cycle through available interfaces */ for (ifa = ifap; ifa != NULL; ifa = ifa->ifa_next) { /* Skip loopback, point-to-point and down interfaces, * except don't skip down interfaces * if we're trying to get a list of configurable interfaces. */ if ((ifa->ifa_flags & IFF_LOOPBACK) || (!( ifa->ifa_flags & IFF_UP))) { continue; } if (ifa->ifa_addr->sa_family == AF_INET) { /* We don't want the loopback interface. */ if (((struct sockaddr_in *)(ifa->ifa_addr))->sin_addr.s_addr == htonl(INADDR_LOOPBACK)) { continue; } p = inet_ntop(AF_INET, &((struct sockaddr_in *)(ifa->ifa_addr))->sin_addr, tempstr, sizeof(tempstr)); if (p) { strncpy(out, p, out_len); } else { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "getlocalhostname: inet_ntop returned error\n"); ret = UPNP_E_INIT; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside getlocalhostname: after strncpy %s\n", out); break; } } freeifaddrs(ifap); ret = ifa ? UPNP_E_SUCCESS : UPNP_E_INIT; #else char szBuffer[MAX_INTERFACES * sizeof (struct ifreq)]; struct ifconf ifConf; struct ifreq ifReq; int nResult; long unsigned int i; int LocalSock; struct sockaddr_in LocalAddr; int j = 0; /* purify */ memset(&ifConf, 0, sizeof(ifConf)); memset(&ifReq, 0, sizeof(ifReq)); memset(szBuffer, 0, sizeof(szBuffer)); memset(&LocalAddr, 0, sizeof(LocalAddr)); /* Create an unbound datagram socket to do the SIOCGIFADDR ioctl on. */ LocalSock = socket(AF_INET, SOCK_DGRAM, IPPROTO_UDP); if (LocalSock == INVALID_SOCKET) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Can't create addrlist socket\n"); return UPNP_E_INIT; } /* Get the interface configuration information... */ ifConf.ifc_len = (int)sizeof szBuffer; ifConf.ifc_ifcu.ifcu_buf = (caddr_t) szBuffer; nResult = ioctl(LocalSock, SIOCGIFCONF, &ifConf); if (nResult < 0) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "DiscoverInterfaces: SIOCGIFCONF returned error\n"); close(LocalSock); return UPNP_E_INIT; } /* Cycle through the list of interfaces looking for IP addresses. */ for (i = 0lu; i < (long unsigned int)ifConf.ifc_len && j < DEFAULT_INTERFACE; ) { struct ifreq *pifReq = (struct ifreq *)((caddr_t)ifConf.ifc_req + i); i += sizeof *pifReq; /* See if this is the sort of interface we want to deal with. */ memset(ifReq.ifr_name, 0, sizeof(ifReq.ifr_name)); strncpy(ifReq.ifr_name, pifReq->ifr_name, sizeof(ifReq.ifr_name) - 1); if (ioctl(LocalSock, SIOCGIFFLAGS, &ifReq) < 0) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Can't get interface flags for %s:\n", ifReq.ifr_name); } /* Skip loopback, point-to-point and down interfaces, * except don't skip down interfaces * if we're trying to get a list of configurable interfaces. */ if ((ifReq.ifr_flags & IFF_LOOPBACK) || (!(ifReq.ifr_flags & IFF_UP))) { continue; } if (pifReq->ifr_addr.sa_family == AF_INET) { /* Get a pointer to the address...*/ memcpy(&LocalAddr, &pifReq->ifr_addr, sizeof pifReq->ifr_addr); /* We don't want the loopback interface. */ if (LocalAddr.sin_addr.s_addr == htonl(INADDR_LOOPBACK)) { continue; } } /* increment j if we found an address which is not loopback * and is up */ j++; } close(LocalSock); p = inet_ntop(AF_INET, &LocalAddr.sin_addr, tempstr, sizeof(tempstr)); if (p) { strncpy(out, p, out_len); } else { UpnpPrintf( UPNP_ALL, API, __FILE__, __LINE__, "getlocalhostname: inet_ntop returned error\n" ); ret = UPNP_E_INIT; } UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside getlocalhostname: after strncpy %s\n", out); #endif return ret; } #ifdef INCLUDE_DEVICE_APIS #if EXCLUDE_SSDP == 0 void AutoAdvertise(void *input) { upnp_timeout *event = (upnp_timeout *)input; UpnpSendAdvertisement(event->handle, *((int *)event->Event)); free_upnp_timeout(event); } #endif /* EXCLUDE_SSDP == 0 */ #endif /* INCLUDE_DEVICE_APIS */ #ifdef INTERNAL_WEB_SERVER int UpnpSetWebServerRootDir(const char *rootDir) { if( UpnpSdkInit == 0 ) return UPNP_E_FINISH; if( ( rootDir == NULL ) || ( strlen( rootDir ) == 0 ) ) { return UPNP_E_INVALID_PARAM; } membuffer_destroy( &gDocumentRootDir ); return web_server_set_root_dir(rootDir); } #endif /* INTERNAL_WEB_SERVER */ int UpnpAddVirtualDir(const char *newDirName) { virtualDirList *pNewVirtualDir; virtualDirList *pLast; virtualDirList *pCurVirtualDir; char dirName[NAME_SIZE]; memset( dirName, 0, sizeof( dirName ) ); if( UpnpSdkInit != 1 ) { /* SDK is not initialized */ return UPNP_E_FINISH; } if( ( newDirName == NULL ) || ( strlen( newDirName ) == ( size_t ) 0 ) ) { return UPNP_E_INVALID_PARAM; } if( *newDirName != '/' ) { if (strlen(newDirName) > sizeof(dirName) - 2) return UPNP_E_INVALID_PARAM; dirName[0] = '/'; strncpy( dirName + 1, newDirName, sizeof( dirName ) - 2 ); } else { if (strlen(newDirName) > sizeof(dirName) - 1) return UPNP_E_INVALID_PARAM; strncpy( dirName, newDirName, sizeof( dirName ) - 1 ); } pCurVirtualDir = pVirtualDirList; while( pCurVirtualDir != NULL ) { /* already has this entry */ if( strcmp( pCurVirtualDir->dirName, dirName ) == 0 ) { return UPNP_E_SUCCESS; } pCurVirtualDir = pCurVirtualDir->next; } pNewVirtualDir = ( virtualDirList * ) malloc( sizeof( virtualDirList ) ); if( pNewVirtualDir == NULL ) { return UPNP_E_OUTOF_MEMORY; } pNewVirtualDir->next = NULL; memset( pNewVirtualDir->dirName, 0, sizeof( pNewVirtualDir->dirName ) ); strncpy( pNewVirtualDir->dirName, dirName, sizeof( pNewVirtualDir->dirName ) - 1); *( pNewVirtualDir->dirName + strlen( dirName ) ) = 0; if( pVirtualDirList == NULL ) { /* first virtual dir */ pVirtualDirList = pNewVirtualDir; } else { pLast = pVirtualDirList; while( pLast->next != NULL ) { pLast = pLast->next; } pLast->next = pNewVirtualDir; } return UPNP_E_SUCCESS; } int UpnpRemoveVirtualDir(const char *dirName) { virtualDirList *pPrev; virtualDirList *pCur; int found = 0; if( UpnpSdkInit != 1 ) { return UPNP_E_FINISH; } if( dirName == NULL ) { return UPNP_E_INVALID_PARAM; } if( pVirtualDirList == NULL ) { return UPNP_E_INVALID_PARAM; } /* Handle the special case where the directory that we are */ /* removing is the first in the list. */ if (strcmp( pVirtualDirList->dirName, dirName ) == 0) { pPrev = pVirtualDirList; pVirtualDirList = pVirtualDirList->next; free( pPrev ); return UPNP_E_SUCCESS; } pCur = pVirtualDirList->next; pPrev = pVirtualDirList; while( pCur != NULL ) { if( strcmp( pCur->dirName, dirName ) == 0 ) { pPrev->next = pCur->next; free( pCur ); found = 1; break; } else { pPrev = pCur; pCur = pCur->next; } } if( found == 1 ) return UPNP_E_SUCCESS; else return UPNP_E_INVALID_PARAM; } void UpnpRemoveAllVirtualDirs(void) { virtualDirList *pCur; virtualDirList *pNext; if( UpnpSdkInit != 1 ) { return; } pCur = pVirtualDirList; while( pCur != NULL ) { pNext = pCur->next; free( pCur ); pCur = pNext; } pVirtualDirList = NULL; } int UpnpEnableWebserver(int enable) { int retVal = UPNP_E_SUCCESS; if( UpnpSdkInit != 1 ) { return UPNP_E_FINISH; } switch ( enable ) { #ifdef INTERNAL_WEB_SERVER case TRUE: if( ( retVal = web_server_init() ) != UPNP_E_SUCCESS ) { return retVal; } bWebServerState = WEB_SERVER_ENABLED; SetHTTPGetCallback( web_server_callback ); break; case FALSE: web_server_destroy(); bWebServerState = WEB_SERVER_DISABLED; SetHTTPGetCallback( NULL ); break; #endif /* INTERNAL_WEB_SERVER */ default: retVal = UPNP_E_INVALID_PARAM; } return retVal; } /*! * \brief Checks if the webserver is enabled or disabled. * * \return 1, if webserver is enabled or 0, if webserver is disabled. */ int UpnpIsWebserverEnabled(void) { if (UpnpSdkInit != 1) { return 0; } return bWebServerState == (WebServerState)WEB_SERVER_ENABLED; } int UpnpVirtualDir_set_GetInfoCallback(VDCallback_GetInfo callback) { int ret = UPNP_E_SUCCESS; if (!callback) { ret = UPNP_E_INVALID_PARAM; } else { virtualDirCallback.get_info = callback; } return ret; } int UpnpVirtualDir_set_OpenCallback(VDCallback_Open callback) { int ret = UPNP_E_SUCCESS; if (!callback) { ret = UPNP_E_INVALID_PARAM; } else { virtualDirCallback.open = callback; } return ret; } int UpnpVirtualDir_set_ReadCallback(VDCallback_Read callback) { int ret = UPNP_E_SUCCESS; if (!callback) { ret = UPNP_E_INVALID_PARAM; } else { virtualDirCallback.read = callback; } return ret; } int UpnpVirtualDir_set_WriteCallback(VDCallback_Write callback) { int ret = UPNP_E_SUCCESS; if (!callback) { ret = UPNP_E_INVALID_PARAM; } else { virtualDirCallback.write = callback; } return ret; } int UpnpVirtualDir_set_SeekCallback(VDCallback_Seek callback) { int ret = UPNP_E_SUCCESS; if (!callback) { ret = UPNP_E_INVALID_PARAM; } else { virtualDirCallback.seek = callback; } return ret; } int UpnpVirtualDir_set_CloseCallback(VDCallback_Close callback) { int ret = UPNP_E_SUCCESS; if (!callback) { ret = UPNP_E_INVALID_PARAM; } else { virtualDirCallback.close = callback; } return ret; } int UpnpSetContentLength(UpnpClient_Handle Hnd, size_t contentLength) { int errCode = UPNP_E_SUCCESS; struct Handle_Info *HInfo = NULL; do { if (UpnpSdkInit != 1) { errCode = UPNP_E_FINISH; break; } HandleLock(); switch (GetHandleInfo(Hnd, &HInfo)) { case HND_DEVICE: break; default: HandleUnlock(); return UPNP_E_INVALID_HANDLE; } if (contentLength > MAX_SOAP_CONTENT_LENGTH) { errCode = UPNP_E_OUTOF_BOUNDS; break; } g_maxContentLength = contentLength; } while (0); HandleUnlock(); return errCode; } int UpnpSetMaxContentLength(size_t contentLength) { int errCode = UPNP_E_SUCCESS; do { if (UpnpSdkInit != 1) { errCode = UPNP_E_FINISH; break; } g_maxContentLength = contentLength; } while(0); return errCode; } /* @} UPnPAPI */ pupnp-release-1.8.0/upnp/src/api/upnpdebug.c000066400000000000000000000157641303304015100207620ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \file */ #include "config.h" #include "ithread.h" #include "ixml.h" #include "upnp.h" #include "upnpdebug.h" #include #include #include #include #ifdef DEBUG /*! Mutex to synchronize all the log file opeartions in the debug mode */ static ithread_mutex_t GlobalDebugMutex; /*! Global log level */ static Upnp_LogLevel g_log_level = UPNP_DEFAULT_LOG_LEVEL; /*! File handle for the error log file */ static FILE *ErrFileHnd = NULL; /*! File handle for the information log file */ static FILE *InfoFileHnd = NULL; /*! Name of the error file */ static const char *errFileName = "IUpnpErrFile.txt"; /*! Name of the info file */ static const char *infoFileName = "IUpnpInfoFile.txt"; int UpnpInitLog(void) { ithread_mutex_init(&GlobalDebugMutex, NULL); if (DEBUG_TARGET == 1) { if ((ErrFileHnd = fopen(errFileName, "a")) == NULL) { fprintf(stderr, "Failed to open errFileName (%s): %s\n", errFileName, strerror(errno)); ErrFileHnd = stderr; } if ((InfoFileHnd = fopen(infoFileName, "a")) == NULL) { fprintf(stderr, "Failed to open infoFileName (%s): %s\n", infoFileName, strerror(errno)); InfoFileHnd = stdout; } } return UPNP_E_SUCCESS; } void UpnpSetLogLevel(Upnp_LogLevel log_level) { g_log_level = log_level; } void UpnpCloseLog(void) { if (DEBUG_TARGET == 1) { fflush(ErrFileHnd); fflush(InfoFileHnd); fclose(ErrFileHnd); fclose(InfoFileHnd); } ithread_mutex_destroy(&GlobalDebugMutex); } void UpnpSetLogFileNames(const char *ErrFileName, const char *InfoFileName) { if (ErrFileName) { errFileName = ErrFileName; } if (InfoFileName) { infoFileName = InfoFileName; } } int DebugAtThisLevel(Upnp_LogLevel DLevel, Dbg_Module Module) { int ret = DLevel <= g_log_level; ret &= DEBUG_ALL || (Module == SSDP && DEBUG_SSDP) || (Module == SOAP && DEBUG_SOAP) || (Module == GENA && DEBUG_GENA) || (Module == TPOOL && DEBUG_TPOOL) || (Module == MSERV && DEBUG_MSERV) || (Module == DOM && DEBUG_DOM) || (Module == HTTP && DEBUG_HTTP); return ret; Module = Module; /* VC complains about this being unreferenced */ } void UpnpPrintf(Upnp_LogLevel DLevel, Dbg_Module Module, const char *DbgFileName, int DbgLineNo, const char *FmtStr, ...) { va_list ArgList; if (!DebugAtThisLevel(DLevel, Module)) return; ithread_mutex_lock(&GlobalDebugMutex); va_start(ArgList, FmtStr); if (!DEBUG_TARGET) { if (DbgFileName) UpnpDisplayFileAndLine(stdout, DbgFileName, DbgLineNo); vfprintf(stdout, FmtStr, ArgList); fflush(stdout); } else if (DLevel == 0) { if (DbgFileName) UpnpDisplayFileAndLine(ErrFileHnd, DbgFileName, DbgLineNo); vfprintf(ErrFileHnd, FmtStr, ArgList); fflush(ErrFileHnd); } else { if (DbgFileName) UpnpDisplayFileAndLine(InfoFileHnd, DbgFileName, DbgLineNo); vfprintf(InfoFileHnd, FmtStr, ArgList); fflush(InfoFileHnd); } va_end(ArgList); ithread_mutex_unlock(&GlobalDebugMutex); } FILE *GetDebugFile(Upnp_LogLevel DLevel, Dbg_Module Module) { FILE *ret; if (!DebugAtThisLevel(DLevel, Module)) ret = NULL; if (!DEBUG_TARGET) ret = stdout; else if (DLevel == 0) ret = ErrFileHnd; else ret = InfoFileHnd; return ret; } void UpnpDisplayFileAndLine(FILE *fd, const char *DbgFileName, int DbgLineNo) { #define NLINES 2 #define MAX_LINE_SIZE 512 #define NUMBER_OF_STARS 80 const char *lines[NLINES]; char buf[NLINES][MAX_LINE_SIZE]; int i; /* Initialize the pointer array */ for (i = 0; i < NLINES; i++) lines[i] = buf[i]; /* Put the debug lines in the buffer */ sprintf(buf[0], "DEBUG - THREAD ID: 0x%lX", #ifdef WIN32 (unsigned long int)ithread_self().p #else (unsigned long int)ithread_self() #endif ); if (DbgFileName) sprintf(buf[1], "FILE: %s, LINE: %d", DbgFileName, DbgLineNo); /* Show the lines centered */ UpnpDisplayBanner(fd, lines, NLINES, NUMBER_OF_STARS); fflush(fd); } void UpnpDisplayBanner(FILE * fd, const char **lines, size_t size, size_t starLength) { size_t leftMarginLength = starLength / 2 + 1; size_t rightMarginLength = starLength / 2 + 1; size_t i = 0; size_t LineSize = 0; size_t starLengthMinus2 = starLength - 2; char *leftMargin = malloc(leftMarginLength); char *rightMargin = malloc(rightMarginLength); char *stars = malloc(starLength + 1); char *currentLine = malloc(starLength + 1); const char *line = NULL; memset(stars, '*', starLength); stars[starLength] = 0; memset(leftMargin, 0, leftMarginLength); memset(rightMargin, 0, rightMarginLength); fprintf(fd, "\n%s\n", stars); for (i = 0; i < size; i++) { LineSize = strlen(lines[i]); line = lines[i]; while (LineSize > starLengthMinus2) { memcpy(currentLine, line, starLengthMinus2); currentLine[starLengthMinus2] = 0; fprintf(fd, "*%s*\n", currentLine); LineSize -= starLengthMinus2; line += starLengthMinus2; } leftMarginLength = (starLengthMinus2 - LineSize) / 2; if (LineSize % 2 == 0) rightMarginLength = leftMarginLength; else rightMarginLength = leftMarginLength + 1; memset(leftMargin, ' ', leftMarginLength); memset(rightMargin, ' ', rightMarginLength); leftMargin[leftMarginLength] = 0; rightMargin[rightMarginLength] = 0; fprintf(fd, "*%s%s%s*\n", leftMargin, line, rightMargin); } fprintf(fd, "%s\n\n", stars); free(currentLine); free(stars); free(rightMargin); free(leftMargin); } #endif /* DEBUG */ pupnp-release-1.8.0/upnp/src/api/upnptools.c000066400000000000000000000311731303304015100210240ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ #include "config.h" /*! * \file */ #if EXCLUDE_DOM == 0 #include "upnp.h" #include "upnptools.h" #include "uri.h" #include #include /*! Maximum action header buffer length. */ #define HEADER_LENGTH 2000 #ifdef WIN32 #define snprintf _snprintf #endif /*! * \brief Structure to maintain a error code and string associated with the * error code. */ struct ErrorString { /*! Error code. */ int rc; /*! Error description. */ const char *rcError; }; /*! * \brief Array of error structures. */ struct ErrorString ErrorMessages[] = { {UPNP_E_SUCCESS, "UPNP_E_SUCCESS"}, {UPNP_E_INVALID_HANDLE, "UPNP_E_INVALID_HANDLE"}, {UPNP_E_INVALID_PARAM, "UPNP_E_INVALID_PARAM"}, {UPNP_E_OUTOF_HANDLE, "UPNP_E_OUTOF_HANDLE"}, {UPNP_E_OUTOF_CONTEXT, "UPNP_E_OUTOF_CONTEXT"}, {UPNP_E_OUTOF_MEMORY, "UPNP_E_OUTOF_MEMORY"}, {UPNP_E_INIT, "UPNP_E_INIT"}, {UPNP_E_BUFFER_TOO_SMALL, "UPNP_E_BUFFER_TOO_SMALL"}, {UPNP_E_INVALID_DESC, "UPNP_E_INVALID_DESC"}, {UPNP_E_INVALID_URL, "UPNP_E_INVALID_URL"}, {UPNP_E_INVALID_SID, "UPNP_E_INVALID_SID"}, {UPNP_E_INVALID_DEVICE, "UPNP_E_INVALID_DEVICE"}, {UPNP_E_INVALID_SERVICE, "UPNP_E_INVALID_SERVICE"}, {UPNP_E_BAD_RESPONSE, "UPNP_E_BAD_RESPONSE"}, {UPNP_E_BAD_REQUEST, "UPNP_E_BAD_REQUEST"}, {UPNP_E_INVALID_ACTION, "UPNP_E_INVALID_ACTION"}, {UPNP_E_FINISH, "UPNP_E_FINISH"}, {UPNP_E_INIT_FAILED, "UPNP_E_INIT_FAILED"}, {UPNP_E_URL_TOO_BIG, "UPNP_E_URL_TOO_BIG"}, {UPNP_E_BAD_HTTPMSG, "UPNP_E_BAD_HTTPMSG"}, {UPNP_E_ALREADY_REGISTERED, "UPNP_E_ALREADY_REGISTERED"}, {UPNP_E_INVALID_INTERFACE, "UPNP_E_INVALID_INTERFACE"}, {UPNP_E_NETWORK_ERROR, "UPNP_E_NETWORK_ERROR"}, {UPNP_E_SOCKET_WRITE, "UPNP_E_SOCKET_WRITE"}, {UPNP_E_SOCKET_READ, "UPNP_E_SOCKET_READ"}, {UPNP_E_SOCKET_BIND, "UPNP_E_SOCKET_BIND"}, {UPNP_E_SOCKET_CONNECT, "UPNP_E_SOCKET_CONNECT"}, {UPNP_E_OUTOF_SOCKET, "UPNP_E_OUTOF_SOCKET"}, {UPNP_E_LISTEN, "UPNP_E_LISTEN"}, {UPNP_E_TIMEDOUT, "UPNP_E_TIMEDOUT"}, {UPNP_E_SOCKET_ERROR, "UPNP_E_SOCKET_ERROR"}, {UPNP_E_FILE_WRITE_ERROR, "UPNP_E_FILE_WRITE_ERROR"}, {UPNP_E_CANCELED, "UPNP_E_CANCELED"}, {UPNP_E_EVENT_PROTOCOL, "UPNP_E_EVENT_PROTOCOL"}, {UPNP_E_SUBSCRIBE_UNACCEPTED, "UPNP_E_SUBSCRIBE_UNACCEPTED"}, {UPNP_E_UNSUBSCRIBE_UNACCEPTED, "UPNP_E_UNSUBSCRIBE_UNACCEPTED"}, {UPNP_E_NOTIFY_UNACCEPTED, "UPNP_E_NOTIFY_UNACCEPTED"}, {UPNP_E_INVALID_ARGUMENT, "UPNP_E_INVALID_ARGUMENT"}, {UPNP_E_FILE_NOT_FOUND, "UPNP_E_FILE_NOT_FOUND"}, {UPNP_E_FILE_READ_ERROR, "UPNP_E_FILE_READ_ERROR"}, {UPNP_E_EXT_NOT_XML, "UPNP_E_EXT_NOT_XML"}, {UPNP_E_NO_WEB_SERVER, "UPNP_E_NO_WEB_SERVER"}, {UPNP_E_OUTOF_BOUNDS, "UPNP_E_OUTOF_BOUNDS"}, {UPNP_E_NOT_FOUND, "UPNP_E_NOT_FOUND"}, {UPNP_E_INTERNAL_ERROR, "UPNP_E_INTERNAL_ERROR"}, }; const char *UpnpGetErrorMessage(int rc) { size_t i; for (i = 0; i < sizeof (ErrorMessages) / sizeof (ErrorMessages[0]); ++i) { if (rc == ErrorMessages[i].rc) { return ErrorMessages[i].rcError; } } return "Unknown error code"; } /*! * \todo There is some unnecessary allocation and deallocation going on here * because of the way resolve_rel_url() was originally written and used. In the * future it would be nice to clean this up. */ int UpnpResolveURL( const char *BaseURL, const char *RelURL, char *AbsURL) { int ret = UPNP_E_SUCCESS; char *tempRel = NULL; if (!RelURL) { ret = UPNP_E_INVALID_PARAM; goto ExitFunction; } tempRel = resolve_rel_url((char *)BaseURL, (char *)RelURL); if (tempRel) { strcpy(AbsURL, tempRel); free(tempRel); } else ret = UPNP_E_INVALID_URL; ExitFunction: return ret; } int UpnpResolveURL2( const char *BaseURL, const char *RelURL, char **AbsURL) { int ret = UPNP_E_SUCCESS; if (!RelURL) { ret = UPNP_E_INVALID_PARAM; goto ExitFunction; } *AbsURL = resolve_rel_url((char *)BaseURL, (char *)RelURL); if (!*AbsURL) ret = UPNP_E_INVALID_URL; ExitFunction: return ret; } /*! * \brief Adds the argument in the action request or response. * * This function creates the action request or response if it is a first * argument, otherwise it will add the argument in the document. * * \returns UPNP_E_SUCCESS if successful, otherwise the appropriate error. */ static int addToAction( /*! [in] flag to tell if the ActionDoc is for response or request. */ int response, /*! [in,out] Request or response document. */ IXML_Document **ActionDoc, /*! [in] Name of the action request or response. */ const char *ActionName, /*! [in] Service type. */ const char *ServType, /*! [in] Name of the argument. */ const char *ArgName, /*! [in] Value of the argument. */ const char *ArgValue) { char *ActBuff = NULL; IXML_Node *node = NULL; IXML_Element *Ele = NULL; IXML_Node *Txt = NULL; int rc = 0; if (ActionName == NULL || ServType == NULL) { return UPNP_E_INVALID_PARAM; } if (*ActionDoc == NULL) { ActBuff = (char *)malloc(HEADER_LENGTH); if (ActBuff == NULL) { return UPNP_E_OUTOF_MEMORY; } if (response) { rc = snprintf(ActBuff, HEADER_LENGTH, "\r\n", ActionName, ServType, ActionName); } else { rc = snprintf(ActBuff, HEADER_LENGTH, "\r\n", ActionName, ServType, ActionName); } if (rc < 0 || (unsigned int) rc >= HEADER_LENGTH) { free(ActBuff); return UPNP_E_OUTOF_MEMORY; } rc = ixmlParseBufferEx(ActBuff, ActionDoc); free(ActBuff); if (rc != IXML_SUCCESS) { if (rc == IXML_INSUFFICIENT_MEMORY) { return UPNP_E_OUTOF_MEMORY; } else { return UPNP_E_INVALID_DESC; } } } if (ArgName != NULL /*&& ArgValue != NULL */) { node = ixmlNode_getFirstChild((IXML_Node *)*ActionDoc); Ele = ixmlDocument_createElement(*ActionDoc, ArgName); if(ArgValue) { Txt = ixmlDocument_createTextNode(*ActionDoc, ArgValue); ixmlNode_appendChild((IXML_Node *)Ele, Txt); } ixmlNode_appendChild(node, (IXML_Node *)Ele); } return UPNP_E_SUCCESS; } /*! * \brief Creates the action request or response from the argument list. * * \return Action request or response document if successful, otherwise * returns NULL */ static IXML_Document *makeAction( /*! [in] flag to tell if the ActionDoc is for response or request. */ int response, /*! [in] Name of the action request or response. */ const char *ActionName, /*! [in] Service type. */ const char *ServType, /*! [in] Number of arguments in the action request or response. */ int NumArg, /*! [in] pointer to the first argument. */ const char *Arg, /*! [in] Argument list. */ va_list ArgList) { const char *ArgName; const char *ArgValue; char *ActBuff; int Idx = 0; IXML_Document *ActionDoc; IXML_Node *node; IXML_Element *Ele; IXML_Node *Txt = NULL; int rc = 0; if (ActionName == NULL || ServType == NULL) { return NULL; } ActBuff = (char *)malloc(HEADER_LENGTH); if (ActBuff == NULL) { return NULL; } if (response) { rc = snprintf(ActBuff, HEADER_LENGTH, "\r\n", ActionName, ServType, ActionName); } else { rc = snprintf(ActBuff, HEADER_LENGTH, "\r\n", ActionName, ServType, ActionName); } if (rc < 0 || (unsigned int) rc >= HEADER_LENGTH || ixmlParseBufferEx(ActBuff, &ActionDoc) != IXML_SUCCESS) { free(ActBuff); return NULL; } free(ActBuff); if(ActionDoc == NULL) { return NULL; } if (NumArg > 0) { /*va_start(ArgList, Arg); */ ArgName = Arg; for ( ; ; ) { ArgValue = va_arg(ArgList, const char *); if (ArgName != NULL) { node = ixmlNode_getFirstChild((IXML_Node *)ActionDoc); Ele = ixmlDocument_createElement(ActionDoc, ArgName); if (ArgValue) { Txt = ixmlDocument_createTextNode(ActionDoc, ArgValue); ixmlNode_appendChild((IXML_Node *)Ele, Txt); } ixmlNode_appendChild(node, (IXML_Node *)Ele); } if (++Idx < NumArg) { ArgName = va_arg(ArgList, const char *); } else { break; } } /*va_end(ArgList); */ } return ActionDoc; } IXML_Document *UpnpMakeAction( const char *ActionName, const char *ServType, int NumArg, const char *Arg, ...) { va_list ArgList; IXML_Document *out = NULL; va_start(ArgList, Arg); out = makeAction(0, ActionName, ServType, NumArg, Arg, ArgList); va_end(ArgList); return out; } IXML_Document *UpnpMakeActionResponse( const char *ActionName, const char *ServType, int NumArg, const char *Arg, ...) { va_list ArgList; IXML_Document *out = NULL; va_start(ArgList, Arg); out = makeAction(1, ActionName, ServType, NumArg, Arg, ArgList); va_end(ArgList); return out; } int UpnpAddToAction( IXML_Document **ActionDoc, const char *ActionName, const char *ServType, const char *ArgName, const char *ArgValue) { return addToAction(0, ActionDoc, ActionName, ServType, ArgName, ArgValue); } int UpnpAddToActionResponse( IXML_Document **ActionResponse, const char *ActionName, const char *ServType, const char *ArgName, const char *ArgValue) { return addToAction(1, ActionResponse, ActionName, ServType, ArgName, ArgValue); } IXML_Document *UpnpCreatePropertySet( int NumArg, const char *Arg, ...) { va_list ArgList; int Idx = 0; char BlankDoc[] = "" ""; const char *ArgName, *ArgValue; IXML_Node *node; IXML_Element *Ele; IXML_Element *Ele1; IXML_Node *Txt; IXML_Document *PropSet; if(ixmlParseBufferEx(BlankDoc, &PropSet) != IXML_SUCCESS) { return NULL; } if (NumArg < 1) { return PropSet; } va_start(ArgList, Arg); ArgName = Arg; while (Idx++ != NumArg) { ArgValue = va_arg(ArgList, const char *); if (ArgName != NULL /*&& ArgValue != NULL */) { node = ixmlNode_getFirstChild((IXML_Node *)PropSet); Ele1 = ixmlDocument_createElement(PropSet, "e:property"); Ele = ixmlDocument_createElement(PropSet, ArgName); if (ArgValue) { Txt = ixmlDocument_createTextNode(PropSet, ArgValue); ixmlNode_appendChild((IXML_Node *)Ele, Txt); } ixmlNode_appendChild((IXML_Node *)Ele1, (IXML_Node *)Ele); ixmlNode_appendChild( node, (IXML_Node *)Ele1); } ArgName = va_arg(ArgList, const char *); } va_end(ArgList); return PropSet; } int UpnpAddToPropertySet( IXML_Document **PropSet, const char *ArgName, const char *ArgValue) { char BlankDoc[] = "" ""; IXML_Node *node; IXML_Element *Ele; IXML_Element *Ele1; IXML_Node *Txt; int rc; if (ArgName == NULL) { return UPNP_E_INVALID_PARAM; } if (*PropSet == NULL) { rc = ixmlParseBufferEx(BlankDoc, PropSet); if (rc != IXML_SUCCESS) { return UPNP_E_OUTOF_MEMORY; } } node = ixmlNode_getFirstChild((IXML_Node *)*PropSet); Ele1 = ixmlDocument_createElement(*PropSet, "e:property"); Ele = ixmlDocument_createElement(*PropSet, ArgName); if (ArgValue) { Txt = ixmlDocument_createTextNode(*PropSet, ArgValue); ixmlNode_appendChild((IXML_Node *)Ele, Txt); } ixmlNode_appendChild((IXML_Node *)Ele1, (IXML_Node *)Ele); ixmlNode_appendChild(node, (IXML_Node *)Ele1); return UPNP_E_SUCCESS; } #endif /* EXCLUDE_DOM == 0 */ pupnp-release-1.8.0/upnp/src/gena/000077500000000000000000000000001303304015100167515ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/gena/gena_callback2.c000066400000000000000000000113761303304015100217350ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #include "config.h" #if EXCLUDE_GENA == 0 #include "gena.h" #include "gena_device.h" #include "gena_ctrlpt.h" #include "httpparser.h" #include "httpreadwrite.h" #include "statcodes.h" #include "unixutil.h" /************************************************************************ * Function : error_respond * * Parameters: * IN SOCKINFO *info: Structure containing information about the socket * IN int error_code: error code that will be in the GENA response * IN http_message_t* hmsg: GENA request Packet * * Description: * This function send an error message to the control point in the case * incorrect GENA requests. * * Returns: int * UPNP_E_SUCCESS if successful else appropriate error ***************************************************************************/ void error_respond( IN SOCKINFO * info, IN int error_code, IN http_message_t * hmsg ) { int major, minor; /* retrieve the minor and major version from the GENA request */ http_CalcResponseVersion( hmsg->major_version, hmsg->minor_version, &major, &minor ); http_SendStatusResponse( info, error_code, major, minor ); } /************************************************************************ * Function : genaCallback * * Parameters: * IN http_parser_t *parser: represents the parse state of the request * IN http_message_t* request: HTTP message containing GENA request * INOUT SOCKINFO *info: Structure containing information about the socket * * Description: * This is the callback function called by the miniserver to handle * incoming GENA requests. * * Returns: int * UPNP_E_SUCCESS if successful else appropriate error ***************************************************************************/ void genaCallback( IN http_parser_t * parser, IN http_message_t * request, INOUT SOCKINFO * info ) { int found_function = FALSE; if( request->method == HTTPMETHOD_SUBSCRIBE ) { #ifdef INCLUDE_DEVICE_APIS found_function = TRUE; if( httpmsg_find_hdr( request, HDR_NT, NULL ) == NULL ) { /* renew subscription */ gena_process_subscription_renewal_request ( info, request ); } else { /* subscribe */ gena_process_subscription_request( info, request ); } UpnpPrintf( UPNP_ALL, GENA, __FILE__, __LINE__, "got subscription request\n" ); } else if( request->method == HTTPMETHOD_UNSUBSCRIBE ) { found_function = TRUE; /* unsubscribe */ gena_process_unsubscribe_request( info, request ); #endif } else if( request->method == HTTPMETHOD_NOTIFY ) { #ifdef INCLUDE_CLIENT_APIS found_function = TRUE; /* notify */ gena_process_notification_event( info, request ); #endif } if( !found_function ) { /* handle missing functions of device or ctrl pt */ error_respond( info, HTTP_NOT_IMPLEMENTED, request ); } return; parser = parser; } #endif /* EXCLUDE_GENA */ pupnp-release-1.8.0/upnp/src/gena/gena_ctrlpt.c000066400000000000000000000542271303304015100214310ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #include "config.h" /*! * \file */ #if EXCLUDE_GENA == 0 #ifdef INCLUDE_CLIENT_APIS #include "EventSubscribe.h" #include "gena.h" #include "httpparser.h" #include "httpreadwrite.h" #include "parsetools.h" #include "statcodes.h" #include "sysdep.h" #include "uuid.h" #include "upnpapi.h" #ifdef WIN32 #define snprintf _snprintf #endif extern ithread_mutex_t GlobalClientSubscribeMutex; /*! * \brief This is a thread function to send the renewal just before the * subscription times out. */ static void GenaAutoRenewSubscription( /*! [in] Thread data(upnp_timeout *) needed to send the renewal. */ IN void *input) { upnp_timeout *event = (upnp_timeout *) input; UpnpEventSubscribe *sub_struct = (UpnpEventSubscribe *)event->Event; void *cookie; Upnp_FunPtr callback_fun; struct Handle_Info *handle_info; int send_callback = 0; int eventType = 0; int timeout = 0; int errCode = 0; if (AUTO_RENEW_TIME == 0) { UpnpPrintf( UPNP_INFO, GENA, __FILE__, __LINE__, "GENA SUB EXPIRED"); UpnpEventSubscribe_set_ErrCode(sub_struct, UPNP_E_SUCCESS); send_callback = 1; eventType = UPNP_EVENT_SUBSCRIPTION_EXPIRED; } else { UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "GENA AUTO RENEW"); timeout = UpnpEventSubscribe_get_TimeOut(sub_struct); errCode = genaRenewSubscription( event->handle, UpnpEventSubscribe_get_SID(sub_struct), &timeout); UpnpEventSubscribe_set_ErrCode(sub_struct, errCode); UpnpEventSubscribe_set_TimeOut(sub_struct, timeout); if (errCode != UPNP_E_SUCCESS && errCode != GENA_E_BAD_SID && errCode != GENA_E_BAD_HANDLE) { send_callback = 1; eventType = UPNP_EVENT_AUTORENEWAL_FAILED; } } if (send_callback) { HandleReadLock(); if( GetHandleInfo( event->handle, &handle_info ) != HND_CLIENT ) { HandleUnlock(); free_upnp_timeout(event); goto end_function; } UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "HANDLE IS VALID"); /* make callback */ callback_fun = handle_info->Callback; cookie = handle_info->Cookie; HandleUnlock(); callback_fun(eventType, event->Event, cookie); } free_upnp_timeout(event); end_function: return; } /*! * \brief Schedules a job to renew the subscription just before time out. * * \return GENA_E_SUCCESS if successful, otherwise returns the appropriate * error code. */ static int ScheduleGenaAutoRenew( /*! [in] Handle that also contains the subscription list. */ IN int client_handle, /*! [in] The time out value of the subscription. */ IN int TimeOut, /*! [in] Subscription being renewed. */ IN GenlibClientSubscription *sub) { UpnpEventSubscribe *RenewEventStruct = NULL; upnp_timeout *RenewEvent = NULL; int return_code = GENA_SUCCESS; ThreadPoolJob job; memset(&job, 0, sizeof(job)); if (TimeOut == UPNP_INFINITE) { return_code = GENA_SUCCESS; goto end_function; } RenewEventStruct = UpnpEventSubscribe_new(); if (RenewEventStruct == NULL) { return_code = UPNP_E_OUTOF_MEMORY; goto end_function; } RenewEvent = (upnp_timeout *) malloc(sizeof(upnp_timeout)); if (RenewEvent == NULL) { free(RenewEventStruct); return_code = UPNP_E_OUTOF_MEMORY; goto end_function; } memset(RenewEvent, 0, sizeof(upnp_timeout)); /* schedule expire event */ UpnpEventSubscribe_set_ErrCode(RenewEventStruct, UPNP_E_SUCCESS); UpnpEventSubscribe_set_TimeOut(RenewEventStruct, TimeOut); UpnpEventSubscribe_set_SID(RenewEventStruct, GenlibClientSubscription_get_SID(sub)); UpnpEventSubscribe_set_PublisherUrl(RenewEventStruct, GenlibClientSubscription_get_EventURL(sub)); /* RenewEvent->EventType=UPNP_EVENT_SUBSCRIPTION_EXPIRE; */ RenewEvent->handle = client_handle; RenewEvent->Event = RenewEventStruct; TPJobInit(&job, (start_routine) GenaAutoRenewSubscription, RenewEvent); TPJobSetFreeFunction(&job, (free_routine)free_upnp_timeout); TPJobSetPriority(&job, MED_PRIORITY); /* Schedule the job */ return_code = TimerThreadSchedule( &gTimerThread, TimeOut - AUTO_RENEW_TIME, REL_SEC, &job, SHORT_TERM, &(RenewEvent->eventId)); if (return_code != UPNP_E_SUCCESS) { free(RenewEvent); free(RenewEventStruct); goto end_function; } GenlibClientSubscription_set_RenewEventId(sub, RenewEvent->eventId); return_code = GENA_SUCCESS; end_function: return return_code; } /*! * \brief Sends the UNSUBCRIBE gena request and recieves the response from the * device and returns it as a parameter. * * \returns 0 if successful, otherwise returns the appropriate error code. */ static int gena_unsubscribe( /*! [in] Event URL of the service. */ IN const UpnpString *url, /*! [in] The subcription ID. */ IN const UpnpString *sid, /*! [out] The UNSUBCRIBE response from the device. */ OUT http_parser_t *response ) { int return_code; uri_type dest_url; membuffer request; /* parse url */ return_code = http_FixStrUrl( UpnpString_get_String(url), UpnpString_get_Length(url), &dest_url); if (return_code != 0) { return return_code; } /* make request msg */ membuffer_init(&request); request.size_inc = 30; return_code = http_MakeMessage( &request, 1, 1, "q" "ssc" "Uc", HTTPMETHOD_UNSUBSCRIBE, &dest_url, "SID: ", UpnpString_get_String(sid)); /* Not able to make the message so destroy the existing buffer */ if (return_code != 0) { membuffer_destroy(&request); return return_code; } /* send request and get reply */ return_code = http_RequestAndResponse( &dest_url, request.buf, request.length, HTTPMETHOD_UNSUBSCRIBE, HTTP_DEFAULT_TIMEOUT, response); membuffer_destroy(&request); if (return_code != 0) { httpmsg_destroy(&response->msg); } if (return_code == 0 && response->msg.status_code != HTTP_OK) { return_code = UPNP_E_UNSUBSCRIBE_UNACCEPTED; httpmsg_destroy(&response->msg); } return return_code; } /*! * \brief Subscribes or renew subscription. * * \return 0 if successful, otherwise returns the appropriate error code. */ static int gena_subscribe( /*! [in] URL of service to subscribe. */ IN const UpnpString *url, /*! [in,out] Subscription time desired (in secs). */ INOUT int *timeout, /*! [in] for renewal, this contains a currently held subscription SID. * For first time subscription, this must be NULL. */ IN const UpnpString *renewal_sid, /*! [out] SID returned by the subscription or renew msg. */ OUT UpnpString *sid) { int return_code; int parse_ret = 0; int local_timeout = CP_MINIMUM_SUBSCRIPTION_TIME; memptr sid_hdr; memptr timeout_hdr; char timeout_str[25]; membuffer request; uri_type dest_url; http_parser_t response; int rc = 0; UpnpString_clear(sid); /* request timeout to string */ if (timeout == NULL) { timeout = &local_timeout; } if (*timeout < 0) { memset(timeout_str, 0, sizeof(timeout_str)); strncpy(timeout_str, "infinite", sizeof(timeout_str) - 1); } else if(*timeout < CP_MINIMUM_SUBSCRIPTION_TIME) { rc = snprintf(timeout_str, sizeof(timeout_str), "%d", CP_MINIMUM_SUBSCRIPTION_TIME); } else { rc = snprintf(timeout_str, sizeof(timeout_str), "%d", *timeout); } if (rc < 0 || (unsigned int) rc >= sizeof(timeout_str)) return UPNP_E_OUTOF_MEMORY; /* parse url */ return_code = http_FixStrUrl( UpnpString_get_String(url), UpnpString_get_Length(url), &dest_url); if (return_code != 0) { return return_code; } /* make request msg */ membuffer_init(&request); request.size_inc = 30; if (renewal_sid) { /* renew subscription */ return_code = http_MakeMessage( &request, 1, 1, "q" "ssc" "sscc", HTTPMETHOD_SUBSCRIBE, &dest_url, "SID: ", UpnpString_get_String(renewal_sid), "TIMEOUT: Second-", timeout_str ); } else { /* subscribe */ if (dest_url.hostport.IPaddress.ss_family == AF_INET6) { struct sockaddr_in6* DestAddr6 = (struct sockaddr_in6*)&dest_url.hostport.IPaddress; return_code = http_MakeMessage( &request, 1, 1, "q" "sssdsc" "sc" "sscc", HTTPMETHOD_SUBSCRIBE, &dest_url, "CALLBACK: sin6_addr) || strlen(gIF_IPV6_ULA_GUA) == 0) ? gIF_IPV6 : gIF_IPV6_ULA_GUA, "]:", LOCAL_PORT_V6, "/>", "NT: upnp:event", "TIMEOUT: Second-", timeout_str); } else { return_code = http_MakeMessage( &request, 1, 1, "q" "sssdsc" "sc" "sscc", HTTPMETHOD_SUBSCRIBE, &dest_url, "CALLBACK: ", "NT: upnp:event", "TIMEOUT: Second-", timeout_str); } } if (return_code != 0) { return return_code; } /* send request and get reply */ return_code = http_RequestAndResponse(&dest_url, request.buf, request.length, HTTPMETHOD_SUBSCRIBE, HTTP_DEFAULT_TIMEOUT, &response); membuffer_destroy(&request); if (return_code != 0) { httpmsg_destroy(&response.msg); return return_code; } if (response.msg.status_code != HTTP_OK) { httpmsg_destroy(&response.msg); return UPNP_E_SUBSCRIBE_UNACCEPTED; } /* get SID and TIMEOUT */ if (httpmsg_find_hdr(&response.msg, HDR_SID, &sid_hdr) == NULL || sid_hdr.length == 0 || httpmsg_find_hdr( &response.msg, HDR_TIMEOUT, &timeout_hdr ) == NULL || timeout_hdr.length == 0 ) { httpmsg_destroy( &response.msg ); return UPNP_E_BAD_RESPONSE; } /* save timeout */ parse_ret = matchstr(timeout_hdr.buf, timeout_hdr.length, "%iSecond-%d%0", timeout); if (parse_ret == PARSE_OK) { /* nothing to do */ } else if (memptr_cmp_nocase(&timeout_hdr, "Second-infinite") == 0) { *timeout = -1; } else { httpmsg_destroy( &response.msg ); return UPNP_E_BAD_RESPONSE; } /* save SID */ UpnpString_set_StringN(sid, sid_hdr.buf, sid_hdr.length); if (UpnpString_get_String(sid) == NULL) { httpmsg_destroy(&response.msg); return UPNP_E_OUTOF_MEMORY; } httpmsg_destroy(&response.msg); return UPNP_E_SUCCESS; } int genaUnregisterClient(UpnpClient_Handle client_handle) { GenlibClientSubscription *sub_copy = GenlibClientSubscription_new(); int return_code = UPNP_E_SUCCESS; struct Handle_Info *handle_info = NULL; http_parser_t response; while (TRUE) { HandleLock(); if (GetHandleInfo(client_handle, &handle_info) != HND_CLIENT) { HandleUnlock(); return_code = GENA_E_BAD_HANDLE; goto exit_function; } if (handle_info->ClientSubList == NULL) { return_code = UPNP_E_SUCCESS; break; } GenlibClientSubscription_assign(sub_copy, handle_info->ClientSubList); RemoveClientSubClientSID( &handle_info->ClientSubList, GenlibClientSubscription_get_SID(sub_copy)); HandleUnlock(); return_code = gena_unsubscribe( GenlibClientSubscription_get_EventURL(sub_copy), GenlibClientSubscription_get_ActualSID(sub_copy), &response); if (return_code == 0) { httpmsg_destroy(&response.msg); } free_client_subscription(sub_copy); } freeClientSubList(handle_info->ClientSubList); HandleUnlock(); exit_function: GenlibClientSubscription_delete(sub_copy); return return_code; } #ifdef INCLUDE_CLIENT_APIS int genaUnSubscribe( UpnpClient_Handle client_handle, const UpnpString *in_sid) { GenlibClientSubscription *sub = NULL; int return_code = GENA_SUCCESS; struct Handle_Info *handle_info; GenlibClientSubscription *sub_copy = GenlibClientSubscription_new(); http_parser_t response; /* validate handle and sid */ HandleLock(); if (GetHandleInfo(client_handle, &handle_info) != HND_CLIENT) { HandleUnlock(); return_code = GENA_E_BAD_HANDLE; goto exit_function; } sub = GetClientSubClientSID(handle_info->ClientSubList, in_sid); if (sub == NULL) { HandleUnlock(); return_code = GENA_E_BAD_SID; goto exit_function; } GenlibClientSubscription_assign(sub_copy, sub); HandleUnlock(); return_code = gena_unsubscribe( GenlibClientSubscription_get_EventURL(sub_copy), GenlibClientSubscription_get_ActualSID(sub_copy), &response); if (return_code == 0) { httpmsg_destroy(&response.msg); } free_client_subscription(sub_copy); HandleLock(); if (GetHandleInfo(client_handle, &handle_info) != HND_CLIENT) { HandleUnlock(); return_code = GENA_E_BAD_HANDLE; goto exit_function; } RemoveClientSubClientSID(&handle_info->ClientSubList, in_sid); HandleUnlock(); exit_function: GenlibClientSubscription_delete(sub_copy); return return_code; } #endif /* INCLUDE_CLIENT_APIS */ #ifdef INCLUDE_CLIENT_APIS int genaSubscribe( UpnpClient_Handle client_handle, const UpnpString *PublisherURL, int *TimeOut, UpnpString *out_sid) { int return_code = GENA_SUCCESS; GenlibClientSubscription *newSubscription = GenlibClientSubscription_new(); uuid_upnp uid; Upnp_SID temp_sid; Upnp_SID temp_sid2; UpnpString *ActualSID = UpnpString_new(); UpnpString *EventURL = UpnpString_new(); struct Handle_Info *handle_info; int rc = 0; memset(temp_sid, 0, sizeof(temp_sid)); memset(temp_sid2, 0, sizeof(temp_sid2)); UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "GENA SUBSCRIBE BEGIN"); UpnpString_clear(out_sid); HandleReadLock(); /* validate handle */ if (GetHandleInfo(client_handle, &handle_info) != HND_CLIENT) { return_code = GENA_E_BAD_HANDLE; SubscribeLock(); goto error_handler; } HandleUnlock(); /* subscribe */ SubscribeLock(); return_code = gena_subscribe(PublisherURL, TimeOut, NULL, ActualSID); HandleLock(); if (return_code != UPNP_E_SUCCESS) { UpnpPrintf( UPNP_CRITICAL, GENA, __FILE__, __LINE__, "SUBSCRIBE FAILED in transfer error code: %d returned\n", return_code ); goto error_handler; } if(GetHandleInfo(client_handle, &handle_info) != HND_CLIENT) { return_code = GENA_E_BAD_HANDLE; goto error_handler; } /* generate client SID */ uuid_create(&uid ); uuid_unpack(&uid, temp_sid); rc = snprintf(temp_sid2, sizeof(temp_sid2), "uuid:%s", temp_sid); if (rc < 0 || (unsigned int) rc >= sizeof(temp_sid2)) { return_code = UPNP_E_OUTOF_MEMORY; goto error_handler; } UpnpString_set_String(out_sid, temp_sid2); /* create event url */ UpnpString_assign(EventURL, PublisherURL); /* fill subscription */ if (newSubscription == NULL) { return_code = UPNP_E_OUTOF_MEMORY; goto error_handler; } GenlibClientSubscription_set_RenewEventId(newSubscription, -1); GenlibClientSubscription_set_SID(newSubscription, out_sid); GenlibClientSubscription_set_ActualSID(newSubscription, ActualSID); GenlibClientSubscription_set_EventURL(newSubscription, EventURL); GenlibClientSubscription_set_Next(newSubscription, handle_info->ClientSubList); handle_info->ClientSubList = newSubscription; /* schedule expiration event */ return_code = ScheduleGenaAutoRenew(client_handle, *TimeOut, newSubscription); error_handler: UpnpString_delete(ActualSID); UpnpString_delete(EventURL); if (return_code != UPNP_E_SUCCESS) GenlibClientSubscription_delete(newSubscription); HandleUnlock(); SubscribeUnlock(); return return_code; } #endif /* INCLUDE_CLIENT_APIS */ int genaRenewSubscription( UpnpClient_Handle client_handle, const UpnpString *in_sid, int *TimeOut) { int return_code = GENA_SUCCESS; GenlibClientSubscription *sub = NULL; GenlibClientSubscription *sub_copy = GenlibClientSubscription_new(); struct Handle_Info *handle_info; UpnpString *ActualSID = UpnpString_new(); ThreadPoolJob tempJob; HandleLock(); /* validate handle and sid */ if (GetHandleInfo(client_handle, &handle_info) != HND_CLIENT) { HandleUnlock(); return_code = GENA_E_BAD_HANDLE; goto exit_function; } sub = GetClientSubClientSID(handle_info->ClientSubList, in_sid); if (sub == NULL) { HandleUnlock(); return_code = GENA_E_BAD_SID; goto exit_function; } /* remove old events */ if (TimerThreadRemove( &gTimerThread, GenlibClientSubscription_get_RenewEventId(sub), &tempJob) == 0 ) { free_upnp_timeout((upnp_timeout *)tempJob.arg); } UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "REMOVED AUTO RENEW EVENT"); GenlibClientSubscription_set_RenewEventId(sub, -1); GenlibClientSubscription_assign(sub_copy, sub); HandleUnlock(); return_code = gena_subscribe( GenlibClientSubscription_get_EventURL(sub_copy), TimeOut, GenlibClientSubscription_get_ActualSID(sub_copy), ActualSID); HandleLock(); if (GetHandleInfo(client_handle, &handle_info) != HND_CLIENT) { HandleUnlock(); return_code = GENA_E_BAD_HANDLE; goto exit_function; } /* we just called GetHandleInfo, so we don't check for return value */ /*GetHandleInfo(client_handle, &handle_info); */ if (return_code != UPNP_E_SUCCESS) { /* network failure (remove client sub) */ RemoveClientSubClientSID(&handle_info->ClientSubList, in_sid); free_client_subscription(sub_copy); HandleUnlock(); goto exit_function; } /* get subscription */ sub = GetClientSubClientSID(handle_info->ClientSubList, in_sid); if (sub == NULL) { free_client_subscription(sub_copy); HandleUnlock(); return_code = GENA_E_BAD_SID; goto exit_function; } /* store actual sid */ GenlibClientSubscription_set_ActualSID(sub, ActualSID); /* start renew subscription timer */ return_code = ScheduleGenaAutoRenew(client_handle, *TimeOut, sub); if (return_code != GENA_SUCCESS) { RemoveClientSubClientSID( &handle_info->ClientSubList, GenlibClientSubscription_get_SID(sub)); } free_client_subscription(sub_copy); HandleUnlock(); exit_function: UpnpString_delete(ActualSID); GenlibClientSubscription_delete(sub_copy); return return_code; } void gena_process_notification_event( SOCKINFO *info, http_message_t *event) { UpnpEvent *event_struct = UpnpEvent_new(); IXML_Document *ChangedVars = NULL; int eventKey; token sid; GenlibClientSubscription *subscription = NULL; struct Handle_Info *handle_info; void *cookie; Upnp_FunPtr callback; UpnpClient_Handle client_handle; memptr sid_hdr; memptr nt_hdr, nts_hdr; memptr seq_hdr; /* get SID */ if (httpmsg_find_hdr(event, HDR_SID, &sid_hdr) == NULL) { error_respond(info, HTTP_PRECONDITION_FAILED, event); goto exit_function; } sid.buff = sid_hdr.buf; sid.size = sid_hdr.length; /* get event key */ if (httpmsg_find_hdr(event, HDR_SEQ, &seq_hdr) == NULL || matchstr(seq_hdr.buf, seq_hdr.length, "%d%0", &eventKey) != PARSE_OK) { error_respond( info, HTTP_BAD_REQUEST, event ); goto exit_function; } /* get NT and NTS headers */ if (httpmsg_find_hdr(event, HDR_NT, &nt_hdr) == NULL || httpmsg_find_hdr(event, HDR_NTS, &nts_hdr) == NULL) { error_respond( info, HTTP_BAD_REQUEST, event ); goto exit_function; } /* verify NT and NTS headers */ if (memptr_cmp(&nt_hdr, "upnp:event") != 0 || memptr_cmp(&nts_hdr, "upnp:propchange") != 0) { error_respond(info, HTTP_PRECONDITION_FAILED, event); goto exit_function; } /* parse the content (should be XML) */ if (!has_xml_content_type(event) || event->msg.length == 0 || ixmlParseBufferEx(event->entity.buf, &ChangedVars) != IXML_SUCCESS) { error_respond(info, HTTP_BAD_REQUEST, event); goto exit_function; } HandleLock(); /* get client info */ if (GetClientHandleInfo(&client_handle, &handle_info) != HND_CLIENT) { error_respond(info, HTTP_PRECONDITION_FAILED, event); HandleUnlock(); goto exit_function; } /* get subscription based on SID */ subscription = GetClientSubActualSID(handle_info->ClientSubList, &sid); if (subscription == NULL) { if (eventKey == 0) { /* wait until we've finished processing a subscription */ /* (if we are in the middle) */ /* this is to avoid mistakenly rejecting the first event if we */ /* receive it before the subscription response */ HandleUnlock(); /* try and get Subscription Lock */ /* (in case we are in the process of subscribing) */ SubscribeLock(); /* get HandleLock again */ HandleLock(); if (GetClientHandleInfo(&client_handle, &handle_info) != HND_CLIENT) { error_respond(info, HTTP_PRECONDITION_FAILED, event); SubscribeUnlock(); HandleUnlock(); goto exit_function; } subscription = GetClientSubActualSID(handle_info->ClientSubList, &sid); if (subscription == NULL) { error_respond( info, HTTP_PRECONDITION_FAILED, event ); SubscribeUnlock(); HandleUnlock(); goto exit_function; } SubscribeUnlock(); } else { error_respond( info, HTTP_PRECONDITION_FAILED, event ); HandleUnlock(); goto exit_function; } } /* success */ error_respond(info, HTTP_OK, event); /* fill event struct */ UpnpEvent_set_EventKey(event_struct, eventKey); UpnpEvent_set_ChangedVariables(event_struct, ChangedVars); UpnpEvent_set_SID(event_struct, GenlibClientSubscription_get_SID(subscription)); /* copy callback */ callback = handle_info->Callback; cookie = handle_info->Cookie; HandleUnlock(); /* make callback with event struct */ /* In future, should find a way of mainting */ /* that the handle is not unregistered in the middle of a */ /* callback */ callback(UPNP_EVENT_RECEIVED, event_struct, cookie); exit_function: ixmlDocument_free(ChangedVars); UpnpEvent_delete(event_struct); } #endif /* INCLUDE_CLIENT_APIS */ #endif /* EXCLUDE_GENA */ pupnp-release-1.8.0/upnp/src/gena/gena_device.c000066400000000000000000001233331303304015100213530ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \file */ #include "config.h" #if EXCLUDE_GENA == 0 #ifdef INCLUDE_DEVICE_APIS #include "gena.h" #include "httpparser.h" #include "httpreadwrite.h" #include "parsetools.h" #include "ssdplib.h" #include "statcodes.h" #include "sysdep.h" #include "unixutil.h" #include "upnpapi.h" #include "uuid.h" #ifdef WIN32 #define snprintf _snprintf #endif /*! * \brief Unregisters a device. * * \return UPNP_E_SUCCESS on success, GENA_E_BAD_HANDLE on failure. */ int genaUnregisterDevice( /*! [in] Device handle. */ UpnpDevice_Handle device_handle) { int ret = 0; struct Handle_Info *handle_info; HandleLock(); if (GetHandleInfo(device_handle, &handle_info) != HND_DEVICE) { UpnpPrintf(UPNP_CRITICAL, GENA, __FILE__, __LINE__, "genaUnregisterDevice: BAD Handle: %d\n", device_handle); ret = GENA_E_BAD_HANDLE; } else { freeServiceTable(&handle_info->ServiceTable); ret = UPNP_E_SUCCESS; } HandleUnlock(); return ret; } /*! * \brief Generates XML property set for notifications. * * \return UPNP_E_SUCCESS if successful else returns GENA_E_BAD_HANDLE. * * \note The XML_VERSION comment is NOT sent due to interoperability issues * with other UPnP vendors. */ static int GeneratePropertySet( /*! [in] Array of variable names (go in the event notify). */ char **names, /*! [in] Array of variable values (go in the event notify). */ char **values, /*! [in] number of variables. */ int count, /*! [out] PropertySet node in the string format. */ DOMString *out) { char *buffer; int counter = 0; size_t size = 0; /*size += strlen(XML_VERSION);*/ size += strlen(XML_PROPERTYSET_HEADER); size += strlen("\n\n"); for (counter = 0; counter < count; counter++) { size += strlen( "\n\n" ); size += 2 * strlen(names[counter]) + strlen(values[counter]) + strlen("<>\n"); } buffer = (char *)malloc(size + 1); if (buffer == NULL) return UPNP_E_OUTOF_MEMORY; memset(buffer, 0, size + 1); /* strcpy(buffer,XML_VERSION); strcat(buffer, XML_PROPERTYSET_HEADER); */ strcpy(buffer, XML_PROPERTYSET_HEADER); for (counter = 0; counter < count; counter++) { strcat(buffer, "\n"); sprintf(&buffer[strlen(buffer)], "<%s>%s\n\n", names[counter], values[counter], names[counter]); } strcat(buffer, "\n\n"); *out = ixmlCloneDOMString(buffer); free(buffer); return XML_SUCCESS; } /*! * \brief Frees memory used in notify_threads if the reference count is 0, * otherwise decrements the refrence count. */ static void free_notify_struct( /*! [in] Notify structure. */ notify_thread_struct *input) { (*input->reference_count)--; if (*input->reference_count == 0) { free(input->headers); ixmlFreeDOMString(input->propertySet); free(input->servId); free(input->UDN); free(input->reference_count); } free(input); } /*! * \brief Sends the notify message and returns a reply. * * \return on success returns UPNP_E_SUCCESS, otherwise returns a UPNP error. * * \note called by genaNotify */ static UPNP_INLINE int notify_send_and_recv( /*! [in] subscription callback URL (URL of the control point). */ uri_type *destination_url, /*! [in] Common HTTP headers. */ membuffer *mid_msg, /*! [in] The evented XML. */ char *propertySet, /*! [out] The response from the control point. */ http_parser_t *response) { uri_type url; SOCKET conn_fd; membuffer start_msg; int ret_code; int err_code; int timeout; SOCKINFO info; const char *CRLF = "\r\n"; /* connect */ UpnpPrintf(UPNP_ALL, GENA, __FILE__, __LINE__, "gena notify to: %.*s\n", (int)destination_url->hostport.text.size, destination_url->hostport.text.buff); conn_fd = http_Connect(destination_url, &url); if (conn_fd < 0) /* return UPNP error */ return UPNP_E_SOCKET_CONNECT; ret_code = sock_init(&info, conn_fd); if (ret_code) { sock_destroy(&info, SD_BOTH); return ret_code; } /* make start line and HOST header */ membuffer_init(&start_msg); if (http_MakeMessage( &start_msg, 1, 1, "q" "s", HTTPMETHOD_NOTIFY, &url, mid_msg->buf) != 0) { membuffer_destroy(&start_msg); sock_destroy(&info, SD_BOTH); return UPNP_E_OUTOF_MEMORY; } timeout = GENA_NOTIFICATION_SENDING_TIMEOUT; /* send msg (note: end of notification will contain "\r\n" twice) */ ret_code = http_SendMessage(&info, &timeout, "bbb", start_msg.buf, start_msg.length, propertySet, strlen(propertySet), CRLF, strlen(CRLF)); if (ret_code) { membuffer_destroy(&start_msg); sock_destroy(&info, SD_BOTH); return ret_code; } timeout = GENA_NOTIFICATION_ANSWERING_TIMEOUT; ret_code = http_RecvMessage(&info, response, HTTPMETHOD_NOTIFY, &timeout, &err_code); if (ret_code) { membuffer_destroy(&start_msg); sock_destroy(&info, SD_BOTH); httpmsg_destroy(&response->msg); return ret_code; } /* should shutdown completely when closing socket */ sock_destroy(&info, SD_BOTH); membuffer_destroy(&start_msg); return UPNP_E_SUCCESS; } /*! * \brief Function to Notify a particular subscription of a particular event. * * In general the service should NOT be blocked around this call (this may * cause deadlock with a client). * * NOTIFY http request is sent and the reply is processed. * * \return GENA_SUCCESS if the event was delivered, otherwise returns the * appropriate error code. */ static int genaNotify( /*! [in] Null terminated, includes all headers (including \\r\\n) except SID and SEQ. */ char *headers, /*! [in] The evented XML. */ char *propertySet, /*! [in] subscription to be Notified, assumes this is valid for life of function. */ subscription *sub) { size_t i; membuffer mid_msg; uri_type *url; http_parser_t response; int return_code = -1; membuffer_init(&mid_msg); if (http_MakeMessage(&mid_msg, 1, 1, "s" "ssc" "sdcc", headers, "SID: ", sub->sid, "SEQ: ", sub->ToSendEventKey) != 0) { membuffer_destroy(&mid_msg); return UPNP_E_OUTOF_MEMORY; } /* send a notify to each url until one goes thru */ for (i = 0; i < sub->DeliveryURLs.size; i++) { url = &sub->DeliveryURLs.parsedURLs[i]; return_code = notify_send_and_recv( url, &mid_msg, propertySet, &response); if (return_code == UPNP_E_SUCCESS) break; } membuffer_destroy(&mid_msg); if (return_code == UPNP_E_SUCCESS) { if (response.msg.status_code == HTTP_OK) return_code = GENA_SUCCESS; else { if (response.msg.status_code == HTTP_PRECONDITION_FAILED) /*Invalid SID gets removed */ return_code = GENA_E_NOTIFY_UNACCEPTED_REMOVE_SUB; else return_code = GENA_E_NOTIFY_UNACCEPTED; } httpmsg_destroy(&response.msg); } return return_code; } /*! * \brief Thread job to Notify a control point. * * It validates the subscription and copies the subscription. Also make sure * that events are sent in order. * * \note calls the genaNotify to do the actual work. */ static void genaNotifyThread( /*! [in] notify thread structure containing all the headers and property set info. */ void *input) { subscription *sub; service_info *service; subscription sub_copy; notify_thread_struct *in = (notify_thread_struct *) input; int return_code; struct Handle_Info *handle_info; ThreadPoolJob job; memset(&job, 0, sizeof(job)); /* This should be a HandleLock and not a HandleReadLock otherwise if there * is a lot of notifications, then multiple threads will acquire a read * lock and the thread which sends the notification will be blocked forever * on the HandleLock at the end of this function. */ /*HandleReadLock(); */ HandleLock(); /* validate context */ if (GetHandleInfo(in->device_handle, &handle_info) != HND_DEVICE) { free_notify_struct(in); HandleUnlock(); return; } if (!(service = FindServiceId(&handle_info->ServiceTable, in->servId, in->UDN)) || !service->active || !(sub = GetSubscriptionSID(in->sid, service)) || copy_subscription(sub, &sub_copy) != HTTP_SUCCESS) { free_notify_struct(in); HandleUnlock(); return; } #ifdef UPNP_ENABLE_NOTIFICATION_REORDERING /*If the event is out of order push it back to the job queue */ if (in->eventKey != sub->ToSendEventKey) { TPJobInit(&job, (start_routine) genaNotifyThread, input); TPJobSetFreeFunction(&job, (free_function) free_notify_struct); TPJobSetPriority(&job, MED_PRIORITY); /* Sleep a little before creating another thread otherwise if there is * a lot of notifications to send, the device will take 100% of the CPU * to create threads and push them back to the job queue. */ imillisleep(1); ThreadPoolAdd(&gSendThreadPool, &job, NULL); freeSubscription(&sub_copy); HandleUnlock(); return; } #endif HandleUnlock(); /* send the notify */ return_code = genaNotify(in->headers, in->propertySet, &sub_copy); freeSubscription(&sub_copy); HandleLock(); if (GetHandleInfo(in->device_handle, &handle_info) != HND_DEVICE) { free_notify_struct(in); HandleUnlock(); return; } /* validate context */ if (!(service = FindServiceId(&handle_info->ServiceTable, in->servId, in->UDN)) || !service->active || !(sub = GetSubscriptionSID(in->sid, service))) { free_notify_struct(in); HandleUnlock(); return; } sub->ToSendEventKey++; if (sub->ToSendEventKey < 0) /* wrap to 1 for overflow */ sub->ToSendEventKey = 1; if (return_code == GENA_E_NOTIFY_UNACCEPTED_REMOVE_SUB) RemoveSubscriptionSID(in->sid, service); free_notify_struct(in); HandleUnlock(); } /*! * \brief Allocates the GENA header. * * \note The header must be destroyed after with a call to free(), otherwise * there will be a memory leak. * * \return The constructed header. */ static char *AllocGenaHeaders( /*! [in] The property set string. */ const DOMString propertySet) { static const char *HEADER_LINE_1 = "CONTENT-TYPE: text/xml; charset=\"utf-8\"\r\n"; static const char *HEADER_LINE_2A = "CONTENT-LENGTH: "; static const char *HEADER_LINE_2B = "\r\n"; static const char *HEADER_LINE_3 = "NT: upnp:event\r\n"; static const char *HEADER_LINE_4 = "NTS: upnp:propchange\r\n"; char *headers = NULL; size_t headers_size = 0; int line = 0; int rc = 0; headers_size = strlen(HEADER_LINE_1 ) + strlen(HEADER_LINE_2A) + MAX_CONTENT_LENGTH + strlen(HEADER_LINE_2B) + strlen(HEADER_LINE_3 ) + strlen(HEADER_LINE_4 ) + 1; headers = (char *)malloc(headers_size); if (headers == NULL) { line = __LINE__; goto ExitFunction; } rc = snprintf(headers, headers_size, "%s%s%"PRIzu"%s%s%s", HEADER_LINE_1, HEADER_LINE_2A, strlen(propertySet) + 2, HEADER_LINE_2B, HEADER_LINE_3, HEADER_LINE_4); ExitFunction: if (headers == NULL || rc < 0 || (unsigned int) rc >= headers_size) { UpnpPrintf(UPNP_ALL, GENA, __FILE__, line, "AllocGenaHeaders(): Error UPNP_E_OUTOF_MEMORY\n"); } return headers; } int genaInitNotify( UpnpDevice_Handle device_handle, char *UDN, char *servId, char **VarNames, char **VarValues, int var_count, const Upnp_SID sid) { int ret = GENA_SUCCESS; int line = 0; int *reference_count = NULL; char *UDN_copy = NULL; char *servId_copy = NULL; DOMString propertySet = NULL; char *headers = NULL; notify_thread_struct *thread_struct = NULL; subscription *sub = NULL; service_info *service = NULL; struct Handle_Info *handle_info; ThreadPoolJob job; memset(&job, 0, sizeof(job)); UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "GENA BEGIN INITIAL NOTIFY"); reference_count = (int *)malloc(sizeof (int)); if (reference_count == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } *reference_count = 0; UDN_copy = strdup(UDN); if (UDN_copy == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } servId_copy = strdup(servId); if (servId_copy == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } HandleLock(); if (GetHandleInfo(device_handle, &handle_info) != HND_DEVICE) { line = __LINE__; ret = GENA_E_BAD_HANDLE; goto ExitFunction; } service = FindServiceId(&handle_info->ServiceTable, servId, UDN); if (service == NULL) { line = __LINE__; ret = GENA_E_BAD_SERVICE; goto ExitFunction; } UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "FOUND SERVICE IN INIT NOTFY: UDN %s, ServID: %s", UDN, servId); sub = GetSubscriptionSID(sid, service); if (sub == NULL || sub->active) { line = __LINE__; ret = GENA_E_BAD_SID; goto ExitFunction; } UpnpPrintf( UPNP_INFO, GENA, __FILE__, __LINE__, "FOUND SUBSCRIPTION IN INIT NOTIFY: SID %s", sid); sub->active = 1; if (var_count <= 0) { line = __LINE__; ret = GENA_SUCCESS; goto ExitFunction; } ret = GeneratePropertySet(VarNames, VarValues, var_count, &propertySet); if (ret != XML_SUCCESS) { line = __LINE__; goto ExitFunction; } UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "GENERATED PROPERTY SET IN INIT NOTIFY: %s", propertySet); headers = AllocGenaHeaders(propertySet); if (headers == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } /* schedule thread for initial notification */ thread_struct = (notify_thread_struct *)malloc(sizeof (notify_thread_struct)); if (thread_struct == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; } else { *reference_count = 1; thread_struct->servId = servId_copy; thread_struct->UDN = UDN_copy; thread_struct->headers = headers; thread_struct->propertySet = propertySet; memset(thread_struct->sid, 0, sizeof(thread_struct->sid)); strncpy(thread_struct->sid, sid, sizeof(thread_struct->sid) - 1); thread_struct->eventKey = sub->eventKey++; thread_struct->reference_count = reference_count; thread_struct->device_handle = device_handle; TPJobInit(&job, (start_routine)genaNotifyThread, thread_struct); TPJobSetFreeFunction(&job, (free_routine)free_notify_struct); TPJobSetPriority(&job, MED_PRIORITY); ret = ThreadPoolAdd(&gSendThreadPool, &job, NULL); if (ret != 0) { if (ret == EOUTOFMEM) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; } } else { line = __LINE__; ret = GENA_SUCCESS; } } ExitFunction: if (ret != GENA_SUCCESS || var_count <= 0) { free(thread_struct); free(headers); ixmlFreeDOMString(propertySet); free(servId_copy); free(UDN_copy); free(reference_count); } HandleUnlock(); UpnpPrintf(UPNP_INFO, GENA, __FILE__, line, "GENA END INITIAL NOTIFY, ret = %d", ret); return ret; } int genaInitNotifyExt( UpnpDevice_Handle device_handle, char *UDN, char *servId, IXML_Document *PropSet, const Upnp_SID sid) { int ret = GENA_SUCCESS; int line = 0; int *reference_count = NULL; char *UDN_copy = NULL; char *servId_copy = NULL; DOMString propertySet = NULL; char *headers = NULL; notify_thread_struct *thread_struct = NULL; subscription *sub = NULL; service_info *service = NULL; struct Handle_Info *handle_info; ThreadPoolJob job; memset(&job, 0, sizeof(job)); UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "GENA BEGIN INITIAL NOTIFY EXT"); reference_count = (int *)malloc(sizeof (int)); if (reference_count == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } *reference_count = 0; UDN_copy = strdup(UDN); if (UDN_copy == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } servId_copy = strdup(servId); if( servId_copy == NULL ) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } HandleLock(); if (GetHandleInfo(device_handle, &handle_info) != HND_DEVICE) { line = __LINE__; ret = GENA_E_BAD_HANDLE; goto ExitFunction; } service = FindServiceId(&handle_info->ServiceTable, servId, UDN); if (service == NULL) { line = __LINE__; ret = GENA_E_BAD_SERVICE; goto ExitFunction; } UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "FOUND SERVICE IN INIT NOTFY EXT: UDN %s, ServID: %s", UDN, servId); sub = GetSubscriptionSID(sid, service); if (sub == NULL || sub->active) { line = __LINE__; ret = GENA_E_BAD_SID; goto ExitFunction; } UpnpPrintf( UPNP_INFO, GENA, __FILE__, __LINE__, "FOUND SUBSCRIPTION IN INIT NOTIFY EXT: SID %s", sid); sub->active = 1; if (PropSet == 0) { line = __LINE__; ret = GENA_SUCCESS; goto ExitFunction; } propertySet = ixmlPrintNode((IXML_Node *)PropSet); if (propertySet == NULL) { line = __LINE__; ret = UPNP_E_INVALID_PARAM; goto ExitFunction; } UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "GENERATED PROPERTY SET IN INIT EXT NOTIFY: %s", propertySet); headers = AllocGenaHeaders(propertySet); if (headers == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } /* schedule thread for initial notification */ thread_struct = (notify_thread_struct *)malloc(sizeof (notify_thread_struct)); if (thread_struct == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; } else { *reference_count = 1; thread_struct->servId = servId_copy; thread_struct->UDN = UDN_copy; thread_struct->headers = headers; thread_struct->propertySet = propertySet; memset(thread_struct->sid, 0, sizeof(thread_struct->sid)); strncpy(thread_struct->sid, sid, sizeof(thread_struct->sid) - 1); thread_struct->eventKey = sub->eventKey++; thread_struct->reference_count = reference_count; thread_struct->device_handle = device_handle; TPJobInit(&job, (start_routine)genaNotifyThread, thread_struct); TPJobSetFreeFunction(&job, (free_routine)free_notify_struct); TPJobSetPriority(&job, MED_PRIORITY); ret = ThreadPoolAdd(&gSendThreadPool, &job, NULL); if (ret != 0) { if (ret == EOUTOFMEM) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; } } else { line = __LINE__; ret = GENA_SUCCESS; } } ExitFunction: if (ret != GENA_SUCCESS || PropSet == 0) { free(thread_struct); free(headers); ixmlFreeDOMString(propertySet); free(servId_copy); free(UDN_copy); free(reference_count); } HandleUnlock(); UpnpPrintf(UPNP_INFO, GENA, __FILE__, line, "GENA END INITIAL NOTIFY EXT, ret = %d", ret); return ret; } int genaNotifyAllExt( UpnpDevice_Handle device_handle, char *UDN, char *servId, IXML_Document *PropSet) { int ret = GENA_SUCCESS; int line = 0; int *reference_count = NULL; char *UDN_copy = NULL; char *servId_copy = NULL; DOMString propertySet = NULL; char *headers = NULL; notify_thread_struct *thread_struct = NULL; subscription *finger = NULL; service_info *service = NULL; struct Handle_Info *handle_info; ThreadPoolJob job; memset(&job, 0, sizeof(job)); UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "GENA BEGIN NOTIFY ALL EXT"); reference_count = (int *)malloc(sizeof (int)); if (reference_count == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } *reference_count = 0; UDN_copy = strdup(UDN); if (UDN_copy == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } servId_copy = strdup(servId); if( servId_copy == NULL ) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } propertySet = ixmlPrintNode((IXML_Node *)PropSet); if (propertySet == NULL) { line = __LINE__; ret = UPNP_E_INVALID_PARAM; goto ExitFunction; } UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "GENERATED PROPERTY SET IN EXT NOTIFY: %s", propertySet); headers = AllocGenaHeaders(propertySet); if (headers == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } HandleLock(); if (GetHandleInfo(device_handle, &handle_info) != HND_DEVICE) { line = __LINE__; ret = GENA_E_BAD_HANDLE; } else { service = FindServiceId(&handle_info->ServiceTable, servId, UDN); if (service != NULL) { finger = GetFirstSubscription(service); while (finger) { thread_struct = (notify_thread_struct *)malloc(sizeof (notify_thread_struct)); if (thread_struct == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; break; } (*reference_count)++; thread_struct->reference_count = reference_count; thread_struct->UDN = UDN_copy; thread_struct->servId = servId_copy; thread_struct->headers = headers; thread_struct->propertySet = propertySet; memset(thread_struct->sid, 0, sizeof(thread_struct->sid)); strncpy(thread_struct->sid, finger->sid, sizeof(thread_struct->sid) - 1); thread_struct->eventKey = finger->eventKey++; thread_struct->device_handle = device_handle; /* if overflow, wrap to 1 */ if (finger->eventKey < 0) { finger->eventKey = 1; } TPJobInit(&job, (start_routine)genaNotifyThread, thread_struct); TPJobSetFreeFunction(&job, (free_routine)free_notify_struct); TPJobSetPriority(&job, MED_PRIORITY); ret = ThreadPoolAdd(&gSendThreadPool, &job, NULL); if (ret != 0) { line = __LINE__; if (ret == EOUTOFMEM) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; } break; } finger = GetNextSubscription(service, finger); } } else { line = __LINE__; ret = GENA_E_BAD_SERVICE; } } ExitFunction: if (ret != GENA_SUCCESS || *reference_count == 0) { free(headers); ixmlFreeDOMString(propertySet); free(servId_copy); free(UDN_copy); free(reference_count); } HandleUnlock(); UpnpPrintf(UPNP_INFO, GENA, __FILE__, line, "GENA END NOTIFY ALL EXT, ret = %d", ret); return ret; } int genaNotifyAll( UpnpDevice_Handle device_handle, char *UDN, char *servId, char **VarNames, char **VarValues, int var_count) { int ret = GENA_SUCCESS; int line = 0; int *reference_count = NULL; char *UDN_copy = NULL; char *servId_copy = NULL; DOMString propertySet = NULL; char *headers = NULL; notify_thread_struct *thread_struct = NULL; subscription *finger = NULL; service_info *service = NULL; struct Handle_Info *handle_info; ThreadPoolJob job; memset(&job, 0, sizeof(job)); UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "GENA BEGIN NOTIFY ALL"); reference_count = (int *)malloc(sizeof (int)); if (reference_count == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } *reference_count = 0; UDN_copy = strdup(UDN); if (UDN_copy == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } servId_copy = strdup(servId); if( servId_copy == NULL ) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } ret = GeneratePropertySet(VarNames, VarValues, var_count, &propertySet); if (ret != XML_SUCCESS) { line = __LINE__; goto ExitFunction; } UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "GENERATED PROPERTY SET IN EXT NOTIFY: %s", propertySet); headers = AllocGenaHeaders(propertySet); if (headers == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } HandleLock(); if (GetHandleInfo(device_handle, &handle_info) != HND_DEVICE) { line = __LINE__; ret = GENA_E_BAD_HANDLE; } else { service = FindServiceId(&handle_info->ServiceTable, servId, UDN); if (service != NULL) { finger = GetFirstSubscription(service); while (finger) { thread_struct = (notify_thread_struct *)malloc(sizeof (notify_thread_struct)); if (thread_struct == NULL) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; break; } (*reference_count)++; thread_struct->reference_count = reference_count; thread_struct->UDN = UDN_copy; thread_struct->servId = servId_copy; thread_struct->headers = headers; thread_struct->propertySet = propertySet; memset(thread_struct->sid, 0, sizeof(thread_struct->sid)); strncpy(thread_struct->sid, finger->sid, sizeof(thread_struct->sid) - 1); thread_struct->eventKey = finger->eventKey++; thread_struct->device_handle = device_handle; /* if overflow, wrap to 1 */ if (finger->eventKey < 0) { finger->eventKey = 1; } TPJobInit(&job, (start_routine)genaNotifyThread, thread_struct); TPJobSetFreeFunction(&job, (free_routine)free_notify_struct); TPJobSetPriority(&job, MED_PRIORITY); ret = ThreadPoolAdd(&gSendThreadPool, &job, NULL); if (ret != 0) { line = __LINE__; if (ret == EOUTOFMEM) { line = __LINE__; ret = UPNP_E_OUTOF_MEMORY; } break; } finger = GetNextSubscription(service, finger); } } else { line = __LINE__; ret = GENA_E_BAD_SERVICE; } } ExitFunction: if (ret != GENA_SUCCESS || *reference_count == 0) { free(headers); ixmlFreeDOMString(propertySet); free(servId_copy); free(UDN_copy); free(reference_count); } HandleUnlock(); UpnpPrintf(UPNP_INFO, GENA, __FILE__, line, "GENA END NOTIFY ALL, ret = %d", ret); return ret; } /*! * \brief Returns OK message in the case of a subscription request. * * \return UPNP_E_SUCCESS if successful, otherwise the appropriate error code. */ static int respond_ok( /*! [in] Socket connection of request. */ SOCKINFO *info, /*! [in] Accepted duration. */ int time_out, /*! [in] Accepted subscription. */ subscription *sub, /*! [in] Http request. */ http_message_t *request) { int major; int minor; membuffer response; int return_code; char timeout_str[100]; int upnp_timeout = UPNP_TIMEOUT; int rc = 0; http_CalcResponseVersion( request->major_version, request->minor_version, &major, &minor ); if( time_out >= 0 ) { rc = snprintf( timeout_str, sizeof ( timeout_str ), "TIMEOUT: Second-%d", time_out ); } else { memset( timeout_str, 0, sizeof( timeout_str ) ); strncpy( timeout_str, "TIMEOUT: Second-infinite", sizeof ( timeout_str ) - 1); } if (rc < 0 || (unsigned int) rc >= sizeof ( timeout_str ) ) { error_respond( info, HTTP_INTERNAL_SERVER_ERROR, request ); return UPNP_E_OUTOF_MEMORY; } membuffer_init( &response ); response.size_inc = 30; if( http_MakeMessage( &response, major, minor, "R" "D" "S" "N" "Xc" "ssc" "scc", HTTP_OK, (off_t)0, X_USER_AGENT, "SID: ", sub->sid, timeout_str ) != 0 ) { membuffer_destroy( &response ); error_respond( info, HTTP_INTERNAL_SERVER_ERROR, request ); return UPNP_E_OUTOF_MEMORY; } return_code = http_SendMessage( info, &upnp_timeout, "b", response.buf, response.length ); membuffer_destroy( &response ); return return_code; } /*! * \brief Function to parse the Callback header value in subscription requests. * * Takes in a buffer containing URLS delimited by '<' and '>'. The entire buffer * is copied into dynamic memory and stored in the URL_list. Pointers to the * individual urls within this buffer are allocated and stored in the URL_list. * Only URLs with network addresses are considered (i.e. host:port or domain name). * * \return The number of URLs parsed if successful, otherwise UPNP_E_OUTOF_MEMORY. */ static int create_url_list( /*! [in] . */ memptr *url_list, /*! [out] . */ URL_list *out) { size_t URLcount = 0, URLcount2 = 0; size_t i; int return_code = 0; uri_type temp; token urls; token *URLS; urls.buff = url_list->buf; urls.size = url_list->length; URLS = &urls; out->size = 0; out->URLs = NULL; out->parsedURLs = NULL; for( i = 0; i < URLS->size; i++ ) { if( ( URLS->buff[i] == '<' ) && ( i + 1 < URLS->size ) ) { if( ( ( return_code = parse_uri( &URLS->buff[i + 1], URLS->size - i + 1, &temp ) ) == HTTP_SUCCESS ) && ( temp.hostport.text.size != 0 ) ) { URLcount++; } else { if( return_code == UPNP_E_OUTOF_MEMORY ) { return return_code; } } } } if( URLcount > 0 ) { out->URLs = malloc(URLS->size + 1); out->parsedURLs = malloc(sizeof(uri_type) * URLcount); if (!out->URLs || !out->parsedURLs) { free(out->URLs); free(out->parsedURLs); out->URLs = NULL; out->parsedURLs = NULL; return UPNP_E_OUTOF_MEMORY; } memcpy( out->URLs, URLS->buff, URLS->size ); out->URLs[URLS->size] = 0; for( i = 0; i < URLS->size; i++ ) { if( ( URLS->buff[i] == '<' ) && ( i + 1 < URLS->size ) ) { if( ( ( return_code = parse_uri( &out->URLs[i + 1], URLS->size - i + 1, &out->parsedURLs[URLcount2] ) ) == HTTP_SUCCESS ) && ( out->parsedURLs[URLcount2].hostport.text.size != 0 ) ) { URLcount2++; if (URLcount2 >= URLcount) /* * break early here in case there is a bogus URL that * was skipped above. This prevents to access * out->parsedURLs[URLcount] which is beyond the * allocation. */ break; } else { if( return_code == UPNP_E_OUTOF_MEMORY ) { free( out->URLs ); free( out->parsedURLs ); out->URLs = NULL; out->parsedURLs = NULL; return return_code; } } } } } out->size = URLcount; return (int)URLcount; } void gena_process_subscription_request( SOCKINFO *info, http_message_t *request) { UpnpSubscriptionRequest *request_struct = UpnpSubscriptionRequest_new(); Upnp_SID temp_sid; int return_code = 1; int time_out = 1801; service_info *service; subscription *sub; uuid_upnp uid; struct Handle_Info *handle_info; void *cookie; Upnp_FunPtr callback_fun; UpnpDevice_Handle device_handle; memptr nt_hdr; char *event_url_path = NULL; memptr callback_hdr; memptr timeout_hdr; int rc = 0; UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "Subscription Request Received:\n"); if (httpmsg_find_hdr(request, HDR_NT, &nt_hdr) == NULL) { error_respond(info, HTTP_BAD_REQUEST, request); goto exit_function; } /* check NT header */ /* Windows Millenium Interoperability: */ /* we accept either upnp:event, or upnp:propchange for the NT header */ if (memptr_cmp_nocase(&nt_hdr, "upnp:event") != 0) { error_respond(info, HTTP_PRECONDITION_FAILED, request); goto exit_function; } /* if a SID is present then the we have a bad request "incompatible headers" */ if (httpmsg_find_hdr(request, HDR_SID, NULL) != NULL) { error_respond(info, HTTP_BAD_REQUEST, request); goto exit_function; } /* look up service by eventURL */ event_url_path = str_alloc(request->uri.pathquery.buff, request->uri.pathquery.size); if (event_url_path == NULL) { error_respond(info, HTTP_INTERNAL_SERVER_ERROR, request); goto exit_function; } UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "SubscriptionRequest for event URL path: %s\n", event_url_path); HandleLock(); /* CURRENTLY, ONLY ONE DEVICE */ if (GetDeviceHandleInfo(info->foreign_sockaddr.ss_family , &device_handle, &handle_info) != HND_DEVICE) { free(event_url_path); error_respond(info, HTTP_INTERNAL_SERVER_ERROR, request); HandleUnlock(); goto exit_function; } service = FindServiceEventURLPath(&handle_info->ServiceTable, event_url_path); free(event_url_path); if (service == NULL || !service->active) { error_respond(info, HTTP_NOT_FOUND, request); HandleUnlock(); goto exit_function; } UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "Subscription Request: Number of Subscriptions already %d\n " "Max Subscriptions allowed: %d\n", service->TotalSubscriptions, handle_info->MaxSubscriptions); /* too many subscriptions */ if (handle_info->MaxSubscriptions != -1 && service->TotalSubscriptions >= handle_info->MaxSubscriptions) { error_respond(info, HTTP_INTERNAL_SERVER_ERROR, request); HandleUnlock(); goto exit_function; } /* generate new subscription */ sub = (subscription *)malloc(sizeof (subscription)); if (sub == NULL) { error_respond(info, HTTP_INTERNAL_SERVER_ERROR, request); HandleUnlock(); goto exit_function; } sub->eventKey = 0; sub->ToSendEventKey = 0; sub->active = 0; sub->next = NULL; sub->DeliveryURLs.size = 0; sub->DeliveryURLs.URLs = NULL; sub->DeliveryURLs.parsedURLs = NULL; /* check for valid callbacks */ if (httpmsg_find_hdr( request, HDR_CALLBACK, &callback_hdr) == NULL) { error_respond(info, HTTP_PRECONDITION_FAILED, request); freeSubscriptionList(sub); HandleUnlock(); goto exit_function; } return_code = create_url_list(&callback_hdr, &sub->DeliveryURLs); if (return_code == 0) { error_respond(info, HTTP_PRECONDITION_FAILED, request); freeSubscriptionList(sub); HandleUnlock(); goto exit_function; } if (return_code == UPNP_E_OUTOF_MEMORY) { error_respond(info, HTTP_INTERNAL_SERVER_ERROR, request); freeSubscriptionList(sub); HandleUnlock(); goto exit_function; } /* set the timeout */ if (httpmsg_find_hdr(request, HDR_TIMEOUT, &timeout_hdr) != NULL) { if (matchstr(timeout_hdr.buf, timeout_hdr.length, "%iSecond-%d%0", &time_out) == PARSE_OK) { /* nothing */ } else if(memptr_cmp_nocase(&timeout_hdr, "Second-infinite") == 0) { /* infinite timeout */ time_out = -1; } else { /* default is > 1800 seconds */ time_out = DEFAULT_TIMEOUT; } } /* replace infinite timeout with max timeout, if possible */ if (handle_info->MaxSubscriptionTimeOut != -1) { if (time_out == -1 || time_out > handle_info->MaxSubscriptionTimeOut) { time_out = handle_info->MaxSubscriptionTimeOut; } } if (time_out >= 0) { sub->expireTime = time(NULL) + time_out; } else { /* infinite time */ sub->expireTime = 0; } /* generate SID */ uuid_create(&uid); uuid_unpack(&uid, temp_sid); rc = snprintf(sub->sid, sizeof(sub->sid), "uuid:%s", temp_sid); /* respond OK */ if (rc < 0 || (unsigned int) rc >= sizeof(sub->sid) || (respond_ok(info, time_out, sub, request) != UPNP_E_SUCCESS)) { freeSubscriptionList(sub); HandleUnlock(); goto exit_function; } /* add to subscription list */ sub->next = service->subscriptionList; service->subscriptionList = sub; service->TotalSubscriptions++; /* finally generate callback for init table dump */ UpnpSubscriptionRequest_strcpy_ServiceId(request_struct, service->serviceId); UpnpSubscriptionRequest_strcpy_UDN(request_struct, service->UDN); UpnpSubscriptionRequest_strcpy_SID(request_struct, sub->sid); /* copy callback */ callback_fun = handle_info->Callback; cookie = handle_info->Cookie; HandleUnlock(); /* make call back with request struct */ /* in the future should find a way of mainting that the handle */ /* is not unregistered in the middle of a callback */ callback_fun(UPNP_EVENT_SUBSCRIPTION_REQUEST, request_struct, cookie); exit_function: UpnpSubscriptionRequest_delete(request_struct); } void gena_process_subscription_renewal_request( SOCKINFO *info, http_message_t *request) { Upnp_SID sid; subscription *sub; int time_out = 1801; service_info *service; struct Handle_Info *handle_info; UpnpDevice_Handle device_handle; memptr temp_hdr; membuffer event_url_path; memptr timeout_hdr; /* if a CALLBACK or NT header is present, then it is an error */ if( httpmsg_find_hdr( request, HDR_CALLBACK, NULL ) != NULL || httpmsg_find_hdr( request, HDR_NT, NULL ) != NULL ) { error_respond( info, HTTP_BAD_REQUEST, request ); return; } /* get SID */ if( httpmsg_find_hdr( request, HDR_SID, &temp_hdr ) == NULL || temp_hdr.length > SID_SIZE ) { error_respond( info, HTTP_PRECONDITION_FAILED, request ); return; } memcpy( sid, temp_hdr.buf, temp_hdr.length ); sid[temp_hdr.length] = '\0'; /* lookup service by eventURL */ membuffer_init( &event_url_path ); if( membuffer_append( &event_url_path, request->uri.pathquery.buff, request->uri.pathquery.size ) != 0 ) { error_respond( info, HTTP_INTERNAL_SERVER_ERROR, request ); return; } HandleLock(); /* CURRENTLY, ONLY SUPPORT ONE DEVICE */ if( GetDeviceHandleInfo( info->foreign_sockaddr.ss_family, &device_handle, &handle_info ) != HND_DEVICE ) { error_respond( info, HTTP_PRECONDITION_FAILED, request ); membuffer_destroy( &event_url_path ); HandleUnlock(); return; } service = FindServiceEventURLPath( &handle_info->ServiceTable, event_url_path.buf ); membuffer_destroy( &event_url_path ); /* get subscription */ if( service == NULL || !service->active || ( ( sub = GetSubscriptionSID( sid, service ) ) == NULL ) ) { error_respond( info, HTTP_PRECONDITION_FAILED, request ); HandleUnlock(); return; } UpnpPrintf( UPNP_INFO, GENA, __FILE__, __LINE__, "Renew request: Number of subscriptions already: %d\n " "Max Subscriptions allowed:%d\n", service->TotalSubscriptions, handle_info->MaxSubscriptions ); /* too many subscriptions */ if( handle_info->MaxSubscriptions != -1 && service->TotalSubscriptions > handle_info->MaxSubscriptions ) { error_respond( info, HTTP_INTERNAL_SERVER_ERROR, request ); RemoveSubscriptionSID( sub->sid, service ); HandleUnlock(); return; } /* set the timeout */ if( httpmsg_find_hdr( request, HDR_TIMEOUT, &timeout_hdr ) != NULL ) { if( matchstr( timeout_hdr.buf, timeout_hdr.length, "%iSecond-%d%0", &time_out ) == PARSE_OK ) { /*nothing */ } else if( memptr_cmp_nocase( &timeout_hdr, "Second-infinite" ) == 0 ) { time_out = -1; /* inifinite timeout */ } else { time_out = DEFAULT_TIMEOUT; /* default is > 1800 seconds */ } } /* replace infinite timeout with max timeout, if possible */ if( handle_info->MaxSubscriptionTimeOut != -1 ) { if( time_out == -1 || time_out > handle_info->MaxSubscriptionTimeOut ) { time_out = handle_info->MaxSubscriptionTimeOut; } } if( time_out == -1 ) { sub->expireTime = 0; } else { sub->expireTime = time( NULL ) + time_out; } if( respond_ok( info, time_out, sub, request ) != UPNP_E_SUCCESS ) { RemoveSubscriptionSID( sub->sid, service ); } HandleUnlock(); } void gena_process_unsubscribe_request( SOCKINFO *info, http_message_t *request) { Upnp_SID sid; service_info *service; struct Handle_Info *handle_info; UpnpDevice_Handle device_handle; memptr temp_hdr; membuffer event_url_path; /* if a CALLBACK or NT header is present, then it is an error */ if( httpmsg_find_hdr( request, HDR_CALLBACK, NULL ) != NULL || httpmsg_find_hdr( request, HDR_NT, NULL ) != NULL ) { error_respond( info, HTTP_BAD_REQUEST, request ); return; } /* get SID */ if( httpmsg_find_hdr( request, HDR_SID, &temp_hdr ) == NULL || temp_hdr.length > SID_SIZE ) { error_respond( info, HTTP_PRECONDITION_FAILED, request ); return; } memcpy( sid, temp_hdr.buf, temp_hdr.length ); sid[temp_hdr.length] = '\0'; /* lookup service by eventURL */ membuffer_init( &event_url_path ); if( membuffer_append( &event_url_path, request->uri.pathquery.buff, request->uri.pathquery.size ) != 0 ) { error_respond( info, HTTP_INTERNAL_SERVER_ERROR, request ); return; } HandleLock(); /* CURRENTLY, ONLY SUPPORT ONE DEVICE */ if( GetDeviceHandleInfo( info->foreign_sockaddr.ss_family, &device_handle, &handle_info ) != HND_DEVICE ) { error_respond( info, HTTP_PRECONDITION_FAILED, request ); membuffer_destroy( &event_url_path ); HandleUnlock(); return; } service = FindServiceEventURLPath( &handle_info->ServiceTable, event_url_path.buf ); membuffer_destroy( &event_url_path ); /* validate service */ if( service == NULL || !service->active || GetSubscriptionSID( sid, service ) == NULL ) { error_respond( info, HTTP_PRECONDITION_FAILED, request ); HandleUnlock(); return; } RemoveSubscriptionSID(sid, service); error_respond(info, HTTP_OK, request); /* success */ HandleUnlock(); } #endif /* INCLUDE_DEVICE_APIS */ #endif /* EXCLUDE_GENA */ pupnp-release-1.8.0/upnp/src/genlib/000077500000000000000000000000001303304015100172775ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/genlib/client_table/000077500000000000000000000000001303304015100217245ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/genlib/client_table/ClientSubscription.c000066400000000000000000000004131303304015100257110ustar00rootroot00000000000000 /*! * \file * * \brief GenlibClientSubscription object implementation. * * \author Marcelo Roberto Jimenez */ #include "config.h" #ifdef INCLUDE_CLIENT_APIS #define TEMPLATE_GENERATE_SOURCE #include "ClientSubscription.h" #endif /* INCLUDE_CLIENT_APIS */ pupnp-release-1.8.0/upnp/src/genlib/client_table/client_table.c000066400000000000000000000054531303304015100245240ustar00rootroot00000000000000 /************************************************************************ * Purpose: This file defines the functions for clients. It defines * functions for adding and removing clients to and from the client table, * adding and accessing subscription and other attributes pertaining to the * client ************************************************************************/ #include "config.h" #include "client_table.h" #ifdef INCLUDE_CLIENT_APIS #include /* for calloc(), free() */ void free_client_subscription(GenlibClientSubscription *sub) { upnp_timeout *event; ThreadPoolJob tempJob; if (sub) { int renewEventId = GenlibClientSubscription_get_RenewEventId(sub); GenlibClientSubscription_strcpy_ActualSID(sub, ""); GenlibClientSubscription_strcpy_EventURL(sub, ""); if (renewEventId != -1) { /* do not remove timer event of copy */ /* invalid timer event id */ if (TimerThreadRemove(&gTimerThread, renewEventId, &tempJob) == 0) { event = (upnp_timeout *)tempJob.arg; free_upnp_timeout(event); } } GenlibClientSubscription_set_RenewEventId(sub, -1); } } void freeClientSubList(GenlibClientSubscription *list) { GenlibClientSubscription *next; while (list) { free_client_subscription(list); next = GenlibClientSubscription_get_Next(list); GenlibClientSubscription_delete(list); list = next; } } void RemoveClientSubClientSID(GenlibClientSubscription **head, const UpnpString *sid) { GenlibClientSubscription *finger = *head; GenlibClientSubscription *previous = NULL; int found = 0; while (finger) { found = !strcmp( UpnpString_get_String(sid), GenlibClientSubscription_get_SID_cstr(finger)); if (found) { if (previous) { GenlibClientSubscription_set_Next(previous, GenlibClientSubscription_get_Next(finger)); } else { *head = GenlibClientSubscription_get_Next(finger); } GenlibClientSubscription_set_Next(finger, NULL); freeClientSubList(finger); finger = NULL; } else { previous = finger; finger = GenlibClientSubscription_get_Next(finger); } } } GenlibClientSubscription *GetClientSubClientSID(GenlibClientSubscription *head, const UpnpString *sid) { GenlibClientSubscription *next = head; int found = 0; while (next) { found = !strcmp( GenlibClientSubscription_get_SID_cstr(next), UpnpString_get_String(sid)); if(found) { break; } else { next = GenlibClientSubscription_get_Next(next); } } return next; } GenlibClientSubscription *GetClientSubActualSID(GenlibClientSubscription *head, token *sid) { GenlibClientSubscription *next = head; while (next) { if (!memcmp( GenlibClientSubscription_get_ActualSID_cstr(next), sid->buff, sid->size)) { break; } else { next = GenlibClientSubscription_get_Next(next); } } return next; } #endif /* INCLUDE_CLIENT_APIS */ pupnp-release-1.8.0/upnp/src/genlib/miniserver/000077500000000000000000000000001303304015100214625ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/genlib/miniserver/miniserver.c000066400000000000000000000677331303304015100240310ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (C) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ #include "config.h" #if EXCLUDE_MINISERVER == 0 /*! * \file * * \brief Implements the functionality and utility functions * used by the Miniserver module. * * The miniserver is a central point for processing all network requests. * It is made of: * - The SSDP sockets for discovery. * - The HTTP listeners for description / control / eventing. * */ #include "miniserver.h" #include "httpreadwrite.h" #include "ithread.h" #include "ssdplib.h" #include "statcodes.h" #include "ThreadPool.h" #include "unixutil.h" /* for socklen_t, EAFNOSUPPORT */ #include "upnpapi.h" #include "upnputil.h" #include #include #include #include #include #include /*! . */ #define APPLICATION_LISTENING_PORT 49152 struct mserv_request_t { /*! Connection handle. */ SOCKET connfd; /*! . */ struct sockaddr_storage foreign_sockaddr; }; /*! . */ typedef enum { /*! . */ MSERV_IDLE, /*! . */ MSERV_RUNNING, /*! . */ MSERV_STOPPING } MiniServerState; /*! . */ uint16_t miniStopSockPort; /*! * module vars */ static MiniServerState gMServState = MSERV_IDLE; #ifdef INTERNAL_WEB_SERVER static MiniServerCallback gGetCallback = NULL; static MiniServerCallback gSoapCallback = NULL; static MiniServerCallback gGenaCallback = NULL; void SetHTTPGetCallback(MiniServerCallback callback) { gGetCallback = callback; } #ifdef INCLUDE_DEVICE_APIS void SetSoapCallback(MiniServerCallback callback) { gSoapCallback = callback; } #endif /* INCLUDE_DEVICE_APIS */ void SetGenaCallback(MiniServerCallback callback) { gGenaCallback = callback; } /*! * \brief Based on the type pf message, appropriate callback is issued. * * \return 0 on Success or HTTP_INTERNAL_SERVER_ERROR if Callback is NULL. */ static int dispatch_request( /*! [in] Socket Information object. */ IN SOCKINFO *info, /*! [in] HTTP parser object. */ http_parser_t *hparser) { MiniServerCallback callback; switch (hparser->msg.method) { /* Soap Call */ case SOAPMETHOD_POST: case HTTPMETHOD_MPOST: callback = gSoapCallback; break; /* Gena Call */ case HTTPMETHOD_NOTIFY: case HTTPMETHOD_SUBSCRIBE: case HTTPMETHOD_UNSUBSCRIBE: UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "miniserver %d: got GENA msg\n", info->socket); callback = gGenaCallback; break; /* HTTP server call */ case HTTPMETHOD_GET: case HTTPMETHOD_POST: case HTTPMETHOD_HEAD: case HTTPMETHOD_SIMPLEGET: callback = gGetCallback; break; default: callback = NULL; } if (callback == NULL) { return HTTP_INTERNAL_SERVER_ERROR; } callback(hparser, &hparser->msg, info); return 0; } /*! * \brief Send Error Message. */ static UPNP_INLINE void handle_error( /*! [in] Socket Information object. */ SOCKINFO *info, /*! [in] HTTP Error Code. */ int http_error_code, /*! [in] Major Version Number. */ int major, /*! [in] Minor Version Number. */ int minor) { http_SendStatusResponse(info, http_error_code, major, minor); } /*! * \brief Free memory assigned for handling request and unitialize socket * functionality. */ static void free_handle_request_arg( /*! [in] Request Message to be freed. */ void *args) { struct mserv_request_t *request = (struct mserv_request_t *)args; sock_close(request->connfd); free(request); } /*! * \brief Receive the request and dispatch it for handling. */ static void handle_request( /*! [in] Request Message to be handled. */ void *args) { SOCKINFO info; int http_error_code; int ret_code; int major = 1; int minor = 1; http_parser_t parser; http_message_t *hmsg = NULL; int timeout = HTTP_DEFAULT_TIMEOUT; struct mserv_request_t *request = (struct mserv_request_t *)args; SOCKET connfd = request->connfd; UpnpPrintf( UPNP_INFO, MSERV, __FILE__, __LINE__, "miniserver %d: READING\n", connfd ); /* parser_request_init( &parser ); */ /* LEAK_FIX_MK */ hmsg = &parser.msg; ret_code = sock_init_with_ip( &info, connfd, (struct sockaddr *)&request->foreign_sockaddr); if (ret_code != UPNP_E_SUCCESS) { free(request); httpmsg_destroy(hmsg); return; } /* read */ ret_code = http_RecvMessage( &info, &parser, HTTPMETHOD_UNKNOWN, &timeout, &http_error_code); if (ret_code != 0) { goto error_handler; } UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "miniserver %d: PROCESSING...\n", connfd); /* dispatch */ http_error_code = dispatch_request(&info, &parser); if (http_error_code != 0) { goto error_handler; } http_error_code = 0; error_handler: if (http_error_code > 0) { if (hmsg) { major = hmsg->major_version; minor = hmsg->minor_version; } handle_error(&info, http_error_code, major, minor); } sock_destroy(&info, SD_BOTH); httpmsg_destroy(hmsg); free(request); UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "miniserver %d: COMPLETE\n", connfd); } /*! * \brief Initilize the thread pool to handle a request, sets priority for the * job and adds the job to the thread pool. */ static UPNP_INLINE void schedule_request_job( /*! [in] Socket Descriptor on which connection is accepted. */ SOCKET connfd, /*! [in] Clients Address information. */ struct sockaddr *clientAddr) { struct mserv_request_t *request; ThreadPoolJob job; memset(&job, 0, sizeof(job)); request = (struct mserv_request_t *)malloc( sizeof (struct mserv_request_t)); if (request == NULL) { UpnpPrintf( UPNP_INFO, MSERV, __FILE__, __LINE__, "mserv %d: out of memory\n", connfd); sock_close(connfd); return; } request->connfd = connfd; memcpy(&request->foreign_sockaddr, clientAddr, sizeof(request->foreign_sockaddr)); TPJobInit(&job, (start_routine)handle_request, (void *)request); TPJobSetFreeFunction(&job, free_handle_request_arg); TPJobSetPriority(&job, MED_PRIORITY); if (ThreadPoolAdd(&gMiniServerThreadPool, &job, NULL) != 0) { UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "mserv %d: cannot schedule request\n", connfd); free(request); sock_close(connfd); return; } } #endif static UPNP_INLINE void fdset_if_valid(SOCKET sock, fd_set *set) { if (sock != INVALID_SOCKET) { FD_SET(sock, set); } } static void web_server_accept(SOCKET lsock, fd_set *set) { #ifdef INTERNAL_WEB_SERVER SOCKET asock; socklen_t clientLen; struct sockaddr_storage clientAddr; char errorBuffer[ERROR_BUFFER_LEN]; if (lsock != INVALID_SOCKET && FD_ISSET(lsock, set)) { clientLen = sizeof(clientAddr); asock = accept(lsock, (struct sockaddr *)&clientAddr, &clientLen); if (asock == INVALID_SOCKET) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "miniserver: Error in accept(): %s\n", errorBuffer); } else { schedule_request_job(asock, (struct sockaddr *)&clientAddr); } } #endif /* INTERNAL_WEB_SERVER */ } static void ssdp_read(SOCKET rsock, fd_set *set) { if (rsock != INVALID_SOCKET && FD_ISSET(rsock, set)) { readFromSSDPSocket(rsock); } } static int receive_from_stopSock(SOCKET ssock, fd_set *set) { ssize_t byteReceived; socklen_t clientLen; struct sockaddr_storage clientAddr; char requestBuf[256]; char buf_ntop[INET6_ADDRSTRLEN]; if (FD_ISSET(ssock, set)) { clientLen = sizeof(clientAddr); memset((char *)&clientAddr, 0, sizeof(clientAddr)); byteReceived = recvfrom(ssock, requestBuf, (size_t)25, 0, (struct sockaddr *)&clientAddr, &clientLen); if (byteReceived > 0) { requestBuf[byteReceived] = '\0'; inet_ntop(AF_INET, &((struct sockaddr_in*)&clientAddr)->sin_addr, buf_ntop, sizeof(buf_ntop)); UpnpPrintf( UPNP_INFO, MSERV, __FILE__, __LINE__, "Received response: %s From host %s \n", requestBuf, buf_ntop ); UpnpPrintf( UPNP_PACKET, MSERV, __FILE__, __LINE__, "Received multicast packet: \n %s\n", requestBuf); if (NULL != strstr(requestBuf, "ShutDown")) { return 1; } } } return 0; } /*! * \brief Run the miniserver. * * The MiniServer accepts a new request and schedules a thread to handle the * new request. Checks for socket state and invokes appropriate read and * shutdown actions for the Miniserver and SSDP sockets. */ static void RunMiniServer( /*! [in] Socket Array. */ MiniServerSockArray *miniSock) { char errorBuffer[ERROR_BUFFER_LEN]; fd_set expSet; fd_set rdSet; SOCKET maxMiniSock; int ret = 0; int stopSock = 0; maxMiniSock = 0; maxMiniSock = max(maxMiniSock, miniSock->miniServerSock4); maxMiniSock = max(maxMiniSock, miniSock->miniServerSock6); maxMiniSock = max(maxMiniSock, miniSock->miniServerStopSock); maxMiniSock = max(maxMiniSock, miniSock->ssdpSock4); maxMiniSock = max(maxMiniSock, miniSock->ssdpSock6); maxMiniSock = max(maxMiniSock, miniSock->ssdpSock6UlaGua); #ifdef INCLUDE_CLIENT_APIS maxMiniSock = max(maxMiniSock, miniSock->ssdpReqSock4); maxMiniSock = max(maxMiniSock, miniSock->ssdpReqSock6); #endif /* INCLUDE_CLIENT_APIS */ ++maxMiniSock; gMServState = MSERV_RUNNING; while (!stopSock) { FD_ZERO(&rdSet); FD_ZERO(&expSet); /* FD_SET()'s */ FD_SET(miniSock->miniServerStopSock, &expSet); FD_SET(miniSock->miniServerStopSock, &rdSet); fdset_if_valid(miniSock->miniServerSock4, &rdSet); fdset_if_valid(miniSock->miniServerSock6, &rdSet); fdset_if_valid(miniSock->ssdpSock4, &rdSet); fdset_if_valid(miniSock->ssdpSock6, &rdSet); fdset_if_valid(miniSock->ssdpSock6UlaGua, &rdSet); #ifdef INCLUDE_CLIENT_APIS fdset_if_valid(miniSock->ssdpReqSock4, &rdSet); fdset_if_valid(miniSock->ssdpReqSock6, &rdSet); #endif /* INCLUDE_CLIENT_APIS */ /* select() */ ret = select((int) maxMiniSock, &rdSet, NULL, &expSet, NULL); if (ret == SOCKET_ERROR && errno == EINTR) { continue; } if (ret == SOCKET_ERROR) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in select(): %s\n", errorBuffer); continue; } else { web_server_accept(miniSock->miniServerSock4, &rdSet); web_server_accept(miniSock->miniServerSock6, &rdSet); #ifdef INCLUDE_CLIENT_APIS ssdp_read(miniSock->ssdpReqSock4, &rdSet); ssdp_read(miniSock->ssdpReqSock6, &rdSet); #endif /* INCLUDE_CLIENT_APIS */ ssdp_read(miniSock->ssdpSock4, &rdSet); ssdp_read(miniSock->ssdpSock6, &rdSet); ssdp_read(miniSock->ssdpSock6UlaGua, &rdSet); stopSock = receive_from_stopSock( miniSock->miniServerStopSock, &rdSet); } } /* Close all sockets. */ sock_close(miniSock->miniServerSock4); sock_close(miniSock->miniServerSock6); sock_close(miniSock->miniServerStopSock); sock_close(miniSock->ssdpSock4); sock_close(miniSock->ssdpSock6); sock_close(miniSock->ssdpSock6UlaGua); #ifdef INCLUDE_CLIENT_APIS sock_close(miniSock->ssdpReqSock4); sock_close(miniSock->ssdpReqSock6); #endif /* INCLUDE_CLIENT_APIS */ /* Free minisock. */ free(miniSock); gMServState = MSERV_IDLE; return; } /*! * \brief Returns port to which socket, sockfd, is bound. * * \return -1 on error; check errno. 0 if successfull. */ static int get_port( /*! [in] Socket descriptor. */ SOCKET sockfd, /*! [out] The port value if successful, otherwise, untouched. */ uint16_t *port) { struct sockaddr_storage sockinfo; socklen_t len; int code; len = sizeof(sockinfo); code = getsockname(sockfd, (struct sockaddr *)&sockinfo, &len); if (code == -1) { return -1; } if (sockinfo.ss_family == AF_INET) { *port = ntohs(((struct sockaddr_in*)&sockinfo)->sin_port); } else if(sockinfo.ss_family == AF_INET6) { *port = ntohs(((struct sockaddr_in6*)&sockinfo)->sin6_port); } UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "sockfd = %d, .... port = %d\n", sockfd, (int)*port); return 0; } #ifdef INTERNAL_WEB_SERVER /*! * \brief Creates a STREAM socket, binds to INADDR_ANY and listens for * incoming connecttions. Returns the actual port which the sockets * sub-system returned. * * Also creates a DGRAM socket, binds to the loop back address and * returns the port allocated by the socket sub-system. * * \return * \li UPNP_E_OUTOF_SOCKET: Failed to create a socket. * \li UPNP_E_SOCKET_BIND: Bind() failed. * \li UPNP_E_LISTEN: Listen() failed. * \li UPNP_E_INTERNAL_ERROR: Port returned by the socket layer is < 0. * \li UPNP_E_SUCCESS: Success. */ static int get_miniserver_sockets( /*! [in] Socket Array. */ MiniServerSockArray *out, /*! [in] port on which the server is listening for incoming IPv4 * connections. */ uint16_t listen_port4 #ifdef UPNP_ENABLE_IPV6 , /*! [in] port on which the server is listening for incoming IPv6 * connections. */ uint16_t listen_port6 #endif ) { char errorBuffer[ERROR_BUFFER_LEN]; struct sockaddr_storage __ss_v4; struct sockaddr_in* serverAddr4 = (struct sockaddr_in*)&__ss_v4; SOCKET listenfd4; uint16_t actual_port4 = 0u; #ifdef UPNP_ENABLE_IPV6 struct sockaddr_storage __ss_v6; struct sockaddr_in6* serverAddr6 = (struct sockaddr_in6*)&__ss_v6; SOCKET listenfd6; uint16_t actual_port6 = 0u; #endif int ret_code; int reuseaddr_on = 0; int sockError = UPNP_E_SUCCESS; int errCode = 0; /* Create listen socket for IPv4/IPv6. An error here may indicate * that we don't have an IPv4/IPv6 stack. */ listenfd4 = socket(AF_INET, SOCK_STREAM, 0); if (listenfd4 == INVALID_SOCKET) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "get_miniserver_sockets: IPv4 socket not available: %s\n", errorBuffer); } #ifdef UPNP_ENABLE_IPV6 listenfd6 = socket(AF_INET6, SOCK_STREAM, 0); if (listenfd6 == INVALID_SOCKET) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "get_miniserver_sockets: IPv6 socket not available: %s\n", errorBuffer); } else { int onOff = 1; sockError = setsockopt(listenfd6, IPPROTO_IPV6, IPV6_V6ONLY, (char *)&onOff, sizeof(onOff)); if (sockError == SOCKET_ERROR) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "get_miniserver_sockets: unable to set IPv6 socket protocol: %s\n", errorBuffer); sock_close(listenfd6); listenfd6 = INVALID_SOCKET; } } #endif if (listenfd4 == INVALID_SOCKET #ifdef UPNP_ENABLE_IPV6 && listenfd6 == INVALID_SOCKET #endif ) { UpnpPrintf(UPNP_CRITICAL, MSERV, __FILE__, __LINE__, "get_miniserver_sockets: no protocols available\n"); return UPNP_E_OUTOF_SOCKET; } /* As per the IANA specifications for the use of ports by applications * override the listen port passed in with the first available. */ if (listen_port4 < APPLICATION_LISTENING_PORT) { listen_port4 = (uint16_t)APPLICATION_LISTENING_PORT; } #ifdef UPNP_ENABLE_IPV6 if (listen_port6 < APPLICATION_LISTENING_PORT) { listen_port6 = (uint16_t)APPLICATION_LISTENING_PORT; } #endif memset(&__ss_v4, 0, sizeof (__ss_v4)); serverAddr4->sin_family = (sa_family_t)AF_INET; inet_pton(AF_INET, gIF_IPV4, &serverAddr4->sin_addr); #ifdef UPNP_ENABLE_IPV6 memset(&__ss_v6, 0, sizeof (__ss_v6)); serverAddr6->sin6_family = (sa_family_t)AF_INET6; inet_pton(AF_INET6, gIF_IPV6, &serverAddr6->sin6_addr); serverAddr6->sin6_scope_id = gIF_INDEX; #endif /* Getting away with implementation of re-using address:port and * instead choosing to increment port numbers. * Keeping the re-use address code as an optional behaviour that * can be turned on if necessary. * TURN ON the reuseaddr_on option to use the option. */ if (reuseaddr_on) { /* THIS IS ALLOWS US TO BIND AGAIN IMMEDIATELY * AFTER OUR SERVER HAS BEEN CLOSED * THIS MAY CAUSE TCP TO BECOME LESS RELIABLE * HOWEVER IT HAS BEEN SUGESTED FOR TCP SERVERS. */ UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "get_miniserver_sockets: resuseaddr is set.\n"); if (listenfd4 != INVALID_SOCKET) { sockError = setsockopt(listenfd4, SOL_SOCKET, SO_REUSEADDR, (const char *)&reuseaddr_on, sizeof (int)); if (sockError == SOCKET_ERROR) { sock_close(listenfd4); #ifdef UPNP_ENABLE_IPV6 sock_close(listenfd6); #endif return UPNP_E_SOCKET_BIND; } serverAddr4->sin_port = htons(listen_port4); sockError = bind(listenfd4, (struct sockaddr *)&__ss_v4, sizeof (__ss_v4)); if (sockError == SOCKET_ERROR) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "get_miniserver_sockets: " "Error in IPv4 bind(): %s\n", errorBuffer); sock_close(listenfd4); #ifdef UPNP_ENABLE_IPV6 sock_close(listenfd6); #endif /* Bind failed */ return UPNP_E_SOCKET_BIND; } } #ifdef UPNP_ENABLE_IPV6 if (listenfd6 != INVALID_SOCKET) { sockError = setsockopt(listenfd6, SOL_SOCKET, SO_REUSEADDR, (const char *)&reuseaddr_on, sizeof (int)); if (sockError == SOCKET_ERROR) { sock_close(listenfd4); sock_close(listenfd6); return UPNP_E_SOCKET_BIND; } serverAddr6->sin6_port = htons(listen_port6); sockError = bind(listenfd6, (struct sockaddr *)&__ss_v6, sizeof (__ss_v6)); if (sockError == SOCKET_ERROR) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "get_miniserver_sockets: " "Error in IPv6 bind(): %s\n", errorBuffer); sock_close(listenfd4); sock_close(listenfd6); /* Bind failed */ return UPNP_E_SOCKET_BIND; } } #endif /* IPv6 */ } else { if (listenfd4 != INVALID_SOCKET) { uint16_t orig_listen_port4 = listen_port4; do { serverAddr4->sin_port = htons(listen_port4++); sockError = bind(listenfd4, (struct sockaddr *)serverAddr4, sizeof(*serverAddr4)); if (sockError == SOCKET_ERROR) { #ifdef WIN32 errCode = WSAGetLastError(); #else errCode = errno; #endif if (errno == EADDRINUSE) { errCode = 1; } } else { errCode = 0; } } while (errCode != 0 && listen_port4 >= orig_listen_port4); if (sockError == SOCKET_ERROR) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "get_miniserver_sockets: " "Error in IPv4 bind(): %s\n", errorBuffer); sock_close(listenfd4); #ifdef UPNP_ENABLE_IPV6 sock_close(listenfd6); #endif /* Bind failied. */ return UPNP_E_SOCKET_BIND; } } #ifdef UPNP_ENABLE_IPV6 if (listenfd6 != INVALID_SOCKET) { uint16_t orig_listen_port6 = listen_port6; do { serverAddr6->sin6_port = htons(listen_port6++); sockError = bind(listenfd6, (struct sockaddr *)serverAddr6, sizeof(*serverAddr6)); if (sockError == SOCKET_ERROR) { #ifdef WIN32 errCode = WSAGetLastError(); #else errCode = errno; #endif if (errno == EADDRINUSE) { errCode = 1; } } else { errCode = 0; } } while (errCode != 0 && listen_port6 >= orig_listen_port6); if (sockError == SOCKET_ERROR) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "get_miniserver_sockets: " "Error in IPv6 bind(): %s\n", errorBuffer); sock_close(listenfd4); sock_close(listenfd6); /* Bind failied. */ return UPNP_E_SOCKET_BIND; } } #endif } UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "get_miniserver_sockets: bind successful\n"); if (listenfd4 != INVALID_SOCKET) { ret_code = listen(listenfd4, SOMAXCONN); if (ret_code == SOCKET_ERROR) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "mserv start: Error in IPv4 listen(): %s\n", errorBuffer); sock_close(listenfd4); #ifdef UPNP_ENABLE_IPV6 sock_close(listenfd6); #endif return UPNP_E_LISTEN; } ret_code = get_port(listenfd4, &actual_port4); if (ret_code < 0) { sock_close(listenfd4); #ifdef UPNP_ENABLE_IPV6 sock_close(listenfd6); #endif return UPNP_E_INTERNAL_ERROR; } out->miniServerPort4 = actual_port4; } #ifdef UPNP_ENABLE_IPV6 if (listenfd6 != INVALID_SOCKET) { ret_code = listen(listenfd6, SOMAXCONN); if (ret_code == SOCKET_ERROR) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, MSERV, __FILE__, __LINE__, "mserv start: Error in IPv6 listen(): %s\n", errorBuffer); sock_close(listenfd4); sock_close(listenfd6); return UPNP_E_LISTEN; } ret_code = get_port(listenfd6, &actual_port6); if (ret_code < 0) { sock_close(listenfd4); sock_close(listenfd6); return UPNP_E_INTERNAL_ERROR; } out->miniServerPort6 = actual_port6; } #endif out->miniServerSock4 = listenfd4; #ifdef UPNP_ENABLE_IPV6 out->miniServerSock6 = listenfd6; #endif return UPNP_E_SUCCESS; } #endif /* INTERNAL_WEB_SERVER */ /*! * \brief Creates the miniserver STOP socket. This socket is created and * listened on to know when it is time to stop the Miniserver. * * \return * \li \c UPNP_E_OUTOF_SOCKET: Failed to create a socket. * \li \c UPNP_E_SOCKET_BIND: Bind() failed. * \li \c UPNP_E_INTERNAL_ERROR: Port returned by the socket layer is < 0. * \li \c UPNP_E_SUCCESS: Success. */ static int get_miniserver_stopsock( /*! [in] Miniserver Socket Array. */ MiniServerSockArray *out) { char errorBuffer[ERROR_BUFFER_LEN]; struct sockaddr_in stop_sockaddr; SOCKET miniServerStopSock = 0; int ret = 0; miniServerStopSock = socket(AF_INET, SOCK_DGRAM, 0); if (miniServerStopSock == INVALID_SOCKET) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, MSERV, __FILE__, __LINE__, "Error in socket(): %s\n", errorBuffer); return UPNP_E_OUTOF_SOCKET; } /* Bind to local socket. */ memset(&stop_sockaddr, 0, sizeof (stop_sockaddr)); stop_sockaddr.sin_family = (sa_family_t)AF_INET; stop_sockaddr.sin_addr.s_addr = inet_addr("127.0.0.1"); ret = bind(miniServerStopSock, (struct sockaddr *)&stop_sockaddr, sizeof(stop_sockaddr)); if (ret == SOCKET_ERROR) { UpnpPrintf(UPNP_CRITICAL, MSERV, __FILE__, __LINE__, "Error in binding localhost!!!\n"); sock_close(miniServerStopSock); return UPNP_E_SOCKET_BIND; } ret = get_port(miniServerStopSock, &miniStopSockPort); if (ret < 0) { sock_close(miniServerStopSock); return UPNP_E_INTERNAL_ERROR; } out->miniServerStopSock = miniServerStopSock; out->stopPort = miniStopSockPort; return UPNP_E_SUCCESS; } static UPNP_INLINE void InitMiniServerSockArray(MiniServerSockArray *miniSocket) { miniSocket->miniServerSock4 = INVALID_SOCKET; miniSocket->miniServerSock6 = INVALID_SOCKET; miniSocket->miniServerStopSock = INVALID_SOCKET; miniSocket->ssdpSock4 = INVALID_SOCKET; miniSocket->ssdpSock6 = INVALID_SOCKET; miniSocket->ssdpSock6UlaGua = INVALID_SOCKET; miniSocket->stopPort = 0u; miniSocket->miniServerPort4 = 0u; miniSocket->miniServerPort6 = 0u; #ifdef INCLUDE_CLIENT_APIS miniSocket->ssdpReqSock4 = INVALID_SOCKET; miniSocket->ssdpReqSock6 = INVALID_SOCKET; #endif /* INCLUDE_CLIENT_APIS */ } int StartMiniServer( /*! [in,out] Port on which the server listens for incoming IPv4 * connections. */ uint16_t *listen_port4, /*! [in,out] Port on which the server listens for incoming IPv6 * connections. */ uint16_t *listen_port6) { int ret_code; int count; int max_count = 10000; MiniServerSockArray *miniSocket; ThreadPoolJob job; memset(&job, 0, sizeof(job)); switch (gMServState) { case MSERV_IDLE: break; default: /* miniserver running. */ return UPNP_E_INTERNAL_ERROR; } miniSocket = (MiniServerSockArray *)malloc( sizeof (MiniServerSockArray)); if (!miniSocket) { return UPNP_E_OUTOF_MEMORY; } InitMiniServerSockArray(miniSocket); #ifdef INTERNAL_WEB_SERVER /* V4 and V6 http listeners. */ ret_code = get_miniserver_sockets( miniSocket, *listen_port4 #ifdef UPNP_ENABLE_IPV6 , *listen_port6 #endif ); if (ret_code != UPNP_E_SUCCESS) { free(miniSocket); return ret_code; } #endif /* Stop socket (To end miniserver processing). */ ret_code = get_miniserver_stopsock(miniSocket); if (ret_code != UPNP_E_SUCCESS) { sock_close(miniSocket->miniServerSock4); sock_close(miniSocket->miniServerSock6); free(miniSocket); return ret_code; } /* SSDP socket for discovery/advertising. */ ret_code = get_ssdp_sockets(miniSocket); if (ret_code != UPNP_E_SUCCESS) { sock_close(miniSocket->miniServerSock4); sock_close(miniSocket->miniServerSock6); sock_close(miniSocket->miniServerStopSock); free(miniSocket); return ret_code; } TPJobInit(&job, (start_routine)RunMiniServer, (void *)miniSocket); TPJobSetPriority(&job, MED_PRIORITY); TPJobSetFreeFunction(&job, (free_routine)free); ret_code = ThreadPoolAddPersistent(&gMiniServerThreadPool, &job, NULL); if (ret_code < 0) { sock_close(miniSocket->miniServerSock4); sock_close(miniSocket->miniServerSock6); sock_close(miniSocket->miniServerStopSock); sock_close(miniSocket->ssdpSock4); sock_close(miniSocket->ssdpSock6); sock_close(miniSocket->ssdpSock6UlaGua); #ifdef INCLUDE_CLIENT_APIS sock_close(miniSocket->ssdpReqSock4); sock_close(miniSocket->ssdpReqSock6); #endif /* INCLUDE_CLIENT_APIS */ free(miniSocket); return UPNP_E_OUTOF_MEMORY; } /* Wait for miniserver to start. */ count = 0; while (gMServState != (MiniServerState)MSERV_RUNNING && count < max_count) { /* 0.05s */ usleep(50u * 1000u); count++; } if (count >= max_count) { /* Took it too long to start that thread. */ sock_close(miniSocket->miniServerSock4); sock_close(miniSocket->miniServerSock6); sock_close(miniSocket->miniServerStopSock); sock_close(miniSocket->ssdpSock4); sock_close(miniSocket->ssdpSock6); sock_close(miniSocket->ssdpSock6UlaGua); #ifdef INCLUDE_CLIENT_APIS sock_close(miniSocket->ssdpReqSock4); sock_close(miniSocket->ssdpReqSock6); #endif /* INCLUDE_CLIENT_APIS */ return UPNP_E_INTERNAL_ERROR; } #ifdef INTERNAL_WEB_SERVER *listen_port4 = miniSocket->miniServerPort4; *listen_port6 = miniSocket->miniServerPort6; #endif return UPNP_E_SUCCESS; } int StopMiniServer() { char errorBuffer[ERROR_BUFFER_LEN]; socklen_t socklen = sizeof (struct sockaddr_in); SOCKET sock; struct sockaddr_in ssdpAddr; char buf[256] = "ShutDown"; size_t bufLen = strlen(buf); switch(gMServState) { case MSERV_RUNNING: gMServState = MSERV_STOPPING; break; default: return 0; } sock = socket(AF_INET, SOCK_DGRAM, 0); if (sock == INVALID_SOCKET) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, "SSDP_SERVER: StopSSDPServer: Error in socket() %s\n", errorBuffer); return 0; } while(gMServState != (MiniServerState)MSERV_IDLE) { ssdpAddr.sin_family = (sa_family_t)AF_INET; ssdpAddr.sin_addr.s_addr = inet_addr("127.0.0.1"); ssdpAddr.sin_port = htons(miniStopSockPort); sendto(sock, buf, bufLen, 0, (struct sockaddr *)&ssdpAddr, socklen); usleep(1000u); if (gMServState == (MiniServerState)MSERV_IDLE) { break; } isleep(1u); } sock_close(sock); return 0; } #endif /* EXCLUDE_MINISERVER */ pupnp-release-1.8.0/upnp/src/genlib/net/000077500000000000000000000000001303304015100200655ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/genlib/net/http/000077500000000000000000000000001303304015100210445ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/genlib/net/http/httpparser.c000066400000000000000000002026151303304015100234120ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /* * \file * * \brief Contains functions for scanner and parser for http messages. */ #ifndef _GNU_SOURCE #define _GNU_SOURCE /* For strcasestr() in string.h */ #endif #include "config.h" #include "strintmap.h" #include "httpparser.h" #include "statcodes.h" #include "unixutil.h" #include "upnpdebug.h" #include #include #include #include #include #include /* entity positions */ #define NUM_HTTP_METHODS 11 static str_int_entry Http_Method_Table[NUM_HTTP_METHODS] = { {"DELETE", HTTPMETHOD_DELETE}, {"GET", HTTPMETHOD_GET}, {"HEAD", HTTPMETHOD_HEAD}, {"M-POST", HTTPMETHOD_MPOST}, {"M-SEARCH", HTTPMETHOD_MSEARCH}, {"NOTIFY", HTTPMETHOD_NOTIFY}, {"POST", HTTPMETHOD_POST}, {"SUBSCRIBE", HTTPMETHOD_SUBSCRIBE}, {"UNSUBSCRIBE", HTTPMETHOD_UNSUBSCRIBE}, {"POST", SOAPMETHOD_POST}, {"PUT", HTTPMETHOD_PUT} }; #define NUM_HTTP_HEADER_NAMES 33 str_int_entry Http_Header_Names[NUM_HTTP_HEADER_NAMES] = { {"ACCEPT", HDR_ACCEPT}, {"ACCEPT-CHARSET", HDR_ACCEPT_CHARSET}, {"ACCEPT-ENCODING", HDR_ACCEPT_ENCODING}, {"ACCEPT-LANGUAGE", HDR_ACCEPT_LANGUAGE}, {"ACCEPT-RANGES", HDR_ACCEPT_RANGE}, {"CACHE-CONTROL", HDR_CACHE_CONTROL}, {"CALLBACK", HDR_CALLBACK}, {"CONTENT-ENCODING", HDR_CONTENT_ENCODING}, {"CONTENT-LANGUAGE", HDR_CONTENT_LANGUAGE}, {"CONTENT-LENGTH", HDR_CONTENT_LENGTH}, {"CONTENT-LOCATION", HDR_CONTENT_LOCATION}, {"CONTENT-RANGE", HDR_CONTENT_RANGE}, {"CONTENT-TYPE", HDR_CONTENT_TYPE}, {"DATE", HDR_DATE}, {"EXT", HDR_EXT}, {"HOST", HDR_HOST}, {"IF-RANGE", HDR_IF_RANGE}, {"LOCATION", HDR_LOCATION}, {"MAN", HDR_MAN}, {"MX", HDR_MX}, {"NT", HDR_NT}, {"NTS", HDR_NTS}, {"RANGE", HDR_RANGE}, {"SEQ", HDR_SEQ}, {"SERVER", HDR_SERVER}, {"SID", HDR_SID}, {"SOAPACTION", HDR_SOAPACTION}, {"ST", HDR_ST}, {"TE", HDR_TE}, {"TIMEOUT", HDR_TIMEOUT}, {"TRANSFER-ENCODING", HDR_TRANSFER_ENCODING}, {"USER-AGENT", HDR_USER_AGENT}, {"USN", HDR_USN}, }; /***********************************************************************/ /************* scanner *************/ /***********************************************************************/ #define TOKCHAR_CR 0xD #define TOKCHAR_LF 0xA /************************************************************************ * Function : scanner_init * * Parameters : * OUT scanner_t* scanner ; Scanner Object to be initialized * IN membuffer* bufptr ; Buffer to be copied * * Description : Intialize scanner * * Return : void ; * * Note : ************************************************************************/ static UPNP_INLINE void scanner_init(OUT scanner_t *scanner, IN membuffer *bufptr) { scanner->cursor = (size_t)0; scanner->msg = bufptr; scanner->entire_msg_loaded = FALSE; } /************************************************************************ * Function : is_separator_char * * Parameters : * IN char c ; character to be tested against used separator values * * Description : Determines if the passed value is a separator * ************************************************************************/ static UPNP_INLINE int is_separator_char(IN int c) { return strchr(" \t()<>@,;:\\\"/[]?={}", c) != 0; } /************************************************************************ * Function : is_identifier_char * * Parameters : * IN char c ; character to be tested for separator values * * Description : Determines if the passed value is permissible in token * ************************************************************************/ static UPNP_INLINE int is_identifier_char(IN int c) { return c >= 32 && c <= 126 && !is_separator_char(c); } /************************************************************************ * Function : is_control_char * * Parameters : * IN char c ; character to be tested for a control character * * Description : Determines if the passed value is a control character * ************************************************************************/ static UPNP_INLINE int is_control_char(IN int c) { return (c >= 0 && c <= 31) || c == 127; } /************************************************************************ * Function : is_qdtext_char * * Parameters : * IN char cc ; character to be tested for CR/LF * * Description : Determines if the passed value is permissible in qdtext * ************************************************************************/ static UPNP_INLINE int is_qdtext_char(IN int c) { /* we don't check for this; it's checked in get_token() */ assert( c != '"' ); return (c >= 32 && c != 127) || c < 0 || c == TOKCHAR_CR || c == TOKCHAR_LF || c == '\t'; } /************************************************************************ * Function : scanner_get_token * * Parameters : * INOUT scanner_t* scanner ; Scanner Object * OUT memptr* token ; Token * OUT token_type_t* tok_type ; Type of token * * Description : reads next token from the input stream * note: 0 and is used as a marker, and will not be valid in a quote * * Return : parse_status_t ; * PARSE_OK * PARSE_INCOMPLETE -- not enuf chars to get a token * PARSE_FAILURE -- bad msg format * * Note : ************************************************************************/ static parse_status_t scanner_get_token( INOUT scanner_t *scanner, OUT memptr *token, OUT token_type_t *tok_type) { char *cursor; char *null_terminator; /* point to null-terminator in buffer */ int c; token_type_t token_type; int got_end_quote; assert(scanner); assert(token); assert(tok_type); /* point to next char in buffer */ cursor = scanner->msg->buf + scanner->cursor; null_terminator = scanner->msg->buf + scanner->msg->length; /* not enough chars in input to parse */ if (cursor == null_terminator) return PARSE_INCOMPLETE; c = *cursor; if (is_identifier_char(c)) { /* scan identifier */ token->buf = cursor++; token_type = TT_IDENTIFIER; while (cursor < null_terminator && is_identifier_char(*cursor)) cursor++; if (!scanner->entire_msg_loaded && cursor == null_terminator) /* possibly more valid chars */ return PARSE_INCOMPLETE; /* calc token length */ token->length = (size_t)cursor - (size_t)token->buf; } else if (c == ' ' || c == '\t') { token->buf = cursor++; token_type = TT_WHITESPACE; while (cursor < null_terminator && (*cursor == ' ' || *cursor == '\t')) cursor++; if (!scanner->entire_msg_loaded && cursor == null_terminator) /* possibly more chars */ return PARSE_INCOMPLETE; token->length = (size_t)cursor - (size_t)token->buf; } else if (c == TOKCHAR_CR) { /* scan CRLF */ token->buf = cursor++; if (cursor == null_terminator) /* not enuf info to determine CRLF */ return PARSE_INCOMPLETE; if (*cursor != TOKCHAR_LF) { /* couldn't match CRLF; match as CR */ token_type = TT_CTRL; /* ctrl char */ token->length = (size_t)1; } else { /* got CRLF */ token->length = (size_t)2; token_type = TT_CRLF; cursor++; } } else if (c == TOKCHAR_LF) { /* accept \n as CRLF */ token->buf = cursor++; token->length = (size_t)1; token_type = TT_CRLF; } else if (c == '"') { /* quoted text */ token->buf = cursor++; token_type = TT_QUOTEDSTRING; got_end_quote = FALSE; while (cursor < null_terminator) { c = *cursor++; if (c == '"') { got_end_quote = TRUE; break; } else if (c == '\\') { if (cursor < null_terminator) { c = *cursor++; /* the char after '\\' could be ANY octet */ } /* else, while loop handles incomplete buf */ } else if (is_qdtext_char(c)) { /* just accept char */ } else /* bad quoted text */ return PARSE_FAILURE; } if (got_end_quote) token->length = (size_t)cursor - (size_t)token->buf; else { /* incomplete */ assert(cursor == null_terminator); return PARSE_INCOMPLETE; } } else if (is_separator_char(c)) { /* scan separator */ token->buf = cursor++; token_type = TT_SEPARATOR; token->length = (size_t)1; } else if (is_control_char(c)) { /* scan ctrl char */ token->buf = cursor++; token_type = TT_CTRL; token->length = (size_t)1; } else return PARSE_FAILURE; scanner->cursor += token->length; /* move to next token */ *tok_type = token_type; return PARSE_OK; } /************************************************************************ * Function : scanner_get_str * * Parameters : * IN scanner_t* scanner ; Scanner Object * * Description : returns ptr to next char in string * * Return : char* ; * * Note : ************************************************************************/ static UPNP_INLINE char *scanner_get_str(IN scanner_t * scanner) { return scanner->msg->buf + scanner->cursor; } /************************************************************************ * Function : httpmsg_compare * * Parameters : * void* param1 ; * void* param2 ; * * Description : Compares name id in the http headers. * * Return : int ; * * Note : ************************************************************************/ static int httpmsg_compare(void *param1, void *param2) { assert( param1 != NULL ); assert( param2 != NULL ); return ((http_header_t *)param1)->name_id == ((http_header_t *)param2)->name_id; } /************************************************************************ * Function : httpheader_free * * Parameters : * void *msg ; * * Description : Free memory allocated for the http header * * Return : void ; * * Note : ************************************************************************/ static void httpheader_free(void *msg) { http_header_t *hdr = ( http_header_t * ) msg; membuffer_destroy( &hdr->name_buf ); membuffer_destroy( &hdr->value ); free( hdr ); } /************************************************************************ * Function : httpmsg_init * * Parameters : * INOUT http_message_t* msg ; HTTP Message Object * * Description : Initialize and allocate memory for http message * * Return : void ; * * Note : ************************************************************************/ void httpmsg_init(INOUT http_message_t *msg) { msg->initialized = 1; msg->entity.buf = NULL; msg->entity.length = ( size_t ) 0; ListInit( &msg->headers, httpmsg_compare, httpheader_free ); membuffer_init( &msg->msg ); membuffer_init( &msg->status_msg ); } /************************************************************************ * Function : httpmsg_destroy * * Parameters : * INOUT http_message_t* msg ; HTTP Message Object * * Description : Free memory allocated for the http message * * Return : void ; * * Note : ************************************************************************/ void httpmsg_destroy( INOUT http_message_t * msg ) { assert( msg != NULL ); if( msg->initialized == 1 ) { ListDestroy( &msg->headers, 1 ); membuffer_destroy( &msg->msg ); membuffer_destroy( &msg->status_msg ); free( msg->urlbuf ); msg->initialized = 0; } } /************************************************************************ * Function : httpmsg_find_hdr_str * * Parameters : * IN http_message_t* msg ; HTTP Message Object * IN const char* header_name ; Header name to be compared with * * Description : Compares the header name with the header names stored * in the linked list of messages * * Return : http_header_t* - Pointer to a header on success; * NULL on failure * * Note : ************************************************************************/ http_header_t *httpmsg_find_hdr_str( IN http_message_t *msg, IN const char *header_name) { http_header_t *header; ListNode *node; node = ListHead( &msg->headers ); while( node != NULL ) { header = ( http_header_t * ) node->item; if( memptr_cmp_nocase( &header->name, header_name ) == 0 ) { return header; } node = ListNext( &msg->headers, node ); } return NULL; } /************************************************************************ * Function : httpmsg_find_hdr * * Parameters : * IN http_message_t* msg ; HTTP Message Object * IN int header_name_id ; Header Name ID to be compared with * OUT memptr* value ; Buffer to get the ouput to. * * Description : Finds header from a list, with the given 'name_id'. * * Return : http_header_t* - Pointer to a header on success; * NULL on failure * * Note : ************************************************************************/ http_header_t *httpmsg_find_hdr( IN http_message_t *msg, IN int header_name_id, OUT memptr *value) { http_header_t header; /* temp header for searching */ ListNode *node; http_header_t *data; header.name_id = header_name_id; node = ListFind( &msg->headers, NULL, &header ); if( node == NULL ) { return NULL; } data = ( http_header_t * ) node->item; if( value != NULL ) { value->buf = data->value.buf; value->length = data->value.length; } return data; } /************************************************************************ * Function : skip_blank_lines * * Parameters : * INOUT scanner_t* scanner ; Scanner Object * * Description : skips blank lines at the start of a msg. * * Return : parse_status_t ; * PARSE_OK * PARSE_INCOMPLETE -- not enuf chars to get a token * PARSE_FAILURE -- bad msg format ************************************************************************/ static UPNP_INLINE parse_status_t skip_blank_lines(INOUT scanner_t *scanner) { memptr token; token_type_t tok_type; parse_status_t status; /* skip ws, crlf */ do { status = scanner_get_token(scanner, &token, &tok_type); } while (status == (parse_status_t)PARSE_OK && (tok_type == (token_type_t)TT_WHITESPACE || tok_type == (token_type_t)TT_CRLF)); if (status == (parse_status_t)PARSE_OK) { /* pushback a non-whitespace token */ scanner->cursor -= token.length; } return status; } /************************************************************************ * Function : skip_lws * * Parameters : * INOUT scanner_t* scanner ; Scanner Object * * Description : skip linear whitespace. * * Return : int ; * PARSE_OK: (LWS)* removed from input * PARSE_FAILURE: bad input * PARSE_INCOMPLETE: incomplete input * * Note : ************************************************************************/ static UPNP_INLINE parse_status_t skip_lws(INOUT scanner_t *scanner) { memptr token; token_type_t tok_type; parse_status_t status; size_t save_pos; int matched; do { save_pos = scanner->cursor; matched = FALSE; /* get CRLF or WS */ status = scanner_get_token( scanner, &token, &tok_type ); if( status == ( parse_status_t ) PARSE_OK ) { if( tok_type == ( token_type_t ) TT_CRLF ) { /* get WS */ status = scanner_get_token( scanner, &token, &tok_type ); } if( status == ( parse_status_t ) PARSE_OK && tok_type == ( token_type_t ) TT_WHITESPACE ) { matched = TRUE; } else { /* did not match LWS; pushback token(s) */ scanner->cursor = save_pos; } } } while( matched ); /* if entire msg is loaded, ignore an 'incomplete' warning */ if( status == ( parse_status_t ) PARSE_INCOMPLETE && scanner->entire_msg_loaded ) { status = PARSE_OK; } return status; } /************************************************************************ * Function : match_non_ws_string * * Parameters : * INOUT scanner_t* scanner ; Scanner Object * OUT memptr* str ; Buffer to get the scanner buffer contents. * * Description : Match a string without whitespace or CRLF (%S) * * Return : UPNP_INLINE parse_status_t ; * PARSE_OK * PARSE_NO_MATCH * PARSE_FAILURE * PARSE_INCOMPLETE * * Note : ************************************************************************/ static UPNP_INLINE parse_status_t match_non_ws_string( INOUT scanner_t *scanner, OUT memptr *str) { memptr token; token_type_t tok_type; parse_status_t status; int done = FALSE; size_t save_cursor; save_cursor = scanner->cursor; str->length = ( size_t ) 0; str->buf = scanner_get_str( scanner ); /* point to next char in input */ while( !done ) { status = scanner_get_token( scanner, &token, &tok_type ); if( status == ( parse_status_t ) PARSE_OK && tok_type != ( token_type_t ) TT_WHITESPACE && tok_type != ( token_type_t ) TT_CRLF ) { /* append non-ws token */ str->length += token.length; } else { done = TRUE; } } if( status == ( parse_status_t ) PARSE_OK ) { /* last token was WS; push it back in */ scanner->cursor -= token.length; } /* tolerate 'incomplete' msg */ if( status == ( parse_status_t ) PARSE_OK || ( status == ( parse_status_t ) PARSE_INCOMPLETE && scanner->entire_msg_loaded ) ) { if( str->length == ( size_t ) 0 ) { /* no strings found */ return PARSE_NO_MATCH; } else { return PARSE_OK; } } else { /* error -- pushback tokens */ scanner->cursor = save_cursor; return status; } } /************************************************************************ * Function : match_raw_value * * Parameters : * INOUT scanner_t* scanner ; Scanner Object * OUT memptr* raw_value ; Buffer to get the scanner buffer * contents * * Description : Matches a raw value in a the input; value's length * can be 0 or more. Whitespace after value is trimmed. On success, * scanner points the CRLF that ended the value * * Return : parse_status_t ; * PARSE_OK * PARSE_INCOMPLETE * PARSE_FAILURE * * Note : ************************************************************************/ static UPNP_INLINE parse_status_t match_raw_value( INOUT scanner_t * scanner, OUT memptr *raw_value) { memptr token; token_type_t tok_type; parse_status_t status; int done = FALSE; int saw_crlf = FALSE; size_t pos_at_crlf = ( size_t ) 0; size_t save_pos; char c; save_pos = scanner->cursor; /* value points to start of input */ raw_value->buf = scanner_get_str( scanner ); raw_value->length = ( size_t ) 0; while( !done ) { status = scanner_get_token( scanner, &token, &tok_type ); if( status == ( parse_status_t ) PARSE_OK ) { if( !saw_crlf ) { if( tok_type == ( token_type_t ) TT_CRLF ) { /* CRLF could end value */ saw_crlf = TRUE; /* save input position at start of CRLF */ pos_at_crlf = scanner->cursor - token.length; } /* keep appending value */ raw_value->length += token.length; } else /* already seen CRLF */ { if( tok_type == ( token_type_t ) TT_WHITESPACE ) { /* start again; forget CRLF */ saw_crlf = FALSE; raw_value->length += token.length; } else { /* non-ws means value ended just before CRLF */ done = TRUE; /* point to the crlf which ended the value */ scanner->cursor = pos_at_crlf; } } } else { /* some kind of error; restore scanner position */ scanner->cursor = save_pos; done = TRUE; } } if( status == ( parse_status_t ) PARSE_OK ) { /* trim whitespace on right side of value */ while( raw_value->length > ( size_t ) 0 ) { /* get last char */ c = raw_value->buf[raw_value->length - ( size_t ) 1]; if( c != ' ' && c != '\t' && c != TOKCHAR_CR && c != TOKCHAR_LF ) { /* done; no more whitespace */ break; } /* remove whitespace */ raw_value->length--; } } return status; } /************************************************************************ * Function: match_int * * Parameters: * INOUT scanner_t* scanner ; Scanner Object * IN int base : Base of number in the string; * valid values: 10 or 16 * OUT int* value ; Number stored here * * Description: Matches an unsigned integer value in the input. The * integer is returned in 'value'. Except for PARSE_OK result, the * scanner's cursor is moved back to its original position on error. * * Returns: * PARSE_OK * PARSE_NO_MATCH -- got different kind of token * PARSE_FAILURE -- bad input * PARSE_INCOMPLETE ************************************************************************/ static UPNP_INLINE parse_status_t match_int( INOUT scanner_t *scanner, IN int base, OUT int *value) { memptr token; token_type_t tok_type; parse_status_t status; long num; char *end_ptr; size_t save_pos; save_pos = scanner->cursor; status = scanner_get_token(scanner, &token, &tok_type); if (status == (parse_status_t)PARSE_OK) { if (tok_type == (token_type_t)TT_IDENTIFIER) { errno = 0; num = strtol(token.buf, &end_ptr, base); /* all and only those chars in token should be used for num */ if (num < 0 || end_ptr != token.buf + token.length || ((num == LONG_MIN || num == LONG_MAX) && (errno == ERANGE))) { status = PARSE_NO_MATCH; } /* save result */ *value = (int)num; } else { /* token must be an identifier */ status = PARSE_NO_MATCH; } } if (status != (parse_status_t)PARSE_OK) { /* restore scanner position for bad values */ scanner->cursor = save_pos; } return status; } /************************************************************************ * Function: read_until_crlf * * Parameters: * INOUT scanner_t* scanner ;Scanner Object * OUT memptr* str ; Buffer to copy scanner buffer contents to * * Description: Reads data until end of line; the crlf at the end of * line is not consumed. On error, scanner is not restored. On * success, 'str' points to a string that runs until eol * * Returns: * PARSE_OK * PARSE_FAILURE * PARSE_INCOMPLETE ************************************************************************/ static UPNP_INLINE parse_status_t read_until_crlf( INOUT scanner_t * scanner, OUT memptr * str ) { memptr token; token_type_t tok_type; parse_status_t status; size_t start_pos; start_pos = scanner->cursor; str->buf = scanner_get_str( scanner ); /* read until we hit a crlf */ do { status = scanner_get_token( scanner, &token, &tok_type ); } while( status == ( parse_status_t ) PARSE_OK && tok_type != ( token_type_t ) TT_CRLF ); if( status == ( parse_status_t ) PARSE_OK ) { /* pushback crlf in stream */ scanner->cursor -= token.length; /* str should include all strings except crlf at the end */ str->length = scanner->cursor - start_pos; } return status; } /************************************************************************ * Function: match_char * * Parameters: * INOUT scanner_t* scanner ; Scanner Object * IN char c ; Character to be compared with * IN int case_sensitive; Flag indicating whether * comparison should be case sensitive * * Description: Compares a character to the next char in the scanner; * on error, scanner chars are not restored * * Returns: * PARSE_OK * PARSE_NO_MATCH * PARSE_INCOMPLETE ************************************************************************/ static UPNP_INLINE parse_status_t match_char( INOUT scanner_t * scanner, IN char c, IN int case_sensitive ) { char scan_char; if( scanner->cursor >= scanner->msg->length ) { return PARSE_INCOMPLETE; } /* read next char from scanner */ scan_char = scanner->msg->buf[scanner->cursor++]; if( case_sensitive ) { return c == scan_char ? PARSE_OK : PARSE_NO_MATCH; } else { return tolower( c ) == tolower( scan_char ) ? PARSE_OK : PARSE_NO_MATCH; } } /* * * * args for ... * %d, int * (31-bit positive integer) * %x, int * (31-bit postive number encoded as hex) * %s, memptr* (simple identifier) * %q, memptr* (quoted string) * %S, memptr* (non-whitespace string) * %R, memptr* (raw value) * %U, uri_type* (url) * %L, memptr* (string until end of line) * %P, int * (current index of the string being scanned) * * no args for * ' ' LWS* * \t whitespace * "%%" matches '%' * "% " matches ' ' * %c matches CRLF * %i ignore case in literal matching * %n case-sensitive matching in literals * %w optional whitespace; (similar to '\t', * except whitespace is optional) * %0 (zero) match null-terminator char '\0' * (can only be used as last char in fmt) * use only in matchstr(), not match() * other chars match literally * * returns: * PARSE_OK * PARSE_INCOMPLETE * PARSE_FAILURE -- bad input * PARSE_NO_MATCH -- input does not match pattern */ /************************************************************************ * Function : vfmatch * * Parameters : * INOUT scanner_t* scanner ; Scanner Object * IN const char* fmt ; Pattern Format * va_list argp ; List of variable arguments * * Description : Extracts variable parameters depending on the passed * in format parameter. Parses data also based on the passed in * format parameter. * * Return : int ; * PARSE_OK * PARSE_INCOMPLETE * PARSE_FAILURE - bad input * PARSE_NO_MATCH - input does not match pattern * * Note : ************************************************************************/ static parse_status_t vfmatch( INOUT scanner_t *scanner, IN const char *fmt, va_list argp) { char c; const char *fmt_ptr = fmt; parse_status_t status; memptr *str_ptr; memptr temp_str; int *int_ptr; uri_type *uri_ptr; size_t save_pos; int stat; int case_sensitive = TRUE; memptr token; token_type_t tok_type; int base; assert( scanner != NULL ); assert( fmt != NULL ); /* save scanner pos; to aid error recovery */ save_pos = scanner->cursor; status = PARSE_OK; while( ( c = *fmt_ptr++ ) && ( status == ( parse_status_t ) PARSE_OK ) ) { if( c == '%' ) { c = *fmt_ptr++; switch ( c ) { case 'R': /* raw value */ str_ptr = va_arg( argp, memptr * ); assert( str_ptr != NULL ); status = match_raw_value( scanner, str_ptr ); break; case 's': /* simple identifier */ str_ptr = va_arg( argp, memptr * ); assert( str_ptr != NULL ); status = scanner_get_token( scanner, str_ptr, &tok_type ); if( status == ( parse_status_t ) PARSE_OK && tok_type != ( token_type_t ) TT_IDENTIFIER ) { /* not an identifier */ status = PARSE_NO_MATCH; } break; case 'c': /* crlf */ status = scanner_get_token( scanner, &token, &tok_type ); if( status == ( parse_status_t ) PARSE_OK && tok_type != ( token_type_t ) TT_CRLF ) { /* not CRLF token */ status = PARSE_NO_MATCH; } break; case 'd': /* integer */ case 'x': /* hex number */ int_ptr = va_arg(argp, int *); assert(int_ptr != NULL); base = c == 'd' ? 10 : 16; status = match_int(scanner, base, int_ptr); break; case 'S': /* non-whitespace string */ case 'U': /* uri */ if( c == 'S' ) { str_ptr = va_arg( argp, memptr * ); } else { str_ptr = &temp_str; } assert( str_ptr != NULL ); status = match_non_ws_string( scanner, str_ptr ); if( c == 'U' && status == ( parse_status_t ) PARSE_OK ) { uri_ptr = va_arg( argp, uri_type * ); assert( uri_ptr != NULL ); stat = parse_uri( str_ptr->buf, str_ptr->length, uri_ptr ); if( stat != HTTP_SUCCESS ) { status = PARSE_NO_MATCH; } } break; case 'L': /* string till eol */ str_ptr = va_arg( argp, memptr * ); assert( str_ptr != NULL ); status = read_until_crlf( scanner, str_ptr ); break; case ' ': /* match space */ case '%': /* match percentage symbol */ status = match_char( scanner, c, case_sensitive ); break; case 'n': /* case-sensitive match */ case_sensitive = TRUE; break; case 'i': /* ignore case */ case_sensitive = FALSE; break; case 'q': /* quoted string */ str_ptr = ( memptr * ) va_arg( argp, memptr * ); status = scanner_get_token( scanner, str_ptr, &tok_type ); if( status == ( parse_status_t ) PARSE_OK && tok_type != ( token_type_t ) TT_QUOTEDSTRING ) { status = PARSE_NO_MATCH; /* not a quoted string */ } break; case 'w': /* optional whitespace */ status = scanner_get_token( scanner, &token, &tok_type ); if( status == ( parse_status_t ) PARSE_OK && tok_type != ( token_type_t ) TT_WHITESPACE ) { /* restore non-whitespace token */ scanner->cursor -= token.length; } break; case 'P': /* current pos of scanner */ int_ptr = va_arg( argp, int * ); assert( int_ptr != NULL ); *int_ptr = (int)scanner->cursor; break; /* valid only in matchstr() */ case '0': /* end of msg? */ /* check that we are 1 beyond last char */ if( scanner->cursor == scanner->msg->length && scanner->msg->buf[scanner->cursor] == '\0' ) { status = PARSE_OK; } else { status = PARSE_NO_MATCH; } break; default: /* unknown option */ assert( 0 ); } } else { switch ( c ) { case ' ': /* LWS* */ status = skip_lws( scanner ); break; case '\t': /* Whitespace */ status = scanner_get_token( scanner, &token, &tok_type ); if( status == ( parse_status_t ) PARSE_OK && tok_type != (token_type_t) TT_WHITESPACE ) { /* not whitespace token */ status = PARSE_NO_MATCH; } break; default: /* match characters */ { status = match_char( scanner, c, case_sensitive ); } } } } if( status != ( parse_status_t ) PARSE_OK ) { /* on error, restore original scanner pos */ scanner->cursor = save_pos; } return status; } /************************************************************************ * Function: match * * Parameters: * INOUT scanner_t* scanner ; Scanner Object * IN const char* fmt; Pattern format * ... * * Description: matches a variable parameter list and takes necessary * actions based on the data type specified. * * Returns: * PARSE_OK * PARSE_NO_MATCH * PARSE_INCOMPLETE * PARSE_FAILURE - bad input ************************************************************************/ static parse_status_t match( INOUT scanner_t *scanner, IN const char *fmt, ...) { parse_status_t ret_code; va_list args; va_start(args, fmt); ret_code = vfmatch(scanner, fmt, args); va_end(args); return ret_code; } /************************************************************************ * Function: matchstr * * Parameters: * IN char *str ; String to be matched * IN size_t slen ; Length of the string * IN const char* fmt ; Pattern format * ... * * Description: Matches a variable parameter list with a string * and takes actions based on the data type specified. * * Returns: * PARSE_OK * PARSE_NO_MATCH -- failure to match pattern 'fmt' * PARSE_FAILURE -- 'str' is bad input * PARSE_INCOMPLETE ************************************************************************/ parse_status_t matchstr( IN char *str, IN size_t slen, IN const char *fmt, ... ) { parse_status_t ret_code; char save_char; scanner_t scanner; membuffer buf; va_list arg_list; /* null terminate str */ save_char = str[slen]; str[slen] = '\0'; membuffer_init( &buf ); /* under no circumstances should this buffer be modifed because its memory */ /* might have not come from malloc() */ membuffer_attach( &buf, str, slen ); scanner_init( &scanner, &buf ); scanner.entire_msg_loaded = TRUE; va_start( arg_list, fmt ); ret_code = vfmatch( &scanner, fmt, arg_list ); va_end( arg_list ); /* restore str */ str[slen] = save_char; /* don't destroy buf */ return ret_code; } /************************************************************************ * Function: parser_init * * Parameters: * OUT http_parser_t* parser ; HTTP Parser object * * Description: Initializes the parser object. * * Returns: * void ************************************************************************/ static UPNP_INLINE void parser_init( OUT http_parser_t * parser ) { memset( parser, 0, sizeof( http_parser_t ) ); parser->http_error_code = HTTP_BAD_REQUEST; /* err msg by default */ parser->ent_position = ENTREAD_DETERMINE_READ_METHOD; parser->valid_ssdp_notify_hack = FALSE; httpmsg_init( &parser->msg ); scanner_init( &parser->scanner, &parser->msg.msg ); } /************************************************************************ * Function: parser_parse_requestline * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser object * * Description: Get HTTP Method, URL location and version information. * * Returns: * PARSE_OK * PARSE_SUCCESS * PARSE_FAILURE * PARSE_INCOMPLETE * PARSE_NO_MATCH ************************************************************************/ static parse_status_t parser_parse_requestline( INOUT http_parser_t * parser ) { parse_status_t status; http_message_t *hmsg = &parser->msg; memptr method_str; memptr version_str; int index; char save_char; int num_scanned; memptr url_str; assert( parser->position == POS_REQUEST_LINE ); status = skip_blank_lines( &parser->scanner ); if( status != ( parse_status_t ) PARSE_OK ) { return status; } /*simple get http 0.9 as described in http 1.0 spec */ status = match( &parser->scanner, "%s\t%S%w%c", &method_str, &url_str ); if( status == ( parse_status_t ) PARSE_OK ) { index = map_str_to_int( method_str.buf, method_str.length, Http_Method_Table, NUM_HTTP_METHODS, TRUE ); if( index < 0 ) { /* error; method not found */ parser->http_error_code = HTTP_NOT_IMPLEMENTED; return PARSE_FAILURE; } if( Http_Method_Table[index].id != HTTPMETHOD_GET ) { parser->http_error_code = HTTP_BAD_REQUEST; return PARSE_FAILURE; } hmsg->method = HTTPMETHOD_SIMPLEGET; /* store url */ hmsg->urlbuf = str_alloc( url_str.buf, url_str.length ); if( hmsg->urlbuf == NULL ) { /* out of mem */ parser->http_error_code = HTTP_INTERNAL_SERVER_ERROR; return PARSE_FAILURE; } if( parse_uri( hmsg->urlbuf, url_str.length, &hmsg->uri ) != HTTP_SUCCESS ) { return PARSE_FAILURE; } parser->position = POS_COMPLETE; /* move to headers */ return PARSE_SUCCESS; } status = match( &parser->scanner, "%s\t%S\t%ihttp%w/%w%L%c", &method_str, &url_str, &version_str ); if( status != ( parse_status_t ) PARSE_OK ) { return status; } /* store url */ hmsg->urlbuf = str_alloc( url_str.buf, url_str.length ); if( hmsg->urlbuf == NULL ) { /* out of mem */ parser->http_error_code = HTTP_INTERNAL_SERVER_ERROR; return PARSE_FAILURE; } if( parse_uri( hmsg->urlbuf, url_str.length, &hmsg->uri ) != HTTP_SUCCESS ) { return PARSE_FAILURE; } index = map_str_to_int( method_str.buf, method_str.length, Http_Method_Table, NUM_HTTP_METHODS, TRUE ); if( index < 0 ) { /* error; method not found */ parser->http_error_code = HTTP_NOT_IMPLEMENTED; return PARSE_FAILURE; } /* scan version */ save_char = version_str.buf[version_str.length]; version_str.buf[version_str.length] = '\0'; /* null-terminate */ num_scanned = sscanf( version_str.buf, "%d . %d", &hmsg->major_version, &hmsg->minor_version ); version_str.buf[version_str.length] = save_char; /* restore */ if (num_scanned != 2 || /* HTTP version equals to 1.0 should fail for MSEARCH as required by the * UPnP certification tool */ hmsg->major_version < 0 || ( hmsg->major_version == 1 && hmsg->minor_version < 1 && Http_Method_Table[index].id == HTTPMETHOD_MSEARCH )) { parser->http_error_code = HTTP_HTTP_VERSION_NOT_SUPPORTED; /* error; bad http version */ return PARSE_FAILURE; } hmsg->method = ( http_method_t ) Http_Method_Table[index].id; parser->position = POS_HEADERS; /* move to headers */ return PARSE_OK; } /************************************************************************ * Function: parser_parse_responseline * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser object * * Description: Get HTTP version information, status code and status msg. * * Returns: * PARSE_OK * PARSE_FAILURE * PARSE_INCOMPLETE * PARSE_NO_MATCH ************************************************************************/ parse_status_t parser_parse_responseline(INOUT http_parser_t *parser) { parse_status_t status; http_message_t *hmsg = &parser->msg; memptr line; char save_char; int num_scanned; int i; size_t n; char *p; assert(parser->position == POS_RESPONSE_LINE); status = skip_blank_lines(&parser->scanner); if (status != ( parse_status_t) PARSE_OK) return status; /* response line */ /*status = match( &parser->scanner, "%ihttp%w/%w%d\t.\t%d\t%d\t%L%c", */ /* &hmsg->major_version, &hmsg->minor_version, */ /* &hmsg->status_code, &hmsg->status_msg ); */ status = match(&parser->scanner, "%ihttp%w/%w%L%c", &line); if (status != ( parse_status_t ) PARSE_OK) return status; save_char = line.buf[line.length]; line.buf[line.length] = '\0'; /* null-terminate */ /* scan http version and ret code */ num_scanned = sscanf(line.buf, "%d . %d %d", &hmsg->major_version, &hmsg->minor_version, &hmsg->status_code); line.buf[line.length] = save_char; /* restore */ if (num_scanned != 3 || hmsg->major_version < 0 || hmsg->minor_version < 0 || hmsg->status_code < 0) /* bad response line */ return PARSE_FAILURE; /* point to status msg */ p = line.buf; /* skip 3 ints */ for (i = 0; i < 3; i++) { /* go to start of num */ while (!isdigit(*p)) p++; /* skip int */ while (isdigit(*p)) p++; } /* whitespace must exist after status code */ if (*p != ' ' && *p != '\t') return PARSE_FAILURE; /* skip whitespace */ while (*p == ' ' || *p == '\t') p++; /* now, p is at start of status msg */ n = line.length - ((size_t)p - (size_t)line.buf); if (membuffer_assign(&hmsg->status_msg, p, n) != 0) { /* out of mem */ parser->http_error_code = HTTP_INTERNAL_SERVER_ERROR; return PARSE_FAILURE; } parser->position = POS_HEADERS; /* move to headers */ return PARSE_OK; } /************************************************************************ * Function: parser_parse_headers * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser object * * Description: Read HTTP header fields. * * Returns: * PARSE_OK * PARSE_SUCCESS * PARSE_FAILURE * PARSE_INCOMPLETE * PARSE_NO_MATCH ************************************************************************/ parse_status_t parser_parse_headers(INOUT http_parser_t *parser) { parse_status_t status; memptr token; memptr hdr_value; token_type_t tok_type; scanner_t *scanner = &parser->scanner; size_t save_pos; http_header_t *header; int header_id; int ret = 0; int index; http_header_t *orig_header; char save_char; int ret2; assert(parser->position == (parser_pos_t)POS_HEADERS || parser->ent_position == ENTREAD_CHUNKY_HEADERS); while (TRUE) { save_pos = scanner->cursor; /* check end of headers */ status = scanner_get_token(scanner, &token, &tok_type); if (status != (parse_status_t)PARSE_OK) { /* pushback tokens; useful only on INCOMPLETE error */ scanner->cursor = save_pos; return status; } switch (tok_type) { case TT_CRLF: /* end of headers */ if ((parser->msg.is_request) && (parser->msg.method == (http_method_t)HTTPMETHOD_POST)) { parser->position = POS_COMPLETE; /*post entity parsing */ /*is handled separately */ return PARSE_SUCCESS; } parser->position = POS_ENTITY; /* read entity next */ return PARSE_OK; case TT_IDENTIFIER: /* not end; read header */ break; default: return PARSE_FAILURE; /* didn't see header name */ } status = match(scanner, " : %R%c", &hdr_value); if (status != (parse_status_t)PARSE_OK) { /* pushback tokens; useful only on INCOMPLETE error */ scanner->cursor = save_pos; return status; } /* add header */ /* find header */ index = map_str_to_int(token.buf, token.length, Http_Header_Names, NUM_HTTP_HEADER_NAMES, FALSE); if (index != -1) { /*Check if it is a soap header */ if (Http_Header_Names[index].id == HDR_SOAPACTION) { parser->msg.method = SOAPMETHOD_POST; } header_id = Http_Header_Names[index].id; orig_header = httpmsg_find_hdr(&parser->msg, header_id, NULL); } else { header_id = HDR_UNKNOWN; save_char = token.buf[token.length]; token.buf[token.length] = '\0'; orig_header = httpmsg_find_hdr_str(&parser->msg, token.buf); token.buf[token.length] = save_char; /* restore */ } if (orig_header == NULL) { /* add new header */ header = (http_header_t *) malloc(sizeof(http_header_t)); if (header == NULL) { parser->http_error_code = HTTP_INTERNAL_SERVER_ERROR; return PARSE_FAILURE; } membuffer_init(&header->name_buf); membuffer_init(&header->value); /* value can be 0 length */ if (hdr_value.length == (size_t)0) { /* FIXME: Is this a bug? buf is not const. */ hdr_value.buf = "\0"; hdr_value.length = (size_t)1; } /* save in header in buffers */ if (membuffer_assign(&header->name_buf, token.buf, token.length) || membuffer_assign(&header->value, hdr_value.buf, hdr_value.length)) { /* not enough mem */ membuffer_destroy(&header->value); membuffer_destroy(&header->name_buf); free(header); parser->http_error_code = HTTP_INTERNAL_SERVER_ERROR; return PARSE_FAILURE; } header->name.buf = header->name_buf.buf; header->name.length = header->name_buf.length; header->name_id = header_id; if (!ListAddTail(&parser->msg.headers, header)) { membuffer_destroy(&header->value); membuffer_destroy(&header->name_buf); free(header); parser->http_error_code = HTTP_INTERNAL_SERVER_ERROR; return PARSE_FAILURE; } } else if (hdr_value.length > (size_t)0) { /* append value to existing header */ /* append space */ ret = membuffer_append_str(&orig_header->value, ", "); /* append continuation of header value */ ret2 = membuffer_append(&orig_header->value, hdr_value.buf, hdr_value.length); if (ret == UPNP_E_OUTOF_MEMORY || ret2 == UPNP_E_OUTOF_MEMORY) { /* not enuf mem */ parser->http_error_code = HTTP_INTERNAL_SERVER_ERROR; return PARSE_FAILURE; } } } /* end while */ } /************************************************************************ * Function: parser_parse_entity_using_clen * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser object * * Description: reads entity using content-length * * Returns: * PARSE_INCOMPLETE * PARSE_SUCCESS ************************************************************************/ static UPNP_INLINE parse_status_t parser_parse_entity_using_clen( INOUT http_parser_t * parser ) { /*int entity_length; */ assert( parser->ent_position == ENTREAD_USING_CLEN ); /* determine entity (i.e. body) length so far */ parser->msg.entity.length = parser->msg.msg.length - parser->entity_start_position + parser->msg.amount_discarded; if( parser->msg.entity.length < parser->content_length ) { /* more data to be read */ return PARSE_INCOMPLETE; } else { if( parser->msg.entity.length > parser->content_length ) { /* silently discard extra data */ parser->msg.msg.buf[parser->entity_start_position + parser->content_length - parser->msg.amount_discarded] = '\0'; } /* save entity length */ parser->msg.entity.length = parser->content_length; /* save entity start ptr; (the very last thing to do) */ parser->msg.entity.buf = parser->msg.msg.buf + parser->entity_start_position; /* done reading entity */ parser->position = POS_COMPLETE; return PARSE_SUCCESS; } } /************************************************************************ * Function: parser_parse_chunky_body * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser object * * Description: Read data in the chunks * * Returns: * PARSE_CONTINUE_1 * PARSE_INCOMPLETE * PARSE_FAILURE * PARSE_NO_MATCH ************************************************************************/ static UPNP_INLINE parse_status_t parser_parse_chunky_body( INOUT http_parser_t *parser) { parse_status_t status; size_t save_pos; /* if 'chunk_size' of bytes have been read; read next chunk */ if ((parser->msg.msg.length - parser->scanner.cursor) >= parser->chunk_size) { /* move to next chunk */ parser->scanner.cursor += parser->chunk_size; save_pos = parser->scanner.cursor; /* discard CRLF */ status = match(&parser->scanner, "%c"); if (status != (parse_status_t)PARSE_OK) { /*move back */ parser->scanner.cursor -= parser->chunk_size; /*parser->scanner.cursor = save_pos; */ return status; } membuffer_delete(&parser->msg.msg, save_pos, (parser->scanner.cursor - save_pos)); parser->scanner.cursor = save_pos; /*update temp */ parser->msg.entity.length += parser->chunk_size; parser->ent_position = ENTREAD_USING_CHUNKED; return PARSE_CONTINUE_1; } else /* need more data for chunk */ return PARSE_INCOMPLETE; } /************************************************************************ * Function: parser_parse_chunky_headers * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser object * * Description: Read headers at the end of the chunked entity * * Returns: * PARSE_NO_MATCH * PARSE_INCOMPLETE * PARSE_FAILURE * PARSE_SUCCESS ************************************************************************/ static UPNP_INLINE parse_status_t parser_parse_chunky_headers( INOUT http_parser_t * parser ) { parse_status_t status; size_t save_pos; save_pos = parser->scanner.cursor; status = parser_parse_headers( parser ); if( status == ( parse_status_t ) PARSE_OK ) { /* finally, done with the whole msg */ parser->position = POS_COMPLETE; membuffer_delete( &parser->msg.msg, save_pos, ( parser->scanner.cursor - save_pos ) ); parser->scanner.cursor = save_pos; /* save entity start ptr as the very last thing to do */ parser->msg.entity.buf = parser->msg.msg.buf + parser->entity_start_position; return PARSE_SUCCESS; } else { return status; } } /************************************************************************ * Function: parser_parse_chunky_entity * * Parameters: * INOUT http_parser_t* parser - HTTP Parser Object * * Description: Read entity using chunked transfer encoding * * Returns: * PARSE_INCOMPLETE * PARSE_FAILURE * PARSE_NO_MATCH * PARSE_CONTINUE_1 ************************************************************************/ static UPNP_INLINE parse_status_t parser_parse_chunky_entity( INOUT http_parser_t * parser ) { scanner_t *scanner = &parser->scanner; parse_status_t status; size_t save_pos; memptr dummy; assert( parser->ent_position == ENTREAD_USING_CHUNKED ); save_pos = scanner->cursor; /* get size of chunk, discard extension, discard CRLF */ status = match( scanner, "%x%L%c", &parser->chunk_size, &dummy ); if( status != ( parse_status_t ) PARSE_OK ) { scanner->cursor = save_pos; UpnpPrintf( UPNP_INFO, HTTP, __FILE__, __LINE__, "CHUNK COULD NOT BE PARSED\n" ); return status; } /* remove chunk info just matched; just retain data */ membuffer_delete( &parser->msg.msg, save_pos, ( scanner->cursor - save_pos ) ); scanner->cursor = save_pos; /* adjust scanner too */ if( parser->chunk_size == (size_t)0 ) { /* done reading entity; determine length of entity */ parser->msg.entity.length = parser->scanner.cursor - parser->entity_start_position + parser->msg.amount_discarded; /* read entity headers */ parser->ent_position = ENTREAD_CHUNKY_HEADERS; } else { /* read chunk body */ parser->ent_position = ENTREAD_CHUNKY_BODY; } return PARSE_CONTINUE_1; /* continue to reading body */ } /************************************************************************ * Function: parser_parse_entity_until_close * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser object * * Description: Keep reading entity until the connection is closed. * * Returns: * PARSE_INCOMPLETE_ENTITY ************************************************************************/ static UPNP_INLINE parse_status_t parser_parse_entity_until_close( INOUT http_parser_t * parser ) { size_t cursor; assert( parser->ent_position == ENTREAD_UNTIL_CLOSE ); /* eat any and all data */ cursor = parser->msg.msg.length; /* update entity length */ parser->msg.entity.length = cursor - parser->entity_start_position + parser->msg.amount_discarded; /* update pointer */ parser->msg.entity.buf = parser->msg.msg.buf + parser->entity_start_position; parser->scanner.cursor = cursor; return PARSE_INCOMPLETE_ENTITY; /* add anything */ } /************************************************************************ * Function: parser_get_entity_read_method * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser object * * Description: Determines method to read entity * * Returns: * PARSE_CONTINUE_1 * PARSE_FAILURE * PARSE_SUCCESS -- no more reading to do ************************************************************************/ UPNP_INLINE parse_status_t parser_get_entity_read_method( INOUT http_parser_t * parser ) { http_message_t *hmsg = &parser->msg; int response_code; memptr hdr_value; assert( parser->ent_position == ENTREAD_DETERMINE_READ_METHOD ); /* entity points to start of msg body */ parser->msg.entity.buf = scanner_get_str( &parser->scanner ); parser->msg.entity.length = ( size_t ) 0; /* remember start of body */ parser->entity_start_position = parser->scanner.cursor; /* std http rules for determining content length */ /* * no body for 1xx, 204, 304 and HEAD, GET, */ /* SUBSCRIBE, UNSUBSCRIBE */ if( hmsg->is_request ) { switch ( hmsg->method ) { case HTTPMETHOD_HEAD: case HTTPMETHOD_GET: /*case HTTPMETHOD_POST: */ case HTTPMETHOD_SUBSCRIBE: case HTTPMETHOD_UNSUBSCRIBE: case HTTPMETHOD_MSEARCH: /* no body; mark as done */ parser->position = POS_COMPLETE; return PARSE_SUCCESS; break; default: ; /* do nothing */ } } else /* response */ { response_code = hmsg->status_code; if( response_code == 204 || response_code == 304 || ( response_code >= 100 && response_code <= 199 ) || hmsg->request_method == ( http_method_t ) HTTPMETHOD_HEAD || hmsg->request_method == ( http_method_t ) HTTPMETHOD_MSEARCH || hmsg->request_method == ( http_method_t ) HTTPMETHOD_SUBSCRIBE || hmsg->request_method == ( http_method_t ) HTTPMETHOD_UNSUBSCRIBE || hmsg->request_method == ( http_method_t ) HTTPMETHOD_NOTIFY ) { parser->position = POS_COMPLETE; return PARSE_SUCCESS; } } /* * transfer-encoding -- used to indicate chunked data */ if( httpmsg_find_hdr( hmsg, HDR_TRANSFER_ENCODING, &hdr_value ) ) { if( raw_find_str( &hdr_value, "chunked" ) >= 0 ) { /* read method to use chunked transfer encoding */ parser->ent_position = ENTREAD_USING_CHUNKED; UpnpPrintf( UPNP_INFO, HTTP, __FILE__, __LINE__, "Found Chunked Encoding ....\n" ); return PARSE_CONTINUE_1; } } /* * use content length */ if( httpmsg_find_hdr( hmsg, HDR_CONTENT_LENGTH, &hdr_value ) ) { parser->content_length = (unsigned int)raw_to_int(&hdr_value, 10); parser->ent_position = ENTREAD_USING_CLEN; return PARSE_CONTINUE_1; } /* * multi-part/byteranges not supported (yet) */ /* * read until connection is closed */ if( hmsg->is_request ) { /* set hack flag for NOTIFY methods; if set to true this is */ /* a valid SSDP notify msg */ if( hmsg->method == ( http_method_t ) HTTPMETHOD_NOTIFY ) { parser->valid_ssdp_notify_hack = TRUE; } parser->http_error_code = HTTP_LENGTH_REQUIRED; return PARSE_FAILURE; } parser->ent_position = ENTREAD_UNTIL_CLOSE; return PARSE_CONTINUE_1; } /************************************************************************ * Function: parser_parse_entity * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser object * * Description: Read HTTP entity body * * Returns: * PARSE_FAILURE * PARSE_NO_MATCH * PARSE_INCOMPLETE * PARSE_INCOMPLETE_ENTITY * PARSE_SUCCESS -- no more reading to do ************************************************************************/ UPNP_INLINE parse_status_t parser_parse_entity( INOUT http_parser_t * parser ) { parse_status_t status; assert( parser->position == POS_ENTITY ); do { switch ( parser->ent_position ) { case ENTREAD_USING_CLEN: status = parser_parse_entity_using_clen( parser ); break; case ENTREAD_USING_CHUNKED: status = parser_parse_chunky_entity( parser ); break; case ENTREAD_CHUNKY_BODY: status = parser_parse_chunky_body( parser ); break; case ENTREAD_CHUNKY_HEADERS: status = parser_parse_chunky_headers( parser ); break; case ENTREAD_UNTIL_CLOSE: status = parser_parse_entity_until_close( parser ); break; case ENTREAD_DETERMINE_READ_METHOD: status = parser_get_entity_read_method( parser ); break; default: status = PARSE_FAILURE; assert( 0 ); } } while( status == ( parse_status_t ) PARSE_CONTINUE_1 ); return status; } /************************************************************************ * Function: parser_request_init * * Parameters: * OUT http_parser_t* parser ; HTTP Parser object * * Description: Initializes parser object for a request * * Returns: * void ************************************************************************/ void parser_request_init( OUT http_parser_t * parser ) { parser_init( parser ); parser->msg.is_request = TRUE; parser->position = POS_REQUEST_LINE; } /************************************************************************ * Function: parser_response_init * * Parameters: * OUT http_parser_t* parser ; HTTP Parser object * IN http_method_t request_method ; Request method * * Description: Initializes parser object for a response * * Returns: * void ************************************************************************/ void parser_response_init( OUT http_parser_t * parser, IN http_method_t request_method ) { parser_init( parser ); parser->msg.is_request = FALSE; parser->msg.request_method = request_method; parser->msg.amount_discarded = (size_t)0; parser->position = POS_RESPONSE_LINE; } /************************************************************************ * Function: parser_parse * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser object * * Description: The parser function. Depending on the position of the * parser object the actual parsing function is invoked * * Returns: * PARSE_SUCCESS * PARSE_FAILURE * PARSE_INCOMPLETE * PARSE_INCOMPLETE_ENTITY * PARSE_NO_MATCH ************************************************************************/ parse_status_t parser_parse( INOUT http_parser_t * parser ) { parse_status_t status; /*takes an http_parser_t with memory already allocated */ /*in the message */ assert( parser != NULL ); do { switch ( parser->position ) { case POS_ENTITY: status = parser_parse_entity( parser ); break; case POS_HEADERS: status = parser_parse_headers( parser ); break; case POS_REQUEST_LINE: status = parser_parse_requestline( parser ); break; case POS_RESPONSE_LINE: status = parser_parse_responseline( parser ); break; default: { status = PARSE_FAILURE; assert( 0 ); } } } while( status == ( parse_status_t ) PARSE_OK ); return status; } /************************************************************************ * Function: parser_append * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser Object * IN const char* buf ; buffer to be appended to the parser * buffer * IN size_t buf_length ; Size of the buffer * * Description: Append date to HTTP parser, and do the parsing. * * Returns: * PARSE_SUCCESS * PARSE_FAILURE * PARSE_INCOMPLETE * PARSE_INCOMPLETE_ENTITY * PARSE_NO_MATCH ************************************************************************/ parse_status_t parser_append( INOUT http_parser_t * parser, IN const char *buf, IN size_t buf_length ) { int ret_code; assert( parser != NULL ); assert( buf != NULL ); /* append data to buffer */ ret_code = membuffer_append( &parser->msg.msg, buf, buf_length ); if( ret_code != 0 ) { /* set failure status */ parser->http_error_code = HTTP_INTERNAL_SERVER_ERROR; return PARSE_FAILURE; } return parser_parse( parser ); } /************************************************************************ * Function: raw_to_int * * Parameters: * IN memptr* raw_value ; Buffer to be converted * IN int base ; Base to use for conversion * * Description: Converts raw character data to long-integer value * * Returns: * int ************************************************************************/ int raw_to_int(IN memptr *raw_value, IN int base) { long num; char *end_ptr; if (raw_value->length == (size_t)0) return -1; errno = 0; num = strtol(raw_value->buf, &end_ptr, base); if ((num < 0) /* all and only those chars in token should be used for num */ || (end_ptr != raw_value->buf + raw_value->length) || ((num == LONG_MIN || num == LONG_MAX) && (errno == ERANGE)) ) { return -1; } return (int)num; } /************************************************************************ * Function: raw_find_str * * Parameters: * IN memptr* raw_value ; Buffer containg the string * IN const char* str ; Substring to be found * * Description: Find a substring from raw character string buffer * * Side effects: raw_value is transformed to lowercase. * * Returns: * int - index at which the substring is found. ************************************************************************/ int raw_find_str(IN memptr *raw_value, IN const char *str) { char c; char *ptr; int i = 0; /* save */ c = raw_value->buf[raw_value->length]; /* Make it lowercase */ for (i = 0; raw_value->buf[i]; ++i) { raw_value->buf[i] = (char)tolower(raw_value->buf[i]); } /* null-terminate */ raw_value->buf[raw_value->length] = 0; /* Find the substring position */ ptr = strstr( raw_value->buf, str ); /* restore the "length" byte */ raw_value->buf[raw_value->length] = c; if( ptr == 0 ) { return -1; } /* return index */ return (int)(ptr - raw_value->buf); } /************************************************************************ * Function: method_to_str * * Parameters: * IN http_method_t method ; HTTP method * * Description: A wrapper function that maps a method id to a method * nameConverts a http_method id stored in the HTTP Method * * Returns: * const char* ptr - Ptr to the HTTP Method ************************************************************************/ const char *method_to_str(IN http_method_t method) { int index; index = map_int_to_str( method, Http_Method_Table, NUM_HTTP_METHODS ); assert( index != -1 ); return index == -1 ? NULL : Http_Method_Table[index].name; } #ifdef DEBUG void print_http_headers(http_message_t *hmsg) { ListNode *node; /* NNS: dlist_node *node; */ http_header_t *header; /* print start line */ if( hmsg->is_request ) { printf( "method = %d, version = %d.%d, url = %.*s\n", hmsg->method, hmsg->major_version, hmsg->minor_version, (int)hmsg->uri.pathquery.size, hmsg->uri.pathquery.buff); } else { printf( "resp status = %d, version = %d.%d, status msg = %.*s\n", hmsg->status_code, hmsg->major_version, hmsg->minor_version, (int)hmsg->status_msg.length, hmsg->status_msg.buf); } /* print headers */ node = ListHead( &hmsg->headers ); /* NNS: node = dlist_first_node( &hmsg->headers ); */ while( node != NULL ) { header = ( http_header_t * ) node->item; /* NNS: header = (http_header_t *)node->data; */ printf( "hdr name: %.*s, value: %.*s\n", (int)header->name.length, header->name.buf, (int)header->value.length, header->value.buf ); node = ListNext( &hmsg->headers, node ); /* NNS: node = dlist_next( &hmsg->headers, node ); */ } } #endif /* DEBUG */ pupnp-release-1.8.0/upnp/src/genlib/net/http/httpreadwrite.c000066400000000000000000001613511303304015100241050ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \file * * Purpose: This file defines the functionality making use of the http. * It defines functions to receive messages, process messages, send messages. */ #include "config.h" #include "httpreadwrite.h" #include "unixutil.h" #include "upnp.h" #include "upnpapi.h" #include "membuffer.h" #include "uri.h" #include "statcodes.h" #include "sock.h" #include "UpnpInet.h" #include "UpnpIntTypes.h" #include "UpnpStdInt.h" #include "webserver.h" #include #include #ifdef WIN32 #include #define fseeko fseek #define snprintf _snprintf #else #include #include #include #include #include #endif /* * Please, do not change these to const int while MSVC cannot understand * const int in array dimensions. */ /* const int CHUNK_HEADER_SIZE = 10; const int CHUNK_TAIL_SIZE = 10; */ #define CHUNK_HEADER_SIZE (size_t)10 #define CHUNK_TAIL_SIZE (size_t)10 #ifndef UPNP_ENABLE_BLOCKING_TCP_CONNECTIONS /* in seconds */ #define DEFAULT_TCP_CONNECT_TIMEOUT 5 /*! * \brief Checks socket connection and wait if it is not connected. * It should be called just after connect. * * \return 0 if successful, else -1. */ static int Check_Connect_And_Wait_Connection( /*! [in] socket. */ SOCKET sock, /*! [in] result of connect. */ int connect_res) { struct timeval tmvTimeout = {DEFAULT_TCP_CONNECT_TIMEOUT, 0}; int result; #ifdef WIN32 struct fd_set fdSet; #else fd_set fdSet; #endif FD_ZERO(&fdSet); FD_SET(sock, &fdSet); if (connect_res < 0) { #ifdef WIN32 if (WSAEWOULDBLOCK == WSAGetLastError() ) { #else if (EINPROGRESS == errno ) { #endif result = select(sock + 1, NULL, &fdSet, NULL, &tmvTimeout); if (result < 0) { #ifdef WIN32 /* WSAGetLastError(); */ #else /* errno */ #endif return -1; } else if (result == 0) { /* timeout */ return -1; #ifndef WIN32 } else { int valopt = 0; socklen_t len = sizeof(valopt); if (getsockopt(sock, SOL_SOCKET, SO_ERROR, (void *) &valopt, &len) < 0) { /* failed to read delayed error */ return -1; } else if (valopt) { /* delayed error = valopt */ return -1; } #endif } } } return 0; } #endif /* UPNP_ENABLE_BLOCKING_TCP_CONNECTIONS */ static int private_connect( SOCKET sockfd, const struct sockaddr *serv_addr, socklen_t addrlen) { #ifndef UPNP_ENABLE_BLOCKING_TCP_CONNECTIONS int ret = sock_make_no_blocking(sockfd); if (ret != - 1) { ret = connect(sockfd, serv_addr, addrlen); ret = Check_Connect_And_Wait_Connection(sockfd, ret); if (ret != - 1) { ret = sock_make_blocking(sockfd); } } return ret; #else return connect(sockfd, serv_addr, addrlen); #endif /* UPNP_ENABLE_BLOCKING_TCP_CONNECTIONS */ } #ifdef WIN32 struct tm *http_gmtime_r(const time_t *clock, struct tm *result) { if (clock == NULL || *clock < 0 || result == NULL) return NULL; /* gmtime in VC runtime is thread safe. */ *result = *gmtime(clock); return result; } #endif static int get_hoststr(const char* url_str, char **hoststr, size_t *hostlen) { char *urlPath = alloca(strlen(url_str) + 1); char *temp; memset(urlPath, 0, strlen(url_str) + 1); strncpy(urlPath, url_str, strlen(url_str)); *hoststr = strstr(urlPath, "//"); if (*hoststr == NULL) return UPNP_E_INVALID_URL; *hoststr += 2; temp = strchr(*hoststr, '/'); if (temp == NULL) return UPNP_E_INVALID_URL; *temp = '\0'; *hostlen = strlen(*hoststr); *temp = '/'; return UPNP_E_SUCCESS; } static void copy_msg_headers(IN LinkedList *msgHeaders, OUT UpnpString *headers) { return; /* TODO: */ #if 0 ListNode *node; UpnpHttpHeader *header; http_header_t *msgHeader; if (headers) { ListInit(headers, NULL, (free_function) UpnpHttpHeader_delete); node = ListHead(msgHeaders); while(node) { msgHeader = (http_header_t*) node->item; header = UpnpHttpHeader_new(); UpnpHttpHeader_strncpy_Name( header, msgHeader->name.buf, msgHeader->name.length); UpnpHttpHeader_strncpy_Value( header, msgHeader->value.buf, msgHeader->value.length); node = ListNext(msgHeaders, node); } } #endif } int http_FixUrl(IN uri_type *url, OUT uri_type *fixed_url) { const char *temp_path = "/"; *fixed_url = *url; #ifdef UPNP_ENABLE_OPEN_SSL if (token_string_casecmp(&fixed_url->scheme, "http") != 0 && token_string_casecmp(&fixed_url->scheme, "https") != 0) { return UPNP_E_INVALID_URL; } #else if (token_string_casecmp(&fixed_url->scheme, "http") != 0) { return UPNP_E_INVALID_URL; } #endif if( fixed_url->hostport.text.size == ( size_t ) 0 ) { return UPNP_E_INVALID_URL; } /* set pathquery to "/" if it is empty */ if (fixed_url->pathquery.size == (size_t)0) { fixed_url->pathquery.buff = temp_path; fixed_url->pathquery.size = (size_t)1; } return UPNP_E_SUCCESS; } int http_FixStrUrl( IN const char *urlstr, IN size_t urlstrlen, OUT uri_type *fixed_url) { uri_type url; if (parse_uri(urlstr, urlstrlen, &url) != HTTP_SUCCESS) { return UPNP_E_INVALID_URL; } return http_FixUrl(&url, fixed_url); } /************************************************************************ * Function: http_Connect * * Parameters: * IN uri_type* destination_url; URL containing destination information * OUT uri_type *url; Fixed and corrected URL * * Description: * Gets destination address from URL and then connects to the remote end * * Returns: * socket descriptor on success * UPNP_E_OUTOF_SOCKET * UPNP_E_SOCKET_CONNECT on error ************************************************************************/ SOCKET http_Connect( IN uri_type *destination_url, OUT uri_type *url) { SOCKET connfd; socklen_t sockaddr_len; int ret_connect; char errorBuffer[ERROR_BUFFER_LEN]; http_FixUrl(destination_url, url); connfd = socket((int)url->hostport.IPaddress.ss_family, SOCK_STREAM, 0); if (connfd == INVALID_SOCKET) { return (SOCKET)(UPNP_E_OUTOF_SOCKET); } sockaddr_len = (socklen_t)(url->hostport.IPaddress.ss_family == AF_INET6 ? sizeof(struct sockaddr_in6) : sizeof(struct sockaddr_in)); ret_connect = private_connect(connfd, (struct sockaddr *)&url->hostport.IPaddress, sockaddr_len); if (ret_connect == -1) { #ifdef WIN32 UpnpPrintf(UPNP_CRITICAL, HTTP, __FILE__, __LINE__, "connect error: %d\n", WSAGetLastError()); #endif if (shutdown(connfd, SD_BOTH) == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "Error in shutdown: %s\n", errorBuffer); } UpnpCloseSocket(connfd); return (SOCKET)(UPNP_E_SOCKET_CONNECT); } return connfd; } /*! * \brief Get the data on the socket and take actions based on the read data to * modify the parser objects buffer. * * If an error is reported while parsing the data, the error code is passed in * the http_errr_code parameter. * * Parameters: * IN SOCKINFO *info; Socket information object * OUT http_parser_t* parser; HTTP parser object * IN http_method_t request_method; HTTP request method * IN OUT int* timeout_secs; time out * OUT int* http_error_code; HTTP error code returned * * \return * UPNP_E_SUCCESS * UPNP_E_BAD_HTTPMSG */ int http_RecvMessage( IN SOCKINFO *info, OUT http_parser_t *parser, IN http_method_t request_method, IN OUT int *timeout_secs, OUT int *http_error_code) { int ret = UPNP_E_SUCCESS; int line = 0; parse_status_t status; int num_read; int ok_on_close = FALSE; char buf[2 * 1024]; if (request_method == (http_method_t)HTTPMETHOD_UNKNOWN) { parser_request_init(parser); } else { parser_response_init(parser, request_method); } while (TRUE) { num_read = sock_read(info, buf, sizeof buf, timeout_secs); if (num_read > 0) { /* got data */ status = parser_append(parser, buf, (size_t)num_read); switch (status) { case PARSE_SUCCESS: UpnpPrintf( UPNP_INFO, HTTP, __FILE__, __LINE__, "<<< (RECVD) <<<\n%s\n-----------------\n", parser->msg.msg.buf ); print_http_headers( &parser->msg ); if (g_maxContentLength > (size_t)0 && parser->content_length > (unsigned int)g_maxContentLength) { *http_error_code = HTTP_REQ_ENTITY_TOO_LARGE; line = __LINE__; ret = UPNP_E_OUTOF_BOUNDS; goto ExitFunction; } line = __LINE__; ret = 0; goto ExitFunction; case PARSE_FAILURE: case PARSE_NO_MATCH: *http_error_code = parser->http_error_code; line = __LINE__; ret = UPNP_E_BAD_HTTPMSG; goto ExitFunction; case PARSE_INCOMPLETE_ENTITY: /* read until close */ ok_on_close = TRUE; break; case PARSE_CONTINUE_1: /* Web post request. */ line = __LINE__; ret = PARSE_SUCCESS; goto ExitFunction; default: break; } } else if (num_read == 0) { if (ok_on_close) { UpnpPrintf( UPNP_INFO, HTTP, __FILE__, __LINE__, "<<< (RECVD) <<<\n%s\n-----------------\n", parser->msg.msg.buf ); print_http_headers(&parser->msg); line = __LINE__; ret = 0; goto ExitFunction; } else { /* partial msg */ *http_error_code = HTTP_BAD_REQUEST; /* or response */ line = __LINE__; ret = UPNP_E_BAD_HTTPMSG; goto ExitFunction; } } else { *http_error_code = parser->http_error_code; line = __LINE__; ret = num_read; goto ExitFunction; } } ExitFunction: if (ret != UPNP_E_SUCCESS) { UpnpPrintf(UPNP_ALL, HTTP, __FILE__, line, "(http_RecvMessage): Error %d, http_error_code = %d.\n", ret, *http_error_code); } return ret; } int http_SendMessage(SOCKINFO *info, int *TimeOut, const char *fmt, ...) { #if EXCLUDE_WEB_SERVER == 0 FILE *Fp; struct SendInstruction *Instr = NULL; char *filename = NULL; char *file_buf = NULL; char *ChunkBuf = NULL; /* 10 byte allocated for chunk header. */ char Chunk_Header[CHUNK_HEADER_SIZE]; size_t num_read; size_t amount_to_be_read = (size_t)0; size_t Data_Buf_Size = WEB_SERVER_BUF_SIZE; #endif /* EXCLUDE_WEB_SERVER */ va_list argp; char *buf = NULL; char c; int nw; int RetVal = 0; size_t buf_length; size_t num_written; #if EXCLUDE_WEB_SERVER == 0 memset(Chunk_Header, 0, sizeof(Chunk_Header)); #endif /* EXCLUDE_WEB_SERVER */ va_start(argp, fmt); while ((c = *fmt++)) { #if EXCLUDE_WEB_SERVER == 0 if (c == 'I') { Instr = va_arg(argp, struct SendInstruction *); if (Instr->ReadSendSize >= 0) amount_to_be_read = (size_t)Instr->ReadSendSize; else amount_to_be_read = Data_Buf_Size; if (amount_to_be_read < WEB_SERVER_BUF_SIZE) Data_Buf_Size = amount_to_be_read; ChunkBuf = malloc((size_t) (Data_Buf_Size + CHUNK_HEADER_SIZE + CHUNK_TAIL_SIZE)); if (!ChunkBuf) { RetVal = UPNP_E_OUTOF_MEMORY; goto ExitFunction; } file_buf = ChunkBuf + CHUNK_HEADER_SIZE; } else if (c == 'f') { /* file name */ filename = va_arg(argp, char *); if (Instr && Instr->IsVirtualFile) Fp = (virtualDirCallback.open)(filename, UPNP_READ); else Fp = fopen(filename, "rb"); if (Fp == NULL) { RetVal = UPNP_E_FILE_READ_ERROR; goto ExitFunction; } if (Instr && Instr->IsRangeActive && Instr->IsVirtualFile) { if (virtualDirCallback.seek(Fp, Instr->RangeOffset, SEEK_CUR) != 0) { RetVal = UPNP_E_FILE_READ_ERROR; goto Cleanup_File; } } else if (Instr && Instr->IsRangeActive) { if (fseeko(Fp, Instr->RangeOffset, SEEK_CUR) != 0) { RetVal = UPNP_E_FILE_READ_ERROR; goto Cleanup_File; } } while (amount_to_be_read) { if (Instr) { int nr; size_t n = amount_to_be_read >= Data_Buf_Size ? Data_Buf_Size : amount_to_be_read; if (Instr->IsVirtualFile) { nr = virtualDirCallback.read(Fp, file_buf, n); num_read = (size_t)nr; } else { num_read = fread(file_buf, (size_t)1, n, Fp); } amount_to_be_read -= num_read; if (Instr->ReadSendSize < 0) { /* read until close */ amount_to_be_read = Data_Buf_Size; } } else { num_read = fread(file_buf, (size_t)1, Data_Buf_Size, Fp); } if (num_read == (size_t)0) { /* EOF so no more to send. */ if (Instr && Instr->IsChunkActive) { const char *str = "0\r\n\r\n"; nw = sock_write(info, str, strlen(str), TimeOut); } else { RetVal = UPNP_E_FILE_READ_ERROR; } goto Cleanup_File; } /* Create chunk for the current buffer. */ if (Instr && Instr->IsChunkActive) { int rc; /* Copy CRLF at the end of the chunk */ memcpy(file_buf + num_read, "\r\n", (size_t)2); /* Hex length for the chunk size. */ memset(Chunk_Header, 0, sizeof(Chunk_Header)); rc = snprintf(Chunk_Header, sizeof(Chunk_Header), "%" PRIzx "\r\n", num_read); if (rc < 0 || (unsigned int) rc >= sizeof(Chunk_Header)) { RetVal = UPNP_E_INTERNAL_ERROR; goto Cleanup_File; } /* Copy the chunk size header */ memcpy(file_buf - strlen(Chunk_Header), Chunk_Header, strlen(Chunk_Header)); /* on the top of the buffer. */ /*file_buf[num_read+strlen(Chunk_Header)] = NULL; */ /*printf("Sending %s\n",file_buf-strlen(Chunk_Header)); */ nw = sock_write(info, file_buf - strlen(Chunk_Header), num_read + strlen(Chunk_Header) + (size_t)2, TimeOut); num_written = (size_t)nw; if (nw <= 0 || num_written != num_read + strlen(Chunk_Header) + (size_t)2) /* Send error nothing we can do. */ goto Cleanup_File; } else { /* write data */ nw = sock_write(info, file_buf, num_read, TimeOut); UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, ">>> (SENT) >>>\n%.*s\n------------\n", nw, file_buf); /* Send error nothing we can do */ num_written = (size_t)nw; if (nw <= 0 || num_written != num_read) { goto Cleanup_File; } } } /* while */ Cleanup_File: if (Instr && Instr->IsVirtualFile) { virtualDirCallback.close(Fp); } else { fclose(Fp); } goto ExitFunction; } else #endif /* EXCLUDE_WEB_SERVER */ if (c == 'b') { /* memory buffer */ buf = va_arg(argp, char *); buf_length = va_arg(argp, size_t); if (buf_length > (size_t)0) { nw = sock_write(info, buf, buf_length, TimeOut); num_written = (size_t)nw; UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, ">>> (SENT) >>>\n" "%.*s\nbuf_length=%" PRIzd ", num_written=%" PRIzd "\n" "------------\n", (int)buf_length, buf, buf_length, num_written); if (num_written != buf_length) { RetVal = 0; goto ExitFunction; } } } } ExitFunction: va_end(argp); #if EXCLUDE_WEB_SERVER == 0 free(ChunkBuf); #endif /* EXCLUDE_WEB_SERVER */ return RetVal; } /************************************************************************ * Function: http_RequestAndResponse * * Parameters: * IN uri_type* destination; Destination URI object which contains * remote IP address among other elements * IN const char* request; Request to be sent * IN size_t request_length; Length of the request * IN http_method_t req_method; HTTP Request method * IN int timeout_secs; time out value * OUT http_parser_t* response; Parser object to receive the repsonse * * Description: * Initiates socket, connects to the destination, sends a * request and waits for the response from the remote end * * Returns: * UPNP_E_SOCKET_ERROR * UPNP_E_SOCKET_CONNECT * Error Codes returned by http_SendMessage * Error Codes returned by http_RecvMessage ************************************************************************/ int http_RequestAndResponse( IN uri_type *destination, IN const char *request, IN size_t request_length, IN http_method_t req_method, IN int timeout_secs, OUT http_parser_t *response) { SOCKET tcp_connection; int ret_code; size_t sockaddr_len; int http_error_code; SOCKINFO info; tcp_connection = socket( (int)destination->hostport.IPaddress.ss_family, SOCK_STREAM, 0); if (tcp_connection == INVALID_SOCKET) { parser_response_init(response, req_method); return UPNP_E_SOCKET_ERROR; } if (sock_init(&info, tcp_connection) != UPNP_E_SUCCESS) { parser_response_init(response, req_method); ret_code = UPNP_E_SOCKET_ERROR; goto end_function; } /* connect */ sockaddr_len = destination->hostport.IPaddress.ss_family == AF_INET6 ? sizeof(struct sockaddr_in6) : sizeof(struct sockaddr_in); ret_code = private_connect(info.socket, (struct sockaddr *)&(destination->hostport.IPaddress), (socklen_t)sockaddr_len); if (ret_code == -1) { parser_response_init(response, req_method); ret_code = UPNP_E_SOCKET_CONNECT; goto end_function; } /* send request */ ret_code = http_SendMessage(&info, &timeout_secs, "b", request, request_length); if (ret_code != 0) { parser_response_init(response, req_method); goto end_function; } /* recv response */ ret_code = http_RecvMessage(&info, response, req_method, &timeout_secs, &http_error_code); end_function: /* should shutdown completely */ sock_destroy(&info, SD_BOTH); return ret_code; } /************************************************************************ * Function: http_Download * * Parameters: * IN const char* url_str; String as a URL * IN int timeout_secs; time out value * OUT char** document; buffer to store the document extracted * from the donloaded message. * OUT int* doc_length; length of the extracted document * OUT char* content_type; Type of content * * Description: * Download the document message and extract the document * from the message. * * Return: int * UPNP_E_SUCCESS * UPNP_E_INVALID_URL ************************************************************************/ int http_Download( IN const char *url_str, IN int timeout_secs, OUT char **document, OUT size_t *doc_length, OUT char *content_type ) { int ret_code; uri_type url; char *msg_start; char *entity_start; char *hoststr; char *temp; http_parser_t response; size_t msg_length; size_t hostlen; memptr ctype; size_t copy_len; membuffer request; char *urlPath = alloca(strlen(url_str) + (size_t)1); /*ret_code = parse_uri( (char*)url_str, strlen(url_str), &url ); */ UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "DOWNLOAD URL : %s\n", url_str); ret_code = http_FixStrUrl((char *)url_str, strlen(url_str), &url); if (ret_code != UPNP_E_SUCCESS) return ret_code; /* make msg */ membuffer_init(&request); memset(urlPath, 0, strlen(url_str) + (size_t)1); strncpy(urlPath, url_str, strlen(url_str)); hoststr = strstr(urlPath, "//"); if (hoststr == NULL) return UPNP_E_INVALID_URL; hoststr += 2; temp = strchr(hoststr, '/'); if (temp) { *temp = '\0'; hostlen = strlen(hoststr); *temp = '/'; } else { hostlen = strlen(hoststr); } UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "HOSTNAME : %s Length : %" PRIzu "\n", hoststr, hostlen); ret_code = http_MakeMessage(&request, 1, 1, "Q" "s" "bcDCUc", HTTPMETHOD_GET, url.pathquery.buff, url.pathquery.size, "HOST: ", hoststr, hostlen); if (ret_code != 0) { UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "HTTP Makemessage failed\n"); membuffer_destroy(&request); return ret_code; } UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "HTTP Buffer:\n%s\n" "----------END--------\n", request.buf); /* get doc msg */ ret_code = http_RequestAndResponse(&url, request.buf, request.length, HTTPMETHOD_GET, timeout_secs, &response); if (ret_code != 0) { httpmsg_destroy(&response.msg); membuffer_destroy(&request); return ret_code; } UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "Response\n"); print_http_headers(&response.msg); /* optional content-type */ if (content_type) { if (httpmsg_find_hdr(&response.msg, HDR_CONTENT_TYPE, &ctype) == NULL) { *content_type = '\0'; /* no content-type */ } else { /* safety */ copy_len = ctype.length < LINE_SIZE - (size_t)1 ? ctype.length : LINE_SIZE - (size_t)1; memcpy(content_type, ctype.buf, copy_len); content_type[copy_len] = '\0'; } } /* extract doc from msg */ if ((*doc_length = response.msg.entity.length) == (size_t)0) { /* 0-length msg */ *document = NULL; } else if (response.msg.status_code == HTTP_OK) { /*LEAK_FIX_MK */ /* copy entity */ entity_start = response.msg.entity.buf; /* what we want */ msg_length = response.msg.msg.length; /* save for posterity */ msg_start = membuffer_detach(&response.msg.msg); /* whole msg */ /* move entity to the start; copy null-terminator too */ memmove(msg_start, entity_start, *doc_length + (size_t)1); /* save mem for body only */ *document = realloc(msg_start, *doc_length + (size_t)1); /*LEAK_FIX_MK */ /* *document = Realloc( msg_start,msg_length, *doc_length + 1 ); LEAK_FIX_MK */ /* shrink can't fail */ assert(msg_length > *doc_length); assert(*document != NULL); if (msg_length <= *doc_length || *document == NULL) UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "msg_length(%" PRIzu ") <= *doc_length(%" PRIzu ") or document is NULL", msg_length, *doc_length); } if (response.msg.status_code == HTTP_OK) { ret_code = 0; /* success */ } else { /* server sent error msg (not requested doc) */ ret_code = response.msg.status_code; } httpmsg_destroy(&response.msg); membuffer_destroy(&request); return ret_code; } /************************************************************************ * Function: MakeGenericMessage * * Parameters: * http_method_t method; The type of HTTP method. * const char *url_str; String as a URL * membuffer *request; Buffer containing the request * uri_type *url; URI object containing the scheme, * path query token, etc. * int contentLength; length of content * const char *contentType; Type of content * * Description: * Makes the message for the HTTP POST message * * Returns: * UPNP_E_INVALID_URL * UPNP_E_INVALID_PARAM * UPNP_E_SUCCESS ************************************************************************/ int MakeGenericMessage(http_method_t method, const char *url_str, membuffer *request, uri_type *url, int contentLength, const char *contentType, const UpnpString *headers) { int ret_code = 0; size_t hostlen = (size_t)0; char *hoststr; UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "URL: %s method: %d\n", url_str, method); ret_code = http_FixStrUrl(url_str, strlen(url_str), url); if (ret_code != UPNP_E_SUCCESS) return ret_code; /* make msg */ membuffer_init(request); ret_code = http_MakeMessage(request, 1, 1, "Q", method, url->pathquery.buff, url->pathquery.size); /* add request headers if specified, otherwise use default headers */ if (ret_code == 0) { if (headers) { ret_code = http_MakeMessage(request, 1, 1, "s", UpnpString_get_String(headers)); } else { ret_code = get_hoststr(url_str, &hoststr, &hostlen); if (ret_code != UPNP_E_SUCCESS) return ret_code; UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "HOSTNAME : %s Length : %" PRIzu "\n", hoststr, hostlen); ret_code = http_MakeMessage(request, 1, 1, "s" "bcDCU", "HOST: ", hoststr, hostlen); } } /* add the content-type header */ if (ret_code == 0 && contentType) { ret_code = http_MakeMessage(request, 1, 1, "T", contentType); } /* add content-length header. */ if (ret_code == 0) { if (contentLength >= 0) ret_code = http_MakeMessage(request, 1, 1, "Nc", (off_t) contentLength); else if (contentLength == UPNP_USING_CHUNKED) ret_code = http_MakeMessage(request, 1, 1, "Kc"); else if (contentLength == UPNP_UNTIL_CLOSE) ret_code = http_MakeMessage(request, 1, 1, "c"); else ret_code = UPNP_E_INVALID_PARAM; } if (ret_code != 0) { UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "HTTP Makemessage failed\n"); membuffer_destroy(request); return ret_code; } UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "HTTP Buffer:\n%s\n" "----------END--------\n", request->buf); return UPNP_E_SUCCESS; } typedef struct HTTPCONNECTIONHANDLE { SOCKINFO sock_info; int contentLength; http_parser_t response; int requestStarted; int cancel; } http_connection_handle_t; /*! * \brief Parses already exiting data. If not complete reads more * data on the connected socket. The read data is then parsed. The * same methid is carried out for headers. * * \return integer: * \li \c PARSE_OK - On Success * \li \c PARSE_FAILURE - Failure to parse data correctly * \li \c UPNP_E_BAD_HTTPMSG - Socker read() returns an error */ static int ReadResponseLineAndHeaders( /*! Socket information object. */ IN SOCKINFO *info, /*! HTTP Parser object. */ IN OUT http_parser_t *parser, /*! Time out value. */ IN OUT int *timeout_secs, /*! HTTP errror code returned. */ IN OUT int *http_error_code) { parse_status_t status; int num_read; char buf[2 * 1024]; int done = 0; int ret_code = 0; /*read response line */ status = parser_parse_responseline(parser); switch (status) { case PARSE_OK: done = 1; break; case PARSE_INCOMPLETE: done = 0; break; default: /*error */ return status; } while (!done) { num_read = sock_read(info, buf, sizeof(buf), timeout_secs); if (num_read > 0) { /* append data to buffer */ ret_code = membuffer_append(&parser->msg.msg, buf, (size_t)num_read); if (ret_code != 0) { /* set failure status */ parser->http_error_code = HTTP_INTERNAL_SERVER_ERROR; return PARSE_FAILURE; } status = parser_parse_responseline(parser); switch (status) { case PARSE_OK: done = 1; break; case PARSE_INCOMPLETE: done = 0; break; default: /*error */ return status; } } else if (num_read == 0) { /* partial msg */ *http_error_code = HTTP_BAD_REQUEST; /* or response */ return UPNP_E_BAD_HTTPMSG; } else { *http_error_code = parser->http_error_code; return num_read; } } status = parser_parse_headers(parser); if ((status == (parse_status_t)PARSE_OK) && (parser->position == (parser_pos_t)POS_ENTITY)) done = 1; else if (status == (parse_status_t)PARSE_INCOMPLETE) done = 0; else /*error */ return status; /*read headers */ while (!done) { num_read = sock_read(info, buf, sizeof(buf), timeout_secs); if (num_read > 0) { /* append data to buffer */ ret_code = membuffer_append(&parser->msg.msg, buf, (size_t)num_read); if (ret_code != 0) { /* set failure status */ parser->http_error_code = HTTP_INTERNAL_SERVER_ERROR; return PARSE_FAILURE; } status = parser_parse_headers(parser); if (status == (parse_status_t)PARSE_OK && parser->position == (parser_pos_t)POS_ENTITY) done = 1; else if (status == (parse_status_t)PARSE_INCOMPLETE) done = 0; else /*error */ return status; } else if (num_read == 0) { /* partial msg */ *http_error_code = HTTP_BAD_REQUEST; /* or response */ return UPNP_E_BAD_HTTPMSG; } else { *http_error_code = parser->http_error_code; return num_read; } } return PARSE_OK; } /************************************************************************ * Function: http_HttpGetProgress * * Parameters: * IN void *Handle; Handle to the HTTP get object * OUT size_t *length; Buffer to get the read and parsed data * OUT size_t *total; Size of tge buffer passed * * Description: * Extracts information from the Handle to the HTTP get object. * * Return: int * UPNP_E_SUCCESS - On Sucess * UPNP_E_INVALID_PARAM - Invalid Parameter ************************************************************************/ int http_HttpGetProgress( IN void *Handle, OUT size_t *length, OUT size_t *total) { http_connection_handle_t *handle = Handle; if (!handle || !length || !total) { return UPNP_E_INVALID_PARAM; } *length = handle->response.msg.entity.length; *total = handle->response.content_length; return UPNP_E_SUCCESS; } /************************************************************************ * Function: http_CancelHttpGet * * Parameters: * IN void *Handle; Handle to HTTP get object * * Description: * Set the cancel flag of the HttpGet handle * * Return: int * UPNP_E_SUCCESS - On Success * UPNP_E_INVALID_PARAM - Invalid Parameter ************************************************************************/ int http_CancelHttpGet(IN void *Handle) { http_connection_handle_t *handle = Handle; if (!handle) return UPNP_E_INVALID_PARAM; handle->cancel = 1; return UPNP_E_SUCCESS; } int http_OpenHttpConnection(const char *url_str, void **Handle, int timeout) { int ret_code; size_t sockaddr_len; SOCKET tcp_connection; http_connection_handle_t *handle = NULL; uri_type url; if (!url_str || !Handle) return UPNP_E_INVALID_PARAM; *Handle = handle; /* parse url_str */ ret_code = http_FixStrUrl(url_str, strlen(url_str), &url); if (ret_code != UPNP_E_SUCCESS) return ret_code; /* create the handle */ handle = malloc(sizeof(http_connection_handle_t)); if (!handle) { return UPNP_E_OUTOF_MEMORY; } handle->requestStarted = 0; memset(&handle->response, 0, sizeof(handle->response)); /* connect to the server */ tcp_connection = socket(url.hostport.IPaddress.ss_family, SOCK_STREAM, 0); if (tcp_connection == INVALID_SOCKET) { ret_code = UPNP_E_SOCKET_ERROR; goto errorHandler; } if (sock_init(&handle->sock_info, tcp_connection) != UPNP_E_SUCCESS) { sock_destroy(&handle->sock_info, SD_BOTH); ret_code = UPNP_E_SOCKET_ERROR; goto errorHandler; } sockaddr_len = url.hostport.IPaddress.ss_family == AF_INET6 ? sizeof(struct sockaddr_in6) : sizeof(struct sockaddr_in); ret_code = private_connect(handle->sock_info.socket, (struct sockaddr *)&(url.hostport.IPaddress), (socklen_t) sockaddr_len); if (ret_code == -1) { sock_destroy(&handle->sock_info, SD_BOTH); ret_code = UPNP_E_SOCKET_CONNECT; goto errorHandler; } #ifdef UPNP_ENABLE_OPEN_SSL /* For HTTPS connections start the TLS/SSL handshake. */ if (token_string_casecmp(&url.scheme, "https") == 0) { ret_code = sock_ssl_connect(&handle->sock_info); if (ret_code != UPNP_E_SUCCESS) { sock_destroy(&handle->sock_info, SD_BOTH); goto errorHandler; } } #endif errorHandler: *Handle = handle; return ret_code; /* Unused parameter */ timeout = timeout; } int http_MakeHttpRequest(Upnp_HttpMethod method, const char *url_str, void *Handle, UpnpString *headers, const char *contentType, int contentLength, int timeout) { int ret_code; membuffer request; http_connection_handle_t *handle = Handle; uri_type url; if (!url_str || !Handle) return UPNP_E_INVALID_PARAM; if (handle->requestStarted) { /* TODO: Log an error that a previous request is already in progress. */ } handle->requestStarted = 1; handle->cancel = 0; ret_code = MakeGenericMessage(method, url_str, &request, &url, contentLength, contentType, headers); if (ret_code != UPNP_E_SUCCESS) return ret_code; /* send request */ ret_code = http_SendMessage(&handle->sock_info, &timeout, "b", request.buf, request.length); membuffer_destroy(&request); httpmsg_destroy(&handle->response.msg); parser_response_init(&handle->response, method); return ret_code; } int http_WriteHttpRequest(void *Handle, char *buf, size_t *size, int timeout) { http_connection_handle_t *handle = (http_connection_handle_t *)Handle; char *tempbuf = NULL; size_t tempbufSize = 0; int freeTempbuf = 0; int numWritten = 0; if (!handle || !size || !buf) { if (size) *size = 0; return UPNP_E_INVALID_PARAM; } if (handle->contentLength == UPNP_USING_CHUNKED) { if (*size) { size_t tempSize = 0; tempbuf = malloc(*size + CHUNK_HEADER_SIZE + CHUNK_TAIL_SIZE); if (!tempbuf) return UPNP_E_OUTOF_MEMORY; /* begin chunk */ sprintf(tempbuf, "%zx\r\n", *size); tempSize = strlen(tempbuf); memcpy(tempbuf + tempSize, buf, *size); memcpy(tempbuf + tempSize + *size, "\r\n", 2); /* end of chunk */ tempbufSize = tempSize + *size + 2; freeTempbuf = 1; } } else { tempbuf = buf; tempbufSize = *size; } numWritten = sock_write(&handle->sock_info, tempbuf, tempbufSize, &timeout); if (freeTempbuf) free(tempbuf); if (numWritten < 0) { *size = 0; return numWritten; } else { *size = (size_t)numWritten; return UPNP_E_SUCCESS; } } int http_EndHttpRequest(void *Handle, int timeout) { int retc = 0; const char *zcrlf = "0\r\n\r\n"; http_connection_handle_t *handle = Handle; if (!handle) return UPNP_E_INVALID_PARAM; if (!handle->requestStarted) { return UPNP_E_SUCCESS; } handle->requestStarted = 0; if (handle->contentLength == UPNP_USING_CHUNKED) /*send last chunk */ retc = sock_write(&handle->sock_info, zcrlf, strlen(zcrlf), &timeout); return retc >= 0 ? UPNP_E_SUCCESS : UPNP_E_SOCKET_WRITE; } int http_GetHttpResponse(void *Handle, UpnpString *headers, char **contentType, int *contentLength, int *httpStatus, int timeout) { int ret_code; int http_error_code; memptr ctype; http_connection_handle_t *handle = Handle; parse_status_t status; status = ReadResponseLineAndHeaders(&handle->sock_info, &handle->response, &timeout, &http_error_code); if (status != (parse_status_t)PARSE_OK) { ret_code = UPNP_E_BAD_RESPONSE; goto errorHandler; } status = parser_get_entity_read_method(&handle->response); switch (status) { case PARSE_CONTINUE_1: case PARSE_SUCCESS: break; default: ret_code = UPNP_E_BAD_RESPONSE; goto errorHandler; } ret_code = UPNP_E_SUCCESS; if (httpStatus) { *httpStatus = handle->response.msg.status_code; } if (contentType) { if (!httpmsg_find_hdr(&handle->response.msg, HDR_CONTENT_TYPE, &ctype)) /* no content-type */ *contentType = NULL; else *contentType = ctype.buf; } if (contentLength) { if (handle->response.position == (parser_pos_t)POS_COMPLETE) *contentLength = 0; else if (handle->response.ent_position == ENTREAD_USING_CHUNKED) *contentLength = UPNP_USING_CHUNKED; else if (handle->response.ent_position == ENTREAD_USING_CLEN) *contentLength = (int)handle->response.content_length; else if (handle->response.ent_position == ENTREAD_UNTIL_CLOSE) *contentLength = UPNP_UNTIL_CLOSE; } if (headers) { copy_msg_headers(&handle->response.msg.headers, headers); } errorHandler: if (ret_code != UPNP_E_SUCCESS) httpmsg_destroy(&handle->response.msg); return ret_code; } int http_ReadHttpResponse(void *Handle, char *buf, size_t *size, int timeout) { http_connection_handle_t *handle = Handle; parse_status_t status; int num_read; int ok_on_close = FALSE; char tempbuf[2 * 1024]; int ret_code = 0; if (!handle || !size || (*size > 0 && !buf)) { if (size) *size = 0; return UPNP_E_INVALID_PARAM; } /* first parse what has already been gotten */ if (handle->response.position != POS_COMPLETE) status = parser_parse_entity(&handle->response); else status = PARSE_SUCCESS; if (status == PARSE_INCOMPLETE_ENTITY) /* read until close */ ok_on_close = TRUE; else if ((status != PARSE_SUCCESS) && (status != PARSE_CONTINUE_1) && (status != PARSE_INCOMPLETE)) { /*error */ *size = 0; return UPNP_E_BAD_RESPONSE; } /* read more if necessary entity */ while (handle->response.msg.amount_discarded + *size > handle->response.msg.entity.length && !handle->cancel && handle->response.position != POS_COMPLETE) { num_read = sock_read(&handle->sock_info, tempbuf, sizeof(tempbuf), &timeout); if (num_read > 0) { /* append data to buffer */ ret_code = membuffer_append(&handle->response.msg.msg, tempbuf, (size_t)num_read); if (ret_code != 0) { /* set failure status */ handle->response.http_error_code = HTTP_INTERNAL_SERVER_ERROR; *size = 0; return PARSE_FAILURE; } status = parser_parse_entity(&handle->response); if (status == PARSE_INCOMPLETE_ENTITY) { /* read until close */ ok_on_close = TRUE; } else if ((status != PARSE_SUCCESS) && (status != PARSE_CONTINUE_1) && (status != PARSE_INCOMPLETE)) { /*error */ *size = 0; return UPNP_E_BAD_RESPONSE; } } else if (num_read == 0) { if (ok_on_close) { UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "<<< (RECVD) <<<\n%s\n-----------------\n", handle->response.msg.msg.buf); handle->response.position = POS_COMPLETE; } else { /* partial msg */ *size = 0; handle->response.http_error_code = HTTP_BAD_REQUEST; /* or response */ return UPNP_E_BAD_HTTPMSG; } } else { *size = 0; return num_read; } } if (handle->cancel) { return UPNP_E_CANCELED; } /* truncate size to fall within available data */ if (handle->response.msg.amount_discarded + *size > handle->response.msg.entity.length) *size = handle->response.msg.entity.length - handle->response.msg.amount_discarded; /* copy data to user buffer. delete copied data */ if (*size > 0) { memcpy(buf, &handle->response.msg.msg.buf[handle->response.entity_start_position], *size); membuffer_delete(&handle->response.msg.msg, handle->response.entity_start_position, *size); /* update scanner position. needed for chunked transfers */ handle->response.scanner.cursor -= *size; /* update amount discarded */ handle->response.msg.amount_discarded += *size; } return UPNP_E_SUCCESS; } int http_CloseHttpConnection(void *Handle) { http_connection_handle_t *handle = Handle; if (!handle) return UPNP_E_INVALID_PARAM; /*should shutdown completely */ sock_destroy(&handle->sock_info, SD_BOTH); httpmsg_destroy(&handle->response.msg); free(handle); return UPNP_E_SUCCESS; } /************************************************************************ * Function: http_SendStatusResponse * * Parameters: * IN SOCKINFO *info; Socket information object * IN int http_status_code; error code returned while making * or sending the response message * IN int request_major_version; request major version * IN int request_minor_version; request minor version * * Description: * Generate a response message for the status query and send the * status response. * * Return: int * 0 -- success * UPNP_E_OUTOF_MEMORY * UPNP_E_SOCKET_WRITE * UPNP_E_TIMEDOUT ************************************************************************/ int http_SendStatusResponse(IN SOCKINFO *info, IN int http_status_code, IN int request_major_version, IN int request_minor_version) { int response_major, response_minor; membuffer membuf; int ret; int timeout; http_CalcResponseVersion(request_major_version, request_minor_version, &response_major, &response_minor); membuffer_init(&membuf); membuf.size_inc = (size_t)70; /* response start line */ ret = http_MakeMessage(&membuf, response_major, response_minor, "RSCB", http_status_code, http_status_code); if (ret == 0) { timeout = HTTP_DEFAULT_TIMEOUT; ret = http_SendMessage(info, &timeout, "b", membuf.buf, membuf.length); } membuffer_destroy(&membuf); return ret; } int http_MakeMessage(membuffer *buf, int http_major_version, int http_minor_version, const char *fmt, ...) { char c; char *s = NULL; size_t num; off_t bignum; size_t length; time_t *loc_time; time_t curr_time; struct tm date_storage; struct tm *date; const char *start_str; const char *end_str; int status_code; const char *status_msg; http_method_t method; const char *method_str; const char *url_str; const char *temp_str; uri_type url; uri_type *uri_ptr; int error_code = 0; va_list argp; char tempbuf[200]; const char *weekday_str = "Sun\0Mon\0Tue\0Wed\0Thu\0Fri\0Sat"; const char *month_str = "Jan\0Feb\0Mar\0Apr\0May\0Jun\0" "Jul\0Aug\0Sep\0Oct\0Nov\0Dec"; int rc = 0; memset(tempbuf, 0, sizeof(tempbuf)); va_start(argp, fmt); while ((c = *fmt++)) { if (c == 's') { /* C string */ s = (char *)va_arg(argp, char *); assert(s); UpnpPrintf(UPNP_ALL, HTTP, __FILE__, __LINE__, "Adding a string : %s\n", s); if (membuffer_append(buf, s, strlen(s))) goto error_handler; } else if (c == 'K') { /* Add Chunky header */ if (membuffer_append(buf, "TRANSFER-ENCODING: chunked\r\n", strlen("Transfer-Encoding: chunked\r\n"))) goto error_handler; } else if (c == 'G') { /* Add Range header */ struct SendInstruction *RespInstr; RespInstr = (struct SendInstruction *) va_arg(argp, struct SendInstruction *); assert(RespInstr); /* connection header */ if (membuffer_append(buf, RespInstr->RangeHeader, strlen(RespInstr->RangeHeader))) goto error_handler; } else if (c == 'b') { /* mem buffer */ s = (char *)va_arg(argp, char *); UpnpPrintf(UPNP_ALL, HTTP, __FILE__, __LINE__, "Adding a char Buffer starting with: %c\n", (int)s[0]); assert(s); length = (size_t) va_arg(argp, size_t); if (membuffer_append(buf, s, length)) goto error_handler; } else if (c == 'c') { /* crlf */ if (membuffer_append(buf, "\r\n", (size_t)2)) goto error_handler; } else if (c == 'd') { /* integer */ num = (size_t)va_arg(argp, int); rc = snprintf(tempbuf, sizeof(tempbuf), "%" PRIzu, num); if (rc < 0 || (unsigned int) rc >= sizeof(tempbuf) || membuffer_append(buf, tempbuf, strlen(tempbuf))) goto error_handler; } else if (c == 'h') { /* off_t */ bignum = (off_t) va_arg(argp, off_t); rc = snprintf(tempbuf, sizeof(tempbuf), "%" PRId64, (int64_t) bignum); if (rc < 0 || (unsigned int) rc >= sizeof(tempbuf) || membuffer_append(buf, tempbuf, strlen(tempbuf))) goto error_handler; } else if (c == 't' || c == 'D') { /* date */ if (c == 'D') { /* header */ start_str = "DATE: "; end_str = "\r\n"; curr_time = time(NULL); loc_time = &curr_time; } else { /* date value only */ start_str = end_str = ""; loc_time = (time_t *)va_arg(argp, time_t *); } assert(loc_time); date = http_gmtime_r(loc_time, &date_storage); if (date == NULL) goto error_handler; rc = snprintf(tempbuf, sizeof(tempbuf), "%s%s, %02d %s %d %02d:%02d:%02d GMT%s", start_str, &weekday_str[date->tm_wday * 4], date->tm_mday, &month_str[date->tm_mon * 4], date->tm_year + 1900, date->tm_hour, date->tm_min, date->tm_sec, end_str); if (rc < 0 || (unsigned int) rc >= sizeof(tempbuf) || membuffer_append(buf, tempbuf, strlen(tempbuf))) goto error_handler; } else if (c == 'L') { /* Add CONTENT-LANGUAGE header only if WEB_SERVER_CONTENT_LANGUAGE */ /* is not empty and if Accept-Language header is not empty */ struct SendInstruction *RespInstr; RespInstr = (struct SendInstruction *) va_arg(argp, struct SendInstruction *); assert(RespInstr); if (strcmp(RespInstr->AcceptLanguageHeader, "") && strcmp(WEB_SERVER_CONTENT_LANGUAGE, "") && http_MakeMessage(buf, http_major_version, http_minor_version, "ssc", "CONTENT-LANGUAGE: ", WEB_SERVER_CONTENT_LANGUAGE) != 0) goto error_handler; } else if (c == 'C') { if ((http_major_version > 1) || (http_major_version == 1 && http_minor_version == 1) ) { /* connection header */ if (membuffer_append_str(buf, "CONNECTION: close\r\n")) goto error_handler; } } else if (c == 'N') { /* content-length header */ bignum = (off_t) va_arg(argp, off_t); assert(bignum >= 0); if (http_MakeMessage(buf, http_major_version, http_minor_version, "shc", "CONTENT-LENGTH: ", bignum) != 0) goto error_handler; } else if (c == 'S' || c == 'U') { /* SERVER or USER-AGENT header */ temp_str = (c == 'S') ? "SERVER: " : "USER-AGENT: "; get_sdk_info(tempbuf, sizeof(tempbuf)); if (http_MakeMessage(buf, http_major_version, http_minor_version, "ss", temp_str, tempbuf) != 0) goto error_handler; } else if (c == 'X') { /* C string */ s = (char *)va_arg(argp, char *); assert(s); if (membuffer_append_str(buf, "X-User-Agent: ") != 0) goto error_handler; if (membuffer_append(buf, s, strlen(s)) != 0) goto error_handler; } else if (c == 'R') { /* response start line */ /* e.g.: 'HTTP/1.1 200 OK' code */ status_code = (int)va_arg(argp, int); assert(status_code > 0); rc = snprintf(tempbuf, sizeof(tempbuf), "HTTP/%d.%d %d ", http_major_version, http_minor_version, status_code); /* str */ status_msg = http_get_code_text(status_code); if (rc < 0 || (unsigned int) rc >= sizeof(tempbuf) || http_MakeMessage(buf, http_major_version, http_minor_version, "ssc", tempbuf, status_msg) != 0) goto error_handler; } else if (c == 'B') { /* body of a simple reply */ status_code = (int)va_arg(argp, int); rc = snprintf(tempbuf, sizeof(tempbuf), "%s%d %s%s", "

", status_code, http_get_code_text(status_code), "

"); if (rc < 0 || (unsigned int) rc >= sizeof(tempbuf)) goto error_handler; bignum = (off_t)strlen(tempbuf); if (http_MakeMessage(buf, http_major_version, http_minor_version, "NTcs", bignum, /* content-length */ "text/html", /* content-type */ tempbuf) != 0 /* body */ ) goto error_handler; } else if (c == 'Q') { /* request start line */ /* GET /foo/bar.html HTTP/1.1\r\n */ method = (http_method_t) va_arg(argp, http_method_t); method_str = method_to_str(method); url_str = (const char *)va_arg(argp, const char *); num = (size_t) va_arg(argp, size_t); /* length of url_str */ if (http_MakeMessage(buf, http_major_version, http_minor_version, "ssbsdsdc", method_str, /* method */ " ", url_str, num, /* url */ " HTTP/", http_major_version, ".", http_minor_version) != 0) goto error_handler; } else if (c == 'q') { /* request start line and HOST header */ method = (http_method_t) va_arg(argp, http_method_t); uri_ptr = (uri_type *) va_arg(argp, uri_type *); assert(uri_ptr); if (http_FixUrl(uri_ptr, &url) != 0) { error_code = UPNP_E_INVALID_URL; goto error_handler; } if (http_MakeMessage(buf, http_major_version, http_minor_version, "Q" "sbc", method, url.pathquery.buff, url.pathquery.size, "HOST: ", url.hostport.text.buff, url.hostport.text.size) != 0) goto error_handler; } else if (c == 'T') { /* content type header */ temp_str = (const char *)va_arg(argp, const char *); /* type/subtype format */ if (http_MakeMessage(buf, http_major_version, http_minor_version, "ssc", "CONTENT-TYPE: ", temp_str) != 0) goto error_handler; } else { assert(0); } } goto ExitFunction; error_handler: /* Default is out of memory error. */ if (!error_code) error_code = UPNP_E_OUTOF_MEMORY; membuffer_destroy(buf); ExitFunction: va_end(argp); return error_code; } /************************************************************************ * Function: http_CalcResponseVersion * * Parameters: * IN int request_major_vers; Request major version * IN int request_minor_vers; Request minor version * OUT int* response_major_vers; Response mojor version * OUT int* response_minor_vers; Response minor version * * Description: * Calculate HTTP response versions based on the request versions. * * Return: void ************************************************************************/ void http_CalcResponseVersion( IN int request_major_vers, IN int request_minor_vers, OUT int *response_major_vers, OUT int *response_minor_vers) { if ((request_major_vers > 1) || (request_major_vers == 1 && request_minor_vers >= 1)) { *response_major_vers = 1; *response_minor_vers = 1; } else { *response_major_vers = request_major_vers; *response_minor_vers = request_minor_vers; } } /************************************************************************ * Function: MakeGetMessageEx * * Parameters: * const char *url_str; String as a URL * membuffer *request; Buffer containing the request * uri_type *url; URI object containing the scheme, path * query token, etc. * * Description: * Makes the message for the HTTP GET method * * Returns: * UPNP_E_INVALID_URL * Error Codes returned by http_MakeMessage * UPNP_E_SUCCESS ************************************************************************/ int MakeGetMessageEx( const char *url_str, membuffer * request, uri_type * url, struct SendInstruction *pRangeSpecifier) { int errCode = UPNP_E_SUCCESS; char *urlPath = NULL; size_t hostlen = (size_t)0; char *hoststr, *temp; do { UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "DOWNLOAD URL : %s\n", url_str); if ((errCode = http_FixStrUrl((char *)url_str, strlen(url_str), url)) != UPNP_E_SUCCESS) { break; } /* make msg */ membuffer_init(request); urlPath = alloca(strlen(url_str) + (size_t)1); if (!urlPath) { errCode = UPNP_E_OUTOF_MEMORY; break; } memset(urlPath, 0, strlen(url_str) + (size_t)1); strncpy(urlPath, url_str, strlen(url_str)); hoststr = strstr(urlPath, "//"); if (hoststr == NULL) { errCode = UPNP_E_INVALID_URL; break; } hoststr += 2; temp = strchr(hoststr, '/'); if (temp == NULL) { errCode = UPNP_E_INVALID_URL; break; } *temp = '\0'; hostlen = strlen(hoststr); *temp = '/'; UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "HOSTNAME : %s Length : %" PRIzu "\n", hoststr, hostlen); errCode = http_MakeMessage(request, 1, 1, "Q" "s" "bc" "GDCUc", HTTPMETHOD_GET, url->pathquery.buff, url->pathquery.size, "HOST: ", hoststr, hostlen, pRangeSpecifier); if (errCode != 0) { UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "HTTP Makemessage failed\n"); membuffer_destroy(request); return errCode; } } while (0); UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "HTTP Buffer:\n%s\n" "----------END--------\n", request->buf); return errCode; } #define SIZE_RANGE_BUFFER 50 /************************************************************************ * Function: http_OpenHttpGetEx * * Parameters: * IN const char *url_str; String as a URL * IN OUT void **Handle; Pointer to buffer to store HTTP * post handle * IN OUT char **contentType; Type of content * OUT int *contentLength; length of content * OUT int *httpStatus; HTTP status returned on receiving a * response message * IN int timeout; time out value * * Description: * Makes the HTTP GET message, connects to the peer, * sends the HTTP GET request, gets the response and parses the * response. * * Return: int * UPNP_E_SUCCESS - On Success * UPNP_E_INVALID_PARAM - Invalid Paramters * UPNP_E_OUTOF_MEMORY * UPNP_E_SOCKET_ERROR * UPNP_E_BAD_RESPONSE ************************************************************************/ int http_OpenHttpGetEx( IN const char *url_str, IN OUT void **Handle, IN OUT char **contentType, OUT int *contentLength, OUT int *httpStatus, IN int lowRange, IN int highRange, IN int timeout) { int http_error_code; memptr ctype; SOCKET tcp_connection; size_t sockaddr_len; membuffer request; http_connection_handle_t *handle = NULL; uri_type url; parse_status_t status; int errCode = UPNP_E_SUCCESS; /* char rangeBuf[SIZE_RANGE_BUFFER]; */ struct SendInstruction rangeBuf; int rc = 0; membuffer_init(&request); do { /* Checking Input parameters */ if (!url_str || !Handle || !contentType || !httpStatus ) { errCode = UPNP_E_INVALID_PARAM; break; } /* Initialize output parameters */ *httpStatus = 0; *Handle = handle; *contentType = NULL; *contentLength = 0; if (lowRange > highRange) { errCode = UPNP_E_INTERNAL_ERROR; break; } memset(&rangeBuf, 0, sizeof(rangeBuf)); rc = snprintf(rangeBuf.RangeHeader, sizeof(rangeBuf.RangeHeader), "Range: bytes=%d-%d\r\n", lowRange, highRange); if (rc < 0 || (unsigned int) rc >= sizeof(rangeBuf.RangeHeader)) break; membuffer_init(&request); errCode = MakeGetMessageEx(url_str, &request, &url, &rangeBuf); if (errCode != UPNP_E_SUCCESS) break; handle = (http_connection_handle_t *)malloc(sizeof(http_connection_handle_t)); if (!handle) { errCode = UPNP_E_OUTOF_MEMORY; break; } memset(handle, 0, sizeof(*handle)); parser_response_init(&handle->response, HTTPMETHOD_GET); tcp_connection = socket((int)url.hostport.IPaddress.ss_family, SOCK_STREAM, 0); if (tcp_connection == INVALID_SOCKET) { errCode = UPNP_E_SOCKET_ERROR; free(handle); break; } if (sock_init(&handle->sock_info, tcp_connection) != UPNP_E_SUCCESS) { sock_destroy(&handle->sock_info, SD_BOTH); errCode = UPNP_E_SOCKET_ERROR; free(handle); break; } sockaddr_len = url.hostport.IPaddress.ss_family == AF_INET6 ? sizeof(struct sockaddr_in6) : sizeof(struct sockaddr_in); errCode = private_connect(handle->sock_info.socket, (struct sockaddr *)&(url.hostport.IPaddress), (socklen_t)sockaddr_len); if (errCode == -1) { sock_destroy(&handle->sock_info, SD_BOTH); errCode = UPNP_E_SOCKET_CONNECT; free(handle); break; } /* send request */ errCode = http_SendMessage(&handle->sock_info, &timeout, "b", request.buf, request.length); if (errCode != UPNP_E_SUCCESS) { sock_destroy(&handle->sock_info, SD_BOTH); free(handle); break; } if (ReadResponseLineAndHeaders(&handle->sock_info, &handle->response, &timeout, &http_error_code) != (int)PARSE_OK) { errCode = UPNP_E_BAD_RESPONSE; free(handle); break; } status = parser_get_entity_read_method(&handle->response); if (status != (parse_status_t)PARSE_CONTINUE_1 && status != (parse_status_t)PARSE_SUCCESS) { errCode = UPNP_E_BAD_RESPONSE; free(handle); break; } *httpStatus = handle->response.msg.status_code; errCode = UPNP_E_SUCCESS; if (!httpmsg_find_hdr(&handle->response.msg, HDR_CONTENT_TYPE, &ctype)) /* no content-type */ *contentType = NULL; else *contentType = ctype.buf; if (handle->response.position == (parser_pos_t)POS_COMPLETE) *contentLength = 0; else if(handle->response.ent_position == ENTREAD_USING_CHUNKED) *contentLength = UPNP_USING_CHUNKED; else if(handle->response.ent_position == ENTREAD_USING_CLEN) *contentLength = (int)handle->response.content_length; else if(handle->response.ent_position == ENTREAD_UNTIL_CLOSE) *contentLength = UPNP_UNTIL_CLOSE; *Handle = handle; } while (0); membuffer_destroy(&request); return errCode; } /************************************************************************ * Function: get_sdk_info * * Parameters: * OUT char *info; buffer to store the operating system information * IN size_t infoSize; size of buffer * * Description: * Returns the server information for the operating system * * Return: * UPNP_INLINE void ************************************************************************/ /* 'info' should have a size of at least 100 bytes */ void get_sdk_info(OUT char *info, IN size_t infoSize) { #ifdef UPNP_ENABLE_UNSPECIFIED_SERVER snprintf(info, infoSize, "Unspecified, UPnP/1.0, Unspecified\r\n"); #else /* UPNP_ENABLE_UNSPECIFIED_SERVER */ #ifdef WIN32 OSVERSIONINFO versioninfo; versioninfo.dwOSVersionInfoSize = sizeof(OSVERSIONINFO); if (GetVersionEx(&versioninfo) != 0) snprintf(info, infoSize, "%d.%d.%d %d/%s, UPnP/1.0, Portable SDK for UPnP devices/" PACKAGE_VERSION "\r\n", versioninfo.dwMajorVersion, versioninfo.dwMinorVersion, versioninfo.dwBuildNumber, versioninfo.dwPlatformId, versioninfo.szCSDVersion); else *info = '\0'; #else int ret_code; struct utsname sys_info; ret_code = uname(&sys_info); if (ret_code == -1) *info = '\0'; snprintf(info, infoSize, "%s/%s, UPnP/1.0, Portable SDK for UPnP devices/" PACKAGE_VERSION "\r\n", sys_info.sysname, sys_info.release); #endif #endif /* UPNP_ENABLE_UNSPECIFIED_SERVER */ } pupnp-release-1.8.0/upnp/src/genlib/net/http/parsetools.c000066400000000000000000000046031303304015100234060ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \file * * Purpose: This file a function to extract the header information from * an http message and then matches the data with XML data. */ #include "config.h" #include #include "upnputil.h" #include "membuffer.h" #include "httpparser.h" #include "statcodes.h" #include "parsetools.h" int has_xml_content_type(http_message_t *hmsg) { memptr hdr_value; assert(hmsg); /* find 'content-type' header which must have text/xml */ if (httpmsg_find_hdr(hmsg, HDR_CONTENT_TYPE, &hdr_value)) { switch (matchstr(hdr_value.buf, hdr_value.length, "%itext%w/%wxml" )) { case PARSE_OK: return TRUE; default: break; } } return FALSE; } pupnp-release-1.8.0/upnp/src/genlib/net/http/statcodes.c000066400000000000000000000161571303304015100232130ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /************************************************************************ * Purpose: This file defines status codes, buffers to store the status * * messages and functions to manipulate those buffers * ************************************************************************/ #include "config.h" #include #include #include "upnputil.h" #include "statcodes.h" #ifdef WIN32 #include "unixutil.h" #endif #define NUM_1XX_CODES 2 static const char *Http1xxCodes[NUM_1XX_CODES]; static const char *Http1xxStr = "Continue\0" "Switching Protocols\0"; #define NUM_2XX_CODES 7 static const char *Http2xxCodes[NUM_2XX_CODES]; static const char *Http2xxStr = "OK\0" "Created\0" "Accepted\0" "Non-Authoratative Information\0" "No Content\0" "Reset Content\0" "Partial Content\0"; #define NUM_3XX_CODES 8 static const char *Http3xxCodes[NUM_3XX_CODES]; static const char *Http3xxStr = "Multiple Choices\0" "Moved Permanently\0" "Found\0" "See Other\0" "Not Modified\0" "Use Proxy\0" "\0" "Temporary Redirect\0"; #define NUM_4XX_CODES 18 static const char *Http4xxCodes[NUM_4XX_CODES]; static const char *Http4xxStr = "Bad Request\0" "Unauthorized\0" "Payment Required\0" "Forbidden\0" "Not Found\0" "Method Not Allowed\0" "Not Acceptable\0" "Proxy Authentication Required\0" "Request Timeout\0" "Conflict\0" "Gone\0" "Length Required\0" "Precondition Failed\0" "Request Entity Too Large\0" "Request-URI Too Long\0" "Unsupported Media Type\0" "Requested Range Not Satisfiable\0" "Expectation Failed\0"; #define NUM_5XX_CODES 11 static const char *Http5xxCodes[NUM_5XX_CODES]; static const char *Http5xxStr = "Internal Server Error\0" "Not Implemented\0" "Bad Gateway\0" "Service Unavailable\0" "Gateway Timeout\0" "HTTP Version Not Supported\0" "Variant Also Negotiates\0" "Insufficient Storage\0" "Loop Detected\0" "\0" "Not Extended\0"; static int gInitialized = FALSE; /************************************************************************ ************************* Functions ************************************* ************************************************************************/ /************************************************************************ * Function: init_table * * Parameters: * IN const char* encoded_str ; status code encoded string * OUT const char *table[] ; table to store the encoded status code * strings * IN int tbl_size ; size of the table * * Description: Initializing table representing an array of string * pointers with the individual strings that are comprised in the * input const char* encoded_str parameter. * * Returns: * void ************************************************************************/ static UPNP_INLINE void init_table( IN const char *encoded_str, OUT const char *table[], IN int tbl_size ) { int i; const char *s = encoded_str; for( i = 0; i < tbl_size; i++ ) { table[i] = s; s += strlen( s ) + (size_t)1; /* next entry */ } } /************************************************************************ * Function: init_tables * * Parameters: * none * * Description: Initializing tables with HTTP strings and different HTTP * codes. * * Returns: * void ************************************************************************/ static UPNP_INLINE void init_tables( void ) { init_table( Http1xxStr, Http1xxCodes, NUM_1XX_CODES ); init_table( Http2xxStr, Http2xxCodes, NUM_2XX_CODES ); init_table( Http3xxStr, Http3xxCodes, NUM_3XX_CODES ); init_table( Http4xxStr, Http4xxCodes, NUM_4XX_CODES ); init_table( Http5xxStr, Http5xxCodes, NUM_5XX_CODES ); gInitialized = TRUE; /* mark only after complete */ } /************************************************************************ * Function: http_get_code_text * * Parameters: * int statusCode ; Status code based on which the status table and * status message is returned * * Description: Return the right status message based on the passed in * int statusCode input parameter * * Returns: * const char* ptr - pointer to the status message string ************************************************************************/ const char * http_get_code_text( int statusCode ) { int index; int table_num; if( !gInitialized ) { init_tables(); } if( statusCode < 100 || statusCode >= 600 ) { return NULL; } index = statusCode % 100; table_num = statusCode / 100; if( table_num == 1 && index < NUM_1XX_CODES ) { return Http1xxCodes[index]; } if( table_num == 2 && index < NUM_2XX_CODES ) { return Http2xxCodes[index]; } if( table_num == 3 && index < NUM_3XX_CODES ) { return Http3xxCodes[index]; } if( table_num == 4 && index < NUM_4XX_CODES ) { return Http4xxCodes[index]; } if( table_num == 5 && index < NUM_5XX_CODES ) { return Http5xxCodes[index]; } return NULL; } pupnp-release-1.8.0/upnp/src/genlib/net/http/webserver.c000066400000000000000000001171601303304015100232220ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ /*! * \file * * \brief Defines the Web Server and has functions to carry out * operations of the Web Server. */ #include "config.h" #if EXCLUDE_WEB_SERVER == 0 #include "webserver.h" #include "FileInfo.h" #include "httpparser.h" #include "httpreadwrite.h" #include "ithread.h" #include "membuffer.h" #include "ssdplib.h" #include "statcodes.h" #include "strintmap.h" #include "unixutil.h" #include "upnp.h" #include "upnpapi.h" #include "UpnpIntTypes.h" #include "UpnpStdInt.h" #include "upnputil.h" #include "VirtualDir.h" #include #include #include #ifdef WIN32 #define snprintf _snprintf #endif /*! * Response Types. */ enum resp_type { RESP_FILEDOC, RESP_XMLDOC, RESP_HEADERS, RESP_WEBDOC, RESP_POST }; /* mapping of file extension to content-type of document */ struct document_type_t { /*! . */ const char *file_ext; /*! . */ const char *content_type; /*! . */ const char *content_subtype; }; struct xml_alias_t { /*! name of DOC from root; e.g.: /foo/bar/mydesc.xml */ membuffer name; /*! the XML document contents */ membuffer doc; /*! . */ time_t last_modified; /*! . */ int *ct; }; static const char *gMediaTypes[] = { /*! 0. */ NULL, /*! 1. */ "audio", /*! 2. */ "video", /*! 3. */ "image", /*! 4. */ "application", /*! 5. */ "text" }; /* * Defines. */ /* index into 'gMediaTypes' */ #define AUDIO_STR "\1" #define VIDEO_STR "\2" #define IMAGE_STR "\3" #define APPLICATION_STR "\4" #define TEXT_STR "\5" /* int index */ #define APPLICATION_INDEX 4 #define TEXT_INDEX 5 /* general */ #define NUM_MEDIA_TYPES 70 #define NUM_HTTP_HEADER_NAMES 33 #define ASCTIME_R_BUFFER_SIZE 26 #ifdef WIN32 static char *web_server_asctime_r(const struct tm *tm, char *buf) { if (tm == NULL || buf == NULL) return NULL; asctime_s(buf, ASCTIME_R_BUFFER_SIZE, tm); return buf; } #else #define web_server_asctime_r asctime_r #endif /* sorted by file extension; must have 'NUM_MEDIA_TYPES' extensions */ static const char *gEncodedMediaTypes = "aif\0" AUDIO_STR "aiff\0" "aifc\0" AUDIO_STR "aiff\0" "aiff\0" AUDIO_STR "aiff\0" "asf\0" VIDEO_STR "x-ms-asf\0" "asx\0" VIDEO_STR "x-ms-asf\0" "au\0" AUDIO_STR "basic\0" "avi\0" VIDEO_STR "msvideo\0" "bmp\0" IMAGE_STR "bmp\0" "css\0" TEXT_STR "css\0" "dcr\0" APPLICATION_STR "x-director\0" "dib\0" IMAGE_STR "bmp\0" "dir\0" APPLICATION_STR "x-director\0" "dxr\0" APPLICATION_STR "x-director\0" "gif\0" IMAGE_STR "gif\0" "hta\0" TEXT_STR "hta\0" "htm\0" TEXT_STR "html\0" "html\0" TEXT_STR "html\0" "jar\0" APPLICATION_STR "java-archive\0" "jfif\0" IMAGE_STR "pjpeg\0" "jpe\0" IMAGE_STR "jpeg\0" "jpeg\0" IMAGE_STR "jpeg\0" "jpg\0" IMAGE_STR "jpeg\0" "js\0" APPLICATION_STR "x-javascript\0" "kar\0" AUDIO_STR "midi\0" "m3u\0" AUDIO_STR "mpegurl\0" "mid\0" AUDIO_STR "midi\0" "midi\0" AUDIO_STR "midi\0" "mov\0" VIDEO_STR "quicktime\0" "mp2v\0" VIDEO_STR "x-mpeg2\0" "mp3\0" AUDIO_STR "mpeg\0" "mpe\0" VIDEO_STR "mpeg\0" "mpeg\0" VIDEO_STR "mpeg\0" "mpg\0" VIDEO_STR "mpeg\0" "mpv\0" VIDEO_STR "mpeg\0" "mpv2\0" VIDEO_STR "x-mpeg2\0" "pdf\0" APPLICATION_STR "pdf\0" "pjp\0" IMAGE_STR "jpeg\0" "pjpeg\0" IMAGE_STR "jpeg\0" "plg\0" TEXT_STR "html\0" "pls\0" AUDIO_STR "scpls\0" "png\0" IMAGE_STR "png\0" "qt\0" VIDEO_STR "quicktime\0" "ram\0" AUDIO_STR "x-pn-realaudio\0" "rmi\0" AUDIO_STR "mid\0" "rmm\0" AUDIO_STR "x-pn-realaudio\0" "rtf\0" APPLICATION_STR "rtf\0" "shtml\0" TEXT_STR "html\0" "smf\0" AUDIO_STR "midi\0" "snd\0" AUDIO_STR "basic\0" "spl\0" APPLICATION_STR "futuresplash\0" "ssm\0" APPLICATION_STR "streamingmedia\0" "swf\0" APPLICATION_STR "x-shockwave-flash\0" "tar\0" APPLICATION_STR "tar\0" "tcl\0" APPLICATION_STR "x-tcl\0" "text\0" TEXT_STR "plain\0" "tif\0" IMAGE_STR "tiff\0" "tiff\0" IMAGE_STR "tiff\0" "txt\0" TEXT_STR "plain\0" "ulw\0" AUDIO_STR "basic\0" "wav\0" AUDIO_STR "wav\0" "wax\0" AUDIO_STR "x-ms-wax\0" "wm\0" VIDEO_STR "x-ms-wm\0" "wma\0" AUDIO_STR "x-ms-wma\0" "wmv\0" VIDEO_STR "x-ms-wmv\0" "wvx\0" VIDEO_STR "x-ms-wvx\0" "xbm\0" IMAGE_STR "x-xbitmap\0" "xml\0" TEXT_STR "xml\0" "xsl\0" TEXT_STR "xml\0" "z\0" APPLICATION_STR "x-compress\0" "zip\0" APPLICATION_STR "zip\0" "\0"; /* *** end *** */ /*! * module variables - Globals, static and externs. */ static struct document_type_t gMediaTypeList[NUM_MEDIA_TYPES]; /*! Global variable. A local dir which serves as webserver root. */ membuffer gDocumentRootDir; /*! XML document. */ static struct xml_alias_t gAliasDoc; static ithread_mutex_t gWebMutex; extern str_int_entry Http_Header_Names[NUM_HTTP_HEADER_NAMES]; /*! * \brief Decodes list and stores it in gMediaTypeList. */ static UPNP_INLINE void media_list_init(void) { int i; const char *s = gEncodedMediaTypes; struct document_type_t *doc_type; for (i = 0; *s != '\0'; i++) { doc_type = &gMediaTypeList[i]; doc_type->file_ext = s; /* point to type. */ s += strlen(s) + 1; doc_type->content_type = gMediaTypes[(int)*s]; /* point to subtype. */ s++; doc_type->content_subtype = s; /* next entry. */ s += strlen(s) + 1; } assert(i == NUM_MEDIA_TYPES); } /*! * \brief Based on the extension, returns the content type and content * subtype. * * \return * \li \c 0 on success * \li \c -1 on error */ static UPNP_INLINE int search_extension( /*! [in] . */ const char *extension, /*! [out] . */ const char **con_type, /*! [out] . */ const char **con_subtype) { int top, mid, bot; int cmp; top = 0; bot = NUM_MEDIA_TYPES - 1; while (top <= bot) { mid = (top + bot) / 2; cmp = strcasecmp(extension, gMediaTypeList[mid].file_ext); if (cmp > 0) { /* look below mid. */ top = mid + 1; } else if (cmp < 0) { /* look above mid. */ bot = mid - 1; } else { /* cmp == 0 */ *con_type = gMediaTypeList[mid].content_type; *con_subtype = gMediaTypeList[mid].content_subtype; return 0; } } return -1; } /*! * \brief Based on the extension, clones an XML string based on type and * content subtype. If content type and sub type are not found, unknown * types are used. * * \return * \li \c 0 on success. * \li \c UPNP_E_OUTOF_MEMORY - on memory allocation failures. */ static UPNP_INLINE int get_content_type( /*! [in] . */ const char *filename, /*! [out] . */ OUT UpnpFileInfo *fileInfo) { const char *extension; const char *type; const char *subtype; int ctype_found = FALSE; char *temp = NULL; size_t length = 0; int rc = 0; UpnpFileInfo_set_ContentType(fileInfo, NULL); /* get ext */ extension = strrchr(filename, '.'); if (extension != NULL) if (search_extension(extension + 1, &type, &subtype) == 0) ctype_found = TRUE; if (!ctype_found) { /* unknown content type */ type = gMediaTypes[APPLICATION_INDEX]; subtype = "octet-stream"; } length = strlen(type) + strlen("/") + strlen(subtype) + 1; temp = malloc(length); if (!temp) return UPNP_E_OUTOF_MEMORY; rc = snprintf(temp, length, "%s/%s", type, subtype); if (rc < 0 || (unsigned int) rc >= length) { free(temp); return UPNP_E_OUTOF_MEMORY; } UpnpFileInfo_set_ContentType(fileInfo, temp); free(temp); if (!UpnpFileInfo_get_ContentType(fileInfo)) return UPNP_E_OUTOF_MEMORY; return 0; } /*! * \brief Initialize the global XML document. Allocate buffers for the XML * document. */ static UPNP_INLINE void glob_alias_init(void) { struct xml_alias_t *alias = &gAliasDoc; membuffer_init(&alias->doc); membuffer_init(&alias->name); alias->ct = NULL; alias->last_modified = 0; } /*! * \brief Check for the validity of the XML object buffer. * * \return BOOLEAN. */ static UPNP_INLINE int is_valid_alias( /*! [in] XML alias object. */ const struct xml_alias_t *alias) { return alias->doc.buf != NULL; } /*! * \brief Copy the contents of the global XML document into the local output * parameter. */ static void alias_grab( /*! [out] XML alias object. */ struct xml_alias_t *alias) { ithread_mutex_lock(&gWebMutex); assert(is_valid_alias(&gAliasDoc)); memcpy(alias, &gAliasDoc, sizeof(struct xml_alias_t)); *alias->ct = *alias->ct + 1; ithread_mutex_unlock(&gWebMutex); } /*! * \brief Release the XML document referred to by the input parameter. Free * the allocated buffers associated with this object. */ static void alias_release( /*! [in] XML alias object. */ struct xml_alias_t *alias) { ithread_mutex_lock(&gWebMutex); /* ignore invalid alias */ if (!is_valid_alias(alias)) { ithread_mutex_unlock(&gWebMutex); return; } assert(*alias->ct > 0); *alias->ct -= 1; if (*alias->ct <= 0) { membuffer_destroy(&alias->doc); membuffer_destroy(&alias->name); free(alias->ct); } ithread_mutex_unlock(&gWebMutex); } int web_server_set_alias(const char *alias_name, const char *alias_content, size_t alias_content_length, time_t last_modified) { int ret_code; struct xml_alias_t alias; alias_release(&gAliasDoc); if (alias_name == NULL) { /* don't serve aliased doc anymore */ return 0; } assert(alias_content != NULL); membuffer_init(&alias.doc); membuffer_init(&alias.name); alias.ct = NULL; do { /* insert leading /, if missing */ if (*alias_name != '/') if (membuffer_assign_str(&alias.name, "/") != 0) break; /* error; out of mem */ ret_code = membuffer_append_str(&alias.name, alias_name); if (ret_code != 0) break; /* error */ if ((alias.ct = (int *)malloc(sizeof(int))) == NULL) break; /* error */ *alias.ct = 1; membuffer_attach(&alias.doc, (char *)alias_content, alias_content_length); alias.last_modified = last_modified; /* save in module var */ ithread_mutex_lock(&gWebMutex); gAliasDoc = alias; ithread_mutex_unlock(&gWebMutex); return 0; } while (FALSE); /* error handler */ /* free temp alias */ membuffer_destroy(&alias.name); membuffer_destroy(&alias.doc); free(alias.ct); return UPNP_E_OUTOF_MEMORY; } int web_server_init() { int ret = 0; if (bWebServerState == WEB_SERVER_DISABLED) { /* decode media list */ media_list_init(); membuffer_init(&gDocumentRootDir); glob_alias_init(); pVirtualDirList = NULL; /* Initialize callbacks */ virtualDirCallback.get_info = NULL; virtualDirCallback.open = NULL; virtualDirCallback.read = NULL; virtualDirCallback.write = NULL; virtualDirCallback.seek = NULL; virtualDirCallback.close = NULL; if (ithread_mutex_init(&gWebMutex, NULL) == -1) ret = UPNP_E_OUTOF_MEMORY; else bWebServerState = WEB_SERVER_ENABLED; } return ret; } void web_server_destroy(void) { if (bWebServerState == WEB_SERVER_ENABLED) { membuffer_destroy(&gDocumentRootDir); alias_release(&gAliasDoc); ithread_mutex_lock(&gWebMutex); memset(&gAliasDoc, 0, sizeof(struct xml_alias_t)); ithread_mutex_unlock(&gWebMutex); ithread_mutex_destroy(&gWebMutex); bWebServerState = WEB_SERVER_DISABLED; } } /*! * \brief Release memory allocated for the global web server root directory * and the global XML document. Resets the flag bWebServerState to * WEB_SERVER_DISABLED. * * \return Integer. */ static int get_file_info( /*! [in] Filename having the description document. */ const char *filename, /*! [out] File information object having file attributes such as filelength, * when was the file last modified, whether a file or a directory and * whether the file or directory is readable. */ OUT UpnpFileInfo *info) { int code; struct stat s; FILE *fp; int rc = 0; time_t aux_LastModified; struct tm date; char buffer[ASCTIME_R_BUFFER_SIZE]; UpnpFileInfo_set_ContentType(info, NULL); code = stat(filename, &s); if (code == -1) return -1; if (S_ISDIR(s.st_mode)) UpnpFileInfo_set_IsDirectory(info, TRUE); else if (S_ISREG(s.st_mode)) UpnpFileInfo_set_IsDirectory(info, FALSE); else return -1; /* check readable */ fp = fopen(filename, "r"); UpnpFileInfo_set_IsReadable(info, fp != NULL); if (fp) fclose(fp); UpnpFileInfo_set_FileLength(info, s.st_size); UpnpFileInfo_set_LastModified(info, s.st_mtime); rc = get_content_type(filename, info); aux_LastModified = UpnpFileInfo_get_LastModified(info); UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "file info: %s, length: %lld, last_mod=%s readable=%d\n", filename, (long long)UpnpFileInfo_get_FileLength(info), web_server_asctime_r(http_gmtime_r(&aux_LastModified, &date), buffer), UpnpFileInfo_get_IsReadable(info)); return rc; } int web_server_set_root_dir(const char *root_dir) { size_t index; int ret; ret = membuffer_assign_str(&gDocumentRootDir, root_dir); if (ret != 0) return ret; /* remove trailing '/', if any */ if (gDocumentRootDir.length > 0) { index = gDocumentRootDir.length - 1; /* last char */ if (gDocumentRootDir.buf[index] == '/') membuffer_delete(&gDocumentRootDir, index, 1); } return 0; } /*! * \brief Compare the files names between the one on the XML alias the one * passed in as the input parameter. If equal extract file information. * * \return * \li \c TRUE - On Success * \li \c FALSE if request is not an alias */ static UPNP_INLINE int get_alias( /*! [in] request file passed in to be compared with. */ const char *request_file, /*! [out] xml alias object which has a file name stored. */ struct xml_alias_t *alias, /*! [out] File information object which will be filled up if the file * comparison succeeds. */ UpnpFileInfo *info) { int cmp = strcmp(alias->name.buf, request_file); if (cmp == 0) { UpnpFileInfo_set_FileLength(info, (off_t)alias->doc.length); UpnpFileInfo_set_IsDirectory(info, FALSE); UpnpFileInfo_set_IsReadable(info, TRUE); UpnpFileInfo_set_LastModified(info, alias->last_modified); } return cmp == 0; } /*! * \brief Compares filePath with paths from the list of virtual directory * lists. * * \return BOOLEAN. */ static int isFileInVirtualDir( /*! [in] Directory path to be tested for virtual directory. */ char *filePath) { virtualDirList *pCurVirtualDir; size_t webDirLen; pCurVirtualDir = pVirtualDirList; while (pCurVirtualDir != NULL) { webDirLen = strlen(pCurVirtualDir->dirName); if (webDirLen) { if (pCurVirtualDir->dirName[webDirLen - 1] == '/') { if (strncmp(pCurVirtualDir->dirName, filePath, webDirLen) == 0) return !0; } else { if (strncmp(pCurVirtualDir->dirName, filePath, webDirLen) == 0 && (filePath[webDirLen] == '/' || filePath[webDirLen] == '\0' || filePath[webDirLen] == '?')) return !0; } } pCurVirtualDir = pCurVirtualDir->next; } return 0; } /*! * \brief Converts input string to upper case. */ static void ToUpperCase( /*! Input string to be converted. */ char *s) { while (*s) { *s = (char)toupper(*s); ++s; } } /*! * \brief Finds a substring from a string in a case insensitive way. * * \return A pointer to the first occurence of s2 in s1. */ static char *StrStr( /*! Input string. */ char *s1, /*! Input sub-string. */ const char *s2) { char *Str1; char *Str2; const char *Ptr; char *ret = NULL; Str1 = strdup(s1); if (!Str1) goto error1; Str2 = strdup(s2); if (!Str2) goto error2; ToUpperCase(Str1); ToUpperCase(Str2); Ptr = strstr(Str1, Str2); if (!Ptr) ret = NULL; else ret = s1 + (Ptr - Str1); free(Str2); error2: free(Str1); error1: return ret; } /*! * \brief Finds next token in a string. * * \return Pointer to the next token. */ static char *StrTok( /*! String containing the token. */ char **Src, /*! Set of delimiter characters. */ const char *Del) { char *TmpPtr; char *RetPtr; if (*Src != NULL) { RetPtr = *Src; TmpPtr = strstr(*Src, Del); if (TmpPtr != NULL) { *TmpPtr = '\0'; *Src = TmpPtr + strlen(Del); } else *Src = NULL; return RetPtr; } return NULL; } /*! * \brief Returns a range of integers from a string. * * \return Always returns 1. */ static int GetNextRange( /*! string containing the token / range. */ char **SrcRangeStr, /*! gets the first byte of the token. */ off_t *FirstByte, /*! gets the last byte of the token. */ off_t *LastByte) { char *Ptr; char *Tok; int i; int64_t F = -1; int64_t L = -1; int Is_Suffix_byte_Range = 1; if (*SrcRangeStr == NULL) return -1; Tok = StrTok(SrcRangeStr, ","); if ((Ptr = strstr(Tok, "-")) == NULL) return -1; *Ptr = ' '; sscanf(Tok, "%" SCNd64 "%" SCNd64, &F, &L); if (F == -1 || L == -1) { *Ptr = '-'; for (i = 0; i < (int)strlen(Tok); i++) { if (Tok[i] == '-') { break; } else if (isdigit(Tok[i])) { Is_Suffix_byte_Range = 0; break; } } if (Is_Suffix_byte_Range) { *FirstByte = (off_t) L; *LastByte = (off_t) F; return 1; } } *FirstByte = (off_t) F; *LastByte = (off_t) L; return 1; } /*! * \brief Fills in the Offset, read size and contents to send out as an HTTP * Range Response. * * \return * \li \c HTTP_BAD_REQUEST * \li \c HTTP_INTERNAL_SERVER_ERROR * \li \c HTTP_REQUEST_RANGE_NOT_SATISFIABLE * \li \c HTTP_OK */ static int CreateHTTPRangeResponseHeader( /*! String containing the range. */ char *ByteRangeSpecifier, /*! Length of the file. */ off_t FileLength, /*! [out] SendInstruction object where the range operations will be stored. */ struct SendInstruction *Instr) { off_t FirstByte, LastByte; char *RangeInput; char *Ptr; int rc = 0; Instr->IsRangeActive = 1; Instr->ReadSendSize = FileLength; if (!ByteRangeSpecifier) return HTTP_BAD_REQUEST; RangeInput = strdup(ByteRangeSpecifier); if (!RangeInput) return HTTP_INTERNAL_SERVER_ERROR; /* CONTENT-RANGE: bytes 222-3333/4000 HTTP_PARTIAL_CONTENT */ if (StrStr(RangeInput, "bytes") == NULL || (Ptr = StrStr(RangeInput, "=")) == NULL) { free(RangeInput); Instr->IsRangeActive = 0; return HTTP_BAD_REQUEST; } /* Jump = */ Ptr = Ptr + 1; if (FileLength < 0) { free(RangeInput); return HTTP_REQUEST_RANGE_NOT_SATISFIABLE; } if (GetNextRange(&Ptr, &FirstByte, &LastByte) != -1) { if (FileLength < FirstByte) { free(RangeInput); return HTTP_REQUEST_RANGE_NOT_SATISFIABLE; } if (FirstByte >= 0 && LastByte >= 0 && LastByte >= FirstByte) { if (LastByte >= FileLength) LastByte = FileLength - 1; Instr->RangeOffset = FirstByte; Instr->ReadSendSize = LastByte - FirstByte + 1; /* Data between two range. */ rc = snprintf(Instr->RangeHeader, sizeof(Instr->RangeHeader), "CONTENT-RANGE: bytes %" PRId64 "-%" PRId64 "/%" PRId64 "\r\n", (int64_t)FirstByte, (int64_t)LastByte, (int64_t)FileLength); if (rc < 0 || (unsigned int) rc >= sizeof(Instr->RangeHeader)) { free(RangeInput); return HTTP_INTERNAL_SERVER_ERROR; } } else if (FirstByte >= 0 && LastByte == -1 && FirstByte < FileLength) { Instr->RangeOffset = FirstByte; Instr->ReadSendSize = FileLength - FirstByte; rc = snprintf(Instr->RangeHeader, sizeof(Instr->RangeHeader), "CONTENT-RANGE: bytes %" PRId64 "-%" PRId64 "/%" PRId64 "\r\n", (int64_t)FirstByte, (int64_t)(FileLength - 1), (int64_t)FileLength); if (rc < 0 || (unsigned int) rc >= sizeof(Instr->RangeHeader)) { free(RangeInput); return HTTP_INTERNAL_SERVER_ERROR; } } else if (FirstByte == -1 && LastByte > 0) { if (LastByte >= FileLength) { Instr->RangeOffset = 0; Instr->ReadSendSize = FileLength; rc = snprintf(Instr->RangeHeader, sizeof(Instr->RangeHeader), "CONTENT-RANGE: bytes 0-%" PRId64 "/%" PRId64 "\r\n", (int64_t)(FileLength - 1), (int64_t)FileLength); } else { Instr->RangeOffset = FileLength - LastByte; Instr->ReadSendSize = LastByte; rc = snprintf(Instr->RangeHeader, sizeof(Instr->RangeHeader), "CONTENT-RANGE: bytes %" PRId64 "-%" PRId64 "/%" PRId64 "\r\n", (int64_t)(FileLength - LastByte), (int64_t)FileLength - 1, (int64_t)FileLength); } if (rc < 0 || (unsigned int) rc >= sizeof(Instr->RangeHeader)) { free(RangeInput); return HTTP_INTERNAL_SERVER_ERROR; } } else { free(RangeInput); return HTTP_REQUEST_RANGE_NOT_SATISFIABLE; } } else { free(RangeInput); return HTTP_REQUEST_RANGE_NOT_SATISFIABLE; } free(RangeInput); return HTTP_OK; } /*! * \brief Get header id from the request parameter and take appropriate * action based on the ids as an HTTP Range Response. * * \return * \li \c HTTP_BAD_REQUEST * \li \c HTTP_INTERNAL_SERVER_ERROR * \li \c HTTP_REQUEST_RANGE_NOT_SATISFIABLE * \li \c HTTP_OK */ static int CheckOtherHTTPHeaders( /*! [in] HTTP Request message. */ http_message_t *Req, /*! [out] Send Instruction object to data for the response. */ struct SendInstruction *RespInstr, /*! Size of the file containing the request document. */ off_t FileSize) { http_header_t *header; ListNode *node; /*NNS: dlist_node* node; */ int index, RetCode = HTTP_OK; char *TmpBuf; size_t TmpBufSize = LINE_SIZE; TmpBuf = (char *)malloc(TmpBufSize); if (!TmpBuf) return HTTP_INTERNAL_SERVER_ERROR; node = ListHead(&Req->headers); while (node != NULL) { header = (http_header_t *) node->item; /* find header type. */ index = map_str_to_int((const char *)header->name.buf, header->name.length, Http_Header_Names, NUM_HTTP_HEADER_NAMES, FALSE); if (header->value.length >= TmpBufSize) { free(TmpBuf); TmpBufSize = header->value.length + 1; TmpBuf = (char *)malloc(TmpBufSize); if (!TmpBuf) return HTTP_INTERNAL_SERVER_ERROR; } memcpy(TmpBuf, header->value.buf, header->value.length); TmpBuf[header->value.length] = '\0'; if (index >= 0) { switch (Http_Header_Names[index].id) { case HDR_TE: { /* Request */ RespInstr->IsChunkActive = 1; if (strlen(TmpBuf) > strlen("gzip")) { /* means client will accept trailer. */ if (StrStr(TmpBuf, "trailers") != NULL) { RespInstr->IsTrailers = 1; } } break; } case HDR_CONTENT_LENGTH: RespInstr->RecvWriteSize = atoi(TmpBuf); break; case HDR_RANGE: RetCode = CreateHTTPRangeResponseHeader(TmpBuf, FileSize, RespInstr); if (RetCode != HTTP_OK) { free(TmpBuf); return RetCode; } break; case HDR_ACCEPT_LANGUAGE: if (header->value.length + 1 > sizeof(RespInstr->AcceptLanguageHeader)) { size_t length = sizeof(RespInstr->AcceptLanguageHeader) - 1; memcpy(RespInstr->AcceptLanguageHeader, TmpBuf, length); RespInstr->AcceptLanguageHeader[length] = '\0'; } else { memcpy(RespInstr->AcceptLanguageHeader, TmpBuf, header->value.length + 1); } break; default: /* TODO */ /* header.value is the value. */ /* case HDR_CONTENT_TYPE: return 1; case HDR_CONTENT_LANGUAGE:return 1; case HDR_LOCATION: return 1; case HDR_CONTENT_LOCATION:return 1; case HDR_ACCEPT: return 1; case HDR_ACCEPT_CHARSET: return 1; case HDR_USER_AGENT: return 1; */ /*Header check for encoding */ /* case HDR_ACCEPT_RANGE: case HDR_CONTENT_RANGE: case HDR_IF_RANGE: */ /*Header check for encoding */ /* case HDR_ACCEPT_ENCODING: if(StrStr(TmpBuf, "identity")) { break; } else return -1; case HDR_CONTENT_ENCODING: case HDR_TRANSFER_ENCODING: */ break; } } node = ListNext(&Req->headers, node); } free(TmpBuf); return RetCode; } /*! * \brief Processes the request and returns the result in the output parameters. * * \return * \li \c HTTP_BAD_REQUEST * \li \c HTTP_INTERNAL_SERVER_ERROR * \li \c HTTP_REQUEST_RANGE_NOT_SATISFIABLE * \li \c HTTP_FORBIDDEN * \li \c HTTP_NOT_FOUND * \li \c HTTP_NOT_ACCEPTABLE * \li \c HTTP_OK */ static int process_request( /*! [in] HTTP Request message. */ http_message_t *req, /*! [out] Tpye of response. */ enum resp_type *rtype, /*! [out] Headers. */ membuffer *headers, /*! [out] Get filename from request document. */ membuffer *filename, /*! [out] Xml alias document from the request document. */ struct xml_alias_t *alias, /*! [out] Send Instruction object where the response is set up. */ struct SendInstruction *RespInstr) { int code; int err_code; char *request_doc; UpnpFileInfo *finfo; time_t aux_LastModified; int using_alias; int using_virtual_dir; uri_type *url; const char *temp_str; int resp_major; int resp_minor; int alias_grabbed; size_t dummy; const char *extra_headers = NULL; print_http_headers(req); url = &req->uri; assert(req->method == HTTPMETHOD_GET || req->method == HTTPMETHOD_HEAD || req->method == HTTPMETHOD_POST || req->method == HTTPMETHOD_SIMPLEGET); /* init */ memset(&finfo, 0, sizeof(finfo)); request_doc = NULL; finfo = UpnpFileInfo_new(); alias_grabbed = FALSE; err_code = HTTP_INTERNAL_SERVER_ERROR; /* default error */ using_virtual_dir = FALSE; using_alias = FALSE; http_CalcResponseVersion(req->major_version, req->minor_version, &resp_major, &resp_minor); /* */ /* remove dots */ /* */ request_doc = malloc(url->pathquery.size + 1); if (request_doc == NULL) { goto error_handler; /* out of mem */ } memcpy(request_doc, url->pathquery.buff, url->pathquery.size); request_doc[url->pathquery.size] = '\0'; dummy = url->pathquery.size; remove_escaped_chars(request_doc, &dummy); code = remove_dots(request_doc, url->pathquery.size); if (code != 0) { err_code = HTTP_FORBIDDEN; goto error_handler; } if (*request_doc != '/') { /* no slash */ err_code = HTTP_BAD_REQUEST; goto error_handler; } if (isFileInVirtualDir(request_doc)) { using_virtual_dir = TRUE; RespInstr->IsVirtualFile = 1; if (membuffer_assign_str(filename, request_doc) != 0) { goto error_handler; } } else { /* try using alias */ if (is_valid_alias(&gAliasDoc)) { alias_grab(alias); alias_grabbed = TRUE; using_alias = get_alias(request_doc, alias, finfo); if (using_alias == TRUE) { UpnpFileInfo_set_ContentType(finfo, "text/xml; charset=\"utf-8\""); if (UpnpFileInfo_get_ContentType(finfo) == NULL) { goto error_handler; } } } } if (using_virtual_dir) { if (req->method != HTTPMETHOD_POST) { /* get file info */ if (virtualDirCallback. get_info(filename->buf, finfo) != 0) { err_code = HTTP_NOT_FOUND; goto error_handler; } /* try index.html if req is a dir */ if (UpnpFileInfo_get_IsDirectory(finfo)) { if (filename->buf[filename->length - 1] == '/') { temp_str = "index.html"; } else { temp_str = "/index.html"; } if (membuffer_append_str(filename, temp_str) != 0) { goto error_handler; } /* get info */ if (virtualDirCallback.get_info(filename->buf, finfo) != UPNP_E_SUCCESS || UpnpFileInfo_get_IsDirectory(finfo)) { err_code = HTTP_NOT_FOUND; goto error_handler; } } /* not readable */ if (!UpnpFileInfo_get_IsReadable(finfo)) { err_code = HTTP_FORBIDDEN; goto error_handler; } /* finally, get content type */ /* if ( get_content_type(filename->buf, &content_type) != 0 ) */ /*{ */ /* goto error_handler; */ /* } */ } } else if (!using_alias) { if (gDocumentRootDir.length == 0) { goto error_handler; } /* */ /* get file name */ /* */ /* filename str */ if (membuffer_assign_str(filename, gDocumentRootDir.buf) != 0 || membuffer_append_str(filename, request_doc) != 0) { goto error_handler; /* out of mem */ } /* remove trailing slashes */ while (filename->length > 0 && filename->buf[filename->length - 1] == '/') { membuffer_delete(filename, filename->length - 1, 1); } if (req->method != HTTPMETHOD_POST) { /* get info on file */ if (get_file_info(filename->buf, finfo) != 0) { err_code = HTTP_NOT_FOUND; goto error_handler; } /* try index.html if req is a dir */ if (UpnpFileInfo_get_IsDirectory(finfo)) { if (filename->buf[filename->length - 1] == '/') { temp_str = "index.html"; } else { temp_str = "/index.html"; } if (membuffer_append_str(filename, temp_str) != 0) { goto error_handler; } /* get info */ if (get_file_info(filename->buf, finfo) != 0 || UpnpFileInfo_get_IsDirectory(finfo)) { err_code = HTTP_NOT_FOUND; goto error_handler; } } /* not readable */ if (!UpnpFileInfo_get_IsReadable(finfo)) { err_code = HTTP_FORBIDDEN; goto error_handler; } } /* finally, get content type */ /* if ( get_content_type(filename->buf, &content_type) != 0 ) */ /* { */ /* goto error_handler; */ /* } */ } RespInstr->ReadSendSize = UpnpFileInfo_get_FileLength(finfo); /* Check other header field. */ code = CheckOtherHTTPHeaders(req, RespInstr, UpnpFileInfo_get_FileLength(finfo)); if (code != HTTP_OK) { err_code = code; goto error_handler; } if (req->method == HTTPMETHOD_POST) { *rtype = RESP_POST; err_code = HTTP_OK; goto error_handler; } extra_headers = UpnpFileInfo_get_ExtraHeaders(finfo); if (!extra_headers) { extra_headers = ""; } /* Check if chunked encoding should be used. */ if (using_virtual_dir && UpnpFileInfo_get_FileLength(finfo) == UPNP_USING_CHUNKED) { /* Chunked encoding is only supported by HTTP 1.1 clients */ if (resp_major == 1 && resp_minor == 1) { RespInstr->IsChunkActive = 1; } else { /* The virtual callback indicates that we should use * chunked encoding however the client doesn't support * it. Return with an internal server error. */ err_code = HTTP_NOT_ACCEPTABLE; goto error_handler; } } aux_LastModified = UpnpFileInfo_get_LastModified(finfo); if (RespInstr->IsRangeActive && RespInstr->IsChunkActive) { /* Content-Range: bytes 222-3333/4000 HTTP_PARTIAL_CONTENT */ /* Transfer-Encoding: chunked */ if (http_MakeMessage(headers, resp_major, resp_minor, "R" "T" "GKLD" "s" "tcS" "Xc" "sCc", HTTP_PARTIAL_CONTENT, /* status code */ UpnpFileInfo_get_ContentType(finfo), /* content type */ RespInstr, /* range info */ RespInstr, /* language info */ "LAST-MODIFIED: ", &aux_LastModified, X_USER_AGENT, extra_headers) != 0) { goto error_handler; } } else if (RespInstr->IsRangeActive && !RespInstr->IsChunkActive) { /* Content-Range: bytes 222-3333/4000 HTTP_PARTIAL_CONTENT */ if (http_MakeMessage(headers, resp_major, resp_minor, "R" "N" "T" "GLD" "s" "tcS" "Xc" "sCc", HTTP_PARTIAL_CONTENT, /* status code */ RespInstr->ReadSendSize, /* content length */ UpnpFileInfo_get_ContentType(finfo), /* content type */ RespInstr, /* range info */ RespInstr, /* language info */ "LAST-MODIFIED: ", &aux_LastModified, X_USER_AGENT, extra_headers) != 0) { goto error_handler; } } else if (!RespInstr->IsRangeActive && RespInstr->IsChunkActive) { /* Transfer-Encoding: chunked */ if (http_MakeMessage(headers, resp_major, resp_minor, "RK" "TLD" "s" "tcS" "Xc" "sCc", HTTP_OK, /* status code */ UpnpFileInfo_get_ContentType(finfo), /* content type */ RespInstr, /* language info */ "LAST-MODIFIED: ", &aux_LastModified, X_USER_AGENT, extra_headers) != 0) { goto error_handler; } } else { /* !RespInstr->IsRangeActive && !RespInstr->IsChunkActive */ if (RespInstr->ReadSendSize >= 0) { if (http_MakeMessage(headers, resp_major, resp_minor, "R" "N" "TLD" "s" "tcS" "Xc" "sCc", HTTP_OK, /* status code */ RespInstr->ReadSendSize, /* content length */ UpnpFileInfo_get_ContentType(finfo), /* content type */ RespInstr, /* language info */ "LAST-MODIFIED: ", &aux_LastModified, X_USER_AGENT, extra_headers) != 0) { goto error_handler; } } else { if (http_MakeMessage(headers, resp_major, resp_minor, "R" "TLD" "s" "tcS" "Xc" "sCc", HTTP_OK, /* status code */ UpnpFileInfo_get_ContentType(finfo), /* content type */ RespInstr, /* language info */ "LAST-MODIFIED: ", &aux_LastModified, X_USER_AGENT, extra_headers) != 0) { goto error_handler; } } } if (req->method == HTTPMETHOD_HEAD) { *rtype = RESP_HEADERS; } else if (using_alias) { /* GET xml */ *rtype = RESP_XMLDOC; } else if (using_virtual_dir) { *rtype = RESP_WEBDOC; } else { /* GET filename */ *rtype = RESP_FILEDOC; } /* simple get http 0.9 as specified in http 1.0 */ /* don't send headers */ if (req->method == HTTPMETHOD_SIMPLEGET) { membuffer_destroy(headers); } err_code = HTTP_OK; error_handler: free(request_doc); UpnpFileInfo_delete(finfo); if (err_code != HTTP_OK && alias_grabbed) { alias_release(alias); } return err_code; } /*! * \brief Receives the HTTP post message. * * \return * \li \c HTTP_INTERNAL_SERVER_ERROR * \li \c HTTP_UNAUTHORIZED * \li \c HTTP_BAD_REQUEST * \li \c HTTP_SERVICE_UNAVAILABLE * \li \c HTTP_OK */ static int http_RecvPostMessage( /*! HTTP Parser object. */ http_parser_t *parser, /*! [in] Socket Information object. */ SOCKINFO *info, /*! File where received data is copied to. */ char *filename, /*! Send Instruction object which gives information whether the file * is a virtual file or not. */ struct SendInstruction *Instr) { size_t Data_Buf_Size = 1024; char Buf[1024]; int Timeout = -1; FILE *Fp; parse_status_t status = PARSE_OK; int ok_on_close = FALSE; size_t entity_offset = 0; int num_read = 0; int ret_code = HTTP_OK; if (Instr && Instr->IsVirtualFile) { Fp = (virtualDirCallback.open) (filename, UPNP_WRITE); if (Fp == NULL) return HTTP_INTERNAL_SERVER_ERROR; } else { #ifdef UPNP_ENABLE_POST_WRITE Fp = fopen(filename, "wb"); if (Fp == NULL) return HTTP_UNAUTHORIZED; #else return HTTP_NOT_FOUND; #endif } parser->position = POS_ENTITY; do { /* first parse what has already been gotten */ if (parser->position != POS_COMPLETE) status = parser_parse_entity(parser); if (status == PARSE_INCOMPLETE_ENTITY) { /* read until close */ ok_on_close = TRUE; } else if ((status != PARSE_SUCCESS) && (status != PARSE_CONTINUE_1) && (status != PARSE_INCOMPLETE)) { /* error */ ret_code = HTTP_BAD_REQUEST; goto ExitFunction; } /* read more if necessary entity */ while (entity_offset + Data_Buf_Size > parser->msg.entity.length && parser->position != POS_COMPLETE) { num_read = sock_read(info, Buf, sizeof(Buf), &Timeout); if (num_read > 0) { /* append data to buffer */ if (membuffer_append(&parser->msg.msg, Buf, (size_t)num_read) != 0) { /* set failure status */ parser->http_error_code = HTTP_INTERNAL_SERVER_ERROR; ret_code = HTTP_INTERNAL_SERVER_ERROR; goto ExitFunction; } status = parser_parse_entity(parser); if (status == PARSE_INCOMPLETE_ENTITY) { /* read until close */ ok_on_close = TRUE; } else if ((status != PARSE_SUCCESS) && (status != PARSE_CONTINUE_1) && (status != PARSE_INCOMPLETE)) { ret_code = HTTP_BAD_REQUEST; goto ExitFunction; } } else if (num_read == 0) { if (ok_on_close) { UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "<<< (RECVD) <<<\n%s\n-----------------\n", parser->msg.msg.buf); print_http_headers(&parser->msg); parser->position = POS_COMPLETE; } else { /* partial msg or response */ parser->http_error_code = HTTP_BAD_REQUEST; ret_code = HTTP_BAD_REQUEST; goto ExitFunction; } } else { ret_code = HTTP_SERVICE_UNAVAILABLE; goto ExitFunction; } } if ((entity_offset + Data_Buf_Size) > parser->msg.entity.length) { Data_Buf_Size = parser->msg.entity.length - entity_offset; } memcpy(Buf, &parser->msg.msg.buf[parser->entity_start_position + entity_offset], Data_Buf_Size); entity_offset += Data_Buf_Size; if (Instr && Instr->IsVirtualFile) { int n = virtualDirCallback.write(Fp, Buf, Data_Buf_Size); if (n < 0) { ret_code = HTTP_INTERNAL_SERVER_ERROR; goto ExitFunction; } } else { size_t n = fwrite(Buf, 1, Data_Buf_Size, Fp); if (n != Data_Buf_Size) { ret_code = HTTP_INTERNAL_SERVER_ERROR; goto ExitFunction; } } } while (parser->position != POS_COMPLETE || entity_offset != parser->msg.entity.length); ExitFunction: if (Instr && Instr->IsVirtualFile) { virtualDirCallback.close(Fp); } else { fclose(Fp); } return ret_code; } void web_server_callback(http_parser_t *parser, INOUT http_message_t *req, SOCKINFO *info) { int ret; int timeout = -1; enum resp_type rtype = 0; membuffer headers; membuffer filename; struct xml_alias_t xmldoc; struct SendInstruction RespInstr; /*Initialize instruction header. */ RespInstr.IsVirtualFile = 0; RespInstr.IsChunkActive = 0; RespInstr.IsRangeActive = 0; RespInstr.IsTrailers = 0; memset(RespInstr.AcceptLanguageHeader, 0, sizeof(RespInstr.AcceptLanguageHeader)); /* init */ membuffer_init(&headers); membuffer_init(&filename); /*Process request should create the different kind of header depending on the */ /*the type of request. */ ret = process_request(req, &rtype, &headers, &filename, &xmldoc, &RespInstr); if (ret != HTTP_OK) { /* send error code */ http_SendStatusResponse(info, ret, req->major_version, req->minor_version); } else { /* send response */ switch (rtype) { case RESP_FILEDOC: http_SendMessage(info, &timeout, "Ibf", &RespInstr, headers.buf, headers.length, filename.buf); break; case RESP_XMLDOC: http_SendMessage(info, &timeout, "Ibb", &RespInstr, headers.buf, headers.length, xmldoc.doc.buf, xmldoc.doc.length); alias_release(&xmldoc); break; case RESP_WEBDOC: /*http_SendVirtualDirDoc(info, &timeout, "Ibf", &RespInstr, headers.buf, headers.length, filename.buf);*/ http_SendMessage(info, &timeout, "Ibf", &RespInstr, headers.buf, headers.length, filename.buf); break; case RESP_HEADERS: /* headers only */ http_SendMessage(info, &timeout, "b", headers.buf, headers.length); break; case RESP_POST: /* headers only */ ret = http_RecvPostMessage(parser, info, filename.buf, &RespInstr); /* Send response. */ http_MakeMessage(&headers, 1, 1, "RTLSXcCc", ret, "text/html", &RespInstr, X_USER_AGENT); http_SendMessage(info, &timeout, "b", headers.buf, headers.length); break; default: UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "webserver: Invalid response type received.\n"); assert(0); } } UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "webserver: request processed...\n"); membuffer_destroy(&headers); membuffer_destroy(&filename); } #endif /* EXCLUDE_WEB_SERVER */ pupnp-release-1.8.0/upnp/src/genlib/net/sock.c000066400000000000000000000171531303304015100211770ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ /*! * \addtogroup Sock * * @{ * * \file * * \brief Implements the sockets functionality. */ #include "config.h" #include "sock.h" #include "unixutil.h" /* for socklen_t, EAFNOSUPPORT */ #include "upnp.h" #include "UpnpStdInt.h" /* for ssize_t */ #include "upnpdebug.h" #include "upnputil.h" #include #include #include /* for F_GETFL, F_SETFL, O_NONBLOCK */ #include #include #ifdef UPNP_ENABLE_OPEN_SSL #include #endif #ifndef MSG_NOSIGNAL #define MSG_NOSIGNAL 0 #endif #ifdef UPNP_ENABLE_OPEN_SSL /* OpenSSL context defined in upnpapi.c */ extern SSL_CTX *gSslCtx; #endif int sock_init(SOCKINFO *info, SOCKET sockfd) { assert(info); memset(info, 0, sizeof(SOCKINFO)); info->socket = sockfd; return UPNP_E_SUCCESS; } int sock_init_with_ip(SOCKINFO *info, SOCKET sockfd, struct sockaddr *foreign_sockaddr) { int ret; ret = sock_init(info, sockfd); if (ret != UPNP_E_SUCCESS) { return ret; } memcpy(&info->foreign_sockaddr, foreign_sockaddr, sizeof(info->foreign_sockaddr)); return UPNP_E_SUCCESS; } #ifdef UPNP_ENABLE_OPEN_SSL int sock_ssl_connect(SOCKINFO *info) { int status = 0; info->ssl = SSL_new(gSslCtx); if (!info->ssl) { return UPNP_E_SOCKET_ERROR; } status = SSL_set_fd(info->ssl, info->socket); if (status == 1) { status = SSL_connect(info->ssl); } if (status == 1) { return UPNP_E_SUCCESS; } return UPNP_E_SOCKET_ERROR; } #endif int sock_destroy(SOCKINFO *info, int ShutdownMethod) { int ret = UPNP_E_SUCCESS; char errorBuffer[ERROR_BUFFER_LEN]; if (info->socket != INVALID_SOCKET) { #ifdef UPNP_ENABLE_OPEN_SSL if (info->ssl) { SSL_shutdown(info->ssl); SSL_free(info->ssl); info->ssl = NULL; } #endif if (shutdown(info->socket, ShutdownMethod) == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, HTTP, __FILE__, __LINE__, "Error in shutdown: %s\n", errorBuffer); } if (sock_close(info->socket) == -1) { ret = UPNP_E_SOCKET_ERROR; } info->socket = INVALID_SOCKET; } return ret; } /*! * \brief Receives or sends data. Also returns the time taken to receive or * send data. * * \return * \li \c numBytes - On Success, no of bytes received or sent or * \li \c UPNP_E_TIMEDOUT - Timeout * \li \c UPNP_E_SOCKET_ERROR - Error on socket calls */ static int sock_read_write( /*! [in] Socket Information Object. */ SOCKINFO *info, /*! [out] Buffer to get data to or send data from. */ char *buffer, /*! [in] Size of the buffer. */ size_t bufsize, /*! [in] timeout value. */ int *timeoutSecs, /*! [in] Boolean value specifying read or write option. */ int bRead) { int retCode; fd_set readSet; fd_set writeSet; struct timeval timeout; long numBytes; time_t start_time = time(NULL); SOCKET sockfd = info->socket; long bytes_sent = 0; size_t byte_left = (size_t)0; ssize_t num_written; FD_ZERO(&readSet); FD_ZERO(&writeSet); if (bRead) FD_SET(sockfd, &readSet); else FD_SET(sockfd, &writeSet); timeout.tv_sec = *timeoutSecs; timeout.tv_usec = 0; while (TRUE) { if (*timeoutSecs < 0) retCode = select(sockfd + 1, &readSet, &writeSet, NULL, NULL); else retCode = select(sockfd + 1, &readSet, &writeSet, NULL, &timeout); if (retCode == 0) return UPNP_E_TIMEDOUT; if (retCode == -1) { if (errno == EINTR) continue; return UPNP_E_SOCKET_ERROR; } else /* read or write. */ break; } #ifdef SO_NOSIGPIPE { int old; int set = 1; socklen_t olen = sizeof(old); getsockopt(sockfd, SOL_SOCKET, SO_NOSIGPIPE, &old, &olen); setsockopt(sockfd, SOL_SOCKET, SO_NOSIGPIPE, &set, sizeof(set)); #endif if (bRead) { #ifdef UPNP_ENABLE_OPEN_SSL if (info->ssl) { numBytes = (long)SSL_read(info->ssl, buffer, (size_t)bufsize); } else { #endif /* read data. */ numBytes = (long)recv(sockfd, buffer, bufsize, MSG_NOSIGNAL); #ifdef UPNP_ENABLE_OPEN_SSL } #endif } else { byte_left = bufsize; bytes_sent = 0; while (byte_left != (size_t)0) { #ifdef UPNP_ENABLE_OPEN_SSL if (info->ssl) { num_written = SSL_write(info->ssl, buffer + bytes_sent, byte_left); } else { #endif /* write data. */ num_written = send(sockfd, buffer + bytes_sent, byte_left, MSG_DONTROUTE | MSG_NOSIGNAL); #ifdef UPNP_ENABLE_OPEN_SSL } #endif if (num_written == -1) { #ifdef SO_NOSIGPIPE setsockopt(sockfd, SOL_SOCKET, SO_NOSIGPIPE, &old, olen); #endif return (int)num_written; } byte_left -= (size_t)num_written; bytes_sent += num_written; } numBytes = bytes_sent; } #ifdef SO_NOSIGPIPE setsockopt(sockfd, SOL_SOCKET, SO_NOSIGPIPE, &old, olen); } #endif if (numBytes < 0) return UPNP_E_SOCKET_ERROR; /* subtract time used for reading/writing. */ if (*timeoutSecs != 0) *timeoutSecs -= (int)(time(NULL) - start_time); return (int)numBytes; } int sock_read(SOCKINFO *info, char *buffer, size_t bufsize, int *timeoutSecs) { return sock_read_write(info, buffer, bufsize, timeoutSecs, TRUE); } int sock_write(SOCKINFO *info, const char *buffer, size_t bufsize, int *timeoutSecs) { /* Consciently removing constness. */ return sock_read_write(info, (char *)buffer, bufsize, timeoutSecs, FALSE); } int sock_make_blocking(SOCKET sock) { #ifdef WIN32 u_long val = 0; return ioctlsocket(sock, FIONBIO, &val); #else int val; val = fcntl(sock, F_GETFL, 0); if (fcntl(sock, F_SETFL, val & ~O_NONBLOCK) == -1) { return -1; } #endif return 0; } int sock_make_no_blocking(SOCKET sock) { #ifdef WIN32 u_long val = 1; return ioctlsocket(sock, FIONBIO, &val); #else /* WIN32 */ int val; val = fcntl(sock, F_GETFL, 0); if (fcntl(sock, F_SETFL, val | O_NONBLOCK) == -1) { return -1; } #endif /* WIN32 */ return 0; } /* @} Sock */ pupnp-release-1.8.0/upnp/src/genlib/net/uri/000077500000000000000000000000001303304015100206645ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/genlib/net/uri/uri.c000066400000000000000000000464171303304015100216430ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \file * * \brief Contains functions for uri, url parsing utility. */ #ifdef __FreeBSD__ #include #if __FreeBSD_version < 601103 #include #endif #endif #ifdef WIN32 #define snprintf _snprintf #endif #include #include "config.h" #include "uri.h" #include "upnpapi.h" /*! * \brief Returns a 1 if a char is a RESERVED char as defined in * http://www.ietf.org/rfc/rfc2396.txt RFC explaining URIs). * * \return 1 if char is a RESERVED char. */ static int is_reserved( /*! [in] Char to be matched for RESERVED characters. */ char in) { if (strchr(RESERVED, (int)in)) { return 1; } else { return 0; } } /*! * \brief Returns a 1 if a char is a MARK char as defined in * http://www.ietf.org/rfc/rfc2396.txt (RFC explaining URIs). * * \return 1 if char is a MARKED char. */ int is_mark( /*! [in] Char to be matched for MARKED characters. */ char in) { if (strchr(MARK, (int)in)) { return 1; } else { return 0; } } /*! * \brief Returns a 1 if a char is an UNRESERVED char as defined in * http://www.ietf.org/rfc/rfc2396.txt (RFC explaining URIs). * * \return 1 if char is a UNRESERVED char. */ int is_unreserved( /*! [in] Char to be matched for UNRESERVED characters. */ char in) { if (isalnum(in) || is_mark(in)) { return 1; } else { return 0; } } /*! * \brief Returns a 1 if a char[3] sequence is ESCAPED as defined in * http://www.ietf.org/rfc/rfc2396.txt (RFC explaining URIs). * * Size of array is NOT checked (MUST be checked by caller). * * \return 1 if char is a ESCAPED char. */ int is_escaped( /*! [in] Char sequence to be matched for ESCAPED characters. */ const char *in) { if (in[0] == '%' && isxdigit(in[1]) && isxdigit(in[2])) { return 1; } else { return 0; } } int replace_escaped(char *in, size_t index, size_t *max) { int tempInt = 0; char tempChar = 0; size_t i = (size_t)0; size_t j = (size_t)0; if (in[index] == '%' && isxdigit(in[index + (size_t)1]) && isxdigit(in[index + (size_t)2])) { /* Note the "%2x", makes sure that we convert a maximum of two * characters. */ if (sscanf(&in[index + (size_t)1], "%2x", &tempInt) != 1) { return 0; } tempChar = (char)tempInt; for (i = index + (size_t)3, j = index; j < *max; i++, j++) { in[j] = tempChar; if (i < *max) { tempChar = in[i]; } else { tempChar = 0; } } *max -= (size_t)2; return 1; } else { return 0; } } /*! * \brief Parses a string of uric characters starting at in[0] as defined in * http://www.ietf.org/rfc/rfc2396.txt (RFC explaining URIs). * * \return */ static size_t parse_uric( /*! [in] String of characters. */ const char *in, /*! [in] Maximum limit. */ size_t max, /*! [out] Token object where the string of characters is copied. */ token *out) { size_t i = (size_t)0; while (i < max && (is_unreserved(in[i]) || is_reserved(in[i]) || ((i + (size_t)2 < max) && is_escaped(&in[i])))) { i++; } out->size = i; out->buff = in; return i; } /*! * \brief Tokens are generally pointers into other strings. This copies the * offset and size from a token (in) relative to one string (in_base) into * a token (out) relative to another string (out_base). */ static void copy_token( /*! [in] Source token. */ const token *in, /*! [in] . */ const char *in_base, /*! [out] Destination token. */ token *out, /*! [in] . */ char *out_base) { out->size = in->size; out->buff = out_base + (in->buff - in_base); } int copy_URL_list(URL_list *in, URL_list *out) { size_t len = strlen(in->URLs) + (size_t)1; size_t i = (size_t)0; out->URLs = NULL; out->parsedURLs = NULL; out->size = (size_t)0; out->URLs = malloc(len); out->parsedURLs = malloc(sizeof(uri_type) * in->size); if ( !out->URLs || !out->parsedURLs) return UPNP_E_OUTOF_MEMORY; memcpy(out->URLs, in->URLs, len); for( i = (size_t)0; i < in->size; i++ ) { /*copy the parsed uri */ out->parsedURLs[i].type = in->parsedURLs[i].type; copy_token( &in->parsedURLs[i].scheme, in->URLs, &out->parsedURLs[i].scheme, out->URLs ); out->parsedURLs[i].path_type = in->parsedURLs[i].path_type; copy_token( &in->parsedURLs[i].pathquery, in->URLs, &out->parsedURLs[i].pathquery, out->URLs ); copy_token( &in->parsedURLs[i].fragment, in->URLs, &out->parsedURLs[i].fragment, out->URLs ); copy_token( &in->parsedURLs[i].hostport.text, in->URLs, &out->parsedURLs[i].hostport.text, out->URLs ); memcpy( &out->parsedURLs[i].hostport.IPaddress, &in->parsedURLs[i].hostport.IPaddress, sizeof(struct sockaddr_storage) ); } out->size = in->size; return HTTP_SUCCESS; } void free_URL_list(URL_list *list) { if (list->URLs) { free(list->URLs); } if (list->parsedURLs) { free(list->parsedURLs); } list->size = (size_t)0; } #ifdef DEBUG void print_uri(uri_type *in) { print_token(&in->scheme); print_token(&in->hostport.text); print_token(&in->pathquery); print_token(&in->fragment); } #endif /* DEBUG */ #ifdef DEBUG void print_token(token * in) { size_t i = 0; printf("Token Size : %" PRIzu "\n\'", in->size); for (i = 0; i < in->size; i++) putchar(in->buff[i]); putchar('\''); putchar('\n'); } #endif /* DEBUG */ int token_string_casecmp(token *in1, const char *in2) { size_t in2_length = strlen(in2); if (in1->size != in2_length) return 1; else return strncasecmp(in1->buff, in2, in1->size); } int token_string_cmp(token * in1, char *in2) { size_t in2_length = strlen(in2); if (in1->size != in2_length) return 1; else return strncmp(in1->buff, in2, in1->size); } int token_cmp(token *in1, token *in2) { if (in1->size != in2->size) return 1; else return memcmp(in1->buff, in2->buff, in1->size); } /*! * \brief Parses a string representing a host and port (e.g. "127.127.0.1:80" * or "localhost") and fills out a hostport_type struct with internet address * and a token representing the full host and port. * * Uses gethostbyname. */ static int parse_hostport( /*! [in] String of characters representing host and port. */ const char *in, /*! [out] Output parameter where the host and port are represented as * an internet address. */ unsigned short int defaultPort, hostport_type *out) { char workbuf[256]; char *c; struct sockaddr_in *sai4 = (struct sockaddr_in *)&out->IPaddress; struct sockaddr_in6 *sai6 = (struct sockaddr_in6 *)&out->IPaddress; char *srvname = NULL; char *srvport = NULL; char *last_dot = NULL; unsigned short int port; int af = AF_UNSPEC; size_t hostport_size; int has_port = 0; int ret; memset(out, 0, sizeof(hostport_type)); memset(workbuf, 0, sizeof(workbuf)); /* Work on a copy of the input string. */ strncpy(workbuf, in, sizeof(workbuf) - 1); c = workbuf; if (*c == '[') { /* IPv6 addresses are enclosed in square brackets. */ srvname = ++c; while (*c != '\0' && *c != ']') c++; if (*c == '\0') /* did not find closing bracket. */ return UPNP_E_INVALID_URL; /* NULL terminate the srvname and then increment c. */ *c++ = '\0'; /* overwrite the ']' */ if (*c == ':') { has_port = 1; c++; } af = AF_INET6; } else { /* IPv4 address -OR- host name. */ srvname = c; while (*c != ':' && *c != '/' && (isalnum(*c) || *c == '.' || *c == '-')) { if (*c == '.') last_dot = c; c++; } has_port = (*c == ':') ? 1 : 0; /* NULL terminate the srvname */ *c = '\0'; if (has_port == 1) c++; if (last_dot != NULL && isdigit(*(last_dot + 1))) /* Must be an IPv4 address. */ af = AF_INET; else { /* Must be a host name. */ struct addrinfo hints, *res, *res0; memset(&hints, 0, sizeof(hints)); hints.ai_family = AF_UNSPEC; hints.ai_socktype = SOCK_STREAM; ret = getaddrinfo(srvname, NULL, &hints, &res0); if (ret == 0) { for (res = res0; res; res = res->ai_next) { switch (res->ai_family) { case AF_INET: case AF_INET6: /* Found a valid IPv4 or IPv6 address. */ memcpy(&out->IPaddress, res->ai_addr, res->ai_addrlen); goto found; } } found: freeaddrinfo(res0); if (res == NULL) /* Didn't find an AF_INET or AF_INET6 address. */ return UPNP_E_INVALID_URL; } else /* getaddrinfo failed. */ return UPNP_E_INVALID_URL; } } /* Check if a port is specified. */ if (has_port == 1) { /* Port is specified. */ srvport = c; while (*c != '\0' && isdigit(*c)) c++; port = (unsigned short int)atoi(srvport); if (port == 0) /* Bad port number. */ return UPNP_E_INVALID_URL; } else /* Port was not specified, use default port. */ port = defaultPort; /* The length of the host and port string can be calculated by */ /* subtracting pointers. */ hostport_size = (size_t)c - (size_t)workbuf; /* Fill in the 'out' information. */ switch (af) { case AF_INET: sai4->sin_family = (sa_family_t)af; sai4->sin_port = htons(port); ret = inet_pton(AF_INET, srvname, &sai4->sin_addr); break; case AF_INET6: sai6->sin6_family = (sa_family_t)af; sai6->sin6_port = htons(port); sai6->sin6_scope_id = gIF_INDEX; ret = inet_pton(AF_INET6, srvname, &sai6->sin6_addr); break; default: /* IP address was set by the hostname (getaddrinfo). */ /* Override port: */ if (out->IPaddress.ss_family == (sa_family_t)AF_INET) sai4->sin_port = htons(port); else sai6->sin6_port = htons(port); ret = 1; } /* Check if address was converted successfully. */ if (ret <= 0) return UPNP_E_INVALID_URL; out->text.size = hostport_size; out->text.buff = in; return (int)hostport_size; } /*! * \brief parses a uri scheme starting at in[0] as defined in * http://www.ietf.org/rfc/rfc2396.txt (RFC explaining URIs). * * (e.g. "http:" -> scheme= "http"). * * \note String MUST include ':' within the max charcters. * * \return */ static size_t parse_scheme( /*! [in] String of characters representing a scheme. */ const char *in, /*! [in] Maximum number of characters. */ size_t max, /*! [out] Output parameter whose buffer is filled in with the scheme. */ token *out) { size_t i = (size_t)0; out->size = (size_t)0; out->buff = NULL; if( ( max == (size_t)0 ) || ( !isalpha( in[0] ) ) ) return (size_t)0; i++; while( ( i < max ) && ( in[i] != ':' ) ) { if( !( isalnum( in[i] ) || ( in[i] == '+' ) || ( in[i] == '-' ) || ( in[i] == '.' ) ) ) return (size_t)0; i++; } if( i < max ) { out->size = i; out->buff = &in[0]; return i; } return (size_t)0; } int remove_escaped_chars(INOUT char *in, INOUT size_t *size) { size_t i = (size_t)0; for (i = (size_t)0; i < *size; i++) { replace_escaped(in, i, size); } return UPNP_E_SUCCESS; } static UPNP_INLINE int is_end_path(char c) { switch (c) { case '?': case '#': case '\0': return 1; } return 0; } /* This function directly implements the "Remove Dot Segments" * algorithm described in RFC 3986 section 5.2.4. */ int remove_dots(char *buf, size_t size) { char *in = buf; char *out = buf; char *max = buf + size; while (!is_end_path(in[0])) { assert (buf <= out); assert (out <= in); assert (in < max); /* case 2.A: */ if (strncmp(in, "./", 2) == 0) { in += 2; } else if (strncmp(in, "../", 3) == 0) { in += 3; /* case 2.B: */ } else if (strncmp(in, "/./", 3) == 0) { in += 2; } else if (strncmp(in, "/.", 2) == 0 && is_end_path(in[2])) { in += 1; in[0] = '/'; /* case 2.C: */ } else if (strncmp(in, "/../", 4) == 0 || (strncmp(in, "/..", 3) == 0 && is_end_path(in[3]))) { /* Make the next character in the input buffer a '/': */ if (is_end_path(in[3])) { /* terminating "/.." case */ in += 2; in[0] = '/'; } else { /* "/../" prefix case */ in += 3; } /* Trim the last component from the output buffer, or empty it. */ while (buf < out) if (*--out == '/') break; #ifdef DEBUG if (out < in) out[0] = '\0'; #endif /* case 2.D: */ } else if (strncmp(in, ".", 1) == 0 && is_end_path(in[1])) { in += 1; } else if (strncmp(in, "..", 2) == 0 && is_end_path(in[2])) { in += 2; /* case 2.E */ } else { /* move initial '/' character (if any) */ if (in[0] == '/') *out++ = *in++; /* move first segment up to, but not including, the next '/' character */ while (in < max && in[0] != '/' && !is_end_path(in[0])) *out++ = *in++; #ifdef DEBUG if (out < in) out[0] = '\0'; #endif } } while (in < max) *out++ = *in++; if (out < max) out[0] = '\0'; return UPNP_E_SUCCESS; } char *resolve_rel_url(char *base_url, char *rel_url) { uri_type base; uri_type rel; int rv; if (!base_url) { if (!rel_url) return NULL; return strdup(rel_url); } size_t len_rel = strlen(rel_url); if (parse_uri(rel_url, len_rel, &rel) != HTTP_SUCCESS) return NULL; if (rel.type == (enum uriType)ABSOLUTE) return strdup(rel_url); size_t len_base = strlen(base_url); if ((parse_uri(base_url, len_base, &base) != HTTP_SUCCESS) || (base.type != (enum uriType)ABSOLUTE)) return NULL; if (len_rel == (size_t)0) return strdup(base_url); size_t len = len_base + len_rel + (size_t)2; char *out = (char *)malloc(len); if (out == NULL) return NULL; memset(out, 0, len); char *out_finger = out; /* scheme */ rv = snprintf(out_finger, len, "%.*s:", (int)base.scheme.size, base.scheme.buff); if (rv < 0 || rv >= (int)len) goto error; out_finger += rv; len -= (size_t)rv; /* authority */ if (rel.hostport.text.size > (size_t)0) { rv = snprintf(out_finger, len, "%s", rel_url); if (rv < 0 || rv >= (int)len) goto error; return out; } if (base.hostport.text.size > (size_t)0) { rv = snprintf(out_finger, len, "//%.*s", (int)base.hostport.text.size, base.hostport.text.buff); if (rv < 0 || rv >= (int)len) goto error; out_finger += rv; len -= (size_t)rv; } /* path */ char *path = out_finger; if (rel.path_type == (enum pathType)ABS_PATH) { rv = snprintf(out_finger, len, "%s", rel_url); } else if (base.pathquery.size == (size_t)0) { rv = snprintf(out_finger, len, "/%s", rel_url); } else { if (rel.pathquery.size == (size_t)0) { rv = snprintf(out_finger, len, "%.*s", (int)base.pathquery.size, base.pathquery.buff); } else { if (len < base.pathquery.size) goto error; size_t i = (size_t)0, prefix = (size_t)1; while (i < base.pathquery.size) { out_finger[i] = base.pathquery.buff[i]; switch (base.pathquery.buff[i++]) { case '/': prefix = i; /* fall-through */ default: continue; case '?': /* query */ if (rel.pathquery.buff[0] == '?') prefix = --i; } break; } out_finger += prefix; len -= prefix; rv = snprintf(out_finger, len, "%.*s", (int)rel.pathquery.size, rel.pathquery.buff); } if (rv < 0 || rv >= (int)len) goto error; out_finger += rv; len -= (size_t)rv; /* fragment */ if (rel.fragment.size > (size_t)0) rv = snprintf(out_finger, len, "#%.*s", (int)rel.fragment.size, rel.fragment.buff); else if (base.fragment.size > (size_t)0) rv = snprintf(out_finger, len, "#%.*s", (int)base.fragment.size, base.fragment.buff); else rv = 0; } if (rv < 0 || rv >= (int)len) goto error; out_finger += rv; len -= (size_t)rv; if (remove_dots(path, (size_t)(out_finger - path)) != UPNP_E_SUCCESS) goto error; return out; error: free(out); return NULL; } int parse_uri(const char *in, size_t max, uri_type *out) { int begin_path = 0; size_t begin_hostport = (size_t)0; size_t begin_fragment = (size_t)0; unsigned short int defaultPort = 80; begin_hostport = parse_scheme(in, max, &out->scheme); if (begin_hostport) { out->type = ABSOLUTE; out->path_type = OPAQUE_PART; begin_hostport++; } else { out->type = RELATIVE; out->path_type = REL_PATH; } if (begin_hostport + (size_t)1 < max && in[begin_hostport] == '/' && in[begin_hostport + (size_t)1] == '/') { begin_hostport += (size_t)2; if (token_string_casecmp(&out->scheme, "https") == 0) { defaultPort = 443; } begin_path = parse_hostport(&in[begin_hostport], defaultPort, &out->hostport); if (begin_path >= 0) { begin_path += (int)begin_hostport; } else return begin_path; } else { memset(&out->hostport, 0, sizeof(out->hostport)); begin_path = (int)begin_hostport; } begin_fragment = parse_uric(&in[begin_path], max - (size_t)begin_path, &out->pathquery) + (size_t)begin_path; if (out->pathquery.size && out->pathquery.buff[0] == '/') { out->path_type = ABS_PATH; } if (begin_fragment < max && in[begin_fragment] == '#') { begin_fragment++; parse_uric(&in[begin_fragment], max - begin_fragment, &out->fragment); } else { out->fragment.buff = NULL; out->fragment.size = (size_t)0; } return HTTP_SUCCESS; } int parse_uri_and_unescape(char *in, size_t max, uri_type *out) { int ret = parse_uri(in, max, out); if (ret != HTTP_SUCCESS) { return ret; } if (out->pathquery.size > (size_t)0) { remove_escaped_chars((char *)out->pathquery.buff, &out->pathquery.size); } if (out->fragment.size > (size_t)0) { remove_escaped_chars((char *)out->fragment.buff, &out->fragment.size); } return HTTP_SUCCESS; } pupnp-release-1.8.0/upnp/src/genlib/service_table/000077500000000000000000000000001303304015100221065ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/genlib/service_table/service_table.c000066400000000000000000000773271303304015100251010ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /************************************************************************ * Purpose: This file defines the functions for services. It defines * functions for adding and removing services to and from the service table, * adding and accessing subscription and other attributes pertaining to the * service ************************************************************************/ #include "config.h" #include "service_table.h" #ifdef INCLUDE_DEVICE_APIS #if EXCLUDE_GENA == 0 /************************************************************************ * Function : copy_subscription * * Parameters : * subscription *in ; Source subscription * subscription *out ; Destination subscription * * Description : Makes a copy of the subscription * * Return : int ; * HTTP_SUCCESS - On success * * Note : ************************************************************************/ int copy_subscription( subscription * in, subscription * out ) { int return_code = HTTP_SUCCESS; memcpy( out->sid, in->sid, SID_SIZE ); out->sid[SID_SIZE] = 0; out->eventKey = in->eventKey; out->ToSendEventKey = in->ToSendEventKey; out->expireTime = in->expireTime; out->active = in->active; if( ( return_code = copy_URL_list( &in->DeliveryURLs, &out->DeliveryURLs ) ) != HTTP_SUCCESS ) return return_code; out->next = NULL; return HTTP_SUCCESS; } /************************************************************************ * Function : RemoveSubscriptionSID * * Parameters : * Upnp_SID sid ; subscription ID * service_info * service ; service object providing the list of * subscriptions * * Description : Remove the subscription represented by the * const Upnp_SID sid parameter from the service table and update * the service table. * * Return : void ; * * Note : ************************************************************************/ void RemoveSubscriptionSID( Upnp_SID sid, service_info * service ) { subscription *finger = service->subscriptionList; subscription *previous = NULL; while( finger ) { if( !( strcmp( sid, finger->sid ) ) ) { if( previous ) previous->next = finger->next; else service->subscriptionList = finger->next; finger->next = NULL; freeSubscriptionList( finger ); finger = NULL; service->TotalSubscriptions--; } else { previous = finger; finger = finger->next; } } } subscription *GetSubscriptionSID(const Upnp_SID sid, service_info *service) { subscription *next = service->subscriptionList; subscription *previous = NULL; subscription *found = NULL; time_t current_time; while( ( next ) && ( found == NULL ) ) { if( !strcmp( next->sid, sid ) ) found = next; else { previous = next; next = next->next; } } if( found ) { /*get the current_time */ time( ¤t_time ); if( ( found->expireTime != 0 ) && ( found->expireTime < current_time ) ) { if( previous ) previous->next = found->next; else service->subscriptionList = found->next; found->next = NULL; freeSubscriptionList( found ); found = NULL; service->TotalSubscriptions--; } } return found; } subscription *GetNextSubscription(service_info *service, subscription *current) { time_t current_time; subscription *next = NULL; subscription *previous = NULL; int notDone = 1; /* get the current_time */ time( ¤t_time ); while( ( notDone ) && ( current ) ) { previous = current; current = current->next; if( current == NULL ) { notDone = 0; next = current; } else if( ( current->expireTime != 0 ) && ( current->expireTime < current_time ) ) { previous->next = current->next; current->next = NULL; freeSubscriptionList( current ); current = previous; service->TotalSubscriptions--; } else if( current->active ) { notDone = 0; next = current; } } return next; } subscription *GetFirstSubscription(service_info *service) { subscription temp; subscription *next = NULL; temp.next = service->subscriptionList; next = GetNextSubscription(service, &temp); service->subscriptionList = temp.next; /* service->subscriptionList = next; */ return next; } void freeSubscription(subscription *sub) { if (sub) { free_URL_list(&sub->DeliveryURLs); } } /************************************************************************ * Function : freeSubscriptionList * * Parameters : * subscription * head ; head of the subscription list * * Description : Free's memory allocated for all the subscriptions * in the service table. * * Return : void ; * * Note : ************************************************************************/ void freeSubscriptionList( subscription * head ) { subscription *next = NULL; while( head ) { next = head->next; freeSubscription( head ); free( head ); head = next; } } /************************************************************************ * Function : FindServiceId * * Parameters : * service_table *table ; service table * const char * serviceId ;string representing the service id * to be found among those in the table * const char * UDN ; string representing the UDN * to be found among those in the table * * Description : Traverses through the service table and returns a * pointer to the service node that matches a known service id * and a known UDN * * Return : service_info * - pointer to the matching service_info node; * * Note : ************************************************************************/ service_info * FindServiceId( service_table * table, const char *serviceId, const char *UDN ) { service_info *finger = NULL; if( table ) { finger = table->serviceList; while( finger ) { if( ( !strcmp( serviceId, finger->serviceId ) ) && ( !strcmp( UDN, finger->UDN ) ) ) { return finger; } finger = finger->next; } } return NULL; } /************************************************************************ * Function : FindServiceEventURLPath * * Parameters : * service_table *table ; service table * char * eventURLPath ; event URL path used to find a service * from the table * * Description : Traverses the service table and finds the node whose * event URL Path matches a know value * * Return : service_info * - pointer to the service list node from the * service table whose event URL matches a known event URL; * * Note : ************************************************************************/ service_info * FindServiceEventURLPath( service_table * table, char *eventURLPath ) { service_info *finger = NULL; uri_type parsed_url; uri_type parsed_url_in; if( ( table ) && ( parse_uri( eventURLPath, strlen( eventURLPath ), &parsed_url_in ) == HTTP_SUCCESS ) ) { finger = table->serviceList; while( finger ) { if( finger->eventURL ) if( ( parse_uri ( finger->eventURL, strlen( finger->eventURL ), &parsed_url ) == HTTP_SUCCESS ) ) { if( !token_cmp ( &parsed_url.pathquery, &parsed_url_in.pathquery ) ) return finger; } finger = finger->next; } } return NULL; } #endif /* EXCLUDE_GENA */ /************************************************************************ * Function : FindServiceControlURLPath * * Parameters : * service_table * table ; service table * char * controlURLPath ; control URL path used to find a service * from the table * * Description : Traverses the service table and finds the node whose * control URL Path matches a know value * * Return : service_info * - pointer to the service list node from the * service table whose control URL Path matches a known value; * * Note : ************************************************************************/ #if EXCLUDE_SOAP == 0 service_info * FindServiceControlURLPath( service_table * table, const char *controlURLPath ) { service_info *finger = NULL; uri_type parsed_url; uri_type parsed_url_in; if( ( table ) && ( parse_uri ( controlURLPath, strlen( controlURLPath ), &parsed_url_in ) == HTTP_SUCCESS ) ) { finger = table->serviceList; while( finger ) { if( finger->controlURL ) if( ( parse_uri ( finger->controlURL, strlen( finger->controlURL ), &parsed_url ) == HTTP_SUCCESS) ) { if( !token_cmp ( &parsed_url.pathquery, &parsed_url_in.pathquery ) ) return finger; } finger = finger->next; } } return NULL; } #endif /* EXCLUDE_SOAP */ /************************************************************************ * Function : printService * * Parameters : * service_info *service ;Service whose information is to be printed * Upnp_LogLevel level ; Debug level specified to the print function * Dbg_Module module ; Debug module specified to the print function * * Description : For debugging purposes prints information from the * service passed into the function. * * Return : void ; * * Note : ************************************************************************/ #ifdef DEBUG void printService( service_info *service, Upnp_LogLevel level, Dbg_Module module ) { if( service ) { if( service->serviceType ) { UpnpPrintf( level, module, __FILE__, __LINE__, "serviceType: %s\n", service->serviceType ); } if( service->serviceId ) { UpnpPrintf( level, module, __FILE__, __LINE__, "serviceId: %s\n", service->serviceId ); } if( service->SCPDURL ) { UpnpPrintf( level, module, __FILE__, __LINE__, "SCPDURL: %s\n", service->SCPDURL ); } if( service->controlURL ) { UpnpPrintf( level, module, __FILE__, __LINE__, "controlURL: %s\n", service->controlURL ); } if( service->eventURL ) { UpnpPrintf( level, module, __FILE__, __LINE__, "eventURL: %s\n", service->eventURL ); } if( service->UDN ) { UpnpPrintf( level, module, __FILE__, __LINE__, "UDN: %s\n\n", service->UDN ); } if( service->active ) { UpnpPrintf( level, module, __FILE__, __LINE__, "Service is active\n" ); } else { UpnpPrintf( level, module, __FILE__, __LINE__, "Service is inactive\n" ); } } } #endif /************************************************************************ * Function : printServiceList * * Parameters : * service_info *service ; Service whose information is to be printed * Upnp_LogLevel level ; Debug level specified to the print function * Dbg_Module module ; Debug module specified to the print function * * Description : For debugging purposes prints information of each * service from the service table passed into the function. * * Return : void ; * * Note : ************************************************************************/ #ifdef DEBUG void printServiceList( service_info * service, Upnp_LogLevel level, Dbg_Module module ) { while( service ) { if( service->serviceType ) { UpnpPrintf( level, module, __FILE__, __LINE__, "serviceType: %s\n", service->serviceType ); } if( service->serviceId ) { UpnpPrintf( level, module, __FILE__, __LINE__, "serviceId: %s\n", service->serviceId ); } if( service->SCPDURL ) { UpnpPrintf( level, module, __FILE__, __LINE__, "SCPDURL: %s\n", service->SCPDURL ); } if( service->controlURL ) { UpnpPrintf( level, module, __FILE__, __LINE__, "controlURL: %s\n", service->controlURL ); } if( service->eventURL ) { UpnpPrintf( level, module, __FILE__, __LINE__, "eventURL: %s\n", service->eventURL ); } if( service->UDN ) { UpnpPrintf( level, module, __FILE__, __LINE__, "UDN: %s\n\n", service->UDN ); } if( service->active ) { UpnpPrintf( level, module, __FILE__, __LINE__, "Service is active\n" ); } else { UpnpPrintf( level, module, __FILE__, __LINE__, "Service is inactive\n" ); } service = service->next; } } #endif /************************************************************************ * Function : printServiceTable * * Parameters : * service_table * table ; Service table to be printed * Upnp_LogLevel level ; Debug level specified to the print function * Dbg_Module module ; Debug module specified to the print function * * Description : For debugging purposes prints the URL base of the table * and information of each service from the service table passed into * the function. * * Return : void ; * * Note : ************************************************************************/ #ifdef DEBUG void printServiceTable( service_table * table, Upnp_LogLevel level, Dbg_Module module ) { UpnpPrintf( level, module, __FILE__, __LINE__, "URL_BASE: %s\n", table->URLBase ); UpnpPrintf( level, module, __FILE__, __LINE__, "Services: \n" ); printServiceList( table->serviceList, level, module );} #endif #if EXCLUDE_GENA == 0 /************************************************************************ * Function : freeService * * Parameters : * service_info *in ; service information that is to be freed * * Description : Free's memory allocated for the various components * of the service entry in the service table. * * Return : void ; * * Note : ************************************************************************/ void freeService( service_info * in ) { if( in ) { if( in->serviceType ) ixmlFreeDOMString( in->serviceType ); if( in->serviceId ) ixmlFreeDOMString( in->serviceId ); if( in->SCPDURL ) free( in->SCPDURL ); if( in->controlURL ) free( in->controlURL ); if( in->eventURL ) free( in->eventURL ); if( in->UDN ) ixmlFreeDOMString( in->UDN ); if( in->subscriptionList ) freeSubscriptionList( in->subscriptionList ); in->TotalSubscriptions = 0; free( in ); } } /************************************************************************ * Function : freeServiceList * * Parameters : * service_info * head ; Head of the service list to be freed * * Description : Free's memory allocated for the various components * of each service entry in the service table. * * Return : void ; * * Note : ************************************************************************/ void freeServiceList( service_info * head ) { service_info *next = NULL; while( head ) { if( head->serviceType ) ixmlFreeDOMString( head->serviceType ); if( head->serviceId ) ixmlFreeDOMString( head->serviceId ); if( head->SCPDURL ) free( head->SCPDURL ); if( head->controlURL ) free( head->controlURL ); if( head->eventURL ) free( head->eventURL ); if( head->UDN ) ixmlFreeDOMString( head->UDN ); if( head->subscriptionList ) freeSubscriptionList( head->subscriptionList ); head->TotalSubscriptions = 0; next = head->next; free( head ); head = next; } } /************************************************************************ * Function : freeServiceTable * * Parameters : * service_table * table ; Service table whose memory needs to be * freed * * Description : Free's dynamic memory in table. * (does not free table, only memory within the structure) * * Return : void ; * * Note : ************************************************************************/ void freeServiceTable( service_table * table ) { ixmlFreeDOMString( table->URLBase ); freeServiceList( table->serviceList ); table->serviceList = NULL; table->endServiceList = NULL; } /************************************************************************ * Function : getElementValue * * Parameters : * IXML_Node *node ; Input node which provides the list of child * nodes * * Description : Returns the clone of the element value * * Return : DOMString ; * * Note : value must be freed with DOMString_free ************************************************************************/ DOMString getElementValue( IXML_Node * node ) { IXML_Node *child = ( IXML_Node * ) ixmlNode_getFirstChild( node ); const DOMString temp = NULL; if( ( child != 0 ) && ( ixmlNode_getNodeType( child ) == eTEXT_NODE ) ) { temp = ixmlNode_getNodeValue( child ); return ixmlCloneDOMString( temp ); } else { return NULL; } } /************************************************************************ * Function : getSubElement * * Parameters : * const char *element_name ; sub element name to be searched for * IXML_Node *node ; Input node which provides the list of child * nodes * IXML_Node **out ; Ouput node to which the matched child node is * returned. * * Description : Traverses through a list of XML nodes to find the * node with the known element name. * * Return : int ; * 1 - On Success * 0 - On Failure * * Note : ************************************************************************/ int getSubElement( const char *element_name, IXML_Node * node, IXML_Node ** out ) { const DOMString NodeName = NULL; int found = 0; IXML_Node *child = ( IXML_Node * ) ixmlNode_getFirstChild( node ); ( *out ) = NULL; while( ( child != NULL ) && ( !found ) ) { switch ( ixmlNode_getNodeType( child ) ) { case eELEMENT_NODE: NodeName = ixmlNode_getNodeName( child ); if( !strcmp( NodeName, element_name ) ) { ( *out ) = child; found = 1; return found; } break; default: break; } child = ( IXML_Node * ) ixmlNode_getNextSibling( child ); } return found; } /************************************************************************ * Function : getServiceList * * Parameters : * IXML_Node *node ; XML node information * service_info **end ; service added is returned to the output * parameter * char * URLBase ; provides Base URL to resolve relative URL * * Description : Returns pointer to service info after getting the * sub-elements of the service info. * * Return : service_info * - pointer to the service info node ; * * Note : ************************************************************************/ service_info *getServiceList( IXML_Node *node, service_info **end, char *URLBase) { IXML_Node *serviceList = NULL; IXML_Node *current_service = NULL; IXML_Node *UDN = NULL; IXML_Node *serviceType = NULL; IXML_Node *serviceId = NULL; IXML_Node *SCPDURL = NULL; IXML_Node *controlURL = NULL; IXML_Node *eventURL = NULL; DOMString tempDOMString = NULL; service_info *head = NULL; service_info *current = NULL; service_info *previous = NULL; IXML_NodeList *serviceNodeList = NULL; long unsigned int NumOfServices = 0lu; long unsigned int i = 0lu; int fail = 0; if (getSubElement("UDN", node, &UDN) && getSubElement("serviceList", node, &serviceList)) { serviceNodeList = ixmlElement_getElementsByTagName( (IXML_Element *)serviceList, "service"); if (serviceNodeList != NULL) { NumOfServices = ixmlNodeList_length(serviceNodeList); for (i = 0lu; i < NumOfServices; i++) { current_service = ixmlNodeList_item(serviceNodeList, i); fail = 0; if (current) { current->next = malloc(sizeof(service_info)); previous = current; current = current->next; } else { head = malloc(sizeof(service_info)); current = head; } if (!current) { freeServiceList(head); ixmlNodeList_free(serviceNodeList); return NULL; } current->next = NULL; current->controlURL = NULL; current->eventURL = NULL; current->serviceType = NULL; current->serviceId = NULL; current->SCPDURL = NULL; current->active = 1; current->subscriptionList = NULL; current->TotalSubscriptions = 0; if (!(current->UDN = getElementValue(UDN))) fail = 1; if (!getSubElement("serviceType", current_service, &serviceType) || !(current->serviceType = getElementValue(serviceType))) fail = 1; if (!getSubElement("serviceId", current_service, &serviceId) || !(current->serviceId = getElementValue(serviceId))) fail = 1; if (!getSubElement("SCPDURL", current_service, &SCPDURL) || !(tempDOMString = getElementValue(SCPDURL)) || !(current->SCPDURL = resolve_rel_url(URLBase, tempDOMString))) fail = 1; ixmlFreeDOMString(tempDOMString); tempDOMString = NULL; if (!(getSubElement("controlURL", current_service, &controlURL)) || !(tempDOMString = getElementValue(controlURL)) || !(current->controlURL = resolve_rel_url(URLBase, tempDOMString))) { UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "BAD OR MISSING CONTROL URL"); UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "CONTROL URL SET TO NULL IN SERVICE INFO"); current->controlURL = NULL; fail = 0; } ixmlFreeDOMString(tempDOMString); tempDOMString = NULL; if (!getSubElement("eventSubURL", current_service, &eventURL) || !(tempDOMString = getElementValue(eventURL)) || !(current->eventURL = resolve_rel_url(URLBase, tempDOMString))) { UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "BAD OR MISSING EVENT URL"); UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, "EVENT URL SET TO NULL IN SERVICE INFO"); current->eventURL = NULL; fail = 0; } ixmlFreeDOMString(tempDOMString); tempDOMString = NULL; if (fail) { freeServiceList(current); if (previous) previous->next = NULL; else head = NULL; current = previous; } } ixmlNodeList_free(serviceNodeList); } (*end) = current; return head; } else { (*end) = NULL; return NULL; } } /************************************************************************ * Function : getAllServiceList * * Parameters : * IXML_Node *node ; XML node information * char * URLBase ; provides Base URL to resolve relative URL * service_info **out_end ; service added is returned to the output * parameter * * Description : Returns pointer to service info after getting the * sub-elements of the service info. * * Return : service_info * ; * * Note : ************************************************************************/ service_info * getAllServiceList( IXML_Node * node, char *URLBase, service_info ** out_end ) { service_info *head = NULL; service_info *end = NULL; service_info *next_end = NULL; IXML_NodeList *deviceList = NULL; IXML_Node *currentDevice = NULL; long unsigned int NumOfDevices = 0lu; long unsigned int i = 0lu; (*out_end) = NULL; deviceList = ixmlElement_getElementsByTagName( (IXML_Element *)node, "device"); if (deviceList) { NumOfDevices = ixmlNodeList_length(deviceList); for (i = 0lu; i < NumOfDevices; i++) { currentDevice = ixmlNodeList_item(deviceList, i); if (head) { end->next = getServiceList(currentDevice, &next_end, URLBase); if (next_end) end = next_end; } else head = getServiceList(currentDevice, &end, URLBase); } ixmlNodeList_free(deviceList); } (*out_end) = end; return head; } /************************************************************************ * Function : removeServiceTable * * Parameters : * IXML_Node *node ; XML node information * service_table *in ; service table from which services will be * removed * * Description : This function assumes that services for a particular * root device are placed linearly in the service table, and in the * order in which they are found in the description document * all services for this root device are removed from the list * * Return : int ; * * Note : ************************************************************************/ int removeServiceTable( IXML_Node * node, service_table * in ) { IXML_Node *root = NULL; IXML_Node *currentUDN = NULL; DOMString UDN = NULL; IXML_NodeList *deviceList = NULL; service_info *current_service = NULL; service_info *start_search = NULL; service_info *prev_service = NULL; long unsigned int NumOfDevices = 0lu; long unsigned int i = 0lu; if( getSubElement( "root", node, &root ) ) { start_search = in->serviceList; deviceList = ixmlElement_getElementsByTagName( ( IXML_Element * ) root, "device" ); if( deviceList != NULL ) { NumOfDevices = ixmlNodeList_length( deviceList ); for( i = 0lu; i < NumOfDevices; i++ ) { if( ( start_search ) && ( ( getSubElement( "UDN", node, ¤tUDN ) ) && ( UDN = getElementValue( currentUDN ) ) ) ) { current_service = start_search; /*Services are put in the service table in the order in which they appear in the */ /*description document, therefore we go through the list only once to remove a particular */ /*root device */ while( ( current_service ) && ( strcmp( current_service->UDN, UDN ) ) ) { current_service = current_service->next; if( current_service != NULL) prev_service = current_service->next; } while( ( current_service ) && ( !strcmp( current_service->UDN, UDN ) ) ) { if( prev_service ) { prev_service->next = current_service->next; } else { in->serviceList = current_service->next; } if( current_service == in->endServiceList ) in->endServiceList = prev_service; start_search = current_service->next; freeService( current_service ); current_service = start_search; } ixmlFreeDOMString( UDN ); UDN = NULL; } } ixmlNodeList_free( deviceList ); } } return 1; } /************************************************************************ * Function : addServiceTable * * Parameters : * IXML_Node *node ; XML node information * service_table *in ; service table that will be initialized with * services * const char *DefaultURLBase ; Default base URL on which the URL * will be returned to the service list. * * Description : Add Service to the table. * * Return : int ; * * Note : ************************************************************************/ int addServiceTable( IXML_Node * node, service_table * in, const char *DefaultURLBase ) { IXML_Node *root = NULL; IXML_Node *URLBase = NULL; service_info *tempEnd = NULL; if( in->URLBase ) { free( in->URLBase ); in->URLBase = NULL; } if( getSubElement( "root", node, &root ) ) { if( getSubElement( "URLBase", root, &URLBase ) ) { in->URLBase = getElementValue( URLBase ); } else { if( DefaultURLBase ) { in->URLBase = ixmlCloneDOMString( DefaultURLBase ); } else { in->URLBase = ixmlCloneDOMString( "" ); } } if( ( in->endServiceList->next = getAllServiceList( root, in->URLBase, &tempEnd ) ) ) { in->endServiceList = tempEnd; return 1; } } return 0; } /************************************************************************ * Function : getServiceTable * * Parameters : * IXML_Node *node ; XML node information * service_table *out ; output parameter which will contain the * service list and URL * const char *DefaultURLBase ; Default base URL on which the URL * will be returned. * * Description : Retrieve service from the table * * Return : int ; * * Note : ************************************************************************/ int getServiceTable( IXML_Node * node, service_table * out, const char *DefaultURLBase ) { IXML_Node *root = NULL; IXML_Node *URLBase = NULL; if( getSubElement( "root", node, &root ) ) { if( getSubElement( "URLBase", root, &URLBase ) ) { out->URLBase = getElementValue( URLBase ); } else { if( DefaultURLBase ) { out->URLBase = ixmlCloneDOMString( DefaultURLBase ); } else { out->URLBase = ixmlCloneDOMString( "" ); } } if( ( out->serviceList = getAllServiceList( root, out->URLBase, &out->endServiceList ) ) ) { return 1; } } return 0; } #endif /* EXCLUDE_GENA */ #endif /* INCLUDE_DEVICE_APIS */ pupnp-release-1.8.0/upnp/src/genlib/util/000077500000000000000000000000001303304015100202545ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/genlib/util/membuffer.c000066400000000000000000000155531303304015100224010ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /* * \file * * \brief This file contains functions that operate on memory and buffers, * allocation, re-allocation, and modification of the memory */ #include "config.h" #include #include #include #include "membuffer.h" #include "upnp.h" #include "unixutil.h" char *str_alloc(const char *str, size_t str_len) { char *s; s = (char *)malloc(str_len + (size_t)1); if (s == NULL) { return NULL; /* no mem */ } memcpy(s, str, str_len); s[str_len] = '\0'; return s; } int memptr_cmp(memptr * m, const char *s) { int cmp; cmp = strncmp(m->buf, s, m->length); if (cmp == 0 && m->length < strlen(s)) { /* both strings equal for 'm->length' chars */ /* if m is shorter than s, then s is greater */ return -1; } return cmp; } int memptr_cmp_nocase(memptr * m, const char *s) { int cmp; cmp = strncasecmp(m->buf, s, m->length); if (cmp == 0 && m->length < strlen(s)) { /* both strings equal for 'm->length' chars */ /* if m is shorter than s, then s is greater */ return -1; } return cmp; } /*! * \brief Initialize the buffer. */ static UPNP_INLINE void membuffer_initialize( /*! [in,out] Buffer to be initialized. */ membuffer *m) { m->buf = NULL; m->length = (size_t)0; m->capacity = (size_t)0; } int membuffer_set_size(membuffer *m, size_t new_length) { size_t diff; size_t alloc_len; char *temp_buf; if (new_length >= m->length) { /* increase length */ /* need more mem? */ if (new_length <= m->capacity) { return 0; /* have enough mem; done */ } diff = new_length - m->length; alloc_len = MAXVAL(m->size_inc, diff) + m->capacity; } else { /* decrease length */ assert(new_length <= m->length); /* if diff is 0..m->size_inc, don't free */ if ((m->capacity - new_length) <= m->size_inc) { return 0; } alloc_len = new_length + m->size_inc; } assert(alloc_len >= new_length); temp_buf = realloc(m->buf, alloc_len + (size_t)1); /*LEAK_FIX_MK */ /*temp_buf = Realloc( m->buf,m->length, alloc_len + 1 );LEAK_FIX_MK */ if (temp_buf == NULL) { /* try smaller size */ alloc_len = new_length; temp_buf = realloc(m->buf, alloc_len + (size_t)1); /*LEAK_FIX_MK */ /*temp_buf = Realloc( m->buf,m->length, alloc_len + 1 );LEAK_FIX_MK */ if (temp_buf == NULL) { return UPNP_E_OUTOF_MEMORY; } } /* save */ m->buf = temp_buf; m->capacity = alloc_len; return 0; } void membuffer_init(membuffer *m) { assert(m != NULL); m->size_inc = MEMBUF_DEF_SIZE_INC; membuffer_initialize(m); } void membuffer_destroy(membuffer *m) { if (m == NULL) { return; } free(m->buf); membuffer_init(m); } int membuffer_assign(membuffer *m, const void *buf, size_t buf_len) { int return_code; assert(m != NULL); /* set value to null */ if (buf == NULL) { membuffer_destroy(m); return 0; } /* alloc mem */ return_code = membuffer_set_size(m, buf_len); if (return_code != 0) return return_code; /* copy */ if (buf_len) { memcpy(m->buf, buf, buf_len); m->buf[buf_len] = 0; /* null-terminate */ } m->length = buf_len; return 0; } int membuffer_assign_str(membuffer *m, const char *c_str) { return membuffer_assign(m, c_str, strlen(c_str)); } int membuffer_append(membuffer *m, const void *buf, size_t buf_len) { assert(m != NULL); return membuffer_insert(m, buf, buf_len, m->length); } int membuffer_append_str(membuffer *m, const char *c_str) { return membuffer_insert(m, c_str, strlen(c_str), m->length); } int membuffer_insert(membuffer * m, const void *buf, size_t buf_len, size_t index) { int return_code; assert(m != NULL); if (index > m->length) return UPNP_E_OUTOF_BOUNDS; if (!buf || !buf_len) { return 0; } /* alloc mem */ return_code = membuffer_set_size(m, m->length + buf_len); if (return_code) { return return_code; } /* insert data */ /* move data to right of insertion point */ memmove(m->buf + index + buf_len, m->buf + index, m->length - index); memcpy(m->buf + index, buf, buf_len); m->length += buf_len; /* null-terminate */ m->buf[m->length] = 0; return 0; } void membuffer_delete(membuffer * m, size_t index, size_t num_bytes) { int return_value; size_t new_length; size_t copy_len; assert(m != NULL); if (!m || !m->length) return; /* shrink count if it goes beyond buffer */ if (index + num_bytes > m->length) { num_bytes = m->length - index; /* every thing at and after index purged */ copy_len = (size_t)0; } else { /* calc num bytes after deleted string */ copy_len = m->length - (index + num_bytes); } memmove(m->buf + index, m->buf + index + num_bytes, copy_len); new_length = m->length - num_bytes; /* trim buffer */ return_value = membuffer_set_size(m, new_length); /* shrinking should always work */ assert(return_value == 0); if (return_value != 0) return; /* don't modify until buffer is set */ m->length = new_length; m->buf[new_length] = 0; } char *membuffer_detach(membuffer *m) { char *buf; assert(m != NULL); buf = m->buf; /* free all */ membuffer_initialize(m); return buf; } void membuffer_attach(membuffer *m, char *new_buf, size_t buf_len) { assert(m != NULL); membuffer_destroy(m); m->buf = new_buf; m->length = buf_len; m->capacity = buf_len; } pupnp-release-1.8.0/upnp/src/genlib/util/strintmap.c000066400000000000000000000111001303304015100224320ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /************************************************************************ * Purpose: This file contains string to integer and integer to string * conversion functions ************************************************************************/ #include "config.h" #include "strintmap.h" #include "membuffer.h" /************************************************************************ * Function : map_str_to_int * * Parameters : * IN const char* name ; string containing the name to be matched * IN size_t name_len ; size of the string to be matched * IN str_int_entry* table ; table of entries that need to be * matched. * IN int num_entries ; number of entries in the table that need * to be searched. * IN int case_sensitive ; whether the case should be case * sensitive or not * * Description : Match the given name with names from the entries in the * table. Returns the index of the table when the entry is found. * * Return : int ; * index - On Success * -1 - On failure * * Note : ************************************************************************/ int map_str_to_int( IN const char *name, IN size_t name_len, IN str_int_entry * table, IN int num_entries, IN int case_sensitive ) { int top, mid, bot; int cmp; memptr name_ptr; name_ptr.buf = ( char * )name; name_ptr.length = name_len; top = 0; bot = num_entries - 1; while( top <= bot ) { mid = ( top + bot ) / 2; if( case_sensitive ) { /*cmp = strcmp( name, table[mid].name ); */ cmp = memptr_cmp( &name_ptr, table[mid].name ); } else { /*cmp = strcasecmp( name, table[mid].name ); */ cmp = memptr_cmp_nocase( &name_ptr, table[mid].name ); } if( cmp > 0 ) { top = mid + 1; /* look below mid */ } else if( cmp < 0 ) { bot = mid - 1; /* look above mid */ } else /* cmp == 0 */ { return mid; /* match; return table index */ } } return -1; /* header name not found */ } /************************************************************************ * Function : map_int_to_str * * Parameters : * IN int id ; ID to be matched * IN str_int_entry* table ; table of entries that need to be * matched. * IN int num_entries ; number of entries in the table that need * to be searched. * * Description : Returns the index from the table where the id matches * the entry from the table. * * Return : int ; * * Note : ************************************************************************/ int map_int_to_str( IN int id, IN str_int_entry * table, IN int num_entries ) { int i; for( i = 0; i < num_entries; i++ ) { if( table[i].id == id ) { return i; } } return -1; } pupnp-release-1.8.0/upnp/src/genlib/util/upnp_timeout.c000066400000000000000000000040241303304015100231500ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * * Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \file * * \brief Contains a function for freeing the memory associated with a upnp * time out event. */ #include "config.h" #include "upnp_timeout.h" #include /* for free() */ void free_upnp_timeout(upnp_timeout *event) { if (event) { if (event->Event) { free(event->Event); } free(event); } } pupnp-release-1.8.0/upnp/src/genlib/util/util.c000066400000000000000000000047721303304015100214070ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \file * * Purpose: This file contains functions for copying strings based on * different options. */ #include "config.h" #include "upnp.h" #include "upnputil.h" #include void linecopy(char dest[LINE_SIZE], const char *src) { strncpy(dest, src, LINE_SIZE - (size_t)1); /* null-terminate if len(src) >= LINE_SIZE. */ dest[LINE_SIZE - 1] = '\0'; } void namecopy(char dest[NAME_SIZE], const char *src) { strncpy(dest, src, NAME_SIZE - (size_t)1); /* null-terminate if len(src) >= NAME_SIZE. */ dest[NAME_SIZE - 1] = '\0'; } void linecopylen(char dest[LINE_SIZE], const char *src, size_t srclen) { size_t len; len = srclen < (LINE_SIZE - (size_t)1) ? srclen : (LINE_SIZE - (size_t)1); strncpy(dest, src, len); dest[len] = '\0'; } pupnp-release-1.8.0/upnp/src/inc/000077500000000000000000000000001303304015100166105ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/inc/ClientSubscription.h000066400000000000000000000011031303304015100225770ustar00rootroot00000000000000 #ifndef CLIENTSUBSCRIPTION_H #define CLIENTSUBSCRIPTION_H /*! * \file * * \brief GenlibClientSubscription object declararion. * * \author Marcelo Roberto Jimenez */ #define CLASS GenlibClientSubscription #define EXPAND_CLASS_MEMBERS(CLASS) \ EXPAND_CLASS_MEMBER_INT(CLASS, RenewEventId, int) \ EXPAND_CLASS_MEMBER_STRING(CLASS, SID) \ EXPAND_CLASS_MEMBER_STRING(CLASS, ActualSID) \ EXPAND_CLASS_MEMBER_STRING(CLASS, EventURL) \ EXPAND_CLASS_MEMBER_INT(CLASS, Next, GenlibClientSubscription *) \ #include "TemplateInclude.h" #endif /* CLIENTSUBSCRIPTION_H */ pupnp-release-1.8.0/upnp/src/inc/VirtualDir.h000066400000000000000000000046541303304015100210570ustar00rootroot00000000000000 #ifndef VIRTUALDIR_H #define VIRTUALDIR_H /** The \b VirtualDirCallbacks structure contains the pointers to * file-related callback functions a device application can register to * virtualize URLs. */ struct VirtualDirCallbacks { /** Called by the web server to query information on a file. The callback * should return 0 on success or -1 on an error. */ VDCallback_GetInfo get_info; /** Called by the web server to open a file. The callback should return * a valid handle if the file can be opened. Otherwise, it should return * \c NULL to signify an error. */ VDCallback_Open open; /** Called by the web server to perform a sequential read from an open * file. The callback should copy \b buflen bytes from the file into * the buffer. * @return An integer representing one of the following: * \li 0: The file contains no more data (EOF). * \li > 0: A successful read of the number of bytes in the * return code. * \li < 0: An error occurred reading the file. */ VDCallback_Read read; /** Called by the web server to perform a sequential write to an open * file. The callback should write \b buflen bytes into the file from * the buffer. It should return the actual number of bytes written, * which might be less than \b buflen in the case of a write error. */ VDCallback_Write write; /** Called by the web server to move the file pointer, or offset, into * an open file. The \b origin parameter determines where to start * moving the file pointer. A value of \c SEEK_CUR moves the * file pointer relative to where it is. The \b offset parameter can * be either positive (move forward) or negative (move backward). * \c SEEK_END moves relative to the end of the file. A positive * \b offset extends the file. A negative \b offset moves backward * in the file. Finally, \c SEEK_SET moves to an absolute position in * the file. In this case, \b offset must be positive. The callback * should return 0 on a successful seek or a non-zero value on an error. */ VDCallback_Seek seek; /** Called by the web server to close a file opened via the \b open * callback. It should return 0 on success, or a non-zero value on an * error. */ VDCallback_Close close; }; typedef struct virtual_Dir_List { struct virtual_Dir_List *next; char dirName[NAME_SIZE]; } virtualDirList; #endif /* VIRTUALDIR_H */ pupnp-release-1.8.0/upnp/src/inc/client_table.h000066400000000000000000000037311303304015100214120ustar00rootroot00000000000000 #ifndef CLIENT_TABLE_H #define CLIENT_TABLE_H /*! * \file */ #ifdef __cplusplus extern "C" { #endif #include "ClientSubscription.h" #include "service_table.h" #include "upnp.h" #include "UpnpString.h" #include "upnp_timeout.h" #include "uri.h" #include "TimerThread.h" #include #include #include extern TimerThread gTimerThread; #ifdef INCLUDE_CLIENT_APIS /*! * \brief Free memory allocated for client subscription data. * * Remove timer thread associated with this subscription event. */ void free_client_subscription( /*! [in] Client subscription to be freed. */ GenlibClientSubscription *sub); /*! * \brief Free the client subscription table. */ void freeClientSubList( /*! [in] Client subscription list to be freed. */ GenlibClientSubscription *list); /*! * \brief Remove the client subscription matching the subscritpion id * represented by the const Upnp_SID sid parameter from the table and * update the table. */ void RemoveClientSubClientSID( /*! [in] Head of the subscription list. */ GenlibClientSubscription **head, /*! [in] Subscription ID to be mactched. */ const UpnpString *sid); /*! * \brief Return the client subscription from the client table that matches * const Upnp_SID sid subscrition id value. * * \return The matching subscription. */ GenlibClientSubscription *GetClientSubClientSID( /*! [in] Head of the subscription list. */ GenlibClientSubscription *head, /*! [in] Subscription ID to be mactched. */ const UpnpString *sid); /*! * \brief Returns the client subscription from the client subscription table * that has the matching token *sid buffer value. * * \return The matching subscription. */ GenlibClientSubscription *GetClientSubActualSID( /*! [in] Head of the subscription list. */ GenlibClientSubscription *head, /*! [in] Subscription ID to be mactched. */ token *sid); #endif /* INCLUDE_CLIENT_APIS */ #ifdef __cplusplus } #endif /* __cplusplus */ #endif /* CLIENT_TABLE_H */ pupnp-release-1.8.0/upnp/src/inc/config.h000066400000000000000000000335211303304015100202320ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ #ifndef INTERNAL_CONFIG_H #define INTERNAL_CONFIG_H #include "autoconfig.h" /*! * \name Compile time configuration options * * The Linux SDK for UPnP Devices contains some compile-time parameters * that effect the behavior of the SDK. All configuration options are * located in {\tt src/inc/config.h}. * * @{ */ /*! * \name THREAD_IDLE_TIME * * The {\tt THREAD_IDLE_TIME} constant determines when a thread will be * removed from the thread pool and returned to the operating system. When * a thread in the thread pool has been idle for this number of milliseconds * the thread will be released from the thread pool. The default value is * 5000 milliseconds (5 seconds). * * @{ */ #define THREAD_IDLE_TIME 5000 /* @} */ /*! * \name JOBS_PER_THREAD * * The {\tt JOBS_PER_THREAD} constant determines when a new thread will be * allocated to the thread pool inside the SDK. The thread pool will * try and maintain this jobs/thread ratio. When the jobs/thread ratio * becomes greater than this, then a new thread (up to the max) will be * allocated to the thread pool. The default ratio is 10 jobs/thread. * * @{ */ #define JOBS_PER_THREAD 10 /* @} */ /*! * \name MIN_THREADS * * The {\tt MIN_THREADS} constant defines the minimum number of threads the * thread pool inside the SDK will create. The thread pool will * always have this number of threads. These threads are used * for both callbacks into applications built on top of the SDK and also * for making connections to other control points and devices. This number * includes persistent threads. The default value is two threads. * * @{ */ #define MIN_THREADS 2 /* @} */ /*! * \name MAX_THREADS * * The {\tt MAX_THREADS} constant defines the maximum number of threads the * thread pool inside the SDK will create. These threads are used * for both callbacks into applications built on top of the library and also * for making connections to other control points and devices. It is not * recommended that this value be below 10, since the threads are * necessary for correct operation. This value can be increased for greater * performance in operation at the expense of greater memory overhead. The * default value is 12. * * @{ */ #define MAX_THREADS 12 /* @} */ /*! * \name THREAD_STACK_SIZE * * The {\tt THREAD_STACK_SIZE} constant defines the minimum stack size (in * bytes) allocated for the stack of each thread the thread pool inside the * SDK will create. These threads are used for both callbacks into * applications built on top of the library and also for making connections * to other control points and devices. This value will not be used if it * is lower than ITHREAD_STACK_MIN or greater than a system-imposed limit. * This value can be used to lower memory overhead in embedded systems. * The default value is 0 (so it is not used by default). * * @{ */ #define THREAD_STACK_SIZE (size_t)0 /* @} */ /*! \name MAX_JOBS_TOTAL * * The {\tt MAX_JOBS_TOTAL} constant determines the maximum number of jobs * that can be queued. If this limit is reached further jobs will be thrown * to avoid memory exhaustion. The default value 100. * (Added by Axis.) * * @{ */ #define MAX_JOBS_TOTAL 100 /* @} */ /*! * \name DEFAULT_SOAP_CONTENT_LENGTH * * SOAP messages will read at most {\tt DEFAULT_SOAP_CONTENT_LENGTH} bytes. * This prevents devices that have a misbehaving web server to send * a large amount of data to the control point causing it to crash. * This can be adjusted dynamically with {\tt UpnpSetMaxContentLength}. * * @{ */ #define DEFAULT_SOAP_CONTENT_LENGTH 16000 /* @} */ /*! * \name NUM_SSDP_COPY * * This configuration parameter determines how many copies of each SSDP * advertisement and search packets will be sent. By default it will send two * copies of every packet. * * @{ */ #define NUM_SSDP_COPY 2 /* @} */ /*! * \name SSDP_PAUSE * * This configuration parameter determines the pause between identical SSDP * advertisement and search packets. The pause is measured in milliseconds * and defaults to 100. * * @{ */ #define SSDP_PAUSE 100u /* @} */ /*! * \name WEB_SERVER_BUF_SIZE * * This configuration parameter sets the maximum buffer size for the * webserver. The default value is 1MB. * * @{ */ #define WEB_SERVER_BUF_SIZE (size_t)(1024*1024) /* @} */ /*! * \name WEB_SERVER_CONTENT_LANGUAGE * * This configuration parameter sets the value of the Content-Language * header for the webserver. Thanks to this parameter, the use can advertize * the language used by the device in the description (friendlyName) and * presentation steps of UPnP. The default value is empty string so no * Content-Language header is added. * * @{ */ #define WEB_SERVER_CONTENT_LANGUAGE "" /* @} */ /*! * \name AUTO_RENEW_TIME * * The {\tt AUTO_RENEW_TIME} is the time, in seconds, before a subscription * expires that the SDK automatically resubscribes. The default * value is 10 seconds. Setting this value too low can result in the * subscription renewal not making it to the device in time, causing the * subscription to timeout. In order to avoid continually resubscribing * the minimum subscription time is five seconds more than the auto renew * time. * * @{ */ #define AUTO_RENEW_TIME 10 /* @} */ /*! * \name CP_MINIMUM_SUBSCRIPTION_TIME * * The {\tt CP_MINIMUM_SUBSCRIPTION_TIME} is the minimum subscription time * allowed for a control point using the SDK. Subscribing for less than * this time automatically results in a subscription for this amount. The * default value is 5 seconds more than the {\tt AUTO_RENEW_TIME}, or 15 * seconds. * * @{ */ #define CP_MINIMUM_SUBSCRIPTION_TIME (AUTO_RENEW_TIME + 5) /* @} */ /*! * \name MAX_SEARCH_TIME * * The {\tt MAX_SEARCH_TIME} is the maximum time * allowed for an SSDP search by a control point. Searching for greater than * this time automatically results in a search for this amount. The default * value is 80 seconds. * * @{ */ #define MAX_SEARCH_TIME 80 /* @} */ /*! * \name MIN_SEARCH_TIME * * The {\tt MIN_SEARCH_TIME} is the minimumm time * allowed for an SSDP search by a control point. Searching for less than * this time automatically results in a search for this amount. The default * value is 2 seconds. * * @{ */ #define MIN_SEARCH_TIME 2 /* @} */ /*! * \name AUTO_ADVERTISEMENT_TIME * * The {\tt AUTO_ADVERTISEMENT_TIME} is the time, in seconds, before an * device advertisements expires before a renewed advertisement is sent. * The default time is 30 seconds. * * @{ */ #define AUTO_ADVERTISEMENT_TIME 30 /* @} */ /*! * \name SSDP_PACKET_DISTRIBUTE * * The {\tt SSDP_PACKET_DISTRIBUTE} enables the SSDP packets to be sent * at an interval equal to half of the expiration time of SSDP packets * minus the AUTO_ADVERTISEMENT_TIME. This is used to increase * the probability of SSDP packets reaching to control points. * It is recommended that this flag be turned on for embedded wireless * devices. * * @{ */ #define SSDP_PACKET_DISTRIBUTE 1 /* @} */ /*! * \name GENA_NOTIFICATION_SENDING_TIMEOUT * * The {\tt GENA_NOTIFICATION_SENDING_TIMEOUT} specifies the number of seconds * to wait for sending GENA notifications to the Control Point. * * This timeout will be used to know how many seconds GENA notification threads * will wait to write on the socket to send the notification. By putting a * lower value than HTTP_DEFAULT_TIMEOUT, the thread will not wait too long and * will return quickly if writing is impossible. This is very useful as some * Control Points disconnect from the network without unsubscribing as a result * if HTTP_DEFAULT_TIMEOUT is used, all the GENA threads will be blocked to send * notifications to those disconnected Control Points until the subscription * expires. * * @{ */ #define GENA_NOTIFICATION_SENDING_TIMEOUT HTTP_DEFAULT_TIMEOUT /* @} */ /*! * \name GENA_NOTIFICATION_ANSWERING_TIMEOUT * * The {\tt GENA_NOTIFICATION_ANSWERING_TIMEOUT} specifies the number of seconds * to wait for receiving the answer to a GENA notification from the Control * Point. * * This timeout will be used to know how many seconds GENA notification threads * will wait on the socket to read for an answer from the CP. By putting a * lower value than HTTP_DEFAULT_TIMEOUT, the thread will not wait too long and * will return quickly if there is no answer from the CP. This is very useful as * some Control Points disconnect from the network without unsubscribing and if * HTTP_DEFAULT_TIMEOUT is used, all the GENA threads will be blocked to wait * for an answer from those disconnected Control Points until the subscription * expires. However, it should be noted that UDA specifies a value of 30s for * waiting the CP's answer. * * @{ */ #define GENA_NOTIFICATION_ANSWERING_TIMEOUT HTTP_DEFAULT_TIMEOUT /* @} */ /*! * \name Module Exclusion * * Depending on the requirements, the user can selectively discard any of * the major modules like SOAP, GENA, SSDP or the Internal web server. By * default everything is included inside the SDK. By setting any of * the values below to 0, that component will not be included in the final * SDK. * \begin{itemize} * \item {\tt EXCLUDE_SOAP[0,1]} * \item {\tt EXCLUDE_GENA[0,1]} * \item {\tt EXCLUDE_SSDP[0,1]} * \item {\tt EXCLUDE_DOM [0,1]} * \item {\tt EXCLUDE_MINISERVER[0,1]} * \item {\tt EXCLUDE_WEB_SERVER[0,1]} * \item {\tt EXCLUDE_JNI[0,1]} * \end{itemize} * * @{ */ #define EXCLUDE_SSDP 0 #define EXCLUDE_SOAP 0 #define EXCLUDE_GENA 0 #define EXCLUDE_DOM 0 #define EXCLUDE_MINISERVER 0 #define EXCLUDE_WEB_SERVER 0 #ifdef USE_JNI # define EXCLUDE_JNI 0 #else # define EXCLUDE_JNI 1 #endif /* @} */ /*! * \name DEBUG_TARGET * * The user has the option to redirect the library output debug messages * to either the screen or to a log file. All the output messages with * debug level 0 will go to {\tt upnp.err} and messages with debug level * greater than zero will be redirected to {\tt upnp.out}. * * @{ */ #define DEBUG_TARGET 1 /* @} */ /*! * \name Other debugging features * * The UPnP SDK contains other features to aid in debugging: * see */ #define DEBUG_ALL 1 #define DEBUG_SSDP 0 #define DEBUG_SOAP 0 #define DEBUG_GENA 0 #define DEBUG_TPOOL 0 #define DEBUG_MSERV 0 #define DEBUG_DOM 0 #define DEBUG_HTTP 0 #define DEBUG_API 0 /* * @} Compile time configuration options */ /*************************************************************************** * Do not change, Internal purpose only!!! ***************************************************************************/ /*! * @{ */ /* * Set additional defines based on requested configuration */ /* configure --enable-client */ #if UPNP_HAVE_CLIENT # define INCLUDE_CLIENT_APIS 1 #endif /* configure --enable-device */ #if UPNP_HAVE_DEVICE # define INCLUDE_DEVICE_APIS 1 #endif /* configure --enable-webserver */ #if UPNP_HAVE_WEBSERVER # define INTERNAL_WEB_SERVER 1 #endif /* configure --enable-ssdp */ #undef EXCLUDE_SSDP #if UPNP_HAVE_SSDP # define EXCLUDE_SSDP 0 #else # define EXCLUDE_SSDP 1 #endif /* configure --enable-soap */ #undef EXCLUDE_SOAP #if UPNP_HAVE_SOAP # define EXCLUDE_SOAP 0 #else # define EXCLUDE_SOAP 1 #endif /* configure --enable-gena */ #undef EXCLUDE_GENA #if UPNP_HAVE_GENA # define EXCLUDE_GENA 0 #else # define EXCLUDE_GENA 1 #endif #undef EXCLUDE_WEB_SERVER #undef EXCLUDE_MINISERVER #ifdef INTERNAL_WEB_SERVER # define EXCLUDE_WEB_SERVER 0 # define EXCLUDE_MINISERVER 0 #else # define EXCLUDE_WEB_SERVER 1 # define EXCLUDE_MINISERVER 1 #endif #if EXCLUDE_SSDP == 1 && EXCLUDE_GENA == 1 && EXCLUDE_SOAP == 1 && EXCLUDE_WEB_SERVER == 1 # undef EXCLUDE_MINISERVER # define EXCLUDE_MINISERVER 1 # if INTERNAL_WEB_SERVER # error "conflicting settings: use configure --disable-webserver" # endif #endif #if EXCLUDE_SSDP == 0 || EXCLUDE_GENA == 0 || EXCLUDE_SOAP == 0 || EXCLUDE_WEB_SERVER == 0 # undef EXCLUDE_MINISERVER # define EXCLUDE_MINISERVER 0 # if EXCLUDE_WEB_SERVER == 0 && !defined INTERNAL_WEB_SERVER # error "conflicting settings : use configure --enable-webserver" # endif #endif /* * @} */ #endif /* INTERNAL_CONFIG_H */ pupnp-release-1.8.0/upnp/src/inc/gena.h000066400000000000000000000255221303304015100177010ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef GENA_H #define GENA_H /*! * \file */ #include "config.h" #include #include #include "client_table.h" #include "httpparser.h" #include "miniserver.h" #include "service_table.h" #include "sock.h" #include "ThreadPool.h" #include "upnp.h" #include "UpnpString.h" #include "uri.h" #ifdef __cplusplus #define EXTERN_C extern "C" #else /* __cplusplus */ #ifndef EXTERN_C #define EXTERN_C #endif /* EXTERN_C */ #endif /* __cplusplus */ /*! * \brief XML version comment. Not used because it is not interopeable with * other UPnP vendors. */ #define XML_VERSION "\n" #define XML_PROPERTYSET_HEADER \ "\n" #define UNABLE_MEMORY "HTTP/1.1 500 Internal Server Error\r\n\r\n" #define UNABLE_SERVICE_UNKNOWN "HTTP/1.1 404 Not Found\r\n\r\n" #define UNABLE_SERVICE_NOT_ACCEPT "HTTP/1.1 503 Service Not Available\r\n\r\n" #define NOT_IMPLEMENTED "HTTP/1.1 501 Not Implemented\r\n\r\n" #define BAD_REQUEST "HTTP/1.1 400 Bad Request\r\n\r\n" #define INVALID_NT BAD_CALLBACK #define BAD_CALLBACK "HTTP/1.1 412 Precondition Failed\r\n\r\n" #define HTTP_OK_CRLF "HTTP/1.1 200 OK\r\n\r\n" #define HTTP_OK_STR "HTTP/1.1 200 OK\r\n" #define INVALID_SID BAD_CALLBACK #define MISSING_SID BAD_CALLBACK #define MAX_CONTENT_LENGTH 20 #define MAX_SECONDS 10 #define MAX_EVENTS 20 #define MAX_PORT_SIZE 10 #define GENA_E_BAD_RESPONSE UPNP_E_BAD_RESPONSE #define GENA_E_BAD_SERVICE UPNP_E_INVALID_SERVICE #define GENA_E_SUBSCRIPTION_UNACCEPTED UPNP_E_SUBSCRIBE_UNACCEPTED #define GENA_E_BAD_SID UPNP_E_INVALID_SID #define GENA_E_UNSUBSCRIBE_UNACCEPTED UPNP_E_UNSUBSCRIBE_UNACCEPTED #define GENA_E_NOTIFY_UNACCEPTED UPNP_E_NOTIFY_UNACCEPTED #define GENA_E_NOTIFY_UNACCEPTED_REMOVE_SUB -9 #define GENA_E_BAD_HANDLE UPNP_E_INVALID_HANDLE #define XML_ERROR -5 #define XML_SUCCESS UPNP_E_SUCCESS #define GENA_SUCCESS UPNP_E_SUCCESS #define CALLBACK_SUCCESS 0 #define DEFAULT_TIMEOUT 1801 extern ithread_mutex_t GlobalClientSubscribeMutex; /*! * \brief Locks the subscription. */ #define SubscribeLock() \ UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, \ "Trying Subscribe Lock"); \ ithread_mutex_lock(&GlobalClientSubscribeMutex); \ UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, \ "Subscribe Lock"); /*! * \brief Unlocks the subscription. */ #define SubscribeUnlock() \ UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, \ "Trying Subscribe UnLock"); \ ithread_mutex_unlock(&GlobalClientSubscribeMutex); \ UpnpPrintf(UPNP_INFO, GENA, __FILE__, __LINE__, \ "Subscribe UnLock"); /*! * Structure to send NOTIFY message to all subscribed control points */ typedef struct NOTIFY_THREAD_STRUCT { char *headers; DOMString propertySet; char *servId; char *UDN; Upnp_SID sid; int eventKey; int *reference_count; UpnpDevice_Handle device_handle; } notify_thread_struct; /*! * \brief This is the callback function called by the miniserver to handle * incoming GENA requests. * * \return UPNP_E_SUCCESS if successful, otherwise appropriate error code. */ EXTERN_C void genaCallback( /*! [in] represents the parse state of the request */ http_parser_t *parser, /*! [in] HTTP message containing GENA request */ http_message_t* request, /*! [in,out] Structure containing information about the socket */ SOCKINFO *info); /*! * \brief This function subscribes to a PublisherURL (also mentioned as EventURL * in some places). * * It sends SUBSCRIBE http request to service processes request. Finally adds a * Subscription to the clients subscription list, if service responds with OK. * * \return UPNP_E_SUCCESS if service response is OK, otherwise returns the * appropriate error code */ #ifdef INCLUDE_CLIENT_APIS EXTERN_C int genaSubscribe( /*! [in] The client handle. */ UpnpClient_Handle client_handle, /*! [in] Of the form: "http://134.134.156.80:4000/RedBulb/Event */ const UpnpString *PublisherURL, /*! [in,out] requested Duration: * \li if -1, then "infinite". * \li in the OUT case: actual Duration granted by Service, * -1 for infinite. */ int *TimeOut, /*! [out] sid of subscription, memory passed in by caller. */ UpnpString *out_sid); #endif /* INCLUDE_CLIENT_APIS */ /*! * \brief Unsubscribes a SID. * * It first validates the SID and client_handle,copies the subscription, sends * UNSUBSCRIBE http request to service processes request and finally removes * the subscription. * * \return UPNP_E_SUCCESS if service response is OK, otherwise returns the * appropriate error code. */ #ifdef INCLUDE_CLIENT_APIS EXTERN_C int genaUnSubscribe( /*! [in] UPnP client handle. */ UpnpClient_Handle client_handle, /*! [in] The subscription ID. */ const UpnpString *in_sid); #endif /* INCLUDE_CLIENT_APIS */ /*! * \brief Unsubcribes all the outstanding subscriptions and cleans the * subscription list. * * This function is called when control point unregisters. * * \returns UPNP_E_SUCCESS if successful, otherwise returns the appropriate * error code. */ #ifdef INCLUDE_CLIENT_APIS EXTERN_C int genaUnregisterClient( /*! [in] Handle containing all the control point related information. */ UpnpClient_Handle client_handle); #endif /* INCLUDE_CLIENT_APIS */ /* * DEVICE */ /*! * \brief Cleans the service table of the device. * * \return UPNP_E_SUCCESS if successful, otherwise returns GENA_E_BAD_HANDLE */ #ifdef INCLUDE_DEVICE_APIS EXTERN_C int genaUnregisterDevice( /*! [in] Handle of the root device */ UpnpDevice_Handle device_handle); #endif /* INCLUDE_CLIENT_APIS */ /*! * \brief Renews a SID. * * It first validates the SID and client_handle and copies the subscription. * It sends RENEW (modified SUBSCRIBE) http request to service and processes * the response. * * \return UPNP_E_SUCCESS if service response is OK, otherwise the * appropriate error code. */ #ifdef INCLUDE_CLIENT_APIS EXTERN_C int genaRenewSubscription( /*! [in] Client handle. */ UpnpClient_Handle client_handle, /*! [in] Subscription ID. */ const UpnpString *in_sid, /*! [in,out] requested Duration, if -1, then "infinite". In the OUT case: * actual Duration granted by Service, -1 for infinite. */ int *TimeOut); #endif /* INCLUDE_CLIENT_APIS */ /*! * \brief Sends a notification to all the subscribed control points. * * \return int * * \note This function is similar to the genaNotifyAllExt. The only difference * is it takes event variable array instead of xml document. */ #ifdef INCLUDE_DEVICE_APIS EXTERN_C int genaNotifyAll( /*! [in] Device handle. */ UpnpDevice_Handle device_handle, /*! [in] Device udn. */ char *UDN, /*! [in] Service ID. */ char *servId, /*! [in] Array of varible names. */ char **VarNames, /*! [in] Array of variable values. */ char **VarValues, /*! [in] Number of variables. */ int var_count); #endif /* INCLUDE_DEVICE_APIS */ /*! * \brief Sends a notification to all the subscribed control points. * * \return int * * \note This function is similar to the genaNotifyAll. the only difference * is it takes the document instead of event variable array. */ #ifdef INCLUDE_DEVICE_APIS EXTERN_C int genaNotifyAllExt( /*! [in] Device handle. */ UpnpDevice_Handle device_handle, /*! [in] Device udn. */ char *UDN, /*! [in] Service ID. */ char *servId, /*! [in] XML document Event varible property set. */ IXML_Document *PropSet); #endif /* INCLUDE_DEVICE_APIS */ /*! * \brief Sends the intial state table dump to newly subscribed control point. * * \return GENA_E_SUCCESS if successful, otherwise the appropriate error code. * * \note No other event will be sent to this control point before the * intial state table dump. */ #ifdef INCLUDE_DEVICE_APIS EXTERN_C int genaInitNotify( /*! [in] Device handle. */ UpnpDevice_Handle device_handle, /*! [in] Device udn. */ char *UDN, /*! [in] Service ID. */ char *servId, /*! [in] Array of variable names. */ char **VarNames, /*! [in] Array of variable values. */ char **VarValues, /*! [in] Array size. */ int var_count, /*! [in] Subscription ID. */ const Upnp_SID sid); #endif /* INCLUDE_DEVICE_APIS */ /*! * \brief Similar to the genaInitNofity. The only difference is that it * takes the xml document for the state table and sends the intial state * table dump to newly subscribed control point. * * \return GENA_E_SUCCESS if successful, otherwise the appropriate error code. * * \note No other event will be sent to this control point before the * intial state table dump. */ #ifdef INCLUDE_DEVICE_APIS EXTERN_C int genaInitNotifyExt( /*! [in] Device handle. */ UpnpDevice_Handle device_handle, /*! [in] Device udn. */ char *UDN, /*! [in] Service ID. */ char *servId, /*! [in] Document of the state table. */ IXML_Document *PropSet, /*! [in] subscription ID. */ const Upnp_SID sid); #endif /* INCLUDE_DEVICE_APIS */ /*! * \brief Sends an error message to the control point in the case of incorrect * GENA requests. * * \return UPNP_E_SUCCESS if successful, otherwise appropriate error code. */ void error_respond( /*! [in] Structure containing information about the socket. */ SOCKINFO *info, /*! [in] error code that will be in the GENA response. */ int error_code, /*! [in] GENA request Packet. */ http_message_t* hmsg); #endif /* GENA_H */ pupnp-release-1.8.0/upnp/src/inc/gena_ctrlpt.h000066400000000000000000000044371303304015100212730ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef GENA_CTRLPT_H #define GENA_CTRLPT_H /*! * \file */ #include "sock.h" /*! * \brief This function processes NOTIFY events that are sent by devices. * * Parameters: * IN SOCKINFO *info: Socket structure containing the device socket * information * IN http_message_t *event: The http message contains the GENA * notification * * \note called by genacallback() */ void gena_process_notification_event( /*! [in] Socket info of the device. */ SOCKINFO *info, /*! [in] The http message contains the GENA notification. */ http_message_t *event); #endif /* GENA_CTRLPT_H */ pupnp-release-1.8.0/upnp/src/inc/gena_device.h000066400000000000000000000053161303304015100212170ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * * Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef GENA_DEVICE_H #define GENA_DEVICE_H /*! * \file */ #include "sock.h" /*! * \brief Handles a subscription request from a ctrl point. The socket is not * closed on return. */ void gena_process_subscription_request( /*! [in] Socket info of the device. */ SOCKINFO *info, /*! [in] Subscription request from the control point. */ http_message_t *request); /*! * \brief Handles a subscription renewal request from a ctrl point. * The connection is not destroyed on return. */ void gena_process_subscription_renewal_request( /*! [in] Socket info of the device. */ SOCKINFO *info, /*! [in] Subscription renewal request from the control point. */ http_message_t *request); /*! * \brief Handles a subscription cancellation request from a ctrl point. * The connection is not destroyed on return. */ void gena_process_unsubscribe_request( /*! [in] Socket info of the device. */ SOCKINFO *info, /*! [in] UNSUBSCRIBE request from the control point. */ http_message_t *request); #endif /* GENA_DEVICE_H */ pupnp-release-1.8.0/upnp/src/inc/global.h000066400000000000000000000050151303304015100202220ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ #ifndef GLOBAL_H #define GLOBAL_H /* GLOBAL.H - RSAREF types and constants */ /* PROTOTYPES should be set to one if and only if the compiler supports function argument prototyping. The following makes PROTOTYPES default to 1 if it has not already been defined with C compiler flags. */ #ifndef PROTOTYPES #define PROTOTYPES 1 #endif /* POINTER defines a generic pointer type */ typedef unsigned char *POINTER; /* UINT2 defines a two byte word */ typedef unsigned short int UINT2; /* UINT4 defines a four byte word */ typedef unsigned long int UINT4; /* * PROTO_LIST is defined depending on how PROTOTYPES is defined above. * If using PROTOTYPES, then PROTO_LIST returns the list, otherwise it * returns an empty list. */ #if PROTOTYPES #define PROTO_LIST(list) list #else #define PROTO_LIST(list) () #endif #endif /* GLOBAL_H */ pupnp-release-1.8.0/upnp/src/inc/gmtdate.h000066400000000000000000000071141303304015100204110ustar00rootroot00000000000000/////////////////////////////////////////////////////////////////////////// // // Copyright (c) 2000-2003 Intel Corporation // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // // * Redistributions of source code must retain the above copyright notice, // this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above copyright notice, // this list of conditions and the following disclaimer in the documentation // and/or other materials provided with the distribution. // * Neither name of Intel Corporation nor the names of its contributors // may be used to endorse or promote products derived from this software // without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR // PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY // OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // /////////////////////////////////////////////////////////////////////////// #ifndef GENLIB_UTIL_GMTDATE_H #define GENLIB_UTIL_GMTDATE_H #include #include #ifdef __cplusplus extern "C" { #endif // input: monthStr: 3-letter or full month // returns month=0..11 or -1 on failure // output: // charsRead - num chars that match the month // fullNameMatch - full name match(1) or 3-letter match(0) // int ParseMonth( IN const char* monthStr, OUT int* charsRead, OUT int* fullNameMatch ); // input: dayOfWeek: 3-letter or full day of week ("mon" etc) // returns dayOfWeek=0..6 or -1 on failure // output: // charsRead - num chars that match the month // fullNameMatch - full name match(1) or 3-letter match(0) // int ParseDayOfWeek( IN const char* dayOfWeek, OUT int* charsRead, OUT int* fullNameMatch ); // converts date to string format: RFC 1123 format: // Sun, 06 Nov 1994 08:49:37 GMT // String returned must be freed using free() function // returns NULL if date is NULL // // throws OutOfMemoryException char* DateToString( const struct tm* date ); // parses time in fmt hh:mm:ss, military fmt // returns 0 on success; -1 on error int ParseTime( const char* s, int* hour, int* minute, int* second ); // tries to parse date according to RFCs 1123, 850, or asctime() // format // params: // str - contains date/time in string format // dateTime - date and time obtained from 'str' // returns: 0 on success, -1 on error int ParseRFC850DateTime( IN const char* str, OUT struct tm* dateTime, OUT int* numCharsParsed ); int ParseRFC1123DateTime( IN const char* str, OUT struct tm* dateTime, OUT int* numCharsParsed ); int ParseAsctimeFmt( IN const char* str, OUT struct tm* dateTime, OUT int* numCharsParsed ); // parses any of these formats: 1123, 850 or asctime() int ParseDateTime( IN const char* str, OUT struct tm* dateTime, OUT int* numCharsParsed ); #ifdef __cplusplus } /* extern C */ #endif #endif /* GENLIB_UTIL_GMTDATE_H */ pupnp-release-1.8.0/upnp/src/inc/httpparser.h000066400000000000000000000375741303304015100211750ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef GENLIB_NET_HTTP_HTTPPARSER_H #define GENLIB_NET_HTTP_HTTPPARSER_H /*! * \file */ #include "LinkedList.h" #include "membuffer.h" #include "uri.h" #include "upnputil.h" /* private types */ /* scanner */ /* Used to represent different types of tokens in input. */ typedef enum { TT_IDENTIFIER, TT_WHITESPACE, TT_CRLF, TT_CTRL, TT_SEPARATOR, TT_QUOTEDSTRING, } token_type_t; typedef struct { /*! raw http msg. */ membuffer* msg; /*! current position in buffer. */ size_t cursor; /*! set this to TRUE if the entire msg is loaded in 'msg'; * else FALSE if only partial msg in 'msg' (default is FALSE). */ int entire_msg_loaded; } scanner_t; typedef enum { POS_REQUEST_LINE, POS_RESPONSE_LINE, POS_HEADERS, POS_ENTITY, POS_COMPLETE, } parser_pos_t; #define ENTREAD_DETERMINE_READ_METHOD 1 #define ENTREAD_USING_CLEN 2 #define ENTREAD_USING_CHUNKED 3 #define ENTREAD_UNTIL_CLOSE 4 #define ENTREAD_CHUNKY_BODY 5 #define ENTREAD_CHUNKY_HEADERS 6 /* end of private section. */ /* method in a HTTP request. * IMPORTANT: The enum values of the standard HTTP method should match * those of Upnp_HttpMethod enum defined in upnp.h */ typedef enum { HTTPMETHOD_PUT = 0, HTTPMETHOD_DELETE = 1, HTTPMETHOD_GET = 2, HTTPMETHOD_HEAD = 3, HTTPMETHOD_POST = 4, HTTPMETHOD_MPOST, HTTPMETHOD_SUBSCRIBE, HTTPMETHOD_UNSUBSCRIBE, HTTPMETHOD_NOTIFY, HTTPMETHOD_MSEARCH, HTTPMETHOD_UNKNOWN, SOAPMETHOD_POST, HTTPMETHOD_SIMPLEGET } http_method_t; /* different types of HTTP headers */ #define HDR_UNKNOWN -1 #define HDR_CACHE_CONTROL 1 #define HDR_CALLBACK 2 #define HDR_CONTENT_LENGTH 3 #define HDR_CONTENT_TYPE 4 #define HDR_DATE 5 #define HDR_EXT 6 #define HDR_HOST 7 /*define HDR_IF_MODIFIED_SINCE 8 */ /*define HDR_IF_UNMODIFIED_SINCE 9 */ /*define HDR_LAST_MODIFIED 10 */ #define HDR_LOCATION 11 #define HDR_MAN 12 #define HDR_MX 13 #define HDR_NT 14 #define HDR_NTS 15 #define HDR_SERVER 16 #define HDR_SEQ 17 #define HDR_SID 18 #define HDR_SOAPACTION 19 #define HDR_ST 20 #define HDR_TIMEOUT 21 #define HDR_TRANSFER_ENCODING 22 #define HDR_USN 23 #define HDR_USER_AGENT 24 /* Adding new header difinition */ #define HDR_ACCEPT 25 #define HDR_ACCEPT_ENCODING 26 #define HDR_ACCEPT_CHARSET 27 #define HDR_ACCEPT_LANGUAGE 28 #define HDR_ACCEPT_RANGE 29 #define HDR_CONTENT_ENCODING 30 #define HDR_CONTENT_LANGUAGE 31 #define HDR_CONTENT_LOCATION 32 #define HDR_CONTENT_RANGE 33 #define HDR_IF_RANGE 34 #define HDR_RANGE 35 #define HDR_TE 36 /*! status of parsing */ typedef enum { /*! msg was parsed successfully. */ PARSE_SUCCESS = 0, /*! need more data to continue. */ PARSE_INCOMPLETE, /*! for responses that don't have length specified. */ PARSE_INCOMPLETE_ENTITY, /*! parse failed; check status code for details. */ PARSE_FAILURE, /*! done partial. */ PARSE_OK, /*! token not matched. */ PARSE_NO_MATCH, /*! private. */ PARSE_CONTINUE_1 } parse_status_t; typedef struct { /*! header name as a string. */ memptr name; /*! header name id (for a selective group of headers only). */ int name_id; /*! raw-value; could be multi-lined; min-length = 0. */ membuffer value; /* private. */ membuffer name_buf; } http_header_t; typedef struct { int initialized; /*! request only. */ http_method_t method; /*! request only. */ uri_type uri; /*! response only. */ http_method_t request_method; /*! response only. */ int status_code; /*! response only. */ membuffer status_msg; /*! response only. the amount of data that's been read by the user, that's no * longer in the raw message buffer. */ size_t amount_discarded; /* fields used in both request or response messages. */ /*! if TRUE, msg is a request, else response. */ int is_request; /* http major version. */ int major_version; /* http minor version. */ int minor_version; /*! . */ LinkedList headers; /*! message body(entity). */ memptr entity; /* private fields. */ /*! entire raw message. */ membuffer msg; /*! storage for url string. */ char *urlbuf; } http_message_t; typedef struct { http_message_t msg; /*! read-only; in case of parse error, this * contains the HTTP error code (4XX or 5XX). */ int http_error_code; /*! read-only; this is set to true if a NOTIFY request has no * content-length. used to read valid sspd notify msg. */ int valid_ssdp_notify_hack; /* private data -- don't touch. */ parser_pos_t position; int ent_position; unsigned int content_length; size_t chunk_size; /*! offset in the the raw message buffer, which contains the message body. * preceding this are the headers of the messsage. */ size_t entity_start_position; scanner_t scanner; } http_parser_t; #ifdef __cplusplus extern "C" { #endif /* __cplusplus */ /************************************************************************ * Function : httpmsg_init * * Parameters : * INOUT http_message_t* msg ; HTTP Message Object * * Description : Initialize and allocate memory for http message * * Return : void ; * * Note : ************************************************************************/ void httpmsg_init( INOUT http_message_t* msg ); /************************************************************************ * Function : httpmsg_destroy * * Parameters : * INOUT http_message_t* msg ; HTTP Message Object * * Description : Free memory allocated for the http message * * Return : void ; * * Note : ************************************************************************/ void httpmsg_destroy( INOUT http_message_t* msg ); /************************************************************************ * Function : httpmsg_find_hdr_str * * Parameters : * IN http_message_t* msg ; HTTP Message Object * IN const char* header_name ; Header name to be compared with * * Description : Compares the header name with the header names stored * in the linked list of messages * * Return : http_header_t* - Pointer to a header on success; * NULL on failure * Note : ************************************************************************/ http_header_t* httpmsg_find_hdr_str( IN http_message_t* msg, IN const char* header_name ); /************************************************************************ * Function : httpmsg_find_hdr * * Parameters : * IN http_message_t* msg ; HTTP Message Object * IN int header_name_id ; Header Name ID to be compared with * OUT memptr* value ; Buffer to get the ouput to. * * Description : Finds header from a list, with the given 'name_id'. * * Return : http_header_t* - Pointer to a header on success; * NULL on failure * * Note : ************************************************************************/ http_header_t* httpmsg_find_hdr( IN http_message_t* msg, IN int header_name_id, OUT memptr* value ); /************************************************************************ * Function: parser_request_init * * Parameters: * OUT http_parser_t* parser ; HTTP Parser object * * Description: Initializes parser object for a request * * Returns: * void ************************************************************************/ void parser_request_init( OUT http_parser_t* parser ); /************************************************************************ * Function: parser_response_init * * Parameters: * OUT http_parser_t* parser ; HTTP Parser object * IN http_method_t request_method ; Request method * * Description: Initializes parser object for a response * * Returns: * void ************************************************************************/ void parser_response_init( OUT http_parser_t* parser, IN http_method_t request_method ); /************************************************************************ * Function: parser_parse * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser object * * Description: The parser function. Depending on the position of the * parser object the actual parsing function is invoked * * Returns: * void ************************************************************************/ parse_status_t parser_parse(INOUT http_parser_t * parser); /************************************************************************ * Function: parser_parse_responseline * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser object * * Description: Get HTTP Method, URL location and version information. * * Returns: * PARSE_OK * PARSE_SUCCESS * PARSE_FAILURE ************************************************************************/ parse_status_t parser_parse_responseline(INOUT http_parser_t *parser); /************************************************************************ * Function: parser_parse_headers * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser object * * Description: Get HTTP Method, URL location and version information. * * Returns: * PARSE_OK * PARSE_SUCCESS * PARSE_FAILURE ************************************************************************/ parse_status_t parser_parse_headers(INOUT http_parser_t *parser); /************************************************************************ * Function: parser_parse_entity * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser object * * Description: Determines method to read entity * * Returns: * PARSE_OK * PARSE_FAILURE * PARSE_COMPLETE -- no more reading to do ************************************************************************/ parse_status_t parser_parse_entity(INOUT http_parser_t *parser); /************************************************************************ * Function: parser_get_entity_read_method * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser object * * Description: Determines method to read entity * * Returns: * PARSE_OK * PARSE_FAILURE * PARSE_COMPLETE -- no more reading to do ************************************************************************/ parse_status_t parser_get_entity_read_method( INOUT http_parser_t* parser ); /************************************************************************ * Function: parser_append * * Parameters: * INOUT http_parser_t* parser ; HTTP Parser Object * IN const char* buf ; buffer to be appended to the parser * buffer * IN size_t buf_length ; Size of the buffer * * Description: The parser function. Depending on the position of the * parser object the actual parsing function is invoked * * Returns: * void ************************************************************************/ parse_status_t parser_append( INOUT http_parser_t* parser, IN const char* buf, IN size_t buf_length ); /************************************************************************ * Function: matchstr * * Parameters: * IN char *str ; String to be matched * IN size_t slen ; Length of the string * IN const char* fmt ; Pattern format * ... * * Description: Matches a variable parameter list with a string * and takes actions based on the data type specified. * * Returns: * PARSE_OK * PARSE_NO_MATCH -- failure to match pattern 'fmt' * PARSE_FAILURE -- 'str' is bad input ************************************************************************/ parse_status_t matchstr( IN char *str, IN size_t slen, IN const char* fmt, ... ); /************************************************************************ * Function: raw_to_int * * Parameters: * IN memptr* raw_value ; Buffer to be converted * IN int base ; Base to use for conversion * * Description: Converts raw character data to long-integer value * * Returns: * int ************************************************************************/ int raw_to_int( IN memptr* raw_value, int base ); /************************************************************************ * Function: raw_find_str * * Parameters: * IN memptr* raw_value ; Buffer containg the string * IN const char* str ; Substring to be found * * Description: Find a substring from raw character string buffer * * Side effects: raw_value is transformed to lowercase. * * Returns: * int - index at which the substring is found. ************************************************************************/ int raw_find_str( IN memptr* raw_value, IN const char* str ); /************************************************************************ * Function: method_to_str * * Parameters: * IN http_method_t method ; HTTP method * * Description: A wrapper function that maps a method id to a method * nameConverts a http_method id stored in the HTTP Method * * Returns: * const char* ptr - Ptr to the HTTP Method ************************************************************************/ const char* method_to_str( IN http_method_t method ); /*! * \brief Print the HTTP headers. */ #ifdef DEBUG void print_http_headers( /*! [in] HTTP Message object. */ http_message_t *hmsg); #else static UPNP_INLINE void print_http_headers(http_message_t *hmsg) { return; hmsg = hmsg; } #endif #ifdef __cplusplus } /* extern "C" */ #endif /* __cplusplus */ #endif /* GENLIB_NET_HTTP_HTTPPARSER_H */ pupnp-release-1.8.0/upnp/src/inc/httpreadwrite.h000066400000000000000000000546211303304015100216570ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef GENLIB_NET_HTTP_HTTPREADWRITE_H #define GENLIB_NET_HTTP_HTTPREADWRITE_H /* * \file */ #include "config.h" #include "upnputil.h" #include "sock.h" #include "httpparser.h" /*! timeout in secs. */ #define HTTP_DEFAULT_TIMEOUT 30 #ifdef __cplusplus extern "C" { #endif #ifdef WIN32 struct tm *http_gmtime_r(const time_t *clock, struct tm *result); #else #define http_gmtime_r gmtime_r #endif int http_CancelHttpGet(IN void *Handle); /*! * \brief Validates URL. * * \return * \li \c UPNP_E_INVALID_URL * \li \c UPNP_E_SUCCESS */ int http_FixUrl( /*! [in] URL to be validated and fixed. */ uri_type *url, /*! [out] URL after being fixed. */ uri_type *fixed_url); /*! * \brief Parses URL and then validates URL. * * \return * \li \c UPNP_E_INVALID_URL * \li \c UPNP_E_SUCCESS */ int http_FixStrUrl( /*! [in] Character string as a URL. */ const char *urlstr, /*! [in] Length of the character string. */ size_t urlstrlen, /*! [out] Fixed and corrected URL. */ uri_type *fixed_url); /*! * \brief Gets destination address from URL and then connects to the * remote end. * * \return Socket descriptor on success, or on error: * \li \c UPNP_E_OUTOF_SOCKET * \li \c UPNP_E_SOCKET_CONNECT */ SOCKET http_Connect( /*! [in] URL containing destination information. */ uri_type *destination_url, /*! [out] Fixed and corrected URL. */ uri_type *url); /************************************************************************ * Function: http_RecvMessage * * Parameters: * IN SOCKINFO *info; Socket information object * OUT http_parser_t* parser; HTTP parser object * IN http_method_t request_method; HTTP request method * IN OUT int* timeout_secs; time out * OUT int* http_error_code; HTTP error code returned * * Description: * Get the data on the socket and take actions based on the read data * to modify the parser objects buffer. If an error is reported while * parsing the data, the error code is passed in the http_errr_code * parameter * * Returns: * UPNP_E_BAD_HTTPMSG * UPNP_E_SUCCESS ************************************************************************/ int http_RecvMessage( IN SOCKINFO *info, OUT http_parser_t* parser, IN http_method_t request_method, IN OUT int* timeout_secs, OUT int* http_error_code ); /*! * \brief Sends a message to the destination based on the format parameter. * * fmt types: * \li \c 'f': arg = "const char *" file name * \li \c 'b': arg1 = "const char *" mem_buffer; arg2 = "size_t" buffer length. * \li \c 'I': arg = "struct SendInstruction *" * * E.g.: \verbatim char *buf = "POST /xyz.cgi http/1.1\r\n\r\n"; char *filename = "foo.dat"; int status = http_SendMessage(tcpsock, "bf", buf, strlen(buf), // args for memory buffer filename); // arg for file \endverbatim * * \return * \li \c UPNP_E_OUTOF_MEMORY * \li \c UPNP_E_FILE_READ_ERROR * \li \c UPNP_E_SUCCESS */ int http_SendMessage( /* [in] Socket information object. */ SOCKINFO *info, /* [in,out] Time out value. */ int* timeout_secs, /* [in] Pattern format to take actions upon. */ const char* fmt, /* [in] Variable parameter list. */ ...); /************************************************************************ * Function: http_RequestAndResponse * * Parameters: * IN uri_type* destination; Destination URI object which contains * remote IP address among other elements * IN const char* request; Request to be sent * IN size_t request_length; Length of the request * IN http_method_t req_method; HTTP Request method * IN int timeout_secs; time out value * OUT http_parser_t* response; Parser object to receive the repsonse * * Description: * Initiates socket, connects to the destination, sends a * request and waits for the response from the remote end * * Returns: * UPNP_E_SOCKET_ERROR * UPNP_E_SOCKET_CONNECT * Error Codes returned by http_SendMessage * Error Codes returned by http_RecvMessage ************************************************************************/ int http_RequestAndResponse( IN uri_type* destination, IN const char* request, IN size_t request_length, IN http_method_t req_method, IN int timeout_secs, OUT http_parser_t* response ); /************************************************************************ * return codes: * 0 -- success * UPNP_E_OUTOF_MEMORY * UPNP_E_TIMEDOUT * UPNP_E_BAD_REQUEST * UPNP_E_BAD_RESPONSE * UPNP_E_INVALID_URL * UPNP_E_SOCKET_READ * UPNP_E_SOCKET_WRITE ************************************************************************/ /************************************************************************ * Function: http_Download * * Parameters: * IN const char* url_str; String as a URL * IN int timeout_secs; time out value * OUT char** document; buffer to store the document extracted * from the donloaded message. * OUT size_t* doc_length; length of the extracted document * OUT char* content_type; Type of content * * Description: * Download the document message and extract the document * from the message. * * Return: int * UPNP_E_SUCCESS * UPNP_E_INVALID_URL ************************************************************************/ int http_Download( IN const char* url, IN int timeout_secs, OUT char** document, OUT size_t *doc_length, OUT char* content_type ); /************************************************************************ * Function: http_HttpGetProgress * * Parameters: * IN void *Handle; Handle to the HTTP get object * OUT size_t *length; Buffer to get the read and parsed data * OUT size_t *total; Size of tge buffer passed * * Description: * Extracts information from the Handle to the HTTP get object. * * Return: int * UPNP_E_SUCCESS - On Sucess * UPNP_E_INVALID_PARAM - Invalid Parameter ************************************************************************/ int http_HttpGetProgress( IN void *Handle, OUT size_t *length, OUT size_t *total); /*! * \brief Opens a connection to the server. * * The SDK allocates the memory for \b handle, the * application is responsible for freeing this memory. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b url, or \b handle * is not a valid pointer. * \li \c UPNP_E_INVALID_URL: The \b url is not a valid * URL. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * download this file. * \li \c UPNP_E_SOCKET_ERROR: Error occured allocating a socket and * resources or an error occurred binding a socket. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting a * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. */ EXPORT_SPEC int http_OpenHttpConnection( /*! [in] The URL which contains the host, and the scheme to make the connection. */ const char *url, /*! [in,out] A pointer in which to store the handle for this connection. This * handle is required for futher operations over this connection. */ void **handle, /*! [in] The time out value sent with the request during which a response * is expected from the receiver, failing which, an error is reported. * If value is negative, timeout is infinite. */ int timeout); /*! * \brief Makes a HTTP request using a connection previously created by * \b UpnpOpenHttpConnection. * * \note Trying to make another request while a request is already being processed * results in undefined behavior. It's up to the user to end a previous * request by calling \b UpnpEndHttpRequest. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b url, \b handle * or \b contentType is not a valid pointer. * \li \c UPNP_E_INVALID_URL: The \b url is not a valid * URL. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * download this file. * \li \c UPNP_E_SOCKET_ERROR: Error occured allocating a socket and * resources or an error occurred binding a socket. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting a * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. */ EXPORT_SPEC int http_MakeHttpRequest( /* ![in] The method to use to make the request. */ Upnp_HttpMethod method, /*! [in] The URL to use to make the request. The URL should use the same * host and scheme used to create the connection. */ const char *url, /*! [in] The handle to the connection. */ void *handle, /*! [in] Headers to be used for the request. Each header should be terminated by a CRLF as specified * in the HTTP specification. If NULL then the default headers will be used. */ UpnpString *headers, /*! [in] The media type of content being sent. Can be NULL. */ const char *contentType, /*! [in] The length of the content being sent, in bytes. Set to \b UPNP_USING_CHUNKED to use * chunked encoding, or \b UPNP_UNTIL_CLOSE to avoid specifying the content length to the server. * In this case the request is considered unfinished until the connection is closed. */ int contentLength, /*! [in] The time out value sent with the request during which a response * is expected from the receiver, failing which, an error is reported. * If value is negative, timeout is infinite. */ int timeout); /*! * \brief Writes the content of a HTTP request initiated by a \b UpnpMakeHttpRequest call. * The end of the content should be indicated by a call to \b UpnpEndHttpRequest * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b handle, \b buf * or \b size is not a valid pointer. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. */ EXPORT_SPEC int http_WriteHttpRequest( /*! [in] The handle of the connection created by the call to * \b UpnpOpenHttpConnection. */ void *handle, /*! [in] The buffer containing date to be written. */ char *buf, /*! [in] The size, in bytes of \b buf. */ size_t *size, /*! [in] A timeout value sent with the request during which a response is * expected from the server, failing which, an error is reported. If * value is negative, timeout is infinite. */ int timeout); /*! * \brief Indicates the end of a HTTP request previously made by * \b UpnpMakeHttpRequest. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: \b handle is not a valid pointer. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * download this file. * \li \c UPNP_E_SOCKET_ERROR: Error occured allocating a socket and * resources or an error occurred binding a socket. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting a * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. */ EXPORT_SPEC int http_EndHttpRequest( /*! [in] The handle to the connection. */ void *handle, /*! [in] The time out value sent with the request during which a response * is expected from the receiver, failing which, an error is reported. * If value is negative, timeout is infinite. */ int timeout); /*! * \brief Gets the response from the server using a connection previously created * by \b UpnpOpenHttpConnection * * \note Memory for \b contentType is only valid until the next call to the HTTP API * for the same connection. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b handle, * \b contentType, \b contentLength or \b httpStatus * is not a valid pointer. * \li \c UPNP_E_INVALID_URL: The \b url is not a valid * URL. * \li \c UPNP_E_OUTOF_MEMORY: Insufficient resources exist to * download this file. * \li \c UPNP_E_NETWORK_ERROR: A network error occurred. * \li \c UPNP_E_SOCKET_WRITE: An error or timeout occurred writing * to a socket. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_SOCKET_BIND: An error occurred binding a socket. * \li \c UPNP_E_SOCKET_CONNECT: An error occurred connecting a * socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. * \li \c UPNP_E_BAD_RESPONSE: A bad response was received from the * remote server. */ EXPORT_SPEC int http_GetHttpResponse( /*! [in] The handle of the connection created by the call to * \b UpnpOpenHttpConnection. */ void *handle, /*! [in] Headers sent by the server for the response. If NULL then the * headers are not copied. */ UpnpString *headers, /*! [out] A buffer to store the media type of the item. */ char **contentType, /*! [out] A pointer to store the length of the item. */ int *contentLength, /*! [out] The status returned on receiving a response message. */ int *httpStatus, /*! [in] The time out value sent with the request during which a response * is expected from the server, failing which, an error is reported * back to the user. If value is negative, timeout is infinite. */ int timeout); /*! * \brief Reads the content of a response using a connection previously created * by \b UpnpOpenHttpConnection. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: Either \b handle, \b buf * or \b size is not a valid pointer. * \li \c UPNP_E_BAD_RESPONSE: A bad response was received from the * remote server. * \li \c UPNP_E_BAD_HTTPMSG: Either the request or response was in * the incorrect format. * \li \c UPNP_E_CANCELED: another thread called UpnpCancelHttpGet. * * Note: In case of return values, the status code parameter of the passed * in handle value may provide additional information on the return * value. */ EXPORT_SPEC int http_ReadHttpResponse( /*! [in] The handle of the connection created by the call to * \b UpnpOpenHttpConnection. */ void *handle, /*! [in,out] The buffer to store the read item. */ char *buf, /*! [in,out] The size of the buffer to be read. */ size_t *size, /*! [in] The time out value sent with the request during which a response is * expected from the server, failing which, an error is reported back to * the user. If value is negative, timeout is infinite. */ int timeout); /*! * \brief Closes the connection created with \b UpnpOpenHttpConnection * and frees any memory associated with the connection. * * \return An integer representing one of the following: * \li \c UPNP_E_SUCCESS: The operation completed successfully. * \li \c UPNP_E_INVALID_PARAM: \b handle, or is not a valid pointer. * \li \c UPNP_E_SOCKET_READ: An error or timeout occurred reading * from a socket. * \li \c UPNP_E_OUTOF_SOCKET: Too many sockets are currently * allocated. */ EXPORT_SPEC int http_CloseHttpConnection( /*! [in] The handle of the connection to close, created by the call to * \b UpnpOpenHttpPost. */ void *handle); /************************************************************************ * Function: http_SendStatusResponse * * Parameters: * IN SOCKINFO *info; Socket information object * IN int http_status_code; error code returned while making * or sending the response message * IN int request_major_version; request major version * IN int request_minor_version; request minor version * * Description: * Generate a response message for the status query and send the * status response. * * Return: int * 0 -- success * UPNP_E_OUTOF_MEMORY * UPNP_E_SOCKET_WRITE * UPNP_E_TIMEDOUT ************************************************************************/ int http_SendStatusResponse( IN SOCKINFO *info, IN int http_status_code, IN int request_major_version, IN int request_minor_version ); /*! * \brief Generate an HTTP message based on the format that is specified in * the input parameters. * \verbatim Format types: 'B': arg = int status_code -- appends content-length, content-type and HTML body for given code. 'b': arg1 = const char *buf; arg2 = size_t buf_length memory ptr 'C': (no args) -- appends a HTTP CONNECTION: close header depending on major, minor version. 'c': (no args) -- appends CRLF "\r\n" 'D': (no args) -- appends HTTP DATE: header 'd': arg = int number -- appends decimal number 'G': arg = range information -- add range header 'h': arg = off_t number -- appends off_t number 'K': (no args) -- add chunky header 'L': arg = language information -- add Content-Language header if Accept-Language header is not empty and if WEB_SERVER_CONTENT_LANGUAGE is not empty 'N': arg1 = off_t content_length -- content-length header 'q': arg1 = http_method_t -- request start line and HOST header arg2 = (uri_type *) 'Q': arg1 = http_method_t; -- start line of request arg2 = char* url; arg3 = size_t url_length 'R': arg = int status_code -- adds a response start line 'S': (no args) -- appends HTTP SERVER: header 's': arg = const char * -- C_string 'T': arg = char * content_type; -- format e.g: "text/html"; content-type header 't': arg = time_t * gmt_time -- appends time in RFC 1123 fmt 'U': (no args) -- appends HTTP USER-AGENT: header 'X': arg = const char * -- useragent; "redsonic" HTTP X-User-Agent: useragent \endverbatim * * \return * \li \c 0 - On Success * \li \c UPNP_E_OUTOF_MEMORY * \li \c UPNP_E_INVALID_URL */ int http_MakeMessage( /* [in,out] Buffer with the contents of the message. */ INOUT membuffer* buf, /* [in] HTTP major version. */ IN int http_major_version, /* [in] HTTP minor version. */ IN int http_minor_version, /* [in] Pattern format. */ IN const char* fmt, /* [in] Format arguments. */ ... ); /************************************************************************ * Function: http_CalcResponseVersion * * Parameters: * IN int request_major_vers; Request major version * IN int request_minor_vers; Request minor version * OUT int* response_major_vers; Response mojor version * OUT int* response_minor_vers; Response minor version * * Description: * Calculate HTTP response versions based on the request versions. * * Return: void ************************************************************************/ void http_CalcResponseVersion( IN int request_major_vers, IN int request_minor_vers, OUT int* response_major_vers, OUT int* response_minor_vers ); /************************************************************************ * Function: http_OpenHttpGetEx * * Parameters: * IN const char *url_str; String as a URL * IN OUT void **Handle; Pointer to buffer to store HTTP * post handle * IN OUT char **contentType; Type of content * OUT int *contentLength; length of content * OUT int *httpStatus; HTTP status returned on receiving a * response message * IN int timeout; time out value * * Description: * Makes the HTTP GET message, connects to the peer, * sends the HTTP GET request, gets the response and parses the * response. * * Return: int * UPNP_E_SUCCESS - On Success * UPNP_E_INVALID_PARAM - Invalid Paramters * UPNP_E_OUTOF_MEMORY * UPNP_E_SOCKET_ERROR * UPNP_E_BAD_RESPONSE ************************************************************************/ int http_OpenHttpGetEx(IN const char *url_str, IN OUT void **Handle, IN OUT char **contentType, OUT int *contentLength, OUT int *httpStatus, IN int lowRange, IN int highRange, IN int timeout); /************************************************************************ * Function: get_sdk_info * * Parameters: * OUT char *info; buffer to store the operating system information * IN size_t infoSize; size of buffer * * Description: * Returns the server information for the operating system * * Return: * UPNP_INLINE void ************************************************************************/ void get_sdk_info( OUT char *info, IN size_t infoSize ); #ifdef __cplusplus } /* #extern "C" */ #endif #endif /* GENLIB_NET_HTTP_HTTPREADWRITE_H */ pupnp-release-1.8.0/upnp/src/inc/inet_pton.h000066400000000000000000000022221303304015100207560ustar00rootroot00000000000000#ifndef INET_PTON #define INET_PTON #ifdef WIN32 #ifdef IPV6_ #define INET_IPV6 #endif #include "unixutil.h" #include #include #include /*! * \file * * \author: Paul Vixie, 1996. * * \brief Network support routines missing in WIN32. * * \warning Don't even consider trying to compile this on a system where * sizeof(int) < 4. sizeof(int) 4 is fine; all the world's not a VAX. * */ /*! * \brief convert a network format address to presentation format. * * \return * pointer to presentation format address (`dst'), or NULL (see errno). */ extern const char *inet_ntop(int af, const void *src, char *dst, socklen_t size); /*! * \brief convert from presentation format (which usually means ASCII printable) * to network format (which is usually some kind of binary format). * * \return * \li 1 if the address was valid for the specified address family * \li 0 if the address wasn't valid (`dst' is untouched in this case) * \li -1 if some other error occurred (`dst' is untouched in this case, too) */ extern int inet_pton(int af, const char *src, void *dst); #endif /* WIN32 */ #endif /* INET_PTON */ pupnp-release-1.8.0/upnp/src/inc/md5.h000066400000000000000000000026421303304015100174520ustar00rootroot00000000000000/* MD5.H - header file for MD5C.C */ /* Copyright (C) 1991-2, RSA Data Security, Inc. Created 1991. All rights reserved. License to copy and use this software is granted provided that it is identified as the "RSA Data Security, Inc. MD5 Message-Digest Algorithm" in all material mentioning or referencing this software or this function. License is also granted to make and use derivative works provided that such works are identified as "derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm" in all material mentioning or referencing the derived work. RSA Data Security, Inc. makes no representations concerning either the merchantability of this software or the suitability of this software for any particular purpose. It is provided "as is" without express or implied warranty of any kind. These notices must be retained in any copies of any part of this documentation and/or software. */ /* MD5 context. */ typedef struct { UINT4 state[4]; /* state (ABCD) */ UINT4 count[2]; /* number of bits, modulo 2^64 (lsb first) */ unsigned char buffer[64]; /* input buffer */ } MD5_CTX; void MD5Init PROTO_LIST ((MD5_CTX *)); void MD5Update PROTO_LIST ((MD5_CTX *, unsigned char *, unsigned int)); void MD5Final PROTO_LIST ((unsigned char [16], MD5_CTX *)); pupnp-release-1.8.0/upnp/src/inc/membuffer.h000066400000000000000000000177171303304015100207460ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef GENLIB_UTIL_MEMBUFFER_H #define GENLIB_UTIL_MEMBUFFER_H /*! * \file */ #include #include "upnputil.h" #define MINVAL( a, b ) ( (a) < (b) ? (a) : (b) ) #define MAXVAL( a, b ) ( (a) > (b) ? (a) : (b) ) /*! pointer to a chunk of memory. */ typedef struct { /*! start of memory (read/write). */ char *buf; /*! length of memory (read-only). */ size_t length; } memptr; /*! Maintains a block of dynamically allocated memory * note: Total length/capacity should not exceed MAX_INT */ typedef struct { /*! mem buffer; must not write beyond buf[length-1] (read/write). */ char *buf; /*! length of buffer (read-only). */ size_t length; /*! total allocated memory (read-only). */ size_t capacity; /*! used to increase size; MUST be > 0; (read/write). */ size_t size_inc; /*! default value of size_inc. */ #define MEMBUF_DEF_SIZE_INC (size_t)5 } membuffer; #ifdef __cplusplus extern "C" { #endif /* __cplusplus */ /*! * \brief Allocate memory and copy information from the input string to the * newly allocated memory. * * \return Pointer to the newly allocated memory. * NULL if memory cannot be allocated. */ char *str_alloc( /*! [in] Input string object. */ const char *str, /*! [in] Input string length. */ size_t str_len); /*! * \brief Compares characters of strings passed for number of bytes. * If equal for the number of bytes, the length of the bytes determines * which buffer is shorter. * * \return * \li < 0 string1 substring less than string2 substring * \li == 0 string1 substring identical to string2 substring * \li > 0 string1 substring greater than string2 substring */ int memptr_cmp( /*! [in] Input memory object. */ memptr *m, /*! [in] Constatnt string for the memory object to be compared with. */ const char *s); /*! * \brief Compares characters of 2 strings irrespective of the case for a * specific count of bytes. * * If the character comparison is the same the length of the 2 srings * determines the shorter of the 2 strings. * * \return * \li < 0 string1 substring less than string2 substring * \li == 0 string1 substring identical to string2 substring * \li > 0 string1 substring greater than string2 substring */ int memptr_cmp_nocase( /*! [in] Input memory object. */ memptr *m, /*! [in] Constatnt string for the memory object to be compared with. */ const char *s); /*! * \brief Increases or decreases buffer cap so that at least 'new_length' * bytes can be stored. * * \return * \li UPNP_E_SUCCESS - On Success * \li UPNP_E_OUTOF_MEMORY - On failure to allocate memory. */ int membuffer_set_size( /*! [in,out] buffer whose size is to be modified. */ membuffer *m, /*! [in] new size to which the buffer will be modified. */ size_t new_length); /*! * \brief Wrapper to membuffer_initialize(). * * Set the size of the buffer to MEMBUF_DEF_SIZE_INC and Initializes * m->buf to NULL, length = 0. */ void membuffer_init( /*! [in,out] Buffer to be initialized. */ membuffer *m); /*! * \brief Free's memory allocated for membuffer* m. */ void membuffer_destroy( /*! [in,out] Buffer to be destroyed. */ membuffer *m); /*! * \brief Allocate memory to membuffer *m and copy the contents of the in * parameter const void *buf. * * \return * \li UPNP_E_SUCCESS * \li UPNP_E_OUTOF_MEMORY */ int membuffer_assign( /*! [in,out] Buffer whose memory is to be allocated and assigned. */ membuffer *m, /*! [in] Source buffer whose contents will be copied. */ const void *buf, /*! [in] Length of the source buffer. */ size_t buf_len); /*! * \brief Wrapper function for membuffer_assign(). * * \return * \li UPNP_E_SUCCESS * \li UPNP_E_OUTOF_MEMORY */ int membuffer_assign_str( /*! [in,out] Buffer to be allocated and assigned. */ membuffer *m, /*! [in] Source buffer whose contents will be copied. */ const char *c_str); /*! * \brief Invokes function to appends data from a constant buffer to the buffer. * * \return int. */ int membuffer_append( /*! [in,out] Buffer whose memory is to be appended. */ membuffer *m, /*! [in] Source buffer whose contents will be copied. */ const void *buf, /*! [in] Length of the source buffer. */ size_t buf_len); /*! * \brief Invokes function to appends data from a constant string to the buffer. * * \return int. */ int membuffer_append_str( /*! [in,out] Buffer whose memory is to be appended. */ membuffer *m, /*! [in] Source buffer whose contents will be copied. */ const char *c_str); /*! * \brief Allocates memory for the new data to be inserted. Does * memory management by moving the data from the existing memory to * the newly allocated memory and then appending the new data. * * \return 0 if successful, error code if error. */ int membuffer_insert( /*! [in,out] Buffer whose memory size is to be increased and appended. */ membuffer * m, /*! [in] source buffer whose contents will be copied. */ const void *buf, /*! [in] size of the source buffer. */ size_t buf_len, /*! [in] index to determine the bounds while movinf the data. */ size_t index); /*! * \brief Shrink the size of the buffer depending on the current size of the * bufer and te input parameters. Move contents from the old buffer to the * new sized buffer. */ void membuffer_delete( /*! [in,out] Buffer whose memory size is to be decreased and copied * to the modified location. */ membuffer * m, /*! [in] Index to determine bounds while moving data. */ size_t index, /*! [in] Number of bytes that the data needs to shrink by. */ size_t num_bytes); /* * \brief Detaches current buffer and returns it. The caller must free the * returned buffer using free(). After this call, length becomes 0. * * \return A pointer to the current buffer. */ char *membuffer_detach( /*! [in,out] Buffer to be returned and updated. */ membuffer *m); /* * \brief Free existing memory in membuffer and assign the new buffer in its * place. * * \note 'new_buf' must be allocted using malloc or realloc so that it can be * freed using free(). */ void membuffer_attach( /*! [in,out] Buffer to be updated. */ membuffer *m, /*! [in] Source buffer which will be assigned to the buffer to be * updated. */ char *new_buf, /*! [in] Length of the source buffer. */ size_t buf_len); #ifdef __cplusplus } /* extern "C" */ #endif /* __cplusplus */ #endif /* GENLIB_UTIL_MEMBUFFER_H */ pupnp-release-1.8.0/upnp/src/inc/miniserver.h000066400000000000000000000105721303304015100211510ustar00rootroot00000000000000#ifndef MINISERVER_H #define MINISERVER_H /************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ /*! * \file */ #include "sock.h" #include "httpparser.h" #include "UpnpStdInt.h" extern SOCKET gMiniServerStopSock; typedef struct MServerSockArray { /*! IPv4 socket for listening for miniserver requests. */ SOCKET miniServerSock4; /*! IPv6 Socket for listening for miniserver requests. */ SOCKET miniServerSock6; /*! Socket for stopping miniserver */ SOCKET miniServerStopSock; /*! IPv4 SSDP Socket for incoming advertisments and search requests. */ SOCKET ssdpSock4; /*! IPv6 SSDP Socket for incoming advertisments and search requests. */ SOCKET ssdpSock6; /*! IPv6 SSDP Socket for incoming advertisments and search requests. */ SOCKET ssdpSock6UlaGua; /* ! . */ uint16_t stopPort; /* ! . */ uint16_t miniServerPort4; /* ! . */ uint16_t miniServerPort6; #ifdef INCLUDE_CLIENT_APIS /*! IPv4 SSDP socket for sending search requests and receiving search * replies */ SOCKET ssdpReqSock4; /*! IPv6 SSDP socket for sending search requests and receiving search * replies */ SOCKET ssdpReqSock6; #endif /* INCLUDE_CLIENT_APIS */ } MiniServerSockArray; /*! . */ typedef void (*MiniServerCallback) ( /* ! . */ IN http_parser_t * parser, /* ! . */ IN http_message_t * request, /* ! . */ IN SOCKINFO * info); #ifdef __cplusplus extern "C" { #endif /*! * \brief Set HTTP Get Callback. */ void SetHTTPGetCallback( /*! [in] HTTP Callback to be invoked . */ MiniServerCallback callback); /*! * \brief Set SOAP Callback. */ #ifdef INCLUDE_DEVICE_APIS void SetSoapCallback( /*! [in] SOAP Callback to be invoked . */ MiniServerCallback callback); #else /* INCLUDE_DEVICE_APIS */ static UPNP_INLINE void SetSoapCallback(MiniServerCallback callback) {} #endif /* INCLUDE_DEVICE_APIS */ /*! * \brief Set GENA Callback. */ void SetGenaCallback( /*! [in] GENA Callback to be invoked. */ MiniServerCallback callback); /*! * \brief Initialize the sockets functionality for the Miniserver. * * Initialize a thread pool job to run the MiniServer and the job to the * thread pool. * * If listen port is 0, port is dynamically picked. * * Use timer mechanism to start the MiniServer, failure to meet the * allowed delay aborts the attempt to launch the MiniServer. * * \return * \li On success: UPNP_E_SUCCESS. * \li On error: UPNP_E_XXX. */ int StartMiniServer( /*! [in,out] Port on which the server listens for incoming IPv4 * connections. */ uint16_t *listen_port4, /*! [in,out] Port on which the server listens for incoming IPv6 * connections. */ uint16_t *listen_port6); /*! * \brief Stop and Shutdown the MiniServer and free socket resources. * * \return Always returns 0. */ int StopMiniServer(); #ifdef __cplusplus } /* extern C */ #endif #endif /* MINISERVER_H */ pupnp-release-1.8.0/upnp/src/inc/netall.h000066400000000000000000000033771303304015100202520ustar00rootroot00000000000000/////////////////////////////////////////////////////////////////////////// // // Copyright (c) 2000-2003 Intel Corporation // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // // * Redistributions of source code must retain the above copyright notice, // this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above copyright notice, // this list of conditions and the following disclaimer in the documentation // and/or other materials provided with the distribution. // * Neither name of Intel Corporation nor the names of its contributors // may be used to endorse or promote products derived from this software // without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR // PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY // OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // /////////////////////////////////////////////////////////////////////////// #include #include pupnp-release-1.8.0/upnp/src/inc/parsetools.h000066400000000000000000000042001303304015100211500ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef GENLIB_NET_HTTP_PARSETOOLS_H #define GENLIB_NET_HTTP_PARSETOOLS_H /*! * \file */ #include "upnputil.h" #include "httpparser.h" #ifdef __cplusplus extern "C" { #endif /*! * \brief Find the header from the HTTP message and match the header for * xml data. * * \return boolean. */ int has_xml_content_type( /*! HTTP Message object. */ IN http_message_t *hmsg); #ifdef __cplusplus } /* extern C */ #endif #endif /* GENLIB_NET_HTTP_PARSETOOLS_H */ pupnp-release-1.8.0/upnp/src/inc/server.h000066400000000000000000000051761303304015100203000ustar00rootroot00000000000000/////////////////////////////////////////////////////////////////////////// // // Copyright (c) 2000-2003 Intel Corporation // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // // * Redistributions of source code must retain the above copyright notice, // this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above copyright notice, // this list of conditions and the following disclaimer in the documentation // and/or other materials provided with the distribution. // * Neither name of Intel Corporation nor the names of its contributors // may be used to endorse or promote products derived from this software // without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR // PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY // OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // /////////////////////////////////////////////////////////////////////////// #ifndef GENLIB_NET_HTTP_SERVER_H #define GENLIB_NET_HTTP_SERVER_H #ifdef __cplusplus #include int http_ServerCallback( IN HttpMessage& request, IN int sockfd ); // adds 'entity' to the alias list; the entity is referred using // // aliasRelURL: relative url for given entity // entity: entity to be served // actualAlias: [possibly] modified version of aliasResURL to resolve conflicts // returns: // 0 : success // HTTP_E_OUT_OF_MEMORY int http_AddAlias( IN const char* aliasRelURL, IN HttpEntity* entity, OUT xstring& actualAlias ); extern "C" { #endif /* __cplusplus */ void http_OldServerCallback( IN const char* msg, int sockfd ); void http_SetRootDir( const char* httpRootDir ); // removes a previously added entity // returns: // 0: success -- alias removed // -1: alias not found int http_RemoveAlias( IN const char* alias ); #ifdef __cplusplus } /* extern C */ #endif #endif /* GENLIB_NET_HTTP_SERVER_H */ pupnp-release-1.8.0/upnp/src/inc/service_table.h000066400000000000000000000237211303304015100215750ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef SERVICE_TABLE_H #define SERVICE_TABLE_H /*! * \file */ #ifdef __cplusplus extern "C" { #endif #include "config.h" #include "uri.h" #include "ixml.h" #include "upnp.h" #include "upnpdebug.h" #include #include #define SID_SIZE (size_t)41 #ifdef INCLUDE_DEVICE_APIS typedef struct SUBSCRIPTION { Upnp_SID sid; int eventKey; int ToSendEventKey; time_t expireTime; int active; URL_list DeliveryURLs; struct SUBSCRIPTION *next; } subscription; typedef struct SERVICE_INFO { DOMString serviceType; DOMString serviceId; char *SCPDURL ; char *controlURL; char *eventURL; DOMString UDN; int active; int TotalSubscriptions; subscription *subscriptionList; struct SERVICE_INFO *next; } service_info; typedef struct SERVICE_TABLE { DOMString URLBase; service_info *serviceList; service_info *endServiceList; } service_table; /* Functions for Subscriptions */ /*! * \brief Makes a copy of the subscription. * * \return HTTP_SUCCESS on success. */ int copy_subscription( /*! [in] Source subscription. */ subscription *in, /*! [in] Destination subscription. */ subscription *out); /* * \brief Remove the subscription represented by the const Upnp_SID sid parameter * from the service table and update the service table. */ void RemoveSubscriptionSID( /*! [in] Subscription ID. */ Upnp_SID sid, /*! [in] Service object providing the list of subscriptions. */ service_info *service); /*! * \brief Return the subscription from the service table that matches * const Upnp_SID sid value. * * \return Pointer to the matching subscription node. */ subscription *GetSubscriptionSID( /*! [in] Subscription ID. */ const Upnp_SID sid, /*! [in] Service object providing the list of subscriptions. */ service_info *service); /*! * \brief Gets pointer to the first subscription node in the service table. * * \return Pointer to the first subscription node. */ subscription *GetFirstSubscription( /*! [in] Service object providing the list of subscriptions. */ service_info *service); /*! * \brief Get current and valid subscription from the service table. * * \return Pointer to the next subscription node. */ subscription *GetNextSubscription( /*! [in] Service object providing the list of subscriptions. */ service_info *service, /*! [in] Current subscription object. */ subscription *current); /*! * \brief Free's the memory allocated for storing the URL of the subscription. */ void freeSubscription( /*! [in] Subscription object to be freed. */ subscription *sub); /*! * \brief Free's memory allocated for all the subscriptions in the service table. */ void freeSubscriptionList( /*! [in] Head of the subscription list. */ subscription * head); /*! * \brief Traverses through the service table and returns a pointer to the * service node that matches a known service id and a known UDN. * * \return Pointer to the matching service_info node. */ service_info *FindServiceId( /*! [in] Service table. */ service_table *table, /*! [in] String representing the service id to be found among those * in the table. */ const char *serviceId, /*! [in] String representing the UDN to be found among those in the * table. */ const char *UDN); /*! * \brief Traverses the service table and finds the node whose event URL Path * matches a know value. * * \return Pointer to the service list node from the service table whose event * URL matches a known event URL. */ service_info *FindServiceEventURLPath( /*! [in] Service table. */ service_table *table, /*! [in] Event URL path used to find a service from the table. */ char *eventURLPath); /*! * \brief Traverses the service table and finds the node whose control URL Path * matches a know value. * * \return Pointer to the service list node from the service table whose control * URL Path matches a known value. */ service_info * FindServiceControlURLPath( /*! [in] Service table. */ service_table *table, /*! [in] Control URL path used to find a service from the table. */ const char *controlURLPath); /*! * \brief For debugging purposes prints information from the service passed * into the function. */ #ifdef DEBUG void printService( /*! [in] Service whose information is to be printed. */ service_info *service, /*! [in] Debug level specified to the print function. */ Upnp_LogLevel level, /*! [in] Debug module specified to the print function. */ Dbg_Module module); #else static UPNP_INLINE void printService( service_info *service, Upnp_LogLevel level, Dbg_Module module) { return; service = service; level = level; module = module; } #endif /*! * \brief For debugging purposes prints information of each service from the * service table passed into the function. */ #ifdef DEBUG void printServiceList( /*! [in] Service whose information is to be printed. */ service_info *service, /*! [in] Debug level specified to the print function. */ Upnp_LogLevel level, /*! [in] Debug module specified to the print function. */ Dbg_Module module); #else static UPNP_INLINE void printServiceList( service_info *service, Upnp_LogLevel level, Dbg_Module module) { return; service = service; level = level; module = module; } #endif /*! * \brief For debugging purposes prints the URL base of the table and information * of each service from the service table passed into the function. */ #ifdef DEBUG void printServiceTable( /*! [in] Service table to be printed. */ service_table *table, /*! [in] Debug level specified to the print function. */ Upnp_LogLevel level, /*! [in] Debug module specified to the print function. */ Dbg_Module module); #else static UPNP_INLINE void printServiceTable( service_table *table, Upnp_LogLevel level, Dbg_Module module) { return; table = table; level = level; module = module; } #endif /*! * \brief Free's memory allocated for the various components of the service * entry in the service table. */ void freeService( /*! [in] Service information that is to be freed. */ service_info *in); /*! * \brief Free's memory allocated for the various components of each service * entry in the service table. */ void freeServiceList( /*! [in] Head of the service list to be freed. */ service_info *head); /*! * \brief Free's dynamic memory in table (does not free table, only memory * within the structure). */ void freeServiceTable( /*! [in] Service table whose internal memory needs to be freed. */ service_table *table); /*! * \brief This function assumes that services for a particular root device are * placed linearly in the service table, and in the order in which they are * found in the description document all services for this root device are * removed from the list. * * \return An integer. */ int removeServiceTable( /*! [in] XML node information. */ IXML_Node *node, /*! [in] Service table from which services will be removed. */ service_table *in); /*! * \brief Add Service to the table. */ int addServiceTable( /*! [in] XML node information. */ IXML_Node *node, /*! [in] Service table that will be initialized with services. */ service_table *in, /*! [in] Default base URL on which the URL will be returned to the * service list. */ const char *DefaultURLBase); /*! * \brief Retrieve service from the table. * * \return An integer */ int getServiceTable( /*! [in] XML node information. */ IXML_Node *node, /*! [in] Output parameter which will contain the service list and URL. */ service_table *out, /*! [in] Default base URL on which the URL will be returned. */ const char *DefaultURLBase); /* Misc helper functions */ /*! * \brief Returns the clone of the element value. * * \note Value must be freed with DOMString_free. * * \return DOMString */ DOMString getElementValue( /*! [in] Input node which provides the list of child nodes. */ IXML_Node *node); /*! * \brief Traverses through a list of XML nodes to find the node with the * known element name. * * \return * \li 1 - On Success * \li 0 - On Failure */ int getSubElement( /*! [in] Sub element name to be searched for. */ const char *element_name, /*! [in] Input node which provides the list of child nodes. */ IXML_Node *node, /*! [out] Ouput node to which the matched child node is returned. */ IXML_Node **out); #endif /* INCLUDE_DEVICE_APIS */ #ifdef __cplusplus } #endif #endif /* SERVICE_TABLE */ pupnp-release-1.8.0/upnp/src/inc/soaplib.h000066400000000000000000000113201303304015100204070ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ #ifndef SOAPLIB_H #define SOAPLIB_H /*! * \file */ /* SOAP module API to be called in Upnp-Dk API */ /*! * \brief This is a callback called by minisever after receiving the request * from the control point. This function will start processing the request. * It calls handle_invoke_action to handle the SOAP action. */ void soap_device_callback( /*! [in] Parsed request received by the device. */ http_parser_t *parser, /*! [in] HTTP request. */ http_message_t *request, /*! [in,out] Socket info. */ SOCKINFO *info); /**************************************************************************** * Function: SoapSendAction * * Parameters: * IN char* action_url: device contrl URL * IN char *service_type: device service type * IN IXML_Document *action_node: SOAP action node * OUT IXML_Document **response_node: SOAP response node * * Description: This function is called by UPnP API to send the SOAP * action request and waits till it gets the response from the device * pass the response to the API layer * * Return: int * returns UPNP_E_SUCCESS if successful else returns appropriate error * Note: ****************************************************************************/ int SoapSendAction( IN char* action_url, IN char *service_type, IN IXML_Document *action_node, OUT IXML_Document **response_node); /**************************************************************************** * Function: SoapSendActionEx * * Parameters: * IN char* action_url: device contrl URL * IN char *service_type: device service type * IN IXML_Document *Header: Soap header * IN IXML_Document *action_node: SOAP action node (SOAP body) * OUT IXML_Document **response_node: SOAP response node * * Description: This function is called by UPnP API to send the SOAP * action request and waits till it gets the response from the device * pass the response to the API layer. This action is similar to the * the SoapSendAction with only difference that it allows users to * pass the SOAP header along the SOAP body ( soap action request) * * Return: int * returns UPNP_E_SUCCESS if successful else returns appropriate error * Note: ****************************************************************************/ int SoapSendActionEx( IN char * ActionURL, IN char *ServiceType, IN IXML_Document *Header, IN IXML_Document *ActNode, OUT IXML_Document **RespNode); /**************************************************************************** * Function: SoapGetServiceVarStatus * * Parameters: * IN char * action_url: Address to send this variable query message. * IN char *var_name: Name of the variable. * OUT char **var_value: Output value. * * Description: This function creates a status variable query message * send it to the specified URL. It also collect the response. * * Return: int * * Note: ****************************************************************************/ int SoapGetServiceVarStatus( IN char * ActionURL, IN DOMString VarName, OUT DOMString *StVar); extern const char* ContentTypeHeader; #endif /* SOAPLIB_H */ pupnp-release-1.8.0/upnp/src/inc/sock.h000066400000000000000000000132741303304015100177270ustar00rootroot00000000000000#ifndef GENLIB_NET_SOCK_H #define GENLIB_NET_SOCK_H /************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ /*! * \defgroup Sock Network Socket Library * * @{ * * \file */ #include "upnpconfig.h" #include "UpnpInet.h" /* for SOCKET, netinet/in */ #include "UpnpGlobal.h" /* for UPNP_INLINE */ #ifdef UPNP_ENABLE_OPEN_SSL #include #endif /* The following are not defined under winsock.h */ #ifndef SD_RECEIVE #define SD_RECEIVE 0x00 #define SD_SEND 0x01 #define SD_BOTH 0x02 #endif /*! */ typedef struct { /*! Handle/descriptor to a socket. */ SOCKET socket; /*! The following two fields are filled only in incoming requests. */ struct sockaddr_storage foreign_sockaddr; #ifdef UPNP_ENABLE_OPEN_SSL SSL *ssl; #endif } SOCKINFO; #ifdef __cplusplus extern "C" { #endif /*! * \brief Closes the socket if it is different from -1. * * \return -1 if an error occurred or if the socket is -1. */ static UPNP_INLINE int sock_close( /*! Socket descriptor. */ SOCKET sock) { int ret = -1; if (sock != INVALID_SOCKET) ret = UpnpCloseSocket(sock); return ret; } /*! * \brief Assign the passed in socket descriptor to socket descriptor in the * SOCKINFO structure. * * \return Integer: * \li \c UPNP_E_SUCCESS * \li \c UPNP_E_OUTOF_MEMORY * \li \c UPNP_E_SOCKET_ERROR */ int sock_init( /*! [out] Socket Information Object. */ SOCKINFO *info, /*! [in] Socket Descriptor. */ SOCKET sockfd); /*! * \brief Calls the sock_init function and assigns the passed in IP address * and port to the IP address and port in the SOCKINFO structure. * * \return Integer: * \li \c UPNP_E_SUCCESS * \li \c UPNP_E_OUTOF_MEMORY * \li \c UPNP_E_SOCKET_ERROR */ int sock_init_with_ip( /*! [out] Socket Information Object. */ SOCKINFO* info, /*! [in] Socket Descriptor. */ SOCKET sockfd, /*! [in] Remote socket address. */ struct sockaddr *foreign_sockaddr); /*! * \brief Associates an SSL object with the socket and begins * the client-side SSL/TLS handshake. * * \return Integer: * \li \c UPNP_E_SUCCESS * \li \c UPNP_E_SOCKET_ERROR */ #ifdef UPNP_ENABLE_OPEN_SSL int sock_ssl_connect( /*! [out] Socket Information Object. */ SOCKINFO* info); #endif /*! * \brief Shutsdown the socket using the ShutdownMethod to indicate whether * sends and receives on the socket will be dis-allowed. * * After shutting down the socket, closesocket is called to release system * resources used by the socket calls. * * \return Integer: * \li \c UPNP_E_SOCKET_ERROR on failure. * \li \c UPNP_E_SUCCESS on success. */ int sock_destroy( /*! [in,out] Socket Information Object. */ SOCKINFO* info, /*! [in] How to shutdown the socket. Used by sockets's shutdown(). */ int ShutdownMethod); /*! * \brief Reads data on socket in sockinfo. * * \return Integer: * \li \c numBytes - On Success, no of bytes received. * \li \c UPNP_E_TIMEDOUT - Timeout. * \li \c UPNP_E_SOCKET_ERROR - Error on socket calls. */ int sock_read( /*! [in] Socket Information Object. */ SOCKINFO *info, /*! [out] Buffer to get data to. */ char* buffer, /*! [in] Size of the buffer. */ size_t bufsize, /*! [in,out] timeout value. */ int *timeoutSecs); /*! * \brief Writes data on the socket in sockinfo. * * \return Integer: * \li \c numBytes - On Success, no of bytes received. * \li \c UPNP_E_TIMEDOUT - Timeout. * \li \c UPNP_E_SOCKET_ERROR - Error on socket calls. */ int sock_write( /*! [in] Socket Information Object. */ SOCKINFO *info, /*! [in] Buffer to send data from. */ const char *buffer, /*! [in] Size of the buffer. */ size_t bufsize, /*! [in,out] timeout value. */ int *timeoutSecs); /*! * \brief Make socket blocking. * * \return 0 if successful, -1 otherwise. */ int sock_make_blocking( /* [in] socket. */ SOCKET sock); /*! * \brief Make socket non-blocking. * * \return 0 if successful, -1 otherwise. */ int sock_make_no_blocking( /* [in] socket. */ SOCKET sock); #ifdef __cplusplus } /* #extern "C" */ #endif /* @} Sock Network Socket Library */ #endif /* GENLIB_NET_SOCK_H */ pupnp-release-1.8.0/upnp/src/inc/ssdplib.h000066400000000000000000000342311303304015100204240ustar00rootroot00000000000000#ifndef SSDPLIB_H #define SSDPLIB_H /************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (C) 2011-2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ /*! * \defgroup SSDPlib SSDP Library * * @{ * * \file */ #include "httpparser.h" #include "httpreadwrite.h" #include "miniserver.h" #include "UpnpInet.h" #include #include #include #include #ifdef WIN32 #else /* WIN32 */ #include #ifndef __APPLE__ #include #include #include #endif /* __APPLE__ */ #include #endif /* WIN32 */ /*! Enumeration to define all different types of ssdp searches */ typedef enum SsdpSearchType { /*! Unknown search command. */ SSDP_SERROR = -1, SSDP_ALL, SSDP_ROOTDEVICE, SSDP_DEVICEUDN, SSDP_DEVICETYPE, SSDP_SERVICE } SType; #define BUFSIZE (size_t)2500 #define SSDP_IP "239.255.255.250" #define SSDP_IPV6_LINKLOCAL "FF02::C" #define SSDP_IPV6_SITELOCAL "FF05::C" #define SSDP_PORT 1900 #define NUM_TRY 3 #define THREAD_LIMIT 50 #define COMMAND_LEN 300 /*! can be overwritten by configure CFLAGS argument. */ #ifndef X_USER_AGENT /*! @name X_USER_AGENT * The {\tt X_USER_AGENT} constant specifies the value of the X-User-Agent: * HTTP header. The value "redsonic" is needed for the DSM-320. See * https://sourceforge.net/forum/message.php?msg_id=3166856 for more * information */ #define X_USER_AGENT "redsonic" #endif /*! Error codes. */ #define NO_ERROR_FOUND 0 #define E_REQUEST_INVALID -3 #define E_RES_EXPIRED -4 #define E_MEM_ALLOC -5 #define E_HTTP_SYNTEX -6 #define E_SOCKET -7 #define RQST_TIMEOUT 20 /*! Structure to store the SSDP information */ typedef struct SsdpEventStruct { enum SsdpSearchType RequestType; int ErrCode; int MaxAge; int Mx; char UDN[LINE_SIZE]; char DeviceType[LINE_SIZE]; /* NT or ST */ char ServiceType[LINE_SIZE]; char Location[LINE_SIZE]; char HostAddr[LINE_SIZE]; char Os[LINE_SIZE]; char Ext[LINE_SIZE]; char Date[LINE_SIZE]; struct sockaddr *DestAddr; void * Cookie; } SsdpEvent; typedef void (* SsdpFunPtr)(SsdpEvent *); typedef struct TData { int Mx; void * Cookie; char * Data; struct sockaddr_storage DestAddr; } ThreadData; typedef struct ssdpsearchreply { int MaxAge; UpnpDevice_Handle handle; struct sockaddr_storage dest_addr; SsdpEvent event; } SsdpSearchReply; typedef struct ssdpsearcharg { int timeoutEventId; char * searchTarget; void *cookie; enum SsdpSearchType requestType; } SsdpSearchArg; typedef struct { http_parser_t parser; struct sockaddr_storage dest_addr; } ssdp_thread_data; /* globals */ #ifdef INCLUDE_CLIENT_APIS extern SOCKET gSsdpReqSocket4; #ifdef UPNP_ENABLE_IPV6 extern SOCKET gSsdpReqSocket6; #endif /* UPNP_ENABLE_IPV6 */ #endif /* INCLUDE_CLIENT_APIS */ typedef int (*ParserFun)(char *, SsdpEvent *); /*! * \name SSDP Server Functions * * @{ */ /*! * \brief Sends SSDP advertisements, replies and shutdown messages. * * \return UPNP_E_SUCCESS if successful else appropriate error. */ int AdvertiseAndReply( /* [in] -1 = Send shutdown, 0 = send reply, 1 = Send Advertisement. */ int AdFlag, /* [in] Device handle. */ UpnpDevice_Handle Hnd, /* [in] Search type for sending replies. */ enum SsdpSearchType SearchType, /* [in] Destination address. */ struct sockaddr *DestAddr, /* [in] Device type. */ char *DeviceType, /* [in] Device UDN. */ char *DeviceUDN, /* [in] Service type. */ char *ServiceType, /* [in] Advertisement age. */ int Exp); /*! * \brief Fills the fields of the event structure like DeviceType, Device UDN * and Service Type. * * \return 0 if successful else -1. */ int unique_service_name( /* [in] Service Name string. */ char *cmd, /* [out] The SSDP event structure partially filled by all the * function. */ SsdpEvent *Evt); /*! * \brief This function figures out the type of the SSDP search in the in the * request. * * \return enum SsdpSearchType. Returns appropriate search type, * else returns SSDP_ERROR */ enum SsdpSearchType ssdp_request_type1( /* [in] command came in the ssdp request. */ char *cmd); /*! * \brief Starts filling the SSDP event structure based upon the * request received. * * \return 0 on success; -1 on error. */ int ssdp_request_type( /* [in] command came in the ssdp request. */ char *cmd, /* [out] The event structure partially filled by this function. */ SsdpEvent *Evt); /*! * \brief This function reads the data from the ssdp socket. */ void readFromSSDPSocket( /* [in] SSDP socket. */ SOCKET socket); /*! * \brief Creates the IPv4 and IPv6 ssdp sockets required by the * control point and device operation. * * \return UPNP_E_SUCCESS if successful else returns appropriate error. */ int get_ssdp_sockets( /* [out] Array of SSDP sockets. */ MiniServerSockArray *out); /* @} SSDP Server Functions */ /*! * \name SSDP Control Point Functions * * @{ */ /*! * \brief This function handles the ssdp messages from the devices. These * messages includes the search replies, advertisement of device coming alive * and bye byes. */ void ssdp_handle_ctrlpt_msg( /* [in] SSDP message from the device. */ http_message_t *hmsg, /* [in] Address of the device. */ struct sockaddr_storage *dest_addr, /* [in] timeout kept by the control point while sending search message. * Only in search reply. */ int timeout, /* [in] Cookie stored by the control point application. This cookie will * be returned to the control point in the callback. * Only in search reply. */ void *cookie); /*! * \brief Creates and send the search request for a specific URL. * * This function implements the search request of the discovery phase. * A M-SEARCH request is sent on the SSDP channel for both IPv4 and * IPv6 addresses. The search target(ST) is required and must be one of * the following: * \li "ssdp:all" : Search for all devices and services. * \li "ssdp:rootdevice" : Search for root devices only. * \li "uuid:" : Search for a particular device. * \li "urn:schemas-upnp-org:device:" * \li "urn:schemas-upnp-org:service:" * \li "urn::device:" * \li "urn::service:" * * \return 1 if successful else appropriate error. */ int SearchByTarget( /* [in] Number of seconds to wait, to collect all the responses. */ int Mx, /* [in] Search target. */ char *St, /* [in] Cookie provided by control point application. This cokie will * be returned to application in the callback. */ void *Cookie); /* @} SSDP Control Point Functions */ /*! * \name SSDP Device Functions * * @{ */ /*! * \brief Wrapper function to reply the search request coming from the * control point. * * \return always return NULL */ void *advertiseAndReplyThread( /* [in] Structure containing the search request. */ void *data); /*! * \brief Handles the search request. It does the sanity checks of the * request and then schedules a thread to send a random time reply * (random within maximum time given by the control point to reply). */ #ifdef INCLUDE_DEVICE_APIS void ssdp_handle_device_request( /* [in] . */ http_message_t *hmsg, /* [in] . */ struct sockaddr_storage *dest_addr); #else /* INCLUDE_DEVICE_APIS */ static UPNP_INLINE void ssdp_handle_device_request( /* [in] . */ http_message_t *hmsg, /* [in] . */ struct sockaddr_storage *dest_addr) {} #endif /* INCLUDE_DEVICE_APIS */ /*! * \brief Creates the device advertisement request based on the input * parameter, and send it to the multicast channel. * * \return UPNP_E_SUCCESS if successful else appropriate error. */ int DeviceAdvertisement( /* [in] type of the device. */ char *DevType, /* [in] flag to indicate if the device is root device. */ int RootDev, /* [in] UDN. */ char *Udn, /* [in] Location URL. */ char *Location, /* [in] Service duration in sec. */ int Duration, /* [in] Device address family. */ int AddressFamily, /* [in] PowerState as defined by UPnP Low Power. */ int PowerState, /* [in] SleepPeriod as defined by UPnP Low Power. */ int SleepPeriod, /* [in] RegistrationState as defined by UPnP Low Power. */ int RegistrationState); /*! * \brief Creates the reply packet based on the input parameter, and send it * to the client addesss given in its input parameter DestAddr. * * \return UPNP_E_SUCCESS if successful else appropriate error. */ int SendReply( /* [in] destination IP address. */ struct sockaddr *DestAddr, /* [in] Device type. */ char *DevType, /* [in] 1 means root device 0 means embedded device. */ int RootDev, /* [in] Device UDN. */ char *Udn, /* [in] Location of Device description document. */ char *Location, /* [in] Life time of this device. */ int Duration, /* [in] . */ int ByType, /* [in] PowerState as defined by UPnP Low Power. */ int PowerState, /* [in] SleepPeriod as defined by UPnP Low Power. */ int SleepPeriod, /* [in] RegistrationState as defined by UPnP Low Power. */ int RegistrationState); /*! * \brief Creates the reply packet based on the input parameter, and send it * to the client address given in its input parameter DestAddr. * * \return UPNP_E_SUCCESS if successful else appropriate error. */ int DeviceReply( /* [in] destination IP address. */ struct sockaddr *DestAddr, /* [in] Device type. */ char *DevType, /* [in] 1 means root device 0 means embedded device. */ int RootDev, /* [in] Device UDN. */ char *Udn, /* [in] Location of Device description document. */ char *Location, /* [in] Life time of this device. */ int Duration, /* [in] PowerState as defined by UPnP Low Power. */ int PowerState, /* [in] SleepPeriod as defined by UPnP Low Power. */ int SleepPeriod, /* [in] RegistrationState as defined by UPnP Low Power. */ int RegistrationState); /*! * \brief Creates the advertisement packet based on the input parameter, * and send it to the multicast channel. * * \return UPNP_E_SUCCESS if successful else appropriate error. */ int ServiceAdvertisement( /* [in] Device UDN. */ char *Udn, /* [in] Service Type. */ char *ServType, /* [in] Location of Device description document. */ char *Location, /* [in] Life time of this device. */ int Duration, /* [in] Device address family. */ int AddressFamily, /* [in] PowerState as defined by UPnP Low Power. */ int PowerState, /* [in] SleepPeriod as defined by UPnP Low Power. */ int SleepPeriod, /* [in] RegistrationState as defined by UPnP Low Power. */ int RegistrationState); /*! * \brief Creates the advertisement packet based on the input parameter, * and send it to the multicast channel. * * \return UPNP_E_SUCCESS if successful else appropriate error. */ int ServiceReply( /* [in] . */ struct sockaddr *DestAddr, /* [in] Service Type. */ char *ServType, /* [in] Device UDN. */ char *Udn, /* [in] Location of Device description document. */ char *Location, /* [in] Life time of this device. */ int Duration, /* [in] PowerState as defined by UPnP Low Power. */ int PowerState, /* [in] SleepPeriod as defined by UPnP Low Power. */ int SleepPeriod, /* [in] RegistrationState as defined by UPnP Low Power. */ int RegistrationState); /*! * \brief Creates a HTTP service shutdown request packet and sends it to the * multicast channel through RequestHandler. * * \return UPNP_E_SUCCESS if successful else appropriate error. */ int ServiceShutdown( /* [in] Device UDN. */ char *Udn, /* [in] Service Type. */ char *ServType, /* [in] Location of Device description document. */ char *Location, /* [in] Service duration in sec. */ int Duration, /* [in] Device address family. */ int AddressFamily, /* [in] PowerState as defined by UPnP Low Power. */ int PowerState, /* [in] SleepPeriod as defined by UPnP Low Power. */ int SleepPeriod, /* [in] RegistrationState as defined by UPnP Low Power. */ int RegistrationState); /*! * \brief Creates a HTTP device shutdown request packet and send it to the * multicast channel through RequestHandler. * * \return UPNP_E_SUCCESS if successful else appropriate error. */ int DeviceShutdown( /* [in] Device Type. */ char *DevType, /* [in] 1 means root device. */ int RootDev, /* [in] Device UDN. */ char *Udn, /* [in] Location URL. */ char *Location, /* [in] Device duration in sec. */ int Duration, /* [in] Device address family. */ int AddressFamily, /* [in] PowerState as defined by UPnP Low Power. */ int PowerState, /* [in] SleepPeriod as defined by UPnP Low Power. */ int SleepPeriod, /* [in] RegistrationState as defined by UPnP Low Power. */ int RegistrationState); /* @} SSDP Device Functions */ /* @} SSDPlib SSDP Library */ #endif /* SSDPLIB_H */ pupnp-release-1.8.0/upnp/src/inc/statcodes.h000066400000000000000000000114661303304015100207620ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef GENLIB_NET_HTTP_STATCODES_H #define GENLIB_NET_HTTP_STATCODES_H /* HTTP response status codes */ #define HTTP_CONTINUE 100 #define HTTP_SWITCHING_PROCOTOLS 101 #define HTTP_OK 200 #define HTTP_CREATED 201 #define HTTP_ACCEPTED 202 #define HTTP_NON_AUTHORATATIVE 203 #define HTTP_NO_CONTENT 204 #define HTTP_RESET_CONTENT 205 #define HTTP_PARTIAL_CONTENT 206 #define HTTP_MULTIPLE_CHOICES 300 #define HTTP_MOVED_PERMANENTLY 301 #define HTTP_FOUND 302 #define HTTP_SEE_OTHER 303 #define HTTP_NOT_MODIFIED 304 #define HTTP_USE_PROXY 305 #define HTTP_UNUSED_3XX 306 #define HTTP_TEMPORARY_REDIRECT 307 #define HTTP_BAD_REQUEST 400 #define HTTP_UNAUTHORIZED 401 #define HTTP_PAYMENT_REQD 402 #define HTTP_FORBIDDEN 403 #define HTTP_NOT_FOUND 404 #define HTTP_METHOD_NOT_ALLOWED 405 #define HTTP_NOT_ACCEPTABLE 406 #define HTTP_PROXY_AUTH_REQD 407 #define HTTP_REQUEST_TIMEOUT 408 #define HTTP_CONFLICT 409 #define HTTP_GONE 410 #define HTTP_LENGTH_REQUIRED 411 #define HTTP_PRECONDITION_FAILED 412 #define HTTP_REQ_ENTITY_TOO_LARGE 413 #define HTTP_REQ_URI_TOO_LONG 414 #define HTTP_UNSUPPORTED_MEDIA_TYPE 415 #define HTTP_REQUEST_RANGE_NOT_SATISFIABLE 416 #define HTTP_EXPECTATION_FAILED 417 #define HTTP_INTERNAL_SERVER_ERROR 500 #define HTTP_NOT_IMPLEMENTED 501 #define HTTP_BAD_GATEWAY 502 #define HTTP_SERVICE_UNAVAILABLE 503 #define HTTP_GATEWAY_TIMEOUT 504 #define HTTP_HTTP_VERSION_NOT_SUPPORTED 505 #define HTTP_VARIANT_ALSO_NEGOTIATES 506 #define HTTP_INSUFFICIENT_STORAGE 507 #define HTTP_LOOP_DETECTED 508 #define HTTP_NOT_EXTENDED 510 /* HTTP lib error codes */ #define HTTP_E_OUT_OF_MEMORY -2 #define HTTP_E_BAD_MSG_FORMAT -3 #define HTTP_E_TIMEDOUT -4 #define HTTP_E_FILE_READ -5 #ifdef __cplusplus extern "C" { #endif /************************************************************************ * Function: http_get_code_text * * Parameters: * int statusCode ; Status code based on which the status table and * status message is returned * * Description: Return the right status message based on the passed in * int statusCode input parameter * * Returns: * const char* ptr - pointer to the status message string ************************************************************************/ const char* http_get_code_text( int statusCode ); #ifdef __cplusplus } /* extern C */ #endif #endif /* GENLIB_NET_HTTP_STATCODES_H */ pupnp-release-1.8.0/upnp/src/inc/statuscodes.h000066400000000000000000000101631303304015100213230ustar00rootroot00000000000000/////////////////////////////////////////////////////////////////////////// // // Copyright (c) 2000-2003 Intel Corporation // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // // * Redistributions of source code must retain the above copyright notice, // this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above copyright notice, // this list of conditions and the following disclaimer in the documentation // and/or other materials provided with the distribution. // * Neither name of Intel Corporation nor the names of its contributors // may be used to endorse or promote products derived from this software // without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR // PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY // OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // /////////////////////////////////////////////////////////////////////////// #ifndef GENLIB_NET_HTTP_STATUSCODES_H #define GENLIB_NET_HTTP_STATUSCODES_H // HTTP response status codes #define HTTP_CONTINUE 100 #define HTTP_SWITCHING_PROCOTOLS 101 #define HTTP_OK 200 #define HTTP_CREATED 201 #define HTTP_ACCEPTED 202 #define HTTP_NON_AUTHORATATIVE 203 #define HTTP_NO_CONTENT 204 #define HTTP_RESET_CONTENT 205 #define HTTP_PARTIAL_CONTENT 206 #define HTTP_MULTIPLE_CHOICES 300 #define HTTP_MOVED_PERMANENTLY 301 #define HTTP_FOUND 302 #define HTTP_SEE_OTHER 303 #define HTTP_NOT_MODIFIED 304 #define HTTP_USE_PROXY 305 #define HTTP_UNUSED_3XX 306 #define HTTP_TEMPORARY_REDIRECT 307 #define HTTP_BAD_REQUEST 400 #define HTTP_UNAUTHORIZED 401 #define HTTP_PAYMENT_REQD 402 #define HTTP_FORBIDDEN 403 #define HTTP_NOT_FOUND 404 #define HTTP_METHOD_NOT_ALLOWED 405 #define HTTP_NOT_ACCEPTABLE 406 #define HTTP_PROXY_AUTH_REQD 407 #define HTTP_REQUEST_TIMEOUT 408 #define HTTP_CONFLICT 409 #define HTTP_GONE 410 #define HTTP_LENGTH_REQUIRED 411 #define HTTP_PRECONDITION_FAILED 412 #define HTTP_REQ_ENTITY_TOO_LARGE 413 #define HTTP_REQ_URI_TOO_LONG 414 #define HTTP_UNSUPPORTED_MEDIA_TYPE 415 #define HTTP_REQUEST_RANGE_NOT_SATISFIABLE 416 #define HTTP_EXPECTATION_FAILED 417 #define HTTP_INTERNAL_SERVER_ERROR 500 #define HTTP_NOT_IMPLEMENTED 501 #define HTTP_BAD_GATEWAY 502 #define HTTP_SERVICE_UNAVAILABLE 503 #define HTTP_GATEWAY_TIMEOUT 504 #define HTTP_HTTP_VERSION_NOT_SUPPORTED 505 // *********** HTTP lib error codes ********** #define HTTP_E_OUT_OF_MEMORY -2 #define HTTP_E_BAD_MSG_FORMAT -3 #define HTTP_E_TIMEDOUT -4 #define HTTP_E_FILE_READ -5 // ******************************************* #ifdef __cplusplus extern "C" { #endif const char* http_GetCodeText( int statusCode ); #ifdef __cplusplus } // extern C #endif #endif /* GENLIB_NET_HTTP_STATUSCODES_H */ pupnp-release-1.8.0/upnp/src/inc/strintmap.h000066400000000000000000000071231303304015100210050ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef GENLIB_UTIL_STRINTMAP_H #define GENLIB_UTIL_STRINTMAP_H #include #include "upnputil.h" /* Util to map from a string to an integer and vice versa */ typedef struct /* str_int_entry */ { const char *name; /* a value in string form */ int id; /* same value in integer form */ } str_int_entry; #ifdef __cplusplus extern "C" { #endif /************************************************************************ * Function : map_str_to_int * * Parameters : * IN const char* name ; string containing the name to be matched * IN size_t name_len ; size of the string to be matched * IN str_int_entry* table ; table of entries that need to be * matched. * IN int num_entries ; number of entries in the table that need * to be searched. * IN int case_sensitive ; whether the case should be case * sensitive or not * * Description : Match the given name with names from the entries in the * table. Returns the index of the table when the entry is found. * * Return : int ; * index - On Success * -1 - On failure * * Note : ************************************************************************/ int map_str_to_int( IN const char* name, IN size_t name_len, IN str_int_entry* table, IN int num_entries, IN int case_sensitive ); /************************************************************************ * Function : map_int_to_str * * Parameters : * IN int id ; ID to be matched * IN str_int_entry* table ; table of entries that need to be * matched. * IN int num_entries ; number of entries in the table that need * to be searched. * * Description : Returns the index from the table where the id matches * the entry from the table. * * Return : int ; * * Note : ************************************************************************/ int map_int_to_str( IN int id, IN str_int_entry* table, IN int num_entries ); #ifdef __cplusplus } /* extern C */ #endif #endif /* GENLIB_UTIL_STRINTMAP_H */ pupnp-release-1.8.0/upnp/src/inc/sysdep.h000066400000000000000000000036301303304015100202720ustar00rootroot00000000000000#ifndef SYSDEP_H #define SYSDEP_H /* * Copyright (c) 1990- 1993, 1996 Open Software Foundation, Inc. * Copyright (c) 1989 by Hewlett-Packard Company, Palo Alto, Ca. & * Digital Equipment Corporation, Maynard, Mass. * Copyright (c) 1998 Microsoft. * To anyone who acknowledges that this file is provided "AS IS" * without any express or implied warranty: permission to use, copy, * modify, and distribute this file for any purpose is hereby * granted without fee, provided that the above copyright notices and * this notice appears in all source code copies, and that none of * the names of Open Software Foundation, Inc., Hewlett-Packard * Company, or Digital Equipment Corporation be used in advertising * or publicity pertaining to distribution of the software without * specific, written prior permission. Neither Open Software * Foundation, Inc., Hewlett-Packard Company, Microsoft, nor Digital Equipment * Corporation makes any representations about the suitability of * this software for any purpose. */ /*! * \file */ #include "ithread.h" /* change to point to where MD5 .h's live */ /* get MD5 sample implementation from RFC 1321 */ #include "global.h" #include "md5.h" #include "UpnpStdInt.h" #include #ifdef WIN32 /* Do not #include */ #else #include #endif /*! set the following to the number of 100ns ticks of the actual resolution of * your system's clock */ #define UUIDS_PER_TICK 1024 /*! Set the following to a call to acquire a system wide global lock. */ extern ithread_mutex_t gUUIDMutex; #define UUIDLock() ithread_mutex_lock(&gUUIDMutex) #define UUIDUnlock() ithread_mutex_unlock(&gUUIDMutex) typedef uint64_t uuid_time_t; typedef struct { char nodeID[6]; } uuid_node_t; void get_ieee_node_identifier(uuid_node_t * node); void get_system_time(uuid_time_t * uuid_time); void get_random_info(unsigned char seed[16]); #endif /* SYSDEP_H */ pupnp-release-1.8.0/upnp/src/inc/unixutil.h000066400000000000000000000040541303304015100206450ustar00rootroot00000000000000#ifndef GENLIB_NET_UNIXUTIL_H #define GENLIB_NET_UNIXUTIL_H /******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /* Unix-specific network utilities */ #include "UpnpInet.h" #ifdef WIN32 #include typedef int socklen_t; #ifndef EAFNOSUPPORT /* VS2010 has this defined */ #define EAFNOSUPPORT 97 #endif #else #include #include #endif #endif /* GENLIB_NET_UNIXUTIL_H */ pupnp-release-1.8.0/upnp/src/inc/upnp_timeout.h000066400000000000000000000041551303304015100215160ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef UPNPTIMEOUT_H #define UPNPTIMEOUT_H /*! * \file */ /*! * The upnp_timeout structure definition. */ typedef struct UPNP_TIMEOUT { int EventType; int handle; int eventId; void *Event; } upnp_timeout; /*! * \brief Free memory associated with event and memory for any sub-elements. */ void free_upnp_timeout( /*! [in] Event which needs to be freed. */ upnp_timeout *event); #endif /* UPNPTIMEOUT_H */ pupnp-release-1.8.0/upnp/src/inc/upnpapi.h000066400000000000000000000204431303304015100204400ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (C) 2011-2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * * Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef UPNPAPI_H #define UPNPAPI_H /*! * \file */ #include "client_table.h" #include "upnp.h" #include "VirtualDir.h" /* for struct VirtualDirCallbacks */ #define MAX_INTERFACES 256 #define DEFAULT_INTERFACE 1 #define DEV_LIMIT 200 #define DEFAULT_MX 5 #define DEFAULT_MAXAGE 1800 #define DEFAULT_SOAP_CONTENT_LENGTH 16000 #define MAX_SOAP_CONTENT_LENGTH (size_t)32000 extern size_t g_maxContentLength; /* 30-second timeout */ #define UPNP_TIMEOUT 30 typedef enum {HND_INVALID=-1,HND_CLIENT,HND_DEVICE} Upnp_Handle_Type; /* Data to be stored in handle table for */ struct Handle_Info { /*! . */ Upnp_Handle_Type HType; /*! Callback function pointer. */ Upnp_FunPtr Callback; /*! . */ char *Cookie; /*! 0 = not installed; otherwise installed. */ int aliasInstalled; /* Device Only */ #ifdef INCLUDE_DEVICE_APIS /*! URL for the use of SSDP. */ char DescURL[LINE_SIZE]; /*! URL for the use of SSDP when answering to legacy CPs (CP searching * for a v1 when the device is v2). */ char LowerDescURL[LINE_SIZE]; /*! XML file path for device description. */ char DescXML[LINE_SIZE]; /* Advertisement timeout */ int MaxAge; /* Power State as defined by UPnP Low Power. */ int PowerState; /* Sleep Period as defined by UPnP Low Power. */ int SleepPeriod; /* Registration State as defined by UPnP Low Power. */ int RegistrationState; /*! Description parsed in terms of DOM document. */ IXML_Document *DescDocument; /*! List of devices in the description document. */ IXML_NodeList *DeviceList; /*! List of services in the description document. */ IXML_NodeList *ServiceList; /*! Table holding subscriptions and URL information. */ service_table ServiceTable; /*! . */ int MaxSubscriptions; /*! . */ int MaxSubscriptionTimeOut; /*! Address family: AF_INET or AF_INET6. */ int DeviceAf; #endif /* Client only */ #ifdef INCLUDE_CLIENT_APIS /*! Client subscription list. */ GenlibClientSubscription *ClientSubList; /*! Active SSDP searches. */ LinkedList SsdpSearchList; #endif }; extern ithread_rwlock_t GlobalHndRWLock; /*! * \brief Get handle information. * * \return HND_DEVICE, UPNP_E_INVALID_HANDLE */ Upnp_Handle_Type GetHandleInfo( /*! handle pointer (key for the client handle structure). */ int Hnd, /*! handle structure passed by this function. */ struct Handle_Info **HndInfo); #define HandleLock() HandleWriteLock() #define HandleWriteLock() \ UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Trying a write lock"); \ ithread_rwlock_wrlock(&GlobalHndRWLock); \ UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Write lock acquired"); #define HandleReadLock() \ UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Trying a read lock"); \ ithread_rwlock_rdlock(&GlobalHndRWLock); \ UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Read lock acquired"); #define HandleUnlock() \ UpnpPrintf(UPNP_INFO, API,__FILE__, __LINE__, "Trying Unlock"); \ ithread_rwlock_unlock(&GlobalHndRWLock); \ UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Unlocked rwlock"); /*! * \brief Get client handle info. * * \note The logic around the use of this function should be revised. * * \return HND_CLIENT, HND_INVALID */ Upnp_Handle_Type GetClientHandleInfo( /*! [in] client handle pointer (key for the client handle structure). */ int *client_handle_out, /*! [out] Client handle structure passed by this function. */ struct Handle_Info **HndInfo); /*! * \brief Retrieves the device handle and information of the first device of * the address family spcified. * * \return HND_DEVICE or HND_INVALID */ Upnp_Handle_Type GetDeviceHandleInfo( /*! [in] Address family. */ int AddressFamily, /*! [out] Device handle pointer. */ int *device_handle_out, /*! [out] Device handle structure passed by this function. */ struct Handle_Info **HndInfo); extern char gIF_NAME[LINE_SIZE]; extern char gIF_IPV4[INET_ADDRSTRLEN]; extern char gIF_IPV6[INET6_ADDRSTRLEN]; extern char gIF_IPV6_ULA_GUA[INET6_ADDRSTRLEN]; extern unsigned gIF_INDEX; extern unsigned short LOCAL_PORT_V4; extern unsigned short LOCAL_PORT_V6; /*! NLS uuid. */ extern Upnp_SID gUpnpSdkNLSuuid; extern TimerThread gTimerThread; extern ThreadPool gRecvThreadPool; extern ThreadPool gSendThreadPool; extern ThreadPool gMiniServerThreadPool; typedef enum { SUBSCRIBE, UNSUBSCRIBE, DK_NOTIFY, QUERY, ACTION, STATUS, DEVDESCRIPTION, SERVDESCRIPTION, MINI, RENEW } UpnpFunName; struct UpnpNonblockParam { UpnpFunName FunName; int Handle; int TimeOut; char VarName[NAME_SIZE]; char NewVal[NAME_SIZE]; char DevType[NAME_SIZE]; char DevId[NAME_SIZE]; char ServiceType[NAME_SIZE]; char ServiceVer[NAME_SIZE]; char Url[NAME_SIZE]; Upnp_SID SubsId; char *Cookie; Upnp_FunPtr Fun; IXML_Document *Header; IXML_Document *Act; struct DevDesc *Devdesc; }; extern virtualDirList *pVirtualDirList; extern struct VirtualDirCallbacks virtualDirCallback; typedef enum { WEB_SERVER_DISABLED, WEB_SERVER_ENABLED } WebServerState; #define E_HTTP_SYNTAX -6 /*! * \brief Retrieve interface information and keep it in global variables. * If NULL, we'll find the first suitable interface for operation. * * The interface must fulfill these requirements: * \li Be UP. * \li Not be LOOPBACK. * \li Support MULTICAST. * \li Have a valid IPv4 or IPv6 address. * * We'll retrieve the following information from the interface: * \li gIF_NAME -> Interface name (by input or found). * \li gIF_IPV4 -> IPv4 address (if any). * \li gIF_IPV6 -> IPv6 address (if any). * \li gIF_IPV6_ULA_GUA -> ULA or GUA IPv6 address (if any) * \li gIF_INDEX -> Interface index number. * * \return UPNP_E_SUCCESS on success. */ int UpnpGetIfInfo( /*! [in] Interface name (can be NULL). */ const char *IfName); void UpnpThreadDistribution(struct UpnpNonblockParam * Param); /*! * \brief This function is a timer thread scheduled by UpnpSendAdvertisement * to the send advetisement again. */ void AutoAdvertise( /*! [in] Information provided to the thread. */ void *input); /*! * \brief Get local IP address. * * Gets the ip address for the DEFAULT_INTERFACE interface which is up and not * a loopback. Assumes at most MAX_INTERFACES interfaces * * \return UPNP_E_SUCCESS if successful or UPNP_E_INIT. */ int getlocalhostname( /*! [out] IP address of the interface. */ char *out, /*! [in] Length of the output buffer. */ size_t out_len); /*! * \brief Print handle info. * * \return UPNP_E_SUCCESS if successful, otherwise returns appropriate error. */ int PrintHandleInfo( /*! [in] Handle index. */ UpnpClient_Handle Hnd); extern WebServerState bWebServerState; #endif /* UPNPAPI_H */ pupnp-release-1.8.0/upnp/src/inc/upnputil.h000066400000000000000000000101061303304015100206370ustar00rootroot00000000000000#ifndef UTIL_H #define UTIL_H /******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \file */ #include "upnp.h" #include /* usually used to specify direction of parameters in functions */ #ifndef IN #define IN #endif #ifndef OUT #define OUT #endif #ifndef INOUT #define INOUT #endif #define GEMD_OUT_OF_MEMORY -1 #define EVENT_TIMEDOUT -2 #define EVENT_TERMINATE -3 /*! boolean type in C. */ #ifndef TRUE #define TRUE 1 #endif #ifndef FALSE #define FALSE 0 #endif #ifdef __cplusplus extern "C" { #endif /*! * \brief Copy no of bytes spcified by the LINE_SIZE constant, from the * source buffer. Null terminate the destination buffer. */ void linecopy( /*! [out] output buffer. */ char dest[LINE_SIZE], /*! [in] input buffer. */ const char *src); /*! * \brief Copy no of bytes spcified by the NAME_SIZE constant, from the * source buffer. Null terminate the destination buffer */ void namecopy( /*! [out] output buffer. */ char dest[NAME_SIZE], /*! [in] input buffer. */ const char *src); /*! * \brief Determine if the srclen passed in paramter is less than the * permitted LINE_SIZE. If it is use the passed parameter, if not * use the permitted LINE_SIZE as the length parameter. * * Copy no of bytes spcified by the LINE_SIZE constant, from the source * buffer. Null terminate the destination buffer. */ void linecopylen( /*! [out] output buffer. */ char dest[LINE_SIZE], /*! [in] input buffer. */ const char *src, /*! [in] bytes to be copied. */ size_t srclen); #ifdef __cplusplus } #endif /* Size of the errorBuffer variable, passed to the strerror_r() function */ #define ERROR_BUFFER_LEN (size_t)256 /* C specific */ /* VC needs these in C++ mode too (do other compilers?) */ #if !defined(__cplusplus) || defined(UPNP_USE_MSVCPP) #ifdef WIN32 #ifndef S_ISREG #define S_ISREG(m) (((m) & S_IFMT) == S_IFREG) #endif #ifndef S_ISDIR #define S_ISDIR(m) (((m) & S_IFMT) == S_IFDIR) #endif #ifndef EADDRINUSE /* VS2010 has this defined */ #define EADDRINUSE WSAEADDRINUSE #endif #define strcasecmp stricmp #define strncasecmp strnicmp #define sleep(a) Sleep((a)*1000) #define usleep(a) Sleep((a)/1000) #define strerror_r(a,b,c) (strerror_s((b),(c),(a))) #else #define max(a, b) (((a)>(b))? (a):(b)) #define min(a, b) (((a)<(b))? (a):(b)) #endif /* WIN32 */ #endif /* !defined(__cplusplus) || defined(UPNP_USE_MSVCPP) */ #endif /* UTIL_H */ pupnp-release-1.8.0/upnp/src/inc/uri.h000066400000000000000000000307441303304015100175700ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #ifndef GENLIB_NET_URI_H #define GENLIB_NET_URI_H /*! * \file */ #if !defined(WIN32) #include #endif #include "UpnpGlobal.h" /* for */ #include "UpnpInet.h" #include #include #include #include #include #include #include #ifdef WIN32 #ifndef UPNP_USE_MSVCPP /* VC Winsocks2 includes these functions */ #include "inet_pton.h" #endif #else #include /* for struct addrinfo */ #endif #ifdef WIN32 #define strncasecmp strnicmp #else /* Other systems have strncasecmp */ #endif #ifdef __cplusplus extern "C" { #endif /*! length for HTTP DATE: "DATE: Sun, 01 Jul 2000 08:15:23 GMT" */ #define HTTP_DATE_LENGTH 37 #define SEPARATORS "()<>@,;:\\\"/[]?={} \t" #define MARK "-_.!~*'()" /*! added {} for compatibility */ #define RESERVED ";/?:@&=+$,{}" #define HTTP_SUCCESS 1 #define FALSE 0 #define TAB 9 #define CR 13 #define LF 10 #define SOCKET_BUFFER_SIZE 5000 enum hostType { HOSTNAME, IPv4address }; enum pathType { ABS_PATH, REL_PATH, OPAQUE_PART }; #ifdef WIN32 /* there is a conflict in windows with other symbols. */ enum uriType { absolute, relative }; #else enum uriType { ABSOLUTE, RELATIVE }; #endif /*! * \brief Buffer used in parsinghttp messages, urls, etc. generally this simply * holds a pointer into a larger array. */ typedef struct TOKEN { const char *buff; size_t size; } token; /*! * \brief Represents a host port: e.g. "127.127.0.1:80" text is a token * pointing to the full string representation. */ typedef struct HOSTPORT { /*! Full host port. */ token text; /* Network Byte Order */ struct sockaddr_storage IPaddress; } hostport_type; /*! * \brief Represents a URI used in parse_uri and elsewhere */ typedef struct URI{ enum uriType type; token scheme; enum pathType path_type; token pathquery; token fragment; hostport_type hostport; } uri_type; /*! * \brief Represents a list of URLs as in the "callback" header of SUBSCRIBE * message in GENA. "char *" URLs holds dynamic memory. */ typedef struct URL_LIST { /*! */ size_t size; /*! All the urls, delimited by <> */ char *URLs; /*! */ uri_type *parsedURLs; } URL_list; /*! * \brief Replaces an escaped sequence with its unescaped version as in * http://www.ietf.org/rfc/rfc2396.txt (RFC explaining URIs) * * Size of array is NOT checked (MUST be checked by caller) * * \note This function modifies the string. If the sequence is an escaped * sequence it is replaced, the other characters in the string are shifted * over, and NULL characters are placed at the end of the string. * * \return */ int replace_escaped( /*! [in,out] String of characters. */ char *in, /*! [in] Index at which to start checking the characters. */ size_t index, /*! [out] . */ size_t *max); /*! * \brief Copies one URL_list into another. * * This includes dynamically allocating the out->URLs field (the full string), * and the structures used to hold the parsedURLs. This memory MUST be freed * by the caller through: free_URL_list(&out). * * \return * \li HTTP_SUCCESS - On Success. * \li UPNP_E_OUTOF_MEMORY - On Failure to allocate memory. */ int copy_URL_list( /*! [in] Source URL list. */ URL_list *in, /*! [out] Destination URL list. */ URL_list *out); /*! * \brief Frees the memory associated with a URL_list. * * Frees the dynamically allocated members of of list. Does NOT free the * pointer to the list itself ( i.e. does NOT free(list)). */ void free_URL_list( /*! [in] URL list object. */ URL_list *list); /*! * \brief Function useful in debugging for printing a parsed uri. */ #ifdef DEBUG void print_uri( /*! [in] URI object to print. */ uri_type *in); #else static UPNP_INLINE void print_uri(uri_type *in) { return; in = in; } #endif /*! * \brief Function useful in debugging for printing a token. */ #ifdef DEBUG void print_token( /*! [in] Token object to print. */ token *in); #else static UPNP_INLINE void print_token( /*! [in] Token object to print. */ token *in) { return; in = in; } #endif /*! * \brief Compares buffer in the token object with the buffer in in2. * * \return * \li < 0, if string1 is less than string2. * \li == 0, if string1 is identical to string2 . * \li > 0, if string1 is greater than string2. */ int token_string_casecmp( /*! [in] Token object whose buffer is to be compared. */ token *in1, /*! [in] String of characters to compare with. */ const char *in2); /*! * \brief Compares a null terminated string to a token (exact). * * \return * \li < 0, if string1 is less than string2. * \li == 0, if string1 is identical to string2 . * \li > 0, if string1 is greater than string2. */ int token_string_cmp( /*! [in] Token object whose buffer is to be compared. */ token *in1, /*! [in] String of characters to compare with. */ char *in2); /*! * \brief Compares two tokens. * * \return * \li < 0, if string1 is less than string2. * \li == 0, if string1 is identical to string2 . * \li > 0, if string1 is greater than string2. */ int token_cmp( /*! [in] First token object whose buffer is to be compared. */ token *in1, /*! [in] Second token object used for the comparison. */ token *in2); /*! * \brief Removes http escaped characters such as: "%20" and replaces them with * their character representation. i.e. "hello%20foo" -> "hello foo". * * The input IS MODIFIED in place (shortened). Extra characters are replaced * with \b NULL. * * \return UPNP_E_SUCCESS. */ int remove_escaped_chars( /*! [in,out] String of characters to be modified. */ char *in, /*! [in,out] Size limit for the number of characters. */ size_t *size); /*! * \brief Removes ".", and ".." from a path. * * If a ".." can not be resolved (i.e. the .. would go past the root of the * path) an error is returned. * * The input IS modified in place.) * * \note Examples * char path[30]="/../hello"; * remove_dots(path, strlen(path)) -> UPNP_E_INVALID_URL * char path[30]="/./hello"; * remove_dots(path, strlen(path)) -> UPNP_E_SUCCESS, * in = "/hello" * char path[30]="/./hello/foo/../goodbye" -> * UPNP_E_SUCCESS, in = "/hello/goodbye" * * \return * \li UPNP_E_SUCCESS - On Success. * \li UPNP_E_OUTOF_MEMORY - On failure to allocate memory. * \li UPNP_E_INVALID_URL - Failure to resolve URL. */ int remove_dots( /*! [in] String of characters from which "dots" have to be removed. */ char *in, /*! [in] Size limit for the number of characters. */ size_t size); /*! * \brief resolves a relative url with a base url returning a NEW (dynamically * allocated with malloc) full url. * * If the base_url is \b NULL, then a copy of the rel_url is passed back if * the rel_url is absolute then a copy of the rel_url is passed back if neither * the base nor the rel_url are Absolute then NULL is returned. Otherwise it * tries and resolves the relative url with the base as described in * http://www.ietf.org/rfc/rfc2396.txt (RFCs explaining URIs). * * The resolution of '..' is NOT implemented, but '.' is resolved. * * \return */ char *resolve_rel_url( /*! [in] Base URL. */ char *base_url, /*! [in] Relative URL. */ char *rel_url); /*! * \brief Parses a uri as defined in http://www.ietf.org/rfc/rfc2396.txt * (RFC explaining URIs). * * Handles absolute, relative, and opaque uris. Parses into the following * pieces: scheme, hostport, pathquery, fragment (path and query are treated * as one token) * * Caller should check for the pieces they require. * * \return */ int parse_uri( /*! [in] Character string containing uri information to be parsed. */ const char *in, /*! [in] Maximum limit on the number of characters. */ size_t max, /*! [out] Output parameter which will have the parsed uri information. */ uri_type *out); /*! * \brief Same as parse_uri(), except that all strings are unescaped * (%XX replaced by chars). * * \note This modifies 'pathquery' and 'fragment' parts of the input. * * \return */ int parse_uri_and_unescape( /*! [in] Character string containing uri information to be parsed. */ char *in, /*! [in] Maximum limit on the number of characters. */ size_t max, /*! [out] Output parameter which will have the parsed uri information. */ uri_type *out); /*! * \brief * * \return */ int parse_token( /*! [in] . */ char *in, /*! [out] . */ token *out, /*! [in] . */ int max_size); /* Commented #defines, functions and typdefs */ #if 0 #define HTTP_E_BAD_URL UPNP_E_INVALID_URL #define HTTP_E_READ_SOCKET UPNP_E_SOCKET_READ #define HTTP_E_BIND_SOCKET UPNP_E_SOCKET_BIND #define HTTP_E_WRITE_SOCKET UPNP_E_SOCKET_WRITE #define HTTP_E_CONNECT_SOCKET UPNP_E_SOCKET_CONNECT #define HTTP_E_SOCKET UPNP_E_OUTOF_SOCKET #define HTTP_E_BAD_RESPONSE UPNP_E_BAD_RESPONSE #define HTTP_E_BAD_REQUEST UPNP_E_BAD_REQUEST #define HTTP_E_BAD_IP_ADDRESS UPNP_E_INVALID_URL #define RESPONSE_TIMEOUT 30 #endif #if 0 /*! * Buffer used to store data read from a socket during an http transfer in * function read_bytes. */ typedef struct SOCKET_BUFFER{ char buff[SOCKET_BUFFER_SIZE]; int size; struct SOCKET_BUFFER *next; } socket_buffer; typedef struct HTTP_HEADER { token header; token value; struct HTTP_HEADER * next; } http_header; typedef struct HTTP_STATUS_LINE{ token http_version; token status_code; token reason_phrase; } http_status; typedef struct HTTP_REQUEST_LINE { token http_version; uri_type request_uri; token method; } http_request; /*! * Represents a parsed HTTP_MESSAGE head_list is dynamically allocated */ typedef struct HTTP_MESSAGE { http_status status; http_request request; http_header * header_list; token content; } http_message; #endif #if 0 int transferHTTP( char *request, char *toSend, int toSendSize, char **out, char *Url); int transferHTTPRaw( char *toSend, int toSendSize, char **out, char *URL); /*! * \brief helper function. */ int transferHTTPparsedURL( char *request, char *toSend, int toSendSize, char **out, uri_type *URL); /*! * \brief assumes that char * out has enough space ( 38 characters) * outputs the current time in the following null terminated string: * "DATE: Sun, Jul 06 2000 08:53:01 GMT\r\n" */ void currentTmToHttpDate( char *out); int parse_http_response( char *in, http_message *out, int max_len); int parse_http_request( char *in, http_message *out, int max_len); void print_http_message( http_message *message); int search_for_header( http_message *in, char *header, token *out_value); void print_status_line( http_status *in); void print_request_line( http_request *in); int parse_http_line( char *in, int max_size); int parse_not_LWS( char *in, token *out, int max_size); int parse_LWS( char *in, int max_size); size_t write_bytes( int fd, char *bytes, size_t n, int timeout); void free_http_message( http_message *message); #endif #ifdef __cplusplus } #endif #endif /* GENLIB_NET_URI_H */ pupnp-release-1.8.0/upnp/src/inc/urlconfig.h000066400000000000000000000057331303304015100207610ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ #ifndef URLCONFIG_H #define URLCONFIG_H #include "UpnpInet.h" /* functions available only if the web server is included */ #ifdef __cplusplus extern "C" { #endif /************************************************************************ * Function: configure_urlbase * * Parameters : * INOUT IXML_Document *doc ; IXML Description document * IN const struct sockaddr *serverAddr; socket address object * providing the IP address and port information * IN const char* alias ; string containing the alias * IN time_t last_modified ; time when the XML document was * downloaded * OUT char docURL[LINE_SIZE] ; buffer to hold the URL of the * document. * * Description : Configure the full URL for the description document. * Create the URL document and add alias, description information. * The doc is added to the web server to be served using the given * alias. * * Return : int ; * UPNP_E_SUCCESS - On Success * UPNP_E_OUTOF_MEMORY - Default Error ****************************************************************************/ int configure_urlbase( INOUT IXML_Document *doc, IN const struct sockaddr* serverAddr, IN const char* alias, IN time_t last_modified, OUT char docURL[LINE_SIZE]); #ifdef __cplusplus } /* extern C */ #endif #endif /* URLCONFIG_H */ pupnp-release-1.8.0/upnp/src/inc/uuid.h000066400000000000000000000042201303304015100177250ustar00rootroot00000000000000#ifndef UUID_H #define UUID_H /* * Copyright (c) 1990- 1993, 1996 Open Software Foundation, Inc. * Copyright (c) 1989 by Hewlett-Packard Company, Palo Alto, Ca. & * Digital Equipment Corporation, Maynard, Mass. * Copyright (c) 1998 Microsoft. * To anyone who acknowledges that this file is provided "AS IS" * without any express or implied warranty: permission to use, copy, * modify, and distribute this file for any purpose is hereby * granted without fee, provided that the above copyright notices and * this notice appears in all source code copies, and that none of * the names of Open Software Foundation, Inc., Hewlett-Packard * Company, or Digital Equipment Corporation be used in advertising * or publicity pertaining to distribution of the software without * specific, written prior permission. Neither Open Software * Foundation, Inc., Hewlett-Packard Company, Microsoft, nor Digital Equipment * Corporation makes any representations about the suitability of * this software for any purpose. */ #include "sysdep.h" /*! . */ typedef struct _uuid_upnp { /*! . */ uint32_t time_low; /*! . */ uint16_t time_mid; /*! . */ uint16_t time_hi_and_version; /*! . */ uint8_t clock_seq_hi_and_reserved; /*! . */ uint8_t clock_seq_low; /*! . */ uint8_t node[6]; } uuid_upnp; /*! * \brief Generate a UUID. */ int uuid_create( /*! . */ uuid_upnp * id); /*! * \brief Out will be xxxx-xx-xx-xx-xxxxxx format. */ void uuid_unpack( /*! . */ uuid_upnp * u, /*! . */ char *out); /*! * \brief Create a UUID using a "name" from a "name space" */ void uuid_create_from_name( /*! Resulting UUID. */ uuid_upnp * uid, /*! UUID to serve as context, so identical names from different name * spaces generate different UUIDs. */ uuid_upnp nsid, /*! The name from which to generate a UUID. */ void *name, /*! The length of the name. */ int namelen); /*! * \brief Compare two UUID's "lexically". * * \return * -1 u1 is lexically before u2 * 0 u1 is equal to u2 * 1 u1 is lexically after u2 * * \note Lexical ordering is not temporal ordering! */ int uuid_compare( /*! . */ uuid_upnp * u1, /*! . */ uuid_upnp * u2); #endif /* UUID_H */ pupnp-release-1.8.0/upnp/src/inc/webserver.h000066400000000000000000000100761303304015100207710ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ #ifndef GENLIB_NET_HTTP_WEBSERVER_H #define GENLIB_NET_HTTP_WEBSERVER_H #include #include "sock.h" #include "httpparser.h" #ifdef __cplusplus extern "C" { #endif struct SendInstruction { int IsVirtualFile; int IsChunkActive; int IsRangeActive; int IsTrailers; char RangeHeader[200]; char AcceptLanguageHeader[200]; off_t RangeOffset; /*! Read from local source and send on the network. */ off_t ReadSendSize; /*! Recv from the network and write into local file. */ long RecvWriteSize; /* Later few more member could be added depending * on the requirement.*/ }; /*! * \brief Initilialize the different documents. Initialize the memory * for root directory for web server. Call to initialize global XML * document. Sets bWebServerState to WEB_SERVER_ENABLED. * * \note alias_content is not freed here * * \return * \li \c 0 - OK * \li \c UPNP_E_OUTOF_MEMORY */ int web_server_init(void); /*! * \brief Release memory allocated for the global web server root * directory and the global XML document. Resets the flag bWebServerState * to WEB_SERVER_DISABLED. */ void web_server_destroy(void); /*! * \brief Replaces current alias with the given alias. To remove the current * alias, set alias_name to NULL. * * \note alias_content is not freed here * * \return * \li \c 0 - OK * \li \c UPNP_E_OUTOF_MEMORY */ int web_server_set_alias( /*! [in] Webserver name of alias; created by caller and freed by caller * (doesn't even have to be malloc()d. */ const char* alias_name, /*! [in] The xml doc; this is allocated by the caller; and freed by * the web server. */ const char* alias_content, /*! [in] Length of alias body in bytes. */ size_t alias_content_length, /*! [in] Time when the contents of alias were last changed (local time). */ time_t last_modified); /*! * \brief Assign the path specfied by the input const char* root_dir parameter * to the global Document root directory. Also check for path names ending * in '/'. * * \return Integer. */ int web_server_set_root_dir( /*! [in] String having the root directory for the document. */ const char* root_dir); /*! * \brief Main entry point into web server; Handles HTTP GET and HEAD * requests. */ void web_server_callback( /*! [in] . */ http_parser_t *parser, /*! [in] . */ http_message_t *req, /*! [in,out] . */ SOCKINFO *info); #ifdef __cplusplus } /* extern C */ #endif #endif /* GENLIB_NET_HTTP_WEBSERVER_H */ pupnp-release-1.8.0/upnp/src/inet_pton.c000066400000000000000000000163031303304015100202050ustar00rootroot00000000000000/* * Copyright (c) 1996-1999 by Internet Software Consortium. * * Permission to use, copy, modify, and distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS * ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES * OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE * CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS * SOFTWARE. */ /*! * \file */ /* This file is WIN32 only */ #ifdef WIN32 #include "inet_pton.h" /*! * \brief format an IPv4 address * * \return `dst' (as a const) * * \note * \li (1) uses no statics * \li (2) takes a u_char* not an in_addr as input */ static const char *inet_ntop4(const u_char *src, char *dst, socklen_t size) { char tmp[sizeof ("255.255.255.255") + 1] = "\0"; int octet; int i; i = 0; for (octet = 0; octet <= 3; octet++) { if (src[octet]>255) { //__set_errno (ENOSPC); return (NULL); } tmp[i++] = '0' + src[octet] / 100; if (tmp[i - 1] == '0') { tmp[i - 1] = '0' + (src[octet] / 10 % 10); if (tmp[i - 1] == '0') i--; } else { tmp[i++] = '0' + (src[octet] / 10 % 10); } tmp[i++] = '0' + src[octet] % 10; tmp[i++] = '.'; } tmp[i - 1] = '\0'; if ((socklen_t)strlen(tmp)>size) { //__set_errno (ENOSPC); return (NULL); } return strcpy(dst, tmp); } #ifdef INET_IPV6 /*! * \brief convert IPv6 binary address into presentation (printable) format */ static const char *inet_ntop6(const u_char *src, char *dst, socklen_t size) { /* * Note that int32_t and int16_t need only be "at least" large enough * to contain a value of the specified size. On some systems, like * Crays, there is no such thing as an integer variable with 16 bits. * Keep this in mind if you think this function should have been coded * to use pointer overlays. All the world's not a VAX. */ char tmp[sizeof ("ffff:ffff:ffff:ffff:ffff:ffff:255.255.255.255")], *tp; struct { int base, len; } best, cur; u_int words[8]; int i; /* * Preprocess: * Copy the input (bytewise) array into a wordwise array. * Find the longest run of 0x00's in src[] for :: shorthanding. */ memset(words, '\0', sizeof words); for (i = 0; i < 16; i += 2) words[i / 2] = (src[i] << 8) | src[i + 1]; best.base = -1; cur.base = -1; for (i = 0; i < 8; i++) { if (words[i] == 0) { if (cur.base == -1) cur.base = i, cur.len = 1; else cur.len++; } else { if (cur.base != -1) { if (best.base == -1 || cur.len best.len) best = cur; cur.base = -1; } } } if (cur.base != -1) { if (best.base == -1 || cur.len best.len) best = cur; } if (best.base != -1 && best.len < 2) best.base = -1; /* * Format the result. */ tp = tmp; for (i = 0; i < 8; i++) { /* Are we inside the best run of 0x00's? */ if (best.base != -1 && i >= best.base && i < (best.base + best.len)) { if (i == best.base) *tp++ = ':'; continue; } /* Are we following an initial run of 0x00s or any real hex? */ if (i != 0) *tp++ = ':'; /* Is this address an encapsulated IPv4? */ if (i == 6 && best.base == 0 && (best.len == 6 || (best.len == 5 && words[5] == 0xffff))) { if (!inet_ntop4(src+12, tp, sizeof tmp - (tp - tmp))) return (NULL); tp += strlen(tp); break; } tp += SPRINTF((tp, "%x", words[i])); } /* Was it a trailing run of 0x00's? */ if (best.base != -1 && (best.base + best.len) == 8) *tp++ = ':'; *tp++ = '\0'; /* Check for overflow, copy, and we're done. */ if ((socklen_t)(tp - tmp) size) { //__set_errno (ENOSPC); return (NULL); } return strcpy(dst, tmp); } #endif /* INET_IPV6 */ /*! * \brief like inet_aton() but without all the hexadecimal and shorthand. * * \return 1 if `src' is a valid dotted quad, else 0. * * \note does not touch `dst' unless it's returning 1. */ static int inet_pton4(const char *src,u_char *dst) { int saw_digit, octets, ch; u_char tmp[4], *tp; saw_digit = 0; octets = 0; *(tp = tmp) = 0; while ((ch = *src++) != '\0') { if (ch >= '0' && ch <= '9') { u_int new = *tp * 10 + (ch - '0'); if (new>255) return (0); *tp = new; if (! saw_digit) { if (++octets>4) return (0); saw_digit = 1; } } else if (ch == '.' && saw_digit) { if (octets == 4) return (0); *++tp = 0; saw_digit = 0; } else return (0); } if (octets < 4) return (0); memcpy(dst, tmp, 4); return 1; } #ifdef INET_IPV6 /*! * \brief convert presentation level address to network order binary form. * * \return 1 if `src' is a valid [RFC1884 2.2] address, else 0. * * \note * \li (1) does not touch `dst' unless it's returning 1. * \li (2) :: in a full address is silently ignored. */ static int inet_pton6(const char *src, u_char *dst) { static const char xdigits[] = "0123456789abcdef"; u_char tmp[16], *tp, *endp, *colonp; const char *curtok; int ch, saw_xdigit; u_int val; tp = memset(tmp, '\0', 16); endp = tp + 16; colonp = NULL; /* Leading :: requires some special handling. */ if (*src == ':') if (*++src != ':') return (0); curtok = src; saw_xdigit = 0; val = 0; while ((ch = tolower (*src++)) != '\0') { const char *pch; pch = strchr(xdigits, ch); if (pch != NULL) { val <<= 4; val |= (pch - xdigits); if (val 0xffff) return (0); saw_xdigit = 1; continue; } if (ch == ':') { curtok = src; if (!saw_xdigit) { if (colonp) return (0); colonp = tp; continue; } else if (*src == '\0') { return (0); } if (tp + 2 endp) return (0); *tp++ = (u_char) (val >8) & 0xff; *tp++ = (u_char) val & 0xff; saw_xdigit = 0; val = 0; continue; } if (ch == '.' && ((tp + 4) <= endp) && inet_pton4(curtok, tp) 0) { tp += 4; saw_xdigit = 0; break; /* '\0' was seen by inet_pton4(). */ } return (0); } if (saw_xdigit) { if (tp + 2 endp) return (0); *tp++ = (u_char) (val >8) & 0xff; *tp++ = (u_char) val & 0xff; } if (colonp != NULL) { /* Since some memmove()'s erroneously fail to handle * overlapping regions, we'll do the shift by hand. */ const int n = tp - colonp; int i; if (tp == endp) return (0); for (i = 1; i <= n; i++) { endp[- i] = colonp[n - i]; colonp[n - i] = 0; } tp = endp; } if (tp != endp) return (0); memcpy(dst, tmp, 16); return (1); } #endif /* INET_IPV6 */ const char *inet_ntop(int af, const void *src, char *dst,socklen_t size) { switch (af) { case AF_INET: return inet_ntop4(src, dst, size); #ifdef INET_IPV6 case AF_INET6: return inet_ntop6(src, dst, size); #endif default: /*__set_errno(EAFNOSUPPORT);*/ return NULL; } /* NOTREACHED */ } int inet_pton(int af, const char *src, void *dst) { switch (af) { case AF_INET: return inet_pton4(src, dst); #ifdef INET_IPV6 case AF_INET6: return inet_pton6(src, dst); #endif default: /*__set_errno(EAFNOSUPPORT);*/ return -1; } /* NOTREACHED */ } #endif /* WIN32 */ pupnp-release-1.8.0/upnp/src/soap/000077500000000000000000000000001303304015100170015ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/soap/soap_common.c000066400000000000000000000003351303304015100214600ustar00rootroot00000000000000 #include "config.h" #if EXCLUDE_SOAP == 0 #include "httpparser.h" #include "sock.h" #include "soaplib.h" const char *ContentTypeHeader = "CONTENT-TYPE: text/xml; charset=\"utf-8\"\r\n"; #endif /* EXCLUDE_SOAP */ pupnp-release-1.8.0/upnp/src/soap/soap_ctrlpt.c000066400000000000000000000646501303304015100215120ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ #include "config.h" #ifdef INCLUDE_CLIENT_APIS #if EXCLUDE_SOAP == 0 #include #include #include #include #include #include "miniserver.h" #include "membuffer.h" #include "httpparser.h" #include "httpreadwrite.h" #include "statcodes.h" #include "parsetools.h" #include "upnpapi.h" #include "soaplib.h" #include "uri.h" #include "upnp.h" #include "unixutil.h" #define SOAP_ACTION_RESP 1 #define SOAP_VAR_RESP 2 /*#define SOAP_ERROR_RESP 3*/ #define SOAP_ACTION_RESP_ERROR 3 #define SOAP_VAR_RESP_ERROR 4 /*! * \brief Compares 'name' and node's name. * * \return 0 if both are equal; 1 if not equal, and UPNP_E_OUTOF_MEMORY. */ static int dom_cmp_name( /* [in] lookup name. */ const char *name, /* [in] xml node. */ IXML_Node *node) { const DOMString node_name = NULL; memptr nameptr; memptr dummy; int ret_code; assert(name); assert(node); node_name = ixmlNode_getNodeName(node); if (node_name == NULL) return UPNP_E_OUTOF_MEMORY; if (strcmp(name, node_name) == 0) ret_code = 0; else if (matchstr((char *)node_name, strlen(node_name), "%s:%s%0", &dummy, &nameptr) == PARSE_OK && strcmp(nameptr.buf, name) == 0) ret_code = 0; else /* names are not the same */ ret_code = 1; return ret_code; } /*! * \brief Goes thru each child of 'start_node' looking for a node having * the name 'node_name'. * * \return UPNP_E_SUCCESS if successful else returns appropriate error. */ static int dom_find_node( /* [in] name of the node. */ const char *node_name, /* [in] complete xml node. */ IXML_Node *start_node, /* [out] matched node. */ IXML_Node **matching_node) { IXML_Node *node; /* invalid args */ if (!node_name || !start_node) return UPNP_E_NOT_FOUND; node = ixmlNode_getFirstChild(start_node); while (node != NULL) { /* match name */ if (dom_cmp_name(node_name, node) == 0) { *matching_node = node; return UPNP_E_SUCCESS; } /* free and next node */ node = ixmlNode_getNextSibling(node); } return UPNP_E_NOT_FOUND; } /*! * \brief Searches for the node specifed by the last name in the 'name' array. * * \return UPNP_E_SUCCESS if successful, else returns appropriate error. */ static int dom_find_deep_node( /* [in] array of names. */ const char *names[], /* [in] size of array. */ int num_names, /* [in] Node from where it should should be searched. */ IXML_Node *start_node, /* [out] Node that matches the last name of the array. */ IXML_Node **matching_node) { int i; IXML_Node *node; IXML_Node *match_node; assert(num_names > 0); node = start_node; if (dom_cmp_name(names[0], start_node) == 0) { if (num_names == 1) { *matching_node = start_node; return UPNP_E_SUCCESS; } } for (i = 1; i < num_names; i++) { if (dom_find_node(names[i], node, &match_node) != UPNP_E_SUCCESS) return UPNP_E_NOT_FOUND; if (i == num_names - 1) { *matching_node = match_node; return UPNP_E_SUCCESS; } /* try again */ node = match_node; } /* this line not reached */ return UPNP_E_NOT_FOUND; } /**************************************************************************** * Function : get_node_value * * Parameters : * IN IXML_Node *node : input node * * Description : This function returns the value of the text node * * Return : DOMString * string containing the node value * * Note :The given node must have a text node as its first child ****************************************************************************/ static const DOMString get_node_value( IN IXML_Node * node ) { IXML_Node *text_node = NULL; const DOMString text_value = NULL; text_node = ixmlNode_getFirstChild( node ); if( text_node == NULL ) { return NULL; } text_value = ixmlNode_getNodeValue( text_node ); return text_value; } /**************************************************************************** * Function : get_host_and_path * * Parameters : * IN char *ctrl_url : URL * OUT memptr *host : host string * OUT memptr *path : path string * OUT uri_type* url : URL type * * Description : This function retrives the host and path from the * control URL * * Return : int * returns 0 on success; -1 on error * * Note : ****************************************************************************/ static UPNP_INLINE int get_host_and_path( IN char *ctrl_url, OUT const memptr *host, OUT const memptr *path, OUT uri_type * url ) { if( parse_uri( ctrl_url, strlen( ctrl_url ), url ) != HTTP_SUCCESS ) { return -1; } /* This is done to ensure that the buffer is kept const */ ((memptr *)host)->buf = (char *)url->hostport.text.buff; ((memptr *)host)->length = url->hostport.text.size; ((memptr *)path)->buf = (char *)url->pathquery.buff; ((memptr *)path)->length = url->pathquery.size; return 0; } /**************************************************************************** * Function : get_action_name * * Parameters : * IN char* action : string containing action name * OUT memptr* name : name of the action * * Description : This functions retirves the action name in the buffer * * Return : int * returns 0 on success; -1 on error * * Note : ****************************************************************************/ static UPNP_INLINE int get_action_name( IN char *action, OUT memptr * name ) { memptr dummy; int ret_code; ret_code = matchstr( action, strlen( action ), " <%s:%s", &dummy, name ); return ret_code == PARSE_OK ? 0 : -1; } /*! * \brief Adds "MAN" field in the HTTP header. * * \return 0 on success, UPNP_E_OUTOFMEMORY on error. */ static UPNP_INLINE int add_man_header( /* [in,out] HTTP header. */ membuffer *headers) { size_t n; char *soap_action_hdr; const char *man_hdr = "MAN: \"http://schemas.xmlsoap.org/soap/envelope/\"; ns=01\r\n01-"; /* change POST to M-POST */ if (membuffer_insert(headers, "M-", 2, 0) != 0) return UPNP_E_OUTOF_MEMORY; soap_action_hdr = strstr(headers->buf, "SOAPACTION:"); /* can't fail */ assert(soap_action_hdr != NULL); /* insert MAN header */ n = (size_t)(soap_action_hdr - headers->buf); if (membuffer_insert(headers, man_hdr, strlen(man_hdr), n)) return UPNP_E_OUTOF_MEMORY; return 0; } /**************************************************************************** * Function : soap_request_and_response * * Parameters : * IN membuffer* request : request that will be sent to the device * IN uri_type* destination_url : destination address string * OUT http_parser_t *response : response from the device * * Description : This function sends the control point's request to the * device and receives a response from it. * * Return : int * * Note : ****************************************************************************/ static int soap_request_and_response( IN membuffer * request, IN uri_type * destination_url, OUT http_parser_t * response ) { int ret_code; ret_code = http_RequestAndResponse( destination_url, request->buf, request->length, SOAPMETHOD_POST, UPNP_TIMEOUT, response ); if( ret_code != 0 ) { httpmsg_destroy( &response->msg ); return ret_code; } /* method-not-allowed error */ if( response->msg.status_code == HTTP_METHOD_NOT_ALLOWED ) { ret_code = add_man_header( request ); /* change to M-POST msg */ if( ret_code != 0 ) { return ret_code; } httpmsg_destroy( &response->msg ); /* about to reuse response */ /* try again */ ret_code = http_RequestAndResponse( destination_url, request->buf, request->length, HTTPMETHOD_MPOST, UPNP_TIMEOUT, response ); if( ret_code != 0 ) { httpmsg_destroy( &response->msg ); } } return ret_code; } /**************************************************************************** * Function : get_response_value * * Parameters : * IN http_message_t* hmsg : HTTP response message * IN int code : return code in the HTTP response * IN char*name : name of the action * OUT int *upnp_error_code : UPnP error code * OUT IXML_Node ** action_value : SOAP response node * OUT DOMString * str_value : state varible value ( in the case of * querry state variable request) * * Description : This function handles the response coming back from the * device. This function parses the response and gives back the SOAP * response node. * * Return : int * return the type of the SOAP message if successful else returns * appropriate error. * * Note : ****************************************************************************/ static int get_response_value( IN http_message_t * hmsg, IN int code, IN char *name, OUT int *upnp_error_code, OUT IXML_Node ** action_value, OUT DOMString * str_value ) { IXML_Node *node = NULL; IXML_Node *root_node = NULL; IXML_Node *error_node = NULL; IXML_Document *doc = NULL; char *node_str = NULL; const char *temp_str = NULL; DOMString error_node_str = NULL; int err_code = UPNP_E_BAD_RESPONSE; /* default error */ int done = FALSE; const char *names[5]; const DOMString nodeValue; /* only 200 and 500 status codes are relevant */ if ((hmsg->status_code != HTTP_OK && hmsg->status_code != HTTP_INTERNAL_SERVER_ERROR) || !has_xml_content_type(hmsg)) goto error_handler; if (ixmlParseBufferEx(hmsg->entity.buf, &doc) != IXML_SUCCESS) goto error_handler; root_node = ixmlNode_getFirstChild((IXML_Node *) doc); if (root_node == NULL) goto error_handler; if (code == SOAP_ACTION_RESP) { /* try reading soap action response */ assert(action_value != NULL); *action_value = NULL; names[0] = "Envelope"; names[1] = "Body"; names[2] = name; if (dom_find_deep_node(names, 3, root_node, &node) == UPNP_E_SUCCESS) { node_str = ixmlPrintNode(node); if (node_str == NULL) { err_code = UPNP_E_OUTOF_MEMORY; goto error_handler; } if (ixmlParseBufferEx(node_str, (IXML_Document **) action_value) != IXML_SUCCESS) { err_code = UPNP_E_BAD_RESPONSE; goto error_handler; } err_code = SOAP_ACTION_RESP; done = TRUE; } } else if (code == SOAP_VAR_RESP) { /* try reading var response */ assert(str_value != NULL); *str_value = NULL; names[0] = "Envelope"; names[1] = "Body"; names[2] = "QueryStateVariableResponse"; names[3] = "return"; if (dom_find_deep_node(names, 4, root_node, &node) == UPNP_E_SUCCESS) { nodeValue = get_node_value(node); if (nodeValue == NULL) goto error_handler; *str_value = ixmlCloneDOMString(nodeValue); err_code = SOAP_VAR_RESP; done = TRUE; } } if (!done) { /* not action or var resp; read error code and description */ *str_value = NULL; names[0] = "Envelope"; names[1] = "Body"; names[2] = "Fault"; names[3] = "detail"; names[4] = "UPnPError"; if (dom_find_deep_node(names, 5, root_node, &error_node) != UPNP_E_SUCCESS) goto error_handler; if (dom_find_node("errorCode", error_node, &node) != UPNP_E_SUCCESS) goto error_handler; temp_str = get_node_value(node); if (!temp_str) goto error_handler; *upnp_error_code = atoi(temp_str); if (*upnp_error_code > 400) { err_code = *upnp_error_code; goto error_handler; /* bad SOAP error code */ } if (code == SOAP_VAR_RESP) { if (dom_find_node("errorDescription", error_node, &node) != UPNP_E_SUCCESS) { goto error_handler; } nodeValue = get_node_value(node); if (nodeValue == NULL) { goto error_handler; } *str_value = ixmlCloneDOMString(nodeValue); if (*str_value == NULL) { goto error_handler; } err_code = SOAP_VAR_RESP_ERROR; } else if (code == SOAP_ACTION_RESP) { error_node_str = ixmlPrintNode(error_node); if (error_node_str == NULL) { err_code = UPNP_E_OUTOF_MEMORY; goto error_handler; } if (ixmlParseBufferEx(error_node_str, (IXML_Document **) action_value) != IXML_SUCCESS) { err_code = UPNP_E_BAD_RESPONSE; goto error_handler; } err_code = SOAP_ACTION_RESP_ERROR; } } error_handler: ixmlDocument_free(doc); ixmlFreeDOMString(node_str); ixmlFreeDOMString(error_node_str); return err_code; } /**************************************************************************** * Function : SoapSendAction * * Parameters : * IN char* action_url : device contrl URL * IN char *service_type : device service type * IN IXML_Document *action_node : SOAP action node * OUT IXML_Document **response_node : SOAP response node * * Description : This function is called by UPnP API to send the SOAP * action request and waits till it gets the response from the device * pass the response to the API layer * * Return : int * returns UPNP_E_SUCCESS if successful else returns appropriate error * Note : ****************************************************************************/ int SoapSendAction( IN char *action_url, IN char *service_type, IN IXML_Document * action_node, OUT IXML_Document ** response_node ) { char *action_str = NULL; memptr name; membuffer request; membuffer responsename; int err_code; int ret_code; http_parser_t response; uri_type url; int upnp_error_code; char *upnp_error_str; int got_response = FALSE; off_t content_length; const char *xml_start = "\r\n" ""; const char *xml_end = "\r\n" "\r\n\r\n"; size_t xml_start_len; size_t xml_end_len; size_t action_str_len; *response_node = NULL; /* init */ err_code = UPNP_E_OUTOF_MEMORY; /* default error */ UpnpPrintf( UPNP_INFO, SOAP, __FILE__, __LINE__, "Inside SoapSendAction():" ); /* init */ membuffer_init( &request ); membuffer_init( &responsename ); /* print action */ action_str = ixmlPrintNode( ( IXML_Node * ) action_node ); if( action_str == NULL ) { goto error_handler; } /* get action name */ if( get_action_name( action_str, &name ) != 0 ) { err_code = UPNP_E_INVALID_ACTION; goto error_handler; } /* parse url */ if( http_FixStrUrl( action_url, strlen( action_url ), &url ) != 0 ) { err_code = UPNP_E_INVALID_URL; goto error_handler; } UpnpPrintf( UPNP_INFO, SOAP, __FILE__, __LINE__, "path=%.*s, hostport=%.*s\n", (int)url.pathquery.size, url.pathquery.buff, (int)url.hostport.text.size, url.hostport.text.buff ); xml_start_len = strlen( xml_start ); xml_end_len = strlen( xml_end ); action_str_len = strlen( action_str ); /* make request msg */ request.size_inc = 50; content_length = (off_t)(xml_start_len + action_str_len + xml_end_len); if (http_MakeMessage( &request, 1, 1, "q" "N" "s" "sssbsc" "Uc" "b" "b" "b", SOAPMETHOD_POST, &url, content_length, ContentTypeHeader, "SOAPACTION: \"", service_type, "#", name.buf, name.length, "\"", xml_start, xml_start_len, action_str, action_str_len, xml_end, xml_end_len ) != 0 ) { goto error_handler; } ret_code = soap_request_and_response( &request, &url, &response ); got_response = TRUE; if( ret_code != UPNP_E_SUCCESS ) { err_code = ret_code; goto error_handler; } if( membuffer_append( &responsename, name.buf, name.length ) != 0 || membuffer_append_str( &responsename, "Response" ) != 0 ) { goto error_handler; } /* get action node from the response */ ret_code = get_response_value( &response.msg, SOAP_ACTION_RESP, responsename.buf, &upnp_error_code, ( IXML_Node ** ) response_node, &upnp_error_str ); if( ret_code == SOAP_ACTION_RESP ) { err_code = UPNP_E_SUCCESS; } else if( ret_code == SOAP_ACTION_RESP_ERROR ) { err_code = upnp_error_code; } else { err_code = ret_code; } error_handler: ixmlFreeDOMString( action_str ); membuffer_destroy( &request ); membuffer_destroy( &responsename ); if( got_response ) { httpmsg_destroy( &response.msg ); } return err_code; } /**************************************************************************** * Function : SoapSendActionEx * * Parameters : * IN char* action_url : device contrl URL * IN char *service_type : device service type IN IXML_Document *Header: Soap header * IN IXML_Document *action_node : SOAP action node ( SOAP body) * OUT IXML_Document **response_node : SOAP response node * * Description : This function is called by UPnP API to send the SOAP * action request and waits till it gets the response from the device * pass the response to the API layer. This action is similar to the * the SoapSendAction with only difference that it allows users to * pass the SOAP header along the SOAP body ( soap action request) * * Return : int * returns UPNP_E_SUCCESS if successful else returns appropriate error * Note : ****************************************************************************/ int SoapSendActionEx( IN char *action_url, IN char *service_type, IN IXML_Document * header, IN IXML_Document * action_node, OUT IXML_Document ** response_node ) { char *xml_header_str = NULL; char *action_str = NULL; memptr name; membuffer request; membuffer responsename; int err_code; int ret_code; http_parser_t response; uri_type url; int upnp_error_code; char *upnp_error_str; int got_response = FALSE; const char *xml_start = "\r\n"; const char *xml_header_start = "\r\n"; const char *xml_header_end = "\r\n"; const char *xml_body_start = ""; const char *xml_end = "\r\n" "\r\n"; size_t xml_start_len; size_t xml_header_start_len; size_t xml_header_str_len; size_t xml_header_end_len; size_t xml_body_start_len; size_t action_str_len; size_t xml_end_len; off_t content_length; *response_node = NULL; /* init */ err_code = UPNP_E_OUTOF_MEMORY; /* default error */ UpnpPrintf( UPNP_INFO, SOAP, __FILE__, __LINE__, "Inside SoapSendActionEx():" ); /* init */ membuffer_init( &request ); membuffer_init( &responsename ); /* header string */ xml_header_str = ixmlPrintNode( ( IXML_Node * ) header ); if( xml_header_str == NULL ) { goto error_handler; } /* print action */ action_str = ixmlPrintNode( ( IXML_Node * ) action_node ); if( action_str == NULL ) { goto error_handler; } /* get action name */ if( get_action_name( action_str, &name ) != 0 ) { err_code = UPNP_E_INVALID_ACTION; goto error_handler; } /* parse url */ if( http_FixStrUrl( action_url, strlen( action_url ), &url ) != 0 ) { err_code = UPNP_E_INVALID_URL; goto error_handler; } UpnpPrintf( UPNP_INFO, SOAP, __FILE__, __LINE__, "path=%.*s, hostport=%.*s\n", (int)url.pathquery.size, url.pathquery.buff, (int)url.hostport.text.size, url.hostport.text.buff ); xml_start_len = strlen( xml_start ); xml_body_start_len = strlen( xml_body_start ); xml_end_len = strlen( xml_end ); action_str_len = strlen( action_str ); xml_header_start_len = strlen( xml_header_start ); xml_header_end_len = strlen( xml_header_end ); xml_header_str_len = strlen( xml_header_str ); /* make request msg */ request.size_inc = 50; content_length = (off_t)(xml_start_len + xml_header_start_len + xml_header_str_len + xml_header_end_len + xml_body_start_len + action_str_len + xml_end_len); if (http_MakeMessage( &request, 1, 1, "q" "N" "s" "sssbsc" "Uc" "b" "b" "b" "b" "b" "b" "b", SOAPMETHOD_POST, &url, content_length, ContentTypeHeader, "SOAPACTION: \"", service_type, "#", name.buf, name.length, "\"", xml_start, xml_start_len, xml_header_start, xml_header_start_len, xml_header_str, xml_header_str_len, xml_header_end, xml_header_end_len, xml_body_start, xml_body_start_len, action_str, action_str_len, xml_end, xml_end_len ) != 0 ) { goto error_handler; } ret_code = soap_request_and_response( &request, &url, &response ); got_response = TRUE; if( ret_code != UPNP_E_SUCCESS ) { err_code = ret_code; goto error_handler; } if( membuffer_append( &responsename, name.buf, name.length ) != 0 || membuffer_append_str( &responsename, "Response" ) != 0 ) { goto error_handler; } /* get action node from the response */ ret_code = get_response_value( &response.msg, SOAP_ACTION_RESP, responsename.buf, &upnp_error_code, ( IXML_Node ** ) response_node, &upnp_error_str ); if( ret_code == SOAP_ACTION_RESP ) { err_code = UPNP_E_SUCCESS; } else if( ret_code == SOAP_ACTION_RESP_ERROR ) { err_code = upnp_error_code; } else { err_code = ret_code; } error_handler: ixmlFreeDOMString( action_str ); ixmlFreeDOMString( xml_header_str ); membuffer_destroy( &request ); membuffer_destroy( &responsename ); if( got_response ) { httpmsg_destroy( &response.msg ); } return err_code; } /**************************************************************************** * Function : SoapGetServiceVarStatus * * Parameters : * IN char * action_url : Address to send this variable * query message. * IN char *var_name : Name of the variable. * OUT char **var_value : Output value. * * Description : This function creates a status variable query message * send it to the specified URL. It also collect the response. * * Return : int * * Note : ****************************************************************************/ int SoapGetServiceVarStatus( IN char *action_url, IN char *var_name, OUT char **var_value ) { const memptr host; /* value for HOST header */ const memptr path; /* ctrl path in first line in msg */ uri_type url; membuffer request; int ret_code; http_parser_t response; int upnp_error_code; off_t content_length; const char *xml_start = "\r\n" "\r\n" "\r\n" ""; const char *xml_end = "\r\n" "\r\n" "\r\n" "\r\n"; *var_value = NULL; /* return NULL in case of an error */ membuffer_init( &request ); /* get host hdr and url path */ if( get_host_and_path( action_url, &host, &path, &url ) == -1 ) { return UPNP_E_INVALID_URL; } /* make headers */ request.size_inc = 50; content_length = (off_t)(strlen(xml_start) + strlen(var_name) + strlen(xml_end)); if (http_MakeMessage( &request, 1, 1, "Q" "sbc" "N" "s" "sc" "Ucc" "sss", SOAPMETHOD_POST, path.buf, path.length, "HOST: ", host.buf, host.length, content_length, ContentTypeHeader, "SOAPACTION: \"urn:schemas-upnp-org:control-1-0#QueryStateVariable\"", xml_start, var_name, xml_end ) != 0 ) { return UPNP_E_OUTOF_MEMORY; } /* send msg and get reply */ ret_code = soap_request_and_response( &request, &url, &response ); membuffer_destroy( &request ); if( ret_code != UPNP_E_SUCCESS ) { return ret_code; } /* get variable value from the response */ ret_code = get_response_value( &response.msg, SOAP_VAR_RESP, NULL, &upnp_error_code, NULL, var_value ); httpmsg_destroy( &response.msg ); if( ret_code == SOAP_VAR_RESP ) { return UPNP_E_SUCCESS; } else if( ret_code == SOAP_VAR_RESP_ERROR ) { return upnp_error_code; } else { return ret_code; } } #endif /* EXCLUDE_SOAP */ #endif /* INCLUDE_CLIENT_APIS */ pupnp-release-1.8.0/upnp/src/soap/soap_device.c000066400000000000000000000544571303304015100214450ustar00rootroot00000000000000/******************************************************************************* * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ******************************************************************************/ /*! * \file */ #include "config.h" #ifdef INCLUDE_DEVICE_APIS #if EXCLUDE_SOAP == 0 #include "ActionRequest.h" #include "httpparser.h" #include "httpreadwrite.h" #include "parsetools.h" #include "soaplib.h" #include "ssdplib.h" #include "statcodes.h" #include "unixutil.h" #include "upnpapi.h" #include #include #ifdef WIN32 #define snprintf _snprintf #endif /*! timeout duration in secs for transmission/reception */ #define SOAP_TIMEOUT UPNP_TIMEOUT #define SREQ_HDR_NOT_FOUND -1 #define SREQ_BAD_HDR_FORMAT -2 #define SREQ_NOT_EXTENDED -3 #define SOAP_INVALID_ACTION 401 #define SOAP_INVALID_ARGS 402 #define SOAP_OUT_OF_SYNC 403 #define SOAP_INVALID_VAR 404 #define SOAP_ACTION_FAILED 501 #define SOAP_MEMORY_OUT 603 static const char *SOAP_BODY = "Body"; static const char *SOAP_URN = "http:/""/schemas.xmlsoap.org/soap/envelope/"; static const char *QUERY_STATE_VAR_URN = "urn:schemas-upnp-org:control-1-0"; static const char *Soap_Invalid_Action = "Invalid Action"; /*static const char* Soap_Invalid_Args = "Invalid Args"; */ static const char *Soap_Action_Failed = "Action Failed"; static const char *Soap_Invalid_Var = "Invalid Var"; static const char *Soap_Memory_out = "Out of Memory"; typedef struct soap_devserv_t { char dev_udn[NAME_SIZE]; char service_type[NAME_SIZE]; char service_id[NAME_SIZE]; memptr action_name; Upnp_FunPtr callback; void *cookie; }soap_devserv_t; /*! * \brief Sends SOAP error response. */ static void send_error_response( /*! [in] Socket info. */ IN SOCKINFO *info, /*! [in] Error code. */ IN int error_code, /*! [in] Error message. */ IN const char *err_msg, /*! [in] HTTP request. */ IN http_message_t *hmsg) { off_t content_length; int timeout_secs = SOAP_TIMEOUT; int major; int minor; const char *start_body = /* "\n" required?? */ "\n" "\n" "\n" "s:Client\n" "UPnPError\n" "\n" "\n" ""; const char *mid_body = "\n" ""; const char *end_body = "\n" "\n" "\n" "\n" "\n" "\n"; char err_code_str[30]; membuffer headers; memset(err_code_str, 0, sizeof(err_code_str)); snprintf(err_code_str, sizeof(err_code_str), "%d", error_code); /* calc body len */ content_length = (off_t) (strlen(start_body) + strlen(err_code_str) + strlen(mid_body) + strlen(err_msg) + strlen(end_body)); http_CalcResponseVersion(hmsg->major_version, hmsg->minor_version, &major, &minor); /* make headers */ membuffer_init(&headers); if (http_MakeMessage(&headers, major, minor, "RNsDsSXcc" "sssss", 500, content_length, ContentTypeHeader, "EXT:\r\n", X_USER_AGENT, start_body, err_code_str, mid_body, err_msg, end_body) != 0) { membuffer_destroy(&headers); /* out of mem */ return; } /* send err msg */ http_SendMessage(info, &timeout_secs, "b", headers.buf, headers.length); membuffer_destroy(&headers); } /*! * \brief Sends response of get var status. */ static UPNP_INLINE void send_var_query_response( /*! [in] Socket info. */ SOCKINFO *info, /*! [in] Value of the state variable. */ const char *var_value, /*! [in] HTTP request. */ http_message_t *hmsg) { off_t content_length; int timeout_secs = SOAP_TIMEOUT; int major; int minor; const char *start_body = "\n" "\n" "\n" ""; const char *end_body = "\n" "\n" "\n" "\n"; membuffer response; http_CalcResponseVersion(hmsg->major_version, hmsg->minor_version, &major, &minor); content_length = (off_t) (strlen(start_body) + strlen(var_value) + strlen(end_body)); /* make headers */ membuffer_init(&response); if (http_MakeMessage(&response, major, minor, "RNsDsSXcc" "sss", HTTP_OK, content_length, ContentTypeHeader, "EXT:\r\n", X_USER_AGENT, start_body, var_value, end_body) != 0) { membuffer_destroy(&response); /* out of mem */ return; } /* send msg */ http_SendMessage(info, &timeout_secs, "b", response.buf, response.length); membuffer_destroy(&response); } /*! * \brief Sends the SOAP action response. */ static UPNP_INLINE void send_action_response( /*! [in] Socket info. */ SOCKINFO *info, /*! [in] The response document. */ IXML_Document *action_resp, /*! [in] Action request document. */ http_message_t *request) { char *xml_response = NULL; membuffer headers; int major, minor; int err_code; off_t content_length; int ret_code; int timeout_secs = SOAP_TIMEOUT; static const char *start_body = /*"" required?? */ "\n"; static const char *end_body = " "; /* init */ http_CalcResponseVersion(request->major_version, request->minor_version, &major, &minor); membuffer_init(&headers); err_code = UPNP_E_OUTOF_MEMORY; /* one error only */ /* get xml */ xml_response = ixmlPrintNode((IXML_Node *) action_resp); if (!xml_response) goto error_handler; content_length = (off_t)(strlen(start_body) + strlen(xml_response) + strlen(end_body)); /* make headers */ if (http_MakeMessage(&headers, major, minor, "RNsDsSXcc", HTTP_OK, /* status code */ content_length, ContentTypeHeader, "EXT:\r\n", X_USER_AGENT) != 0) { goto error_handler; } /* send whole msg */ ret_code = http_SendMessage( info, &timeout_secs, "bbbb", headers.buf, headers.length, start_body, strlen(start_body), xml_response, strlen(xml_response), end_body, strlen(end_body)); if (ret_code != 0) { UpnpPrintf(UPNP_INFO, SOAP, __FILE__, __LINE__, "Failed to send response: err code = %d\n", ret_code); } err_code = 0; error_handler: ixmlFreeDOMString(xml_response); membuffer_destroy(&headers); if (err_code != 0) { /* only one type of error to worry about - out of mem */ send_error_response(info, SOAP_ACTION_FAILED, "Out of memory", request); } } /*! * \brief Handles the SOAP requests to querry the state variables. * This functionality has been deprecated in the UPnP V1.0 architecture. */ static UPNP_INLINE void handle_query_variable( /*! [in] Socket info. */ SOCKINFO *info, /*! [in] HTTP Request. */ http_message_t *request, /*! [in] SOAP device/service information. */ soap_devserv_t *soap_info, /*! [in] Node containing variable name. */ IXML_Node *req_node) { UpnpStateVarRequest *variable = UpnpStateVarRequest_new(); const char *err_str; int err_code; const DOMString var_name; /* set default error */ err_code = SOAP_INVALID_VAR; err_str = Soap_Invalid_Var; if (variable == NULL) { err_code = SOAP_MEMORY_OUT; err_str = Soap_Memory_out; goto error_handler; } UpnpStateVarRequest_set_ErrCode(variable, UPNP_E_SUCCESS); UpnpStateVarRequest_strcpy_DevUDN(variable, soap_info->dev_udn); UpnpStateVarRequest_strcpy_ServiceID(variable, soap_info->service_id); var_name = ixmlNode_getNodeValue(req_node); UpnpStateVarRequest_strcpy_StateVarName(variable, var_name); UpnpStateVarRequest_set_CtrlPtIPAddr(variable, &info->foreign_sockaddr); /* send event */ soap_info->callback(UPNP_CONTROL_GET_VAR_REQUEST, variable, soap_info->cookie); UpnpPrintf(UPNP_INFO, SOAP, __FILE__, __LINE__, "Return from callback for var request\n"); /* validate, and handle result */ if (UpnpStateVarRequest_get_CurrentVal(variable) == NULL) goto error_handler; if (UpnpStateVarRequest_get_ErrCode(variable) != UPNP_E_SUCCESS) { if (UpnpString_get_Length(UpnpStateVarRequest_get_ErrStr(variable)) > 0) { err_code = UpnpStateVarRequest_get_ErrCode(variable); err_str = UpnpStateVarRequest_get_ErrStr_cstr(variable); } goto error_handler; } /* send response */ send_var_query_response(info, UpnpStateVarRequest_get_CurrentVal(variable), request); err_code = 0; /* error handling and cleanup */ error_handler: UpnpStateVarRequest_delete(variable); if (err_code != 0) send_error_response(info, err_code, err_str, request); } /*! * \brief Handles the SOAP action request. */ static void handle_invoke_action( /*! [in] Socket info. */ SOCKINFO *info, /*! [in] HTTP Request. */ http_message_t *request, /*! [in] SOAP device/service information. */ soap_devserv_t *soap_info, /*! [in] Node containing the SOAP action request. */ IXML_Node *req_node) { char save_char; UpnpActionRequest *action = UpnpActionRequest_new(); IXML_Document *actionRequestDoc = NULL; IXML_Document *actionResultDoc = NULL; int err_code; const char *err_str; memptr action_name; DOMString act_node = NULL; /* null-terminate */ action_name = soap_info->action_name; save_char = action_name.buf[action_name.length]; action_name.buf[action_name.length] = '\0'; /* get action node */ act_node = ixmlPrintNode(req_node); if (!act_node) { err_code = SOAP_MEMORY_OUT; err_str = Soap_Memory_out; goto error_handler; } err_code = ixmlParseBufferEx(act_node, &actionRequestDoc); if (err_code != IXML_SUCCESS) { if (IXML_INSUFFICIENT_MEMORY == err_code) { err_code = SOAP_MEMORY_OUT; err_str = Soap_Memory_out; } else { err_code = SOAP_INVALID_ACTION; err_str = Soap_Invalid_Action; } goto error_handler; } UpnpActionRequest_set_ErrCode(action, UPNP_E_SUCCESS); UpnpActionRequest_strcpy_ActionName(action, action_name.buf); UpnpActionRequest_strcpy_DevUDN(action, soap_info->dev_udn); UpnpActionRequest_strcpy_ServiceID(action, soap_info->service_id); UpnpActionRequest_set_ActionRequest(action, actionRequestDoc); UpnpActionRequest_set_ActionResult(action, NULL); UpnpActionRequest_set_CtrlPtIPAddr(action, &info->foreign_sockaddr); UpnpPrintf(UPNP_INFO, SOAP, __FILE__, __LINE__, "Calling Callback\n"); soap_info->callback(UPNP_CONTROL_ACTION_REQUEST, action, soap_info->cookie); err_code = UpnpActionRequest_get_ErrCode(action); if (err_code != UPNP_E_SUCCESS) { err_str = UpnpActionRequest_get_ErrStr_cstr(action); if (strlen(err_str) <= 0) { err_code = SOAP_ACTION_FAILED; err_str = Soap_Action_Failed; } goto error_handler; } /* validate, and handle action error */ actionResultDoc = UpnpActionRequest_get_ActionResult(action); if (actionResultDoc == NULL) { err_code = SOAP_ACTION_FAILED; err_str = Soap_Action_Failed; goto error_handler; } /* send response */ send_action_response(info, actionResultDoc, request); err_code = 0; /* error handling and cleanup */ error_handler: ixmlDocument_free(actionResultDoc); ixmlDocument_free(actionRequestDoc); ixmlFreeDOMString(act_node); /* restore */ action_name.buf[action_name.length] = save_char; if (err_code != 0) send_error_response(info, err_code, err_str, request); UpnpActionRequest_delete(action); } /*! * \brief Retrieve SOAP device/service information associated * with request-URI, which includes the callback function to hand-over * the request to the device application. * * \return 0 if OK, -1 on error. */ static int get_dev_service( /*! [in] HTTP request. */ http_message_t *request, /*! [in] Address family: AF_INET or AF_INET6. */ int AddressFamily, /*! [out] SOAP device/service information. */ soap_devserv_t *soap_info) { struct Handle_Info *device_info; int device_hnd; service_info *serv_info; char save_char; /* error by default */ int ret_code = -1; const char *control_url; /* null-terminate pathquery of url */ control_url = request->uri.pathquery.buff; save_char = control_url[request->uri.pathquery.size]; ((char *)control_url)[request->uri.pathquery.size] = '\0'; HandleReadLock(); if (GetDeviceHandleInfo(AddressFamily, &device_hnd, &device_info) != HND_DEVICE) goto error_handler; serv_info = FindServiceControlURLPath( &device_info->ServiceTable, control_url); if (!serv_info) goto error_handler; namecopy(soap_info->dev_udn, serv_info->UDN); namecopy(soap_info->service_type, serv_info->serviceType); namecopy(soap_info->service_id, serv_info->serviceId); soap_info->callback = device_info->Callback; soap_info->cookie = device_info->Cookie; ret_code = 0; error_handler: /* restore */ ((char *)control_url)[request->uri.pathquery.size] = save_char; HandleUnlock(); return ret_code; } /*! * \brief Get the SOAPACTION header value for M-POST request. * * \return UPNP_E_SUCCESS if OK, error number on failure. */ static int get_mpost_acton_hdrval( /*! [in] HTTP request. */ http_message_t *request, /*! [out] Buffer to get the header value */ memptr *val) { http_header_t *hdr; memptr ns_value, dummy_quote, value; membuffer soap_action_name; assert(HTTPMETHOD_MPOST == request->method); hdr = httpmsg_find_hdr(request, HDR_MAN, &value); if (NULL == hdr) return SREQ_NOT_EXTENDED; if (matchstr(value.buf, value.length, "%q%i ; ns = %s", &dummy_quote, &ns_value) != PARSE_OK) return SREQ_NOT_EXTENDED; /* create soapaction name header */ membuffer_init(&soap_action_name); if (membuffer_assign(&soap_action_name, ns_value.buf, ns_value.length) == UPNP_E_OUTOF_MEMORY || membuffer_append_str(&soap_action_name, "-SOAPACTION") == UPNP_E_OUTOF_MEMORY) { membuffer_destroy(&soap_action_name); return UPNP_E_OUTOF_MEMORY; } hdr = httpmsg_find_hdr_str(request, soap_action_name.buf); membuffer_destroy(&soap_action_name); if (NULL == hdr) return SREQ_HDR_NOT_FOUND; val->buf = hdr->value.buf; val->length = hdr->value.length; return UPNP_E_SUCCESS; } /*! * \brief Check the header validity, and get the action name * and the version of the service that the CP wants to use. * * \return UPNP_E_SUCCESS if OK, error number on failure. */ static int check_soapaction_hdr( /*! [in] HTTP request. */ http_message_t *request, /*! [in, out] SOAP device/service information. */ soap_devserv_t *soap_info) { memptr value; char save_char; char *hash_pos = NULL; char *col_pos1, *col_pos2, *serv_type; size_t cp1_diff; int ret_code; /* find SOAPACTION header */ if (SOAPMETHOD_POST == request->method) { if (!httpmsg_find_hdr(request, HDR_SOAPACTION, &value)) return SREQ_HDR_NOT_FOUND; } else { ret_code = get_mpost_acton_hdrval(request, &value); if (ret_code != UPNP_E_SUCCESS) { return ret_code; } } /* error by default */ ret_code = SREQ_BAD_HDR_FORMAT; /* get action name*/ save_char = value.buf[value.length]; value.buf[value.length] = '\0'; hash_pos = strchr(value.buf, '#'); if (NULL == hash_pos) { goto error_handler; } *hash_pos = '\0'; if (matchstr(hash_pos+1, value.length - (size_t)(hash_pos+1 - value.buf), "%s", &soap_info->action_name) != PARSE_OK) { goto error_handler; } /* check service type */ if (value.buf[0] != '\"') { goto error_handler; } serv_type = &value.buf[1]; col_pos1 = strrchr(serv_type, ':'); if (NULL == col_pos1) { goto error_handler; } col_pos2 = strrchr(soap_info->service_type, ':'); /* XXX: this should be checked when service list is generated */ assert(col_pos2 != NULL); cp1_diff = (size_t)(col_pos1 - serv_type); if (col_pos2 - soap_info->service_type == col_pos1 - serv_type && strncmp(soap_info->service_type, serv_type, cp1_diff) == 0) { /* for action invocation, update the version information */ namecopy(soap_info->service_type, serv_type); } else if (strcmp(serv_type, QUERY_STATE_VAR_URN) == 0 && memptr_cmp(&soap_info->action_name, "QueryStateVariable") == 0) { /* query variable */ soap_info->action_name.buf = NULL; soap_info->action_name.length = 0; } else { goto error_handler; } ret_code = UPNP_E_SUCCESS; error_handler: if (hash_pos != NULL) { *hash_pos = '#'; } value.buf[value.length] = save_char; return ret_code; } /*! * \brief Check validity of the SOAP request per UPnP specification. * * \return 0 if OK, -1 on failure. */ static int check_soap_request( /*! [in] SOAP device/service information. */ soap_devserv_t *soap_info, /*! [in] Document containing the SOAP action request. */ IN IXML_Document *xml_doc, /*! [out] Node containing the SOAP action request/variable name. */ IXML_Node **req_node) { IXML_Node *envp_node = NULL; IXML_Node *body_node = NULL; IXML_Node *action_node = NULL; const DOMString local_name = NULL; const DOMString ns_uri = NULL; int ret_val = -1; /* Got the Envelop node here */ envp_node = ixmlNode_getFirstChild((IXML_Node *) xml_doc); if (NULL == envp_node) { goto error_handler; } ns_uri = ixmlNode_getNamespaceURI(envp_node); if (NULL == ns_uri || strcmp(ns_uri, SOAP_URN) != 0) { goto error_handler; } /* Got Body here */ body_node = ixmlNode_getFirstChild(envp_node); if (NULL == body_node) { goto error_handler; } local_name = ixmlNode_getLocalName(body_node); if (NULL == local_name || strcmp(local_name, SOAP_BODY) != 0) { goto error_handler; } /* Got action node here */ action_node = ixmlNode_getFirstChild(body_node); if (NULL == action_node) { goto error_handler; } /* check local name and namespace of action node */ ns_uri = ixmlNode_getNamespaceURI(action_node); if (NULL == ns_uri) { goto error_handler; } local_name = ixmlNode_getLocalName(action_node); if (NULL == local_name) { goto error_handler; } if (NULL == soap_info->action_name.buf) { IXML_Node *varname_node = NULL; IXML_Node *nametxt_node = NULL; if (strcmp(ns_uri, QUERY_STATE_VAR_URN) != 0 || strcmp(local_name, "QueryStateVariable") != 0) { goto error_handler; } varname_node = ixmlNode_getFirstChild(action_node); if(NULL == varname_node) { goto error_handler; } local_name = ixmlNode_getLocalName(varname_node); if (strcmp(local_name, "varName") != 0) { goto error_handler; } nametxt_node = ixmlNode_getFirstChild(varname_node); if (NULL == nametxt_node || ixmlNode_getNodeType(nametxt_node) != eTEXT_NODE) { goto error_handler; } *req_node = nametxt_node; } else { /* check service type against SOAPACTION header */ if (strcmp(soap_info->service_type, ns_uri) != 0 || memptr_cmp(&soap_info->action_name, local_name) != 0) { goto error_handler; } *req_node = action_node; } /* success */ ret_val = 0; error_handler: return ret_val; } /*! * \brief This is a callback called by minisever after receiving the request * from the control point. After HTTP processing, it calls handle_soap_request * to start SOAP processing. */ void soap_device_callback( /*! [in] Parsed request received by the device. */ http_parser_t *parser, /*! [in] HTTP request. */ http_message_t *request, /*! [in,out] Socket info. */ SOCKINFO *info) { int err_code; IXML_Document *xml_doc = NULL; soap_devserv_t *soap_info = NULL; IXML_Node *req_node = NULL; /* get device/service identified by the request-URI */ soap_info = malloc(sizeof(soap_devserv_t)); if (NULL == soap_info) { err_code = HTTP_INTERNAL_SERVER_ERROR; goto error_handler; } if (get_dev_service(request, info->foreign_sockaddr.ss_family, soap_info) < 0) { err_code = HTTP_NOT_FOUND; goto error_handler; } /* validate: content-type == text/xml */ if (!has_xml_content_type(request)) { err_code = HTTP_UNSUPPORTED_MEDIA_TYPE; goto error_handler; } /* check SOAPACTION HTTP header */ err_code = check_soapaction_hdr(request, soap_info); if (err_code != UPNP_E_SUCCESS) { switch (err_code) { case SREQ_NOT_EXTENDED: err_code = HTTP_NOT_EXTENDED; break; case UPNP_E_OUTOF_MEMORY: err_code = HTTP_INTERNAL_SERVER_ERROR; break; default: err_code = HTTP_BAD_REQUEST; break; } goto error_handler; } /* parse XML */ err_code = ixmlParseBufferEx(request->entity.buf, &xml_doc); if (err_code != IXML_SUCCESS) { if (IXML_INSUFFICIENT_MEMORY == err_code) err_code = HTTP_INTERNAL_SERVER_ERROR; else err_code = HTTP_BAD_REQUEST; goto error_handler; } /* check SOAP body */ if (check_soap_request(soap_info, xml_doc, &req_node) < 0) { err_code = HTTP_BAD_REQUEST; goto error_handler; } /* process SOAP request */ if (NULL == soap_info->action_name.buf) /* query var */ handle_query_variable(info, request, soap_info, req_node); else /* invoke action */ handle_invoke_action(info, request, soap_info, req_node); err_code = HTTP_OK; error_handler: ixmlDocument_free(xml_doc); free(soap_info); if (err_code != HTTP_OK) { http_SendStatusResponse(info, err_code, request->major_version, request->minor_version); } return; parser = parser; } #endif /* EXCLUDE_SOAP */ #endif /* INCLUDE_DEVICE_APIS */ pupnp-release-1.8.0/upnp/src/ssdp/000077500000000000000000000000001303304015100170105ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/ssdp/ssdp_ResultData.c000066400000000000000000000006411303304015100222560ustar00rootroot00000000000000 /*! * \file * * \brief SSDPResultData object implementation. * * \author Marcelo Roberto Jimenez */ #include "config.h" #define TEMPLATE_GENERATE_SOURCE #include "ssdp_ResultData.h" void SSDPResultData_Callback(const SSDPResultData *p) { Upnp_FunPtr callback = SSDPResultData_get_CtrlptCallback(p); callback(UPNP_DISCOVERY_SEARCH_RESULT, SSDPResultData_get_Param(p), SSDPResultData_get_Cookie(p)); } pupnp-release-1.8.0/upnp/src/ssdp/ssdp_ResultData.h000066400000000000000000000020441303304015100222620ustar00rootroot00000000000000 #ifndef SSDP_RESULTDATA_H #define SSDP_RESULTDATA_H /*! * \addtogroup SSDPlib * * @{ * * \file * * \brief SSDPResultData object declararion. * * \author Marcelo Roberto Jimenez */ /******************************************************************************/ #ifdef TEMPLATE_GENERATE_SOURCE #undef TEMPLATE_GENERATE_SOURCE #include "Discovery.h" /* for UpnpDiscovery */ #define TEMPLATE_GENERATE_SOURCE #else /* TEMPLATE_GENERATE_SOURCE */ #include "Discovery.h" /* for UpnpDiscovery */ #endif /* TEMPLATE_GENERATE_SOURCE */ /******************************************************************************/ #include "Callback.h" /* for Upnp_FunPtr */ #define CLASS SSDPResultData #define EXPAND_CLASS_MEMBERS(CLASS) \ EXPAND_CLASS_MEMBER_OBJECT(CLASS, Param, UpnpDiscovery) \ EXPAND_CLASS_MEMBER_INT(CLASS, Cookie, void *) \ EXPAND_CLASS_MEMBER_INT(CLASS, CtrlptCallback, Upnp_FunPtr) \ #include "TemplateInclude.h" /*! */ void SSDPResultData_Callback(const SSDPResultData *p); /* @} SSDPlib */ #endif /* SSDP_RESULTDATA_H */ pupnp-release-1.8.0/upnp/src/ssdp/ssdp_ctrlpt.c000066400000000000000000000465031303304015100215250ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ /*! * \addtogroup SSDPlib * * @{ * * \file */ #include "config.h" #include "upnputil.h" #ifdef INCLUDE_CLIENT_APIS #if EXCLUDE_SSDP == 0 #include "httpparser.h" #include "httpreadwrite.h" #include "ssdp_ResultData.h" #include "ssdplib.h" #include "statcodes.h" #include "unixutil.h" #include "upnpapi.h" #include "UpnpInet.h" #include "ThreadPool.h" #include #ifdef WIN32 #include #define snprintf _snprintf #endif /* WIN32 */ /*! * \brief Sends a callback to the control point application with a SEARCH * result. */ static void send_search_result( /* [in] Search reply from the device. */ IN void *data) { SSDPResultData *temp = (SSDPResultData *)data; SSDPResultData_Callback(temp); SSDPResultData_delete(temp); } void ssdp_handle_ctrlpt_msg(http_message_t *hmsg, struct sockaddr_storage *dest_addr, int timeout, void *cookie) { int handle; struct Handle_Info *ctrlpt_info = NULL; memptr hdr_value; /* byebye or alive */ int is_byebye; UpnpDiscovery *param = UpnpDiscovery_new(); int expires; int ret; SsdpEvent event; int nt_found; int usn_found; int st_found; char save_char; Upnp_EventType event_type; Upnp_FunPtr ctrlpt_callback; void *ctrlpt_cookie; ListNode *node = NULL; SsdpSearchArg *searchArg = NULL; int matched = 0; SSDPResultData *threadData = NULL; ThreadPoolJob job; memset(&job, 0, sizeof(job)); /* we are assuming that there can be only one client supported at a time */ HandleReadLock(); if (GetClientHandleInfo(&handle, &ctrlpt_info) != HND_CLIENT) { HandleUnlock(); goto end_ssdp_handle_ctrlpt_msg; } /* copy */ ctrlpt_callback = ctrlpt_info->Callback; ctrlpt_cookie = ctrlpt_info->Cookie; HandleUnlock(); /* search timeout */ if (timeout) { ctrlpt_callback(UPNP_DISCOVERY_SEARCH_TIMEOUT, NULL, cookie); goto end_ssdp_handle_ctrlpt_msg; } UpnpDiscovery_set_ErrCode(param, UPNP_E_SUCCESS); /* MAX-AGE, assume error */ expires = -1; UpnpDiscovery_set_Expires(param, expires); if (httpmsg_find_hdr(hmsg, HDR_CACHE_CONTROL, &hdr_value) != NULL) { ret = matchstr(hdr_value.buf, hdr_value.length, "%imax-age = %d%0", &expires); UpnpDiscovery_set_Expires(param, expires); if (ret != PARSE_OK) goto end_ssdp_handle_ctrlpt_msg; } /* DATE */ if (httpmsg_find_hdr(hmsg, HDR_DATE, &hdr_value) != NULL) { UpnpDiscovery_strcpy_Date(param, hdr_value.buf); } /* dest addr */ UpnpDiscovery_set_DestAddr(param, dest_addr); /* EXT */ if (httpmsg_find_hdr(hmsg, HDR_EXT, &hdr_value) != NULL) { UpnpDiscovery_strncpy_Ext(param, hdr_value.buf, hdr_value.length); } /* LOCATION */ if (httpmsg_find_hdr(hmsg, HDR_LOCATION, &hdr_value) != NULL) { UpnpDiscovery_strncpy_Location(param, hdr_value.buf, hdr_value.length); } /* SERVER / USER-AGENT */ if (httpmsg_find_hdr(hmsg, HDR_SERVER, &hdr_value) != NULL || httpmsg_find_hdr(hmsg, HDR_USER_AGENT, &hdr_value) != NULL) { UpnpDiscovery_strncpy_Os(param, hdr_value.buf, hdr_value.length); } /* clear everything */ event.UDN[0] = '\0'; event.DeviceType[0] = '\0'; event.ServiceType[0] = '\0'; nt_found = FALSE; if (httpmsg_find_hdr(hmsg, HDR_NT, &hdr_value) != NULL) { save_char = hdr_value.buf[hdr_value.length]; hdr_value.buf[hdr_value.length] = '\0'; nt_found = (ssdp_request_type(hdr_value.buf, &event) == 0); hdr_value.buf[hdr_value.length] = save_char; } usn_found = FALSE; if (httpmsg_find_hdr(hmsg, HDR_USN, &hdr_value) != NULL) { save_char = hdr_value.buf[hdr_value.length]; hdr_value.buf[hdr_value.length] = '\0'; usn_found = (unique_service_name(hdr_value.buf, &event) == 0); hdr_value.buf[hdr_value.length] = save_char; } if (nt_found || usn_found) { UpnpDiscovery_strcpy_DeviceID(param, event.UDN); UpnpDiscovery_strcpy_DeviceType(param, event.DeviceType); UpnpDiscovery_strcpy_ServiceType(param, event.ServiceType); } /* ADVERT. OR BYEBYE */ if (hmsg->is_request) { /* use NTS hdr to determine advert., or byebye */ if (httpmsg_find_hdr(hmsg, HDR_NTS, &hdr_value) == NULL) { /* error; NTS header not found */ goto end_ssdp_handle_ctrlpt_msg; } if (memptr_cmp(&hdr_value, "ssdp:alive") == 0) { is_byebye = FALSE; } else if (memptr_cmp(&hdr_value, "ssdp:byebye") == 0) { is_byebye = TRUE; } else { /* bad value */ goto end_ssdp_handle_ctrlpt_msg; } if (is_byebye) { /* check device byebye */ if (!nt_found || !usn_found) { /* bad byebye */ goto end_ssdp_handle_ctrlpt_msg; } event_type = UPNP_DISCOVERY_ADVERTISEMENT_BYEBYE; } else { /* check advertisement. * Expires is valid if positive. This is for testing * only. Expires should be greater than 1800 (30 mins) */ if (!nt_found || !usn_found || UpnpString_get_Length(UpnpDiscovery_get_Location(param)) == 0 || UpnpDiscovery_get_Expires(param) <= 0) { /* bad advertisement */ goto end_ssdp_handle_ctrlpt_msg; } event_type = UPNP_DISCOVERY_ADVERTISEMENT_ALIVE; } /* call callback */ ctrlpt_callback(event_type, param, ctrlpt_cookie); } else { /* reply (to a SEARCH) */ /* only checking to see if there is a valid ST header */ st_found = FALSE; if (httpmsg_find_hdr(hmsg, HDR_ST, &hdr_value) != NULL) { save_char = hdr_value.buf[hdr_value.length]; hdr_value.buf[hdr_value.length] = '\0'; st_found = ssdp_request_type(hdr_value.buf, &event) == 0; hdr_value.buf[hdr_value.length] = save_char; } if (hmsg->status_code != HTTP_OK || UpnpDiscovery_get_Expires(param) <= 0 || UpnpString_get_Length(UpnpDiscovery_get_Location(param)) == 0 || !usn_found || !st_found) { /* bad reply */ goto end_ssdp_handle_ctrlpt_msg; } /* check each current search */ HandleLock(); if (GetClientHandleInfo(&handle, &ctrlpt_info) != HND_CLIENT) { HandleUnlock(); goto end_ssdp_handle_ctrlpt_msg; } node = ListHead(&ctrlpt_info->SsdpSearchList); /* temporary add null termination */ /*save_char = hdr_value.buf[ hdr_value.length ]; */ /*hdr_value.buf[ hdr_value.length ] = '\0'; */ while (node != NULL) { searchArg = node->item; /* check for match of ST header and search target */ switch (searchArg->requestType) { case SSDP_ALL: matched = 1; break; case SSDP_ROOTDEVICE: matched = (event.RequestType == SSDP_ROOTDEVICE); break; case SSDP_DEVICEUDN: matched = !strncmp(searchArg->searchTarget, hdr_value.buf, hdr_value.length); break; case SSDP_DEVICETYPE:{ size_t m = min(hdr_value.length, strlen (searchArg->searchTarget)); matched = !strncmp(searchArg->searchTarget, hdr_value.buf, m); break; } case SSDP_SERVICE:{ size_t m = min(hdr_value.length, strlen (searchArg->searchTarget)); matched = !strncmp(searchArg->searchTarget, hdr_value.buf, m); break; } default: matched = 0; break; } if (matched) { /* schedule call back */ threadData = SSDPResultData_new(); if (threadData != NULL) { SSDPResultData_set_Param(threadData, param); SSDPResultData_set_Cookie(threadData, searchArg-> cookie); SSDPResultData_set_CtrlptCallback (threadData, ctrlpt_callback); TPJobInit(&job, (start_routine) send_search_result, threadData); TPJobSetPriority(&job, MED_PRIORITY); TPJobSetFreeFunction(&job, (free_routine) free); if (ThreadPoolAdd(&gRecvThreadPool, &job, NULL) != 0) { SSDPResultData_delete(threadData); } } } node = ListNext(&ctrlpt_info->SsdpSearchList, node); } HandleUnlock(); /*ctrlpt_callback( UPNP_DISCOVERY_SEARCH_RESULT, param, cookie ); */ } end_ssdp_handle_ctrlpt_msg: UpnpDiscovery_delete(param); } /*! * \brief Creates a HTTP search request packet depending on the input * parameter. */ static int CreateClientRequestPacket( /*! [in,out] Output string in HTTP format. */ INOUT char *RqstBuf, /*! [in] RqstBuf size. */ IN size_t RqstBufSize, /*! [in] Search Target. */ IN int Mx, /*! [in] Number of seconds to wait to collect all the responses. */ IN char *SearchTarget, /*! [in] search address family. */ IN int AddressFamily) { int rc; char TempBuf[COMMAND_LEN]; const char *command = "M-SEARCH * HTTP/1.1\r\n"; const char *man = "MAN: \"ssdp:discover\"\r\n"; memset(TempBuf, 0, sizeof(TempBuf)); if (RqstBufSize <= strlen(command)) return UPNP_E_INTERNAL_ERROR; strcpy(RqstBuf, command); switch (AddressFamily) { case AF_INET: rc = snprintf(TempBuf, sizeof(TempBuf), "HOST: %s:%d\r\n", SSDP_IP, SSDP_PORT); break; case AF_INET6: rc = snprintf(TempBuf, sizeof(TempBuf), "HOST: [%s]:%d\r\n", SSDP_IPV6_LINKLOCAL, SSDP_PORT); break; default: return UPNP_E_INVALID_ARGUMENT; } if (rc < 0 || (unsigned int) rc >= sizeof(TempBuf)) return UPNP_E_INTERNAL_ERROR; if (RqstBufSize <= strlen(RqstBuf) + strlen(TempBuf)) return UPNP_E_BUFFER_TOO_SMALL; strcat(RqstBuf, TempBuf); if (RqstBufSize <= strlen(RqstBuf) + strlen(man)) return UPNP_E_BUFFER_TOO_SMALL; strcat(RqstBuf, man); if (Mx > 0) { rc = snprintf(TempBuf, sizeof(TempBuf), "MX: %d\r\n", Mx); if (rc < 0 || (unsigned int) rc >= sizeof(TempBuf)) return UPNP_E_INTERNAL_ERROR; if (RqstBufSize <= strlen(RqstBuf) + strlen(TempBuf)) return UPNP_E_BUFFER_TOO_SMALL; strcat(RqstBuf, TempBuf); } if (SearchTarget != NULL) { rc = snprintf(TempBuf, sizeof(TempBuf), "ST: %s\r\n", SearchTarget); if (rc < 0 || (unsigned int) rc >= sizeof(TempBuf)) return UPNP_E_INTERNAL_ERROR; if (RqstBufSize <= strlen(RqstBuf) + strlen(TempBuf)) return UPNP_E_BUFFER_TOO_SMALL; strcat(RqstBuf, TempBuf); } if (RqstBufSize <= strlen(RqstBuf) + strlen("\r\n")) return UPNP_E_BUFFER_TOO_SMALL; strcat(RqstBuf, "\r\n"); return UPNP_E_SUCCESS; } /*! * \brief */ #ifdef UPNP_ENABLE_IPV6 static int CreateClientRequestPacketUlaGua( /*! [in,out] . */ char *RqstBuf, /*! [in] . */ size_t RqstBufSize, /*! [in] . */ int Mx, /*! [in] . */ char *SearchTarget, /*! [in] . */ int AddressFamily) { int rc; char TempBuf[COMMAND_LEN]; const char *command = "M-SEARCH * HTTP/1.1\r\n"; const char *man = "MAN: \"ssdp:discover\"\r\n"; memset(TempBuf, 0, sizeof(TempBuf)); if (RqstBufSize <= strlen(command)) return UPNP_E_INTERNAL_ERROR; strcpy(RqstBuf, command); switch (AddressFamily) { case AF_INET: rc = snprintf(TempBuf, sizeof(TempBuf), "HOST: %s:%d\r\n", SSDP_IP, SSDP_PORT); break; case AF_INET6: rc = snprintf(TempBuf, sizeof(TempBuf), "HOST: [%s]:%d\r\n", SSDP_IPV6_SITELOCAL, SSDP_PORT); break; default: return UPNP_E_INVALID_ARGUMENT; } if (rc < 0 || (unsigned int) rc >= sizeof(TempBuf)) return UPNP_E_INTERNAL_ERROR; if (RqstBufSize <= strlen(RqstBuf) + strlen(TempBuf)) return UPNP_E_BUFFER_TOO_SMALL; strcat(RqstBuf, TempBuf); if (RqstBufSize <= strlen(RqstBuf) + strlen(man)) return UPNP_E_BUFFER_TOO_SMALL; strcat(RqstBuf, man); if (Mx > 0) { rc = snprintf(TempBuf, sizeof(TempBuf), "MX: %d\r\n", Mx); if (rc < 0 || (unsigned int) rc >= sizeof(TempBuf)) return UPNP_E_INTERNAL_ERROR; if (RqstBufSize <= strlen(RqstBuf) + strlen(TempBuf)) return UPNP_E_BUFFER_TOO_SMALL; strcat(RqstBuf, TempBuf); } if (SearchTarget) { rc = snprintf(TempBuf, sizeof(TempBuf), "ST: %s\r\n", SearchTarget); if (rc < 0 || (unsigned int) rc >= sizeof(TempBuf)) return UPNP_E_INTERNAL_ERROR; if (RqstBufSize <= strlen(RqstBuf) + strlen(TempBuf)) return UPNP_E_BUFFER_TOO_SMALL; strcat(RqstBuf, TempBuf); } if (RqstBufSize <= strlen(RqstBuf) + strlen("\r\n")) return UPNP_E_BUFFER_TOO_SMALL; strcat(RqstBuf, "\r\n"); return UPNP_E_SUCCESS; } #endif /* UPNP_ENABLE_IPV6 */ /*! * \brief */ static void searchExpired( /* [in] . */ void *arg) { int *id = (int *)arg; int handle = -1; struct Handle_Info *ctrlpt_info = NULL; /* remove search Target from list and call client back */ ListNode *node = NULL; SsdpSearchArg *item; Upnp_FunPtr ctrlpt_callback; void *cookie = NULL; int found = 0; HandleLock(); /* remove search target from search list */ if (GetClientHandleInfo(&handle, &ctrlpt_info) != HND_CLIENT) { free(id); HandleUnlock(); return; } ctrlpt_callback = ctrlpt_info->Callback; node = ListHead(&ctrlpt_info->SsdpSearchList); while (node != NULL) { item = (SsdpSearchArg *) node->item; if (item->timeoutEventId == (*id)) { free(item->searchTarget); cookie = item->cookie; found = 1; item->searchTarget = NULL; free(item); ListDelNode(&ctrlpt_info->SsdpSearchList, node, 0); break; } node = ListNext(&ctrlpt_info->SsdpSearchList, node); } HandleUnlock(); if (found) ctrlpt_callback(UPNP_DISCOVERY_SEARCH_TIMEOUT, NULL, cookie); free(id); } int SearchByTarget(int Mx, char *St, void *Cookie) { char errorBuffer[ERROR_BUFFER_LEN]; int *id = NULL; int ret = 0; char ReqBufv4[BUFSIZE]; #ifdef UPNP_ENABLE_IPV6 char ReqBufv6[BUFSIZE]; char ReqBufv6UlaGua[BUFSIZE]; #endif struct sockaddr_storage __ss_v4; #ifdef UPNP_ENABLE_IPV6 struct sockaddr_storage __ss_v6; #endif struct sockaddr_in *destAddr4 = (struct sockaddr_in *)&__ss_v4; #ifdef UPNP_ENABLE_IPV6 struct sockaddr_in6 *destAddr6 = (struct sockaddr_in6 *)&__ss_v6; #endif fd_set wrSet; SsdpSearchArg *newArg = NULL; int timeTillRead = 0; int handle; struct Handle_Info *ctrlpt_info = NULL; enum SsdpSearchType requestType; unsigned long addrv4 = inet_addr(gIF_IPV4); SOCKET max_fd = 0; int retVal; /*ThreadData *ThData; */ ThreadPoolJob job; memset(&job, 0, sizeof(job)); requestType = ssdp_request_type1(St); if (requestType == SSDP_SERROR) return UPNP_E_INVALID_PARAM; UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, "Inside SearchByTarget\n"); timeTillRead = Mx; if (timeTillRead < MIN_SEARCH_TIME) timeTillRead = MIN_SEARCH_TIME; else if (timeTillRead > MAX_SEARCH_TIME) timeTillRead = MAX_SEARCH_TIME; retVal = CreateClientRequestPacket(ReqBufv4, sizeof(ReqBufv4), timeTillRead, St, AF_INET); if (retVal != UPNP_E_SUCCESS) return retVal; #ifdef UPNP_ENABLE_IPV6 retVal = CreateClientRequestPacket(ReqBufv6, sizeof(ReqBufv6), timeTillRead, St, AF_INET6); if (retVal != UPNP_E_SUCCESS) return retVal; retVal = CreateClientRequestPacketUlaGua(ReqBufv6UlaGua, sizeof(ReqBufv6UlaGua), timeTillRead, St, AF_INET6); if (retVal != UPNP_E_SUCCESS) return retVal; #endif memset(&__ss_v4, 0, sizeof(__ss_v4)); destAddr4->sin_family = (sa_family_t)AF_INET; inet_pton(AF_INET, SSDP_IP, &destAddr4->sin_addr); destAddr4->sin_port = htons(SSDP_PORT); #ifdef UPNP_ENABLE_IPV6 memset(&__ss_v6, 0, sizeof(__ss_v6)); destAddr6->sin6_family = (sa_family_t)AF_INET6; inet_pton(AF_INET6, SSDP_IPV6_SITELOCAL, &destAddr6->sin6_addr); destAddr6->sin6_port = htons(SSDP_PORT); destAddr6->sin6_scope_id = gIF_INDEX; #endif /* add search criteria to list */ HandleLock(); if (GetClientHandleInfo(&handle, &ctrlpt_info) != HND_CLIENT) { HandleUnlock(); return UPNP_E_INTERNAL_ERROR; } newArg = (SsdpSearchArg *) malloc(sizeof(SsdpSearchArg)); newArg->searchTarget = strdup(St); newArg->cookie = Cookie; newArg->requestType = requestType; id = (int *)malloc(sizeof(int)); TPJobInit(&job, (start_routine) searchExpired, id); TPJobSetPriority(&job, MED_PRIORITY); TPJobSetFreeFunction(&job, (free_routine) free); /* Schedule a timeout event to remove search Arg */ TimerThreadSchedule(&gTimerThread, timeTillRead, REL_SEC, &job, SHORT_TERM, id); newArg->timeoutEventId = *id; ListAddTail(&ctrlpt_info->SsdpSearchList, newArg); HandleUnlock(); /* End of lock */ FD_ZERO(&wrSet); if (gSsdpReqSocket4 != INVALID_SOCKET) { setsockopt(gSsdpReqSocket4, IPPROTO_IP, IP_MULTICAST_IF, (char *)&addrv4, sizeof(addrv4)); FD_SET(gSsdpReqSocket4, &wrSet); max_fd = max(max_fd, gSsdpReqSocket4); } #ifdef UPNP_ENABLE_IPV6 if (gSsdpReqSocket6 != INVALID_SOCKET) { setsockopt(gSsdpReqSocket6, IPPROTO_IPV6, IPV6_MULTICAST_IF, (char *)&gIF_INDEX, sizeof(gIF_INDEX)); FD_SET(gSsdpReqSocket6, &wrSet); max_fd = max(max_fd, gSsdpReqSocket6); } #endif ret = select(max_fd + 1, NULL, &wrSet, NULL, NULL); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, "SSDP_LIB: Error in select(): %s\n", errorBuffer); UpnpCloseSocket(gSsdpReqSocket4); #ifdef UPNP_ENABLE_IPV6 UpnpCloseSocket(gSsdpReqSocket6); #endif return UPNP_E_INTERNAL_ERROR; } #ifdef UPNP_ENABLE_IPV6 if (gSsdpReqSocket6 != INVALID_SOCKET && FD_ISSET(gSsdpReqSocket6, &wrSet)) { int NumCopy = 0; while (NumCopy < NUM_SSDP_COPY) { UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, ">>> SSDP SEND M-SEARCH >>>\n%s\n", ReqBufv6UlaGua); sendto(gSsdpReqSocket6, ReqBufv6UlaGua, strlen(ReqBufv6UlaGua), 0, (struct sockaddr *)&__ss_v6, sizeof(struct sockaddr_in6)); NumCopy++; imillisleep(SSDP_PAUSE); } NumCopy = 0; inet_pton(AF_INET6, SSDP_IPV6_LINKLOCAL, &destAddr6->sin6_addr); while (NumCopy < NUM_SSDP_COPY) { UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, ">>> SSDP SEND M-SEARCH >>>\n%s\n", ReqBufv6); sendto(gSsdpReqSocket6, ReqBufv6, strlen(ReqBufv6), 0, (struct sockaddr *)&__ss_v6, sizeof(struct sockaddr_in6)); NumCopy++; imillisleep(SSDP_PAUSE); } } #endif /* IPv6 */ if (gSsdpReqSocket4 != INVALID_SOCKET && FD_ISSET(gSsdpReqSocket4, &wrSet)) { int NumCopy = 0; while (NumCopy < NUM_SSDP_COPY) { UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, ">>> SSDP SEND M-SEARCH >>>\n%s\n", ReqBufv4); sendto(gSsdpReqSocket4, ReqBufv4, strlen(ReqBufv4), 0, (struct sockaddr *)&__ss_v4, sizeof(struct sockaddr_in)); NumCopy++; imillisleep(SSDP_PAUSE); } } return 1; } #endif /* EXCLUDE_SSDP */ #endif /* INCLUDE_CLIENT_APIS */ /* @} SSDPlib */ pupnp-release-1.8.0/upnp/src/ssdp/ssdp_device.c000066400000000000000000000654601303304015100214570ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (C) 2011-2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ /*! * \addtogroup SSDPlib * * @{ * * \file */ #include "config.h" #ifdef INCLUDE_DEVICE_APIS #if EXCLUDE_SSDP == 0 #include "httpparser.h" #include "httpreadwrite.h" #include "ssdplib.h" #include "statcodes.h" #include "ThreadPool.h" #include "unixutil.h" #include "upnpapi.h" #include "UpnpInet.h" #include #include #include #ifdef WIN32 #define snprintf _snprintf #endif #define MSGTYPE_SHUTDOWN 0 #define MSGTYPE_ADVERTISEMENT 1 #define MSGTYPE_REPLY 2 void *advertiseAndReplyThread(void *data) { SsdpSearchReply *arg = (SsdpSearchReply *) data; AdvertiseAndReply(0, arg->handle, arg->event.RequestType, (struct sockaddr *)&arg->dest_addr, arg->event.DeviceType, arg->event.UDN, arg->event.ServiceType, arg->MaxAge); free(arg); return NULL; } #ifdef INCLUDE_DEVICE_APIS void ssdp_handle_device_request(http_message_t *hmsg, struct sockaddr_storage *dest_addr) { #define MX_FUDGE_FACTOR 10 int handle; struct Handle_Info *dev_info = NULL; memptr hdr_value; int mx; char save_char; SsdpEvent event; int ret_code; SsdpSearchReply *threadArg = NULL; ThreadPoolJob job; int replyTime; int maxAge; memset(&job, 0, sizeof(job)); /* check man hdr. */ if (httpmsg_find_hdr(hmsg, HDR_MAN, &hdr_value) == NULL || memptr_cmp(&hdr_value, "\"ssdp:discover\"") != 0) /* bad or missing hdr. */ return; /* MX header. */ if (httpmsg_find_hdr(hmsg, HDR_MX, &hdr_value) == NULL || (mx = raw_to_int(&hdr_value, 10)) < 0) return; /* ST header. */ if (httpmsg_find_hdr(hmsg, HDR_ST, &hdr_value) == NULL) return; save_char = hdr_value.buf[hdr_value.length]; hdr_value.buf[hdr_value.length] = '\0'; ret_code = ssdp_request_type(hdr_value.buf, &event); /* restore. */ hdr_value.buf[hdr_value.length] = save_char; if (ret_code == -1) /* bad ST header. */ return; HandleLock(); /* device info. */ switch (GetDeviceHandleInfo((int)dest_addr->ss_family, &handle, &dev_info)) { case HND_DEVICE: break; default: HandleUnlock(); /* no info found. */ return; } maxAge = dev_info->MaxAge; HandleUnlock(); UpnpPrintf(UPNP_PACKET, API, __FILE__, __LINE__, "MAX-AGE = %d\n", maxAge); UpnpPrintf(UPNP_PACKET, API, __FILE__, __LINE__, "MX = %d\n", event.Mx); UpnpPrintf(UPNP_PACKET, API, __FILE__, __LINE__, "DeviceType = %s\n", event.DeviceType); UpnpPrintf(UPNP_PACKET, API, __FILE__, __LINE__, "DeviceUuid = %s\n", event.UDN); UpnpPrintf(UPNP_PACKET, API, __FILE__, __LINE__, "ServiceType = %s\n", event.ServiceType); threadArg = (SsdpSearchReply *)malloc(sizeof(SsdpSearchReply)); if (threadArg == NULL) return; threadArg->handle = handle; memcpy(&threadArg->dest_addr, dest_addr, sizeof(threadArg->dest_addr)); threadArg->event = event; threadArg->MaxAge = maxAge; TPJobInit(&job, advertiseAndReplyThread, threadArg); TPJobSetFreeFunction(&job, (free_routine) free); /* Subtract a percentage from the mx to allow for network and processing * delays (i.e. if search is for 30 seconds, respond * within 0 - 27 seconds). */ if (mx >= 2) mx -= MAXVAL(1, mx / MX_FUDGE_FACTOR); if (mx < 1) mx = 1; replyTime = rand() % mx; TimerThreadSchedule(&gTimerThread, replyTime, REL_SEC, &job, SHORT_TERM, NULL); } #endif /*! * \brief Works as a request handler which passes the HTTP request string * to multicast channel. * * \return UPNP_E_SUCCESS if successful else appropriate error. */ static int NewRequestHandler( /*! [in] Ip address, to send the reply. */ struct sockaddr *DestAddr, /*! [in] Number of packet to be sent. */ int NumPacket, /*! [in] . */ char **RqPacket) { char errorBuffer[ERROR_BUFFER_LEN]; SOCKET ReplySock; socklen_t socklen = sizeof(struct sockaddr_storage); int Index; unsigned long replyAddr = inet_addr(gIF_IPV4); /* a/c to UPNP Spec */ int ttl = 4; #ifdef INET_IPV6 int hops = 1; #endif char buf_ntop[INET6_ADDRSTRLEN]; int ret = UPNP_E_SUCCESS; ReplySock = socket((int)DestAddr->sa_family, SOCK_DGRAM, 0); if (ReplySock == INVALID_SOCKET) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, "SSDP_LIB: New Request Handler:" "Error in socket(): %s\n", errorBuffer); return UPNP_E_OUTOF_SOCKET; } switch (DestAddr->sa_family) { case AF_INET: inet_ntop(AF_INET, &((struct sockaddr_in *)DestAddr)->sin_addr, buf_ntop, sizeof(buf_ntop)); setsockopt(ReplySock, IPPROTO_IP, IP_MULTICAST_IF, (char *)&replyAddr, sizeof(replyAddr)); setsockopt(ReplySock, IPPROTO_IP, IP_MULTICAST_TTL, (char *)&ttl, sizeof(int)); socklen = sizeof(struct sockaddr_in); break; #ifdef INET_IPV6 case AF_INET6: inet_ntop(AF_INET6, &((struct sockaddr_in6 *)DestAddr)->sin6_addr, buf_ntop, sizeof(buf_ntop)); setsockopt(ReplySock, IPPROTO_IPV6, IPV6_MULTICAST_IF, (char *)&gIF_INDEX, sizeof(gIF_INDEX)); setsockopt(ReplySock, IPPROTO_IPV6, IPV6_MULTICAST_HOPS, (char *)&hops, sizeof(hops)); break; #endif default: UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Invalid destination address specified."); ret = UPNP_E_NETWORK_ERROR; goto end_NewRequestHandler; } for (Index = 0; Index < NumPacket; Index++) { ssize_t rc; UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, ">>> SSDP SEND to %s >>>\n%s\n", buf_ntop, *(RqPacket + Index)); rc = sendto(ReplySock, *(RqPacket + Index), strlen(*(RqPacket + Index)), 0, DestAddr, socklen); if (rc == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, "SSDP_LIB: New Request Handler:" "Error in socket(): %s\n", errorBuffer); ret = UPNP_E_SOCKET_WRITE; goto end_NewRequestHandler; } } end_NewRequestHandler: UpnpCloseSocket(ReplySock); return ret; } /*! * \brief * * \return 1 if an inet6 @ has been found. */ static int extractIPv6address(char *url, char *address) { int i = 0; int j = 0; int ret = 0; while (url[i] != '[' && url[i] != '\0') { i++; } if (url[i] == '\0') { goto exit_function; } /* bracket has been found, we deal with an IPv6 address */ i++; while (url[i] != '\0' && url[i] != ']') { address[j] = url[i]; i++; j++; } if (url[i] == '\0') { goto exit_function; } if (url[i] == ']') { address[j] = '\0'; ret = 1; } exit_function: return ret; } /*! * \brief * * \return 1 if the Url contains an ULA or GUA IPv6 address, 0 otherwise. */ static int isUrlV6UlaGua(char *descdocUrl) { char address[INET6_ADDRSTRLEN]; struct in6_addr v6_addr; if (extractIPv6address(descdocUrl, address)) { inet_pton(AF_INET6, address, &v6_addr); return !IN6_IS_ADDR_LINKLOCAL(&v6_addr); } return 0; } /*! * \brief Creates a HTTP request packet. Depending on the input parameter, * it either creates a service advertisement request or service shutdown * request etc. */ static void CreateServicePacket( /*! [in] type of the message (Search Reply, Advertisement * or Shutdown). */ int msg_type, /*! [in] ssdp type. */ const char *nt, /*! [in] unique service name ( go in the HTTP Header). */ char *usn, /*! [in] Location URL. */ char *location, /*! [in] Service duration in sec. */ int duration, /*! [out] Output buffer filled with HTTP statement. */ char **packet, /*! [in] Address family of the HTTP request. */ int AddressFamily, /*! [in] PowerState as defined by UPnP Low Power. */ int PowerState, /*! [in] SleepPeriod as defined by UPnP Low Power. */ int SleepPeriod, /*! [in] RegistrationState as defined by UPnP Low Power. */ int RegistrationState) { int ret_code; const char *nts; membuffer buf; /* Notf == 0 means service shutdown, * Notf == 1 means service advertisement, * Notf == 2 means reply */ membuffer_init(&buf); buf.size_inc = (size_t)30; *packet = NULL; if (msg_type == MSGTYPE_REPLY) { if (PowerState > 0) { #ifdef UPNP_HAVE_OPTSSDP ret_code = http_MakeMessage(&buf, 1, 1, "R" "sdc" "D" "sc" "ssc" "ssc" "ssc" "S" "Xc" "ssc" "ssc" "sdc" "sdc" "sdcc", HTTP_OK, "CACHE-CONTROL: max-age=", duration, "EXT:", "LOCATION: ", location, "OPT: ", "\"http://schemas.upnp.org/upnp/1/0/\"; ns=01", "01-NLS: ", gUpnpSdkNLSuuid, X_USER_AGENT, "ST: ", nt, "USN: ", usn, "Powerstate: ", PowerState, "SleepPeriod: ", SleepPeriod, "RegistrationState: ", RegistrationState); #else ret_code = http_MakeMessage(&buf, 1, 1, "R" "sdc" "D" "sc" "ssc" "S" "ssc" "ssc" "sdc" "sdc" "sdcc", HTTP_OK, "CACHE-CONTROL: max-age=", duration, "EXT:", "LOCATION: ", location, "ST: ", nt, "USN: ", usn, "Powerstate: ", PowerState, "SleepPeriod: ", SleepPeriod, "RegistrationState: ", RegistrationState); #endif /* UPNP_HAVE_OPTSSDP */ } else { #ifdef UPNP_HAVE_OPTSSDP ret_code = http_MakeMessage(&buf, 1, 1, "R" "sdc" "D" "sc" "ssc" "ssc" "ssc" "S" "Xc" "ssc" "sscc", HTTP_OK, "CACHE-CONTROL: max-age=", duration, "EXT:", "LOCATION: ", location, "OPT: ", "\"http://schemas.upnp.org/upnp/1/0/\"; ns=01", "01-NLS: ", gUpnpSdkNLSuuid, X_USER_AGENT, "ST: ", nt, "USN: ", usn); #else ret_code = http_MakeMessage(&buf, 1, 1, "R" "sdc" "D" "sc" "ssc" "S" "ssc" "sscc", HTTP_OK, "CACHE-CONTROL: max-age=", duration, "EXT:", "LOCATION: ", location, "ST: ", nt, "USN: ", usn); #endif /* UPNP_HAVE_OPTSSDP */ } if (ret_code != 0) { return; } } else if (msg_type == MSGTYPE_ADVERTISEMENT || msg_type == MSGTYPE_SHUTDOWN) { const char *host = NULL; if (msg_type == MSGTYPE_ADVERTISEMENT) nts = "ssdp:alive"; else /* shutdown */ nts = "ssdp:byebye"; /* NOTE: The CACHE-CONTROL and LOCATION headers are not present in * a shutdown msg, but are present here for MS WinMe interop. */ switch (AddressFamily) { case AF_INET: host = SSDP_IP; break; default: if (isUrlV6UlaGua(location)) host = "[" SSDP_IPV6_SITELOCAL "]"; else host = "[" SSDP_IPV6_LINKLOCAL "]"; } if (PowerState > 0) { #ifdef UPNP_HAVE_OPTSSDP ret_code = http_MakeMessage(&buf, 1, 1, "Q" "sssdc" "sdc" "ssc" "ssc" "ssc" "ssc" "ssc" "S" "Xc" "ssc" "sdc" "sdc" "sdcc", HTTPMETHOD_NOTIFY, "*", (size_t) 1, "HOST: ", host, ":", SSDP_PORT, "CACHE-CONTROL: max-age=", duration, "LOCATION: ", location, "OPT: ", "\"http://schemas.upnp.org/upnp/1/0/\"; ns=01", "01-NLS: ", gUpnpSdkNLSuuid, "NT: ", nt, "NTS: ", nts, X_USER_AGENT, "USN: ", usn, "Powerstate: ", PowerState, "SleepPeriod: ", SleepPeriod, "RegistrationState: ", RegistrationState); #else ret_code = http_MakeMessage(&buf, 1, 1, "Q" "sssdc" "sdc" "ssc" "ssc" "ssc" "S" "ssc" "sdc" "sdc" "sdcc", HTTPMETHOD_NOTIFY, "*", (size_t) 1, "HOST: ", host, ":", SSDP_PORT, "CACHE-CONTROL: max-age=", duration, "LOCATION: ", location, "NT: ", nt, "NTS: ", nts, "USN: ", usn, "Powerstate: ", PowerState, "SleepPeriod: ", SleepPeriod, "RegistrationState: ", RegistrationState); #endif /* UPNP_HAVE_OPTSSDP */ } else { #ifdef UPNP_HAVE_OPTSSDP ret_code = http_MakeMessage(&buf, 1, 1, "Q" "sssdc" "sdc" "ssc" "ssc" "ssc" "ssc" "ssc" "S" "Xc" "sscc", HTTPMETHOD_NOTIFY, "*", (size_t) 1, "HOST: ", host, ":", SSDP_PORT, "CACHE-CONTROL: max-age=", duration, "LOCATION: ", location, "OPT: ", "\"http://schemas.upnp.org/upnp/1/0/\"; ns=01", "01-NLS: ", gUpnpSdkNLSuuid, "NT: ", nt, "NTS: ", nts, X_USER_AGENT, "USN: ", usn); #else ret_code = http_MakeMessage(&buf, 1, 1, "Q" "sssdc" "sdc" "ssc" "ssc" "ssc" "S" "sscc", HTTPMETHOD_NOTIFY, "*", (size_t) 1, "HOST: ", host, ":", SSDP_PORT, "CACHE-CONTROL: max-age=", duration, "LOCATION: ", location, "NT: ", nt, "NTS: ", nts, "USN: ", usn); #endif /* UPNP_HAVE_OPTSSDP */ } if (ret_code) return; } else /* unknown msg */ assert(0); /* return msg */ *packet = membuffer_detach(&buf); membuffer_destroy(&buf); return; } int DeviceAdvertisement(char *DevType, int RootDev, char *Udn, char *Location, int Duration, int AddressFamily, int PowerState, int SleepPeriod, int RegistrationState) { struct sockaddr_storage __ss; struct sockaddr_in *DestAddr4 = (struct sockaddr_in *)&__ss; struct sockaddr_in6 *DestAddr6 = (struct sockaddr_in6 *)&__ss; /* char Mil_Nt[LINE_SIZE] */ char Mil_Usn[LINE_SIZE]; char *msgs[3]; int ret_code = UPNP_E_OUTOF_MEMORY; int rc = 0; UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, "In function DeviceAdvertisement\n"); memset(&__ss, 0, sizeof(__ss)); switch (AddressFamily) { case AF_INET: DestAddr4->sin_family = (sa_family_t)AF_INET; inet_pton(AF_INET, SSDP_IP, &DestAddr4->sin_addr); DestAddr4->sin_port = htons(SSDP_PORT); break; case AF_INET6: DestAddr6->sin6_family = (sa_family_t)AF_INET6; inet_pton(AF_INET6, (isUrlV6UlaGua(Location)) ? SSDP_IPV6_SITELOCAL : SSDP_IPV6_LINKLOCAL, &DestAddr6->sin6_addr); DestAddr6->sin6_port = htons(SSDP_PORT); DestAddr6->sin6_scope_id = gIF_INDEX; break; default: UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Invalid device address family.\n"); } msgs[0] = NULL; msgs[1] = NULL; msgs[2] = NULL; /* If deviceis a root device , here we need to send 3 advertisement * or reply */ if (RootDev) { rc = snprintf(Mil_Usn, sizeof(Mil_Usn), "%s::upnp:rootdevice", Udn); if (rc < 0 || (unsigned int) rc >= sizeof(Mil_Usn)) goto error_handler; CreateServicePacket(MSGTYPE_ADVERTISEMENT, "upnp:rootdevice", Mil_Usn, Location, Duration, &msgs[0], AddressFamily, PowerState, SleepPeriod, RegistrationState); } /* both root and sub-devices need to send these two messages */ CreateServicePacket(MSGTYPE_ADVERTISEMENT, Udn, Udn, Location, Duration, &msgs[1], AddressFamily, PowerState, SleepPeriod, RegistrationState); rc = snprintf(Mil_Usn, sizeof(Mil_Usn), "%s::%s", Udn, DevType); if (rc < 0 || (unsigned int) rc >= sizeof(Mil_Usn)) goto error_handler; CreateServicePacket(MSGTYPE_ADVERTISEMENT, DevType, Mil_Usn, Location, Duration, &msgs[2], AddressFamily, PowerState, SleepPeriod, RegistrationState); /* check error */ if ((RootDev && msgs[0] == NULL) || msgs[1] == NULL || msgs[2] == NULL) { goto error_handler; } /* send packets */ if (RootDev) { /* send 3 msg types */ ret_code = NewRequestHandler((struct sockaddr *)&__ss, 3, &msgs[0]); } else { /* sub-device */ /* send 2 msg types */ ret_code = NewRequestHandler((struct sockaddr *)&__ss, 2, &msgs[1]); } error_handler: /* free msgs */ free(msgs[0]); free(msgs[1]); free(msgs[2]); return ret_code; } int SendReply(struct sockaddr *DestAddr, char *DevType, int RootDev, char *Udn, char *Location, int Duration, int ByType, int PowerState, int SleepPeriod, int RegistrationState) { int ret_code = UPNP_E_OUTOF_MEMORY; char *msgs[2]; int num_msgs; char Mil_Usn[LINE_SIZE]; int i; int rc = 0; msgs[0] = NULL; msgs[1] = NULL; if (RootDev) { /* one msg for root device */ num_msgs = 1; rc = snprintf(Mil_Usn, sizeof(Mil_Usn), "%s::upnp:rootdevice", Udn); if (rc < 0 || (unsigned int) rc >= sizeof(Mil_Usn)) goto error_handler; CreateServicePacket(MSGTYPE_REPLY, "upnp:rootdevice", Mil_Usn, Location, Duration, &msgs[0], (int)DestAddr->sa_family, PowerState, SleepPeriod, RegistrationState); } else { /* two msgs for embedded devices */ num_msgs = 1; /*NK: FIX for extra response when someone searches by udn */ if (!ByType) { CreateServicePacket(MSGTYPE_REPLY, Udn, Udn, Location, Duration, &msgs[0], (int)DestAddr->sa_family, PowerState, SleepPeriod, RegistrationState); } else { rc = snprintf(Mil_Usn, sizeof(Mil_Usn), "%s::%s", Udn, DevType); if (rc < 0 || (unsigned int) rc >= sizeof(Mil_Usn)) goto error_handler; CreateServicePacket(MSGTYPE_REPLY, DevType, Mil_Usn, Location, Duration, &msgs[0], (int)DestAddr->sa_family, PowerState, SleepPeriod, RegistrationState); } } /* check error */ for (i = 0; i < num_msgs; i++) { if (msgs[i] == NULL) { goto error_handler; } } /* send msgs */ ret_code = NewRequestHandler(DestAddr, num_msgs, msgs); error_handler: for (i = 0; i < num_msgs; i++) { if (msgs[i] != NULL) free(msgs[i]); } return ret_code; } int DeviceReply(struct sockaddr *DestAddr, char *DevType, int RootDev, char *Udn, char *Location, int Duration, int PowerState, int SleepPeriod, int RegistrationState) { char *szReq[3], Mil_Nt[LINE_SIZE], Mil_Usn[LINE_SIZE]; int RetVal = UPNP_E_OUTOF_MEMORY; int rc = 0; szReq[0] = NULL; szReq[1] = NULL; szReq[2] = NULL; /* create 2 or 3 msgs */ if (RootDev) { /* 3 replies for root device */ memset(Mil_Nt, 0, sizeof(Mil_Nt)); strncpy(Mil_Nt, "upnp:rootdevice", sizeof(Mil_Nt) - 1); rc = snprintf(Mil_Usn, sizeof(Mil_Usn), "%s::upnp:rootdevice", Udn); if (rc < 0 || (unsigned int) rc >= sizeof(Mil_Usn)) goto error_handler; CreateServicePacket(MSGTYPE_REPLY, Mil_Nt, Mil_Usn, Location, Duration, &szReq[0], (int)DestAddr->sa_family, PowerState, SleepPeriod, RegistrationState); } rc = snprintf(Mil_Nt, sizeof(Mil_Nt), "%s", Udn); if (rc < 0 || (unsigned int) rc >= sizeof(Mil_Nt)) goto error_handler; rc = snprintf(Mil_Usn, sizeof(Mil_Usn), "%s", Udn); if (rc < 0 || (unsigned int) rc >= sizeof(Mil_Usn)) goto error_handler; CreateServicePacket(MSGTYPE_REPLY, Mil_Nt, Mil_Usn, Location, Duration, &szReq[1], (int)DestAddr->sa_family, PowerState, SleepPeriod, RegistrationState); rc = snprintf(Mil_Nt, sizeof(Mil_Nt), "%s", DevType); if (rc < 0 || (unsigned int) rc >= sizeof(Mil_Nt)) goto error_handler; rc = snprintf(Mil_Usn, sizeof(Mil_Usn), "%s::%s", Udn, DevType); if (rc < 0 || (unsigned int) rc >= sizeof(Mil_Usn)) goto error_handler; CreateServicePacket(MSGTYPE_REPLY, Mil_Nt, Mil_Usn, Location, Duration, &szReq[2], (int)DestAddr->sa_family, PowerState, SleepPeriod, RegistrationState); /* check error */ if ((RootDev && szReq[0] == NULL) || szReq[1] == NULL || szReq[2] == NULL) { goto error_handler; } /* send replies */ if (RootDev) { RetVal = NewRequestHandler(DestAddr, 3, szReq); } else { RetVal = NewRequestHandler(DestAddr, 2, &szReq[1]); } error_handler: /* free */ free(szReq[0]); free(szReq[1]); free(szReq[2]); return RetVal; } int ServiceAdvertisement(char *Udn, char *ServType, char *Location, int Duration, int AddressFamily, int PowerState, int SleepPeriod, int RegistrationState) { char Mil_Usn[LINE_SIZE]; char *szReq[1]; int RetVal = UPNP_E_OUTOF_MEMORY; struct sockaddr_storage __ss; struct sockaddr_in *DestAddr4 = (struct sockaddr_in *)&__ss; struct sockaddr_in6 *DestAddr6 = (struct sockaddr_in6 *)&__ss; int rc = 0; memset(&__ss, 0, sizeof(__ss)); szReq[0] = NULL; switch (AddressFamily) { case AF_INET: DestAddr4->sin_family = (sa_family_t)AddressFamily; inet_pton(AF_INET, SSDP_IP, &DestAddr4->sin_addr); DestAddr4->sin_port = htons(SSDP_PORT); break; case AF_INET6: DestAddr6->sin6_family = (sa_family_t)AddressFamily; inet_pton(AF_INET6, (isUrlV6UlaGua(Location)) ? SSDP_IPV6_SITELOCAL : SSDP_IPV6_LINKLOCAL, &DestAddr6->sin6_addr); DestAddr6->sin6_port = htons(SSDP_PORT); DestAddr6->sin6_scope_id = gIF_INDEX; break; default: UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Invalid device address family.\n"); } rc = snprintf(Mil_Usn, sizeof(Mil_Usn), "%s::%s", Udn, ServType); if (rc < 0 || (unsigned int) rc >= sizeof(Mil_Usn)) goto error_handler; /* CreateServiceRequestPacket(1,szReq[0],Mil_Nt,Mil_Usn, * Server,Location,Duration); */ CreateServicePacket(MSGTYPE_ADVERTISEMENT, ServType, Mil_Usn, Location, Duration, &szReq[0], AddressFamily, PowerState, SleepPeriod, RegistrationState); if (szReq[0] == NULL) { goto error_handler; } RetVal = NewRequestHandler((struct sockaddr *)&__ss, 1, szReq); error_handler: free(szReq[0]); return RetVal; } int ServiceReply(struct sockaddr *DestAddr, char *ServType, char *Udn, char *Location, int Duration, int PowerState, int SleepPeriod, int RegistrationState) { char Mil_Usn[LINE_SIZE]; char *szReq[1]; int RetVal = UPNP_E_OUTOF_MEMORY; int rc = 0; szReq[0] = NULL; rc = snprintf(Mil_Usn, sizeof(Mil_Usn), "%s::%s", Udn, ServType); if (rc < 0 || (unsigned int) rc >= sizeof(Mil_Usn)) goto error_handler; CreateServicePacket(MSGTYPE_REPLY, ServType, Mil_Usn, Location, Duration, &szReq[0], (int)DestAddr->sa_family, PowerState, SleepPeriod, RegistrationState); if (szReq[0] == NULL) goto error_handler; RetVal = NewRequestHandler(DestAddr, 1, szReq); error_handler: free(szReq[0]); return RetVal; } int ServiceShutdown(char *Udn, char *ServType, char *Location, int Duration, int AddressFamily, int PowerState, int SleepPeriod, int RegistrationState) { char Mil_Usn[LINE_SIZE]; char *szReq[1]; struct sockaddr_storage __ss; struct sockaddr_in *DestAddr4 = (struct sockaddr_in *)&__ss; struct sockaddr_in6 *DestAddr6 = (struct sockaddr_in6 *)&__ss; int RetVal = UPNP_E_OUTOF_MEMORY; int rc = 0; memset(&__ss, 0, sizeof(__ss)); szReq[0] = NULL; switch (AddressFamily) { case AF_INET: DestAddr4->sin_family = (sa_family_t)AddressFamily; inet_pton(AF_INET, SSDP_IP, &DestAddr4->sin_addr); DestAddr4->sin_port = htons(SSDP_PORT); break; case AF_INET6: DestAddr6->sin6_family = (sa_family_t)AddressFamily; inet_pton(AF_INET6, (isUrlV6UlaGua(Location)) ? SSDP_IPV6_SITELOCAL : SSDP_IPV6_LINKLOCAL, &DestAddr6->sin6_addr); DestAddr6->sin6_port = htons(SSDP_PORT); DestAddr6->sin6_scope_id = gIF_INDEX; break; default: UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Invalid device address family.\n"); } /* sprintf(Mil_Nt,"%s",ServType); */ rc = snprintf(Mil_Usn, sizeof(Mil_Usn), "%s::%s", Udn, ServType); if (rc < 0 || (unsigned int) rc >= sizeof(Mil_Usn)) goto error_handler; /* CreateServiceRequestPacket(0,szReq[0],Mil_Nt,Mil_Usn, * Server,Location,Duration); */ CreateServicePacket(MSGTYPE_SHUTDOWN, ServType, Mil_Usn, Location, Duration, &szReq[0], AddressFamily, PowerState, SleepPeriod, RegistrationState); if (szReq[0] == NULL) goto error_handler; RetVal = NewRequestHandler((struct sockaddr *)&__ss, 1, szReq); error_handler: free(szReq[0]); return RetVal; } int DeviceShutdown(char *DevType, int RootDev, char *Udn, char *Location, int Duration, int AddressFamily, int PowerState, int SleepPeriod, int RegistrationState) { struct sockaddr_storage __ss; struct sockaddr_in *DestAddr4 = (struct sockaddr_in *)&__ss; struct sockaddr_in6 *DestAddr6 = (struct sockaddr_in6 *)&__ss; char *msgs[3]; char Mil_Usn[LINE_SIZE]; int ret_code = UPNP_E_OUTOF_MEMORY; int rc = 0; msgs[0] = NULL; msgs[1] = NULL; msgs[2] = NULL; memset(&__ss, 0, sizeof(__ss)); switch (AddressFamily) { case AF_INET: DestAddr4->sin_family = (sa_family_t)AddressFamily; inet_pton(AF_INET, SSDP_IP, &DestAddr4->sin_addr); DestAddr4->sin_port = htons(SSDP_PORT); break; case AF_INET6: DestAddr6->sin6_family = (sa_family_t)AddressFamily; inet_pton(AF_INET6, (isUrlV6UlaGua(Location)) ? SSDP_IPV6_SITELOCAL : SSDP_IPV6_LINKLOCAL, &DestAddr6->sin6_addr); DestAddr6->sin6_port = htons(SSDP_PORT); DestAddr6->sin6_scope_id = gIF_INDEX; break; default: UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Invalid device address family.\n"); } /* root device has one extra msg */ if (RootDev) { rc = snprintf(Mil_Usn, sizeof(Mil_Usn), "%s::upnp:rootdevice", Udn); if (rc < 0 || (unsigned int) rc >= sizeof(Mil_Usn)) goto error_handler; CreateServicePacket(MSGTYPE_SHUTDOWN, "upnp:rootdevice", Mil_Usn, Location, Duration, &msgs[0], AddressFamily, PowerState, SleepPeriod, RegistrationState); } UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, "In function DeviceShutdown\n"); /* both root and sub-devices need to send these two messages */ CreateServicePacket(MSGTYPE_SHUTDOWN, Udn, Udn, Location, Duration, &msgs[1], AddressFamily, PowerState, SleepPeriod, RegistrationState); rc = snprintf(Mil_Usn, sizeof(Mil_Usn), "%s::%s", Udn, DevType); if (rc < 0 || (unsigned int) rc >= sizeof(Mil_Usn)) goto error_handler; CreateServicePacket(MSGTYPE_SHUTDOWN, DevType, Mil_Usn, Location, Duration, &msgs[2], AddressFamily, PowerState, SleepPeriod, RegistrationState); /* check error */ if ((RootDev && msgs[0] == NULL) || msgs[1] == NULL || msgs[2] == NULL) { goto error_handler; } /* send packets */ if (RootDev) { /* send 3 msg types */ ret_code = NewRequestHandler((struct sockaddr *)&__ss, 3, &msgs[0]); } else { /* sub-device */ /* send 2 msg types */ ret_code = NewRequestHandler((struct sockaddr *)&__ss, 2, &msgs[1]); } error_handler: /* free msgs */ free(msgs[0]); free(msgs[1]); free(msgs[2]); return ret_code; } #endif /* EXCLUDE_SSDP */ #endif /* INCLUDE_DEVICE_APIS */ /* @} SSDPlib */ pupnp-release-1.8.0/upnp/src/ssdp/ssdp_server.c000066400000000000000000001125031303304015100215150ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (C) 2011-2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ /*! * \addtogroup SSDPlib * * @{ * * \file */ #ifndef WIN32 #include #else #define snprintf _snprintf #endif /* WIN32 */ #include "config.h" #if EXCLUDE_SSDP == 0 #include "ssdplib.h" #include "httpparser.h" #include "httpreadwrite.h" #include "membuffer.h" #include "miniserver.h" #include "sock.h" #include "ThreadPool.h" #include "upnpapi.h" #include #define MAX_TIME_TOREAD 45 #ifdef INCLUDE_CLIENT_APIS SOCKET gSsdpReqSocket4 = INVALID_SOCKET; #ifdef UPNP_ENABLE_IPV6 SOCKET gSsdpReqSocket6 = INVALID_SOCKET; #endif /* UPNP_ENABLE_IPV6 */ #endif /* INCLUDE_CLIENT_APIS */ void RequestHandler(); enum Listener { Idle, Stopping, Running }; struct SSDPSockArray { /*! socket for incoming advertisments and search requests */ SOCKET ssdpSock; #ifdef INCLUDE_CLIENT_APIS /*! socket for sending search requests and receiving search replies */ int ssdpReqSock; #endif /* INCLUDE_CLIENT_APIS */ }; #ifdef INCLUDE_DEVICE_APIS static const char SERVICELIST_STR[] = "serviceList"; int AdvertiseAndReply(int AdFlag, UpnpDevice_Handle Hnd, enum SsdpSearchType SearchType, struct sockaddr *DestAddr, char *DeviceType, char *DeviceUDN, char *ServiceType, int Exp) { int retVal = UPNP_E_SUCCESS; long unsigned int i; long unsigned int j; int defaultExp = DEFAULT_MAXAGE; struct Handle_Info *SInfo = NULL; char UDNstr[100]; char devType[100]; char servType[100]; IXML_NodeList *nodeList = NULL; IXML_NodeList *tmpNodeList = NULL; IXML_Node *tmpNode = NULL; IXML_Node *tmpNode2 = NULL; IXML_Node *textNode = NULL; const DOMString tmpStr; const DOMString dbgStr; int NumCopy = 0; memset(UDNstr, 0, sizeof(UDNstr)); memset(devType, 0, sizeof(devType)); memset(servType, 0, sizeof(servType)); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Inside AdvertiseAndReply with AdFlag = %d\n", AdFlag); /* Use a read lock */ HandleReadLock(); if (GetHandleInfo(Hnd, &SInfo) != HND_DEVICE) { retVal = UPNP_E_INVALID_HANDLE; goto end_function; } defaultExp = SInfo->MaxAge; /* parse the device list and send advertisements/replies */ while (NumCopy == 0 || (AdFlag && NumCopy < NUM_SSDP_COPY)) { if (NumCopy != 0) imillisleep(SSDP_PAUSE); NumCopy++; for (i = 0lu;; i++) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Entering new device list with i = %lu\n\n", i); tmpNode = ixmlNodeList_item(SInfo->DeviceList, i); if (!tmpNode) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting new device list with i = %lu\n\n", i); break; } dbgStr = ixmlNode_getNodeName(tmpNode); UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Extracting device type once for %s\n", dbgStr); ixmlNodeList_free(nodeList); nodeList = ixmlElement_getElementsByTagName((IXML_Element *) tmpNode, "deviceType"); if (!nodeList) continue; UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Extracting UDN for %s\n", dbgStr); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Extracting device type\n"); tmpNode2 = ixmlNodeList_item(nodeList, 0lu); if (!tmpNode2) continue; textNode = ixmlNode_getFirstChild(tmpNode2); if (!textNode) continue; UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Extracting device type \n"); tmpStr = ixmlNode_getNodeValue(textNode); if (!tmpStr) continue; strncpy(devType, tmpStr, sizeof(devType) - 1); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Extracting device type = %s\n", devType); if (!tmpNode) { UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "TempNode is NULL\n"); } dbgStr = ixmlNode_getNodeName(tmpNode); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Extracting UDN for %s\n", dbgStr); ixmlNodeList_free(nodeList); nodeList = ixmlElement_getElementsByTagName((IXML_Element *) tmpNode, "UDN"); if (!nodeList) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "UDN not found!\n"); continue; } tmpNode2 = ixmlNodeList_item(nodeList, 0lu); if (!tmpNode2) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "UDN not found!\n"); continue; } textNode = ixmlNode_getFirstChild(tmpNode2); if (!textNode) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "UDN not found!\n"); continue; } tmpStr = ixmlNode_getNodeValue(textNode); if (!tmpStr) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "UDN not found!\n"); continue; } strncpy(UDNstr, tmpStr, sizeof(UDNstr) - 1); UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Sending UDNStr = %s \n", UDNstr); if (AdFlag) { /* send the device advertisement */ if (AdFlag == 1) { DeviceAdvertisement(devType, i == 0lu, UDNstr, SInfo->DescURL, Exp, SInfo->DeviceAf, SInfo->PowerState, SInfo->SleepPeriod, SInfo->RegistrationState); } else { /* AdFlag == -1 */ DeviceShutdown(devType, i == 0lu, UDNstr, SInfo->DescURL, Exp, SInfo->DeviceAf, SInfo->PowerState, SInfo->SleepPeriod, SInfo->RegistrationState); } } else { switch (SearchType) { case SSDP_ALL: DeviceReply(DestAddr, devType, i == 0lu, UDNstr, SInfo->DescURL, defaultExp, SInfo->PowerState, SInfo->SleepPeriod, SInfo->RegistrationState); break; case SSDP_ROOTDEVICE: if (i == 0lu) { SendReply(DestAddr, devType, 1, UDNstr, SInfo->DescURL, defaultExp, 0, SInfo->PowerState, SInfo->SleepPeriod, SInfo->RegistrationState); } break; case SSDP_DEVICEUDN: { if (DeviceUDN && strlen(DeviceUDN) != (size_t)0) { if (strcasecmp(DeviceUDN, UDNstr)) { UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "DeviceUDN=%s and search UDN=%s DID NOT match\n", UDNstr, DeviceUDN); break; } else { UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "DeviceUDN=%s and search UDN=%s MATCH\n", UDNstr, DeviceUDN); SendReply(DestAddr, devType, 0, UDNstr, SInfo->DescURL, defaultExp, 0, SInfo->PowerState, SInfo->SleepPeriod, SInfo->RegistrationState); break; } } } case SSDP_DEVICETYPE: { if (!strncasecmp(DeviceType, devType, strlen(DeviceType) - (size_t)2)) { if (atoi(strrchr(DeviceType, ':') + 1) < atoi(&devType[strlen(devType) - (size_t)1])) { /* the requested version is lower than the device version * must reply with the lower version number and the lower * description URL */ UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "DeviceType=%s and search devType=%s MATCH\n", devType, DeviceType); SendReply(DestAddr, DeviceType, 0, UDNstr, SInfo->LowerDescURL, defaultExp, 1, SInfo->PowerState, SInfo->SleepPeriod, SInfo->RegistrationState); } else if (atoi(strrchr(DeviceType, ':') + 1) == atoi(&devType[strlen(devType) - (size_t)1])) { UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "DeviceType=%s and search devType=%s MATCH\n", devType, DeviceType); SendReply(DestAddr, DeviceType, 0, UDNstr, SInfo->DescURL, defaultExp, 1, SInfo->PowerState, SInfo->SleepPeriod, SInfo->RegistrationState); } else { UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "DeviceType=%s and search devType=%s DID NOT MATCH\n", devType, DeviceType); } } else { UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "DeviceType=%s and search devType=%s DID NOT MATCH\n", devType, DeviceType); } break; } default: break; } } /* send service advertisements for services corresponding * to the same device */ UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Sending service Advertisement\n"); /* Correct service traversal such that each device's serviceList * is directly traversed as a child of its parent device. This * ensures that the service's alive message uses the UDN of * the parent device. */ tmpNode = ixmlNode_getFirstChild(tmpNode); while (tmpNode) { dbgStr = ixmlNode_getNodeName(tmpNode); if (!strncmp (dbgStr, SERVICELIST_STR, sizeof SERVICELIST_STR)) { break; } tmpNode = ixmlNode_getNextSibling(tmpNode); } ixmlNodeList_free(nodeList); if (!tmpNode) { nodeList = NULL; continue; } nodeList = ixmlElement_getElementsByTagName((IXML_Element *) tmpNode, "service"); if (!nodeList) { UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "Service not found 3\n"); continue; } for (j = 0lu;; j++) { tmpNode = ixmlNodeList_item(nodeList, j); if (!tmpNode) { break; } ixmlNodeList_free(tmpNodeList); tmpNodeList = ixmlElement_getElementsByTagName((IXML_Element *) tmpNode, "serviceType"); if (!tmpNodeList) { UpnpPrintf(UPNP_CRITICAL, API, __FILE__, __LINE__, "ServiceType not found \n"); continue; } tmpNode2 = ixmlNodeList_item(tmpNodeList, 0lu); if (!tmpNode2) continue; textNode = ixmlNode_getFirstChild(tmpNode2); if (!textNode) continue; /* servType is of format Servicetype:ServiceVersion */ tmpStr = ixmlNode_getNodeValue(textNode); if (!tmpStr) continue; strncpy(servType, tmpStr, sizeof(servType) - 1); UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "ServiceType = %s\n", servType); if (AdFlag) { if (AdFlag == 1) { ServiceAdvertisement(UDNstr, servType, SInfo->DescURL, Exp, SInfo->DeviceAf, SInfo->PowerState, SInfo->SleepPeriod, SInfo->RegistrationState); } else { /* AdFlag == -1 */ ServiceShutdown(UDNstr, servType, SInfo->DescURL, Exp, SInfo->DeviceAf, SInfo->PowerState, SInfo->SleepPeriod, SInfo->RegistrationState); } } else { switch (SearchType) { case SSDP_ALL: ServiceReply(DestAddr, servType, UDNstr, SInfo->DescURL, defaultExp, SInfo->PowerState, SInfo->SleepPeriod, SInfo->RegistrationState); break; case SSDP_SERVICE: if (ServiceType) { if (!strncasecmp(ServiceType, servType, strlen(ServiceType) - (size_t)2)) { if (atoi(strrchr(ServiceType, ':') + 1) < atoi(&servType[strlen(servType) - (size_t)1])) { /* the requested version is lower than the service version * must reply with the lower version number and the lower * description URL */ UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "ServiceType=%s and search servType=%s MATCH\n", ServiceType, servType); SendReply(DestAddr, ServiceType, 0, UDNstr, SInfo->LowerDescURL, defaultExp, 1, SInfo->PowerState, SInfo->SleepPeriod, SInfo->RegistrationState); } else if (atoi(strrchr (ServiceType, ':') + 1) == atoi(&servType[strlen(servType) - (size_t)1])) { UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "ServiceType=%s and search servType=%s MATCH\n", ServiceType, servType); SendReply(DestAddr, ServiceType, 0, UDNstr, SInfo->DescURL, defaultExp, 1, SInfo->PowerState, SInfo->SleepPeriod, SInfo->RegistrationState); } else { UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "ServiceType=%s and search servType=%s DID NOT MATCH\n", ServiceType, servType); } } else { UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "ServiceType=%s and search servType=%s DID NOT MATCH\n", ServiceType, servType); } } break; default: break; } } } ixmlNodeList_free(tmpNodeList); tmpNodeList = NULL; ixmlNodeList_free(nodeList); nodeList = NULL; } } end_function: ixmlNodeList_free(tmpNodeList); ixmlNodeList_free(nodeList); UpnpPrintf(UPNP_ALL, API, __FILE__, __LINE__, "Exiting AdvertiseAndReply.\n"); HandleUnlock(); return retVal; } #endif /* INCLUDE_DEVICE_APIS */ int unique_service_name(char *cmd, SsdpEvent *Evt) { char TempBuf[COMMAND_LEN]; char *TempPtr = NULL; char *Ptr = NULL; char *ptr1 = NULL; char *ptr2 = NULL; char *ptr3 = NULL; int CommandFound = 0; size_t n = (size_t)0; if (strstr(cmd, "uuid:schemas") != NULL) { ptr1 = strstr(cmd, ":device"); if (ptr1 != NULL) ptr2 = strstr(ptr1 + 1, ":"); else return -1; if (ptr2 != NULL) ptr3 = strstr(ptr2 + 1, ":"); else return -1; if (ptr3 != NULL) { if (strlen("uuid:") + strlen(ptr3 + 1) >= sizeof Evt->UDN) return -1; snprintf(Evt->UDN, sizeof Evt->UDN, "uuid:%s", ptr3 + 1); } else return -1; ptr1 = strstr(cmd, ":"); if (ptr1 != NULL) { n = (size_t)ptr3 - (size_t)ptr1; n = n >= sizeof TempBuf ? sizeof TempBuf - 1 : n; strncpy(TempBuf, ptr1, n); TempBuf[n] = '\0'; if (strlen("urn") + strlen(TempBuf) >= sizeof(Evt->DeviceType)) return -1; snprintf(Evt->DeviceType, sizeof(Evt->DeviceType), "urn%s", TempBuf); } else return -1; return 0; } if ((TempPtr = strstr(cmd, "uuid")) != NULL) { if ((Ptr = strstr(cmd, "::")) != NULL) { n = (size_t)Ptr - (size_t)TempPtr; n = n >= sizeof Evt->UDN ? sizeof Evt->UDN - 1 : n; strncpy(Evt->UDN, TempPtr, n); Evt->UDN[n] = '\0'; } else { memset(Evt->UDN, 0, sizeof(Evt->UDN)); strncpy(Evt->UDN, TempPtr, sizeof Evt->UDN - 1); } CommandFound = 1; } if (strstr(cmd, "urn:") != NULL && strstr(cmd, ":service:") != NULL) { if ((TempPtr = strstr(cmd, "urn")) != NULL) { memset(Evt->ServiceType, 0, sizeof Evt->ServiceType); strncpy(Evt->ServiceType, TempPtr, sizeof Evt->ServiceType - 1); CommandFound = 1; } } if (strstr(cmd, "urn:") != NULL && strstr(cmd, ":device:") != NULL) { if ((TempPtr = strstr(cmd, "urn")) != NULL) { memset(Evt->DeviceType, 0, sizeof Evt->DeviceType); strncpy(Evt->DeviceType, TempPtr, sizeof Evt->DeviceType - 1); CommandFound = 1; } } if ((TempPtr = strstr(cmd, "::upnp:rootdevice")) != NULL) { /* Everything before "::upnp::rootdevice" is the UDN. */ if (TempPtr != cmd) { n = (size_t)TempPtr - (size_t)cmd; n = n >= sizeof Evt->UDN ? sizeof Evt->UDN - 1 : n; strncpy(Evt->UDN, cmd, n); Evt->UDN[n] = 0; CommandFound = 1; } } if (CommandFound == 0) return -1; return 0; } enum SsdpSearchType ssdp_request_type1(char *cmd) { if (strstr(cmd, ":all")) return SSDP_ALL; if (strstr(cmd, ":rootdevice")) return SSDP_ROOTDEVICE; if (strstr(cmd, "uuid:")) return SSDP_DEVICEUDN; if (strstr(cmd, "urn:") && strstr(cmd, ":device:")) return SSDP_DEVICETYPE; if (strstr(cmd, "urn:") && strstr(cmd, ":service:")) return SSDP_SERVICE; return SSDP_SERROR; } int ssdp_request_type(char *cmd, SsdpEvent *Evt) { /* clear event */ memset(Evt, 0, sizeof(SsdpEvent)); unique_service_name(cmd, Evt); Evt->ErrCode = NO_ERROR_FOUND; if ((Evt->RequestType = ssdp_request_type1(cmd)) == SSDP_SERROR) { Evt->ErrCode = E_HTTP_SYNTEX; return -1; } return 0; } /*! * \brief Frees the ssdp request. */ static void free_ssdp_event_handler_data( /*! [in] ssdp_thread_data structure. This structure contains SSDP * request message. */ void *the_data) { ssdp_thread_data *data = (ssdp_thread_data *) the_data; if (data != NULL) { http_message_t *hmsg = &data->parser.msg; /* free data */ httpmsg_destroy(hmsg); free(data); } } /*! * \brief Does some quick checking of the ssdp msg. * * \return TRUE if msg is valid, else FALSE. */ static UPNP_INLINE int valid_ssdp_msg( /*! [in] ssdp_thread_data structure. This structure contains SSDP * request message. */ http_message_t * hmsg) { memptr hdr_value; /* check for valid methods - NOTIFY or M-SEARCH */ if (hmsg->method != (http_method_t)HTTPMETHOD_NOTIFY && hmsg->method != (http_method_t)HTTPMETHOD_MSEARCH && hmsg->request_method != (http_method_t)HTTPMETHOD_MSEARCH) { return FALSE; } if (hmsg->request_method != (http_method_t)HTTPMETHOD_MSEARCH) { /* check PATH == "*" */ if (hmsg->uri.type != (enum uriType)RELATIVE || strncmp("*", hmsg->uri.pathquery.buff, hmsg->uri.pathquery.size) != 0) { return FALSE; } /* check HOST header */ if (httpmsg_find_hdr(hmsg, HDR_HOST, &hdr_value) == NULL || (memptr_cmp(&hdr_value, "239.255.255.250:1900") != 0 && memptr_cmp(&hdr_value, "[FF02::C]:1900") != 0 && memptr_cmp(&hdr_value, "[ff02::c]:1900") != 0 && memptr_cmp(&hdr_value, "[FF05::C]:1900") != 0 && memptr_cmp(&hdr_value, "[ff05::c]:1900") != 0)) { UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, "Invalid HOST header from SSDP message\n"); return FALSE; } } /* passed quick check */ return TRUE; } /*! * \brief Parses the message and dispatches it to a handler which handles the * ssdp request msg. * * \return 0 if successful, -1 if error. */ static UPNP_INLINE int start_event_handler( /*! [in] ssdp_thread_data structure. This structure contains SSDP * request message. */ void *Data) { http_parser_t *parser = NULL; parse_status_t status; ssdp_thread_data *data = (ssdp_thread_data *) Data; parser = &data->parser; status = parser_parse(parser); if (status == (parse_status_t)PARSE_FAILURE) { if (parser->msg.method != (http_method_t)HTTPMETHOD_NOTIFY || !parser->valid_ssdp_notify_hack) { UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, "SSDP recvd bad msg code = %d\n", status); /* ignore bad msg, or not enuf mem */ goto error_handler; } /* valid notify msg */ } else if (status != (parse_status_t)PARSE_SUCCESS) { UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, "SSDP recvd bad msg code = %d\n", status); goto error_handler; } /* check msg */ if (valid_ssdp_msg(&parser->msg) != TRUE) { goto error_handler; } /* done; thread will free 'data' */ return 0; error_handler: free_ssdp_event_handler_data(data); return -1; } /*! * \brief This function is a thread that handles SSDP requests. */ static void ssdp_event_handler_thread( /*! [] ssdp_thread_data structure. This structure contains SSDP * request message. */ void *the_data) { ssdp_thread_data *data = (ssdp_thread_data *) the_data; http_message_t *hmsg = &data->parser.msg; if (start_event_handler(the_data) != 0) return; /* send msg to device or ctrlpt */ if (hmsg->method == (http_method_t)HTTPMETHOD_NOTIFY || hmsg->request_method == (http_method_t)HTTPMETHOD_MSEARCH) { #ifdef INCLUDE_CLIENT_APIS ssdp_handle_ctrlpt_msg(hmsg, &data->dest_addr, FALSE, NULL); #endif /* INCLUDE_CLIENT_APIS */ } else { ssdp_handle_device_request(hmsg, &data->dest_addr); } /* free data */ free_ssdp_event_handler_data(data); } void readFromSSDPSocket(SOCKET socket) { char *requestBuf = NULL; char staticBuf[BUFSIZE]; struct sockaddr_storage __ss; ThreadPoolJob job; ssdp_thread_data *data = NULL; socklen_t socklen = sizeof(__ss); ssize_t byteReceived = 0; char ntop_buf[INET6_ADDRSTRLEN]; memset(&job, 0, sizeof(job)); requestBuf = staticBuf; /* in case memory can't be allocated, still drain the socket using a * static buffer. */ data = malloc(sizeof(ssdp_thread_data)); if (data) { /* initialize parser */ #ifdef INCLUDE_CLIENT_APIS if (socket == gSsdpReqSocket4 #ifdef UPNP_ENABLE_IPV6 || socket == gSsdpReqSocket6 #endif /* UPNP_ENABLE_IPV6 */ ) parser_response_init(&data->parser, HTTPMETHOD_MSEARCH); else parser_request_init(&data->parser); #else /* INCLUDE_CLIENT_APIS */ parser_request_init(&data->parser); #endif /* INCLUDE_CLIENT_APIS */ /* set size of parser buffer */ if (membuffer_set_size(&data->parser.msg.msg, BUFSIZE) == 0) /* use this as the buffer for recv */ requestBuf = data->parser.msg.msg.buf; else { free(data); data = NULL; } } byteReceived = recvfrom(socket, requestBuf, BUFSIZE - (size_t)1, 0, (struct sockaddr *)&__ss, &socklen); if (byteReceived > 0) { requestBuf[byteReceived] = '\0'; switch (__ss.ss_family) { case AF_INET: inet_ntop(AF_INET, &((struct sockaddr_in *)&__ss)->sin_addr, ntop_buf, sizeof(ntop_buf)); break; #ifdef UPNP_ENABLE_IPV6 case AF_INET6: inet_ntop(AF_INET6, &((struct sockaddr_in6 *)&__ss)->sin6_addr, ntop_buf, sizeof(ntop_buf)); break; #endif /* UPNP_ENABLE_IPV6 */ default: memset(ntop_buf, 0, sizeof(ntop_buf)); strncpy(ntop_buf, "", sizeof(ntop_buf) - 1); } UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, "Start of received response ----------------------------------------------------\n" "%s\n" "End of received response ------------------------------------------------------\n" "From host %s\n", requestBuf, ntop_buf); /* add thread pool job to handle request */ if (data != NULL) { data->parser.msg.msg.length += (size_t) byteReceived; /* null-terminate */ data->parser.msg.msg.buf[byteReceived] = 0; memcpy(&data->dest_addr, &__ss, sizeof(__ss)); TPJobInit(&job, (start_routine) ssdp_event_handler_thread, data); TPJobSetFreeFunction(&job, free_ssdp_event_handler_data); TPJobSetPriority(&job, MED_PRIORITY); if (ThreadPoolAdd(&gRecvThreadPool, &job, NULL) != 0) free_ssdp_event_handler_data(data); } } else free_ssdp_event_handler_data(data); } /*! * \brief */ static int create_ssdp_sock_v4( /*! [] SSDP IPv4 socket to be created. */ SOCKET *ssdpSock) { char errorBuffer[ERROR_BUFFER_LEN]; int onOff; u_char ttl = (u_char)4; struct ip_mreq ssdpMcastAddr; struct sockaddr_storage __ss; struct sockaddr_in *ssdpAddr4 = (struct sockaddr_in *)&__ss; int ret = 0; struct in_addr addr; *ssdpSock = socket(AF_INET, SOCK_DGRAM, 0); if (*ssdpSock == INVALID_SOCKET) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in socket(): %s\n", errorBuffer); return UPNP_E_OUTOF_SOCKET; } onOff = 1; ret = setsockopt(*ssdpSock, SOL_SOCKET, SO_REUSEADDR, (char *)&onOff, sizeof(onOff)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in setsockopt() SO_REUSEADDR: %s\n", errorBuffer); ret = UPNP_E_SOCKET_ERROR; goto error_handler; } #if (defined(BSD) && !defined(__GNU__)) || defined(__OSX__) || defined(__APPLE__) onOff = 1; ret = setsockopt(*ssdpSock, SOL_SOCKET, SO_REUSEPORT, (char *)&onOff, sizeof(onOff)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in setsockopt() SO_REUSEPORT: %s\n", errorBuffer); ret = UPNP_E_SOCKET_ERROR; goto error_handler; } #endif /* BSD, __OSX__, __APPLE__ */ memset(&__ss, 0, sizeof(__ss)); ssdpAddr4->sin_family = (sa_family_t)AF_INET; ssdpAddr4->sin_addr.s_addr = htonl(INADDR_ANY); ssdpAddr4->sin_port = htons(SSDP_PORT); ret = bind(*ssdpSock, (struct sockaddr *)ssdpAddr4, sizeof(*ssdpAddr4)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in bind(), addr=0x%08X, port=%d: %s\n", INADDR_ANY, SSDP_PORT, errorBuffer); ret = UPNP_E_SOCKET_BIND; goto error_handler; } memset((void *)&ssdpMcastAddr, 0, sizeof(struct ip_mreq)); ssdpMcastAddr.imr_interface.s_addr = inet_addr(gIF_IPV4); ssdpMcastAddr.imr_multiaddr.s_addr = inet_addr(SSDP_IP); ret = setsockopt(*ssdpSock, IPPROTO_IP, IP_ADD_MEMBERSHIP, (char *)&ssdpMcastAddr, sizeof(struct ip_mreq)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in setsockopt() IP_ADD_MEMBERSHIP (join multicast group): %s\n", errorBuffer); ret = UPNP_E_SOCKET_ERROR; goto error_handler; } /* Set multicast interface. */ memset((void *)&addr, 0, sizeof(struct in_addr)); addr.s_addr = inet_addr(gIF_IPV4); ret = setsockopt(*ssdpSock, IPPROTO_IP, IP_MULTICAST_IF, (char *)&addr, sizeof addr); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_INFO, SSDP, __FILE__, __LINE__, "Error in setsockopt() IP_MULTICAST_IF (set multicast interface): %s\n", errorBuffer); /* This is probably not a critical error, so let's continue. */ } /* result is not checked becuase it will fail in WinMe and Win9x. */ setsockopt(*ssdpSock, IPPROTO_IP, IP_MULTICAST_TTL, &ttl, sizeof(ttl)); onOff = 1; ret = setsockopt(*ssdpSock, SOL_SOCKET, SO_BROADCAST, (char *)&onOff, sizeof(onOff)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in setsockopt() SO_BROADCAST (set broadcast): %s\n", errorBuffer); ret = UPNP_E_NETWORK_ERROR; goto error_handler; } ret = UPNP_E_SUCCESS; error_handler: if (ret != UPNP_E_SUCCESS) { UpnpCloseSocket(*ssdpSock); } return ret; } #ifdef INCLUDE_CLIENT_APIS /*! * \brief Creates the SSDP IPv4 socket to be used by the control point. * * \return UPNP_E_SUCCESS on successful socket creation. */ static int create_ssdp_sock_reqv4( /*! [out] SSDP IPv4 request socket to be created. */ SOCKET *ssdpReqSock) { char errorBuffer[ERROR_BUFFER_LEN]; u_char ttl = 4; *ssdpReqSock = socket(AF_INET, SOCK_DGRAM, 0); if (*ssdpReqSock == INVALID_SOCKET) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in socket(): %s\n", errorBuffer); return UPNP_E_OUTOF_SOCKET; } setsockopt(*ssdpReqSock, IPPROTO_IP, IP_MULTICAST_TTL, &ttl, sizeof(ttl)); /* just do it, regardless if fails or not. */ sock_make_no_blocking(*ssdpReqSock); return UPNP_E_SUCCESS; } #ifdef UPNP_ENABLE_IPV6 /*! * \brief This function ... */ static int create_ssdp_sock_v6( /* [] SSDP IPv6 socket to be created. */ SOCKET *ssdpSock) { char errorBuffer[ERROR_BUFFER_LEN]; struct ipv6_mreq ssdpMcastAddr; struct sockaddr_storage __ss; struct sockaddr_in6 *ssdpAddr6 = (struct sockaddr_in6 *)&__ss; int onOff; int ret = 0; *ssdpSock = socket(AF_INET6, SOCK_DGRAM, 0); if (*ssdpSock == INVALID_SOCKET) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in socket(): %s\n", errorBuffer); return UPNP_E_OUTOF_SOCKET; } onOff = 1; ret = setsockopt(*ssdpSock, SOL_SOCKET, SO_REUSEADDR, (char *)&onOff, sizeof(onOff)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in setsockopt() SO_REUSEADDR: %s\n", errorBuffer); ret = UPNP_E_SOCKET_ERROR; goto error_handler; } #if (defined(BSD) && !defined(__GNU__)) || defined(__OSX__) || defined(__APPLE__) onOff = 1; ret = setsockopt(*ssdpSock, SOL_SOCKET, SO_REUSEPORT, (char *)&onOff, sizeof(onOff)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in setsockopt() SO_REUSEPORT: %s\n", errorBuffer); ret = UPNP_E_SOCKET_ERROR; goto error_handler; } #endif /* BSD, __OSX__, __APPLE__ */ onOff = 1; ret = setsockopt(*ssdpSock, IPPROTO_IPV6, IPV6_V6ONLY, (char *)&onOff, sizeof(onOff)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in setsockopt() IPV6_V6ONLY: %s\n", errorBuffer); ret = UPNP_E_SOCKET_ERROR; goto error_handler; } memset(&__ss, 0, sizeof(__ss)); ssdpAddr6->sin6_family = (sa_family_t)AF_INET6; ssdpAddr6->sin6_addr = in6addr_any; ssdpAddr6->sin6_scope_id = gIF_INDEX; ssdpAddr6->sin6_port = htons(SSDP_PORT); ret = bind(*ssdpSock, (struct sockaddr *)ssdpAddr6, sizeof(*ssdpAddr6)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in bind(), addr=0x%032lX, port=%d: %s\n", 0lu, SSDP_PORT, errorBuffer); ret = UPNP_E_SOCKET_BIND; goto error_handler; } memset((void *)&ssdpMcastAddr, 0, sizeof(ssdpMcastAddr)); ssdpMcastAddr.ipv6mr_interface = gIF_INDEX; inet_pton(AF_INET6, SSDP_IPV6_LINKLOCAL, &ssdpMcastAddr.ipv6mr_multiaddr); ret = setsockopt(*ssdpSock, IPPROTO_IPV6, IPV6_JOIN_GROUP, (char *)&ssdpMcastAddr, sizeof(ssdpMcastAddr)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in setsockopt() IPV6_JOIN_GROUP (join multicast group): %s\n", errorBuffer); ret = UPNP_E_SOCKET_ERROR; goto error_handler; } onOff = 1; ret = setsockopt(*ssdpSock, SOL_SOCKET, SO_BROADCAST, (char *)&onOff, sizeof(onOff)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in setsockopt() SO_BROADCAST (set broadcast): %s\n", errorBuffer); ret = UPNP_E_NETWORK_ERROR; goto error_handler; } ret = UPNP_E_SUCCESS; error_handler: if (ret != UPNP_E_SUCCESS) { UpnpCloseSocket(*ssdpSock); } return ret; } #endif /* IPv6 */ #ifdef UPNP_ENABLE_IPV6 /*! * \brief This function ... */ static int create_ssdp_sock_v6_ula_gua( /*! [] SSDP IPv6 socket to be created. */ SOCKET * ssdpSock) { char errorBuffer[ERROR_BUFFER_LEN]; struct ipv6_mreq ssdpMcastAddr; struct sockaddr_storage __ss; struct sockaddr_in6 *ssdpAddr6 = (struct sockaddr_in6 *)&__ss; int onOff; int ret = 0; *ssdpSock = socket(AF_INET6, SOCK_DGRAM, 0); if (*ssdpSock == INVALID_SOCKET) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in socket(): %s\n", errorBuffer); return UPNP_E_OUTOF_SOCKET; } onOff = 1; ret = setsockopt(*ssdpSock, SOL_SOCKET, SO_REUSEADDR, (char *)&onOff, sizeof(onOff)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in setsockopt() SO_REUSEADDR: %s\n", errorBuffer); ret = UPNP_E_SOCKET_ERROR; goto error_handler; } #if (defined(BSD) && !defined(__GNU__)) || defined(__OSX__) || defined(__APPLE__) onOff = 1; ret = setsockopt(*ssdpSock, SOL_SOCKET, SO_REUSEPORT, (char *)&onOff, sizeof(onOff)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in setsockopt() SO_REUSEPORT: %s\n", errorBuffer); ret = UPNP_E_SOCKET_ERROR; goto error_handler; } #endif /* BSD, __OSX__, __APPLE__ */ onOff = 1; ret = setsockopt(*ssdpSock, IPPROTO_IPV6, IPV6_V6ONLY, (char *)&onOff, sizeof(onOff)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in setsockopt() IPV6_V6ONLY: %s\n", errorBuffer); ret = UPNP_E_SOCKET_ERROR; goto error_handler; } memset(&__ss, 0, sizeof(__ss)); ssdpAddr6->sin6_family = (sa_family_t)AF_INET6; ssdpAddr6->sin6_addr = in6addr_any; ssdpAddr6->sin6_scope_id = gIF_INDEX; ssdpAddr6->sin6_port = htons(SSDP_PORT); ret = bind(*ssdpSock, (struct sockaddr *)ssdpAddr6, sizeof(*ssdpAddr6)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in bind(), addr=0x%032lX, port=%d: %s\n", 0lu, SSDP_PORT, errorBuffer); ret = UPNP_E_SOCKET_BIND; goto error_handler; } memset((void *)&ssdpMcastAddr, 0, sizeof(ssdpMcastAddr)); ssdpMcastAddr.ipv6mr_interface = gIF_INDEX; /* SITE LOCAL */ inet_pton(AF_INET6, SSDP_IPV6_SITELOCAL, &ssdpMcastAddr.ipv6mr_multiaddr); ret = setsockopt(*ssdpSock, IPPROTO_IPV6, IPV6_JOIN_GROUP, (char *)&ssdpMcastAddr, sizeof(ssdpMcastAddr)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in setsockopt() IPV6_JOIN_GROUP (join multicast group): %s\n", errorBuffer); ret = UPNP_E_SOCKET_ERROR; goto error_handler; } onOff = 1; ret = setsockopt(*ssdpSock, SOL_SOCKET, SO_BROADCAST, (char *)&onOff, sizeof(onOff)); if (ret == -1) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in setsockopt() SO_BROADCAST (set broadcast): %s\n", errorBuffer); ret = UPNP_E_NETWORK_ERROR; goto error_handler; } ret = UPNP_E_SUCCESS; error_handler: if (ret != UPNP_E_SUCCESS) { UpnpCloseSocket(*ssdpSock); } return ret; } #endif /* IPv6 */ /*! * \brief Creates the SSDP IPv6 socket to be used by the control point. */ #ifdef UPNP_ENABLE_IPV6 static int create_ssdp_sock_reqv6( /* [out] SSDP IPv6 request socket to be created. */ SOCKET *ssdpReqSock) { char errorBuffer[ERROR_BUFFER_LEN]; char hops = 1; *ssdpReqSock = socket(AF_INET6, SOCK_DGRAM, 0); if (*ssdpReqSock == INVALID_SOCKET) { strerror_r(errno, errorBuffer, ERROR_BUFFER_LEN); UpnpPrintf(UPNP_CRITICAL, SSDP, __FILE__, __LINE__, "Error in socket(): %s\n", errorBuffer); return UPNP_E_OUTOF_SOCKET; } /* MUST use scoping of IPv6 addresses to control the propagation os SSDP * messages instead of relying on the Hop Limit (Equivalent to the TTL * limit in IPv4). */ setsockopt(*ssdpReqSock, IPPROTO_IPV6, IPV6_MULTICAST_HOPS, &hops, sizeof(hops)); /* just do it, regardless if fails or not. */ sock_make_no_blocking(*ssdpReqSock); return UPNP_E_SUCCESS; } #endif /* IPv6 */ #endif /* INCLUDE_CLIENT_APIS */ int get_ssdp_sockets(MiniServerSockArray * out) { int retVal; #ifdef INCLUDE_CLIENT_APIS out->ssdpReqSock4 = INVALID_SOCKET; out->ssdpReqSock6 = INVALID_SOCKET; /* Create the IPv4 socket for SSDP REQUESTS */ if (strlen(gIF_IPV4) > (size_t)0) { retVal = create_ssdp_sock_reqv4(&out->ssdpReqSock4); if (retVal != UPNP_E_SUCCESS) return retVal; /* For use by ssdp control point. */ gSsdpReqSocket4 = out->ssdpReqSock4; } else out->ssdpReqSock4 = INVALID_SOCKET; /* Create the IPv6 socket for SSDP REQUESTS */ #ifdef UPNP_ENABLE_IPV6 if (strlen(gIF_IPV6) > (size_t)0) { retVal = create_ssdp_sock_reqv6(&out->ssdpReqSock6); if (retVal != UPNP_E_SUCCESS) { UpnpCloseSocket(out->ssdpReqSock4); return retVal; } /* For use by ssdp control point. */ gSsdpReqSocket6 = out->ssdpReqSock6; } else out->ssdpReqSock6 = INVALID_SOCKET; #endif /* IPv6 */ #endif /* INCLUDE_CLIENT_APIS */ /* Create the IPv4 socket for SSDP */ if (strlen(gIF_IPV4) > (size_t)0) { retVal = create_ssdp_sock_v4(&out->ssdpSock4); if (retVal != UPNP_E_SUCCESS) { #ifdef INCLUDE_CLIENT_APIS UpnpCloseSocket(out->ssdpReqSock4); UpnpCloseSocket(out->ssdpReqSock6); #endif /* INCLUDE_CLIENT_APIS */ return retVal; } } else out->ssdpSock4 = INVALID_SOCKET; /* Create the IPv6 socket for SSDP */ #ifdef UPNP_ENABLE_IPV6 if (strlen(gIF_IPV6) > (size_t)0) { retVal = create_ssdp_sock_v6(&out->ssdpSock6); if (retVal != UPNP_E_SUCCESS) { UpnpCloseSocket(out->ssdpSock4); #ifdef INCLUDE_CLIENT_APIS UpnpCloseSocket(out->ssdpReqSock4); UpnpCloseSocket(out->ssdpReqSock6); #endif /* INCLUDE_CLIENT_APIS */ return retVal; } } else out->ssdpSock6 = INVALID_SOCKET; if (strlen(gIF_IPV6_ULA_GUA) > (size_t)0) { retVal = create_ssdp_sock_v6_ula_gua(&out->ssdpSock6UlaGua); if (retVal != UPNP_E_SUCCESS) { UpnpCloseSocket(out->ssdpSock4); UpnpCloseSocket(out->ssdpSock6); #ifdef INCLUDE_CLIENT_APIS UpnpCloseSocket(out->ssdpReqSock4); UpnpCloseSocket(out->ssdpReqSock6); #endif /* INCLUDE_CLIENT_APIS */ return retVal; } } else out->ssdpSock6UlaGua = INVALID_SOCKET; #endif /* UPNP_ENABLE_IPV6 */ return UPNP_E_SUCCESS; } #endif /* EXCLUDE_SSDP */ /* @} SSDPlib */ pupnp-release-1.8.0/upnp/src/urlconfig/000077500000000000000000000000001303304015100200275ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/urlconfig/urlconfig.c000066400000000000000000000330541303304015100221700ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 2000-2003 Intel Corporation * All rights reserved. * Copyright (c) 2012 France Telecom All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * - Neither name of Intel Corporation nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * **************************************************************************/ /*! * \file */ #include "config.h" #include "membuffer.h" #include "unixutil.h" #include "upnp.h" #include "upnpdebug.h" #include "UpnpInet.h" #include "uri.h" #include "urlconfig.h" #include "upnputil.h" #include "webserver.h" #include #include #ifdef WIN32 #define snprintf _snprintf #else #include #endif #ifdef INCLUDE_DEVICE_APIS #ifdef INTERNAL_WEB_SERVER /************************************************************************ * Function : addrToString * * Parameters : * IN const struct sockaddr* addr ; socket address object with * the IP Address and port information * OUT char ipaddr_port ; character array which will hold the * IP Address in a string format. * IN size_t ipaddr_port_size ; ipaddr_port buffer size * * Description : Converts an Internet address to a string and stores it * a buffer. * * Return : int ; * UPNP_E_SUCCESS - On Success. * UPNP_E_BUFFER_TOO_SMALL - Given buffer doesn't have enough size. * * Note : ************************************************************************/ static UPNP_INLINE int addrToString( IN const struct sockaddr *addr, OUT char *ipaddr_port, IN size_t ipaddr_port_size ) { char buf_ntop[INET6_ADDRSTRLEN]; int rc = 0; if( addr->sa_family == AF_INET ) { struct sockaddr_in* sa4 = (struct sockaddr_in*)addr; inet_ntop(AF_INET, &sa4->sin_addr, buf_ntop, sizeof(buf_ntop) ); rc = snprintf( ipaddr_port, ipaddr_port_size, "%s:%d", buf_ntop, (int)ntohs( sa4->sin_port ) ); } else if( addr->sa_family == AF_INET6 ) { struct sockaddr_in6* sa6 = (struct sockaddr_in6*)addr; inet_ntop(AF_INET6, &sa6->sin6_addr, buf_ntop, sizeof(buf_ntop) ); rc = snprintf( ipaddr_port, ipaddr_port_size, "[%s]:%d", buf_ntop, (int)ntohs( sa6->sin6_port ) ); } if (rc < 0 || (unsigned int) rc >= ipaddr_port_size) return UPNP_E_BUFFER_TOO_SMALL; return UPNP_E_SUCCESS; } /************************************************************************ * Function : calc_alias * * Parameters : * IN const char* alias ; String containing the alias * IN const char* rootPath ; String containing the root path * OUT char** newAlias ; String pointer to hold the modified new * alias * * Description : Determine alias based urlbase's root path. * * Return : int ; * UPNP_E_SUCCESS - On Success. * UPNP_E_OUTOF_MEMORY - On Failure to allocate memory for new alias * * Note : 'newAlias' should be freed using free() ************************************************************************/ static UPNP_INLINE int calc_alias( IN const char *alias, IN const char *rootPath, OUT char **newAlias) { const char *aliasPtr; size_t root_len; const char *temp_str; size_t new_alias_len; char *alias_temp; assert(rootPath); assert(alias); /* add / suffix, if missing */ root_len = strlen(rootPath); if (root_len == 0 || rootPath[root_len - 1] != '/') temp_str = "/"; else temp_str = ""; /* suffix already present */ /* discard / prefix, if present */ if (alias[0] == '/') aliasPtr = alias + 1; else aliasPtr = alias; new_alias_len = root_len + strlen(temp_str) + strlen(aliasPtr) + (size_t)1; alias_temp = malloc(new_alias_len); if (alias_temp == NULL) return UPNP_E_OUTOF_MEMORY; memset(alias_temp, 0, new_alias_len); snprintf(alias_temp, new_alias_len, "%s%s%s", rootPath, temp_str, aliasPtr); *newAlias = alias_temp; return UPNP_E_SUCCESS; } /************************************************************************ * Function : calc_descURL * * Parameters : * IN const char* ipPortStr ; String containing the port number * IN const char* alias ; String containing the alias * OUT char descURL[LINE_SIZE] ; buffer to hold the calculated * description URL * * Description : Determines the description URL * * Return : int ; * UPNP_E_SUCCESS - On Success * UPNP_E_URL_TOO_BIG - length of the URL is determined to be to * exceeding the limit. * * Note : ************************************************************************/ static UPNP_INLINE int calc_descURL( IN const char *ipPortStr, IN const char *alias, OUT char descURL[LINE_SIZE]) { size_t len; const char *http_scheme = "http://"; assert(ipPortStr != NULL && strlen(ipPortStr) > 0); assert(alias != NULL && strlen(alias) > 0); len = strlen(http_scheme) + strlen(ipPortStr) + strlen(alias) + (size_t)1; if (len > (size_t)LINE_SIZE) return UPNP_E_URL_TOO_BIG; snprintf(descURL, len, "%s%s%s", http_scheme, ipPortStr, alias); UpnpPrintf(UPNP_INFO, API, __FILE__, __LINE__, "desc url: %s\n", descURL); return UPNP_E_SUCCESS; } /************************************************************************ * Function : config_description_doc * * Parameters : * INOUT IXML_Document *doc ;IMXL description document to be * configured * IN const char* ip_str ; string containing the IP port number * OUT char** root_path_str ; buffer to hold the root path * of the configured description document * INOUT IXML_Document *doc : Description document * IN const char* ip_str : ipaddress string * OUT char** root_path_str : root path string * * Description : Configure the description document. Add the standard * format and then add information from the root device and any * child nodes. * * Return : int ; * UPNP_E_SUCCESS - On Success * UPNP_E_OUTOF_MEMORY - Default Error * UPNP_E_INVALID_DESC - Invalid child node * UPNP_E_INVALID_URL - Invalid node information * * Note : ************************************************************************/ static int config_description_doc( INOUT IXML_Document *doc, IN const char *ip_str, OUT char **root_path_str ) { IXML_NodeList *baseList; IXML_Element *element = NULL; IXML_Node *textNode = NULL; IXML_Node *rootNode = NULL; IXML_Node *urlbase_node = NULL; const char *urlBaseStr = "URLBase"; const DOMString domStr = NULL; uri_type uri; int err_code; int len; membuffer url_str; membuffer root_path; membuffer_init(&url_str); membuffer_init(&root_path); err_code = UPNP_E_OUTOF_MEMORY; /* default error */ baseList = ixmlDocument_getElementsByTagName(doc, urlBaseStr); if (baseList == NULL) { /* urlbase not found -- create new one */ element = ixmlDocument_createElement(doc, urlBaseStr); if (element == NULL) { goto error_handler; } if (membuffer_append_str(&url_str, "http://") != 0 || membuffer_append_str(&url_str, ip_str) != 0 || membuffer_append_str(&url_str, "/") != 0 || membuffer_append_str(&root_path, "/") != 0) { goto error_handler; } rootNode = ixmlNode_getFirstChild((IXML_Node *) doc); if (rootNode == NULL) { err_code = UPNP_E_INVALID_DESC; goto error_handler; } err_code = ixmlNode_appendChild(rootNode, (IXML_Node *) element); if (err_code != IXML_SUCCESS) { err_code = UPNP_E_INVALID_DESC; goto error_handler; } textNode = ixmlDocument_createTextNode(doc, (char *)url_str.buf); if (textNode == NULL) { goto error_handler; } err_code = ixmlNode_appendChild((IXML_Node *) element, textNode); if (err_code != IXML_SUCCESS) { err_code = UPNP_E_INTERNAL_ERROR; goto error_handler; } } else { /* urlbase found */ urlbase_node = ixmlNodeList_item(baseList, 0lu); assert(urlbase_node != NULL); textNode = ixmlNode_getFirstChild(urlbase_node); if (textNode == NULL) { err_code = UPNP_E_INVALID_DESC; goto error_handler; } domStr = ixmlNode_getNodeValue(textNode); if (domStr == NULL) { err_code = UPNP_E_INVALID_URL; goto error_handler; } len = parse_uri(domStr, strlen(domStr), &uri); if (len < 0 || uri.type != ABSOLUTE) { err_code = UPNP_E_INVALID_URL; goto error_handler; } if (membuffer_assign(&url_str, uri.scheme.buff, uri.scheme.size) != 0 || membuffer_append_str(&url_str, "://") != 0 || membuffer_append_str(&url_str, ip_str) != 0) { goto error_handler; } /* add leading '/' if missing from relative path */ if ((uri.pathquery.size > 0 && uri.pathquery.buff[0] != '/') || (uri.pathquery.size == 0) ) { if (membuffer_append_str(&url_str, "/") != 0 || membuffer_append_str(&root_path, "/") != 0) { goto error_handler; } } if (membuffer_append(&url_str, uri.pathquery.buff, uri.pathquery.size) != 0 || membuffer_append(&root_path, uri.pathquery.buff, uri.pathquery.size) != 0) { goto error_handler; } /* add trailing '/' if missing */ if (url_str.buf[url_str.length - 1] != '/') { if (membuffer_append(&url_str, "/", (size_t)1) != 0) { goto error_handler; } } err_code = ixmlNode_setNodeValue(textNode, url_str.buf); if (err_code != IXML_SUCCESS) { err_code = UPNP_E_OUTOF_MEMORY; goto error_handler; } } *root_path_str = membuffer_detach(&root_path); /* return path */ err_code = UPNP_E_SUCCESS; error_handler: if (err_code != UPNP_E_SUCCESS) { ixmlElement_free(element); } ixmlNodeList_free(baseList); membuffer_destroy(&root_path); membuffer_destroy(&url_str); return err_code; } /************************************************************************ * Function : configure_urlbase * * Parameters : * INOUT IXML_Document *doc ; IXML Description document * IN const struct sockaddr* serverAddr ; socket address object * providing the IP address and port information * IN const char* alias ; string containing the alias * IN time_t last_modified ; time when the XML document was * downloaded * OUT char docURL[LINE_SIZE] ; buffer to hold the URL of the * document. * INOUT IXML_Document *doc:dom document whose urlbase is to be modified * IN const struct sockaddr* serverAddr : ip address and port of * the miniserver * IN const char* alias : a name to be used for the temp; e.g.:"foo.xml" * IN time_t last_modified : time * OUT char docURL[LINE_SIZE] : document URL * * Description : Configure the full URL for the description document. * Create the URL document and add alias, description information. * The doc is added to the web server to be served using the given * alias. * * Return : int ; * UPNP_E_SUCCESS - On Success * UPNP_E_OUTOF_MEMORY - Default Error * * Note : ************************************************************************/ int configure_urlbase( INOUT IXML_Document * doc, IN const struct sockaddr *serverAddr, IN const char *alias, IN time_t last_modified, OUT char docURL[LINE_SIZE] ) { char *root_path = NULL; char *new_alias = NULL; char *xml_str = NULL; int err_code; char ipaddr_port[LINE_SIZE]; /* get IP address and port */ err_code = addrToString( serverAddr, ipaddr_port, sizeof(ipaddr_port) ); if ( err_code != UPNP_E_SUCCESS ) { goto error_handler; } /* config url-base in 'doc' */ err_code = config_description_doc( doc, ipaddr_port, &root_path ); if( err_code != UPNP_E_SUCCESS ) { goto error_handler; } /* calc alias */ err_code = calc_alias( alias, root_path, &new_alias ); if( err_code != UPNP_E_SUCCESS ) { goto error_handler; } /* calc full url for desc doc */ err_code = calc_descURL( ipaddr_port, new_alias, docURL ); if( err_code != UPNP_E_SUCCESS ) { goto error_handler; } /* xml doc to str */ xml_str = ixmlPrintDocument( doc ); if( xml_str == NULL ) { goto error_handler; } UpnpPrintf( UPNP_INFO, API, __FILE__, __LINE__, "desc url: %s\n", docURL ); UpnpPrintf( UPNP_INFO, API, __FILE__, __LINE__, "doc = %s\n", xml_str ); /* store in web server */ err_code = web_server_set_alias( new_alias, xml_str, strlen( xml_str ), last_modified ); error_handler: free( root_path ); free( new_alias ); if( err_code != UPNP_E_SUCCESS ) { ixmlFreeDOMString( xml_str ); } return err_code; } #endif /* INCLUDE_DEVICE_APIS */ #endif /* INTERNAL_WEB_SERVER */ pupnp-release-1.8.0/upnp/src/uuid/000077500000000000000000000000001303304015100170055ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/src/uuid/md5.c000066400000000000000000000247121303304015100176440ustar00rootroot00000000000000/* MD5C.C - RSA Data Security, Inc., MD5 message-digest algorithm */ /* Copyright (C) 1991-2, RSA Data Security, Inc. Created 1991. All rights reserved. License to copy and use this software is granted provided that it is identified as the "RSA Data Security, Inc. MD5 Message-Digest Algorithm" in all material mentioning or referencing this software or this function. License is also granted to make and use derivative works provided that such works are identified as "derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm" in all material mentioning or referencing the derived work. RSA Data Security, Inc. makes no representations concerning either the merchantability of this software or the suitability of this software for any particular purpose. It is provided "as is" without express or implied warranty of any kind. These notices must be retained in any copies of any part of this documentation and/or software. */ #include "config.h" #include "global.h" #include "md5.h" /* Constants for MD5Transform routine. */ #define S11 7 #define S12 12 #define S13 17 #define S14 22 #define S21 5 #define S22 9 #define S23 14 #define S24 20 #define S31 4 #define S32 11 #define S33 16 #define S34 23 #define S41 6 #define S42 10 #define S43 15 #define S44 21 static void MD5Transform PROTO_LIST((UINT4[4], unsigned char[64])); static void Encode PROTO_LIST((unsigned char *, UINT4 *, unsigned int)); static void Decode PROTO_LIST((UINT4 *, unsigned char *, unsigned int)); static void MD5_memcpy PROTO_LIST((POINTER, POINTER, unsigned int)); static void MD5_memset PROTO_LIST((POINTER, int, unsigned int)); static unsigned char PADDING[64] = { 0x80, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 }; /* F, G, H and I are basic MD5 functions. */ #define F(x, y, z) (((x) & (y)) | ((~x) & (z))) #define G(x, y, z) (((x) & (z)) | ((y) & (~z))) #define H(x, y, z) ((x) ^ (y) ^ (z)) #define I(x, y, z) ((y) ^ ((x) | (~z))) /* ROTATE_LEFT rotates x left n bits. */ #define ROTATE_LEFT(x, n) (((x) <<(n)) | ((x) >> (32-(n)))) /* FF, GG, HH, and II transformations for rounds 1, 2, 3, and 4. Rotation is separate from addition to prevent recomputation. */ #define FF(a, b, c, d, x, s, ac) { \ (a) += F ((b), (c), (d)) + (x) + (UINT4)(ac); \ (a) = ROTATE_LEFT ((a), (s)); \ (a) += (b); \ } #define GG(a, b, c, d, x, s, ac) { \ (a) += G ((b), (c), (d)) + (x) + (UINT4)(ac); \ (a) = ROTATE_LEFT ((a), (s)); \ (a) += (b); \ } #define HH(a, b, c, d, x, s, ac) { \ (a) += H ((b), (c), (d)) + (x) + (UINT4)(ac); \ (a) = ROTATE_LEFT ((a), (s)); \ (a) += (b); \ } #define II(a, b, c, d, x, s, ac) { \ (a) += I ((b), (c), (d)) + (x) + (UINT4)(ac); \ (a) = ROTATE_LEFT ((a), (s)); \ (a) += (b); \ } /* MD5 initialization. Begins an MD5 operation, writing a new context. */ void MD5Init(MD5_CTX * context) { context->count[0] = context->count[1] = 0; /* Load magic initialization constants. */ context->state[0] = 0x67452301; context->state[1] = 0xefcdab89; context->state[2] = 0x98badcfe; context->state[3] = 0x10325476; } /* MD5 block update operation. Continues an MD5 message-digest operation, processing another message block, and updating the context. */ void MD5Update(MD5_CTX *context, unsigned char *input, unsigned int inputLen) { unsigned int i; unsigned int index; unsigned int partLen; /* Compute number of bytes mod 64 */ index = (unsigned int)((context->count[0] >> 3) & 0x3F); /* Update number of bits */ if ((context->count[0] += ((UINT4)inputLen << 3)) < ((UINT4)inputLen << 3)) { context->count[1]++; } context->count[1] += ((UINT4)inputLen >> 29); partLen = 64 - index; /* Transform as many times as possible. */ if (inputLen >= partLen) { MD5_memcpy((POINTER)&context->buffer[index], (POINTER)input, partLen); MD5Transform(context->state, context->buffer); for (i = partLen; i + 63 < inputLen; i += 64) { MD5Transform(context->state, &input[i]); } index = 0; } else { i = 0; } /* Buffer remaining input */ MD5_memcpy((POINTER)&context->buffer[index], (POINTER)&input[i], inputLen - i); } /* MD5 finalization. Ends an MD5 message-digest operation, writing the the message digest and zeroizing the context. */ void MD5Final(unsigned char digest[16], MD5_CTX *context) { unsigned char bits[8]; unsigned int index; unsigned int padLen; /* Save number of bits */ Encode(bits, context->count, 8); /* Pad out to 56 mod 64. */ index = (unsigned int)((context->count[0] >> 3) & 0x3f); padLen = (index < 56) ? (56 - index) : (120 - index); MD5Update(context, PADDING, padLen); /* Append length (before padding) */ MD5Update(context, bits, 8); /* Store state in digest */ Encode(digest, context->state, 16); /* Zeroize sensitive information. */ MD5_memset((POINTER)context, 0, sizeof(*context)); } /* MD5 basic transformation. Transforms state based on block. */ static void MD5Transform(UINT4 state[4], unsigned char block[64]) { UINT4 a = state[0], b = state[1], c = state[2], d = state[3], x[16]; Decode( x, block, 64 ); /* Round 1 */ FF( a, b, c, d, x[0], S11, 0xd76aa478 ); /* 1 */ FF( d, a, b, c, x[1], S12, 0xe8c7b756 ); /* 2 */ FF( c, d, a, b, x[2], S13, 0x242070db ); /* 3 */ FF( b, c, d, a, x[3], S14, 0xc1bdceee ); /* 4 */ FF( a, b, c, d, x[4], S11, 0xf57c0faf ); /* 5 */ FF( d, a, b, c, x[5], S12, 0x4787c62a ); /* 6 */ FF( c, d, a, b, x[6], S13, 0xa8304613 ); /* 7 */ FF( b, c, d, a, x[7], S14, 0xfd469501 ); /* 8 */ FF( a, b, c, d, x[8], S11, 0x698098d8 ); /* 9 */ FF( d, a, b, c, x[9], S12, 0x8b44f7af ); /* 10 */ FF( c, d, a, b, x[10], S13, 0xffff5bb1 ); /* 11 */ FF( b, c, d, a, x[11], S14, 0x895cd7be ); /* 12 */ FF( a, b, c, d, x[12], S11, 0x6b901122 ); /* 13 */ FF( d, a, b, c, x[13], S12, 0xfd987193 ); /* 14 */ FF( c, d, a, b, x[14], S13, 0xa679438e ); /* 15 */ FF( b, c, d, a, x[15], S14, 0x49b40821 ); /* 16 */ /* Round 2 */ GG( a, b, c, d, x[1], S21, 0xf61e2562 ); /* 17 */ GG( d, a, b, c, x[6], S22, 0xc040b340 ); /* 18 */ GG( c, d, a, b, x[11], S23, 0x265e5a51 ); /* 19 */ GG( b, c, d, a, x[0], S24, 0xe9b6c7aa ); /* 20 */ GG( a, b, c, d, x[5], S21, 0xd62f105d ); /* 21 */ GG( d, a, b, c, x[10], S22, 0x2441453 ); /* 22 */ GG( c, d, a, b, x[15], S23, 0xd8a1e681 ); /* 23 */ GG( b, c, d, a, x[4], S24, 0xe7d3fbc8 ); /* 24 */ GG( a, b, c, d, x[9], S21, 0x21e1cde6 ); /* 25 */ GG( d, a, b, c, x[14], S22, 0xc33707d6 ); /* 26 */ GG( c, d, a, b, x[3], S23, 0xf4d50d87 ); /* 27 */ GG( b, c, d, a, x[8], S24, 0x455a14ed ); /* 28 */ GG( a, b, c, d, x[13], S21, 0xa9e3e905 ); /* 29 */ GG( d, a, b, c, x[2], S22, 0xfcefa3f8 ); /* 30 */ GG( c, d, a, b, x[7], S23, 0x676f02d9 ); /* 31 */ GG( b, c, d, a, x[12], S24, 0x8d2a4c8a ); /* 32 */ /* Round 3 */ HH( a, b, c, d, x[5], S31, 0xfffa3942 ); /* 33 */ HH( d, a, b, c, x[8], S32, 0x8771f681 ); /* 34 */ HH( c, d, a, b, x[11], S33, 0x6d9d6122 ); /* 35 */ HH( b, c, d, a, x[14], S34, 0xfde5380c ); /* 36 */ HH( a, b, c, d, x[1], S31, 0xa4beea44 ); /* 37 */ HH( d, a, b, c, x[4], S32, 0x4bdecfa9 ); /* 38 */ HH( c, d, a, b, x[7], S33, 0xf6bb4b60 ); /* 39 */ HH( b, c, d, a, x[10], S34, 0xbebfbc70 ); /* 40 */ HH( a, b, c, d, x[13], S31, 0x289b7ec6 ); /* 41 */ HH( d, a, b, c, x[0], S32, 0xeaa127fa ); /* 42 */ HH( c, d, a, b, x[3], S33, 0xd4ef3085 ); /* 43 */ HH( b, c, d, a, x[6], S34, 0x4881d05 ); /* 44 */ HH( a, b, c, d, x[9], S31, 0xd9d4d039 ); /* 45 */ HH( d, a, b, c, x[12], S32, 0xe6db99e5 ); /* 46 */ HH( c, d, a, b, x[15], S33, 0x1fa27cf8 ); /* 47 */ HH( b, c, d, a, x[2], S34, 0xc4ac5665 ); /* 48 */ /* Round 4 */ II( a, b, c, d, x[0], S41, 0xf4292244 ); /* 49 */ II( d, a, b, c, x[7], S42, 0x432aff97 ); /* 50 */ II( c, d, a, b, x[14], S43, 0xab9423a7 ); /* 51 */ II( b, c, d, a, x[5], S44, 0xfc93a039 ); /* 52 */ II( a, b, c, d, x[12], S41, 0x655b59c3 ); /* 53 */ II( d, a, b, c, x[3], S42, 0x8f0ccc92 ); /* 54 */ II( c, d, a, b, x[10], S43, 0xffeff47d ); /* 55 */ II( b, c, d, a, x[1], S44, 0x85845dd1 ); /* 56 */ II( a, b, c, d, x[8], S41, 0x6fa87e4f ); /* 57 */ II( d, a, b, c, x[15], S42, 0xfe2ce6e0 ); /* 58 */ II( c, d, a, b, x[6], S43, 0xa3014314 ); /* 59 */ II( b, c, d, a, x[13], S44, 0x4e0811a1 ); /* 60 */ II( a, b, c, d, x[4], S41, 0xf7537e82 ); /* 61 */ II( d, a, b, c, x[11], S42, 0xbd3af235 ); /* 62 */ II( c, d, a, b, x[2], S43, 0x2ad7d2bb ); /* 63 */ II( b, c, d, a, x[9], S44, 0xeb86d391 ); /* 64 */ state[0] += a; state[1] += b; state[2] += c; state[3] += d; /* Zeroize sensitive information. */ MD5_memset( ( POINTER ) x, 0, sizeof( x ) ); } /* Encodes input (UINT4) into output (unsigned char). Assumes len is a multiple of 4. */ static void Encode(unsigned char *output, UINT4 *input, unsigned int len) { unsigned int i; unsigned int j; for (i = 0, j = 0; j < len; ++i, j += 4) { output[j+0] = (unsigned char)((input[i] >> 0) & 0xff); output[j+1] = (unsigned char)((input[i] >> 8) & 0xff); output[j+2] = (unsigned char)((input[i] >> 16) & 0xff); output[j+3] = (unsigned char)((input[i] >> 24) & 0xff); } } /* Decodes input (unsigned char) into output (UINT4). Assumes len is a multiple of 4. */ static void Decode(UINT4 *output, unsigned char *input, unsigned int len) { unsigned int i; unsigned int j; for (i = 0, j = 0; j < len; ++i, j += 4) { output[i] = (((UINT4)input[j+0]) << 0) | (((UINT4)input[j+1]) << 8) | (((UINT4)input[j+2]) << 16) | (((UINT4)input[j+3]) << 24); } } /* Note: Replace for loop with standard memcpy if possible. */ static void MD5_memcpy(POINTER output, POINTER input, unsigned int len) { unsigned int i; for (i = 0; i < len; ++i) { output[i] = input[i]; } } /* Note: Replace for loop with standard memset if possible. */ static void MD5_memset(POINTER output, int value, unsigned int len) { unsigned int i; for (i = 0; i < len; ++i) { ((char *)output)[i] = (char)value; } } pupnp-release-1.8.0/upnp/src/uuid/sysdep.c000066400000000000000000000076421303304015100204710ustar00rootroot00000000000000/* * Copyright (c) 1990- 1993, 1996 Open Software Foundation, Inc. * Copyright (c) 1989 by Hewlett-Packard Company, Palo Alto, Ca. & * Digital Equipment Corporation, Maynard, Mass. * Copyright (c) 1998 Microsoft. * To anyone who acknowledges that this file is provided "AS IS" * without any express or implied warranty: permission to use, copy, * modify, and distribute this file for any purpose is hereby * granted without fee, provided that the above copyright notices and * this notice appears in all source code copies, and that none of * the names of Open Software Foundation, Inc., Hewlett-Packard * Company, or Digital Equipment Corporation be used in advertising * or publicity pertaining to distribution of the software without * specific, written prior permission. Neither Open Software * Foundation, Inc., Hewlett-Packard Company, Microsoft, nor Digital Equipment * Corporation makes any representations about the suitability of * this software for any purpose. */ /*! * \file */ #include "config.h" #include "sysdep.h" #include "UpnpInet.h" #include #include /*! * \brief System dependent call to get IEEE node ID. * * This sample implementation generates a random node ID. */ void get_ieee_node_identifier(uuid_node_t *node) { unsigned char seed[16]; static int inited = 0; static uuid_node_t saved_node; if (!inited) { get_random_info(seed); seed[0] |= 0x80; memcpy(&saved_node, seed, sizeof(uuid_node_t)); inited = 1; }; *node = saved_node; }; /*! * \brief System dependent call to get the current system time. * * Returned as 100ns ticks since Oct 15, 1582, but resolution may be less * than 100ns. */ #ifdef WIN32 void get_system_time(uuid_time_t *uuid_time) { ULARGE_INTEGER time; GetSystemTimeAsFileTime((FILETIME *) & time); /* NT keeps time in FILETIME format which is 100ns ticks since Jan 1, 1601. UUIDs use time in 100ns ticks since Oct 15, 1582. The difference is 17 Days in Oct + 30 (Nov) + 31 (Dec) + 18 years and 5 leap days. */ time.QuadPart += (unsigned __int64)(1000 * 1000 * 10) /* seconds */ *(unsigned __int64)(60 * 60 * 24) /* days */ *(unsigned __int64)(17 + 30 + 31 + 365 * 18 + 5); /* # of days */ *uuid_time = time.QuadPart; }; void get_random_info(unsigned char seed[16]) { MD5_CTX c; typedef struct { MEMORYSTATUS m; SYSTEM_INFO s; FILETIME t; LARGE_INTEGER pc; DWORD tc; DWORD l; char hostname[MAX_COMPUTERNAME_LENGTH + 1]; } randomness; randomness r; /* Initialize memory area so that valgrind does not complain */ memset(&r, 0, sizeof r); /* memory usage stats */ GlobalMemoryStatus( &r.m ); /* random system stats */ GetSystemInfo( &r.s ); /* 100ns resolution (nominally) time of day */ GetSystemTimeAsFileTime( &r.t ); /* high resolution performance counter */ QueryPerformanceCounter( &r.pc ); /* milliseconds since last boot */ r.tc = GetTickCount(); r.l = MAX_COMPUTERNAME_LENGTH + 1; GetComputerName( r.hostname, &r.l ); /* MD5 it */ MD5Init(&c); MD5Update(&c, (unsigned char *)(&r), sizeof r); MD5Final(seed, &c); }; #else /* WIN32 */ void get_system_time(uuid_time_t *uuid_time) { struct timeval tp; gettimeofday(&tp, (struct timezone *)0); /* Offset between UUID formatted times and Unix formatted times. * UUID UTC base time is October 15, 1582. * Unix base time is January 1, 1970. */ *uuid_time = (uuid_time_t)tp.tv_sec * 10000000 + (uuid_time_t)tp.tv_usec * 10 + 0x01B21DD213814000LL; }; void get_random_info(unsigned char seed[16]) { MD5_CTX c; typedef struct { /*struct sysinfo s; */ struct timeval t; char hostname[257]; } randomness; randomness r; /* Initialize memory area so that valgrind does not complain. */ memset(&r, 0, sizeof r); /* Get some random stuff. */ gettimeofday(&r.t, (struct timezone *)0); gethostname(r.hostname, 256); /* MD5 it */ MD5Init(&c); MD5Update(&c, (unsigned char *)&r, sizeof r); MD5Final(seed, &c); }; #endif /* WIN32 */ pupnp-release-1.8.0/upnp/src/uuid/uuid.c000066400000000000000000000203611303304015100201210ustar00rootroot00000000000000/************************************************************************** * * Copyright (c) 1990- 1993, 1996 Open Software Foundation, Inc. * Copyright (c) 1989 by Hewlett-Packard Company, Palo Alto, Ca. & * Digital Equipment Corporation, Maynard, Mass. * Copyright (c) 1998 Microsoft. * To anyone who acknowledges that this file is provided "AS IS" * without any express or implied warranty: permission to use, copy, * modify, and distribute this file for any purpose is hereby * granted without fee, provided that the above copyright notices and * this notice appears in all source code copies, and that none of * the names of Open Software Foundation, Inc., Hewlett-Packard * Company, or Digital Equipment Corporation be used in advertising * or publicity pertaining to distribution of the software without * specific, written prior permission. Neither Open Software * Foundation, Inc., Hewlett-Packard Company, Microsoft, nor Digital Equipment * Corporation makes any representations about the suitability of * this software for any purpose. * **************************************************************************/ /*! * \file */ #include "config.h" #include "uuid.h" #include "UpnpInet.h" #include "UpnpStdInt.h" #include #include #include #include /* various forward declarations. */ static int read_state(uint16_t *clockseq, uuid_time_t *timestamp, uuid_node_t * node); static void write_state(uint16_t clockseq, uuid_time_t timestamp, uuid_node_t node); static void format_uuid_v1(uuid_upnp *uid, uint16_t clockseq, uuid_time_t timestamp, uuid_node_t node); static void format_uuid_v3(uuid_upnp *uid, unsigned char hash[16]); static void get_current_time(uuid_time_t *timestamp); static uint16_t true_random(void); /*! * \brief Generator of a UUID. */ int uuid_create(uuid_upnp * uid) { uuid_time_t timestamp; uuid_time_t last_time; uint16_t clockseq; uuid_node_t node; uuid_node_t last_node; int f; /* acquire system wide lock so we're alone. */ UUIDLock(); /* get current time. */ get_current_time(×tamp); /* get node ID. */ get_ieee_node_identifier(&node); /* get saved state from NV storage. */ f = read_state(&clockseq, &last_time, &last_node); /* if no NV state, or if clock went backwards, or node ID changed * (e.g., net card swap) change clockseq. */ if (!f || memcmp(&node, &last_node, sizeof(uuid_node_t))) clockseq = true_random(); else if (timestamp < last_time) clockseq++; /* stuff fields into the UUID. */ format_uuid_v1(uid, clockseq, timestamp, node); /* save the state for next time. */ write_state(clockseq, timestamp, node); UUIDUnlock(); return 1; }; void uuid_unpack(uuid_upnp * u, char *out) { sprintf(out, "%8.8x-%4.4x-%4.4x-%2.2x%2.2x-%2.2x%2.2x%2.2x%2.2x%2.2x%2.2x", (unsigned int)u->time_low, u->time_mid, u->time_hi_and_version, u->clock_seq_hi_and_reserved, u->clock_seq_low, u->node[0], u->node[1], u->node[2], u->node[3], u->node[4], u->node[5]); }; /*! * \brief Make a UUID from the timestamp, clockseq, and node ID. */ void format_uuid_v1(uuid_upnp * uid, uint16_t clock_seq, uuid_time_t timestamp, uuid_node_t node) { /* Construct a version 1 uuid with the information we've gathered * plus a few constants. */ uid->time_low = (uint32_t)(timestamp & 0xFFFFFFFF); uid->time_mid = (uint16_t)((timestamp >> 32) & 0xFFFF); uid->time_hi_and_version = (uint16_t)((timestamp >> 48) & 0x0FFF); uid->time_hi_and_version |= (1 << 12); uid->clock_seq_low = (uint8_t) (clock_seq & 0xFF); uid->clock_seq_hi_and_reserved = (uint8_t) ((clock_seq & 0x3F00) >> 8); uid->clock_seq_hi_and_reserved |= 0x80; memcpy(&uid->node, &node, sizeof uid->node); }; /*! Data type for UUID generator persistent state. */ typedef struct { /*! Saved timestamp. */ uuid_time_t ts; /*! Saved node ID. */ uuid_node_t node; /*! Saved clock sequence. */ uint16_t cs; } uuid_state; static uuid_state st; static int stateInited = 0; /*! * \brief Read UUID generator state from non-volatile store. */ int read_state(uint16_t *clockseq, uuid_time_t *timestamp, uuid_node_t *node) { if (!stateInited) return 0; *clockseq = st.cs; *timestamp = st.ts; *node = st.node; return 1; }; /*! * \brief Save UUID generator state back to non-volatile storage. */ void write_state(uint16_t clockseq, uuid_time_t timestamp, uuid_node_t node) { static uuid_time_t next_save; if (!stateInited) { next_save = timestamp; stateInited = 1; }; /* always save state to volatile shared state. */ st.cs = clockseq; st.ts = timestamp; st.node = node; if (timestamp >= next_save) { /* schedule next save for 10 seconds from now. */ next_save = timestamp + (10 * 10 * 1000 * 1000); }; }; /*! * \brief Get time as 60 bit 100ns ticks since whenever. * * Compensate for the fact that real clock resolution is less than 100ns. */ void get_current_time(uuid_time_t *timestamp) { uuid_time_t time_now; static uuid_time_t time_last; static uint16_t uuids_this_tick; static int inited = 0; if (!inited) { uuids_this_tick = UUIDS_PER_TICK; inited = 1; }; while (1) { get_system_time(&time_now); /* if clock reading changed since last UUID generated... */ if (time_last != time_now) { /* reset count of uuids gen'd with this clock reading. */ uuids_this_tick = 0; break; }; if (uuids_this_tick < UUIDS_PER_TICK) { uuids_this_tick++; break; }; /* going too fast for our clock; spin. */ }; /* add the count of uuids to low order bits of the clock reading. */ *timestamp = time_now + uuids_this_tick; time_last = *timestamp; }; /*! * \brief generate a crypto-quality random number. * This sample doesn't do that. */ static uint16_t true_random(void) { static int inited = 0; uuid_time_t time_now; if (!inited) { get_system_time(&time_now); time_now = time_now / UUIDS_PER_TICK; srand((unsigned int)(((time_now >> 32) ^ time_now) & 0xffffffff)); inited = 1; }; return (uint16_t) (rand()); } /*! * \brief Create a UUID using a "name" from a "name space". */ void uuid_create_from_name( /*! resulting UUID. */ uuid_upnp *uid, /*! UUID to serve as context, so identical names from different name * spaces generate different UUIDs. */ uuid_upnp nsid, /*! The name from which to generate a UUID. */ void *name, /*! The length of the name. */ int namelen) { MD5_CTX c; unsigned char hash[16]; uuid_upnp net_nsid; /* context UUID in network byte order */ /* put name space ID in network byte order so it hashes the same no matter * what endian machine we're on. */ net_nsid = nsid; net_nsid.time_low = htonl(net_nsid.time_low); net_nsid.time_mid = htons(net_nsid.time_mid); net_nsid.time_hi_and_version = htons(net_nsid.time_hi_and_version); MD5Init(&c); MD5Update(&c, (unsigned char *)&net_nsid, sizeof(uuid_upnp)); MD5Update(&c, name, (unsigned int)namelen); MD5Final(hash, &c); /* the hash is in network byte order at this point. */ format_uuid_v3(uid, hash); }; /*! * \brief Make a UUID from a (pseudo)random 128 bit number. */ void format_uuid_v3(uuid_upnp *uid, unsigned char hash[16]) { /* Construct a version 3 uuid with the (pseudo-)random number plus a few * constants. */ memcpy(uid, hash, sizeof(uuid_upnp)); /* convert UUID to local byte order. */ uid->time_low = ntohl(uid->time_low); uid->time_mid = ntohs(uid->time_mid); uid->time_hi_and_version = ntohs(uid->time_hi_and_version); /* put in the variant and version bits. */ uid->time_hi_and_version &= 0x0FFF; uid->time_hi_and_version |= (3 << 12); uid->clock_seq_hi_and_reserved &= 0x3F; uid->clock_seq_hi_and_reserved |= 0x80; }; #define CHECK(f1, f2) if (f1 != f2) return f1 < f2 ? -1 : 1; /*! * \brief Compare two UUID's "lexically" and return. * * \li -1: u1 is lexically before u2 * \li 0: u1 is equal to u2 * \li 1: u1 is lexically after u2 * * Note: Lexical ordering is not temporal ordering! */ int uuid_compare(uuid_upnp *u1, uuid_upnp *u2) { int i; CHECK(u1->time_low, u2->time_low); CHECK(u1->time_mid, u2->time_mid); CHECK(u1->time_hi_and_version, u2->time_hi_and_version); CHECK(u1->clock_seq_hi_and_reserved, u2->clock_seq_hi_and_reserved); CHECK(u1->clock_seq_low, u2->clock_seq_low) for (i = 0; i < 6; i++) { if (u1->node[i] < u2->node[i]) return -1; if (u1->node[i] > u2->node[i]) return 1; } return 0; }; pupnp-release-1.8.0/upnp/src/win_dll.c000066400000000000000000000005061303304015100176340ustar00rootroot00000000000000// upnpLib.cpp : Defines the entry point for the DLL application. // #ifdef WIN32 #include BOOL APIENTRY DllMain( HANDLE hModule, DWORD ul_reason_for_call, LPVOID lpReserved ) { if (ul_reason_for_call == DLL_PROCESS_ATTACH) { } return TRUE; } #endif pupnp-release-1.8.0/upnp/test/000077500000000000000000000000001303304015100162275ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/test/test_init.c000066400000000000000000000074361303304015100204070ustar00rootroot00000000000000/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */ /////////////////////////////////////////////////////////////////////////// // // Copyright (c) 2006 Rmi Turboult // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // // * Redistributions of source code must retain the above copyright notice, // this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above copyright notice, // this list of conditions and the following disclaimer in the documentation // and/or other materials provided with the distribution. // * Neither name of Intel Corporation nor the names of its contributors // may be used to endorse or promote products derived from this software // without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR // PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY // OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // /////////////////////////////////////////////////////////////////////////// #include "upnp.h" #include #include #if UPNP_HAVE_TOOLS # include "upnptools.h" #endif int main (int argc, char* argv[]) { int rc; int a, b, c; /* * Check library version (and formats) */ printf ("\n"); printf ("UPNP_VERSION_STRING = \"%s\"\n", UPNP_VERSION_STRING); printf ("UPNP_VERSION_MAJOR = %d\n", UPNP_VERSION_MAJOR); printf ("UPNP_VERSION_MINOR = %d\n", UPNP_VERSION_MINOR); printf ("UPNP_VERSION_PATCH = %d\n", UPNP_VERSION_PATCH); printf ("UPNP_VERSION = %d\n", UPNP_VERSION); if ( sscanf (UPNP_VERSION_STRING, "%d.%d.%d", &a, &b, &c) != 3 || a != UPNP_VERSION_MAJOR || b != UPNP_VERSION_MINOR || c != UPNP_VERSION_PATCH ) { printf ("** ERROR malformed UPNP_VERSION_STRING\n"); exit (EXIT_FAILURE); // ----------> } /* * Check library optional features */ printf ("\n"); #if UPNP_HAVE_DEBUG printf ("UPNP_HAVE_DEBUG \t= yes\n"); #else printf ("UPNP_HAVE_DEBUG \t= no\n"); #endif #if UPNP_HAVE_CLIENT printf ("UPNP_HAVE_CLIENT\t= yes\n"); #else printf ("UPNP_HAVE_CLIENT\t= no\n"); #endif #if UPNP_HAVE_DEVICE printf ("UPNP_HAVE_DEVICE\t= yes\n"); #else printf ("UPNP_HAVE_DEVICE\t= no\n"); #endif #if UPNP_HAVE_WEBSERVER printf ("UPNP_HAVE_WEBSERVER\t= yes\n"); #else printf ("UPNP_HAVE_WEBSERVER\t= no\n"); #endif #if UPNP_HAVE_TOOLS printf ("UPNP_HAVE_TOOLS \t= yes\n"); #else printf ("UPNP_HAVE_TOOLS \t= no\n"); #endif /* * Test library initialisation */ printf ("\n"); printf ("Initializing UPnP ... \n"); rc = UpnpInit (NULL, 0); if ( UPNP_E_SUCCESS == rc ) { const char* ip_address = UpnpGetServerIpAddress(); unsigned short port = UpnpGetServerPort(); printf ("UPnP Initialized OK ip=%s, port=%d\n", (ip_address ? ip_address : "UNKNOWN"), port); } else { printf ("** ERROR UpnpInit(): %d", rc); #if UPNP_HAVE_TOOLS printf (" %s", UpnpGetErrorMessage (rc)); #endif printf ("\n"); exit (EXIT_FAILURE); // ----------> } (void) UpnpFinish(); printf ("\n"); exit (EXIT_SUCCESS); } pupnp-release-1.8.0/upnp/test/test_url.c000066400000000000000000000125351303304015100202420ustar00rootroot00000000000000 #include #include #include #include "upnp.h" #include "upnptools.h" struct test { const char *base; const char *rel; const char *expect; int line; int error; }; #define TEST(BaseURL, RelURL, expect, ...) {BaseURL, RelURL, expect, __LINE__, ##__VA_ARGS__} static int result(const struct test *test) { char *absurl = NULL; int ret = 0; ret = UpnpResolveURL2(test->base, test->rel, &absurl); if (ret == test->error && (test->expect == NULL || strcmp(test->expect, absurl) == 0)) { ret = 0; } else { printf("%s:%d: '%s' | '%s' -> '%s' != '%s' (%d)\n", __FILE__, test->line, test->base, test->rel, absurl, test->expect, ret); ret = 1; } free(absurl); return ret; } /* The URLs must be resolvale! */ static const char ABS_URL1[] = "http://www.libupnp.org/path1/"; static const char ABS_URL2[] = "http://www.libupnp.org/path1/path1"; static const char ABS_URL3[] = "http://localhost/path1/"; static const char ABS_URL4[] = "http://127.0.0.1/path1/"; static const char ABS_URL5[] = "http://127.0.0.1:6544/path1/"; static const char ABS_URL6[] = "http://[::1]:6544/path1/"; static const char REL_URL1[] = "//localhost/path2"; static const char REL_URL2[] = "/path3"; static const char REL_URL3[] = "path4"; static const char REL_URL4[] = "../path5"; static const char REL_URL5[] = "?query1"; static const char REL_URL6[] = "#frag1"; static const char ABS_RFC[] = "http://localhost/b/c/d;p?q"; // s,\,localhost, // s,//g\>,//127.0.0.1, static const struct test RFC3986[] = { // Errors TEST(NULL, NULL, NULL, UPNP_E_INVALID_PARAM), TEST(ABS_URL1, NULL, NULL, UPNP_E_INVALID_PARAM), TEST("foo", "bar", NULL, UPNP_E_INVALID_URL), // Custom TEST(NULL, ABS_URL1, ABS_URL1), TEST(ABS_URL1, ABS_URL2, ABS_URL2), TEST(ABS_URL1, "", ABS_URL1), TEST(ABS_URL1, REL_URL1, "http://localhost/path2"), TEST(ABS_URL2, REL_URL1, "http://localhost/path2"), TEST(ABS_URL1, REL_URL2, "http://www.libupnp.org/path3"), TEST(ABS_URL2, REL_URL2, "http://www.libupnp.org/path3"), TEST(ABS_URL1, REL_URL3, "http://www.libupnp.org/path1/path4"), TEST(ABS_URL2, REL_URL3, "http://www.libupnp.org/path1/path4"), TEST(ABS_URL1, REL_URL4, "http://www.libupnp.org/path5"), TEST(ABS_URL2, REL_URL4, "http://www.libupnp.org/path5"), TEST(ABS_URL1, REL_URL6, "http://www.libupnp.org/path1/#frag1"), TEST(ABS_URL2, REL_URL6, "http://www.libupnp.org/path1/path1#frag1"), TEST("http://127.0.0.1:6544/getDeviceDesc", "CDS_Event", "http://127.0.0.1:6544/CDS_Event"), // Normal Examples TEST(ABS_RFC, "g:h", "g:h"), TEST(ABS_RFC, "g", "http://localhost/b/c/g"), TEST(ABS_RFC, "./g", "http://localhost/b/c/g"), TEST(ABS_RFC, "g/", "http://localhost/b/c/g/"), TEST(ABS_RFC, "/g", "http://localhost/g"), TEST(ABS_RFC, "//127.0.0.1", "http://127.0.0.1"), TEST(ABS_RFC, "?y", "http://localhost/b/c/d;p?y"), TEST(ABS_RFC, "g?y", "http://localhost/b/c/g?y"), TEST(ABS_RFC, "#s", "http://localhost/b/c/d;p?q#s"), TEST(ABS_RFC, "g#s", "http://localhost/b/c/g#s"), TEST(ABS_RFC, "g?y#s", "http://localhost/b/c/g?y#s"), TEST(ABS_RFC, ";x", "http://localhost/b/c/;x"), TEST(ABS_RFC, "g;x", "http://localhost/b/c/g;x"), TEST(ABS_RFC, "g;x?y#s", "http://localhost/b/c/g;x?y#s"), TEST(ABS_RFC, "", "http://localhost/b/c/d;p?q"), TEST(ABS_RFC, ".", "http://localhost/b/c/"), TEST(ABS_RFC, "./", "http://localhost/b/c/"), TEST(ABS_RFC, "..", "http://localhost/b/"), TEST(ABS_RFC, "../", "http://localhost/b/"), TEST(ABS_RFC, "../g", "http://localhost/b/g"), TEST(ABS_RFC, "../..", "http://localhost/"), TEST(ABS_RFC, "../../", "http://localhost/"), TEST(ABS_RFC, "../../g", "http://localhost/g"), // Abnormal Examples TEST(ABS_RFC, "../../../g", "http://localhost/g"), TEST(ABS_RFC, "../../../../g", "http://localhost/g"), TEST(ABS_RFC, "/./g", "http://localhost/g"), TEST(ABS_RFC, "/../g", "http://localhost/g"), TEST(ABS_RFC, "g.", "http://localhost/b/c/g."), TEST(ABS_RFC, ".g", "http://localhost/b/c/.g"), TEST(ABS_RFC, "g..", "http://localhost/b/c/g.."), TEST(ABS_RFC, "..g", "http://localhost/b/c/..g"), TEST(ABS_RFC, "./../g", "http://localhost/b/g"), TEST(ABS_RFC, "./g/.", "http://localhost/b/c/g/"), TEST(ABS_RFC, "g/./h", "http://localhost/b/c/g/h"), TEST(ABS_RFC, "g/../h", "http://localhost/b/c/h"), TEST(ABS_RFC, "g;x=1/./y", "http://localhost/b/c/g;x=1/y"), TEST(ABS_RFC, "g;x=1/../y", "http://localhost/b/c/y"), TEST(ABS_RFC, "g?y/./x", "http://localhost/b/c/g?y/./x"), TEST(ABS_RFC, "g?y/../x", "http://localhost/b/c/g?y/../x"), TEST(ABS_RFC, "g#s/./x", "http://localhost/b/c/g#s/./x"), TEST(ABS_RFC, "g#s/../x", "http://localhost/b/c/g#s/../x"), TEST(ABS_RFC, "http:g", "http:g"), }; #define ARRAY_SIZE(a) (sizeof (a) / sizeof *(a)) int main (int argc, char* argv[]) { int i, ret = 0; for (i = 0; i < ARRAY_SIZE(RFC3986); i++) ret += result(&RFC3986[i]); exit (ret ? EXIT_FAILURE : EXIT_SUCCESS); } // gcc -o url-test -g url-test.c -I ixml/inc -I threadutil/inc -I upnp/inc upnp/.libs/libupnp.a -L ixml/.libs -lixml -L threadutil/.libs -lthreadutil -lpthread pupnp-release-1.8.0/upnp/unittest/000077500000000000000000000000001303304015100171275ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/unittest/Makefile.am000066400000000000000000000013041303304015100211610ustar00rootroot00000000000000# # "Makefile.am" for "libupnp/upnp/unittest" # # Copyright (C) 2010 Marcelo Roberto Jimenez # AM_CPPFLAGS = \ -I$(top_srcdir)/upnp/inc \ -I$(top_srcdir)/threadutil/inc \ -I$(top_srcdir)/ixml/inc \ -I$(top_srcdir)/upnp/src/inc LDADD = \ $(top_builddir)/upnp/libupnp-1.8.la \ $(top_builddir)/threadutil/libthreadutil-1.8.la \ $(top_builddir)/ixml/libixml-1.8.la #unittest noinst_PROGRAMS = unittest-1.8 unittest_1_8_CPPFLAGS = \ $(AM_CPPFLAGS) unittest_1_8_SOURCES = \ main.c \ templates/FirstObject.c \ templates/FirstObject.h \ templates/templates.c \ templates/templates.h \ templates/SecondObject.c \ templates/SecondObject.h \ templates/TheStruct.h pupnp-release-1.8.0/upnp/unittest/main.c000066400000000000000000000006631303304015100202240ustar00rootroot00000000000000 #include #include "templates/templates.h" int (*tests[])(void) = { templates, }; int main(void) { int ret = 0; int i; int n = (sizeof tests) / (sizeof tests[0]); int result; for (i = 0; i < n; ++i) { result = tests[i](); printf("Test number %3d: %s.\n", i + 1, !result ? "PASS" : "FAIL"); ret += result; } printf("\n" "Failed in %d tests.\n" "Passed in %d tests.\n", ret, n - ret); return ret; } pupnp-release-1.8.0/upnp/unittest/templates/000077500000000000000000000000001303304015100211255ustar00rootroot00000000000000pupnp-release-1.8.0/upnp/unittest/templates/FirstObject.c000066400000000000000000000001211303304015100235010ustar00rootroot00000000000000 #include "config.h" #define TEMPLATE_GENERATE_SOURCE #include "FirstObject.h" pupnp-release-1.8.0/upnp/unittest/templates/FirstObject.h000066400000000000000000000022241303304015100235140ustar00rootroot00000000000000 #ifndef FIRSTOBJECT_H #define FIRSTOBJECT_H /*! * \file * * \brief Object used in unit testing of object templates. */ /******************************************************************************/ #ifdef TEMPLATE_GENERATE_SOURCE #undef TEMPLATE_GENERATE_SOURCE #include "SecondObject.h" #define TEMPLATE_GENERATE_SOURCE #else /* TEMPLATE_GENERATE_SOURCE */ #include "SecondObject.h" #endif /* TEMPLATE_GENERATE_SOURCE */ /******************************************************************************/ #include "TheStruct.h" #define CLASS UnitFirstObject #define EXPAND_CLASS_MEMBERS(CLASS) \ EXPAND_CLASS_MEMBER_INT(CLASS, TheInteger, int) \ EXPAND_CLASS_MEMBER_INT(CLASS, TheUnsignedLong, unsigned long) \ EXPAND_CLASS_MEMBER_INT(CLASS, TheCharPointer, char *) \ EXPAND_CLASS_MEMBER_BUFFER(CLASS, TheBuffer, struct TheStruct) \ EXPAND_CLASS_MEMBER_LIST(CLASS, TheList) \ EXPAND_CLASS_MEMBER_OBJECT(CLASS, TheSecondObject, UnitSecondObject) \ EXPAND_CLASS_MEMBER_STRING(CLASS, TheString) \ EXPAND_CLASS_MEMBER_DOMSTRING(CLASS, TheDomString) #include "TemplateInclude.h" #endif /* FIRSTOBJECT_H */ pupnp-release-1.8.0/upnp/unittest/templates/SecondObject.c000066400000000000000000000001221303304015100236260ustar00rootroot00000000000000 #include "config.h" #define TEMPLATE_GENERATE_SOURCE #include "SecondObject.h" pupnp-release-1.8.0/upnp/unittest/templates/SecondObject.h000066400000000000000000000022361303304015100236430ustar00rootroot00000000000000 #ifndef SECONDOBJECT_H #define SECONDOBJECT_H /*! * \file * * \brief Object used in unit testing of object templates. */ /******************************************************************************/ #ifdef TEMPLATE_GENERATE_SOURCE #undef TEMPLATE_GENERATE_SOURCE /*#include "ThirdObject.h"*/ #define TEMPLATE_GENERATE_SOURCE #else /* TEMPLATE_GENERATE_SOURCE */ /*#include "ThirdObject.h"*/ #endif /* TEMPLATE_GENERATE_SOURCE */ /******************************************************************************/ #include "TheStruct.h" #define CLASS UnitSecondObject #define EXPAND_CLASS_MEMBERS(CLASS) \ EXPAND_CLASS_MEMBER_INT(CLASS, TheInteger, int) \ EXPAND_CLASS_MEMBER_INT(CLASS, TheUnsignedLong, unsigned long) \ EXPAND_CLASS_MEMBER_INT(CLASS, TheCharPointer, char *) \ EXPAND_CLASS_MEMBER_BUFFER(CLASS, TheBuffer, struct TheStruct) \ EXPAND_CLASS_MEMBER_LIST(CLASS, TheList) \ /* EXPAND_CLASS_MEMBER_OBJECT(CLASS, TheThirdObject, ThirdObject) */ \ EXPAND_CLASS_MEMBER_STRING(CLASS, TheString) \ EXPAND_CLASS_MEMBER_DOMSTRING(CLASS, TheDomString) #include "TemplateInclude.h" #endif /* SECONDOBJECT_H */ pupnp-release-1.8.0/upnp/unittest/templates/TheStruct.h000066400000000000000000000001541303304015100232230ustar00rootroot00000000000000 #ifndef THESTRUCT_H #define THESTRUCT_H struct TheStruct { int a; long b; }; #endif /* THESTRUCT_H */ pupnp-release-1.8.0/upnp/unittest/templates/compile.sh000077500000000000000000000020021303304015100231060ustar00rootroot00000000000000#! /bin/bash # # The purpose of this file is to make it easier to find problems in # Template Objects compilation. # # Because Template Objects are a result of preprocessing, the are normally # invisible to the human eye. So, we paint him! Using the C pre-processor. # # The issue is that compilation error messages give all errors at the same # lines. Using a combination of the pre-processor and indent, we are able # to produce a good readable code, so that we can debug the templates. # if [[ "$1" == "" ]]; then echo "Error: no file name given, please enter the C file name." exit -1 fi FILENAME=$(basename $1 .c) top_srcdir=../../.. INCLUDES= INCLUDES="${INCLUDES} -I${top_srcdir}" INCLUDES="${INCLUDES} -I${top_srcdir}/ixml/inc" INCLUDES="${INCLUDES} -I${top_srcdir}/threadutil/inc" \ INCLUDES="${INCLUDES} -I${top_srcdir}/upnp/inc" \ INCLUDES="${INCLUDES} -I${top_srcdir}/upnp/src/inc" gcc ${INCLUDES} -E ${FILENAME}.c | grep -v ^# | indent -linux > ${FILENAME}.pp.c gcc ${INCLUDES} -Wall -c ${FILENAME}.pp.c pupnp-release-1.8.0/upnp/unittest/templates/templates.c000066400000000000000000000002021303304015100232610ustar00rootroot00000000000000 #include "templates.h" #include "FirstObject.h" #include "SecondObject.h" int templates(void) { int ret = 0; return ret; } pupnp-release-1.8.0/upnp/unittest/templates/templates.h000066400000000000000000000001321303304015100232700ustar00rootroot00000000000000 #ifndef TEMPLATES_H #define TEMPLATES_H int templates(void); #endif /* TEMPLATES_H */