diff --git a/src/modules/lost/doc/lost.xml b/src/modules/lost/doc/lost.xml index 34fe9d045a8..c9326a85a97 100644 --- a/src/modules/lost/doc/lost.xml +++ b/src/modules/lost/doc/lost.xml @@ -25,7 +25,7 @@ - 20018-2020 + 2018-2020 Wolfgang Kampichler diff --git a/src/modules/lost/doc/lost_admin.xml b/src/modules/lost/doc/lost_admin.xml index e7c6db21374..c8be8f668ba 100644 --- a/src/modules/lost/doc/lost_admin.xml +++ b/src/modules/lost/doc/lost_admin.xml @@ -69,8 +69,8 @@ loaded first in order to initialize connections properly. - TLS - if you use TLS connections (https) the tls module should be - loaded first in order to initialize &openssl; properly. + TLS - if you use TLS connections (https) the tls module + should be loaded first in order to initialize &openssl; properly. @@ -98,14 +98,14 @@
Parameters - Besides parameters listed, this module uses http_client therefore - according parameters may apply. + Besides parameters listed, this module uses http_client + therefore according parameters may apply.
<varname>exact_type</varname> (int) - Indicates to the location server that the contents of the "location_type" parameter must - be strictly followed. Values are 0 (false) or 1 (true). + Indicates to the location server that the contents of the "location_type" + parameter must be strictly followed. Values are 0 (false) or 1 (true). Default: 0 (false) @@ -181,8 +181,8 @@ lost_held_query(con, [id,] pidf-lo, url, error) - Sends a HELD locationRequest to a given connection. The device identity is either specified, - or the P-A-I header value, or the From header value. + Sends a HELD locationRequest to a given connection. The device identity is either + specified, or the P-A-I header value, or the From header value. @@ -200,7 +200,7 @@ url - the location reference returned in the HELD locationRequest response - this reference may be - added as Geolocation header value and forwarded downstream + added as Geolocation header value and forwarded downstream. Note: to work properly, it is required to include "locationURI" in the location_type parameter. @@ -325,15 +325,20 @@ xlog("L_INFO", "LOST findService: Result code $var(res)\nUri: $var(uri)\nName: $ (via http_client) and in case if you are using CentOS 6, be aware that standard libcurl-7.19.7-52 has a memory leak. To fix this memory, install libcurl from city-fan repository. More details at: - - https://www.digitalocean.com/community/questions/how-to-upgrade-curl-in-centos6 + . Note: http_client_query exported by the http_client API returns by default the first line of the HTTP response, but the lost module requires the complete response message, otherwise dereferencing location via the HTTP URL provided with the Geolocation header causes an error. - Therefore, to work properly, it is required to set the http_client module parameter query_result to 0. More details at: + Therefore, to work properly, it is required to set the http_client module parameter query_result + to 0. More details at: . + + Note: to test the module with a mapping service (LOST), an API key may be requested under the + following link (search for "GET ACCESS"): + . +