pdbt: add one helper script, protocol and input data documentation

utils/pdbt/docs/data_format.txt

@@ -0,0 +1,29 @@
+* File format off the number portability data *
+
+The number portability data consists only from the number or number block in
+the internation format followed by an semi-colon and the carrier identity.
+Each entry must be in a separate line.
+
+Format [0-9]{n,m}; [0-9][0-9][0-9]
+
+For example: 
+
+495041748;012
+493687413;009
+
+The meaning of this entry is that the first number or block 495041748 belongs
+to the carrier 12, the second to the carrier 9.
+
+
+* File format of the carrier name file *
+
+Each carrier id and name must be in a separate line.
+
+Format: D[0-9][0-9][0-9] <name>
+
+For example:
+
+D001 Deutsche Telekom AG, Bonn
+D012 BT Germany GmbH & Co. OHG
+
+This means that the 495041748 block belongs to British Telecom Germany.

utils/pdbt/docs/network_protocol.txt

@@ -0,0 +1,16 @@
+* Network protocol of pdb server and sip-router module *
+
+The pdb server daemon listen only for UDP messages. The requests contains in
+the UDP payload the number starting with a internation prefix, e.g. '49' for
+germany. It must contain only numbers like this: '49721913742734'.
+
+The answer packet contains then the number string from the respective request,
+null-terminated and followed from two bytes which represents the result. This
+two bytes are interpreted as 16 bit signed integer value, the UDP payload is
+in network byte order (most significant byte first).  
+
+Possible values for the search request:
+  * 0: the number could not be found
+  * 1-999 the number was found and the result represents its carrier ID
+  * 1000: the number could be found, but its owned from a carriers which is
+    not interesting for us and belongs to the "other carrier" group

utils/pdbt/scripts/get_carrier_names_germany.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+
+# Copyright (C) 2009 1&1 Internet AG
+#
+# This file is part of sip-router, a free SIP server.
+#
+# sip-router 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
+#
+# sip-router 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
+
+# Small helper script for germany:
+# Download the directory of german carrier names and the respective IDs from
+# the 'Bundesnetzagentur' and convert this into the format which the pdbt tool
+# understands.
+
+url="http://www.bundesnetzagentur.de/enid/Portierungskennung/Verzeichnis_1ct.html"
+
+# fix LOCALE problem during filtering 
+export LANG="C"
+
+wget -O - "$url" | recode latin1..utf8 | tr -d '\r' | tr '\n' '@' | sed 's/^.*Firma//' | sed 's/<\/table>.*$//' | tr '@' '\n' | sed 's/<\/p>/@/' | sed 's/<\/td>/@/' | egrep -v "^ *<" | tr -d '\n' | sed 's/@ *@/@/g' | tr '@' '\n' | sed 's/  */ /g' | sed 's/^ *//' | tr '\n' '@' | sed 's/\([^@]*\)@\(D[0-9][0-9][0-9]\)[^@]*@/\2 \1@/g' | tr '@' '\n' | sed 's/\&nbsp\;/ /g' | sed 's/\&amp\;/\&/g' | sed 's/  */ /g' | egrep -v '^$'