{"diffoscope-json-version": 1, "source1": "/srv/reproducible-results/rbuild-debian/r-b-build.fuPHIY1N/b1/fwknop_2.6.10-16_arm64.changes", "source2": "/srv/reproducible-results/rbuild-debian/r-b-build.fuPHIY1N/b2/fwknop_2.6.10-16_arm64.changes", "unified_diff": null, "details": [{"source1": "Files", "source2": "Files", "unified_diff": "@@ -1,12 +1,12 @@\n \n  8ed6a3bb75179a6688e7936b452d7b26 23260 admin optional fwknop-apparmor-profile_2.6.10-16_all.deb\n  d6d296ddd1bd5663f03514fb0c5bfde5 82768 debug optional fwknop-client-dbgsym_2.6.10-16_arm64.deb\n  926d0cb3f75089b78f21433326eb7de5 69440 admin optional fwknop-client_2.6.10-16_arm64.deb\n  0b2a5118296574cd2c7630247e372150 132348 debug optional fwknop-server-dbgsym_2.6.10-16_arm64.deb\n  39b42adddeaf0f95010b5733d3a44576 99776 admin optional fwknop-server_2.6.10-16_arm64.deb\n- df47ba2dd49eeed74465bc952ca0b1bf 49392 doc optional libfko-doc_2.6.10-16_all.deb\n+ 7bff9ed7992b03e614701e5307b54c24 49396 doc optional libfko-doc_2.6.10-16_all.deb\n  ad0cd042a8bd238e5b7e4403ed1889cb 67556 debug optional libfko-perl-dbgsym_2.6.10-16_arm64.deb\n  1c0cd71f1f97946bfd564ab296e6c872 48272 perl optional libfko-perl_2.6.10-16_arm64.deb\n  b1691678eef1d262e56b994d081be08e 106952 debug optional libfko3-dbgsym_2.6.10-16_arm64.deb\n- f1bdbb2baa61e074ffe6e4072d16ae0b 91772 libdevel optional libfko3-dev_2.6.10-16_arm64.deb\n+ 7fc2e207274291439b74e42bc5fb133e 91760 libdevel optional libfko3-dev_2.6.10-16_arm64.deb\n  39ba7d3b83bf7c377abd506d18129ed1 58112 libs optional libfko3_2.6.10-16_arm64.deb\n"}, {"source1": "libfko-doc_2.6.10-16_all.deb", "source2": "libfko-doc_2.6.10-16_all.deb", "unified_diff": null, "details": [{"source1": "file list", "source2": "file list", "unified_diff": "@@ -1,3 +1,3 @@\n -rw-r--r--   0        0        0        4 2023-04-11 03:52:01.000000 debian-binary\n--rw-r--r--   0        0        0     1740 2023-04-11 03:52:01.000000 control.tar.xz\n+-rw-r--r--   0        0        0     1744 2023-04-11 03:52:01.000000 control.tar.xz\n -rw-r--r--   0        0        0    47460 2023-04-11 03:52:01.000000 data.tar.xz\n"}, {"source1": "control.tar.xz", "source2": "control.tar.xz", "unified_diff": null, "details": [{"source1": "control.tar", "source2": "control.tar", "unified_diff": null, "details": [{"source1": "./md5sums", "source2": "./md5sums", "unified_diff": null, "details": [{"source1": "./md5sums", "source2": "./md5sums", "comments": ["Files differ"], "unified_diff": null}]}]}]}, {"source1": "data.tar.xz", "source2": "data.tar.xz", "unified_diff": null, "details": [{"source1": "data.tar", "source2": "data.tar", "unified_diff": null, "details": [{"source1": "file list", "source2": "file list", "unified_diff": "@@ -3,34 +3,34 @@\n drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/\n drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/doc/\n drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/\n -rw-r--r--   0 root         (0) root         (0)     1453 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/changelog.Debian.gz\n -rw-r--r--   0 root         (0) root         (0)    17337 2018-08-07 00:41:32.000000 ./usr/share/doc/libfko-doc/changelog.gz\n -rw-r--r--   0 root         (0) root         (0)     5077 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/copyright\n drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/\n--rw-r--r--   0 root         (0) root         (0)     4545 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Compiling-with-libfko.html\n--rw-r--r--   0 root         (0) root         (0)    14794 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Concept-Index.html\n--rw-r--r--   0 root         (0) root         (0)     8989 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Creating-Contexts.html\n--rw-r--r--   0 root         (0) root         (0)     8946 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Creating-a-SPA-Message.html\n--rw-r--r--   0 root         (0) root         (0)     4101 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Destroying-Contexts.html\n--rw-r--r--   0 root         (0) root         (0)     4652 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Digests.html\n--rw-r--r--   0 root         (0) root         (0)     4848 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Encryption-Algorithms.html\n--rw-r--r--   0 root         (0) root         (0)    24839 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Error-Handling.html\n--rw-r--r--   0 root         (0) root         (0)     4376 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Features.html\n--rw-r--r--   0 root         (0) root         (0)    20450 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Function-and-Data-Index.html\n--rw-r--r--   0 root         (0) root         (0)     3592 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Getting-Started.html\n--rw-r--r--   0 root         (0) root         (0)     4549 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/HMAC-Digests.html\n--rw-r--r--   0 root         (0) root         (0)     5234 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Introduction.html\n--rw-r--r--   0 root         (0) root         (0)    22663 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Library-Copying.html\n--rw-r--r--   0 root         (0) root         (0)     4203 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Overview.html\n--rw-r--r--   0 root         (0) root         (0)     3569 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Preparation.html\n--rw-r--r--   0 root         (0) root         (0)    20030 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Retrieving-SPA-Data.html\n--rw-r--r--   0 root         (0) root         (0)     6885 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/SPA-Data-Format.html\n--rw-r--r--   0 root         (0) root         (0)     6030 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/SPA-Messages.html\n--rw-r--r--   0 root         (0) root         (0)     3483 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/SPA-Parameter-Types.html\n--rw-r--r--   0 root         (0) root         (0)    17273 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Setting-SPA-Data.html\n--rw-r--r--   0 root         (0) root         (0)     4015 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Using-libfko.html\n--rw-r--r--   0 root         (0) root         (0)     9249 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Utility-Functions.html\n--rw-r--r--   0 root         (0) root         (0)     7164 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/index.html\n--rw-r--r--   0 root         (0) root         (0)     3817 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/libfko-Header.html\n+-rw-r--r--   0 root         (0) root         (0)     4544 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Compiling-with-libfko.html\n+-rw-r--r--   0 root         (0) root         (0)    14793 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Concept-Index.html\n+-rw-r--r--   0 root         (0) root         (0)     8988 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Creating-Contexts.html\n+-rw-r--r--   0 root         (0) root         (0)     8945 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Creating-a-SPA-Message.html\n+-rw-r--r--   0 root         (0) root         (0)     4100 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Destroying-Contexts.html\n+-rw-r--r--   0 root         (0) root         (0)     4651 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Digests.html\n+-rw-r--r--   0 root         (0) root         (0)     4847 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Encryption-Algorithms.html\n+-rw-r--r--   0 root         (0) root         (0)    24838 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Error-Handling.html\n+-rw-r--r--   0 root         (0) root         (0)     4375 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Features.html\n+-rw-r--r--   0 root         (0) root         (0)    20449 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Function-and-Data-Index.html\n+-rw-r--r--   0 root         (0) root         (0)     3591 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Getting-Started.html\n+-rw-r--r--   0 root         (0) root         (0)     4548 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/HMAC-Digests.html\n+-rw-r--r--   0 root         (0) root         (0)     5233 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Introduction.html\n+-rw-r--r--   0 root         (0) root         (0)    22662 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Library-Copying.html\n+-rw-r--r--   0 root         (0) root         (0)     4202 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Overview.html\n+-rw-r--r--   0 root         (0) root         (0)     3568 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Preparation.html\n+-rw-r--r--   0 root         (0) root         (0)    20029 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Retrieving-SPA-Data.html\n+-rw-r--r--   0 root         (0) root         (0)     6884 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/SPA-Data-Format.html\n+-rw-r--r--   0 root         (0) root         (0)     6029 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/SPA-Messages.html\n+-rw-r--r--   0 root         (0) root         (0)     3482 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/SPA-Parameter-Types.html\n+-rw-r--r--   0 root         (0) root         (0)    17272 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Setting-SPA-Data.html\n+-rw-r--r--   0 root         (0) root         (0)     4014 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Using-libfko.html\n+-rw-r--r--   0 root         (0) root         (0)     9248 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Utility-Functions.html\n+-rw-r--r--   0 root         (0) root         (0)     7162 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/index.html\n+-rw-r--r--   0 root         (0) root         (0)     3816 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/libfko-Header.html\n drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/doc-base/\n -rw-r--r--   0 root         (0) root         (0)      245 2023-04-11 03:52:01.000000 ./usr/share/doc-base/libfko-doc.libfko\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Compiling-with-libfko.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Compiling-with-libfko.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Concept-Index.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Concept-Index.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Creating-Contexts.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Creating-Contexts.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Creating-a-SPA-Message.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Creating-a-SPA-Message.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Destroying-Contexts.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Destroying-Contexts.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Digests.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Digests.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Encryption-Algorithms.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Encryption-Algorithms.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Error-Handling.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Error-Handling.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Features.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Features.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Function-and-Data-Index.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Function-and-Data-Index.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Getting-Started.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Getting-Started.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/HMAC-Digests.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/HMAC-Digests.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Introduction.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Introduction.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Library-Copying.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Library-Copying.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Overview.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Overview.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Preparation.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Preparation.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Retrieving-SPA-Data.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Retrieving-SPA-Data.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/SPA-Data-Format.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/SPA-Data-Format.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/SPA-Messages.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/SPA-Messages.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/SPA-Parameter-Types.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/SPA-Parameter-Types.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Setting-SPA-Data.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Setting-SPA-Data.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Using-libfko.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Using-libfko.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/Utility-Functions.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/Utility-Functions.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/index.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/index.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n@@ -72,15 +72,15 @@\n <p>\n Next: <a href=\"Introduction.html\" accesskey=\"n\" rel=\"next\">Introduction</a> &nbsp; [<a href=\"#SEC_Contents\" title=\"Table of contents\" rel=\"contents\">Contents</a>][<a href=\"Concept-Index.html\" title=\"Index\" rel=\"index\">Index</a>]</p>\n </div>\n <hr>\n <span id=\"Main-Menu\"></span><h1 class=\"top\">Main Menu</h1>\n \n <p>This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n </p>\n <p>Copyright &copy; 2009-2013 Damien Stuart.\n </p>\n <blockquote>\n <p>The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -9,15 +9,15 @@\n \n \n             ****** Firewall Knock Operator Library - libfko ******\n Next: Introduction \u00a0 [Contents][Index]\n ===============================================================================\n ****** Main Menu ******\n This manual is for the Firewall Knock Operator library, libfko. (version\n-2.6.10, last updated 9 February 2025).\n+2.6.10, last updated 8 January 2024).\n Copyright \u00a9 2009-2013 Damien Stuart.\n      The libfko manual is free; you can redistribute it and/or modify it\n      under the terms of the GNU General Public License as published by the\n      Free Software Foundation; either version 2 of the License, or (at\n      your option) any later version.\n      The libfko manual is distributed in the hope that it will be useful,\n      but WITHOUT ANY WARRANTY; without even the implied warranty of\n"}]}, {"source1": "./usr/share/doc/libfko-doc/libfko.html/libfko-Header.html", "source2": "./usr/share/doc/libfko-doc/libfko.html/libfko-Header.html", "unified_diff": "@@ -1,15 +1,15 @@\n <!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\n <html>\n <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->\n <head>\n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n <!-- \n This manual is for the Firewall Knock Operator library, libfko.\n-(version 2.6.10, last updated 9 February 2025).\n+(version 2.6.10, last updated 8 January 2024).\n \n Copyright (C) 2009-2013 Damien Stuart.\n \n The libfko manual is free; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n"}]}]}]}, {"source1": "libfko3-dev_2.6.10-16_arm64.deb", "source2": "libfko3-dev_2.6.10-16_arm64.deb", "unified_diff": null, "details": [{"source1": "file list", "source2": "file list", "unified_diff": "@@ -1,3 +1,3 @@\n -rw-r--r--   0        0        0        4 2023-04-11 03:52:01.000000 debian-binary\n -rw-r--r--   0        0        0     1144 2023-04-11 03:52:01.000000 control.tar.xz\n--rw-r--r--   0        0        0    90436 2023-04-11 03:52:01.000000 data.tar.xz\n+-rw-r--r--   0        0        0    90424 2023-04-11 03:52:01.000000 data.tar.xz\n"}, {"source1": "control.tar.xz", "source2": "control.tar.xz", "unified_diff": null, "details": [{"source1": "control.tar", "source2": "control.tar", "unified_diff": null, "details": [{"source1": "./md5sums", "source2": "./md5sums", "unified_diff": null, "details": [{"source1": "./md5sums", "source2": "./md5sums", "comments": ["Files differ"], "unified_diff": null}]}]}]}, {"source1": "data.tar.xz", "source2": "data.tar.xz", "unified_diff": null, "details": [{"source1": "data.tar", "source2": "data.tar", "unified_diff": null, "details": [{"source1": "file list", "source2": "file list", "unified_diff": "@@ -9,9 +9,9 @@\n drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/doc/\n drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko3-dev/\n -rw-r--r--   0 root         (0) root         (0)      593 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko3-dev/README.Debian\n -rw-r--r--   0 root         (0) root         (0)     1451 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko3-dev/changelog.Debian.gz\n -rw-r--r--   0 root         (0) root         (0)    17337 2018-08-07 00:41:32.000000 ./usr/share/doc/libfko3-dev/changelog.gz\n -rw-r--r--   0 root         (0) root         (0)     5077 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko3-dev/copyright\n drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/info/\n--rw-r--r--   0 root         (0) root         (0)    23961 2023-04-11 03:52:01.000000 ./usr/share/info/libfko.info.gz\n+-rw-r--r--   0 root         (0) root         (0)    23958 2023-04-11 03:52:01.000000 ./usr/share/info/libfko.info.gz\n lrwxrwxrwx   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/lib/aarch64-linux-gnu/libfko.so -> libfko.so.3.0.0\n"}, {"source1": "./usr/share/info/libfko.info.gz", "source2": "./usr/share/info/libfko.info.gz", "unified_diff": null, "details": [{"source1": "libfko.info", "source2": "libfko.info", "has_internal_linenos": true, "unified_diff": "@@ -4,5879 +4,5879 @@\n 00000030: 6e20 362e 3820 6672 6f6d 206c 6962 666b  n 6.8 from libfk\n 00000040: 6f2e 7465 7869 2e0a 0a54 6869 7320 6d61  o.texi...This ma\n 00000050: 6e75 616c 2069 7320 666f 7220 7468 6520  nual is for the \n 00000060: 4669 7265 7761 6c6c 204b 6e6f 636b 204f  Firewall Knock O\n 00000070: 7065 7261 746f 7220 6c69 6272 6172 792c  perator library,\n 00000080: 206c 6962 666b 6f2e 0a28 7665 7273 696f   libfko..(versio\n 00000090: 6e20 322e 362e 3130 2c20 6c61 7374 2075  n 2.6.10, last u\n-000000a0: 7064 6174 6564 2039 2046 6562 7275 6172  pdated 9 Februar\n-000000b0: 7920 3230 3235 292e 0a0a 2020 2043 6f70  y 2025)...   Cop\n-000000c0: 7972 6967 6874 2028 4329 2032 3030 392d  yright (C) 2009-\n-000000d0: 3230 3133 2044 616d 6965 6e20 5374 7561  2013 Damien Stua\n-000000e0: 7274 2e0a 0a20 2020 2020 5468 6520 6c69  rt...     The li\n-000000f0: 6266 6b6f 206d 616e 7561 6c20 6973 2066  bfko manual is f\n-00000100: 7265 653b 2079 6f75 2063 616e 2072 6564  ree; you can red\n-00000110: 6973 7472 6962 7574 6520 6974 2061 6e64  istribute it and\n-00000120: 2f6f 7220 6d6f 6469 6679 2069 740a 2020  /or modify it.  \n-00000130: 2020 2075 6e64 6572 2074 6865 2074 6572     under the ter\n-00000140: 6d73 206f 6620 7468 6520 474e 5520 4765  ms of the GNU Ge\n-00000150: 6e65 7261 6c20 5075 626c 6963 204c 6963  neral Public Lic\n-00000160: 656e 7365 2061 7320 7075 626c 6973 6865  ense as publishe\n-00000170: 6420 6279 0a20 2020 2020 7468 6520 4672  d by.     the Fr\n-00000180: 6565 2053 6f66 7477 6172 6520 466f 756e  ee Software Foun\n-00000190: 6461 7469 6f6e 3b20 6569 7468 6572 2076  dation; either v\n-000001a0: 6572 7369 6f6e 2032 206f 6620 7468 6520  ersion 2 of the \n-000001b0: 4c69 6365 6e73 652c 206f 720a 2020 2020  License, or.    \n-000001c0: 2028 6174 2079 6f75 7220 6f70 7469 6f6e   (at your option\n-000001d0: 2920 616e 7920 6c61 7465 7220 7665 7273  ) any later vers\n-000001e0: 696f 6e2e 0a0a 2020 2020 2054 6865 206c  ion...     The l\n-000001f0: 6962 666b 6f20 6d61 6e75 616c 2069 7320  ibfko manual is \n-00000200: 6469 7374 7269 6275 7465 6420 696e 2074  distributed in t\n-00000210: 6865 2068 6f70 6520 7468 6174 2069 7420  he hope that it \n-00000220: 7769 6c6c 2062 650a 2020 2020 2075 7365  will be.     use\n-00000230: 6675 6c2c 2062 7574 2057 4954 484f 5554  ful, but WITHOUT\n-00000240: 2041 4e59 2057 4152 5241 4e54 593b 2077   ANY WARRANTY; w\n-00000250: 6974 686f 7574 2065 7665 6e20 7468 6520  ithout even the \n-00000260: 696d 706c 6965 6420 7761 7272 616e 7479  implied warranty\n-00000270: 0a20 2020 2020 6f66 204d 4552 4348 414e  .     of MERCHAN\n-00000280: 5441 4249 4c49 5459 206f 7220 4649 544e  TABILITY or FITN\n-00000290: 4553 5320 464f 5220 4120 5041 5254 4943  ESS FOR A PARTIC\n-000002a0: 554c 4152 2050 5552 504f 5345 2e20 5365  ULAR PURPOSE. Se\n-000002b0: 6520 7468 6520 474e 550a 2020 2020 2047  e the GNU.     G\n-000002c0: 656e 6572 616c 2050 7562 6c69 6320 4c69  eneral Public Li\n-000002d0: 6365 6e73 6520 666f 7220 6d6f 7265 2064  cense for more d\n-000002e0: 6574 6169 6c73 2e0a 0a20 2020 2020 596f  etails...     Yo\n-000002f0: 7520 7368 6f75 6c64 2068 6176 6520 7265  u should have re\n-00000300: 6365 6976 6564 2061 2063 6f70 7920 6f66  ceived a copy of\n-00000310: 2074 6865 2047 4e55 2047 656e 6572 616c   the GNU General\n-00000320: 2050 7562 6c69 6320 4c69 6365 6e73 650a   Public License.\n-00000330: 2020 2020 2061 6c6f 6e67 2077 6974 6820       along with \n-00000340: 7468 6973 206d 616e 7561 6c3b 2069 6620  this manual; if \n-00000350: 6e6f 742c 2077 7269 7465 2074 6f20 7468  not, write to th\n-00000360: 6520 4672 6565 2053 6f66 7477 6172 650a  e Free Software.\n-00000370: 2020 2020 2046 6f75 6e64 6174 696f 6e2c       Foundation,\n-00000380: 2049 6e63 2e2c 2035 3120 4672 616e 6b6c   Inc., 51 Frankl\n-00000390: 696e 2053 7472 6565 742c 2046 6966 7468  in Street, Fifth\n-000003a0: 2046 6c6f 6f72 2c20 426f 7374 6f6e 2c20   Floor, Boston, \n-000003b0: 4d41 0a20 2020 2020 3032 3131 302d 3133  MA.     02110-13\n-000003c0: 3031 2055 5341 0a49 4e46 4f2d 4449 522d  01 USA.INFO-DIR-\n-000003d0: 5345 4354 494f 4e20 4e65 7477 6f72 6b20  SECTION Network \n-000003e0: 5365 6375 7269 7479 0a53 5441 5254 2d49  Security.START-I\n-000003f0: 4e46 4f2d 4449 522d 454e 5452 590a 2a20  NFO-DIR-ENTRY.* \n-00000400: 6c69 6266 6b6f 3a20 286c 6962 666b 6f29  libfko: (libfko)\n-00000410: 2e20 2020 2054 6865 2046 6972 6557 616c  .    The FireWal\n-00000420: 6c20 4b4e 6f63 6b20 4f50 6572 6174 6f72  l KNock OPerator\n-00000430: 2028 6677 6b6e 6f70 2920 4c69 6272 6172   (fwknop) Librar\n-00000440: 7920 2d20 6c69 6266 6b6f 0a45 4e44 2d49  y - libfko.END-I\n-00000450: 4e46 4f2d 4449 522d 454e 5452 590a 0a1f  NFO-DIR-ENTRY...\n-00000460: 0a46 696c 653a 206c 6962 666b 6f2e 696e  .File: libfko.in\n-00000470: 666f 2c20 204e 6f64 653a 2054 6f70 2c20  fo,  Node: Top, \n-00000480: 204e 6578 743a 2049 6e74 726f 6475 6374   Next: Introduct\n-00000490: 696f 6e2c 2020 5570 3a20 2864 6972 290a  ion,  Up: (dir).\n-000004a0: 0a4d 6169 6e20 4d65 6e75 0a2a 2a2a 2a2a  .Main Menu.*****\n-000004b0: 2a2a 2a2a 0a0a 5468 6973 206d 616e 7561  ****..This manua\n-000004c0: 6c20 6973 2066 6f72 2074 6865 2046 6972  l is for the Fir\n-000004d0: 6577 616c 6c20 4b6e 6f63 6b20 4f70 6572  ewall Knock Oper\n-000004e0: 6174 6f72 206c 6962 7261 7279 2c20 6c69  ator library, li\n-000004f0: 6266 6b6f 2e0a 2876 6572 7369 6f6e 2032  bfko..(version 2\n-00000500: 2e36 2e31 302c 206c 6173 7420 7570 6461  .6.10, last upda\n-00000510: 7465 6420 3920 4665 6272 7561 7279 2032  ted 9 February 2\n-00000520: 3032 3529 2e0a 0a20 2020 436f 7079 7269  025)...   Copyri\n-00000530: 6768 7420 2843 2920 3230 3039 2d32 3031  ght (C) 2009-201\n-00000540: 3320 4461 6d69 656e 2053 7475 6172 742e  3 Damien Stuart.\n-00000550: 0a0a 2020 2020 2054 6865 206c 6962 666b  ..     The libfk\n-00000560: 6f20 6d61 6e75 616c 2069 7320 6672 6565  o manual is free\n-00000570: 3b20 796f 7520 6361 6e20 7265 6469 7374  ; you can redist\n-00000580: 7269 6275 7465 2069 7420 616e 642f 6f72  ribute it and/or\n-00000590: 206d 6f64 6966 7920 6974 0a20 2020 2020   modify it.     \n-000005a0: 756e 6465 7220 7468 6520 7465 726d 7320  under the terms \n-000005b0: 6f66 2074 6865 2047 4e55 2047 656e 6572  of the GNU Gener\n-000005c0: 616c 2050 7562 6c69 6320 4c69 6365 6e73  al Public Licens\n-000005d0: 6520 6173 2070 7562 6c69 7368 6564 2062  e as published b\n-000005e0: 790a 2020 2020 2074 6865 2046 7265 6520  y.     the Free \n-000005f0: 536f 6674 7761 7265 2046 6f75 6e64 6174  Software Foundat\n-00000600: 696f 6e3b 2065 6974 6865 7220 7665 7273  ion; either vers\n-00000610: 696f 6e20 3220 6f66 2074 6865 204c 6963  ion 2 of the Lic\n-00000620: 656e 7365 2c20 6f72 0a20 2020 2020 2861  ense, or.     (a\n-00000630: 7420 796f 7572 206f 7074 696f 6e29 2061  t your option) a\n-00000640: 6e79 206c 6174 6572 2076 6572 7369 6f6e  ny later version\n-00000650: 2e0a 0a20 2020 2020 5468 6520 6c69 6266  ...     The libf\n-00000660: 6b6f 206d 616e 7561 6c20 6973 2064 6973  ko manual is dis\n-00000670: 7472 6962 7574 6564 2069 6e20 7468 6520  tributed in the \n-00000680: 686f 7065 2074 6861 7420 6974 2077 696c  hope that it wil\n-00000690: 6c20 6265 0a20 2020 2020 7573 6566 756c  l be.     useful\n-000006a0: 2c20 6275 7420 5749 5448 4f55 5420 414e  , but WITHOUT AN\n-000006b0: 5920 5741 5252 414e 5459 3b20 7769 7468  Y WARRANTY; with\n-000006c0: 6f75 7420 6576 656e 2074 6865 2069 6d70  out even the imp\n-000006d0: 6c69 6564 2077 6172 7261 6e74 790a 2020  lied warranty.  \n-000006e0: 2020 206f 6620 4d45 5243 4841 4e54 4142     of MERCHANTAB\n-000006f0: 494c 4954 5920 6f72 2046 4954 4e45 5353  ILITY or FITNESS\n-00000700: 2046 4f52 2041 2050 4152 5449 4355 4c41   FOR A PARTICULA\n-00000710: 5220 5055 5250 4f53 452e 2053 6565 2074  R PURPOSE. See t\n-00000720: 6865 2047 4e55 0a20 2020 2020 4765 6e65  he GNU.     Gene\n-00000730: 7261 6c20 5075 626c 6963 204c 6963 656e  ral Public Licen\n-00000740: 7365 2066 6f72 206d 6f72 6520 6465 7461  se for more deta\n-00000750: 696c 732e 0a0a 2020 2020 2059 6f75 2073  ils...     You s\n-00000760: 686f 756c 6420 6861 7665 2072 6563 6569  hould have recei\n-00000770: 7665 6420 6120 636f 7079 206f 6620 7468  ved a copy of th\n-00000780: 6520 474e 5520 4765 6e65 7261 6c20 5075  e GNU General Pu\n-00000790: 626c 6963 204c 6963 656e 7365 0a20 2020  blic License.   \n-000007a0: 2020 616c 6f6e 6720 7769 7468 2074 6869    along with thi\n-000007b0: 7320 6d61 6e75 616c 3b20 6966 206e 6f74  s manual; if not\n-000007c0: 2c20 7772 6974 6520 746f 2074 6865 2046  , write to the F\n-000007d0: 7265 6520 536f 6674 7761 7265 0a20 2020  ree Software.   \n-000007e0: 2020 466f 756e 6461 7469 6f6e 2c20 496e    Foundation, In\n-000007f0: 632e 2c20 3531 2046 7261 6e6b 6c69 6e20  c., 51 Franklin \n-00000800: 5374 7265 6574 2c20 4669 6674 6820 466c  Street, Fifth Fl\n-00000810: 6f6f 722c 2042 6f73 746f 6e2c 204d 410a  oor, Boston, MA.\n-00000820: 2020 2020 2030 3231 3130 2d31 3330 3120       02110-1301 \n-00000830: 5553 410a 0a2a 204d 656e 753a 0a0a 2a20  USA..* Menu:..* \n-00000840: 496e 7472 6f64 7563 7469 6f6e 3a3a 2020  Introduction::  \n-00000850: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000860: 486f 7720 746f 2075 7365 2074 6869 7320  How to use this \n-00000870: 6d61 6e75 616c 0a2a 2050 7265 7061 7261  manual.* Prepara\n-00000880: 7469 6f6e 3a3a 2020 2020 2020 2020 2020  tion::          \n-00000890: 2020 2020 2020 2020 2057 6861 7420 796f           What yo\n-000008a0: 7520 7368 6f75 6c64 2064 6f20 6265 666f  u should do befo\n-000008b0: 7265 2075 7369 6e67 2074 6865 206c 6962  re using the lib\n-000008c0: 7261 7279 0a2a 2055 7369 6e67 206c 6962  rary.* Using lib\n-000008d0: 666b 6f3a 3a20 2020 2020 2020 2020 2020  fko::           \n-000008e0: 2020 2020 2020 2048 6f77 2074 6f20 7573         How to us\n-000008f0: 6520 6c69 6266 6b6f 2069 6e20 796f 7572  e libfko in your\n-00000900: 2070 726f 6772 616d 0a0a 4170 7065 6e64   program..Append\n-00000910: 6963 6573 0a0a 2a20 4c69 6272 6172 7920  ices..* Library \n-00000920: 436f 7079 696e 673a 3a20 2020 2020 2020  Copying::       \n-00000930: 2020 2020 2020 2020 5468 6520 474e 5520          The GNU \n-00000940: 4765 6e65 7261 6c20 5075 626c 6963 204c  General Public L\n-00000950: 6963 656e 7365 2073 6179 730a 2020 2020  icense says.    \n+000000a0: 7064 6174 6564 2038 204a 616e 7561 7279  pdated 8 January\n+000000b0: 2032 3032 3429 2e0a 0a20 2020 436f 7079   2024)...   Copy\n+000000c0: 7269 6768 7420 2843 2920 3230 3039 2d32  right (C) 2009-2\n+000000d0: 3031 3320 4461 6d69 656e 2053 7475 6172  013 Damien Stuar\n+000000e0: 742e 0a0a 2020 2020 2054 6865 206c 6962  t...     The lib\n+000000f0: 666b 6f20 6d61 6e75 616c 2069 7320 6672  fko manual is fr\n+00000100: 6565 3b20 796f 7520 6361 6e20 7265 6469  ee; you can redi\n+00000110: 7374 7269 6275 7465 2069 7420 616e 642f  stribute it and/\n+00000120: 6f72 206d 6f64 6966 7920 6974 0a20 2020  or modify it.   \n+00000130: 2020 756e 6465 7220 7468 6520 7465 726d    under the term\n+00000140: 7320 6f66 2074 6865 2047 4e55 2047 656e  s of the GNU Gen\n+00000150: 6572 616c 2050 7562 6c69 6320 4c69 6365  eral Public Lice\n+00000160: 6e73 6520 6173 2070 7562 6c69 7368 6564  nse as published\n+00000170: 2062 790a 2020 2020 2074 6865 2046 7265   by.     the Fre\n+00000180: 6520 536f 6674 7761 7265 2046 6f75 6e64  e Software Found\n+00000190: 6174 696f 6e3b 2065 6974 6865 7220 7665  ation; either ve\n+000001a0: 7273 696f 6e20 3220 6f66 2074 6865 204c  rsion 2 of the L\n+000001b0: 6963 656e 7365 2c20 6f72 0a20 2020 2020  icense, or.     \n+000001c0: 2861 7420 796f 7572 206f 7074 696f 6e29  (at your option)\n+000001d0: 2061 6e79 206c 6174 6572 2076 6572 7369   any later versi\n+000001e0: 6f6e 2e0a 0a20 2020 2020 5468 6520 6c69  on...     The li\n+000001f0: 6266 6b6f 206d 616e 7561 6c20 6973 2064  bfko manual is d\n+00000200: 6973 7472 6962 7574 6564 2069 6e20 7468  istributed in th\n+00000210: 6520 686f 7065 2074 6861 7420 6974 2077  e hope that it w\n+00000220: 696c 6c20 6265 0a20 2020 2020 7573 6566  ill be.     usef\n+00000230: 756c 2c20 6275 7420 5749 5448 4f55 5420  ul, but WITHOUT \n+00000240: 414e 5920 5741 5252 414e 5459 3b20 7769  ANY WARRANTY; wi\n+00000250: 7468 6f75 7420 6576 656e 2074 6865 2069  thout even the i\n+00000260: 6d70 6c69 6564 2077 6172 7261 6e74 790a  mplied warranty.\n+00000270: 2020 2020 206f 6620 4d45 5243 4841 4e54       of MERCHANT\n+00000280: 4142 494c 4954 5920 6f72 2046 4954 4e45  ABILITY or FITNE\n+00000290: 5353 2046 4f52 2041 2050 4152 5449 4355  SS FOR A PARTICU\n+000002a0: 4c41 5220 5055 5250 4f53 452e 2053 6565  LAR PURPOSE. See\n+000002b0: 2074 6865 2047 4e55 0a20 2020 2020 4765   the GNU.     Ge\n+000002c0: 6e65 7261 6c20 5075 626c 6963 204c 6963  neral Public Lic\n+000002d0: 656e 7365 2066 6f72 206d 6f72 6520 6465  ense for more de\n+000002e0: 7461 696c 732e 0a0a 2020 2020 2059 6f75  tails...     You\n+000002f0: 2073 686f 756c 6420 6861 7665 2072 6563   should have rec\n+00000300: 6569 7665 6420 6120 636f 7079 206f 6620  eived a copy of \n+00000310: 7468 6520 474e 5520 4765 6e65 7261 6c20  the GNU General \n+00000320: 5075 626c 6963 204c 6963 656e 7365 0a20  Public License. \n+00000330: 2020 2020 616c 6f6e 6720 7769 7468 2074      along with t\n+00000340: 6869 7320 6d61 6e75 616c 3b20 6966 206e  his manual; if n\n+00000350: 6f74 2c20 7772 6974 6520 746f 2074 6865  ot, write to the\n+00000360: 2046 7265 6520 536f 6674 7761 7265 0a20   Free Software. \n+00000370: 2020 2020 466f 756e 6461 7469 6f6e 2c20      Foundation, \n+00000380: 496e 632e 2c20 3531 2046 7261 6e6b 6c69  Inc., 51 Frankli\n+00000390: 6e20 5374 7265 6574 2c20 4669 6674 6820  n Street, Fifth \n+000003a0: 466c 6f6f 722c 2042 6f73 746f 6e2c 204d  Floor, Boston, M\n+000003b0: 410a 2020 2020 2030 3231 3130 2d31 3330  A.     02110-130\n+000003c0: 3120 5553 410a 494e 464f 2d44 4952 2d53  1 USA.INFO-DIR-S\n+000003d0: 4543 5449 4f4e 204e 6574 776f 726b 2053  ECTION Network S\n+000003e0: 6563 7572 6974 790a 5354 4152 542d 494e  ecurity.START-IN\n+000003f0: 464f 2d44 4952 2d45 4e54 5259 0a2a 206c  FO-DIR-ENTRY.* l\n+00000400: 6962 666b 6f3a 2028 6c69 6266 6b6f 292e  ibfko: (libfko).\n+00000410: 2020 2020 5468 6520 4669 7265 5761 6c6c      The FireWall\n+00000420: 204b 4e6f 636b 204f 5065 7261 746f 7220   KNock OPerator \n+00000430: 2866 776b 6e6f 7029 204c 6962 7261 7279  (fwknop) Library\n+00000440: 202d 206c 6962 666b 6f0a 454e 442d 494e   - libfko.END-IN\n+00000450: 464f 2d44 4952 2d45 4e54 5259 0a0a 1f0a  FO-DIR-ENTRY....\n+00000460: 4669 6c65 3a20 6c69 6266 6b6f 2e69 6e66  File: libfko.inf\n+00000470: 6f2c 2020 4e6f 6465 3a20 546f 702c 2020  o,  Node: Top,  \n+00000480: 4e65 7874 3a20 496e 7472 6f64 7563 7469  Next: Introducti\n+00000490: 6f6e 2c20 2055 703a 2028 6469 7229 0a0a  on,  Up: (dir)..\n+000004a0: 4d61 696e 204d 656e 750a 2a2a 2a2a 2a2a  Main Menu.******\n+000004b0: 2a2a 2a0a 0a54 6869 7320 6d61 6e75 616c  ***..This manual\n+000004c0: 2069 7320 666f 7220 7468 6520 4669 7265   is for the Fire\n+000004d0: 7761 6c6c 204b 6e6f 636b 204f 7065 7261  wall Knock Opera\n+000004e0: 746f 7220 6c69 6272 6172 792c 206c 6962  tor library, lib\n+000004f0: 666b 6f2e 0a28 7665 7273 696f 6e20 322e  fko..(version 2.\n+00000500: 362e 3130 2c20 6c61 7374 2075 7064 6174  6.10, last updat\n+00000510: 6564 2038 204a 616e 7561 7279 2032 3032  ed 8 January 202\n+00000520: 3429 2e0a 0a20 2020 436f 7079 7269 6768  4)...   Copyrigh\n+00000530: 7420 2843 2920 3230 3039 2d32 3031 3320  t (C) 2009-2013 \n+00000540: 4461 6d69 656e 2053 7475 6172 742e 0a0a  Damien Stuart...\n+00000550: 2020 2020 2054 6865 206c 6962 666b 6f20       The libfko \n+00000560: 6d61 6e75 616c 2069 7320 6672 6565 3b20  manual is free; \n+00000570: 796f 7520 6361 6e20 7265 6469 7374 7269  you can redistri\n+00000580: 6275 7465 2069 7420 616e 642f 6f72 206d  bute it and/or m\n+00000590: 6f64 6966 7920 6974 0a20 2020 2020 756e  odify it.     un\n+000005a0: 6465 7220 7468 6520 7465 726d 7320 6f66  der the terms of\n+000005b0: 2074 6865 2047 4e55 2047 656e 6572 616c   the GNU General\n+000005c0: 2050 7562 6c69 6320 4c69 6365 6e73 6520   Public License \n+000005d0: 6173 2070 7562 6c69 7368 6564 2062 790a  as published by.\n+000005e0: 2020 2020 2074 6865 2046 7265 6520 536f       the Free So\n+000005f0: 6674 7761 7265 2046 6f75 6e64 6174 696f  ftware Foundatio\n+00000600: 6e3b 2065 6974 6865 7220 7665 7273 696f  n; either versio\n+00000610: 6e20 3220 6f66 2074 6865 204c 6963 656e  n 2 of the Licen\n+00000620: 7365 2c20 6f72 0a20 2020 2020 2861 7420  se, or.     (at \n+00000630: 796f 7572 206f 7074 696f 6e29 2061 6e79  your option) any\n+00000640: 206c 6174 6572 2076 6572 7369 6f6e 2e0a   later version..\n+00000650: 0a20 2020 2020 5468 6520 6c69 6266 6b6f  .     The libfko\n+00000660: 206d 616e 7561 6c20 6973 2064 6973 7472   manual is distr\n+00000670: 6962 7574 6564 2069 6e20 7468 6520 686f  ibuted in the ho\n+00000680: 7065 2074 6861 7420 6974 2077 696c 6c20  pe that it will \n+00000690: 6265 0a20 2020 2020 7573 6566 756c 2c20  be.     useful, \n+000006a0: 6275 7420 5749 5448 4f55 5420 414e 5920  but WITHOUT ANY \n+000006b0: 5741 5252 414e 5459 3b20 7769 7468 6f75  WARRANTY; withou\n+000006c0: 7420 6576 656e 2074 6865 2069 6d70 6c69  t even the impli\n+000006d0: 6564 2077 6172 7261 6e74 790a 2020 2020  ed warranty.    \n+000006e0: 206f 6620 4d45 5243 4841 4e54 4142 494c   of MERCHANTABIL\n+000006f0: 4954 5920 6f72 2046 4954 4e45 5353 2046  ITY or FITNESS F\n+00000700: 4f52 2041 2050 4152 5449 4355 4c41 5220  OR A PARTICULAR \n+00000710: 5055 5250 4f53 452e 2053 6565 2074 6865  PURPOSE. See the\n+00000720: 2047 4e55 0a20 2020 2020 4765 6e65 7261   GNU.     Genera\n+00000730: 6c20 5075 626c 6963 204c 6963 656e 7365  l Public License\n+00000740: 2066 6f72 206d 6f72 6520 6465 7461 696c   for more detail\n+00000750: 732e 0a0a 2020 2020 2059 6f75 2073 686f  s...     You sho\n+00000760: 756c 6420 6861 7665 2072 6563 6569 7665  uld have receive\n+00000770: 6420 6120 636f 7079 206f 6620 7468 6520  d a copy of the \n+00000780: 474e 5520 4765 6e65 7261 6c20 5075 626c  GNU General Publ\n+00000790: 6963 204c 6963 656e 7365 0a20 2020 2020  ic License.     \n+000007a0: 616c 6f6e 6720 7769 7468 2074 6869 7320  along with this \n+000007b0: 6d61 6e75 616c 3b20 6966 206e 6f74 2c20  manual; if not, \n+000007c0: 7772 6974 6520 746f 2074 6865 2046 7265  write to the Fre\n+000007d0: 6520 536f 6674 7761 7265 0a20 2020 2020  e Software.     \n+000007e0: 466f 756e 6461 7469 6f6e 2c20 496e 632e  Foundation, Inc.\n+000007f0: 2c20 3531 2046 7261 6e6b 6c69 6e20 5374  , 51 Franklin St\n+00000800: 7265 6574 2c20 4669 6674 6820 466c 6f6f  reet, Fifth Floo\n+00000810: 722c 2042 6f73 746f 6e2c 204d 410a 2020  r, Boston, MA.  \n+00000820: 2020 2030 3231 3130 2d31 3330 3120 5553     02110-1301 US\n+00000830: 410a 0a2a 204d 656e 753a 0a0a 2a20 496e  A..* Menu:..* In\n+00000840: 7472 6f64 7563 7469 6f6e 3a3a 2020 2020  troduction::    \n+00000850: 2020 2020 2020 2020 2020 2020 2020 486f                Ho\n+00000860: 7720 746f 2075 7365 2074 6869 7320 6d61  w to use this ma\n+00000870: 6e75 616c 0a2a 2050 7265 7061 7261 7469  nual.* Preparati\n+00000880: 6f6e 3a3a 2020 2020 2020 2020 2020 2020  on::            \n+00000890: 2020 2020 2020 2057 6861 7420 796f 7520         What you \n+000008a0: 7368 6f75 6c64 2064 6f20 6265 666f 7265  should do before\n+000008b0: 2075 7369 6e67 2074 6865 206c 6962 7261   using the libra\n+000008c0: 7279 0a2a 2055 7369 6e67 206c 6962 666b  ry.* Using libfk\n+000008d0: 6f3a 3a20 2020 2020 2020 2020 2020 2020  o::             \n+000008e0: 2020 2020 2048 6f77 2074 6f20 7573 6520       How to use \n+000008f0: 6c69 6266 6b6f 2069 6e20 796f 7572 2070  libfko in your p\n+00000900: 726f 6772 616d 0a0a 4170 7065 6e64 6963  rogram..Appendic\n+00000910: 6573 0a0a 2a20 4c69 6272 6172 7920 436f  es..* Library Co\n+00000920: 7079 696e 673a 3a20 2020 2020 2020 2020  pying::         \n+00000930: 2020 2020 2020 5468 6520 474e 5520 4765        The GNU Ge\n+00000940: 6e65 7261 6c20 5075 626c 6963 204c 6963  neral Public Lic\n+00000950: 656e 7365 2073 6179 730a 2020 2020 2020  ense says.      \n 00000960: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000970: 2020 2020 2020 2020 2020 2020 2020 686f                ho\n-00000980: 7720 796f 7520 6361 6e20 636f 7079 2061  w you can copy a\n-00000990: 6e64 2073 6861 7265 0a49 6e64 6963 6573  nd share.Indices\n-000009a0: 0a0a 2a20 436f 6e63 6570 7420 496e 6465  ..* Concept Inde\n-000009b0: 783a 3a20 2020 2020 2020 2020 2020 2020  x::             \n-000009c0: 2020 2020 496e 6465 7820 6f66 2063 6f6e      Index of con\n-000009d0: 6365 7074 7320 616e 6420 7072 6f67 7261  cepts and progra\n-000009e0: 6d73 0a2a 2046 756e 6374 696f 6e20 616e  ms.* Function an\n-000009f0: 6420 4461 7461 2049 6e64 6578 3a3a 2020  d Data Index::  \n-00000a00: 2020 2020 2049 6e64 6578 206f 6620 6675       Index of fu\n-00000a10: 6e63 7469 6f6e 732c 2076 6172 6961 626c  nctions, variabl\n-00000a20: 6573 2061 6e64 2064 6174 6120 7479 7065  es and data type\n-00000a30: 730a 0a20 2d2d 2054 6865 2044 6574 6169  s.. -- The Detai\n-00000a40: 6c65 6420 4e6f 6465 204c 6973 7469 6e67  led Node Listing\n-00000a50: 202d 2d0a 0a49 6e74 726f 6475 6374 696f   --..Introductio\n-00000a60: 6e0a 0a2a 2047 6574 7469 6e67 2053 7461  n..* Getting Sta\n-00000a70: 7274 6564 3a3a 2020 2020 2020 2020 2020  rted::          \n-00000a80: 2020 2020 2050 7572 706f 7365 206f 6620       Purpose of \n-00000a90: 7468 6520 6d61 6e75 616c 2c20 616e 6420  the manual, and \n-00000aa0: 686f 7720 746f 2075 7365 2069 740a 2a20  how to use it.* \n-00000ab0: 4665 6174 7572 6573 3a3a 2020 2020 2020  Features::      \n-00000ac0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000ad0: 5265 6173 6f6e 7320 746f 2069 6e73 7461  Reasons to insta\n-00000ae0: 6c6c 2061 6e64 2075 7365 206c 6962 666b  ll and use libfk\n-00000af0: 6f0a 2a20 4f76 6572 7669 6577 3a3a 2020  o.* Overview::  \n+00000970: 2020 2020 2020 2020 2020 2020 686f 7720              how \n+00000980: 796f 7520 6361 6e20 636f 7079 2061 6e64  you can copy and\n+00000990: 2073 6861 7265 0a49 6e64 6963 6573 0a0a   share.Indices..\n+000009a0: 2a20 436f 6e63 6570 7420 496e 6465 783a  * Concept Index:\n+000009b0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               \n+000009c0: 2020 496e 6465 7820 6f66 2063 6f6e 6365    Index of conce\n+000009d0: 7074 7320 616e 6420 7072 6f67 7261 6d73  pts and programs\n+000009e0: 0a2a 2046 756e 6374 696f 6e20 616e 6420  .* Function and \n+000009f0: 4461 7461 2049 6e64 6578 3a3a 2020 2020  Data Index::    \n+00000a00: 2020 2049 6e64 6578 206f 6620 6675 6e63     Index of func\n+00000a10: 7469 6f6e 732c 2076 6172 6961 626c 6573  tions, variables\n+00000a20: 2061 6e64 2064 6174 6120 7479 7065 730a   and data types.\n+00000a30: 0a20 2d2d 2054 6865 2044 6574 6169 6c65  . -- The Detaile\n+00000a40: 6420 4e6f 6465 204c 6973 7469 6e67 202d  d Node Listing -\n+00000a50: 2d0a 0a49 6e74 726f 6475 6374 696f 6e0a  -..Introduction.\n+00000a60: 0a2a 2047 6574 7469 6e67 2053 7461 7274  .* Getting Start\n+00000a70: 6564 3a3a 2020 2020 2020 2020 2020 2020  ed::            \n+00000a80: 2020 2050 7572 706f 7365 206f 6620 7468     Purpose of th\n+00000a90: 6520 6d61 6e75 616c 2c20 616e 6420 686f  e manual, and ho\n+00000aa0: 7720 746f 2075 7365 2069 740a 2a20 4665  w to use it.* Fe\n+00000ab0: 6174 7572 6573 3a3a 2020 2020 2020 2020  atures::        \n+00000ac0: 2020 2020 2020 2020 2020 2020 2020 5265                Re\n+00000ad0: 6173 6f6e 7320 746f 2069 6e73 7461 6c6c  asons to install\n+00000ae0: 2061 6e64 2075 7365 206c 6962 666b 6f0a   and use libfko.\n+00000af0: 2a20 4f76 6572 7669 6577 3a3a 2020 2020  * Overview::    \n 00000b00: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000b10: 2020 2020 4261 7369 6320 6f76 6572 7669      Basic overvi\n-00000b20: 6577 206f 6620 5350 4120 616e 640a 2020  ew of SPA and.  \n+00000b10: 2020 4261 7369 6320 6f76 6572 7669 6577    Basic overview\n+00000b20: 206f 6620 5350 4120 616e 640a 2020 2020   of SPA and.    \n 00000b30: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000b40: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000b50: 6172 6368 6974 6563 7475 7265 206f 6620  architecture of \n-00000b60: 7468 6520 6c69 6266 6b6f 206c 6962 7261  the libfko libra\n-00000b70: 7279 0a0a 4f76 6572 7669 6577 0a0a 2a20  ry..Overview..* \n-00000b80: 5350 4120 4461 7461 2046 6f72 6d61 743a  SPA Data Format:\n-00000b90: 3a20 2020 2020 2020 2020 2020 2020 2020  :               \n-00000ba0: 4465 7363 7269 7074 696f 6e20 6f66 2074  Description of t\n-00000bb0: 6865 2053 5041 2064 6174 610a 2020 2020  he SPA data.    \n+00000b40: 2020 2020 2020 2020 2020 2020 2020 6172                ar\n+00000b50: 6368 6974 6563 7475 7265 206f 6620 7468  chitecture of th\n+00000b60: 6520 6c69 6266 6b6f 206c 6962 7261 7279  e libfko library\n+00000b70: 0a0a 4f76 6572 7669 6577 0a0a 2a20 5350  ..Overview..* SP\n+00000b80: 4120 4461 7461 2046 6f72 6d61 743a 3a20  A Data Format:: \n+00000b90: 2020 2020 2020 2020 2020 2020 2020 4465                De\n+00000ba0: 7363 7269 7074 696f 6e20 6f66 2074 6865  scription of the\n+00000bb0: 2053 5041 2064 6174 610a 2020 2020 2020   SPA data.      \n 00000bc0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000bd0: 2020 2020 2020 2020 2020 2020 2020 666f                fo\n-00000be0: 726d 6174 2e0a 0a50 7265 7061 7261 7469  rmat...Preparati\n-00000bf0: 6f6e 0a0a 2a20 6c69 6266 6b6f 2048 6561  on..* libfko Hea\n-00000c00: 6465 723a 3a20 2020 2020 2020 2020 2020  der::           \n-00000c10: 2020 2020 2020 5768 6174 2068 6561 6465        What heade\n-00000c20: 7220 6669 6c65 2079 6f75 206e 6565 6420  r file you need \n-00000c30: 746f 2069 6e63 6c75 6465 0a2a 2043 6f6d  to include.* Com\n-00000c40: 7069 6c69 6e67 2077 6974 6820 6c69 6266  piling with libf\n-00000c50: 6b6f 3a3a 2020 2020 2020 2020 2057 6861  ko::         Wha\n-00000c60: 7420 796f 7520 6e65 6564 2074 6f20 636f  t you need to co\n-00000c70: 6d70 696c 6520 616e 6420 6c69 6e6b 2079  mpile and link y\n-00000c80: 6f75 720a 2020 2020 2020 2020 2020 2020  our.            \n+00000bd0: 2020 2020 2020 2020 2020 2020 666f 726d              form\n+00000be0: 6174 2e0a 0a50 7265 7061 7261 7469 6f6e  at...Preparation\n+00000bf0: 0a0a 2a20 6c69 6266 6b6f 2048 6561 6465  ..* libfko Heade\n+00000c00: 723a 3a20 2020 2020 2020 2020 2020 2020  r::             \n+00000c10: 2020 2020 5768 6174 2068 6561 6465 7220      What header \n+00000c20: 6669 6c65 2079 6f75 206e 6565 6420 746f  file you need to\n+00000c30: 2069 6e63 6c75 6465 0a2a 2043 6f6d 7069   include.* Compi\n+00000c40: 6c69 6e67 2077 6974 6820 6c69 6266 6b6f  ling with libfko\n+00000c50: 3a3a 2020 2020 2020 2020 2057 6861 7420  ::         What \n+00000c60: 796f 7520 6e65 6564 2074 6f20 636f 6d70  you need to comp\n+00000c70: 696c 6520 616e 6420 6c69 6e6b 2079 6f75  ile and link you\n+00000c80: 720a 2020 2020 2020 2020 2020 2020 2020  r.              \n 00000c90: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000ca0: 2020 2020 2020 7072 6f67 7261 6d20 7769        program wi\n-00000cb0: 7468 206c 6962 666b 6f0a 2a20 5350 4120  th libfko.* SPA \n-00000cc0: 5061 7261 6d65 7465 7220 5479 7065 733a  Parameter Types:\n-00000cd0: 3a20 2020 2020 2020 2020 2020 5468 6520  :           The \n-00000ce0: 6176 6169 6c61 626c 6520 6469 6765 7374  available digest\n-00000cf0: 732c 206d 6573 7361 6765 2074 7970 6573  s, message types\n-00000d00: 2061 6e64 0a20 2020 2020 2020 2020 2020   and.           \n+00000ca0: 2020 2020 7072 6f67 7261 6d20 7769 7468      program with\n+00000cb0: 206c 6962 666b 6f0a 2a20 5350 4120 5061   libfko.* SPA Pa\n+00000cc0: 7261 6d65 7465 7220 5479 7065 733a 3a20  rameter Types:: \n+00000cd0: 2020 2020 2020 2020 2020 5468 6520 6176            The av\n+00000ce0: 6169 6c61 626c 6520 6469 6765 7374 732c  ailable digests,\n+00000cf0: 206d 6573 7361 6765 2074 7970 6573 2061   message types a\n+00000d00: 6e64 0a20 2020 2020 2020 2020 2020 2020  nd.             \n 00000d10: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000d20: 2020 2020 2020 206d 6f64 6573 206f 6620         modes of \n-00000d30: 656e 6372 7970 7469 6f6e 2066 6f72 2053  encryption for S\n-00000d40: 5041 2064 6174 610a 5573 696e 6720 6c69  PA data.Using li\n-00000d50: 6266 6b6f 0a0a 2a20 4372 6561 7469 6e67  bfko..* Creating\n-00000d60: 2043 6f6e 7465 7874 733a 3a20 2020 2020   Contexts::     \n-00000d70: 2020 2020 2020 2020 4372 6561 7469 6e67          Creating\n-00000d80: 2061 206e 6577 2066 6b6f 2063 6f6e 7465   a new fko conte\n-00000d90: 7874 0a2a 2044 6573 7472 6f79 696e 6720  xt.* Destroying \n-00000da0: 436f 6e74 6578 7473 3a3a 2020 2020 2020  Contexts::      \n-00000db0: 2020 2020 2052 656c 6561 7369 6e67 2061       Releasing a\n-00000dc0: 6e20 666b 6f20 636f 6e74 6578 740a 2a20  n fko context.* \n-00000dd0: 4372 6561 7469 6e67 2061 2053 5041 204d  Creating a SPA M\n-00000de0: 6573 7361 6765 3a3a 2020 2020 2020 2020  essage::        \n-00000df0: 5768 6174 2069 7420 7461 6b65 7320 746f  What it takes to\n-00000e00: 2063 7265 6174 6520 6120 5350 410a 2020   create a SPA.  \n+00000d20: 2020 2020 206d 6f64 6573 206f 6620 656e       modes of en\n+00000d30: 6372 7970 7469 6f6e 2066 6f72 2053 5041  cryption for SPA\n+00000d40: 2064 6174 610a 5573 696e 6720 6c69 6266   data.Using libf\n+00000d50: 6b6f 0a0a 2a20 4372 6561 7469 6e67 2043  ko..* Creating C\n+00000d60: 6f6e 7465 7874 733a 3a20 2020 2020 2020  ontexts::       \n+00000d70: 2020 2020 2020 4372 6561 7469 6e67 2061        Creating a\n+00000d80: 206e 6577 2066 6b6f 2063 6f6e 7465 7874   new fko context\n+00000d90: 0a2a 2044 6573 7472 6f79 696e 6720 436f  .* Destroying Co\n+00000da0: 6e74 6578 7473 3a3a 2020 2020 2020 2020  ntexts::        \n+00000db0: 2020 2052 656c 6561 7369 6e67 2061 6e20     Releasing an \n+00000dc0: 666b 6f20 636f 6e74 6578 740a 2a20 4372  fko context.* Cr\n+00000dd0: 6561 7469 6e67 2061 2053 5041 204d 6573  eating a SPA Mes\n+00000de0: 7361 6765 3a3a 2020 2020 2020 2020 5768  sage::        Wh\n+00000df0: 6174 2069 7420 7461 6b65 7320 746f 2063  at it takes to c\n+00000e00: 7265 6174 6520 6120 5350 410a 2020 2020  reate a SPA.    \n 00000e10: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000e20: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000e30: 6d65 7373 6167 650a 2a20 5365 7474 696e  message.* Settin\n-00000e40: 6720 5350 4120 4461 7461 3a3a 2020 2020  g SPA Data::    \n-00000e50: 2020 2020 2020 2020 2020 5365 7474 696e            Settin\n-00000e60: 6720 5350 4120 6461 7461 0a2a 2052 6574  g SPA data.* Ret\n-00000e70: 7269 6576 696e 6720 5350 4120 4461 7461  rieving SPA Data\n-00000e80: 3a3a 2020 2020 2020 2020 2020 2052 6574  ::           Ret\n-00000e90: 7269 6576 696e 6720 5350 4120 6461 7461  rieving SPA data\n-00000ea0: 0a2a 2055 7469 6c69 7479 2046 756e 6374  .* Utility Funct\n-00000eb0: 696f 6e73 3a3a 2020 2020 2020 2020 2020  ions::          \n-00000ec0: 2020 204f 7468 6572 2075 7469 6c69 7479     Other utility\n-00000ed0: 2c20 6d69 7363 656c 6c61 6e65 6f75 732c  , miscellaneous,\n-00000ee0: 2061 6e64 2073 656c 646f 6d0a 2020 2020   and seldom.    \n+00000e20: 2020 2020 2020 2020 2020 2020 2020 6d65                me\n+00000e30: 7373 6167 650a 2a20 5365 7474 696e 6720  ssage.* Setting \n+00000e40: 5350 4120 4461 7461 3a3a 2020 2020 2020  SPA Data::      \n+00000e50: 2020 2020 2020 2020 5365 7474 696e 6720          Setting \n+00000e60: 5350 4120 6461 7461 0a2a 2052 6574 7269  SPA data.* Retri\n+00000e70: 6576 696e 6720 5350 4120 4461 7461 3a3a  eving SPA Data::\n+00000e80: 2020 2020 2020 2020 2020 2052 6574 7269             Retri\n+00000e90: 6576 696e 6720 5350 4120 6461 7461 0a2a  eving SPA data.*\n+00000ea0: 2055 7469 6c69 7479 2046 756e 6374 696f   Utility Functio\n+00000eb0: 6e73 3a3a 2020 2020 2020 2020 2020 2020  ns::            \n+00000ec0: 204f 7468 6572 2075 7469 6c69 7479 2c20   Other utility, \n+00000ed0: 6d69 7363 656c 6c61 6e65 6f75 732c 2061  miscellaneous, a\n+00000ee0: 6e64 2073 656c 646f 6d0a 2020 2020 2020  nd seldom.      \n 00000ef0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000f00: 2020 2020 2020 2020 2020 2020 2020 7573                us\n-00000f10: 6564 2066 756e 6374 696f 6e73 0a2a 2045  ed functions.* E\n-00000f20: 7272 6f72 2048 616e 646c 696e 673a 3a20  rror Handling:: \n-00000f30: 2020 2020 2020 2020 2020 2020 2020 2050                 P\n-00000f40: 6f73 7369 626c 6520 6572 726f 7273 2061  ossible errors a\n-00000f50: 6e64 2074 6865 6972 206d 6561 6e69 6e67  nd their meaning\n-00000f60: 0a0a 5350 4120 5061 7261 6d65 7465 7220  ..SPA Parameter \n-00000f70: 5479 7065 730a 0a2a 2044 6967 6573 7473  Types..* Digests\n-00000f80: 3a3a 2020 2020 2020 2020 2020 2020 2020  ::              \n-00000f90: 2020 2020 2020 2020 2054 6865 206d 6573           The mes\n-00000fa0: 7361 6765 2064 6967 6573 7420 6861 7368  sage digest hash\n-00000fb0: 6573 2073 7570 706f 7274 6564 2062 7920  es supported by \n-00000fc0: 6c69 6266 6b6f 0a2a 2053 5041 204d 6573  libfko.* SPA Mes\n-00000fd0: 7361 6765 733a 3a20 2020 2020 2020 2020  sages::         \n-00000fe0: 2020 2020 2020 2020 2054 6865 2066 6b6f           The fko\n-00000ff0: 2053 5041 206d 6573 7361 6765 2074 7970   SPA message typ\n-00001000: 6573 0a20 2020 2020 2020 2020 2020 2020  es.             \n+00000f00: 2020 2020 2020 2020 2020 2020 7573 6564              used\n+00000f10: 2066 756e 6374 696f 6e73 0a2a 2045 7272   functions.* Err\n+00000f20: 6f72 2048 616e 646c 696e 673a 3a20 2020  or Handling::   \n+00000f30: 2020 2020 2020 2020 2020 2020 2050 6f73               Pos\n+00000f40: 7369 626c 6520 6572 726f 7273 2061 6e64  sible errors and\n+00000f50: 2074 6865 6972 206d 6561 6e69 6e67 0a0a   their meaning..\n+00000f60: 5350 4120 5061 7261 6d65 7465 7220 5479  SPA Parameter Ty\n+00000f70: 7065 730a 0a2a 2044 6967 6573 7473 3a3a  pes..* Digests::\n+00000f80: 2020 2020 2020 2020 2020 2020 2020 2020                  \n+00000f90: 2020 2020 2020 2054 6865 206d 6573 7361         The messa\n+00000fa0: 6765 2064 6967 6573 7420 6861 7368 6573  ge digest hashes\n+00000fb0: 2073 7570 706f 7274 6564 2062 7920 6c69   supported by li\n+00000fc0: 6266 6b6f 0a2a 2053 5041 204d 6573 7361  bfko.* SPA Messa\n+00000fd0: 6765 733a 3a20 2020 2020 2020 2020 2020  ges::           \n+00000fe0: 2020 2020 2020 2054 6865 2066 6b6f 2053         The fko S\n+00000ff0: 5041 206d 6573 7361 6765 2074 7970 6573  PA message types\n+00001000: 0a20 2020 2020 2020 2020 2020 2020 2020  .               \n 00001010: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00001020: 2020 2020 2073 7570 706f 7274 6564 2062       supported b\n-00001030: 7920 6c69 6266 6b6f 2028 616e 6420 6677  y libfko (and fw\n-00001040: 6b6e 6f70 290a 2a20 456e 6372 7970 7469  knop).* Encrypti\n-00001050: 6f6e 2041 6c67 6f72 6974 686d 733a 3a20  on Algorithms:: \n-00001060: 2020 2020 2020 2020 456e 6372 7970 7469          Encrypti\n-00001070: 6f6e 2073 6368 656d 6573 2073 7570 706f  on schemes suppo\n-00001080: 7274 6564 2062 7920 6c69 6266 6b6f 0a2a  rted by libfko.*\n-00001090: 2048 4d41 4320 4469 6765 7374 733a 3a20   HMAC Digests:: \n-000010a0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000010b0: 2044 6967 6573 7473 2074 6861 7420 6361   Digests that ca\n-000010c0: 6e20 6265 2075 7365 6420 746f 2062 7569  n be used to bui\n-000010d0: 6c64 2061 6e20 484d 4143 0a0a 0a1f 0a46  ld an HMAC.....F\n-000010e0: 696c 653a 206c 6962 666b 6f2e 696e 666f  ile: libfko.info\n-000010f0: 2c20 204e 6f64 653a 2049 6e74 726f 6475  ,  Node: Introdu\n-00001100: 6374 696f 6e2c 2020 4e65 7874 3a20 5072  ction,  Next: Pr\n-00001110: 6570 6172 6174 696f 6e2c 2020 5072 6576  eparation,  Prev\n-00001120: 3a20 546f 702c 2020 5570 3a20 546f 700a  : Top,  Up: Top.\n-00001130: 0a31 2049 6e74 726f 6475 6374 696f 6e0a  .1 Introduction.\n-00001140: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a  **************..\n-00001150: 5468 6520 2246 6972 6577 616c 6c20 4b6e  The \"Firewall Kn\n-00001160: 6f63 6b20 4f70 6572 6174 6f72 204c 6962  ock Operator Lib\n-00001170: 7261 7279 2220 286c 6962 666b 6f29 2069  rary\" (libfko) i\n-00001180: 7320 6120 4320 6c61 6e67 7561 6765 206c  s a C language l\n-00001190: 6962 7261 7279 0a74 6861 7420 696d 706c  ibrary.that impl\n-000011a0: 656d 656e 7473 2074 6865 2066 756e 6374  ements the funct\n-000011b0: 696f 6e73 206e 6565 6465 6420 746f 2063  ions needed to c\n-000011c0: 7265 6174 6520 616e 642f 6f72 2070 6172  reate and/or par\n-000011d0: 7365 2022 5369 6e67 6c65 0a50 6163 6b65  se \"Single.Packe\n-000011e0: 7420 4175 7468 6f72 697a 6174 696f 6e22  t Authorization\"\n-000011f0: 2028 5350 4129 2064 6174 612e 2020 4974   (SPA) data.  It\n-00001200: 2069 7320 6465 7369 676e 6564 2074 6f20   is designed to \n-00001210: 6162 7374 7261 6374 2074 6865 0a64 6574  abstract the.det\n-00001220: 6169 6c73 206f 6620 656e 636f 6469 6e67  ails of encoding\n-00001230: 2c20 656e 6372 7970 7469 6f6e 2c20 6465  , encryption, de\n-00001240: 636f 6469 6e67 2c20 7061 7273 696e 672c  coding, parsing,\n-00001250: 2061 6e64 2076 6572 6966 7969 6e67 2053   and verifying S\n-00001260: 5041 0a6d 6573 7361 6765 7320 7375 6368  PA.messages such\n-00001270: 2061 7320 7468 6f73 6520 7573 6564 2062   as those used b\n-00001280: 7920 4d69 6368 6165 6c20 5261 7368 2773  y Michael Rash's\n-00001290: 2022 4669 7265 7761 6c6c 204b 6e6f 636b   \"Firewall Knock\n-000012a0: 204f 7065 7261 746f 7222 0a28 6677 6b6e   Operator\".(fwkn\n-000012b0: 6f70 292e 0a0a 2020 2022 6677 6b6e 6f70  op)...   \"fwknop\n-000012c0: 2220 696d 706c 656d 656e 7473 2061 6e20  \" implements an \n-000012d0: 6175 7468 6f72 697a 6174 696f 6e20 7363  authorization sc\n-000012e0: 6865 6d65 206b 6e6f 776e 2061 7320 5369  heme known as Si\n-000012f0: 6e67 6c65 2050 6163 6b65 740a 4175 7468  ngle Packet.Auth\n-00001300: 6f72 697a 6174 696f 6e20 2853 5041 2920  orization (SPA) \n-00001310: 666f 7220 7374 726f 6e67 2073 6572 7669  for strong servi\n-00001320: 6365 2070 726f 7465 6374 696f 6e2e 2020  ce protection.  \n-00001330: 5350 4120 7265 7175 6972 6573 206f 6e6c  SPA requires onl\n-00001340: 7920 610a 7369 6e67 6c65 2070 6163 6b65  y a.single packe\n-00001350: 7420 7768 6963 6820 6973 2065 6e63 7279  t which is encry\n-00001360: 7074 6564 2c20 6e6f 6e2d 7265 706c 6179  pted, non-replay\n-00001370: 6162 6c65 2c20 616e 6420 6175 7468 656e  able, and authen\n-00001380: 7469 6361 7465 6420 7669 610a 616e 2048  ticated via.an H\n-00001390: 4d41 4320 696e 206f 7264 6572 2074 6f20  MAC in order to \n-000013a0: 636f 6d6d 756e 6963 6174 6520 6465 7369  communicate desi\n-000013b0: 7265 6420 6163 6365 7373 2074 6f20 6120  red access to a \n-000013c0: 7365 7276 6963 6520 7468 6174 2069 730a  service that is.\n-000013d0: 6869 6464 656e 2062 6568 696e 6420 6120  hidden behind a \n-000013e0: 6669 7265 7761 6c6c 2069 6e20 6120 6465  firewall in a de\n-000013f0: 6661 756c 742d 6472 6f70 2066 696c 7465  fault-drop filte\n-00001400: 7269 6e67 2073 7461 6e63 652e 2020 5468  ring stance.  Th\n-00001410: 6520 6d61 696e 0a61 7070 6c69 6361 7469  e main.applicati\n-00001420: 6f6e 206f 6620 5350 4120 6973 2074 6f20  on of SPA is to \n-00001430: 7573 6520 6120 6669 7265 7761 6c6c 2074  use a firewall t\n-00001440: 6f20 6472 6f70 2061 6c6c 2061 7474 656d  o drop all attem\n-00001450: 7074 7320 746f 2063 6f6e 6e65 6374 0a74  pts to connect.t\n-00001460: 6f20 7365 7276 6963 6573 2073 7563 6820  o services such \n-00001470: 6173 2027 5353 4827 2069 6e20 6f72 6465  as 'SSH' in orde\n-00001480: 7220 746f 206d 616b 6520 7468 6520 6578  r to make the ex\n-00001490: 706c 6f69 7461 7469 6f6e 206f 660a 7675  ploitation of.vu\n-000014a0: 6c6e 6572 6162 696c 6974 6965 7320 2862  lnerabilities (b\n-000014b0: 6f74 6820 302d 6461 7920 616e 6420 756e  oth 0-day and un\n-000014c0: 7061 7463 6865 6420 636f 6465 2920 6d6f  patched code) mo\n-000014d0: 7265 2064 6966 6669 6375 6c74 2e20 2041  re difficult.  A\n-000014e0: 6e79 0a73 6572 7669 6365 2074 6861 7420  ny.service that \n-000014f0: 6973 2070 726f 7465 6374 6564 2062 7920  is protected by \n-00001500: 5350 4120 6e61 7475 7261 6c6c 7920 6361  SPA naturally ca\n-00001510: 6e6e 6f74 2062 6520 7363 616e 6e65 6420  nnot be scanned \n-00001520: 666f 7220 7769 7468 0a27 4e6d 6170 272e  for with.'Nmap'.\n-00001530: 2020 5468 6520 6677 6b6e 6f70 2070 726f    The fwknop pro\n-00001540: 6a65 6374 2073 7570 706f 7274 7320 7468  ject supports th\n-00001550: 7265 6520 6469 6666 6572 656e 7420 6669  ree different fi\n-00001560: 7265 7761 6c6c 733a 0a27 6970 7461 626c  rewalls:.'iptabl\n-00001570: 6573 2720 6f6e 204c 696e 7578 2073 7973  es' on Linux sys\n-00001580: 7465 6d73 2c20 2770 6627 206f 6e20 4f70  tems, 'pf' on Op\n-00001590: 656e 4253 442c 2061 6e64 2027 6970 6677  enBSD, and 'ipfw\n-000015a0: 2720 6f6e 2046 7265 6542 5344 2061 6e64  ' on FreeBSD and\n-000015b0: 0a4d 6163 204f 5320 582e 0a0a 2020 206c  .Mac OS X...   l\n-000015c0: 6962 666b 6f20 6973 206e 6f74 2061 6e20  ibfko is not an \n-000015d0: 696d 706c 656d 656e 7461 7469 6f6e 206f  implementation o\n-000015e0: 6620 616e 2066 776b 6e6f 7020 636c 6965  f an fwknop clie\n-000015f0: 6e74 206f 7220 7365 7276 6572 2e20 2049  nt or server.  I\n-00001600: 740a 7369 6d70 6c79 2070 726f 7669 6465  t.simply provide\n-00001610: 7320 7468 6520 6675 6e63 7469 6f6e 7320  s the functions \n-00001620: 666f 7220 6d61 6e61 6769 6e67 2074 6865  for managing the\n-00001630: 2053 5041 2064 6174 6120 7573 6564 2062   SPA data used b\n-00001640: 7920 7468 6f73 650a 7072 6f67 7261 6d73  y those.programs\n-00001650: 2e0a 0a0a 466f 7220 6d6f 7265 2069 6e66  ....For more inf\n-00001660: 6f72 6d61 7469 6f6e 206f 6e20 6677 6b6e  ormation on fwkn\n-00001670: 6f70 2061 6e64 2053 5041 2c20 676f 2074  op and SPA, go t\n-00001680: 6f0a 3c68 7474 703a 2f2f 7777 772e 6369  o.<http://www.ci\n-00001690: 7068 6572 6479 6e65 2e6f 7267 2f66 776b  pherdyne.org/fwk\n-000016a0: 6e6f 703e 2e0a 0a2a 204d 656e 753a 0a0a  nop>...* Menu:..\n-000016b0: 2a20 4765 7474 696e 6720 5374 6172 7465  * Getting Starte\n-000016c0: 643a 3a20 2020 2020 2020 2020 2020 2020  d::             \n-000016d0: 2020 5075 7270 6f73 6520 6f66 2074 6865    Purpose of the\n-000016e0: 206d 616e 7561 6c2c 2061 6e64 2068 6f77   manual, and how\n-000016f0: 2074 6f20 7573 6520 6974 0a2a 2046 6561   to use it.* Fea\n-00001700: 7475 7265 733a 3a20 2020 2020 2020 2020  tures::         \n-00001710: 2020 2020 2020 2020 2020 2020 2052 6561               Rea\n-00001720: 736f 6e73 2074 6f20 696e 7374 616c 6c20  sons to install \n-00001730: 616e 6420 7573 6520 6c69 6266 6b6f 0a2a  and use libfko.*\n-00001740: 204f 7665 7276 6965 773a 3a20 2020 2020   Overview::     \n-00001750: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00001760: 2042 6173 6963 2061 7263 6869 7465 6374   Basic architect\n-00001770: 7572 6520 6f66 2074 6865 206c 6962 666b  ure of the libfk\n-00001780: 6f20 6c69 6272 6172 790a 0a1f 0a46 696c  o library....Fil\n-00001790: 653a 206c 6962 666b 6f2e 696e 666f 2c20  e: libfko.info, \n-000017a0: 204e 6f64 653a 2047 6574 7469 6e67 2053   Node: Getting S\n-000017b0: 7461 7274 6564 2c20 204e 6578 743a 2046  tarted,  Next: F\n-000017c0: 6561 7475 7265 732c 2020 5570 3a20 496e  eatures,  Up: In\n-000017d0: 7472 6f64 7563 7469 6f6e 0a0a 312e 3120  troduction..1.1 \n-000017e0: 4765 7474 696e 6720 5374 6172 7465 640a  Getting Started.\n+00001020: 2020 2073 7570 706f 7274 6564 2062 7920     supported by \n+00001030: 6c69 6266 6b6f 2028 616e 6420 6677 6b6e  libfko (and fwkn\n+00001040: 6f70 290a 2a20 456e 6372 7970 7469 6f6e  op).* Encryption\n+00001050: 2041 6c67 6f72 6974 686d 733a 3a20 2020   Algorithms::   \n+00001060: 2020 2020 2020 456e 6372 7970 7469 6f6e        Encryption\n+00001070: 2073 6368 656d 6573 2073 7570 706f 7274   schemes support\n+00001080: 6564 2062 7920 6c69 6266 6b6f 0a2a 2048  ed by libfko.* H\n+00001090: 4d41 4320 4469 6765 7374 733a 3a20 2020  MAC Digests::   \n+000010a0: 2020 2020 2020 2020 2020 2020 2020 2044                 D\n+000010b0: 6967 6573 7473 2074 6861 7420 6361 6e20  igests that can \n+000010c0: 6265 2075 7365 6420 746f 2062 7569 6c64  be used to build\n+000010d0: 2061 6e20 484d 4143 0a0a 0a1f 0a46 696c   an HMAC.....Fil\n+000010e0: 653a 206c 6962 666b 6f2e 696e 666f 2c20  e: libfko.info, \n+000010f0: 204e 6f64 653a 2049 6e74 726f 6475 6374   Node: Introduct\n+00001100: 696f 6e2c 2020 4e65 7874 3a20 5072 6570  ion,  Next: Prep\n+00001110: 6172 6174 696f 6e2c 2020 5072 6576 3a20  aration,  Prev: \n+00001120: 546f 702c 2020 5570 3a20 546f 700a 0a31  Top,  Up: Top..1\n+00001130: 2049 6e74 726f 6475 6374 696f 6e0a 2a2a   Introduction.**\n+00001140: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 5468  ************..Th\n+00001150: 6520 2246 6972 6577 616c 6c20 4b6e 6f63  e \"Firewall Knoc\n+00001160: 6b20 4f70 6572 6174 6f72 204c 6962 7261  k Operator Libra\n+00001170: 7279 2220 286c 6962 666b 6f29 2069 7320  ry\" (libfko) is \n+00001180: 6120 4320 6c61 6e67 7561 6765 206c 6962  a C language lib\n+00001190: 7261 7279 0a74 6861 7420 696d 706c 656d  rary.that implem\n+000011a0: 656e 7473 2074 6865 2066 756e 6374 696f  ents the functio\n+000011b0: 6e73 206e 6565 6465 6420 746f 2063 7265  ns needed to cre\n+000011c0: 6174 6520 616e 642f 6f72 2070 6172 7365  ate and/or parse\n+000011d0: 2022 5369 6e67 6c65 0a50 6163 6b65 7420   \"Single.Packet \n+000011e0: 4175 7468 6f72 697a 6174 696f 6e22 2028  Authorization\" (\n+000011f0: 5350 4129 2064 6174 612e 2020 4974 2069  SPA) data.  It i\n+00001200: 7320 6465 7369 676e 6564 2074 6f20 6162  s designed to ab\n+00001210: 7374 7261 6374 2074 6865 0a64 6574 6169  stract the.detai\n+00001220: 6c73 206f 6620 656e 636f 6469 6e67 2c20  ls of encoding, \n+00001230: 656e 6372 7970 7469 6f6e 2c20 6465 636f  encryption, deco\n+00001240: 6469 6e67 2c20 7061 7273 696e 672c 2061  ding, parsing, a\n+00001250: 6e64 2076 6572 6966 7969 6e67 2053 5041  nd verifying SPA\n+00001260: 0a6d 6573 7361 6765 7320 7375 6368 2061  .messages such a\n+00001270: 7320 7468 6f73 6520 7573 6564 2062 7920  s those used by \n+00001280: 4d69 6368 6165 6c20 5261 7368 2773 2022  Michael Rash's \"\n+00001290: 4669 7265 7761 6c6c 204b 6e6f 636b 204f  Firewall Knock O\n+000012a0: 7065 7261 746f 7222 0a28 6677 6b6e 6f70  perator\".(fwknop\n+000012b0: 292e 0a0a 2020 2022 6677 6b6e 6f70 2220  )...   \"fwknop\" \n+000012c0: 696d 706c 656d 656e 7473 2061 6e20 6175  implements an au\n+000012d0: 7468 6f72 697a 6174 696f 6e20 7363 6865  thorization sche\n+000012e0: 6d65 206b 6e6f 776e 2061 7320 5369 6e67  me known as Sing\n+000012f0: 6c65 2050 6163 6b65 740a 4175 7468 6f72  le Packet.Author\n+00001300: 697a 6174 696f 6e20 2853 5041 2920 666f  ization (SPA) fo\n+00001310: 7220 7374 726f 6e67 2073 6572 7669 6365  r strong service\n+00001320: 2070 726f 7465 6374 696f 6e2e 2020 5350   protection.  SP\n+00001330: 4120 7265 7175 6972 6573 206f 6e6c 7920  A requires only \n+00001340: 610a 7369 6e67 6c65 2070 6163 6b65 7420  a.single packet \n+00001350: 7768 6963 6820 6973 2065 6e63 7279 7074  which is encrypt\n+00001360: 6564 2c20 6e6f 6e2d 7265 706c 6179 6162  ed, non-replayab\n+00001370: 6c65 2c20 616e 6420 6175 7468 656e 7469  le, and authenti\n+00001380: 6361 7465 6420 7669 610a 616e 2048 4d41  cated via.an HMA\n+00001390: 4320 696e 206f 7264 6572 2074 6f20 636f  C in order to co\n+000013a0: 6d6d 756e 6963 6174 6520 6465 7369 7265  mmunicate desire\n+000013b0: 6420 6163 6365 7373 2074 6f20 6120 7365  d access to a se\n+000013c0: 7276 6963 6520 7468 6174 2069 730a 6869  rvice that is.hi\n+000013d0: 6464 656e 2062 6568 696e 6420 6120 6669  dden behind a fi\n+000013e0: 7265 7761 6c6c 2069 6e20 6120 6465 6661  rewall in a defa\n+000013f0: 756c 742d 6472 6f70 2066 696c 7465 7269  ult-drop filteri\n+00001400: 6e67 2073 7461 6e63 652e 2020 5468 6520  ng stance.  The \n+00001410: 6d61 696e 0a61 7070 6c69 6361 7469 6f6e  main.application\n+00001420: 206f 6620 5350 4120 6973 2074 6f20 7573   of SPA is to us\n+00001430: 6520 6120 6669 7265 7761 6c6c 2074 6f20  e a firewall to \n+00001440: 6472 6f70 2061 6c6c 2061 7474 656d 7074  drop all attempt\n+00001450: 7320 746f 2063 6f6e 6e65 6374 0a74 6f20  s to connect.to \n+00001460: 7365 7276 6963 6573 2073 7563 6820 6173  services such as\n+00001470: 2027 5353 4827 2069 6e20 6f72 6465 7220   'SSH' in order \n+00001480: 746f 206d 616b 6520 7468 6520 6578 706c  to make the expl\n+00001490: 6f69 7461 7469 6f6e 206f 660a 7675 6c6e  oitation of.vuln\n+000014a0: 6572 6162 696c 6974 6965 7320 2862 6f74  erabilities (bot\n+000014b0: 6820 302d 6461 7920 616e 6420 756e 7061  h 0-day and unpa\n+000014c0: 7463 6865 6420 636f 6465 2920 6d6f 7265  tched code) more\n+000014d0: 2064 6966 6669 6375 6c74 2e20 2041 6e79   difficult.  Any\n+000014e0: 0a73 6572 7669 6365 2074 6861 7420 6973  .service that is\n+000014f0: 2070 726f 7465 6374 6564 2062 7920 5350   protected by SP\n+00001500: 4120 6e61 7475 7261 6c6c 7920 6361 6e6e  A naturally cann\n+00001510: 6f74 2062 6520 7363 616e 6e65 6420 666f  ot be scanned fo\n+00001520: 7220 7769 7468 0a27 4e6d 6170 272e 2020  r with.'Nmap'.  \n+00001530: 5468 6520 6677 6b6e 6f70 2070 726f 6a65  The fwknop proje\n+00001540: 6374 2073 7570 706f 7274 7320 7468 7265  ct supports thre\n+00001550: 6520 6469 6666 6572 656e 7420 6669 7265  e different fire\n+00001560: 7761 6c6c 733a 0a27 6970 7461 626c 6573  walls:.'iptables\n+00001570: 2720 6f6e 204c 696e 7578 2073 7973 7465  ' on Linux syste\n+00001580: 6d73 2c20 2770 6627 206f 6e20 4f70 656e  ms, 'pf' on Open\n+00001590: 4253 442c 2061 6e64 2027 6970 6677 2720  BSD, and 'ipfw' \n+000015a0: 6f6e 2046 7265 6542 5344 2061 6e64 0a4d  on FreeBSD and.M\n+000015b0: 6163 204f 5320 582e 0a0a 2020 206c 6962  ac OS X...   lib\n+000015c0: 666b 6f20 6973 206e 6f74 2061 6e20 696d  fko is not an im\n+000015d0: 706c 656d 656e 7461 7469 6f6e 206f 6620  plementation of \n+000015e0: 616e 2066 776b 6e6f 7020 636c 6965 6e74  an fwknop client\n+000015f0: 206f 7220 7365 7276 6572 2e20 2049 740a   or server.  It.\n+00001600: 7369 6d70 6c79 2070 726f 7669 6465 7320  simply provides \n+00001610: 7468 6520 6675 6e63 7469 6f6e 7320 666f  the functions fo\n+00001620: 7220 6d61 6e61 6769 6e67 2074 6865 2053  r managing the S\n+00001630: 5041 2064 6174 6120 7573 6564 2062 7920  PA data used by \n+00001640: 7468 6f73 650a 7072 6f67 7261 6d73 2e0a  those.programs..\n+00001650: 0a0a 466f 7220 6d6f 7265 2069 6e66 6f72  ..For more infor\n+00001660: 6d61 7469 6f6e 206f 6e20 6677 6b6e 6f70  mation on fwknop\n+00001670: 2061 6e64 2053 5041 2c20 676f 2074 6f0a   and SPA, go to.\n+00001680: 3c68 7474 703a 2f2f 7777 772e 6369 7068  <http://www.ciph\n+00001690: 6572 6479 6e65 2e6f 7267 2f66 776b 6e6f  erdyne.org/fwkno\n+000016a0: 703e 2e0a 0a2a 204d 656e 753a 0a0a 2a20  p>...* Menu:..* \n+000016b0: 4765 7474 696e 6720 5374 6172 7465 643a  Getting Started:\n+000016c0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               \n+000016d0: 5075 7270 6f73 6520 6f66 2074 6865 206d  Purpose of the m\n+000016e0: 616e 7561 6c2c 2061 6e64 2068 6f77 2074  anual, and how t\n+000016f0: 6f20 7573 6520 6974 0a2a 2046 6561 7475  o use it.* Featu\n+00001700: 7265 733a 3a20 2020 2020 2020 2020 2020  res::           \n+00001710: 2020 2020 2020 2020 2020 2052 6561 736f             Reaso\n+00001720: 6e73 2074 6f20 696e 7374 616c 6c20 616e  ns to install an\n+00001730: 6420 7573 6520 6c69 6266 6b6f 0a2a 204f  d use libfko.* O\n+00001740: 7665 7276 6965 773a 3a20 2020 2020 2020  verview::       \n+00001750: 2020 2020 2020 2020 2020 2020 2020 2042                 B\n+00001760: 6173 6963 2061 7263 6869 7465 6374 7572  asic architectur\n+00001770: 6520 6f66 2074 6865 206c 6962 666b 6f20  e of the libfko \n+00001780: 6c69 6272 6172 790a 0a1f 0a46 696c 653a  library....File:\n+00001790: 206c 6962 666b 6f2e 696e 666f 2c20 204e   libfko.info,  N\n+000017a0: 6f64 653a 2047 6574 7469 6e67 2053 7461  ode: Getting Sta\n+000017b0: 7274 6564 2c20 204e 6578 743a 2046 6561  rted,  Next: Fea\n+000017c0: 7475 7265 732c 2020 5570 3a20 496e 7472  tures,  Up: Intr\n+000017d0: 6f64 7563 7469 6f6e 0a0a 312e 3120 4765  oduction..1.1 Ge\n+000017e0: 7474 696e 6720 5374 6172 7465 640a 3d3d  tting Started.==\n 000017f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================\n-00001800: 3d3d 3d0a 0a54 6869 7320 6d61 6e75 616c  ===..This manual\n-00001810: 2064 6f63 756d 656e 7473 2074 6865 2022   documents the \"\n-00001820: 4669 7265 7761 6c6c 204b 6e6f 636b 204f  Firewall Knock O\n-00001830: 7065 7261 746f 7222 206c 6962 7261 7279  perator\" library\n-00001840: 2070 726f 6772 616d 6d69 6e67 0a69 6e74   programming.int\n-00001850: 6572 6661 6365 2e20 2041 6c6c 2066 756e  erface.  All fun\n-00001860: 6374 696f 6e73 2061 6e64 2064 6174 6120  ctions and data \n-00001870: 7479 7065 7320 7072 6f76 6964 6564 2062  types provided b\n-00001880: 7920 7468 6520 6c69 6272 6172 7920 6172  y the library ar\n-00001890: 650a 6578 706c 6169 6e65 642e 0a0a 2020  e.explained...  \n-000018a0: 2054 6869 7320 6d61 6e75 616c 2063 616e   This manual can\n-000018b0: 2062 6520 7573 6564 2069 6e20 6120 636f   be used in a co\n-000018c0: 7570 6c65 206f 6620 7761 7973 2e20 2049  uple of ways.  I\n-000018d0: 6620 7265 6164 2066 726f 6d20 7468 650a  f read from the.\n-000018e0: 6265 6769 6e6e 696e 6720 746f 2074 6865  beginning to the\n-000018f0: 2065 6e64 2c20 6974 2073 686f 756c 6420   end, it should \n-00001900: 6769 7665 2061 2067 6f6f 6420 696e 7472  give a good intr\n-00001910: 6f64 7563 7469 6f6e 2069 6e74 6f20 7468  oduction into th\n-00001920: 650a 6c69 6272 6172 7920 616e 6420 686f  e.library and ho\n-00001930: 7720 6974 2063 616e 2062 6520 7573 6564  w it can be used\n-00001940: 2069 6e20 616e 2061 7070 6c69 6361 7469   in an applicati\n-00001950: 6f6e 2e20 204c 6174 6572 206f 6e2c 2074  on.  Later on, t\n-00001960: 6865 206d 616e 7561 6c0a 6361 6e20 6265  he manual.can be\n-00001970: 2075 7365 6420 6173 2061 2072 6566 6572   used as a refer\n-00001980: 656e 6365 206d 616e 7561 6c20 746f 2067  ence manual to g\n-00001990: 6574 206a 7573 7420 7468 6520 696e 666f  et just the info\n-000019a0: 726d 6174 696f 6e20 6e65 6564 6564 0a61  rmation needed.a\n-000019b0: 626f 7574 2061 6e79 2070 6172 7469 6375  bout any particu\n-000019c0: 6c61 7220 696e 7465 7266 6163 6520 6f66  lar interface of\n-000019d0: 2074 6865 206c 6962 7261 7279 2e0a 0a1f   the library....\n-000019e0: 0a46 696c 653a 206c 6962 666b 6f2e 696e  .File: libfko.in\n-000019f0: 666f 2c20 204e 6f64 653a 2046 6561 7475  fo,  Node: Featu\n-00001a00: 7265 732c 2020 4e65 7874 3a20 4f76 6572  res,  Next: Over\n-00001a10: 7669 6577 2c20 2050 7265 763a 2047 6574  view,  Prev: Get\n-00001a20: 7469 6e67 2053 7461 7274 6564 2c20 2055  ting Started,  U\n-00001a30: 703a 2049 6e74 726f 6475 6374 696f 6e0a  p: Introduction.\n-00001a40: 0a31 2e32 2046 6561 7475 7265 730a 3d3d  .1.2 Features.==\n-00001a50: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520  ==========..The \n-00001a60: 7072 696d 6172 7920 6164 7661 6e74 6167  primary advantag\n-00001a70: 6520 6f66 2075 7369 6e67 206c 6962 666b  e of using libfk\n-00001a80: 6f20 6973 2069 7420 7072 6f76 6964 6573  o is it provides\n-00001a90: 2061 2073 696e 676c 6520 4150 4920 666f   a single API fo\n-00001aa0: 720a 6569 7468 6572 2063 7265 6174 696e  r.either creatin\n-00001ab0: 6720 6f72 2070 6172 7369 6e67 2053 5041  g or parsing SPA\n-00001ac0: 2064 6174 612e 2020 4164 6469 7469 6f6e   data.  Addition\n-00001ad0: 616c 2061 6476 616e 7461 6765 7320 696e  al advantages in\n-00001ae0: 636c 7564 653a 0a0a 4974 2773 2066 7265  clude:..It's fre\n-00001af0: 6520 736f 6674 7761 7265 0a20 2020 2020  e software.     \n-00001b00: 416e 7962 6f64 7920 6361 6e20 7573 652c  Anybody can use,\n-00001b10: 206d 6f64 6966 792c 2061 6e64 2072 6564   modify, and red\n-00001b20: 6973 7472 6962 7574 6520 6974 2075 6e64  istribute it und\n-00001b30: 6572 2074 6865 2074 6572 6d73 206f 6620  er the terms of \n-00001b40: 7468 650a 2020 2020 2047 4e55 2047 656e  the.     GNU Gen\n-00001b50: 6572 616c 2050 7562 6c69 6320 4c69 6365  eral Public Lice\n-00001b60: 6e73 6520 7632 206f 7220 616e 7920 6c61  nse v2 or any la\n-00001b70: 7465 7220 7665 7273 696f 6e20 282a 6e6f  ter version (*no\n-00001b80: 7465 204c 6962 7261 7279 0a20 2020 2020  te Library.     \n-00001b90: 436f 7079 696e 673a 3a29 2e0a 0a49 7427  Copying::)...It'\n-00001ba0: 7320 6c69 6768 7477 6569 6768 740a 2020  s lightweight.  \n-00001bb0: 2020 2054 6865 2050 6572 6c2d 6261 7365     The Perl-base\n-00001bc0: 6420 696d 706c 656d 656e 7461 7469 6f6e  d implementation\n-00001bd0: 2072 6571 7569 7265 7320 7365 7665 7261   requires severa\n-00001be0: 6c20 6164 6469 7469 6f6e 616c 2050 6572  l additional Per\n-00001bf0: 6c0a 2020 2020 206d 6f64 756c 6573 2061  l.     modules a\n-00001c00: 6e64 2068 6173 2061 2072 656c 6174 6976  nd has a relativ\n-00001c10: 656c 7920 6c61 7267 6520 666f 6f74 7072  ely large footpr\n-00001c20: 696e 7420 696e 206d 656d 6f72 792e 2020  int in memory.  \n-00001c30: 5468 6973 0a20 2020 2020 432d 6261 7365  This.     C-base\n-00001c40: 6420 6c69 6272 6172 7920 656c 696d 696e  d library elimin\n-00001c50: 6174 6573 2074 686f 7365 2064 6570 656e  ates those depen\n-00001c60: 6465 6e63 6965 7320 616e 6420 6861 7320  dencies and has \n-00001c70: 6120 6d75 6368 0a20 2020 2020 736d 616c  a much.     smal\n-00001c80: 6c65 7220 666f 6f74 7072 696e 742e 2020  ler footprint.  \n-00001c90: 5573 696e 6720 7468 6973 206c 6962 7261  Using this libra\n-00001ca0: 7279 2061 6c6c 6f77 7320 5350 4120 746f  ry allows SPA to\n-00001cb0: 2065 6173 696c 790a 2020 2020 2066 756e   easily.     fun\n-00001cc0: 6374 696f 6e20 6f6e 2065 6d62 6564 6465  ction on embedde\n-00001cd0: 6420 6f70 6572 6174 696e 6720 7379 7374  d operating syst\n-00001ce0: 656d 7320 7375 6368 2061 7320 4f70 656e  ems such as Open\n-00001cf0: 5752 542e 0a0a 4974 2773 2065 6173 790a  WRT...It's easy.\n-00001d00: 2020 2020 206c 6962 666b 6f20 6869 6465       libfko hide\n-00001d10: 7320 6d61 6e79 206f 6620 7468 6520 676f  s many of the go\n-00001d20: 7279 2064 6574 6169 6c73 206f 6620 6677  ry details of fw\n-00001d30: 6b6e 6f70 2773 2053 5041 206d 6573 7361  knop's SPA messa\n-00001d40: 6765 2064 6174 610a 2020 2020 2066 6f72  ge data.     for\n-00001d50: 6d61 742c 2065 6e63 6f64 696e 672c 2064  mat, encoding, d\n-00001d60: 6563 6f64 696e 672c 2065 6e63 7279 7074  ecoding, encrypt\n-00001d70: 696e 672c 2064 6563 7279 7074 696e 672c  ing, decrypting,\n-00001d80: 2061 7574 6865 6e74 6963 6174 696e 672c   authenticating,\n-00001d90: 0a20 2020 2020 616e 6420 7061 7273 696e  .     and parsin\n-00001da0: 672e 2020 496e 206d 6f73 7420 6361 7365  g.  In most case\n-00001db0: 732c 206f 6e6c 7920 6120 6665 7720 6675  s, only a few fu\n-00001dc0: 6e63 7469 6f6e 2063 616c 6c73 2077 696c  nction calls wil\n-00001dd0: 6c20 6265 0a20 2020 2020 6e65 6564 6564  l be.     needed\n-00001de0: 2063 7265 6174 6520 6f72 2070 6172 7365   create or parse\n-00001df0: 2061 2053 5041 206d 6573 7361 6765 2e0a   a SPA message..\n-00001e00: 0a1f 0a46 696c 653a 206c 6962 666b 6f2e  ...File: libfko.\n-00001e10: 696e 666f 2c20 204e 6f64 653a 204f 7665  info,  Node: Ove\n-00001e20: 7276 6965 772c 2020 5072 6576 3a20 4665  rview,  Prev: Fe\n-00001e30: 6174 7572 6573 2c20 2055 703a 2049 6e74  atures,  Up: Int\n-00001e40: 726f 6475 6374 696f 6e0a 0a31 2e33 204f  roduction..1.3 O\n-00001e50: 7665 7276 6965 770a 3d3d 3d3d 3d3d 3d3d  verview.========\n-00001e60: 3d3d 3d3d 0a0a 2a20 4d65 6e75 3a0a 0a2a  ====..* Menu:..*\n-00001e70: 2053 5041 2044 6174 6120 466f 726d 6174   SPA Data Format\n-00001e80: 3a3a 2020 2020 2020 2020 2020 2020 2020  ::              \n-00001e90: 2044 6573 6372 6970 7469 6f6e 206f 6620   Description of \n-00001ea0: 7468 6520 5350 4120 6461 7461 0a20 2020  the SPA data.   \n+00001800: 3d0a 0a54 6869 7320 6d61 6e75 616c 2064  =..This manual d\n+00001810: 6f63 756d 656e 7473 2074 6865 2022 4669  ocuments the \"Fi\n+00001820: 7265 7761 6c6c 204b 6e6f 636b 204f 7065  rewall Knock Ope\n+00001830: 7261 746f 7222 206c 6962 7261 7279 2070  rator\" library p\n+00001840: 726f 6772 616d 6d69 6e67 0a69 6e74 6572  rogramming.inter\n+00001850: 6661 6365 2e20 2041 6c6c 2066 756e 6374  face.  All funct\n+00001860: 696f 6e73 2061 6e64 2064 6174 6120 7479  ions and data ty\n+00001870: 7065 7320 7072 6f76 6964 6564 2062 7920  pes provided by \n+00001880: 7468 6520 6c69 6272 6172 7920 6172 650a  the library are.\n+00001890: 6578 706c 6169 6e65 642e 0a0a 2020 2054  explained...   T\n+000018a0: 6869 7320 6d61 6e75 616c 2063 616e 2062  his manual can b\n+000018b0: 6520 7573 6564 2069 6e20 6120 636f 7570  e used in a coup\n+000018c0: 6c65 206f 6620 7761 7973 2e20 2049 6620  le of ways.  If \n+000018d0: 7265 6164 2066 726f 6d20 7468 650a 6265  read from the.be\n+000018e0: 6769 6e6e 696e 6720 746f 2074 6865 2065  ginning to the e\n+000018f0: 6e64 2c20 6974 2073 686f 756c 6420 6769  nd, it should gi\n+00001900: 7665 2061 2067 6f6f 6420 696e 7472 6f64  ve a good introd\n+00001910: 7563 7469 6f6e 2069 6e74 6f20 7468 650a  uction into the.\n+00001920: 6c69 6272 6172 7920 616e 6420 686f 7720  library and how \n+00001930: 6974 2063 616e 2062 6520 7573 6564 2069  it can be used i\n+00001940: 6e20 616e 2061 7070 6c69 6361 7469 6f6e  n an application\n+00001950: 2e20 204c 6174 6572 206f 6e2c 2074 6865  .  Later on, the\n+00001960: 206d 616e 7561 6c0a 6361 6e20 6265 2075   manual.can be u\n+00001970: 7365 6420 6173 2061 2072 6566 6572 656e  sed as a referen\n+00001980: 6365 206d 616e 7561 6c20 746f 2067 6574  ce manual to get\n+00001990: 206a 7573 7420 7468 6520 696e 666f 726d   just the inform\n+000019a0: 6174 696f 6e20 6e65 6564 6564 0a61 626f  ation needed.abo\n+000019b0: 7574 2061 6e79 2070 6172 7469 6375 6c61  ut any particula\n+000019c0: 7220 696e 7465 7266 6163 6520 6f66 2074  r interface of t\n+000019d0: 6865 206c 6962 7261 7279 2e0a 0a1f 0a46  he library.....F\n+000019e0: 696c 653a 206c 6962 666b 6f2e 696e 666f  ile: libfko.info\n+000019f0: 2c20 204e 6f64 653a 2046 6561 7475 7265  ,  Node: Feature\n+00001a00: 732c 2020 4e65 7874 3a20 4f76 6572 7669  s,  Next: Overvi\n+00001a10: 6577 2c20 2050 7265 763a 2047 6574 7469  ew,  Prev: Getti\n+00001a20: 6e67 2053 7461 7274 6564 2c20 2055 703a  ng Started,  Up:\n+00001a30: 2049 6e74 726f 6475 6374 696f 6e0a 0a31   Introduction..1\n+00001a40: 2e32 2046 6561 7475 7265 730a 3d3d 3d3d  .2 Features.====\n+00001a50: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 7072  ========..The pr\n+00001a60: 696d 6172 7920 6164 7661 6e74 6167 6520  imary advantage \n+00001a70: 6f66 2075 7369 6e67 206c 6962 666b 6f20  of using libfko \n+00001a80: 6973 2069 7420 7072 6f76 6964 6573 2061  is it provides a\n+00001a90: 2073 696e 676c 6520 4150 4920 666f 720a   single API for.\n+00001aa0: 6569 7468 6572 2063 7265 6174 696e 6720  either creating \n+00001ab0: 6f72 2070 6172 7369 6e67 2053 5041 2064  or parsing SPA d\n+00001ac0: 6174 612e 2020 4164 6469 7469 6f6e 616c  ata.  Additional\n+00001ad0: 2061 6476 616e 7461 6765 7320 696e 636c   advantages incl\n+00001ae0: 7564 653a 0a0a 4974 2773 2066 7265 6520  ude:..It's free \n+00001af0: 736f 6674 7761 7265 0a20 2020 2020 416e  software.     An\n+00001b00: 7962 6f64 7920 6361 6e20 7573 652c 206d  ybody can use, m\n+00001b10: 6f64 6966 792c 2061 6e64 2072 6564 6973  odify, and redis\n+00001b20: 7472 6962 7574 6520 6974 2075 6e64 6572  tribute it under\n+00001b30: 2074 6865 2074 6572 6d73 206f 6620 7468   the terms of th\n+00001b40: 650a 2020 2020 2047 4e55 2047 656e 6572  e.     GNU Gener\n+00001b50: 616c 2050 7562 6c69 6320 4c69 6365 6e73  al Public Licens\n+00001b60: 6520 7632 206f 7220 616e 7920 6c61 7465  e v2 or any late\n+00001b70: 7220 7665 7273 696f 6e20 282a 6e6f 7465  r version (*note\n+00001b80: 204c 6962 7261 7279 0a20 2020 2020 436f   Library.     Co\n+00001b90: 7079 696e 673a 3a29 2e0a 0a49 7427 7320  pying::)...It's \n+00001ba0: 6c69 6768 7477 6569 6768 740a 2020 2020  lightweight.    \n+00001bb0: 2054 6865 2050 6572 6c2d 6261 7365 6420   The Perl-based \n+00001bc0: 696d 706c 656d 656e 7461 7469 6f6e 2072  implementation r\n+00001bd0: 6571 7569 7265 7320 7365 7665 7261 6c20  equires several \n+00001be0: 6164 6469 7469 6f6e 616c 2050 6572 6c0a  additional Perl.\n+00001bf0: 2020 2020 206d 6f64 756c 6573 2061 6e64       modules and\n+00001c00: 2068 6173 2061 2072 656c 6174 6976 656c   has a relativel\n+00001c10: 7920 6c61 7267 6520 666f 6f74 7072 696e  y large footprin\n+00001c20: 7420 696e 206d 656d 6f72 792e 2020 5468  t in memory.  Th\n+00001c30: 6973 0a20 2020 2020 432d 6261 7365 6420  is.     C-based \n+00001c40: 6c69 6272 6172 7920 656c 696d 696e 6174  library eliminat\n+00001c50: 6573 2074 686f 7365 2064 6570 656e 6465  es those depende\n+00001c60: 6e63 6965 7320 616e 6420 6861 7320 6120  ncies and has a \n+00001c70: 6d75 6368 0a20 2020 2020 736d 616c 6c65  much.     smalle\n+00001c80: 7220 666f 6f74 7072 696e 742e 2020 5573  r footprint.  Us\n+00001c90: 696e 6720 7468 6973 206c 6962 7261 7279  ing this library\n+00001ca0: 2061 6c6c 6f77 7320 5350 4120 746f 2065   allows SPA to e\n+00001cb0: 6173 696c 790a 2020 2020 2066 756e 6374  asily.     funct\n+00001cc0: 696f 6e20 6f6e 2065 6d62 6564 6465 6420  ion on embedded \n+00001cd0: 6f70 6572 6174 696e 6720 7379 7374 656d  operating system\n+00001ce0: 7320 7375 6368 2061 7320 4f70 656e 5752  s such as OpenWR\n+00001cf0: 542e 0a0a 4974 2773 2065 6173 790a 2020  T...It's easy.  \n+00001d00: 2020 206c 6962 666b 6f20 6869 6465 7320     libfko hides \n+00001d10: 6d61 6e79 206f 6620 7468 6520 676f 7279  many of the gory\n+00001d20: 2064 6574 6169 6c73 206f 6620 6677 6b6e   details of fwkn\n+00001d30: 6f70 2773 2053 5041 206d 6573 7361 6765  op's SPA message\n+00001d40: 2064 6174 610a 2020 2020 2066 6f72 6d61   data.     forma\n+00001d50: 742c 2065 6e63 6f64 696e 672c 2064 6563  t, encoding, dec\n+00001d60: 6f64 696e 672c 2065 6e63 7279 7074 696e  oding, encryptin\n+00001d70: 672c 2064 6563 7279 7074 696e 672c 2061  g, decrypting, a\n+00001d80: 7574 6865 6e74 6963 6174 696e 672c 0a20  uthenticating,. \n+00001d90: 2020 2020 616e 6420 7061 7273 696e 672e      and parsing.\n+00001da0: 2020 496e 206d 6f73 7420 6361 7365 732c    In most cases,\n+00001db0: 206f 6e6c 7920 6120 6665 7720 6675 6e63   only a few func\n+00001dc0: 7469 6f6e 2063 616c 6c73 2077 696c 6c20  tion calls will \n+00001dd0: 6265 0a20 2020 2020 6e65 6564 6564 2063  be.     needed c\n+00001de0: 7265 6174 6520 6f72 2070 6172 7365 2061  reate or parse a\n+00001df0: 2053 5041 206d 6573 7361 6765 2e0a 0a1f   SPA message....\n+00001e00: 0a46 696c 653a 206c 6962 666b 6f2e 696e  .File: libfko.in\n+00001e10: 666f 2c20 204e 6f64 653a 204f 7665 7276  fo,  Node: Overv\n+00001e20: 6965 772c 2020 5072 6576 3a20 4665 6174  iew,  Prev: Feat\n+00001e30: 7572 6573 2c20 2055 703a 2049 6e74 726f  ures,  Up: Intro\n+00001e40: 6475 6374 696f 6e0a 0a31 2e33 204f 7665  duction..1.3 Ove\n+00001e50: 7276 6965 770a 3d3d 3d3d 3d3d 3d3d 3d3d  rview.==========\n+00001e60: 3d3d 0a0a 2a20 4d65 6e75 3a0a 0a2a 2053  ==..* Menu:..* S\n+00001e70: 5041 2044 6174 6120 466f 726d 6174 3a3a  PA Data Format::\n+00001e80: 2020 2020 2020 2020 2020 2020 2020 2044                 D\n+00001e90: 6573 6372 6970 7469 6f6e 206f 6620 7468  escription of th\n+00001ea0: 6520 5350 4120 6461 7461 0a20 2020 2020  e SPA data.     \n 00001eb0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00001ec0: 2020 2020 2020 2020 2020 2020 2020 2066                 f\n-00001ed0: 6f72 6d61 742e 0a0a 6c69 6266 6b6f 2066  ormat...libfko f\n-00001ee0: 756e 6374 696f 6e61 6c69 7479 2063 616e  unctionality can\n-00001ef0: 2062 6520 6469 7669 6465 6420 696e 746f   be divided into\n-00001f00: 2074 776f 2072 6f6c 6573 2e20 204f 6e65   two roles.  One\n-00001f10: 2069 7320 7468 6520 6372 6561 7469 6f6e   is the creation\n-00001f20: 0a6f 6620 616e 2065 6e63 7279 7074 6564  .of an encrypted\n-00001f30: 2053 5041 206d 6573 7361 6765 2074 6f67   SPA message tog\n-00001f40: 6574 6865 7220 7769 7468 2061 6e20 484d  ether with an HM\n-00001f50: 4143 2066 6f72 2061 7574 6865 6e74 6963  AC for authentic\n-00001f60: 6174 696f 6e2e 0a54 6865 206f 7468 6572  ation..The other\n-00001f70: 2069 7320 7468 6520 7461 6b69 6e67 2061   is the taking a\n-00001f80: 6e20 656e 6372 7970 7465 6420 5350 4120  n encrypted SPA \n-00001f90: 6d65 7373 6167 6520 746f 2061 7574 6865  message to authe\n-00001fa0: 6e74 6963 6174 652c 0a64 6563 6f64 652c  nticate,.decode,\n-00001fb0: 2070 6172 7365 2c20 616e 6420 6578 7472   parse, and extr\n-00001fc0: 6163 7420 7468 6520 6f72 6967 696e 616c  act the original\n-00001fd0: 2064 6174 612e 0a0a 2020 2054 6865 2061   data...   The a\n-00001fe0: 6374 7561 6c20 5350 4120 6461 7461 2068  ctual SPA data h\n-00001ff0: 616e 646c 696e 6720 616e 6420 6f70 6572  andling and oper\n-00002000: 6174 696f 6e73 2061 7265 2073 6574 2077  ations are set w\n-00002010: 6974 6869 6e20 6120 636f 6e74 6578 742e  ithin a context.\n-00002020: 0a54 6865 2063 6f6e 7465 7874 2072 6570  .The context rep\n-00002030: 7265 7365 6e74 7320 6120 7369 6e67 6c65  resents a single\n-00002040: 2053 5041 206d 6573 7361 6765 2061 6e64   SPA message and\n-00002050: 2070 726f 7669 6465 7320 636f 6e66 6967   provides config\n-00002060: 7572 6174 696f 6e0a 7061 7261 6d65 7465  uration.paramete\n-00002070: 7273 2061 6e64 2064 6174 6120 7365 7474  rs and data sett\n-00002080: 696e 6773 2066 6f72 2064 6566 696e 696e  ings for definin\n-00002090: 6720 7468 6174 206d 6573 7361 6765 2e20  g that message. \n-000020a0: 2041 6c6c 206f 7065 7261 7469 6f6e 730a   All operations.\n-000020b0: 6f6e 2074 6865 2064 6174 6120 6f63 6375  on the data occu\n-000020c0: 7220 7769 7468 696e 2074 6861 7420 636f  r within that co\n-000020d0: 6e74 6578 742e 0a0a 2020 2053 6f6d 6520  ntext...   Some \n-000020e0: 6f70 6572 6174 696f 6e73 206f 6e20 7468  operations on th\n-000020f0: 6520 636f 6e74 6578 7420 6d75 7374 206f  e context must o\n-00002100: 6363 7572 2062 6566 6f72 6520 6f74 6865  ccur before othe\n-00002110: 7273 2e20 2044 6574 6169 6c73 206f 660a  rs.  Details of.\n-00002120: 7468 6573 6520 6465 7065 6e64 656e 6369  these dependenci\n-00002130: 6573 2061 7265 2063 6f76 6572 6564 2069  es are covered i\n-00002140: 6e20 2a6e 6f74 6520 4372 6561 7469 6e67  n *note Creating\n-00002150: 2061 2053 5041 204d 6573 7361 6765 3a3a   a SPA Message::\n-00002160: 2e0a 0a57 6974 6820 6c69 6266 6b6f 2c20  ...With libfko, \n-00002170: 776f 726b 696e 6720 7769 7468 2053 5041  working with SPA\n-00002180: 206d 6573 7361 6765 2064 6174 6120 6261   message data ba\n-00002190: 7369 6361 6c6c 7920 636f 6e73 6973 7473  sically consists\n-000021a0: 206f 6620 7468 650a 666f 6c6c 6f77 696e   of the.followin\n-000021b0: 6720 7374 6570 7320 696e 206f 7264 6572  g steps in order\n-000021c0: 3a0a 0a20 2020 2a20 4372 6561 7465 2061  :..   * Create a\n-000021d0: 206e 6577 2063 6f6e 7465 7874 0a20 2020   new context.   \n-000021e0: 2a20 576f 726b 2077 6974 6820 2867 6574  * Work with (get\n-000021f0: 2f73 6574 2920 7468 6520 5350 4120 6461  /set) the SPA da\n-00002200: 7461 2066 6965 6c64 730a 2020 202a 2044  ta fields.   * D\n-00002210: 6573 7472 6f79 2074 6865 2063 6f6e 7465  estroy the conte\n-00002220: 7874 0a0a 1f0a 4669 6c65 3a20 6c69 6266  xt....File: libf\n-00002230: 6b6f 2e69 6e66 6f2c 2020 4e6f 6465 3a20  ko.info,  Node: \n-00002240: 5350 4120 4461 7461 2046 6f72 6d61 742c  SPA Data Format,\n-00002250: 2020 5570 3a20 4f76 6572 7669 6577 0a0a    Up: Overview..\n-00002260: 312e 332e 3120 5350 4120 4461 7461 2046  1.3.1 SPA Data F\n-00002270: 6f72 6d61 740a 2d2d 2d2d 2d2d 2d2d 2d2d  ormat.----------\n-00002280: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865  -----------..The\n-00002290: 2066 6f72 6d61 7420 6f66 2074 6865 2053   format of the S\n-000022a0: 5041 206d 6573 7361 6765 2064 6174 6120  PA message data \n-000022b0: 7573 6564 2062 7920 6677 6b6e 6f70 2028  used by fwknop (\n-000022c0: 6265 666f 7265 2065 6e63 7279 7074 696f  before encryptio\n-000022d0: 6e20 616e 640a 6265 666f 7265 2061 6e20  n and.before an \n-000022e0: 484d 4143 2069 7320 6170 706c 6965 6429  HMAC is applied)\n-000022f0: 2069 7320 6120 636f 6c6f 6e2d 6465 6c69   is a colon-deli\n-00002300: 6d69 7465 6420 7374 7269 6e67 2063 6f6e  mited string con\n-00002310: 7461 696e 696e 6720 7468 650a 696e 6469  taining the.indi\n-00002320: 7669 6475 616c 2053 5041 2064 6174 6120  vidual SPA data \n-00002330: 6669 656c 6473 2e20 2053 6f6d 6520 6f66  fields.  Some of\n-00002340: 2074 6865 7365 2066 6965 6c64 7320 6172   these fields ar\n-00002350: 6520 6261 7365 3634 2d65 6e63 6f64 6564  e base64-encoded\n-00002360: 2069 6e0a 7468 6520 6669 6e61 6c20 656e   in.the final en\n-00002370: 636f 6469 6e67 2070 726f 6365 7373 2061  coding process a\n-00002380: 7320 6469 6374 6174 6564 2062 7920 7468  s dictated by th\n-00002390: 6520 6375 7272 656e 7420 6677 6b6e 6f70  e current fwknop\n-000023a0: 0a69 6d70 6c65 6d65 6e74 6174 696f 6e2e  .implementation.\n-000023b0: 0a0a 202d 2d20 5661 7269 6162 6c65 3a20  .. -- Variable: \n-000023c0: 6461 7461 2073 7061 5f6d 6573 7361 6765  data spa_message\n-000023d0: 5f66 6965 6c64 730a 2020 2020 2055 7369  _fields.     Usi\n-000023e0: 6e67 2074 6865 206c 6962 666b 6f20 6e61  ng the libfko na\n-000023f0: 6d65 7320 666f 7220 7468 6520 6461 7461  mes for the data\n-00002400: 2066 6965 6c64 732c 2074 6865 206c 6973   fields, the lis\n-00002410: 7420 6f66 2074 6865 7365 0a20 2020 2020  t of these.     \n-00002420: 6669 656c 6473 2028 696e 206f 7264 6572  fields (in order\n-00002430: 2920 666f 6c6c 6f77 733a 0a20 2020 2020  ) follows:.     \n-00002440: 272a 7261 6e64 5f76 616c 7565 2a20 2d20  '*rand_value* - \n-00002450: 5f44 6566 6175 6c74 3a20 5261 6e64 6f6d  _Default: Random\n-00002460: 2028 6372 6561 7465 6420 7570 6f6e 2063   (created upon c\n-00002470: 6f6e 7465 7874 2063 7265 6174 696f 6e29  ontext creation)\n-00002480: 5f27 0a20 2020 2020 2020 2020 2041 2031  _'.          A 1\n-00002490: 362d 6279 7465 2072 616e 646f 6d20 6e75  6-byte random nu\n-000024a0: 6d65 7269 6320 7374 7269 6e67 2e0a 2020  meric string..  \n-000024b0: 2020 2027 2a75 7365 726e 616d 652a 202d     '*username* -\n-000024c0: 205f 4465 6661 756c 743a 2043 7572 7265   _Default: Curre\n-000024d0: 6e74 206c 6f67 696e 2075 7365 7220 6f72  nt login user or\n-000024e0: 2056 616c 7565 206f 6620 5350 4f4f 465f   Value of SPOOF_\n-000024f0: 5553 4552 2065 6e76 2076 6172 5f27 0a20  USER env var_'. \n-00002500: 2020 2020 2020 2020 2054 6865 2062 6173           The bas\n-00002510: 6536 342d 656e 636f 6465 6420 7573 6572  e64-encoded user\n-00002520: 6e61 6d65 2061 7373 6f63 6961 7465 6420  name associated \n-00002530: 7769 7468 2074 6869 7320 5350 4120 6461  with this SPA da\n-00002540: 7461 2e0a 2020 2020 2027 2a74 696d 6573  ta..     '*times\n-00002550: 7461 6d70 2a20 2d20 5f44 6566 6175 6c74  tamp* - _Default\n-00002560: 3a20 5468 6520 556e 6978 2074 696d 6520  : The Unix time \n-00002570: 6174 2063 7265 6174 696f 6e5f 270a 2020  at creation_'.  \n-00002580: 2020 2020 2020 2020 5468 6520 556e 6978          The Unix\n-00002590: 2074 696d 6573 7461 6d70 2076 616c 7565   timestamp value\n-000025a0: 2e0a 2020 2020 2027 2a76 6572 7369 6f6e  ..     '*version\n-000025b0: 2a20 2d20 5f44 6566 6175 6c74 3a20 7468  * - _Default: th\n-000025c0: 6520 6375 7272 656e 7420 6677 6b6e 6f70  e current fwknop\n-000025d0: 2076 6572 7369 6f6e 5f27 0a20 2020 2020   version_'.     \n-000025e0: 2020 2020 2054 6865 2063 7572 7265 6e74       The current\n-000025f0: 2066 776b 6e6f 7020 7665 7273 696f 6e20   fwknop version \n-00002600: 7468 6174 2073 7570 706f 7274 7320 7468  that supports th\n-00002610: 6973 2066 6f72 6d61 742e 2020 5468 6973  is format.  This\n-00002620: 0a20 2020 2020 2020 2020 2066 6965 6c64  .          field\n-00002630: 2069 7320 6e6f 7420 7573 6572 2073 6574   is not user set\n-00002640: 7461 626c 652e 0a20 2020 2020 272a 7370  table..     '*sp\n-00002650: 615f 6d65 7373 6167 655f 7479 7065 2a20  a_message_type* \n-00002660: 2d20 5f44 6566 6175 6c74 3a20 5350 4120  - _Default: SPA \n-00002670: 6163 6365 7373 206d 6573 7361 6765 2028  access message (\n-00002680: 464b 4f5f 4143 4345 5353 5f4d 5347 295f  FKO_ACCESS_MSG)_\n-00002690: 270a 2020 2020 2020 2020 2020 5468 6520  '.          The \n-000026a0: 5350 4120 6d65 7373 6167 6520 7479 7065  SPA message type\n-000026b0: 2076 616c 7565 2066 6f72 2074 6869 7320   value for this \n-000026c0: 6d65 7373 6167 652e 0a20 2020 2020 272a  message..     '*\n-000026d0: 7370 615f 6d65 7373 6167 652a 270a 2020  spa_message*'.  \n-000026e0: 2020 2020 2020 2020 5468 6520 6261 7365          The base\n-000026f0: 3634 2d65 6e63 6f64 6564 2053 5041 206d  64-encoded SPA m\n-00002700: 6573 7361 6765 2069 7473 656c 6620 2861  essage itself (a\n-00002710: 6e20 6163 6365 7373 2072 6571 7565 7374  n access request\n-00002720: 206f 720a 2020 2020 2020 2020 2020 636f   or.          co\n-00002730: 6d6d 616e 6420 7374 7269 6e67 292e 0a20  mmand string).. \n-00002740: 2020 2020 272a 7370 615f 6e61 745f 6163      '*spa_nat_ac\n-00002750: 6365 7373 2a27 0a20 2020 2020 2020 2020  cess*'.         \n-00002760: 2041 6e20 6f70 7469 6f6e 616c 2062 6173   An optional bas\n-00002770: 6536 342d 656e 636f 6465 6420 7265 7175  e64-encoded requ\n-00002780: 6573 7420 666f 7220 4e41 5420 6163 6365  est for NAT acce\n-00002790: 7373 2e0a 2020 2020 2027 2a73 7061 5f73  ss..     '*spa_s\n-000027a0: 6572 7665 725f 6175 7468 2a27 0a20 2020  erver_auth*'.   \n-000027b0: 2020 2020 2020 2041 6e20 6f70 7469 6f6e         An option\n-000027c0: 616c 2062 6173 6536 342d 656e 636f 6465  al base64-encode\n-000027d0: 6420 7374 7269 6e67 2074 6861 7420 6361  d string that ca\n-000027e0: 6e20 6265 2075 7365 6420 6173 2061 6e0a  n be used as an.\n-000027f0: 2020 2020 2020 2020 2020 6164 6469 7469            additi\n-00002800: 6f6e 616c 2061 7574 6865 6e74 6963 6174  onal authenticat\n-00002810: 696f 6e20 6d65 6368 616e 6973 6d20 6174  ion mechanism at\n-00002820: 2074 6865 2066 776b 6e6f 7020 7365 7276   the fwknop serv\n-00002830: 6572 2e0a 2020 2020 2027 2a73 7061 5f63  er..     '*spa_c\n-00002840: 6c69 656e 745f 7469 6d65 6f75 742a 270a  lient_timeout*'.\n-00002850: 2020 2020 2020 2020 2020 416e 206f 7074            An opt\n-00002860: 696f 6e61 6c20 636c 6965 6e74 2074 696d  ional client tim\n-00002870: 656f 7574 2076 616c 7565 2074 6861 7420  eout value that \n-00002880: 6361 6e20 6265 2073 7570 706c 6965 6420  can be supplied \n-00002890: 746f 2074 6865 0a20 2020 2020 2020 2020  to the.         \n-000028a0: 2066 776b 6e6f 7020 7365 7276 6572 2e0a   fwknop server..\n-000028b0: 2020 2020 2027 2a73 7061 5f64 6967 6573       '*spa_diges\n-000028c0: 742a 202d 205f 436f 6d70 7574 6564 2076  t* - _Computed v\n-000028d0: 616c 7565 5f27 0a20 2020 2020 2020 2020  alue_'.         \n-000028e0: 2054 6865 2064 6967 6573 7420 6f66 2074   The digest of t\n-000028f0: 6865 2070 7265 7669 6f75 7320 6669 656c  he previous fiel\n-00002900: 6473 2028 696e 636c 7564 696e 6720 7468  ds (including th\n-00002910: 6520 6465 6c69 6d69 7465 7273 292e 0a0a  e delimiters)...\n-00002920: 2020 2057 6974 6820 616c 6c20 6669 656c     With all fiel\n-00002930: 6473 2064 6566 696e 6564 2c20 6120 636f  ds defined, a co\n-00002940: 6d70 6c65 7465 2028 756e 656e 636f 6465  mplete (unencode\n-00002950: 6429 2053 5041 206d 6573 7361 6765 2077  d) SPA message w\n-00002960: 6f75 6c64 0a6c 6f6f 6b20 736f 6d65 7468  ould.look someth\n-00002970: 696e 6720 6c69 6b65 2074 6865 2066 6f6c  ing like the fol\n-00002980: 6c6f 7769 6e67 2065 7861 6d70 6c65 2028  lowing example (\n-00002990: 4e6f 7465 3a20 5468 6520 6c69 6e65 2069  Note: The line i\n-000029a0: 7320 6272 6f6b 656e 2066 6f72 0a72 6561  s broken for.rea\n-000029b0: 6461 6269 6c69 7479 2061 6e64 2074 6865  dability and the\n-000029c0: 2075 7365 726e 616d 652c 206d 6573 7361   username, messa\n-000029d0: 6765 2c20 6e61 745f 6163 6365 7373 2c20  ge, nat_access, \n-000029e0: 616e 6420 7365 7276 6572 5f61 7574 680a  and server_auth.\n-000029f0: 6669 656c 6473 2061 7265 206e 6f74 2062  fields are not b\n-00002a00: 6173 6536 342d 656e 636f 6465 6429 3a0a  ase64-encoded):.\n-00002a10: 0a0a 2020 2020 2038 3330 3735 3430 3938  ..     830754098\n-00002a20: 3231 3736 3533 393a 6a75 7365 723a 3132  2176539:juser:12\n-00002a30: 3330 3636 3531 3732 3a32 2e35 3a31 3a31  30665172:2.5:1:1\n-00002a40: 2e31 2e31 2e31 2c74 6370 2f32 323a 3139  .1.1.1,tcp/22:19\n-00002a50: 322e 3136 382e 312e 322c 3232 3a0a 2020  2.168.1.2,22:.  \n-00002a60: 2020 2063 7279 7074 2c6d 7970 773a 3132     crypt,mypw:12\n-00002a70: 303a 7873 776a 3856 307a 4d52 372f 374d  0:xswj8V0zMR7/7M\n-00002a80: 5639 7051 5261 7253 4b57 4731 6c39 5a66  V9pQRarSKWG1l9Zf\n-00002a90: 6a76 2b6b 6258 614b 724a 2b52 410a 0a20  jv+kbXaKrJ+RA.. \n-00002aa0: 2020 466f 7220 6d6f 7374 206f 6620 7468    For most of th\n-00002ab0: 6520 6669 656c 6473 2c20 796f 7520 6e65  e fields, you ne\n-00002ac0: 6564 206e 6f74 2062 6520 746f 6f20 636f  ed not be too co\n-00002ad0: 6e63 6572 6e65 6420 6162 6f75 7420 7468  ncerned about th\n-00002ae0: 650a 666f 726d 6174 2061 7320 6c69 6266  e.format as libf\n-00002af0: 6b6f 2068 616e 646c 6573 2074 6861 742e  ko handles that.\n-00002b00: 2020 5468 6520 6578 6365 7074 696f 6e73    The exceptions\n-00002b10: 2061 7265 2074 6865 2027 7370 615f 6d65   are the 'spa_me\n-00002b20: 7373 6167 6527 2c0a 2773 7061 5f6e 6174  ssage',.'spa_nat\n-00002b30: 5f61 6363 6573 7327 2c20 616e 6420 2773  _access', and 's\n-00002b40: 7061 5f73 6572 7665 725f 6175 7468 272e  pa_server_auth'.\n-00002b50: 2020 5468 6520 666f 726d 6174 7320 666f    The formats fo\n-00002b60: 7220 7468 6573 6520 6172 6520 6e6f 740a  r these are not.\n-00002b70: 6861 6e64 6c65 6420 6279 206c 6962 666b  handled by libfk\n-00002b80: 6f20 6475 7269 6e67 2063 7265 6174 696f  o during creatio\n-00002b90: 6e2e 2020 486f 7765 7665 722c 2074 6865  n.  However, the\n-00002ba0: 7920 6172 6520 6368 6563 6b65 6420 666f  y are checked fo\n-00002bb0: 7220 666f 726d 6174 0a76 616c 6964 6974  r format.validit\n-00002bc0: 7920 6475 7269 6e67 2074 6865 2065 6e64  y during the end\n-00002bd0: 636f 6469 6e67 2061 6e64 2064 6563 6f64  coding and decod\n-00002be0: 696e 6720 2877 6865 6e20 7061 7273 696e  ing (when parsin\n-00002bf0: 6720 696e 636f 6d69 6e67 2920 5350 410a  g incoming) SPA.\n-00002c00: 6461 7461 2e20 204d 6f72 6520 696e 666f  data.  More info\n-00002c10: 726d 6174 696f 6e20 6f6e 2074 6865 2073  rmation on the s\n-00002c20: 7065 6369 6669 6373 206f 6620 7468 6520  pecifics of the \n-00002c30: 666f 726d 6174 7320 666f 7220 7468 6573  formats for thes\n-00002c40: 6520 6669 656c 6473 0a63 616e 2062 6520  e fields.can be \n-00002c50: 666f 756e 6420 696e 202a 6e6f 7465 2053  found in *note S\n-00002c60: 5041 204d 6573 7361 6765 733a 3a2e 0a0a  PA Messages::...\n-00002c70: 1f0a 4669 6c65 3a20 6c69 6266 6b6f 2e69  ..File: libfko.i\n-00002c80: 6e66 6f2c 2020 4e6f 6465 3a20 5072 6570  nfo,  Node: Prep\n-00002c90: 6172 6174 696f 6e2c 2020 4e65 7874 3a20  aration,  Next: \n-00002ca0: 5573 696e 6720 6c69 6266 6b6f 2c20 2050  Using libfko,  P\n-00002cb0: 7265 763a 2049 6e74 726f 6475 6374 696f  rev: Introductio\n-00002cc0: 6e2c 2020 5570 3a20 546f 700a 0a32 2050  n,  Up: Top..2 P\n-00002cd0: 7265 7061 7261 7469 6f6e 0a2a 2a2a 2a2a  reparation.*****\n-00002ce0: 2a2a 2a2a 2a2a 2a2a 0a0a 5468 6973 2063  ********..This c\n-00002cf0: 6861 7074 6572 2070 726f 7669 6465 7320  hapter provides \n-00002d00: 696e 666f 726d 6174 696f 6e20 6e65 6564  information need\n-00002d10: 6564 2074 6f20 7072 6570 6172 6520 666f  ed to prepare fo\n-00002d20: 7220 7573 696e 6720 6c69 6266 6b6f 2069  r using libfko i\n-00002d30: 6e0a 796f 7572 2070 726f 6772 616d 732e  n.your programs.\n-00002d40: 0a0a 2a20 4d65 6e75 3a0a 0a2a 206c 6962  ..* Menu:..* lib\n-00002d50: 666b 6f20 4865 6164 6572 3a3a 2020 2020  fko Header::    \n-00002d60: 2020 2020 2020 2020 2020 2020 2057 6861               Wha\n-00002d70: 7420 6865 6164 6572 2066 696c 6520 796f  t header file yo\n-00002d80: 7520 6e65 6564 2074 6f20 696e 636c 7564  u need to includ\n-00002d90: 650a 2a20 436f 6d70 696c 696e 6720 7769  e.* Compiling wi\n-00002da0: 7468 206c 6962 666b 6f3a 3a20 2020 2020  th libfko::     \n-00002db0: 2020 2020 5768 6174 2079 6f75 206e 6565      What you nee\n-00002dc0: 6420 746f 2063 6f6d 7069 6c65 2061 6e64  d to compile and\n-00002dd0: 206c 696e 6b20 796f 7572 0a20 2020 2020   link your.     \n+00001ec0: 2020 2020 2020 2020 2020 2020 2066 6f72               for\n+00001ed0: 6d61 742e 0a0a 6c69 6266 6b6f 2066 756e  mat...libfko fun\n+00001ee0: 6374 696f 6e61 6c69 7479 2063 616e 2062  ctionality can b\n+00001ef0: 6520 6469 7669 6465 6420 696e 746f 2074  e divided into t\n+00001f00: 776f 2072 6f6c 6573 2e20 204f 6e65 2069  wo roles.  One i\n+00001f10: 7320 7468 6520 6372 6561 7469 6f6e 0a6f  s the creation.o\n+00001f20: 6620 616e 2065 6e63 7279 7074 6564 2053  f an encrypted S\n+00001f30: 5041 206d 6573 7361 6765 2074 6f67 6574  PA message toget\n+00001f40: 6865 7220 7769 7468 2061 6e20 484d 4143  her with an HMAC\n+00001f50: 2066 6f72 2061 7574 6865 6e74 6963 6174   for authenticat\n+00001f60: 696f 6e2e 0a54 6865 206f 7468 6572 2069  ion..The other i\n+00001f70: 7320 7468 6520 7461 6b69 6e67 2061 6e20  s the taking an \n+00001f80: 656e 6372 7970 7465 6420 5350 4120 6d65  encrypted SPA me\n+00001f90: 7373 6167 6520 746f 2061 7574 6865 6e74  ssage to authent\n+00001fa0: 6963 6174 652c 0a64 6563 6f64 652c 2070  icate,.decode, p\n+00001fb0: 6172 7365 2c20 616e 6420 6578 7472 6163  arse, and extrac\n+00001fc0: 7420 7468 6520 6f72 6967 696e 616c 2064  t the original d\n+00001fd0: 6174 612e 0a0a 2020 2054 6865 2061 6374  ata...   The act\n+00001fe0: 7561 6c20 5350 4120 6461 7461 2068 616e  ual SPA data han\n+00001ff0: 646c 696e 6720 616e 6420 6f70 6572 6174  dling and operat\n+00002000: 696f 6e73 2061 7265 2073 6574 2077 6974  ions are set wit\n+00002010: 6869 6e20 6120 636f 6e74 6578 742e 0a54  hin a context..T\n+00002020: 6865 2063 6f6e 7465 7874 2072 6570 7265  he context repre\n+00002030: 7365 6e74 7320 6120 7369 6e67 6c65 2053  sents a single S\n+00002040: 5041 206d 6573 7361 6765 2061 6e64 2070  PA message and p\n+00002050: 726f 7669 6465 7320 636f 6e66 6967 7572  rovides configur\n+00002060: 6174 696f 6e0a 7061 7261 6d65 7465 7273  ation.parameters\n+00002070: 2061 6e64 2064 6174 6120 7365 7474 696e   and data settin\n+00002080: 6773 2066 6f72 2064 6566 696e 696e 6720  gs for defining \n+00002090: 7468 6174 206d 6573 7361 6765 2e20 2041  that message.  A\n+000020a0: 6c6c 206f 7065 7261 7469 6f6e 730a 6f6e  ll operations.on\n+000020b0: 2074 6865 2064 6174 6120 6f63 6375 7220   the data occur \n+000020c0: 7769 7468 696e 2074 6861 7420 636f 6e74  within that cont\n+000020d0: 6578 742e 0a0a 2020 2053 6f6d 6520 6f70  ext...   Some op\n+000020e0: 6572 6174 696f 6e73 206f 6e20 7468 6520  erations on the \n+000020f0: 636f 6e74 6578 7420 6d75 7374 206f 6363  context must occ\n+00002100: 7572 2062 6566 6f72 6520 6f74 6865 7273  ur before others\n+00002110: 2e20 2044 6574 6169 6c73 206f 660a 7468  .  Details of.th\n+00002120: 6573 6520 6465 7065 6e64 656e 6369 6573  ese dependencies\n+00002130: 2061 7265 2063 6f76 6572 6564 2069 6e20   are covered in \n+00002140: 2a6e 6f74 6520 4372 6561 7469 6e67 2061  *note Creating a\n+00002150: 2053 5041 204d 6573 7361 6765 3a3a 2e0a   SPA Message::..\n+00002160: 0a57 6974 6820 6c69 6266 6b6f 2c20 776f  .With libfko, wo\n+00002170: 726b 696e 6720 7769 7468 2053 5041 206d  rking with SPA m\n+00002180: 6573 7361 6765 2064 6174 6120 6261 7369  essage data basi\n+00002190: 6361 6c6c 7920 636f 6e73 6973 7473 206f  cally consists o\n+000021a0: 6620 7468 650a 666f 6c6c 6f77 696e 6720  f the.following \n+000021b0: 7374 6570 7320 696e 206f 7264 6572 3a0a  steps in order:.\n+000021c0: 0a20 2020 2a20 4372 6561 7465 2061 206e  .   * Create a n\n+000021d0: 6577 2063 6f6e 7465 7874 0a20 2020 2a20  ew context.   * \n+000021e0: 576f 726b 2077 6974 6820 2867 6574 2f73  Work with (get/s\n+000021f0: 6574 2920 7468 6520 5350 4120 6461 7461  et) the SPA data\n+00002200: 2066 6965 6c64 730a 2020 202a 2044 6573   fields.   * Des\n+00002210: 7472 6f79 2074 6865 2063 6f6e 7465 7874  troy the context\n+00002220: 0a0a 1f0a 4669 6c65 3a20 6c69 6266 6b6f  ....File: libfko\n+00002230: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5350  .info,  Node: SP\n+00002240: 4120 4461 7461 2046 6f72 6d61 742c 2020  A Data Format,  \n+00002250: 5570 3a20 4f76 6572 7669 6577 0a0a 312e  Up: Overview..1.\n+00002260: 332e 3120 5350 4120 4461 7461 2046 6f72  3.1 SPA Data For\n+00002270: 6d61 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  mat.------------\n+00002280: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 2066  ---------..The f\n+00002290: 6f72 6d61 7420 6f66 2074 6865 2053 5041  ormat of the SPA\n+000022a0: 206d 6573 7361 6765 2064 6174 6120 7573   message data us\n+000022b0: 6564 2062 7920 6677 6b6e 6f70 2028 6265  ed by fwknop (be\n+000022c0: 666f 7265 2065 6e63 7279 7074 696f 6e20  fore encryption \n+000022d0: 616e 640a 6265 666f 7265 2061 6e20 484d  and.before an HM\n+000022e0: 4143 2069 7320 6170 706c 6965 6429 2069  AC is applied) i\n+000022f0: 7320 6120 636f 6c6f 6e2d 6465 6c69 6d69  s a colon-delimi\n+00002300: 7465 6420 7374 7269 6e67 2063 6f6e 7461  ted string conta\n+00002310: 696e 696e 6720 7468 650a 696e 6469 7669  ining the.indivi\n+00002320: 6475 616c 2053 5041 2064 6174 6120 6669  dual SPA data fi\n+00002330: 656c 6473 2e20 2053 6f6d 6520 6f66 2074  elds.  Some of t\n+00002340: 6865 7365 2066 6965 6c64 7320 6172 6520  hese fields are \n+00002350: 6261 7365 3634 2d65 6e63 6f64 6564 2069  base64-encoded i\n+00002360: 6e0a 7468 6520 6669 6e61 6c20 656e 636f  n.the final enco\n+00002370: 6469 6e67 2070 726f 6365 7373 2061 7320  ding process as \n+00002380: 6469 6374 6174 6564 2062 7920 7468 6520  dictated by the \n+00002390: 6375 7272 656e 7420 6677 6b6e 6f70 0a69  current fwknop.i\n+000023a0: 6d70 6c65 6d65 6e74 6174 696f 6e2e 0a0a  mplementation...\n+000023b0: 202d 2d20 5661 7269 6162 6c65 3a20 6461   -- Variable: da\n+000023c0: 7461 2073 7061 5f6d 6573 7361 6765 5f66  ta spa_message_f\n+000023d0: 6965 6c64 730a 2020 2020 2055 7369 6e67  ields.     Using\n+000023e0: 2074 6865 206c 6962 666b 6f20 6e61 6d65   the libfko name\n+000023f0: 7320 666f 7220 7468 6520 6461 7461 2066  s for the data f\n+00002400: 6965 6c64 732c 2074 6865 206c 6973 7420  ields, the list \n+00002410: 6f66 2074 6865 7365 0a20 2020 2020 6669  of these.     fi\n+00002420: 656c 6473 2028 696e 206f 7264 6572 2920  elds (in order) \n+00002430: 666f 6c6c 6f77 733a 0a20 2020 2020 272a  follows:.     '*\n+00002440: 7261 6e64 5f76 616c 7565 2a20 2d20 5f44  rand_value* - _D\n+00002450: 6566 6175 6c74 3a20 5261 6e64 6f6d 2028  efault: Random (\n+00002460: 6372 6561 7465 6420 7570 6f6e 2063 6f6e  created upon con\n+00002470: 7465 7874 2063 7265 6174 696f 6e29 5f27  text creation)_'\n+00002480: 0a20 2020 2020 2020 2020 2041 2031 362d  .          A 16-\n+00002490: 6279 7465 2072 616e 646f 6d20 6e75 6d65  byte random nume\n+000024a0: 7269 6320 7374 7269 6e67 2e0a 2020 2020  ric string..    \n+000024b0: 2027 2a75 7365 726e 616d 652a 202d 205f   '*username* - _\n+000024c0: 4465 6661 756c 743a 2043 7572 7265 6e74  Default: Current\n+000024d0: 206c 6f67 696e 2075 7365 7220 6f72 2056   login user or V\n+000024e0: 616c 7565 206f 6620 5350 4f4f 465f 5553  alue of SPOOF_US\n+000024f0: 4552 2065 6e76 2076 6172 5f27 0a20 2020  ER env var_'.   \n+00002500: 2020 2020 2020 2054 6865 2062 6173 6536         The base6\n+00002510: 342d 656e 636f 6465 6420 7573 6572 6e61  4-encoded userna\n+00002520: 6d65 2061 7373 6f63 6961 7465 6420 7769  me associated wi\n+00002530: 7468 2074 6869 7320 5350 4120 6461 7461  th this SPA data\n+00002540: 2e0a 2020 2020 2027 2a74 696d 6573 7461  ..     '*timesta\n+00002550: 6d70 2a20 2d20 5f44 6566 6175 6c74 3a20  mp* - _Default: \n+00002560: 5468 6520 556e 6978 2074 696d 6520 6174  The Unix time at\n+00002570: 2063 7265 6174 696f 6e5f 270a 2020 2020   creation_'.    \n+00002580: 2020 2020 2020 5468 6520 556e 6978 2074        The Unix t\n+00002590: 696d 6573 7461 6d70 2076 616c 7565 2e0a  imestamp value..\n+000025a0: 2020 2020 2027 2a76 6572 7369 6f6e 2a20       '*version* \n+000025b0: 2d20 5f44 6566 6175 6c74 3a20 7468 6520  - _Default: the \n+000025c0: 6375 7272 656e 7420 6677 6b6e 6f70 2076  current fwknop v\n+000025d0: 6572 7369 6f6e 5f27 0a20 2020 2020 2020  ersion_'.       \n+000025e0: 2020 2054 6865 2063 7572 7265 6e74 2066     The current f\n+000025f0: 776b 6e6f 7020 7665 7273 696f 6e20 7468  wknop version th\n+00002600: 6174 2073 7570 706f 7274 7320 7468 6973  at supports this\n+00002610: 2066 6f72 6d61 742e 2020 5468 6973 0a20   format.  This. \n+00002620: 2020 2020 2020 2020 2066 6965 6c64 2069           field i\n+00002630: 7320 6e6f 7420 7573 6572 2073 6574 7461  s not user setta\n+00002640: 626c 652e 0a20 2020 2020 272a 7370 615f  ble..     '*spa_\n+00002650: 6d65 7373 6167 655f 7479 7065 2a20 2d20  message_type* - \n+00002660: 5f44 6566 6175 6c74 3a20 5350 4120 6163  _Default: SPA ac\n+00002670: 6365 7373 206d 6573 7361 6765 2028 464b  cess message (FK\n+00002680: 4f5f 4143 4345 5353 5f4d 5347 295f 270a  O_ACCESS_MSG)_'.\n+00002690: 2020 2020 2020 2020 2020 5468 6520 5350            The SP\n+000026a0: 4120 6d65 7373 6167 6520 7479 7065 2076  A message type v\n+000026b0: 616c 7565 2066 6f72 2074 6869 7320 6d65  alue for this me\n+000026c0: 7373 6167 652e 0a20 2020 2020 272a 7370  ssage..     '*sp\n+000026d0: 615f 6d65 7373 6167 652a 270a 2020 2020  a_message*'.    \n+000026e0: 2020 2020 2020 5468 6520 6261 7365 3634        The base64\n+000026f0: 2d65 6e63 6f64 6564 2053 5041 206d 6573  -encoded SPA mes\n+00002700: 7361 6765 2069 7473 656c 6620 2861 6e20  sage itself (an \n+00002710: 6163 6365 7373 2072 6571 7565 7374 206f  access request o\n+00002720: 720a 2020 2020 2020 2020 2020 636f 6d6d  r.          comm\n+00002730: 616e 6420 7374 7269 6e67 292e 0a20 2020  and string)..   \n+00002740: 2020 272a 7370 615f 6e61 745f 6163 6365    '*spa_nat_acce\n+00002750: 7373 2a27 0a20 2020 2020 2020 2020 2041  ss*'.          A\n+00002760: 6e20 6f70 7469 6f6e 616c 2062 6173 6536  n optional base6\n+00002770: 342d 656e 636f 6465 6420 7265 7175 6573  4-encoded reques\n+00002780: 7420 666f 7220 4e41 5420 6163 6365 7373  t for NAT access\n+00002790: 2e0a 2020 2020 2027 2a73 7061 5f73 6572  ..     '*spa_ser\n+000027a0: 7665 725f 6175 7468 2a27 0a20 2020 2020  ver_auth*'.     \n+000027b0: 2020 2020 2041 6e20 6f70 7469 6f6e 616c       An optional\n+000027c0: 2062 6173 6536 342d 656e 636f 6465 6420   base64-encoded \n+000027d0: 7374 7269 6e67 2074 6861 7420 6361 6e20  string that can \n+000027e0: 6265 2075 7365 6420 6173 2061 6e0a 2020  be used as an.  \n+000027f0: 2020 2020 2020 2020 6164 6469 7469 6f6e          addition\n+00002800: 616c 2061 7574 6865 6e74 6963 6174 696f  al authenticatio\n+00002810: 6e20 6d65 6368 616e 6973 6d20 6174 2074  n mechanism at t\n+00002820: 6865 2066 776b 6e6f 7020 7365 7276 6572  he fwknop server\n+00002830: 2e0a 2020 2020 2027 2a73 7061 5f63 6c69  ..     '*spa_cli\n+00002840: 656e 745f 7469 6d65 6f75 742a 270a 2020  ent_timeout*'.  \n+00002850: 2020 2020 2020 2020 416e 206f 7074 696f          An optio\n+00002860: 6e61 6c20 636c 6965 6e74 2074 696d 656f  nal client timeo\n+00002870: 7574 2076 616c 7565 2074 6861 7420 6361  ut value that ca\n+00002880: 6e20 6265 2073 7570 706c 6965 6420 746f  n be supplied to\n+00002890: 2074 6865 0a20 2020 2020 2020 2020 2066   the.          f\n+000028a0: 776b 6e6f 7020 7365 7276 6572 2e0a 2020  wknop server..  \n+000028b0: 2020 2027 2a73 7061 5f64 6967 6573 742a     '*spa_digest*\n+000028c0: 202d 205f 436f 6d70 7574 6564 2076 616c   - _Computed val\n+000028d0: 7565 5f27 0a20 2020 2020 2020 2020 2054  ue_'.          T\n+000028e0: 6865 2064 6967 6573 7420 6f66 2074 6865  he digest of the\n+000028f0: 2070 7265 7669 6f75 7320 6669 656c 6473   previous fields\n+00002900: 2028 696e 636c 7564 696e 6720 7468 6520   (including the \n+00002910: 6465 6c69 6d69 7465 7273 292e 0a0a 2020  delimiters)...  \n+00002920: 2057 6974 6820 616c 6c20 6669 656c 6473   With all fields\n+00002930: 2064 6566 696e 6564 2c20 6120 636f 6d70   defined, a comp\n+00002940: 6c65 7465 2028 756e 656e 636f 6465 6429  lete (unencoded)\n+00002950: 2053 5041 206d 6573 7361 6765 2077 6f75   SPA message wou\n+00002960: 6c64 0a6c 6f6f 6b20 736f 6d65 7468 696e  ld.look somethin\n+00002970: 6720 6c69 6b65 2074 6865 2066 6f6c 6c6f  g like the follo\n+00002980: 7769 6e67 2065 7861 6d70 6c65 2028 4e6f  wing example (No\n+00002990: 7465 3a20 5468 6520 6c69 6e65 2069 7320  te: The line is \n+000029a0: 6272 6f6b 656e 2066 6f72 0a72 6561 6461  broken for.reada\n+000029b0: 6269 6c69 7479 2061 6e64 2074 6865 2075  bility and the u\n+000029c0: 7365 726e 616d 652c 206d 6573 7361 6765  sername, message\n+000029d0: 2c20 6e61 745f 6163 6365 7373 2c20 616e  , nat_access, an\n+000029e0: 6420 7365 7276 6572 5f61 7574 680a 6669  d server_auth.fi\n+000029f0: 656c 6473 2061 7265 206e 6f74 2062 6173  elds are not bas\n+00002a00: 6536 342d 656e 636f 6465 6429 3a0a 0a0a  e64-encoded):...\n+00002a10: 2020 2020 2038 3330 3735 3430 3938 3231       83075409821\n+00002a20: 3736 3533 393a 6a75 7365 723a 3132 3330  76539:juser:1230\n+00002a30: 3636 3531 3732 3a32 2e35 3a31 3a31 2e31  665172:2.5:1:1.1\n+00002a40: 2e31 2e31 2c74 6370 2f32 323a 3139 322e  .1.1,tcp/22:192.\n+00002a50: 3136 382e 312e 322c 3232 3a0a 2020 2020  168.1.2,22:.    \n+00002a60: 2063 7279 7074 2c6d 7970 773a 3132 303a   crypt,mypw:120:\n+00002a70: 7873 776a 3856 307a 4d52 372f 374d 5639  xswj8V0zMR7/7MV9\n+00002a80: 7051 5261 7253 4b57 4731 6c39 5a66 6a76  pQRarSKWG1l9Zfjv\n+00002a90: 2b6b 6258 614b 724a 2b52 410a 0a20 2020  +kbXaKrJ+RA..   \n+00002aa0: 466f 7220 6d6f 7374 206f 6620 7468 6520  For most of the \n+00002ab0: 6669 656c 6473 2c20 796f 7520 6e65 6564  fields, you need\n+00002ac0: 206e 6f74 2062 6520 746f 6f20 636f 6e63   not be too conc\n+00002ad0: 6572 6e65 6420 6162 6f75 7420 7468 650a  erned about the.\n+00002ae0: 666f 726d 6174 2061 7320 6c69 6266 6b6f  format as libfko\n+00002af0: 2068 616e 646c 6573 2074 6861 742e 2020   handles that.  \n+00002b00: 5468 6520 6578 6365 7074 696f 6e73 2061  The exceptions a\n+00002b10: 7265 2074 6865 2027 7370 615f 6d65 7373  re the 'spa_mess\n+00002b20: 6167 6527 2c0a 2773 7061 5f6e 6174 5f61  age',.'spa_nat_a\n+00002b30: 6363 6573 7327 2c20 616e 6420 2773 7061  ccess', and 'spa\n+00002b40: 5f73 6572 7665 725f 6175 7468 272e 2020  _server_auth'.  \n+00002b50: 5468 6520 666f 726d 6174 7320 666f 7220  The formats for \n+00002b60: 7468 6573 6520 6172 6520 6e6f 740a 6861  these are not.ha\n+00002b70: 6e64 6c65 6420 6279 206c 6962 666b 6f20  ndled by libfko \n+00002b80: 6475 7269 6e67 2063 7265 6174 696f 6e2e  during creation.\n+00002b90: 2020 486f 7765 7665 722c 2074 6865 7920    However, they \n+00002ba0: 6172 6520 6368 6563 6b65 6420 666f 7220  are checked for \n+00002bb0: 666f 726d 6174 0a76 616c 6964 6974 7920  format.validity \n+00002bc0: 6475 7269 6e67 2074 6865 2065 6e64 636f  during the endco\n+00002bd0: 6469 6e67 2061 6e64 2064 6563 6f64 696e  ding and decodin\n+00002be0: 6720 2877 6865 6e20 7061 7273 696e 6720  g (when parsing \n+00002bf0: 696e 636f 6d69 6e67 2920 5350 410a 6461  incoming) SPA.da\n+00002c00: 7461 2e20 204d 6f72 6520 696e 666f 726d  ta.  More inform\n+00002c10: 6174 696f 6e20 6f6e 2074 6865 2073 7065  ation on the spe\n+00002c20: 6369 6669 6373 206f 6620 7468 6520 666f  cifics of the fo\n+00002c30: 726d 6174 7320 666f 7220 7468 6573 6520  rmats for these \n+00002c40: 6669 656c 6473 0a63 616e 2062 6520 666f  fields.can be fo\n+00002c50: 756e 6420 696e 202a 6e6f 7465 2053 5041  und in *note SPA\n+00002c60: 204d 6573 7361 6765 733a 3a2e 0a0a 1f0a   Messages::.....\n+00002c70: 4669 6c65 3a20 6c69 6266 6b6f 2e69 6e66  File: libfko.inf\n+00002c80: 6f2c 2020 4e6f 6465 3a20 5072 6570 6172  o,  Node: Prepar\n+00002c90: 6174 696f 6e2c 2020 4e65 7874 3a20 5573  ation,  Next: Us\n+00002ca0: 696e 6720 6c69 6266 6b6f 2c20 2050 7265  ing libfko,  Pre\n+00002cb0: 763a 2049 6e74 726f 6475 6374 696f 6e2c  v: Introduction,\n+00002cc0: 2020 5570 3a20 546f 700a 0a32 2050 7265    Up: Top..2 Pre\n+00002cd0: 7061 7261 7469 6f6e 0a2a 2a2a 2a2a 2a2a  paration.*******\n+00002ce0: 2a2a 2a2a 2a2a 0a0a 5468 6973 2063 6861  ******..This cha\n+00002cf0: 7074 6572 2070 726f 7669 6465 7320 696e  pter provides in\n+00002d00: 666f 726d 6174 696f 6e20 6e65 6564 6564  formation needed\n+00002d10: 2074 6f20 7072 6570 6172 6520 666f 7220   to prepare for \n+00002d20: 7573 696e 6720 6c69 6266 6b6f 2069 6e0a  using libfko in.\n+00002d30: 796f 7572 2070 726f 6772 616d 732e 0a0a  your programs...\n+00002d40: 2a20 4d65 6e75 3a0a 0a2a 206c 6962 666b  * Menu:..* libfk\n+00002d50: 6f20 4865 6164 6572 3a3a 2020 2020 2020  o Header::      \n+00002d60: 2020 2020 2020 2020 2020 2057 6861 7420             What \n+00002d70: 6865 6164 6572 2066 696c 6520 796f 7520  header file you \n+00002d80: 6e65 6564 2074 6f20 696e 636c 7564 650a  need to include.\n+00002d90: 2a20 436f 6d70 696c 696e 6720 7769 7468  * Compiling with\n+00002da0: 206c 6962 666b 6f3a 3a20 2020 2020 2020   libfko::       \n+00002db0: 2020 5768 6174 2079 6f75 206e 6565 6420    What you need \n+00002dc0: 746f 2063 6f6d 7069 6c65 2061 6e64 206c  to compile and l\n+00002dd0: 696e 6b20 796f 7572 0a20 2020 2020 2020  ink your.       \n 00002de0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00002df0: 2020 2020 2020 2020 2020 2020 2070 726f               pro\n-00002e00: 6772 616d 2077 6974 6820 6c69 6266 6b6f  gram with libfko\n-00002e10: 0a2a 2053 5041 2050 6172 616d 6574 6572  .* SPA Parameter\n-00002e20: 2054 7970 6573 3a3a 2020 2020 2020 2020   Types::        \n-00002e30: 2020 2054 6865 2061 7661 696c 6162 6c65     The available\n-00002e40: 2064 6967 6573 7473 2c20 6d65 7373 6167   digests, messag\n-00002e50: 6520 7479 7065 7320 616e 640a 2020 2020  e types and.    \n+00002df0: 2020 2020 2020 2020 2020 2070 726f 6772             progr\n+00002e00: 616d 2077 6974 6820 6c69 6266 6b6f 0a2a  am with libfko.*\n+00002e10: 2053 5041 2050 6172 616d 6574 6572 2054   SPA Parameter T\n+00002e20: 7970 6573 3a3a 2020 2020 2020 2020 2020  ypes::          \n+00002e30: 2054 6865 2061 7661 696c 6162 6c65 2064   The available d\n+00002e40: 6967 6573 7473 2c20 6d65 7373 6167 6520  igests, message \n+00002e50: 7479 7065 7320 616e 640a 2020 2020 2020  types and.      \n 00002e60: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00002e70: 2020 2020 2020 2020 2020 2020 2020 6d6f                mo\n-00002e80: 6465 7320 6f66 2065 6e63 7279 7074 696f  des of encryptio\n-00002e90: 6e20 666f 7220 5350 4120 6461 7461 0a0a  n for SPA data..\n-00002ea0: 1f0a 4669 6c65 3a20 6c69 6266 6b6f 2e69  ..File: libfko.i\n-00002eb0: 6e66 6f2c 2020 4e6f 6465 3a20 6c69 6266  nfo,  Node: libf\n-00002ec0: 6b6f 2048 6561 6465 722c 2020 4e65 7874  ko Header,  Next\n-00002ed0: 3a20 436f 6d70 696c 696e 6720 7769 7468  : Compiling with\n-00002ee0: 206c 6962 666b 6f2c 2020 5570 3a20 5072   libfko,  Up: Pr\n-00002ef0: 6570 6172 6174 696f 6e0a 0a32 2e31 206c  eparation..2.1 l\n-00002f00: 6962 666b 6f20 4865 6164 6572 0a3d 3d3d  ibfko Header.===\n-00002f10: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a  ==============..\n-00002f20: 416c 6c20 696e 7465 7266 6163 6573 2028  All interfaces (\n-00002f30: 6461 7461 2074 7970 6573 2061 6e64 2066  data types and f\n-00002f40: 756e 6374 696f 6e73 2920 6f66 2074 6865  unctions) of the\n-00002f50: 206c 6962 7261 7279 2061 7265 2064 6566   library are def\n-00002f60: 696e 6564 2069 6e0a 7468 6520 6865 6164  ined in.the head\n-00002f70: 6572 2066 696c 6520 2766 6b6f 2e68 272e  er file 'fko.h'.\n-00002f80: 2020 596f 7520 6d75 7374 2069 6e63 6c75    You must inclu\n-00002f90: 6465 2074 6869 7320 696e 2061 6c6c 2070  de this in all p\n-00002fa0: 726f 6772 616d 7320 7573 696e 670a 7468  rograms using.th\n-00002fb0: 6520 6c69 6272 6172 792c 2065 6974 6865  e library, eithe\n-00002fc0: 7220 6469 7265 6374 6c79 206f 7220 7468  r directly or th\n-00002fd0: 726f 7567 6820 736f 6d65 206f 7468 6572  rough some other\n-00002fe0: 2068 6561 6465 7220 6669 6c65 2c20 6c69   header file, li\n-00002ff0: 6b65 0a74 6869 733a 0a0a 2020 2020 2023  ke.this:..     #\n-00003000: 696e 636c 7564 6520 3c66 6b6f 2e68 3e0a  include <fko.h>.\n-00003010: 0a20 2020 5468 6520 6e61 6d65 2073 7061  .   The name spa\n-00003020: 6365 206f 6620 464b 4f20 6973 2027 666b  ce of FKO is 'fk\n-00003030: 6f5f 2a27 2066 6f72 2066 756e 6374 696f  o_*' for functio\n-00003040: 6e20 6e61 6d65 7320 616e 6420 6461 7461  n names and data\n-00003050: 2074 7970 6573 0a61 6e64 2027 464b 4f5f   types.and 'FKO_\n-00003060: 2a27 2066 6f72 206f 7468 6572 2073 796d  *' for other sym\n-00003070: 626f 6c73 2e20 204f 7468 6572 2073 796d  bols.  Other sym\n-00003080: 626f 6c73 2069 6e74 6572 6e61 6c20 746f  bols internal to\n-00003090: 2046 4b4f 206d 6179 2074 616b 650a 7468   FKO may take.th\n-000030a0: 6520 666f 726d 2027 5f66 6b6f 5f2a 2720  e form '_fko_*' \n-000030b0: 616e 6420 275f 464b 4f5f 2a27 2e0a 0a1f  and '_FKO_*'....\n-000030c0: 0a46 696c 653a 206c 6962 666b 6f2e 696e  .File: libfko.in\n-000030d0: 666f 2c20 204e 6f64 653a 2043 6f6d 7069  fo,  Node: Compi\n-000030e0: 6c69 6e67 2077 6974 6820 6c69 6266 6b6f  ling with libfko\n-000030f0: 2c20 204e 6578 743a 2053 5041 2050 6172  ,  Next: SPA Par\n-00003100: 616d 6574 6572 2054 7970 6573 2c20 2050  ameter Types,  P\n-00003110: 7265 763a 206c 6962 666b 6f20 4865 6164  rev: libfko Head\n-00003120: 6572 2c20 2055 703a 2050 7265 7061 7261  er,  Up: Prepara\n-00003130: 7469 6f6e 0a0a 322e 3220 436f 6d70 696c  tion..2.2 Compil\n-00003140: 696e 6720 7769 7468 206c 6962 666b 6f0a  ing with libfko.\n+00002e70: 2020 2020 2020 2020 2020 2020 6d6f 6465              mode\n+00002e80: 7320 6f66 2065 6e63 7279 7074 696f 6e20  s of encryption \n+00002e90: 666f 7220 5350 4120 6461 7461 0a0a 1f0a  for SPA data....\n+00002ea0: 4669 6c65 3a20 6c69 6266 6b6f 2e69 6e66  File: libfko.inf\n+00002eb0: 6f2c 2020 4e6f 6465 3a20 6c69 6266 6b6f  o,  Node: libfko\n+00002ec0: 2048 6561 6465 722c 2020 4e65 7874 3a20   Header,  Next: \n+00002ed0: 436f 6d70 696c 696e 6720 7769 7468 206c  Compiling with l\n+00002ee0: 6962 666b 6f2c 2020 5570 3a20 5072 6570  ibfko,  Up: Prep\n+00002ef0: 6172 6174 696f 6e0a 0a32 2e31 206c 6962  aration..2.1 lib\n+00002f00: 666b 6f20 4865 6164 6572 0a3d 3d3d 3d3d  fko Header.=====\n+00002f10: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 416c  ============..Al\n+00002f20: 6c20 696e 7465 7266 6163 6573 2028 6461  l interfaces (da\n+00002f30: 7461 2074 7970 6573 2061 6e64 2066 756e  ta types and fun\n+00002f40: 6374 696f 6e73 2920 6f66 2074 6865 206c  ctions) of the l\n+00002f50: 6962 7261 7279 2061 7265 2064 6566 696e  ibrary are defin\n+00002f60: 6564 2069 6e0a 7468 6520 6865 6164 6572  ed in.the header\n+00002f70: 2066 696c 6520 2766 6b6f 2e68 272e 2020   file 'fko.h'.  \n+00002f80: 596f 7520 6d75 7374 2069 6e63 6c75 6465  You must include\n+00002f90: 2074 6869 7320 696e 2061 6c6c 2070 726f   this in all pro\n+00002fa0: 6772 616d 7320 7573 696e 670a 7468 6520  grams using.the \n+00002fb0: 6c69 6272 6172 792c 2065 6974 6865 7220  library, either \n+00002fc0: 6469 7265 6374 6c79 206f 7220 7468 726f  directly or thro\n+00002fd0: 7567 6820 736f 6d65 206f 7468 6572 2068  ugh some other h\n+00002fe0: 6561 6465 7220 6669 6c65 2c20 6c69 6b65  eader file, like\n+00002ff0: 0a74 6869 733a 0a0a 2020 2020 2023 696e  .this:..     #in\n+00003000: 636c 7564 6520 3c66 6b6f 2e68 3e0a 0a20  clude <fko.h>.. \n+00003010: 2020 5468 6520 6e61 6d65 2073 7061 6365    The name space\n+00003020: 206f 6620 464b 4f20 6973 2027 666b 6f5f   of FKO is 'fko_\n+00003030: 2a27 2066 6f72 2066 756e 6374 696f 6e20  *' for function \n+00003040: 6e61 6d65 7320 616e 6420 6461 7461 2074  names and data t\n+00003050: 7970 6573 0a61 6e64 2027 464b 4f5f 2a27  ypes.and 'FKO_*'\n+00003060: 2066 6f72 206f 7468 6572 2073 796d 626f   for other symbo\n+00003070: 6c73 2e20 204f 7468 6572 2073 796d 626f  ls.  Other symbo\n+00003080: 6c73 2069 6e74 6572 6e61 6c20 746f 2046  ls internal to F\n+00003090: 4b4f 206d 6179 2074 616b 650a 7468 6520  KO may take.the \n+000030a0: 666f 726d 2027 5f66 6b6f 5f2a 2720 616e  form '_fko_*' an\n+000030b0: 6420 275f 464b 4f5f 2a27 2e0a 0a1f 0a46  d '_FKO_*'.....F\n+000030c0: 696c 653a 206c 6962 666b 6f2e 696e 666f  ile: libfko.info\n+000030d0: 2c20 204e 6f64 653a 2043 6f6d 7069 6c69  ,  Node: Compili\n+000030e0: 6e67 2077 6974 6820 6c69 6266 6b6f 2c20  ng with libfko, \n+000030f0: 204e 6578 743a 2053 5041 2050 6172 616d   Next: SPA Param\n+00003100: 6574 6572 2054 7970 6573 2c20 2050 7265  eter Types,  Pre\n+00003110: 763a 206c 6962 666b 6f20 4865 6164 6572  v: libfko Header\n+00003120: 2c20 2055 703a 2050 7265 7061 7261 7469  ,  Up: Preparati\n+00003130: 6f6e 0a0a 322e 3220 436f 6d70 696c 696e  on..2.2 Compilin\n+00003140: 6720 7769 7468 206c 6962 666b 6f0a 3d3d  g with libfko.==\n 00003150: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================\n-00003160: 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 6620 796f  =========..If yo\n-00003170: 7520 7761 6e74 2074 6f20 636f 6d70 696c  u want to compil\n-00003180: 6520 6120 736f 7572 6365 2066 696c 6520  e a source file \n-00003190: 696e 636c 7564 696e 6720 7468 6520 2766  including the 'f\n-000031a0: 6b6f 2e68 2720 6865 6164 6572 2066 696c  ko.h' header fil\n-000031b0: 652c 0a79 6f75 206d 7573 7420 6d61 6b65  e,.you must make\n-000031c0: 2073 7572 6520 7468 6174 2074 6865 2063   sure that the c\n-000031d0: 6f6d 7069 6c65 7220 6361 6e20 6669 6e64  ompiler can find\n-000031e0: 2069 7420 696e 2074 6865 2064 6972 6563   it in the direc\n-000031f0: 746f 7279 0a68 6965 7261 7263 6879 2e20  tory.hierarchy. \n-00003200: 2054 6869 7320 6973 2061 6363 6f6d 706c   This is accompl\n-00003210: 6973 6865 6420 6279 2061 6464 696e 6720  ished by adding \n-00003220: 7468 6520 7061 7468 2074 6f20 7468 6520  the path to the \n-00003230: 6469 7265 6374 6f72 7920 696e 0a77 6869  directory in.whi\n-00003240: 6368 2074 6865 2068 6561 6465 7220 6669  ch the header fi\n-00003250: 6c65 2069 7320 6c6f 6361 7465 6420 746f  le is located to\n-00003260: 2074 6865 2063 6f6d 7069 6c65 7273 2069   the compilers i\n-00003270: 6e63 6c75 6465 2066 696c 6520 7365 6172  nclude file sear\n-00003280: 6368 0a70 6174 6820 2876 6961 2074 6865  ch.path (via the\n-00003290: 2027 2d49 2720 6f70 7469 6f6e 292e 0a0a   '-I' option)...\n-000032a0: 2020 2046 6f72 2065 7861 6d70 6c65 2c20     For example, \n-000032b0: 6966 2079 6f75 2069 6e73 7461 6c6c 6564  if you installed\n-000032c0: 206c 6962 666b 6f20 696e 2027 2f6f 7074   libfko in '/opt\n-000032d0: 2f66 6b6f 272c 2079 6f75 206d 6179 2077  /fko', you may w\n-000032e0: 616e 7420 746f 0a61 6464 2027 2d49 2f6f  ant to.add '-I/o\n-000032f0: 7074 2f66 6b6f 2f69 6e63 6c75 6465 2720  pt/fko/include' \n-00003300: 746f 2027 4346 4c41 4753 272c 206f 7220  to 'CFLAGS', or \n-00003310: 6469 7265 6374 6c79 206f 6e20 7468 6520  directly on the \n-00003320: 636f 6d6d 616e 642d 6c69 6e65 3a0a 0a20  command-line:.. \n-00003330: 2020 2020 6763 6320 2d63 2066 6f6f 2e63      gcc -c foo.c\n-00003340: 202d 492f 6f70 742f 666b 6f2f 696e 636c   -I/opt/fko/incl\n-00003350: 7564 6520 2e2e 2e0a 0a20 2020 5468 6520  ude .....   The \n-00003360: 7361 6d65 2069 7320 7472 7565 2077 6865  same is true whe\n-00003370: 6e20 6c69 6e6b 696e 6720 6120 7072 6f67  n linking a prog\n-00003380: 7261 6d20 7769 7468 2074 6865 206c 6962  ram with the lib\n-00003390: 7261 7279 2e20 2049 6e20 7468 6973 0a63  rary.  In this.c\n-000033a0: 6173 652c 2074 6865 206c 696e 6b65 7220  ase, the linker \n-000033b0: 6861 7320 746f 2066 696e 6420 7468 6520  has to find the \n-000033c0: 6c69 6272 6172 7920 6669 6c65 732e 2020  library files.  \n-000033d0: 466f 7220 7468 6973 2074 6f20 776f 726b  For this to work\n-000033e0: 2c20 7468 650a 7061 7468 2074 6f20 7468  , the.path to th\n-000033f0: 6520 6c69 6272 6172 7920 6669 6c65 7320  e library files \n-00003400: 6861 7320 746f 2062 6520 6164 6465 6420  has to be added \n-00003410: 746f 2074 6865 206c 6962 7261 7279 2073  to the library s\n-00003420: 6561 7263 6820 7061 7468 0a28 7669 6120  earch path.(via \n-00003430: 7468 6520 272d 4c27 206f 7074 696f 6e29  the '-L' option)\n-00003440: 2e0a 0a20 2020 436f 6e74 696e 7569 6e67  ...   Continuing\n-00003450: 2077 6974 6820 7468 6520 6578 616d 706c   with the exampl\n-00003460: 6520 6162 6f76 6520 796f 7520 6d61 7920  e above you may \n-00003470: 7761 6e74 2074 6f20 6164 640a 272d 4c2f  want to add.'-L/\n-00003480: 6f70 742f 666b 6f2f 6c69 6227 2074 6f20  opt/fko/lib' to \n-00003490: 274c 4446 4c41 4753 272c 206f 7220 6469  'LDFLAGS', or di\n-000034a0: 7265 6374 6c79 206f 6e20 7468 6520 636f  rectly on the co\n-000034b0: 6d6d 616e 642d 6c69 6e65 3a0a 0a20 2020  mmand-line:..   \n-000034c0: 2020 6763 6320 2d6f 2066 6f6f 2066 6f6f    gcc -o foo foo\n-000034d0: 2e63 202d 492f 6f70 742f 666b 6f2f 696e  .c -I/opt/fko/in\n-000034e0: 636c 7564 6520 2d4c 2f6f 7074 2f66 6b6f  clude -L/opt/fko\n-000034f0: 2f6c 6962 202d 6c66 6b6f 0a0a 1f0a 4669  /lib -lfko....Fi\n-00003500: 6c65 3a20 6c69 6266 6b6f 2e69 6e66 6f2c  le: libfko.info,\n-00003510: 2020 4e6f 6465 3a20 5350 4120 5061 7261    Node: SPA Para\n-00003520: 6d65 7465 7220 5479 7065 732c 2020 5072  meter Types,  Pr\n-00003530: 6576 3a20 436f 6d70 696c 696e 6720 7769  ev: Compiling wi\n-00003540: 7468 206c 6962 666b 6f2c 2020 5570 3a20  th libfko,  Up: \n-00003550: 5072 6570 6172 6174 696f 6e0a 0a32 2e33  Preparation..2.3\n-00003560: 2053 5041 2050 6172 616d 6574 6572 2054   SPA Parameter T\n-00003570: 7970 6573 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d  ypes.===========\n-00003580: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 2a20  ============..* \n-00003590: 4d65 6e75 3a0a 0a2a 2044 6967 6573 7473  Menu:..* Digests\n-000035a0: 3a3a 2020 2020 2020 2020 2020 2020 2020  ::              \n-000035b0: 2020 2020 2020 2020 2054 6865 206d 6573           The mes\n-000035c0: 7361 6765 2064 6967 6573 7420 6861 7368  sage digest hash\n-000035d0: 6573 2073 7570 706f 7274 6564 2062 7920  es supported by \n-000035e0: 6c69 6266 6b6f 0a2a 2053 5041 204d 6573  libfko.* SPA Mes\n-000035f0: 7361 6765 733a 3a20 2020 2020 2020 2020  sages::         \n-00003600: 2020 2020 2020 2020 2054 6865 2066 6b6f           The fko\n-00003610: 2053 5041 206d 6573 7361 6765 2074 7970   SPA message typ\n-00003620: 6573 0a20 2020 2020 2020 2020 2020 2020  es.             \n+00003160: 3d3d 3d3d 3d3d 3d0a 0a49 6620 796f 7520  =======..If you \n+00003170: 7761 6e74 2074 6f20 636f 6d70 696c 6520  want to compile \n+00003180: 6120 736f 7572 6365 2066 696c 6520 696e  a source file in\n+00003190: 636c 7564 696e 6720 7468 6520 2766 6b6f  cluding the 'fko\n+000031a0: 2e68 2720 6865 6164 6572 2066 696c 652c  .h' header file,\n+000031b0: 0a79 6f75 206d 7573 7420 6d61 6b65 2073  .you must make s\n+000031c0: 7572 6520 7468 6174 2074 6865 2063 6f6d  ure that the com\n+000031d0: 7069 6c65 7220 6361 6e20 6669 6e64 2069  piler can find i\n+000031e0: 7420 696e 2074 6865 2064 6972 6563 746f  t in the directo\n+000031f0: 7279 0a68 6965 7261 7263 6879 2e20 2054  ry.hierarchy.  T\n+00003200: 6869 7320 6973 2061 6363 6f6d 706c 6973  his is accomplis\n+00003210: 6865 6420 6279 2061 6464 696e 6720 7468  hed by adding th\n+00003220: 6520 7061 7468 2074 6f20 7468 6520 6469  e path to the di\n+00003230: 7265 6374 6f72 7920 696e 0a77 6869 6368  rectory in.which\n+00003240: 2074 6865 2068 6561 6465 7220 6669 6c65   the header file\n+00003250: 2069 7320 6c6f 6361 7465 6420 746f 2074   is located to t\n+00003260: 6865 2063 6f6d 7069 6c65 7273 2069 6e63  he compilers inc\n+00003270: 6c75 6465 2066 696c 6520 7365 6172 6368  lude file search\n+00003280: 0a70 6174 6820 2876 6961 2074 6865 2027  .path (via the '\n+00003290: 2d49 2720 6f70 7469 6f6e 292e 0a0a 2020  -I' option)...  \n+000032a0: 2046 6f72 2065 7861 6d70 6c65 2c20 6966   For example, if\n+000032b0: 2079 6f75 2069 6e73 7461 6c6c 6564 206c   you installed l\n+000032c0: 6962 666b 6f20 696e 2027 2f6f 7074 2f66  ibfko in '/opt/f\n+000032d0: 6b6f 272c 2079 6f75 206d 6179 2077 616e  ko', you may wan\n+000032e0: 7420 746f 0a61 6464 2027 2d49 2f6f 7074  t to.add '-I/opt\n+000032f0: 2f66 6b6f 2f69 6e63 6c75 6465 2720 746f  /fko/include' to\n+00003300: 2027 4346 4c41 4753 272c 206f 7220 6469   'CFLAGS', or di\n+00003310: 7265 6374 6c79 206f 6e20 7468 6520 636f  rectly on the co\n+00003320: 6d6d 616e 642d 6c69 6e65 3a0a 0a20 2020  mmand-line:..   \n+00003330: 2020 6763 6320 2d63 2066 6f6f 2e63 202d    gcc -c foo.c -\n+00003340: 492f 6f70 742f 666b 6f2f 696e 636c 7564  I/opt/fko/includ\n+00003350: 6520 2e2e 2e0a 0a20 2020 5468 6520 7361  e .....   The sa\n+00003360: 6d65 2069 7320 7472 7565 2077 6865 6e20  me is true when \n+00003370: 6c69 6e6b 696e 6720 6120 7072 6f67 7261  linking a progra\n+00003380: 6d20 7769 7468 2074 6865 206c 6962 7261  m with the libra\n+00003390: 7279 2e20 2049 6e20 7468 6973 0a63 6173  ry.  In this.cas\n+000033a0: 652c 2074 6865 206c 696e 6b65 7220 6861  e, the linker ha\n+000033b0: 7320 746f 2066 696e 6420 7468 6520 6c69  s to find the li\n+000033c0: 6272 6172 7920 6669 6c65 732e 2020 466f  brary files.  Fo\n+000033d0: 7220 7468 6973 2074 6f20 776f 726b 2c20  r this to work, \n+000033e0: 7468 650a 7061 7468 2074 6f20 7468 6520  the.path to the \n+000033f0: 6c69 6272 6172 7920 6669 6c65 7320 6861  library files ha\n+00003400: 7320 746f 2062 6520 6164 6465 6420 746f  s to be added to\n+00003410: 2074 6865 206c 6962 7261 7279 2073 6561   the library sea\n+00003420: 7263 6820 7061 7468 0a28 7669 6120 7468  rch path.(via th\n+00003430: 6520 272d 4c27 206f 7074 696f 6e29 2e0a  e '-L' option)..\n+00003440: 0a20 2020 436f 6e74 696e 7569 6e67 2077  .   Continuing w\n+00003450: 6974 6820 7468 6520 6578 616d 706c 6520  ith the example \n+00003460: 6162 6f76 6520 796f 7520 6d61 7920 7761  above you may wa\n+00003470: 6e74 2074 6f20 6164 640a 272d 4c2f 6f70  nt to add.'-L/op\n+00003480: 742f 666b 6f2f 6c69 6227 2074 6f20 274c  t/fko/lib' to 'L\n+00003490: 4446 4c41 4753 272c 206f 7220 6469 7265  DFLAGS', or dire\n+000034a0: 6374 6c79 206f 6e20 7468 6520 636f 6d6d  ctly on the comm\n+000034b0: 616e 642d 6c69 6e65 3a0a 0a20 2020 2020  and-line:..     \n+000034c0: 6763 6320 2d6f 2066 6f6f 2066 6f6f 2e63  gcc -o foo foo.c\n+000034d0: 202d 492f 6f70 742f 666b 6f2f 696e 636c   -I/opt/fko/incl\n+000034e0: 7564 6520 2d4c 2f6f 7074 2f66 6b6f 2f6c  ude -L/opt/fko/l\n+000034f0: 6962 202d 6c66 6b6f 0a0a 1f0a 4669 6c65  ib -lfko....File\n+00003500: 3a20 6c69 6266 6b6f 2e69 6e66 6f2c 2020  : libfko.info,  \n+00003510: 4e6f 6465 3a20 5350 4120 5061 7261 6d65  Node: SPA Parame\n+00003520: 7465 7220 5479 7065 732c 2020 5072 6576  ter Types,  Prev\n+00003530: 3a20 436f 6d70 696c 696e 6720 7769 7468  : Compiling with\n+00003540: 206c 6962 666b 6f2c 2020 5570 3a20 5072   libfko,  Up: Pr\n+00003550: 6570 6172 6174 696f 6e0a 0a32 2e33 2053  eparation..2.3 S\n+00003560: 5041 2050 6172 616d 6574 6572 2054 7970  PA Parameter Typ\n+00003570: 6573 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  es.=============\n+00003580: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 2a20 4d65  ==========..* Me\n+00003590: 6e75 3a0a 0a2a 2044 6967 6573 7473 3a3a  nu:..* Digests::\n+000035a0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n+000035b0: 2020 2020 2020 2054 6865 206d 6573 7361         The messa\n+000035c0: 6765 2064 6967 6573 7420 6861 7368 6573  ge digest hashes\n+000035d0: 2073 7570 706f 7274 6564 2062 7920 6c69   supported by li\n+000035e0: 6266 6b6f 0a2a 2053 5041 204d 6573 7361  bfko.* SPA Messa\n+000035f0: 6765 733a 3a20 2020 2020 2020 2020 2020  ges::           \n+00003600: 2020 2020 2020 2054 6865 2066 6b6f 2053         The fko S\n+00003610: 5041 206d 6573 7361 6765 2074 7970 6573  PA message types\n+00003620: 0a20 2020 2020 2020 2020 2020 2020 2020  .               \n 00003630: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00003640: 2020 2020 2073 7570 706f 7274 6564 2062       supported b\n-00003650: 7920 6c69 6266 6b6f 2028 616e 6420 6677  y libfko (and fw\n-00003660: 6b6e 6f70 290a 2a20 456e 6372 7970 7469  knop).* Encrypti\n-00003670: 6f6e 2041 6c67 6f72 6974 686d 733a 3a20  on Algorithms:: \n-00003680: 2020 2020 2020 2020 456e 6372 7970 7469          Encrypti\n-00003690: 6f6e 2073 6368 656d 6573 2073 7570 706f  on schemes suppo\n-000036a0: 7274 6564 2062 7920 6c69 6266 6b6f 0a2a  rted by libfko.*\n-000036b0: 2048 4d41 4320 4469 6765 7374 733a 3a20   HMAC Digests:: \n-000036c0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000036d0: 2044 6967 6573 7473 2074 6861 7420 6361   Digests that ca\n-000036e0: 6e20 6265 2075 7365 6420 746f 2062 7569  n be used to bui\n-000036f0: 6c64 2061 6e20 484d 4143 0a0a 1f0a 4669  ld an HMAC....Fi\n-00003700: 6c65 3a20 6c69 6266 6b6f 2e69 6e66 6f2c  le: libfko.info,\n-00003710: 2020 4e6f 6465 3a20 4469 6765 7374 732c    Node: Digests,\n-00003720: 2020 4e65 7874 3a20 5350 4120 4d65 7373    Next: SPA Mess\n-00003730: 6167 6573 2c20 2055 703a 2053 5041 2050  ages,  Up: SPA P\n-00003740: 6172 616d 6574 6572 2054 7970 6573 0a0a  arameter Types..\n-00003750: 322e 332e 3120 4469 6765 7374 730a 2d2d  2.3.1 Digests.--\n-00003760: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865  -----------..The\n-00003770: 2066 776b 6e6f 7020 7379 7374 656d 2065   fwknop system e\n-00003780: 6d70 6c6f 7973 2061 206d 6573 7361 6765  mploys a message\n-00003790: 2064 6967 6573 7420 6861 7368 206f 6620   digest hash of \n-000037a0: 7468 6520 5350 4120 6461 7461 2061 7320  the SPA data as \n-000037b0: 6f6e 650a 6f66 2074 6865 2064 6174 6120  one.of the data \n-000037c0: 6669 656c 6473 2074 6f20 6163 7420 6120  fields to act a \n-000037d0: 7369 676e 6174 7572 6520 7768 6963 6820  signature which \n-000037e0: 6361 6e20 6265 2075 7365 6420 6174 2074  can be used at t\n-000037f0: 6865 2072 6563 6569 7669 6e67 0a65 6e64  he receiving.end\n-00003800: 2074 6f20 7665 7269 6679 2074 6865 2064   to verify the d\n-00003810: 6174 6120 6973 2076 616c 6964 2028 616c  ata is valid (al\n-00003820: 7468 6f75 6768 2074 6869 7320 6665 6174  though this feat\n-00003830: 7572 6520 6861 7320 6265 656e 0a73 7570  ure has been.sup\n-00003840: 6572 6365 6465 6420 6279 2074 6865 2075  erceded by the u\n-00003850: 7361 6765 206f 6620 616e 2048 4d41 4320  sage of an HMAC \n-00003860: 666f 7220 7072 6f70 6572 206d 6573 7361  for proper messa\n-00003870: 6765 2061 7574 6865 6e74 6963 6174 696f  ge authenticatio\n-00003880: 6e20 616e 640a 7665 7269 6669 6361 7469  n and.verificati\n-00003890: 6f6e 206f 6620 696e 7465 6772 6974 7929  on of integrity)\n-000038a0: 2e20 2054 6865 2072 6573 756c 7469 6e67  .  The resulting\n-000038b0: 2064 6967 6573 7420 6973 2062 6173 6536   digest is base6\n-000038c0: 342d 656e 636f 6465 640a 6265 666f 7265  4-encoded.before\n-000038d0: 2069 7420 6973 2061 6464 6564 2074 6f20   it is added to \n-000038e0: 7468 6520 5350 4120 6461 7461 2e0a 0a20  the SPA data... \n-000038f0: 2020 4375 7272 656e 746c 792c 206c 6962    Currently, lib\n-00003900: 666b 6f20 7375 7070 6f72 7473 2074 6865  fko supports the\n-00003910: 2073 616d 6520 6d65 7373 6167 6520 6469   same message di\n-00003920: 6765 7374 7320 6173 2074 6865 206c 6567  gests as the leg\n-00003930: 6163 790a 6677 6b6e 6f70 2070 6c75 7320  acy.fwknop plus \n-00003940: 7477 6f20 6f74 6865 7273 2028 5348 4133  two others (SHA3\n-00003950: 3834 2061 6e64 2053 4841 3531 3229 2e20  84 and SHA512). \n-00003960: 2054 6865 7365 2061 7265 2028 696e 206f   These are (in o\n-00003970: 7264 6572 206f 660a 7374 7265 6e67 7468  rder of.strength\n-00003980: 293a 0a0a 202d 2d20 5661 7269 6162 6c65  ):.. -- Variable\n-00003990: 3a20 696e 7420 666b 6f5f 6469 6765 7374  : int fko_digest\n-000039a0: 5f74 7970 655f 740a 2020 2020 2027 464b  _type_t.     'FK\n-000039b0: 4f5f 4449 4745 5354 5f4d 4435 270a 2020  O_DIGEST_MD5'.  \n-000039c0: 2020 2027 464b 4f5f 4449 4745 5354 5f53     'FKO_DIGEST_S\n-000039d0: 4841 3127 0a20 2020 2020 2746 4b4f 5f44  HA1'.     'FKO_D\n-000039e0: 4947 4553 545f 5348 4132 3536 2028 6c69  IGEST_SHA256 (li\n-000039f0: 6266 6b6f 2064 6566 6175 6c74 2927 0a20  bfko default)'. \n-00003a00: 2020 2020 2746 4b4f 5f44 4947 4553 545f      'FKO_DIGEST_\n-00003a10: 5348 4133 3834 270a 2020 2020 2027 464b  SHA384'.     'FK\n-00003a20: 4f5f 4449 4745 5354 5f53 4841 3531 3227  O_DIGEST_SHA512'\n-00003a30: 0a0a 2020 2041 7320 696e 6469 6361 7465  ..   As indicate\n-00003a40: 6420 696e 2074 6865 206c 6973 7420 6162  d in the list ab\n-00003a50: 6f76 652c 2053 4841 3235 3620 6973 2074  ove, SHA256 is t\n-00003a60: 6865 2064 6566 6175 6c74 2e20 2054 6869  he default.  Thi\n-00003a70: 7320 6d65 616e 730a 7468 6520 6469 6765  s means.the dige\n-00003a80: 7374 2074 7970 6520 646f 6573 206e 6f74  st type does not\n-00003a90: 206e 6565 6420 746f 2062 6520 6578 706c   need to be expl\n-00003aa0: 6963 6974 6c79 2073 6574 2075 6e6c 6573  icitly set unles\n-00003ab0: 7320 796f 7520 7769 7368 2074 6f0a 7573  s you wish to.us\n-00003ac0: 6520 6f6e 6520 6f66 2074 6865 206f 7468  e one of the oth\n-00003ad0: 6572 2076 616c 7565 732e 2020 5468 6973  er values.  This\n-00003ae0: 2061 7070 6c69 6573 2074 6f20 616c 6c20   applies to all \n-00003af0: 6c69 6266 6b6f 2053 5041 2064 6174 6120  libfko SPA data \n-00003b00: 6669 656c 6473 0a74 6861 7420 6861 7665  fields.that have\n-00003b10: 2061 2064 6566 6175 6c74 2076 616c 7565   a default value\n-00003b20: 2e0a 0a1f 0a46 696c 653a 206c 6962 666b  .....File: libfk\n-00003b30: 6f2e 696e 666f 2c20 204e 6f64 653a 2053  o.info,  Node: S\n-00003b40: 5041 204d 6573 7361 6765 732c 2020 4e65  PA Messages,  Ne\n-00003b50: 7874 3a20 456e 6372 7970 7469 6f6e 2041  xt: Encryption A\n-00003b60: 6c67 6f72 6974 686d 732c 2020 5072 6576  lgorithms,  Prev\n-00003b70: 3a20 4469 6765 7374 732c 2020 5570 3a20  : Digests,  Up: \n-00003b80: 5350 4120 5061 7261 6d65 7465 7220 5479  SPA Parameter Ty\n-00003b90: 7065 730a 0a32 2e33 2e32 2053 5041 204d  pes..2.3.2 SPA M\n-00003ba0: 6573 7361 6765 730a 2d2d 2d2d 2d2d 2d2d  essages.--------\n-00003bb0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520  ----------..The \n-00003bc0: 6677 6b6e 6f70 2073 7973 7465 6d20 2861  fwknop system (a\n-00003bd0: 6e64 2073 7562 7365 7175 656e 746c 7920  nd subsequently \n-00003be0: 6c69 6266 6b6f 292c 2073 7570 706f 7274  libfko), support\n-00003bf0: 2061 2073 7065 6369 6669 6320 7365 7420   a specific set \n-00003c00: 6f66 0a6d 6573 7361 6765 2074 7970 6573  of.message types\n-00003c10: 2e20 2054 6865 206d 6573 7361 6765 2074  .  The message t\n-00003c20: 7970 6520 7661 6c75 6520 6973 2075 7365  ype value is use\n-00003c30: 6420 6279 2066 776b 6e6f 7020 746f 2068  d by fwknop to h\n-00003c40: 656c 700a 6465 7465 726d 696e 6520 7468  elp.determine th\n-00003c50: 6520 636f 7272 6563 7420 6d65 7373 6167  e correct messag\n-00003c60: 6520 666f 726d 6174 2061 6e64 2063 6f6e  e format and con\n-00003c70: 7465 6e74 2e20 2054 6865 7365 206d 6573  tent.  These mes\n-00003c80: 7361 6765 2074 7970 6573 0a61 7265 3a0a  sage types.are:.\n-00003c90: 0a20 2d2d 2056 6172 6961 626c 653a 2069  . -- Variable: i\n-00003ca0: 6e74 2066 6b6f 5f6d 6573 7361 6765 5f74  nt fko_message_t\n-00003cb0: 7970 655f 740a 2020 2020 2027 464b 4f5f  ype_t.     'FKO_\n-00003cc0: 434f 4d4d 414e 445f 4d53 4727 0a20 2020  COMMAND_MSG'.   \n-00003cd0: 2020 2020 2020 2041 2072 6571 7565 7374         A request\n-00003ce0: 2074 6f20 6861 7665 2074 6865 2066 776b   to have the fwk\n-00003cf0: 6e6f 7020 7365 7276 6572 2065 7865 6375  nop server execu\n-00003d00: 7465 2074 6865 2067 6976 656e 2063 6f6d  te the given com\n-00003d10: 6d61 6e64 2e0a 2020 2020 2020 2020 2020  mand..          \n-00003d20: 5468 6520 666f 726d 6174 2066 6f72 2074  The format for t\n-00003d30: 6869 7320 7479 7065 2069 733a 2027 3c69  his type is: '<i\n-00003d40: 7020 6f66 2072 6571 7565 7374 6f72 3e2c  p of requestor>,\n-00003d50: 3c63 6f6d 6d61 6e64 0a20 2020 2020 2020  <command.       \n-00003d60: 2020 2074 6578 743e 272e 0a20 2020 2020     text>'..     \n-00003d70: 2020 2020 2020 2020 2020 2231 3932 2e31            \"192.1\n-00003d80: 3638 2e31 2e32 2c75 6e61 6d65 202d 6122  68.1.2,uname -a\"\n-00003d90: 0a0a 2020 2020 2027 464b 4f5f 4143 4345  ..     'FKO_ACCE\n-00003da0: 5353 5f4d 5347 270a 2020 2020 2020 2020  SS_MSG'.        \n-00003db0: 2020 4120 6261 7369 6320 6163 6365 7373    A basic access\n-00003dc0: 2072 6571 7565 7374 2e20 2054 6869 7320   request.  This \n-00003dd0: 6973 2074 6865 206d 6f73 7420 636f 6d6d  is the most comm\n-00003de0: 6f6e 2074 7970 6520 696e 2075 7365 2e0a  on type in use..\n-00003df0: 2020 2020 2020 2020 2020 5468 6520 666f            The fo\n-00003e00: 726d 6174 2066 6f72 2074 6869 7320 7479  rmat for this ty\n-00003e10: 7065 2069 733a 2027 3c69 7020 6f66 0a20  pe is: '<ip of. \n-00003e20: 2020 2020 2020 2020 2072 6571 7565 7374           request\n-00003e30: 6f72 3e2c 3c70 726f 746f 636f 6c3e 2f3c  or>,<protocol>/<\n-00003e40: 706f 7274 3e27 2e20 204e 6f74 6520 7468  port>'.  Note th\n-00003e50: 6174 206d 756c 7469 706c 650a 2020 2020  at multiple.    \n-00003e60: 2020 2020 2020 7072 6f74 6f63 6f6c 2f70        protocol/p\n-00003e70: 6f72 7420 656e 7472 6965 7320 6172 6520  ort entries are \n-00003e80: 616c 6c6f 7765 642e 0a20 2020 2020 2020  allowed..       \n-00003e90: 2020 2020 2020 2020 2231 3932 2e31 3638          \"192.168\n-00003ea0: 2e31 2e32 2c74 6370 2f32 3222 0a20 2020  .1.2,tcp/22\".   \n-00003eb0: 2020 2020 2020 2020 2020 2020 2231 3932              \"192\n-00003ec0: 2e31 3638 2e31 2e32 2c74 6370 2f32 322c  .168.1.2,tcp/22,\n-00003ed0: 7564 702f 3530 3035 220a 0a20 2020 2020  udp/5005\"..     \n-00003ee0: 2746 4b4f 5f4e 4154 5f41 4343 4553 535f  'FKO_NAT_ACCESS_\n-00003ef0: 4d53 4727 0a20 2020 2020 2020 2020 2041  MSG'.          A\n-00003f00: 6e20 6163 6365 7373 2072 6571 7565 7374  n access request\n-00003f10: 2074 6861 7420 616c 736f 2070 726f 7669   that also provi\n-00003f20: 6465 2069 6e66 6f72 6d61 7469 6f6e 2066  de information f\n-00003f30: 6f72 2074 6865 2066 776b 6e6f 700a 2020  or the fwknop.  \n-00003f40: 2020 2020 2020 2020 7365 7276 6572 2074          server t\n-00003f50: 6f20 6372 6561 7465 2061 204e 6574 776f  o create a Netwo\n-00003f60: 726b 2041 6464 7265 7373 2054 7261 6e73  rk Address Trans\n-00003f70: 6c61 7469 6f6e 2028 4e41 5420 746f 2061  lation (NAT to a\n-00003f80: 6e0a 2020 2020 2020 2020 2020 696e 7465  n.          inte\n-00003f90: 726e 616c 2061 6464 7265 7373 2e20 2054  rnal address.  T\n-00003fa0: 6865 2066 6f72 6d61 7420 666f 7220 7468  he format for th\n-00003fb0: 6973 2073 7472 696e 6720 6973 3a20 273c  is string is: '<\n-00003fc0: 696e 7465 726e 616c 0a20 2020 2020 2020  internal.       \n-00003fd0: 2020 2069 703e 2c3c 6578 7420 6e61 7420     ip>,<ext nat \n-00003fe0: 706f 7274 3e27 2e0a 2020 2020 2020 2020  port>'..        \n-00003ff0: 2020 2020 2020 2022 3130 2e31 302e 312e         \"10.10.1.\n-00004000: 322c 3939 3232 220a 0a20 2020 2020 2746  2,9922\"..     'F\n-00004010: 4b4f 5f43 4c49 454e 545f 5449 4d45 4f55  KO_CLIENT_TIMEOU\n-00004020: 545f 4143 4345 5353 5f4d 5347 270a 2020  T_ACCESS_MSG'.  \n-00004030: 2020 2020 2020 2020 5468 6973 2069 7320          This is \n-00004040: 616e 2046 4b4f 5f41 4343 4553 535f 5245  an FKO_ACCESS_RE\n-00004050: 5155 4553 5420 7769 7468 2061 2074 696d  QUEST with a tim\n-00004060: 656f 7574 2070 6172 616d 6574 6572 2066  eout parameter f\n-00004070: 6f72 2074 6865 0a20 2020 2020 2020 2020  or the.         \n-00004080: 2066 776b 6e6f 7020 7365 7276 6572 2e20   fwknop server. \n-00004090: 2054 6865 2074 696d 656f 7574 2076 616c   The timeout val\n-000040a0: 7565 2069 7320 7072 6f76 6964 6564 2076  ue is provided v\n-000040b0: 6961 2074 6865 0a20 2020 2020 2020 2020  ia the.         \n-000040c0: 2027 636c 6965 6e74 5f74 696d 656f 7574   'client_timeout\n-000040d0: 2720 6461 7461 2066 6965 6c64 2e0a 0a20  ' data field... \n-000040e0: 2020 2020 2746 4b4f 5f43 4c49 454e 545f      'FKO_CLIENT_\n-000040f0: 5449 4d45 4f55 545f 4e41 545f 4143 4345  TIMEOUT_NAT_ACCE\n-00004100: 5353 5f4d 5347 270a 2020 2020 2020 2020  SS_MSG'.        \n-00004110: 2020 5468 6973 2069 7320 616e 2046 4b4f    This is an FKO\n-00004120: 5f4e 4154 5f41 4343 4553 535f 5245 5155  _NAT_ACCESS_REQU\n-00004130: 4553 5420 7769 7468 2061 2074 696d 656f  EST with a timeo\n-00004140: 7574 2070 6172 616d 6574 6572 2066 6f72  ut parameter for\n-00004150: 0a20 2020 2020 2020 2020 2074 6865 2066  .          the f\n-00004160: 776b 6e6f 7020 7365 7276 6572 2e20 2054  wknop server.  T\n-00004170: 6865 2074 696d 656f 7574 2076 616c 7565  he timeout value\n-00004180: 2069 7320 7072 6f76 6964 6564 2076 6961   is provided via\n-00004190: 2074 6865 0a20 2020 2020 2020 2020 2027   the.          '\n-000041a0: 636c 6965 6e74 5f74 696d 656f 7574 2720  client_timeout' \n-000041b0: 6461 7461 2066 6965 6c64 2e0a 0a20 2020  data field...   \n-000041c0: 2020 2746 4b4f 5f4c 4f43 414c 5f4e 4154    'FKO_LOCAL_NAT\n-000041d0: 5f41 4343 4553 535f 4d53 4727 0a20 2020  _ACCESS_MSG'.   \n-000041e0: 2020 2020 2020 2054 6869 7320 6973 2073         This is s\n-000041f0: 696d 696c 6172 2074 6f20 7468 6520 464b  imilar to the FK\n-00004200: 4f5f 4e41 545f 4143 4345 5353 2072 6571  O_NAT_ACCESS req\n-00004210: 7565 7374 2065 7863 6570 7420 7468 6520  uest except the \n-00004220: 4e41 540a 2020 2020 2020 2020 2020 6973  NAT.          is\n-00004230: 2074 6f20 7468 6520 6c6f 6361 6c20 746f   to the local to\n-00004240: 2074 6865 2073 6572 7665 7220 2869 2e65   the server (i.e\n-00004250: 2e20 2061 2073 6572 7669 6365 206c 6973  .  a service lis\n-00004260: 7465 6e69 6e67 206f 6e0a 2020 2020 2020  tening on.      \n-00004270: 2020 2020 3132 372e 302e 302e 3129 2e0a      127.0.0.1)..\n-00004280: 0a20 2020 2020 2746 4b4f 5f43 4c49 454e  .     'FKO_CLIEN\n-00004290: 545f 5449 4d45 4f55 545f 4c4f 4341 4c5f  T_TIMEOUT_LOCAL_\n-000042a0: 4e41 545f 4143 4345 5353 5f4d 5347 270a  NAT_ACCESS_MSG'.\n-000042b0: 2020 2020 2020 2020 2020 5468 6973 2069            This i\n-000042c0: 7320 616e 2046 4b4f 5f4c 4f43 414c 5f4e  s an FKO_LOCAL_N\n-000042d0: 4154 5f41 4343 4553 535f 5245 5155 4553  AT_ACCESS_REQUES\n-000042e0: 5420 7769 7468 2061 2074 696d 656f 7574  T with a timeout\n-000042f0: 0a20 2020 2020 2020 2020 2070 6172 616d  .          param\n-00004300: 6574 6572 2066 6f72 2074 6865 2066 776b  eter for the fwk\n-00004310: 6e6f 7020 7365 7276 6572 2e20 2054 6865  nop server.  The\n-00004320: 2074 696d 656f 7574 2076 616c 7565 2069   timeout value i\n-00004330: 730a 2020 2020 2020 2020 2020 7072 6f76  s.          prov\n-00004340: 6964 6564 2076 6961 2074 6865 2027 636c  ided via the 'cl\n-00004350: 6965 6e74 5f74 696d 656f 7574 2720 6461  ient_timeout' da\n-00004360: 7461 2066 6965 6c64 2e0a 0a1f 0a46 696c  ta field.....Fil\n-00004370: 653a 206c 6962 666b 6f2e 696e 666f 2c20  e: libfko.info, \n-00004380: 204e 6f64 653a 2045 6e63 7279 7074 696f   Node: Encryptio\n-00004390: 6e20 416c 676f 7269 7468 6d73 2c20 204e  n Algorithms,  N\n-000043a0: 6578 743a 2048 4d41 4320 4469 6765 7374  ext: HMAC Digest\n-000043b0: 732c 2020 5072 6576 3a20 5350 4120 4d65  s,  Prev: SPA Me\n-000043c0: 7373 6167 6573 2c20 2055 703a 2053 5041  ssages,  Up: SPA\n-000043d0: 2050 6172 616d 6574 6572 2054 7970 6573   Parameter Types\n-000043e0: 0a0a 322e 332e 3320 456e 6372 7970 7469  ..2.3.3 Encrypti\n-000043f0: 6f6e 2041 6c67 6f72 6974 686d 730a 2d2d  on Algorithms.--\n+00003640: 2020 2073 7570 706f 7274 6564 2062 7920     supported by \n+00003650: 6c69 6266 6b6f 2028 616e 6420 6677 6b6e  libfko (and fwkn\n+00003660: 6f70 290a 2a20 456e 6372 7970 7469 6f6e  op).* Encryption\n+00003670: 2041 6c67 6f72 6974 686d 733a 3a20 2020   Algorithms::   \n+00003680: 2020 2020 2020 456e 6372 7970 7469 6f6e        Encryption\n+00003690: 2073 6368 656d 6573 2073 7570 706f 7274   schemes support\n+000036a0: 6564 2062 7920 6c69 6266 6b6f 0a2a 2048  ed by libfko.* H\n+000036b0: 4d41 4320 4469 6765 7374 733a 3a20 2020  MAC Digests::   \n+000036c0: 2020 2020 2020 2020 2020 2020 2020 2044                 D\n+000036d0: 6967 6573 7473 2074 6861 7420 6361 6e20  igests that can \n+000036e0: 6265 2075 7365 6420 746f 2062 7569 6c64  be used to build\n+000036f0: 2061 6e20 484d 4143 0a0a 1f0a 4669 6c65   an HMAC....File\n+00003700: 3a20 6c69 6266 6b6f 2e69 6e66 6f2c 2020  : libfko.info,  \n+00003710: 4e6f 6465 3a20 4469 6765 7374 732c 2020  Node: Digests,  \n+00003720: 4e65 7874 3a20 5350 4120 4d65 7373 6167  Next: SPA Messag\n+00003730: 6573 2c20 2055 703a 2053 5041 2050 6172  es,  Up: SPA Par\n+00003740: 616d 6574 6572 2054 7970 6573 0a0a 322e  ameter Types..2.\n+00003750: 332e 3120 4469 6765 7374 730a 2d2d 2d2d  3.1 Digests.----\n+00003760: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 2066  ---------..The f\n+00003770: 776b 6e6f 7020 7379 7374 656d 2065 6d70  wknop system emp\n+00003780: 6c6f 7973 2061 206d 6573 7361 6765 2064  loys a message d\n+00003790: 6967 6573 7420 6861 7368 206f 6620 7468  igest hash of th\n+000037a0: 6520 5350 4120 6461 7461 2061 7320 6f6e  e SPA data as on\n+000037b0: 650a 6f66 2074 6865 2064 6174 6120 6669  e.of the data fi\n+000037c0: 656c 6473 2074 6f20 6163 7420 6120 7369  elds to act a si\n+000037d0: 676e 6174 7572 6520 7768 6963 6820 6361  gnature which ca\n+000037e0: 6e20 6265 2075 7365 6420 6174 2074 6865  n be used at the\n+000037f0: 2072 6563 6569 7669 6e67 0a65 6e64 2074   receiving.end t\n+00003800: 6f20 7665 7269 6679 2074 6865 2064 6174  o verify the dat\n+00003810: 6120 6973 2076 616c 6964 2028 616c 7468  a is valid (alth\n+00003820: 6f75 6768 2074 6869 7320 6665 6174 7572  ough this featur\n+00003830: 6520 6861 7320 6265 656e 0a73 7570 6572  e has been.super\n+00003840: 6365 6465 6420 6279 2074 6865 2075 7361  ceded by the usa\n+00003850: 6765 206f 6620 616e 2048 4d41 4320 666f  ge of an HMAC fo\n+00003860: 7220 7072 6f70 6572 206d 6573 7361 6765  r proper message\n+00003870: 2061 7574 6865 6e74 6963 6174 696f 6e20   authentication \n+00003880: 616e 640a 7665 7269 6669 6361 7469 6f6e  and.verification\n+00003890: 206f 6620 696e 7465 6772 6974 7929 2e20   of integrity). \n+000038a0: 2054 6865 2072 6573 756c 7469 6e67 2064   The resulting d\n+000038b0: 6967 6573 7420 6973 2062 6173 6536 342d  igest is base64-\n+000038c0: 656e 636f 6465 640a 6265 666f 7265 2069  encoded.before i\n+000038d0: 7420 6973 2061 6464 6564 2074 6f20 7468  t is added to th\n+000038e0: 6520 5350 4120 6461 7461 2e0a 0a20 2020  e SPA data...   \n+000038f0: 4375 7272 656e 746c 792c 206c 6962 666b  Currently, libfk\n+00003900: 6f20 7375 7070 6f72 7473 2074 6865 2073  o supports the s\n+00003910: 616d 6520 6d65 7373 6167 6520 6469 6765  ame message dige\n+00003920: 7374 7320 6173 2074 6865 206c 6567 6163  sts as the legac\n+00003930: 790a 6677 6b6e 6f70 2070 6c75 7320 7477  y.fwknop plus tw\n+00003940: 6f20 6f74 6865 7273 2028 5348 4133 3834  o others (SHA384\n+00003950: 2061 6e64 2053 4841 3531 3229 2e20 2054   and SHA512).  T\n+00003960: 6865 7365 2061 7265 2028 696e 206f 7264  hese are (in ord\n+00003970: 6572 206f 660a 7374 7265 6e67 7468 293a  er of.strength):\n+00003980: 0a0a 202d 2d20 5661 7269 6162 6c65 3a20  .. -- Variable: \n+00003990: 696e 7420 666b 6f5f 6469 6765 7374 5f74  int fko_digest_t\n+000039a0: 7970 655f 740a 2020 2020 2027 464b 4f5f  ype_t.     'FKO_\n+000039b0: 4449 4745 5354 5f4d 4435 270a 2020 2020  DIGEST_MD5'.    \n+000039c0: 2027 464b 4f5f 4449 4745 5354 5f53 4841   'FKO_DIGEST_SHA\n+000039d0: 3127 0a20 2020 2020 2746 4b4f 5f44 4947  1'.     'FKO_DIG\n+000039e0: 4553 545f 5348 4132 3536 2028 6c69 6266  EST_SHA256 (libf\n+000039f0: 6b6f 2064 6566 6175 6c74 2927 0a20 2020  ko default)'.   \n+00003a00: 2020 2746 4b4f 5f44 4947 4553 545f 5348    'FKO_DIGEST_SH\n+00003a10: 4133 3834 270a 2020 2020 2027 464b 4f5f  A384'.     'FKO_\n+00003a20: 4449 4745 5354 5f53 4841 3531 3227 0a0a  DIGEST_SHA512'..\n+00003a30: 2020 2041 7320 696e 6469 6361 7465 6420     As indicated \n+00003a40: 696e 2074 6865 206c 6973 7420 6162 6f76  in the list abov\n+00003a50: 652c 2053 4841 3235 3620 6973 2074 6865  e, SHA256 is the\n+00003a60: 2064 6566 6175 6c74 2e20 2054 6869 7320   default.  This \n+00003a70: 6d65 616e 730a 7468 6520 6469 6765 7374  means.the digest\n+00003a80: 2074 7970 6520 646f 6573 206e 6f74 206e   type does not n\n+00003a90: 6565 6420 746f 2062 6520 6578 706c 6963  eed to be explic\n+00003aa0: 6974 6c79 2073 6574 2075 6e6c 6573 7320  itly set unless \n+00003ab0: 796f 7520 7769 7368 2074 6f0a 7573 6520  you wish to.use \n+00003ac0: 6f6e 6520 6f66 2074 6865 206f 7468 6572  one of the other\n+00003ad0: 2076 616c 7565 732e 2020 5468 6973 2061   values.  This a\n+00003ae0: 7070 6c69 6573 2074 6f20 616c 6c20 6c69  pplies to all li\n+00003af0: 6266 6b6f 2053 5041 2064 6174 6120 6669  bfko SPA data fi\n+00003b00: 656c 6473 0a74 6861 7420 6861 7665 2061  elds.that have a\n+00003b10: 2064 6566 6175 6c74 2076 616c 7565 2e0a   default value..\n+00003b20: 0a1f 0a46 696c 653a 206c 6962 666b 6f2e  ...File: libfko.\n+00003b30: 696e 666f 2c20 204e 6f64 653a 2053 5041  info,  Node: SPA\n+00003b40: 204d 6573 7361 6765 732c 2020 4e65 7874   Messages,  Next\n+00003b50: 3a20 456e 6372 7970 7469 6f6e 2041 6c67  : Encryption Alg\n+00003b60: 6f72 6974 686d 732c 2020 5072 6576 3a20  orithms,  Prev: \n+00003b70: 4469 6765 7374 732c 2020 5570 3a20 5350  Digests,  Up: SP\n+00003b80: 4120 5061 7261 6d65 7465 7220 5479 7065  A Parameter Type\n+00003b90: 730a 0a32 2e33 2e32 2053 5041 204d 6573  s..2.3.2 SPA Mes\n+00003ba0: 7361 6765 730a 2d2d 2d2d 2d2d 2d2d 2d2d  sages.----------\n+00003bb0: 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520 6677  --------..The fw\n+00003bc0: 6b6e 6f70 2073 7973 7465 6d20 2861 6e64  knop system (and\n+00003bd0: 2073 7562 7365 7175 656e 746c 7920 6c69   subsequently li\n+00003be0: 6266 6b6f 292c 2073 7570 706f 7274 2061  bfko), support a\n+00003bf0: 2073 7065 6369 6669 6320 7365 7420 6f66   specific set of\n+00003c00: 0a6d 6573 7361 6765 2074 7970 6573 2e20  .message types. \n+00003c10: 2054 6865 206d 6573 7361 6765 2074 7970   The message typ\n+00003c20: 6520 7661 6c75 6520 6973 2075 7365 6420  e value is used \n+00003c30: 6279 2066 776b 6e6f 7020 746f 2068 656c  by fwknop to hel\n+00003c40: 700a 6465 7465 726d 696e 6520 7468 6520  p.determine the \n+00003c50: 636f 7272 6563 7420 6d65 7373 6167 6520  correct message \n+00003c60: 666f 726d 6174 2061 6e64 2063 6f6e 7465  format and conte\n+00003c70: 6e74 2e20 2054 6865 7365 206d 6573 7361  nt.  These messa\n+00003c80: 6765 2074 7970 6573 0a61 7265 3a0a 0a20  ge types.are:.. \n+00003c90: 2d2d 2056 6172 6961 626c 653a 2069 6e74  -- Variable: int\n+00003ca0: 2066 6b6f 5f6d 6573 7361 6765 5f74 7970   fko_message_typ\n+00003cb0: 655f 740a 2020 2020 2027 464b 4f5f 434f  e_t.     'FKO_CO\n+00003cc0: 4d4d 414e 445f 4d53 4727 0a20 2020 2020  MMAND_MSG'.     \n+00003cd0: 2020 2020 2041 2072 6571 7565 7374 2074       A request t\n+00003ce0: 6f20 6861 7665 2074 6865 2066 776b 6e6f  o have the fwkno\n+00003cf0: 7020 7365 7276 6572 2065 7865 6375 7465  p server execute\n+00003d00: 2074 6865 2067 6976 656e 2063 6f6d 6d61   the given comma\n+00003d10: 6e64 2e0a 2020 2020 2020 2020 2020 5468  nd..          Th\n+00003d20: 6520 666f 726d 6174 2066 6f72 2074 6869  e format for thi\n+00003d30: 7320 7479 7065 2069 733a 2027 3c69 7020  s type is: '<ip \n+00003d40: 6f66 2072 6571 7565 7374 6f72 3e2c 3c63  of requestor>,<c\n+00003d50: 6f6d 6d61 6e64 0a20 2020 2020 2020 2020  ommand.         \n+00003d60: 2074 6578 743e 272e 0a20 2020 2020 2020   text>'..       \n+00003d70: 2020 2020 2020 2020 2231 3932 2e31 3638          \"192.168\n+00003d80: 2e31 2e32 2c75 6e61 6d65 202d 6122 0a0a  .1.2,uname -a\"..\n+00003d90: 2020 2020 2027 464b 4f5f 4143 4345 5353       'FKO_ACCESS\n+00003da0: 5f4d 5347 270a 2020 2020 2020 2020 2020  _MSG'.          \n+00003db0: 4120 6261 7369 6320 6163 6365 7373 2072  A basic access r\n+00003dc0: 6571 7565 7374 2e20 2054 6869 7320 6973  equest.  This is\n+00003dd0: 2074 6865 206d 6f73 7420 636f 6d6d 6f6e   the most common\n+00003de0: 2074 7970 6520 696e 2075 7365 2e0a 2020   type in use..  \n+00003df0: 2020 2020 2020 2020 5468 6520 666f 726d          The form\n+00003e00: 6174 2066 6f72 2074 6869 7320 7479 7065  at for this type\n+00003e10: 2069 733a 2027 3c69 7020 6f66 0a20 2020   is: '<ip of.   \n+00003e20: 2020 2020 2020 2072 6571 7565 7374 6f72         requestor\n+00003e30: 3e2c 3c70 726f 746f 636f 6c3e 2f3c 706f  >,<protocol>/<po\n+00003e40: 7274 3e27 2e20 204e 6f74 6520 7468 6174  rt>'.  Note that\n+00003e50: 206d 756c 7469 706c 650a 2020 2020 2020   multiple.      \n+00003e60: 2020 2020 7072 6f74 6f63 6f6c 2f70 6f72      protocol/por\n+00003e70: 7420 656e 7472 6965 7320 6172 6520 616c  t entries are al\n+00003e80: 6c6f 7765 642e 0a20 2020 2020 2020 2020  lowed..         \n+00003e90: 2020 2020 2020 2231 3932 2e31 3638 2e31        \"192.168.1\n+00003ea0: 2e32 2c74 6370 2f32 3222 0a20 2020 2020  .2,tcp/22\".     \n+00003eb0: 2020 2020 2020 2020 2020 2231 3932 2e31            \"192.1\n+00003ec0: 3638 2e31 2e32 2c74 6370 2f32 322c 7564  68.1.2,tcp/22,ud\n+00003ed0: 702f 3530 3035 220a 0a20 2020 2020 2746  p/5005\"..     'F\n+00003ee0: 4b4f 5f4e 4154 5f41 4343 4553 535f 4d53  KO_NAT_ACCESS_MS\n+00003ef0: 4727 0a20 2020 2020 2020 2020 2041 6e20  G'.          An \n+00003f00: 6163 6365 7373 2072 6571 7565 7374 2074  access request t\n+00003f10: 6861 7420 616c 736f 2070 726f 7669 6465  hat also provide\n+00003f20: 2069 6e66 6f72 6d61 7469 6f6e 2066 6f72   information for\n+00003f30: 2074 6865 2066 776b 6e6f 700a 2020 2020   the fwknop.    \n+00003f40: 2020 2020 2020 7365 7276 6572 2074 6f20        server to \n+00003f50: 6372 6561 7465 2061 204e 6574 776f 726b  create a Network\n+00003f60: 2041 6464 7265 7373 2054 7261 6e73 6c61   Address Transla\n+00003f70: 7469 6f6e 2028 4e41 5420 746f 2061 6e0a  tion (NAT to an.\n+00003f80: 2020 2020 2020 2020 2020 696e 7465 726e            intern\n+00003f90: 616c 2061 6464 7265 7373 2e20 2054 6865  al address.  The\n+00003fa0: 2066 6f72 6d61 7420 666f 7220 7468 6973   format for this\n+00003fb0: 2073 7472 696e 6720 6973 3a20 273c 696e   string is: '<in\n+00003fc0: 7465 726e 616c 0a20 2020 2020 2020 2020  ternal.         \n+00003fd0: 2069 703e 2c3c 6578 7420 6e61 7420 706f   ip>,<ext nat po\n+00003fe0: 7274 3e27 2e0a 2020 2020 2020 2020 2020  rt>'..          \n+00003ff0: 2020 2020 2022 3130 2e31 302e 312e 322c       \"10.10.1.2,\n+00004000: 3939 3232 220a 0a20 2020 2020 2746 4b4f  9922\"..     'FKO\n+00004010: 5f43 4c49 454e 545f 5449 4d45 4f55 545f  _CLIENT_TIMEOUT_\n+00004020: 4143 4345 5353 5f4d 5347 270a 2020 2020  ACCESS_MSG'.    \n+00004030: 2020 2020 2020 5468 6973 2069 7320 616e        This is an\n+00004040: 2046 4b4f 5f41 4343 4553 535f 5245 5155   FKO_ACCESS_REQU\n+00004050: 4553 5420 7769 7468 2061 2074 696d 656f  EST with a timeo\n+00004060: 7574 2070 6172 616d 6574 6572 2066 6f72  ut parameter for\n+00004070: 2074 6865 0a20 2020 2020 2020 2020 2066   the.          f\n+00004080: 776b 6e6f 7020 7365 7276 6572 2e20 2054  wknop server.  T\n+00004090: 6865 2074 696d 656f 7574 2076 616c 7565  he timeout value\n+000040a0: 2069 7320 7072 6f76 6964 6564 2076 6961   is provided via\n+000040b0: 2074 6865 0a20 2020 2020 2020 2020 2027   the.          '\n+000040c0: 636c 6965 6e74 5f74 696d 656f 7574 2720  client_timeout' \n+000040d0: 6461 7461 2066 6965 6c64 2e0a 0a20 2020  data field...   \n+000040e0: 2020 2746 4b4f 5f43 4c49 454e 545f 5449    'FKO_CLIENT_TI\n+000040f0: 4d45 4f55 545f 4e41 545f 4143 4345 5353  MEOUT_NAT_ACCESS\n+00004100: 5f4d 5347 270a 2020 2020 2020 2020 2020  _MSG'.          \n+00004110: 5468 6973 2069 7320 616e 2046 4b4f 5f4e  This is an FKO_N\n+00004120: 4154 5f41 4343 4553 535f 5245 5155 4553  AT_ACCESS_REQUES\n+00004130: 5420 7769 7468 2061 2074 696d 656f 7574  T with a timeout\n+00004140: 2070 6172 616d 6574 6572 2066 6f72 0a20   parameter for. \n+00004150: 2020 2020 2020 2020 2074 6865 2066 776b           the fwk\n+00004160: 6e6f 7020 7365 7276 6572 2e20 2054 6865  nop server.  The\n+00004170: 2074 696d 656f 7574 2076 616c 7565 2069   timeout value i\n+00004180: 7320 7072 6f76 6964 6564 2076 6961 2074  s provided via t\n+00004190: 6865 0a20 2020 2020 2020 2020 2027 636c  he.          'cl\n+000041a0: 6965 6e74 5f74 696d 656f 7574 2720 6461  ient_timeout' da\n+000041b0: 7461 2066 6965 6c64 2e0a 0a20 2020 2020  ta field...     \n+000041c0: 2746 4b4f 5f4c 4f43 414c 5f4e 4154 5f41  'FKO_LOCAL_NAT_A\n+000041d0: 4343 4553 535f 4d53 4727 0a20 2020 2020  CCESS_MSG'.     \n+000041e0: 2020 2020 2054 6869 7320 6973 2073 696d       This is sim\n+000041f0: 696c 6172 2074 6f20 7468 6520 464b 4f5f  ilar to the FKO_\n+00004200: 4e41 545f 4143 4345 5353 2072 6571 7565  NAT_ACCESS reque\n+00004210: 7374 2065 7863 6570 7420 7468 6520 4e41  st except the NA\n+00004220: 540a 2020 2020 2020 2020 2020 6973 2074  T.          is t\n+00004230: 6f20 7468 6520 6c6f 6361 6c20 746f 2074  o the local to t\n+00004240: 6865 2073 6572 7665 7220 2869 2e65 2e20  he server (i.e. \n+00004250: 2061 2073 6572 7669 6365 206c 6973 7465   a service liste\n+00004260: 6e69 6e67 206f 6e0a 2020 2020 2020 2020  ning on.        \n+00004270: 2020 3132 372e 302e 302e 3129 2e0a 0a20    127.0.0.1)... \n+00004280: 2020 2020 2746 4b4f 5f43 4c49 454e 545f      'FKO_CLIENT_\n+00004290: 5449 4d45 4f55 545f 4c4f 4341 4c5f 4e41  TIMEOUT_LOCAL_NA\n+000042a0: 545f 4143 4345 5353 5f4d 5347 270a 2020  T_ACCESS_MSG'.  \n+000042b0: 2020 2020 2020 2020 5468 6973 2069 7320          This is \n+000042c0: 616e 2046 4b4f 5f4c 4f43 414c 5f4e 4154  an FKO_LOCAL_NAT\n+000042d0: 5f41 4343 4553 535f 5245 5155 4553 5420  _ACCESS_REQUEST \n+000042e0: 7769 7468 2061 2074 696d 656f 7574 0a20  with a timeout. \n+000042f0: 2020 2020 2020 2020 2070 6172 616d 6574           paramet\n+00004300: 6572 2066 6f72 2074 6865 2066 776b 6e6f  er for the fwkno\n+00004310: 7020 7365 7276 6572 2e20 2054 6865 2074  p server.  The t\n+00004320: 696d 656f 7574 2076 616c 7565 2069 730a  imeout value is.\n+00004330: 2020 2020 2020 2020 2020 7072 6f76 6964            provid\n+00004340: 6564 2076 6961 2074 6865 2027 636c 6965  ed via the 'clie\n+00004350: 6e74 5f74 696d 656f 7574 2720 6461 7461  nt_timeout' data\n+00004360: 2066 6965 6c64 2e0a 0a1f 0a46 696c 653a   field.....File:\n+00004370: 206c 6962 666b 6f2e 696e 666f 2c20 204e   libfko.info,  N\n+00004380: 6f64 653a 2045 6e63 7279 7074 696f 6e20  ode: Encryption \n+00004390: 416c 676f 7269 7468 6d73 2c20 204e 6578  Algorithms,  Nex\n+000043a0: 743a 2048 4d41 4320 4469 6765 7374 732c  t: HMAC Digests,\n+000043b0: 2020 5072 6576 3a20 5350 4120 4d65 7373    Prev: SPA Mess\n+000043c0: 6167 6573 2c20 2055 703a 2053 5041 2050  ages,  Up: SPA P\n+000043d0: 6172 616d 6574 6572 2054 7970 6573 0a0a  arameter Types..\n+000043e0: 322e 332e 3320 456e 6372 7970 7469 6f6e  2.3.3 Encryption\n+000043f0: 2041 6c67 6f72 6974 686d 730a 2d2d 2d2d   Algorithms.----\n 00004400: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------\n-00004410: 2d2d 2d2d 2d2d 2d2d 2d0a 0a4f 6e65 206f  ---------..One o\n-00004420: 6620 7468 6520 6669 6e61 6c20 7374 6570  f the final step\n-00004430: 7320 2862 6566 6f72 6520 7468 6520 484d  s (before the HM\n-00004440: 4143 2069 7320 6361 6c63 756c 6174 6564  AC is calculated\n-00004450: 2061 6e64 2061 7070 6c69 6564 2920 696e   and applied) in\n-00004460: 0a63 7265 6174 696e 6720 616e 2066 776b  .creating an fwk\n-00004470: 6e6f 7020 5350 4120 6d65 7373 6167 6520  nop SPA message \n-00004480: 6973 2065 6e63 7279 7074 696e 6720 7468  is encrypting th\n-00004490: 6520 656e 7469 7265 206d 6573 7361 6765  e entire message\n-000044a0: 2e0a 4375 7272 656e 746c 792c 2066 776b  ..Currently, fwk\n-000044b0: 6e6f 7020 7375 7070 6f72 7473 2074 776f  nop supports two\n-000044c0: 206d 6574 686f 6473 206f 6620 656e 6372   methods of encr\n-000044d0: 7970 7469 6f6e 3a0a 0a20 2d2d 2056 6172  yption:.. -- Var\n-000044e0: 6961 626c 653a 2069 6e74 2066 6b6f 5f65  iable: int fko_e\n-000044f0: 6e63 7279 7074 696f 6e5f 7479 7065 5f74  ncryption_type_t\n-00004500: 0a20 2020 2020 2746 4b4f 5f45 4e43 5259  .     'FKO_ENCRY\n-00004510: 5054 494f 4e5f 5249 4a4e 4441 454c 2028  PTION_RIJNDAEL (\n-00004520: 6465 6661 756c 7429 270a 2020 2020 2027  default)'.     '\n-00004530: 464b 4f5f 454e 4352 5950 5449 4f4e 5f47  FKO_ENCRYPTION_G\n-00004540: 5047 270a 0a20 2020 4173 2069 6e64 6963  PG'..   As indic\n-00004550: 6174 6564 2c20 6c69 6266 6b6f 2075 7365  ated, libfko use\n-00004560: 7320 5269 6a6e 6461 656c 2065 6e63 7279  s Rijndael encry\n-00004570: 7074 696f 6e20 6279 2064 6566 6175 6c74  ption by default\n-00004580: 2e20 2052 696a 6e64 6165 6c0a 656e 6372  .  Rijndael.encr\n-00004590: 7970 7469 6f6e 2069 7320 7375 6666 6963  yption is suffic\n-000045a0: 6965 6e74 2066 6f72 206d 6f73 7420 7573  ient for most us\n-000045b0: 6572 7320 616e 6420 7072 6f64 7563 6573  ers and produces\n-000045c0: 2061 206d 7563 6820 736d 616c 6c65 7220   a much smaller \n-000045d0: 6461 7461 0a70 6163 6b65 7420 7468 616e  data.packet than\n-000045e0: 2047 5047 2028 6265 7477 6565 6e20 3134   GPG (between 14\n-000045f0: 3020 6279 7465 7320 7769 7468 204d 4435  0 bytes with MD5\n-00004600: 2064 6967 6573 7420 746f 2061 726f 756e   digest to aroun\n-00004610: 6420 3232 3520 6279 7465 730a 6f72 2073  d 225 bytes.or s\n-00004620: 6f20 7769 7468 2053 4841 3531 322c 2063  o with SHA512, c\n-00004630: 6f6d 7061 7265 6420 746f 2061 726f 756e  ompared to aroun\n-00004640: 6420 3131 3030 2066 6f72 2073 6967 6e65  d 1100 for signe\n-00004650: 6420 4750 4729 2e20 2057 6865 6e0a 5269  d GPG).  When.Ri\n-00004660: 6a6e 6461 656c 2069 7320 7573 6564 2c20  jndael is used, \n-00004670: 7468 6520 656e 6372 7970 7469 6f6e 206b  the encryption k\n-00004680: 6579 2069 7473 656c 6620 6973 2064 6572  ey itself is der\n-00004690: 6976 6564 2066 726f 6d20 7468 6520 7375  ived from the su\n-000046a0: 7070 6c69 6564 0a70 6173 7370 6872 6173  pplied.passphras\n-000046b0: 6520 7669 6120 7468 6520 5042 4b44 4631  e via the PBKDF1\n-000046c0: 2061 6c67 6f72 6974 686d 2c20 616e 6420   algorithm, and \n-000046d0: 4342 4320 6d6f 6465 2069 7320 7365 742e  CBC mode is set.\n-000046e0: 0a0a 2020 2048 6f77 6576 6572 2c20 736f  ..   However, so\n-000046f0: 6d65 206d 6179 2070 7265 6665 7220 7468  me may prefer th\n-00004700: 6520 6869 6768 6572 206c 6576 656c 206f  e higher level o\n-00004710: 6620 7365 6375 7269 7479 2070 726f 7669  f security provi\n-00004720: 6465 6420 6279 0a47 5047 2e20 2057 6865  ded by.GPG.  Whe\n-00004730: 6e20 7365 6c65 6374 6564 2c20 6164 6469  n selected, addi\n-00004740: 7469 6f6e 616c 2070 6172 616d 6574 6572  tional parameter\n-00004750: 7320 7375 6368 2061 7320 5f72 6563 6970  s such as _recip\n-00004760: 6965 6e74 5f20 616e 640a 5f73 6967 6e65  ient_ and._signe\n-00004770: 725f 206d 6179 2062 6520 7365 7420 6173  r_ may be set as\n-00004780: 2077 656c 6c2e 2020 5365 6520 2a6e 6f74   well.  See *not\n-00004790: 6520 5365 7474 696e 6720 5350 4120 4461  e Setting SPA Da\n-000047a0: 7461 3a3a 2066 6f72 2064 6574 6169 6c20  ta:: for detail \n-000047b0: 6f6e 0a73 6574 7469 6e67 2074 6865 7365  on.setting these\n-000047c0: 2061 6e64 206f 7468 6572 2053 5041 2064   and other SPA d\n-000047d0: 6174 6120 6669 656c 6473 2e0a 0a1f 0a46  ata fields.....F\n-000047e0: 696c 653a 206c 6962 666b 6f2e 696e 666f  ile: libfko.info\n-000047f0: 2c20 204e 6f64 653a 2048 4d41 4320 4469  ,  Node: HMAC Di\n-00004800: 6765 7374 732c 2020 5072 6576 3a20 456e  gests,  Prev: En\n-00004810: 6372 7970 7469 6f6e 2041 6c67 6f72 6974  cryption Algorit\n-00004820: 686d 732c 2020 5570 3a20 5350 4120 5061  hms,  Up: SPA Pa\n-00004830: 7261 6d65 7465 7220 5479 7065 730a 0a32  rameter Types..2\n-00004840: 2e33 2e34 2048 4d41 4320 4469 6765 7374  .3.4 HMAC Digest\n-00004850: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  s.--------------\n-00004860: 2d2d 2d2d 0a0a 5468 6520 6677 6b6e 6f70  ----..The fwknop\n-00004870: 2070 726f 6a65 6374 2065 6d70 6c6f 7973   project employs\n-00004880: 2061 6e20 484d 4143 2069 6e20 7468 6520   an HMAC in the \n-00004890: 656e 6372 7970 742d 7468 656e 2d61 7574  encrypt-then-aut\n-000048a0: 6865 6e74 6963 6174 650a 6d6f 6465 6c20  henticate.model \n-000048b0: 666f 7220 7374 726f 6e67 2053 5041 206d  for strong SPA m\n-000048c0: 6573 7361 6765 2061 7574 6865 6e74 6963  essage authentic\n-000048d0: 6174 696f 6e2e 2020 5468 6520 484d 4143  ation.  The HMAC\n-000048e0: 2069 7473 656c 6620 6973 2064 6572 6976   itself is deriv\n-000048f0: 6564 0a66 726f 6d20 6120 6469 6765 7374  ed.from a digest\n-00004900: 206f 6620 7468 6520 656e 6372 7970 7465   of the encrypte\n-00004910: 6420 5350 4120 6d65 7373 6167 6520 616c  d SPA message al\n-00004920: 6f6e 6720 7769 7468 2061 2064 6564 6963  ong with a dedic\n-00004930: 6174 6564 2048 4d41 430a 6b65 792e 0a0a  ated HMAC.key...\n-00004940: 2020 2043 7572 7265 6e74 6c79 2c20 6c69     Currently, li\n-00004950: 6266 6b6f 2073 7570 706f 7274 7320 7468  bfko supports th\n-00004960: 6520 7361 6d65 206d 6573 7361 6765 2064  e same message d\n-00004970: 6967 6573 7473 2061 7320 6d65 6e74 696f  igests as mentio\n-00004980: 6e65 6420 696e 0a74 6865 2044 6967 6573  ned in.the Diges\n-00004990: 7420 7365 6374 696f 6e20 6162 6f76 652c  t section above,\n-000049a0: 2061 6e64 2074 6865 7365 2061 7265 2028   and these are (\n-000049b0: 696e 206f 7264 6572 206f 6620 7374 7265  in order of stre\n-000049c0: 6e67 7468 293a 0a0a 202d 2d20 5661 7269  ngth):.. -- Vari\n-000049d0: 6162 6c65 3a20 696e 7420 666b 6f5f 6469  able: int fko_di\n-000049e0: 6765 7374 5f74 7970 655f 740a 2020 2020  gest_type_t.    \n-000049f0: 2027 464b 4f5f 484d 4143 5f4d 4435 270a   'FKO_HMAC_MD5'.\n-00004a00: 2020 2020 2027 464b 4f5f 484d 4143 5f53       'FKO_HMAC_S\n-00004a10: 4841 3127 0a20 2020 2020 2746 4b4f 5f48  HA1'.     'FKO_H\n-00004a20: 4d41 435f 5348 4132 3536 2028 6c69 6266  MAC_SHA256 (libf\n-00004a30: 6b6f 2064 6566 6175 6c74 2927 0a20 2020  ko default)'.   \n-00004a40: 2020 2746 4b4f 5f48 4d41 435f 5348 4133    'FKO_HMAC_SHA3\n-00004a50: 3834 270a 2020 2020 2027 464b 4f5f 484d  84'.     'FKO_HM\n-00004a60: 4143 5f53 4841 3531 3227 0a0a 2020 2041  AC_SHA512'..   A\n-00004a70: 7320 696e 6469 6361 7465 6420 696e 2074  s indicated in t\n-00004a80: 6865 206c 6973 7420 6162 6f76 652c 2053  he list above, S\n-00004a90: 4841 3235 3620 6973 2074 6865 2064 6566  HA256 is the def\n-00004aa0: 6175 6c74 2e20 2054 6869 7320 6d65 616e  ault.  This mean\n-00004ab0: 730a 7468 6520 484d 4143 2064 6967 6573  s.the HMAC diges\n-00004ac0: 7420 7479 7065 2064 6f65 7320 6e6f 7420  t type does not \n-00004ad0: 6e65 6564 2074 6f20 6265 2065 7870 6c69  need to be expli\n-00004ae0: 6369 746c 7920 7365 7420 756e 6c65 7373  citly set unless\n-00004af0: 2079 6f75 2077 6973 680a 746f 2075 7365   you wish.to use\n-00004b00: 206f 6e65 206f 6620 7468 6520 6f74 6865   one of the othe\n-00004b10: 7220 7661 6c75 6573 2e20 2054 6869 7320  r values.  This \n-00004b20: 6170 706c 6965 7320 746f 2061 6c6c 206c  applies to all l\n-00004b30: 6962 666b 6f20 5350 4120 6461 7461 0a66  ibfko SPA data.f\n-00004b40: 6965 6c64 7320 7468 6174 2068 6176 6520  ields that have \n-00004b50: 6120 6465 6661 756c 7420 7661 6c75 652e  a default value.\n-00004b60: 0a0a 1f0a 4669 6c65 3a20 6c69 6266 6b6f  ....File: libfko\n-00004b70: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5573  .info,  Node: Us\n-00004b80: 696e 6720 6c69 6266 6b6f 2c20 204e 6578  ing libfko,  Nex\n-00004b90: 743a 204c 6962 7261 7279 2043 6f70 7969  t: Library Copyi\n-00004ba0: 6e67 2c20 2050 7265 763a 2050 7265 7061  ng,  Prev: Prepa\n-00004bb0: 7261 7469 6f6e 2c20 2055 703a 2054 6f70  ration,  Up: Top\n-00004bc0: 0a0a 3320 5573 696e 6720 6c69 6266 6b6f  ..3 Using libfko\n-00004bd0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a  .**************.\n-00004be0: 0a54 6869 7320 6368 6170 7465 7220 7072  .This chapter pr\n-00004bf0: 6f76 6964 6573 2074 6865 2022 686f 7774  ovides the \"howt\n-00004c00: 6f22 2066 6f72 2075 7369 6e67 206c 6962  o\" for using lib\n-00004c10: 666b 6f2c 2069 6e63 6c75 6469 6e67 2072  fko, including r\n-00004c20: 6571 7569 7265 640a 6675 6e63 7469 6f6e  equired.function\n-00004c30: 7320 616e 6420 7061 7261 6d65 7465 7220  s and parameter \n-00004c40: 6368 6f69 6365 732e 2020 496e 2073 6f6d  choices.  In som\n-00004c50: 6520 7365 6374 696f 6e73 2c20 636f 6465  e sections, code\n-00004c60: 2073 616d 706c 6573 2061 7265 0a70 726f   samples are.pro\n-00004c70: 7669 6465 6420 746f 2066 7572 7468 6572  vided to further\n-00004c80: 2069 6c6c 7573 7472 6174 6520 7573 6167   illustrate usag\n-00004c90: 652e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2043  e...* Menu:..* C\n-00004ca0: 7265 6174 696e 6720 436f 6e74 6578 7473  reating Contexts\n-00004cb0: 3a3a 2020 2020 2020 2020 2020 2020 2043  ::             C\n-00004cc0: 7265 6174 696e 6720 6120 6e65 7720 666b  reating a new fk\n-00004cd0: 6f20 636f 6e74 6578 740a 2a20 4465 7374  o context.* Dest\n-00004ce0: 726f 7969 6e67 2043 6f6e 7465 7874 733a  roying Contexts:\n-00004cf0: 3a20 2020 2020 2020 2020 2020 5265 6c65  :           Rele\n-00004d00: 6173 696e 6720 616e 2066 6b6f 2063 6f6e  asing an fko con\n-00004d10: 7465 7874 0a2a 2043 7265 6174 696e 6720  text.* Creating \n-00004d20: 6120 5350 4120 4d65 7373 6167 653a 3a20  a SPA Message:: \n-00004d30: 2020 2020 2020 2057 6861 7420 6974 2074         What it t\n-00004d40: 616b 6573 2074 6f20 6372 6561 7465 2061  akes to create a\n-00004d50: 2053 5041 0a20 2020 2020 2020 2020 2020   SPA.           \n+00004410: 2d2d 2d2d 2d2d 2d0a 0a4f 6e65 206f 6620  -------..One of \n+00004420: 7468 6520 6669 6e61 6c20 7374 6570 7320  the final steps \n+00004430: 2862 6566 6f72 6520 7468 6520 484d 4143  (before the HMAC\n+00004440: 2069 7320 6361 6c63 756c 6174 6564 2061   is calculated a\n+00004450: 6e64 2061 7070 6c69 6564 2920 696e 0a63  nd applied) in.c\n+00004460: 7265 6174 696e 6720 616e 2066 776b 6e6f  reating an fwkno\n+00004470: 7020 5350 4120 6d65 7373 6167 6520 6973  p SPA message is\n+00004480: 2065 6e63 7279 7074 696e 6720 7468 6520   encrypting the \n+00004490: 656e 7469 7265 206d 6573 7361 6765 2e0a  entire message..\n+000044a0: 4375 7272 656e 746c 792c 2066 776b 6e6f  Currently, fwkno\n+000044b0: 7020 7375 7070 6f72 7473 2074 776f 206d  p supports two m\n+000044c0: 6574 686f 6473 206f 6620 656e 6372 7970  ethods of encryp\n+000044d0: 7469 6f6e 3a0a 0a20 2d2d 2056 6172 6961  tion:.. -- Varia\n+000044e0: 626c 653a 2069 6e74 2066 6b6f 5f65 6e63  ble: int fko_enc\n+000044f0: 7279 7074 696f 6e5f 7479 7065 5f74 0a20  ryption_type_t. \n+00004500: 2020 2020 2746 4b4f 5f45 4e43 5259 5054      'FKO_ENCRYPT\n+00004510: 494f 4e5f 5249 4a4e 4441 454c 2028 6465  ION_RIJNDAEL (de\n+00004520: 6661 756c 7429 270a 2020 2020 2027 464b  fault)'.     'FK\n+00004530: 4f5f 454e 4352 5950 5449 4f4e 5f47 5047  O_ENCRYPTION_GPG\n+00004540: 270a 0a20 2020 4173 2069 6e64 6963 6174  '..   As indicat\n+00004550: 6564 2c20 6c69 6266 6b6f 2075 7365 7320  ed, libfko uses \n+00004560: 5269 6a6e 6461 656c 2065 6e63 7279 7074  Rijndael encrypt\n+00004570: 696f 6e20 6279 2064 6566 6175 6c74 2e20  ion by default. \n+00004580: 2052 696a 6e64 6165 6c0a 656e 6372 7970   Rijndael.encryp\n+00004590: 7469 6f6e 2069 7320 7375 6666 6963 6965  tion is sufficie\n+000045a0: 6e74 2066 6f72 206d 6f73 7420 7573 6572  nt for most user\n+000045b0: 7320 616e 6420 7072 6f64 7563 6573 2061  s and produces a\n+000045c0: 206d 7563 6820 736d 616c 6c65 7220 6461   much smaller da\n+000045d0: 7461 0a70 6163 6b65 7420 7468 616e 2047  ta.packet than G\n+000045e0: 5047 2028 6265 7477 6565 6e20 3134 3020  PG (between 140 \n+000045f0: 6279 7465 7320 7769 7468 204d 4435 2064  bytes with MD5 d\n+00004600: 6967 6573 7420 746f 2061 726f 756e 6420  igest to around \n+00004610: 3232 3520 6279 7465 730a 6f72 2073 6f20  225 bytes.or so \n+00004620: 7769 7468 2053 4841 3531 322c 2063 6f6d  with SHA512, com\n+00004630: 7061 7265 6420 746f 2061 726f 756e 6420  pared to around \n+00004640: 3131 3030 2066 6f72 2073 6967 6e65 6420  1100 for signed \n+00004650: 4750 4729 2e20 2057 6865 6e0a 5269 6a6e  GPG).  When.Rijn\n+00004660: 6461 656c 2069 7320 7573 6564 2c20 7468  dael is used, th\n+00004670: 6520 656e 6372 7970 7469 6f6e 206b 6579  e encryption key\n+00004680: 2069 7473 656c 6620 6973 2064 6572 6976   itself is deriv\n+00004690: 6564 2066 726f 6d20 7468 6520 7375 7070  ed from the supp\n+000046a0: 6c69 6564 0a70 6173 7370 6872 6173 6520  lied.passphrase \n+000046b0: 7669 6120 7468 6520 5042 4b44 4631 2061  via the PBKDF1 a\n+000046c0: 6c67 6f72 6974 686d 2c20 616e 6420 4342  lgorithm, and CB\n+000046d0: 4320 6d6f 6465 2069 7320 7365 742e 0a0a  C mode is set...\n+000046e0: 2020 2048 6f77 6576 6572 2c20 736f 6d65     However, some\n+000046f0: 206d 6179 2070 7265 6665 7220 7468 6520   may prefer the \n+00004700: 6869 6768 6572 206c 6576 656c 206f 6620  higher level of \n+00004710: 7365 6375 7269 7479 2070 726f 7669 6465  security provide\n+00004720: 6420 6279 0a47 5047 2e20 2057 6865 6e20  d by.GPG.  When \n+00004730: 7365 6c65 6374 6564 2c20 6164 6469 7469  selected, additi\n+00004740: 6f6e 616c 2070 6172 616d 6574 6572 7320  onal parameters \n+00004750: 7375 6368 2061 7320 5f72 6563 6970 6965  such as _recipie\n+00004760: 6e74 5f20 616e 640a 5f73 6967 6e65 725f  nt_ and._signer_\n+00004770: 206d 6179 2062 6520 7365 7420 6173 2077   may be set as w\n+00004780: 656c 6c2e 2020 5365 6520 2a6e 6f74 6520  ell.  See *note \n+00004790: 5365 7474 696e 6720 5350 4120 4461 7461  Setting SPA Data\n+000047a0: 3a3a 2066 6f72 2064 6574 6169 6c20 6f6e  :: for detail on\n+000047b0: 0a73 6574 7469 6e67 2074 6865 7365 2061  .setting these a\n+000047c0: 6e64 206f 7468 6572 2053 5041 2064 6174  nd other SPA dat\n+000047d0: 6120 6669 656c 6473 2e0a 0a1f 0a46 696c  a fields.....Fil\n+000047e0: 653a 206c 6962 666b 6f2e 696e 666f 2c20  e: libfko.info, \n+000047f0: 204e 6f64 653a 2048 4d41 4320 4469 6765   Node: HMAC Dige\n+00004800: 7374 732c 2020 5072 6576 3a20 456e 6372  sts,  Prev: Encr\n+00004810: 7970 7469 6f6e 2041 6c67 6f72 6974 686d  yption Algorithm\n+00004820: 732c 2020 5570 3a20 5350 4120 5061 7261  s,  Up: SPA Para\n+00004830: 6d65 7465 7220 5479 7065 730a 0a32 2e33  meter Types..2.3\n+00004840: 2e34 2048 4d41 4320 4469 6765 7374 730a  .4 HMAC Digests.\n+00004850: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------\n+00004860: 2d2d 0a0a 5468 6520 6677 6b6e 6f70 2070  --..The fwknop p\n+00004870: 726f 6a65 6374 2065 6d70 6c6f 7973 2061  roject employs a\n+00004880: 6e20 484d 4143 2069 6e20 7468 6520 656e  n HMAC in the en\n+00004890: 6372 7970 742d 7468 656e 2d61 7574 6865  crypt-then-authe\n+000048a0: 6e74 6963 6174 650a 6d6f 6465 6c20 666f  nticate.model fo\n+000048b0: 7220 7374 726f 6e67 2053 5041 206d 6573  r strong SPA mes\n+000048c0: 7361 6765 2061 7574 6865 6e74 6963 6174  sage authenticat\n+000048d0: 696f 6e2e 2020 5468 6520 484d 4143 2069  ion.  The HMAC i\n+000048e0: 7473 656c 6620 6973 2064 6572 6976 6564  tself is derived\n+000048f0: 0a66 726f 6d20 6120 6469 6765 7374 206f  .from a digest o\n+00004900: 6620 7468 6520 656e 6372 7970 7465 6420  f the encrypted \n+00004910: 5350 4120 6d65 7373 6167 6520 616c 6f6e  SPA message alon\n+00004920: 6720 7769 7468 2061 2064 6564 6963 6174  g with a dedicat\n+00004930: 6564 2048 4d41 430a 6b65 792e 0a0a 2020  ed HMAC.key...  \n+00004940: 2043 7572 7265 6e74 6c79 2c20 6c69 6266   Currently, libf\n+00004950: 6b6f 2073 7570 706f 7274 7320 7468 6520  ko supports the \n+00004960: 7361 6d65 206d 6573 7361 6765 2064 6967  same message dig\n+00004970: 6573 7473 2061 7320 6d65 6e74 696f 6e65  ests as mentione\n+00004980: 6420 696e 0a74 6865 2044 6967 6573 7420  d in.the Digest \n+00004990: 7365 6374 696f 6e20 6162 6f76 652c 2061  section above, a\n+000049a0: 6e64 2074 6865 7365 2061 7265 2028 696e  nd these are (in\n+000049b0: 206f 7264 6572 206f 6620 7374 7265 6e67   order of streng\n+000049c0: 7468 293a 0a0a 202d 2d20 5661 7269 6162  th):.. -- Variab\n+000049d0: 6c65 3a20 696e 7420 666b 6f5f 6469 6765  le: int fko_dige\n+000049e0: 7374 5f74 7970 655f 740a 2020 2020 2027  st_type_t.     '\n+000049f0: 464b 4f5f 484d 4143 5f4d 4435 270a 2020  FKO_HMAC_MD5'.  \n+00004a00: 2020 2027 464b 4f5f 484d 4143 5f53 4841     'FKO_HMAC_SHA\n+00004a10: 3127 0a20 2020 2020 2746 4b4f 5f48 4d41  1'.     'FKO_HMA\n+00004a20: 435f 5348 4132 3536 2028 6c69 6266 6b6f  C_SHA256 (libfko\n+00004a30: 2064 6566 6175 6c74 2927 0a20 2020 2020   default)'.     \n+00004a40: 2746 4b4f 5f48 4d41 435f 5348 4133 3834  'FKO_HMAC_SHA384\n+00004a50: 270a 2020 2020 2027 464b 4f5f 484d 4143  '.     'FKO_HMAC\n+00004a60: 5f53 4841 3531 3227 0a0a 2020 2041 7320  _SHA512'..   As \n+00004a70: 696e 6469 6361 7465 6420 696e 2074 6865  indicated in the\n+00004a80: 206c 6973 7420 6162 6f76 652c 2053 4841   list above, SHA\n+00004a90: 3235 3620 6973 2074 6865 2064 6566 6175  256 is the defau\n+00004aa0: 6c74 2e20 2054 6869 7320 6d65 616e 730a  lt.  This means.\n+00004ab0: 7468 6520 484d 4143 2064 6967 6573 7420  the HMAC digest \n+00004ac0: 7479 7065 2064 6f65 7320 6e6f 7420 6e65  type does not ne\n+00004ad0: 6564 2074 6f20 6265 2065 7870 6c69 6369  ed to be explici\n+00004ae0: 746c 7920 7365 7420 756e 6c65 7373 2079  tly set unless y\n+00004af0: 6f75 2077 6973 680a 746f 2075 7365 206f  ou wish.to use o\n+00004b00: 6e65 206f 6620 7468 6520 6f74 6865 7220  ne of the other \n+00004b10: 7661 6c75 6573 2e20 2054 6869 7320 6170  values.  This ap\n+00004b20: 706c 6965 7320 746f 2061 6c6c 206c 6962  plies to all lib\n+00004b30: 666b 6f20 5350 4120 6461 7461 0a66 6965  fko SPA data.fie\n+00004b40: 6c64 7320 7468 6174 2068 6176 6520 6120  lds that have a \n+00004b50: 6465 6661 756c 7420 7661 6c75 652e 0a0a  default value...\n+00004b60: 1f0a 4669 6c65 3a20 6c69 6266 6b6f 2e69  ..File: libfko.i\n+00004b70: 6e66 6f2c 2020 4e6f 6465 3a20 5573 696e  nfo,  Node: Usin\n+00004b80: 6720 6c69 6266 6b6f 2c20 204e 6578 743a  g libfko,  Next:\n+00004b90: 204c 6962 7261 7279 2043 6f70 7969 6e67   Library Copying\n+00004ba0: 2c20 2050 7265 763a 2050 7265 7061 7261  ,  Prev: Prepara\n+00004bb0: 7469 6f6e 2c20 2055 703a 2054 6f70 0a0a  tion,  Up: Top..\n+00004bc0: 3320 5573 696e 6720 6c69 6266 6b6f 0a2a  3 Using libfko.*\n+00004bd0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54  *************..T\n+00004be0: 6869 7320 6368 6170 7465 7220 7072 6f76  his chapter prov\n+00004bf0: 6964 6573 2074 6865 2022 686f 7774 6f22  ides the \"howto\"\n+00004c00: 2066 6f72 2075 7369 6e67 206c 6962 666b   for using libfk\n+00004c10: 6f2c 2069 6e63 6c75 6469 6e67 2072 6571  o, including req\n+00004c20: 7569 7265 640a 6675 6e63 7469 6f6e 7320  uired.functions \n+00004c30: 616e 6420 7061 7261 6d65 7465 7220 6368  and parameter ch\n+00004c40: 6f69 6365 732e 2020 496e 2073 6f6d 6520  oices.  In some \n+00004c50: 7365 6374 696f 6e73 2c20 636f 6465 2073  sections, code s\n+00004c60: 616d 706c 6573 2061 7265 0a70 726f 7669  amples are.provi\n+00004c70: 6465 6420 746f 2066 7572 7468 6572 2069  ded to further i\n+00004c80: 6c6c 7573 7472 6174 6520 7573 6167 652e  llustrate usage.\n+00004c90: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2043 7265  ..* Menu:..* Cre\n+00004ca0: 6174 696e 6720 436f 6e74 6578 7473 3a3a  ating Contexts::\n+00004cb0: 2020 2020 2020 2020 2020 2020 2043 7265               Cre\n+00004cc0: 6174 696e 6720 6120 6e65 7720 666b 6f20  ating a new fko \n+00004cd0: 636f 6e74 6578 740a 2a20 4465 7374 726f  context.* Destro\n+00004ce0: 7969 6e67 2043 6f6e 7465 7874 733a 3a20  ying Contexts:: \n+00004cf0: 2020 2020 2020 2020 2020 5265 6c65 6173            Releas\n+00004d00: 696e 6720 616e 2066 6b6f 2063 6f6e 7465  ing an fko conte\n+00004d10: 7874 0a2a 2043 7265 6174 696e 6720 6120  xt.* Creating a \n+00004d20: 5350 4120 4d65 7373 6167 653a 3a20 2020  SPA Message::   \n+00004d30: 2020 2020 2057 6861 7420 6974 2074 616b       What it tak\n+00004d40: 6573 2074 6f20 6372 6561 7465 2061 2053  es to create a S\n+00004d50: 5041 0a20 2020 2020 2020 2020 2020 2020  PA.             \n 00004d60: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00004d70: 2020 2020 2020 206d 6573 7361 6765 0a2a         message.*\n-00004d80: 2053 6574 7469 6e67 2053 5041 2044 6174   Setting SPA Dat\n-00004d90: 613a 3a20 2020 2020 2020 2020 2020 2020  a::             \n-00004da0: 2053 6574 7469 6e67 2053 5041 2064 6174   Setting SPA dat\n-00004db0: 610a 2a20 5265 7472 6965 7669 6e67 2053  a.* Retrieving S\n-00004dc0: 5041 2044 6174 613a 3a20 2020 2020 2020  PA Data::       \n-00004dd0: 2020 2020 5265 7472 6965 7669 6e67 2053      Retrieving S\n-00004de0: 5041 2064 6174 610a 2a20 5574 696c 6974  PA data.* Utilit\n-00004df0: 7920 4675 6e63 7469 6f6e 733a 3a20 2020  y Functions::   \n-00004e00: 2020 2020 2020 2020 2020 4f74 6865 7220            Other \n-00004e10: 7574 696c 6974 792c 206d 6973 6365 6c6c  utility, miscell\n-00004e20: 616e 656f 7573 2c20 616e 6420 7365 6c64  aneous, and seld\n-00004e30: 6f6d 0a20 2020 2020 2020 2020 2020 2020  om.             \n+00004d70: 2020 2020 206d 6573 7361 6765 0a2a 2053       message.* S\n+00004d80: 6574 7469 6e67 2053 5041 2044 6174 613a  etting SPA Data:\n+00004d90: 3a20 2020 2020 2020 2020 2020 2020 2053  :              S\n+00004da0: 6574 7469 6e67 2053 5041 2064 6174 610a  etting SPA data.\n+00004db0: 2a20 5265 7472 6965 7669 6e67 2053 5041  * Retrieving SPA\n+00004dc0: 2044 6174 613a 3a20 2020 2020 2020 2020   Data::         \n+00004dd0: 2020 5265 7472 6965 7669 6e67 2053 5041    Retrieving SPA\n+00004de0: 2064 6174 610a 2a20 5574 696c 6974 7920   data.* Utility \n+00004df0: 4675 6e63 7469 6f6e 733a 3a20 2020 2020  Functions::     \n+00004e00: 2020 2020 2020 2020 4f74 6865 7220 7574          Other ut\n+00004e10: 696c 6974 792c 206d 6973 6365 6c6c 616e  ility, miscellan\n+00004e20: 656f 7573 2c20 616e 6420 7365 6c64 6f6d  eous, and seldom\n+00004e30: 0a20 2020 2020 2020 2020 2020 2020 2020  .               \n 00004e40: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00004e50: 2020 2020 2075 7365 6420 6675 6e63 7469       used functi\n-00004e60: 6f6e 730a 2a20 4572 726f 7220 4861 6e64  ons.* Error Hand\n-00004e70: 6c69 6e67 3a3a 2020 2020 2020 2020 2020  ling::          \n-00004e80: 2020 2020 2020 506f 7373 6962 6c65 2065        Possible e\n-00004e90: 7272 6f72 7320 616e 6420 7468 6569 7220  rrors and their \n-00004ea0: 6d65 616e 696e 670a 0a1f 0a46 696c 653a  meaning....File:\n-00004eb0: 206c 6962 666b 6f2e 696e 666f 2c20 204e   libfko.info,  N\n-00004ec0: 6f64 653a 2043 7265 6174 696e 6720 436f  ode: Creating Co\n-00004ed0: 6e74 6578 7473 2c20 204e 6578 743a 2044  ntexts,  Next: D\n-00004ee0: 6573 7472 6f79 696e 6720 436f 6e74 6578  estroying Contex\n-00004ef0: 7473 2c20 2055 703a 2055 7369 6e67 206c  ts,  Up: Using l\n-00004f00: 6962 666b 6f0a 0a33 2e31 2043 7265 6174  ibfko..3.1 Creat\n-00004f10: 696e 6720 436f 6e74 6578 7473 0a3d 3d3d  ing Contexts.===\n+00004e50: 2020 2075 7365 6420 6675 6e63 7469 6f6e     used function\n+00004e60: 730a 2a20 4572 726f 7220 4861 6e64 6c69  s.* Error Handli\n+00004e70: 6e67 3a3a 2020 2020 2020 2020 2020 2020  ng::            \n+00004e80: 2020 2020 506f 7373 6962 6c65 2065 7272      Possible err\n+00004e90: 6f72 7320 616e 6420 7468 6569 7220 6d65  ors and their me\n+00004ea0: 616e 696e 670a 0a1f 0a46 696c 653a 206c  aning....File: l\n+00004eb0: 6962 666b 6f2e 696e 666f 2c20 204e 6f64  ibfko.info,  Nod\n+00004ec0: 653a 2043 7265 6174 696e 6720 436f 6e74  e: Creating Cont\n+00004ed0: 6578 7473 2c20 204e 6578 743a 2044 6573  exts,  Next: Des\n+00004ee0: 7472 6f79 696e 6720 436f 6e74 6578 7473  troying Contexts\n+00004ef0: 2c20 2055 703a 2055 7369 6e67 206c 6962  ,  Up: Using lib\n+00004f00: 666b 6f0a 0a33 2e31 2043 7265 6174 696e  fko..3.1 Creatin\n+00004f10: 6720 436f 6e74 6578 7473 0a3d 3d3d 3d3d  g Contexts.=====\n 00004f20: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================\n-00004f30: 3d3d 0a0a 4265 666f 7265 2064 6f69 6e67  ==..Before doing\n-00004f40: 2061 6e79 7468 696e 6720 7769 7468 206c   anything with l\n-00004f50: 6962 666b 6f2c 2079 6f75 206e 6565 6420  ibfko, you need \n-00004f60: 746f 2063 7265 6174 6520 6120 636f 6e74  to create a cont\n-00004f70: 6578 742e 2020 410a 636f 6e74 6578 7420  ext.  A.context \n-00004f80: 6973 2063 7265 6174 6564 2066 6f72 206f  is created for o\n-00004f90: 6e65 206f 6620 7477 6f20 7265 6173 6f6e  ne of two reason\n-00004fa0: 732e 2020 4f6e 6520 6973 2066 6f72 2074  s.  One is for t\n-00004fb0: 6865 2070 7572 706f 7365 206f 660a 6275  he purpose of.bu\n-00004fc0: 696c 6469 6e67 2061 206e 6577 2066 6b6f  ilding a new fko\n-00004fd0: 2053 5041 206d 6573 7361 6765 2066 726f   SPA message fro\n-00004fe0: 6d20 7363 7261 7463 6820 2874 7970 6963  m scratch (typic\n-00004ff0: 616c 6c79 2074 6f20 6265 2070 6163 6b61  ally to be packa\n-00005000: 6765 640a 616e 6420 7365 6e74 2074 6f20  ged.and sent to \n-00005010: 616e 2066 776b 6e6f 7020 7365 7276 6572  an fwknop server\n-00005020: 2073 6f6d 6577 6865 7265 292e 2020 5468   somewhere).  Th\n-00005030: 6520 6f74 6865 7220 776f 756c 6420 6265  e other would be\n-00005040: 2061 2063 6f6e 7465 7874 0a66 6f72 2074   a context.for t\n-00005050: 616b 696e 6720 616e 2065 7869 7374 696e  aking an existin\n-00005060: 6720 5350 4120 6d65 7373 6167 6520 666f  g SPA message fo\n-00005070: 7220 6465 636f 6469 6e67 2c20 7061 7273  r decoding, pars\n-00005080: 696e 672c 2061 6e64 2064 6174 610a 6578  ing, and data.ex\n-00005090: 7472 6163 7469 6f6e 2e0a 0a46 6f72 2062  traction...For b\n-000050a0: 7569 6c64 696e 6720 6120 6e65 7720 666b  uilding a new fk\n-000050b0: 6f20 5350 4120 6d65 7373 6167 652c 2079  o SPA message, y\n-000050c0: 6f75 2077 696c 6c20 7573 6520 7468 6520  ou will use the \n-000050d0: 2766 6b6f 5f6e 6577 2720 6675 6e63 7469  'fko_new' functi\n-000050e0: 6f6e 3a0a 0a20 2d2d 2046 756e 6374 696f  on:.. -- Functio\n-000050f0: 6e3a 2069 6e74 2066 6b6f 5f6e 6577 2028  n: int fko_new (\n-00005100: 666b 6f5f 6374 785f 7420 2a43 5458 290a  fko_ctx_t *CTX).\n-00005110: 2020 2020 2054 6865 2066 756e 6374 696f       The functio\n-00005120: 6e20 2766 6b6f 5f6e 6577 2720 7365 7473  n 'fko_new' sets\n-00005130: 2075 7020 616e 6420 696e 6974 6961 6c69   up and initiali\n-00005140: 7a65 7320 6120 6e65 7720 2766 6b6f 5f63  zes a new 'fko_c\n-00005150: 7478 5f74 270a 2020 2020 206f 626a 6563  tx_t'.     objec\n-00005160: 742c 2070 7265 2d70 6f70 756c 6174 6573  t, pre-populates\n-00005170: 2064 6566 6175 6c74 2076 616c 7565 7320   default values \n-00005180: 616e 6420 7265 7475 726e 7320 6120 6861  and returns a ha\n-00005190: 6e64 6c65 2066 6f72 2069 7420 696e 0a20  ndle for it in. \n-000051a0: 2020 2020 4354 582e 2020 5468 6520 6675      CTX.  The fu\n-000051b0: 6e63 7469 6f6e 2072 6574 7572 6e73 2074  nction returns t\n-000051c0: 6865 2065 7272 6f72 2063 6f64 6520 2746  he error code 'F\n-000051d0: 4b4f 5f53 5543 4345 5353 2720 6966 2074  KO_SUCCESS' if t\n-000051e0: 6865 0a20 2020 2020 636f 6e74 6578 7420  he.     context \n-000051f0: 7761 7320 7375 6363 6573 7366 756c 6c79  was successfully\n-00005200: 2063 7265 6174 6564 2e20 204f 7468 6572   created.  Other\n-00005210: 7769 7365 2061 6e20 616e 6f74 6865 7220  wise an another \n-00005220: 6572 726f 7220 636f 6465 0a20 2020 2020  error code.     \n-00005230: 7769 6c6c 2062 6520 7265 7475 726e 6564  will be returned\n-00005240: 2028 2a6e 6f74 6520 4572 726f 7220 4861   (*note Error Ha\n-00005250: 6e64 6c69 6e67 3a3a 2066 6f72 2064 6574  ndling:: for det\n-00005260: 6169 6c73 206f 6e20 7468 6520 7661 7269  ails on the vari\n-00005270: 6f75 730a 2020 2020 2065 7272 6f72 2063  ous.     error c\n-00005280: 6f64 6573 2061 6e64 2074 6865 6972 206d  odes and their m\n-00005290: 6561 6e69 6e67 7329 2e0a 0a20 2020 2020  eanings)...     \n-000052a0: 666b 6f5f 6374 785f 7420 2020 6374 783b  fko_ctx_t   ctx;\n-000052b0: 0a20 2020 2020 696e 7420 2020 2020 2020  .     int       \n-000052c0: 2020 7263 3b0a 0a20 2020 2020 7263 203d    rc;..     rc =\n-000052d0: 2066 6b6f 5f6e 6577 2826 6374 7829 3b0a   fko_new(&ctx);.\n-000052e0: 0a20 2020 2020 6966 2872 6320 213d 2046  .     if(rc != F\n-000052f0: 4b4f 5f53 5543 4345 5353 290a 2020 2020  KO_SUCCESS).    \n-00005300: 207b 0a20 2020 2020 2020 2020 6670 7269   {.         fpri\n-00005310: 6e74 6628 7374 6465 7272 2c20 2245 7272  ntf(stderr, \"Err\n-00005320: 6f72 2025 6920 6672 6f6d 2066 6b6f 5f6e  or %i from fko_n\n-00005330: 6577 3a20 2573 5c6e 222c 0a20 2020 2020  ew: %s\\n\",.     \n-00005340: 2020 2020 2020 2020 7263 2c20 666b 6f5f          rc, fko_\n-00005350: 6572 7273 7472 2872 6329 293b 0a20 2020  errstr(rc));.   \n-00005360: 2020 2020 2020 6578 6974 2831 293b 0a20        exit(1);. \n-00005370: 2020 2020 7d0a 0a46 6f72 2061 2063 6f6e      }..For a con\n-00005380: 7465 7874 2074 6861 7420 7769 6c6c 2062  text that will b\n-00005390: 6520 7573 6564 2066 6f72 2072 6563 6569  e used for recei\n-000053a0: 7669 6e67 2061 6e64 2070 6172 7369 6e67  ving and parsing\n-000053b0: 2061 6e20 6578 6973 7469 6e67 0a53 5041   an existing.SPA\n-000053c0: 206d 6573 7361 6765 2c20 796f 7520 7769   message, you wi\n-000053d0: 6c6c 2075 7365 2074 6865 2027 666b 6f5f  ll use the 'fko_\n-000053e0: 6e65 775f 7769 7468 5f64 6174 6127 2066  new_with_data' f\n-000053f0: 756e 6374 696f 6e3a 0a0a 202d 2d20 4675  unction:.. -- Fu\n-00005400: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_\n-00005410: 6e65 775f 7769 7468 5f64 6174 6120 2866  new_with_data (f\n-00005420: 6b6f 5f63 7478 5f74 202a 4354 582c 2063  ko_ctx_t *CTX, c\n-00005430: 6f6e 7374 2063 6861 7220 2a44 4154 412c  onst char *DATA,\n-00005440: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const\n-00005450: 2063 6861 7220 2a4b 4559 2c20 636f 6e73   char *KEY, cons\n-00005460: 7420 6368 6172 204b 4559 5f4c 454e 2c20  t char KEY_LEN, \n-00005470: 696e 7420 454e 4352 5950 5449 4f4e 5f4d  int ENCRYPTION_M\n-00005480: 4f44 452c 0a20 2020 2020 2020 2020 2063  ODE,.          c\n-00005490: 6f6e 7374 2063 6861 7220 484d 4143 5f4b  onst char HMAC_K\n-000054a0: 4559 2c20 636f 6e73 7420 696e 7420 484d  EY, const int HM\n-000054b0: 4143 5f54 5950 4529 0a0a 2020 2020 2054  AC_TYPE)..     T\n-000054c0: 6865 2066 756e 6374 696f 6e20 2766 6b6f  he function 'fko\n-000054d0: 5f6e 6577 5f77 6974 685f 6461 7461 2720  _new_with_data' \n-000054e0: 7365 7473 2075 7020 616e 6420 696e 6974  sets up and init\n-000054f0: 6961 6c69 7a65 7320 6120 6e65 770a 2020  ializes a new.  \n-00005500: 2020 2027 666b 6f5f 6374 785f 7427 2063     'fko_ctx_t' c\n-00005510: 6f6e 7465 7874 2c20 6275 7420 696e 7374  ontext, but inst\n-00005520: 6561 6420 6f66 2069 6e69 7469 616c 697a  ead of initializ\n-00005530: 696e 6720 6465 6661 756c 7420 7661 6c75  ing default valu\n-00005540: 6573 2c20 6974 0a20 2020 2020 7374 6f72  es, it.     stor\n-00005550: 6573 2074 6865 2065 6e63 7279 7074 6564  es the encrypted\n-00005560: 206d 6573 7361 6765 2064 6174 6120 616e   message data an\n-00005570: 6420 6d61 6b65 7320 6974 2072 6561 6479  d makes it ready\n-00005580: 2066 6f72 2070 6172 7369 6e67 2e0a 2020   for parsing..  \n-00005590: 2020 2054 6869 7320 6361 6e20 6265 2064     This can be d\n-000055a0: 6f6e 6520 696e 206f 6e65 206f 6620 7477  one in one of tw\n-000055b0: 6f20 7761 7973 2e20 204f 6e65 2069 7320  o ways.  One is \n-000055c0: 746f 2070 6173 7320 274e 554c 4c27 2066  to pass 'NULL' f\n-000055d0: 6f72 2074 6865 0a20 2020 2020 7468 6972  or the.     thir\n-000055e0: 6420 6172 6775 6d65 6e74 2e20 2054 6865  d argument.  The\n-000055f0: 2063 6f6e 7465 7874 2077 696c 6c20 6265   context will be\n-00005600: 2063 7265 6174 6564 2061 6e64 2074 6865   created and the\n-00005610: 2064 6174 6120 7769 6c6c 2062 650a 2020   data will be.  \n-00005620: 2020 2073 746f 7265 642c 2062 7574 206e     stored, but n\n-00005630: 6f20 6465 6372 7970 7469 6f6e 206f 7220  o decryption or \n-00005640: 6465 636f 6469 6e67 2074 616b 6573 2070  decoding takes p\n-00005650: 6c61 6365 2e20 2049 6e20 7468 6973 2063  lace.  In this c\n-00005660: 6173 652c 0a20 2020 2020 796f 7520 7769  ase,.     you wi\n-00005670: 6c6c 206e 6565 6420 746f 2063 616c 6c20  ll need to call \n-00005680: 2766 6b6f 5f64 6563 7279 7074 5f73 7061  'fko_decrypt_spa\n-00005690: 5f64 6174 6127 2061 7420 6120 6c61 7465  _data' at a late\n-000056a0: 7220 7469 6d65 2e20 2054 6865 0a20 2020  r time.  The.   \n-000056b0: 2020 6f74 6865 7220 7761 7920 746f 2064    other way to d\n-000056c0: 6f20 6974 2069 7320 746f 2073 7570 706c  o it is to suppl\n-000056d0: 7920 7468 6520 4b45 5920 7661 6c75 6520  y the KEY value \n-000056e0: 2864 6563 7279 7074 696f 6e0a 2020 2020  (decryption.    \n-000056f0: 2070 6173 7370 6872 6173 6529 2061 6e64   passphrase) and\n-00005700: 2061 7373 6f63 6174 6564 206c 656e 6774   assocated lengt\n-00005710: 682e 2020 496e 2074 6869 7320 6361 7365  h.  In this case\n-00005720: 2c20 7468 6520 636f 6e74 6578 7420 6973  , the context is\n-00005730: 0a20 2020 2020 6372 6561 7465 642c 2074  .     created, t\n-00005740: 6865 2053 5041 2064 6174 6120 6973 2064  he SPA data is d\n-00005750: 6563 7279 7074 6564 2c20 6465 636f 6465  ecrypted, decode\n-00005760: 642c 2070 6172 7365 642c 2061 6e64 2073  d, parsed, and s\n-00005770: 746f 7265 6420 696e 0a20 2020 2020 7468  tored in.     th\n-00005780: 6520 636f 6e74 6578 7420 7265 6164 7920  e context ready \n-00005790: 666f 7220 7265 7472 6965 7661 6c2e 2020  for retrieval.  \n-000057a0: 4966 2061 6e20 484d 4143 2069 7320 616c  If an HMAC is al\n-000057b0: 736f 2064 6573 6972 6564 206f 720a 2020  so desired or.  \n-000057c0: 2020 2072 6571 7569 7265 642c 2074 6865     required, the\n-000057d0: 6e20 7468 6520 484d 4143 5f4b 4559 2061  n the HMAC_KEY a\n-000057e0: 6e64 2061 7373 6f63 6961 7465 6420 6c65  nd associated le\n-000057f0: 6e67 7468 2063 616e 2062 6520 7061 7373  ngth can be pass\n-00005800: 6564 2069 6e2e 0a20 2020 2020 5468 6973  ed in..     This\n-00005810: 2077 696c 6c20 6361 7573 6520 6c69 6266   will cause libf\n-00005820: 6b6f 2074 6f20 6175 7468 656e 7469 6361  ko to authentica\n-00005830: 7465 2074 6865 2053 5041 2064 6174 6120  te the SPA data \n-00005840: 6265 666f 7265 0a20 2020 2020 6465 6372  before.     decr\n-00005850: 7970 7469 6f6e 2069 7320 6174 7465 6d70  yption is attemp\n-00005860: 7465 642c 2061 6e64 2074 6869 7320 6973  ted, and this is\n-00005870: 2073 7472 6f6e 676c 7920 7265 636f 6d6d   strongly recomm\n-00005880: 656e 6465 6420 746f 2064 6f2e 0a0a 2020  ended to do...  \n-00005890: 2020 2054 6865 2027 666b 6f5f 6e65 775f     The 'fko_new_\n-000058a0: 7769 7468 5f64 6174 6127 2066 756e 6374  with_data' funct\n-000058b0: 696f 6e20 7265 7475 726e 7320 7468 6520  ion returns the \n-000058c0: 6572 726f 7220 636f 6465 0a20 2020 2020  error code.     \n-000058d0: 2746 4b4f 5f53 5543 4345 5353 2720 6966  'FKO_SUCCESS' if\n-000058e0: 2074 6865 2063 6f6e 7465 7874 2077 6173   the context was\n-000058f0: 2073 7563 6365 7373 6675 6c6c 7920 6372   successfully cr\n-00005900: 6561 7465 642e 2020 4966 2061 6e79 206f  eated.  If any o\n-00005910: 660a 2020 2020 2074 6865 2069 6e74 6572  f.     the inter\n-00005920: 6d65 6469 6174 6520 7374 6570 7320 696e  mediate steps in\n-00005930: 2070 6172 7369 6e67 2074 6865 2064 6174   parsing the dat\n-00005940: 612c 2076 616c 6964 6174 696e 6720 7468  a, validating th\n-00005950: 6520 5350 410a 2020 2020 206d 6573 7361  e SPA.     messa\n-00005960: 6765 2064 6967 6573 742c 206f 7220 616e  ge digest, or an\n-00005970: 7920 6f74 6865 7220 696e 7465 726e 616c  y other internal\n-00005980: 2061 6374 696f 6e20 6661 696c 732c 2074   action fails, t\n-00005990: 6865 6e20 7468 650a 2020 2020 2061 7070  hen the.     app\n-000059a0: 726f 7072 6961 7465 2065 7272 6f72 2063  ropriate error c\n-000059b0: 6f64 6520 6973 2072 6574 7572 6e65 642e  ode is returned.\n-000059c0: 0a0a 5468 6520 6d6f 7374 2063 6f6d 6d6f  ..The most commo\n-000059d0: 6e20 2873 696d 706c 6529 2063 6173 652e  n (simple) case.\n-000059e0: 2e2e 0a0a 2020 2020 2066 6b6f 5f63 7478  ....     fko_ctx\n-000059f0: 5f74 2020 2063 7478 3b0a 2020 2020 2063  _t   ctx;.     c\n-00005a00: 6861 7220 2020 2020 2020 2a73 7061 5f64  har       *spa_d\n-00005a10: 6174 613b 0a20 2020 2020 6368 6172 2020  ata;.     char  \n-00005a20: 2020 2020 202a 6b65 793b 0a20 2020 2020       *key;.     \n-00005a30: 696e 7420 2020 2020 2020 2020 6b65 795f  int         key_\n-00005a40: 6c65 6e3b 0a20 2020 2020 6368 6172 2020  len;.     char  \n-00005a50: 2020 2020 202a 686d 6163 5f6b 6579 3b0a       *hmac_key;.\n-00005a60: 2020 2020 2069 6e74 2020 2020 2020 2020       int        \n-00005a70: 2068 6d61 635f 6b65 795f 6c65 6e3b 0a20   hmac_key_len;. \n-00005a80: 2020 2020 696e 7420 2020 2020 2020 2020      int         \n-00005a90: 686d 6163 5f74 7970 6520 3d20 464b 4f5f  hmac_type = FKO_\n-00005aa0: 484d 4143 5f53 4841 3235 363b 0a20 2020  HMAC_SHA256;.   \n-00005ab0: 2020 696e 7420 2020 2020 2020 2020 656e    int         en\n-00005ac0: 635f 6d6f 6465 2020 3d20 464b 4f5f 454e  c_mode  = FKO_EN\n-00005ad0: 435f 4d4f 4445 5f43 4243 3b0a 2020 2020  C_MODE_CBC;.    \n-00005ae0: 2069 6e74 2072 633b 0a0a 2020 2020 202f   int rc;..     /\n-00005af0: 2a20 4173 7375 6d65 2077 6520 6361 6c6c  * Assume we call\n-00005b00: 6564 2063 6f64 6520 7468 6174 2072 6574  ed code that ret\n-00005b10: 7269 6576 6573 2074 6865 2064 6174 6120  rieves the data \n-00005b20: 616e 6420 6b65 790a 2020 2020 202a 2f0a  and key.     */.\n-00005b30: 0a20 2020 2020 7263 203d 2066 6b6f 5f6e  .     rc = fko_n\n-00005b40: 6577 5f77 6974 685f 6461 7461 2826 6374  ew_with_data(&ct\n-00005b50: 782c 2073 7061 5f64 6174 612c 206b 6579  x, spa_data, key\n-00005b60: 2c20 6b65 795f 6c65 6e2c 205c 5c0a 2020  , key_len, \\\\.  \n-00005b70: 2020 2020 2020 2065 6e63 5f6d 6f64 652c         enc_mode,\n-00005b80: 2068 6d61 635f 6b65 792c 2068 6d61 635f   hmac_key, hmac_\n-00005b90: 6b65 795f 6c65 6e2c 2068 6d61 635f 7479  key_len, hmac_ty\n-00005ba0: 7065 293b 0a0a 2020 2020 2069 6628 7263  pe);..     if(rc\n-00005bb0: 2021 3d20 464b 4f5f 5355 4343 4553 5329   != FKO_SUCCESS)\n-00005bc0: 0a20 2020 2020 7b0a 2020 2020 2020 2020  .     {.        \n-00005bd0: 2066 7072 696e 7466 2873 7464 6572 722c   fprintf(stderr,\n-00005be0: 2022 4572 726f 7220 2569 2066 726f 6d20   \"Error %i from \n-00005bf0: 666b 6f5f 6e65 775f 7769 7468 5f64 6174  fko_new_with_dat\n-00005c00: 613a 2025 735c 6e22 2c0a 2020 2020 2020  a: %s\\n\",.      \n-00005c10: 2020 2020 2020 2072 632c 2066 6b6f 6572         rc, fkoer\n-00005c20: 7273 7472 2872 6329 293b 0a20 2020 2020  rstr(rc));.     \n-00005c30: 2020 2020 6578 6974 2831 293b 0a20 2020      exit(1);.   \n-00005c40: 2020 7d0a 0a4f 722c 2070 6572 6861 7073    }..Or, perhaps\n-00005c50: 2079 6f75 206e 6565 6420 746f 2064 6566   you need to def\n-00005c60: 6572 2064 6563 7279 7074 696f 6e20 616e  er decryption an\n-00005c70: 6420 7061 7273 696e 6720 746f 2061 206c  d parsing to a l\n-00005c80: 6174 6572 2070 6f69 6e74 2069 6e0a 7468  ater point in.th\n-00005c90: 6520 7072 6f67 7261 6d2e 2020 5765 2063  e program.  We c\n-00005ca0: 6f75 6c64 2075 7365 2066 6b6f 5f6e 6577  ould use fko_new\n-00005cb0: 5f77 6974 685f 6461 7461 2829 2c20 7061  _with_data(), pa\n-00005cc0: 7373 696e 6720 4e55 4c4c 2066 6f72 2074  ssing NULL for t\n-00005cd0: 6865 0a64 6563 7279 7074 696f 6e20 6b65  he.decryption ke\n-00005ce0: 7920 616e 6420 484d 4143 206b 6579 732c  y and HMAC keys,\n-00005cf0: 206f 7220 7765 2063 6f75 6c64 2075 7365   or we could use\n-00005d00: 2066 6b6f 5f6e 6577 2829 2074 6f20 6372   fko_new() to cr\n-00005d10: 6561 7465 2061 6e0a 656d 7074 7920 636f  eate an.empty co\n-00005d20: 6e74 6578 742c 2074 6865 6e20 7573 6520  ntext, then use \n-00005d30: 666b 6f5f 7365 745f 7370 615f 6461 7461  fko_set_spa_data\n-00005d40: 2829 2074 6f20 6164 6420 7468 6520 656e  () to add the en\n-00005d50: 6379 7074 6564 2064 6174 6120 2873 6565  cypted data (see\n-00005d60: 0a63 6f6d 6d65 6e74 7320 696e 2074 6865  .comments in the\n-00005d70: 2063 6f64 6520 7361 6d70 6c65 7329 2e0a   code samples)..\n-00005d80: 0a20 2020 2020 666b 6f5f 6374 785f 7420  .     fko_ctx_t \n-00005d90: 2020 6374 783b 0a20 2020 2020 6368 6172    ctx;.     char\n-00005da0: 2020 2020 2020 202a 7370 615f 6461 7461         *spa_data\n-00005db0: 3b0a 2020 2020 2063 6861 7220 2020 2020  ;.     char     \n-00005dc0: 2020 2a6b 6579 3b0a 2020 2020 2069 6e74    *key;.     int\n-00005dd0: 2072 633b 0a0a 2020 2020 202f 2a20 4173   rc;..     /* As\n-00005de0: 7375 6d65 2077 6520 6361 6c6c 6564 2063  sume we called c\n-00005df0: 6f64 6520 7468 6174 2072 6574 7269 6576  ode that retriev\n-00005e00: 6573 2074 6865 2064 6174 6120 616e 6420  es the data and \n-00005e10: 6b65 790a 2020 2020 202a 2f0a 0a20 2020  key.     */..   \n-00005e20: 2020 7263 203d 2066 6b6f 5f6e 6577 5f77    rc = fko_new_w\n-00005e30: 6974 685f 6461 7461 2826 6374 782c 2073  ith_data(&ctx, s\n-00005e40: 7061 5f64 6174 612c 204e 554c 4c2c 2030  pa_data, NULL, 0\n-00005e50: 2c0a 2020 2020 2020 2020 2020 2020 2046  ,.             F\n-00005e60: 4b4f 5f45 4e43 5f4d 4f44 455f 4342 432c  KO_ENC_MODE_CBC,\n-00005e70: 204e 554c 4c2c 2030 2c20 464b 4f5f 484d   NULL, 0, FKO_HM\n-00005e80: 4143 5f53 4841 3235 3629 3b0a 0a20 2020  AC_SHA256);..   \n-00005e90: 2020 6966 2872 6320 213d 2046 4b4f 5f53    if(rc != FKO_S\n-00005ea0: 5543 4345 5353 290a 2020 2020 207b 0a20  UCCESS).     {. \n-00005eb0: 2020 2020 2020 2020 6670 7269 6e74 6628          fprintf(\n-00005ec0: 7374 6465 7272 2c20 2245 7272 6f72 2066  stderr, \"Error f\n-00005ed0: 726f 6d20 666b 6f5f 6e65 775f 7769 7468  rom fko_new_with\n-00005ee0: 5f64 6174 613a 2025 735c 6e22 2c0a 2020  _data: %s\\n\",.  \n-00005ef0: 2020 2020 2020 2020 2020 2066 6b6f 5f65             fko_e\n-00005f00: 7272 7374 7228 7263 2929 3b0a 2020 2020  rrstr(rc));.    \n-00005f10: 2020 2020 2065 7869 7428 3129 3b0a 2020       exit(1);.  \n-00005f20: 2020 207d 0a0a 2020 2020 202f 2a20 5765     }..     /* We\n-00005f30: 2063 6f75 6c64 2061 6c73 6f20 6a75 7374   could also just\n-00005f40: 2063 7265 6174 6520 616e 6420 656d 7074   create and empt\n-00005f50: 7920 636f 6e74 6578 7420 616e 6420 6164  y context and ad\n-00005f60: 6420 7468 650a 2020 2020 2020 2a20 656e  d the.      * en\n-00005f70: 6372 7970 7465 6420 6461 7461 2061 7320  crypted data as \n-00005f80: 666f 6c6c 6f77 733a 0a20 2020 2020 202a  follows:.      *\n-00005f90: 0a20 2020 2020 202a 2072 6320 3d20 666b  .      * rc = fk\n-00005fa0: 6f5f 6e65 7728 2663 7478 293b 0a20 2020  o_new(&ctx);.   \n-00005fb0: 2020 202a 202e 2e2e 2063 6865 636b 2072     * ... check r\n-00005fc0: 6320 2e2e 2e0a 2020 2020 2020 2a20 7263  c ....      * rc\n-00005fd0: 203d 2066 6b6f 5f73 6574 5f73 7061 5f64   = fko_set_spa_d\n-00005fe0: 6174 6128 6374 782c 2073 7061 5f64 6174  ata(ctx, spa_dat\n-00005ff0: 6129 3b0a 2020 2020 2020 2a20 2e2e 2e0a  a);.      * ....\n-00006000: 2020 2020 202a 2f0a 0a20 2020 2020 2f2a       */..     /*\n-00006010: 2041 7373 756d 6520 7765 2063 616c 6c65   Assume we calle\n-00006020: 6420 6f74 6865 7220 636f 6465 2061 6e64  d other code and\n-00006030: 2066 756e 6374 696f 6e73 2e2e 2e20 202a   functions...  *\n-00006040: 2f0a 0a20 2020 2020 2f2a 2056 6572 6966  /..     /* Verif\n-00006050: 7920 484d 4143 0a20 2020 2020 2a2f 0a20  y HMAC.     */. \n-00006060: 2020 2020 7263 203d 2066 6b6f 5f76 6572      rc = fko_ver\n-00006070: 6966 795f 686d 6163 2863 7478 2c20 686d  ify_hmac(ctx, hm\n-00006080: 6163 5f6b 6579 2c20 686d 6163 5f6b 6579  ac_key, hmac_key\n-00006090: 5f6c 656e 293b 0a20 2020 2020 6966 2872  _len);.     if(r\n-000060a0: 6320 213d 2046 4b4f 5f53 5543 4345 5353  c != FKO_SUCCESS\n-000060b0: 290a 2020 2020 207b 0a20 2020 2020 2020  ).     {.       \n-000060c0: 2020 6670 7269 6e74 6628 7374 6465 7272    fprintf(stderr\n-000060d0: 2c20 2245 7272 6f72 2066 726f 6d20 666b  , \"Error from fk\n-000060e0: 6f5f 7665 7269 6679 5f68 6d61 633a 2025  o_verify_hmac: %\n-000060f0: 735c 6e22 2c0a 2020 2020 2020 2020 2020  s\\n\",.          \n-00006100: 2020 2066 6b6f 5f65 7272 7374 7228 7263     fko_errstr(rc\n-00006110: 2929 3b0a 2020 2020 2020 2020 2065 7869  ));.         exi\n-00006120: 7428 3129 3b0a 2020 2020 207d 0a0a 2020  t(1);.     }..  \n-00006130: 2020 202f 2a20 4465 6372 7970 7420 616e     /* Decrypt an\n-00006140: 6420 6465 636f 6465 2e2e 2e0a 2020 2020  d decode....    \n-00006150: 202a 2f0a 2020 2020 2072 6320 3d20 666b   */.     rc = fk\n-00006160: 6f5f 6465 6372 7970 745f 7370 615f 6461  o_decrypt_spa_da\n-00006170: 7461 2863 7478 2c20 6b65 792c 206b 6579  ta(ctx, key, key\n-00006180: 5f6c 656e 293b 0a0a 2020 2020 2069 6628  _len);..     if(\n-00006190: 7263 2021 3d20 464b 4f5f 5355 4343 4553  rc != FKO_SUCCES\n-000061a0: 5329 0a20 2020 2020 7b0a 2020 2020 2020  S).     {.      \n-000061b0: 2020 2066 7072 696e 7466 2873 7464 6572     fprintf(stder\n-000061c0: 722c 2022 4572 726f 7220 6672 6f6d 2066  r, \"Error from f\n-000061d0: 6b6f 5f64 6563 7279 7074 5f73 7061 5f64  ko_decrypt_spa_d\n-000061e0: 6174 613a 2025 735c 6e22 2c0a 2020 2020  ata: %s\\n\",.    \n-000061f0: 2020 2020 2020 2020 2066 6b6f 5f65 7272           fko_err\n-00006200: 7374 7228 7263 2929 3b0a 2020 2020 2020  str(rc));.      \n-00006210: 2020 2065 7869 7428 3129 3b0a 2020 2020     exit(1);.    \n-00006220: 207d 0a0a 1f0a 4669 6c65 3a20 6c69 6266   }....File: libf\n-00006230: 6b6f 2e69 6e66 6f2c 2020 4e6f 6465 3a20  ko.info,  Node: \n-00006240: 4465 7374 726f 7969 6e67 2043 6f6e 7465  Destroying Conte\n-00006250: 7874 732c 2020 4e65 7874 3a20 4372 6561  xts,  Next: Crea\n-00006260: 7469 6e67 2061 2053 5041 204d 6573 7361  ting a SPA Messa\n-00006270: 6765 2c20 2050 7265 763a 2043 7265 6174  ge,  Prev: Creat\n-00006280: 696e 6720 436f 6e74 6578 7473 2c20 2055  ing Contexts,  U\n-00006290: 703a 2055 7369 6e67 206c 6962 666b 6f0a  p: Using libfko.\n-000062a0: 0a33 2e32 2044 6573 7472 6f79 696e 6720  .3.2 Destroying \n-000062b0: 436f 6e74 6578 7473 0a3d 3d3d 3d3d 3d3d  Contexts.=======\n-000062c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================\n-000062d0: 0a0a 5768 656e 2079 6f75 2061 7265 2064  ..When you are d\n-000062e0: 6f6e 6520 7769 7468 2074 6865 2063 6f6e  one with the con\n-000062f0: 7465 7874 2c20 796f 7520 6d75 7374 2064  text, you must d\n-00006300: 6573 7472 6f79 2069 7420 696e 206f 7264  estroy it in ord\n-00006310: 6572 2074 6f20 6672 6565 0a75 7020 7468  er to free.up th\n-00006320: 6520 6d65 6d6f 7279 2061 6e64 2072 6573  e memory and res\n-00006330: 6f75 7263 6573 2069 7420 7761 7320 7573  ources it was us\n-00006340: 696e 672e 2020 5468 6973 2069 7320 6573  ing.  This is es\n-00006350: 7065 6369 616c 6c79 2069 6d70 6f72 7461  pecially importa\n-00006360: 6e74 0a69 6e20 7072 6f67 7261 6d73 2074  nt.in programs t\n-00006370: 6861 7420 7072 6f63 6573 7320 5350 4120  hat process SPA \n-00006380: 6461 7461 2072 6570 6561 7465 646c 7920  data repeatedly \n-00006390: 2869 2e65 2e20 2069 6e20 6120 6c6f 6f70  (i.e.  in a loop\n-000063a0: 292e 2020 4661 696c 7572 650a 746f 2064  ).  Failure.to d\n-000063b0: 6573 7472 6f79 2074 6865 2063 6f6e 7465  estroy the conte\n-000063c0: 7874 2063 616e 2063 6175 7365 206d 656d  xt can cause mem\n-000063d0: 6f72 7920 6c65 616b 7320 696e 2079 6f75  ory leaks in you\n-000063e0: 7220 7072 6f67 7261 6d2e 0a0a 202d 2d20  r program... -- \n-000063f0: 4675 6e63 7469 6f6e 3a20 766f 6964 2066  Function: void f\n-00006400: 6b6f 5f64 6573 7472 6f79 2028 666b 6f5f  ko_destroy (fko_\n-00006410: 6374 785f 7420 4354 5829 0a20 2020 2020  ctx_t CTX).     \n-00006420: 5468 6520 6675 6e63 7469 6f6e 2027 666b  The function 'fk\n-00006430: 6f5f 6465 7374 726f 7927 2064 6573 7472  o_destroy' destr\n-00006440: 6f79 7320 7468 6520 636f 6e74 6578 7420  oys the context \n-00006450: 7769 7468 2074 6865 2068 616e 646c 6520  with the handle \n-00006460: 4354 580a 2020 2020 2061 6e64 2072 656c  CTX.     and rel\n-00006470: 6561 7365 7320 616c 6c20 6173 736f 6369  eases all associ\n-00006480: 6174 6564 2072 6573 6f75 7263 6573 2e0a  ated resources..\n-00006490: 0a1f 0a46 696c 653a 206c 6962 666b 6f2e  ...File: libfko.\n-000064a0: 696e 666f 2c20 204e 6f64 653a 2043 7265  info,  Node: Cre\n-000064b0: 6174 696e 6720 6120 5350 4120 4d65 7373  ating a SPA Mess\n-000064c0: 6167 652c 2020 4e65 7874 3a20 5365 7474  age,  Next: Sett\n-000064d0: 696e 6720 5350 4120 4461 7461 2c20 2050  ing SPA Data,  P\n-000064e0: 7265 763a 2044 6573 7472 6f79 696e 6720  rev: Destroying \n-000064f0: 436f 6e74 6578 7473 2c20 2055 703a 2055  Contexts,  Up: U\n-00006500: 7369 6e67 206c 6962 666b 6f0a 0a33 2e33  sing libfko..3.3\n-00006510: 2043 7265 6174 696e 6720 6120 5350 4120   Creating a SPA \n-00006520: 4d65 7373 6167 650a 3d3d 3d3d 3d3d 3d3d  Message.========\n+00004f30: 0a0a 4265 666f 7265 2064 6f69 6e67 2061  ..Before doing a\n+00004f40: 6e79 7468 696e 6720 7769 7468 206c 6962  nything with lib\n+00004f50: 666b 6f2c 2079 6f75 206e 6565 6420 746f  fko, you need to\n+00004f60: 2063 7265 6174 6520 6120 636f 6e74 6578   create a contex\n+00004f70: 742e 2020 410a 636f 6e74 6578 7420 6973  t.  A.context is\n+00004f80: 2063 7265 6174 6564 2066 6f72 206f 6e65   created for one\n+00004f90: 206f 6620 7477 6f20 7265 6173 6f6e 732e   of two reasons.\n+00004fa0: 2020 4f6e 6520 6973 2066 6f72 2074 6865    One is for the\n+00004fb0: 2070 7572 706f 7365 206f 660a 6275 696c   purpose of.buil\n+00004fc0: 6469 6e67 2061 206e 6577 2066 6b6f 2053  ding a new fko S\n+00004fd0: 5041 206d 6573 7361 6765 2066 726f 6d20  PA message from \n+00004fe0: 7363 7261 7463 6820 2874 7970 6963 616c  scratch (typical\n+00004ff0: 6c79 2074 6f20 6265 2070 6163 6b61 6765  ly to be package\n+00005000: 640a 616e 6420 7365 6e74 2074 6f20 616e  d.and sent to an\n+00005010: 2066 776b 6e6f 7020 7365 7276 6572 2073   fwknop server s\n+00005020: 6f6d 6577 6865 7265 292e 2020 5468 6520  omewhere).  The \n+00005030: 6f74 6865 7220 776f 756c 6420 6265 2061  other would be a\n+00005040: 2063 6f6e 7465 7874 0a66 6f72 2074 616b   context.for tak\n+00005050: 696e 6720 616e 2065 7869 7374 696e 6720  ing an existing \n+00005060: 5350 4120 6d65 7373 6167 6520 666f 7220  SPA message for \n+00005070: 6465 636f 6469 6e67 2c20 7061 7273 696e  decoding, parsin\n+00005080: 672c 2061 6e64 2064 6174 610a 6578 7472  g, and data.extr\n+00005090: 6163 7469 6f6e 2e0a 0a46 6f72 2062 7569  action...For bui\n+000050a0: 6c64 696e 6720 6120 6e65 7720 666b 6f20  lding a new fko \n+000050b0: 5350 4120 6d65 7373 6167 652c 2079 6f75  SPA message, you\n+000050c0: 2077 696c 6c20 7573 6520 7468 6520 2766   will use the 'f\n+000050d0: 6b6f 5f6e 6577 2720 6675 6e63 7469 6f6e  ko_new' function\n+000050e0: 3a0a 0a20 2d2d 2046 756e 6374 696f 6e3a  :.. -- Function:\n+000050f0: 2069 6e74 2066 6b6f 5f6e 6577 2028 666b   int fko_new (fk\n+00005100: 6f5f 6374 785f 7420 2a43 5458 290a 2020  o_ctx_t *CTX).  \n+00005110: 2020 2054 6865 2066 756e 6374 696f 6e20     The function \n+00005120: 2766 6b6f 5f6e 6577 2720 7365 7473 2075  'fko_new' sets u\n+00005130: 7020 616e 6420 696e 6974 6961 6c69 7a65  p and initialize\n+00005140: 7320 6120 6e65 7720 2766 6b6f 5f63 7478  s a new 'fko_ctx\n+00005150: 5f74 270a 2020 2020 206f 626a 6563 742c  _t'.     object,\n+00005160: 2070 7265 2d70 6f70 756c 6174 6573 2064   pre-populates d\n+00005170: 6566 6175 6c74 2076 616c 7565 7320 616e  efault values an\n+00005180: 6420 7265 7475 726e 7320 6120 6861 6e64  d returns a hand\n+00005190: 6c65 2066 6f72 2069 7420 696e 0a20 2020  le for it in.   \n+000051a0: 2020 4354 582e 2020 5468 6520 6675 6e63    CTX.  The func\n+000051b0: 7469 6f6e 2072 6574 7572 6e73 2074 6865  tion returns the\n+000051c0: 2065 7272 6f72 2063 6f64 6520 2746 4b4f   error code 'FKO\n+000051d0: 5f53 5543 4345 5353 2720 6966 2074 6865  _SUCCESS' if the\n+000051e0: 0a20 2020 2020 636f 6e74 6578 7420 7761  .     context wa\n+000051f0: 7320 7375 6363 6573 7366 756c 6c79 2063  s successfully c\n+00005200: 7265 6174 6564 2e20 204f 7468 6572 7769  reated.  Otherwi\n+00005210: 7365 2061 6e20 616e 6f74 6865 7220 6572  se an another er\n+00005220: 726f 7220 636f 6465 0a20 2020 2020 7769  ror code.     wi\n+00005230: 6c6c 2062 6520 7265 7475 726e 6564 2028  ll be returned (\n+00005240: 2a6e 6f74 6520 4572 726f 7220 4861 6e64  *note Error Hand\n+00005250: 6c69 6e67 3a3a 2066 6f72 2064 6574 6169  ling:: for detai\n+00005260: 6c73 206f 6e20 7468 6520 7661 7269 6f75  ls on the variou\n+00005270: 730a 2020 2020 2065 7272 6f72 2063 6f64  s.     error cod\n+00005280: 6573 2061 6e64 2074 6865 6972 206d 6561  es and their mea\n+00005290: 6e69 6e67 7329 2e0a 0a20 2020 2020 666b  nings)...     fk\n+000052a0: 6f5f 6374 785f 7420 2020 6374 783b 0a20  o_ctx_t   ctx;. \n+000052b0: 2020 2020 696e 7420 2020 2020 2020 2020      int         \n+000052c0: 7263 3b0a 0a20 2020 2020 7263 203d 2066  rc;..     rc = f\n+000052d0: 6b6f 5f6e 6577 2826 6374 7829 3b0a 0a20  ko_new(&ctx);.. \n+000052e0: 2020 2020 6966 2872 6320 213d 2046 4b4f      if(rc != FKO\n+000052f0: 5f53 5543 4345 5353 290a 2020 2020 207b  _SUCCESS).     {\n+00005300: 0a20 2020 2020 2020 2020 6670 7269 6e74  .         fprint\n+00005310: 6628 7374 6465 7272 2c20 2245 7272 6f72  f(stderr, \"Error\n+00005320: 2025 6920 6672 6f6d 2066 6b6f 5f6e 6577   %i from fko_new\n+00005330: 3a20 2573 5c6e 222c 0a20 2020 2020 2020  : %s\\n\",.       \n+00005340: 2020 2020 2020 7263 2c20 666b 6f5f 6572        rc, fko_er\n+00005350: 7273 7472 2872 6329 293b 0a20 2020 2020  rstr(rc));.     \n+00005360: 2020 2020 6578 6974 2831 293b 0a20 2020      exit(1);.   \n+00005370: 2020 7d0a 0a46 6f72 2061 2063 6f6e 7465    }..For a conte\n+00005380: 7874 2074 6861 7420 7769 6c6c 2062 6520  xt that will be \n+00005390: 7573 6564 2066 6f72 2072 6563 6569 7669  used for receivi\n+000053a0: 6e67 2061 6e64 2070 6172 7369 6e67 2061  ng and parsing a\n+000053b0: 6e20 6578 6973 7469 6e67 0a53 5041 206d  n existing.SPA m\n+000053c0: 6573 7361 6765 2c20 796f 7520 7769 6c6c  essage, you will\n+000053d0: 2075 7365 2074 6865 2027 666b 6f5f 6e65   use the 'fko_ne\n+000053e0: 775f 7769 7468 5f64 6174 6127 2066 756e  w_with_data' fun\n+000053f0: 6374 696f 6e3a 0a0a 202d 2d20 4675 6e63  ction:.. -- Func\n+00005400: 7469 6f6e 3a20 696e 7420 666b 6f5f 6e65  tion: int fko_ne\n+00005410: 775f 7769 7468 5f64 6174 6120 2866 6b6f  w_with_data (fko\n+00005420: 5f63 7478 5f74 202a 4354 582c 2063 6f6e  _ctx_t *CTX, con\n+00005430: 7374 2063 6861 7220 2a44 4154 412c 0a20  st char *DATA,. \n+00005440: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c\n+00005450: 6861 7220 2a4b 4559 2c20 636f 6e73 7420  har *KEY, const \n+00005460: 6368 6172 204b 4559 5f4c 454e 2c20 696e  char KEY_LEN, in\n+00005470: 7420 454e 4352 5950 5449 4f4e 5f4d 4f44  t ENCRYPTION_MOD\n+00005480: 452c 0a20 2020 2020 2020 2020 2063 6f6e  E,.          con\n+00005490: 7374 2063 6861 7220 484d 4143 5f4b 4559  st char HMAC_KEY\n+000054a0: 2c20 636f 6e73 7420 696e 7420 484d 4143  , const int HMAC\n+000054b0: 5f54 5950 4529 0a0a 2020 2020 2054 6865  _TYPE)..     The\n+000054c0: 2066 756e 6374 696f 6e20 2766 6b6f 5f6e   function 'fko_n\n+000054d0: 6577 5f77 6974 685f 6461 7461 2720 7365  ew_with_data' se\n+000054e0: 7473 2075 7020 616e 6420 696e 6974 6961  ts up and initia\n+000054f0: 6c69 7a65 7320 6120 6e65 770a 2020 2020  lizes a new.    \n+00005500: 2027 666b 6f5f 6374 785f 7427 2063 6f6e   'fko_ctx_t' con\n+00005510: 7465 7874 2c20 6275 7420 696e 7374 6561  text, but instea\n+00005520: 6420 6f66 2069 6e69 7469 616c 697a 696e  d of initializin\n+00005530: 6720 6465 6661 756c 7420 7661 6c75 6573  g default values\n+00005540: 2c20 6974 0a20 2020 2020 7374 6f72 6573  , it.     stores\n+00005550: 2074 6865 2065 6e63 7279 7074 6564 206d   the encrypted m\n+00005560: 6573 7361 6765 2064 6174 6120 616e 6420  essage data and \n+00005570: 6d61 6b65 7320 6974 2072 6561 6479 2066  makes it ready f\n+00005580: 6f72 2070 6172 7369 6e67 2e0a 2020 2020  or parsing..    \n+00005590: 2054 6869 7320 6361 6e20 6265 2064 6f6e   This can be don\n+000055a0: 6520 696e 206f 6e65 206f 6620 7477 6f20  e in one of two \n+000055b0: 7761 7973 2e20 204f 6e65 2069 7320 746f  ways.  One is to\n+000055c0: 2070 6173 7320 274e 554c 4c27 2066 6f72   pass 'NULL' for\n+000055d0: 2074 6865 0a20 2020 2020 7468 6972 6420   the.     third \n+000055e0: 6172 6775 6d65 6e74 2e20 2054 6865 2063  argument.  The c\n+000055f0: 6f6e 7465 7874 2077 696c 6c20 6265 2063  ontext will be c\n+00005600: 7265 6174 6564 2061 6e64 2074 6865 2064  reated and the d\n+00005610: 6174 6120 7769 6c6c 2062 650a 2020 2020  ata will be.    \n+00005620: 2073 746f 7265 642c 2062 7574 206e 6f20   stored, but no \n+00005630: 6465 6372 7970 7469 6f6e 206f 7220 6465  decryption or de\n+00005640: 636f 6469 6e67 2074 616b 6573 2070 6c61  coding takes pla\n+00005650: 6365 2e20 2049 6e20 7468 6973 2063 6173  ce.  In this cas\n+00005660: 652c 0a20 2020 2020 796f 7520 7769 6c6c  e,.     you will\n+00005670: 206e 6565 6420 746f 2063 616c 6c20 2766   need to call 'f\n+00005680: 6b6f 5f64 6563 7279 7074 5f73 7061 5f64  ko_decrypt_spa_d\n+00005690: 6174 6127 2061 7420 6120 6c61 7465 7220  ata' at a later \n+000056a0: 7469 6d65 2e20 2054 6865 0a20 2020 2020  time.  The.     \n+000056b0: 6f74 6865 7220 7761 7920 746f 2064 6f20  other way to do \n+000056c0: 6974 2069 7320 746f 2073 7570 706c 7920  it is to supply \n+000056d0: 7468 6520 4b45 5920 7661 6c75 6520 2864  the KEY value (d\n+000056e0: 6563 7279 7074 696f 6e0a 2020 2020 2070  ecryption.     p\n+000056f0: 6173 7370 6872 6173 6529 2061 6e64 2061  assphrase) and a\n+00005700: 7373 6f63 6174 6564 206c 656e 6774 682e  ssocated length.\n+00005710: 2020 496e 2074 6869 7320 6361 7365 2c20    In this case, \n+00005720: 7468 6520 636f 6e74 6578 7420 6973 0a20  the context is. \n+00005730: 2020 2020 6372 6561 7465 642c 2074 6865      created, the\n+00005740: 2053 5041 2064 6174 6120 6973 2064 6563   SPA data is dec\n+00005750: 7279 7074 6564 2c20 6465 636f 6465 642c  rypted, decoded,\n+00005760: 2070 6172 7365 642c 2061 6e64 2073 746f   parsed, and sto\n+00005770: 7265 6420 696e 0a20 2020 2020 7468 6520  red in.     the \n+00005780: 636f 6e74 6578 7420 7265 6164 7920 666f  context ready fo\n+00005790: 7220 7265 7472 6965 7661 6c2e 2020 4966  r retrieval.  If\n+000057a0: 2061 6e20 484d 4143 2069 7320 616c 736f   an HMAC is also\n+000057b0: 2064 6573 6972 6564 206f 720a 2020 2020   desired or.    \n+000057c0: 2072 6571 7569 7265 642c 2074 6865 6e20   required, then \n+000057d0: 7468 6520 484d 4143 5f4b 4559 2061 6e64  the HMAC_KEY and\n+000057e0: 2061 7373 6f63 6961 7465 6420 6c65 6e67   associated leng\n+000057f0: 7468 2063 616e 2062 6520 7061 7373 6564  th can be passed\n+00005800: 2069 6e2e 0a20 2020 2020 5468 6973 2077   in..     This w\n+00005810: 696c 6c20 6361 7573 6520 6c69 6266 6b6f  ill cause libfko\n+00005820: 2074 6f20 6175 7468 656e 7469 6361 7465   to authenticate\n+00005830: 2074 6865 2053 5041 2064 6174 6120 6265   the SPA data be\n+00005840: 666f 7265 0a20 2020 2020 6465 6372 7970  fore.     decryp\n+00005850: 7469 6f6e 2069 7320 6174 7465 6d70 7465  tion is attempte\n+00005860: 642c 2061 6e64 2074 6869 7320 6973 2073  d, and this is s\n+00005870: 7472 6f6e 676c 7920 7265 636f 6d6d 656e  trongly recommen\n+00005880: 6465 6420 746f 2064 6f2e 0a0a 2020 2020  ded to do...    \n+00005890: 2054 6865 2027 666b 6f5f 6e65 775f 7769   The 'fko_new_wi\n+000058a0: 7468 5f64 6174 6127 2066 756e 6374 696f  th_data' functio\n+000058b0: 6e20 7265 7475 726e 7320 7468 6520 6572  n returns the er\n+000058c0: 726f 7220 636f 6465 0a20 2020 2020 2746  ror code.     'F\n+000058d0: 4b4f 5f53 5543 4345 5353 2720 6966 2074  KO_SUCCESS' if t\n+000058e0: 6865 2063 6f6e 7465 7874 2077 6173 2073  he context was s\n+000058f0: 7563 6365 7373 6675 6c6c 7920 6372 6561  uccessfully crea\n+00005900: 7465 642e 2020 4966 2061 6e79 206f 660a  ted.  If any of.\n+00005910: 2020 2020 2074 6865 2069 6e74 6572 6d65       the interme\n+00005920: 6469 6174 6520 7374 6570 7320 696e 2070  diate steps in p\n+00005930: 6172 7369 6e67 2074 6865 2064 6174 612c  arsing the data,\n+00005940: 2076 616c 6964 6174 696e 6720 7468 6520   validating the \n+00005950: 5350 410a 2020 2020 206d 6573 7361 6765  SPA.     message\n+00005960: 2064 6967 6573 742c 206f 7220 616e 7920   digest, or any \n+00005970: 6f74 6865 7220 696e 7465 726e 616c 2061  other internal a\n+00005980: 6374 696f 6e20 6661 696c 732c 2074 6865  ction fails, the\n+00005990: 6e20 7468 650a 2020 2020 2061 7070 726f  n the.     appro\n+000059a0: 7072 6961 7465 2065 7272 6f72 2063 6f64  priate error cod\n+000059b0: 6520 6973 2072 6574 7572 6e65 642e 0a0a  e is returned...\n+000059c0: 5468 6520 6d6f 7374 2063 6f6d 6d6f 6e20  The most common \n+000059d0: 2873 696d 706c 6529 2063 6173 652e 2e2e  (simple) case...\n+000059e0: 0a0a 2020 2020 2066 6b6f 5f63 7478 5f74  ..     fko_ctx_t\n+000059f0: 2020 2063 7478 3b0a 2020 2020 2063 6861     ctx;.     cha\n+00005a00: 7220 2020 2020 2020 2a73 7061 5f64 6174  r       *spa_dat\n+00005a10: 613b 0a20 2020 2020 6368 6172 2020 2020  a;.     char    \n+00005a20: 2020 202a 6b65 793b 0a20 2020 2020 696e     *key;.     in\n+00005a30: 7420 2020 2020 2020 2020 6b65 795f 6c65  t         key_le\n+00005a40: 6e3b 0a20 2020 2020 6368 6172 2020 2020  n;.     char    \n+00005a50: 2020 202a 686d 6163 5f6b 6579 3b0a 2020     *hmac_key;.  \n+00005a60: 2020 2069 6e74 2020 2020 2020 2020 2068     int         h\n+00005a70: 6d61 635f 6b65 795f 6c65 6e3b 0a20 2020  mac_key_len;.   \n+00005a80: 2020 696e 7420 2020 2020 2020 2020 686d    int         hm\n+00005a90: 6163 5f74 7970 6520 3d20 464b 4f5f 484d  ac_type = FKO_HM\n+00005aa0: 4143 5f53 4841 3235 363b 0a20 2020 2020  AC_SHA256;.     \n+00005ab0: 696e 7420 2020 2020 2020 2020 656e 635f  int         enc_\n+00005ac0: 6d6f 6465 2020 3d20 464b 4f5f 454e 435f  mode  = FKO_ENC_\n+00005ad0: 4d4f 4445 5f43 4243 3b0a 2020 2020 2069  MODE_CBC;.     i\n+00005ae0: 6e74 2072 633b 0a0a 2020 2020 202f 2a20  nt rc;..     /* \n+00005af0: 4173 7375 6d65 2077 6520 6361 6c6c 6564  Assume we called\n+00005b00: 2063 6f64 6520 7468 6174 2072 6574 7269   code that retri\n+00005b10: 6576 6573 2074 6865 2064 6174 6120 616e  eves the data an\n+00005b20: 6420 6b65 790a 2020 2020 202a 2f0a 0a20  d key.     */.. \n+00005b30: 2020 2020 7263 203d 2066 6b6f 5f6e 6577      rc = fko_new\n+00005b40: 5f77 6974 685f 6461 7461 2826 6374 782c  _with_data(&ctx,\n+00005b50: 2073 7061 5f64 6174 612c 206b 6579 2c20   spa_data, key, \n+00005b60: 6b65 795f 6c65 6e2c 205c 5c0a 2020 2020  key_len, \\\\.    \n+00005b70: 2020 2020 2065 6e63 5f6d 6f64 652c 2068       enc_mode, h\n+00005b80: 6d61 635f 6b65 792c 2068 6d61 635f 6b65  mac_key, hmac_ke\n+00005b90: 795f 6c65 6e2c 2068 6d61 635f 7479 7065  y_len, hmac_type\n+00005ba0: 293b 0a0a 2020 2020 2069 6628 7263 2021  );..     if(rc !\n+00005bb0: 3d20 464b 4f5f 5355 4343 4553 5329 0a20  = FKO_SUCCESS). \n+00005bc0: 2020 2020 7b0a 2020 2020 2020 2020 2066      {.         f\n+00005bd0: 7072 696e 7466 2873 7464 6572 722c 2022  printf(stderr, \"\n+00005be0: 4572 726f 7220 2569 2066 726f 6d20 666b  Error %i from fk\n+00005bf0: 6f5f 6e65 775f 7769 7468 5f64 6174 613a  o_new_with_data:\n+00005c00: 2025 735c 6e22 2c0a 2020 2020 2020 2020   %s\\n\",.        \n+00005c10: 2020 2020 2072 632c 2066 6b6f 6572 7273       rc, fkoerrs\n+00005c20: 7472 2872 6329 293b 0a20 2020 2020 2020  tr(rc));.       \n+00005c30: 2020 6578 6974 2831 293b 0a20 2020 2020    exit(1);.     \n+00005c40: 7d0a 0a4f 722c 2070 6572 6861 7073 2079  }..Or, perhaps y\n+00005c50: 6f75 206e 6565 6420 746f 2064 6566 6572  ou need to defer\n+00005c60: 2064 6563 7279 7074 696f 6e20 616e 6420   decryption and \n+00005c70: 7061 7273 696e 6720 746f 2061 206c 6174  parsing to a lat\n+00005c80: 6572 2070 6f69 6e74 2069 6e0a 7468 6520  er point in.the \n+00005c90: 7072 6f67 7261 6d2e 2020 5765 2063 6f75  program.  We cou\n+00005ca0: 6c64 2075 7365 2066 6b6f 5f6e 6577 5f77  ld use fko_new_w\n+00005cb0: 6974 685f 6461 7461 2829 2c20 7061 7373  ith_data(), pass\n+00005cc0: 696e 6720 4e55 4c4c 2066 6f72 2074 6865  ing NULL for the\n+00005cd0: 0a64 6563 7279 7074 696f 6e20 6b65 7920  .decryption key \n+00005ce0: 616e 6420 484d 4143 206b 6579 732c 206f  and HMAC keys, o\n+00005cf0: 7220 7765 2063 6f75 6c64 2075 7365 2066  r we could use f\n+00005d00: 6b6f 5f6e 6577 2829 2074 6f20 6372 6561  ko_new() to crea\n+00005d10: 7465 2061 6e0a 656d 7074 7920 636f 6e74  te an.empty cont\n+00005d20: 6578 742c 2074 6865 6e20 7573 6520 666b  ext, then use fk\n+00005d30: 6f5f 7365 745f 7370 615f 6461 7461 2829  o_set_spa_data()\n+00005d40: 2074 6f20 6164 6420 7468 6520 656e 6379   to add the ency\n+00005d50: 7074 6564 2064 6174 6120 2873 6565 0a63  pted data (see.c\n+00005d60: 6f6d 6d65 6e74 7320 696e 2074 6865 2063  omments in the c\n+00005d70: 6f64 6520 7361 6d70 6c65 7329 2e0a 0a20  ode samples)... \n+00005d80: 2020 2020 666b 6f5f 6374 785f 7420 2020      fko_ctx_t   \n+00005d90: 6374 783b 0a20 2020 2020 6368 6172 2020  ctx;.     char  \n+00005da0: 2020 2020 202a 7370 615f 6461 7461 3b0a       *spa_data;.\n+00005db0: 2020 2020 2063 6861 7220 2020 2020 2020       char       \n+00005dc0: 2a6b 6579 3b0a 2020 2020 2069 6e74 2072  *key;.     int r\n+00005dd0: 633b 0a0a 2020 2020 202f 2a20 4173 7375  c;..     /* Assu\n+00005de0: 6d65 2077 6520 6361 6c6c 6564 2063 6f64  me we called cod\n+00005df0: 6520 7468 6174 2072 6574 7269 6576 6573  e that retrieves\n+00005e00: 2074 6865 2064 6174 6120 616e 6420 6b65   the data and ke\n+00005e10: 790a 2020 2020 202a 2f0a 0a20 2020 2020  y.     */..     \n+00005e20: 7263 203d 2066 6b6f 5f6e 6577 5f77 6974  rc = fko_new_wit\n+00005e30: 685f 6461 7461 2826 6374 782c 2073 7061  h_data(&ctx, spa\n+00005e40: 5f64 6174 612c 204e 554c 4c2c 2030 2c0a  _data, NULL, 0,.\n+00005e50: 2020 2020 2020 2020 2020 2020 2046 4b4f               FKO\n+00005e60: 5f45 4e43 5f4d 4f44 455f 4342 432c 204e  _ENC_MODE_CBC, N\n+00005e70: 554c 4c2c 2030 2c20 464b 4f5f 484d 4143  ULL, 0, FKO_HMAC\n+00005e80: 5f53 4841 3235 3629 3b0a 0a20 2020 2020  _SHA256);..     \n+00005e90: 6966 2872 6320 213d 2046 4b4f 5f53 5543  if(rc != FKO_SUC\n+00005ea0: 4345 5353 290a 2020 2020 207b 0a20 2020  CESS).     {.   \n+00005eb0: 2020 2020 2020 6670 7269 6e74 6628 7374        fprintf(st\n+00005ec0: 6465 7272 2c20 2245 7272 6f72 2066 726f  derr, \"Error fro\n+00005ed0: 6d20 666b 6f5f 6e65 775f 7769 7468 5f64  m fko_new_with_d\n+00005ee0: 6174 613a 2025 735c 6e22 2c0a 2020 2020  ata: %s\\n\",.    \n+00005ef0: 2020 2020 2020 2020 2066 6b6f 5f65 7272           fko_err\n+00005f00: 7374 7228 7263 2929 3b0a 2020 2020 2020  str(rc));.      \n+00005f10: 2020 2065 7869 7428 3129 3b0a 2020 2020     exit(1);.    \n+00005f20: 207d 0a0a 2020 2020 202f 2a20 5765 2063   }..     /* We c\n+00005f30: 6f75 6c64 2061 6c73 6f20 6a75 7374 2063  ould also just c\n+00005f40: 7265 6174 6520 616e 6420 656d 7074 7920  reate and empty \n+00005f50: 636f 6e74 6578 7420 616e 6420 6164 6420  context and add \n+00005f60: 7468 650a 2020 2020 2020 2a20 656e 6372  the.      * encr\n+00005f70: 7970 7465 6420 6461 7461 2061 7320 666f  ypted data as fo\n+00005f80: 6c6c 6f77 733a 0a20 2020 2020 202a 0a20  llows:.      *. \n+00005f90: 2020 2020 202a 2072 6320 3d20 666b 6f5f       * rc = fko_\n+00005fa0: 6e65 7728 2663 7478 293b 0a20 2020 2020  new(&ctx);.     \n+00005fb0: 202a 202e 2e2e 2063 6865 636b 2072 6320   * ... check rc \n+00005fc0: 2e2e 2e0a 2020 2020 2020 2a20 7263 203d  ....      * rc =\n+00005fd0: 2066 6b6f 5f73 6574 5f73 7061 5f64 6174   fko_set_spa_dat\n+00005fe0: 6128 6374 782c 2073 7061 5f64 6174 6129  a(ctx, spa_data)\n+00005ff0: 3b0a 2020 2020 2020 2a20 2e2e 2e0a 2020  ;.      * ....  \n+00006000: 2020 202a 2f0a 0a20 2020 2020 2f2a 2041     */..     /* A\n+00006010: 7373 756d 6520 7765 2063 616c 6c65 6420  ssume we called \n+00006020: 6f74 6865 7220 636f 6465 2061 6e64 2066  other code and f\n+00006030: 756e 6374 696f 6e73 2e2e 2e20 202a 2f0a  unctions...  */.\n+00006040: 0a20 2020 2020 2f2a 2056 6572 6966 7920  .     /* Verify \n+00006050: 484d 4143 0a20 2020 2020 2a2f 0a20 2020  HMAC.     */.   \n+00006060: 2020 7263 203d 2066 6b6f 5f76 6572 6966    rc = fko_verif\n+00006070: 795f 686d 6163 2863 7478 2c20 686d 6163  y_hmac(ctx, hmac\n+00006080: 5f6b 6579 2c20 686d 6163 5f6b 6579 5f6c  _key, hmac_key_l\n+00006090: 656e 293b 0a20 2020 2020 6966 2872 6320  en);.     if(rc \n+000060a0: 213d 2046 4b4f 5f53 5543 4345 5353 290a  != FKO_SUCCESS).\n+000060b0: 2020 2020 207b 0a20 2020 2020 2020 2020       {.         \n+000060c0: 6670 7269 6e74 6628 7374 6465 7272 2c20  fprintf(stderr, \n+000060d0: 2245 7272 6f72 2066 726f 6d20 666b 6f5f  \"Error from fko_\n+000060e0: 7665 7269 6679 5f68 6d61 633a 2025 735c  verify_hmac: %s\\\n+000060f0: 6e22 2c0a 2020 2020 2020 2020 2020 2020  n\",.            \n+00006100: 2066 6b6f 5f65 7272 7374 7228 7263 2929   fko_errstr(rc))\n+00006110: 3b0a 2020 2020 2020 2020 2065 7869 7428  ;.         exit(\n+00006120: 3129 3b0a 2020 2020 207d 0a0a 2020 2020  1);.     }..    \n+00006130: 202f 2a20 4465 6372 7970 7420 616e 6420   /* Decrypt and \n+00006140: 6465 636f 6465 2e2e 2e0a 2020 2020 202a  decode....     *\n+00006150: 2f0a 2020 2020 2072 6320 3d20 666b 6f5f  /.     rc = fko_\n+00006160: 6465 6372 7970 745f 7370 615f 6461 7461  decrypt_spa_data\n+00006170: 2863 7478 2c20 6b65 792c 206b 6579 5f6c  (ctx, key, key_l\n+00006180: 656e 293b 0a0a 2020 2020 2069 6628 7263  en);..     if(rc\n+00006190: 2021 3d20 464b 4f5f 5355 4343 4553 5329   != FKO_SUCCESS)\n+000061a0: 0a20 2020 2020 7b0a 2020 2020 2020 2020  .     {.        \n+000061b0: 2066 7072 696e 7466 2873 7464 6572 722c   fprintf(stderr,\n+000061c0: 2022 4572 726f 7220 6672 6f6d 2066 6b6f   \"Error from fko\n+000061d0: 5f64 6563 7279 7074 5f73 7061 5f64 6174  _decrypt_spa_dat\n+000061e0: 613a 2025 735c 6e22 2c0a 2020 2020 2020  a: %s\\n\",.      \n+000061f0: 2020 2020 2020 2066 6b6f 5f65 7272 7374         fko_errst\n+00006200: 7228 7263 2929 3b0a 2020 2020 2020 2020  r(rc));.        \n+00006210: 2065 7869 7428 3129 3b0a 2020 2020 207d   exit(1);.     }\n+00006220: 0a0a 1f0a 4669 6c65 3a20 6c69 6266 6b6f  ....File: libfko\n+00006230: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4465  .info,  Node: De\n+00006240: 7374 726f 7969 6e67 2043 6f6e 7465 7874  stroying Context\n+00006250: 732c 2020 4e65 7874 3a20 4372 6561 7469  s,  Next: Creati\n+00006260: 6e67 2061 2053 5041 204d 6573 7361 6765  ng a SPA Message\n+00006270: 2c20 2050 7265 763a 2043 7265 6174 696e  ,  Prev: Creatin\n+00006280: 6720 436f 6e74 6578 7473 2c20 2055 703a  g Contexts,  Up:\n+00006290: 2055 7369 6e67 206c 6962 666b 6f0a 0a33   Using libfko..3\n+000062a0: 2e32 2044 6573 7472 6f79 696e 6720 436f  .2 Destroying Co\n+000062b0: 6e74 6578 7473 0a3d 3d3d 3d3d 3d3d 3d3d  ntexts.=========\n+000062c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a  ==============..\n+000062d0: 5768 656e 2079 6f75 2061 7265 2064 6f6e  When you are don\n+000062e0: 6520 7769 7468 2074 6865 2063 6f6e 7465  e with the conte\n+000062f0: 7874 2c20 796f 7520 6d75 7374 2064 6573  xt, you must des\n+00006300: 7472 6f79 2069 7420 696e 206f 7264 6572  troy it in order\n+00006310: 2074 6f20 6672 6565 0a75 7020 7468 6520   to free.up the \n+00006320: 6d65 6d6f 7279 2061 6e64 2072 6573 6f75  memory and resou\n+00006330: 7263 6573 2069 7420 7761 7320 7573 696e  rces it was usin\n+00006340: 672e 2020 5468 6973 2069 7320 6573 7065  g.  This is espe\n+00006350: 6369 616c 6c79 2069 6d70 6f72 7461 6e74  cially important\n+00006360: 0a69 6e20 7072 6f67 7261 6d73 2074 6861  .in programs tha\n+00006370: 7420 7072 6f63 6573 7320 5350 4120 6461  t process SPA da\n+00006380: 7461 2072 6570 6561 7465 646c 7920 2869  ta repeatedly (i\n+00006390: 2e65 2e20 2069 6e20 6120 6c6f 6f70 292e  .e.  in a loop).\n+000063a0: 2020 4661 696c 7572 650a 746f 2064 6573    Failure.to des\n+000063b0: 7472 6f79 2074 6865 2063 6f6e 7465 7874  troy the context\n+000063c0: 2063 616e 2063 6175 7365 206d 656d 6f72   can cause memor\n+000063d0: 7920 6c65 616b 7320 696e 2079 6f75 7220  y leaks in your \n+000063e0: 7072 6f67 7261 6d2e 0a0a 202d 2d20 4675  program... -- Fu\n+000063f0: 6e63 7469 6f6e 3a20 766f 6964 2066 6b6f  nction: void fko\n+00006400: 5f64 6573 7472 6f79 2028 666b 6f5f 6374  _destroy (fko_ct\n+00006410: 785f 7420 4354 5829 0a20 2020 2020 5468  x_t CTX).     Th\n+00006420: 6520 6675 6e63 7469 6f6e 2027 666b 6f5f  e function 'fko_\n+00006430: 6465 7374 726f 7927 2064 6573 7472 6f79  destroy' destroy\n+00006440: 7320 7468 6520 636f 6e74 6578 7420 7769  s the context wi\n+00006450: 7468 2074 6865 2068 616e 646c 6520 4354  th the handle CT\n+00006460: 580a 2020 2020 2061 6e64 2072 656c 6561  X.     and relea\n+00006470: 7365 7320 616c 6c20 6173 736f 6369 6174  ses all associat\n+00006480: 6564 2072 6573 6f75 7263 6573 2e0a 0a1f  ed resources....\n+00006490: 0a46 696c 653a 206c 6962 666b 6f2e 696e  .File: libfko.in\n+000064a0: 666f 2c20 204e 6f64 653a 2043 7265 6174  fo,  Node: Creat\n+000064b0: 696e 6720 6120 5350 4120 4d65 7373 6167  ing a SPA Messag\n+000064c0: 652c 2020 4e65 7874 3a20 5365 7474 696e  e,  Next: Settin\n+000064d0: 6720 5350 4120 4461 7461 2c20 2050 7265  g SPA Data,  Pre\n+000064e0: 763a 2044 6573 7472 6f79 696e 6720 436f  v: Destroying Co\n+000064f0: 6e74 6578 7473 2c20 2055 703a 2055 7369  ntexts,  Up: Usi\n+00006500: 6e67 206c 6962 666b 6f0a 0a33 2e33 2043  ng libfko..3.3 C\n+00006510: 7265 6174 696e 6720 6120 5350 4120 4d65  reating a SPA Me\n+00006520: 7373 6167 650a 3d3d 3d3d 3d3d 3d3d 3d3d  ssage.==========\n 00006530: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================\n-00006540: 3d3d 0a0a 5468 6973 2073 6563 7469 6f6e  ==..This section\n-00006550: 2064 6573 6372 6962 6573 2074 6865 2070   describes the p\n-00006560: 726f 6365 7373 2066 6f72 2063 7265 6174  rocess for creat\n-00006570: 696e 6720 6120 6e65 7720 666b 6f20 5350  ing a new fko SP\n-00006580: 4120 6d65 7373 6167 652e 0a41 6674 6572  A message..After\n-00006590: 2063 7265 6174 696e 6720 6120 636f 6e74   creating a cont\n-000065a0: 6578 742c 2074 6865 7265 2061 7265 2073  ext, there are s\n-000065b0: 7469 6c6c 2073 6f6d 6520 7265 7175 6973  till some requis\n-000065c0: 6974 6520 5350 4120 6461 7461 2066 6965  ite SPA data fie\n-000065d0: 6c64 730a 616e 6420 5350 4120 7061 7261  lds.and SPA para\n-000065e0: 6d65 7465 7273 2074 6861 7420 6e65 6564  meters that need\n-000065f0: 2074 6f20 6265 2073 6574 2062 6566 6f72   to be set befor\n-00006600: 6520 7468 6520 6669 6e61 6c20 656e 6372  e the final encr\n-00006610: 7970 7465 640a 6d65 7373 6167 6520 6973  ypted.message is\n-00006620: 2072 6561 6479 2e0a 0a20 2020 5468 6520   ready...   The \n-00006630: 666f 6c6c 6f77 696e 6720 6c69 7374 2063  following list c\n-00006640: 6f6e 7461 696e 7320 7468 6520 6d69 6e69  ontains the mini\n-00006650: 6d75 6d20 7265 7175 6972 6564 2066 6965  mum required fie\n-00006660: 6c64 7320 666f 7220 610a 636f 6d70 6c65  lds for a.comple\n-00006670: 7465 2066 6b6f 2053 5041 206d 6573 7361  te fko SPA messa\n-00006680: 6765 2e20 2059 6f75 2073 686f 756c 6420  ge.  You should \n-00006690: 616c 736f 2074 616b 6520 6e6f 7465 206f  also take note o\n-000066a0: 6620 7468 6520 6f72 6465 7220 6f66 0a74  f the order of.t\n-000066b0: 6865 7365 2070 6172 616d 6574 6572 7320  hese parameters \n-000066c0: 6173 2077 656c 6c2e 2020 5365 7474 696e  as well.  Settin\n-000066d0: 6720 7468 6520 2274 7970 6522 2070 6172  g the \"type\" par\n-000066e0: 616d 6574 6572 7320 6669 7273 7420 6973  ameters first is\n-000066f0: 0a72 6563 6f6d 6d65 6e64 6564 2028 6966  .recommended (if\n-00006700: 2079 6f75 2077 616e 7420 6120 7479 7065   you want a type\n-00006710: 206f 7468 6572 2074 6861 6e20 7468 6520   other than the \n-00006720: 6465 6661 756c 7429 2e0a 0a20 2020 2a20  default)...   * \n-00006730: 6469 6765 7374 5f74 7970 6520 2d20 5f28  digest_type - _(\n-00006740: 6465 6661 756c 7420 6d61 7920 7375 6666  default may suff\n-00006750: 6963 6529 5f0a 2020 202a 206d 6573 7361  ice)_.   * messa\n-00006760: 6765 5f74 7970 6520 2d20 5f28 6465 6661  ge_type - _(defa\n-00006770: 756c 7420 6d61 7920 7375 6666 6963 6529  ult may suffice)\n-00006780: 5f0a 2020 202a 2065 6e63 7279 7074 696f  _.   * encryptio\n-00006790: 6e5f 7479 7065 202d 205f 2864 6566 6175  n_type - _(defau\n-000067a0: 6c74 206d 6179 2073 7566 6669 6365 295f  lt may suffice)_\n-000067b0: 0a20 2020 2a20 7261 6e64 5f76 616c 202d  .   * rand_val -\n-000067c0: 205f 2864 6566 6175 6c74 2073 686f 756c   _(default shoul\n-000067d0: 6420 7375 6666 6963 6529 5f0a 2020 202a  d suffice)_.   *\n-000067e0: 2074 696d 655f 7374 616d 7020 2d20 5f28   time_stamp - _(\n-000067f0: 6465 6661 756c 7420 7368 6f75 6c64 2073  default should s\n-00006800: 7566 6669 6365 295f 0a20 2020 2a20 7573  uffice)_.   * us\n-00006810: 6572 6e61 6d65 202d 205f 2864 6566 6175  ername - _(defau\n-00006820: 6c74 206d 6179 2073 7566 6669 6365 295f  lt may suffice)_\n-00006830: 0a20 2020 2a20 7370 615f 6d65 7373 6167  .   * spa_messag\n-00006840: 6520 2d20 5f28 6d75 7374 2062 6520 6578  e - _(must be ex\n-00006850: 706c 6963 6974 6c79 2073 6574 295f 0a0a  plicitly set)_..\n-00006860: 5f49 6620 7573 696e 6720 6770 6720 656e  _If using gpg en\n-00006870: 6372 7970 7469 6f6e 3a5f 0a0a 2020 202a  cryption:_..   *\n-00006880: 2067 7067 5f72 6563 6970 6965 6e74 202d   gpg_recipient -\n-00006890: 205f 286d 7573 7420 6265 2065 7870 6c69   _(must be expli\n-000068a0: 6369 746c 7920 7365 7429 5f0a 2020 202a  citly set)_.   *\n-000068b0: 2067 7067 5f73 6967 6e65 7220 2d20 5f28   gpg_signer - _(\n-000068c0: 6f70 7469 6f6e 616c 2c20 6275 7420 7265  optional, but re\n-000068d0: 636f 6d6d 656e 6465 6420 2d20 6d75 7374  commended - must\n-000068e0: 2062 6520 6578 706c 6963 6974 6c79 2073   be explicitly s\n-000068f0: 6574 0a20 2020 2020 6966 2075 7365 6429  et.     if used)\n-00006900: 5f0a 2020 202a 2067 7067 5f68 6f6d 655f  _.   * gpg_home_\n-00006910: 6469 7220 2d20 5f28 6465 6661 756c 7420  dir - _(default \n-00006920: 6d61 7920 7375 6666 6963 6520 2d20 7479  may suffice - ty\n-00006930: 7069 6361 6c6c 7920 2448 4f4d 452f 2e67  pically $HOME/.g\n-00006940: 6e75 7067 295f 0a0a 2020 2057 6865 6e20  nupg)_..   When \n-00006950: 6120 636f 6e74 6578 7420 6973 2069 6e69  a context is ini\n-00006960: 7469 616c 697a 6564 2c20 736f 6d65 206f  tialized, some o\n-00006970: 6620 7468 6520 5350 4120 6461 7461 2066  f the SPA data f\n-00006980: 6965 6c64 7320 6172 650a 7072 652d 7365  ields are.pre-se\n-00006990: 7420 7769 7468 2064 6566 6175 6c74 2076  t with default v\n-000069a0: 616c 7565 7320 282a 6e6f 7465 2053 5041  alues (*note SPA\n-000069b0: 2044 6174 6120 466f 726d 6174 3a3a 292e   Data Format::).\n-000069c0: 2020 466f 7220 6669 656c 6473 2073 7563    For fields suc\n-000069d0: 680a 6173 2027 7261 6e64 5f76 616c 272c  h.as 'rand_val',\n-000069e0: 2027 7573 6572 6e61 6d65 272c 2027 7469   'username', 'ti\n-000069f0: 6d65 7374 616d 7027 2c20 276d 6573 7361  mestamp', 'messa\n-00006a00: 6765 5f74 7970 6527 2c20 616e 640a 2764  ge_type', and.'d\n-00006a10: 6967 6573 745f 7479 7065 272c 2074 6865  igest_type', the\n-00006a20: 7365 2064 6566 6175 6c74 7320 6d61 7920  se defaults may \n-00006a30: 6265 2073 7566 6669 6369 656e 742e 0a0a  be sufficient...\n-00006a40: 2020 2054 6865 2066 756e 6374 696f 6e73     The functions\n-00006a50: 2075 7365 6420 746f 2073 6574 2074 6865   used to set the\n-00006a60: 2076 6172 696f 7573 2053 5041 2064 6174   various SPA dat\n-00006a70: 6120 6669 656c 6473 2061 6e64 2070 6172  a fields and par\n-00006a80: 616d 6574 6572 730a 6172 6520 6465 7363  ameters.are desc\n-00006a90: 7269 6265 6420 696e 2064 6574 6169 6c20  ribed in detail \n-00006aa0: 696e 202a 6e6f 7465 2053 6574 7469 6e67  in *note Setting\n-00006ab0: 2053 5041 2044 6174 613a 3a2e 0a0a 2a4e   SPA Data::...*N\n-00006ac0: 6f74 652a 3a20 4174 7465 6d70 7473 2074  ote*: Attempts t\n-00006ad0: 6f20 6361 6c6c 2061 6e79 2022 2766 6b6f  o call any \"'fko\n-00006ae0: 5f27 2220 6675 6e63 7469 6f6e 206f 6e20  _'\" function on \n-00006af0: 6120 636f 6e74 6578 7420 7468 6174 2068  a context that h\n-00006b00: 6173 206e 6f74 0a62 6565 6e20 696e 6974  as not.been init\n-00006b10: 6961 6c69 7a65 6420 6361 6e20 6861 7665  ialized can have\n-00006b20: 2075 6e64 6566 696e 6564 2063 6f6e 7365   undefined conse\n-00006b30: 7175 656e 6365 732e 2020 4c69 6266 6b6f  quences.  Libfko\n-00006b40: 2077 696c 6c20 6174 7465 6d70 740a 746f   will attempt.to\n-00006b50: 2072 6563 6f76 6572 2c20 616e 6420 6966   recover, and if\n-00006b60: 2073 7563 6365 7373 6675 6c2c 2077 696c   successful, wil\n-00006b70: 6c20 7265 7475 726e 2061 2073 7461 7475  l return a statu\n-00006b80: 7320 6f66 0a27 464b 4f5f 4552 524f 525f  s of.'FKO_ERROR_\n-00006b90: 4354 585f 4e4f 545f 494e 4954 4941 4c49  CTX_NOT_INITIALI\n-00006ba0: 5a45 4427 2e0a 0a20 2020 4120 636f 6d6d  ZED'...   A comm\n-00006bb0: 6f6e 2053 5041 206d 6573 7361 6765 2069  on SPA message i\n-00006bc0: 7320 6120 7369 6d70 6c65 2061 6363 6573  s a simple acces\n-00006bd0: 7320 7265 7175 6573 742e 2020 5468 6973  s request.  This\n-00006be0: 2072 6571 7565 7374 2061 736b 730a 7468   request asks.th\n-00006bf0: 6520 6677 6b6e 6f70 2073 6572 7665 7220  e fwknop server \n-00006c00: 746f 2063 7265 6174 6520 6120 7465 6d70  to create a temp\n-00006c10: 6f72 6172 7920 6669 7265 7761 6c6c 2072  orary firewall r\n-00006c20: 756c 6520 746f 2061 6c6c 6f77 2061 0a70  ule to allow a.p\n-00006c30: 6172 7469 6375 6c61 7220 4950 2061 6464  articular IP add\n-00006c40: 7265 7373 2061 6363 6573 7320 746f 2061  ress access to a\n-00006c50: 2070 6172 7469 6375 6c61 7220 706f 7274   particular port\n-00006c60: 206f 6e20 7468 6520 6677 6b6e 6f70 2073   on the fwknop s\n-00006c70: 6572 7665 722e 0a41 7373 756d 696e 6720  erver..Assuming \n-00006c80: 7468 6520 6465 6661 756c 7473 2061 7265  the defaults are\n-00006c90: 2066 696e 6520 666f 7220 7468 6973 2c20   fine for this, \n-00006ca0: 616c 6c20 7765 206e 6565 6420 746f 2064  all we need to d\n-00006cb0: 6f20 6973 2063 7265 6174 6520 7468 650a  o is create the.\n-00006cc0: 636f 6e74 6578 742c 2073 6574 2074 6865  context, set the\n-00006cd0: 206d 6573 7361 6765 2064 6174 6120 6669   message data fi\n-00006ce0: 656c 642c 2063 616c 6c20 7468 6520 2766  eld, call the 'f\n-00006cf0: 6b6f 5f73 7061 5f64 6174 615f 6669 6e61  ko_spa_data_fina\n-00006d00: 6c27 0a66 756e 6374 696f 6e20 746f 2065  l'.function to e\n-00006d10: 6e63 6f64 6520 616e 6420 656e 6372 7970  ncode and encryp\n-00006d20: 742c 2070 726f 6365 7373 2074 6865 206d  t, process the m\n-00006d30: 6573 7361 6765 2c20 7468 656e 2064 6573  essage, then des\n-00006d40: 7472 6f79 2074 6865 0a63 6f6e 7465 7874  troy the.context\n-00006d50: 2e20 2042 656c 6f77 2c20 7765 2068 6176  .  Below, we hav\n-00006d60: 6520 6120 636f 6e74 7269 7665 6420 6269  e a contrived bi\n-00006d70: 7420 6f66 2063 6f64 6520 6465 6d6f 6e73  t of code demons\n-00006d80: 7472 6174 696e 6720 7468 6973 3a0a 0a20  trating this:.. \n-00006d90: 2020 2020 696e 740a 2020 2020 206d 6169      int.     mai\n-00006da0: 6e28 696e 7420 6172 6763 2c20 6368 6172  n(int argc, char\n-00006db0: 202a 2a61 7267 7629 0a20 2020 2020 7b0a   **argv).     {.\n-00006dc0: 2020 2020 2020 2020 2066 6b6f 5f63 7478           fko_ctx\n-00006dd0: 5f74 2020 2063 7478 3b20 2020 2020 2020  _t   ctx;       \n-00006de0: 2020 2020 2f2a 2046 4b4f 2043 6f6e 7465      /* FKO Conte\n-00006df0: 7874 202a 2f0a 2020 2020 2020 2020 2063  xt */.         c\n-00006e00: 6861 7220 2020 2020 2020 2a6b 6579 3b20  har       *key; \n-00006e10: 2020 2020 2020 2020 2020 2f2a 2045 6e63            /* Enc\n-00006e20: 7279 7074 696f 6e20 7061 7373 7068 7261  ryption passphra\n-00006e30: 7365 202a 2f0a 2020 2020 2020 2020 2063  se */.         c\n-00006e40: 6861 7220 2020 2020 2020 2a68 6d61 635f  har       *hmac_\n-00006e50: 6b65 793b 2020 2020 2020 2f2a 2048 4d41  key;      /* HMA\n-00006e60: 4320 6b65 7920 2a2f 0a20 2020 2020 2020  C key */.       \n-00006e70: 2020 6368 6172 2020 2020 2020 202a 6669    char       *fi\n-00006e80: 6e61 6c5f 7370 613b 2020 2020 202f 2a20  nal_spa;     /* \n-00006e90: 4669 6e61 6c20 656e 6372 7970 7465 6420  Final encrypted \n-00006ea0: 5350 4120 6461 7461 202a 2f0a 2020 2020  SPA data */.    \n-00006eb0: 2020 2020 2069 6e74 2020 2020 2020 2020       int        \n-00006ec0: 206b 6579 5f6c 656e 3b20 2020 2020 2020   key_len;       \n-00006ed0: 2f2a 204c 656e 6774 6820 6f66 2065 6e63  /* Length of enc\n-00006ee0: 7279 7074 696f 6e20 6b65 7920 2a2f 0a20  ryption key */. \n-00006ef0: 2020 2020 2020 2020 696e 7420 2020 2020          int     \n-00006f00: 2020 2020 686d 6163 5f6b 6579 5f6c 656e      hmac_key_len\n-00006f10: 3b20 202f 2a20 4c65 6e67 7468 206f 6620  ;  /* Length of \n-00006f20: 484d 4143 206b 6579 202a 2f0a 2020 2020  HMAC key */.    \n-00006f30: 2020 2020 2069 6e74 2020 2020 2020 2020       int        \n-00006f40: 2072 633b 2020 2020 2020 2020 2020 2020   rc;            \n-00006f50: 2f2a 2052 6573 756c 7420 636f 6465 202a  /* Result code *\n-00006f60: 2f0a 2020 2020 2020 2020 2069 6e74 2020  /.         int  \n-00006f70: 2020 2020 2020 2068 6d61 635f 7479 7065         hmac_type\n-00006f80: 203d 2046 4b4f 5f48 4d41 435f 5348 4132   = FKO_HMAC_SHA2\n-00006f90: 3536 3b20 2020 2f2a 2044 6566 6175 6c74  56;   /* Default\n-00006fa0: 2048 4d41 4320 6469 6765 7374 202a 2f0a   HMAC digest */.\n-00006fb0: 2020 2020 2020 2020 2069 6e74 2020 2020           int    \n-00006fc0: 2020 2020 2065 6e63 5f6d 6f64 6520 203d       enc_mode  =\n-00006fd0: 2046 4b4f 5f45 4e43 5f4d 4f44 455f 4153   FKO_ENC_MODE_AS\n-00006fe0: 594d 4d45 5452 4943 3b20 202f 2a20 5573  YMMETRIC;  /* Us\n-00006ff0: 6520 4750 4720 2a2f 0a0a 2020 2020 2020  e GPG */..      \n-00007000: 2020 202f 2a20 2041 7373 756d 6520 7765     /*  Assume we\n-00007010: 2070 726f 6365 7373 6564 2074 6865 2063   processed the c\n-00007020: 6f6d 6d61 6e64 206c 696e 650a 2020 2020  ommand line.    \n-00007030: 2020 2020 2020 2a20 2061 6e64 2072 6574        *  and ret\n-00007040: 7269 6576 6564 2074 6865 2070 6173 7377  rieved the passw\n-00007050: 6f72 6420 616e 6420 7468 6520 484d 4143  ord and the HMAC\n-00007060: 206b 6579 2061 6e64 0a20 2020 2020 2020   key and.       \n-00007070: 2020 2a20 2020 7365 7420 7468 6569 7220    *   set their \n-00007080: 6173 736f 6369 6174 6564 206c 656e 6774  associated lengt\n-00007090: 6873 2e0a 2020 2020 2020 2020 202a 2f0a  hs..         */.\n-000070a0: 0a20 2020 2020 2020 2020 2f2a 2043 7265  .         /* Cre\n-000070b0: 6174 6520 7468 6520 636f 6e74 6578 7420  ate the context \n-000070c0: 2a2f 0a20 2020 2020 2020 2020 7263 203d  */.         rc =\n-000070d0: 2066 6b6f 5f6e 6577 2826 6374 7829 3b0a   fko_new(&ctx);.\n-000070e0: 2020 2020 2020 2020 2069 6628 7263 2021           if(rc !\n-000070f0: 3d20 464b 4f5f 5355 4343 4553 5329 0a20  = FKO_SUCCESS). \n-00007100: 2020 2020 2020 2020 7b0a 2020 2020 2020          {.      \n-00007110: 2020 2020 2020 2066 7072 696e 7466 2873         fprintf(s\n-00007120: 7464 6572 722c 2022 4572 726f 7220 6372  tderr, \"Error cr\n-00007130: 6561 7469 6e67 2063 6f6e 7465 7874 3a20  eating context: \n-00007140: 2573 5c6e 222c 2066 6b6f 5f65 7272 7374  %s\\n\", fko_errst\n-00007150: 7228 7263 2929 3b0a 2020 2020 2020 2020  r(rc));.        \n-00007160: 2020 2020 2065 7869 7428 3129 3b0a 2020       exit(1);.  \n-00007170: 2020 2020 2020 207d 0a0a 2020 2020 2020         }..      \n-00007180: 2020 202f 2a20 5365 7420 7468 6520 5350     /* Set the SP\n-00007190: 4120 6d65 7373 6167 6520 6669 656c 6420  A message field \n-000071a0: 2d20 6173 6b69 6e67 2074 6f20 6f70 656e  - asking to open\n-000071b0: 2074 6370 2070 6f72 7420 3232 0a20 2020   tcp port 22.   \n-000071c0: 2020 2020 2020 202a 2066 6f72 2074 6865         * for the\n-000071d0: 2073 7973 7465 6d20 6174 2031 3932 2e31   system at 192.1\n-000071e0: 3638 2e30 2e33 330a 2020 2020 2020 2020  68.0.33.        \n-000071f0: 202a 2f0a 2020 2020 2020 2020 2072 6320   */.         rc \n-00007200: 3d20 666b 6f5f 7365 745f 7370 615f 6d65  = fko_set_spa_me\n-00007210: 7373 6167 6528 6374 782c 2022 3139 322e  ssage(ctx, \"192.\n-00007220: 3136 382e 302e 3333 2c74 6370 2f32 3222  168.0.33,tcp/22\"\n-00007230: 293b 0a20 2020 2020 2020 2020 6966 2872  );.         if(r\n-00007240: 6320 213d 2046 4b4f 5f53 5543 4345 5353  c != FKO_SUCCESS\n-00007250: 290a 2020 2020 2020 2020 207b 0a20 2020  ).         {.   \n-00007260: 2020 2020 2020 2020 2020 6670 7269 6e74            fprint\n-00007270: 6628 7374 6465 7272 2c20 2253 6574 2053  f(stderr, \"Set S\n-00007280: 5041 206d 6573 7361 6765 2066 6169 6c65  PA message faile\n-00007290: 643a 2025 735c 6e22 2c20 666b 6f5f 6572  d: %s\\n\", fko_er\n-000072a0: 7273 7472 2872 6329 293b 0a20 2020 2020  rstr(rc));.     \n-000072b0: 2020 2020 2020 2020 6578 6974 2831 293b          exit(1);\n-000072c0: 0a20 2020 2020 2020 2020 7d0a 0a20 2020  .         }..   \n-000072d0: 2020 2020 2020 2f2a 204c 6574 2075 7320        /* Let us \n-000072e0: 6173 7375 6d65 2077 6520 6172 6520 7573  assume we are us\n-000072f0: 696e 6720 4750 4720 656e 6372 7970 7469  ing GPG encrypti\n-00007300: 6f6e 2e20 2053 6f20 7765 206e 6565 6420  on.  So we need \n-00007310: 746f 0a20 2020 2020 2020 2020 202a 2073  to.          * s\n-00007320: 6574 2074 6865 2065 6e63 7279 7074 696f  et the encryptio\n-00007330: 6e20 7479 7065 2061 6e64 2073 6574 2074  n type and set t\n-00007340: 6865 2072 6571 7569 7265 6420 4750 4720  he required GPG \n-00007350: 7061 7261 6d65 7465 7273 0a20 2020 2020  parameters.     \n-00007360: 2020 2020 202a 2028 7765 2063 616e 2073       * (we can s\n-00007370: 6b69 7020 6368 6563 6b69 6e67 2072 6574  kip checking ret\n-00007380: 7572 6e20 7661 6c75 6573 2066 6f72 2062  urn values for b\n-00007390: 7265 7669 7479 292e 0a20 2020 2020 2020  revity)..       \n-000073a0: 2020 2a2f 0a20 2020 2020 2020 2020 7263    */.         rc\n-000073b0: 203d 2066 6b6f 5f73 6574 5f73 7061 5f65   = fko_set_spa_e\n-000073c0: 6e63 7279 7074 696f 6e5f 7479 7065 2863  ncryption_type(c\n-000073d0: 7478 2c20 464b 4f5f 454e 4352 5950 5449  tx, FKO_ENCRYPTI\n-000073e0: 4f4e 5f47 5047 293b 0a0a 2020 2020 2020  ON_GPG);..      \n-000073f0: 2020 202f 2a20 4b65 7920 666f 7220 7468     /* Key for th\n-00007400: 6520 7265 6369 7069 656e 7420 2a2f 0a20  e recipient */. \n-00007410: 2020 2020 2020 2020 7263 203d 2066 6b6f          rc = fko\n-00007420: 5f73 6574 5f67 7067 5f72 6563 6970 6965  _set_gpg_recipie\n-00007430: 6e74 2863 7478 2c20 2272 6563 6970 4073  nt(ctx, \"recip@s\n-00007440: 6f6d 652e 7768 6572 6522 293b 0a0a 2020  ome.where\");..  \n-00007450: 2020 2020 2020 202f 2a20 4b65 7920 666f         /* Key fo\n-00007460: 7220 7468 6520 7369 676e 6572 2028 6966  r the signer (if\n-00007470: 2079 6f75 2077 616e 7420 746f 2073 6967   you want to sig\n-00007480: 6e20 6974 2920 2a2f 0a20 2020 2020 2020  n it) */.       \n-00007490: 2020 7263 203d 2066 6b6f 5f73 6574 5f67    rc = fko_set_g\n-000074a0: 7067 5f73 6967 6e65 7228 6374 782c 2022  pg_signer(ctx, \"\n-000074b0: 6d65 4072 6967 6874 2e68 6572 6522 293b  me@right.here\");\n-000074c0: 0a0a 2020 2020 2020 2020 202f 2a20 4669  ..         /* Fi\n-000074d0: 6e61 6c69 7a65 2074 6865 2053 5041 2064  nalize the SPA d\n-000074e0: 6174 6120 2a2f 0a20 2020 2020 2020 2020  ata */.         \n-000074f0: 7263 203d 2066 6b6f 5f73 7061 5f64 6174  rc = fko_spa_dat\n-00007500: 615f 6669 6e61 6c28 6374 782c 206b 6579  a_final(ctx, key\n-00007510: 2c20 6b65 795f 6c65 6e2c 2065 6e63 5f6d  , key_len, enc_m\n-00007520: 6f64 652c 0a20 2020 2020 2020 2020 2020  ode,.           \n-00007530: 2020 2020 2020 686d 6163 5f6b 6579 2c20        hmac_key, \n-00007540: 686d 6163 5f6b 6579 5f6c 656e 2c20 686d  hmac_key_len, hm\n-00007550: 6163 5f74 7970 6529 3b0a 2020 2020 2020  ac_type);.      \n-00007560: 2020 2069 6628 7263 2021 3d20 464b 4f5f     if(rc != FKO_\n-00007570: 5355 4343 4553 5329 0a20 2020 2020 2020  SUCCESS).       \n-00007580: 2020 7b0a 2020 2020 2020 2020 2020 2020    {.            \n-00007590: 2066 7072 696e 7466 2873 7464 6572 722c   fprintf(stderr,\n-000075a0: 2022 4572 726f 7220 656e 636f 6469 6e67   \"Error encoding\n-000075b0: 2053 5041 2064 6174 613a 2025 735c 6e22   SPA data: %s\\n\"\n-000075c0: 2c0a 2020 2020 2020 2020 2020 2020 2020  ,.              \n-000075d0: 2020 2066 6b6f 5f65 7272 7374 7228 7263     fko_errstr(rc\n-000075e0: 2929 3b0a 2020 2020 2020 2020 2020 2020  ));.            \n-000075f0: 2065 7869 7428 3129 3b0a 2020 2020 2020   exit(1);.      \n-00007600: 2020 207d 0a0a 2020 2020 2020 2020 202f     }..         /\n-00007610: 2a20 5461 6b65 2074 6865 2066 696e 616c  * Take the final\n-00007620: 206d 6573 7361 6765 2061 6e64 2064 6f20   message and do \n-00007630: 736f 6d65 7468 696e 6720 7769 7468 2069  something with i\n-00007640: 7420 2a2f 0a20 2020 2020 2020 2020 7263  t */.         rc\n-00007650: 203d 2066 6b6f 5f67 6574 5f73 7061 5f64   = fko_get_spa_d\n-00007660: 6174 6128 6374 782c 2026 6669 6e61 6c5f  ata(ctx, &final_\n-00007670: 7370 6129 3b0a 0a20 2020 2020 2020 2020  spa);..         \n-00007680: 2f2a 2041 7373 756d 6520 7468 6973 2066  /* Assume this f\n-00007690: 756e 6374 696f 6e20 7061 636b 7320 7468  unction packs th\n-000076a0: 6520 7370 6120 6461 7461 2069 6e74 6f20  e spa data into \n-000076b0: 6120 5544 500a 2020 2020 2020 2020 2020  a UDP.          \n-000076c0: 2a20 7061 636b 6574 2061 6e64 2073 656e  * packet and sen\n-000076d0: 6473 2069 7420 746f 2074 6865 2073 6572  ds it to the ser\n-000076e0: 7665 722e 0a20 2020 2020 2020 2020 2a2f  ver..         */\n-000076f0: 0a20 2020 2020 2020 2020 7365 6e64 5f73  .         send_s\n-00007700: 7061 5f6d 6573 7361 6765 2866 696e 616c  pa_message(final\n-00007710: 5f73 7061 293b 0a0a 2020 2020 2020 2020  _spa);..        \n-00007720: 202f 2a20 446f 6e65 2077 6974 6820 7468   /* Done with th\n-00007730: 6520 636f 6e74 6578 7420 2a2f 0a20 2020  e context */.   \n-00007740: 2020 2020 2020 666b 6f5f 6465 7374 726f        fko_destro\n-00007750: 7928 6374 7829 3b0a 0a20 2020 2020 2020  y(ctx);..       \n-00007760: 2020 6578 6974 2830 293b 0a20 2020 2020    exit(0);.     \n-00007770: 7d0a 0a1f 0a46 696c 653a 206c 6962 666b  }....File: libfk\n-00007780: 6f2e 696e 666f 2c20 204e 6f64 653a 2053  o.info,  Node: S\n-00007790: 6574 7469 6e67 2053 5041 2044 6174 612c  etting SPA Data,\n-000077a0: 2020 4e65 7874 3a20 5265 7472 6965 7669    Next: Retrievi\n-000077b0: 6e67 2053 5041 2044 6174 612c 2020 5072  ng SPA Data,  Pr\n-000077c0: 6576 3a20 4372 6561 7469 6e67 2061 2053  ev: Creating a S\n-000077d0: 5041 204d 6573 7361 6765 2c20 2055 703a  PA Message,  Up:\n-000077e0: 2055 7369 6e67 206c 6962 666b 6f0a 0a33   Using libfko..3\n-000077f0: 2e34 2053 6574 7469 6e67 2053 5041 2044  .4 Setting SPA D\n-00007800: 6174 610a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ata.============\n-00007810: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6973 2073  ========..This s\n-00007820: 6563 7469 6f6e 2064 6573 6372 6962 6573  ection describes\n-00007830: 2074 6865 2066 756e 6374 696f 6e73 2075   the functions u\n-00007840: 7365 6420 666f 7220 7365 7474 696e 6720  sed for setting \n-00007850: 7468 6520 7661 7269 6f75 7320 5350 410a  the various SPA.\n-00007860: 6461 7461 2066 6965 6c64 7320 616e 6420  data fields and \n-00007870: 7061 7261 6d65 7465 7273 2e20 2041 6c6c  parameters.  All\n-00007880: 206f 6620 7468 6573 6520 6675 6e63 7469   of these functi\n-00007890: 6f6e 7320 7265 7475 726e 2061 6e20 696e  ons return an in\n-000078a0: 7465 6765 720a 7265 7072 6573 656e 7469  teger.representi\n-000078b0: 6e67 2074 6865 2072 6574 7572 6e20 7374  ng the return st\n-000078c0: 6174 7573 206f 6620 7468 6520 6675 6e63  atus of the func\n-000078d0: 7469 6f6e 2e20 2057 6865 6e20 7375 6363  tion.  When succ\n-000078e0: 6573 6675 6c6c 2c20 7468 6579 0a77 696c  esfull, they.wil\n-000078f0: 6c20 7265 7475 726e 2027 464b 4f5f 5355  l return 'FKO_SU\n-00007900: 4343 4553 5327 2e20 204f 7468 6572 7769  CCESS'.  Otherwi\n-00007910: 7365 2c20 616e 2065 7272 6f72 2063 6f64  se, an error cod\n-00007920: 6520 7661 6c75 6520 6973 2072 6574 7572  e value is retur\n-00007930: 6e65 642e 0a0a 202d 2d20 4675 6e63 7469  ned... -- Functi\n-00007940: 6f6e 3a20 696e 7420 666b 6f5f 7365 745f  on: int fko_set_\n-00007950: 7370 615f 6469 6765 7374 5f74 7970 6520  spa_digest_type \n-00007960: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, \n-00007970: 7368 6f72 740a 2020 2020 2020 2020 2020  short.          \n-00007980: 4449 4745 5354 5f54 5950 4529 3b0a 2020  DIGEST_TYPE);.  \n-00007990: 2020 2053 6574 2074 6865 206d 6573 7361     Set the messa\n-000079a0: 6765 2064 6967 6573 7420 7479 7065 2e20  ge digest type. \n-000079b0: 2056 616c 6964 2076 616c 7565 7320 6361   Valid values ca\n-000079c0: 6e20 6265 2066 6f75 6e64 2069 6e20 2a6e  n be found in *n\n-000079d0: 6f74 650a 2020 2020 2044 6967 6573 7473  ote.     Digests\n-000079e0: 3a3a 206f 6620 7468 6973 206d 616e 7561  :: of this manua\n-000079f0: 6c2e 2020 4966 2061 2076 616c 7565 206f  l.  If a value o\n-00007a00: 7468 6572 2074 6861 6e20 7468 6520 7468  ther than the th\n-00007a10: 6f73 6520 7468 6174 2061 7265 0a20 2020  ose that are.   \n-00007a20: 2020 7375 7070 6f72 7465 6420 6973 2067    supported is g\n-00007a30: 6976 656e 2c20 7468 6520 6675 6e63 7469  iven, the functi\n-00007a40: 6f6e 2077 696c 6c20 7265 7475 726e 0a20  on will return. \n-00007a50: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n-00007a60: 4e56 414c 4944 5f44 4154 4127 2e20 2046  NVALID_DATA'.  F\n-00007a70: 6f72 2065 7861 6d70 6c65 3a0a 2020 2020  or example:.    \n-00007a80: 2020 2020 2020 2020 2020 7263 203d 2066            rc = f\n-00007a90: 6b6f 5f73 6574 5f64 6967 6573 745f 7479  ko_set_digest_ty\n-00007aa0: 7065 2863 7478 2c20 464b 4f5f 4449 4745  pe(ctx, FKO_DIGE\n-00007ab0: 5354 5f53 4841 3129 3b0a 0a20 2d2d 2046  ST_SHA1);.. -- F\n-00007ac0: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko\n-00007ad0: 5f73 6574 5f73 7061 5f68 6d61 635f 7479  _set_spa_hmac_ty\n-00007ae0: 7065 2028 666b 6f5f 6374 785f 7420 4354  pe (fko_ctx_t CT\n-00007af0: 582c 2073 686f 7274 0a20 2020 2020 2020  X, short.       \n-00007b00: 2020 2048 4d41 435f 5459 5045 293b 0a20     HMAC_TYPE);. \n-00007b10: 2020 2020 5365 7420 7468 6520 6d65 7373      Set the mess\n-00007b20: 6167 6520 686d 6163 2074 7970 652e 2020  age hmac type.  \n-00007b30: 5661 6c69 6420 7661 6c75 6573 2063 616e  Valid values can\n-00007b40: 2062 6520 666f 756e 6420 696e 202a 6e6f   be found in *no\n-00007b50: 7465 2048 4d41 430a 2020 2020 2044 6967  te HMAC.     Dig\n-00007b60: 6573 7473 3a3a 206f 6620 7468 6973 206d  ests:: of this m\n-00007b70: 616e 7561 6c2e 2020 4966 2061 2076 616c  anual.  If a val\n-00007b80: 7565 206f 7468 6572 2074 6861 6e20 7468  ue other than th\n-00007b90: 6520 7468 6f73 6520 7468 6174 2061 7265  e those that are\n-00007ba0: 0a20 2020 2020 7375 7070 6f72 7465 6420  .     supported \n-00007bb0: 6973 2067 6976 656e 2c20 7468 6520 6675  is given, the fu\n-00007bc0: 6e63 7469 6f6e 2077 696c 6c20 7265 7475  nction will retu\n-00007bd0: 726e 0a20 2020 2020 2746 4b4f 5f45 5252  rn.     'FKO_ERR\n-00007be0: 4f52 5f49 4e56 414c 4944 5f44 4154 4127  OR_INVALID_DATA'\n-00007bf0: 2e20 2046 6f72 2065 7861 6d70 6c65 3a0a  .  For example:.\n-00007c00: 2020 2020 2020 2020 2020 2020 2020 7263                rc\n-00007c10: 203d 2066 6b6f 5f73 6574 5f68 6d61 635f   = fko_set_hmac_\n-00007c20: 7479 7065 2863 7478 2c20 464b 4f5f 484d  type(ctx, FKO_HM\n-00007c30: 4143 5f53 4841 3235 3629 3b0a 0a20 2d2d  AC_SHA256);.. --\n-00007c40: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f\n-00007c50: 6b6f 5f73 6574 5f73 7061 5f65 6e63 7279  ko_set_spa_encry\n-00007c60: 7074 696f 6e5f 7479 7065 2028 666b 6f5f  ption_type (fko_\n-00007c70: 6374 785f 7420 4354 582c 2073 686f 7274  ctx_t CTX, short\n-00007c80: 0a20 2020 2020 2020 2020 2045 4e43 5259  .          ENCRY\n-00007c90: 5054 5f54 5950 4529 3b0a 2020 2020 2053  PT_TYPE);.     S\n-00007ca0: 6574 2074 6865 2065 6e63 7279 7469 6f6e  et the encrytion\n-00007cb0: 2061 6c67 6f72 6974 686d 2074 6f20 7573   algorithm to us\n-00007cc0: 6520 7768 656e 2065 6372 7970 7469 6e67  e when ecrypting\n-00007cd0: 2074 6865 2066 696e 616c 2053 5041 0a20   the final SPA. \n-00007ce0: 2020 2020 6461 7461 2e20 2056 616c 6964      data.  Valid\n-00007cf0: 2076 616c 7565 7320 6361 6e20 6265 2066   values can be f\n-00007d00: 6f75 6e64 2069 6e20 2a6e 6f74 6520 456e  ound in *note En\n-00007d10: 6372 7970 7469 6f6e 2041 6c67 6f72 6974  cryption Algorit\n-00007d20: 686d 733a 3a0a 2020 2020 206f 6620 7468  hms::.     of th\n-00007d30: 6973 206d 616e 7561 6c2e 2020 466f 7220  is manual.  For \n-00007d40: 6578 616d 706c 653a 0a20 2020 2020 2020  example:.       \n-00007d50: 2020 2020 2020 2072 6320 3d20 666b 6f5f         rc = fko_\n-00007d60: 7365 745f 656e 6372 7970 7469 6f6e 5f74  set_encryption_t\n-00007d70: 7970 6528 6374 782c 2046 4b4f 5f45 4e43  ype(ctx, FKO_ENC\n-00007d80: 5259 5054 494f 4e5f 5249 4a4e 4441 454c  RYPTION_RIJNDAEL\n-00007d90: 293b 0a0a 202d 2d20 4675 6e63 7469 6f6e  );.. -- Function\n-00007da0: 3a20 696e 7420 666b 6f5f 7365 745f 7261  : int fko_set_ra\n-00007db0: 6e64 5f76 616c 7565 2028 666b 6f5f 6374  nd_value (fko_ct\n-00007dc0: 785f 7420 4354 582c 2063 6f6e 7374 2063  x_t CTX, const c\n-00007dd0: 6861 7220 2a56 414c 293b 0a20 2020 2020  har *VAL);.     \n-00007de0: 5365 7420 7468 6520 7261 6e64 6f6d 2076  Set the random v\n-00007df0: 616c 7565 2070 6f72 7469 6f6e 206f 6620  alue portion of \n-00007e00: 7468 6520 7370 6120 6461 7461 2074 6f20  the spa data to \n-00007e10: 7468 6520 6769 7665 6e20 7661 6c75 650a  the given value.\n-00007e20: 2020 2020 2028 5641 4c29 2e20 2054 6865       (VAL).  The\n-00007e30: 2067 6976 656e 2076 616c 7565 206d 7573   given value mus\n-00007e40: 7420 6265 2061 2070 6f69 6e74 6572 2074  t be a pointer t\n-00007e50: 6f20 6120 3136 2d63 6861 7261 6374 6572  o a 16-character\n-00007e60: 2064 6563 696d 616c 0a20 2020 2020 6e75   decimal.     nu\n-00007e70: 6d65 7269 6320 7374 7269 6e67 206f 7220  meric string or \n-00007e80: 4e55 4c4c 2e20 4966 2074 6865 2076 616c  NULL. If the val\n-00007e90: 7565 2069 7320 4e55 4c4c 2c20 7468 6520  ue is NULL, the \n-00007ea0: 6675 6e63 7469 6f6e 2067 656e 6572 6174  function generat\n-00007eb0: 650a 2020 2020 2061 206e 6577 2072 616e  e.     a new ran\n-00007ec0: 646f 6d20 7661 6c75 652e 2020 4966 2061  dom value.  If a\n-00007ed0: 2073 7472 696e 6720 7661 6c75 6520 6973   string value is\n-00007ee0: 2070 726f 7669 6465 642c 2069 7420 6d75   provided, it mu\n-00007ef0: 7374 2062 6520 610a 2020 2020 2031 362d  st be a.     16-\n-00007f00: 6368 6172 6163 7465 7220 6465 6369 6d61  character decima\n-00007f10: 6c20 7374 7269 6e67 2e20 204f 7468 6572  l string.  Other\n-00007f20: 7769 7365 2c20 7468 6520 6675 6e63 7469  wise, the functi\n-00007f30: 6f6e 2077 696c 6c20 7265 7475 726e 0a20  on will return. \n-00007f40: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n-00007f50: 4e56 414c 4944 5f44 4154 4127 2e0a 0a20  NVALID_DATA'... \n-00007f60: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int\n-00007f70: 2066 6b6f 5f73 6574 5f75 7365 726e 616d   fko_set_usernam\n-00007f80: 6520 2866 6b6f 5f63 7478 5f74 2043 5458  e (fko_ctx_t CTX\n-00007f90: 2c20 636f 6e73 7420 6368 6172 0a20 2020  , const char.   \n-00007fa0: 2020 2020 2020 202a 5553 4552 4e41 4d45         *USERNAME\n-00007fb0: 293b 0a20 2020 2020 5365 7420 7468 6520  );.     Set the \n-00007fc0: 7573 6572 6e61 6d65 2066 6965 6c64 206f  username field o\n-00007fd0: 6620 7468 6520 5350 4120 6461 7461 2e20  f the SPA data. \n-00007fe0: 2049 6620 5553 4552 4e41 4d45 2069 7320   If USERNAME is \n-00007ff0: 4e55 4c4c 2c0a 2020 2020 206c 6962 666b  NULL,.     libfk\n-00008000: 6f20 7769 6c6c 2066 6972 7374 206c 6f6f  o will first loo\n-00008010: 6b20 666f 7220 7468 6520 656e 7669 726f  k for the enviro\n-00008020: 6e6d 656e 7420 7661 7269 6162 6c65 2027  nment variable '\n-00008030: 5350 4f4f 465f 5553 4552 270a 2020 2020  SPOOF_USER'.    \n-00008040: 2061 6e64 2075 7365 2069 7473 2076 616c   and use its val\n-00008050: 7565 2069 6620 666f 756e 642e 2020 4f74  ue if found.  Ot\n-00008060: 6865 7277 6973 652c 2069 7420 7769 6c6c  herwise, it will\n-00008070: 2074 7279 2074 6f20 6465 7465 726d 696e   try to determin\n-00008080: 650a 2020 2020 2074 6865 2075 7365 726e  e.     the usern\n-00008090: 616d 6520 6974 7365 6c66 2075 7369 6e67  ame itself using\n-000080a0: 2076 6172 696f 7573 206d 6574 686f 6473   various methods\n-000080b0: 2073 7461 7274 696e 6720 7769 7468 2027   starting with '\n-000080c0: 6375 7365 7227 206f 720a 2020 2020 2027  cuser' or.     '\n-000080d0: 6765 746c 6f67 696e 272c 2074 6865 6e20  getlogin', then \n-000080e0: 6661 6c6c 6261 636b 2074 6f20 7468 6520  fallback to the \n-000080f0: 656e 7669 726f 6e6d 656e 7420 7661 7269  environment vari\n-00008100: 6162 6c65 7320 274c 4f47 4e41 4d45 2720  ables 'LOGNAME' \n-00008110: 6f72 0a20 2020 2020 2755 5345 5227 2e20  or.     'USER'. \n-00008120: 2049 6620 6e6f 6e65 206f 6620 7468 6f73   If none of thos\n-00008130: 6520 776f 726b 2c20 7468 6520 6675 6e63  e work, the func\n-00008140: 7469 6f6e 2077 696c 6c20 7265 7475 726e  tion will return\n-00008150: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-00008160: 5f55 5345 524e 414d 455f 554e 4b4e 4f57  _USERNAME_UNKNOW\n-00008170: 4e27 2e0a 0a20 2d2d 2046 756e 6374 696f  N'... -- Functio\n-00008180: 6e3a 2069 6e74 2066 6b6f 5f73 6574 5f74  n: int fko_set_t\n-00008190: 696d 6573 7461 6d70 2028 666b 6f5f 6374  imestamp (fko_ct\n-000081a0: 785f 7420 4354 582c 2069 6e74 204f 4646  x_t CTX, int OFF\n-000081b0: 5345 5429 3b0a 2020 2020 2053 6574 7320  SET);.     Sets \n-000081c0: 7468 6520 7469 6d65 7374 616d 7020 7661  the timestamp va\n-000081d0: 6c75 6520 6f66 2074 6865 2053 5041 2064  lue of the SPA d\n-000081e0: 6174 6120 746f 2074 6865 2063 7572 7265  ata to the curre\n-000081f0: 6e74 2074 696d 6520 706c 7573 0a20 2020  nt time plus.   \n-00008200: 2020 7468 6520 6f66 6673 6574 2076 616c    the offset val\n-00008210: 7565 2e0a 0a20 2d2d 2046 756e 6374 696f  ue... -- Functio\n-00008220: 6e3a 2069 6e74 2066 6b6f 5f73 6574 5f73  n: int fko_set_s\n-00008230: 7061 5f6d 6573 7361 6765 5f74 7970 6520  pa_message_type \n-00008240: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, \n-00008250: 7368 6f72 740a 2020 2020 2020 2020 2020  short.          \n-00008260: 4d53 475f 5459 5045 293b 0a20 2020 2020  MSG_TYPE);.     \n-00008270: 5365 7473 2074 6865 206d 6573 7361 6765  Sets the message\n-00008280: 2074 7970 6520 666f 7220 7468 6520 5350   type for the SP\n-00008290: 4120 6461 7461 2e20 2054 6865 2063 686f  A data.  The cho\n-000082a0: 6963 6573 2066 6f72 2074 6865 0a20 2020  ices for the.   \n-000082b0: 2020 2773 7061 5f6d 6573 7361 6765 5f74    'spa_message_t\n-000082c0: 7970 6527 2061 7265 206c 6973 7465 6420  ype' are listed \n-000082d0: 696e 202a 6e6f 7465 2053 5041 204d 6573  in *note SPA Mes\n-000082e0: 7361 6765 733a 3a2e 2020 466f 720a 2020  sages::.  For.  \n-000082f0: 2020 2065 7861 6d70 6c65 3a0a 2020 2020     example:.    \n-00008300: 2020 2020 2020 2020 2020 7263 203d 2066            rc = f\n-00008310: 6b6f 5f73 6574 5f73 7061 5f6d 6573 7361  ko_set_spa_messa\n-00008320: 6765 5f74 7970 6528 6374 782c 2046 4b4f  ge_type(ctx, FKO\n-00008330: 5f41 4343 4553 535f 4d53 4729 3b0a 0a20  _ACCESS_MSG);.. \n-00008340: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int\n-00008350: 2066 6b6f 5f73 6574 5f73 7061 5f6d 6573   fko_set_spa_mes\n-00008360: 7361 6765 2028 666b 6f5f 6374 785f 7420  sage (fko_ctx_t \n-00008370: 4354 582c 2063 6f6e 7374 2063 6861 720a  CTX, const char.\n-00008380: 2020 2020 2020 2020 2020 2a4d 5347 5f53            *MSG_S\n-00008390: 5452 494e 4729 3b0a 2020 2020 2053 6574  TRING);.     Set\n-000083a0: 2074 6865 2053 5041 206d 6573 7361 6765   the SPA message\n-000083b0: 2073 7472 696e 6720 746f 2074 6865 2067   string to the g\n-000083c0: 6976 656e 2076 616c 7565 2e20 2049 6620  iven value.  If \n-000083d0: 7468 6973 2073 7472 696e 6720 646f 6573  this string does\n-000083e0: 0a20 2020 2020 6e6f 7420 636f 6e66 6f72  .     not confor\n-000083f0: 6d20 746f 2074 6865 2072 6571 7569 7265  m to the require\n-00008400: 6420 2773 7061 5f6e 6174 5f61 6363 6573  d 'spa_nat_acces\n-00008410: 7327 2066 6f72 6d61 742c 2074 6865 2066  s' format, the f\n-00008420: 756e 6374 696f 6e0a 2020 2020 2077 696c  unction.     wil\n-00008430: 6c20 7265 7475 726e 2027 464b 4f5f 4552  l return 'FKO_ER\n-00008440: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n-00008450: 272e 0a0a 202d 2d20 4675 6e63 7469 6f6e  '... -- Function\n-00008460: 3a20 696e 7420 666b 6f5f 7365 745f 7370  : int fko_set_sp\n-00008470: 615f 6e61 745f 6163 6365 7373 2028 666b  a_nat_access (fk\n-00008480: 6f5f 6374 785f 7420 4354 582c 2063 6f6e  o_ctx_t CTX, con\n-00008490: 7374 2063 6861 720a 2020 2020 2020 2020  st char.        \n-000084a0: 2020 2a4e 4154 5f41 4343 4553 5329 3b0a    *NAT_ACCESS);.\n-000084b0: 2020 2020 2053 6574 2074 6865 206f 7074       Set the opt\n-000084c0: 696f 6e61 6c20 5350 4120 6e61 7420 6163  ional SPA nat ac\n-000084d0: 6365 7373 2073 7472 696e 6720 746f 2074  cess string to t\n-000084e0: 6865 2067 6976 656e 2076 616c 7565 2e20  he given value. \n-000084f0: 2049 6620 7468 6973 0a20 2020 2020 7374   If this.     st\n-00008500: 7269 6e67 2064 6f65 7320 6e6f 7420 636f  ring does not co\n-00008510: 6e66 6f72 6d20 746f 2074 6865 2072 6571  nform to the req\n-00008520: 7569 7265 6420 2773 7061 5f6e 6174 5f61  uired 'spa_nat_a\n-00008530: 6363 6573 7327 2066 6f72 6d61 742c 0a20  ccess' format,. \n-00008540: 2020 2020 7468 6520 6675 6e63 7469 6f6e      the function\n-00008550: 2077 696c 6c20 7265 7475 726e 2027 464b   will return 'FK\n-00008560: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n-00008570: 4441 5441 272e 0a0a 202d 2d20 4675 6e63  DATA'... -- Func\n-00008580: 7469 6f6e 3a20 696e 7420 666b 6f5f 7365  tion: int fko_se\n-00008590: 745f 7370 615f 7365 7276 6572 5f61 7574  t_spa_server_aut\n-000085a0: 6820 2866 6b6f 5f63 7478 5f74 2043 5458  h (fko_ctx_t CTX\n-000085b0: 2c20 636f 6e73 7420 6368 6172 0a20 2020  , const char.   \n-000085c0: 2020 2020 2020 202a 5345 5256 4552 5f41         *SERVER_A\n-000085d0: 5554 4829 3b0a 2020 2020 2053 6574 2074  UTH);.     Set t\n-000085e0: 6865 206f 7074 696f 6e61 6c20 2876 6572  he optional (ver\n-000085f0: 7920 7365 6c64 6f6d 2075 7365 6429 2053  y seldom used) S\n-00008600: 5041 2073 6572 7665 7220 6175 7468 2066  PA server auth f\n-00008610: 6561 7475 7265 2074 6f20 7468 650a 2020  eature to the.  \n-00008620: 2020 2067 6976 656e 2076 616c 7565 2e20     given value. \n-00008630: 2054 6869 7320 7061 7261 6d65 7465 7220   This parameter \n-00008640: 6d61 7920 6265 636f 6d65 2064 6570 7265  may become depre\n-00008650: 6361 7465 642e 0a0a 202d 2d20 4675 6e63  cated... -- Func\n-00008660: 7469 6f6e 3a20 696e 7420 666b 6f5f 7365  tion: int fko_se\n-00008670: 745f 7370 615f 636c 6965 6e74 5f74 696d  t_spa_client_tim\n-00008680: 656f 7574 2028 666b 6f5f 6374 785f 7420  eout (fko_ctx_t \n-00008690: 4354 582c 2069 6e74 0a20 2020 2020 2020  CTX, int.       \n-000086a0: 2020 2054 494d 454f 5554 293b 0a20 2020     TIMEOUT);.   \n-000086b0: 2020 5365 7473 2074 6865 2053 5041 2063    Sets the SPA c\n-000086c0: 6c69 656e 7420 7469 6d65 6f75 7420 7661  lient timeout va\n-000086d0: 6c75 652e 2020 4966 2074 6865 2074 696d  lue.  If the tim\n-000086e0: 656f 7574 2069 7320 7365 7420 746f 2061  eout is set to a\n-000086f0: 0a20 2020 2020 7661 6c75 6520 6772 6561  .     value grea\n-00008700: 7465 7220 7468 616e 2030 2c20 6974 2069  ter than 0, it i\n-00008710: 7320 6173 7375 6d65 6420 7468 6520 2773  s assumed the 's\n-00008720: 7061 5f6d 6573 7361 6765 5f74 7970 6527  pa_message_type'\n-00008730: 2073 6574 7469 6e67 0a20 2020 2020 7368   setting.     sh\n-00008740: 6f75 6c64 2062 6520 6f6e 6520 6f66 2074  ould be one of t\n-00008750: 6865 2022 5449 4d45 4f55 5422 2076 6172  he \"TIMEOUT\" var\n-00008760: 6961 6e74 732e 2020 5468 6973 2066 756e  iants.  This fun\n-00008770: 6374 696f 6e20 7769 6c6c 2063 6861 6e67  ction will chang\n-00008780: 650a 2020 2020 2074 6865 2027 6d65 7373  e.     the 'mess\n-00008790: 6167 655f 7479 7065 2720 746f 2074 6865  age_type' to the\n-000087a0: 2061 7070 726f 7072 6961 7465 2073 6574   appropriate set\n-000087b0: 7469 6e67 2069 6620 6e65 6365 7373 6172  ting if necessar\n-000087c0: 792e 0a20 2020 2020 486f 7765 7665 722c  y..     However,\n-000087d0: 2069 7420 6973 2072 6563 6f6d 6d65 6e64   it is recommend\n-000087e0: 6564 2079 6f75 2073 6574 2074 6865 2063  ed you set the c\n-000087f0: 6f72 7265 6374 2027 6d65 7373 6167 655f  orrect 'message_\n-00008800: 7479 7065 2720 6168 6561 640a 2020 2020  type' ahead.    \n-00008810: 206f 6620 7469 6d65 2e0a 0a20 2d2d 2046   of time... -- F\n-00008820: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko\n-00008830: 5f73 6574 5f73 7061 5f64 6967 6573 7420  _set_spa_digest \n-00008840: 2866 6b6f 5f63 7478 5f74 2043 5458 293b  (fko_ctx_t CTX);\n-00008850: 0a20 2020 2020 496e 6974 6961 7465 7320  .     Initiates \n-00008860: 6120 6361 6c63 756c 6174 696f 6e20 286f  a calculation (o\n-00008870: 7220 7265 6361 6c63 756c 6174 696f 6e29  r recalculation)\n-00008880: 206f 6620 7468 6520 6d65 7373 6167 6520   of the message \n-00008890: 6469 6765 7374 0a20 2020 2020 6861 7368  digest.     hash\n-000088a0: 2066 6f72 2074 6865 2063 7572 7265 6e74   for the current\n-000088b0: 2053 5041 2064 6174 612e 2020 4966 2074   SPA data.  If t\n-000088c0: 6865 2072 6571 7569 7265 6420 6461 7461  he required data\n-000088d0: 2066 6965 6c64 7320 6172 6520 6e6f 740a   fields are not.\n-000088e0: 2020 2020 2073 6574 2074 6869 7320 6675       set this fu\n-000088f0: 6e63 7469 6f6e 2077 696c 6c20 7265 7475  nction will retu\n-00008900: 726e 2027 464b 4f5f 4552 524f 525f 4d49  rn 'FKO_ERROR_MI\n-00008910: 5353 494e 475f 454e 434f 4445 445f 4441  SSING_ENCODED_DA\n-00008920: 5441 272e 0a20 2020 2020 2a4e 6f74 652a  TA'..     *Note*\n-00008930: 3a20 4974 2073 686f 756c 6420 6e6f 7420  : It should not \n-00008940: 6265 206e 6563 6573 7361 7279 2074 6f20  be necessary to \n-00008950: 6361 6c6c 2074 6869 7320 6675 6e63 7469  call this functi\n-00008960: 6f6e 2064 6972 6563 746c 790a 2020 2020  on directly.    \n-00008970: 2061 7320 6974 2077 696c 6c20 6265 2063   as it will be c\n-00008980: 616c 6c65 6420 6175 746f 6d61 7469 6361  alled automatica\n-00008990: 6c6c 7920 6279 206f 7468 6572 2066 756e  lly by other fun\n-000089a0: 6374 696f 6e73 2064 7572 696e 6720 6e6f  ctions during no\n-000089b0: 726d 616c 0a20 2020 2020 7072 6f63 6573  rmal.     proces\n-000089c0: 7369 6e67 2028 6d6f 7374 206e 6f74 6162  sing (most notab\n-000089d0: 6c79 2027 666b 6f5f 7370 615f 6461 7461  ly 'fko_spa_data\n-000089e0: 5f66 696e 616c 2729 2e0a 0a20 2d2d 2046  _final')... -- F\n-000089f0: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko\n-00008a00: 5f73 6574 5f73 7061 5f68 6d61 6320 2866  _set_spa_hmac (f\n-00008a10: 6b6f 5f63 7478 5f74 2043 5458 2c20 636f  ko_ctx_t CTX, co\n-00008a20: 6e73 7420 6368 6172 202a 484d 4143 5f4b  nst char *HMAC_K\n-00008a30: 4559 2c0a 2020 2020 2020 2020 2020 636f  EY,.          co\n-00008a40: 6e73 7420 696e 7420 484d 4143 5f4b 4559  nst int HMAC_KEY\n-00008a50: 5f4c 454e 293b 0a20 2020 2020 496e 6974  _LEN);.     Init\n-00008a60: 6961 7465 7320 6120 6361 6c63 756c 6174  iates a calculat\n-00008a70: 696f 6e20 286f 7220 7265 6361 6c63 756c  ion (or recalcul\n-00008a80: 6174 696f 6e29 206f 6620 7468 6520 6d65  ation) of the me\n-00008a90: 7373 6167 6520 484d 4143 2066 6f72 0a20  ssage HMAC for. \n-00008aa0: 2020 2020 7468 6520 6375 7272 656e 7420      the current \n-00008ab0: 5350 4120 6461 7461 2e20 202a 4e6f 7465  SPA data.  *Note\n-00008ac0: 2a3a 2049 7420 7368 6f75 6c64 206e 6f74  *: It should not\n-00008ad0: 2062 6520 6e65 6365 7373 6172 7920 746f   be necessary to\n-00008ae0: 2063 616c 6c0a 2020 2020 2074 6869 7320   call.     this \n-00008af0: 6675 6e63 7469 6f6e 2064 6972 6563 746c  function directl\n-00008b00: 7920 6173 2069 7420 7769 6c6c 2062 6520  y as it will be \n-00008b10: 6361 6c6c 6564 2061 7574 6f6d 6174 6963  called automatic\n-00008b20: 616c 6c79 2062 7920 6f74 6865 720a 2020  ally by other.  \n-00008b30: 2020 2066 756e 6374 696f 6e73 2064 7572     functions dur\n-00008b40: 696e 6720 6e6f 726d 616c 2070 726f 6365  ing normal proce\n-00008b50: 7373 696e 6720 286d 6f73 7420 6e6f 7461  ssing (most nota\n-00008b60: 626c 790a 2020 2020 2027 666b 6f5f 7370  bly.     'fko_sp\n-00008b70: 615f 6461 7461 5f66 696e 616c 2729 2e0a  a_data_final')..\n-00008b80: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i\n-00008b90: 6e74 2066 6b6f 5f73 6574 5f73 7061 5f64  nt fko_set_spa_d\n-00008ba0: 6174 6120 2866 6b6f 5f63 7478 5f74 2043  ata (fko_ctx_t C\n-00008bb0: 5458 2c20 6368 6172 202a 454e 435f 4441  TX, char *ENC_DA\n-00008bc0: 5441 293b 0a20 2020 2020 5468 6973 2066  TA);.     This f\n-00008bd0: 756e 6374 696f 6e20 6973 2075 7365 6420  unction is used \n-00008be0: 746f 2070 6c61 6365 2065 6e63 7279 7074  to place encrypt\n-00008bf0: 6564 2053 5041 2064 6174 6120 696e 746f  ed SPA data into\n-00008c00: 2061 206e 6577 6c79 0a20 2020 2020 6372   a newly.     cr\n-00008c10: 6561 7465 6420 656d 7074 7920 636f 6e74  eated empty cont\n-00008c20: 6578 7420 2869 2e65 2e20 2077 6974 6820  ext (i.e.  with \n-00008c30: 2766 6b6f 5f6e 6577 2729 2e20 2049 6e20  'fko_new').  In \n-00008c40: 6d6f 7374 2063 6173 6573 2c20 796f 750a  most cases, you.\n-00008c50: 2020 2020 2077 6f75 6c64 2075 7365 2027       would use '\n-00008c60: 666b 6f5f 6e65 775f 7769 7468 5f64 6174  fko_new_with_dat\n-00008c70: 6127 2073 6f20 796f 7520 776f 756c 646e  a' so you wouldn\n-00008c80: 2774 2068 6176 6520 746f 2074 616b 6520  't have to take \n-00008c90: 7468 650a 2020 2020 2065 7874 7261 2073  the.     extra s\n-00008ca0: 7465 7020 746f 2075 7365 2074 6869 7320  tep to use this \n-00008cb0: 6675 6e63 7469 6f6e 2e20 2048 6f77 6576  function.  Howev\n-00008cc0: 6572 2c20 736f 6d65 206d 6179 2066 696e  er, some may fin\n-00008cd0: 6420 6120 7265 6173 6f6e 0a20 2020 2020  d a reason.     \n-00008ce0: 746f 2064 6f20 6974 2069 6e20 7468 6973  to do it in this\n-00008cf0: 2077 6179 2e0a 0a5f 4750 472d 7370 6563   way..._GPG-spec\n-00008d00: 6966 6963 2066 756e 6374 696f 6e73 3a5f  ific functions:_\n-00008d10: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: \n-00008d20: 696e 7420 666b 6f5f 7365 745f 6770 675f  int fko_set_gpg_\n-00008d30: 7265 6369 7069 656e 7420 2866 6b6f 5f63  recipient (fko_c\n-00008d40: 7478 5f74 2043 5458 2c20 636f 6e73 7420  tx_t CTX, const \n-00008d50: 6368 6172 0a20 2020 2020 2020 2020 2052  char.          R\n-00008d60: 4543 4950 4945 4e54 293b 0a20 2020 2020  ECIPIENT);.     \n-00008d70: 5365 7473 2074 6865 2047 5047 206b 6579  Sets the GPG key\n-00008d80: 2066 6f72 2074 6865 2072 6563 6970 6965   for the recipie\n-00008d90: 6e74 2e20 2054 6869 7320 776f 756c 6420  nt.  This would \n-00008da0: 6265 2074 6865 2072 6563 6970 6965 6e74  be the recipient\n-00008db0: 2773 0a20 2020 2020 7075 626c 6963 206b  's.     public k\n-00008dc0: 6579 2075 7365 6420 746f 2065 6e63 7972  ey used to encyr\n-00008dd0: 7074 2074 6865 2053 5041 2064 6174 612e  pt the SPA data.\n-00008de0: 2020 596f 7520 6361 6e20 7573 6520 7468    You can use th\n-00008df0: 6520 7573 6572 206e 616d 650a 2020 2020  e user name.    \n-00008e00: 2028 2272 6563 6970 4074 6865 2e64 6573   (\"recip@the.des\n-00008e10: 742e 636f 6d22 2920 6f72 2074 6865 206b  t.com\") or the k\n-00008e20: 6579 2049 4420 2822 3545 5858 5858 4343  ey ID (\"5EXXXXCC\n-00008e30: 2229 2e20 4174 2070 7265 7365 6e74 2c0a  \"). At present,.\n-00008e40: 2020 2020 206d 756c 7469 706c 6520 7265       multiple re\n-00008e50: 6369 7069 656e 7473 2061 7265 206e 6f74  cipients are not\n-00008e60: 2073 7570 706f 7274 6564 2e0a 0a20 2d2d   supported... --\n-00008e70: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f\n-00008e80: 6b6f 5f73 6574 5f67 7067 5f73 6967 6e65  ko_set_gpg_signe\n-00008e90: 7220 2866 6b6f 5f63 7478 5f74 2043 5458  r (fko_ctx_t CTX\n-00008ea0: 2c20 636f 6e73 7420 6368 6172 2053 4947  , const char SIG\n-00008eb0: 4e45 5229 3b0a 2020 2020 2053 6574 7320  NER);.     Sets \n-00008ec0: 7468 6520 4750 4720 6b65 7920 666f 7220  the GPG key for \n-00008ed0: 7369 676e 696e 6720 7468 6520 6461 7461  signing the data\n-00008ee0: 2e20 2054 6869 7320 776f 756c 6420 6265  .  This would be\n-00008ef0: 2074 6865 2073 656e 6465 7227 730a 2020   the sender's.  \n-00008f00: 2020 206b 6579 2075 7365 6420 746f 2073     key used to s\n-00008f10: 6967 6e20 7468 6520 5350 4120 6461 7461  ign the SPA data\n-00008f20: 2e20 2059 6f75 2063 616e 2075 7365 2074  .  You can use t\n-00008f30: 6865 2075 7365 7220 6e61 6d65 206f 7220  he user name or \n-00008f40: 6b65 790a 2020 2020 2049 442e 0a0a 202d  key.     ID... -\n-00008f50: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int \n-00008f60: 666b 6f5f 7365 745f 6770 675f 686f 6d65  fko_set_gpg_home\n-00008f70: 5f64 6972 2028 666b 6f5f 6374 785f 7420  _dir (fko_ctx_t \n-00008f80: 4354 582c 2063 6f6e 7374 2063 6861 720a  CTX, const char.\n-00008f90: 2020 2020 2020 2020 2020 484f 4d45 5f44            HOME_D\n-00008fa0: 4952 293b 0a20 2020 2020 5365 7473 2074  IR);.     Sets t\n-00008fb0: 6865 2047 5047 2068 6f6d 6520 6469 7265  he GPG home dire\n-00008fc0: 6374 6f72 7920 666f 7220 7468 6520 6375  ctory for the cu\n-00008fd0: 7272 656e 7420 6770 676d 6520 636f 6e74  rrent gpgme cont\n-00008fe0: 6578 742e 2020 5468 6973 0a20 2020 2020  ext.  This.     \n-00008ff0: 616c 6c6f 7773 2066 6f72 2075 7369 6e67  allows for using\n-00009000: 2061 6c74 6572 6e61 7465 206b 6579 7269   alternate keyri\n-00009010: 6e67 732c 2067 7067 2063 6f6e 6669 6775  ngs, gpg configu\n-00009020: 7261 7469 6f6e 732c 2065 7463 2e0a 0a20  rations, etc... \n-00009030: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int\n-00009040: 2066 6b6f 5f73 6574 5f67 7067 5f73 6967   fko_set_gpg_sig\n-00009050: 6e61 7475 7265 5f76 6572 6966 7920 2866  nature_verify (f\n-00009060: 6b6f 5f63 7478 5f74 2043 5458 2c20 756e  ko_ctx_t CTX, un\n-00009070: 7369 676e 6564 0a20 2020 2020 2020 2020  signed.         \n-00009080: 2063 6861 7220 5645 5249 4659 293b 0a20   char VERIFY);. \n-00009090: 2020 2020 5365 7473 2074 6865 2076 6572      Sets the ver\n-000090a0: 6966 7920 4750 4720 7369 676e 6174 7572  ify GPG signatur\n-000090b0: 6520 666c 6167 2e20 2057 6865 6e20 7365  e flag.  When se\n-000090c0: 7420 746f 2061 2074 7275 6520 7661 6c75  t to a true valu\n-000090d0: 652c 2074 6865 0a20 2020 2020 4750 4720  e, the.     GPG \n-000090e0: 7369 676e 6174 7572 6520 6973 2065 7874  signature is ext\n-000090f0: 7261 6374 6564 2061 6e64 2063 6865 636b  racted and check\n-00009100: 6564 2066 6f72 2076 616c 6964 6974 7920  ed for validity \n-00009110: 6475 7269 6e67 2074 6865 0a20 2020 2020  during the.     \n-00009120: 6465 6372 7970 7469 6f6e 2f64 6563 6f64  decryption/decod\n-00009130: 696e 6720 7068 6173 652e 2020 5768 656e  ing phase.  When\n-00009140: 2073 6574 2074 6f20 6661 6c73 652c 206e   set to false, n\n-00009150: 6f20 6174 7465 6d70 7420 6973 206d 6164  o attempt is mad\n-00009160: 650a 2020 2020 2074 6f20 6163 6365 7373  e.     to access\n-00009170: 206f 7220 6368 6563 6b20 7468 6520 7369   or check the si\n-00009180: 676e 6174 7572 652e 2020 5468 6973 2066  gnature.  This f\n-00009190: 6c61 6720 6973 2073 6574 2074 6f20 7472  lag is set to tr\n-000091a0: 7565 2062 790a 2020 2020 2064 6566 6175  ue by.     defau\n-000091b0: 6c74 2e0a 0a20 2d2d 2046 756e 6374 696f  lt... -- Functio\n-000091c0: 6e3a 2069 6e74 2066 6b6f 5f73 6574 5f67  n: int fko_set_g\n-000091d0: 7067 5f69 676e 6f72 655f 7665 7269 6679  pg_ignore_verify\n-000091e0: 5f65 7272 6f72 2028 666b 6f5f 6374 785f  _error (fko_ctx_\n-000091f0: 7420 4354 582c 0a20 2020 2020 2020 2020  t CTX,.         \n-00009200: 2075 6e73 6967 6e65 6420 6368 6172 2049   unsigned char I\n-00009210: 474e 4f52 4529 3b0a 2020 2020 2053 6574  GNORE);.     Set\n-00009220: 7320 7468 6520 6967 6e6f 7265 2073 6967  s the ignore sig\n-00009230: 6e61 7475 7265 2076 6572 6966 7920 6572  nature verify er\n-00009240: 726f 7220 666c 6167 2e20 2057 6865 6e20  ror flag.  When \n-00009250: 7365 7420 746f 2061 2074 7275 650a 2020  set to a true.  \n-00009260: 2020 2076 616c 7565 2e20 2041 6e79 2073     value.  Any s\n-00009270: 6967 6e61 7475 7265 2076 6572 6966 6963  ignature verific\n-00009280: 6174 696f 6e20 6572 726f 7273 2061 7265  ation errors are\n-00009290: 2069 676e 6f72 6564 2028 6275 7420 7374   ignored (but st\n-000092a0: 696c 6c0a 2020 2020 2063 6170 7475 7265  ill.     capture\n-000092b0: 6429 2061 6e64 2074 6865 2064 6563 6f64  d) and the decod\n-000092c0: 696e 6720 7072 6f63 6573 7320 7769 6c6c  ing process will\n-000092d0: 2063 6f6e 7469 6e75 652e 2020 5468 6520   continue.  The \n-000092e0: 6465 6661 756c 740a 2020 2020 2076 616c  default.     val\n-000092f0: 7565 206f 6620 7468 6973 2066 6c61 6720  ue of this flag \n-00009300: 6973 2066 616c 7365 2e0a 0a20 2d2d 2046  is false... -- F\n-00009310: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko\n-00009320: 5f73 6574 5f67 7067 5f65 7865 2028 666b  _set_gpg_exe (fk\n-00009330: 6f5f 6374 785f 7420 4354 582c 2063 6f6e  o_ctx_t CTX, con\n-00009340: 7374 2063 6861 7220 4750 475f 4558 4529  st char GPG_EXE)\n-00009350: 3b0a 2020 2020 2053 6574 7320 7468 6520  ;.     Sets the \n-00009360: 7061 7468 2074 6f20 7468 6520 4750 4720  path to the GPG \n-00009370: 6578 6563 7574 6162 6c65 2074 6861 7420  executable that \n-00009380: 5f67 7067 6d65 5f20 7769 6c6c 2075 7365  _gpgme_ will use\n-00009390: 2e20 2042 790a 2020 2020 2064 6566 6175  .  By.     defau\n-000093a0: 6c74 2c20 5f6c 6962 666b 6f5f 2066 6f72  lt, _libfko_ for\n-000093b0: 6365 7320 5f67 7067 6d65 5f20 746f 2075  ces _gpgme_ to u\n-000093c0: 7365 2027 6770 6727 2069 6e20 6361 7365  se 'gpg' in case\n-000093d0: 205f 6770 676d 655f 2077 6173 0a20 2020   _gpgme_ was.   \n-000093e0: 2020 636f 6d70 696c 6564 2074 6f20 7573    compiled to us\n-000093f0: 6520 2767 7067 3227 2061 7320 6974 7320  e 'gpg2' as its \n-00009400: 6465 6661 756c 7420 656e 6769 6e65 2e20  default engine. \n-00009410: 2059 6f75 2063 616e 2075 7365 2074 6869   You can use thi\n-00009420: 730a 2020 2020 2066 756e 6374 696f 6e20  s.     function \n-00009430: 746f 206f 7665 7272 6964 6520 616e 6420  to override and \n-00009440: 7365 7420 7768 6174 2047 5047 2065 7865  set what GPG exe\n-00009450: 6375 7461 626c 6520 5f67 7067 6d65 5f20  cutable _gpgme_ \n-00009460: 7769 6c6c 2075 7365 2e0a 0a2a 4e6f 7465  will use...*Note\n-00009470: 2a3a 204f 6e20 6120 6c69 6266 6b6f 2062  *: On a libfko b\n-00009480: 7569 6c64 2077 6974 686f 7574 2047 5047  uild without GPG\n-00009490: 2073 7570 706f 7274 2c20 7468 6520 4750   support, the GP\n-000094a0: 472d 7265 6c61 7465 6420 6675 6e63 7469  G-related functi\n-000094b0: 6f6e 730a 6162 6f76 6520 7769 6c6c 2073  ons.above will s\n-000094c0: 696d 706c 7920 7265 7475 726e 2074 6865  imply return the\n-000094d0: 2046 4b4f 5f45 5252 4f52 5f55 4e53 5550   FKO_ERROR_UNSUP\n-000094e0: 504f 5254 4544 5f46 4541 5455 5245 2065  PORTED_FEATURE e\n-000094f0: 7272 6f72 2063 6f64 652e 0a0a 1f0a 4669  rror code.....Fi\n-00009500: 6c65 3a20 6c69 6266 6b6f 2e69 6e66 6f2c  le: libfko.info,\n-00009510: 2020 4e6f 6465 3a20 5265 7472 6965 7669    Node: Retrievi\n-00009520: 6e67 2053 5041 2044 6174 612c 2020 4e65  ng SPA Data,  Ne\n-00009530: 7874 3a20 5574 696c 6974 7920 4675 6e63  xt: Utility Func\n-00009540: 7469 6f6e 732c 2020 5072 6576 3a20 5365  tions,  Prev: Se\n-00009550: 7474 696e 6720 5350 4120 4461 7461 2c20  tting SPA Data, \n-00009560: 2055 703a 2055 7369 6e67 206c 6962 666b   Up: Using libfk\n-00009570: 6f0a 0a33 2e35 2052 6574 7269 6576 696e  o..3.5 Retrievin\n-00009580: 6720 5350 4120 4461 7461 0a3d 3d3d 3d3d  g SPA Data.=====\n+00006540: 0a0a 5468 6973 2073 6563 7469 6f6e 2064  ..This section d\n+00006550: 6573 6372 6962 6573 2074 6865 2070 726f  escribes the pro\n+00006560: 6365 7373 2066 6f72 2063 7265 6174 696e  cess for creatin\n+00006570: 6720 6120 6e65 7720 666b 6f20 5350 4120  g a new fko SPA \n+00006580: 6d65 7373 6167 652e 0a41 6674 6572 2063  message..After c\n+00006590: 7265 6174 696e 6720 6120 636f 6e74 6578  reating a contex\n+000065a0: 742c 2074 6865 7265 2061 7265 2073 7469  t, there are sti\n+000065b0: 6c6c 2073 6f6d 6520 7265 7175 6973 6974  ll some requisit\n+000065c0: 6520 5350 4120 6461 7461 2066 6965 6c64  e SPA data field\n+000065d0: 730a 616e 6420 5350 4120 7061 7261 6d65  s.and SPA parame\n+000065e0: 7465 7273 2074 6861 7420 6e65 6564 2074  ters that need t\n+000065f0: 6f20 6265 2073 6574 2062 6566 6f72 6520  o be set before \n+00006600: 7468 6520 6669 6e61 6c20 656e 6372 7970  the final encryp\n+00006610: 7465 640a 6d65 7373 6167 6520 6973 2072  ted.message is r\n+00006620: 6561 6479 2e0a 0a20 2020 5468 6520 666f  eady...   The fo\n+00006630: 6c6c 6f77 696e 6720 6c69 7374 2063 6f6e  llowing list con\n+00006640: 7461 696e 7320 7468 6520 6d69 6e69 6d75  tains the minimu\n+00006650: 6d20 7265 7175 6972 6564 2066 6965 6c64  m required field\n+00006660: 7320 666f 7220 610a 636f 6d70 6c65 7465  s for a.complete\n+00006670: 2066 6b6f 2053 5041 206d 6573 7361 6765   fko SPA message\n+00006680: 2e20 2059 6f75 2073 686f 756c 6420 616c  .  You should al\n+00006690: 736f 2074 616b 6520 6e6f 7465 206f 6620  so take note of \n+000066a0: 7468 6520 6f72 6465 7220 6f66 0a74 6865  the order of.the\n+000066b0: 7365 2070 6172 616d 6574 6572 7320 6173  se parameters as\n+000066c0: 2077 656c 6c2e 2020 5365 7474 696e 6720   well.  Setting \n+000066d0: 7468 6520 2274 7970 6522 2070 6172 616d  the \"type\" param\n+000066e0: 6574 6572 7320 6669 7273 7420 6973 0a72  eters first is.r\n+000066f0: 6563 6f6d 6d65 6e64 6564 2028 6966 2079  ecommended (if y\n+00006700: 6f75 2077 616e 7420 6120 7479 7065 206f  ou want a type o\n+00006710: 7468 6572 2074 6861 6e20 7468 6520 6465  ther than the de\n+00006720: 6661 756c 7429 2e0a 0a20 2020 2a20 6469  fault)...   * di\n+00006730: 6765 7374 5f74 7970 6520 2d20 5f28 6465  gest_type - _(de\n+00006740: 6661 756c 7420 6d61 7920 7375 6666 6963  fault may suffic\n+00006750: 6529 5f0a 2020 202a 206d 6573 7361 6765  e)_.   * message\n+00006760: 5f74 7970 6520 2d20 5f28 6465 6661 756c  _type - _(defaul\n+00006770: 7420 6d61 7920 7375 6666 6963 6529 5f0a  t may suffice)_.\n+00006780: 2020 202a 2065 6e63 7279 7074 696f 6e5f     * encryption_\n+00006790: 7479 7065 202d 205f 2864 6566 6175 6c74  type - _(default\n+000067a0: 206d 6179 2073 7566 6669 6365 295f 0a20   may suffice)_. \n+000067b0: 2020 2a20 7261 6e64 5f76 616c 202d 205f    * rand_val - _\n+000067c0: 2864 6566 6175 6c74 2073 686f 756c 6420  (default should \n+000067d0: 7375 6666 6963 6529 5f0a 2020 202a 2074  suffice)_.   * t\n+000067e0: 696d 655f 7374 616d 7020 2d20 5f28 6465  ime_stamp - _(de\n+000067f0: 6661 756c 7420 7368 6f75 6c64 2073 7566  fault should suf\n+00006800: 6669 6365 295f 0a20 2020 2a20 7573 6572  fice)_.   * user\n+00006810: 6e61 6d65 202d 205f 2864 6566 6175 6c74  name - _(default\n+00006820: 206d 6179 2073 7566 6669 6365 295f 0a20   may suffice)_. \n+00006830: 2020 2a20 7370 615f 6d65 7373 6167 6520    * spa_message \n+00006840: 2d20 5f28 6d75 7374 2062 6520 6578 706c  - _(must be expl\n+00006850: 6963 6974 6c79 2073 6574 295f 0a0a 5f49  icitly set)_.._I\n+00006860: 6620 7573 696e 6720 6770 6720 656e 6372  f using gpg encr\n+00006870: 7970 7469 6f6e 3a5f 0a0a 2020 202a 2067  yption:_..   * g\n+00006880: 7067 5f72 6563 6970 6965 6e74 202d 205f  pg_recipient - _\n+00006890: 286d 7573 7420 6265 2065 7870 6c69 6369  (must be explici\n+000068a0: 746c 7920 7365 7429 5f0a 2020 202a 2067  tly set)_.   * g\n+000068b0: 7067 5f73 6967 6e65 7220 2d20 5f28 6f70  pg_signer - _(op\n+000068c0: 7469 6f6e 616c 2c20 6275 7420 7265 636f  tional, but reco\n+000068d0: 6d6d 656e 6465 6420 2d20 6d75 7374 2062  mmended - must b\n+000068e0: 6520 6578 706c 6963 6974 6c79 2073 6574  e explicitly set\n+000068f0: 0a20 2020 2020 6966 2075 7365 6429 5f0a  .     if used)_.\n+00006900: 2020 202a 2067 7067 5f68 6f6d 655f 6469     * gpg_home_di\n+00006910: 7220 2d20 5f28 6465 6661 756c 7420 6d61  r - _(default ma\n+00006920: 7920 7375 6666 6963 6520 2d20 7479 7069  y suffice - typi\n+00006930: 6361 6c6c 7920 2448 4f4d 452f 2e67 6e75  cally $HOME/.gnu\n+00006940: 7067 295f 0a0a 2020 2057 6865 6e20 6120  pg)_..   When a \n+00006950: 636f 6e74 6578 7420 6973 2069 6e69 7469  context is initi\n+00006960: 616c 697a 6564 2c20 736f 6d65 206f 6620  alized, some of \n+00006970: 7468 6520 5350 4120 6461 7461 2066 6965  the SPA data fie\n+00006980: 6c64 7320 6172 650a 7072 652d 7365 7420  lds are.pre-set \n+00006990: 7769 7468 2064 6566 6175 6c74 2076 616c  with default val\n+000069a0: 7565 7320 282a 6e6f 7465 2053 5041 2044  ues (*note SPA D\n+000069b0: 6174 6120 466f 726d 6174 3a3a 292e 2020  ata Format::).  \n+000069c0: 466f 7220 6669 656c 6473 2073 7563 680a  For fields such.\n+000069d0: 6173 2027 7261 6e64 5f76 616c 272c 2027  as 'rand_val', '\n+000069e0: 7573 6572 6e61 6d65 272c 2027 7469 6d65  username', 'time\n+000069f0: 7374 616d 7027 2c20 276d 6573 7361 6765  stamp', 'message\n+00006a00: 5f74 7970 6527 2c20 616e 640a 2764 6967  _type', and.'dig\n+00006a10: 6573 745f 7479 7065 272c 2074 6865 7365  est_type', these\n+00006a20: 2064 6566 6175 6c74 7320 6d61 7920 6265   defaults may be\n+00006a30: 2073 7566 6669 6369 656e 742e 0a0a 2020   sufficient...  \n+00006a40: 2054 6865 2066 756e 6374 696f 6e73 2075   The functions u\n+00006a50: 7365 6420 746f 2073 6574 2074 6865 2076  sed to set the v\n+00006a60: 6172 696f 7573 2053 5041 2064 6174 6120  arious SPA data \n+00006a70: 6669 656c 6473 2061 6e64 2070 6172 616d  fields and param\n+00006a80: 6574 6572 730a 6172 6520 6465 7363 7269  eters.are descri\n+00006a90: 6265 6420 696e 2064 6574 6169 6c20 696e  bed in detail in\n+00006aa0: 202a 6e6f 7465 2053 6574 7469 6e67 2053   *note Setting S\n+00006ab0: 5041 2044 6174 613a 3a2e 0a0a 2a4e 6f74  PA Data::...*Not\n+00006ac0: 652a 3a20 4174 7465 6d70 7473 2074 6f20  e*: Attempts to \n+00006ad0: 6361 6c6c 2061 6e79 2022 2766 6b6f 5f27  call any \"'fko_'\n+00006ae0: 2220 6675 6e63 7469 6f6e 206f 6e20 6120  \" function on a \n+00006af0: 636f 6e74 6578 7420 7468 6174 2068 6173  context that has\n+00006b00: 206e 6f74 0a62 6565 6e20 696e 6974 6961   not.been initia\n+00006b10: 6c69 7a65 6420 6361 6e20 6861 7665 2075  lized can have u\n+00006b20: 6e64 6566 696e 6564 2063 6f6e 7365 7175  ndefined consequ\n+00006b30: 656e 6365 732e 2020 4c69 6266 6b6f 2077  ences.  Libfko w\n+00006b40: 696c 6c20 6174 7465 6d70 740a 746f 2072  ill attempt.to r\n+00006b50: 6563 6f76 6572 2c20 616e 6420 6966 2073  ecover, and if s\n+00006b60: 7563 6365 7373 6675 6c2c 2077 696c 6c20  uccessful, will \n+00006b70: 7265 7475 726e 2061 2073 7461 7475 7320  return a status \n+00006b80: 6f66 0a27 464b 4f5f 4552 524f 525f 4354  of.'FKO_ERROR_CT\n+00006b90: 585f 4e4f 545f 494e 4954 4941 4c49 5a45  X_NOT_INITIALIZE\n+00006ba0: 4427 2e0a 0a20 2020 4120 636f 6d6d 6f6e  D'...   A common\n+00006bb0: 2053 5041 206d 6573 7361 6765 2069 7320   SPA message is \n+00006bc0: 6120 7369 6d70 6c65 2061 6363 6573 7320  a simple access \n+00006bd0: 7265 7175 6573 742e 2020 5468 6973 2072  request.  This r\n+00006be0: 6571 7565 7374 2061 736b 730a 7468 6520  equest asks.the \n+00006bf0: 6677 6b6e 6f70 2073 6572 7665 7220 746f  fwknop server to\n+00006c00: 2063 7265 6174 6520 6120 7465 6d70 6f72   create a tempor\n+00006c10: 6172 7920 6669 7265 7761 6c6c 2072 756c  ary firewall rul\n+00006c20: 6520 746f 2061 6c6c 6f77 2061 0a70 6172  e to allow a.par\n+00006c30: 7469 6375 6c61 7220 4950 2061 6464 7265  ticular IP addre\n+00006c40: 7373 2061 6363 6573 7320 746f 2061 2070  ss access to a p\n+00006c50: 6172 7469 6375 6c61 7220 706f 7274 206f  articular port o\n+00006c60: 6e20 7468 6520 6677 6b6e 6f70 2073 6572  n the fwknop ser\n+00006c70: 7665 722e 0a41 7373 756d 696e 6720 7468  ver..Assuming th\n+00006c80: 6520 6465 6661 756c 7473 2061 7265 2066  e defaults are f\n+00006c90: 696e 6520 666f 7220 7468 6973 2c20 616c  ine for this, al\n+00006ca0: 6c20 7765 206e 6565 6420 746f 2064 6f20  l we need to do \n+00006cb0: 6973 2063 7265 6174 6520 7468 650a 636f  is create the.co\n+00006cc0: 6e74 6578 742c 2073 6574 2074 6865 206d  ntext, set the m\n+00006cd0: 6573 7361 6765 2064 6174 6120 6669 656c  essage data fiel\n+00006ce0: 642c 2063 616c 6c20 7468 6520 2766 6b6f  d, call the 'fko\n+00006cf0: 5f73 7061 5f64 6174 615f 6669 6e61 6c27  _spa_data_final'\n+00006d00: 0a66 756e 6374 696f 6e20 746f 2065 6e63  .function to enc\n+00006d10: 6f64 6520 616e 6420 656e 6372 7970 742c  ode and encrypt,\n+00006d20: 2070 726f 6365 7373 2074 6865 206d 6573   process the mes\n+00006d30: 7361 6765 2c20 7468 656e 2064 6573 7472  sage, then destr\n+00006d40: 6f79 2074 6865 0a63 6f6e 7465 7874 2e20  oy the.context. \n+00006d50: 2042 656c 6f77 2c20 7765 2068 6176 6520   Below, we have \n+00006d60: 6120 636f 6e74 7269 7665 6420 6269 7420  a contrived bit \n+00006d70: 6f66 2063 6f64 6520 6465 6d6f 6e73 7472  of code demonstr\n+00006d80: 6174 696e 6720 7468 6973 3a0a 0a20 2020  ating this:..   \n+00006d90: 2020 696e 740a 2020 2020 206d 6169 6e28    int.     main(\n+00006da0: 696e 7420 6172 6763 2c20 6368 6172 202a  int argc, char *\n+00006db0: 2a61 7267 7629 0a20 2020 2020 7b0a 2020  *argv).     {.  \n+00006dc0: 2020 2020 2020 2066 6b6f 5f63 7478 5f74         fko_ctx_t\n+00006dd0: 2020 2063 7478 3b20 2020 2020 2020 2020     ctx;         \n+00006de0: 2020 2f2a 2046 4b4f 2043 6f6e 7465 7874    /* FKO Context\n+00006df0: 202a 2f0a 2020 2020 2020 2020 2063 6861   */.         cha\n+00006e00: 7220 2020 2020 2020 2a6b 6579 3b20 2020  r       *key;   \n+00006e10: 2020 2020 2020 2020 2f2a 2045 6e63 7279          /* Encry\n+00006e20: 7074 696f 6e20 7061 7373 7068 7261 7365  ption passphrase\n+00006e30: 202a 2f0a 2020 2020 2020 2020 2063 6861   */.         cha\n+00006e40: 7220 2020 2020 2020 2a68 6d61 635f 6b65  r       *hmac_ke\n+00006e50: 793b 2020 2020 2020 2f2a 2048 4d41 4320  y;      /* HMAC \n+00006e60: 6b65 7920 2a2f 0a20 2020 2020 2020 2020  key */.         \n+00006e70: 6368 6172 2020 2020 2020 202a 6669 6e61  char       *fina\n+00006e80: 6c5f 7370 613b 2020 2020 202f 2a20 4669  l_spa;     /* Fi\n+00006e90: 6e61 6c20 656e 6372 7970 7465 6420 5350  nal encrypted SP\n+00006ea0: 4120 6461 7461 202a 2f0a 2020 2020 2020  A data */.      \n+00006eb0: 2020 2069 6e74 2020 2020 2020 2020 206b     int         k\n+00006ec0: 6579 5f6c 656e 3b20 2020 2020 2020 2f2a  ey_len;       /*\n+00006ed0: 204c 656e 6774 6820 6f66 2065 6e63 7279   Length of encry\n+00006ee0: 7074 696f 6e20 6b65 7920 2a2f 0a20 2020  ption key */.   \n+00006ef0: 2020 2020 2020 696e 7420 2020 2020 2020        int       \n+00006f00: 2020 686d 6163 5f6b 6579 5f6c 656e 3b20    hmac_key_len; \n+00006f10: 202f 2a20 4c65 6e67 7468 206f 6620 484d   /* Length of HM\n+00006f20: 4143 206b 6579 202a 2f0a 2020 2020 2020  AC key */.      \n+00006f30: 2020 2069 6e74 2020 2020 2020 2020 2072     int         r\n+00006f40: 633b 2020 2020 2020 2020 2020 2020 2f2a  c;            /*\n+00006f50: 2052 6573 756c 7420 636f 6465 202a 2f0a   Result code */.\n+00006f60: 2020 2020 2020 2020 2069 6e74 2020 2020           int    \n+00006f70: 2020 2020 2068 6d61 635f 7479 7065 203d       hmac_type =\n+00006f80: 2046 4b4f 5f48 4d41 435f 5348 4132 3536   FKO_HMAC_SHA256\n+00006f90: 3b20 2020 2f2a 2044 6566 6175 6c74 2048  ;   /* Default H\n+00006fa0: 4d41 4320 6469 6765 7374 202a 2f0a 2020  MAC digest */.  \n+00006fb0: 2020 2020 2020 2069 6e74 2020 2020 2020         int      \n+00006fc0: 2020 2065 6e63 5f6d 6f64 6520 203d 2046     enc_mode  = F\n+00006fd0: 4b4f 5f45 4e43 5f4d 4f44 455f 4153 594d  KO_ENC_MODE_ASYM\n+00006fe0: 4d45 5452 4943 3b20 202f 2a20 5573 6520  METRIC;  /* Use \n+00006ff0: 4750 4720 2a2f 0a0a 2020 2020 2020 2020  GPG */..        \n+00007000: 202f 2a20 2041 7373 756d 6520 7765 2070   /*  Assume we p\n+00007010: 726f 6365 7373 6564 2074 6865 2063 6f6d  rocessed the com\n+00007020: 6d61 6e64 206c 696e 650a 2020 2020 2020  mand line.      \n+00007030: 2020 2020 2a20 2061 6e64 2072 6574 7269      *  and retri\n+00007040: 6576 6564 2074 6865 2070 6173 7377 6f72  eved the passwor\n+00007050: 6420 616e 6420 7468 6520 484d 4143 206b  d and the HMAC k\n+00007060: 6579 2061 6e64 0a20 2020 2020 2020 2020  ey and.         \n+00007070: 2a20 2020 7365 7420 7468 6569 7220 6173  *   set their as\n+00007080: 736f 6369 6174 6564 206c 656e 6774 6873  sociated lengths\n+00007090: 2e0a 2020 2020 2020 2020 202a 2f0a 0a20  ..         */.. \n+000070a0: 2020 2020 2020 2020 2f2a 2043 7265 6174          /* Creat\n+000070b0: 6520 7468 6520 636f 6e74 6578 7420 2a2f  e the context */\n+000070c0: 0a20 2020 2020 2020 2020 7263 203d 2066  .         rc = f\n+000070d0: 6b6f 5f6e 6577 2826 6374 7829 3b0a 2020  ko_new(&ctx);.  \n+000070e0: 2020 2020 2020 2069 6628 7263 2021 3d20         if(rc != \n+000070f0: 464b 4f5f 5355 4343 4553 5329 0a20 2020  FKO_SUCCESS).   \n+00007100: 2020 2020 2020 7b0a 2020 2020 2020 2020        {.        \n+00007110: 2020 2020 2066 7072 696e 7466 2873 7464       fprintf(std\n+00007120: 6572 722c 2022 4572 726f 7220 6372 6561  err, \"Error crea\n+00007130: 7469 6e67 2063 6f6e 7465 7874 3a20 2573  ting context: %s\n+00007140: 5c6e 222c 2066 6b6f 5f65 7272 7374 7228  \\n\", fko_errstr(\n+00007150: 7263 2929 3b0a 2020 2020 2020 2020 2020  rc));.          \n+00007160: 2020 2065 7869 7428 3129 3b0a 2020 2020     exit(1);.    \n+00007170: 2020 2020 207d 0a0a 2020 2020 2020 2020       }..        \n+00007180: 202f 2a20 5365 7420 7468 6520 5350 4120   /* Set the SPA \n+00007190: 6d65 7373 6167 6520 6669 656c 6420 2d20  message field - \n+000071a0: 6173 6b69 6e67 2074 6f20 6f70 656e 2074  asking to open t\n+000071b0: 6370 2070 6f72 7420 3232 0a20 2020 2020  cp port 22.     \n+000071c0: 2020 2020 202a 2066 6f72 2074 6865 2073       * for the s\n+000071d0: 7973 7465 6d20 6174 2031 3932 2e31 3638  ystem at 192.168\n+000071e0: 2e30 2e33 330a 2020 2020 2020 2020 202a  .0.33.         *\n+000071f0: 2f0a 2020 2020 2020 2020 2072 6320 3d20  /.         rc = \n+00007200: 666b 6f5f 7365 745f 7370 615f 6d65 7373  fko_set_spa_mess\n+00007210: 6167 6528 6374 782c 2022 3139 322e 3136  age(ctx, \"192.16\n+00007220: 382e 302e 3333 2c74 6370 2f32 3222 293b  8.0.33,tcp/22\");\n+00007230: 0a20 2020 2020 2020 2020 6966 2872 6320  .         if(rc \n+00007240: 213d 2046 4b4f 5f53 5543 4345 5353 290a  != FKO_SUCCESS).\n+00007250: 2020 2020 2020 2020 207b 0a20 2020 2020           {.     \n+00007260: 2020 2020 2020 2020 6670 7269 6e74 6628          fprintf(\n+00007270: 7374 6465 7272 2c20 2253 6574 2053 5041  stderr, \"Set SPA\n+00007280: 206d 6573 7361 6765 2066 6169 6c65 643a   message failed:\n+00007290: 2025 735c 6e22 2c20 666b 6f5f 6572 7273   %s\\n\", fko_errs\n+000072a0: 7472 2872 6329 293b 0a20 2020 2020 2020  tr(rc));.       \n+000072b0: 2020 2020 2020 6578 6974 2831 293b 0a20        exit(1);. \n+000072c0: 2020 2020 2020 2020 7d0a 0a20 2020 2020          }..     \n+000072d0: 2020 2020 2f2a 204c 6574 2075 7320 6173      /* Let us as\n+000072e0: 7375 6d65 2077 6520 6172 6520 7573 696e  sume we are usin\n+000072f0: 6720 4750 4720 656e 6372 7970 7469 6f6e  g GPG encryption\n+00007300: 2e20 2053 6f20 7765 206e 6565 6420 746f  .  So we need to\n+00007310: 0a20 2020 2020 2020 2020 202a 2073 6574  .          * set\n+00007320: 2074 6865 2065 6e63 7279 7074 696f 6e20   the encryption \n+00007330: 7479 7065 2061 6e64 2073 6574 2074 6865  type and set the\n+00007340: 2072 6571 7569 7265 6420 4750 4720 7061   required GPG pa\n+00007350: 7261 6d65 7465 7273 0a20 2020 2020 2020  rameters.       \n+00007360: 2020 202a 2028 7765 2063 616e 2073 6b69     * (we can ski\n+00007370: 7020 6368 6563 6b69 6e67 2072 6574 7572  p checking retur\n+00007380: 6e20 7661 6c75 6573 2066 6f72 2062 7265  n values for bre\n+00007390: 7669 7479 292e 0a20 2020 2020 2020 2020  vity)..         \n+000073a0: 2a2f 0a20 2020 2020 2020 2020 7263 203d  */.         rc =\n+000073b0: 2066 6b6f 5f73 6574 5f73 7061 5f65 6e63   fko_set_spa_enc\n+000073c0: 7279 7074 696f 6e5f 7479 7065 2863 7478  ryption_type(ctx\n+000073d0: 2c20 464b 4f5f 454e 4352 5950 5449 4f4e  , FKO_ENCRYPTION\n+000073e0: 5f47 5047 293b 0a0a 2020 2020 2020 2020  _GPG);..        \n+000073f0: 202f 2a20 4b65 7920 666f 7220 7468 6520   /* Key for the \n+00007400: 7265 6369 7069 656e 7420 2a2f 0a20 2020  recipient */.   \n+00007410: 2020 2020 2020 7263 203d 2066 6b6f 5f73        rc = fko_s\n+00007420: 6574 5f67 7067 5f72 6563 6970 6965 6e74  et_gpg_recipient\n+00007430: 2863 7478 2c20 2272 6563 6970 4073 6f6d  (ctx, \"recip@som\n+00007440: 652e 7768 6572 6522 293b 0a0a 2020 2020  e.where\");..    \n+00007450: 2020 2020 202f 2a20 4b65 7920 666f 7220       /* Key for \n+00007460: 7468 6520 7369 676e 6572 2028 6966 2079  the signer (if y\n+00007470: 6f75 2077 616e 7420 746f 2073 6967 6e20  ou want to sign \n+00007480: 6974 2920 2a2f 0a20 2020 2020 2020 2020  it) */.         \n+00007490: 7263 203d 2066 6b6f 5f73 6574 5f67 7067  rc = fko_set_gpg\n+000074a0: 5f73 6967 6e65 7228 6374 782c 2022 6d65  _signer(ctx, \"me\n+000074b0: 4072 6967 6874 2e68 6572 6522 293b 0a0a  @right.here\");..\n+000074c0: 2020 2020 2020 2020 202f 2a20 4669 6e61           /* Fina\n+000074d0: 6c69 7a65 2074 6865 2053 5041 2064 6174  lize the SPA dat\n+000074e0: 6120 2a2f 0a20 2020 2020 2020 2020 7263  a */.         rc\n+000074f0: 203d 2066 6b6f 5f73 7061 5f64 6174 615f   = fko_spa_data_\n+00007500: 6669 6e61 6c28 6374 782c 206b 6579 2c20  final(ctx, key, \n+00007510: 6b65 795f 6c65 6e2c 2065 6e63 5f6d 6f64  key_len, enc_mod\n+00007520: 652c 0a20 2020 2020 2020 2020 2020 2020  e,.             \n+00007530: 2020 2020 686d 6163 5f6b 6579 2c20 686d      hmac_key, hm\n+00007540: 6163 5f6b 6579 5f6c 656e 2c20 686d 6163  ac_key_len, hmac\n+00007550: 5f74 7970 6529 3b0a 2020 2020 2020 2020  _type);.        \n+00007560: 2069 6628 7263 2021 3d20 464b 4f5f 5355   if(rc != FKO_SU\n+00007570: 4343 4553 5329 0a20 2020 2020 2020 2020  CCESS).         \n+00007580: 7b0a 2020 2020 2020 2020 2020 2020 2066  {.             f\n+00007590: 7072 696e 7466 2873 7464 6572 722c 2022  printf(stderr, \"\n+000075a0: 4572 726f 7220 656e 636f 6469 6e67 2053  Error encoding S\n+000075b0: 5041 2064 6174 613a 2025 735c 6e22 2c0a  PA data: %s\\n\",.\n+000075c0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n+000075d0: 2066 6b6f 5f65 7272 7374 7228 7263 2929   fko_errstr(rc))\n+000075e0: 3b0a 2020 2020 2020 2020 2020 2020 2065  ;.             e\n+000075f0: 7869 7428 3129 3b0a 2020 2020 2020 2020  xit(1);.        \n+00007600: 207d 0a0a 2020 2020 2020 2020 202f 2a20   }..         /* \n+00007610: 5461 6b65 2074 6865 2066 696e 616c 206d  Take the final m\n+00007620: 6573 7361 6765 2061 6e64 2064 6f20 736f  essage and do so\n+00007630: 6d65 7468 696e 6720 7769 7468 2069 7420  mething with it \n+00007640: 2a2f 0a20 2020 2020 2020 2020 7263 203d  */.         rc =\n+00007650: 2066 6b6f 5f67 6574 5f73 7061 5f64 6174   fko_get_spa_dat\n+00007660: 6128 6374 782c 2026 6669 6e61 6c5f 7370  a(ctx, &final_sp\n+00007670: 6129 3b0a 0a20 2020 2020 2020 2020 2f2a  a);..         /*\n+00007680: 2041 7373 756d 6520 7468 6973 2066 756e   Assume this fun\n+00007690: 6374 696f 6e20 7061 636b 7320 7468 6520  ction packs the \n+000076a0: 7370 6120 6461 7461 2069 6e74 6f20 6120  spa data into a \n+000076b0: 5544 500a 2020 2020 2020 2020 2020 2a20  UDP.          * \n+000076c0: 7061 636b 6574 2061 6e64 2073 656e 6473  packet and sends\n+000076d0: 2069 7420 746f 2074 6865 2073 6572 7665   it to the serve\n+000076e0: 722e 0a20 2020 2020 2020 2020 2a2f 0a20  r..         */. \n+000076f0: 2020 2020 2020 2020 7365 6e64 5f73 7061          send_spa\n+00007700: 5f6d 6573 7361 6765 2866 696e 616c 5f73  _message(final_s\n+00007710: 7061 293b 0a0a 2020 2020 2020 2020 202f  pa);..         /\n+00007720: 2a20 446f 6e65 2077 6974 6820 7468 6520  * Done with the \n+00007730: 636f 6e74 6578 7420 2a2f 0a20 2020 2020  context */.     \n+00007740: 2020 2020 666b 6f5f 6465 7374 726f 7928      fko_destroy(\n+00007750: 6374 7829 3b0a 0a20 2020 2020 2020 2020  ctx);..         \n+00007760: 6578 6974 2830 293b 0a20 2020 2020 7d0a  exit(0);.     }.\n+00007770: 0a1f 0a46 696c 653a 206c 6962 666b 6f2e  ...File: libfko.\n+00007780: 696e 666f 2c20 204e 6f64 653a 2053 6574  info,  Node: Set\n+00007790: 7469 6e67 2053 5041 2044 6174 612c 2020  ting SPA Data,  \n+000077a0: 4e65 7874 3a20 5265 7472 6965 7669 6e67  Next: Retrieving\n+000077b0: 2053 5041 2044 6174 612c 2020 5072 6576   SPA Data,  Prev\n+000077c0: 3a20 4372 6561 7469 6e67 2061 2053 5041  : Creating a SPA\n+000077d0: 204d 6573 7361 6765 2c20 2055 703a 2055   Message,  Up: U\n+000077e0: 7369 6e67 206c 6962 666b 6f0a 0a33 2e34  sing libfko..3.4\n+000077f0: 2053 6574 7469 6e67 2053 5041 2044 6174   Setting SPA Dat\n+00007800: 610a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  a.==============\n+00007810: 3d3d 3d3d 3d3d 0a0a 5468 6973 2073 6563  ======..This sec\n+00007820: 7469 6f6e 2064 6573 6372 6962 6573 2074  tion describes t\n+00007830: 6865 2066 756e 6374 696f 6e73 2075 7365  he functions use\n+00007840: 6420 666f 7220 7365 7474 696e 6720 7468  d for setting th\n+00007850: 6520 7661 7269 6f75 7320 5350 410a 6461  e various SPA.da\n+00007860: 7461 2066 6965 6c64 7320 616e 6420 7061  ta fields and pa\n+00007870: 7261 6d65 7465 7273 2e20 2041 6c6c 206f  rameters.  All o\n+00007880: 6620 7468 6573 6520 6675 6e63 7469 6f6e  f these function\n+00007890: 7320 7265 7475 726e 2061 6e20 696e 7465  s return an inte\n+000078a0: 6765 720a 7265 7072 6573 656e 7469 6e67  ger.representing\n+000078b0: 2074 6865 2072 6574 7572 6e20 7374 6174   the return stat\n+000078c0: 7573 206f 6620 7468 6520 6675 6e63 7469  us of the functi\n+000078d0: 6f6e 2e20 2057 6865 6e20 7375 6363 6573  on.  When succes\n+000078e0: 6675 6c6c 2c20 7468 6579 0a77 696c 6c20  full, they.will \n+000078f0: 7265 7475 726e 2027 464b 4f5f 5355 4343  return 'FKO_SUCC\n+00007900: 4553 5327 2e20 204f 7468 6572 7769 7365  ESS'.  Otherwise\n+00007910: 2c20 616e 2065 7272 6f72 2063 6f64 6520  , an error code \n+00007920: 7661 6c75 6520 6973 2072 6574 7572 6e65  value is returne\n+00007930: 642e 0a0a 202d 2d20 4675 6e63 7469 6f6e  d... -- Function\n+00007940: 3a20 696e 7420 666b 6f5f 7365 745f 7370  : int fko_set_sp\n+00007950: 615f 6469 6765 7374 5f74 7970 6520 2866  a_digest_type (f\n+00007960: 6b6f 5f63 7478 5f74 2043 5458 2c20 7368  ko_ctx_t CTX, sh\n+00007970: 6f72 740a 2020 2020 2020 2020 2020 4449  ort.          DI\n+00007980: 4745 5354 5f54 5950 4529 3b0a 2020 2020  GEST_TYPE);.    \n+00007990: 2053 6574 2074 6865 206d 6573 7361 6765   Set the message\n+000079a0: 2064 6967 6573 7420 7479 7065 2e20 2056   digest type.  V\n+000079b0: 616c 6964 2076 616c 7565 7320 6361 6e20  alid values can \n+000079c0: 6265 2066 6f75 6e64 2069 6e20 2a6e 6f74  be found in *not\n+000079d0: 650a 2020 2020 2044 6967 6573 7473 3a3a  e.     Digests::\n+000079e0: 206f 6620 7468 6973 206d 616e 7561 6c2e   of this manual.\n+000079f0: 2020 4966 2061 2076 616c 7565 206f 7468    If a value oth\n+00007a00: 6572 2074 6861 6e20 7468 6520 7468 6f73  er than the thos\n+00007a10: 6520 7468 6174 2061 7265 0a20 2020 2020  e that are.     \n+00007a20: 7375 7070 6f72 7465 6420 6973 2067 6976  supported is giv\n+00007a30: 656e 2c20 7468 6520 6675 6e63 7469 6f6e  en, the function\n+00007a40: 2077 696c 6c20 7265 7475 726e 0a20 2020   will return.   \n+00007a50: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n+00007a60: 414c 4944 5f44 4154 4127 2e20 2046 6f72  ALID_DATA'.  For\n+00007a70: 2065 7861 6d70 6c65 3a0a 2020 2020 2020   example:.      \n+00007a80: 2020 2020 2020 2020 7263 203d 2066 6b6f          rc = fko\n+00007a90: 5f73 6574 5f64 6967 6573 745f 7479 7065  _set_digest_type\n+00007aa0: 2863 7478 2c20 464b 4f5f 4449 4745 5354  (ctx, FKO_DIGEST\n+00007ab0: 5f53 4841 3129 3b0a 0a20 2d2d 2046 756e  _SHA1);.. -- Fun\n+00007ac0: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f73  ction: int fko_s\n+00007ad0: 6574 5f73 7061 5f68 6d61 635f 7479 7065  et_spa_hmac_type\n+00007ae0: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,\n+00007af0: 2073 686f 7274 0a20 2020 2020 2020 2020   short.         \n+00007b00: 2048 4d41 435f 5459 5045 293b 0a20 2020   HMAC_TYPE);.   \n+00007b10: 2020 5365 7420 7468 6520 6d65 7373 6167    Set the messag\n+00007b20: 6520 686d 6163 2074 7970 652e 2020 5661  e hmac type.  Va\n+00007b30: 6c69 6420 7661 6c75 6573 2063 616e 2062  lid values can b\n+00007b40: 6520 666f 756e 6420 696e 202a 6e6f 7465  e found in *note\n+00007b50: 2048 4d41 430a 2020 2020 2044 6967 6573   HMAC.     Diges\n+00007b60: 7473 3a3a 206f 6620 7468 6973 206d 616e  ts:: of this man\n+00007b70: 7561 6c2e 2020 4966 2061 2076 616c 7565  ual.  If a value\n+00007b80: 206f 7468 6572 2074 6861 6e20 7468 6520   other than the \n+00007b90: 7468 6f73 6520 7468 6174 2061 7265 0a20  those that are. \n+00007ba0: 2020 2020 7375 7070 6f72 7465 6420 6973      supported is\n+00007bb0: 2067 6976 656e 2c20 7468 6520 6675 6e63   given, the func\n+00007bc0: 7469 6f6e 2077 696c 6c20 7265 7475 726e  tion will return\n+00007bd0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n+00007be0: 5f49 4e56 414c 4944 5f44 4154 4127 2e20  _INVALID_DATA'. \n+00007bf0: 2046 6f72 2065 7861 6d70 6c65 3a0a 2020   For example:.  \n+00007c00: 2020 2020 2020 2020 2020 2020 7263 203d              rc =\n+00007c10: 2066 6b6f 5f73 6574 5f68 6d61 635f 7479   fko_set_hmac_ty\n+00007c20: 7065 2863 7478 2c20 464b 4f5f 484d 4143  pe(ctx, FKO_HMAC\n+00007c30: 5f53 4841 3235 3629 3b0a 0a20 2d2d 2046  _SHA256);.. -- F\n+00007c40: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko\n+00007c50: 5f73 6574 5f73 7061 5f65 6e63 7279 7074  _set_spa_encrypt\n+00007c60: 696f 6e5f 7479 7065 2028 666b 6f5f 6374  ion_type (fko_ct\n+00007c70: 785f 7420 4354 582c 2073 686f 7274 0a20  x_t CTX, short. \n+00007c80: 2020 2020 2020 2020 2045 4e43 5259 5054           ENCRYPT\n+00007c90: 5f54 5950 4529 3b0a 2020 2020 2053 6574  _TYPE);.     Set\n+00007ca0: 2074 6865 2065 6e63 7279 7469 6f6e 2061   the encrytion a\n+00007cb0: 6c67 6f72 6974 686d 2074 6f20 7573 6520  lgorithm to use \n+00007cc0: 7768 656e 2065 6372 7970 7469 6e67 2074  when ecrypting t\n+00007cd0: 6865 2066 696e 616c 2053 5041 0a20 2020  he final SPA.   \n+00007ce0: 2020 6461 7461 2e20 2056 616c 6964 2076    data.  Valid v\n+00007cf0: 616c 7565 7320 6361 6e20 6265 2066 6f75  alues can be fou\n+00007d00: 6e64 2069 6e20 2a6e 6f74 6520 456e 6372  nd in *note Encr\n+00007d10: 7970 7469 6f6e 2041 6c67 6f72 6974 686d  yption Algorithm\n+00007d20: 733a 3a0a 2020 2020 206f 6620 7468 6973  s::.     of this\n+00007d30: 206d 616e 7561 6c2e 2020 466f 7220 6578   manual.  For ex\n+00007d40: 616d 706c 653a 0a20 2020 2020 2020 2020  ample:.         \n+00007d50: 2020 2020 2072 6320 3d20 666b 6f5f 7365       rc = fko_se\n+00007d60: 745f 656e 6372 7970 7469 6f6e 5f74 7970  t_encryption_typ\n+00007d70: 6528 6374 782c 2046 4b4f 5f45 4e43 5259  e(ctx, FKO_ENCRY\n+00007d80: 5054 494f 4e5f 5249 4a4e 4441 454c 293b  PTION_RIJNDAEL);\n+00007d90: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: \n+00007da0: 696e 7420 666b 6f5f 7365 745f 7261 6e64  int fko_set_rand\n+00007db0: 5f76 616c 7565 2028 666b 6f5f 6374 785f  _value (fko_ctx_\n+00007dc0: 7420 4354 582c 2063 6f6e 7374 2063 6861  t CTX, const cha\n+00007dd0: 7220 2a56 414c 293b 0a20 2020 2020 5365  r *VAL);.     Se\n+00007de0: 7420 7468 6520 7261 6e64 6f6d 2076 616c  t the random val\n+00007df0: 7565 2070 6f72 7469 6f6e 206f 6620 7468  ue portion of th\n+00007e00: 6520 7370 6120 6461 7461 2074 6f20 7468  e spa data to th\n+00007e10: 6520 6769 7665 6e20 7661 6c75 650a 2020  e given value.  \n+00007e20: 2020 2028 5641 4c29 2e20 2054 6865 2067     (VAL).  The g\n+00007e30: 6976 656e 2076 616c 7565 206d 7573 7420  iven value must \n+00007e40: 6265 2061 2070 6f69 6e74 6572 2074 6f20  be a pointer to \n+00007e50: 6120 3136 2d63 6861 7261 6374 6572 2064  a 16-character d\n+00007e60: 6563 696d 616c 0a20 2020 2020 6e75 6d65  ecimal.     nume\n+00007e70: 7269 6320 7374 7269 6e67 206f 7220 4e55  ric string or NU\n+00007e80: 4c4c 2e20 4966 2074 6865 2076 616c 7565  LL. If the value\n+00007e90: 2069 7320 4e55 4c4c 2c20 7468 6520 6675   is NULL, the fu\n+00007ea0: 6e63 7469 6f6e 2067 656e 6572 6174 650a  nction generate.\n+00007eb0: 2020 2020 2061 206e 6577 2072 616e 646f       a new rando\n+00007ec0: 6d20 7661 6c75 652e 2020 4966 2061 2073  m value.  If a s\n+00007ed0: 7472 696e 6720 7661 6c75 6520 6973 2070  tring value is p\n+00007ee0: 726f 7669 6465 642c 2069 7420 6d75 7374  rovided, it must\n+00007ef0: 2062 6520 610a 2020 2020 2031 362d 6368   be a.     16-ch\n+00007f00: 6172 6163 7465 7220 6465 6369 6d61 6c20  aracter decimal \n+00007f10: 7374 7269 6e67 2e20 204f 7468 6572 7769  string.  Otherwi\n+00007f20: 7365 2c20 7468 6520 6675 6e63 7469 6f6e  se, the function\n+00007f30: 2077 696c 6c20 7265 7475 726e 0a20 2020   will return.   \n+00007f40: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n+00007f50: 414c 4944 5f44 4154 4127 2e0a 0a20 2d2d  ALID_DATA'... --\n+00007f60: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f\n+00007f70: 6b6f 5f73 6574 5f75 7365 726e 616d 6520  ko_set_username \n+00007f80: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, \n+00007f90: 636f 6e73 7420 6368 6172 0a20 2020 2020  const char.     \n+00007fa0: 2020 2020 202a 5553 4552 4e41 4d45 293b       *USERNAME);\n+00007fb0: 0a20 2020 2020 5365 7420 7468 6520 7573  .     Set the us\n+00007fc0: 6572 6e61 6d65 2066 6965 6c64 206f 6620  ername field of \n+00007fd0: 7468 6520 5350 4120 6461 7461 2e20 2049  the SPA data.  I\n+00007fe0: 6620 5553 4552 4e41 4d45 2069 7320 4e55  f USERNAME is NU\n+00007ff0: 4c4c 2c0a 2020 2020 206c 6962 666b 6f20  LL,.     libfko \n+00008000: 7769 6c6c 2066 6972 7374 206c 6f6f 6b20  will first look \n+00008010: 666f 7220 7468 6520 656e 7669 726f 6e6d  for the environm\n+00008020: 656e 7420 7661 7269 6162 6c65 2027 5350  ent variable 'SP\n+00008030: 4f4f 465f 5553 4552 270a 2020 2020 2061  OOF_USER'.     a\n+00008040: 6e64 2075 7365 2069 7473 2076 616c 7565  nd use its value\n+00008050: 2069 6620 666f 756e 642e 2020 4f74 6865   if found.  Othe\n+00008060: 7277 6973 652c 2069 7420 7769 6c6c 2074  rwise, it will t\n+00008070: 7279 2074 6f20 6465 7465 726d 696e 650a  ry to determine.\n+00008080: 2020 2020 2074 6865 2075 7365 726e 616d       the usernam\n+00008090: 6520 6974 7365 6c66 2075 7369 6e67 2076  e itself using v\n+000080a0: 6172 696f 7573 206d 6574 686f 6473 2073  arious methods s\n+000080b0: 7461 7274 696e 6720 7769 7468 2027 6375  tarting with 'cu\n+000080c0: 7365 7227 206f 720a 2020 2020 2027 6765  ser' or.     'ge\n+000080d0: 746c 6f67 696e 272c 2074 6865 6e20 6661  tlogin', then fa\n+000080e0: 6c6c 6261 636b 2074 6f20 7468 6520 656e  llback to the en\n+000080f0: 7669 726f 6e6d 656e 7420 7661 7269 6162  vironment variab\n+00008100: 6c65 7320 274c 4f47 4e41 4d45 2720 6f72  les 'LOGNAME' or\n+00008110: 0a20 2020 2020 2755 5345 5227 2e20 2049  .     'USER'.  I\n+00008120: 6620 6e6f 6e65 206f 6620 7468 6f73 6520  f none of those \n+00008130: 776f 726b 2c20 7468 6520 6675 6e63 7469  work, the functi\n+00008140: 6f6e 2077 696c 6c20 7265 7475 726e 0a20  on will return. \n+00008150: 2020 2020 2746 4b4f 5f45 5252 4f52 5f55      'FKO_ERROR_U\n+00008160: 5345 524e 414d 455f 554e 4b4e 4f57 4e27  SERNAME_UNKNOWN'\n+00008170: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:\n+00008180: 2069 6e74 2066 6b6f 5f73 6574 5f74 696d   int fko_set_tim\n+00008190: 6573 7461 6d70 2028 666b 6f5f 6374 785f  estamp (fko_ctx_\n+000081a0: 7420 4354 582c 2069 6e74 204f 4646 5345  t CTX, int OFFSE\n+000081b0: 5429 3b0a 2020 2020 2053 6574 7320 7468  T);.     Sets th\n+000081c0: 6520 7469 6d65 7374 616d 7020 7661 6c75  e timestamp valu\n+000081d0: 6520 6f66 2074 6865 2053 5041 2064 6174  e of the SPA dat\n+000081e0: 6120 746f 2074 6865 2063 7572 7265 6e74  a to the current\n+000081f0: 2074 696d 6520 706c 7573 0a20 2020 2020   time plus.     \n+00008200: 7468 6520 6f66 6673 6574 2076 616c 7565  the offset value\n+00008210: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:\n+00008220: 2069 6e74 2066 6b6f 5f73 6574 5f73 7061   int fko_set_spa\n+00008230: 5f6d 6573 7361 6765 5f74 7970 6520 2866  _message_type (f\n+00008240: 6b6f 5f63 7478 5f74 2043 5458 2c20 7368  ko_ctx_t CTX, sh\n+00008250: 6f72 740a 2020 2020 2020 2020 2020 4d53  ort.          MS\n+00008260: 475f 5459 5045 293b 0a20 2020 2020 5365  G_TYPE);.     Se\n+00008270: 7473 2074 6865 206d 6573 7361 6765 2074  ts the message t\n+00008280: 7970 6520 666f 7220 7468 6520 5350 4120  ype for the SPA \n+00008290: 6461 7461 2e20 2054 6865 2063 686f 6963  data.  The choic\n+000082a0: 6573 2066 6f72 2074 6865 0a20 2020 2020  es for the.     \n+000082b0: 2773 7061 5f6d 6573 7361 6765 5f74 7970  'spa_message_typ\n+000082c0: 6527 2061 7265 206c 6973 7465 6420 696e  e' are listed in\n+000082d0: 202a 6e6f 7465 2053 5041 204d 6573 7361   *note SPA Messa\n+000082e0: 6765 733a 3a2e 2020 466f 720a 2020 2020  ges::.  For.    \n+000082f0: 2065 7861 6d70 6c65 3a0a 2020 2020 2020   example:.      \n+00008300: 2020 2020 2020 2020 7263 203d 2066 6b6f          rc = fko\n+00008310: 5f73 6574 5f73 7061 5f6d 6573 7361 6765  _set_spa_message\n+00008320: 5f74 7970 6528 6374 782c 2046 4b4f 5f41  _type(ctx, FKO_A\n+00008330: 4343 4553 535f 4d53 4729 3b0a 0a20 2d2d  CCESS_MSG);.. --\n+00008340: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f\n+00008350: 6b6f 5f73 6574 5f73 7061 5f6d 6573 7361  ko_set_spa_messa\n+00008360: 6765 2028 666b 6f5f 6374 785f 7420 4354  ge (fko_ctx_t CT\n+00008370: 582c 2063 6f6e 7374 2063 6861 720a 2020  X, const char.  \n+00008380: 2020 2020 2020 2020 2a4d 5347 5f53 5452          *MSG_STR\n+00008390: 494e 4729 3b0a 2020 2020 2053 6574 2074  ING);.     Set t\n+000083a0: 6865 2053 5041 206d 6573 7361 6765 2073  he SPA message s\n+000083b0: 7472 696e 6720 746f 2074 6865 2067 6976  tring to the giv\n+000083c0: 656e 2076 616c 7565 2e20 2049 6620 7468  en value.  If th\n+000083d0: 6973 2073 7472 696e 6720 646f 6573 0a20  is string does. \n+000083e0: 2020 2020 6e6f 7420 636f 6e66 6f72 6d20      not conform \n+000083f0: 746f 2074 6865 2072 6571 7569 7265 6420  to the required \n+00008400: 2773 7061 5f6e 6174 5f61 6363 6573 7327  'spa_nat_access'\n+00008410: 2066 6f72 6d61 742c 2074 6865 2066 756e   format, the fun\n+00008420: 6374 696f 6e0a 2020 2020 2077 696c 6c20  ction.     will \n+00008430: 7265 7475 726e 2027 464b 4f5f 4552 524f  return 'FKO_ERRO\n+00008440: 525f 494e 5641 4c49 445f 4441 5441 272e  R_INVALID_DATA'.\n+00008450: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: \n+00008460: 696e 7420 666b 6f5f 7365 745f 7370 615f  int fko_set_spa_\n+00008470: 6e61 745f 6163 6365 7373 2028 666b 6f5f  nat_access (fko_\n+00008480: 6374 785f 7420 4354 582c 2063 6f6e 7374  ctx_t CTX, const\n+00008490: 2063 6861 720a 2020 2020 2020 2020 2020   char.          \n+000084a0: 2a4e 4154 5f41 4343 4553 5329 3b0a 2020  *NAT_ACCESS);.  \n+000084b0: 2020 2053 6574 2074 6865 206f 7074 696f     Set the optio\n+000084c0: 6e61 6c20 5350 4120 6e61 7420 6163 6365  nal SPA nat acce\n+000084d0: 7373 2073 7472 696e 6720 746f 2074 6865  ss string to the\n+000084e0: 2067 6976 656e 2076 616c 7565 2e20 2049   given value.  I\n+000084f0: 6620 7468 6973 0a20 2020 2020 7374 7269  f this.     stri\n+00008500: 6e67 2064 6f65 7320 6e6f 7420 636f 6e66  ng does not conf\n+00008510: 6f72 6d20 746f 2074 6865 2072 6571 7569  orm to the requi\n+00008520: 7265 6420 2773 7061 5f6e 6174 5f61 6363  red 'spa_nat_acc\n+00008530: 6573 7327 2066 6f72 6d61 742c 0a20 2020  ess' format,.   \n+00008540: 2020 7468 6520 6675 6e63 7469 6f6e 2077    the function w\n+00008550: 696c 6c20 7265 7475 726e 2027 464b 4f5f  ill return 'FKO_\n+00008560: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n+00008570: 5441 272e 0a0a 202d 2d20 4675 6e63 7469  TA'... -- Functi\n+00008580: 6f6e 3a20 696e 7420 666b 6f5f 7365 745f  on: int fko_set_\n+00008590: 7370 615f 7365 7276 6572 5f61 7574 6820  spa_server_auth \n+000085a0: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, \n+000085b0: 636f 6e73 7420 6368 6172 0a20 2020 2020  const char.     \n+000085c0: 2020 2020 202a 5345 5256 4552 5f41 5554       *SERVER_AUT\n+000085d0: 4829 3b0a 2020 2020 2053 6574 2074 6865  H);.     Set the\n+000085e0: 206f 7074 696f 6e61 6c20 2876 6572 7920   optional (very \n+000085f0: 7365 6c64 6f6d 2075 7365 6429 2053 5041  seldom used) SPA\n+00008600: 2073 6572 7665 7220 6175 7468 2066 6561   server auth fea\n+00008610: 7475 7265 2074 6f20 7468 650a 2020 2020  ture to the.    \n+00008620: 2067 6976 656e 2076 616c 7565 2e20 2054   given value.  T\n+00008630: 6869 7320 7061 7261 6d65 7465 7220 6d61  his parameter ma\n+00008640: 7920 6265 636f 6d65 2064 6570 7265 6361  y become depreca\n+00008650: 7465 642e 0a0a 202d 2d20 4675 6e63 7469  ted... -- Functi\n+00008660: 6f6e 3a20 696e 7420 666b 6f5f 7365 745f  on: int fko_set_\n+00008670: 7370 615f 636c 6965 6e74 5f74 696d 656f  spa_client_timeo\n+00008680: 7574 2028 666b 6f5f 6374 785f 7420 4354  ut (fko_ctx_t CT\n+00008690: 582c 2069 6e74 0a20 2020 2020 2020 2020  X, int.         \n+000086a0: 2054 494d 454f 5554 293b 0a20 2020 2020   TIMEOUT);.     \n+000086b0: 5365 7473 2074 6865 2053 5041 2063 6c69  Sets the SPA cli\n+000086c0: 656e 7420 7469 6d65 6f75 7420 7661 6c75  ent timeout valu\n+000086d0: 652e 2020 4966 2074 6865 2074 696d 656f  e.  If the timeo\n+000086e0: 7574 2069 7320 7365 7420 746f 2061 0a20  ut is set to a. \n+000086f0: 2020 2020 7661 6c75 6520 6772 6561 7465      value greate\n+00008700: 7220 7468 616e 2030 2c20 6974 2069 7320  r than 0, it is \n+00008710: 6173 7375 6d65 6420 7468 6520 2773 7061  assumed the 'spa\n+00008720: 5f6d 6573 7361 6765 5f74 7970 6527 2073  _message_type' s\n+00008730: 6574 7469 6e67 0a20 2020 2020 7368 6f75  etting.     shou\n+00008740: 6c64 2062 6520 6f6e 6520 6f66 2074 6865  ld be one of the\n+00008750: 2022 5449 4d45 4f55 5422 2076 6172 6961   \"TIMEOUT\" varia\n+00008760: 6e74 732e 2020 5468 6973 2066 756e 6374  nts.  This funct\n+00008770: 696f 6e20 7769 6c6c 2063 6861 6e67 650a  ion will change.\n+00008780: 2020 2020 2074 6865 2027 6d65 7373 6167       the 'messag\n+00008790: 655f 7479 7065 2720 746f 2074 6865 2061  e_type' to the a\n+000087a0: 7070 726f 7072 6961 7465 2073 6574 7469  ppropriate setti\n+000087b0: 6e67 2069 6620 6e65 6365 7373 6172 792e  ng if necessary.\n+000087c0: 0a20 2020 2020 486f 7765 7665 722c 2069  .     However, i\n+000087d0: 7420 6973 2072 6563 6f6d 6d65 6e64 6564  t is recommended\n+000087e0: 2079 6f75 2073 6574 2074 6865 2063 6f72   you set the cor\n+000087f0: 7265 6374 2027 6d65 7373 6167 655f 7479  rect 'message_ty\n+00008800: 7065 2720 6168 6561 640a 2020 2020 206f  pe' ahead.     o\n+00008810: 6620 7469 6d65 2e0a 0a20 2d2d 2046 756e  f time... -- Fun\n+00008820: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f73  ction: int fko_s\n+00008830: 6574 5f73 7061 5f64 6967 6573 7420 2866  et_spa_digest (f\n+00008840: 6b6f 5f63 7478 5f74 2043 5458 293b 0a20  ko_ctx_t CTX);. \n+00008850: 2020 2020 496e 6974 6961 7465 7320 6120      Initiates a \n+00008860: 6361 6c63 756c 6174 696f 6e20 286f 7220  calculation (or \n+00008870: 7265 6361 6c63 756c 6174 696f 6e29 206f  recalculation) o\n+00008880: 6620 7468 6520 6d65 7373 6167 6520 6469  f the message di\n+00008890: 6765 7374 0a20 2020 2020 6861 7368 2066  gest.     hash f\n+000088a0: 6f72 2074 6865 2063 7572 7265 6e74 2053  or the current S\n+000088b0: 5041 2064 6174 612e 2020 4966 2074 6865  PA data.  If the\n+000088c0: 2072 6571 7569 7265 6420 6461 7461 2066   required data f\n+000088d0: 6965 6c64 7320 6172 6520 6e6f 740a 2020  ields are not.  \n+000088e0: 2020 2073 6574 2074 6869 7320 6675 6e63     set this func\n+000088f0: 7469 6f6e 2077 696c 6c20 7265 7475 726e  tion will return\n+00008900: 2027 464b 4f5f 4552 524f 525f 4d49 5353   'FKO_ERROR_MISS\n+00008910: 494e 475f 454e 434f 4445 445f 4441 5441  ING_ENCODED_DATA\n+00008920: 272e 0a20 2020 2020 2a4e 6f74 652a 3a20  '..     *Note*: \n+00008930: 4974 2073 686f 756c 6420 6e6f 7420 6265  It should not be\n+00008940: 206e 6563 6573 7361 7279 2074 6f20 6361   necessary to ca\n+00008950: 6c6c 2074 6869 7320 6675 6e63 7469 6f6e  ll this function\n+00008960: 2064 6972 6563 746c 790a 2020 2020 2061   directly.     a\n+00008970: 7320 6974 2077 696c 6c20 6265 2063 616c  s it will be cal\n+00008980: 6c65 6420 6175 746f 6d61 7469 6361 6c6c  led automaticall\n+00008990: 7920 6279 206f 7468 6572 2066 756e 6374  y by other funct\n+000089a0: 696f 6e73 2064 7572 696e 6720 6e6f 726d  ions during norm\n+000089b0: 616c 0a20 2020 2020 7072 6f63 6573 7369  al.     processi\n+000089c0: 6e67 2028 6d6f 7374 206e 6f74 6162 6c79  ng (most notably\n+000089d0: 2027 666b 6f5f 7370 615f 6461 7461 5f66   'fko_spa_data_f\n+000089e0: 696e 616c 2729 2e0a 0a20 2d2d 2046 756e  inal')... -- Fun\n+000089f0: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f73  ction: int fko_s\n+00008a00: 6574 5f73 7061 5f68 6d61 6320 2866 6b6f  et_spa_hmac (fko\n+00008a10: 5f63 7478 5f74 2043 5458 2c20 636f 6e73  _ctx_t CTX, cons\n+00008a20: 7420 6368 6172 202a 484d 4143 5f4b 4559  t char *HMAC_KEY\n+00008a30: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons\n+00008a40: 7420 696e 7420 484d 4143 5f4b 4559 5f4c  t int HMAC_KEY_L\n+00008a50: 454e 293b 0a20 2020 2020 496e 6974 6961  EN);.     Initia\n+00008a60: 7465 7320 6120 6361 6c63 756c 6174 696f  tes a calculatio\n+00008a70: 6e20 286f 7220 7265 6361 6c63 756c 6174  n (or recalculat\n+00008a80: 696f 6e29 206f 6620 7468 6520 6d65 7373  ion) of the mess\n+00008a90: 6167 6520 484d 4143 2066 6f72 0a20 2020  age HMAC for.   \n+00008aa0: 2020 7468 6520 6375 7272 656e 7420 5350    the current SP\n+00008ab0: 4120 6461 7461 2e20 202a 4e6f 7465 2a3a  A data.  *Note*:\n+00008ac0: 2049 7420 7368 6f75 6c64 206e 6f74 2062   It should not b\n+00008ad0: 6520 6e65 6365 7373 6172 7920 746f 2063  e necessary to c\n+00008ae0: 616c 6c0a 2020 2020 2074 6869 7320 6675  all.     this fu\n+00008af0: 6e63 7469 6f6e 2064 6972 6563 746c 7920  nction directly \n+00008b00: 6173 2069 7420 7769 6c6c 2062 6520 6361  as it will be ca\n+00008b10: 6c6c 6564 2061 7574 6f6d 6174 6963 616c  lled automatical\n+00008b20: 6c79 2062 7920 6f74 6865 720a 2020 2020  ly by other.    \n+00008b30: 2066 756e 6374 696f 6e73 2064 7572 696e   functions durin\n+00008b40: 6720 6e6f 726d 616c 2070 726f 6365 7373  g normal process\n+00008b50: 696e 6720 286d 6f73 7420 6e6f 7461 626c  ing (most notabl\n+00008b60: 790a 2020 2020 2027 666b 6f5f 7370 615f  y.     'fko_spa_\n+00008b70: 6461 7461 5f66 696e 616c 2729 2e0a 0a20  data_final')... \n+00008b80: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int\n+00008b90: 2066 6b6f 5f73 6574 5f73 7061 5f64 6174   fko_set_spa_dat\n+00008ba0: 6120 2866 6b6f 5f63 7478 5f74 2043 5458  a (fko_ctx_t CTX\n+00008bb0: 2c20 6368 6172 202a 454e 435f 4441 5441  , char *ENC_DATA\n+00008bc0: 293b 0a20 2020 2020 5468 6973 2066 756e  );.     This fun\n+00008bd0: 6374 696f 6e20 6973 2075 7365 6420 746f  ction is used to\n+00008be0: 2070 6c61 6365 2065 6e63 7279 7074 6564   place encrypted\n+00008bf0: 2053 5041 2064 6174 6120 696e 746f 2061   SPA data into a\n+00008c00: 206e 6577 6c79 0a20 2020 2020 6372 6561   newly.     crea\n+00008c10: 7465 6420 656d 7074 7920 636f 6e74 6578  ted empty contex\n+00008c20: 7420 2869 2e65 2e20 2077 6974 6820 2766  t (i.e.  with 'f\n+00008c30: 6b6f 5f6e 6577 2729 2e20 2049 6e20 6d6f  ko_new').  In mo\n+00008c40: 7374 2063 6173 6573 2c20 796f 750a 2020  st cases, you.  \n+00008c50: 2020 2077 6f75 6c64 2075 7365 2027 666b     would use 'fk\n+00008c60: 6f5f 6e65 775f 7769 7468 5f64 6174 6127  o_new_with_data'\n+00008c70: 2073 6f20 796f 7520 776f 756c 646e 2774   so you wouldn't\n+00008c80: 2068 6176 6520 746f 2074 616b 6520 7468   have to take th\n+00008c90: 650a 2020 2020 2065 7874 7261 2073 7465  e.     extra ste\n+00008ca0: 7020 746f 2075 7365 2074 6869 7320 6675  p to use this fu\n+00008cb0: 6e63 7469 6f6e 2e20 2048 6f77 6576 6572  nction.  However\n+00008cc0: 2c20 736f 6d65 206d 6179 2066 696e 6420  , some may find \n+00008cd0: 6120 7265 6173 6f6e 0a20 2020 2020 746f  a reason.     to\n+00008ce0: 2064 6f20 6974 2069 6e20 7468 6973 2077   do it in this w\n+00008cf0: 6179 2e0a 0a5f 4750 472d 7370 6563 6966  ay..._GPG-specif\n+00008d00: 6963 2066 756e 6374 696f 6e73 3a5f 0a0a  ic functions:_..\n+00008d10: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in\n+00008d20: 7420 666b 6f5f 7365 745f 6770 675f 7265  t fko_set_gpg_re\n+00008d30: 6369 7069 656e 7420 2866 6b6f 5f63 7478  cipient (fko_ctx\n+00008d40: 5f74 2043 5458 2c20 636f 6e73 7420 6368  _t CTX, const ch\n+00008d50: 6172 0a20 2020 2020 2020 2020 2052 4543  ar.          REC\n+00008d60: 4950 4945 4e54 293b 0a20 2020 2020 5365  IPIENT);.     Se\n+00008d70: 7473 2074 6865 2047 5047 206b 6579 2066  ts the GPG key f\n+00008d80: 6f72 2074 6865 2072 6563 6970 6965 6e74  or the recipient\n+00008d90: 2e20 2054 6869 7320 776f 756c 6420 6265  .  This would be\n+00008da0: 2074 6865 2072 6563 6970 6965 6e74 2773   the recipient's\n+00008db0: 0a20 2020 2020 7075 626c 6963 206b 6579  .     public key\n+00008dc0: 2075 7365 6420 746f 2065 6e63 7972 7074   used to encyrpt\n+00008dd0: 2074 6865 2053 5041 2064 6174 612e 2020   the SPA data.  \n+00008de0: 596f 7520 6361 6e20 7573 6520 7468 6520  You can use the \n+00008df0: 7573 6572 206e 616d 650a 2020 2020 2028  user name.     (\n+00008e00: 2272 6563 6970 4074 6865 2e64 6573 742e  \"recip@the.dest.\n+00008e10: 636f 6d22 2920 6f72 2074 6865 206b 6579  com\") or the key\n+00008e20: 2049 4420 2822 3545 5858 5858 4343 2229   ID (\"5EXXXXCC\")\n+00008e30: 2e20 4174 2070 7265 7365 6e74 2c0a 2020  . At present,.  \n+00008e40: 2020 206d 756c 7469 706c 6520 7265 6369     multiple reci\n+00008e50: 7069 656e 7473 2061 7265 206e 6f74 2073  pients are not s\n+00008e60: 7570 706f 7274 6564 2e0a 0a20 2d2d 2046  upported... -- F\n+00008e70: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko\n+00008e80: 5f73 6574 5f67 7067 5f73 6967 6e65 7220  _set_gpg_signer \n+00008e90: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, \n+00008ea0: 636f 6e73 7420 6368 6172 2053 4947 4e45  const char SIGNE\n+00008eb0: 5229 3b0a 2020 2020 2053 6574 7320 7468  R);.     Sets th\n+00008ec0: 6520 4750 4720 6b65 7920 666f 7220 7369  e GPG key for si\n+00008ed0: 676e 696e 6720 7468 6520 6461 7461 2e20  gning the data. \n+00008ee0: 2054 6869 7320 776f 756c 6420 6265 2074   This would be t\n+00008ef0: 6865 2073 656e 6465 7227 730a 2020 2020  he sender's.    \n+00008f00: 206b 6579 2075 7365 6420 746f 2073 6967   key used to sig\n+00008f10: 6e20 7468 6520 5350 4120 6461 7461 2e20  n the SPA data. \n+00008f20: 2059 6f75 2063 616e 2075 7365 2074 6865   You can use the\n+00008f30: 2075 7365 7220 6e61 6d65 206f 7220 6b65   user name or ke\n+00008f40: 790a 2020 2020 2049 442e 0a0a 202d 2d20  y.     ID... -- \n+00008f50: 4675 6e63 7469 6f6e 3a20 696e 7420 666b  Function: int fk\n+00008f60: 6f5f 7365 745f 6770 675f 686f 6d65 5f64  o_set_gpg_home_d\n+00008f70: 6972 2028 666b 6f5f 6374 785f 7420 4354  ir (fko_ctx_t CT\n+00008f80: 582c 2063 6f6e 7374 2063 6861 720a 2020  X, const char.  \n+00008f90: 2020 2020 2020 2020 484f 4d45 5f44 4952          HOME_DIR\n+00008fa0: 293b 0a20 2020 2020 5365 7473 2074 6865  );.     Sets the\n+00008fb0: 2047 5047 2068 6f6d 6520 6469 7265 6374   GPG home direct\n+00008fc0: 6f72 7920 666f 7220 7468 6520 6375 7272  ory for the curr\n+00008fd0: 656e 7420 6770 676d 6520 636f 6e74 6578  ent gpgme contex\n+00008fe0: 742e 2020 5468 6973 0a20 2020 2020 616c  t.  This.     al\n+00008ff0: 6c6f 7773 2066 6f72 2075 7369 6e67 2061  lows for using a\n+00009000: 6c74 6572 6e61 7465 206b 6579 7269 6e67  lternate keyring\n+00009010: 732c 2067 7067 2063 6f6e 6669 6775 7261  s, gpg configura\n+00009020: 7469 6f6e 732c 2065 7463 2e0a 0a20 2d2d  tions, etc... --\n+00009030: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f\n+00009040: 6b6f 5f73 6574 5f67 7067 5f73 6967 6e61  ko_set_gpg_signa\n+00009050: 7475 7265 5f76 6572 6966 7920 2866 6b6f  ture_verify (fko\n+00009060: 5f63 7478 5f74 2043 5458 2c20 756e 7369  _ctx_t CTX, unsi\n+00009070: 676e 6564 0a20 2020 2020 2020 2020 2063  gned.          c\n+00009080: 6861 7220 5645 5249 4659 293b 0a20 2020  har VERIFY);.   \n+00009090: 2020 5365 7473 2074 6865 2076 6572 6966    Sets the verif\n+000090a0: 7920 4750 4720 7369 676e 6174 7572 6520  y GPG signature \n+000090b0: 666c 6167 2e20 2057 6865 6e20 7365 7420  flag.  When set \n+000090c0: 746f 2061 2074 7275 6520 7661 6c75 652c  to a true value,\n+000090d0: 2074 6865 0a20 2020 2020 4750 4720 7369   the.     GPG si\n+000090e0: 676e 6174 7572 6520 6973 2065 7874 7261  gnature is extra\n+000090f0: 6374 6564 2061 6e64 2063 6865 636b 6564  cted and checked\n+00009100: 2066 6f72 2076 616c 6964 6974 7920 6475   for validity du\n+00009110: 7269 6e67 2074 6865 0a20 2020 2020 6465  ring the.     de\n+00009120: 6372 7970 7469 6f6e 2f64 6563 6f64 696e  cryption/decodin\n+00009130: 6720 7068 6173 652e 2020 5768 656e 2073  g phase.  When s\n+00009140: 6574 2074 6f20 6661 6c73 652c 206e 6f20  et to false, no \n+00009150: 6174 7465 6d70 7420 6973 206d 6164 650a  attempt is made.\n+00009160: 2020 2020 2074 6f20 6163 6365 7373 206f       to access o\n+00009170: 7220 6368 6563 6b20 7468 6520 7369 676e  r check the sign\n+00009180: 6174 7572 652e 2020 5468 6973 2066 6c61  ature.  This fla\n+00009190: 6720 6973 2073 6574 2074 6f20 7472 7565  g is set to true\n+000091a0: 2062 790a 2020 2020 2064 6566 6175 6c74   by.     default\n+000091b0: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:\n+000091c0: 2069 6e74 2066 6b6f 5f73 6574 5f67 7067   int fko_set_gpg\n+000091d0: 5f69 676e 6f72 655f 7665 7269 6679 5f65  _ignore_verify_e\n+000091e0: 7272 6f72 2028 666b 6f5f 6374 785f 7420  rror (fko_ctx_t \n+000091f0: 4354 582c 0a20 2020 2020 2020 2020 2075  CTX,.          u\n+00009200: 6e73 6967 6e65 6420 6368 6172 2049 474e  nsigned char IGN\n+00009210: 4f52 4529 3b0a 2020 2020 2053 6574 7320  ORE);.     Sets \n+00009220: 7468 6520 6967 6e6f 7265 2073 6967 6e61  the ignore signa\n+00009230: 7475 7265 2076 6572 6966 7920 6572 726f  ture verify erro\n+00009240: 7220 666c 6167 2e20 2057 6865 6e20 7365  r flag.  When se\n+00009250: 7420 746f 2061 2074 7275 650a 2020 2020  t to a true.    \n+00009260: 2076 616c 7565 2e20 2041 6e79 2073 6967   value.  Any sig\n+00009270: 6e61 7475 7265 2076 6572 6966 6963 6174  nature verificat\n+00009280: 696f 6e20 6572 726f 7273 2061 7265 2069  ion errors are i\n+00009290: 676e 6f72 6564 2028 6275 7420 7374 696c  gnored (but stil\n+000092a0: 6c0a 2020 2020 2063 6170 7475 7265 6429  l.     captured)\n+000092b0: 2061 6e64 2074 6865 2064 6563 6f64 696e   and the decodin\n+000092c0: 6720 7072 6f63 6573 7320 7769 6c6c 2063  g process will c\n+000092d0: 6f6e 7469 6e75 652e 2020 5468 6520 6465  ontinue.  The de\n+000092e0: 6661 756c 740a 2020 2020 2076 616c 7565  fault.     value\n+000092f0: 206f 6620 7468 6973 2066 6c61 6720 6973   of this flag is\n+00009300: 2066 616c 7365 2e0a 0a20 2d2d 2046 756e   false... -- Fun\n+00009310: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f73  ction: int fko_s\n+00009320: 6574 5f67 7067 5f65 7865 2028 666b 6f5f  et_gpg_exe (fko_\n+00009330: 6374 785f 7420 4354 582c 2063 6f6e 7374  ctx_t CTX, const\n+00009340: 2063 6861 7220 4750 475f 4558 4529 3b0a   char GPG_EXE);.\n+00009350: 2020 2020 2053 6574 7320 7468 6520 7061       Sets the pa\n+00009360: 7468 2074 6f20 7468 6520 4750 4720 6578  th to the GPG ex\n+00009370: 6563 7574 6162 6c65 2074 6861 7420 5f67  ecutable that _g\n+00009380: 7067 6d65 5f20 7769 6c6c 2075 7365 2e20  pgme_ will use. \n+00009390: 2042 790a 2020 2020 2064 6566 6175 6c74   By.     default\n+000093a0: 2c20 5f6c 6962 666b 6f5f 2066 6f72 6365  , _libfko_ force\n+000093b0: 7320 5f67 7067 6d65 5f20 746f 2075 7365  s _gpgme_ to use\n+000093c0: 2027 6770 6727 2069 6e20 6361 7365 205f   'gpg' in case _\n+000093d0: 6770 676d 655f 2077 6173 0a20 2020 2020  gpgme_ was.     \n+000093e0: 636f 6d70 696c 6564 2074 6f20 7573 6520  compiled to use \n+000093f0: 2767 7067 3227 2061 7320 6974 7320 6465  'gpg2' as its de\n+00009400: 6661 756c 7420 656e 6769 6e65 2e20 2059  fault engine.  Y\n+00009410: 6f75 2063 616e 2075 7365 2074 6869 730a  ou can use this.\n+00009420: 2020 2020 2066 756e 6374 696f 6e20 746f       function to\n+00009430: 206f 7665 7272 6964 6520 616e 6420 7365   override and se\n+00009440: 7420 7768 6174 2047 5047 2065 7865 6375  t what GPG execu\n+00009450: 7461 626c 6520 5f67 7067 6d65 5f20 7769  table _gpgme_ wi\n+00009460: 6c6c 2075 7365 2e0a 0a2a 4e6f 7465 2a3a  ll use...*Note*:\n+00009470: 204f 6e20 6120 6c69 6266 6b6f 2062 7569   On a libfko bui\n+00009480: 6c64 2077 6974 686f 7574 2047 5047 2073  ld without GPG s\n+00009490: 7570 706f 7274 2c20 7468 6520 4750 472d  upport, the GPG-\n+000094a0: 7265 6c61 7465 6420 6675 6e63 7469 6f6e  related function\n+000094b0: 730a 6162 6f76 6520 7769 6c6c 2073 696d  s.above will sim\n+000094c0: 706c 7920 7265 7475 726e 2074 6865 2046  ply return the F\n+000094d0: 4b4f 5f45 5252 4f52 5f55 4e53 5550 504f  KO_ERROR_UNSUPPO\n+000094e0: 5254 4544 5f46 4541 5455 5245 2065 7272  RTED_FEATURE err\n+000094f0: 6f72 2063 6f64 652e 0a0a 1f0a 4669 6c65  or code.....File\n+00009500: 3a20 6c69 6266 6b6f 2e69 6e66 6f2c 2020  : libfko.info,  \n+00009510: 4e6f 6465 3a20 5265 7472 6965 7669 6e67  Node: Retrieving\n+00009520: 2053 5041 2044 6174 612c 2020 4e65 7874   SPA Data,  Next\n+00009530: 3a20 5574 696c 6974 7920 4675 6e63 7469  : Utility Functi\n+00009540: 6f6e 732c 2020 5072 6576 3a20 5365 7474  ons,  Prev: Sett\n+00009550: 696e 6720 5350 4120 4461 7461 2c20 2055  ing SPA Data,  U\n+00009560: 703a 2055 7369 6e67 206c 6962 666b 6f0a  p: Using libfko.\n+00009570: 0a33 2e35 2052 6574 7269 6576 696e 6720  .3.5 Retrieving \n+00009580: 5350 4120 4461 7461 0a3d 3d3d 3d3d 3d3d  SPA Data.=======\n 00009590: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================\n-000095a0: 3d3d 0a0a 5468 6973 2073 6563 7469 6f6e  ==..This section\n-000095b0: 2064 6573 6372 6962 6573 2074 6865 2066   describes the f\n-000095c0: 756e 6374 696f 6e73 2075 7365 6420 666f  unctions used fo\n-000095d0: 7220 7265 7472 6965 7669 6e67 2074 6865  r retrieving the\n-000095e0: 2076 6172 696f 7573 2053 5041 0a64 6174   various SPA.dat\n-000095f0: 6120 6669 656c 6473 2061 6e64 2070 6172  a fields and par\n-00009600: 616d 6574 6572 7320 7365 7474 696e 6773  ameters settings\n-00009610: 2e20 2054 6865 7920 616c 6c20 7265 7475  .  They all retu\n-00009620: 726e 2061 6e20 464b 4f20 6572 726f 7220  rn an FKO error \n-00009630: 636f 6465 2e0a 5468 6520 7661 6c75 6520  code..The value \n-00009640: 6f66 2074 6865 2072 6573 7065 6374 6976  of the respectiv\n-00009650: 6520 6669 656c 6420 6f72 2070 6172 6d65  e field or parme\n-00009660: 7465 7220 7468 6174 2069 7320 6265 696e  ter that is bein\n-00009670: 6720 7265 7472 6965 7665 640a 7769 6c6c  g retrieved.will\n-00009680: 2070 6c61 6365 6420 696e 746f 2074 6865   placed into the\n-00009690: 2076 6172 6961 626c 6573 2077 686f 7365   variables whose\n-000096a0: 2061 6464 7265 7373 6573 2061 7265 2070   addresses are p\n-000096b0: 6173 7365 6420 746f 2074 6865 0a66 756e  assed to the.fun\n-000096c0: 6374 696f 6e2e 0a0a 202d 2d20 4675 6e63  ction... -- Func\n-000096d0: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge\n-000096e0: 745f 7370 615f 6461 7461 2028 666b 6f5f  t_spa_data (fko_\n-000096f0: 6374 785f 7420 4354 582c 2063 6861 7220  ctx_t CTX, char \n-00009700: 2a2a 5350 415f 4441 5441 293b 0a20 2020  **SPA_DATA);.   \n-00009710: 2020 4173 7369 676e 7320 7468 6520 706f    Assigns the po\n-00009720: 696e 7465 7220 746f 2074 6865 2073 7472  inter to the str\n-00009730: 696e 6720 686f 6c64 696e 6720 7468 6520  ing holding the \n-00009740: 6669 6e61 6c20 656e 6372 7970 7465 6420  final encrypted \n-00009750: 5350 410a 2020 2020 2064 6174 6120 746f  SPA.     data to\n-00009760: 2074 6865 2061 6464 7265 7373 2053 5041   the address SPA\n-00009770: 5f44 4154 4120 6973 2070 6f69 6e74 696e  _DATA is pointin\n-00009780: 6720 746f 2e20 2054 6869 7320 6973 2074  g to.  This is t\n-00009790: 6865 2064 6174 6120 7468 6174 0a20 2020  he data that.   \n-000097a0: 2020 776f 756c 6420 6265 2070 6163 6b61    would be packa\n-000097b0: 6765 6420 696e 746f 2061 2070 6163 6b65  ged into a packe\n-000097c0: 7420 616e 6420 7365 6e74 2074 6f20 616e  t and sent to an\n-000097d0: 2066 776b 6e6f 7020 7365 7276 6572 2e20   fwknop server. \n-000097e0: 2054 6865 0a20 2020 2020 7265 7475 726e   The.     return\n-000097f0: 2076 616c 7565 2069 7320 616e 2046 4b4f   value is an FKO\n-00009800: 2065 7272 6f72 2073 7461 7475 732e 0a0a   error status...\n-00009810: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in\n-00009820: 7420 666b 6f5f 6765 745f 7261 6e64 5f76  t fko_get_rand_v\n-00009830: 616c 7565 2028 666b 6f5f 6374 785f 7420  alue (fko_ctx_t \n-00009840: 4354 582c 2063 6861 7220 2a2a 5241 4e44  CTX, char **RAND\n-00009850: 5f56 414c 293b 0a20 2020 2020 4173 7369  _VAL);.     Assi\n-00009860: 676e 7320 7468 6520 706f 696e 7465 7220  gns the pointer \n-00009870: 746f 2074 6865 2073 7472 696e 6720 686f  to the string ho\n-00009880: 6c64 696e 6720 7468 6520 7261 6e64 6f6d  lding the random\n-00009890: 2031 362d 6368 6172 6163 7465 720a 2020   16-character.  \n-000098a0: 2020 2064 6563 696d 616c 206e 756d 6265     decimal numbe\n-000098b0: 7220 2827 7261 6e64 5f76 616c 2729 2061  r ('rand_val') a\n-000098c0: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t\n-000098d0: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte\n-000098e0: 7874 2074 6f0a 2020 2020 2074 6865 2061  xt to.     the a\n-000098f0: 6464 7265 7373 2052 414e 445f 5641 4c20  ddress RAND_VAL \n-00009900: 6973 2070 6f69 6e74 696e 6720 746f 2e20  is pointing to. \n-00009910: 2054 6865 2072 6574 7572 6e20 7661 6c75   The return valu\n-00009920: 6520 6973 2061 6e20 464b 4f0a 2020 2020  e is an FKO.    \n-00009930: 2065 7272 6f72 2073 7461 7475 732e 0a0a   error status...\n-00009940: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in\n-00009950: 7420 666b 6f5f 6765 745f 7573 6572 6e61  t fko_get_userna\n-00009960: 6d65 2028 666b 6f5f 6374 785f 7420 4354  me (fko_ctx_t CT\n-00009970: 582c 2063 6861 7220 2a2a 5553 4552 4e41  X, char **USERNA\n-00009980: 4d45 293b 0a20 2020 2020 4173 7369 676e  ME);.     Assign\n-00009990: 7320 7468 6520 706f 696e 7465 7220 746f  s the pointer to\n-000099a0: 2074 6865 2073 7472 696e 6720 686f 6c64   the string hold\n-000099b0: 696e 6720 7468 6520 7573 6572 6e61 6d65  ing the username\n-000099c0: 2061 7373 6f63 6961 7465 640a 2020 2020   associated.    \n-000099d0: 2077 6974 6820 7468 6520 6375 7272 656e   with the curren\n-000099e0: 7420 636f 6e74 6578 7420 746f 2074 6865  t context to the\n-000099f0: 2061 6464 7265 7373 2052 414e 445f 5641   address RAND_VA\n-00009a00: 4c20 6973 2070 6f69 6e74 696e 6720 746f  L is pointing to\n-00009a10: 2e0a 2020 2020 2054 6865 2072 6574 7572  ..     The retur\n-00009a20: 6e20 7661 6c75 6520 6973 2061 6e20 464b  n value is an FK\n-00009a30: 4f20 6572 726f 7220 7374 6174 7573 2e0a  O error status..\n-00009a40: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i\n-00009a50: 6e74 2066 6b6f 5f67 6574 5f74 696d 6573  nt fko_get_times\n-00009a60: 7461 6d70 2028 666b 6f5f 6374 785f 7420  tamp (fko_ctx_t \n-00009a70: 4354 582c 2074 696d 655f 7420 2a54 494d  CTX, time_t *TIM\n-00009a80: 4553 5441 4d50 293b 0a20 2020 2020 5365  ESTAMP);.     Se\n-00009a90: 7473 2074 6865 2076 616c 7565 206f 6620  ts the value of \n-00009aa0: 7468 6520 5449 4d45 5354 414d 5020 7661  the TIMESTAMP va\n-00009ab0: 7269 6162 6c65 2074 6f20 7468 6520 7469  riable to the ti\n-00009ac0: 6d65 7374 616d 7020 7661 6c75 650a 2020  mestamp value.  \n-00009ad0: 2020 2061 7373 6f63 6961 7465 6420 7769     associated wi\n-00009ae0: 7468 2074 6865 2063 7572 7265 6e74 2063  th the current c\n-00009af0: 6f6e 7465 7874 2e20 2054 6865 2072 6574  ontext.  The ret\n-00009b00: 7572 6e20 7661 6c75 6520 6973 2061 6e20  urn value is an \n-00009b10: 464b 4f0a 2020 2020 2065 7272 6f72 2073  FKO.     error s\n-00009b20: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func\n-00009b30: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge\n-00009b40: 745f 7370 615f 6d65 7373 6167 655f 7479  t_spa_message_ty\n-00009b50: 7065 2028 666b 6f5f 6374 785f 7420 4354  pe (fko_ctx_t CT\n-00009b60: 582c 2073 686f 7274 0a20 2020 2020 2020  X, short.       \n-00009b70: 2020 202a 4d53 475f 5459 5045 293b 0a20     *MSG_TYPE);. \n-00009b80: 2020 2020 5365 7473 2074 6865 2076 616c      Sets the val\n-00009b90: 7565 206f 6620 7468 6520 4d53 475f 5459  ue of the MSG_TY\n-00009ba0: 5045 2076 6172 6961 626c 6520 746f 2074  PE variable to t\n-00009bb0: 6865 2053 5041 206d 6573 7361 6765 2074  he SPA message t\n-00009bc0: 7970 650a 2020 2020 2076 616c 7565 2061  ype.     value a\n-00009bd0: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t\n-00009be0: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte\n-00009bf0: 7874 2e20 2054 6869 7320 7661 6c75 6520  xt.  This value \n-00009c00: 6361 6e20 6265 0a20 2020 2020 6368 6563  can be.     chec\n-00009c10: 6b65 6420 6167 6169 6e73 7420 7468 6520  ked against the \n-00009c20: 6c69 7374 206f 6620 7661 6c69 6420 6d65  list of valid me\n-00009c30: 7373 6167 655f 7479 7065 7320 6c69 7374  ssage_types list\n-00009c40: 6564 2069 6e20 2a6e 6f74 6520 5350 410a  ed in *note SPA.\n-00009c50: 2020 2020 204d 6573 7361 6765 733a 3a20       Messages:: \n-00009c60: 6f66 2074 6869 7320 6d61 6e75 616c 2e20  of this manual. \n-00009c70: 2046 6f72 2065 7861 6d70 6c65 3a0a 2020   For example:.  \n-00009c80: 2020 2020 2020 2020 2020 2020 7368 6f72              shor\n-00009c90: 7420 6d73 675f 7479 7065 3b0a 0a20 2020  t msg_type;..   \n-00009ca0: 2020 2020 2020 2020 2020 2072 6320 3d20             rc = \n-00009cb0: 666b 6f5f 6765 745f 7370 615f 6d65 7373  fko_get_spa_mess\n-00009cc0: 6167 655f 7479 7065 2863 7478 2c20 266d  age_type(ctx, &m\n-00009cd0: 7367 5f74 7970 6529 3b0a 0a20 2020 2020  sg_type);..     \n-00009ce0: 2020 2020 2020 2020 2073 7769 7463 6828           switch(\n-00009cf0: 6d73 675f 7479 7065 290a 2020 2020 2020  msg_type).      \n-00009d00: 2020 2020 2020 2020 7b0a 2020 2020 2020          {.      \n-00009d10: 2020 2020 2020 2020 2020 2020 6361 7365              case\n-00009d20: 2046 4b4f 5f41 4343 4553 535f 4d53 473a   FKO_ACCESS_MSG:\n-00009d30: 0a20 2020 2020 2020 2020 2020 2020 2020  .               \n-00009d40: 2020 2020 2020 2070 726f 6365 7373 5f61         process_a\n-00009d50: 6363 6573 735f 6d73 6728 2e2e 2e29 3b0a  ccess_msg(...);.\n+000095a0: 0a0a 5468 6973 2073 6563 7469 6f6e 2064  ..This section d\n+000095b0: 6573 6372 6962 6573 2074 6865 2066 756e  escribes the fun\n+000095c0: 6374 696f 6e73 2075 7365 6420 666f 7220  ctions used for \n+000095d0: 7265 7472 6965 7669 6e67 2074 6865 2076  retrieving the v\n+000095e0: 6172 696f 7573 2053 5041 0a64 6174 6120  arious SPA.data \n+000095f0: 6669 656c 6473 2061 6e64 2070 6172 616d  fields and param\n+00009600: 6574 6572 7320 7365 7474 696e 6773 2e20  eters settings. \n+00009610: 2054 6865 7920 616c 6c20 7265 7475 726e   They all return\n+00009620: 2061 6e20 464b 4f20 6572 726f 7220 636f   an FKO error co\n+00009630: 6465 2e0a 5468 6520 7661 6c75 6520 6f66  de..The value of\n+00009640: 2074 6865 2072 6573 7065 6374 6976 6520   the respective \n+00009650: 6669 656c 6420 6f72 2070 6172 6d65 7465  field or parmete\n+00009660: 7220 7468 6174 2069 7320 6265 696e 6720  r that is being \n+00009670: 7265 7472 6965 7665 640a 7769 6c6c 2070  retrieved.will p\n+00009680: 6c61 6365 6420 696e 746f 2074 6865 2076  laced into the v\n+00009690: 6172 6961 626c 6573 2077 686f 7365 2061  ariables whose a\n+000096a0: 6464 7265 7373 6573 2061 7265 2070 6173  ddresses are pas\n+000096b0: 7365 6420 746f 2074 6865 0a66 756e 6374  sed to the.funct\n+000096c0: 696f 6e2e 0a0a 202d 2d20 4675 6e63 7469  ion... -- Functi\n+000096d0: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_\n+000096e0: 7370 615f 6461 7461 2028 666b 6f5f 6374  spa_data (fko_ct\n+000096f0: 785f 7420 4354 582c 2063 6861 7220 2a2a  x_t CTX, char **\n+00009700: 5350 415f 4441 5441 293b 0a20 2020 2020  SPA_DATA);.     \n+00009710: 4173 7369 676e 7320 7468 6520 706f 696e  Assigns the poin\n+00009720: 7465 7220 746f 2074 6865 2073 7472 696e  ter to the strin\n+00009730: 6720 686f 6c64 696e 6720 7468 6520 6669  g holding the fi\n+00009740: 6e61 6c20 656e 6372 7970 7465 6420 5350  nal encrypted SP\n+00009750: 410a 2020 2020 2064 6174 6120 746f 2074  A.     data to t\n+00009760: 6865 2061 6464 7265 7373 2053 5041 5f44  he address SPA_D\n+00009770: 4154 4120 6973 2070 6f69 6e74 696e 6720  ATA is pointing \n+00009780: 746f 2e20 2054 6869 7320 6973 2074 6865  to.  This is the\n+00009790: 2064 6174 6120 7468 6174 0a20 2020 2020   data that.     \n+000097a0: 776f 756c 6420 6265 2070 6163 6b61 6765  would be package\n+000097b0: 6420 696e 746f 2061 2070 6163 6b65 7420  d into a packet \n+000097c0: 616e 6420 7365 6e74 2074 6f20 616e 2066  and sent to an f\n+000097d0: 776b 6e6f 7020 7365 7276 6572 2e20 2054  wknop server.  T\n+000097e0: 6865 0a20 2020 2020 7265 7475 726e 2076  he.     return v\n+000097f0: 616c 7565 2069 7320 616e 2046 4b4f 2065  alue is an FKO e\n+00009800: 7272 6f72 2073 7461 7475 732e 0a0a 202d  rror status... -\n+00009810: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int \n+00009820: 666b 6f5f 6765 745f 7261 6e64 5f76 616c  fko_get_rand_val\n+00009830: 7565 2028 666b 6f5f 6374 785f 7420 4354  ue (fko_ctx_t CT\n+00009840: 582c 2063 6861 7220 2a2a 5241 4e44 5f56  X, char **RAND_V\n+00009850: 414c 293b 0a20 2020 2020 4173 7369 676e  AL);.     Assign\n+00009860: 7320 7468 6520 706f 696e 7465 7220 746f  s the pointer to\n+00009870: 2074 6865 2073 7472 696e 6720 686f 6c64   the string hold\n+00009880: 696e 6720 7468 6520 7261 6e64 6f6d 2031  ing the random 1\n+00009890: 362d 6368 6172 6163 7465 720a 2020 2020  6-character.    \n+000098a0: 2064 6563 696d 616c 206e 756d 6265 7220   decimal number \n+000098b0: 2827 7261 6e64 5f76 616c 2729 2061 7373  ('rand_val') ass\n+000098c0: 6f63 6961 7465 6420 7769 7468 2074 6865  ociated with the\n+000098d0: 2063 7572 7265 6e74 2063 6f6e 7465 7874   current context\n+000098e0: 2074 6f0a 2020 2020 2074 6865 2061 6464   to.     the add\n+000098f0: 7265 7373 2052 414e 445f 5641 4c20 6973  ress RAND_VAL is\n+00009900: 2070 6f69 6e74 696e 6720 746f 2e20 2054   pointing to.  T\n+00009910: 6865 2072 6574 7572 6e20 7661 6c75 6520  he return value \n+00009920: 6973 2061 6e20 464b 4f0a 2020 2020 2065  is an FKO.     e\n+00009930: 7272 6f72 2073 7461 7475 732e 0a0a 202d  rror status... -\n+00009940: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int \n+00009950: 666b 6f5f 6765 745f 7573 6572 6e61 6d65  fko_get_username\n+00009960: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,\n+00009970: 2063 6861 7220 2a2a 5553 4552 4e41 4d45   char **USERNAME\n+00009980: 293b 0a20 2020 2020 4173 7369 676e 7320  );.     Assigns \n+00009990: 7468 6520 706f 696e 7465 7220 746f 2074  the pointer to t\n+000099a0: 6865 2073 7472 696e 6720 686f 6c64 696e  he string holdin\n+000099b0: 6720 7468 6520 7573 6572 6e61 6d65 2061  g the username a\n+000099c0: 7373 6f63 6961 7465 640a 2020 2020 2077  ssociated.     w\n+000099d0: 6974 6820 7468 6520 6375 7272 656e 7420  ith the current \n+000099e0: 636f 6e74 6578 7420 746f 2074 6865 2061  context to the a\n+000099f0: 6464 7265 7373 2052 414e 445f 5641 4c20  ddress RAND_VAL \n+00009a00: 6973 2070 6f69 6e74 696e 6720 746f 2e0a  is pointing to..\n+00009a10: 2020 2020 2054 6865 2072 6574 7572 6e20       The return \n+00009a20: 7661 6c75 6520 6973 2061 6e20 464b 4f20  value is an FKO \n+00009a30: 6572 726f 7220 7374 6174 7573 2e0a 0a20  error status... \n+00009a40: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int\n+00009a50: 2066 6b6f 5f67 6574 5f74 696d 6573 7461   fko_get_timesta\n+00009a60: 6d70 2028 666b 6f5f 6374 785f 7420 4354  mp (fko_ctx_t CT\n+00009a70: 582c 2074 696d 655f 7420 2a54 494d 4553  X, time_t *TIMES\n+00009a80: 5441 4d50 293b 0a20 2020 2020 5365 7473  TAMP);.     Sets\n+00009a90: 2074 6865 2076 616c 7565 206f 6620 7468   the value of th\n+00009aa0: 6520 5449 4d45 5354 414d 5020 7661 7269  e TIMESTAMP vari\n+00009ab0: 6162 6c65 2074 6f20 7468 6520 7469 6d65  able to the time\n+00009ac0: 7374 616d 7020 7661 6c75 650a 2020 2020  stamp value.    \n+00009ad0: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with\n+00009ae0: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con\n+00009af0: 7465 7874 2e20 2054 6865 2072 6574 7572  text.  The retur\n+00009b00: 6e20 7661 6c75 6520 6973 2061 6e20 464b  n value is an FK\n+00009b10: 4f0a 2020 2020 2065 7272 6f72 2073 7461  O.     error sta\n+00009b20: 7475 732e 0a0a 202d 2d20 4675 6e63 7469  tus... -- Functi\n+00009b30: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_\n+00009b40: 7370 615f 6d65 7373 6167 655f 7479 7065  spa_message_type\n+00009b50: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,\n+00009b60: 2073 686f 7274 0a20 2020 2020 2020 2020   short.         \n+00009b70: 202a 4d53 475f 5459 5045 293b 0a20 2020   *MSG_TYPE);.   \n+00009b80: 2020 5365 7473 2074 6865 2076 616c 7565    Sets the value\n+00009b90: 206f 6620 7468 6520 4d53 475f 5459 5045   of the MSG_TYPE\n+00009ba0: 2076 6172 6961 626c 6520 746f 2074 6865   variable to the\n+00009bb0: 2053 5041 206d 6573 7361 6765 2074 7970   SPA message typ\n+00009bc0: 650a 2020 2020 2076 616c 7565 2061 7373  e.     value ass\n+00009bd0: 6f63 6961 7465 6420 7769 7468 2074 6865  ociated with the\n+00009be0: 2063 7572 7265 6e74 2063 6f6e 7465 7874   current context\n+00009bf0: 2e20 2054 6869 7320 7661 6c75 6520 6361  .  This value ca\n+00009c00: 6e20 6265 0a20 2020 2020 6368 6563 6b65  n be.     checke\n+00009c10: 6420 6167 6169 6e73 7420 7468 6520 6c69  d against the li\n+00009c20: 7374 206f 6620 7661 6c69 6420 6d65 7373  st of valid mess\n+00009c30: 6167 655f 7479 7065 7320 6c69 7374 6564  age_types listed\n+00009c40: 2069 6e20 2a6e 6f74 6520 5350 410a 2020   in *note SPA.  \n+00009c50: 2020 204d 6573 7361 6765 733a 3a20 6f66     Messages:: of\n+00009c60: 2074 6869 7320 6d61 6e75 616c 2e20 2046   this manual.  F\n+00009c70: 6f72 2065 7861 6d70 6c65 3a0a 2020 2020  or example:.    \n+00009c80: 2020 2020 2020 2020 2020 7368 6f72 7420            short \n+00009c90: 6d73 675f 7479 7065 3b0a 0a20 2020 2020  msg_type;..     \n+00009ca0: 2020 2020 2020 2020 2072 6320 3d20 666b           rc = fk\n+00009cb0: 6f5f 6765 745f 7370 615f 6d65 7373 6167  o_get_spa_messag\n+00009cc0: 655f 7479 7065 2863 7478 2c20 266d 7367  e_type(ctx, &msg\n+00009cd0: 5f74 7970 6529 3b0a 0a20 2020 2020 2020  _type);..       \n+00009ce0: 2020 2020 2020 2073 7769 7463 6828 6d73         switch(ms\n+00009cf0: 675f 7479 7065 290a 2020 2020 2020 2020  g_type).        \n+00009d00: 2020 2020 2020 7b0a 2020 2020 2020 2020        {.        \n+00009d10: 2020 2020 2020 2020 2020 6361 7365 2046            case F\n+00009d20: 4b4f 5f41 4343 4553 535f 4d53 473a 0a20  KO_ACCESS_MSG:. \n+00009d30: 2020 2020 2020 2020 2020 2020 2020 2020                  \n+00009d40: 2020 2020 2070 726f 6365 7373 5f61 6363       process_acc\n+00009d50: 6573 735f 6d73 6728 2e2e 2e29 3b0a 2020  ess_msg(...);.  \n 00009d60: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00009d70: 2020 2020 2020 6272 6561 6b3b 0a20 2020        break;.   \n-00009d80: 2020 2020 2020 2020 2020 2020 2020 2063                 c\n-00009d90: 6173 6520 464b 4f5f 4e41 545f 4143 4345  ase FKO_NAT_ACCE\n-00009da0: 5353 5f4d 5347 3a0a 2020 2020 2020 2020  SS_MSG:.        \n-00009db0: 2020 2020 2020 2020 2020 2020 2020 7072                pr\n-00009dc0: 6f63 6573 735f 6e61 745f 6163 6365 7373  ocess_nat_access\n-00009dd0: 5f6d 7367 282e 2e2e 293b 0a20 2020 2020  _msg(...);.     \n-00009de0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00009df0: 2062 7265 616b 3b0a 2020 2020 2020 2020   break;.        \n-00009e00: 2020 2020 2020 2f2a 2e2e 2e61 6e64 2073        /*...and s\n-00009e10: 6f20 6f6e 2e2e 2e2a 2f0a 2020 2020 2020  o on...*/.      \n-00009e20: 2020 2020 2020 2020 7d0a 2020 2020 2054          }.     T\n-00009e30: 6865 2072 6574 7572 6e20 7661 6c75 6520  he return value \n-00009e40: 6973 2061 6e20 464b 4f20 6572 726f 7220  is an FKO error \n-00009e50: 7374 6174 7573 2e0a 0a20 2d2d 2046 756e  status... -- Fun\n-00009e60: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f67  ction: int fko_g\n-00009e70: 6574 5f73 7061 5f6d 6573 7361 6765 2028  et_spa_message (\n-00009e80: 666b 6f5f 6374 785f 7420 4354 582c 2063  fko_ctx_t CTX, c\n-00009e90: 6861 7220 2a2a 5350 415f 4d53 4729 3b0a  har **SPA_MSG);.\n-00009ea0: 2020 2020 2041 7373 6967 6e73 2074 6865       Assigns the\n-00009eb0: 2070 6f69 6e74 6572 2074 6f20 7468 6520   pointer to the \n-00009ec0: 7374 7269 6e67 2068 6f6c 6469 6e67 2074  string holding t\n-00009ed0: 6865 2074 6865 2066 6b6f 2053 5041 2072  he the fko SPA r\n-00009ee0: 6571 7565 7374 0a20 2020 2020 6d65 7373  equest.     mess\n-00009ef0: 6167 6520 6173 736f 6369 6174 6564 2077  age associated w\n-00009f00: 6974 6820 7468 6520 6375 7272 656e 7420  ith the current \n-00009f10: 636f 6e74 6578 7420 746f 2074 6865 2061  context to the a\n-00009f20: 6464 7265 7373 2053 5041 5f4d 5347 0a20  ddress SPA_MSG. \n-00009f30: 2020 2020 6973 2070 6f69 6e74 696e 6720      is pointing \n-00009f40: 746f 2e20 2054 6865 2072 6574 7572 6e20  to.  The return \n-00009f50: 7661 6c75 6520 6973 2061 6e20 464b 4f20  value is an FKO \n-00009f60: 6572 726f 7220 7374 6174 7573 2e0a 0a20  error status... \n-00009f70: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int\n-00009f80: 2066 6b6f 5f67 6574 5f73 7061 5f6e 6174   fko_get_spa_nat\n-00009f90: 5f61 6363 6573 7320 2866 6b6f 5f63 7478  _access (fko_ctx\n-00009fa0: 5f74 2043 5458 2c20 6368 6172 0a20 2020  _t CTX, char.   \n-00009fb0: 2020 2020 2020 202a 2a4e 4154 5f41 4343         **NAT_ACC\n-00009fc0: 4553 5329 3b0a 2020 2020 2041 7373 6967  ESS);.     Assig\n-00009fd0: 6e73 2074 6865 2070 6f69 6e74 6572 2074  ns the pointer t\n-00009fe0: 6f20 7468 6520 7374 7269 6e67 2068 6f6c  o the string hol\n-00009ff0: 6469 6e67 2074 6865 2074 6865 2066 6b6f  ding the the fko\n-0000a000: 2053 5041 206e 6174 0a20 2020 2020 6163   SPA nat.     ac\n-0000a010: 6365 7373 206d 6573 7361 6765 2061 7373  cess message ass\n-0000a020: 6f63 6961 7465 6420 7769 7468 2074 6865  ociated with the\n-0000a030: 2063 7572 7265 6e74 2063 6f6e 7465 7874   current context\n-0000a040: 2074 6f20 7468 6520 6164 6472 6573 730a   to the address.\n-0000a050: 2020 2020 204e 4154 5f41 4343 4553 5320       NAT_ACCESS \n-0000a060: 6973 2070 6f69 6e74 696e 6720 746f 2e20  is pointing to. \n-0000a070: 2054 6865 2072 6574 7572 6e20 7661 6c75   The return valu\n-0000a080: 6520 6973 2061 6e20 464b 4f20 6572 726f  e is an FKO erro\n-0000a090: 720a 2020 2020 2073 7461 7475 732e 0a0a  r.     status...\n-0000a0a0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in\n-0000a0b0: 7420 666b 6f5f 6765 745f 7370 615f 7365  t fko_get_spa_se\n-0000a0c0: 7276 6572 5f61 7574 6820 2866 6b6f 5f63  rver_auth (fko_c\n-0000a0d0: 7478 5f74 2043 5458 2c20 6368 6172 0a20  tx_t CTX, char. \n-0000a0e0: 2020 2020 2020 2020 202a 2a53 4552 5645           **SERVE\n-0000a0f0: 525f 4155 5448 293b 0a20 2020 2020 4173  R_AUTH);.     As\n-0000a100: 7369 676e 7320 7468 6520 706f 696e 7465  signs the pointe\n-0000a110: 7220 746f 2074 6865 2073 7472 696e 6720  r to the string \n-0000a120: 686f 6c64 696e 6720 7468 6520 7468 6520  holding the the \n-0000a130: 666b 6f20 5350 4120 7365 7276 6572 0a20  fko SPA server. \n-0000a140: 2020 2020 6175 7468 206d 6573 7361 6765      auth message\n-0000a150: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with\n-0000a160: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con\n-0000a170: 7465 7874 2074 6f20 7468 6520 6164 6472  text to the addr\n-0000a180: 6573 730a 2020 2020 2053 4552 5645 525f  ess.     SERVER_\n-0000a190: 4155 5448 2069 7320 706f 696e 7469 6e67  AUTH is pointing\n-0000a1a0: 2074 6f2e 2020 5468 6520 7265 7475 726e   to.  The return\n-0000a1b0: 2076 616c 7565 2069 7320 616e 2046 4b4f   value is an FKO\n-0000a1c0: 2065 7272 6f72 0a20 2020 2020 7374 6174   error.     stat\n-0000a1d0: 7573 2e0a 0a20 2d2d 2046 756e 6374 696f  us... -- Functio\n-0000a1e0: 6e3a 2069 6e74 2066 6b6f 5f67 6574 5f73  n: int fko_get_s\n-0000a1f0: 7061 5f63 6c69 656e 745f 7469 6d65 6f75  pa_client_timeou\n-0000a200: 7420 2866 6b6f 5f63 7478 5f74 2043 5458  t (fko_ctx_t CTX\n-0000a210: 2c20 696e 740a 2020 2020 2020 2020 2020  , int.          \n-0000a220: 2a43 4c49 454e 545f 5449 4d45 4f55 5429  *CLIENT_TIMEOUT)\n-0000a230: 3b0a 2020 2020 2053 6574 7320 7468 6520  ;.     Sets the \n-0000a240: 7661 6c75 6520 6f66 2074 6865 2043 4c49  value of the CLI\n-0000a250: 454e 545f 5449 4d45 4f55 5420 7661 7269  ENT_TIMEOUT vari\n-0000a260: 6162 6c65 2074 6f20 7468 6520 636c 6965  able to the clie\n-0000a270: 6e74 5f74 696d 656f 7574 0a20 2020 2020  nt_timeout.     \n-0000a280: 7661 6c75 6520 6173 736f 6369 6174 6564  value associated\n-0000a290: 2077 6974 6820 7468 6520 6375 7272 656e   with the curren\n-0000a2a0: 7420 636f 6e74 6578 742e 2020 5468 6520  t context.  The \n-0000a2b0: 7265 7475 726e 2076 616c 7565 2069 7320  return value is \n-0000a2c0: 616e 0a20 2020 2020 464b 4f20 6572 726f  an.     FKO erro\n-0000a2d0: 7220 7374 6174 7573 2e0a 0a20 2d2d 2046  r status... -- F\n-0000a2e0: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko\n-0000a2f0: 5f67 6574 5f73 7061 5f64 6967 6573 745f  _get_spa_digest_\n-0000a300: 7479 7065 2028 666b 6f5f 6374 785f 7420  type (fko_ctx_t \n-0000a310: 4354 582c 2073 686f 7274 0a20 2020 2020  CTX, short.     \n-0000a320: 2020 2020 202a 4449 4745 5354 5f54 5950       *DIGEST_TYP\n-0000a330: 4529 3b0a 2020 2020 2053 6574 7320 7468  E);.     Sets th\n-0000a340: 6520 7661 6c75 6520 6f66 2074 6865 2044  e value of the D\n-0000a350: 4947 4553 545f 5459 5045 2076 6172 6961  IGEST_TYPE varia\n-0000a360: 626c 6520 746f 2074 6865 2064 6967 6573  ble to the diges\n-0000a370: 7420 7479 7065 2076 616c 7565 0a20 2020  t type value.   \n-0000a380: 2020 6173 736f 6369 6174 6564 2077 6974    associated wit\n-0000a390: 6820 7468 6520 6375 7272 656e 7420 636f  h the current co\n-0000a3a0: 6e74 6578 742e 2020 5468 6973 2076 616c  ntext.  This val\n-0000a3b0: 7565 2063 616e 2062 6520 6368 6563 6b65  ue can be checke\n-0000a3c0: 640a 2020 2020 2061 6761 696e 7374 2074  d.     against t\n-0000a3d0: 6865 206c 6973 7420 6f66 2076 616c 6964  he list of valid\n-0000a3e0: 2064 6967 6573 745f 7479 7065 7320 6c69   digest_types li\n-0000a3f0: 7374 6564 2069 6e20 2a6e 6f74 6520 4469  sted in *note Di\n-0000a400: 6765 7374 733a 3a20 6f66 0a20 2020 2020  gests:: of.     \n-0000a410: 7468 6973 206d 616e 7561 6c2e 2020 5468  this manual.  Th\n-0000a420: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i\n-0000a430: 7320 616e 2046 4b4f 2065 7272 6f72 2073  s an FKO error s\n-0000a440: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func\n-0000a450: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge\n-0000a460: 745f 7370 615f 686d 6163 5f74 7970 6520  t_spa_hmac_type \n-0000a470: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, \n-0000a480: 7368 6f72 740a 2020 2020 2020 2020 2020  short.          \n-0000a490: 2a48 4d41 435f 5459 5045 293b 0a20 2020  *HMAC_TYPE);.   \n-0000a4a0: 2020 5365 7473 2074 6865 2076 616c 7565    Sets the value\n-0000a4b0: 206f 6620 7468 6520 484d 4143 5f54 5950   of the HMAC_TYP\n-0000a4c0: 4520 7661 7269 6162 6c65 2074 6f20 7468  E variable to th\n-0000a4d0: 6520 484d 4143 2074 7970 6520 7661 6c75  e HMAC type valu\n-0000a4e0: 650a 2020 2020 2061 7373 6f63 6961 7465  e.     associate\n-0000a4f0: 6420 7769 7468 2074 6865 2063 7572 7265  d with the curre\n-0000a500: 6e74 2063 6f6e 7465 7874 2e20 2054 6869  nt context.  Thi\n-0000a510: 7320 7661 6c75 6520 6361 6e20 6265 2063  s value can be c\n-0000a520: 6865 636b 6564 0a20 2020 2020 6167 6169  hecked.     agai\n-0000a530: 6e73 7420 7468 6520 6c69 7374 206f 6620  nst the list of \n-0000a540: 7661 6c69 6420 686d 6163 5f74 7970 6573  valid hmac_types\n-0000a550: 206c 6973 7465 6420 696e 202a 6e6f 7465   listed in *note\n-0000a560: 2048 4d41 4320 4469 6765 7374 733a 3a0a   HMAC Digests::.\n-0000a570: 2020 2020 206f 6620 7468 6973 206d 616e       of this man\n-0000a580: 7561 6c2e 2020 5468 6520 7265 7475 726e  ual.  The return\n-0000a590: 2076 616c 7565 2069 7320 616e 2046 4b4f   value is an FKO\n-0000a5a0: 2065 7272 6f72 2073 7461 7475 732e 0a0a   error status...\n-0000a5b0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in\n-0000a5c0: 7420 666b 6f5f 6765 745f 7370 615f 6469  t fko_get_spa_di\n-0000a5d0: 6765 7374 2028 666b 6f5f 6374 785f 7420  gest (fko_ctx_t \n-0000a5e0: 4354 582c 2063 6861 7220 2a2a 5350 415f  CTX, char **SPA_\n-0000a5f0: 4449 4745 5354 293b 0a20 2020 2020 4173  DIGEST);.     As\n-0000a600: 7369 676e 7320 7468 6520 706f 696e 7465  signs the pointe\n-0000a610: 7220 746f 2074 6865 2073 7472 696e 6720  r to the string \n-0000a620: 686f 6c64 696e 6720 7468 6520 7468 6520  holding the the \n-0000a630: 666b 6f20 5350 4120 6469 6765 7374 0a20  fko SPA digest. \n-0000a640: 2020 2020 7661 6c75 6520 6173 736f 6369      value associ\n-0000a650: 6174 6564 2077 6974 6820 7468 6520 6375  ated with the cu\n-0000a660: 7272 656e 7420 636f 6e74 6578 7420 746f  rrent context to\n-0000a670: 2074 6865 2061 6464 7265 7373 2053 5041   the address SPA\n-0000a680: 5f44 4947 4553 540a 2020 2020 2069 7320  _DIGEST.     is \n-0000a690: 706f 696e 7469 6e67 2074 6f2e 2020 5468  pointing to.  Th\n-0000a6a0: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i\n-0000a6b0: 7320 616e 2046 4b4f 2065 7272 6f72 2073  s an FKO error s\n-0000a6c0: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func\n-0000a6d0: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge\n-0000a6e0: 745f 7370 615f 686d 6163 2028 666b 6f5f  t_spa_hmac (fko_\n-0000a6f0: 6374 785f 7420 4354 582c 2063 6861 7220  ctx_t CTX, char \n-0000a700: 2a2a 5350 415f 484d 4143 293b 0a20 2020  **SPA_HMAC);.   \n-0000a710: 2020 4173 7369 676e 7320 7468 6520 706f    Assigns the po\n-0000a720: 696e 7465 7220 746f 2074 6865 2073 7472  inter to the str\n-0000a730: 696e 6720 686f 6c64 696e 6720 7468 6520  ing holding the \n-0000a740: 7468 6520 666b 6f20 5350 4120 484d 4143  the fko SPA HMAC\n-0000a750: 0a20 2020 2020 7661 6c75 6520 6173 736f  .     value asso\n-0000a760: 6369 6174 6564 2077 6974 6820 7468 6520  ciated with the \n-0000a770: 6375 7272 656e 7420 636f 6e74 6578 7420  current context \n-0000a780: 746f 2074 6865 2061 6464 7265 7373 2053  to the address S\n-0000a790: 5041 5f48 4d41 430a 2020 2020 2069 7320  PA_HMAC.     is \n-0000a7a0: 706f 696e 7469 6e67 2074 6f2e 2020 5468  pointing to.  Th\n-0000a7b0: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i\n-0000a7c0: 7320 616e 2046 4b4f 2065 7272 6f72 2073  s an FKO error s\n-0000a7d0: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func\n-0000a7e0: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge\n-0000a7f0: 745f 7370 615f 656e 6372 7970 7469 6f6e  t_spa_encryption\n-0000a800: 5f74 7970 6520 2866 6b6f 5f63 7478 5f74  _type (fko_ctx_t\n-0000a810: 2043 5458 2c20 7368 6f72 740a 2020 2020   CTX, short.    \n-0000a820: 2020 2020 2020 2a45 4e43 5f54 5950 4529        *ENC_TYPE)\n-0000a830: 3b0a 2020 2020 2053 6574 7320 7468 6520  ;.     Sets the \n-0000a840: 7661 6c75 6520 6f66 2074 6865 2045 4e43  value of the ENC\n-0000a850: 5f54 5950 4520 7661 7269 6162 6c65 2074  _TYPE variable t\n-0000a860: 6f20 7468 6520 656e 6372 7970 7469 6f6e  o the encryption\n-0000a870: 2074 7970 650a 2020 2020 2076 616c 7565   type.     value\n-0000a880: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with\n-0000a890: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con\n-0000a8a0: 7465 7874 2e20 2054 6869 7320 7661 6c75  text.  This valu\n-0000a8b0: 6520 6361 6e20 6265 0a20 2020 2020 6368  e can be.     ch\n-0000a8c0: 6563 6b65 6420 6167 6169 6e73 7420 7468  ecked against th\n-0000a8d0: 6520 6c69 7374 206f 6620 7661 6c69 6420  e list of valid \n-0000a8e0: 6469 6765 7374 5f74 7970 6573 206c 6973  digest_types lis\n-0000a8f0: 7465 6420 696e 202a 6e6f 7465 0a20 2020  ted in *note.   \n-0000a900: 2020 456e 6372 7970 7469 6f6e 2041 6c67    Encryption Alg\n-0000a910: 6f72 6974 686d 733a 3a20 6f66 2074 6869  orithms:: of thi\n-0000a920: 7320 6d61 6e75 616c 2e20 2054 6865 2072  s manual.  The r\n-0000a930: 6574 7572 6e20 7661 6c75 6520 6973 2061  eturn value is a\n-0000a940: 6e20 464b 4f0a 2020 2020 2065 7272 6f72  n FKO.     error\n-0000a950: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu\n-0000a960: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_\n-0000a970: 6765 745f 656e 636f 6465 645f 6461 7461  get_encoded_data\n-0000a980: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,\n-0000a990: 2063 6861 7220 2a2a 454e 435f 4d53 4729   char **ENC_MSG)\n-0000a9a0: 3b0a 2020 2020 2041 7373 6967 6e73 2074  ;.     Assigns t\n-0000a9b0: 6865 2070 6f69 6e74 6572 2074 6f20 7468  he pointer to th\n-0000a9c0: 6520 7374 7269 6e67 2068 6f6c 6469 6e67  e string holding\n-0000a9d0: 2074 6865 2074 6865 2065 6e63 6f64 6564   the the encoded\n-0000a9e0: 2053 5041 2064 6174 610a 2020 2020 2028   SPA data.     (\n-0000a9f0: 6265 666f 7265 2065 6e63 7279 7074 696f  before encryptio\n-0000aa00: 6e29 2061 7373 6f63 6961 7465 6420 7769  n) associated wi\n-0000aa10: 7468 2074 6865 2063 7572 7265 6e74 2063  th the current c\n-0000aa20: 6f6e 7465 7874 2074 6f20 7468 650a 2020  ontext to the.  \n-0000aa30: 2020 2061 6464 7265 7373 2045 4e43 5f4d     address ENC_M\n-0000aa40: 5347 2069 7320 706f 696e 7469 6e67 2074  SG is pointing t\n-0000aa50: 6f2e 2020 5468 6973 2069 7320 696e 7465  o.  This is inte\n-0000aa60: 726d 6564 6961 7465 2064 6174 6120 7468  rmediate data th\n-0000aa70: 6174 0a20 2020 2020 776f 756c 6420 6e6f  at.     would no\n-0000aa80: 7420 6e6f 726d 616c 6c79 2062 6520 6f66  t normally be of\n-0000aa90: 2075 7365 2075 6e6c 6573 7320 6465 6275   use unless debu\n-0000aaa0: 6767 696e 6720 7468 6520 6c69 6272 6172  gging the librar\n-0000aab0: 792e 2020 5468 650a 2020 2020 2072 6574  y.  The.     ret\n-0000aac0: 7572 6e20 7661 6c75 6520 6973 2061 6e20  urn value is an \n-0000aad0: 464b 4f20 6572 726f 7220 7374 6174 7573  FKO error status\n-0000aae0: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:\n-0000aaf0: 2069 6e74 2066 6b6f 5f67 6574 5f76 6572   int fko_get_ver\n-0000ab00: 7369 6f6e 2028 666b 6f5f 6374 785f 7420  sion (fko_ctx_t \n-0000ab10: 4354 582c 2063 6861 7220 2a2a 464b 4f5f  CTX, char **FKO_\n-0000ab20: 5645 5253 494f 4e29 3b0a 2020 2020 2041  VERSION);.     A\n-0000ab30: 7373 6967 6e73 2074 6865 2070 6f69 6e74  ssigns the point\n-0000ab40: 6572 2074 6f20 7468 6520 7374 7269 6e67  er to the string\n-0000ab50: 2068 6f6c 6469 6e67 2074 6865 2074 6865   holding the the\n-0000ab60: 2053 5041 2076 6572 7369 6f6e 2076 616c   SPA version val\n-0000ab70: 7565 0a20 2020 2020 6173 736f 6369 6174  ue.     associat\n-0000ab80: 6564 2077 6974 6820 7468 6520 6375 7272  ed with the curr\n-0000ab90: 656e 7420 636f 6e74 6578 7420 746f 2074  ent context to t\n-0000aba0: 6865 2061 6464 7265 7373 2046 4b4f 5f56  he address FKO_V\n-0000abb0: 4552 5349 4f4e 2069 730a 2020 2020 2070  ERSION is.     p\n-0000abc0: 6f69 6e74 696e 6720 746f 2e20 2054 6869  ointing to.  Thi\n-0000abd0: 7320 6973 2061 2073 7461 7469 6320 7661  s is a static va\n-0000abe0: 6c75 6520 666f 7220 5350 4120 6461 7461  lue for SPA data\n-0000abf0: 2074 6861 7420 6973 2062 6569 6e67 0a20   that is being. \n-0000ac00: 2020 2020 6372 6561 7465 6420 696e 2061      created in a\n-0000ac10: 206e 6577 2063 6f6e 7465 7874 2e20 2046   new context.  F\n-0000ac20: 6f72 2064 6174 6120 7061 7273 6564 2066  or data parsed f\n-0000ac30: 726f 6d20 616e 2065 7874 6572 6e61 6c20  rom an external \n-0000ac40: 736f 7572 6365 2c0a 2020 2020 2074 6865  source,.     the\n-0000ac50: 2076 6572 7369 6f6e 2073 7472 696e 6720   version string \n-0000ac60: 7769 6c6c 2062 6520 7768 6174 6576 6572  will be whatever\n-0000ac70: 2076 6572 7369 6f6e 2074 6865 2073 656e   version the sen\n-0000ac80: 6469 6e67 2063 6c69 656e 740a 2020 2020  ding client.    \n-0000ac90: 2075 7365 642e 2020 5468 6520 7265 7475   used.  The retu\n-0000aca0: 726e 2076 616c 7565 2069 7320 616e 2046  rn value is an F\n-0000acb0: 4b4f 2065 7272 6f72 2073 7461 7475 732e  KO error status.\n-0000acc0: 0a0a 5f47 5047 2d73 7065 6369 6669 6320  .._GPG-specific \n-0000acd0: 6675 6e63 7469 6f6e 733a 5f0a 0a20 2d2d  functions:_.. --\n-0000ace0: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f\n-0000acf0: 6b6f 5f67 6574 5f67 7067 5f72 6563 6970  ko_get_gpg_recip\n-0000ad00: 6965 6e74 2028 666b 6f5f 6374 785f 7420  ient (fko_ctx_t \n-0000ad10: 4354 582c 2063 6861 720a 2020 2020 2020  CTX, char.      \n-0000ad20: 2020 2020 2a2a 5245 4349 5049 454e 5429      **RECIPIENT)\n-0000ad30: 3b0a 2020 2020 2041 7373 6967 6e73 2074  ;.     Assigns t\n-0000ad40: 6865 2070 6f69 6e74 6572 2074 6f20 7468  he pointer to th\n-0000ad50: 6520 7374 7269 6e67 2068 6f6c 6469 6e67  e string holding\n-0000ad60: 2074 6865 2074 6865 2047 5047 2072 6563   the the GPG rec\n-0000ad70: 6970 6965 6e74 2049 440a 2020 2020 2061  ipient ID.     a\n-0000ad80: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t\n-0000ad90: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte\n-0000ada0: 7874 2074 6f20 7468 6520 6164 6472 6573  xt to the addres\n-0000adb0: 7320 5245 4349 5049 454e 5420 6973 0a20  s RECIPIENT is. \n-0000adc0: 2020 2020 706f 696e 7469 6e67 2074 6f2e      pointing to.\n-0000add0: 2020 5468 6520 7265 7475 726e 2076 616c    The return val\n-0000ade0: 7565 2069 7320 616e 2046 4b4f 2065 7272  ue is an FKO err\n-0000adf0: 6f72 2073 7461 7475 732e 0a0a 202d 2d20  or status... -- \n-0000ae00: 4675 6e63 7469 6f6e 3a20 696e 7420 666b  Function: int fk\n-0000ae10: 6f5f 6765 745f 6770 675f 7369 676e 6572  o_get_gpg_signer\n-0000ae20: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,\n-0000ae30: 2063 6861 7220 2a2a 5349 474e 4552 293b   char **SIGNER);\n-0000ae40: 0a20 2020 2020 4173 7369 676e 7320 7468  .     Assigns th\n-0000ae50: 6520 706f 696e 7465 7220 746f 2074 6865  e pointer to the\n-0000ae60: 2073 7472 696e 6720 686f 6c64 696e 6720   string holding \n-0000ae70: 7468 6520 7468 6520 4750 4720 7369 676e  the the GPG sign\n-0000ae80: 6572 2049 440a 2020 2020 2061 7373 6f63  er ID.     assoc\n-0000ae90: 6961 7465 6420 7769 7468 2074 6865 2063  iated with the c\n-0000aea0: 7572 7265 6e74 2063 6f6e 7465 7874 2074  urrent context t\n-0000aeb0: 6f20 7468 6520 6164 6472 6573 7320 5349  o the address SI\n-0000aec0: 474e 4552 2069 730a 2020 2020 2070 6f69  GNER is.     poi\n-0000aed0: 6e74 696e 6720 746f 2e20 2054 6865 2072  nting to.  The r\n-0000aee0: 6574 7572 6e20 7661 6c75 6520 6973 2061  eturn value is a\n-0000aef0: 6e20 464b 4f20 6572 726f 7220 7374 6174  n FKO error stat\n-0000af00: 7573 2e0a 0a20 2d2d 2046 756e 6374 696f  us... -- Functio\n-0000af10: 6e3a 2069 6e74 2066 6b6f 5f67 6574 5f67  n: int fko_get_g\n-0000af20: 7067 5f68 6f6d 655f 6469 7220 2866 6b6f  pg_home_dir (fko\n-0000af30: 5f63 7478 5f74 2043 5458 2c20 6368 6172  _ctx_t CTX, char\n-0000af40: 202a 2a47 5047 5f44 4952 293b 0a20 2020   **GPG_DIR);.   \n-0000af50: 2020 4173 7369 676e 7320 7468 6520 706f    Assigns the po\n-0000af60: 696e 7465 7220 746f 2074 6865 2073 7472  inter to the str\n-0000af70: 696e 6720 686f 6c64 696e 6720 7468 6520  ing holding the \n-0000af80: 7468 6520 4750 4720 686f 6d65 0a20 2020  the GPG home.   \n-0000af90: 2020 6469 7265 6374 6f72 7920 6173 736f    directory asso\n-0000afa0: 6369 6174 6564 2077 6974 6820 7468 6520  ciated with the \n-0000afb0: 6375 7272 656e 7420 636f 6e74 6578 7420  current context \n-0000afc0: 746f 2074 6865 2061 6464 7265 7373 0a20  to the address. \n-0000afd0: 2020 2020 4750 475f 4449 5220 6973 2070      GPG_DIR is p\n-0000afe0: 6f69 6e74 696e 6720 746f 2e20 2054 6865  ointing to.  The\n-0000aff0: 2072 6574 7572 6e20 7661 6c75 6520 6973   return value is\n-0000b000: 2061 6e20 464b 4f20 6572 726f 7220 7374   an FKO error st\n-0000b010: 6174 7573 2e0a 0a20 2d2d 2046 756e 6374  atus... -- Funct\n-0000b020: 696f 6e3a 2069 6e74 2066 6b6f 5f67 6574  ion: int fko_get\n-0000b030: 5f67 7067 5f73 6967 6e61 7475 7265 5f76  _gpg_signature_v\n-0000b040: 6572 6966 7920 2866 6b6f 5f63 7478 5f74  erify (fko_ctx_t\n-0000b050: 2043 5458 2c20 756e 7369 676e 6564 0a20   CTX, unsigned. \n-0000b060: 2020 2020 2020 2020 2063 6861 7220 2a56           char *V\n-0000b070: 414c 293b 0a20 2020 2020 5365 7473 2074  AL);.     Sets t\n-0000b080: 6865 2076 616c 7565 206f 6620 7468 6520  he value of the \n-0000b090: 5641 4c20 7661 7269 6162 6c65 2074 6f20  VAL variable to \n-0000b0a0: 7468 6520 6375 7272 656e 740a 2020 2020  the current.    \n-0000b0b0: 2067 7067 5f73 6967 6e61 7475 7265 5f76   gpg_signature_v\n-0000b0c0: 6572 6966 7920 666c 6167 2076 616c 7565  erify flag value\n-0000b0d0: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with\n-0000b0e0: 2074 6865 2063 7572 7265 6e74 0a20 2020   the current.   \n-0000b0f0: 2020 636f 6e74 6578 742e 2020 5468 6520    context.  The \n-0000b100: 7265 7475 726e 2076 616c 7565 2069 7320  return value is \n-0000b110: 616e 2046 4b4f 2065 7272 6f72 2073 7461  an FKO error sta\n-0000b120: 7475 732e 0a0a 202d 2d20 4675 6e63 7469  tus... -- Functi\n-0000b130: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_\n-0000b140: 6770 675f 6967 6e6f 7265 5f76 6572 6966  gpg_ignore_verif\n-0000b150: 795f 6572 726f 7220 2866 6b6f 5f63 7478  y_error (fko_ctx\n-0000b160: 5f74 2043 5458 2c0a 2020 2020 2020 2020  _t CTX,.        \n-0000b170: 2020 756e 7369 676e 6564 2063 6861 7220    unsigned char \n-0000b180: 2a56 414c 293b 0a20 2020 2020 5365 7473  *VAL);.     Sets\n-0000b190: 2074 6865 2076 616c 7565 206f 6620 7468   the value of th\n-0000b1a0: 6520 5641 4c20 7661 7269 6162 6c65 2074  e VAL variable t\n-0000b1b0: 6f20 7468 6520 6375 7272 656e 740a 2020  o the current.  \n-0000b1c0: 2020 2069 676e 6f72 655f 7665 7269 6679     ignore_verify\n-0000b1d0: 5f65 7272 6f72 2066 6c61 6720 7661 6c75  _error flag valu\n-0000b1e0: 6520 6173 736f 6369 6174 6564 2077 6974  e associated wit\n-0000b1f0: 6820 7468 6520 6375 7272 656e 7420 636f  h the current co\n-0000b200: 6e74 6578 742e 0a20 2020 2020 5468 6520  ntext..     The \n-0000b210: 7265 7475 726e 2076 616c 7565 2069 7320  return value is \n-0000b220: 616e 2046 4b4f 2065 7272 6f72 2073 7461  an FKO error sta\n-0000b230: 7475 732e 0a0a 202d 2d20 4675 6e63 7469  tus... -- Functi\n-0000b240: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_\n-0000b250: 6770 675f 7369 676e 6174 7572 655f 6964  gpg_signature_id\n-0000b260: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,\n-0000b270: 2063 6861 720a 2020 2020 2020 2020 2020   char.          \n-0000b280: 2a2a 5349 475f 4944 293b 0a20 2020 2020  **SIG_ID);.     \n-0000b290: 4173 7369 676e 7320 7468 6520 706f 696e  Assigns the poin\n-0000b2a0: 7465 7220 746f 2074 6865 2073 7472 696e  ter to the strin\n-0000b2b0: 6720 686f 6c64 696e 6720 7468 6520 7468  g holding the th\n-0000b2c0: 6520 4750 4720 7369 676e 6174 7572 6520  e GPG signature \n-0000b2d0: 4944 0a20 2020 2020 6173 736f 6369 6174  ID.     associat\n-0000b2e0: 6564 2077 6974 6820 7468 6520 6375 7272  ed with the curr\n-0000b2f0: 656e 7420 636f 6e74 6578 7420 746f 2074  ent context to t\n-0000b300: 6865 2061 6464 7265 7373 2053 4947 5f49  he address SIG_I\n-0000b310: 4420 6973 0a20 2020 2020 706f 696e 7469  D is.     pointi\n-0000b320: 6e67 2074 6f2e 2020 5468 6520 7265 7475  ng to.  The retu\n-0000b330: 726e 2076 616c 7565 2069 7320 616e 2046  rn value is an F\n-0000b340: 4b4f 2065 7272 6f72 2073 7461 7475 732e  KO error status.\n-0000b350: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: \n-0000b360: 696e 7420 666b 6f5f 6765 745f 6770 675f  int fko_get_gpg_\n-0000b370: 7369 676e 6174 7572 655f 6670 7220 2866  signature_fpr (f\n-0000b380: 6b6f 5f63 7478 5f74 2043 5458 2c20 6368  ko_ctx_t CTX, ch\n-0000b390: 6172 0a20 2020 2020 2020 2020 202a 2a53  ar.          **S\n-0000b3a0: 4947 5f46 5052 293b 0a20 2020 2020 4173  IG_FPR);.     As\n-0000b3b0: 7369 676e 7320 7468 6520 706f 696e 7465  signs the pointe\n-0000b3c0: 7220 746f 2074 6865 2073 7472 696e 6720  r to the string \n-0000b3d0: 686f 6c64 696e 6720 7468 6520 7468 6520  holding the the \n-0000b3e0: 4750 4720 7369 676e 6174 7572 650a 2020  GPG signature.  \n-0000b3f0: 2020 2066 696e 6765 7270 7269 6e74 2061     fingerprint a\n-0000b400: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t\n-0000b410: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte\n-0000b420: 7874 2074 6f20 7468 6520 6164 6472 6573  xt to the addres\n-0000b430: 730a 2020 2020 2053 4947 5f46 5052 2069  s.     SIG_FPR i\n-0000b440: 7320 706f 696e 7469 6e67 2074 6f2e 2020  s pointing to.  \n-0000b450: 5468 6520 7265 7475 726e 2076 616c 7565  The return value\n-0000b460: 2069 7320 616e 2046 4b4f 2065 7272 6f72   is an FKO error\n-0000b470: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu\n-0000b480: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_\n-0000b490: 6765 745f 6770 675f 7369 676e 6174 7572  get_gpg_signatur\n-0000b4a0: 655f 7375 6d6d 6172 7920 2866 6b6f 5f63  e_summary (fko_c\n-0000b4b0: 7478 5f74 2043 5458 2c20 696e 740a 2020  tx_t CTX, int.  \n-0000b4c0: 2020 2020 2020 2020 2a53 4947 5f53 554d          *SIG_SUM\n-0000b4d0: 293b 0a20 2020 2020 5365 7473 2074 6865  );.     Sets the\n-0000b4e0: 2076 616c 7565 206f 6620 7468 6520 5349   value of the SI\n-0000b4f0: 475f 5355 4d20 7661 7269 6162 6c65 2074  G_SUM variable t\n-0000b500: 6f20 7468 6520 4750 4720 7369 676e 6174  o the GPG signat\n-0000b510: 7572 6520 7375 6d6d 6172 790a 2020 2020  ure summary.    \n-0000b520: 2076 616c 7565 2061 7373 6f63 6961 7465   value associate\n-0000b530: 6420 7769 7468 2074 6865 2063 7572 7265  d with the curre\n-0000b540: 6e74 2063 6f6e 7465 7874 2e20 2054 6865  nt context.  The\n-0000b550: 2072 6574 7572 6e20 7661 6c75 6520 6973   return value is\n-0000b560: 2061 6e0a 2020 2020 2046 4b4f 2065 7272   an.     FKO err\n-0000b570: 6f72 2073 7461 7475 732e 0a0a 202d 2d20  or status... -- \n-0000b580: 4675 6e63 7469 6f6e 3a20 696e 7420 666b  Function: int fk\n-0000b590: 6f5f 6765 745f 6770 675f 7369 676e 6174  o_get_gpg_signat\n-0000b5a0: 7572 655f 7374 6174 7573 2028 666b 6f5f  ure_status (fko_\n-0000b5b0: 6374 785f 7420 4354 582c 2069 6e74 0a20  ctx_t CTX, int. \n-0000b5c0: 2020 2020 2020 2020 202a 5349 475f 5354           *SIG_ST\n-0000b5d0: 4154 293b 0a20 2020 2020 5365 7473 2074  AT);.     Sets t\n-0000b5e0: 6865 2076 616c 7565 206f 6620 7468 6520  he value of the \n-0000b5f0: 5349 475f 5354 4154 2076 6172 6961 626c  SIG_STAT variabl\n-0000b600: 6520 746f 2074 6865 2047 5047 2073 6967  e to the GPG sig\n-0000b610: 6e61 7475 7265 2065 7272 6f72 0a20 2020  nature error.   \n-0000b620: 2020 7374 6174 7573 2076 616c 7565 2061    status value a\n-0000b630: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t\n-0000b640: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte\n-0000b650: 7874 2e20 2054 6865 2072 6574 7572 6e20  xt.  The return \n-0000b660: 7661 6c75 650a 2020 2020 2069 7320 616e  value.     is an\n-0000b670: 2046 4b4f 2065 7272 6f72 2073 7461 7475   FKO error statu\n-0000b680: 732e 0a0a 202d 2d20 4675 6e63 7469 6f6e  s... -- Function\n-0000b690: 3a20 696e 7420 666b 6f5f 6765 745f 6770  : int fko_get_gp\n-0000b6a0: 675f 6578 6520 2866 6b6f 5f63 7478 5f74  g_exe (fko_ctx_t\n-0000b6b0: 2043 5458 2c20 6368 6172 202a 2a47 5047   CTX, char **GPG\n-0000b6c0: 5f45 5845 293b 0a20 2020 2020 4173 7369  _EXE);.     Assi\n-0000b6d0: 676e 7320 7468 6520 706f 696e 7465 7220  gns the pointer \n-0000b6e0: 746f 2074 6865 2073 7472 696e 6720 686f  to the string ho\n-0000b6f0: 6c64 696e 6720 7468 6520 7468 6520 4750  lding the the GP\n-0000b700: 4720 6578 6563 7574 6162 6c65 0a20 2020  G executable.   \n-0000b710: 2020 7061 7468 2061 7373 6f63 6961 7465    path associate\n-0000b720: 6420 7769 7468 2074 6865 2063 7572 7265  d with the curre\n-0000b730: 6e74 2063 6f6e 7465 7874 2074 6f20 7468  nt context to th\n-0000b740: 6520 6164 6472 6573 7320 4750 475f 4558  e address GPG_EX\n-0000b750: 4520 6973 0a20 2020 2020 706f 696e 7469  E is.     pointi\n-0000b760: 6e67 2074 6f2e 2020 5468 6520 7265 7475  ng to.  The retu\n-0000b770: 726e 2076 616c 7565 2069 7320 616e 2046  rn value is an F\n-0000b780: 4b4f 2065 7272 6f72 2073 7461 7475 732e  KO error status.\n-0000b790: 0a0a 2a4e 6f74 652a 3a20 5468 6520 6368  ..*Note*: The ch\n-0000b7a0: 6172 2a20 7661 6c75 6573 2072 6574 7269  ar* values retri\n-0000b7b0: 6576 6564 2062 7920 7468 6520 4750 472d  eved by the GPG-\n-0000b7c0: 7265 6c61 7465 6420 6675 6e63 7469 6f6e  related function\n-0000b7d0: 7320 6162 6f76 650a 7769 6c6c 2062 6520  s above.will be \n-0000b7e0: 4e55 4c4c 2069 6620 7468 6520 636f 6e74  NULL if the cont\n-0000b7f0: 6578 7420 7661 6c75 6520 7761 7320 6e6f  ext value was no\n-0000b800: 7420 7072 6576 696f 7573 6c79 2073 6574  t previously set\n-0000b810: 2e0a 0a1f 0a46 696c 653a 206c 6962 666b  .....File: libfk\n-0000b820: 6f2e 696e 666f 2c20 204e 6f64 653a 2055  o.info,  Node: U\n-0000b830: 7469 6c69 7479 2046 756e 6374 696f 6e73  tility Functions\n-0000b840: 2c20 204e 6578 743a 2045 7272 6f72 2048  ,  Next: Error H\n-0000b850: 616e 646c 696e 672c 2020 5072 6576 3a20  andling,  Prev: \n-0000b860: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D\n-0000b870: 6174 612c 2020 5570 3a20 5573 696e 6720  ata,  Up: Using \n-0000b880: 6c69 6266 6b6f 0a0a 332e 3620 5574 696c  libfko..3.6 Util\n-0000b890: 6974 7920 4675 6e63 7469 6f6e 730a 3d3d  ity Functions.==\n+00009d70: 2020 2020 6272 6561 6b3b 0a20 2020 2020      break;.     \n+00009d80: 2020 2020 2020 2020 2020 2020 2063 6173               cas\n+00009d90: 6520 464b 4f5f 4e41 545f 4143 4345 5353  e FKO_NAT_ACCESS\n+00009da0: 5f4d 5347 3a0a 2020 2020 2020 2020 2020  _MSG:.          \n+00009db0: 2020 2020 2020 2020 2020 2020 7072 6f63              proc\n+00009dc0: 6573 735f 6e61 745f 6163 6365 7373 5f6d  ess_nat_access_m\n+00009dd0: 7367 282e 2e2e 293b 0a20 2020 2020 2020  sg(...);.       \n+00009de0: 2020 2020 2020 2020 2020 2020 2020 2062                 b\n+00009df0: 7265 616b 3b0a 2020 2020 2020 2020 2020  reak;.          \n+00009e00: 2020 2020 2f2a 2e2e 2e61 6e64 2073 6f20      /*...and so \n+00009e10: 6f6e 2e2e 2e2a 2f0a 2020 2020 2020 2020  on...*/.        \n+00009e20: 2020 2020 2020 7d0a 2020 2020 2054 6865        }.     The\n+00009e30: 2072 6574 7572 6e20 7661 6c75 6520 6973   return value is\n+00009e40: 2061 6e20 464b 4f20 6572 726f 7220 7374   an FKO error st\n+00009e50: 6174 7573 2e0a 0a20 2d2d 2046 756e 6374  atus... -- Funct\n+00009e60: 696f 6e3a 2069 6e74 2066 6b6f 5f67 6574  ion: int fko_get\n+00009e70: 5f73 7061 5f6d 6573 7361 6765 2028 666b  _spa_message (fk\n+00009e80: 6f5f 6374 785f 7420 4354 582c 2063 6861  o_ctx_t CTX, cha\n+00009e90: 7220 2a2a 5350 415f 4d53 4729 3b0a 2020  r **SPA_MSG);.  \n+00009ea0: 2020 2041 7373 6967 6e73 2074 6865 2070     Assigns the p\n+00009eb0: 6f69 6e74 6572 2074 6f20 7468 6520 7374  ointer to the st\n+00009ec0: 7269 6e67 2068 6f6c 6469 6e67 2074 6865  ring holding the\n+00009ed0: 2074 6865 2066 6b6f 2053 5041 2072 6571   the fko SPA req\n+00009ee0: 7565 7374 0a20 2020 2020 6d65 7373 6167  uest.     messag\n+00009ef0: 6520 6173 736f 6369 6174 6564 2077 6974  e associated wit\n+00009f00: 6820 7468 6520 6375 7272 656e 7420 636f  h the current co\n+00009f10: 6e74 6578 7420 746f 2074 6865 2061 6464  ntext to the add\n+00009f20: 7265 7373 2053 5041 5f4d 5347 0a20 2020  ress SPA_MSG.   \n+00009f30: 2020 6973 2070 6f69 6e74 696e 6720 746f    is pointing to\n+00009f40: 2e20 2054 6865 2072 6574 7572 6e20 7661  .  The return va\n+00009f50: 6c75 6520 6973 2061 6e20 464b 4f20 6572  lue is an FKO er\n+00009f60: 726f 7220 7374 6174 7573 2e0a 0a20 2d2d  ror status... --\n+00009f70: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f\n+00009f80: 6b6f 5f67 6574 5f73 7061 5f6e 6174 5f61  ko_get_spa_nat_a\n+00009f90: 6363 6573 7320 2866 6b6f 5f63 7478 5f74  ccess (fko_ctx_t\n+00009fa0: 2043 5458 2c20 6368 6172 0a20 2020 2020   CTX, char.     \n+00009fb0: 2020 2020 202a 2a4e 4154 5f41 4343 4553       **NAT_ACCES\n+00009fc0: 5329 3b0a 2020 2020 2041 7373 6967 6e73  S);.     Assigns\n+00009fd0: 2074 6865 2070 6f69 6e74 6572 2074 6f20   the pointer to \n+00009fe0: 7468 6520 7374 7269 6e67 2068 6f6c 6469  the string holdi\n+00009ff0: 6e67 2074 6865 2074 6865 2066 6b6f 2053  ng the the fko S\n+0000a000: 5041 206e 6174 0a20 2020 2020 6163 6365  PA nat.     acce\n+0000a010: 7373 206d 6573 7361 6765 2061 7373 6f63  ss message assoc\n+0000a020: 6961 7465 6420 7769 7468 2074 6865 2063  iated with the c\n+0000a030: 7572 7265 6e74 2063 6f6e 7465 7874 2074  urrent context t\n+0000a040: 6f20 7468 6520 6164 6472 6573 730a 2020  o the address.  \n+0000a050: 2020 204e 4154 5f41 4343 4553 5320 6973     NAT_ACCESS is\n+0000a060: 2070 6f69 6e74 696e 6720 746f 2e20 2054   pointing to.  T\n+0000a070: 6865 2072 6574 7572 6e20 7661 6c75 6520  he return value \n+0000a080: 6973 2061 6e20 464b 4f20 6572 726f 720a  is an FKO error.\n+0000a090: 2020 2020 2073 7461 7475 732e 0a0a 202d       status... -\n+0000a0a0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int \n+0000a0b0: 666b 6f5f 6765 745f 7370 615f 7365 7276  fko_get_spa_serv\n+0000a0c0: 6572 5f61 7574 6820 2866 6b6f 5f63 7478  er_auth (fko_ctx\n+0000a0d0: 5f74 2043 5458 2c20 6368 6172 0a20 2020  _t CTX, char.   \n+0000a0e0: 2020 2020 2020 202a 2a53 4552 5645 525f         **SERVER_\n+0000a0f0: 4155 5448 293b 0a20 2020 2020 4173 7369  AUTH);.     Assi\n+0000a100: 676e 7320 7468 6520 706f 696e 7465 7220  gns the pointer \n+0000a110: 746f 2074 6865 2073 7472 696e 6720 686f  to the string ho\n+0000a120: 6c64 696e 6720 7468 6520 7468 6520 666b  lding the the fk\n+0000a130: 6f20 5350 4120 7365 7276 6572 0a20 2020  o SPA server.   \n+0000a140: 2020 6175 7468 206d 6573 7361 6765 2061    auth message a\n+0000a150: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t\n+0000a160: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte\n+0000a170: 7874 2074 6f20 7468 6520 6164 6472 6573  xt to the addres\n+0000a180: 730a 2020 2020 2053 4552 5645 525f 4155  s.     SERVER_AU\n+0000a190: 5448 2069 7320 706f 696e 7469 6e67 2074  TH is pointing t\n+0000a1a0: 6f2e 2020 5468 6520 7265 7475 726e 2076  o.  The return v\n+0000a1b0: 616c 7565 2069 7320 616e 2046 4b4f 2065  alue is an FKO e\n+0000a1c0: 7272 6f72 0a20 2020 2020 7374 6174 7573  rror.     status\n+0000a1d0: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:\n+0000a1e0: 2069 6e74 2066 6b6f 5f67 6574 5f73 7061   int fko_get_spa\n+0000a1f0: 5f63 6c69 656e 745f 7469 6d65 6f75 7420  _client_timeout \n+0000a200: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, \n+0000a210: 696e 740a 2020 2020 2020 2020 2020 2a43  int.          *C\n+0000a220: 4c49 454e 545f 5449 4d45 4f55 5429 3b0a  LIENT_TIMEOUT);.\n+0000a230: 2020 2020 2053 6574 7320 7468 6520 7661       Sets the va\n+0000a240: 6c75 6520 6f66 2074 6865 2043 4c49 454e  lue of the CLIEN\n+0000a250: 545f 5449 4d45 4f55 5420 7661 7269 6162  T_TIMEOUT variab\n+0000a260: 6c65 2074 6f20 7468 6520 636c 6965 6e74  le to the client\n+0000a270: 5f74 696d 656f 7574 0a20 2020 2020 7661  _timeout.     va\n+0000a280: 6c75 6520 6173 736f 6369 6174 6564 2077  lue associated w\n+0000a290: 6974 6820 7468 6520 6375 7272 656e 7420  ith the current \n+0000a2a0: 636f 6e74 6578 742e 2020 5468 6520 7265  context.  The re\n+0000a2b0: 7475 726e 2076 616c 7565 2069 7320 616e  turn value is an\n+0000a2c0: 0a20 2020 2020 464b 4f20 6572 726f 7220  .     FKO error \n+0000a2d0: 7374 6174 7573 2e0a 0a20 2d2d 2046 756e  status... -- Fun\n+0000a2e0: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f67  ction: int fko_g\n+0000a2f0: 6574 5f73 7061 5f64 6967 6573 745f 7479  et_spa_digest_ty\n+0000a300: 7065 2028 666b 6f5f 6374 785f 7420 4354  pe (fko_ctx_t CT\n+0000a310: 582c 2073 686f 7274 0a20 2020 2020 2020  X, short.       \n+0000a320: 2020 202a 4449 4745 5354 5f54 5950 4529     *DIGEST_TYPE)\n+0000a330: 3b0a 2020 2020 2053 6574 7320 7468 6520  ;.     Sets the \n+0000a340: 7661 6c75 6520 6f66 2074 6865 2044 4947  value of the DIG\n+0000a350: 4553 545f 5459 5045 2076 6172 6961 626c  EST_TYPE variabl\n+0000a360: 6520 746f 2074 6865 2064 6967 6573 7420  e to the digest \n+0000a370: 7479 7065 2076 616c 7565 0a20 2020 2020  type value.     \n+0000a380: 6173 736f 6369 6174 6564 2077 6974 6820  associated with \n+0000a390: 7468 6520 6375 7272 656e 7420 636f 6e74  the current cont\n+0000a3a0: 6578 742e 2020 5468 6973 2076 616c 7565  ext.  This value\n+0000a3b0: 2063 616e 2062 6520 6368 6563 6b65 640a   can be checked.\n+0000a3c0: 2020 2020 2061 6761 696e 7374 2074 6865       against the\n+0000a3d0: 206c 6973 7420 6f66 2076 616c 6964 2064   list of valid d\n+0000a3e0: 6967 6573 745f 7479 7065 7320 6c69 7374  igest_types list\n+0000a3f0: 6564 2069 6e20 2a6e 6f74 6520 4469 6765  ed in *note Dige\n+0000a400: 7374 733a 3a20 6f66 0a20 2020 2020 7468  sts:: of.     th\n+0000a410: 6973 206d 616e 7561 6c2e 2020 5468 6520  is manual.  The \n+0000a420: 7265 7475 726e 2076 616c 7565 2069 7320  return value is \n+0000a430: 616e 2046 4b4f 2065 7272 6f72 2073 7461  an FKO error sta\n+0000a440: 7475 732e 0a0a 202d 2d20 4675 6e63 7469  tus... -- Functi\n+0000a450: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_\n+0000a460: 7370 615f 686d 6163 5f74 7970 6520 2866  spa_hmac_type (f\n+0000a470: 6b6f 5f63 7478 5f74 2043 5458 2c20 7368  ko_ctx_t CTX, sh\n+0000a480: 6f72 740a 2020 2020 2020 2020 2020 2a48  ort.          *H\n+0000a490: 4d41 435f 5459 5045 293b 0a20 2020 2020  MAC_TYPE);.     \n+0000a4a0: 5365 7473 2074 6865 2076 616c 7565 206f  Sets the value o\n+0000a4b0: 6620 7468 6520 484d 4143 5f54 5950 4520  f the HMAC_TYPE \n+0000a4c0: 7661 7269 6162 6c65 2074 6f20 7468 6520  variable to the \n+0000a4d0: 484d 4143 2074 7970 6520 7661 6c75 650a  HMAC type value.\n+0000a4e0: 2020 2020 2061 7373 6f63 6961 7465 6420       associated \n+0000a4f0: 7769 7468 2074 6865 2063 7572 7265 6e74  with the current\n+0000a500: 2063 6f6e 7465 7874 2e20 2054 6869 7320   context.  This \n+0000a510: 7661 6c75 6520 6361 6e20 6265 2063 6865  value can be che\n+0000a520: 636b 6564 0a20 2020 2020 6167 6169 6e73  cked.     agains\n+0000a530: 7420 7468 6520 6c69 7374 206f 6620 7661  t the list of va\n+0000a540: 6c69 6420 686d 6163 5f74 7970 6573 206c  lid hmac_types l\n+0000a550: 6973 7465 6420 696e 202a 6e6f 7465 2048  isted in *note H\n+0000a560: 4d41 4320 4469 6765 7374 733a 3a0a 2020  MAC Digests::.  \n+0000a570: 2020 206f 6620 7468 6973 206d 616e 7561     of this manua\n+0000a580: 6c2e 2020 5468 6520 7265 7475 726e 2076  l.  The return v\n+0000a590: 616c 7565 2069 7320 616e 2046 4b4f 2065  alue is an FKO e\n+0000a5a0: 7272 6f72 2073 7461 7475 732e 0a0a 202d  rror status... -\n+0000a5b0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int \n+0000a5c0: 666b 6f5f 6765 745f 7370 615f 6469 6765  fko_get_spa_dige\n+0000a5d0: 7374 2028 666b 6f5f 6374 785f 7420 4354  st (fko_ctx_t CT\n+0000a5e0: 582c 2063 6861 7220 2a2a 5350 415f 4449  X, char **SPA_DI\n+0000a5f0: 4745 5354 293b 0a20 2020 2020 4173 7369  GEST);.     Assi\n+0000a600: 676e 7320 7468 6520 706f 696e 7465 7220  gns the pointer \n+0000a610: 746f 2074 6865 2073 7472 696e 6720 686f  to the string ho\n+0000a620: 6c64 696e 6720 7468 6520 7468 6520 666b  lding the the fk\n+0000a630: 6f20 5350 4120 6469 6765 7374 0a20 2020  o SPA digest.   \n+0000a640: 2020 7661 6c75 6520 6173 736f 6369 6174    value associat\n+0000a650: 6564 2077 6974 6820 7468 6520 6375 7272  ed with the curr\n+0000a660: 656e 7420 636f 6e74 6578 7420 746f 2074  ent context to t\n+0000a670: 6865 2061 6464 7265 7373 2053 5041 5f44  he address SPA_D\n+0000a680: 4947 4553 540a 2020 2020 2069 7320 706f  IGEST.     is po\n+0000a690: 696e 7469 6e67 2074 6f2e 2020 5468 6520  inting to.  The \n+0000a6a0: 7265 7475 726e 2076 616c 7565 2069 7320  return value is \n+0000a6b0: 616e 2046 4b4f 2065 7272 6f72 2073 7461  an FKO error sta\n+0000a6c0: 7475 732e 0a0a 202d 2d20 4675 6e63 7469  tus... -- Functi\n+0000a6d0: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_\n+0000a6e0: 7370 615f 686d 6163 2028 666b 6f5f 6374  spa_hmac (fko_ct\n+0000a6f0: 785f 7420 4354 582c 2063 6861 7220 2a2a  x_t CTX, char **\n+0000a700: 5350 415f 484d 4143 293b 0a20 2020 2020  SPA_HMAC);.     \n+0000a710: 4173 7369 676e 7320 7468 6520 706f 696e  Assigns the poin\n+0000a720: 7465 7220 746f 2074 6865 2073 7472 696e  ter to the strin\n+0000a730: 6720 686f 6c64 696e 6720 7468 6520 7468  g holding the th\n+0000a740: 6520 666b 6f20 5350 4120 484d 4143 0a20  e fko SPA HMAC. \n+0000a750: 2020 2020 7661 6c75 6520 6173 736f 6369      value associ\n+0000a760: 6174 6564 2077 6974 6820 7468 6520 6375  ated with the cu\n+0000a770: 7272 656e 7420 636f 6e74 6578 7420 746f  rrent context to\n+0000a780: 2074 6865 2061 6464 7265 7373 2053 5041   the address SPA\n+0000a790: 5f48 4d41 430a 2020 2020 2069 7320 706f  _HMAC.     is po\n+0000a7a0: 696e 7469 6e67 2074 6f2e 2020 5468 6520  inting to.  The \n+0000a7b0: 7265 7475 726e 2076 616c 7565 2069 7320  return value is \n+0000a7c0: 616e 2046 4b4f 2065 7272 6f72 2073 7461  an FKO error sta\n+0000a7d0: 7475 732e 0a0a 202d 2d20 4675 6e63 7469  tus... -- Functi\n+0000a7e0: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_\n+0000a7f0: 7370 615f 656e 6372 7970 7469 6f6e 5f74  spa_encryption_t\n+0000a800: 7970 6520 2866 6b6f 5f63 7478 5f74 2043  ype (fko_ctx_t C\n+0000a810: 5458 2c20 7368 6f72 740a 2020 2020 2020  TX, short.      \n+0000a820: 2020 2020 2a45 4e43 5f54 5950 4529 3b0a      *ENC_TYPE);.\n+0000a830: 2020 2020 2053 6574 7320 7468 6520 7661       Sets the va\n+0000a840: 6c75 6520 6f66 2074 6865 2045 4e43 5f54  lue of the ENC_T\n+0000a850: 5950 4520 7661 7269 6162 6c65 2074 6f20  YPE variable to \n+0000a860: 7468 6520 656e 6372 7970 7469 6f6e 2074  the encryption t\n+0000a870: 7970 650a 2020 2020 2076 616c 7565 2061  ype.     value a\n+0000a880: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t\n+0000a890: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte\n+0000a8a0: 7874 2e20 2054 6869 7320 7661 6c75 6520  xt.  This value \n+0000a8b0: 6361 6e20 6265 0a20 2020 2020 6368 6563  can be.     chec\n+0000a8c0: 6b65 6420 6167 6169 6e73 7420 7468 6520  ked against the \n+0000a8d0: 6c69 7374 206f 6620 7661 6c69 6420 6469  list of valid di\n+0000a8e0: 6765 7374 5f74 7970 6573 206c 6973 7465  gest_types liste\n+0000a8f0: 6420 696e 202a 6e6f 7465 0a20 2020 2020  d in *note.     \n+0000a900: 456e 6372 7970 7469 6f6e 2041 6c67 6f72  Encryption Algor\n+0000a910: 6974 686d 733a 3a20 6f66 2074 6869 7320  ithms:: of this \n+0000a920: 6d61 6e75 616c 2e20 2054 6865 2072 6574  manual.  The ret\n+0000a930: 7572 6e20 7661 6c75 6520 6973 2061 6e20  urn value is an \n+0000a940: 464b 4f0a 2020 2020 2065 7272 6f72 2073  FKO.     error s\n+0000a950: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func\n+0000a960: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge\n+0000a970: 745f 656e 636f 6465 645f 6461 7461 2028  t_encoded_data (\n+0000a980: 666b 6f5f 6374 785f 7420 4354 582c 2063  fko_ctx_t CTX, c\n+0000a990: 6861 7220 2a2a 454e 435f 4d53 4729 3b0a  har **ENC_MSG);.\n+0000a9a0: 2020 2020 2041 7373 6967 6e73 2074 6865       Assigns the\n+0000a9b0: 2070 6f69 6e74 6572 2074 6f20 7468 6520   pointer to the \n+0000a9c0: 7374 7269 6e67 2068 6f6c 6469 6e67 2074  string holding t\n+0000a9d0: 6865 2074 6865 2065 6e63 6f64 6564 2053  he the encoded S\n+0000a9e0: 5041 2064 6174 610a 2020 2020 2028 6265  PA data.     (be\n+0000a9f0: 666f 7265 2065 6e63 7279 7074 696f 6e29  fore encryption)\n+0000aa00: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with\n+0000aa10: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con\n+0000aa20: 7465 7874 2074 6f20 7468 650a 2020 2020  text to the.    \n+0000aa30: 2061 6464 7265 7373 2045 4e43 5f4d 5347   address ENC_MSG\n+0000aa40: 2069 7320 706f 696e 7469 6e67 2074 6f2e   is pointing to.\n+0000aa50: 2020 5468 6973 2069 7320 696e 7465 726d    This is interm\n+0000aa60: 6564 6961 7465 2064 6174 6120 7468 6174  ediate data that\n+0000aa70: 0a20 2020 2020 776f 756c 6420 6e6f 7420  .     would not \n+0000aa80: 6e6f 726d 616c 6c79 2062 6520 6f66 2075  normally be of u\n+0000aa90: 7365 2075 6e6c 6573 7320 6465 6275 6767  se unless debugg\n+0000aaa0: 696e 6720 7468 6520 6c69 6272 6172 792e  ing the library.\n+0000aab0: 2020 5468 650a 2020 2020 2072 6574 7572    The.     retur\n+0000aac0: 6e20 7661 6c75 6520 6973 2061 6e20 464b  n value is an FK\n+0000aad0: 4f20 6572 726f 7220 7374 6174 7573 2e0a  O error status..\n+0000aae0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i\n+0000aaf0: 6e74 2066 6b6f 5f67 6574 5f76 6572 7369  nt fko_get_versi\n+0000ab00: 6f6e 2028 666b 6f5f 6374 785f 7420 4354  on (fko_ctx_t CT\n+0000ab10: 582c 2063 6861 7220 2a2a 464b 4f5f 5645  X, char **FKO_VE\n+0000ab20: 5253 494f 4e29 3b0a 2020 2020 2041 7373  RSION);.     Ass\n+0000ab30: 6967 6e73 2074 6865 2070 6f69 6e74 6572  igns the pointer\n+0000ab40: 2074 6f20 7468 6520 7374 7269 6e67 2068   to the string h\n+0000ab50: 6f6c 6469 6e67 2074 6865 2074 6865 2053  olding the the S\n+0000ab60: 5041 2076 6572 7369 6f6e 2076 616c 7565  PA version value\n+0000ab70: 0a20 2020 2020 6173 736f 6369 6174 6564  .     associated\n+0000ab80: 2077 6974 6820 7468 6520 6375 7272 656e   with the curren\n+0000ab90: 7420 636f 6e74 6578 7420 746f 2074 6865  t context to the\n+0000aba0: 2061 6464 7265 7373 2046 4b4f 5f56 4552   address FKO_VER\n+0000abb0: 5349 4f4e 2069 730a 2020 2020 2070 6f69  SION is.     poi\n+0000abc0: 6e74 696e 6720 746f 2e20 2054 6869 7320  nting to.  This \n+0000abd0: 6973 2061 2073 7461 7469 6320 7661 6c75  is a static valu\n+0000abe0: 6520 666f 7220 5350 4120 6461 7461 2074  e for SPA data t\n+0000abf0: 6861 7420 6973 2062 6569 6e67 0a20 2020  hat is being.   \n+0000ac00: 2020 6372 6561 7465 6420 696e 2061 206e    created in a n\n+0000ac10: 6577 2063 6f6e 7465 7874 2e20 2046 6f72  ew context.  For\n+0000ac20: 2064 6174 6120 7061 7273 6564 2066 726f   data parsed fro\n+0000ac30: 6d20 616e 2065 7874 6572 6e61 6c20 736f  m an external so\n+0000ac40: 7572 6365 2c0a 2020 2020 2074 6865 2076  urce,.     the v\n+0000ac50: 6572 7369 6f6e 2073 7472 696e 6720 7769  ersion string wi\n+0000ac60: 6c6c 2062 6520 7768 6174 6576 6572 2076  ll be whatever v\n+0000ac70: 6572 7369 6f6e 2074 6865 2073 656e 6469  ersion the sendi\n+0000ac80: 6e67 2063 6c69 656e 740a 2020 2020 2075  ng client.     u\n+0000ac90: 7365 642e 2020 5468 6520 7265 7475 726e  sed.  The return\n+0000aca0: 2076 616c 7565 2069 7320 616e 2046 4b4f   value is an FKO\n+0000acb0: 2065 7272 6f72 2073 7461 7475 732e 0a0a   error status...\n+0000acc0: 5f47 5047 2d73 7065 6369 6669 6320 6675  _GPG-specific fu\n+0000acd0: 6e63 7469 6f6e 733a 5f0a 0a20 2d2d 2046  nctions:_.. -- F\n+0000ace0: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko\n+0000acf0: 5f67 6574 5f67 7067 5f72 6563 6970 6965  _get_gpg_recipie\n+0000ad00: 6e74 2028 666b 6f5f 6374 785f 7420 4354  nt (fko_ctx_t CT\n+0000ad10: 582c 2063 6861 720a 2020 2020 2020 2020  X, char.        \n+0000ad20: 2020 2a2a 5245 4349 5049 454e 5429 3b0a    **RECIPIENT);.\n+0000ad30: 2020 2020 2041 7373 6967 6e73 2074 6865       Assigns the\n+0000ad40: 2070 6f69 6e74 6572 2074 6f20 7468 6520   pointer to the \n+0000ad50: 7374 7269 6e67 2068 6f6c 6469 6e67 2074  string holding t\n+0000ad60: 6865 2074 6865 2047 5047 2072 6563 6970  he the GPG recip\n+0000ad70: 6965 6e74 2049 440a 2020 2020 2061 7373  ient ID.     ass\n+0000ad80: 6f63 6961 7465 6420 7769 7468 2074 6865  ociated with the\n+0000ad90: 2063 7572 7265 6e74 2063 6f6e 7465 7874   current context\n+0000ada0: 2074 6f20 7468 6520 6164 6472 6573 7320   to the address \n+0000adb0: 5245 4349 5049 454e 5420 6973 0a20 2020  RECIPIENT is.   \n+0000adc0: 2020 706f 696e 7469 6e67 2074 6f2e 2020    pointing to.  \n+0000add0: 5468 6520 7265 7475 726e 2076 616c 7565  The return value\n+0000ade0: 2069 7320 616e 2046 4b4f 2065 7272 6f72   is an FKO error\n+0000adf0: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu\n+0000ae00: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_\n+0000ae10: 6765 745f 6770 675f 7369 676e 6572 2028  get_gpg_signer (\n+0000ae20: 666b 6f5f 6374 785f 7420 4354 582c 2063  fko_ctx_t CTX, c\n+0000ae30: 6861 7220 2a2a 5349 474e 4552 293b 0a20  har **SIGNER);. \n+0000ae40: 2020 2020 4173 7369 676e 7320 7468 6520      Assigns the \n+0000ae50: 706f 696e 7465 7220 746f 2074 6865 2073  pointer to the s\n+0000ae60: 7472 696e 6720 686f 6c64 696e 6720 7468  tring holding th\n+0000ae70: 6520 7468 6520 4750 4720 7369 676e 6572  e the GPG signer\n+0000ae80: 2049 440a 2020 2020 2061 7373 6f63 6961   ID.     associa\n+0000ae90: 7465 6420 7769 7468 2074 6865 2063 7572  ted with the cur\n+0000aea0: 7265 6e74 2063 6f6e 7465 7874 2074 6f20  rent context to \n+0000aeb0: 7468 6520 6164 6472 6573 7320 5349 474e  the address SIGN\n+0000aec0: 4552 2069 730a 2020 2020 2070 6f69 6e74  ER is.     point\n+0000aed0: 696e 6720 746f 2e20 2054 6865 2072 6574  ing to.  The ret\n+0000aee0: 7572 6e20 7661 6c75 6520 6973 2061 6e20  urn value is an \n+0000aef0: 464b 4f20 6572 726f 7220 7374 6174 7573  FKO error status\n+0000af00: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:\n+0000af10: 2069 6e74 2066 6b6f 5f67 6574 5f67 7067   int fko_get_gpg\n+0000af20: 5f68 6f6d 655f 6469 7220 2866 6b6f 5f63  _home_dir (fko_c\n+0000af30: 7478 5f74 2043 5458 2c20 6368 6172 202a  tx_t CTX, char *\n+0000af40: 2a47 5047 5f44 4952 293b 0a20 2020 2020  *GPG_DIR);.     \n+0000af50: 4173 7369 676e 7320 7468 6520 706f 696e  Assigns the poin\n+0000af60: 7465 7220 746f 2074 6865 2073 7472 696e  ter to the strin\n+0000af70: 6720 686f 6c64 696e 6720 7468 6520 7468  g holding the th\n+0000af80: 6520 4750 4720 686f 6d65 0a20 2020 2020  e GPG home.     \n+0000af90: 6469 7265 6374 6f72 7920 6173 736f 6369  directory associ\n+0000afa0: 6174 6564 2077 6974 6820 7468 6520 6375  ated with the cu\n+0000afb0: 7272 656e 7420 636f 6e74 6578 7420 746f  rrent context to\n+0000afc0: 2074 6865 2061 6464 7265 7373 0a20 2020   the address.   \n+0000afd0: 2020 4750 475f 4449 5220 6973 2070 6f69    GPG_DIR is poi\n+0000afe0: 6e74 696e 6720 746f 2e20 2054 6865 2072  nting to.  The r\n+0000aff0: 6574 7572 6e20 7661 6c75 6520 6973 2061  eturn value is a\n+0000b000: 6e20 464b 4f20 6572 726f 7220 7374 6174  n FKO error stat\n+0000b010: 7573 2e0a 0a20 2d2d 2046 756e 6374 696f  us... -- Functio\n+0000b020: 6e3a 2069 6e74 2066 6b6f 5f67 6574 5f67  n: int fko_get_g\n+0000b030: 7067 5f73 6967 6e61 7475 7265 5f76 6572  pg_signature_ver\n+0000b040: 6966 7920 2866 6b6f 5f63 7478 5f74 2043  ify (fko_ctx_t C\n+0000b050: 5458 2c20 756e 7369 676e 6564 0a20 2020  TX, unsigned.   \n+0000b060: 2020 2020 2020 2063 6861 7220 2a56 414c         char *VAL\n+0000b070: 293b 0a20 2020 2020 5365 7473 2074 6865  );.     Sets the\n+0000b080: 2076 616c 7565 206f 6620 7468 6520 5641   value of the VA\n+0000b090: 4c20 7661 7269 6162 6c65 2074 6f20 7468  L variable to th\n+0000b0a0: 6520 6375 7272 656e 740a 2020 2020 2067  e current.     g\n+0000b0b0: 7067 5f73 6967 6e61 7475 7265 5f76 6572  pg_signature_ver\n+0000b0c0: 6966 7920 666c 6167 2076 616c 7565 2061  ify flag value a\n+0000b0d0: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t\n+0000b0e0: 6865 2063 7572 7265 6e74 0a20 2020 2020  he current.     \n+0000b0f0: 636f 6e74 6578 742e 2020 5468 6520 7265  context.  The re\n+0000b100: 7475 726e 2076 616c 7565 2069 7320 616e  turn value is an\n+0000b110: 2046 4b4f 2065 7272 6f72 2073 7461 7475   FKO error statu\n+0000b120: 732e 0a0a 202d 2d20 4675 6e63 7469 6f6e  s... -- Function\n+0000b130: 3a20 696e 7420 666b 6f5f 6765 745f 6770  : int fko_get_gp\n+0000b140: 675f 6967 6e6f 7265 5f76 6572 6966 795f  g_ignore_verify_\n+0000b150: 6572 726f 7220 2866 6b6f 5f63 7478 5f74  error (fko_ctx_t\n+0000b160: 2043 5458 2c0a 2020 2020 2020 2020 2020   CTX,.          \n+0000b170: 756e 7369 676e 6564 2063 6861 7220 2a56  unsigned char *V\n+0000b180: 414c 293b 0a20 2020 2020 5365 7473 2074  AL);.     Sets t\n+0000b190: 6865 2076 616c 7565 206f 6620 7468 6520  he value of the \n+0000b1a0: 5641 4c20 7661 7269 6162 6c65 2074 6f20  VAL variable to \n+0000b1b0: 7468 6520 6375 7272 656e 740a 2020 2020  the current.    \n+0000b1c0: 2069 676e 6f72 655f 7665 7269 6679 5f65   ignore_verify_e\n+0000b1d0: 7272 6f72 2066 6c61 6720 7661 6c75 6520  rror flag value \n+0000b1e0: 6173 736f 6369 6174 6564 2077 6974 6820  associated with \n+0000b1f0: 7468 6520 6375 7272 656e 7420 636f 6e74  the current cont\n+0000b200: 6578 742e 0a20 2020 2020 5468 6520 7265  ext..     The re\n+0000b210: 7475 726e 2076 616c 7565 2069 7320 616e  turn value is an\n+0000b220: 2046 4b4f 2065 7272 6f72 2073 7461 7475   FKO error statu\n+0000b230: 732e 0a0a 202d 2d20 4675 6e63 7469 6f6e  s... -- Function\n+0000b240: 3a20 696e 7420 666b 6f5f 6765 745f 6770  : int fko_get_gp\n+0000b250: 675f 7369 676e 6174 7572 655f 6964 2028  g_signature_id (\n+0000b260: 666b 6f5f 6374 785f 7420 4354 582c 2063  fko_ctx_t CTX, c\n+0000b270: 6861 720a 2020 2020 2020 2020 2020 2a2a  har.          **\n+0000b280: 5349 475f 4944 293b 0a20 2020 2020 4173  SIG_ID);.     As\n+0000b290: 7369 676e 7320 7468 6520 706f 696e 7465  signs the pointe\n+0000b2a0: 7220 746f 2074 6865 2073 7472 696e 6720  r to the string \n+0000b2b0: 686f 6c64 696e 6720 7468 6520 7468 6520  holding the the \n+0000b2c0: 4750 4720 7369 676e 6174 7572 6520 4944  GPG signature ID\n+0000b2d0: 0a20 2020 2020 6173 736f 6369 6174 6564  .     associated\n+0000b2e0: 2077 6974 6820 7468 6520 6375 7272 656e   with the curren\n+0000b2f0: 7420 636f 6e74 6578 7420 746f 2074 6865  t context to the\n+0000b300: 2061 6464 7265 7373 2053 4947 5f49 4420   address SIG_ID \n+0000b310: 6973 0a20 2020 2020 706f 696e 7469 6e67  is.     pointing\n+0000b320: 2074 6f2e 2020 5468 6520 7265 7475 726e   to.  The return\n+0000b330: 2076 616c 7565 2069 7320 616e 2046 4b4f   value is an FKO\n+0000b340: 2065 7272 6f72 2073 7461 7475 732e 0a0a   error status...\n+0000b350: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in\n+0000b360: 7420 666b 6f5f 6765 745f 6770 675f 7369  t fko_get_gpg_si\n+0000b370: 676e 6174 7572 655f 6670 7220 2866 6b6f  gnature_fpr (fko\n+0000b380: 5f63 7478 5f74 2043 5458 2c20 6368 6172  _ctx_t CTX, char\n+0000b390: 0a20 2020 2020 2020 2020 202a 2a53 4947  .          **SIG\n+0000b3a0: 5f46 5052 293b 0a20 2020 2020 4173 7369  _FPR);.     Assi\n+0000b3b0: 676e 7320 7468 6520 706f 696e 7465 7220  gns the pointer \n+0000b3c0: 746f 2074 6865 2073 7472 696e 6720 686f  to the string ho\n+0000b3d0: 6c64 696e 6720 7468 6520 7468 6520 4750  lding the the GP\n+0000b3e0: 4720 7369 676e 6174 7572 650a 2020 2020  G signature.    \n+0000b3f0: 2066 696e 6765 7270 7269 6e74 2061 7373   fingerprint ass\n+0000b400: 6f63 6961 7465 6420 7769 7468 2074 6865  ociated with the\n+0000b410: 2063 7572 7265 6e74 2063 6f6e 7465 7874   current context\n+0000b420: 2074 6f20 7468 6520 6164 6472 6573 730a   to the address.\n+0000b430: 2020 2020 2053 4947 5f46 5052 2069 7320       SIG_FPR is \n+0000b440: 706f 696e 7469 6e67 2074 6f2e 2020 5468  pointing to.  Th\n+0000b450: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i\n+0000b460: 7320 616e 2046 4b4f 2065 7272 6f72 2073  s an FKO error s\n+0000b470: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func\n+0000b480: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge\n+0000b490: 745f 6770 675f 7369 676e 6174 7572 655f  t_gpg_signature_\n+0000b4a0: 7375 6d6d 6172 7920 2866 6b6f 5f63 7478  summary (fko_ctx\n+0000b4b0: 5f74 2043 5458 2c20 696e 740a 2020 2020  _t CTX, int.    \n+0000b4c0: 2020 2020 2020 2a53 4947 5f53 554d 293b        *SIG_SUM);\n+0000b4d0: 0a20 2020 2020 5365 7473 2074 6865 2076  .     Sets the v\n+0000b4e0: 616c 7565 206f 6620 7468 6520 5349 475f  alue of the SIG_\n+0000b4f0: 5355 4d20 7661 7269 6162 6c65 2074 6f20  SUM variable to \n+0000b500: 7468 6520 4750 4720 7369 676e 6174 7572  the GPG signatur\n+0000b510: 6520 7375 6d6d 6172 790a 2020 2020 2076  e summary.     v\n+0000b520: 616c 7565 2061 7373 6f63 6961 7465 6420  alue associated \n+0000b530: 7769 7468 2074 6865 2063 7572 7265 6e74  with the current\n+0000b540: 2063 6f6e 7465 7874 2e20 2054 6865 2072   context.  The r\n+0000b550: 6574 7572 6e20 7661 6c75 6520 6973 2061  eturn value is a\n+0000b560: 6e0a 2020 2020 2046 4b4f 2065 7272 6f72  n.     FKO error\n+0000b570: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu\n+0000b580: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_\n+0000b590: 6765 745f 6770 675f 7369 676e 6174 7572  get_gpg_signatur\n+0000b5a0: 655f 7374 6174 7573 2028 666b 6f5f 6374  e_status (fko_ct\n+0000b5b0: 785f 7420 4354 582c 2069 6e74 0a20 2020  x_t CTX, int.   \n+0000b5c0: 2020 2020 2020 202a 5349 475f 5354 4154         *SIG_STAT\n+0000b5d0: 293b 0a20 2020 2020 5365 7473 2074 6865  );.     Sets the\n+0000b5e0: 2076 616c 7565 206f 6620 7468 6520 5349   value of the SI\n+0000b5f0: 475f 5354 4154 2076 6172 6961 626c 6520  G_STAT variable \n+0000b600: 746f 2074 6865 2047 5047 2073 6967 6e61  to the GPG signa\n+0000b610: 7475 7265 2065 7272 6f72 0a20 2020 2020  ture error.     \n+0000b620: 7374 6174 7573 2076 616c 7565 2061 7373  status value ass\n+0000b630: 6f63 6961 7465 6420 7769 7468 2074 6865  ociated with the\n+0000b640: 2063 7572 7265 6e74 2063 6f6e 7465 7874   current context\n+0000b650: 2e20 2054 6865 2072 6574 7572 6e20 7661  .  The return va\n+0000b660: 6c75 650a 2020 2020 2069 7320 616e 2046  lue.     is an F\n+0000b670: 4b4f 2065 7272 6f72 2073 7461 7475 732e  KO error status.\n+0000b680: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: \n+0000b690: 696e 7420 666b 6f5f 6765 745f 6770 675f  int fko_get_gpg_\n+0000b6a0: 6578 6520 2866 6b6f 5f63 7478 5f74 2043  exe (fko_ctx_t C\n+0000b6b0: 5458 2c20 6368 6172 202a 2a47 5047 5f45  TX, char **GPG_E\n+0000b6c0: 5845 293b 0a20 2020 2020 4173 7369 676e  XE);.     Assign\n+0000b6d0: 7320 7468 6520 706f 696e 7465 7220 746f  s the pointer to\n+0000b6e0: 2074 6865 2073 7472 696e 6720 686f 6c64   the string hold\n+0000b6f0: 696e 6720 7468 6520 7468 6520 4750 4720  ing the the GPG \n+0000b700: 6578 6563 7574 6162 6c65 0a20 2020 2020  executable.     \n+0000b710: 7061 7468 2061 7373 6f63 6961 7465 6420  path associated \n+0000b720: 7769 7468 2074 6865 2063 7572 7265 6e74  with the current\n+0000b730: 2063 6f6e 7465 7874 2074 6f20 7468 6520   context to the \n+0000b740: 6164 6472 6573 7320 4750 475f 4558 4520  address GPG_EXE \n+0000b750: 6973 0a20 2020 2020 706f 696e 7469 6e67  is.     pointing\n+0000b760: 2074 6f2e 2020 5468 6520 7265 7475 726e   to.  The return\n+0000b770: 2076 616c 7565 2069 7320 616e 2046 4b4f   value is an FKO\n+0000b780: 2065 7272 6f72 2073 7461 7475 732e 0a0a   error status...\n+0000b790: 2a4e 6f74 652a 3a20 5468 6520 6368 6172  *Note*: The char\n+0000b7a0: 2a20 7661 6c75 6573 2072 6574 7269 6576  * values retriev\n+0000b7b0: 6564 2062 7920 7468 6520 4750 472d 7265  ed by the GPG-re\n+0000b7c0: 6c61 7465 6420 6675 6e63 7469 6f6e 7320  lated functions \n+0000b7d0: 6162 6f76 650a 7769 6c6c 2062 6520 4e55  above.will be NU\n+0000b7e0: 4c4c 2069 6620 7468 6520 636f 6e74 6578  LL if the contex\n+0000b7f0: 7420 7661 6c75 6520 7761 7320 6e6f 7420  t value was not \n+0000b800: 7072 6576 696f 7573 6c79 2073 6574 2e0a  previously set..\n+0000b810: 0a1f 0a46 696c 653a 206c 6962 666b 6f2e  ...File: libfko.\n+0000b820: 696e 666f 2c20 204e 6f64 653a 2055 7469  info,  Node: Uti\n+0000b830: 6c69 7479 2046 756e 6374 696f 6e73 2c20  lity Functions, \n+0000b840: 204e 6578 743a 2045 7272 6f72 2048 616e   Next: Error Han\n+0000b850: 646c 696e 672c 2020 5072 6576 3a20 5265  dling,  Prev: Re\n+0000b860: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat\n+0000b870: 612c 2020 5570 3a20 5573 696e 6720 6c69  a,  Up: Using li\n+0000b880: 6266 6b6f 0a0a 332e 3620 5574 696c 6974  bfko..3.6 Utilit\n+0000b890: 7920 4675 6e63 7469 6f6e 730a 3d3d 3d3d  y Functions.====\n 0000b8a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================\n-0000b8b0: 3d3d 3d0a 0a54 6869 7320 7365 6374 696f  ===..This sectio\n-0000b8c0: 6e20 6465 7363 7269 6265 7320 7468 6520  n describes the \n-0000b8d0: 6675 6e63 7469 6f6e 7320 6e6f 7420 636f  functions not co\n-0000b8e0: 7665 7265 6420 656c 7365 7768 6572 6520  vered elsewhere \n-0000b8f0: 696e 2074 6869 730a 6d61 6e75 616c 2e20  in this.manual. \n-0000b900: 2054 6865 7365 2061 7265 2075 7469 6c69   These are utili\n-0000b910: 7479 2066 756e 6374 696f 6e73 2074 6861  ty functions tha\n-0000b920: 7420 6f70 6572 6174 6520 6f6e 2074 6865  t operate on the\n-0000b930: 2064 6174 6120 696e 2074 6865 2066 6b6f   data in the fko\n-0000b940: 0a63 6f6e 7465 7874 2e20 2041 6c6c 2062  .context.  All b\n-0000b950: 7574 2027 666b 6f5f 7370 615f 6461 7461  ut 'fko_spa_data\n-0000b960: 5f66 696e 616c 2720 6172 6520 6361 6c6c  _final' are call\n-0000b970: 6564 2062 7920 6f74 6865 7220 6675 6e63  ed by other func\n-0000b980: 7469 6f6e 7320 616e 640a 6172 6520 6e6f  tions and.are no\n-0000b990: 7420 6e6f 726d 616c 6c79 2065 7870 6c69  t normally expli\n-0000b9a0: 6369 746c 7920 6361 6c6c 6564 2062 7920  citly called by \n-0000b9b0: 7468 6520 7573 6572 2e20 2048 6f77 6576  the user.  Howev\n-0000b9c0: 6572 2c20 7468 6579 2063 616e 2062 652c  er, they can be,\n-0000b9d0: 0a73 6f20 7468 6579 2061 7265 206c 6973  .so they are lis\n-0000b9e0: 7465 6420 6865 7265 2e0a 0a20 2020 416c  ted here...   Al\n-0000b9f0: 6c20 6f66 2074 6865 7365 2066 756e 6374  l of these funct\n-0000ba00: 696f 6e73 2072 6574 7572 6e20 616e 2069  ions return an i\n-0000ba10: 6e74 6567 6572 2072 6570 7265 7365 6e74  nteger represent\n-0000ba20: 696e 6720 7468 6520 7265 7475 726e 0a73  ing the return.s\n-0000ba30: 7461 7475 7320 6f66 2074 6865 2066 756e  tatus of the fun\n-0000ba40: 6374 696f 6e2e 2020 5768 656e 2073 7563  ction.  When suc\n-0000ba50: 6365 7366 756c 6c2c 2074 6865 7920 7769  cesfull, they wi\n-0000ba60: 6c6c 2072 6574 7572 6e0a 2746 4b4f 5f53  ll return.'FKO_S\n-0000ba70: 5543 4345 5353 272e 2020 4f74 6865 7277  UCCESS'.  Otherw\n-0000ba80: 6973 652c 2061 6e20 6572 726f 7220 636f  ise, an error co\n-0000ba90: 6465 2076 616c 7565 2069 7320 7265 7475  de value is retu\n-0000baa0: 726e 6564 2e0a 0a20 2d2d 2046 756e 6374  rned... -- Funct\n-0000bab0: 696f 6e3a 2069 6e74 2066 6b6f 5f73 7061  ion: int fko_spa\n-0000bac0: 5f64 6174 615f 6669 6e61 6c20 2866 6b6f  _data_final (fko\n-0000bad0: 5f63 7478 5f74 2043 5458 2c20 6368 6172  _ctx_t CTX, char\n-0000bae0: 202a 454e 435f 4b45 592c 2069 6e74 0a20   *ENC_KEY, int. \n-0000baf0: 2020 2020 2020 2020 204b 454e 5f4c 454e           KEN_LEN\n-0000bb00: 2c20 6368 6172 202a 484d 4143 5f4b 4559  , char *HMAC_KEY\n-0000bb10: 2c20 696e 7420 484d 4143 5f4b 4559 5f4c  , int HMAC_KEY_L\n-0000bb20: 454e 293b 0a20 2020 2020 5468 6973 2066  EN);.     This f\n-0000bb30: 756e 6374 696f 6e20 6973 2074 6865 2066  unction is the f\n-0000bb40: 696e 616c 2073 7465 7020 696e 2063 7265  inal step in cre\n-0000bb50: 6174 696e 6720 6120 636f 6d70 6c65 7465  ating a complete\n-0000bb60: 2065 6e63 7279 7074 6564 0a20 2020 2020   encrypted.     \n-0000bb70: 5350 4120 6461 7461 2073 7472 696e 6720  SPA data string \n-0000bb80: 7375 6974 6162 6c65 2066 6f72 2074 7261  suitable for tra\n-0000bb90: 6e73 6d69 7373 696f 6e20 746f 2061 6e20  nsmission to an \n-0000bba0: 6677 6b6e 6f70 2073 6572 7665 722e 2020  fwknop server.  \n-0000bbb0: 4974 0a20 2020 2020 646f 6573 2072 6571  It.     does req\n-0000bbc0: 7569 7265 2061 6c6c 206f 6620 7468 6520  uire all of the \n-0000bbd0: 7265 7175 6973 6974 6520 5350 4120 6461  requisite SPA da\n-0000bbe0: 7461 2066 6965 6c64 7320 6265 2073 6574  ta fields be set\n-0000bbf0: 2c20 6f74 6865 7277 6973 650a 2020 2020  , otherwise.    \n-0000bc00: 2069 7420 7769 6c6c 2066 6169 6c20 7769   it will fail wi\n-0000bc10: 7468 2061 6e20 6170 7072 6f70 7269 6174  th an appropriat\n-0000bc20: 6520 6572 726f 7220 636f 6465 2e0a 0a20  e error code... \n-0000bc30: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int\n-0000bc40: 2066 6b6f 5f64 6563 7279 7074 5f73 7061   fko_decrypt_spa\n-0000bc50: 5f64 6174 6120 2866 6b6f 5f63 7478 5f74  _data (fko_ctx_t\n-0000bc60: 2043 5458 2c20 6368 6172 202a 4445 435f   CTX, char *DEC_\n-0000bc70: 4b45 592c 0a20 2020 2020 2020 2020 2069  KEY,.          i\n-0000bc80: 6e74 204b 4559 5f4c 454e 293b 0a20 2020  nt KEY_LEN);.   \n-0000bc90: 2020 5768 656e 2067 6976 656e 2074 6865    When given the\n-0000bca0: 2063 6f72 7265 6374 204b 4559 2028 7061   correct KEY (pa\n-0000bcb0: 7373 776f 7264 292c 2074 6869 7320 6675  ssword), this fu\n-0000bcc0: 6e63 7469 6f6e 2064 6563 7279 7074 732c  nction decrypts,\n-0000bcd0: 0a20 2020 2020 6465 636f 6465 732c 2061  .     decodes, a\n-0000bce0: 6e64 2070 6172 7365 7320 7468 6520 656e  nd parses the en\n-0000bcf0: 6372 7970 7465 6420 5350 4120 6461 7461  crypted SPA data\n-0000bd00: 2074 6861 7420 7761 7320 7375 7070 6c69   that was suppli\n-0000bd10: 6564 2074 6f20 7468 650a 2020 2020 2063  ed to the.     c\n-0000bd20: 6f6e 7465 7874 2076 6961 2074 6865 2027  ontext via the '\n-0000bd30: 666b 6f5f 6e65 775f 7769 7468 5f64 6174  fko_new_with_dat\n-0000bd40: 6127 2066 756e 6374 696f 6e20 7468 6174  a' function that\n-0000bd50: 2077 6173 2061 6c73 6f20 6361 6c6c 6564   was also called\n-0000bd60: 0a20 2020 2020 7769 7468 6f75 7420 7468  .     without th\n-0000bd70: 6520 4b45 5920 7661 6c75 652e 2020 4f6e  e KEY value.  On\n-0000bd80: 6365 2074 6865 2064 6174 6120 6973 2064  ce the data is d\n-0000bd90: 6563 7279 7074 6564 2c20 7468 6973 2066  ecrypted, this f\n-0000bda0: 756e 6374 696f 6e0a 2020 2020 2077 696c  unction.     wil\n-0000bdb0: 6c20 616c 736f 2063 616c 6c20 2766 6b6f  l also call 'fko\n-0000bdc0: 5f64 6563 6f64 655f 7370 615f 6461 7461  _decode_spa_data\n-0000bdd0: 2720 746f 2064 6563 6f64 652c 2070 6172  ' to decode, par\n-0000bde0: 7365 2c20 7661 6c69 6461 7465 2c0a 2020  se, validate,.  \n-0000bdf0: 2020 2061 6e64 2073 746f 7265 2074 6865     and store the\n-0000be00: 2064 6174 6120 6669 656c 6473 2069 6e20   data fields in \n-0000be10: 7468 6520 636f 6e74 6578 7420 666f 7220  the context for \n-0000be20: 6c61 7465 7220 7265 7472 6965 7661 6c2e  later retrieval.\n-0000be30: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: \n-0000be40: 696e 7420 666b 6f5f 656e 6372 7970 745f  int fko_encrypt_\n-0000be50: 7370 615f 6461 7461 2028 666b 6f5f 6374  spa_data (fko_ct\n-0000be60: 785f 7420 4354 582c 2063 6861 7220 2a45  x_t CTX, char *E\n-0000be70: 4e43 5f4b 4559 2c0a 2020 2020 2020 2020  NC_KEY,.        \n-0000be80: 2020 696e 7420 4b45 595f 4c45 4e29 3b0a    int KEY_LEN);.\n-0000be90: 2020 2020 2045 6e63 7279 7074 7320 7468       Encrypts th\n-0000bea0: 6520 696e 7465 726d 6564 6961 7465 2065  e intermediate e\n-0000beb0: 6e63 6f64 6564 2053 5041 2064 6174 6120  ncoded SPA data \n-0000bec0: 7374 6f72 6564 2069 6e20 7468 6520 636f  stored in the co\n-0000bed0: 6e74 6578 742e 0a20 2020 2020 5468 6973  ntext..     This\n-0000bee0: 2066 756e 6374 696f 6e20 7769 6c6c 2063   function will c\n-0000bef0: 616c 6c20 2766 6b6f 5f65 6e63 6f64 6527  all 'fko_encode'\n-0000bf00: 2069 6620 6e65 6365 7373 6172 792e 2020   if necessary.  \n-0000bf10: 4974 2069 7320 6e6f 726d 616c 6c79 0a20  It is normally. \n-0000bf20: 2020 2020 6e6f 7420 6361 6c6c 6564 2064      not called d\n-0000bf30: 6972 6563 746c 7920 6173 2069 7420 6973  irectly as it is\n-0000bf40: 2063 616c 6c65 6420 6672 6f6d 2027 666b   called from 'fk\n-0000bf50: 6f5f 7370 615f 6461 7461 5f66 696e 616c  o_spa_data_final\n-0000bf60: 272e 0a0a 202d 2d20 4675 6e63 7469 6f6e  '... -- Function\n-0000bf70: 3a20 696e 7420 666b 6f5f 6465 636f 6465  : int fko_decode\n-0000bf80: 5f73 7061 5f64 6174 6120 2866 6b6f 5f63  _spa_data (fko_c\n-0000bf90: 7478 5f74 2043 5458 293b 0a20 2020 2020  tx_t CTX);.     \n-0000bfa0: 5468 6973 2066 756e 6374 696f 6e20 7065  This function pe\n-0000bfb0: 7266 6f72 6d73 2074 6865 2064 6563 6f64  rforms the decod\n-0000bfc0: 696e 672c 2070 6172 7369 6e67 2c20 7661  ing, parsing, va\n-0000bfd0: 6c69 6461 7469 6f6e 206f 6620 7468 6520  lidation of the \n-0000bfe0: 5350 410a 2020 2020 2064 6174 6120 7468  SPA.     data th\n-0000bff0: 6174 2077 6173 206a 7573 7420 6465 6372  at was just decr\n-0000c000: 7970 7465 642e 2020 4974 2069 7320 6e6f  ypted.  It is no\n-0000c010: 726d 616c 6c79 206e 6f74 2063 616c 6c65  rmally not calle\n-0000c020: 6420 6469 7265 6374 6c79 0a20 2020 2020  d directly.     \n-0000c030: 6173 2069 7420 6973 2063 616c 6c65 6420  as it is called \n-0000c040: 6672 6f6d 2027 666b 6f5f 6465 6372 7970  from 'fko_decryp\n-0000c050: 745f 7370 615f 6461 7461 2720 2877 6869  t_spa_data' (whi\n-0000c060: 6368 2069 7320 696e 2074 7572 6e0a 2020  ch is in turn.  \n-0000c070: 2020 2063 616c 6c65 6420 6672 6f6d 2027     called from '\n-0000c080: 666b 6f5f 6e65 775f 7769 7468 5f64 6174  fko_new_with_dat\n-0000c090: 6127 2069 6620 6120 7061 7373 776f 7264  a' if a password\n-0000c0a0: 2069 7320 7375 7070 6c69 6564 2074 6f20   is supplied to \n-0000c0b0: 6974 292e 0a0a 202d 2d20 4675 6e63 7469  it)... -- Functi\n-0000c0c0: 6f6e 3a20 696e 7420 666b 6f5f 656e 636f  on: int fko_enco\n-0000c0d0: 6465 5f73 7061 5f64 6174 6120 2866 6b6f  de_spa_data (fko\n-0000c0e0: 5f63 7478 5f74 2043 5458 293b 0a20 2020  _ctx_t CTX);.   \n-0000c0f0: 2020 5065 7266 6f72 6d73 2074 6865 2062    Performs the b\n-0000c100: 6173 6536 3420 656e 636f 6469 6e67 206f  ase64 encoding o\n-0000c110: 6620 7468 6f73 6520 5350 4120 6461 7461  f those SPA data\n-0000c120: 2066 6965 6c64 7320 7468 6174 206e 6565   fields that nee\n-0000c130: 6420 746f 0a20 2020 2020 6265 2065 6e63  d to.     be enc\n-0000c140: 6f64 6564 2c20 7065 7266 6f72 6d73 2073  oded, performs s\n-0000c150: 6f6d 6520 6461 7461 2076 616c 6964 6174  ome data validat\n-0000c160: 696f 6e2c 2061 6e64 2063 616c 6c73 0a20  ion, and calls. \n-0000c170: 2020 2020 2766 6b70 5f73 6574 5f73 7061      'fkp_set_spa\n-0000c180: 5f64 6967 6573 7427 2074 6f20 7265 636f  _digest' to reco\n-0000c190: 6d70 7574 6520 7468 6520 5350 4120 6d65  mpute the SPA me\n-0000c1a0: 7373 6167 6520 6469 6765 7374 2e20 2049  ssage digest.  I\n-0000c1b0: 7420 6973 0a20 2020 2020 6e6f 726d 616c  t is.     normal\n-0000c1c0: 6c79 206e 6f74 2063 616c 6c65 6420 6469  ly not called di\n-0000c1d0: 7265 6374 6c79 2061 7320 6974 2069 7320  rectly as it is \n-0000c1e0: 6361 6c6c 6564 2066 726f 6d0a 2020 2020  called from.    \n-0000c1f0: 2027 666b 6f5f 656e 6372 7970 745f 7370   'fko_encrypt_sp\n-0000c200: 615f 6461 7461 2720 2877 6869 6368 2069  a_data' (which i\n-0000c210: 7320 696e 2074 7572 6e20 6361 6c6c 6564  s in turn called\n-0000c220: 2066 726f 6d0a 2020 2020 2027 666b 6f5f   from.     'fko_\n-0000c230: 7370 615f 6461 7461 5f66 696e 616c 2729  spa_data_final')\n-0000c240: 2e0a 0a5f 4750 472d 7370 6563 6966 6963  ..._GPG-specific\n-0000c250: 2075 7469 6c69 7479 2066 756e 6374 696f   utility functio\n-0000c260: 6e73 3a5f 0a0a 202d 2d20 4675 6e63 7469  ns:_.. -- Functi\n-0000c270: 6f6e 3a20 696e 7420 666b 6f5f 6770 675f  on: int fko_gpg_\n-0000c280: 7369 676e 6174 7572 655f 6964 5f6d 6174  signature_id_mat\n-0000c290: 6368 2028 666b 6f5f 6374 785f 7420 4354  ch (fko_ctx_t CT\n-0000c2a0: 582c 2063 6f6e 7374 2063 6861 720a 2020  X, const char.  \n-0000c2b0: 2020 2020 2020 2020 2a49 442c 2075 6e73          *ID, uns\n-0000c2c0: 6967 6e65 6420 6368 6172 202a 4944 5f4d  igned char *ID_M\n-0000c2d0: 4154 4348 293b 0a20 2020 2020 5365 7473  ATCH);.     Sets\n-0000c2e0: 2074 6865 2076 616c 7565 206f 6620 7468   the value of th\n-0000c2f0: 6520 4944 5f4d 4154 4348 2076 6172 6961  e ID_MATCH varia\n-0000c300: 626c 6520 746f 2074 7275 6520 2831 2920  ble to true (1) \n-0000c310: 6966 2074 6865 2076 616c 7565 206f 660a  if the value of.\n-0000c320: 2020 2020 2049 4420 6d61 7463 6865 7320       ID matches \n-0000c330: 7468 6520 4944 206f 6620 7468 6520 4750  the ID of the GP\n-0000c340: 4720 7369 676e 6174 7572 6520 6173 736f  G signature asso\n-0000c350: 6369 6174 6564 2077 6974 6820 7468 6520  ciated with the \n-0000c360: 6375 7272 656e 740a 2020 2020 2063 6f6e  current.     con\n-0000c370: 7465 7874 2e20 204f 7468 6572 7769 7365  text.  Otherwise\n-0000c380: 2c20 4944 5f4d 4154 4348 2069 7320 7365  , ID_MATCH is se\n-0000c390: 7420 746f 2066 616c 7365 2028 3029 2e20  t to false (0). \n-0000c3a0: 2054 6865 2072 6574 7572 6e0a 2020 2020   The return.    \n-0000c3b0: 2076 616c 7565 2069 7320 616e 2046 4b4f   value is an FKO\n-0000c3c0: 2065 7272 6f72 2073 7461 7475 732e 0a0a   error status...\n-0000c3d0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in\n-0000c3e0: 7420 666b 6f5f 6770 675f 7369 676e 6174  t fko_gpg_signat\n-0000c3f0: 7572 655f 6670 725f 6d61 7463 6820 2866  ure_fpr_match (f\n-0000c400: 6b6f 5f63 7478 5f74 2043 5458 2c20 636f  ko_ctx_t CTX, co\n-0000c410: 6e73 7420 6368 6172 0a20 2020 2020 2020  nst char.       \n-0000c420: 2020 202a 4650 522c 2075 6e73 6967 6e65     *FPR, unsigne\n-0000c430: 6420 6368 6172 202a 4650 525f 4d41 5443  d char *FPR_MATC\n-0000c440: 4829 3b0a 2020 2020 2053 6574 7320 7468  H);.     Sets th\n-0000c450: 6520 7661 6c75 6520 6f66 2074 6865 2046  e value of the F\n-0000c460: 5052 5f4d 4154 4348 2076 6172 6961 626c  PR_MATCH variabl\n-0000c470: 6520 746f 2074 7275 6520 2831 2920 6966  e to true (1) if\n-0000c480: 2074 6865 2076 616c 7565 0a20 2020 2020   the value.     \n-0000c490: 6f66 2046 5052 206d 6174 6368 6573 2074  of FPR matches t\n-0000c4a0: 6865 2066 696e 6765 7270 7269 6e74 206f  he fingerprint o\n-0000c4b0: 6620 7468 6520 4750 4720 7369 676e 6174  f the GPG signat\n-0000c4c0: 7572 6520 6173 736f 6369 6174 6564 2077  ure associated w\n-0000c4d0: 6974 680a 2020 2020 2074 6865 2063 7572  ith.     the cur\n-0000c4e0: 7265 6e74 2063 6f6e 7465 7874 2e20 204f  rent context.  O\n-0000c4f0: 7468 6572 7769 7365 2c20 4650 525f 4d41  therwise, FPR_MA\n-0000c500: 5443 4820 6973 2073 6574 2074 6f20 6661  TCH is set to fa\n-0000c510: 6c73 6520 2830 292e 0a20 2020 2020 5468  lse (0)..     Th\n-0000c520: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i\n-0000c530: 7320 616e 2046 4b4f 2065 7272 6f72 2073  s an FKO error s\n-0000c540: 7461 7475 732e 0a0a 1f0a 4669 6c65 3a20  tatus.....File: \n-0000c550: 6c69 6266 6b6f 2e69 6e66 6f2c 2020 4e6f  libfko.info,  No\n-0000c560: 6465 3a20 4572 726f 7220 4861 6e64 6c69  de: Error Handli\n-0000c570: 6e67 2c20 2050 7265 763a 2055 7469 6c69  ng,  Prev: Utili\n-0000c580: 7479 2046 756e 6374 696f 6e73 2c20 2055  ty Functions,  U\n-0000c590: 703a 2055 7369 6e67 206c 6962 666b 6f0a  p: Using libfko.\n-0000c5a0: 0a33 2e37 2045 7272 6f72 2048 616e 646c  .3.7 Error Handl\n-0000c5b0: 696e 670a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ing.============\n-0000c5c0: 3d3d 3d3d 3d3d 0a0a 4d6f 7374 2066 6b6f  ======..Most fko\n-0000c5d0: 2066 756e 6374 696f 6e73 2072 6574 7572   functions retur\n-0000c5e0: 6e20 616e 2069 6e74 6567 6572 2076 616c  n an integer val\n-0000c5f0: 7565 2074 6861 7420 636f 7272 6573 706f  ue that correspo\n-0000c600: 6e64 7320 746f 2065 6974 6865 720a 7375  nds to either.su\n-0000c610: 6363 6573 7320 2830 292c 206f 7220 6f6e  ccess (0), or on\n-0000c620: 6520 6f66 2074 6865 206e 6f6e 2d7a 6572  e of the non-zer\n-0000c630: 6f20 7661 6c75 6573 2074 6861 7220 636f  o values thar co\n-0000c640: 7272 6573 706f 6e64 7320 746f 2061 206e  rresponds to a n\n-0000c650: 756d 6265 720a 6f66 2070 6f73 7369 626c  umber.of possibl\n-0000c660: 6520 6572 726f 7273 2e20 206c 6962 666b  e errors.  libfk\n-0000c670: 6f20 7072 6f76 6964 6573 2061 2066 756e  o provides a fun\n-0000c680: 6374 696f 6e20 746f 2067 6574 2061 2064  ction to get a d\n-0000c690: 6573 6372 6970 7469 7665 0a73 7472 696e  escriptive.strin\n-0000c6a0: 6720 666f 7220 7468 6520 6769 7665 6e20  g for the given \n-0000c6b0: 6572 726f 7220 636f 6465 2e0a 0a20 2d2d  error code... --\n-0000c6c0: 2046 756e 6374 696f 6e3a 2063 6f6e 7374   Function: const\n-0000c6d0: 2063 6861 7220 2a20 666b 6f5f 6572 7273   char * fko_errs\n-0000c6e0: 7472 2028 696e 7420 4552 525f 434f 4445  tr (int ERR_CODE\n-0000c6f0: 290a 2020 2020 2054 6865 2066 756e 6374  ).     The funct\n-0000c700: 696f 6e20 2766 6b6f 5f65 7272 7374 7227  ion 'fko_errstr'\n-0000c710: 2072 6574 7572 6e73 2061 2070 6f69 6e74   returns a point\n-0000c720: 6572 2074 6f20 6120 7374 6174 6963 616c  er to a statical\n-0000c730: 6c79 0a20 2020 2020 616c 6c6f 6361 7465  ly.     allocate\n-0000c740: 6420 7374 7269 6e67 2063 6f6e 7461 696e  d string contain\n-0000c750: 696e 6720 7468 6520 6465 7363 7269 7074  ing the descript\n-0000c760: 696f 6e20 6f66 2074 6865 2065 7272 6f72  ion of the error\n-0000c770: 2e0a 0a54 6865 206c 6973 7420 6f66 2074  ...The list of t\n-0000c780: 6865 2070 6f73 7369 626c 6520 6572 726f  he possible erro\n-0000c790: 7220 636f 6465 7320 616e 6420 7468 6569  r codes and thei\n-0000c7a0: 7220 636f 7272 6573 706f 6e64 696e 670a  r corresponding.\n-0000c7b0: 6465 7363 7269 7074 696f 6e73 2061 7320  descriptions as \n-0000c7c0: 7265 7475 726e 6564 2062 7920 2766 6b6f  returned by 'fko\n-0000c7d0: 5f65 7272 7374 7227 2066 6f6c 6c6f 7773  _errstr' follows\n-0000c7e0: 3a0a 0a20 2d2d 2056 6172 6961 626c 653a  :.. -- Variable:\n-0000c7f0: 2069 6e74 2065 7272 6f72 5f63 6f64 650a   int error_code.\n-0000c800: 2020 2020 2027 464b 4f5f 5355 4343 4553       'FKO_SUCCES\n-0000c810: 5327 0a20 2020 2020 2020 2020 2053 7563  S'.          Suc\n-0000c820: 6365 7373 0a20 2020 2020 2746 4b4f 5f45  cess.     'FKO_E\n-0000c830: 5252 4f52 5f43 5458 5f4e 4f54 5f49 4e49  RROR_CTX_NOT_INI\n-0000c840: 5449 414c 495a 4544 270a 2020 2020 2020  TIALIZED'.      \n-0000c850: 2020 2020 464b 4f20 436f 6e74 6578 7420      FKO Context \n-0000c860: 6973 206e 6f74 2069 6e69 7469 616c 697a  is not initializ\n-0000c870: 6564 0a20 2020 2020 2746 4b4f 5f45 5252  ed.     'FKO_ERR\n-0000c880: 4f52 5f4d 454d 4f52 595f 414c 4c4f 4341  OR_MEMORY_ALLOCA\n-0000c890: 5449 4f4e 270a 2020 2020 2020 2020 2020  TION'.          \n-0000c8a0: 556e 6162 6c65 2074 6f20 616c 6c6f 6361  Unable to alloca\n-0000c8b0: 7465 206d 656d 6f72 790a 2020 2020 2027  te memory.     '\n-0000c8c0: 464b 4f5f 4552 524f 525f 4649 4c45 5359  FKO_ERROR_FILESY\n-0000c8d0: 5354 454d 5f4f 5045 5241 5449 4f4e 270a  STEM_OPERATION'.\n-0000c8e0: 2020 2020 2020 2020 2020 5265 6164 2f77            Read/w\n-0000c8f0: 7269 7465 2062 7974 6573 206d 6973 6d61  rite bytes misma\n-0000c900: 7463 680a 2020 2020 2027 464b 4f5f 4552  tch.     'FKO_ER\n-0000c910: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n-0000c920: 270a 2020 2020 2020 2020 2020 4172 6773  '.          Args\n-0000c930: 2063 6f6e 7461 696e 2069 6e76 616c 6964   contain invalid\n-0000c940: 2064 6174 610a 2020 2020 2027 464b 4f5f   data.     'FKO_\n-0000c950: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n-0000c960: 5441 5f43 4c49 454e 545f 5449 4d45 4f55  TA_CLIENT_TIMEOU\n-0000c970: 545f 4e45 4741 5449 5645 270a 2020 2020  T_NEGATIVE'.    \n-0000c980: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n-0000c990: 7461 3a20 6e65 6761 7469 7665 2074 696d  ta: negative tim\n-0000c9a0: 656f 7574 2076 616c 7565 0a20 2020 2020  eout value.     \n-0000c9b0: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n-0000c9c0: 4944 5f44 4154 415f 4445 434f 4445 5f4d  ID_DATA_DECODE_M\n-0000c9d0: 5347 4c45 4e5f 5641 4c49 4446 4149 4c27  SGLEN_VALIDFAIL'\n-0000c9e0: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n-0000c9f0: 6964 2064 6174 613a 2069 6e76 616c 6964  id data: invalid\n-0000ca00: 206d 6573 7361 6765 206c 656e 6774 680a   message length.\n-0000ca10: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000ca20: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC\n-0000ca30: 4f44 455f 4e4f 4e5f 4153 4349 4927 0a20  ODE_NON_ASCII'. \n-0000ca40: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n-0000ca50: 2064 6174 613a 2063 6f6e 7461 696e 7320   data: contains \n-0000ca60: 6e6f 6e2d 6173 6369 6920 6368 6172 6163  non-ascii charac\n-0000ca70: 7465 7273 0a20 2020 2020 2746 4b4f 5f45  ters.     'FKO_E\n-0000ca80: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n-0000ca90: 415f 4445 434f 4445 5f4c 545f 4d49 4e5f  A_DECODE_LT_MIN_\n-0000caa0: 4649 454c 4453 270a 2020 2020 2020 2020  FIELDS'.        \n-0000cab0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n-0000cac0: 696e 7375 6666 6963 6965 6e74 206e 756d  insufficient num\n-0000cad0: 6265 7220 6f66 2064 6174 6120 6669 656c  ber of data fiel\n-0000cae0: 6473 0a20 2020 2020 2746 4b4f 5f45 5252  ds.     'FKO_ERR\n-0000caf0: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_\n-0000cb00: 4445 434f 4445 5f47 545f 4d41 585f 4649  DECODE_GT_MAX_FI\n-0000cb10: 454c 4453 270a 2020 2020 2020 2020 2020  ELDS'.          \n-0000cb20: 496e 7661 6c69 6420 6461 7461 3a20 746f  Invalid data: to\n-0000cb30: 6f20 6d61 6e79 2064 6174 6120 6669 656c  o many data fiel\n-0000cb40: 6473 0a20 2020 2020 2746 4b4f 5f45 5252  ds.     'FKO_ERR\n-0000cb50: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_\n-0000cb60: 4445 434f 4445 5f57 524f 4e47 5f4e 554d  DECODE_WRONG_NUM\n-0000cb70: 5f46 4945 4c44 5327 0a20 2020 2020 2020  _FIELDS'.       \n-0000cb80: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:\n-0000cb90: 2069 6e76 616c 6964 206e 756d 6265 7220   invalid number \n-0000cba0: 6f66 2066 6965 6c64 730a 2020 2020 2027  of fields.     '\n-0000cbb0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n-0000cbc0: 445f 4441 5441 5f44 4543 4f44 455f 454e  D_DATA_DECODE_EN\n-0000cbd0: 435f 4d53 475f 4c45 4e5f 4d54 5f54 5f53  C_MSG_LEN_MT_T_S\n-0000cbe0: 495a 4527 0a20 2020 2020 2020 2020 2049  IZE'.          I\n-0000cbf0: 6e76 616c 6964 2064 6174 613a 2064 6563  nvalid data: dec\n-0000cc00: 6f64 653a 2065 6e63 6f64 6564 206d 6573  ode: encoded mes\n-0000cc10: 7361 6765 202d 2064 6967 6573 7420 7369  sage - digest si\n-0000cc20: 7a65 2069 7320 6e6f 740a 2020 2020 2020  ze is not.      \n-0000cc30: 2020 2020 7661 6c69 640a 2020 2020 2027      valid.     '\n-0000cc40: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n-0000cc50: 445f 4441 5441 5f44 4543 4f44 455f 5241  D_DATA_DECODE_RA\n-0000cc60: 4e44 5f4d 4953 5349 4e47 270a 2020 2020  ND_MISSING'.    \n-0000cc70: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n-0000cc80: 7461 3a20 6465 636f 6465 3a20 6d69 7373  ta: decode: miss\n-0000cc90: 696e 6720 7261 6e64 6f6d 2064 6174 610a  ing random data.\n-0000cca0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000ccb0: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC\n-0000ccc0: 4f44 455f 5553 4552 4e41 4d45 5f4d 4953  ODE_USERNAME_MIS\n-0000ccd0: 5349 4e47 270a 2020 2020 2020 2020 2020  SING'.          \n-0000cce0: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de\n-0000ccf0: 636f 6465 3a20 6d69 7373 696e 6720 7573  code: missing us\n-0000cd00: 6572 6e61 6d65 0a20 2020 2020 2746 4b4f  ername.     'FKO\n-0000cd10: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n-0000cd20: 4154 415f 4445 434f 4445 5f55 5345 524e  ATA_DECODE_USERN\n-0000cd30: 414d 455f 544f 4f42 4947 270a 2020 2020  AME_TOOBIG'.    \n-0000cd40: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n-0000cd50: 7461 3a20 6465 636f 6465 3a20 7573 6572  ta: decode: user\n-0000cd60: 6e61 6d65 2074 6f20 6c61 7267 650a 2020  name to large.  \n-0000cd70: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n-0000cd80: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD\n-0000cd90: 455f 5553 4552 4e41 4d45 5f44 4543 4f44  E_USERNAME_DECOD\n-0000cda0: 4546 4149 4c27 0a20 2020 2020 2020 2020  EFAIL'.         \n-0000cdb0: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d\n-0000cdc0: 6563 6f64 653a 2066 6169 6c65 6420 746f  ecode: failed to\n-0000cdd0: 2064 6563 6f64 6520 7573 6572 6e61 6d65   decode username\n-0000cde0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-0000cdf0: 5f49 4e56 414c 4944 5f44 4154 415f 4445  _INVALID_DATA_DE\n-0000ce00: 434f 4445 5f55 5345 524e 414d 455f 5641  CODE_USERNAME_VA\n-0000ce10: 4c49 4446 4149 4c27 0a20 2020 2020 2020  LIDFAIL'.       \n-0000ce20: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:\n-0000ce30: 2064 6563 6f64 653a 2069 6e76 616c 6964   decode: invalid\n-0000ce40: 2075 7365 726e 616d 650a 2020 2020 2027   username.     '\n-0000ce50: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n-0000ce60: 445f 4441 5441 5f44 4543 4f44 455f 5449  D_DATA_DECODE_TI\n-0000ce70: 4d45 5354 414d 505f 4d49 5353 494e 4727  MESTAMP_MISSING'\n-0000ce80: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n-0000ce90: 6964 2064 6174 613a 2064 6563 6f64 653a  id data: decode:\n-0000cea0: 206d 6973 7369 6e67 2074 696d 6573 7461   missing timesta\n-0000ceb0: 6d70 0a20 2020 2020 2746 4b4f 5f45 5252  mp.     'FKO_ERR\n-0000cec0: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_\n-0000ced0: 4445 434f 4445 5f54 494d 4553 5441 4d50  DECODE_TIMESTAMP\n-0000cee0: 5f54 4f4f 4249 4727 0a20 2020 2020 2020  _TOOBIG'.       \n-0000cef0: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:\n-0000cf00: 2064 6563 6f64 653a 2074 696d 6573 7461   decode: timesta\n-0000cf10: 6d70 2074 6f6f 206c 6172 6765 0a20 2020  mp too large.   \n-0000cf20: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n-0000cf30: 414c 4944 5f44 4154 415f 4445 434f 4445  ALID_DATA_DECODE\n-0000cf40: 5f54 494d 4553 5441 4d50 5f44 4543 4f44  _TIMESTAMP_DECOD\n-0000cf50: 4546 4149 4c27 0a20 2020 2020 2020 2020  EFAIL'.         \n-0000cf60: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d\n-0000cf70: 6563 6f64 653a 2066 6169 6c65 6420 746f  ecode: failed to\n-0000cf80: 2064 6563 6f64 6520 7469 6d65 7374 616d   decode timestam\n-0000cf90: 700a 2020 2020 2027 464b 4f5f 4552 524f  p.     'FKO_ERRO\n-0000cfa0: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D\n-0000cfb0: 4543 4f44 455f 5645 5253 494f 4e5f 4d49  ECODE_VERSION_MI\n-0000cfc0: 5353 494e 4727 0a20 2020 2020 2020 2020  SSING'.         \n-0000cfd0: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d\n-0000cfe0: 6563 6f64 653a 206d 6973 7369 6e67 2076  ecode: missing v\n-0000cff0: 6572 7369 6f6e 2064 6174 610a 2020 2020  ersion data.    \n-0000d000: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n-0000d010: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_\n-0000d020: 5645 5253 494f 4e5f 544f 4f42 4947 270a  VERSION_TOOBIG'.\n-0000d030: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n-0000d040: 6420 6461 7461 3a20 6465 636f 6465 3a20  d data: decode: \n-0000d050: 7665 7273 696f 6e20 6461 7461 2069 7320  version data is \n-0000d060: 746f 6f20 6c61 7267 650a 2020 2020 2027  too large.     '\n-0000d070: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n-0000d080: 445f 4441 5441 5f44 4543 4f44 455f 4d53  D_DATA_DECODE_MS\n-0000d090: 4754 5950 455f 4d49 5353 494e 4727 0a20  GTYPE_MISSING'. \n-0000d0a0: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n-0000d0b0: 2064 6174 613a 2064 6563 6f64 653a 206d   data: decode: m\n-0000d0c0: 6973 7369 6e67 206d 6573 7361 6765 2074  issing message t\n-0000d0d0: 7970 650a 2020 2020 2027 464b 4f5f 4552  ype.     'FKO_ER\n-0000d0e0: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n-0000d0f0: 5f44 4543 4f44 455f 4d53 4754 5950 455f  _DECODE_MSGTYPE_\n-0000d100: 544f 4f42 4947 270a 2020 2020 2020 2020  TOOBIG'.        \n-0000d110: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n-0000d120: 6465 636f 6465 3a20 6d65 7373 6167 6520  decode: message \n-0000d130: 7479 7065 2069 7320 746f 6f20 6c61 7267  type is too larg\n-0000d140: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO\n-0000d150: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D\n-0000d160: 4543 4f44 455f 4d53 4754 5950 455f 4445  ECODE_MSGTYPE_DE\n-0000d170: 434f 4445 4641 494c 270a 2020 2020 2020  CODEFAIL'.      \n-0000d180: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n-0000d190: 3a20 6465 636f 6465 3a20 6661 696c 6564  : decode: failed\n-0000d1a0: 2074 6f20 6465 636f 6465 206d 6573 7361   to decode messa\n-0000d1b0: 6765 2074 7970 650a 2020 2020 2027 464b  ge type.     'FK\n-0000d1c0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n-0000d1d0: 4441 5441 5f44 4543 4f44 455f 4d45 5353  DATA_DECODE_MESS\n-0000d1e0: 4147 455f 4d49 5353 494e 4727 0a20 2020  AGE_MISSING'.   \n-0000d1f0: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d\n-0000d200: 6174 613a 2064 6563 6f64 653a 206d 6973  ata: decode: mis\n-0000d210: 7369 6e67 206d 6573 7361 6765 2064 6174  sing message dat\n-0000d220: 610a 2020 2020 2027 464b 4f5f 4552 524f  a.     'FKO_ERRO\n-0000d230: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D\n-0000d240: 4543 4f44 455f 4d45 5353 4147 455f 544f  ECODE_MESSAGE_TO\n-0000d250: 4f42 4947 270a 2020 2020 2020 2020 2020  OBIG'.          \n-0000d260: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de\n-0000d270: 636f 6465 3a20 6d65 7373 6167 6520 6461  code: message da\n-0000d280: 7461 2069 7320 746f 6f20 6c61 7267 650a  ta is too large.\n-0000d290: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000d2a0: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC\n-0000d2b0: 4f44 455f 4d45 5353 4147 455f 4445 434f  ODE_MESSAGE_DECO\n-0000d2c0: 4445 4641 494c 270a 2020 2020 2020 2020  DEFAIL'.        \n-0000d2d0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n-0000d2e0: 6465 636f 6465 3a20 6661 696c 6564 2074  decode: failed t\n-0000d2f0: 6f20 6465 636f 6465 206d 6573 7361 6765  o decode message\n-0000d300: 2064 6174 610a 2020 2020 2027 464b 4f5f   data.     'FKO_\n-0000d310: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n-0000d320: 5441 5f44 4543 4f44 455f 4d45 5353 4147  TA_DECODE_MESSAG\n-0000d330: 455f 5641 4c49 4446 4149 4c27 0a20 2020  E_VALIDFAIL'.   \n-0000d340: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d\n-0000d350: 6174 613a 2064 6563 6f64 653a 2069 6e76  ata: decode: inv\n-0000d360: 616c 6964 206d 6573 7361 6765 2064 6174  alid message dat\n-0000d370: 610a 2020 2020 2027 464b 4f5f 4552 524f  a.     'FKO_ERRO\n-0000d380: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D\n-0000d390: 4543 4f44 455f 4143 4345 5353 5f56 414c  ECODE_ACCESS_VAL\n-0000d3a0: 4944 4641 494c 270a 2020 2020 2020 2020  IDFAIL'.        \n-0000d3b0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n-0000d3c0: 6465 636f 6465 3a20 696e 766c 6961 6420  decode: invliad \n-0000d3d0: 6163 6365 7373 2064 6174 610a 2020 2020  access data.    \n-0000d3e0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n-0000d3f0: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_\n-0000d400: 4e41 5441 4343 4553 535f 4d49 5353 494e  NATACCESS_MISSIN\n-0000d410: 4727 0a20 2020 2020 2020 2020 2049 6e76  G'.          Inv\n-0000d420: 616c 6964 2064 6174 613a 2064 6563 6f64  alid data: decod\n-0000d430: 653a 206d 6973 7369 6e67 204e 4154 2061  e: missing NAT a\n-0000d440: 6363 6573 7320 6461 7461 0a20 2020 2020  ccess data.     \n-0000d450: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n-0000d460: 4944 5f44 4154 415f 4445 434f 4445 5f4e  ID_DATA_DECODE_N\n-0000d470: 4154 4143 4345 5353 5f54 4f4f 4249 4727  ATACCESS_TOOBIG'\n-0000d480: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n-0000d490: 6964 2064 6174 613a 2064 6563 6f64 653a  id data: decode:\n-0000d4a0: 204e 4154 2061 6363 6573 7320 6461 7461   NAT access data\n-0000d4b0: 2069 7320 746f 6f20 6c61 7267 650a 2020   is too large.  \n-0000d4c0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n-0000d4d0: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD\n-0000d4e0: 455f 4e41 5441 4343 4553 535f 4445 434f  E_NATACCESS_DECO\n-0000d4f0: 4445 4641 494c 270a 2020 2020 2020 2020  DEFAIL'.        \n-0000d500: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n-0000d510: 6465 636f 6465 3a20 6661 696c 6564 2074  decode: failed t\n-0000d520: 6f20 6465 636f 6465 204e 4154 2061 6363  o decode NAT acc\n-0000d530: 6573 7320 6461 7461 0a20 2020 2020 2746  ess data.     'F\n-0000d540: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n-0000d550: 5f44 4154 415f 4445 434f 4445 5f4e 4154  _DATA_DECODE_NAT\n-0000d560: 4143 4345 5353 5f56 414c 4944 4641 494c  ACCESS_VALIDFAIL\n-0000d570: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva\n-0000d580: 6c69 6420 6461 7461 3a20 6465 636f 6465  lid data: decode\n-0000d590: 3a20 696e 7661 6c69 6420 4e41 5420 6163  : invalid NAT ac\n-0000d5a0: 6365 7373 0a20 2020 2020 2746 4b4f 5f45  cess.     'FKO_E\n-0000d5b0: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n-0000d5c0: 415f 4445 434f 4445 5f53 5256 4155 5448  A_DECODE_SRVAUTH\n-0000d5d0: 5f4d 4953 5349 4e47 270a 2020 2020 2020  _MISSING'.      \n-0000d5e0: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n-0000d5f0: 3a20 6465 636f 6465 3a20 6d69 7373 696e  : decode: missin\n-0000d600: 6720 7365 7276 6572 2061 7574 680a 2020  g server auth.  \n-0000d610: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n-0000d620: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD\n-0000d630: 455f 5352 5641 5554 485f 4445 434f 4445  E_SRVAUTH_DECODE\n-0000d640: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          \n-0000d650: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de\n-0000d660: 636f 6465 3a20 7365 7276 6572 2061 7574  code: server aut\n-0000d670: 6820 6465 636f 6465 2066 6169 6c0a 2020  h decode fail.  \n-0000d680: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n-0000d690: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD\n-0000d6a0: 455f 5350 415f 4558 5452 415f 544f 4f42  E_SPA_EXTRA_TOOB\n-0000d6b0: 4947 270a 2020 2020 2020 2020 2020 496e  IG'.          In\n-0000d6c0: 7661 6c69 6420 6461 7461 3a20 6465 636f  valid data: deco\n-0000d6d0: 6465 3a20 5350 4120 6578 7472 6120 746f  de: SPA extra to\n-0000d6e0: 6f20 6c61 7267 650a 2020 2020 2027 464b  o large.     'FK\n-0000d6f0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n-0000d700: 4441 5441 5f44 4543 4f44 455f 4558 5452  DATA_DECODE_EXTR\n-0000d710: 415f 544f 4f42 4947 270a 2020 2020 2020  A_TOOBIG'.      \n-0000d720: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n-0000d730: 3a20 6465 636f 6465 3a20 6578 7472 6120  : decode: extra \n-0000d740: 746f 6f20 6c61 7267 650a 2020 2020 2027  too large.     '\n-0000d750: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n-0000d760: 445f 4441 5441 5f44 4543 4f44 455f 4558  D_DATA_DECODE_EX\n-0000d770: 5452 415f 4445 434f 4445 4641 494c 270a  TRA_DECODEFAIL'.\n-0000d780: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n-0000d790: 6420 6461 7461 3a20 6465 636f 6465 3a20  d data: decode: \n-0000d7a0: 6578 7472 6120 6465 636f 6465 2066 6169  extra decode fai\n-0000d7b0: 6c65 640a 2020 2020 2027 464b 4f5f 4552  led.     'FKO_ER\n-0000d7c0: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n-0000d7d0: 5f44 4543 4f44 455f 5449 4d45 4f55 545f  _DECODE_TIMEOUT_\n-0000d7e0: 4d49 5353 494e 4727 0a20 2020 2020 2020  MISSING'.       \n-0000d7f0: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:\n-0000d800: 2064 6563 6f64 653a 206d 6973 7369 6e67   decode: missing\n-0000d810: 2074 696d 656f 7574 0a20 2020 2020 2746   timeout.     'F\n-0000d820: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n-0000d830: 5f44 4154 415f 4445 434f 4445 5f54 494d  _DATA_DECODE_TIM\n-0000d840: 454f 5554 5f54 4f4f 4249 4727 0a20 2020  EOUT_TOOBIG'.   \n-0000d850: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d\n-0000d860: 6174 613a 2064 6563 6f64 6520 7469 6d65  ata: decode time\n-0000d870: 6f75 7420 7661 6c75 6520 6973 2074 6f6f  out value is too\n-0000d880: 206c 6172 6765 0a20 2020 2020 2746 4b4f   large.     'FKO\n-0000d890: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n-0000d8a0: 4154 415f 4445 434f 4445 5f54 494d 454f  ATA_DECODE_TIMEO\n-0000d8b0: 5554 5f56 414c 4944 4641 494c 270a 2020  UT_VALIDFAIL'.  \n-0000d8c0: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n-0000d8d0: 6461 7461 3a20 6465 636f 6465 2069 6e76  data: decode inv\n-0000d8e0: 616c 6964 2074 696d 656f 7574 0a20 2020  alid timeout.   \n-0000d8f0: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n-0000d900: 414c 4944 5f44 4154 415f 4445 434f 4445  ALID_DATA_DECODE\n-0000d910: 5f54 494d 454f 5554 5f44 4543 4f44 4546  _TIMEOUT_DECODEF\n-0000d920: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I\n-0000d930: 6e76 616c 6964 2064 6174 613a 2064 6563  nvalid data: dec\n-0000d940: 6f64 653a 2074 696d 656f 7574 2064 6563  ode: timeout dec\n-0000d950: 6f64 6520 6661 696c 6564 0a20 2020 2020  ode failed.     \n-0000d960: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n-0000d970: 4944 5f44 4154 415f 454e 434f 4445 5f4d  ID_DATA_ENCODE_M\n-0000d980: 4553 5341 4745 5f54 4f4f 4249 4727 0a20  ESSAGE_TOOBIG'. \n-0000d990: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n-0000d9a0: 2064 6174 613a 2065 6e63 6f64 653a 206d   data: encode: m\n-0000d9b0: 6573 7361 6765 2069 7320 746f 6f20 6c61  essage is too la\n-0000d9c0: 7267 650a 2020 2020 2027 464b 4f5f 4552  rge.     'FKO_ER\n-0000d9d0: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n-0000d9e0: 5f45 4e43 4f44 455f 4d53 474c 454e 5f56  _ENCODE_MSGLEN_V\n-0000d9f0: 414c 4944 4641 494c 270a 2020 2020 2020  ALIDFAIL'.      \n-0000da00: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n-0000da10: 3a20 656e 636f 6465 3a20 696e 7661 6c69  : encode: invali\n-0000da20: 6420 6d65 7373 6167 6520 6c65 6e67 7468  d message length\n-0000da30: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-0000da40: 5f49 4e56 414c 4944 5f44 4154 415f 454e  _INVALID_DATA_EN\n-0000da50: 434f 4445 5f44 4947 4553 545f 5641 4c49  CODE_DIGEST_VALI\n-0000da60: 4446 4149 4c27 0a20 2020 2020 2020 2020  DFAIL'.         \n-0000da70: 2049 6e76 616c 6964 2064 6174 613a 2065   Invalid data: e\n-0000da80: 6e63 6f64 653a 2069 6e76 616c 6964 2064  ncode: invalid d\n-0000da90: 6967 6573 740a 2020 2020 2027 464b 4f5f  igest.     'FKO_\n-0000daa0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n-0000dab0: 5441 5f45 4e43 4f44 455f 4449 4745 5354  TA_ENCODE_DIGEST\n-0000dac0: 5f54 4f4f 4249 4727 0a20 2020 2020 2020  _TOOBIG'.       \n-0000dad0: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:\n-0000dae0: 2065 6e63 6f64 653a 2064 6967 6573 7420   encode: digest \n-0000daf0: 6973 2074 6f6f 206c 6172 6765 0a20 2020  is too large.   \n-0000db00: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n-0000db10: 414c 4944 5f44 4154 415f 454e 434f 4445  ALID_DATA_ENCODE\n-0000db20: 5f4e 4f54 4241 5345 3634 270a 2020 2020  _NOTBASE64'.    \n-0000db30: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n-0000db40: 7461 3a20 656e 636f 6465 6420 6461 7461  ta: encoded data\n-0000db50: 2069 7320 6e6f 7420 4261 7365 3634 0a20   is not Base64. \n-0000db60: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n-0000db70: 4e56 414c 4944 5f44 4154 415f 454e 4352  NVALID_DATA_ENCR\n-0000db80: 5950 545f 4d53 474c 454e 5f56 414c 4944  YPT_MSGLEN_VALID\n-0000db90: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          \n-0000dba0: 496e 7661 6c69 6420 6461 7461 3a20 656e  Invalid data: en\n-0000dbb0: 6372 7970 743a 2069 6e76 616c 6964 206d  crypt: invalid m\n-0000dbc0: 6573 7361 6765 206c 656e 6774 680a 2020  essage length.  \n-0000dbd0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n-0000dbe0: 5641 4c49 445f 4441 5441 5f45 4e43 5259  VALID_DATA_ENCRY\n-0000dbf0: 5054 5f44 4947 4553 544c 454e 5f56 414c  PT_DIGESTLEN_VAL\n-0000dc00: 4944 4641 494c 270a 2020 2020 2020 2020  IDFAIL'.        \n-0000dc10: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n-0000dc20: 656e 6372 7970 743a 2069 6e76 616c 6964  encrypt: invalid\n-0000dc30: 2064 6967 6573 7420 6c65 6e67 7468 0a20   digest length. \n-0000dc40: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n-0000dc50: 4e56 414c 4944 5f44 4154 415f 454e 4352  NVALID_DATA_ENCR\n-0000dc60: 5950 545f 5054 4c45 4e5f 5641 4c49 4446  YPT_PTLEN_VALIDF\n-0000dc70: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I\n-0000dc80: 6e76 616c 6964 2064 6174 613a 2065 6e63  nvalid data: enc\n-0000dc90: 7279 7074 3a20 696e 7661 6c69 6420 706c  rypt: invalid pl\n-0000dca0: 6169 6e74 6578 7420 6c65 6e67 7468 0a20  aintext length. \n-0000dcb0: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n-0000dcc0: 4e56 414c 4944 5f44 4154 415f 454e 4352  NVALID_DATA_ENCR\n-0000dcd0: 5950 545f 5245 5355 4c54 5f4d 5347 4c45  YPT_RESULT_MSGLE\n-0000dce0: 4e5f 5641 4c49 4446 4149 4c27 0a20 2020  N_VALIDFAIL'.   \n-0000dcf0: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d\n-0000dd00: 6174 613a 2065 6e63 7279 7074 3a20 696e  ata: encrypt: in\n-0000dd10: 7661 6c69 6420 656e 6372 7970 7420 7265  valid encrypt re\n-0000dd20: 7375 6c74 206d 6573 7361 6765 206c 656e  sult message len\n-0000dd30: 6774 680a 2020 2020 2027 464b 4f5f 4552  gth.     'FKO_ER\n-0000dd40: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n-0000dd50: 5f45 4e43 5259 5054 5f43 4950 4845 524c  _ENCRYPT_CIPHERL\n-0000dd60: 454e 5f44 4543 4f44 4546 4149 4c27 0a20  EN_DECODEFAIL'. \n-0000dd70: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n-0000dd80: 2064 6174 613a 2065 6e63 7279 7074 3a20   data: encrypt: \n-0000dd90: 6465 636f 6465 2063 6970 6865 7220 6c65  decode cipher le\n-0000dda0: 6e67 7468 2066 6169 6c65 640a 2020 2020  ngth failed.    \n-0000ddb0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n-0000ddc0: 4c49 445f 4441 5441 5f45 4e43 5259 5054  LID_DATA_ENCRYPT\n-0000ddd0: 5f43 4950 4845 524c 454e 5f56 414c 4944  _CIPHERLEN_VALID\n-0000dde0: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          \n-0000ddf0: 496e 7661 6c69 6420 6461 7461 3a20 656e  Invalid data: en\n-0000de00: 6372 7970 743a 2069 6e76 616c 6964 2063  crypt: invalid c\n-0000de10: 6970 6865 7220 6c65 6e67 7468 0a20 2020  ipher length.   \n-0000de20: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n-0000de30: 414c 4944 5f44 4154 415f 454e 4352 5950  ALID_DATA_ENCRYP\n-0000de40: 545f 4445 4352 5950 5445 445f 4d45 5353  T_DECRYPTED_MESS\n-0000de50: 4147 455f 4d49 5353 494e 4727 0a20 2020  AGE_MISSING'.   \n-0000de60: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d\n-0000de70: 6174 613a 2065 6e63 7279 7074 3a20 6d69  ata: encrypt: mi\n-0000de80: 7373 696e 6720 6465 6372 7970 7465 6420  ssing decrypted \n-0000de90: 6d65 7373 6167 650a 2020 2020 2027 464b  message.     'FK\n-0000dea0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n-0000deb0: 4441 5441 5f45 4e43 5259 5054 5f44 4543  DATA_ENCRYPT_DEC\n-0000dec0: 5259 5054 4544 5f4d 5347 4c45 4e5f 5641  RYPTED_MSGLEN_VA\n-0000ded0: 4c49 4446 4149 4c27 0a20 2020 2020 2020  LIDFAIL'.       \n-0000dee0: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:\n-0000def0: 2065 6e63 7279 7074 3a20 696e 7661 6c69   encrypt: invali\n-0000df00: 6420 6465 6372 7970 7465 6420 6d65 7373  d decrypted mess\n-0000df10: 6167 6520 6c65 6e67 7468 0a20 2020 2020  age length.     \n-0000df20: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n-0000df30: 4944 5f44 4154 415f 454e 4352 5950 545f  ID_DATA_ENCRYPT_\n-0000df40: 5459 5045 5f56 414c 4944 4641 494c 270a  TYPE_VALIDFAIL'.\n-0000df50: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n-0000df60: 6420 6461 7461 3a20 656e 6372 7970 743a  d data: encrypt:\n-0000df70: 2069 6e76 616c 6964 2065 6e63 7279 7074   invalid encrypt\n-0000df80: 696f 6e20 7479 7065 0a20 2020 2020 2746  ion type.     'F\n-0000df90: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n-0000dfa0: 5f44 4154 415f 454e 4352 5950 545f 4d4f  _DATA_ENCRYPT_MO\n-0000dfb0: 4445 5f56 414c 4944 4641 494c 270a 2020  DE_VALIDFAIL'.  \n-0000dfc0: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n-0000dfd0: 6461 7461 3a20 656e 6372 7970 743a 2069  data: encrypt: i\n-0000dfe0: 6e76 616c 6964 2065 6e63 7279 7074 696f  nvalid encryptio\n-0000dff0: 6e20 6d6f 6465 0a20 2020 2020 2746 4b4f  n mode.     'FKO\n-0000e000: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n-0000e010: 4154 415f 454e 4352 5950 545f 5459 5045  ATA_ENCRYPT_TYPE\n-0000e020: 5f55 4e4b 4e4f 574e 270a 2020 2020 2020  _UNKNOWN'.      \n-0000e030: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n-0000e040: 3a20 656e 6372 7970 743a 2075 6e6b 6e6f  : encrypt: unkno\n-0000e050: 776e 2065 6e63 7279 7074 696f 6e20 7479  wn encryption ty\n-0000e060: 7065 0a20 2020 2020 2746 4b4f 5f45 5252  pe.     'FKO_ERR\n-0000e070: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_\n-0000e080: 4655 4e43 535f 4e45 575f 454e 434d 5347  FUNCS_NEW_ENCMSG\n-0000e090: 5f4d 4953 5349 4e47 270a 2020 2020 2020  _MISSING'.      \n-0000e0a0: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n-0000e0b0: 3a20 6d69 7373 696e 6720 656e 636f 6465  : missing encode\n-0000e0c0: 6420 6d65 7373 6167 650a 2020 2020 2027  d message.     '\n-0000e0d0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n-0000e0e0: 445f 4441 5441 5f46 554e 4353 5f4e 4557  D_DATA_FUNCS_NEW\n-0000e0f0: 5f4d 5347 4c45 4e5f 5641 4c49 4446 4149  _MSGLEN_VALIDFAI\n-0000e100: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv\n-0000e110: 616c 6964 2064 6174 613a 2069 6e76 616c  alid data: inval\n-0000e120: 6964 206d 6573 7361 6765 206c 656e 6774  id message lengt\n-0000e130: 6820 6672 6f6d 206e 6577 0a20 2020 2020  h from new.     \n-0000e140: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n-0000e150: 4944 5f44 4154 415f 4655 4e43 535f 4745  ID_DATA_FUNCS_GE\n-0000e160: 4e5f 4b45 594c 454e 5f56 414c 4944 4641  N_KEYLEN_VALIDFA\n-0000e170: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In\n-0000e180: 7661 6c69 6420 6461 7461 3a20 696e 7661  valid data: inva\n-0000e190: 6c69 6420 6b65 7920 6c65 6e67 7468 2066  lid key length f\n-0000e1a0: 726f 6d20 6765 6e5f 6b65 796c 656e 0a20  rom gen_keylen. \n-0000e1b0: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n-0000e1c0: 4e56 414c 4944 5f44 4154 415f 4655 4e43  NVALID_DATA_FUNC\n-0000e1d0: 535f 4745 4e5f 484d 4143 4c45 4e5f 5641  S_GEN_HMACLEN_VA\n-0000e1e0: 4c49 4446 4149 4c27 0a20 2020 2020 2020  LIDFAIL'.       \n-0000e1f0: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:\n-0000e200: 2067 656e 5f68 6d61 636c 656e 2066 6169   gen_hmaclen fai\n-0000e210: 6c75 7265 0a20 2020 2020 2746 4b4f 5f45  lure.     'FKO_E\n-0000e220: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n-0000e230: 415f 4655 4e43 535f 4745 4e5f 4b45 595f  A_FUNCS_GEN_KEY_\n-0000e240: 454e 434f 4445 4641 494c 270a 2020 2020  ENCODEFAIL'.    \n-0000e250: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n-0000e260: 7461 3a20 6765 6e5f 6b65 793a 2065 6e63  ta: gen_key: enc\n-0000e270: 6f64 6520 6661 696c 7572 650a 2020 2020  ode failure.    \n-0000e280: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n-0000e290: 4c49 445f 4441 5441 5f46 554e 4353 5f47  LID_DATA_FUNCS_G\n-0000e2a0: 454e 5f48 4d41 435f 454e 434f 4445 4641  EN_HMAC_ENCODEFA\n-0000e2b0: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In\n-0000e2c0: 7661 6c69 6420 6461 7461 3a20 6765 6e5f  valid data: gen_\n-0000e2d0: 686d 6163 3a20 656e 636f 6465 2066 6169  hmac: encode fai\n-0000e2e0: 6c75 7265 0a20 2020 2020 2746 4b4f 5f45  lure.     'FKO_E\n-0000e2f0: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n-0000e300: 415f 4655 4e43 535f 5345 545f 4d53 474c  A_FUNCS_SET_MSGL\n-0000e310: 454e 5f56 414c 4944 4641 494c 270a 2020  EN_VALIDFAIL'.  \n-0000e320: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n-0000e330: 6461 7461 3a20 7365 745f 7370 615f 6461  data: set_spa_da\n-0000e340: 7461 3a20 696e 7661 6c69 6420 6d65 7373  ta: invalid mess\n-0000e350: 6167 6520 6c65 6e67 7468 0a20 2020 2020  age length.     \n-0000e360: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n-0000e370: 4944 5f44 4154 415f 484d 4143 5f4d 5347  ID_DATA_HMAC_MSG\n-0000e380: 4c45 4e5f 5641 4c49 4446 4149 4c27 0a20  LEN_VALIDFAIL'. \n-0000e390: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n-0000e3a0: 2064 6174 613a 2069 6e76 616c 6964 2048   data: invalid H\n-0000e3b0: 4d41 4320 6d73 676c 656e 0a20 2020 2020  MAC msglen.     \n-0000e3c0: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n-0000e3d0: 4944 5f44 4154 415f 484d 4143 5f45 4e43  ID_DATA_HMAC_ENC\n-0000e3e0: 4d53 474c 454e 5f56 414c 4944 4641 494c  MSGLEN_VALIDFAIL\n-0000e3f0: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva\n-0000e400: 6c69 6420 6461 7461 3a20 696e 7661 6c69  lid data: invali\n-0000e410: 6420 6c65 6e67 7468 2066 6f72 2065 6e63  d length for enc\n-0000e420: 7279 7074 6564 206d 6573 7361 6765 0a20  rypted message. \n-0000e430: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n-0000e440: 4e56 414c 4944 5f44 4154 415f 484d 4143  NVALID_DATA_HMAC\n-0000e450: 5f43 4f4d 5041 5245 4641 494c 270a 2020  _COMPAREFAIL'.  \n-0000e460: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n-0000e470: 6461 7461 3a20 484d 4143 2063 6f6d 7061  data: HMAC compa\n-0000e480: 7269 736f 6e20 6661 696c 6564 0a20 2020  rison failed.   \n-0000e490: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n-0000e4a0: 414c 4944 5f44 4154 415f 484d 4143 5f54  ALID_DATA_HMAC_T\n-0000e4b0: 5950 455f 5641 4c49 4446 4149 4c27 0a20  YPE_VALIDFAIL'. \n-0000e4c0: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n-0000e4d0: 2064 6174 613a 2069 6e76 616c 6964 2048   data: invalid H\n-0000e4e0: 4d41 4320 7479 7065 0a20 2020 2020 2746  MAC type.     'F\n-0000e4f0: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n-0000e500: 5f44 4154 415f 484d 4143 5f4c 454e 5f56  _DATA_HMAC_LEN_V\n-0000e510: 414c 4944 4641 494c 270a 2020 2020 2020  ALIDFAIL'.      \n-0000e520: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n-0000e530: 3a20 696e 7661 6c69 6420 484d 4143 206c  : invalid HMAC l\n-0000e540: 656e 6774 680a 2020 2020 2027 464b 4f5f  ength.     'FKO_\n-0000e550: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n-0000e560: 5441 5f4d 4553 5341 4745 5f50 4f52 545f  TA_MESSAGE_PORT_\n-0000e570: 4d49 5353 494e 4727 0a20 2020 2020 2020  MISSING'.       \n-0000e580: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:\n-0000e590: 206d 6973 7369 6e67 2070 6f72 740a 2020   missing port.  \n-0000e5a0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n-0000e5b0: 5641 4c49 445f 4441 5441 5f4d 4553 5341  VALID_DATA_MESSA\n-0000e5c0: 4745 5f54 5950 455f 5641 4c49 4446 4149  GE_TYPE_VALIDFAI\n-0000e5d0: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv\n-0000e5e0: 616c 6964 2064 6174 613a 2069 6e76 616c  alid data: inval\n-0000e5f0: 6964 206d 6573 7361 6765 2074 7970 650a  id message type.\n-0000e600: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000e610: 494e 5641 4c49 445f 4441 5441 5f4d 4553  INVALID_DATA_MES\n-0000e620: 5341 4745 5f45 4d50 5459 270a 2020 2020  SAGE_EMPTY'.    \n-0000e630: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n-0000e640: 7461 3a20 656d 7074 7920 6461 7461 206d  ta: empty data m\n-0000e650: 6573 7361 6765 0a20 2020 2020 2746 4b4f  essage.     'FKO\n-0000e660: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n-0000e670: 4154 415f 4d45 5353 4147 455f 434d 445f  ATA_MESSAGE_CMD_\n-0000e680: 4d49 5353 494e 4727 0a20 2020 2020 2020  MISSING'.       \n-0000e690: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:\n-0000e6a0: 206d 6973 7369 6e67 2063 6f6d 6d61 6e64   missing command\n-0000e6b0: 206d 6573 7361 6765 0a20 2020 2020 2746   message.     'F\n-0000e6c0: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n-0000e6d0: 5f44 4154 415f 4d45 5353 4147 455f 4143  _DATA_MESSAGE_AC\n-0000e6e0: 4345 5353 5f4d 4953 5349 4e47 270a 2020  CESS_MISSING'.  \n-0000e6f0: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n-0000e700: 6461 7461 3a20 6d69 7373 696e 6720 6163  data: missing ac\n-0000e710: 6365 7373 206d 6573 7361 6765 0a20 2020  cess message.   \n-0000e720: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n-0000e730: 414c 4944 5f44 4154 415f 4d45 5353 4147  ALID_DATA_MESSAG\n-0000e740: 455f 4e41 545f 4d49 5353 494e 4727 0a20  E_NAT_MISSING'. \n-0000e750: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n-0000e760: 2064 6174 613a 206d 6973 7369 6e67 204e   data: missing N\n-0000e770: 4154 2064 6174 610a 2020 2020 2027 464b  AT data.     'FK\n-0000e780: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n-0000e790: 4441 5441 5f4d 4553 5341 4745 5f50 4f52  DATA_MESSAGE_POR\n-0000e7a0: 5450 524f 544f 5f4d 4953 5349 4e47 270a  TPROTO_MISSING'.\n-0000e7b0: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n-0000e7c0: 6420 6461 7461 3a20 6d69 7373 696e 6720  d data: missing \n-0000e7d0: 7072 6f74 6f2f 706f 7274 2064 6174 610a  proto/port data.\n-0000e7e0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000e7f0: 494e 5641 4c49 445f 4441 5441 5f4e 4154  INVALID_DATA_NAT\n-0000e800: 5f45 4d50 5459 270a 2020 2020 2020 2020  _EMPTY'.        \n-0000e810: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n-0000e820: 656d 7074 7920 4e41 5420 7661 6c75 650a  empty NAT value.\n-0000e830: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000e840: 494e 5641 4c49 445f 4441 5441 5f52 414e  INVALID_DATA_RAN\n-0000e850: 445f 4c45 4e5f 5641 4c49 4446 4149 4c27  D_LEN_VALIDFAIL'\n-0000e860: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n-0000e870: 6964 2064 6174 613a 2069 6e76 616c 6964  id data: invalid\n-0000e880: 2072 616e 646f 6d20 6461 7461 206c 656e   random data len\n-0000e890: 6774 680a 2020 2020 2027 464b 4f5f 4552  gth.     'FKO_ER\n-0000e8a0: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n-0000e8b0: 5f53 5256 4155 5448 5f4d 4953 5349 4e47  _SRVAUTH_MISSING\n-0000e8c0: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva\n-0000e8d0: 6c69 6420 6461 7461 3a20 7365 7276 6572  lid data: server\n-0000e8e0: 2061 7574 6820 6d69 7373 696e 670a 2020   auth missing.  \n-0000e8f0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n-0000e900: 5641 4c49 445f 4441 5441 5f54 494d 4553  VALID_DATA_TIMES\n-0000e910: 5441 4d50 5f56 414c 4944 4641 494c 270a  TAMP_VALIDFAIL'.\n-0000e920: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n-0000e930: 6420 6461 7461 3a20 696e 7661 6c69 6420  d data: invalid \n-0000e940: 7469 6d65 7374 616d 7020 7661 6c75 650a  timestamp value.\n-0000e950: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000e960: 494e 5641 4c49 445f 4441 5441 5f55 5345  INVALID_DATA_USE\n-0000e970: 525f 4d49 5353 494e 4727 0a20 2020 2020  R_MISSING'.     \n-0000e980: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat\n-0000e990: 613a 206d 6973 7369 6e67 2075 7365 7220  a: missing user \n-0000e9a0: 6461 7461 0a20 2020 2020 2746 4b4f 5f45  data.     'FKO_E\n-0000e9b0: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n-0000e9c0: 415f 5553 4552 5f46 4952 5354 4348 4152  A_USER_FIRSTCHAR\n-0000e9d0: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    \n-0000e9e0: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n-0000e9f0: 7461 3a20 7573 6572 2066 6972 7374 2063  ta: user first c\n-0000ea00: 6861 7220 6e6f 7420 7661 6c69 640a 2020  har not valid.  \n-0000ea10: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n-0000ea20: 5641 4c49 445f 4441 5441 5f55 5345 525f  VALID_DATA_USER_\n-0000ea30: 5245 4d43 4841 525f 5641 4c49 4446 4149  REMCHAR_VALIDFAI\n-0000ea40: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv\n-0000ea50: 616c 6964 2064 6174 613a 2075 7365 7220  alid data: user \n-0000ea60: 7265 6d63 6861 7220 6e6f 7420 7661 6c69  remchar not vali\n-0000ea70: 640a 2020 2020 2027 464b 4f5f 4552 524f  d.     'FKO_ERRO\n-0000ea80: 525f 494e 5641 4c49 445f 4441 5441 5f55  R_INVALID_DATA_U\n-0000ea90: 5449 4c5f 5354 5254 4f4c 5f4c 545f 4d49  TIL_STRTOL_LT_MI\n-0000eaa0: 4e27 0a20 2020 2020 2020 2020 2049 6e76  N'.          Inv\n-0000eab0: 616c 6964 2064 6174 613a 2075 7469 6c20  alid data: util \n-0000eac0: 636f 6e76 6572 7369 6f6e 2074 6f20 6c6f  conversion to lo\n-0000ead0: 6e67 206c 6573 7320 7468 616e 206d 696e  ng less than min\n-0000eae0: 696d 756d 0a20 2020 2020 2746 4b4f 5f45  imum.     'FKO_E\n-0000eaf0: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n-0000eb00: 415f 5554 494c 5f53 5452 544f 4c5f 4754  A_UTIL_STRTOL_GT\n-0000eb10: 5f4d 4158 270a 2020 2020 2020 2020 2020  _MAX'.          \n-0000eb20: 496e 7661 6c69 6420 6461 7461 3a20 7574  Invalid data: ut\n-0000eb30: 696c 2063 6f6e 7665 7273 696f 6e20 746f  il conversion to\n-0000eb40: 206c 6f6e 6720 6772 6561 7465 7220 7468   long greater th\n-0000eb50: 616e 206d 6178 696d 756d 0a20 2020 2020  an maximum.     \n-0000eb60: 2746 4b4f 5f45 5252 4f52 5f44 4154 415f  'FKO_ERROR_DATA_\n-0000eb70: 544f 4f5f 4c41 5247 4527 0a20 2020 2020  TOO_LARGE'.     \n-0000eb80: 2020 2020 2056 616c 7565 206f 7220 5369       Value or Si\n-0000eb90: 7a65 206f 6620 7468 6520 6461 7461 2065  ze of the data e\n-0000eba0: 7863 6565 6465 6420 7468 6520 6d61 7820  xceeded the max \n-0000ebb0: 616c 6c6f 7765 640a 2020 2020 2027 464b  allowed.     'FK\n-0000ebc0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n-0000ebd0: 4b45 595f 4c45 4e27 0a20 2020 2020 2020  KEY_LEN'.       \n-0000ebe0: 2020 2049 6e76 616c 6964 206b 6579 206c     Invalid key l\n-0000ebf0: 656e 6774 680a 2020 2020 2027 464b 4f5f  ength.     'FKO_\n-0000ec00: 4552 524f 525f 5553 4552 4e41 4d45 5f55  ERROR_USERNAME_U\n-0000ec10: 4e4b 4e4f 574e 270a 2020 2020 2020 2020  NKNOWN'.        \n-0000ec20: 2020 556e 6162 6c65 2074 6f20 6465 7465    Unable to dete\n-0000ec30: 726d 696e 6520 7573 6572 6e61 6d65 0a20  rmine username. \n-0000ec40: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n-0000ec50: 4e43 4f4d 504c 4554 455f 5350 415f 4441  NCOMPLETE_SPA_DA\n-0000ec60: 5441 270a 2020 2020 2020 2020 2020 4d69  TA'.          Mi\n-0000ec70: 7373 696e 6720 6f72 2069 6e63 6f6d 706c  ssing or incompl\n-0000ec80: 6574 6520 5350 4120 6461 7461 0a20 2020  ete SPA data.   \n-0000ec90: 2020 2746 4b4f 5f45 5252 4f52 5f4d 4953    'FKO_ERROR_MIS\n-0000eca0: 5349 4e47 5f45 4e43 4f44 4544 5f44 4154  SING_ENCODED_DAT\n-0000ecb0: 4127 0a20 2020 2020 2020 2020 2054 6865  A'.          The\n-0000ecc0: 7265 2069 7320 6e6f 2065 6e63 6f64 6564  re is no encoded\n-0000ecd0: 2064 6174 6120 746f 2070 726f 6365 7373   data to process\n-0000ece0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-0000ecf0: 5f49 4e56 414c 4944 5f44 4947 4553 545f  _INVALID_DIGEST_\n-0000ed00: 5459 5045 270a 2020 2020 2020 2020 2020  TYPE'.          \n-0000ed10: 496e 7661 6c69 6420 6469 6765 7374 2074  Invalid digest t\n-0000ed20: 7970 650a 2020 2020 2027 464b 4f5f 4552  ype.     'FKO_ER\n-0000ed30: 524f 525f 494e 5641 4c49 445f 414c 4c4f  ROR_INVALID_ALLO\n-0000ed40: 575f 4950 270a 2020 2020 2020 2020 2020  W_IP'.          \n-0000ed50: 496e 7661 6c69 6420 616c 6c6f 7720 4950  Invalid allow IP\n-0000ed60: 2061 6464 7265 7373 2069 6e20 7468 6520   address in the \n-0000ed70: 5350 4120 6d65 7373 6167 6520 6461 7461  SPA message data\n-0000ed80: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-0000ed90: 5f49 4e56 414c 4944 5f53 5041 5f43 4f4d  _INVALID_SPA_COM\n-0000eda0: 4d41 4e44 5f4d 5347 270a 2020 2020 2020  MAND_MSG'.      \n-0000edb0: 2020 2020 496e 7661 6c69 6420 5350 4120      Invalid SPA \n-0000edc0: 636f 6d6d 616e 6420 6d65 7373 6167 6520  command message \n-0000edd0: 666f 726d 6174 0a20 2020 2020 2746 4b4f  format.     'FKO\n-0000ede0: 5f45 5252 4f52 5f49 4e56 414c 4944 5f53  _ERROR_INVALID_S\n-0000edf0: 5041 5f41 4343 4553 535f 4d53 4727 0a20  PA_ACCESS_MSG'. \n-0000ee00: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n-0000ee10: 2053 5041 2061 6363 6573 7320 6d65 7373   SPA access mess\n-0000ee20: 6167 6520 666f 726d 6174 0a20 2020 2020  age format.     \n-0000ee30: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n-0000ee40: 4944 5f53 5041 5f4e 4154 5f41 4343 4553  ID_SPA_NAT_ACCES\n-0000ee50: 535f 4d53 4727 0a20 2020 2020 2020 2020  S_MSG'.         \n-0000ee60: 2049 6e76 616c 6964 2053 5041 206e 6174   Invalid SPA nat\n-0000ee70: 5f61 6363 6573 7320 6d65 7373 6167 6520  _access message \n-0000ee80: 666f 726d 6174 0a20 2020 2020 2746 4b4f  format.     'FKO\n-0000ee90: 5f45 5252 4f52 5f49 4e56 414c 4944 5f45  _ERROR_INVALID_E\n-0000eea0: 4e43 5259 5054 494f 4e5f 5459 5045 270a  NCRYPTION_TYPE'.\n-0000eeb0: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n-0000eec0: 6420 656e 6372 7970 7469 6f6e 2074 7970  d encryption typ\n-0000eed0: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO\n-0000eee0: 525f 5752 4f4e 475f 454e 4352 5950 5449  R_WRONG_ENCRYPTI\n-0000eef0: 4f4e 5f54 5950 4527 0a20 2020 2020 2020  ON_TYPE'.       \n-0000ef00: 2020 2057 726f 6e67 206f 7220 696e 6170     Wrong or inap\n-0000ef10: 7072 6f70 7269 6174 6520 656e 6372 7970  propriate encryp\n-0000ef20: 7469 6f6e 2074 7970 6520 666f 7220 7468  tion type for th\n-0000ef30: 6973 206f 7065 7261 7469 6f6e 0a20 2020  is operation.   \n-0000ef40: 2020 2746 4b4f 5f45 5252 4f52 5f44 4543    'FKO_ERROR_DEC\n-0000ef50: 5259 5054 494f 4e5f 5349 5a45 270a 2020  RYPTION_SIZE'.  \n-0000ef60: 2020 2020 2020 2020 556e 6578 7065 6374          Unexpect\n-0000ef70: 6564 206f 7220 696e 7661 6c69 6420 7369  ed or invalid si\n-0000ef80: 7a65 2066 6f72 2064 6563 7279 7074 6564  ze for decrypted\n-0000ef90: 2064 6174 610a 2020 2020 2027 464b 4f5f   data.     'FKO_\n-0000efa0: 4552 524f 525f 4445 4352 5950 5449 4f4e  ERROR_DECRYPTION\n-0000efb0: 5f46 4149 4c55 5245 270a 2020 2020 2020  _FAILURE'.      \n-0000efc0: 2020 2020 4465 6372 7970 7469 6f6e 2066      Decryption f\n-0000efd0: 6169 6c65 6420 6f72 2064 6563 7279 7074  ailed or decrypt\n-0000efe0: 6564 2064 6174 6120 6973 2069 6e76 616c  ed data is inval\n-0000eff0: 6964 0a20 2020 2020 2746 4b4f 5f45 5252  id.     'FKO_ERR\n-0000f000: 4f52 5f44 4947 4553 545f 5645 5249 4649  OR_DIGEST_VERIFI\n-0000f010: 4341 5449 4f4e 5f46 4149 4c45 4427 0a20  CATION_FAILED'. \n-0000f020: 2020 2020 2020 2020 2054 6865 2063 6f6d           The com\n-0000f030: 7075 7465 6420 6469 6765 7374 2064 6964  puted digest did\n-0000f040: 206e 6f74 206d 6174 6368 2074 6865 2064   not match the d\n-0000f050: 6967 6573 7420 696e 2074 6865 2073 7061  igest in the spa\n-0000f060: 2064 6174 610a 2020 2020 2027 464b 4f5f   data.     'FKO_\n-0000f070: 4552 524f 525f 494e 5641 4c49 445f 484d  ERROR_INVALID_HM\n-0000f080: 4143 5f4b 4559 5f4c 454e 270a 2020 2020  AC_KEY_LEN'.    \n-0000f090: 2020 2020 2020 496e 7661 6c69 6420 484d        Invalid HM\n-0000f0a0: 4143 206b 6579 206c 656e 6774 680a 2020  AC key length.  \n-0000f0b0: 2020 2027 464b 4f5f 4552 524f 525f 554e     'FKO_ERROR_UN\n-0000f0c0: 5355 5050 4f52 5445 445f 484d 4143 5f4d  SUPPORTED_HMAC_M\n-0000f0d0: 4f44 4527 0a20 2020 2020 2020 2020 2055  ODE'.          U\n-0000f0e0: 6e73 7570 706f 7274 6564 2048 4d41 4320  nsupported HMAC \n-0000f0f0: 6d6f 6465 2028 6465 6661 756c 743a 2053  mode (default: S\n-0000f100: 4841 3235 3629 0a20 2020 2020 2746 4b4f  HA256).     'FKO\n-0000f110: 5f45 5252 4f52 5f55 4e53 5550 504f 5254  _ERROR_UNSUPPORT\n-0000f120: 4544 5f46 4541 5455 5245 270a 2020 2020  ED_FEATURE'.    \n-0000f130: 2020 2020 2020 556e 7375 7070 6f72 7465        Unsupporte\n-0000f140: 6420 6f72 2075 6e69 6d70 6c65 6d65 6e74  d or unimplement\n-0000f150: 6564 2066 6561 7475 7265 206f 7220 6675  ed feature or fu\n-0000f160: 6e63 7469 6f6e 0a20 2020 2020 2746 4b4f  nction.     'FKO\n-0000f170: 5f45 5252 4f52 5f5a 4552 4f5f 4f55 545f  _ERROR_ZERO_OUT_\n-0000f180: 4441 5441 270a 2020 2020 2020 2020 2020  DATA'.          \n-0000f190: 436f 756c 6420 6e6f 7420 7a65 726f 206f  Could not zero o\n-0000f1a0: 7574 2073 656e 7369 7469 7665 2064 6174  ut sensitive dat\n-0000f1b0: 610a 2020 2020 2027 464b 4f5f 4552 524f  a.     'FKO_ERRO\n-0000f1c0: 525f 554e 4b4e 4f57 4e27 0a20 2020 2020  R_UNKNOWN'.     \n-0000f1d0: 2020 2020 2055 6e6b 6e6f 776e 2f55 6e63       Unknown/Unc\n-0000f1e0: 6c61 7373 6966 6965 6420 6572 726f 720a  lassified error.\n-0000f1f0: 0a20 2020 4966 2047 5047 2073 7570 706f  .   If GPG suppo\n-0000f200: 7274 2069 7320 6176 6169 6c61 626c 652c  rt is available,\n-0000f210: 2074 6865 7265 2061 7265 2061 6464 6974   there are addit\n-0000f220: 696f 6e61 6c20 706f 7373 6962 6c65 2065  ional possible e\n-0000f230: 7272 6f72 0a63 6f6e 6469 7469 6f6e 7320  rror.conditions \n-0000f240: 616e 6420 6572 726f 7220 636f 6465 732e  and error codes.\n-0000f250: 2020 5468 6520 4750 4720 7375 7070 6f72    The GPG suppor\n-0000f260: 7420 6973 2069 6d70 6c65 6d65 6e74 6564  t is implemented\n-0000f270: 2076 6961 2047 5047 4d45 2e0a 5468 6520   via GPGME..The \n-0000f280: 6c69 6266 6b6f 2065 7272 6f72 2068 616e  libfko error han\n-0000f290: 646c 696e 6720 636f 6465 2077 7261 7073  dling code wraps\n-0000f2a0: 206d 616e 7920 6f66 2074 6865 2047 5047   many of the GPG\n-0000f2b0: 4d45 2065 7272 6f72 2063 6f64 6573 2074  ME error codes t\n-0000f2c0: 6861 740a 6d61 7920 6265 2065 6e63 6f75  hat.may be encou\n-0000f2d0: 6e74 6572 6564 2077 6869 6c65 2075 7369  ntered while usi\n-0000f2e0: 6e67 206c 6962 666b 6f27 7320 4750 4720  ng libfko's GPG \n-0000f2f0: 7265 6c61 7465 6420 6675 6e63 7469 6f6e  related function\n-0000f300: 732e 2020 5468 6573 650a 6172 653a 0a0a  s.  These.are:..\n-0000f310: 202d 2d20 5661 7269 6162 6c65 3a20 696e   -- Variable: in\n-0000f320: 7420 6572 726f 725f 636f 6465 2028 6770  t error_code (gp\n-0000f330: 676d 6520 7375 7070 6f72 7420 6f6e 6c79  gme support only\n-0000f340: 290a 2020 2020 2027 464b 4f5f 4552 524f  ).     'FKO_ERRO\n-0000f350: 525f 4d49 5353 494e 475f 4750 475f 4b45  R_MISSING_GPG_KE\n-0000f360: 595f 4441 5441 270a 2020 2020 2020 2020  Y_DATA'.        \n-0000f370: 2020 4d69 7373 696e 6720 4750 4720 6b65    Missing GPG ke\n-0000f380: 7920 6461 7461 2028 7369 676e 6572 206f  y data (signer o\n-0000f390: 7220 7265 6369 7069 656e 7420 6e6f 7420  r recipient not \n-0000f3a0: 7365 7429 0a20 2020 2020 2746 4b4f 5f45  set).     'FKO_E\n-0000f3b0: 5252 4f52 5f47 5047 4d45 5f4e 4f5f 4f50  RROR_GPGME_NO_OP\n-0000f3c0: 454e 5047 5027 0a20 2020 2020 2020 2020  ENPGP'.         \n-0000f3d0: 2054 6869 7320 4750 474d 4520 696d 706c   This GPGME impl\n-0000f3e0: 656d 656e 7461 7469 6f6e 2064 6f65 7320  ementation does \n-0000f3f0: 6e6f 7420 7375 7070 6f72 7420 4f70 656e  not support Open\n-0000f400: 5047 500a 2020 2020 2027 464b 4f5f 4552  PGP.     'FKO_ER\n-0000f410: 524f 525f 4750 474d 455f 434f 4e54 4558  ROR_GPGME_CONTEX\n-0000f420: 5427 0a20 2020 2020 2020 2020 2055 6e61  T'.          Una\n-0000f430: 626c 6520 746f 2063 7265 6174 6520 4750  ble to create GP\n-0000f440: 474d 4520 636f 6e74 6578 740a 2020 2020  GME context.    \n-0000f450: 2027 464b 4f5f 4552 524f 525f 4750 474d   'FKO_ERROR_GPGM\n-0000f460: 455f 504c 4149 4e54 4558 545f 4441 5441  E_PLAINTEXT_DATA\n-0000f470: 5f4f 424a 270a 2020 2020 2020 2020 2020  _OBJ'.          \n-0000f480: 4572 726f 7220 6372 6561 7469 6e67 2074  Error creating t\n-0000f490: 6865 2070 6c61 696e 7465 7874 2064 6174  he plaintext dat\n-0000f4a0: 6120 6f62 6a65 6374 0a20 2020 2020 2746  a object.     'F\n-0000f4b0: 4b4f 5f45 5252 4f52 5f47 5047 4d45 5f53  KO_ERROR_GPGME_S\n-0000f4c0: 4554 5f50 524f 544f 434f 4c27 0a20 2020  ET_PROTOCOL'.   \n-0000f4d0: 2020 2020 2020 2055 6e61 626c 6520 746f         Unable to\n-0000f4e0: 2073 6574 2047 5047 4d45 2074 6f20 7573   set GPGME to us\n-0000f4f0: 6520 4f70 656e 5047 5020 7072 6f74 6f63  e OpenPGP protoc\n-0000f500: 6f6c 0a20 2020 2020 2746 4b4f 5f45 5252  ol.     'FKO_ERR\n-0000f510: 4f52 5f47 5047 4d45 5f43 4950 4845 525f  OR_GPGME_CIPHER_\n-0000f520: 4441 5441 5f4f 424a 270a 2020 2020 2020  DATA_OBJ'.      \n-0000f530: 2020 2020 4572 726f 7220 6372 6561 7469      Error creati\n-0000f540: 6e67 2074 6865 2065 6e63 7279 7074 6564  ng the encrypted\n-0000f550: 2064 6174 6120 6461 7461 206f 626a 6563   data data objec\n-0000f560: 740a 2020 2020 2027 464b 4f5f 4552 524f  t.     'FKO_ERRO\n-0000f570: 525f 4750 474d 455f 4241 445f 5041 5353  R_GPGME_BAD_PASS\n-0000f580: 5048 5241 5345 270a 2020 2020 2020 2020  PHRASE'.        \n-0000f590: 2020 5468 6520 4750 4720 7061 7373 7068    The GPG passph\n-0000f5a0: 7261 7365 2077 6173 206e 6f74 2076 616c  rase was not val\n-0000f5b0: 6964 0a20 2020 2020 2746 4b4f 5f45 5252  id.     'FKO_ERR\n-0000f5c0: 4f52 5f47 5047 4d45 5f45 4e43 5259 5054  OR_GPGME_ENCRYPT\n-0000f5d0: 5f53 4947 4e27 0a20 2020 2020 2020 2020  _SIGN'.         \n-0000f5e0: 2045 7272 6f72 2064 7572 696e 6720 7468   Error during th\n-0000f5f0: 6520 656e 6372 7970 7420 616e 6420 7369  e encrypt and si\n-0000f600: 676e 206f 7065 7261 7469 6f6e 0a20 2020  gn operation.   \n-0000f610: 2020 2746 4b4f 5f45 5252 4f52 5f47 5047    'FKO_ERROR_GPG\n-0000f620: 4d45 5f43 4f4e 5445 5854 5f53 4947 4e45  ME_CONTEXT_SIGNE\n-0000f630: 525f 4b45 5927 0a20 2020 2020 2020 2020  R_KEY'.         \n-0000f640: 2055 6e61 626c 6520 746f 2063 7265 6174   Unable to creat\n-0000f650: 6520 4750 474d 4520 636f 6e74 6578 7420  e GPGME context \n-0000f660: 666f 7220 7468 6520 7369 676e 6572 206b  for the signer k\n-0000f670: 6579 0a20 2020 2020 2746 4b4f 5f45 5252  ey.     'FKO_ERR\n-0000f680: 4f52 5f47 5047 4d45 5f53 4947 4e45 525f  OR_GPGME_SIGNER_\n-0000f690: 4b45 594c 4953 545f 5354 4152 5427 0a20  KEYLIST_START'. \n-0000f6a0: 2020 2020 2020 2020 2045 7272 6f72 2066           Error f\n-0000f6b0: 726f 6d20 7369 676e 6572 206b 6579 6c69  rom signer keyli\n-0000f6c0: 7374 2073 7461 7274 206f 7065 7261 7469  st start operati\n-0000f6d0: 6f6e 0a20 2020 2020 2746 4b4f 5f45 5252  on.     'FKO_ERR\n-0000f6e0: 4f52 5f47 5047 4d45 5f53 4947 4e45 525f  OR_GPGME_SIGNER_\n-0000f6f0: 4b45 595f 4e4f 545f 464f 554e 4427 0a20  KEY_NOT_FOUND'. \n-0000f700: 2020 2020 2020 2020 2054 6865 206b 6579           The key\n-0000f710: 2066 6f72 2074 6865 2067 6976 656e 2073   for the given s\n-0000f720: 6967 6e65 7220 7761 7320 6e6f 7420 666f  igner was not fo\n-0000f730: 756e 640a 2020 2020 2027 464b 4f5f 4552  und.     'FKO_ER\n-0000f740: 524f 525f 4750 474d 455f 5349 474e 4552  ROR_GPGME_SIGNER\n-0000f750: 5f4b 4559 5f41 4d42 4947 554f 5553 270a  _KEY_AMBIGUOUS'.\n-0000f760: 2020 2020 2020 2020 2020 416d 6269 6775            Ambigu\n-0000f770: 6f75 7320 6e61 6d65 2f69 6420 666f 7220  ous name/id for \n-0000f780: 7468 6520 7369 676e 6572 206b 6579 2028  the signer key (\n-0000f790: 6d75 6c74 6970 6c65 206d 6174 6368 6573  multiple matches\n-0000f7a0: 290a 2020 2020 2027 464b 4f5f 4552 524f  ).     'FKO_ERRO\n-0000f7b0: 525f 4750 474d 455f 4144 445f 5349 474e  R_GPGME_ADD_SIGN\n-0000f7c0: 4552 270a 2020 2020 2020 2020 2020 4572  ER'.          Er\n-0000f7d0: 726f 7220 6164 6469 6e67 2074 6865 2073  ror adding the s\n-0000f7e0: 6967 6e65 7220 6b65 7920 746f 2074 6865  igner key to the\n-0000f7f0: 2067 7067 6d65 2063 6f6e 7465 7874 0a20   gpgme context. \n-0000f800: 2020 2020 2746 4b4f 5f45 5252 4f52 5f47      'FKO_ERROR_G\n-0000f810: 5047 4d45 5f43 4f4e 5445 5854 5f52 4543  PGME_CONTEXT_REC\n-0000f820: 4950 4945 4e54 5f4b 4559 270a 2020 2020  IPIENT_KEY'.    \n-0000f830: 2020 2020 2020 556e 6162 6c65 2074 6f20        Unable to \n-0000f840: 6372 6561 7465 2047 5047 4d45 2063 6f6e  create GPGME con\n-0000f850: 7465 7874 2066 6f72 2074 6865 2072 6563  text for the rec\n-0000f860: 6970 6965 6e74 206b 6579 0a20 2020 2020  ipient key.     \n-0000f870: 2746 4b4f 5f45 5252 4f52 5f47 5047 4d45  'FKO_ERROR_GPGME\n-0000f880: 5f52 4543 4950 4945 4e54 5f4b 4559 4c49  _RECIPIENT_KEYLI\n-0000f890: 5354 5f53 5441 5254 270a 2020 2020 2020  ST_START'.      \n-0000f8a0: 2020 2020 4572 726f 7220 6672 6f6d 2073      Error from s\n-0000f8b0: 6967 6e65 7220 6b65 796c 6973 7420 7374  igner keylist st\n-0000f8c0: 6172 7420 6f70 6572 6174 696f 6e0a 2020  art operation.  \n-0000f8d0: 2020 2027 464b 4f5f 4552 524f 525f 4750     'FKO_ERROR_GP\n-0000f8e0: 474d 455f 5245 4349 5049 454e 545f 4b45  GME_RECIPIENT_KE\n-0000f8f0: 595f 4e4f 545f 464f 554e 4427 0a20 2020  Y_NOT_FOUND'.   \n-0000f900: 2020 2020 2020 2054 6865 206b 6579 2066         The key f\n-0000f910: 6f72 2074 6865 2067 6976 656e 2072 6563  or the given rec\n-0000f920: 6970 6965 6e74 2077 6173 206e 6f74 2066  ipient was not f\n-0000f930: 6f75 6e64 0a20 2020 2020 2746 4b4f 5f45  ound.     'FKO_E\n-0000f940: 5252 4f52 5f47 5047 4d45 5f52 4543 4950  RROR_GPGME_RECIP\n-0000f950: 4945 4e54 5f4b 4559 5f41 4d42 4947 554f  IENT_KEY_AMBIGUO\n-0000f960: 5553 270a 2020 2020 2020 2020 2020 416d  US'.          Am\n-0000f970: 6269 6775 6f75 7320 6e61 6d65 2f69 6420  biguous name/id \n-0000f980: 666f 7220 7468 6520 7265 6369 7069 656e  for the recipien\n-0000f990: 7420 6b65 7920 286d 756c 7469 706c 6520  t key (multiple \n-0000f9a0: 6d61 7463 6865 7329 0a20 2020 2020 2746  matches).     'F\n-0000f9b0: 4b4f 5f45 5252 4f52 5f47 5047 4d45 5f44  KO_ERROR_GPGME_D\n-0000f9c0: 4543 5259 5054 5f46 4149 4c45 4427 0a20  ECRYPT_FAILED'. \n-0000f9d0: 2020 2020 2020 2020 2044 6563 7279 7074           Decrypt\n-0000f9e0: 696f 6e20 6f70 6572 6174 696f 6e20 6661  ion operation fa\n-0000f9f0: 696c 6564 0a20 2020 2020 2746 4b4f 5f45  iled.     'FKO_E\n-0000fa00: 5252 4f52 5f47 5047 4d45 5f42 4144 5f47  RROR_GPGME_BAD_G\n-0000fa10: 5047 5f45 5845 270a 2020 2020 2020 2020  PG_EXE'.        \n-0000fa20: 2020 556e 6162 6c65 2074 6f20 7374 6174    Unable to stat\n-0000fa30: 2074 6865 2067 6976 656e 2047 5047 2065   the given GPG e\n-0000fa40: 7865 6375 7461 626c 650a 2020 2020 2027  xecutable.     '\n-0000fa50: 464b 4f5f 4552 524f 525f 4750 474d 455f  FKO_ERROR_GPGME_\n-0000fa60: 4241 445f 484f 4d45 5f44 4952 270a 2020  BAD_HOME_DIR'.  \n-0000fa70: 2020 2020 2020 2020 556e 6162 6c65 2074          Unable t\n-0000fa80: 6f20 7374 6174 2074 6865 2067 6976 656e  o stat the given\n-0000fa90: 2047 5047 2068 6f6d 6520 6469 7265 6374   GPG home direct\n-0000faa0: 6f72 790a 2020 2020 2027 464b 4f5f 4552  ory.     'FKO_ER\n-0000fab0: 524f 525f 4750 474d 455f 5345 545f 484f  ROR_GPGME_SET_HO\n-0000fac0: 4d45 5f44 4952 270a 2020 2020 2020 2020  ME_DIR'.        \n-0000fad0: 2020 556e 6162 6c65 2074 6f20 7365 7420    Unable to set \n-0000fae0: 7468 6520 6769 7665 6e20 4750 4720 686f  the given GPG ho\n-0000faf0: 6d65 2064 6972 6563 746f 7279 0a20 2020  me directory.   \n-0000fb00: 2020 2746 4b4f 5f45 5252 4f52 5f47 5047    'FKO_ERROR_GPG\n-0000fb10: 4d45 5f4e 4f5f 5349 474e 4154 5552 4527  ME_NO_SIGNATURE'\n-0000fb20: 0a20 2020 2020 2020 2020 204d 6973 7369  .          Missi\n-0000fb30: 6e67 2047 5047 2073 6967 6e61 7475 7265  ng GPG signature\n-0000fb40: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-0000fb50: 5f47 5047 4d45 5f42 4144 5f53 4947 4e41  _GPGME_BAD_SIGNA\n-0000fb60: 5455 5245 270a 2020 2020 2020 2020 2020  TURE'.          \n-0000fb70: 4261 6420 4750 4720 7369 676e 6174 7572  Bad GPG signatur\n-0000fb80: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO\n-0000fb90: 525f 4750 474d 455f 5349 474e 4154 5552  R_GPGME_SIGNATUR\n-0000fba0: 455f 5645 5249 4659 5f44 4953 4142 4c45  E_VERIFY_DISABLE\n-0000fbb0: 4427 0a20 2020 2020 2020 2020 2054 7279  D'.          Try\n-0000fbc0: 696e 6720 746f 2063 6865 636b 2073 6967  ing to check sig\n-0000fbd0: 6e61 7475 7265 2077 6974 6820 7665 7269  nature with veri\n-0000fbe0: 6669 6361 7469 6f6e 2064 6973 6162 6c65  fication disable\n-0000fbf0: 640a 2020 2020 2027 464b 4f5f 4552 524f  d.     'FKO_ERRO\n-0000fc00: 525f 494e 5641 4c49 445f 4441 5441 5f45  R_INVALID_DATA_E\n-0000fc10: 4e43 5259 5054 5f47 5047 5f4d 4553 5341  NCRYPT_GPG_MESSA\n-0000fc20: 4745 5f56 414c 4944 4641 494c 270a 2020  GE_VALIDFAIL'.  \n-0000fc30: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n-0000fc40: 6461 7461 3a20 656e 6372 7970 743a 2069  data: encrypt: i\n-0000fc50: 6e76 616c 6964 2047 5047 2d65 6e63 7279  nvalid GPG-encry\n-0000fc60: 7074 206d 6573 7361 6765 0a20 2020 2020  pt message.     \n-0000fc70: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n-0000fc80: 4944 5f44 4154 415f 454e 4352 5950 545f  ID_DATA_ENCRYPT_\n-0000fc90: 4750 475f 4449 4745 5354 5f56 414c 4944  GPG_DIGEST_VALID\n-0000fca0: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          \n-0000fcb0: 496e 7661 6c69 6420 6461 7461 3a20 656e  Invalid data: en\n-0000fcc0: 6372 7970 743a 2069 6e76 616c 6964 2047  crypt: invalid G\n-0000fcd0: 5047 2064 6967 6573 740a 2020 2020 2027  PG digest.     '\n-0000fce0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n-0000fcf0: 445f 4441 5441 5f45 4e43 5259 5054 5f47  D_DATA_ENCRYPT_G\n-0000fd00: 5047 5f4d 5347 4c45 4e5f 5641 4c49 4446  PG_MSGLEN_VALIDF\n-0000fd10: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I\n-0000fd20: 6e76 616c 6964 2064 6174 613a 2065 6e63  nvalid data: enc\n-0000fd30: 7279 7074 3a20 696e 7661 6c69 6420 4750  rypt: invalid GP\n-0000fd40: 4720 6d65 7373 6167 6520 6c65 6e67 7468  G message length\n-0000fd50: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-0000fd60: 5f49 4e56 414c 4944 5f44 4154 415f 454e  _INVALID_DATA_EN\n-0000fd70: 4352 5950 545f 4750 475f 5245 5355 4c54  CRYPT_GPG_RESULT\n-0000fd80: 5f4d 5347 4c45 4e5f 5641 4c49 4446 4149  _MSGLEN_VALIDFAI\n-0000fd90: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv\n-0000fda0: 616c 6964 2064 6174 613a 2065 6e63 7279  alid data: encry\n-0000fdb0: 7074 3a20 696e 7661 6c69 6420 4750 4720  pt: invalid GPG \n-0000fdc0: 7265 7375 6c74 206d 6573 7361 6765 206c  result message l\n-0000fdd0: 656e 6774 680a 2020 2020 2027 464b 4f5f  ength.     'FKO_\n-0000fde0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n-0000fdf0: 5441 5f45 4e43 5259 5054 5f47 5047 5f43  TA_ENCRYPT_GPG_C\n-0000fe00: 4950 4845 525f 4445 434f 4445 4641 494c  IPHER_DECODEFAIL\n-0000fe10: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva\n-0000fe20: 6c69 6420 6461 7461 3a20 656e 6372 7970  lid data: encryp\n-0000fe30: 743a 2047 5047 2063 6970 6865 7220 6661  t: GPG cipher fa\n-0000fe40: 696c 6564 0a20 2020 2020 2746 4b4f 5f45  iled.     'FKO_E\n-0000fe50: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n-0000fe60: 415f 454e 4352 5950 545f 4750 475f 454e  A_ENCRYPT_GPG_EN\n-0000fe70: 434f 4445 444d 5347 5f4e 554c 4c27 0a20  CODEDMSG_NULL'. \n-0000fe80: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n-0000fe90: 2064 6174 613a 2065 6e63 7279 7074 3a20   data: encrypt: \n-0000fea0: 4750 472d 656e 636f 6465 6420 6d65 7373  GPG-encoded mess\n-0000feb0: 6167 6520 6973 204e 554c 4c0a 2020 2020  age is NULL.    \n-0000fec0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n-0000fed0: 4c49 445f 4441 5441 5f45 4e43 5259 5054  LID_DATA_ENCRYPT\n-0000fee0: 5f47 5047 5f45 4e43 4f44 4544 4d53 474c  _GPG_ENCODEDMSGL\n-0000fef0: 454e 5f56 414c 4944 4641 494c 270a 2020  EN_VALIDFAIL'.  \n-0000ff00: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n-0000ff10: 6461 7461 3a20 656e 6372 7970 743a 2069  data: encrypt: i\n-0000ff20: 6e76 616c 6964 2047 5047 2d65 6e63 7279  nvalid GPG-encry\n-0000ff30: 7074 6564 206d 6573 7361 6765 206c 656e  pted message len\n-0000ff40: 6774 680a 0a20 2020 596f 7520 6361 6e20  gth..   You can \n-0000ff50: 7573 6520 7468 6520 2749 535f 4750 474d  use the 'IS_GPGM\n-0000ff60: 455f 4552 524f 5228 6572 725f 636f 6465  E_ERROR(err_code\n-0000ff70: 2927 206d 6163 726f 2074 6f20 6465 7465  )' macro to dete\n-0000ff80: 726d 696e 6520 7768 6574 6865 720a 6f72  rmine whether.or\n-0000ff90: 206e 6f74 2061 6e20 6572 726f 7220 6964   not an error id\n-0000ffa0: 2047 5047 4d45 2072 656c 6174 6564 2e20   GPGME related. \n-0000ffb0: 2049 6620 7468 6520 6d61 6372 6f20 6576   If the macro ev\n-0000ffc0: 616c 7561 7465 7320 746f 2061 2074 7275  aluates to a tru\n-0000ffd0: 650a 7661 6c75 652c 2079 6f75 206d 6179  e.value, you may\n-0000ffe0: 2062 6520 6162 6c65 2074 6f20 6765 7420   be able to get \n-0000fff0: 6164 6469 7469 6f6e 616c 2069 6e66 6f72  additional infor\n-00010000: 6d61 7469 6f6e 2061 626f 7574 2074 6865  mation about the\n-00010010: 2065 7272 6f72 0a75 7369 6e67 2074 6865   error.using the\n-00010020: 2066 6f6c 6c6f 7769 6e67 2066 756e 6374   following funct\n-00010030: 696f 6e3a 0a0a 202d 2d20 4675 6e63 7469  ion:.. -- Functi\n-00010040: 6f6e 3a20 636f 6e73 7420 6368 6172 202a  on: const char *\n-00010050: 2066 6b6f 5f67 7067 5f65 7272 7374 7220   fko_gpg_errstr \n-00010060: 2869 6e74 2045 5252 5f43 4f44 4529 0a20  (int ERR_CODE). \n-00010070: 2020 2020 5468 6520 6675 6e63 7469 6f6e      The function\n-00010080: 2027 666b 6f5f 6572 7273 7472 2720 7265   'fko_errstr' re\n-00010090: 7475 726e 7320 6120 706f 696e 7465 7220  turns a pointer \n-000100a0: 746f 2061 2073 7461 7469 6361 6c6c 790a  to a statically.\n-000100b0: 2020 2020 2061 6c6c 6f63 6174 6564 2073       allocated s\n-000100c0: 7472 696e 6720 636f 6e74 6169 6e69 6e67  tring containing\n-000100d0: 2074 6865 2064 6573 6372 6970 7469 6f6e   the description\n-000100e0: 206f 6620 7468 6520 4750 474d 4520 6572   of the GPGME er\n-000100f0: 726f 722e 0a0a 2a4e 6f74 652a 3a20 466f  ror...*Note*: Fo\n-00010100: 7220 736f 6d65 2065 7272 6f72 732c 2074  r some errors, t\n-00010110: 6869 7320 6675 6e63 7469 6f6e 206d 6179  his function may\n-00010120: 2072 6574 7572 6e20 616e 2065 6d70 7479   return an empty\n-00010130: 2073 7472 696e 672e 0a0a 1f0a 4669 6c65   string.....File\n-00010140: 3a20 6c69 6266 6b6f 2e69 6e66 6f2c 2020  : libfko.info,  \n-00010150: 4e6f 6465 3a20 4c69 6272 6172 7920 436f  Node: Library Co\n-00010160: 7079 696e 672c 2020 4e65 7874 3a20 436f  pying,  Next: Co\n-00010170: 6e63 6570 7420 496e 6465 782c 2020 5072  ncept Index,  Pr\n-00010180: 6576 3a20 5573 696e 6720 6c69 6266 6b6f  ev: Using libfko\n-00010190: 2c20 2055 703a 2054 6f70 0a0a 4170 7065  ,  Up: Top..Appe\n-000101a0: 6e64 6978 2041 2047 4e55 2047 454e 4552  ndix A GNU GENER\n-000101b0: 414c 2050 5542 4c49 4320 4c49 4345 4e53  AL PUBLIC LICENS\n-000101c0: 450a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  E.**************\n+0000b8b0: 3d0a 0a54 6869 7320 7365 6374 696f 6e20  =..This section \n+0000b8c0: 6465 7363 7269 6265 7320 7468 6520 6675  describes the fu\n+0000b8d0: 6e63 7469 6f6e 7320 6e6f 7420 636f 7665  nctions not cove\n+0000b8e0: 7265 6420 656c 7365 7768 6572 6520 696e  red elsewhere in\n+0000b8f0: 2074 6869 730a 6d61 6e75 616c 2e20 2054   this.manual.  T\n+0000b900: 6865 7365 2061 7265 2075 7469 6c69 7479  hese are utility\n+0000b910: 2066 756e 6374 696f 6e73 2074 6861 7420   functions that \n+0000b920: 6f70 6572 6174 6520 6f6e 2074 6865 2064  operate on the d\n+0000b930: 6174 6120 696e 2074 6865 2066 6b6f 0a63  ata in the fko.c\n+0000b940: 6f6e 7465 7874 2e20 2041 6c6c 2062 7574  ontext.  All but\n+0000b950: 2027 666b 6f5f 7370 615f 6461 7461 5f66   'fko_spa_data_f\n+0000b960: 696e 616c 2720 6172 6520 6361 6c6c 6564  inal' are called\n+0000b970: 2062 7920 6f74 6865 7220 6675 6e63 7469   by other functi\n+0000b980: 6f6e 7320 616e 640a 6172 6520 6e6f 7420  ons and.are not \n+0000b990: 6e6f 726d 616c 6c79 2065 7870 6c69 6369  normally explici\n+0000b9a0: 746c 7920 6361 6c6c 6564 2062 7920 7468  tly called by th\n+0000b9b0: 6520 7573 6572 2e20 2048 6f77 6576 6572  e user.  However\n+0000b9c0: 2c20 7468 6579 2063 616e 2062 652c 0a73  , they can be,.s\n+0000b9d0: 6f20 7468 6579 2061 7265 206c 6973 7465  o they are liste\n+0000b9e0: 6420 6865 7265 2e0a 0a20 2020 416c 6c20  d here...   All \n+0000b9f0: 6f66 2074 6865 7365 2066 756e 6374 696f  of these functio\n+0000ba00: 6e73 2072 6574 7572 6e20 616e 2069 6e74  ns return an int\n+0000ba10: 6567 6572 2072 6570 7265 7365 6e74 696e  eger representin\n+0000ba20: 6720 7468 6520 7265 7475 726e 0a73 7461  g the return.sta\n+0000ba30: 7475 7320 6f66 2074 6865 2066 756e 6374  tus of the funct\n+0000ba40: 696f 6e2e 2020 5768 656e 2073 7563 6365  ion.  When succe\n+0000ba50: 7366 756c 6c2c 2074 6865 7920 7769 6c6c  sfull, they will\n+0000ba60: 2072 6574 7572 6e0a 2746 4b4f 5f53 5543   return.'FKO_SUC\n+0000ba70: 4345 5353 272e 2020 4f74 6865 7277 6973  CESS'.  Otherwis\n+0000ba80: 652c 2061 6e20 6572 726f 7220 636f 6465  e, an error code\n+0000ba90: 2076 616c 7565 2069 7320 7265 7475 726e   value is return\n+0000baa0: 6564 2e0a 0a20 2d2d 2046 756e 6374 696f  ed... -- Functio\n+0000bab0: 6e3a 2069 6e74 2066 6b6f 5f73 7061 5f64  n: int fko_spa_d\n+0000bac0: 6174 615f 6669 6e61 6c20 2866 6b6f 5f63  ata_final (fko_c\n+0000bad0: 7478 5f74 2043 5458 2c20 6368 6172 202a  tx_t CTX, char *\n+0000bae0: 454e 435f 4b45 592c 2069 6e74 0a20 2020  ENC_KEY, int.   \n+0000baf0: 2020 2020 2020 204b 454e 5f4c 454e 2c20         KEN_LEN, \n+0000bb00: 6368 6172 202a 484d 4143 5f4b 4559 2c20  char *HMAC_KEY, \n+0000bb10: 696e 7420 484d 4143 5f4b 4559 5f4c 454e  int HMAC_KEY_LEN\n+0000bb20: 293b 0a20 2020 2020 5468 6973 2066 756e  );.     This fun\n+0000bb30: 6374 696f 6e20 6973 2074 6865 2066 696e  ction is the fin\n+0000bb40: 616c 2073 7465 7020 696e 2063 7265 6174  al step in creat\n+0000bb50: 696e 6720 6120 636f 6d70 6c65 7465 2065  ing a complete e\n+0000bb60: 6e63 7279 7074 6564 0a20 2020 2020 5350  ncrypted.     SP\n+0000bb70: 4120 6461 7461 2073 7472 696e 6720 7375  A data string su\n+0000bb80: 6974 6162 6c65 2066 6f72 2074 7261 6e73  itable for trans\n+0000bb90: 6d69 7373 696f 6e20 746f 2061 6e20 6677  mission to an fw\n+0000bba0: 6b6e 6f70 2073 6572 7665 722e 2020 4974  knop server.  It\n+0000bbb0: 0a20 2020 2020 646f 6573 2072 6571 7569  .     does requi\n+0000bbc0: 7265 2061 6c6c 206f 6620 7468 6520 7265  re all of the re\n+0000bbd0: 7175 6973 6974 6520 5350 4120 6461 7461  quisite SPA data\n+0000bbe0: 2066 6965 6c64 7320 6265 2073 6574 2c20   fields be set, \n+0000bbf0: 6f74 6865 7277 6973 650a 2020 2020 2069  otherwise.     i\n+0000bc00: 7420 7769 6c6c 2066 6169 6c20 7769 7468  t will fail with\n+0000bc10: 2061 6e20 6170 7072 6f70 7269 6174 6520   an appropriate \n+0000bc20: 6572 726f 7220 636f 6465 2e0a 0a20 2d2d  error code... --\n+0000bc30: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f\n+0000bc40: 6b6f 5f64 6563 7279 7074 5f73 7061 5f64  ko_decrypt_spa_d\n+0000bc50: 6174 6120 2866 6b6f 5f63 7478 5f74 2043  ata (fko_ctx_t C\n+0000bc60: 5458 2c20 6368 6172 202a 4445 435f 4b45  TX, char *DEC_KE\n+0000bc70: 592c 0a20 2020 2020 2020 2020 2069 6e74  Y,.          int\n+0000bc80: 204b 4559 5f4c 454e 293b 0a20 2020 2020   KEY_LEN);.     \n+0000bc90: 5768 656e 2067 6976 656e 2074 6865 2063  When given the c\n+0000bca0: 6f72 7265 6374 204b 4559 2028 7061 7373  orrect KEY (pass\n+0000bcb0: 776f 7264 292c 2074 6869 7320 6675 6e63  word), this func\n+0000bcc0: 7469 6f6e 2064 6563 7279 7074 732c 0a20  tion decrypts,. \n+0000bcd0: 2020 2020 6465 636f 6465 732c 2061 6e64      decodes, and\n+0000bce0: 2070 6172 7365 7320 7468 6520 656e 6372   parses the encr\n+0000bcf0: 7970 7465 6420 5350 4120 6461 7461 2074  ypted SPA data t\n+0000bd00: 6861 7420 7761 7320 7375 7070 6c69 6564  hat was supplied\n+0000bd10: 2074 6f20 7468 650a 2020 2020 2063 6f6e   to the.     con\n+0000bd20: 7465 7874 2076 6961 2074 6865 2027 666b  text via the 'fk\n+0000bd30: 6f5f 6e65 775f 7769 7468 5f64 6174 6127  o_new_with_data'\n+0000bd40: 2066 756e 6374 696f 6e20 7468 6174 2077   function that w\n+0000bd50: 6173 2061 6c73 6f20 6361 6c6c 6564 0a20  as also called. \n+0000bd60: 2020 2020 7769 7468 6f75 7420 7468 6520      without the \n+0000bd70: 4b45 5920 7661 6c75 652e 2020 4f6e 6365  KEY value.  Once\n+0000bd80: 2074 6865 2064 6174 6120 6973 2064 6563   the data is dec\n+0000bd90: 7279 7074 6564 2c20 7468 6973 2066 756e  rypted, this fun\n+0000bda0: 6374 696f 6e0a 2020 2020 2077 696c 6c20  ction.     will \n+0000bdb0: 616c 736f 2063 616c 6c20 2766 6b6f 5f64  also call 'fko_d\n+0000bdc0: 6563 6f64 655f 7370 615f 6461 7461 2720  ecode_spa_data' \n+0000bdd0: 746f 2064 6563 6f64 652c 2070 6172 7365  to decode, parse\n+0000bde0: 2c20 7661 6c69 6461 7465 2c0a 2020 2020  , validate,.    \n+0000bdf0: 2061 6e64 2073 746f 7265 2074 6865 2064   and store the d\n+0000be00: 6174 6120 6669 656c 6473 2069 6e20 7468  ata fields in th\n+0000be10: 6520 636f 6e74 6578 7420 666f 7220 6c61  e context for la\n+0000be20: 7465 7220 7265 7472 6965 7661 6c2e 0a0a  ter retrieval...\n+0000be30: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in\n+0000be40: 7420 666b 6f5f 656e 6372 7970 745f 7370  t fko_encrypt_sp\n+0000be50: 615f 6461 7461 2028 666b 6f5f 6374 785f  a_data (fko_ctx_\n+0000be60: 7420 4354 582c 2063 6861 7220 2a45 4e43  t CTX, char *ENC\n+0000be70: 5f4b 4559 2c0a 2020 2020 2020 2020 2020  _KEY,.          \n+0000be80: 696e 7420 4b45 595f 4c45 4e29 3b0a 2020  int KEY_LEN);.  \n+0000be90: 2020 2045 6e63 7279 7074 7320 7468 6520     Encrypts the \n+0000bea0: 696e 7465 726d 6564 6961 7465 2065 6e63  intermediate enc\n+0000beb0: 6f64 6564 2053 5041 2064 6174 6120 7374  oded SPA data st\n+0000bec0: 6f72 6564 2069 6e20 7468 6520 636f 6e74  ored in the cont\n+0000bed0: 6578 742e 0a20 2020 2020 5468 6973 2066  ext..     This f\n+0000bee0: 756e 6374 696f 6e20 7769 6c6c 2063 616c  unction will cal\n+0000bef0: 6c20 2766 6b6f 5f65 6e63 6f64 6527 2069  l 'fko_encode' i\n+0000bf00: 6620 6e65 6365 7373 6172 792e 2020 4974  f necessary.  It\n+0000bf10: 2069 7320 6e6f 726d 616c 6c79 0a20 2020   is normally.   \n+0000bf20: 2020 6e6f 7420 6361 6c6c 6564 2064 6972    not called dir\n+0000bf30: 6563 746c 7920 6173 2069 7420 6973 2063  ectly as it is c\n+0000bf40: 616c 6c65 6420 6672 6f6d 2027 666b 6f5f  alled from 'fko_\n+0000bf50: 7370 615f 6461 7461 5f66 696e 616c 272e  spa_data_final'.\n+0000bf60: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: \n+0000bf70: 696e 7420 666b 6f5f 6465 636f 6465 5f73  int fko_decode_s\n+0000bf80: 7061 5f64 6174 6120 2866 6b6f 5f63 7478  pa_data (fko_ctx\n+0000bf90: 5f74 2043 5458 293b 0a20 2020 2020 5468  _t CTX);.     Th\n+0000bfa0: 6973 2066 756e 6374 696f 6e20 7065 7266  is function perf\n+0000bfb0: 6f72 6d73 2074 6865 2064 6563 6f64 696e  orms the decodin\n+0000bfc0: 672c 2070 6172 7369 6e67 2c20 7661 6c69  g, parsing, vali\n+0000bfd0: 6461 7469 6f6e 206f 6620 7468 6520 5350  dation of the SP\n+0000bfe0: 410a 2020 2020 2064 6174 6120 7468 6174  A.     data that\n+0000bff0: 2077 6173 206a 7573 7420 6465 6372 7970   was just decryp\n+0000c000: 7465 642e 2020 4974 2069 7320 6e6f 726d  ted.  It is norm\n+0000c010: 616c 6c79 206e 6f74 2063 616c 6c65 6420  ally not called \n+0000c020: 6469 7265 6374 6c79 0a20 2020 2020 6173  directly.     as\n+0000c030: 2069 7420 6973 2063 616c 6c65 6420 6672   it is called fr\n+0000c040: 6f6d 2027 666b 6f5f 6465 6372 7970 745f  om 'fko_decrypt_\n+0000c050: 7370 615f 6461 7461 2720 2877 6869 6368  spa_data' (which\n+0000c060: 2069 7320 696e 2074 7572 6e0a 2020 2020   is in turn.    \n+0000c070: 2063 616c 6c65 6420 6672 6f6d 2027 666b   called from 'fk\n+0000c080: 6f5f 6e65 775f 7769 7468 5f64 6174 6127  o_new_with_data'\n+0000c090: 2069 6620 6120 7061 7373 776f 7264 2069   if a password i\n+0000c0a0: 7320 7375 7070 6c69 6564 2074 6f20 6974  s supplied to it\n+0000c0b0: 292e 0a0a 202d 2d20 4675 6e63 7469 6f6e  )... -- Function\n+0000c0c0: 3a20 696e 7420 666b 6f5f 656e 636f 6465  : int fko_encode\n+0000c0d0: 5f73 7061 5f64 6174 6120 2866 6b6f 5f63  _spa_data (fko_c\n+0000c0e0: 7478 5f74 2043 5458 293b 0a20 2020 2020  tx_t CTX);.     \n+0000c0f0: 5065 7266 6f72 6d73 2074 6865 2062 6173  Performs the bas\n+0000c100: 6536 3420 656e 636f 6469 6e67 206f 6620  e64 encoding of \n+0000c110: 7468 6f73 6520 5350 4120 6461 7461 2066  those SPA data f\n+0000c120: 6965 6c64 7320 7468 6174 206e 6565 6420  ields that need \n+0000c130: 746f 0a20 2020 2020 6265 2065 6e63 6f64  to.     be encod\n+0000c140: 6564 2c20 7065 7266 6f72 6d73 2073 6f6d  ed, performs som\n+0000c150: 6520 6461 7461 2076 616c 6964 6174 696f  e data validatio\n+0000c160: 6e2c 2061 6e64 2063 616c 6c73 0a20 2020  n, and calls.   \n+0000c170: 2020 2766 6b70 5f73 6574 5f73 7061 5f64    'fkp_set_spa_d\n+0000c180: 6967 6573 7427 2074 6f20 7265 636f 6d70  igest' to recomp\n+0000c190: 7574 6520 7468 6520 5350 4120 6d65 7373  ute the SPA mess\n+0000c1a0: 6167 6520 6469 6765 7374 2e20 2049 7420  age digest.  It \n+0000c1b0: 6973 0a20 2020 2020 6e6f 726d 616c 6c79  is.     normally\n+0000c1c0: 206e 6f74 2063 616c 6c65 6420 6469 7265   not called dire\n+0000c1d0: 6374 6c79 2061 7320 6974 2069 7320 6361  ctly as it is ca\n+0000c1e0: 6c6c 6564 2066 726f 6d0a 2020 2020 2027  lled from.     '\n+0000c1f0: 666b 6f5f 656e 6372 7970 745f 7370 615f  fko_encrypt_spa_\n+0000c200: 6461 7461 2720 2877 6869 6368 2069 7320  data' (which is \n+0000c210: 696e 2074 7572 6e20 6361 6c6c 6564 2066  in turn called f\n+0000c220: 726f 6d0a 2020 2020 2027 666b 6f5f 7370  rom.     'fko_sp\n+0000c230: 615f 6461 7461 5f66 696e 616c 2729 2e0a  a_data_final')..\n+0000c240: 0a5f 4750 472d 7370 6563 6966 6963 2075  ._GPG-specific u\n+0000c250: 7469 6c69 7479 2066 756e 6374 696f 6e73  tility functions\n+0000c260: 3a5f 0a0a 202d 2d20 4675 6e63 7469 6f6e  :_.. -- Function\n+0000c270: 3a20 696e 7420 666b 6f5f 6770 675f 7369  : int fko_gpg_si\n+0000c280: 676e 6174 7572 655f 6964 5f6d 6174 6368  gnature_id_match\n+0000c290: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,\n+0000c2a0: 2063 6f6e 7374 2063 6861 720a 2020 2020   const char.    \n+0000c2b0: 2020 2020 2020 2a49 442c 2075 6e73 6967        *ID, unsig\n+0000c2c0: 6e65 6420 6368 6172 202a 4944 5f4d 4154  ned char *ID_MAT\n+0000c2d0: 4348 293b 0a20 2020 2020 5365 7473 2074  CH);.     Sets t\n+0000c2e0: 6865 2076 616c 7565 206f 6620 7468 6520  he value of the \n+0000c2f0: 4944 5f4d 4154 4348 2076 6172 6961 626c  ID_MATCH variabl\n+0000c300: 6520 746f 2074 7275 6520 2831 2920 6966  e to true (1) if\n+0000c310: 2074 6865 2076 616c 7565 206f 660a 2020   the value of.  \n+0000c320: 2020 2049 4420 6d61 7463 6865 7320 7468     ID matches th\n+0000c330: 6520 4944 206f 6620 7468 6520 4750 4720  e ID of the GPG \n+0000c340: 7369 676e 6174 7572 6520 6173 736f 6369  signature associ\n+0000c350: 6174 6564 2077 6974 6820 7468 6520 6375  ated with the cu\n+0000c360: 7272 656e 740a 2020 2020 2063 6f6e 7465  rrent.     conte\n+0000c370: 7874 2e20 204f 7468 6572 7769 7365 2c20  xt.  Otherwise, \n+0000c380: 4944 5f4d 4154 4348 2069 7320 7365 7420  ID_MATCH is set \n+0000c390: 746f 2066 616c 7365 2028 3029 2e20 2054  to false (0).  T\n+0000c3a0: 6865 2072 6574 7572 6e0a 2020 2020 2076  he return.     v\n+0000c3b0: 616c 7565 2069 7320 616e 2046 4b4f 2065  alue is an FKO e\n+0000c3c0: 7272 6f72 2073 7461 7475 732e 0a0a 202d  rror status... -\n+0000c3d0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int \n+0000c3e0: 666b 6f5f 6770 675f 7369 676e 6174 7572  fko_gpg_signatur\n+0000c3f0: 655f 6670 725f 6d61 7463 6820 2866 6b6f  e_fpr_match (fko\n+0000c400: 5f63 7478 5f74 2043 5458 2c20 636f 6e73  _ctx_t CTX, cons\n+0000c410: 7420 6368 6172 0a20 2020 2020 2020 2020  t char.         \n+0000c420: 202a 4650 522c 2075 6e73 6967 6e65 6420   *FPR, unsigned \n+0000c430: 6368 6172 202a 4650 525f 4d41 5443 4829  char *FPR_MATCH)\n+0000c440: 3b0a 2020 2020 2053 6574 7320 7468 6520  ;.     Sets the \n+0000c450: 7661 6c75 6520 6f66 2074 6865 2046 5052  value of the FPR\n+0000c460: 5f4d 4154 4348 2076 6172 6961 626c 6520  _MATCH variable \n+0000c470: 746f 2074 7275 6520 2831 2920 6966 2074  to true (1) if t\n+0000c480: 6865 2076 616c 7565 0a20 2020 2020 6f66  he value.     of\n+0000c490: 2046 5052 206d 6174 6368 6573 2074 6865   FPR matches the\n+0000c4a0: 2066 696e 6765 7270 7269 6e74 206f 6620   fingerprint of \n+0000c4b0: 7468 6520 4750 4720 7369 676e 6174 7572  the GPG signatur\n+0000c4c0: 6520 6173 736f 6369 6174 6564 2077 6974  e associated wit\n+0000c4d0: 680a 2020 2020 2074 6865 2063 7572 7265  h.     the curre\n+0000c4e0: 6e74 2063 6f6e 7465 7874 2e20 204f 7468  nt context.  Oth\n+0000c4f0: 6572 7769 7365 2c20 4650 525f 4d41 5443  erwise, FPR_MATC\n+0000c500: 4820 6973 2073 6574 2074 6f20 6661 6c73  H is set to fals\n+0000c510: 6520 2830 292e 0a20 2020 2020 5468 6520  e (0)..     The \n+0000c520: 7265 7475 726e 2076 616c 7565 2069 7320  return value is \n+0000c530: 616e 2046 4b4f 2065 7272 6f72 2073 7461  an FKO error sta\n+0000c540: 7475 732e 0a0a 1f0a 4669 6c65 3a20 6c69  tus.....File: li\n+0000c550: 6266 6b6f 2e69 6e66 6f2c 2020 4e6f 6465  bfko.info,  Node\n+0000c560: 3a20 4572 726f 7220 4861 6e64 6c69 6e67  : Error Handling\n+0000c570: 2c20 2050 7265 763a 2055 7469 6c69 7479  ,  Prev: Utility\n+0000c580: 2046 756e 6374 696f 6e73 2c20 2055 703a   Functions,  Up:\n+0000c590: 2055 7369 6e67 206c 6962 666b 6f0a 0a33   Using libfko..3\n+0000c5a0: 2e37 2045 7272 6f72 2048 616e 646c 696e  .7 Error Handlin\n+0000c5b0: 670a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  g.==============\n+0000c5c0: 3d3d 3d3d 0a0a 4d6f 7374 2066 6b6f 2066  ====..Most fko f\n+0000c5d0: 756e 6374 696f 6e73 2072 6574 7572 6e20  unctions return \n+0000c5e0: 616e 2069 6e74 6567 6572 2076 616c 7565  an integer value\n+0000c5f0: 2074 6861 7420 636f 7272 6573 706f 6e64   that correspond\n+0000c600: 7320 746f 2065 6974 6865 720a 7375 6363  s to either.succ\n+0000c610: 6573 7320 2830 292c 206f 7220 6f6e 6520  ess (0), or one \n+0000c620: 6f66 2074 6865 206e 6f6e 2d7a 6572 6f20  of the non-zero \n+0000c630: 7661 6c75 6573 2074 6861 7220 636f 7272  values thar corr\n+0000c640: 6573 706f 6e64 7320 746f 2061 206e 756d  esponds to a num\n+0000c650: 6265 720a 6f66 2070 6f73 7369 626c 6520  ber.of possible \n+0000c660: 6572 726f 7273 2e20 206c 6962 666b 6f20  errors.  libfko \n+0000c670: 7072 6f76 6964 6573 2061 2066 756e 6374  provides a funct\n+0000c680: 696f 6e20 746f 2067 6574 2061 2064 6573  ion to get a des\n+0000c690: 6372 6970 7469 7665 0a73 7472 696e 6720  criptive.string \n+0000c6a0: 666f 7220 7468 6520 6769 7665 6e20 6572  for the given er\n+0000c6b0: 726f 7220 636f 6465 2e0a 0a20 2d2d 2046  ror code... -- F\n+0000c6c0: 756e 6374 696f 6e3a 2063 6f6e 7374 2063  unction: const c\n+0000c6d0: 6861 7220 2a20 666b 6f5f 6572 7273 7472  har * fko_errstr\n+0000c6e0: 2028 696e 7420 4552 525f 434f 4445 290a   (int ERR_CODE).\n+0000c6f0: 2020 2020 2054 6865 2066 756e 6374 696f       The functio\n+0000c700: 6e20 2766 6b6f 5f65 7272 7374 7227 2072  n 'fko_errstr' r\n+0000c710: 6574 7572 6e73 2061 2070 6f69 6e74 6572  eturns a pointer\n+0000c720: 2074 6f20 6120 7374 6174 6963 616c 6c79   to a statically\n+0000c730: 0a20 2020 2020 616c 6c6f 6361 7465 6420  .     allocated \n+0000c740: 7374 7269 6e67 2063 6f6e 7461 696e 696e  string containin\n+0000c750: 6720 7468 6520 6465 7363 7269 7074 696f  g the descriptio\n+0000c760: 6e20 6f66 2074 6865 2065 7272 6f72 2e0a  n of the error..\n+0000c770: 0a54 6865 206c 6973 7420 6f66 2074 6865  .The list of the\n+0000c780: 2070 6f73 7369 626c 6520 6572 726f 7220   possible error \n+0000c790: 636f 6465 7320 616e 6420 7468 6569 7220  codes and their \n+0000c7a0: 636f 7272 6573 706f 6e64 696e 670a 6465  corresponding.de\n+0000c7b0: 7363 7269 7074 696f 6e73 2061 7320 7265  scriptions as re\n+0000c7c0: 7475 726e 6564 2062 7920 2766 6b6f 5f65  turned by 'fko_e\n+0000c7d0: 7272 7374 7227 2066 6f6c 6c6f 7773 3a0a  rrstr' follows:.\n+0000c7e0: 0a20 2d2d 2056 6172 6961 626c 653a 2069  . -- Variable: i\n+0000c7f0: 6e74 2065 7272 6f72 5f63 6f64 650a 2020  nt error_code.  \n+0000c800: 2020 2027 464b 4f5f 5355 4343 4553 5327     'FKO_SUCCESS'\n+0000c810: 0a20 2020 2020 2020 2020 2053 7563 6365  .          Succe\n+0000c820: 7373 0a20 2020 2020 2746 4b4f 5f45 5252  ss.     'FKO_ERR\n+0000c830: 4f52 5f43 5458 5f4e 4f54 5f49 4e49 5449  OR_CTX_NOT_INITI\n+0000c840: 414c 495a 4544 270a 2020 2020 2020 2020  ALIZED'.        \n+0000c850: 2020 464b 4f20 436f 6e74 6578 7420 6973    FKO Context is\n+0000c860: 206e 6f74 2069 6e69 7469 616c 697a 6564   not initialized\n+0000c870: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n+0000c880: 5f4d 454d 4f52 595f 414c 4c4f 4341 5449  _MEMORY_ALLOCATI\n+0000c890: 4f4e 270a 2020 2020 2020 2020 2020 556e  ON'.          Un\n+0000c8a0: 6162 6c65 2074 6f20 616c 6c6f 6361 7465  able to allocate\n+0000c8b0: 206d 656d 6f72 790a 2020 2020 2027 464b   memory.     'FK\n+0000c8c0: 4f5f 4552 524f 525f 4649 4c45 5359 5354  O_ERROR_FILESYST\n+0000c8d0: 454d 5f4f 5045 5241 5449 4f4e 270a 2020  EM_OPERATION'.  \n+0000c8e0: 2020 2020 2020 2020 5265 6164 2f77 7269          Read/wri\n+0000c8f0: 7465 2062 7974 6573 206d 6973 6d61 7463  te bytes mismatc\n+0000c900: 680a 2020 2020 2027 464b 4f5f 4552 524f  h.     'FKO_ERRO\n+0000c910: 525f 494e 5641 4c49 445f 4441 5441 270a  R_INVALID_DATA'.\n+0000c920: 2020 2020 2020 2020 2020 4172 6773 2063            Args c\n+0000c930: 6f6e 7461 696e 2069 6e76 616c 6964 2064  ontain invalid d\n+0000c940: 6174 610a 2020 2020 2027 464b 4f5f 4552  ata.     'FKO_ER\n+0000c950: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n+0000c960: 5f43 4c49 454e 545f 5449 4d45 4f55 545f  _CLIENT_TIMEOUT_\n+0000c970: 4e45 4741 5449 5645 270a 2020 2020 2020  NEGATIVE'.      \n+0000c980: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n+0000c990: 3a20 6e65 6761 7469 7665 2074 696d 656f  : negative timeo\n+0000c9a0: 7574 2076 616c 7565 0a20 2020 2020 2746  ut value.     'F\n+0000c9b0: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n+0000c9c0: 5f44 4154 415f 4445 434f 4445 5f4d 5347  _DATA_DECODE_MSG\n+0000c9d0: 4c45 4e5f 5641 4c49 4446 4149 4c27 0a20  LEN_VALIDFAIL'. \n+0000c9e0: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n+0000c9f0: 2064 6174 613a 2069 6e76 616c 6964 206d   data: invalid m\n+0000ca00: 6573 7361 6765 206c 656e 6774 680a 2020  essage length.  \n+0000ca10: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n+0000ca20: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD\n+0000ca30: 455f 4e4f 4e5f 4153 4349 4927 0a20 2020  E_NON_ASCII'.   \n+0000ca40: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d\n+0000ca50: 6174 613a 2063 6f6e 7461 696e 7320 6e6f  ata: contains no\n+0000ca60: 6e2d 6173 6369 6920 6368 6172 6163 7465  n-ascii characte\n+0000ca70: 7273 0a20 2020 2020 2746 4b4f 5f45 5252  rs.     'FKO_ERR\n+0000ca80: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_\n+0000ca90: 4445 434f 4445 5f4c 545f 4d49 4e5f 4649  DECODE_LT_MIN_FI\n+0000caa0: 454c 4453 270a 2020 2020 2020 2020 2020  ELDS'.          \n+0000cab0: 496e 7661 6c69 6420 6461 7461 3a20 696e  Invalid data: in\n+0000cac0: 7375 6666 6963 6965 6e74 206e 756d 6265  sufficient numbe\n+0000cad0: 7220 6f66 2064 6174 6120 6669 656c 6473  r of data fields\n+0000cae0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n+0000caf0: 5f49 4e56 414c 4944 5f44 4154 415f 4445  _INVALID_DATA_DE\n+0000cb00: 434f 4445 5f47 545f 4d41 585f 4649 454c  CODE_GT_MAX_FIEL\n+0000cb10: 4453 270a 2020 2020 2020 2020 2020 496e  DS'.          In\n+0000cb20: 7661 6c69 6420 6461 7461 3a20 746f 6f20  valid data: too \n+0000cb30: 6d61 6e79 2064 6174 6120 6669 656c 6473  many data fields\n+0000cb40: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n+0000cb50: 5f49 4e56 414c 4944 5f44 4154 415f 4445  _INVALID_DATA_DE\n+0000cb60: 434f 4445 5f57 524f 4e47 5f4e 554d 5f46  CODE_WRONG_NUM_F\n+0000cb70: 4945 4c44 5327 0a20 2020 2020 2020 2020  IELDS'.         \n+0000cb80: 2049 6e76 616c 6964 2064 6174 613a 2069   Invalid data: i\n+0000cb90: 6e76 616c 6964 206e 756d 6265 7220 6f66  nvalid number of\n+0000cba0: 2066 6965 6c64 730a 2020 2020 2027 464b   fields.     'FK\n+0000cbb0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n+0000cbc0: 4441 5441 5f44 4543 4f44 455f 454e 435f  DATA_DECODE_ENC_\n+0000cbd0: 4d53 475f 4c45 4e5f 4d54 5f54 5f53 495a  MSG_LEN_MT_T_SIZ\n+0000cbe0: 4527 0a20 2020 2020 2020 2020 2049 6e76  E'.          Inv\n+0000cbf0: 616c 6964 2064 6174 613a 2064 6563 6f64  alid data: decod\n+0000cc00: 653a 2065 6e63 6f64 6564 206d 6573 7361  e: encoded messa\n+0000cc10: 6765 202d 2064 6967 6573 7420 7369 7a65  ge - digest size\n+0000cc20: 2069 7320 6e6f 740a 2020 2020 2020 2020   is not.        \n+0000cc30: 2020 7661 6c69 640a 2020 2020 2027 464b    valid.     'FK\n+0000cc40: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n+0000cc50: 4441 5441 5f44 4543 4f44 455f 5241 4e44  DATA_DECODE_RAND\n+0000cc60: 5f4d 4953 5349 4e47 270a 2020 2020 2020  _MISSING'.      \n+0000cc70: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n+0000cc80: 3a20 6465 636f 6465 3a20 6d69 7373 696e  : decode: missin\n+0000cc90: 6720 7261 6e64 6f6d 2064 6174 610a 2020  g random data.  \n+0000cca0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n+0000ccb0: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD\n+0000ccc0: 455f 5553 4552 4e41 4d45 5f4d 4953 5349  E_USERNAME_MISSI\n+0000ccd0: 4e47 270a 2020 2020 2020 2020 2020 496e  NG'.          In\n+0000cce0: 7661 6c69 6420 6461 7461 3a20 6465 636f  valid data: deco\n+0000ccf0: 6465 3a20 6d69 7373 696e 6720 7573 6572  de: missing user\n+0000cd00: 6e61 6d65 0a20 2020 2020 2746 4b4f 5f45  name.     'FKO_E\n+0000cd10: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n+0000cd20: 415f 4445 434f 4445 5f55 5345 524e 414d  A_DECODE_USERNAM\n+0000cd30: 455f 544f 4f42 4947 270a 2020 2020 2020  E_TOOBIG'.      \n+0000cd40: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n+0000cd50: 3a20 6465 636f 6465 3a20 7573 6572 6e61  : decode: userna\n+0000cd60: 6d65 2074 6f20 6c61 7267 650a 2020 2020  me to large.    \n+0000cd70: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n+0000cd80: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_\n+0000cd90: 5553 4552 4e41 4d45 5f44 4543 4f44 4546  USERNAME_DECODEF\n+0000cda0: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I\n+0000cdb0: 6e76 616c 6964 2064 6174 613a 2064 6563  nvalid data: dec\n+0000cdc0: 6f64 653a 2066 6169 6c65 6420 746f 2064  ode: failed to d\n+0000cdd0: 6563 6f64 6520 7573 6572 6e61 6d65 0a20  ecode username. \n+0000cde0: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n+0000cdf0: 4e56 414c 4944 5f44 4154 415f 4445 434f  NVALID_DATA_DECO\n+0000ce00: 4445 5f55 5345 524e 414d 455f 5641 4c49  DE_USERNAME_VALI\n+0000ce10: 4446 4149 4c27 0a20 2020 2020 2020 2020  DFAIL'.         \n+0000ce20: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d\n+0000ce30: 6563 6f64 653a 2069 6e76 616c 6964 2075  ecode: invalid u\n+0000ce40: 7365 726e 616d 650a 2020 2020 2027 464b  sername.     'FK\n+0000ce50: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n+0000ce60: 4441 5441 5f44 4543 4f44 455f 5449 4d45  DATA_DECODE_TIME\n+0000ce70: 5354 414d 505f 4d49 5353 494e 4727 0a20  STAMP_MISSING'. \n+0000ce80: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n+0000ce90: 2064 6174 613a 2064 6563 6f64 653a 206d   data: decode: m\n+0000cea0: 6973 7369 6e67 2074 696d 6573 7461 6d70  issing timestamp\n+0000ceb0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n+0000cec0: 5f49 4e56 414c 4944 5f44 4154 415f 4445  _INVALID_DATA_DE\n+0000ced0: 434f 4445 5f54 494d 4553 5441 4d50 5f54  CODE_TIMESTAMP_T\n+0000cee0: 4f4f 4249 4727 0a20 2020 2020 2020 2020  OOBIG'.         \n+0000cef0: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d\n+0000cf00: 6563 6f64 653a 2074 696d 6573 7461 6d70  ecode: timestamp\n+0000cf10: 2074 6f6f 206c 6172 6765 0a20 2020 2020   too large.     \n+0000cf20: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n+0000cf30: 4944 5f44 4154 415f 4445 434f 4445 5f54  ID_DATA_DECODE_T\n+0000cf40: 494d 4553 5441 4d50 5f44 4543 4f44 4546  IMESTAMP_DECODEF\n+0000cf50: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I\n+0000cf60: 6e76 616c 6964 2064 6174 613a 2064 6563  nvalid data: dec\n+0000cf70: 6f64 653a 2066 6169 6c65 6420 746f 2064  ode: failed to d\n+0000cf80: 6563 6f64 6520 7469 6d65 7374 616d 700a  ecode timestamp.\n+0000cf90: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n+0000cfa0: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC\n+0000cfb0: 4f44 455f 5645 5253 494f 4e5f 4d49 5353  ODE_VERSION_MISS\n+0000cfc0: 494e 4727 0a20 2020 2020 2020 2020 2049  ING'.          I\n+0000cfd0: 6e76 616c 6964 2064 6174 613a 2064 6563  nvalid data: dec\n+0000cfe0: 6f64 653a 206d 6973 7369 6e67 2076 6572  ode: missing ver\n+0000cff0: 7369 6f6e 2064 6174 610a 2020 2020 2027  sion data.     '\n+0000d000: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n+0000d010: 445f 4441 5441 5f44 4543 4f44 455f 5645  D_DATA_DECODE_VE\n+0000d020: 5253 494f 4e5f 544f 4f42 4947 270a 2020  RSION_TOOBIG'.  \n+0000d030: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n+0000d040: 6461 7461 3a20 6465 636f 6465 3a20 7665  data: decode: ve\n+0000d050: 7273 696f 6e20 6461 7461 2069 7320 746f  rsion data is to\n+0000d060: 6f20 6c61 7267 650a 2020 2020 2027 464b  o large.     'FK\n+0000d070: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n+0000d080: 4441 5441 5f44 4543 4f44 455f 4d53 4754  DATA_DECODE_MSGT\n+0000d090: 5950 455f 4d49 5353 494e 4727 0a20 2020  YPE_MISSING'.   \n+0000d0a0: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d\n+0000d0b0: 6174 613a 2064 6563 6f64 653a 206d 6973  ata: decode: mis\n+0000d0c0: 7369 6e67 206d 6573 7361 6765 2074 7970  sing message typ\n+0000d0d0: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO\n+0000d0e0: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D\n+0000d0f0: 4543 4f44 455f 4d53 4754 5950 455f 544f  ECODE_MSGTYPE_TO\n+0000d100: 4f42 4947 270a 2020 2020 2020 2020 2020  OBIG'.          \n+0000d110: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de\n+0000d120: 636f 6465 3a20 6d65 7373 6167 6520 7479  code: message ty\n+0000d130: 7065 2069 7320 746f 6f20 6c61 7267 650a  pe is too large.\n+0000d140: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n+0000d150: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC\n+0000d160: 4f44 455f 4d53 4754 5950 455f 4445 434f  ODE_MSGTYPE_DECO\n+0000d170: 4445 4641 494c 270a 2020 2020 2020 2020  DEFAIL'.        \n+0000d180: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n+0000d190: 6465 636f 6465 3a20 6661 696c 6564 2074  decode: failed t\n+0000d1a0: 6f20 6465 636f 6465 206d 6573 7361 6765  o decode message\n+0000d1b0: 2074 7970 650a 2020 2020 2027 464b 4f5f   type.     'FKO_\n+0000d1c0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n+0000d1d0: 5441 5f44 4543 4f44 455f 4d45 5353 4147  TA_DECODE_MESSAG\n+0000d1e0: 455f 4d49 5353 494e 4727 0a20 2020 2020  E_MISSING'.     \n+0000d1f0: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat\n+0000d200: 613a 2064 6563 6f64 653a 206d 6973 7369  a: decode: missi\n+0000d210: 6e67 206d 6573 7361 6765 2064 6174 610a  ng message data.\n+0000d220: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n+0000d230: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC\n+0000d240: 4f44 455f 4d45 5353 4147 455f 544f 4f42  ODE_MESSAGE_TOOB\n+0000d250: 4947 270a 2020 2020 2020 2020 2020 496e  IG'.          In\n+0000d260: 7661 6c69 6420 6461 7461 3a20 6465 636f  valid data: deco\n+0000d270: 6465 3a20 6d65 7373 6167 6520 6461 7461  de: message data\n+0000d280: 2069 7320 746f 6f20 6c61 7267 650a 2020   is too large.  \n+0000d290: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n+0000d2a0: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD\n+0000d2b0: 455f 4d45 5353 4147 455f 4445 434f 4445  E_MESSAGE_DECODE\n+0000d2c0: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          \n+0000d2d0: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de\n+0000d2e0: 636f 6465 3a20 6661 696c 6564 2074 6f20  code: failed to \n+0000d2f0: 6465 636f 6465 206d 6573 7361 6765 2064  decode message d\n+0000d300: 6174 610a 2020 2020 2027 464b 4f5f 4552  ata.     'FKO_ER\n+0000d310: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n+0000d320: 5f44 4543 4f44 455f 4d45 5353 4147 455f  _DECODE_MESSAGE_\n+0000d330: 5641 4c49 4446 4149 4c27 0a20 2020 2020  VALIDFAIL'.     \n+0000d340: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat\n+0000d350: 613a 2064 6563 6f64 653a 2069 6e76 616c  a: decode: inval\n+0000d360: 6964 206d 6573 7361 6765 2064 6174 610a  id message data.\n+0000d370: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n+0000d380: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC\n+0000d390: 4f44 455f 4143 4345 5353 5f56 414c 4944  ODE_ACCESS_VALID\n+0000d3a0: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          \n+0000d3b0: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de\n+0000d3c0: 636f 6465 3a20 696e 766c 6961 6420 6163  code: invliad ac\n+0000d3d0: 6365 7373 2064 6174 610a 2020 2020 2027  cess data.     '\n+0000d3e0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n+0000d3f0: 445f 4441 5441 5f44 4543 4f44 455f 4e41  D_DATA_DECODE_NA\n+0000d400: 5441 4343 4553 535f 4d49 5353 494e 4727  TACCESS_MISSING'\n+0000d410: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n+0000d420: 6964 2064 6174 613a 2064 6563 6f64 653a  id data: decode:\n+0000d430: 206d 6973 7369 6e67 204e 4154 2061 6363   missing NAT acc\n+0000d440: 6573 7320 6461 7461 0a20 2020 2020 2746  ess data.     'F\n+0000d450: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n+0000d460: 5f44 4154 415f 4445 434f 4445 5f4e 4154  _DATA_DECODE_NAT\n+0000d470: 4143 4345 5353 5f54 4f4f 4249 4727 0a20  ACCESS_TOOBIG'. \n+0000d480: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n+0000d490: 2064 6174 613a 2064 6563 6f64 653a 204e   data: decode: N\n+0000d4a0: 4154 2061 6363 6573 7320 6461 7461 2069  AT access data i\n+0000d4b0: 7320 746f 6f20 6c61 7267 650a 2020 2020  s too large.    \n+0000d4c0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n+0000d4d0: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_\n+0000d4e0: 4e41 5441 4343 4553 535f 4445 434f 4445  NATACCESS_DECODE\n+0000d4f0: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          \n+0000d500: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de\n+0000d510: 636f 6465 3a20 6661 696c 6564 2074 6f20  code: failed to \n+0000d520: 6465 636f 6465 204e 4154 2061 6363 6573  decode NAT acces\n+0000d530: 7320 6461 7461 0a20 2020 2020 2746 4b4f  s data.     'FKO\n+0000d540: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n+0000d550: 4154 415f 4445 434f 4445 5f4e 4154 4143  ATA_DECODE_NATAC\n+0000d560: 4345 5353 5f56 414c 4944 4641 494c 270a  CESS_VALIDFAIL'.\n+0000d570: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n+0000d580: 6420 6461 7461 3a20 6465 636f 6465 3a20  d data: decode: \n+0000d590: 696e 7661 6c69 6420 4e41 5420 6163 6365  invalid NAT acce\n+0000d5a0: 7373 0a20 2020 2020 2746 4b4f 5f45 5252  ss.     'FKO_ERR\n+0000d5b0: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_\n+0000d5c0: 4445 434f 4445 5f53 5256 4155 5448 5f4d  DECODE_SRVAUTH_M\n+0000d5d0: 4953 5349 4e47 270a 2020 2020 2020 2020  ISSING'.        \n+0000d5e0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n+0000d5f0: 6465 636f 6465 3a20 6d69 7373 696e 6720  decode: missing \n+0000d600: 7365 7276 6572 2061 7574 680a 2020 2020  server auth.    \n+0000d610: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n+0000d620: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_\n+0000d630: 5352 5641 5554 485f 4445 434f 4445 4641  SRVAUTH_DECODEFA\n+0000d640: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In\n+0000d650: 7661 6c69 6420 6461 7461 3a20 6465 636f  valid data: deco\n+0000d660: 6465 3a20 7365 7276 6572 2061 7574 6820  de: server auth \n+0000d670: 6465 636f 6465 2066 6169 6c0a 2020 2020  decode fail.    \n+0000d680: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n+0000d690: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_\n+0000d6a0: 5350 415f 4558 5452 415f 544f 4f42 4947  SPA_EXTRA_TOOBIG\n+0000d6b0: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva\n+0000d6c0: 6c69 6420 6461 7461 3a20 6465 636f 6465  lid data: decode\n+0000d6d0: 3a20 5350 4120 6578 7472 6120 746f 6f20  : SPA extra too \n+0000d6e0: 6c61 7267 650a 2020 2020 2027 464b 4f5f  large.     'FKO_\n+0000d6f0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n+0000d700: 5441 5f44 4543 4f44 455f 4558 5452 415f  TA_DECODE_EXTRA_\n+0000d710: 544f 4f42 4947 270a 2020 2020 2020 2020  TOOBIG'.        \n+0000d720: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n+0000d730: 6465 636f 6465 3a20 6578 7472 6120 746f  decode: extra to\n+0000d740: 6f20 6c61 7267 650a 2020 2020 2027 464b  o large.     'FK\n+0000d750: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n+0000d760: 4441 5441 5f44 4543 4f44 455f 4558 5452  DATA_DECODE_EXTR\n+0000d770: 415f 4445 434f 4445 4641 494c 270a 2020  A_DECODEFAIL'.  \n+0000d780: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n+0000d790: 6461 7461 3a20 6465 636f 6465 3a20 6578  data: decode: ex\n+0000d7a0: 7472 6120 6465 636f 6465 2066 6169 6c65  tra decode faile\n+0000d7b0: 640a 2020 2020 2027 464b 4f5f 4552 524f  d.     'FKO_ERRO\n+0000d7c0: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D\n+0000d7d0: 4543 4f44 455f 5449 4d45 4f55 545f 4d49  ECODE_TIMEOUT_MI\n+0000d7e0: 5353 494e 4727 0a20 2020 2020 2020 2020  SSING'.         \n+0000d7f0: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d\n+0000d800: 6563 6f64 653a 206d 6973 7369 6e67 2074  ecode: missing t\n+0000d810: 696d 656f 7574 0a20 2020 2020 2746 4b4f  imeout.     'FKO\n+0000d820: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n+0000d830: 4154 415f 4445 434f 4445 5f54 494d 454f  ATA_DECODE_TIMEO\n+0000d840: 5554 5f54 4f4f 4249 4727 0a20 2020 2020  UT_TOOBIG'.     \n+0000d850: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat\n+0000d860: 613a 2064 6563 6f64 6520 7469 6d65 6f75  a: decode timeou\n+0000d870: 7420 7661 6c75 6520 6973 2074 6f6f 206c  t value is too l\n+0000d880: 6172 6765 0a20 2020 2020 2746 4b4f 5f45  arge.     'FKO_E\n+0000d890: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n+0000d8a0: 415f 4445 434f 4445 5f54 494d 454f 5554  A_DECODE_TIMEOUT\n+0000d8b0: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    \n+0000d8c0: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n+0000d8d0: 7461 3a20 6465 636f 6465 2069 6e76 616c  ta: decode inval\n+0000d8e0: 6964 2074 696d 656f 7574 0a20 2020 2020  id timeout.     \n+0000d8f0: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n+0000d900: 4944 5f44 4154 415f 4445 434f 4445 5f54  ID_DATA_DECODE_T\n+0000d910: 494d 454f 5554 5f44 4543 4f44 4546 4149  IMEOUT_DECODEFAI\n+0000d920: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv\n+0000d930: 616c 6964 2064 6174 613a 2064 6563 6f64  alid data: decod\n+0000d940: 653a 2074 696d 656f 7574 2064 6563 6f64  e: timeout decod\n+0000d950: 6520 6661 696c 6564 0a20 2020 2020 2746  e failed.     'F\n+0000d960: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n+0000d970: 5f44 4154 415f 454e 434f 4445 5f4d 4553  _DATA_ENCODE_MES\n+0000d980: 5341 4745 5f54 4f4f 4249 4727 0a20 2020  SAGE_TOOBIG'.   \n+0000d990: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d\n+0000d9a0: 6174 613a 2065 6e63 6f64 653a 206d 6573  ata: encode: mes\n+0000d9b0: 7361 6765 2069 7320 746f 6f20 6c61 7267  sage is too larg\n+0000d9c0: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO\n+0000d9d0: 525f 494e 5641 4c49 445f 4441 5441 5f45  R_INVALID_DATA_E\n+0000d9e0: 4e43 4f44 455f 4d53 474c 454e 5f56 414c  NCODE_MSGLEN_VAL\n+0000d9f0: 4944 4641 494c 270a 2020 2020 2020 2020  IDFAIL'.        \n+0000da00: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n+0000da10: 656e 636f 6465 3a20 696e 7661 6c69 6420  encode: invalid \n+0000da20: 6d65 7373 6167 6520 6c65 6e67 7468 0a20  message length. \n+0000da30: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n+0000da40: 4e56 414c 4944 5f44 4154 415f 454e 434f  NVALID_DATA_ENCO\n+0000da50: 4445 5f44 4947 4553 545f 5641 4c49 4446  DE_DIGEST_VALIDF\n+0000da60: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I\n+0000da70: 6e76 616c 6964 2064 6174 613a 2065 6e63  nvalid data: enc\n+0000da80: 6f64 653a 2069 6e76 616c 6964 2064 6967  ode: invalid dig\n+0000da90: 6573 740a 2020 2020 2027 464b 4f5f 4552  est.     'FKO_ER\n+0000daa0: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n+0000dab0: 5f45 4e43 4f44 455f 4449 4745 5354 5f54  _ENCODE_DIGEST_T\n+0000dac0: 4f4f 4249 4727 0a20 2020 2020 2020 2020  OOBIG'.         \n+0000dad0: 2049 6e76 616c 6964 2064 6174 613a 2065   Invalid data: e\n+0000dae0: 6e63 6f64 653a 2064 6967 6573 7420 6973  ncode: digest is\n+0000daf0: 2074 6f6f 206c 6172 6765 0a20 2020 2020   too large.     \n+0000db00: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n+0000db10: 4944 5f44 4154 415f 454e 434f 4445 5f4e  ID_DATA_ENCODE_N\n+0000db20: 4f54 4241 5345 3634 270a 2020 2020 2020  OTBASE64'.      \n+0000db30: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n+0000db40: 3a20 656e 636f 6465 6420 6461 7461 2069  : encoded data i\n+0000db50: 7320 6e6f 7420 4261 7365 3634 0a20 2020  s not Base64.   \n+0000db60: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n+0000db70: 414c 4944 5f44 4154 415f 454e 4352 5950  ALID_DATA_ENCRYP\n+0000db80: 545f 4d53 474c 454e 5f56 414c 4944 4641  T_MSGLEN_VALIDFA\n+0000db90: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In\n+0000dba0: 7661 6c69 6420 6461 7461 3a20 656e 6372  valid data: encr\n+0000dbb0: 7970 743a 2069 6e76 616c 6964 206d 6573  ypt: invalid mes\n+0000dbc0: 7361 6765 206c 656e 6774 680a 2020 2020  sage length.    \n+0000dbd0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n+0000dbe0: 4c49 445f 4441 5441 5f45 4e43 5259 5054  LID_DATA_ENCRYPT\n+0000dbf0: 5f44 4947 4553 544c 454e 5f56 414c 4944  _DIGESTLEN_VALID\n+0000dc00: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          \n+0000dc10: 496e 7661 6c69 6420 6461 7461 3a20 656e  Invalid data: en\n+0000dc20: 6372 7970 743a 2069 6e76 616c 6964 2064  crypt: invalid d\n+0000dc30: 6967 6573 7420 6c65 6e67 7468 0a20 2020  igest length.   \n+0000dc40: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n+0000dc50: 414c 4944 5f44 4154 415f 454e 4352 5950  ALID_DATA_ENCRYP\n+0000dc60: 545f 5054 4c45 4e5f 5641 4c49 4446 4149  T_PTLEN_VALIDFAI\n+0000dc70: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv\n+0000dc80: 616c 6964 2064 6174 613a 2065 6e63 7279  alid data: encry\n+0000dc90: 7074 3a20 696e 7661 6c69 6420 706c 6169  pt: invalid plai\n+0000dca0: 6e74 6578 7420 6c65 6e67 7468 0a20 2020  ntext length.   \n+0000dcb0: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n+0000dcc0: 414c 4944 5f44 4154 415f 454e 4352 5950  ALID_DATA_ENCRYP\n+0000dcd0: 545f 5245 5355 4c54 5f4d 5347 4c45 4e5f  T_RESULT_MSGLEN_\n+0000dce0: 5641 4c49 4446 4149 4c27 0a20 2020 2020  VALIDFAIL'.     \n+0000dcf0: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat\n+0000dd00: 613a 2065 6e63 7279 7074 3a20 696e 7661  a: encrypt: inva\n+0000dd10: 6c69 6420 656e 6372 7970 7420 7265 7375  lid encrypt resu\n+0000dd20: 6c74 206d 6573 7361 6765 206c 656e 6774  lt message lengt\n+0000dd30: 680a 2020 2020 2027 464b 4f5f 4552 524f  h.     'FKO_ERRO\n+0000dd40: 525f 494e 5641 4c49 445f 4441 5441 5f45  R_INVALID_DATA_E\n+0000dd50: 4e43 5259 5054 5f43 4950 4845 524c 454e  NCRYPT_CIPHERLEN\n+0000dd60: 5f44 4543 4f44 4546 4149 4c27 0a20 2020  _DECODEFAIL'.   \n+0000dd70: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d\n+0000dd80: 6174 613a 2065 6e63 7279 7074 3a20 6465  ata: encrypt: de\n+0000dd90: 636f 6465 2063 6970 6865 7220 6c65 6e67  code cipher leng\n+0000dda0: 7468 2066 6169 6c65 640a 2020 2020 2027  th failed.     '\n+0000ddb0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n+0000ddc0: 445f 4441 5441 5f45 4e43 5259 5054 5f43  D_DATA_ENCRYPT_C\n+0000ddd0: 4950 4845 524c 454e 5f56 414c 4944 4641  IPHERLEN_VALIDFA\n+0000dde0: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In\n+0000ddf0: 7661 6c69 6420 6461 7461 3a20 656e 6372  valid data: encr\n+0000de00: 7970 743a 2069 6e76 616c 6964 2063 6970  ypt: invalid cip\n+0000de10: 6865 7220 6c65 6e67 7468 0a20 2020 2020  her length.     \n+0000de20: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n+0000de30: 4944 5f44 4154 415f 454e 4352 5950 545f  ID_DATA_ENCRYPT_\n+0000de40: 4445 4352 5950 5445 445f 4d45 5353 4147  DECRYPTED_MESSAG\n+0000de50: 455f 4d49 5353 494e 4727 0a20 2020 2020  E_MISSING'.     \n+0000de60: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat\n+0000de70: 613a 2065 6e63 7279 7074 3a20 6d69 7373  a: encrypt: miss\n+0000de80: 696e 6720 6465 6372 7970 7465 6420 6d65  ing decrypted me\n+0000de90: 7373 6167 650a 2020 2020 2027 464b 4f5f  ssage.     'FKO_\n+0000dea0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n+0000deb0: 5441 5f45 4e43 5259 5054 5f44 4543 5259  TA_ENCRYPT_DECRY\n+0000dec0: 5054 4544 5f4d 5347 4c45 4e5f 5641 4c49  PTED_MSGLEN_VALI\n+0000ded0: 4446 4149 4c27 0a20 2020 2020 2020 2020  DFAIL'.         \n+0000dee0: 2049 6e76 616c 6964 2064 6174 613a 2065   Invalid data: e\n+0000def0: 6e63 7279 7074 3a20 696e 7661 6c69 6420  ncrypt: invalid \n+0000df00: 6465 6372 7970 7465 6420 6d65 7373 6167  decrypted messag\n+0000df10: 6520 6c65 6e67 7468 0a20 2020 2020 2746  e length.     'F\n+0000df20: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n+0000df30: 5f44 4154 415f 454e 4352 5950 545f 5459  _DATA_ENCRYPT_TY\n+0000df40: 5045 5f56 414c 4944 4641 494c 270a 2020  PE_VALIDFAIL'.  \n+0000df50: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n+0000df60: 6461 7461 3a20 656e 6372 7970 743a 2069  data: encrypt: i\n+0000df70: 6e76 616c 6964 2065 6e63 7279 7074 696f  nvalid encryptio\n+0000df80: 6e20 7479 7065 0a20 2020 2020 2746 4b4f  n type.     'FKO\n+0000df90: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n+0000dfa0: 4154 415f 454e 4352 5950 545f 4d4f 4445  ATA_ENCRYPT_MODE\n+0000dfb0: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    \n+0000dfc0: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n+0000dfd0: 7461 3a20 656e 6372 7970 743a 2069 6e76  ta: encrypt: inv\n+0000dfe0: 616c 6964 2065 6e63 7279 7074 696f 6e20  alid encryption \n+0000dff0: 6d6f 6465 0a20 2020 2020 2746 4b4f 5f45  mode.     'FKO_E\n+0000e000: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n+0000e010: 415f 454e 4352 5950 545f 5459 5045 5f55  A_ENCRYPT_TYPE_U\n+0000e020: 4e4b 4e4f 574e 270a 2020 2020 2020 2020  NKNOWN'.        \n+0000e030: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n+0000e040: 656e 6372 7970 743a 2075 6e6b 6e6f 776e  encrypt: unknown\n+0000e050: 2065 6e63 7279 7074 696f 6e20 7479 7065   encryption type\n+0000e060: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n+0000e070: 5f49 4e56 414c 4944 5f44 4154 415f 4655  _INVALID_DATA_FU\n+0000e080: 4e43 535f 4e45 575f 454e 434d 5347 5f4d  NCS_NEW_ENCMSG_M\n+0000e090: 4953 5349 4e47 270a 2020 2020 2020 2020  ISSING'.        \n+0000e0a0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n+0000e0b0: 6d69 7373 696e 6720 656e 636f 6465 6420  missing encoded \n+0000e0c0: 6d65 7373 6167 650a 2020 2020 2027 464b  message.     'FK\n+0000e0d0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n+0000e0e0: 4441 5441 5f46 554e 4353 5f4e 4557 5f4d  DATA_FUNCS_NEW_M\n+0000e0f0: 5347 4c45 4e5f 5641 4c49 4446 4149 4c27  SGLEN_VALIDFAIL'\n+0000e100: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n+0000e110: 6964 2064 6174 613a 2069 6e76 616c 6964  id data: invalid\n+0000e120: 206d 6573 7361 6765 206c 656e 6774 6820   message length \n+0000e130: 6672 6f6d 206e 6577 0a20 2020 2020 2746  from new.     'F\n+0000e140: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n+0000e150: 5f44 4154 415f 4655 4e43 535f 4745 4e5f  _DATA_FUNCS_GEN_\n+0000e160: 4b45 594c 454e 5f56 414c 4944 4641 494c  KEYLEN_VALIDFAIL\n+0000e170: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva\n+0000e180: 6c69 6420 6461 7461 3a20 696e 7661 6c69  lid data: invali\n+0000e190: 6420 6b65 7920 6c65 6e67 7468 2066 726f  d key length fro\n+0000e1a0: 6d20 6765 6e5f 6b65 796c 656e 0a20 2020  m gen_keylen.   \n+0000e1b0: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n+0000e1c0: 414c 4944 5f44 4154 415f 4655 4e43 535f  ALID_DATA_FUNCS_\n+0000e1d0: 4745 4e5f 484d 4143 4c45 4e5f 5641 4c49  GEN_HMACLEN_VALI\n+0000e1e0: 4446 4149 4c27 0a20 2020 2020 2020 2020  DFAIL'.         \n+0000e1f0: 2049 6e76 616c 6964 2064 6174 613a 2067   Invalid data: g\n+0000e200: 656e 5f68 6d61 636c 656e 2066 6169 6c75  en_hmaclen failu\n+0000e210: 7265 0a20 2020 2020 2746 4b4f 5f45 5252  re.     'FKO_ERR\n+0000e220: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_\n+0000e230: 4655 4e43 535f 4745 4e5f 4b45 595f 454e  FUNCS_GEN_KEY_EN\n+0000e240: 434f 4445 4641 494c 270a 2020 2020 2020  CODEFAIL'.      \n+0000e250: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n+0000e260: 3a20 6765 6e5f 6b65 793a 2065 6e63 6f64  : gen_key: encod\n+0000e270: 6520 6661 696c 7572 650a 2020 2020 2027  e failure.     '\n+0000e280: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n+0000e290: 445f 4441 5441 5f46 554e 4353 5f47 454e  D_DATA_FUNCS_GEN\n+0000e2a0: 5f48 4d41 435f 454e 434f 4445 4641 494c  _HMAC_ENCODEFAIL\n+0000e2b0: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva\n+0000e2c0: 6c69 6420 6461 7461 3a20 6765 6e5f 686d  lid data: gen_hm\n+0000e2d0: 6163 3a20 656e 636f 6465 2066 6169 6c75  ac: encode failu\n+0000e2e0: 7265 0a20 2020 2020 2746 4b4f 5f45 5252  re.     'FKO_ERR\n+0000e2f0: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_\n+0000e300: 4655 4e43 535f 5345 545f 4d53 474c 454e  FUNCS_SET_MSGLEN\n+0000e310: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    \n+0000e320: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n+0000e330: 7461 3a20 7365 745f 7370 615f 6461 7461  ta: set_spa_data\n+0000e340: 3a20 696e 7661 6c69 6420 6d65 7373 6167  : invalid messag\n+0000e350: 6520 6c65 6e67 7468 0a20 2020 2020 2746  e length.     'F\n+0000e360: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n+0000e370: 5f44 4154 415f 484d 4143 5f4d 5347 4c45  _DATA_HMAC_MSGLE\n+0000e380: 4e5f 5641 4c49 4446 4149 4c27 0a20 2020  N_VALIDFAIL'.   \n+0000e390: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d\n+0000e3a0: 6174 613a 2069 6e76 616c 6964 2048 4d41  ata: invalid HMA\n+0000e3b0: 4320 6d73 676c 656e 0a20 2020 2020 2746  C msglen.     'F\n+0000e3c0: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n+0000e3d0: 5f44 4154 415f 484d 4143 5f45 4e43 4d53  _DATA_HMAC_ENCMS\n+0000e3e0: 474c 454e 5f56 414c 4944 4641 494c 270a  GLEN_VALIDFAIL'.\n+0000e3f0: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n+0000e400: 6420 6461 7461 3a20 696e 7661 6c69 6420  d data: invalid \n+0000e410: 6c65 6e67 7468 2066 6f72 2065 6e63 7279  length for encry\n+0000e420: 7074 6564 206d 6573 7361 6765 0a20 2020  pted message.   \n+0000e430: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n+0000e440: 414c 4944 5f44 4154 415f 484d 4143 5f43  ALID_DATA_HMAC_C\n+0000e450: 4f4d 5041 5245 4641 494c 270a 2020 2020  OMPAREFAIL'.    \n+0000e460: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n+0000e470: 7461 3a20 484d 4143 2063 6f6d 7061 7269  ta: HMAC compari\n+0000e480: 736f 6e20 6661 696c 6564 0a20 2020 2020  son failed.     \n+0000e490: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n+0000e4a0: 4944 5f44 4154 415f 484d 4143 5f54 5950  ID_DATA_HMAC_TYP\n+0000e4b0: 455f 5641 4c49 4446 4149 4c27 0a20 2020  E_VALIDFAIL'.   \n+0000e4c0: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d\n+0000e4d0: 6174 613a 2069 6e76 616c 6964 2048 4d41  ata: invalid HMA\n+0000e4e0: 4320 7479 7065 0a20 2020 2020 2746 4b4f  C type.     'FKO\n+0000e4f0: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n+0000e500: 4154 415f 484d 4143 5f4c 454e 5f56 414c  ATA_HMAC_LEN_VAL\n+0000e510: 4944 4641 494c 270a 2020 2020 2020 2020  IDFAIL'.        \n+0000e520: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n+0000e530: 696e 7661 6c69 6420 484d 4143 206c 656e  invalid HMAC len\n+0000e540: 6774 680a 2020 2020 2027 464b 4f5f 4552  gth.     'FKO_ER\n+0000e550: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n+0000e560: 5f4d 4553 5341 4745 5f50 4f52 545f 4d49  _MESSAGE_PORT_MI\n+0000e570: 5353 494e 4727 0a20 2020 2020 2020 2020  SSING'.         \n+0000e580: 2049 6e76 616c 6964 2064 6174 613a 206d   Invalid data: m\n+0000e590: 6973 7369 6e67 2070 6f72 740a 2020 2020  issing port.    \n+0000e5a0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n+0000e5b0: 4c49 445f 4441 5441 5f4d 4553 5341 4745  LID_DATA_MESSAGE\n+0000e5c0: 5f54 5950 455f 5641 4c49 4446 4149 4c27  _TYPE_VALIDFAIL'\n+0000e5d0: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n+0000e5e0: 6964 2064 6174 613a 2069 6e76 616c 6964  id data: invalid\n+0000e5f0: 206d 6573 7361 6765 2074 7970 650a 2020   message type.  \n+0000e600: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n+0000e610: 5641 4c49 445f 4441 5441 5f4d 4553 5341  VALID_DATA_MESSA\n+0000e620: 4745 5f45 4d50 5459 270a 2020 2020 2020  GE_EMPTY'.      \n+0000e630: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n+0000e640: 3a20 656d 7074 7920 6461 7461 206d 6573  : empty data mes\n+0000e650: 7361 6765 0a20 2020 2020 2746 4b4f 5f45  sage.     'FKO_E\n+0000e660: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n+0000e670: 415f 4d45 5353 4147 455f 434d 445f 4d49  A_MESSAGE_CMD_MI\n+0000e680: 5353 494e 4727 0a20 2020 2020 2020 2020  SSING'.         \n+0000e690: 2049 6e76 616c 6964 2064 6174 613a 206d   Invalid data: m\n+0000e6a0: 6973 7369 6e67 2063 6f6d 6d61 6e64 206d  issing command m\n+0000e6b0: 6573 7361 6765 0a20 2020 2020 2746 4b4f  essage.     'FKO\n+0000e6c0: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n+0000e6d0: 4154 415f 4d45 5353 4147 455f 4143 4345  ATA_MESSAGE_ACCE\n+0000e6e0: 5353 5f4d 4953 5349 4e47 270a 2020 2020  SS_MISSING'.    \n+0000e6f0: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n+0000e700: 7461 3a20 6d69 7373 696e 6720 6163 6365  ta: missing acce\n+0000e710: 7373 206d 6573 7361 6765 0a20 2020 2020  ss message.     \n+0000e720: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n+0000e730: 4944 5f44 4154 415f 4d45 5353 4147 455f  ID_DATA_MESSAGE_\n+0000e740: 4e41 545f 4d49 5353 494e 4727 0a20 2020  NAT_MISSING'.   \n+0000e750: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d\n+0000e760: 6174 613a 206d 6973 7369 6e67 204e 4154  ata: missing NAT\n+0000e770: 2064 6174 610a 2020 2020 2027 464b 4f5f   data.     'FKO_\n+0000e780: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n+0000e790: 5441 5f4d 4553 5341 4745 5f50 4f52 5450  TA_MESSAGE_PORTP\n+0000e7a0: 524f 544f 5f4d 4953 5349 4e47 270a 2020  ROTO_MISSING'.  \n+0000e7b0: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n+0000e7c0: 6461 7461 3a20 6d69 7373 696e 6720 7072  data: missing pr\n+0000e7d0: 6f74 6f2f 706f 7274 2064 6174 610a 2020  oto/port data.  \n+0000e7e0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n+0000e7f0: 5641 4c49 445f 4441 5441 5f4e 4154 5f45  VALID_DATA_NAT_E\n+0000e800: 4d50 5459 270a 2020 2020 2020 2020 2020  MPTY'.          \n+0000e810: 496e 7661 6c69 6420 6461 7461 3a20 656d  Invalid data: em\n+0000e820: 7074 7920 4e41 5420 7661 6c75 650a 2020  pty NAT value.  \n+0000e830: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n+0000e840: 5641 4c49 445f 4441 5441 5f52 414e 445f  VALID_DATA_RAND_\n+0000e850: 4c45 4e5f 5641 4c49 4446 4149 4c27 0a20  LEN_VALIDFAIL'. \n+0000e860: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n+0000e870: 2064 6174 613a 2069 6e76 616c 6964 2072   data: invalid r\n+0000e880: 616e 646f 6d20 6461 7461 206c 656e 6774  andom data lengt\n+0000e890: 680a 2020 2020 2027 464b 4f5f 4552 524f  h.     'FKO_ERRO\n+0000e8a0: 525f 494e 5641 4c49 445f 4441 5441 5f53  R_INVALID_DATA_S\n+0000e8b0: 5256 4155 5448 5f4d 4953 5349 4e47 270a  RVAUTH_MISSING'.\n+0000e8c0: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n+0000e8d0: 6420 6461 7461 3a20 7365 7276 6572 2061  d data: server a\n+0000e8e0: 7574 6820 6d69 7373 696e 670a 2020 2020  uth missing.    \n+0000e8f0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n+0000e900: 4c49 445f 4441 5441 5f54 494d 4553 5441  LID_DATA_TIMESTA\n+0000e910: 4d50 5f56 414c 4944 4641 494c 270a 2020  MP_VALIDFAIL'.  \n+0000e920: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n+0000e930: 6461 7461 3a20 696e 7661 6c69 6420 7469  data: invalid ti\n+0000e940: 6d65 7374 616d 7020 7661 6c75 650a 2020  mestamp value.  \n+0000e950: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n+0000e960: 5641 4c49 445f 4441 5441 5f55 5345 525f  VALID_DATA_USER_\n+0000e970: 4d49 5353 494e 4727 0a20 2020 2020 2020  MISSING'.       \n+0000e980: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:\n+0000e990: 206d 6973 7369 6e67 2075 7365 7220 6461   missing user da\n+0000e9a0: 7461 0a20 2020 2020 2746 4b4f 5f45 5252  ta.     'FKO_ERR\n+0000e9b0: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_\n+0000e9c0: 5553 4552 5f46 4952 5354 4348 4152 5f56  USER_FIRSTCHAR_V\n+0000e9d0: 414c 4944 4641 494c 270a 2020 2020 2020  ALIDFAIL'.      \n+0000e9e0: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n+0000e9f0: 3a20 7573 6572 2066 6972 7374 2063 6861  : user first cha\n+0000ea00: 7220 6e6f 7420 7661 6c69 640a 2020 2020  r not valid.    \n+0000ea10: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n+0000ea20: 4c49 445f 4441 5441 5f55 5345 525f 5245  LID_DATA_USER_RE\n+0000ea30: 4d43 4841 525f 5641 4c49 4446 4149 4c27  MCHAR_VALIDFAIL'\n+0000ea40: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n+0000ea50: 6964 2064 6174 613a 2075 7365 7220 7265  id data: user re\n+0000ea60: 6d63 6861 7220 6e6f 7420 7661 6c69 640a  mchar not valid.\n+0000ea70: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n+0000ea80: 494e 5641 4c49 445f 4441 5441 5f55 5449  INVALID_DATA_UTI\n+0000ea90: 4c5f 5354 5254 4f4c 5f4c 545f 4d49 4e27  L_STRTOL_LT_MIN'\n+0000eaa0: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n+0000eab0: 6964 2064 6174 613a 2075 7469 6c20 636f  id data: util co\n+0000eac0: 6e76 6572 7369 6f6e 2074 6f20 6c6f 6e67  nversion to long\n+0000ead0: 206c 6573 7320 7468 616e 206d 696e 696d   less than minim\n+0000eae0: 756d 0a20 2020 2020 2746 4b4f 5f45 5252  um.     'FKO_ERR\n+0000eaf0: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_\n+0000eb00: 5554 494c 5f53 5452 544f 4c5f 4754 5f4d  UTIL_STRTOL_GT_M\n+0000eb10: 4158 270a 2020 2020 2020 2020 2020 496e  AX'.          In\n+0000eb20: 7661 6c69 6420 6461 7461 3a20 7574 696c  valid data: util\n+0000eb30: 2063 6f6e 7665 7273 696f 6e20 746f 206c   conversion to l\n+0000eb40: 6f6e 6720 6772 6561 7465 7220 7468 616e  ong greater than\n+0000eb50: 206d 6178 696d 756d 0a20 2020 2020 2746   maximum.     'F\n+0000eb60: 4b4f 5f45 5252 4f52 5f44 4154 415f 544f  KO_ERROR_DATA_TO\n+0000eb70: 4f5f 4c41 5247 4527 0a20 2020 2020 2020  O_LARGE'.       \n+0000eb80: 2020 2056 616c 7565 206f 7220 5369 7a65     Value or Size\n+0000eb90: 206f 6620 7468 6520 6461 7461 2065 7863   of the data exc\n+0000eba0: 6565 6465 6420 7468 6520 6d61 7820 616c  eeded the max al\n+0000ebb0: 6c6f 7765 640a 2020 2020 2027 464b 4f5f  lowed.     'FKO_\n+0000ebc0: 4552 524f 525f 494e 5641 4c49 445f 4b45  ERROR_INVALID_KE\n+0000ebd0: 595f 4c45 4e27 0a20 2020 2020 2020 2020  Y_LEN'.         \n+0000ebe0: 2049 6e76 616c 6964 206b 6579 206c 656e   Invalid key len\n+0000ebf0: 6774 680a 2020 2020 2027 464b 4f5f 4552  gth.     'FKO_ER\n+0000ec00: 524f 525f 5553 4552 4e41 4d45 5f55 4e4b  ROR_USERNAME_UNK\n+0000ec10: 4e4f 574e 270a 2020 2020 2020 2020 2020  NOWN'.          \n+0000ec20: 556e 6162 6c65 2074 6f20 6465 7465 726d  Unable to determ\n+0000ec30: 696e 6520 7573 6572 6e61 6d65 0a20 2020  ine username.   \n+0000ec40: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e43    'FKO_ERROR_INC\n+0000ec50: 4f4d 504c 4554 455f 5350 415f 4441 5441  OMPLETE_SPA_DATA\n+0000ec60: 270a 2020 2020 2020 2020 2020 4d69 7373  '.          Miss\n+0000ec70: 696e 6720 6f72 2069 6e63 6f6d 706c 6574  ing or incomplet\n+0000ec80: 6520 5350 4120 6461 7461 0a20 2020 2020  e SPA data.     \n+0000ec90: 2746 4b4f 5f45 5252 4f52 5f4d 4953 5349  'FKO_ERROR_MISSI\n+0000eca0: 4e47 5f45 4e43 4f44 4544 5f44 4154 4127  NG_ENCODED_DATA'\n+0000ecb0: 0a20 2020 2020 2020 2020 2054 6865 7265  .          There\n+0000ecc0: 2069 7320 6e6f 2065 6e63 6f64 6564 2064   is no encoded d\n+0000ecd0: 6174 6120 746f 2070 726f 6365 7373 0a20  ata to process. \n+0000ece0: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n+0000ecf0: 4e56 414c 4944 5f44 4947 4553 545f 5459  NVALID_DIGEST_TY\n+0000ed00: 5045 270a 2020 2020 2020 2020 2020 496e  PE'.          In\n+0000ed10: 7661 6c69 6420 6469 6765 7374 2074 7970  valid digest typ\n+0000ed20: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO\n+0000ed30: 525f 494e 5641 4c49 445f 414c 4c4f 575f  R_INVALID_ALLOW_\n+0000ed40: 4950 270a 2020 2020 2020 2020 2020 496e  IP'.          In\n+0000ed50: 7661 6c69 6420 616c 6c6f 7720 4950 2061  valid allow IP a\n+0000ed60: 6464 7265 7373 2069 6e20 7468 6520 5350  ddress in the SP\n+0000ed70: 4120 6d65 7373 6167 6520 6461 7461 0a20  A message data. \n+0000ed80: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n+0000ed90: 4e56 414c 4944 5f53 5041 5f43 4f4d 4d41  NVALID_SPA_COMMA\n+0000eda0: 4e44 5f4d 5347 270a 2020 2020 2020 2020  ND_MSG'.        \n+0000edb0: 2020 496e 7661 6c69 6420 5350 4120 636f    Invalid SPA co\n+0000edc0: 6d6d 616e 6420 6d65 7373 6167 6520 666f  mmand message fo\n+0000edd0: 726d 6174 0a20 2020 2020 2746 4b4f 5f45  rmat.     'FKO_E\n+0000ede0: 5252 4f52 5f49 4e56 414c 4944 5f53 5041  RROR_INVALID_SPA\n+0000edf0: 5f41 4343 4553 535f 4d53 4727 0a20 2020  _ACCESS_MSG'.   \n+0000ee00: 2020 2020 2020 2049 6e76 616c 6964 2053         Invalid S\n+0000ee10: 5041 2061 6363 6573 7320 6d65 7373 6167  PA access messag\n+0000ee20: 6520 666f 726d 6174 0a20 2020 2020 2746  e format.     'F\n+0000ee30: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n+0000ee40: 5f53 5041 5f4e 4154 5f41 4343 4553 535f  _SPA_NAT_ACCESS_\n+0000ee50: 4d53 4727 0a20 2020 2020 2020 2020 2049  MSG'.          I\n+0000ee60: 6e76 616c 6964 2053 5041 206e 6174 5f61  nvalid SPA nat_a\n+0000ee70: 6363 6573 7320 6d65 7373 6167 6520 666f  ccess message fo\n+0000ee80: 726d 6174 0a20 2020 2020 2746 4b4f 5f45  rmat.     'FKO_E\n+0000ee90: 5252 4f52 5f49 4e56 414c 4944 5f45 4e43  RROR_INVALID_ENC\n+0000eea0: 5259 5054 494f 4e5f 5459 5045 270a 2020  RYPTION_TYPE'.  \n+0000eeb0: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n+0000eec0: 656e 6372 7970 7469 6f6e 2074 7970 650a  encryption type.\n+0000eed0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n+0000eee0: 5752 4f4e 475f 454e 4352 5950 5449 4f4e  WRONG_ENCRYPTION\n+0000eef0: 5f54 5950 4527 0a20 2020 2020 2020 2020  _TYPE'.         \n+0000ef00: 2057 726f 6e67 206f 7220 696e 6170 7072   Wrong or inappr\n+0000ef10: 6f70 7269 6174 6520 656e 6372 7970 7469  opriate encrypti\n+0000ef20: 6f6e 2074 7970 6520 666f 7220 7468 6973  on type for this\n+0000ef30: 206f 7065 7261 7469 6f6e 0a20 2020 2020   operation.     \n+0000ef40: 2746 4b4f 5f45 5252 4f52 5f44 4543 5259  'FKO_ERROR_DECRY\n+0000ef50: 5054 494f 4e5f 5349 5a45 270a 2020 2020  PTION_SIZE'.    \n+0000ef60: 2020 2020 2020 556e 6578 7065 6374 6564        Unexpected\n+0000ef70: 206f 7220 696e 7661 6c69 6420 7369 7a65   or invalid size\n+0000ef80: 2066 6f72 2064 6563 7279 7074 6564 2064   for decrypted d\n+0000ef90: 6174 610a 2020 2020 2027 464b 4f5f 4552  ata.     'FKO_ER\n+0000efa0: 524f 525f 4445 4352 5950 5449 4f4e 5f46  ROR_DECRYPTION_F\n+0000efb0: 4149 4c55 5245 270a 2020 2020 2020 2020  AILURE'.        \n+0000efc0: 2020 4465 6372 7970 7469 6f6e 2066 6169    Decryption fai\n+0000efd0: 6c65 6420 6f72 2064 6563 7279 7074 6564  led or decrypted\n+0000efe0: 2064 6174 6120 6973 2069 6e76 616c 6964   data is invalid\n+0000eff0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n+0000f000: 5f44 4947 4553 545f 5645 5249 4649 4341  _DIGEST_VERIFICA\n+0000f010: 5449 4f4e 5f46 4149 4c45 4427 0a20 2020  TION_FAILED'.   \n+0000f020: 2020 2020 2020 2054 6865 2063 6f6d 7075         The compu\n+0000f030: 7465 6420 6469 6765 7374 2064 6964 206e  ted digest did n\n+0000f040: 6f74 206d 6174 6368 2074 6865 2064 6967  ot match the dig\n+0000f050: 6573 7420 696e 2074 6865 2073 7061 2064  est in the spa d\n+0000f060: 6174 610a 2020 2020 2027 464b 4f5f 4552  ata.     'FKO_ER\n+0000f070: 524f 525f 494e 5641 4c49 445f 484d 4143  ROR_INVALID_HMAC\n+0000f080: 5f4b 4559 5f4c 454e 270a 2020 2020 2020  _KEY_LEN'.      \n+0000f090: 2020 2020 496e 7661 6c69 6420 484d 4143      Invalid HMAC\n+0000f0a0: 206b 6579 206c 656e 6774 680a 2020 2020   key length.    \n+0000f0b0: 2027 464b 4f5f 4552 524f 525f 554e 5355   'FKO_ERROR_UNSU\n+0000f0c0: 5050 4f52 5445 445f 484d 4143 5f4d 4f44  PPORTED_HMAC_MOD\n+0000f0d0: 4527 0a20 2020 2020 2020 2020 2055 6e73  E'.          Uns\n+0000f0e0: 7570 706f 7274 6564 2048 4d41 4320 6d6f  upported HMAC mo\n+0000f0f0: 6465 2028 6465 6661 756c 743a 2053 4841  de (default: SHA\n+0000f100: 3235 3629 0a20 2020 2020 2746 4b4f 5f45  256).     'FKO_E\n+0000f110: 5252 4f52 5f55 4e53 5550 504f 5254 4544  RROR_UNSUPPORTED\n+0000f120: 5f46 4541 5455 5245 270a 2020 2020 2020  _FEATURE'.      \n+0000f130: 2020 2020 556e 7375 7070 6f72 7465 6420      Unsupported \n+0000f140: 6f72 2075 6e69 6d70 6c65 6d65 6e74 6564  or unimplemented\n+0000f150: 2066 6561 7475 7265 206f 7220 6675 6e63   feature or func\n+0000f160: 7469 6f6e 0a20 2020 2020 2746 4b4f 5f45  tion.     'FKO_E\n+0000f170: 5252 4f52 5f5a 4552 4f5f 4f55 545f 4441  RROR_ZERO_OUT_DA\n+0000f180: 5441 270a 2020 2020 2020 2020 2020 436f  TA'.          Co\n+0000f190: 756c 6420 6e6f 7420 7a65 726f 206f 7574  uld not zero out\n+0000f1a0: 2073 656e 7369 7469 7665 2064 6174 610a   sensitive data.\n+0000f1b0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n+0000f1c0: 554e 4b4e 4f57 4e27 0a20 2020 2020 2020  UNKNOWN'.       \n+0000f1d0: 2020 2055 6e6b 6e6f 776e 2f55 6e63 6c61     Unknown/Uncla\n+0000f1e0: 7373 6966 6965 6420 6572 726f 720a 0a20  ssified error.. \n+0000f1f0: 2020 4966 2047 5047 2073 7570 706f 7274    If GPG support\n+0000f200: 2069 7320 6176 6169 6c61 626c 652c 2074   is available, t\n+0000f210: 6865 7265 2061 7265 2061 6464 6974 696f  here are additio\n+0000f220: 6e61 6c20 706f 7373 6962 6c65 2065 7272  nal possible err\n+0000f230: 6f72 0a63 6f6e 6469 7469 6f6e 7320 616e  or.conditions an\n+0000f240: 6420 6572 726f 7220 636f 6465 732e 2020  d error codes.  \n+0000f250: 5468 6520 4750 4720 7375 7070 6f72 7420  The GPG support \n+0000f260: 6973 2069 6d70 6c65 6d65 6e74 6564 2076  is implemented v\n+0000f270: 6961 2047 5047 4d45 2e0a 5468 6520 6c69  ia GPGME..The li\n+0000f280: 6266 6b6f 2065 7272 6f72 2068 616e 646c  bfko error handl\n+0000f290: 696e 6720 636f 6465 2077 7261 7073 206d  ing code wraps m\n+0000f2a0: 616e 7920 6f66 2074 6865 2047 5047 4d45  any of the GPGME\n+0000f2b0: 2065 7272 6f72 2063 6f64 6573 2074 6861   error codes tha\n+0000f2c0: 740a 6d61 7920 6265 2065 6e63 6f75 6e74  t.may be encount\n+0000f2d0: 6572 6564 2077 6869 6c65 2075 7369 6e67  ered while using\n+0000f2e0: 206c 6962 666b 6f27 7320 4750 4720 7265   libfko's GPG re\n+0000f2f0: 6c61 7465 6420 6675 6e63 7469 6f6e 732e  lated functions.\n+0000f300: 2020 5468 6573 650a 6172 653a 0a0a 202d    These.are:.. -\n+0000f310: 2d20 5661 7269 6162 6c65 3a20 696e 7420  - Variable: int \n+0000f320: 6572 726f 725f 636f 6465 2028 6770 676d  error_code (gpgm\n+0000f330: 6520 7375 7070 6f72 7420 6f6e 6c79 290a  e support only).\n+0000f340: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n+0000f350: 4d49 5353 494e 475f 4750 475f 4b45 595f  MISSING_GPG_KEY_\n+0000f360: 4441 5441 270a 2020 2020 2020 2020 2020  DATA'.          \n+0000f370: 4d69 7373 696e 6720 4750 4720 6b65 7920  Missing GPG key \n+0000f380: 6461 7461 2028 7369 676e 6572 206f 7220  data (signer or \n+0000f390: 7265 6369 7069 656e 7420 6e6f 7420 7365  recipient not se\n+0000f3a0: 7429 0a20 2020 2020 2746 4b4f 5f45 5252  t).     'FKO_ERR\n+0000f3b0: 4f52 5f47 5047 4d45 5f4e 4f5f 4f50 454e  OR_GPGME_NO_OPEN\n+0000f3c0: 5047 5027 0a20 2020 2020 2020 2020 2054  PGP'.          T\n+0000f3d0: 6869 7320 4750 474d 4520 696d 706c 656d  his GPGME implem\n+0000f3e0: 656e 7461 7469 6f6e 2064 6f65 7320 6e6f  entation does no\n+0000f3f0: 7420 7375 7070 6f72 7420 4f70 656e 5047  t support OpenPG\n+0000f400: 500a 2020 2020 2027 464b 4f5f 4552 524f  P.     'FKO_ERRO\n+0000f410: 525f 4750 474d 455f 434f 4e54 4558 5427  R_GPGME_CONTEXT'\n+0000f420: 0a20 2020 2020 2020 2020 2055 6e61 626c  .          Unabl\n+0000f430: 6520 746f 2063 7265 6174 6520 4750 474d  e to create GPGM\n+0000f440: 4520 636f 6e74 6578 740a 2020 2020 2027  E context.     '\n+0000f450: 464b 4f5f 4552 524f 525f 4750 474d 455f  FKO_ERROR_GPGME_\n+0000f460: 504c 4149 4e54 4558 545f 4441 5441 5f4f  PLAINTEXT_DATA_O\n+0000f470: 424a 270a 2020 2020 2020 2020 2020 4572  BJ'.          Er\n+0000f480: 726f 7220 6372 6561 7469 6e67 2074 6865  ror creating the\n+0000f490: 2070 6c61 696e 7465 7874 2064 6174 6120   plaintext data \n+0000f4a0: 6f62 6a65 6374 0a20 2020 2020 2746 4b4f  object.     'FKO\n+0000f4b0: 5f45 5252 4f52 5f47 5047 4d45 5f53 4554  _ERROR_GPGME_SET\n+0000f4c0: 5f50 524f 544f 434f 4c27 0a20 2020 2020  _PROTOCOL'.     \n+0000f4d0: 2020 2020 2055 6e61 626c 6520 746f 2073       Unable to s\n+0000f4e0: 6574 2047 5047 4d45 2074 6f20 7573 6520  et GPGME to use \n+0000f4f0: 4f70 656e 5047 5020 7072 6f74 6f63 6f6c  OpenPGP protocol\n+0000f500: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n+0000f510: 5f47 5047 4d45 5f43 4950 4845 525f 4441  _GPGME_CIPHER_DA\n+0000f520: 5441 5f4f 424a 270a 2020 2020 2020 2020  TA_OBJ'.        \n+0000f530: 2020 4572 726f 7220 6372 6561 7469 6e67    Error creating\n+0000f540: 2074 6865 2065 6e63 7279 7074 6564 2064   the encrypted d\n+0000f550: 6174 6120 6461 7461 206f 626a 6563 740a  ata data object.\n+0000f560: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n+0000f570: 4750 474d 455f 4241 445f 5041 5353 5048  GPGME_BAD_PASSPH\n+0000f580: 5241 5345 270a 2020 2020 2020 2020 2020  RASE'.          \n+0000f590: 5468 6520 4750 4720 7061 7373 7068 7261  The GPG passphra\n+0000f5a0: 7365 2077 6173 206e 6f74 2076 616c 6964  se was not valid\n+0000f5b0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n+0000f5c0: 5f47 5047 4d45 5f45 4e43 5259 5054 5f53  _GPGME_ENCRYPT_S\n+0000f5d0: 4947 4e27 0a20 2020 2020 2020 2020 2045  IGN'.          E\n+0000f5e0: 7272 6f72 2064 7572 696e 6720 7468 6520  rror during the \n+0000f5f0: 656e 6372 7970 7420 616e 6420 7369 676e  encrypt and sign\n+0000f600: 206f 7065 7261 7469 6f6e 0a20 2020 2020   operation.     \n+0000f610: 2746 4b4f 5f45 5252 4f52 5f47 5047 4d45  'FKO_ERROR_GPGME\n+0000f620: 5f43 4f4e 5445 5854 5f53 4947 4e45 525f  _CONTEXT_SIGNER_\n+0000f630: 4b45 5927 0a20 2020 2020 2020 2020 2055  KEY'.          U\n+0000f640: 6e61 626c 6520 746f 2063 7265 6174 6520  nable to create \n+0000f650: 4750 474d 4520 636f 6e74 6578 7420 666f  GPGME context fo\n+0000f660: 7220 7468 6520 7369 676e 6572 206b 6579  r the signer key\n+0000f670: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n+0000f680: 5f47 5047 4d45 5f53 4947 4e45 525f 4b45  _GPGME_SIGNER_KE\n+0000f690: 594c 4953 545f 5354 4152 5427 0a20 2020  YLIST_START'.   \n+0000f6a0: 2020 2020 2020 2045 7272 6f72 2066 726f         Error fro\n+0000f6b0: 6d20 7369 676e 6572 206b 6579 6c69 7374  m signer keylist\n+0000f6c0: 2073 7461 7274 206f 7065 7261 7469 6f6e   start operation\n+0000f6d0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n+0000f6e0: 5f47 5047 4d45 5f53 4947 4e45 525f 4b45  _GPGME_SIGNER_KE\n+0000f6f0: 595f 4e4f 545f 464f 554e 4427 0a20 2020  Y_NOT_FOUND'.   \n+0000f700: 2020 2020 2020 2054 6865 206b 6579 2066         The key f\n+0000f710: 6f72 2074 6865 2067 6976 656e 2073 6967  or the given sig\n+0000f720: 6e65 7220 7761 7320 6e6f 7420 666f 756e  ner was not foun\n+0000f730: 640a 2020 2020 2027 464b 4f5f 4552 524f  d.     'FKO_ERRO\n+0000f740: 525f 4750 474d 455f 5349 474e 4552 5f4b  R_GPGME_SIGNER_K\n+0000f750: 4559 5f41 4d42 4947 554f 5553 270a 2020  EY_AMBIGUOUS'.  \n+0000f760: 2020 2020 2020 2020 416d 6269 6775 6f75          Ambiguou\n+0000f770: 7320 6e61 6d65 2f69 6420 666f 7220 7468  s name/id for th\n+0000f780: 6520 7369 676e 6572 206b 6579 2028 6d75  e signer key (mu\n+0000f790: 6c74 6970 6c65 206d 6174 6368 6573 290a  ltiple matches).\n+0000f7a0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n+0000f7b0: 4750 474d 455f 4144 445f 5349 474e 4552  GPGME_ADD_SIGNER\n+0000f7c0: 270a 2020 2020 2020 2020 2020 4572 726f  '.          Erro\n+0000f7d0: 7220 6164 6469 6e67 2074 6865 2073 6967  r adding the sig\n+0000f7e0: 6e65 7220 6b65 7920 746f 2074 6865 2067  ner key to the g\n+0000f7f0: 7067 6d65 2063 6f6e 7465 7874 0a20 2020  pgme context.   \n+0000f800: 2020 2746 4b4f 5f45 5252 4f52 5f47 5047    'FKO_ERROR_GPG\n+0000f810: 4d45 5f43 4f4e 5445 5854 5f52 4543 4950  ME_CONTEXT_RECIP\n+0000f820: 4945 4e54 5f4b 4559 270a 2020 2020 2020  IENT_KEY'.      \n+0000f830: 2020 2020 556e 6162 6c65 2074 6f20 6372      Unable to cr\n+0000f840: 6561 7465 2047 5047 4d45 2063 6f6e 7465  eate GPGME conte\n+0000f850: 7874 2066 6f72 2074 6865 2072 6563 6970  xt for the recip\n+0000f860: 6965 6e74 206b 6579 0a20 2020 2020 2746  ient key.     'F\n+0000f870: 4b4f 5f45 5252 4f52 5f47 5047 4d45 5f52  KO_ERROR_GPGME_R\n+0000f880: 4543 4950 4945 4e54 5f4b 4559 4c49 5354  ECIPIENT_KEYLIST\n+0000f890: 5f53 5441 5254 270a 2020 2020 2020 2020  _START'.        \n+0000f8a0: 2020 4572 726f 7220 6672 6f6d 2073 6967    Error from sig\n+0000f8b0: 6e65 7220 6b65 796c 6973 7420 7374 6172  ner keylist star\n+0000f8c0: 7420 6f70 6572 6174 696f 6e0a 2020 2020  t operation.    \n+0000f8d0: 2027 464b 4f5f 4552 524f 525f 4750 474d   'FKO_ERROR_GPGM\n+0000f8e0: 455f 5245 4349 5049 454e 545f 4b45 595f  E_RECIPIENT_KEY_\n+0000f8f0: 4e4f 545f 464f 554e 4427 0a20 2020 2020  NOT_FOUND'.     \n+0000f900: 2020 2020 2054 6865 206b 6579 2066 6f72       The key for\n+0000f910: 2074 6865 2067 6976 656e 2072 6563 6970   the given recip\n+0000f920: 6965 6e74 2077 6173 206e 6f74 2066 6f75  ient was not fou\n+0000f930: 6e64 0a20 2020 2020 2746 4b4f 5f45 5252  nd.     'FKO_ERR\n+0000f940: 4f52 5f47 5047 4d45 5f52 4543 4950 4945  OR_GPGME_RECIPIE\n+0000f950: 4e54 5f4b 4559 5f41 4d42 4947 554f 5553  NT_KEY_AMBIGUOUS\n+0000f960: 270a 2020 2020 2020 2020 2020 416d 6269  '.          Ambi\n+0000f970: 6775 6f75 7320 6e61 6d65 2f69 6420 666f  guous name/id fo\n+0000f980: 7220 7468 6520 7265 6369 7069 656e 7420  r the recipient \n+0000f990: 6b65 7920 286d 756c 7469 706c 6520 6d61  key (multiple ma\n+0000f9a0: 7463 6865 7329 0a20 2020 2020 2746 4b4f  tches).     'FKO\n+0000f9b0: 5f45 5252 4f52 5f47 5047 4d45 5f44 4543  _ERROR_GPGME_DEC\n+0000f9c0: 5259 5054 5f46 4149 4c45 4427 0a20 2020  RYPT_FAILED'.   \n+0000f9d0: 2020 2020 2020 2044 6563 7279 7074 696f         Decryptio\n+0000f9e0: 6e20 6f70 6572 6174 696f 6e20 6661 696c  n operation fail\n+0000f9f0: 6564 0a20 2020 2020 2746 4b4f 5f45 5252  ed.     'FKO_ERR\n+0000fa00: 4f52 5f47 5047 4d45 5f42 4144 5f47 5047  OR_GPGME_BAD_GPG\n+0000fa10: 5f45 5845 270a 2020 2020 2020 2020 2020  _EXE'.          \n+0000fa20: 556e 6162 6c65 2074 6f20 7374 6174 2074  Unable to stat t\n+0000fa30: 6865 2067 6976 656e 2047 5047 2065 7865  he given GPG exe\n+0000fa40: 6375 7461 626c 650a 2020 2020 2027 464b  cutable.     'FK\n+0000fa50: 4f5f 4552 524f 525f 4750 474d 455f 4241  O_ERROR_GPGME_BA\n+0000fa60: 445f 484f 4d45 5f44 4952 270a 2020 2020  D_HOME_DIR'.    \n+0000fa70: 2020 2020 2020 556e 6162 6c65 2074 6f20        Unable to \n+0000fa80: 7374 6174 2074 6865 2067 6976 656e 2047  stat the given G\n+0000fa90: 5047 2068 6f6d 6520 6469 7265 6374 6f72  PG home director\n+0000faa0: 790a 2020 2020 2027 464b 4f5f 4552 524f  y.     'FKO_ERRO\n+0000fab0: 525f 4750 474d 455f 5345 545f 484f 4d45  R_GPGME_SET_HOME\n+0000fac0: 5f44 4952 270a 2020 2020 2020 2020 2020  _DIR'.          \n+0000fad0: 556e 6162 6c65 2074 6f20 7365 7420 7468  Unable to set th\n+0000fae0: 6520 6769 7665 6e20 4750 4720 686f 6d65  e given GPG home\n+0000faf0: 2064 6972 6563 746f 7279 0a20 2020 2020   directory.     \n+0000fb00: 2746 4b4f 5f45 5252 4f52 5f47 5047 4d45  'FKO_ERROR_GPGME\n+0000fb10: 5f4e 4f5f 5349 474e 4154 5552 4527 0a20  _NO_SIGNATURE'. \n+0000fb20: 2020 2020 2020 2020 204d 6973 7369 6e67           Missing\n+0000fb30: 2047 5047 2073 6967 6e61 7475 7265 0a20   GPG signature. \n+0000fb40: 2020 2020 2746 4b4f 5f45 5252 4f52 5f47      'FKO_ERROR_G\n+0000fb50: 5047 4d45 5f42 4144 5f53 4947 4e41 5455  PGME_BAD_SIGNATU\n+0000fb60: 5245 270a 2020 2020 2020 2020 2020 4261  RE'.          Ba\n+0000fb70: 6420 4750 4720 7369 676e 6174 7572 650a  d GPG signature.\n+0000fb80: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n+0000fb90: 4750 474d 455f 5349 474e 4154 5552 455f  GPGME_SIGNATURE_\n+0000fba0: 5645 5249 4659 5f44 4953 4142 4c45 4427  VERIFY_DISABLED'\n+0000fbb0: 0a20 2020 2020 2020 2020 2054 7279 696e  .          Tryin\n+0000fbc0: 6720 746f 2063 6865 636b 2073 6967 6e61  g to check signa\n+0000fbd0: 7475 7265 2077 6974 6820 7665 7269 6669  ture with verifi\n+0000fbe0: 6361 7469 6f6e 2064 6973 6162 6c65 640a  cation disabled.\n+0000fbf0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n+0000fc00: 494e 5641 4c49 445f 4441 5441 5f45 4e43  INVALID_DATA_ENC\n+0000fc10: 5259 5054 5f47 5047 5f4d 4553 5341 4745  RYPT_GPG_MESSAGE\n+0000fc20: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    \n+0000fc30: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n+0000fc40: 7461 3a20 656e 6372 7970 743a 2069 6e76  ta: encrypt: inv\n+0000fc50: 616c 6964 2047 5047 2d65 6e63 7279 7074  alid GPG-encrypt\n+0000fc60: 206d 6573 7361 6765 0a20 2020 2020 2746   message.     'F\n+0000fc70: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n+0000fc80: 5f44 4154 415f 454e 4352 5950 545f 4750  _DATA_ENCRYPT_GP\n+0000fc90: 475f 4449 4745 5354 5f56 414c 4944 4641  G_DIGEST_VALIDFA\n+0000fca0: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In\n+0000fcb0: 7661 6c69 6420 6461 7461 3a20 656e 6372  valid data: encr\n+0000fcc0: 7970 743a 2069 6e76 616c 6964 2047 5047  ypt: invalid GPG\n+0000fcd0: 2064 6967 6573 740a 2020 2020 2027 464b   digest.     'FK\n+0000fce0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n+0000fcf0: 4441 5441 5f45 4e43 5259 5054 5f47 5047  DATA_ENCRYPT_GPG\n+0000fd00: 5f4d 5347 4c45 4e5f 5641 4c49 4446 4149  _MSGLEN_VALIDFAI\n+0000fd10: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv\n+0000fd20: 616c 6964 2064 6174 613a 2065 6e63 7279  alid data: encry\n+0000fd30: 7074 3a20 696e 7661 6c69 6420 4750 4720  pt: invalid GPG \n+0000fd40: 6d65 7373 6167 6520 6c65 6e67 7468 0a20  message length. \n+0000fd50: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n+0000fd60: 4e56 414c 4944 5f44 4154 415f 454e 4352  NVALID_DATA_ENCR\n+0000fd70: 5950 545f 4750 475f 5245 5355 4c54 5f4d  YPT_GPG_RESULT_M\n+0000fd80: 5347 4c45 4e5f 5641 4c49 4446 4149 4c27  SGLEN_VALIDFAIL'\n+0000fd90: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n+0000fda0: 6964 2064 6174 613a 2065 6e63 7279 7074  id data: encrypt\n+0000fdb0: 3a20 696e 7661 6c69 6420 4750 4720 7265  : invalid GPG re\n+0000fdc0: 7375 6c74 206d 6573 7361 6765 206c 656e  sult message len\n+0000fdd0: 6774 680a 2020 2020 2027 464b 4f5f 4552  gth.     'FKO_ER\n+0000fde0: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n+0000fdf0: 5f45 4e43 5259 5054 5f47 5047 5f43 4950  _ENCRYPT_GPG_CIP\n+0000fe00: 4845 525f 4445 434f 4445 4641 494c 270a  HER_DECODEFAIL'.\n+0000fe10: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n+0000fe20: 6420 6461 7461 3a20 656e 6372 7970 743a  d data: encrypt:\n+0000fe30: 2047 5047 2063 6970 6865 7220 6661 696c   GPG cipher fail\n+0000fe40: 6564 0a20 2020 2020 2746 4b4f 5f45 5252  ed.     'FKO_ERR\n+0000fe50: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_\n+0000fe60: 454e 4352 5950 545f 4750 475f 454e 434f  ENCRYPT_GPG_ENCO\n+0000fe70: 4445 444d 5347 5f4e 554c 4c27 0a20 2020  DEDMSG_NULL'.   \n+0000fe80: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d\n+0000fe90: 6174 613a 2065 6e63 7279 7074 3a20 4750  ata: encrypt: GP\n+0000fea0: 472d 656e 636f 6465 6420 6d65 7373 6167  G-encoded messag\n+0000feb0: 6520 6973 204e 554c 4c0a 2020 2020 2027  e is NULL.     '\n+0000fec0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n+0000fed0: 445f 4441 5441 5f45 4e43 5259 5054 5f47  D_DATA_ENCRYPT_G\n+0000fee0: 5047 5f45 4e43 4f44 4544 4d53 474c 454e  PG_ENCODEDMSGLEN\n+0000fef0: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    \n+0000ff00: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n+0000ff10: 7461 3a20 656e 6372 7970 743a 2069 6e76  ta: encrypt: inv\n+0000ff20: 616c 6964 2047 5047 2d65 6e63 7279 7074  alid GPG-encrypt\n+0000ff30: 6564 206d 6573 7361 6765 206c 656e 6774  ed message lengt\n+0000ff40: 680a 0a20 2020 596f 7520 6361 6e20 7573  h..   You can us\n+0000ff50: 6520 7468 6520 2749 535f 4750 474d 455f  e the 'IS_GPGME_\n+0000ff60: 4552 524f 5228 6572 725f 636f 6465 2927  ERROR(err_code)'\n+0000ff70: 206d 6163 726f 2074 6f20 6465 7465 726d   macro to determ\n+0000ff80: 696e 6520 7768 6574 6865 720a 6f72 206e  ine whether.or n\n+0000ff90: 6f74 2061 6e20 6572 726f 7220 6964 2047  ot an error id G\n+0000ffa0: 5047 4d45 2072 656c 6174 6564 2e20 2049  PGME related.  I\n+0000ffb0: 6620 7468 6520 6d61 6372 6f20 6576 616c  f the macro eval\n+0000ffc0: 7561 7465 7320 746f 2061 2074 7275 650a  uates to a true.\n+0000ffd0: 7661 6c75 652c 2079 6f75 206d 6179 2062  value, you may b\n+0000ffe0: 6520 6162 6c65 2074 6f20 6765 7420 6164  e able to get ad\n+0000fff0: 6469 7469 6f6e 616c 2069 6e66 6f72 6d61  ditional informa\n+00010000: 7469 6f6e 2061 626f 7574 2074 6865 2065  tion about the e\n+00010010: 7272 6f72 0a75 7369 6e67 2074 6865 2066  rror.using the f\n+00010020: 6f6c 6c6f 7769 6e67 2066 756e 6374 696f  ollowing functio\n+00010030: 6e3a 0a0a 202d 2d20 4675 6e63 7469 6f6e  n:.. -- Function\n+00010040: 3a20 636f 6e73 7420 6368 6172 202a 2066  : const char * f\n+00010050: 6b6f 5f67 7067 5f65 7272 7374 7220 2869  ko_gpg_errstr (i\n+00010060: 6e74 2045 5252 5f43 4f44 4529 0a20 2020  nt ERR_CODE).   \n+00010070: 2020 5468 6520 6675 6e63 7469 6f6e 2027    The function '\n+00010080: 666b 6f5f 6572 7273 7472 2720 7265 7475  fko_errstr' retu\n+00010090: 726e 7320 6120 706f 696e 7465 7220 746f  rns a pointer to\n+000100a0: 2061 2073 7461 7469 6361 6c6c 790a 2020   a statically.  \n+000100b0: 2020 2061 6c6c 6f63 6174 6564 2073 7472     allocated str\n+000100c0: 696e 6720 636f 6e74 6169 6e69 6e67 2074  ing containing t\n+000100d0: 6865 2064 6573 6372 6970 7469 6f6e 206f  he description o\n+000100e0: 6620 7468 6520 4750 474d 4520 6572 726f  f the GPGME erro\n+000100f0: 722e 0a0a 2a4e 6f74 652a 3a20 466f 7220  r...*Note*: For \n+00010100: 736f 6d65 2065 7272 6f72 732c 2074 6869  some errors, thi\n+00010110: 7320 6675 6e63 7469 6f6e 206d 6179 2072  s function may r\n+00010120: 6574 7572 6e20 616e 2065 6d70 7479 2073  eturn an empty s\n+00010130: 7472 696e 672e 0a0a 1f0a 4669 6c65 3a20  tring.....File: \n+00010140: 6c69 6266 6b6f 2e69 6e66 6f2c 2020 4e6f  libfko.info,  No\n+00010150: 6465 3a20 4c69 6272 6172 7920 436f 7079  de: Library Copy\n+00010160: 696e 672c 2020 4e65 7874 3a20 436f 6e63  ing,  Next: Conc\n+00010170: 6570 7420 496e 6465 782c 2020 5072 6576  ept Index,  Prev\n+00010180: 3a20 5573 696e 6720 6c69 6266 6b6f 2c20  : Using libfko, \n+00010190: 2055 703a 2054 6f70 0a0a 4170 7065 6e64   Up: Top..Append\n+000101a0: 6978 2041 2047 4e55 2047 454e 4552 414c  ix A GNU GENERAL\n+000101b0: 2050 5542 4c49 4320 4c49 4345 4e53 450a   PUBLIC LICENSE.\n+000101c0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ****************\n 000101d0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ****************\n-000101e0: 2a2a 2a2a 2a2a 2a0a 0a20 2020 2020 2020  *******..       \n-000101f0: 2020 2020 2020 2056 6572 7369 6f6e 2032         Version 2\n-00010200: 2028 6f72 2061 6e79 206c 6174 6572 2076   (or any later v\n-00010210: 6572 7369 6f6e 292c 204a 756e 6520 3139  ersion), June 19\n-00010220: 3931 0a0a 2020 2020 2043 6f70 7972 6967  91..     Copyrig\n-00010230: 6874 2028 4329 2031 3938 392c 2031 3939  ht (C) 1989, 199\n-00010240: 3120 4672 6565 2053 6f66 7477 6172 6520  1 Free Software \n-00010250: 466f 756e 6461 7469 6f6e 2c20 496e 632e  Foundation, Inc.\n-00010260: 0a20 2020 2020 3531 2046 7261 6e6b 6c69  .     51 Frankli\n-00010270: 6e20 5374 7265 6574 2c20 4669 6674 6820  n Street, Fifth \n-00010280: 466c 6f6f 722c 2042 6f73 746f 6e2c 204d  Floor, Boston, M\n-00010290: 4120 2030 3231 3130 2d31 3330 312c 2055  A  02110-1301, U\n-000102a0: 5341 0a0a 2020 2020 2045 7665 7279 6f6e  SA..     Everyon\n-000102b0: 6520 6973 2070 6572 6d69 7474 6564 2074  e is permitted t\n-000102c0: 6f20 636f 7079 2061 6e64 2064 6973 7472  o copy and distr\n-000102d0: 6962 7574 6520 7665 7262 6174 696d 2063  ibute verbatim c\n-000102e0: 6f70 6965 730a 2020 2020 206f 6620 7468  opies.     of th\n-000102f0: 6973 206c 6963 656e 7365 2064 6f63 756d  is license docum\n-00010300: 656e 742c 2062 7574 2063 6861 6e67 696e  ent, but changin\n-00010310: 6720 6974 2069 7320 6e6f 7420 616c 6c6f  g it is not allo\n-00010320: 7765 642e 0a0a 412e 3120 5072 6561 6d62  wed...A.1 Preamb\n-00010330: 6c65 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a  le.============.\n-00010340: 0a54 6865 206c 6963 656e 7365 7320 666f  .The licenses fo\n-00010350: 7220 6d6f 7374 2073 6f66 7477 6172 6520  r most software \n-00010360: 6172 6520 6465 7369 676e 6564 2074 6f20  are designed to \n-00010370: 7461 6b65 2061 7761 7920 796f 7572 2066  take away your f\n-00010380: 7265 6564 6f6d 2074 6f0a 7368 6172 6520  reedom to.share \n-00010390: 616e 6420 6368 616e 6765 2069 742e 2020  and change it.  \n-000103a0: 4279 2063 6f6e 7472 6173 742c 2074 6865  By contrast, the\n-000103b0: 2047 4e55 2047 656e 6572 616c 2050 7562   GNU General Pub\n-000103c0: 6c69 6320 4c69 6365 6e73 6520 6973 0a69  lic License is.i\n-000103d0: 6e74 656e 6465 6420 746f 2067 7561 7261  ntended to guara\n-000103e0: 6e74 6565 2079 6f75 7220 6672 6565 646f  ntee your freedo\n-000103f0: 6d20 746f 2073 6861 7265 2061 6e64 2063  m to share and c\n-00010400: 6861 6e67 6520 6672 6565 2073 6f66 7477  hange free softw\n-00010410: 6172 652d 2d74 6f0a 6d61 6b65 2073 7572  are--to.make sur\n-00010420: 6520 7468 6520 736f 6674 7761 7265 2069  e the software i\n-00010430: 7320 6672 6565 2066 6f72 2061 6c6c 2069  s free for all i\n-00010440: 7473 2075 7365 7273 2e20 2054 6869 7320  ts users.  This \n-00010450: 4765 6e65 7261 6c20 5075 626c 6963 0a4c  General Public.L\n-00010460: 6963 656e 7365 2061 7070 6c69 6573 2074  icense applies t\n-00010470: 6f20 6d6f 7374 206f 6620 7468 6520 4672  o most of the Fr\n-00010480: 6565 2053 6f66 7477 6172 6520 466f 756e  ee Software Foun\n-00010490: 6461 7469 6f6e 2773 2073 6f66 7477 6172  dation's softwar\n-000104a0: 6520 616e 640a 746f 2061 6e79 206f 7468  e and.to any oth\n-000104b0: 6572 2070 726f 6772 616d 2077 686f 7365  er program whose\n-000104c0: 2061 7574 686f 7273 2063 6f6d 6d69 7420   authors commit \n-000104d0: 746f 2075 7369 6e67 2069 742e 2020 2853  to using it.  (S\n-000104e0: 6f6d 6520 6f74 6865 7220 4672 6565 0a53  ome other Free.S\n-000104f0: 6f66 7477 6172 6520 466f 756e 6461 7469  oftware Foundati\n-00010500: 6f6e 2073 6f66 7477 6172 6520 6973 2063  on software is c\n-00010510: 6f76 6572 6564 2062 7920 7468 6520 474e  overed by the GN\n-00010520: 5520 4c65 7373 6572 2047 656e 6572 616c  U Lesser General\n-00010530: 2050 7562 6c69 630a 4c69 6365 6e73 6520   Public.License \n-00010540: 696e 7374 6561 642e 2920 2059 6f75 2063  instead.)  You c\n-00010550: 616e 2061 7070 6c79 2069 7420 746f 2079  an apply it to y\n-00010560: 6f75 7220 7072 6f67 7261 6d73 2c20 746f  our programs, to\n-00010570: 6f2e 0a0a 2020 2057 6865 6e20 7765 2073  o...   When we s\n-00010580: 7065 616b 206f 6620 6672 6565 2073 6f66  peak of free sof\n-00010590: 7477 6172 652c 2077 6520 6172 6520 7265  tware, we are re\n-000105a0: 6665 7272 696e 6720 746f 2066 7265 6564  ferring to freed\n-000105b0: 6f6d 2c20 6e6f 740a 7072 6963 652e 2020  om, not.price.  \n-000105c0: 4f75 7220 4765 6e65 7261 6c20 5075 626c  Our General Publ\n-000105d0: 6963 204c 6963 656e 7365 7320 6172 6520  ic Licenses are \n-000105e0: 6465 7369 676e 6564 2074 6f20 6d61 6b65  designed to make\n-000105f0: 2073 7572 6520 7468 6174 2079 6f75 0a68   sure that you.h\n-00010600: 6176 6520 7468 6520 6672 6565 646f 6d20  ave the freedom \n-00010610: 746f 2064 6973 7472 6962 7574 6520 636f  to distribute co\n-00010620: 7069 6573 206f 6620 6672 6565 2073 6f66  pies of free sof\n-00010630: 7477 6172 6520 2861 6e64 2063 6861 7267  tware (and charg\n-00010640: 6520 666f 720a 7468 6973 2073 6572 7669  e for.this servi\n-00010650: 6365 2069 6620 796f 7520 7769 7368 292c  ce if you wish),\n-00010660: 2074 6861 7420 796f 7520 7265 6365 6976   that you receiv\n-00010670: 6520 736f 7572 6365 2063 6f64 6520 6f72  e source code or\n-00010680: 2063 616e 2067 6574 2069 7420 6966 0a79   can get it if.y\n-00010690: 6f75 2077 616e 7420 6974 2c20 7468 6174  ou want it, that\n-000106a0: 2079 6f75 2063 616e 2063 6861 6e67 6520   you can change \n-000106b0: 7468 6520 736f 6674 7761 7265 206f 7220  the software or \n-000106c0: 7573 6520 7069 6563 6573 206f 6620 6974  use pieces of it\n-000106d0: 2069 6e20 6e65 770a 6672 6565 2070 726f   in new.free pro\n-000106e0: 6772 616d 733b 2061 6e64 2074 6861 7420  grams; and that \n-000106f0: 796f 7520 6b6e 6f77 2079 6f75 2063 616e  you know you can\n-00010700: 2064 6f20 7468 6573 6520 7468 696e 6773   do these things\n-00010710: 2e0a 0a20 2020 546f 2070 726f 7465 6374  ...   To protect\n-00010720: 2079 6f75 7220 7269 6768 7473 2c20 7765   your rights, we\n-00010730: 206e 6565 6420 746f 206d 616b 6520 7265   need to make re\n-00010740: 7374 7269 6374 696f 6e73 2074 6861 7420  strictions that \n-00010750: 666f 7262 6964 0a61 6e79 6f6e 6520 746f  forbid.anyone to\n-00010760: 2064 656e 7920 796f 7520 7468 6573 6520   deny you these \n-00010770: 7269 6768 7473 206f 7220 746f 2061 736b  rights or to ask\n-00010780: 2079 6f75 2074 6f20 7375 7272 656e 6465   you to surrende\n-00010790: 7220 7468 6520 7269 6768 7473 2e0a 5468  r the rights..Th\n-000107a0: 6573 6520 7265 7374 7269 6374 696f 6e73  ese restrictions\n-000107b0: 2074 7261 6e73 6c61 7465 2074 6f20 6365   translate to ce\n-000107c0: 7274 6169 6e20 7265 7370 6f6e 7369 6269  rtain responsibi\n-000107d0: 6c69 7469 6573 2066 6f72 2079 6f75 2069  lities for you i\n-000107e0: 6620 796f 750a 6469 7374 7269 6275 7465  f you.distribute\n-000107f0: 2063 6f70 6965 7320 6f66 2074 6865 2073   copies of the s\n-00010800: 6f66 7477 6172 652c 206f 7220 6966 2079  oftware, or if y\n-00010810: 6f75 206d 6f64 6966 7920 6974 2e0a 0a20  ou modify it... \n-00010820: 2020 466f 7220 6578 616d 706c 652c 2069    For example, i\n-00010830: 6620 796f 7520 6469 7374 7269 6275 7465  f you distribute\n-00010840: 2063 6f70 6965 7320 6f66 2073 7563 6820   copies of such \n-00010850: 6120 7072 6f67 7261 6d2c 2077 6865 7468  a program, wheth\n-00010860: 6572 0a67 7261 7469 7320 6f72 2066 6f72  er.gratis or for\n-00010870: 2061 2066 6565 2c20 796f 7520 6d75 7374   a fee, you must\n-00010880: 2067 6976 6520 7468 6520 7265 6369 7069   give the recipi\n-00010890: 656e 7473 2061 6c6c 2074 6865 2072 6967  ents all the rig\n-000108a0: 6874 7320 7468 6174 0a79 6f75 2068 6176  hts that.you hav\n-000108b0: 652e 2020 596f 7520 6d75 7374 206d 616b  e.  You must mak\n-000108c0: 6520 7375 7265 2074 6861 7420 7468 6579  e sure that they\n-000108d0: 2c20 746f 6f2c 2072 6563 6569 7665 206f  , too, receive o\n-000108e0: 7220 6361 6e20 6765 7420 7468 650a 736f  r can get the.so\n-000108f0: 7572 6365 2063 6f64 652e 2020 416e 6420  urce code.  And \n-00010900: 796f 7520 6d75 7374 2073 686f 7720 7468  you must show th\n-00010910: 656d 2074 6865 7365 2074 6572 6d73 2073  em these terms s\n-00010920: 6f20 7468 6579 206b 6e6f 7720 7468 6569  o they know thei\n-00010930: 720a 7269 6768 7473 2e0a 0a20 2020 5765  r.rights...   We\n-00010940: 2070 726f 7465 6374 2079 6f75 7220 7269   protect your ri\n-00010950: 6768 7473 2077 6974 6820 7477 6f20 7374  ghts with two st\n-00010960: 6570 733a 2028 3129 2063 6f70 7972 6967  eps: (1) copyrig\n-00010970: 6874 2074 6865 2073 6f66 7477 6172 652c  ht the software,\n-00010980: 0a61 6e64 2028 3229 206f 6666 6572 2079  .and (2) offer y\n-00010990: 6f75 2074 6869 7320 6c69 6365 6e73 6520  ou this license \n-000109a0: 7768 6963 6820 6769 7665 7320 796f 7520  which gives you \n-000109b0: 6c65 6761 6c20 7065 726d 6973 7369 6f6e  legal permission\n-000109c0: 2074 6f20 636f 7079 2c0a 6469 7374 7269   to copy,.distri\n-000109d0: 6275 7465 2061 6e64 2f6f 7220 6d6f 6469  bute and/or modi\n-000109e0: 6679 2074 6865 2073 6f66 7477 6172 652e  fy the software.\n-000109f0: 0a0a 2020 2041 6c73 6f2c 2066 6f72 2065  ..   Also, for e\n-00010a00: 6163 6820 6175 7468 6f72 2773 2070 726f  ach author's pro\n-00010a10: 7465 6374 696f 6e20 616e 6420 6f75 7273  tection and ours\n-00010a20: 2c20 7765 2077 616e 7420 746f 206d 616b  , we want to mak\n-00010a30: 6520 6365 7274 6169 6e0a 7468 6174 2065  e certain.that e\n-00010a40: 7665 7279 6f6e 6520 756e 6465 7273 7461  veryone understa\n-00010a50: 6e64 7320 7468 6174 2074 6865 7265 2069  nds that there i\n-00010a60: 7320 6e6f 2077 6172 7261 6e74 7920 666f  s no warranty fo\n-00010a70: 7220 7468 6973 2066 7265 650a 736f 6674  r this free.soft\n-00010a80: 7761 7265 2e20 2049 6620 7468 6520 736f  ware.  If the so\n-00010a90: 6674 7761 7265 2069 7320 6d6f 6469 6669  ftware is modifi\n-00010aa0: 6564 2062 7920 736f 6d65 6f6e 6520 656c  ed by someone el\n-00010ab0: 7365 2061 6e64 2070 6173 7365 6420 6f6e  se and passed on\n-00010ac0: 2c20 7765 0a77 616e 7420 6974 7320 7265  , we.want its re\n-00010ad0: 6369 7069 656e 7473 2074 6f20 6b6e 6f77  cipients to know\n-00010ae0: 2074 6861 7420 7768 6174 2074 6865 7920   that what they \n-00010af0: 6861 7665 2069 7320 6e6f 7420 7468 6520  have is not the \n-00010b00: 6f72 6967 696e 616c 2c20 736f 0a74 6861  original, so.tha\n-00010b10: 7420 616e 7920 7072 6f62 6c65 6d73 2069  t any problems i\n-00010b20: 6e74 726f 6475 6365 6420 6279 206f 7468  ntroduced by oth\n-00010b30: 6572 7320 7769 6c6c 206e 6f74 2072 6566  ers will not ref\n-00010b40: 6c65 6374 206f 6e20 7468 6520 6f72 6967  lect on the orig\n-00010b50: 696e 616c 0a61 7574 686f 7273 2720 7265  inal.authors' re\n-00010b60: 7075 7461 7469 6f6e 732e 0a0a 2020 2046  putations...   F\n-00010b70: 696e 616c 6c79 2c20 616e 7920 6672 6565  inally, any free\n-00010b80: 2070 726f 6772 616d 2069 7320 7468 7265   program is thre\n-00010b90: 6174 656e 6564 2063 6f6e 7374 616e 746c  atened constantl\n-00010ba0: 7920 6279 2073 6f66 7477 6172 650a 7061  y by software.pa\n-00010bb0: 7465 6e74 732e 2020 5765 2077 6973 6820  tents.  We wish \n-00010bc0: 746f 2061 766f 6964 2074 6865 2064 616e  to avoid the dan\n-00010bd0: 6765 7220 7468 6174 2072 6564 6973 7472  ger that redistr\n-00010be0: 6962 7574 6f72 7320 6f66 2061 2066 7265  ibutors of a fre\n-00010bf0: 650a 7072 6f67 7261 6d20 7769 6c6c 2069  e.program will i\n-00010c00: 6e64 6976 6964 7561 6c6c 7920 6f62 7461  ndividually obta\n-00010c10: 696e 2070 6174 656e 7420 6c69 6365 6e73  in patent licens\n-00010c20: 6573 2c20 696e 2065 6666 6563 7420 6d61  es, in effect ma\n-00010c30: 6b69 6e67 2074 6865 0a70 726f 6772 616d  king the.program\n-00010c40: 2070 726f 7072 6965 7461 7279 2e20 2054   proprietary.  T\n-00010c50: 6f20 7072 6576 656e 7420 7468 6973 2c20  o prevent this, \n-00010c60: 7765 2068 6176 6520 6d61 6465 2069 7420  we have made it \n-00010c70: 636c 6561 7220 7468 6174 2061 6e79 0a70  clear that any.p\n-00010c80: 6174 656e 7420 6d75 7374 2062 6520 6c69  atent must be li\n-00010c90: 6365 6e73 6564 2066 6f72 2065 7665 7279  censed for every\n-00010ca0: 6f6e 6527 7320 6672 6565 2075 7365 206f  one's free use o\n-00010cb0: 7220 6e6f 7420 6c69 6365 6e73 6564 2061  r not licensed a\n-00010cc0: 7420 616c 6c2e 0a0a 2020 2054 6865 2070  t all...   The p\n-00010cd0: 7265 6369 7365 2074 6572 6d73 2061 6e64  recise terms and\n-00010ce0: 2063 6f6e 6469 7469 6f6e 7320 666f 7220   conditions for \n-00010cf0: 636f 7079 696e 672c 2064 6973 7472 6962  copying, distrib\n-00010d00: 7574 696f 6e20 616e 640a 6d6f 6469 6669  ution and.modifi\n-00010d10: 6361 7469 6f6e 2066 6f6c 6c6f 772e 0a0a  cation follow...\n+000101e0: 2a2a 2a2a 2a0a 0a20 2020 2020 2020 2020  *****..         \n+000101f0: 2020 2020 2056 6572 7369 6f6e 2032 2028       Version 2 (\n+00010200: 6f72 2061 6e79 206c 6174 6572 2076 6572  or any later ver\n+00010210: 7369 6f6e 292c 204a 756e 6520 3139 3931  sion), June 1991\n+00010220: 0a0a 2020 2020 2043 6f70 7972 6967 6874  ..     Copyright\n+00010230: 2028 4329 2031 3938 392c 2031 3939 3120   (C) 1989, 1991 \n+00010240: 4672 6565 2053 6f66 7477 6172 6520 466f  Free Software Fo\n+00010250: 756e 6461 7469 6f6e 2c20 496e 632e 0a20  undation, Inc.. \n+00010260: 2020 2020 3531 2046 7261 6e6b 6c69 6e20      51 Franklin \n+00010270: 5374 7265 6574 2c20 4669 6674 6820 466c  Street, Fifth Fl\n+00010280: 6f6f 722c 2042 6f73 746f 6e2c 204d 4120  oor, Boston, MA \n+00010290: 2030 3231 3130 2d31 3330 312c 2055 5341   02110-1301, USA\n+000102a0: 0a0a 2020 2020 2045 7665 7279 6f6e 6520  ..     Everyone \n+000102b0: 6973 2070 6572 6d69 7474 6564 2074 6f20  is permitted to \n+000102c0: 636f 7079 2061 6e64 2064 6973 7472 6962  copy and distrib\n+000102d0: 7574 6520 7665 7262 6174 696d 2063 6f70  ute verbatim cop\n+000102e0: 6965 730a 2020 2020 206f 6620 7468 6973  ies.     of this\n+000102f0: 206c 6963 656e 7365 2064 6f63 756d 656e   license documen\n+00010300: 742c 2062 7574 2063 6861 6e67 696e 6720  t, but changing \n+00010310: 6974 2069 7320 6e6f 7420 616c 6c6f 7765  it is not allowe\n+00010320: 642e 0a0a 412e 3120 5072 6561 6d62 6c65  d...A.1 Preamble\n+00010330: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54  .============..T\n+00010340: 6865 206c 6963 656e 7365 7320 666f 7220  he licenses for \n+00010350: 6d6f 7374 2073 6f66 7477 6172 6520 6172  most software ar\n+00010360: 6520 6465 7369 676e 6564 2074 6f20 7461  e designed to ta\n+00010370: 6b65 2061 7761 7920 796f 7572 2066 7265  ke away your fre\n+00010380: 6564 6f6d 2074 6f0a 7368 6172 6520 616e  edom to.share an\n+00010390: 6420 6368 616e 6765 2069 742e 2020 4279  d change it.  By\n+000103a0: 2063 6f6e 7472 6173 742c 2074 6865 2047   contrast, the G\n+000103b0: 4e55 2047 656e 6572 616c 2050 7562 6c69  NU General Publi\n+000103c0: 6320 4c69 6365 6e73 6520 6973 0a69 6e74  c License is.int\n+000103d0: 656e 6465 6420 746f 2067 7561 7261 6e74  ended to guarant\n+000103e0: 6565 2079 6f75 7220 6672 6565 646f 6d20  ee your freedom \n+000103f0: 746f 2073 6861 7265 2061 6e64 2063 6861  to share and cha\n+00010400: 6e67 6520 6672 6565 2073 6f66 7477 6172  nge free softwar\n+00010410: 652d 2d74 6f0a 6d61 6b65 2073 7572 6520  e--to.make sure \n+00010420: 7468 6520 736f 6674 7761 7265 2069 7320  the software is \n+00010430: 6672 6565 2066 6f72 2061 6c6c 2069 7473  free for all its\n+00010440: 2075 7365 7273 2e20 2054 6869 7320 4765   users.  This Ge\n+00010450: 6e65 7261 6c20 5075 626c 6963 0a4c 6963  neral Public.Lic\n+00010460: 656e 7365 2061 7070 6c69 6573 2074 6f20  ense applies to \n+00010470: 6d6f 7374 206f 6620 7468 6520 4672 6565  most of the Free\n+00010480: 2053 6f66 7477 6172 6520 466f 756e 6461   Software Founda\n+00010490: 7469 6f6e 2773 2073 6f66 7477 6172 6520  tion's software \n+000104a0: 616e 640a 746f 2061 6e79 206f 7468 6572  and.to any other\n+000104b0: 2070 726f 6772 616d 2077 686f 7365 2061   program whose a\n+000104c0: 7574 686f 7273 2063 6f6d 6d69 7420 746f  uthors commit to\n+000104d0: 2075 7369 6e67 2069 742e 2020 2853 6f6d   using it.  (Som\n+000104e0: 6520 6f74 6865 7220 4672 6565 0a53 6f66  e other Free.Sof\n+000104f0: 7477 6172 6520 466f 756e 6461 7469 6f6e  tware Foundation\n+00010500: 2073 6f66 7477 6172 6520 6973 2063 6f76   software is cov\n+00010510: 6572 6564 2062 7920 7468 6520 474e 5520  ered by the GNU \n+00010520: 4c65 7373 6572 2047 656e 6572 616c 2050  Lesser General P\n+00010530: 7562 6c69 630a 4c69 6365 6e73 6520 696e  ublic.License in\n+00010540: 7374 6561 642e 2920 2059 6f75 2063 616e  stead.)  You can\n+00010550: 2061 7070 6c79 2069 7420 746f 2079 6f75   apply it to you\n+00010560: 7220 7072 6f67 7261 6d73 2c20 746f 6f2e  r programs, too.\n+00010570: 0a0a 2020 2057 6865 6e20 7765 2073 7065  ..   When we spe\n+00010580: 616b 206f 6620 6672 6565 2073 6f66 7477  ak of free softw\n+00010590: 6172 652c 2077 6520 6172 6520 7265 6665  are, we are refe\n+000105a0: 7272 696e 6720 746f 2066 7265 6564 6f6d  rring to freedom\n+000105b0: 2c20 6e6f 740a 7072 6963 652e 2020 4f75  , not.price.  Ou\n+000105c0: 7220 4765 6e65 7261 6c20 5075 626c 6963  r General Public\n+000105d0: 204c 6963 656e 7365 7320 6172 6520 6465   Licenses are de\n+000105e0: 7369 676e 6564 2074 6f20 6d61 6b65 2073  signed to make s\n+000105f0: 7572 6520 7468 6174 2079 6f75 0a68 6176  ure that you.hav\n+00010600: 6520 7468 6520 6672 6565 646f 6d20 746f  e the freedom to\n+00010610: 2064 6973 7472 6962 7574 6520 636f 7069   distribute copi\n+00010620: 6573 206f 6620 6672 6565 2073 6f66 7477  es of free softw\n+00010630: 6172 6520 2861 6e64 2063 6861 7267 6520  are (and charge \n+00010640: 666f 720a 7468 6973 2073 6572 7669 6365  for.this service\n+00010650: 2069 6620 796f 7520 7769 7368 292c 2074   if you wish), t\n+00010660: 6861 7420 796f 7520 7265 6365 6976 6520  hat you receive \n+00010670: 736f 7572 6365 2063 6f64 6520 6f72 2063  source code or c\n+00010680: 616e 2067 6574 2069 7420 6966 0a79 6f75  an get it if.you\n+00010690: 2077 616e 7420 6974 2c20 7468 6174 2079   want it, that y\n+000106a0: 6f75 2063 616e 2063 6861 6e67 6520 7468  ou can change th\n+000106b0: 6520 736f 6674 7761 7265 206f 7220 7573  e software or us\n+000106c0: 6520 7069 6563 6573 206f 6620 6974 2069  e pieces of it i\n+000106d0: 6e20 6e65 770a 6672 6565 2070 726f 6772  n new.free progr\n+000106e0: 616d 733b 2061 6e64 2074 6861 7420 796f  ams; and that yo\n+000106f0: 7520 6b6e 6f77 2079 6f75 2063 616e 2064  u know you can d\n+00010700: 6f20 7468 6573 6520 7468 696e 6773 2e0a  o these things..\n+00010710: 0a20 2020 546f 2070 726f 7465 6374 2079  .   To protect y\n+00010720: 6f75 7220 7269 6768 7473 2c20 7765 206e  our rights, we n\n+00010730: 6565 6420 746f 206d 616b 6520 7265 7374  eed to make rest\n+00010740: 7269 6374 696f 6e73 2074 6861 7420 666f  rictions that fo\n+00010750: 7262 6964 0a61 6e79 6f6e 6520 746f 2064  rbid.anyone to d\n+00010760: 656e 7920 796f 7520 7468 6573 6520 7269  eny you these ri\n+00010770: 6768 7473 206f 7220 746f 2061 736b 2079  ghts or to ask y\n+00010780: 6f75 2074 6f20 7375 7272 656e 6465 7220  ou to surrender \n+00010790: 7468 6520 7269 6768 7473 2e0a 5468 6573  the rights..Thes\n+000107a0: 6520 7265 7374 7269 6374 696f 6e73 2074  e restrictions t\n+000107b0: 7261 6e73 6c61 7465 2074 6f20 6365 7274  ranslate to cert\n+000107c0: 6169 6e20 7265 7370 6f6e 7369 6269 6c69  ain responsibili\n+000107d0: 7469 6573 2066 6f72 2079 6f75 2069 6620  ties for you if \n+000107e0: 796f 750a 6469 7374 7269 6275 7465 2063  you.distribute c\n+000107f0: 6f70 6965 7320 6f66 2074 6865 2073 6f66  opies of the sof\n+00010800: 7477 6172 652c 206f 7220 6966 2079 6f75  tware, or if you\n+00010810: 206d 6f64 6966 7920 6974 2e0a 0a20 2020   modify it...   \n+00010820: 466f 7220 6578 616d 706c 652c 2069 6620  For example, if \n+00010830: 796f 7520 6469 7374 7269 6275 7465 2063  you distribute c\n+00010840: 6f70 6965 7320 6f66 2073 7563 6820 6120  opies of such a \n+00010850: 7072 6f67 7261 6d2c 2077 6865 7468 6572  program, whether\n+00010860: 0a67 7261 7469 7320 6f72 2066 6f72 2061  .gratis or for a\n+00010870: 2066 6565 2c20 796f 7520 6d75 7374 2067   fee, you must g\n+00010880: 6976 6520 7468 6520 7265 6369 7069 656e  ive the recipien\n+00010890: 7473 2061 6c6c 2074 6865 2072 6967 6874  ts all the right\n+000108a0: 7320 7468 6174 0a79 6f75 2068 6176 652e  s that.you have.\n+000108b0: 2020 596f 7520 6d75 7374 206d 616b 6520    You must make \n+000108c0: 7375 7265 2074 6861 7420 7468 6579 2c20  sure that they, \n+000108d0: 746f 6f2c 2072 6563 6569 7665 206f 7220  too, receive or \n+000108e0: 6361 6e20 6765 7420 7468 650a 736f 7572  can get the.sour\n+000108f0: 6365 2063 6f64 652e 2020 416e 6420 796f  ce code.  And yo\n+00010900: 7520 6d75 7374 2073 686f 7720 7468 656d  u must show them\n+00010910: 2074 6865 7365 2074 6572 6d73 2073 6f20   these terms so \n+00010920: 7468 6579 206b 6e6f 7720 7468 6569 720a  they know their.\n+00010930: 7269 6768 7473 2e0a 0a20 2020 5765 2070  rights...   We p\n+00010940: 726f 7465 6374 2079 6f75 7220 7269 6768  rotect your righ\n+00010950: 7473 2077 6974 6820 7477 6f20 7374 6570  ts with two step\n+00010960: 733a 2028 3129 2063 6f70 7972 6967 6874  s: (1) copyright\n+00010970: 2074 6865 2073 6f66 7477 6172 652c 0a61   the software,.a\n+00010980: 6e64 2028 3229 206f 6666 6572 2079 6f75  nd (2) offer you\n+00010990: 2074 6869 7320 6c69 6365 6e73 6520 7768   this license wh\n+000109a0: 6963 6820 6769 7665 7320 796f 7520 6c65  ich gives you le\n+000109b0: 6761 6c20 7065 726d 6973 7369 6f6e 2074  gal permission t\n+000109c0: 6f20 636f 7079 2c0a 6469 7374 7269 6275  o copy,.distribu\n+000109d0: 7465 2061 6e64 2f6f 7220 6d6f 6469 6679  te and/or modify\n+000109e0: 2074 6865 2073 6f66 7477 6172 652e 0a0a   the software...\n+000109f0: 2020 2041 6c73 6f2c 2066 6f72 2065 6163     Also, for eac\n+00010a00: 6820 6175 7468 6f72 2773 2070 726f 7465  h author's prote\n+00010a10: 6374 696f 6e20 616e 6420 6f75 7273 2c20  ction and ours, \n+00010a20: 7765 2077 616e 7420 746f 206d 616b 6520  we want to make \n+00010a30: 6365 7274 6169 6e0a 7468 6174 2065 7665  certain.that eve\n+00010a40: 7279 6f6e 6520 756e 6465 7273 7461 6e64  ryone understand\n+00010a50: 7320 7468 6174 2074 6865 7265 2069 7320  s that there is \n+00010a60: 6e6f 2077 6172 7261 6e74 7920 666f 7220  no warranty for \n+00010a70: 7468 6973 2066 7265 650a 736f 6674 7761  this free.softwa\n+00010a80: 7265 2e20 2049 6620 7468 6520 736f 6674  re.  If the soft\n+00010a90: 7761 7265 2069 7320 6d6f 6469 6669 6564  ware is modified\n+00010aa0: 2062 7920 736f 6d65 6f6e 6520 656c 7365   by someone else\n+00010ab0: 2061 6e64 2070 6173 7365 6420 6f6e 2c20   and passed on, \n+00010ac0: 7765 0a77 616e 7420 6974 7320 7265 6369  we.want its reci\n+00010ad0: 7069 656e 7473 2074 6f20 6b6e 6f77 2074  pients to know t\n+00010ae0: 6861 7420 7768 6174 2074 6865 7920 6861  hat what they ha\n+00010af0: 7665 2069 7320 6e6f 7420 7468 6520 6f72  ve is not the or\n+00010b00: 6967 696e 616c 2c20 736f 0a74 6861 7420  iginal, so.that \n+00010b10: 616e 7920 7072 6f62 6c65 6d73 2069 6e74  any problems int\n+00010b20: 726f 6475 6365 6420 6279 206f 7468 6572  roduced by other\n+00010b30: 7320 7769 6c6c 206e 6f74 2072 6566 6c65  s will not refle\n+00010b40: 6374 206f 6e20 7468 6520 6f72 6967 696e  ct on the origin\n+00010b50: 616c 0a61 7574 686f 7273 2720 7265 7075  al.authors' repu\n+00010b60: 7461 7469 6f6e 732e 0a0a 2020 2046 696e  tations...   Fin\n+00010b70: 616c 6c79 2c20 616e 7920 6672 6565 2070  ally, any free p\n+00010b80: 726f 6772 616d 2069 7320 7468 7265 6174  rogram is threat\n+00010b90: 656e 6564 2063 6f6e 7374 616e 746c 7920  ened constantly \n+00010ba0: 6279 2073 6f66 7477 6172 650a 7061 7465  by software.pate\n+00010bb0: 6e74 732e 2020 5765 2077 6973 6820 746f  nts.  We wish to\n+00010bc0: 2061 766f 6964 2074 6865 2064 616e 6765   avoid the dange\n+00010bd0: 7220 7468 6174 2072 6564 6973 7472 6962  r that redistrib\n+00010be0: 7574 6f72 7320 6f66 2061 2066 7265 650a  utors of a free.\n+00010bf0: 7072 6f67 7261 6d20 7769 6c6c 2069 6e64  program will ind\n+00010c00: 6976 6964 7561 6c6c 7920 6f62 7461 696e  ividually obtain\n+00010c10: 2070 6174 656e 7420 6c69 6365 6e73 6573   patent licenses\n+00010c20: 2c20 696e 2065 6666 6563 7420 6d61 6b69  , in effect maki\n+00010c30: 6e67 2074 6865 0a70 726f 6772 616d 2070  ng the.program p\n+00010c40: 726f 7072 6965 7461 7279 2e20 2054 6f20  roprietary.  To \n+00010c50: 7072 6576 656e 7420 7468 6973 2c20 7765  prevent this, we\n+00010c60: 2068 6176 6520 6d61 6465 2069 7420 636c   have made it cl\n+00010c70: 6561 7220 7468 6174 2061 6e79 0a70 6174  ear that any.pat\n+00010c80: 656e 7420 6d75 7374 2062 6520 6c69 6365  ent must be lice\n+00010c90: 6e73 6564 2066 6f72 2065 7665 7279 6f6e  nsed for everyon\n+00010ca0: 6527 7320 6672 6565 2075 7365 206f 7220  e's free use or \n+00010cb0: 6e6f 7420 6c69 6365 6e73 6564 2061 7420  not licensed at \n+00010cc0: 616c 6c2e 0a0a 2020 2054 6865 2070 7265  all...   The pre\n+00010cd0: 6369 7365 2074 6572 6d73 2061 6e64 2063  cise terms and c\n+00010ce0: 6f6e 6469 7469 6f6e 7320 666f 7220 636f  onditions for co\n+00010cf0: 7079 696e 672c 2064 6973 7472 6962 7574  pying, distribut\n+00010d00: 696f 6e20 616e 640a 6d6f 6469 6669 6361  ion and.modifica\n+00010d10: 7469 6f6e 2066 6f6c 6c6f 772e 0a0a 2020  tion follow...  \n 00010d20: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00010d30: 2020 2020 474e 5520 4745 4e45 5241 4c20      GNU GENERAL \n-00010d40: 5055 424c 4943 204c 4943 454e 5345 2076  PUBLIC LICENSE v\n-00010d50: 322b 0a20 2020 2054 4552 4d53 2041 4e44  2+.    TERMS AND\n-00010d60: 2043 4f4e 4449 5449 4f4e 5320 464f 5220   CONDITIONS FOR \n-00010d70: 434f 5059 494e 472c 2044 4953 5452 4942  COPYING, DISTRIB\n-00010d80: 5554 494f 4e20 414e 4420 4d4f 4449 4649  UTION AND MODIFI\n-00010d90: 4341 5449 4f4e 0a0a 2020 302e 2054 6869  CATION..  0. Thi\n-00010da0: 7320 4c69 6365 6e73 6520 6170 706c 6965  s License applie\n-00010db0: 7320 746f 2061 6e79 2070 726f 6772 616d  s to any program\n-00010dc0: 206f 7220 6f74 6865 7220 776f 726b 2077   or other work w\n-00010dd0: 6869 6368 2063 6f6e 7461 696e 7320 610a  hich contains a.\n-00010de0: 2020 2020 206e 6f74 6963 6520 706c 6163       notice plac\n-00010df0: 6564 2062 7920 7468 6520 636f 7079 7269  ed by the copyri\n-00010e00: 6768 7420 686f 6c64 6572 2073 6179 696e  ght holder sayin\n-00010e10: 6720 6974 206d 6179 2062 6520 6469 7374  g it may be dist\n-00010e20: 7269 6275 7465 640a 2020 2020 2075 6e64  ributed.     und\n-00010e30: 6572 2074 6865 2074 6572 6d73 206f 6620  er the terms of \n-00010e40: 7468 6973 2047 656e 6572 616c 2050 7562  this General Pub\n-00010e50: 6c69 6320 4c69 6365 6e73 652e 2020 5468  lic License.  Th\n-00010e60: 6520 2250 726f 6772 616d 222c 0a20 2020  e \"Program\",.   \n-00010e70: 2020 6265 6c6f 772c 2072 6566 6572 7320    below, refers \n-00010e80: 746f 2061 6e79 2073 7563 6820 7072 6f67  to any such prog\n-00010e90: 7261 6d20 6f72 2077 6f72 6b2c 2061 6e64  ram or work, and\n-00010ea0: 2061 2022 776f 726b 2062 6173 6564 206f   a \"work based o\n-00010eb0: 6e20 7468 650a 2020 2020 2050 726f 6772  n the.     Progr\n-00010ec0: 616d 2220 6d65 616e 7320 6569 7468 6572  am\" means either\n-00010ed0: 2074 6865 2050 726f 6772 616d 206f 7220   the Program or \n-00010ee0: 616e 7920 6465 7269 7661 7469 7665 2077  any derivative w\n-00010ef0: 6f72 6b20 756e 6465 720a 2020 2020 2063  ork under.     c\n-00010f00: 6f70 7972 6967 6874 206c 6177 3a20 7468  opyright law: th\n-00010f10: 6174 2069 7320 746f 2073 6179 2c20 6120  at is to say, a \n-00010f20: 776f 726b 2063 6f6e 7461 696e 696e 6720  work containing \n-00010f30: 7468 6520 5072 6f67 7261 6d20 6f72 2061  the Program or a\n-00010f40: 0a20 2020 2020 706f 7274 696f 6e20 6f66  .     portion of\n-00010f50: 2069 742c 2065 6974 6865 7220 7665 7262   it, either verb\n-00010f60: 6174 696d 206f 7220 7769 7468 206d 6f64  atim or with mod\n-00010f70: 6966 6963 6174 696f 6e73 2061 6e64 2f6f  ifications and/o\n-00010f80: 720a 2020 2020 2074 7261 6e73 6c61 7465  r.     translate\n-00010f90: 6420 696e 746f 2061 6e6f 7468 6572 206c  d into another l\n-00010fa0: 616e 6775 6167 652e 2020 2848 6572 6569  anguage.  (Herei\n-00010fb0: 6e61 6674 6572 2c20 7472 616e 736c 6174  nafter, translat\n-00010fc0: 696f 6e20 6973 0a20 2020 2020 696e 636c  ion is.     incl\n-00010fd0: 7564 6564 2077 6974 686f 7574 206c 696d  uded without lim\n-00010fe0: 6974 6174 696f 6e20 696e 2074 6865 2074  itation in the t\n-00010ff0: 6572 6d20 226d 6f64 6966 6963 6174 696f  erm \"modificatio\n-00011000: 6e22 2e29 2020 4561 6368 0a20 2020 2020  n\".)  Each.     \n-00011010: 6c69 6365 6e73 6565 2069 7320 6164 6472  licensee is addr\n-00011020: 6573 7365 6420 6173 2022 796f 7522 2e0a  essed as \"you\"..\n-00011030: 0a20 2020 2020 4163 7469 7669 7469 6573  .     Activities\n-00011040: 206f 7468 6572 2074 6861 6e20 636f 7079   other than copy\n-00011050: 696e 672c 2064 6973 7472 6962 7574 696f  ing, distributio\n-00011060: 6e20 616e 6420 6d6f 6469 6669 6361 7469  n and modificati\n-00011070: 6f6e 2061 7265 0a20 2020 2020 6e6f 7420  on are.     not \n-00011080: 636f 7665 7265 6420 6279 2074 6869 7320  covered by this \n-00011090: 4c69 6365 6e73 653b 2074 6865 7920 6172  License; they ar\n-000110a0: 6520 6f75 7473 6964 6520 6974 7320 7363  e outside its sc\n-000110b0: 6f70 652e 2020 5468 6520 6163 740a 2020  ope.  The act.  \n-000110c0: 2020 206f 6620 7275 6e6e 696e 6720 7468     of running th\n-000110d0: 6520 5072 6f67 7261 6d20 6973 206e 6f74  e Program is not\n-000110e0: 2072 6573 7472 6963 7465 642c 2061 6e64   restricted, and\n-000110f0: 2074 6865 206f 7574 7075 7420 6672 6f6d   the output from\n-00011100: 2074 6865 0a20 2020 2020 5072 6f67 7261   the.     Progra\n-00011110: 6d20 6973 2063 6f76 6572 6564 206f 6e6c  m is covered onl\n-00011120: 7920 6966 2069 7473 2063 6f6e 7465 6e74  y if its content\n-00011130: 7320 636f 6e73 7469 7475 7465 2061 2077  s constitute a w\n-00011140: 6f72 6b20 6261 7365 6420 6f6e 0a20 2020  ork based on.   \n-00011150: 2020 7468 6520 5072 6f67 7261 6d20 2869    the Program (i\n-00011160: 6e64 6570 656e 6465 6e74 206f 6620 6861  ndependent of ha\n-00011170: 7669 6e67 2062 6565 6e20 6d61 6465 2062  ving been made b\n-00011180: 7920 7275 6e6e 696e 6720 7468 650a 2020  y running the.  \n-00011190: 2020 2050 726f 6772 616d 292e 2020 5768     Program).  Wh\n-000111a0: 6574 6865 7220 7468 6174 2069 7320 7472  ether that is tr\n-000111b0: 7565 2064 6570 656e 6473 206f 6e20 7768  ue depends on wh\n-000111c0: 6174 2074 6865 2050 726f 6772 616d 2064  at the Program d\n-000111d0: 6f65 732e 0a0a 2020 312e 2059 6f75 206d  oes...  1. You m\n-000111e0: 6179 2063 6f70 7920 616e 6420 6469 7374  ay copy and dist\n-000111f0: 7269 6275 7465 2076 6572 6261 7469 6d20  ribute verbatim \n-00011200: 636f 7069 6573 206f 6620 7468 6520 5072  copies of the Pr\n-00011210: 6f67 7261 6d27 7320 736f 7572 6365 0a20  ogram's source. \n-00011220: 2020 2020 636f 6465 2061 7320 796f 7520      code as you \n-00011230: 7265 6365 6976 6520 6974 2c20 696e 2061  receive it, in a\n-00011240: 6e79 206d 6564 6975 6d2c 2070 726f 7669  ny medium, provi\n-00011250: 6465 6420 7468 6174 2079 6f75 0a20 2020  ded that you.   \n-00011260: 2020 636f 6e73 7069 6375 6f75 736c 7920    conspicuously \n-00011270: 616e 6420 6170 7072 6f70 7269 6174 656c  and appropriatel\n-00011280: 7920 7075 626c 6973 6820 6f6e 2065 6163  y publish on eac\n-00011290: 6820 636f 7079 2061 6e20 6170 7072 6f70  h copy an approp\n-000112a0: 7269 6174 650a 2020 2020 2063 6f70 7972  riate.     copyr\n-000112b0: 6967 6874 206e 6f74 6963 6520 616e 6420  ight notice and \n-000112c0: 6469 7363 6c61 696d 6572 206f 6620 7761  disclaimer of wa\n-000112d0: 7272 616e 7479 3b20 6b65 6570 2069 6e74  rranty; keep int\n-000112e0: 6163 7420 616c 6c20 7468 650a 2020 2020  act all the.    \n-000112f0: 206e 6f74 6963 6573 2074 6861 7420 7265   notices that re\n-00011300: 6665 7220 746f 2074 6869 7320 4c69 6365  fer to this Lice\n-00011310: 6e73 6520 616e 6420 746f 2074 6865 2061  nse and to the a\n-00011320: 6273 656e 6365 206f 6620 616e 790a 2020  bsence of any.  \n-00011330: 2020 2077 6172 7261 6e74 793b 2061 6e64     warranty; and\n-00011340: 2067 6976 6520 616e 7920 6f74 6865 7220   give any other \n-00011350: 7265 6369 7069 656e 7473 206f 6620 7468  recipients of th\n-00011360: 6520 5072 6f67 7261 6d20 6120 636f 7079  e Program a copy\n-00011370: 206f 660a 2020 2020 2074 6869 7320 4c69   of.     this Li\n-00011380: 6365 6e73 6520 616c 6f6e 6720 7769 7468  cense along with\n-00011390: 2074 6865 2050 726f 6772 616d 2e0a 0a20   the Program... \n-000113a0: 2020 2020 596f 7520 6d61 7920 6368 6172      You may char\n-000113b0: 6765 2061 2066 6565 2066 6f72 2074 6865  ge a fee for the\n-000113c0: 2070 6879 7369 6361 6c20 6163 7420 6f66   physical act of\n-000113d0: 2074 7261 6e73 6665 7272 696e 6720 6120   transferring a \n-000113e0: 636f 7079 2c0a 2020 2020 2061 6e64 2079  copy,.     and y\n-000113f0: 6f75 206d 6179 2061 7420 796f 7572 206f  ou may at your o\n-00011400: 7074 696f 6e20 6f66 6665 7220 7761 7272  ption offer warr\n-00011410: 616e 7479 2070 726f 7465 6374 696f 6e20  anty protection \n-00011420: 696e 2065 7863 6861 6e67 650a 2020 2020  in exchange.    \n-00011430: 2066 6f72 2061 2066 6565 2e0a 0a20 2032   for a fee...  2\n-00011440: 2e20 596f 7520 6d61 7920 6d6f 6469 6679  . You may modify\n-00011450: 2079 6f75 7220 636f 7079 206f 7220 636f   your copy or co\n-00011460: 7069 6573 206f 6620 7468 6520 5072 6f67  pies of the Prog\n-00011470: 7261 6d20 6f72 2061 6e79 2070 6f72 7469  ram or any porti\n-00011480: 6f6e 206f 660a 2020 2020 2069 742c 2074  on of.     it, t\n-00011490: 6875 7320 666f 726d 696e 6720 6120 776f  hus forming a wo\n-000114a0: 726b 2062 6173 6564 206f 6e20 7468 6520  rk based on the \n-000114b0: 5072 6f67 7261 6d2c 2061 6e64 2063 6f70  Program, and cop\n-000114c0: 7920 616e 640a 2020 2020 2064 6973 7472  y and.     distr\n-000114d0: 6962 7574 6520 7375 6368 206d 6f64 6966  ibute such modif\n-000114e0: 6963 6174 696f 6e73 206f 7220 776f 726b  ications or work\n-000114f0: 2075 6e64 6572 2074 6865 2074 6572 6d73   under the terms\n-00011500: 206f 6620 5365 6374 696f 6e20 310a 2020   of Section 1.  \n-00011510: 2020 2061 626f 7665 2c20 7072 6f76 6964     above, provid\n-00011520: 6564 2074 6861 7420 796f 7520 616c 736f  ed that you also\n-00011530: 206d 6565 7420 616c 6c20 6f66 2074 6865   meet all of the\n-00011540: 7365 2063 6f6e 6469 7469 6f6e 733a 0a0a  se conditions:..\n-00011550: 2020 2020 2020 2061 2e20 596f 7520 6d75         a. You mu\n-00011560: 7374 2063 6175 7365 2074 6865 206d 6f64  st cause the mod\n-00011570: 6966 6965 6420 6669 6c65 7320 746f 2063  ified files to c\n-00011580: 6172 7279 2070 726f 6d69 6e65 6e74 206e  arry prominent n\n-00011590: 6f74 6963 6573 0a20 2020 2020 2020 2020  otices.         \n-000115a0: 2073 7461 7469 6e67 2074 6861 7420 796f   stating that yo\n-000115b0: 7520 6368 616e 6765 6420 7468 6520 6669  u changed the fi\n-000115c0: 6c65 7320 616e 6420 7468 6520 6461 7465  les and the date\n-000115d0: 206f 6620 616e 7920 6368 616e 6765 2e0a   of any change..\n-000115e0: 0a20 2020 2020 2020 622e 2059 6f75 206d  .       b. You m\n-000115f0: 7573 7420 6361 7573 6520 616e 7920 776f  ust cause any wo\n-00011600: 726b 2074 6861 7420 796f 7520 6469 7374  rk that you dist\n-00011610: 7269 6275 7465 206f 7220 7075 626c 6973  ribute or publis\n-00011620: 682c 2074 6861 740a 2020 2020 2020 2020  h, that.        \n-00011630: 2020 696e 2077 686f 6c65 206f 7220 696e    in whole or in\n-00011640: 2070 6172 7420 636f 6e74 6169 6e73 206f   part contains o\n-00011650: 7220 6973 2064 6572 6976 6564 2066 726f  r is derived fro\n-00011660: 6d20 7468 6520 5072 6f67 7261 6d20 6f72  m the Program or\n-00011670: 0a20 2020 2020 2020 2020 2061 6e79 2070  .          any p\n-00011680: 6172 7420 7468 6572 656f 662c 2074 6f20  art thereof, to \n-00011690: 6265 206c 6963 656e 7365 6420 6173 2061  be licensed as a\n-000116a0: 2077 686f 6c65 2061 7420 6e6f 2063 6861   whole at no cha\n-000116b0: 7267 6520 746f 0a20 2020 2020 2020 2020  rge to.         \n-000116c0: 2061 6c6c 2074 6869 7264 2070 6172 7469   all third parti\n-000116d0: 6573 2075 6e64 6572 2074 6865 2074 6572  es under the ter\n-000116e0: 6d73 206f 6620 7468 6973 204c 6963 656e  ms of this Licen\n-000116f0: 7365 2e0a 0a20 2020 2020 2020 632e 2049  se...       c. I\n-00011700: 6620 7468 6520 6d6f 6469 6669 6564 2070  f the modified p\n-00011710: 726f 6772 616d 206e 6f72 6d61 6c6c 7920  rogram normally \n-00011720: 7265 6164 7320 636f 6d6d 616e 6473 2069  reads commands i\n-00011730: 6e74 6572 6163 7469 7665 6c79 0a20 2020  nteractively.   \n-00011740: 2020 2020 2020 2077 6865 6e20 7275 6e2c         when run,\n-00011750: 2079 6f75 206d 7573 7420 6361 7573 6520   you must cause \n-00011760: 6974 2c20 7768 656e 2073 7461 7274 6564  it, when started\n-00011770: 2072 756e 6e69 6e67 2066 6f72 2073 7563   running for suc\n-00011780: 680a 2020 2020 2020 2020 2020 696e 7465  h.          inte\n-00011790: 7261 6374 6976 6520 7573 6520 696e 2074  ractive use in t\n-000117a0: 6865 206d 6f73 7420 6f72 6469 6e61 7279  he most ordinary\n-000117b0: 2077 6179 2c20 746f 2070 7269 6e74 206f   way, to print o\n-000117c0: 7220 6469 7370 6c61 790a 2020 2020 2020  r display.      \n-000117d0: 2020 2020 616e 2061 6e6e 6f75 6e63 656d      an announcem\n-000117e0: 656e 7420 696e 636c 7564 696e 6720 616e  ent including an\n-000117f0: 2061 7070 726f 7072 6961 7465 2063 6f70   appropriate cop\n-00011800: 7972 6967 6874 206e 6f74 6963 6520 616e  yright notice an\n-00011810: 640a 2020 2020 2020 2020 2020 6120 6e6f  d.          a no\n-00011820: 7469 6365 2074 6861 7420 7468 6572 6520  tice that there \n-00011830: 6973 206e 6f20 7761 7272 616e 7479 2028  is no warranty (\n-00011840: 6f72 2065 6c73 652c 2073 6179 696e 6720  or else, saying \n-00011850: 7468 6174 2079 6f75 0a20 2020 2020 2020  that you.       \n-00011860: 2020 2070 726f 7669 6465 2061 2077 6172     provide a war\n-00011870: 7261 6e74 7929 2061 6e64 2074 6861 7420  ranty) and that \n-00011880: 7573 6572 7320 6d61 7920 7265 6469 7374  users may redist\n-00011890: 7269 6275 7465 2074 6865 0a20 2020 2020  ribute the.     \n-000118a0: 2020 2020 2070 726f 6772 616d 2075 6e64       program und\n-000118b0: 6572 2074 6865 7365 2063 6f6e 6469 7469  er these conditi\n-000118c0: 6f6e 732c 2061 6e64 2074 656c 6c69 6e67  ons, and telling\n-000118d0: 2074 6865 2075 7365 7220 686f 7720 746f   the user how to\n-000118e0: 0a20 2020 2020 2020 2020 2076 6965 7720  .          view \n-000118f0: 6120 636f 7079 206f 6620 7468 6973 204c  a copy of this L\n-00011900: 6963 656e 7365 2e20 2028 4578 6365 7074  icense.  (Except\n-00011910: 696f 6e3a 2069 6620 7468 6520 5072 6f67  ion: if the Prog\n-00011920: 7261 6d0a 2020 2020 2020 2020 2020 6974  ram.          it\n-00011930: 7365 6c66 2069 7320 696e 7465 7261 6374  self is interact\n-00011940: 6976 6520 6275 7420 646f 6573 206e 6f74  ive but does not\n-00011950: 206e 6f72 6d61 6c6c 7920 7072 696e 7420   normally print \n-00011960: 7375 6368 2061 6e0a 2020 2020 2020 2020  such an.        \n-00011970: 2020 616e 6e6f 756e 6365 6d65 6e74 2c20    announcement, \n-00011980: 796f 7572 2077 6f72 6b20 6261 7365 6420  your work based \n-00011990: 6f6e 2074 6865 2050 726f 6772 616d 2069  on the Program i\n-000119a0: 7320 6e6f 7420 7265 7175 6972 6564 0a20  s not required. \n-000119b0: 2020 2020 2020 2020 2074 6f20 7072 696e           to prin\n-000119c0: 7420 616e 2061 6e6e 6f75 6e63 656d 656e  t an announcemen\n-000119d0: 742e 290a 0a20 2020 2020 5468 6573 6520  t.)..     These \n-000119e0: 7265 7175 6972 656d 656e 7473 2061 7070  requirements app\n-000119f0: 6c79 2074 6f20 7468 6520 6d6f 6469 6669  ly to the modifi\n-00011a00: 6564 2077 6f72 6b20 6173 2061 2077 686f  ed work as a who\n-00011a10: 6c65 2e20 2049 660a 2020 2020 2069 6465  le.  If.     ide\n-00011a20: 6e74 6966 6961 626c 6520 7365 6374 696f  ntifiable sectio\n-00011a30: 6e73 206f 6620 7468 6174 2077 6f72 6b20  ns of that work \n-00011a40: 6172 6520 6e6f 7420 6465 7269 7665 6420  are not derived \n-00011a50: 6672 6f6d 2074 6865 0a20 2020 2020 5072  from the.     Pr\n-00011a60: 6f67 7261 6d2c 2061 6e64 2063 616e 2062  ogram, and can b\n-00011a70: 6520 7265 6173 6f6e 6162 6c79 2063 6f6e  e reasonably con\n-00011a80: 7369 6465 7265 6420 696e 6465 7065 6e64  sidered independ\n-00011a90: 656e 7420 616e 6420 7365 7061 7261 7465  ent and separate\n-00011aa0: 0a20 2020 2020 776f 726b 7320 696e 2074  .     works in t\n-00011ab0: 6865 6d73 656c 7665 732c 2074 6865 6e20  hemselves, then \n-00011ac0: 7468 6973 204c 6963 656e 7365 2c20 616e  this License, an\n-00011ad0: 6420 6974 7320 7465 726d 732c 2064 6f20  d its terms, do \n-00011ae0: 6e6f 7420 6170 706c 790a 2020 2020 2074  not apply.     t\n-00011af0: 6f20 7468 6f73 6520 7365 6374 696f 6e73  o those sections\n-00011b00: 2077 6865 6e20 796f 7520 6469 7374 7269   when you distri\n-00011b10: 6275 7465 2074 6865 6d20 6173 2073 6570  bute them as sep\n-00011b20: 6172 6174 6520 776f 726b 732e 2020 4275  arate works.  Bu\n-00011b30: 740a 2020 2020 2077 6865 6e20 796f 7520  t.     when you \n-00011b40: 6469 7374 7269 6275 7465 2074 6865 2073  distribute the s\n-00011b50: 616d 6520 7365 6374 696f 6e73 2061 7320  ame sections as \n-00011b60: 7061 7274 206f 6620 6120 7768 6f6c 6520  part of a whole \n-00011b70: 7768 6963 6820 6973 2061 0a20 2020 2020  which is a.     \n-00011b80: 776f 726b 2062 6173 6564 206f 6e20 7468  work based on th\n-00011b90: 6520 5072 6f67 7261 6d2c 2074 6865 2064  e Program, the d\n-00011ba0: 6973 7472 6962 7574 696f 6e20 6f66 2074  istribution of t\n-00011bb0: 6865 2077 686f 6c65 206d 7573 7420 6265  he whole must be\n-00011bc0: 206f 6e0a 2020 2020 2074 6865 2074 6572   on.     the ter\n-00011bd0: 6d73 206f 6620 7468 6973 204c 6963 656e  ms of this Licen\n-00011be0: 7365 2c20 7768 6f73 6520 7065 726d 6973  se, whose permis\n-00011bf0: 7369 6f6e 7320 666f 7220 6f74 6865 7220  sions for other \n-00011c00: 6c69 6365 6e73 6565 730a 2020 2020 2065  licensees.     e\n-00011c10: 7874 656e 6420 746f 2074 6865 2065 6e74  xtend to the ent\n-00011c20: 6972 6520 7768 6f6c 652c 2061 6e64 2074  ire whole, and t\n-00011c30: 6875 7320 746f 2065 6163 6820 616e 6420  hus to each and \n-00011c40: 6576 6572 7920 7061 7274 0a20 2020 2020  every part.     \n-00011c50: 7265 6761 7264 6c65 7373 206f 6620 7768  regardless of wh\n-00011c60: 6f20 7772 6f74 6520 6974 2e0a 0a20 2020  o wrote it...   \n-00011c70: 2020 5468 7573 2c20 6974 2069 7320 6e6f    Thus, it is no\n-00011c80: 7420 7468 6520 696e 7465 6e74 206f 6620  t the intent of \n-00011c90: 7468 6973 2073 6563 7469 6f6e 2074 6f20  this section to \n-00011ca0: 636c 6169 6d20 7269 6768 7473 206f 720a  claim rights or.\n-00011cb0: 2020 2020 2063 6f6e 7465 7374 2079 6f75       contest you\n-00011cc0: 7220 7269 6768 7473 2074 6f20 776f 726b  r rights to work\n-00011cd0: 2077 7269 7474 656e 2065 6e74 6972 656c   written entirel\n-00011ce0: 7920 6279 2079 6f75 3b20 7261 7468 6572  y by you; rather\n-00011cf0: 2c20 7468 650a 2020 2020 2069 6e74 656e  , the.     inten\n-00011d00: 7420 6973 2074 6f20 6578 6572 6369 7365  t is to exercise\n-00011d10: 2074 6865 2072 6967 6874 2074 6f20 636f   the right to co\n-00011d20: 6e74 726f 6c20 7468 6520 6469 7374 7269  ntrol the distri\n-00011d30: 6275 7469 6f6e 206f 660a 2020 2020 2064  bution of.     d\n-00011d40: 6572 6976 6174 6976 6520 6f72 2063 6f6c  erivative or col\n-00011d50: 6c65 6374 6976 6520 776f 726b 7320 6261  lective works ba\n-00011d60: 7365 6420 6f6e 2074 6865 2050 726f 6772  sed on the Progr\n-00011d70: 616d 2e0a 0a20 2020 2020 496e 2061 6464  am...     In add\n-00011d80: 6974 696f 6e2c 206d 6572 6520 6167 6772  ition, mere aggr\n-00011d90: 6567 6174 696f 6e20 6f66 2061 6e6f 7468  egation of anoth\n-00011da0: 6572 2077 6f72 6b20 6e6f 7420 6261 7365  er work not base\n-00011db0: 6420 6f6e 2074 6865 0a20 2020 2020 5072  d on the.     Pr\n-00011dc0: 6f67 7261 6d20 7769 7468 2074 6865 2050  ogram with the P\n-00011dd0: 726f 6772 616d 2028 6f72 2077 6974 6820  rogram (or with \n-00011de0: 6120 776f 726b 2062 6173 6564 206f 6e20  a work based on \n-00011df0: 7468 6520 5072 6f67 7261 6d29 206f 6e20  the Program) on \n-00011e00: 610a 2020 2020 2076 6f6c 756d 6520 6f66  a.     volume of\n-00011e10: 2061 2073 746f 7261 6765 206f 7220 6469   a storage or di\n-00011e20: 7374 7269 6275 7469 6f6e 206d 6564 6975  stribution mediu\n-00011e30: 6d20 646f 6573 206e 6f74 2062 7269 6e67  m does not bring\n-00011e40: 2074 6865 206f 7468 6572 0a20 2020 2020   the other.     \n-00011e50: 776f 726b 2075 6e64 6572 2074 6865 2073  work under the s\n-00011e60: 636f 7065 206f 6620 7468 6973 204c 6963  cope of this Lic\n-00011e70: 656e 7365 2e0a 0a20 2033 2e20 596f 7520  ense...  3. You \n-00011e80: 6d61 7920 636f 7079 2061 6e64 2064 6973  may copy and dis\n-00011e90: 7472 6962 7574 6520 7468 6520 5072 6f67  tribute the Prog\n-00011ea0: 7261 6d20 286f 7220 6120 776f 726b 2062  ram (or a work b\n-00011eb0: 6173 6564 206f 6e20 6974 2c0a 2020 2020  ased on it,.    \n-00011ec0: 2075 6e64 6572 2053 6563 7469 6f6e 2032   under Section 2\n-00011ed0: 2920 696e 206f 626a 6563 7420 636f 6465  ) in object code\n-00011ee0: 206f 7220 6578 6563 7574 6162 6c65 2066   or executable f\n-00011ef0: 6f72 6d20 756e 6465 7220 7468 6520 7465  orm under the te\n-00011f00: 726d 730a 2020 2020 206f 6620 5365 6374  rms.     of Sect\n-00011f10: 696f 6e73 2031 2061 6e64 2032 2061 626f  ions 1 and 2 abo\n-00011f20: 7665 2070 726f 7669 6465 6420 7468 6174  ve provided that\n-00011f30: 2079 6f75 2061 6c73 6f20 646f 206f 6e65   you also do one\n-00011f40: 206f 6620 7468 650a 2020 2020 2066 6f6c   of the.     fol\n-00011f50: 6c6f 7769 6e67 3a0a 0a20 2020 2020 2020  lowing:..       \n-00011f60: 612e 2041 6363 6f6d 7061 6e79 2069 7420  a. Accompany it \n-00011f70: 7769 7468 2074 6865 2063 6f6d 706c 6574  with the complet\n-00011f80: 6520 636f 7272 6573 706f 6e64 696e 6720  e corresponding \n-00011f90: 6d61 6368 696e 652d 7265 6164 6162 6c65  machine-readable\n-00011fa0: 0a20 2020 2020 2020 2020 2073 6f75 7263  .          sourc\n-00011fb0: 6520 636f 6465 2c20 7768 6963 6820 6d75  e code, which mu\n-00011fc0: 7374 2062 6520 6469 7374 7269 6275 7465  st be distribute\n-00011fd0: 6420 756e 6465 7220 7468 6520 7465 726d  d under the term\n-00011fe0: 7320 6f66 0a20 2020 2020 2020 2020 2053  s of.          S\n-00011ff0: 6563 7469 6f6e 7320 3120 616e 6420 3220  ections 1 and 2 \n-00012000: 6162 6f76 6520 6f6e 2061 206d 6564 6975  above on a mediu\n-00012010: 6d20 6375 7374 6f6d 6172 696c 7920 7573  m customarily us\n-00012020: 6564 2066 6f72 0a20 2020 2020 2020 2020  ed for.         \n-00012030: 2073 6f66 7477 6172 6520 696e 7465 7263   software interc\n-00012040: 6861 6e67 653b 206f 722c 0a0a 2020 2020  hange; or,..    \n-00012050: 2020 2062 2e20 4163 636f 6d70 616e 7920     b. Accompany \n-00012060: 6974 2077 6974 6820 6120 7772 6974 7465  it with a writte\n-00012070: 6e20 6f66 6665 722c 2076 616c 6964 2066  n offer, valid f\n-00012080: 6f72 2061 7420 6c65 6173 7420 7468 7265  or at least thre\n-00012090: 650a 2020 2020 2020 2020 2020 7965 6172  e.          year\n-000120a0: 732c 2074 6f20 6769 7665 2061 6e79 2074  s, to give any t\n-000120b0: 6869 7264 2070 6172 7479 2c20 666f 7220  hird party, for \n-000120c0: 6120 6368 6172 6765 206e 6f20 6d6f 7265  a charge no more\n-000120d0: 2074 6861 6e20 796f 7572 0a20 2020 2020   than your.     \n-000120e0: 2020 2020 2063 6f73 7420 6f66 2070 6879       cost of phy\n-000120f0: 7369 6361 6c6c 7920 7065 7266 6f72 6d69  sically performi\n-00012100: 6e67 2073 6f75 7263 6520 6469 7374 7269  ng source distri\n-00012110: 6275 7469 6f6e 2c20 6120 636f 6d70 6c65  bution, a comple\n-00012120: 7465 0a20 2020 2020 2020 2020 206d 6163  te.          mac\n-00012130: 6869 6e65 2d72 6561 6461 626c 6520 636f  hine-readable co\n-00012140: 7079 206f 6620 7468 6520 636f 7272 6573  py of the corres\n-00012150: 706f 6e64 696e 6720 736f 7572 6365 2063  ponding source c\n-00012160: 6f64 652c 2074 6f20 6265 0a20 2020 2020  ode, to be.     \n-00012170: 2020 2020 2064 6973 7472 6962 7574 6564       distributed\n-00012180: 2075 6e64 6572 2074 6865 2074 6572 6d73   under the terms\n-00012190: 206f 6620 5365 6374 696f 6e73 2031 2061   of Sections 1 a\n-000121a0: 6e64 2032 2061 626f 7665 206f 6e20 610a  nd 2 above on a.\n-000121b0: 2020 2020 2020 2020 2020 6d65 6469 756d            medium\n-000121c0: 2063 7573 746f 6d61 7269 6c79 2075 7365   customarily use\n-000121d0: 6420 666f 7220 736f 6674 7761 7265 2069  d for software i\n-000121e0: 6e74 6572 6368 616e 6765 3b20 6f72 2c0a  nterchange; or,.\n-000121f0: 0a20 2020 2020 2020 632e 2041 6363 6f6d  .       c. Accom\n-00012200: 7061 6e79 2069 7420 7769 7468 2074 6865  pany it with the\n-00012210: 2069 6e66 6f72 6d61 7469 6f6e 2079 6f75   information you\n-00012220: 2072 6563 6569 7665 6420 6173 2074 6f20   received as to \n-00012230: 7468 6520 6f66 6665 720a 2020 2020 2020  the offer.      \n-00012240: 2020 2020 746f 2064 6973 7472 6962 7574      to distribut\n-00012250: 6520 636f 7272 6573 706f 6e64 696e 6720  e corresponding \n-00012260: 736f 7572 6365 2063 6f64 652e 2020 2854  source code.  (T\n-00012270: 6869 7320 616c 7465 726e 6174 6976 6520  his alternative \n-00012280: 6973 0a20 2020 2020 2020 2020 2061 6c6c  is.          all\n-00012290: 6f77 6564 206f 6e6c 7920 666f 7220 6e6f  owed only for no\n-000122a0: 6e63 6f6d 6d65 7263 6961 6c20 6469 7374  ncommercial dist\n-000122b0: 7269 6275 7469 6f6e 2061 6e64 206f 6e6c  ribution and onl\n-000122c0: 7920 6966 2079 6f75 0a20 2020 2020 2020  y if you.       \n-000122d0: 2020 2072 6563 6569 7665 6420 7468 6520     received the \n-000122e0: 7072 6f67 7261 6d20 696e 206f 626a 6563  program in objec\n-000122f0: 7420 636f 6465 206f 7220 6578 6563 7574  t code or execut\n-00012300: 6162 6c65 2066 6f72 6d20 7769 7468 0a20  able form with. \n-00012310: 2020 2020 2020 2020 2073 7563 6820 616e           such an\n-00012320: 206f 6666 6572 2c20 696e 2061 6363 6f72   offer, in accor\n-00012330: 6420 7769 7468 2053 7562 7365 6374 696f  d with Subsectio\n-00012340: 6e20 6220 6162 6f76 652e 290a 0a20 2020  n b above.)..   \n-00012350: 2020 5468 6520 736f 7572 6365 2063 6f64    The source cod\n-00012360: 6520 666f 7220 6120 776f 726b 206d 6561  e for a work mea\n-00012370: 6e73 2074 6865 2070 7265 6665 7272 6564  ns the preferred\n-00012380: 2066 6f72 6d20 6f66 2074 6865 2077 6f72   form of the wor\n-00012390: 6b20 666f 720a 2020 2020 206d 616b 696e  k for.     makin\n-000123a0: 6720 6d6f 6469 6669 6361 7469 6f6e 7320  g modifications \n-000123b0: 746f 2069 742e 2020 466f 7220 616e 2065  to it.  For an e\n-000123c0: 7865 6375 7461 626c 6520 776f 726b 2c20  xecutable work, \n-000123d0: 636f 6d70 6c65 7465 0a20 2020 2020 736f  complete.     so\n-000123e0: 7572 6365 2063 6f64 6520 6d65 616e 7320  urce code means \n-000123f0: 616c 6c20 7468 6520 736f 7572 6365 2063  all the source c\n-00012400: 6f64 6520 666f 7220 616c 6c20 6d6f 6475  ode for all modu\n-00012410: 6c65 7320 6974 2063 6f6e 7461 696e 732c  les it contains,\n-00012420: 0a20 2020 2020 706c 7573 2061 6e79 2061  .     plus any a\n-00012430: 7373 6f63 6961 7465 6420 696e 7465 7266  ssociated interf\n-00012440: 6163 6520 6465 6669 6e69 7469 6f6e 2066  ace definition f\n-00012450: 696c 6573 2c20 706c 7573 2074 6865 2073  iles, plus the s\n-00012460: 6372 6970 7473 0a20 2020 2020 7573 6564  cripts.     used\n-00012470: 2074 6f20 636f 6e74 726f 6c20 636f 6d70   to control comp\n-00012480: 696c 6174 696f 6e20 616e 6420 696e 7374  ilation and inst\n-00012490: 616c 6c61 7469 6f6e 206f 6620 7468 6520  allation of the \n-000124a0: 6578 6563 7574 6162 6c65 2e0a 2020 2020  executable..    \n-000124b0: 2048 6f77 6576 6572 2c20 6173 2061 2073   However, as a s\n-000124c0: 7065 6369 616c 2065 7863 6570 7469 6f6e  pecial exception\n-000124d0: 2c20 7468 6520 736f 7572 6365 2063 6f64  , the source cod\n-000124e0: 6520 6469 7374 7269 6275 7465 6420 6e65  e distributed ne\n-000124f0: 6564 0a20 2020 2020 6e6f 7420 696e 636c  ed.     not incl\n-00012500: 7564 6520 616e 7974 6869 6e67 2074 6861  ude anything tha\n-00012510: 7420 6973 206e 6f72 6d61 6c6c 7920 6469  t is normally di\n-00012520: 7374 7269 6275 7465 6420 2869 6e20 6569  stributed (in ei\n-00012530: 7468 6572 2073 6f75 7263 650a 2020 2020  ther source.    \n-00012540: 206f 7220 6269 6e61 7279 2066 6f72 6d29   or binary form)\n-00012550: 2077 6974 6820 7468 6520 6d61 6a6f 7220   with the major \n-00012560: 636f 6d70 6f6e 656e 7473 2028 636f 6d70  components (comp\n-00012570: 696c 6572 2c20 6b65 726e 656c 2c20 616e  iler, kernel, an\n-00012580: 6420 736f 0a20 2020 2020 6f6e 2920 6f66  d so.     on) of\n-00012590: 2074 6865 206f 7065 7261 7469 6e67 2073   the operating s\n-000125a0: 7973 7465 6d20 6f6e 2077 6869 6368 2074  ystem on which t\n-000125b0: 6865 2065 7865 6375 7461 626c 6520 7275  he executable ru\n-000125c0: 6e73 2c20 756e 6c65 7373 0a20 2020 2020  ns, unless.     \n-000125d0: 7468 6174 2063 6f6d 706f 6e65 6e74 2069  that component i\n-000125e0: 7473 656c 6620 6163 636f 6d70 616e 6965  tself accompanie\n-000125f0: 7320 7468 6520 6578 6563 7574 6162 6c65  s the executable\n-00012600: 2e0a 0a20 2020 2020 4966 2064 6973 7472  ...     If distr\n-00012610: 6962 7574 696f 6e20 6f66 2065 7865 6375  ibution of execu\n-00012620: 7461 626c 6520 6f72 206f 626a 6563 7420  table or object \n-00012630: 636f 6465 2069 7320 6d61 6465 2062 7920  code is made by \n-00012640: 6f66 6665 7269 6e67 0a20 2020 2020 6163  offering.     ac\n-00012650: 6365 7373 2074 6f20 636f 7079 2066 726f  cess to copy fro\n-00012660: 6d20 6120 6465 7369 676e 6174 6564 2070  m a designated p\n-00012670: 6c61 6365 2c20 7468 656e 206f 6666 6572  lace, then offer\n-00012680: 696e 6720 6571 7569 7661 6c65 6e74 0a20  ing equivalent. \n-00012690: 2020 2020 6163 6365 7373 2074 6f20 636f      access to co\n-000126a0: 7079 2074 6865 2073 6f75 7263 6520 636f  py the source co\n-000126b0: 6465 2066 726f 6d20 7468 6520 7361 6d65  de from the same\n-000126c0: 2070 6c61 6365 2063 6f75 6e74 7320 6173   place counts as\n-000126d0: 0a20 2020 2020 6469 7374 7269 6275 7469  .     distributi\n-000126e0: 6f6e 206f 6620 7468 6520 736f 7572 6365  on of the source\n-000126f0: 2063 6f64 652c 2065 7665 6e20 7468 6f75   code, even thou\n-00012700: 6768 2074 6869 7264 2070 6172 7469 6573  gh third parties\n-00012710: 2061 7265 206e 6f74 0a20 2020 2020 636f   are not.     co\n-00012720: 6d70 656c 6c65 6420 746f 2063 6f70 7920  mpelled to copy \n-00012730: 7468 6520 736f 7572 6365 2061 6c6f 6e67  the source along\n-00012740: 2077 6974 6820 7468 6520 6f62 6a65 6374   with the object\n-00012750: 2063 6f64 652e 0a0a 2020 342e 2059 6f75   code...  4. You\n-00012760: 206d 6179 206e 6f74 2063 6f70 792c 206d   may not copy, m\n-00012770: 6f64 6966 792c 2073 7562 6c69 6365 6e73  odify, sublicens\n-00012780: 652c 206f 7220 6469 7374 7269 6275 7465  e, or distribute\n-00012790: 2074 6865 2050 726f 6772 616d 0a20 2020   the Program.   \n-000127a0: 2020 6578 6365 7074 2061 7320 6578 7072    except as expr\n-000127b0: 6573 736c 7920 7072 6f76 6964 6564 2075  essly provided u\n-000127c0: 6e64 6572 2074 6869 7320 4c69 6365 6e73  nder this Licens\n-000127d0: 652e 2020 416e 7920 6174 7465 6d70 740a  e.  Any attempt.\n-000127e0: 2020 2020 206f 7468 6572 7769 7365 2074       otherwise t\n-000127f0: 6f20 636f 7079 2c20 6d6f 6469 6679 2c20  o copy, modify, \n-00012800: 7375 626c 6963 656e 7365 206f 7220 6469  sublicense or di\n-00012810: 7374 7269 6275 7465 2074 6865 2050 726f  stribute the Pro\n-00012820: 6772 616d 2069 730a 2020 2020 2076 6f69  gram is.     voi\n-00012830: 642c 2061 6e64 2077 696c 6c20 6175 746f  d, and will auto\n-00012840: 6d61 7469 6361 6c6c 7920 7465 726d 696e  matically termin\n-00012850: 6174 6520 796f 7572 2072 6967 6874 7320  ate your rights \n-00012860: 756e 6465 7220 7468 6973 0a20 2020 2020  under this.     \n-00012870: 4c69 6365 6e73 652e 2020 486f 7765 7665  License.  Howeve\n-00012880: 722c 2070 6172 7469 6573 2077 686f 2068  r, parties who h\n-00012890: 6176 6520 7265 6365 6976 6564 2063 6f70  ave received cop\n-000128a0: 6965 732c 206f 7220 7269 6768 7473 2c0a  ies, or rights,.\n-000128b0: 2020 2020 2066 726f 6d20 796f 7520 756e       from you un\n-000128c0: 6465 7220 7468 6973 204c 6963 656e 7365  der this License\n-000128d0: 2077 696c 6c20 6e6f 7420 6861 7665 2074   will not have t\n-000128e0: 6865 6972 206c 6963 656e 7365 7320 7465  heir licenses te\n-000128f0: 726d 696e 6174 6564 0a20 2020 2020 736f  rminated.     so\n-00012900: 206c 6f6e 6720 6173 2073 7563 6820 7061   long as such pa\n-00012910: 7274 6965 7320 7265 6d61 696e 2069 6e20  rties remain in \n-00012920: 6675 6c6c 2063 6f6d 706c 6961 6e63 652e  full compliance.\n-00012930: 0a0a 2020 352e 2059 6f75 2061 7265 206e  ..  5. You are n\n-00012940: 6f74 2072 6571 7569 7265 6420 746f 2061  ot required to a\n-00012950: 6363 6570 7420 7468 6973 204c 6963 656e  ccept this Licen\n-00012960: 7365 2c20 7369 6e63 6520 796f 7520 6861  se, since you ha\n-00012970: 7665 206e 6f74 0a20 2020 2020 7369 676e  ve not.     sign\n-00012980: 6564 2069 742e 2020 486f 7765 7665 722c  ed it.  However,\n-00012990: 206e 6f74 6869 6e67 2065 6c73 6520 6772   nothing else gr\n-000129a0: 616e 7473 2079 6f75 2070 6572 6d69 7373  ants you permiss\n-000129b0: 696f 6e20 746f 206d 6f64 6966 790a 2020  ion to modify.  \n-000129c0: 2020 206f 7220 6469 7374 7269 6275 7465     or distribute\n-000129d0: 2074 6865 2050 726f 6772 616d 206f 7220   the Program or \n-000129e0: 6974 7320 6465 7269 7661 7469 7665 2077  its derivative w\n-000129f0: 6f72 6b73 2e20 2054 6865 7365 2061 6374  orks.  These act\n-00012a00: 696f 6e73 0a20 2020 2020 6172 6520 7072  ions.     are pr\n-00012a10: 6f68 6962 6974 6564 2062 7920 6c61 7720  ohibited by law \n-00012a20: 6966 2079 6f75 2064 6f20 6e6f 7420 6163  if you do not ac\n-00012a30: 6365 7074 2074 6869 7320 4c69 6365 6e73  cept this Licens\n-00012a40: 652e 0a20 2020 2020 5468 6572 6566 6f72  e..     Therefor\n-00012a50: 652c 2062 7920 6d6f 6469 6679 696e 6720  e, by modifying \n-00012a60: 6f72 2064 6973 7472 6962 7574 696e 6720  or distributing \n-00012a70: 7468 6520 5072 6f67 7261 6d20 286f 7220  the Program (or \n-00012a80: 616e 7920 776f 726b 0a20 2020 2020 6261  any work.     ba\n-00012a90: 7365 6420 6f6e 2074 6865 2050 726f 6772  sed on the Progr\n-00012aa0: 616d 292c 2079 6f75 2069 6e64 6963 6174  am), you indicat\n-00012ab0: 6520 796f 7572 2061 6363 6570 7461 6e63  e your acceptanc\n-00012ac0: 6520 6f66 2074 6869 7320 4c69 6365 6e73  e of this Licens\n-00012ad0: 650a 2020 2020 2074 6f20 646f 2073 6f2c  e.     to do so,\n-00012ae0: 2061 6e64 2061 6c6c 2069 7473 2074 6572   and all its ter\n-00012af0: 6d73 2061 6e64 2063 6f6e 6469 7469 6f6e  ms and condition\n-00012b00: 7320 666f 7220 636f 7079 696e 672c 0a20  s for copying,. \n-00012b10: 2020 2020 6469 7374 7269 6275 7469 6e67      distributing\n-00012b20: 206f 7220 6d6f 6469 6679 696e 6720 7468   or modifying th\n-00012b30: 6520 5072 6f67 7261 6d20 6f72 2077 6f72  e Program or wor\n-00012b40: 6b73 2062 6173 6564 206f 6e20 6974 2e0a  ks based on it..\n-00012b50: 0a20 2036 2e20 4561 6368 2074 696d 6520  .  6. Each time \n-00012b60: 796f 7520 7265 6469 7374 7269 6275 7465  you redistribute\n-00012b70: 2074 6865 2050 726f 6772 616d 2028 6f72   the Program (or\n-00012b80: 2061 6e79 2077 6f72 6b20 6261 7365 6420   any work based \n-00012b90: 6f6e 2074 6865 0a20 2020 2020 5072 6f67  on the.     Prog\n-00012ba0: 7261 6d29 2c20 7468 6520 7265 6369 7069  ram), the recipi\n-00012bb0: 656e 7420 6175 746f 6d61 7469 6361 6c6c  ent automaticall\n-00012bc0: 7920 7265 6365 6976 6573 2061 206c 6963  y receives a lic\n-00012bd0: 656e 7365 2066 726f 6d20 7468 650a 2020  ense from the.  \n-00012be0: 2020 206f 7269 6769 6e61 6c20 6c69 6365     original lice\n-00012bf0: 6e73 6f72 2074 6f20 636f 7079 2c20 6469  nsor to copy, di\n-00012c00: 7374 7269 6275 7465 206f 7220 6d6f 6469  stribute or modi\n-00012c10: 6679 2074 6865 2050 726f 6772 616d 2073  fy the Program s\n-00012c20: 7562 6a65 6374 0a20 2020 2020 746f 2074  ubject.     to t\n-00012c30: 6865 7365 2074 6572 6d73 2061 6e64 2063  hese terms and c\n-00012c40: 6f6e 6469 7469 6f6e 732e 2020 596f 7520  onditions.  You \n-00012c50: 6d61 7920 6e6f 7420 696d 706f 7365 2061  may not impose a\n-00012c60: 6e79 2066 7572 7468 6572 0a20 2020 2020  ny further.     \n-00012c70: 7265 7374 7269 6374 696f 6e73 206f 6e20  restrictions on \n-00012c80: 7468 6520 7265 6369 7069 656e 7473 2720  the recipients' \n-00012c90: 6578 6572 6369 7365 206f 6620 7468 6520  exercise of the \n-00012ca0: 7269 6768 7473 2067 7261 6e74 6564 0a20  rights granted. \n-00012cb0: 2020 2020 6865 7265 696e 2e20 2059 6f75      herein.  You\n-00012cc0: 2061 7265 206e 6f74 2072 6573 706f 6e73   are not respons\n-00012cd0: 6962 6c65 2066 6f72 2065 6e66 6f72 6369  ible for enforci\n-00012ce0: 6e67 2063 6f6d 706c 6961 6e63 6520 6279  ng compliance by\n-00012cf0: 2074 6869 7264 0a20 2020 2020 7061 7274   third.     part\n-00012d00: 6965 7320 746f 2074 6869 7320 4c69 6365  ies to this Lice\n-00012d10: 6e73 652e 0a0a 2020 372e 2049 662c 2061  nse...  7. If, a\n-00012d20: 7320 6120 636f 6e73 6571 7565 6e63 6520  s a consequence \n-00012d30: 6f66 2061 2063 6f75 7274 206a 7564 676d  of a court judgm\n-00012d40: 656e 7420 6f72 2061 6c6c 6567 6174 696f  ent or allegatio\n-00012d50: 6e20 6f66 2070 6174 656e 740a 2020 2020  n of patent.    \n-00012d60: 2069 6e66 7269 6e67 656d 656e 7420 6f72   infringement or\n-00012d70: 2066 6f72 2061 6e79 206f 7468 6572 2072   for any other r\n-00012d80: 6561 736f 6e20 286e 6f74 206c 696d 6974  eason (not limit\n-00012d90: 6564 2074 6f20 7061 7465 6e74 0a20 2020  ed to patent.   \n-00012da0: 2020 6973 7375 6573 292c 2063 6f6e 6469    issues), condi\n-00012db0: 7469 6f6e 7320 6172 6520 696d 706f 7365  tions are impose\n-00012dc0: 6420 6f6e 2079 6f75 2028 7768 6574 6865  d on you (whethe\n-00012dd0: 7220 6279 2063 6f75 7274 206f 7264 6572  r by court order\n-00012de0: 2c0a 2020 2020 2061 6772 6565 6d65 6e74  ,.     agreement\n-00012df0: 206f 7220 6f74 6865 7277 6973 6529 2074   or otherwise) t\n-00012e00: 6861 7420 636f 6e74 7261 6469 6374 2074  hat contradict t\n-00012e10: 6865 2063 6f6e 6469 7469 6f6e 7320 6f66  he conditions of\n-00012e20: 2074 6869 730a 2020 2020 204c 6963 656e   this.     Licen\n-00012e30: 7365 2c20 7468 6579 2064 6f20 6e6f 7420  se, they do not \n-00012e40: 6578 6375 7365 2079 6f75 2066 726f 6d20  excuse you from \n-00012e50: 7468 6520 636f 6e64 6974 696f 6e73 206f  the conditions o\n-00012e60: 6620 7468 6973 0a20 2020 2020 4c69 6365  f this.     Lice\n-00012e70: 6e73 652e 2020 4966 2079 6f75 2063 616e  nse.  If you can\n-00012e80: 6e6f 7420 6469 7374 7269 6275 7465 2073  not distribute s\n-00012e90: 6f20 6173 2074 6f20 7361 7469 7366 7920  o as to satisfy \n-00012ea0: 7369 6d75 6c74 616e 656f 7573 6c79 0a20  simultaneously. \n-00012eb0: 2020 2020 796f 7572 206f 626c 6967 6174      your obligat\n-00012ec0: 696f 6e73 2075 6e64 6572 2074 6869 7320  ions under this \n-00012ed0: 4c69 6365 6e73 6520 616e 6420 616e 7920  License and any \n-00012ee0: 6f74 6865 7220 7065 7274 696e 656e 740a  other pertinent.\n-00012ef0: 2020 2020 206f 626c 6967 6174 696f 6e73       obligations\n-00012f00: 2c20 7468 656e 2061 7320 6120 636f 6e73  , then as a cons\n-00012f10: 6571 7565 6e63 6520 796f 7520 6d61 7920  equence you may \n-00012f20: 6e6f 7420 6469 7374 7269 6275 7465 2074  not distribute t\n-00012f30: 6865 0a20 2020 2020 5072 6f67 7261 6d20  he.     Program \n-00012f40: 6174 2061 6c6c 2e20 2046 6f72 2065 7861  at all.  For exa\n-00012f50: 6d70 6c65 2c20 6966 2061 2070 6174 656e  mple, if a paten\n-00012f60: 7420 6c69 6365 6e73 6520 776f 756c 6420  t license would \n-00012f70: 6e6f 7420 7065 726d 6974 0a20 2020 2020  not permit.     \n-00012f80: 726f 7961 6c74 792d 6672 6565 2072 6564  royalty-free red\n-00012f90: 6973 7472 6962 7574 696f 6e20 6f66 2074  istribution of t\n-00012fa0: 6865 2050 726f 6772 616d 2062 7920 616c  he Program by al\n-00012fb0: 6c20 7468 6f73 6520 7768 6f20 7265 6365  l those who rece\n-00012fc0: 6976 650a 2020 2020 2063 6f70 6965 7320  ive.     copies \n-00012fd0: 6469 7265 6374 6c79 206f 7220 696e 6469  directly or indi\n-00012fe0: 7265 6374 6c79 2074 6872 6f75 6768 2079  rectly through y\n-00012ff0: 6f75 2c20 7468 656e 2074 6865 206f 6e6c  ou, then the onl\n-00013000: 7920 7761 7920 796f 750a 2020 2020 2063  y way you.     c\n-00013010: 6f75 6c64 2073 6174 6973 6679 2062 6f74  ould satisfy bot\n-00013020: 6820 6974 2061 6e64 2074 6869 7320 4c69  h it and this Li\n-00013030: 6365 6e73 6520 776f 756c 6420 6265 2074  cense would be t\n-00013040: 6f20 7265 6672 6169 6e20 656e 7469 7265  o refrain entire\n-00013050: 6c79 0a20 2020 2020 6672 6f6d 2064 6973  ly.     from dis\n-00013060: 7472 6962 7574 696f 6e20 6f66 2074 6865  tribution of the\n-00013070: 2050 726f 6772 616d 2e0a 0a20 2020 2020   Program...     \n-00013080: 4966 2061 6e79 2070 6f72 7469 6f6e 206f  If any portion o\n-00013090: 6620 7468 6973 2073 6563 7469 6f6e 2069  f this section i\n-000130a0: 7320 6865 6c64 2069 6e76 616c 6964 206f  s held invalid o\n-000130b0: 7220 756e 656e 666f 7263 6561 626c 650a  r unenforceable.\n-000130c0: 2020 2020 2075 6e64 6572 2061 6e79 2070       under any p\n-000130d0: 6172 7469 6375 6c61 7220 6369 7263 756d  articular circum\n-000130e0: 7374 616e 6365 2c20 7468 6520 6261 6c61  stance, the bala\n-000130f0: 6e63 6520 6f66 2074 6865 2073 6563 7469  nce of the secti\n-00013100: 6f6e 2069 730a 2020 2020 2069 6e74 656e  on is.     inten\n-00013110: 6465 6420 746f 2061 7070 6c79 2061 6e64  ded to apply and\n-00013120: 2074 6865 2073 6563 7469 6f6e 2061 7320   the section as \n-00013130: 6120 7768 6f6c 6520 6973 2069 6e74 656e  a whole is inten\n-00013140: 6465 6420 746f 2061 7070 6c79 0a20 2020  ded to apply.   \n-00013150: 2020 696e 206f 7468 6572 2063 6972 6375    in other circu\n-00013160: 6d73 7461 6e63 6573 2e0a 0a20 2020 2020  mstances...     \n-00013170: 4974 2069 7320 6e6f 7420 7468 6520 7075  It is not the pu\n-00013180: 7270 6f73 6520 6f66 2074 6869 7320 7365  rpose of this se\n-00013190: 6374 696f 6e20 746f 2069 6e64 7563 6520  ction to induce \n-000131a0: 796f 7520 746f 2069 6e66 7269 6e67 6520  you to infringe \n-000131b0: 616e 790a 2020 2020 2070 6174 656e 7473  any.     patents\n-000131c0: 206f 7220 6f74 6865 7220 7072 6f70 6572   or other proper\n-000131d0: 7479 2072 6967 6874 2063 6c61 696d 7320  ty right claims \n-000131e0: 6f72 2074 6f20 636f 6e74 6573 7420 7661  or to contest va\n-000131f0: 6c69 6469 7479 206f 660a 2020 2020 2061  lidity of.     a\n-00013200: 6e79 2073 7563 6820 636c 6169 6d73 3b20  ny such claims; \n-00013210: 7468 6973 2073 6563 7469 6f6e 2068 6173  this section has\n-00013220: 2074 6865 2073 6f6c 6520 7075 7270 6f73   the sole purpos\n-00013230: 6520 6f66 2070 726f 7465 6374 696e 670a  e of protecting.\n-00013240: 2020 2020 2074 6865 2069 6e74 6567 7269       the integri\n-00013250: 7479 206f 6620 7468 6520 6672 6565 2073  ty of the free s\n-00013260: 6f66 7477 6172 6520 6469 7374 7269 6275  oftware distribu\n-00013270: 7469 6f6e 2073 7973 7465 6d2c 2077 6869  tion system, whi\n-00013280: 6368 2069 730a 2020 2020 2069 6d70 6c65  ch is.     imple\n-00013290: 6d65 6e74 6564 2062 7920 7075 626c 6963  mented by public\n-000132a0: 206c 6963 656e 7365 2070 7261 6374 6963   license practic\n-000132b0: 6573 2e20 204d 616e 7920 7065 6f70 6c65  es.  Many people\n-000132c0: 2068 6176 6520 6d61 6465 0a20 2020 2020   have made.     \n-000132d0: 6765 6e65 726f 7573 2063 6f6e 7472 6962  generous contrib\n-000132e0: 7574 696f 6e73 2074 6f20 7468 6520 7769  utions to the wi\n-000132f0: 6465 2072 616e 6765 206f 6620 736f 6674  de range of soft\n-00013300: 7761 7265 2064 6973 7472 6962 7574 6564  ware distributed\n-00013310: 0a20 2020 2020 7468 726f 7567 6820 7468  .     through th\n-00013320: 6174 2073 7973 7465 6d20 696e 2072 656c  at system in rel\n-00013330: 6961 6e63 6520 6f6e 2063 6f6e 7369 7374  iance on consist\n-00013340: 656e 7420 6170 706c 6963 6174 696f 6e20  ent application \n-00013350: 6f66 2074 6861 740a 2020 2020 2073 7973  of that.     sys\n-00013360: 7465 6d3b 2069 7420 6973 2075 7020 746f  tem; it is up to\n-00013370: 2074 6865 2061 7574 686f 722f 646f 6e6f   the author/dono\n-00013380: 7220 746f 2064 6563 6964 6520 6966 2068  r to decide if h\n-00013390: 6520 6f72 2073 6865 2069 730a 2020 2020  e or she is.    \n-000133a0: 2077 696c 6c69 6e67 2074 6f20 6469 7374   willing to dist\n-000133b0: 7269 6275 7465 2073 6f66 7477 6172 6520  ribute software \n-000133c0: 7468 726f 7567 6820 616e 7920 6f74 6865  through any othe\n-000133d0: 7220 7379 7374 656d 2061 6e64 2061 0a20  r system and a. \n-000133e0: 2020 2020 6c69 6365 6e73 6565 2063 616e      licensee can\n-000133f0: 6e6f 7420 696d 706f 7365 2074 6861 7420  not impose that \n-00013400: 6368 6f69 6365 2e0a 0a20 2020 2020 5468  choice...     Th\n-00013410: 6973 2073 6563 7469 6f6e 2069 7320 696e  is section is in\n-00013420: 7465 6e64 6564 2074 6f20 6d61 6b65 2074  tended to make t\n-00013430: 686f 726f 7567 686c 7920 636c 6561 7220  horoughly clear \n-00013440: 7768 6174 2069 7320 6265 6c69 6576 6564  what is believed\n-00013450: 0a20 2020 2020 746f 2062 6520 6120 636f  .     to be a co\n-00013460: 6e73 6571 7565 6e63 6520 6f66 2074 6865  nsequence of the\n-00013470: 2072 6573 7420 6f66 2074 6869 7320 4c69   rest of this Li\n-00013480: 6365 6e73 652e 0a0a 2020 382e 2049 6620  cense...  8. If \n-00013490: 7468 6520 6469 7374 7269 6275 7469 6f6e  the distribution\n-000134a0: 2061 6e64 2f6f 7220 7573 6520 6f66 2074   and/or use of t\n-000134b0: 6865 2050 726f 6772 616d 2069 7320 7265  he Program is re\n-000134c0: 7374 7269 6374 6564 2069 6e0a 2020 2020  stricted in.    \n-000134d0: 2063 6572 7461 696e 2063 6f75 6e74 7269   certain countri\n-000134e0: 6573 2065 6974 6865 7220 6279 2070 6174  es either by pat\n-000134f0: 656e 7473 206f 7220 6279 2063 6f70 7972  ents or by copyr\n-00013500: 6967 6874 6564 2069 6e74 6572 6661 6365  ighted interface\n-00013510: 732c 0a20 2020 2020 7468 6520 6f72 6967  s,.     the orig\n-00013520: 696e 616c 2063 6f70 7972 6967 6874 2068  inal copyright h\n-00013530: 6f6c 6465 7220 7768 6f20 706c 6163 6573  older who places\n-00013540: 2074 6865 2050 726f 6772 616d 2075 6e64   the Program und\n-00013550: 6572 2074 6869 730a 2020 2020 204c 6963  er this.     Lic\n-00013560: 656e 7365 206d 6179 2061 6464 2061 6e20  ense may add an \n-00013570: 6578 706c 6963 6974 2067 656f 6772 6170  explicit geograp\n-00013580: 6869 6361 6c20 6469 7374 7269 6275 7469  hical distributi\n-00013590: 6f6e 206c 696d 6974 6174 696f 6e0a 2020  on limitation.  \n-000135a0: 2020 2065 7863 6c75 6469 6e67 2074 686f     excluding tho\n-000135b0: 7365 2063 6f75 6e74 7269 6573 2c20 736f  se countries, so\n-000135c0: 2074 6861 7420 6469 7374 7269 6275 7469   that distributi\n-000135d0: 6f6e 2069 7320 7065 726d 6974 7465 6420  on is permitted \n-000135e0: 6f6e 6c79 0a20 2020 2020 696e 206f 7220  only.     in or \n-000135f0: 616d 6f6e 6720 636f 756e 7472 6965 7320  among countries \n-00013600: 6e6f 7420 7468 7573 2065 7863 6c75 6465  not thus exclude\n-00013610: 642e 2020 496e 2073 7563 6820 6361 7365  d.  In such case\n-00013620: 2c20 7468 6973 0a20 2020 2020 4c69 6365  , this.     Lice\n-00013630: 6e73 6520 696e 636f 7270 6f72 6174 6573  nse incorporates\n-00013640: 2074 6865 206c 696d 6974 6174 696f 6e20   the limitation \n-00013650: 6173 2069 6620 7772 6974 7465 6e20 696e  as if written in\n-00013660: 2074 6865 2062 6f64 7920 6f66 0a20 2020   the body of.   \n-00013670: 2020 7468 6973 204c 6963 656e 7365 2e0a    this License..\n-00013680: 0a20 2039 2e20 5468 6520 4672 6565 2053  .  9. The Free S\n-00013690: 6f66 7477 6172 6520 466f 756e 6461 7469  oftware Foundati\n-000136a0: 6f6e 206d 6179 2070 7562 6c69 7368 2072  on may publish r\n-000136b0: 6576 6973 6564 2061 6e64 2f6f 7220 6e65  evised and/or ne\n-000136c0: 770a 2020 2020 2076 6572 7369 6f6e 7320  w.     versions \n-000136d0: 6f66 2074 6865 2047 656e 6572 616c 2050  of the General P\n-000136e0: 7562 6c69 6320 4c69 6365 6e73 6520 6672  ublic License fr\n-000136f0: 6f6d 2074 696d 6520 746f 2074 696d 652e  om time to time.\n-00013700: 2020 5375 6368 206e 6577 0a20 2020 2020    Such new.     \n-00013710: 7665 7273 696f 6e73 2077 696c 6c20 6265  versions will be\n-00013720: 2073 696d 696c 6172 2069 6e20 7370 6972   similar in spir\n-00013730: 6974 2074 6f20 7468 6520 7072 6573 656e  it to the presen\n-00013740: 7420 7665 7273 696f 6e2c 2062 7574 206d  t version, but m\n-00013750: 6179 0a20 2020 2020 6469 6666 6572 2069  ay.     differ i\n-00013760: 6e20 6465 7461 696c 2074 6f20 6164 6472  n detail to addr\n-00013770: 6573 7320 6e65 7720 7072 6f62 6c65 6d73  ess new problems\n-00013780: 206f 7220 636f 6e63 6572 6e73 2e0a 0a20   or concerns... \n-00013790: 2020 2020 4561 6368 2076 6572 7369 6f6e      Each version\n-000137a0: 2069 7320 6769 7665 6e20 6120 6469 7374   is given a dist\n-000137b0: 696e 6775 6973 6869 6e67 2076 6572 7369  inguishing versi\n-000137c0: 6f6e 206e 756d 6265 722e 2020 4966 2074  on number.  If t\n-000137d0: 6865 0a20 2020 2020 5072 6f67 7261 6d20  he.     Program \n-000137e0: 7370 6563 6966 6965 7320 6120 7665 7273  specifies a vers\n-000137f0: 696f 6e20 6e75 6d62 6572 206f 6620 7468  ion number of th\n-00013800: 6973 204c 6963 656e 7365 2077 6869 6368  is License which\n-00013810: 2061 7070 6c69 6573 2074 6f0a 2020 2020   applies to.    \n-00013820: 2069 7420 616e 6420 2261 6e79 206c 6174   it and \"any lat\n-00013830: 6572 2076 6572 7369 6f6e 222c 2079 6f75  er version\", you\n-00013840: 2068 6176 6520 7468 6520 6f70 7469 6f6e   have the option\n-00013850: 206f 6620 666f 6c6c 6f77 696e 6720 7468   of following th\n-00013860: 650a 2020 2020 2074 6572 6d73 2061 6e64  e.     terms and\n-00013870: 2063 6f6e 6469 7469 6f6e 7320 6569 7468   conditions eith\n-00013880: 6572 206f 6620 7468 6174 2076 6572 7369  er of that versi\n-00013890: 6f6e 206f 7220 6f66 2061 6e79 206c 6174  on or of any lat\n-000138a0: 6572 2076 6572 7369 6f6e 0a20 2020 2020  er version.     \n-000138b0: 7075 626c 6973 6865 6420 6279 2074 6865  published by the\n-000138c0: 2046 7265 6520 536f 6674 7761 7265 2046   Free Software F\n-000138d0: 6f75 6e64 6174 696f 6e2e 2020 4966 2074  oundation.  If t\n-000138e0: 6865 2050 726f 6772 616d 2064 6f65 7320  he Program does \n-000138f0: 6e6f 740a 2020 2020 2073 7065 6369 6679  not.     specify\n-00013900: 2061 2076 6572 7369 6f6e 206e 756d 6265   a version numbe\n-00013910: 7220 6f66 2074 6869 7320 4c69 6365 6e73  r of this Licens\n-00013920: 652c 2079 6f75 206d 6179 2063 686f 6f73  e, you may choos\n-00013930: 6520 616e 790a 2020 2020 2076 6572 7369  e any.     versi\n-00013940: 6f6e 2065 7665 7220 7075 626c 6973 6865  on ever publishe\n-00013950: 6420 6279 2074 6865 2046 7265 6520 536f  d by the Free So\n-00013960: 6674 7761 7265 2046 6f75 6e64 6174 696f  ftware Foundatio\n-00013970: 6e2e 0a0a 2020 3130 2e20 4966 2079 6f75  n...  10. If you\n-00013980: 2077 6973 6820 746f 2069 6e63 6f72 706f   wish to incorpo\n-00013990: 7261 7465 2070 6172 7473 206f 6620 7468  rate parts of th\n-000139a0: 6520 5072 6f67 7261 6d20 696e 746f 206f  e Program into o\n-000139b0: 7468 6572 2066 7265 650a 2020 2020 2070  ther free.     p\n-000139c0: 726f 6772 616d 7320 7768 6f73 6520 6469  rograms whose di\n-000139d0: 7374 7269 6275 7469 6f6e 2063 6f6e 6469  stribution condi\n-000139e0: 7469 6f6e 7320 6172 6520 6469 6666 6572  tions are differ\n-000139f0: 656e 742c 2077 7269 7465 2074 6f20 7468  ent, write to th\n-00013a00: 650a 2020 2020 2061 7574 686f 7220 746f  e.     author to\n-00013a10: 2061 736b 2066 6f72 2070 6572 6d69 7373   ask for permiss\n-00013a20: 696f 6e2e 2020 466f 7220 736f 6674 7761  ion.  For softwa\n-00013a30: 7265 2077 6869 6368 2069 7320 636f 7079  re which is copy\n-00013a40: 7269 6768 7465 6420 6279 0a20 2020 2020  righted by.     \n-00013a50: 7468 6520 4672 6565 2053 6f66 7477 6172  the Free Softwar\n-00013a60: 6520 466f 756e 6461 7469 6f6e 2c20 7772  e Foundation, wr\n-00013a70: 6974 6520 746f 2074 6865 2046 7265 6520  ite to the Free \n-00013a80: 536f 6674 7761 7265 0a20 2020 2020 466f  Software.     Fo\n-00013a90: 756e 6461 7469 6f6e 3b20 7765 2073 6f6d  undation; we som\n-00013aa0: 6574 696d 6573 206d 616b 6520 6578 6365  etimes make exce\n-00013ab0: 7074 696f 6e73 2066 6f72 2074 6869 732e  ptions for this.\n-00013ac0: 2020 4f75 7220 6465 6369 7369 6f6e 0a20    Our decision. \n-00013ad0: 2020 2020 7769 6c6c 2062 6520 6775 6964      will be guid\n-00013ae0: 6564 2062 7920 7468 6520 7477 6f20 676f  ed by the two go\n-00013af0: 616c 7320 6f66 2070 7265 7365 7276 696e  als of preservin\n-00013b00: 6720 7468 6520 6672 6565 2073 7461 7475  g the free statu\n-00013b10: 7320 6f66 0a20 2020 2020 616c 6c20 6465  s of.     all de\n-00013b20: 7269 7661 7469 7665 7320 6f66 206f 7572  rivatives of our\n-00013b30: 2066 7265 6520 736f 6674 7761 7265 2061   free software a\n-00013b40: 6e64 206f 6620 7072 6f6d 6f74 696e 6720  nd of promoting \n-00013b50: 7468 6520 7368 6172 696e 670a 2020 2020  the sharing.    \n-00013b60: 2061 6e64 2072 6575 7365 206f 6620 736f   and reuse of so\n-00013b70: 6674 7761 7265 2067 656e 6572 616c 6c79  ftware generally\n-00013b80: 2e0a 0a20 2020 2020 2020 2020 2020 2020  ...             \n-00013b90: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00013ba0: 204e 4f20 5741 5252 414e 5459 0a0a 2020   NO WARRANTY..  \n-00013bb0: 312e 2042 4543 4155 5345 2054 4845 2050  1. BECAUSE THE P\n-00013bc0: 524f 4752 414d 2049 5320 4c49 4345 4e53  ROGRAM IS LICENS\n-00013bd0: 4544 2046 5245 4520 4f46 2043 4841 5247  ED FREE OF CHARG\n-00013be0: 452c 2054 4845 5245 2049 5320 4e4f 0a20  E, THERE IS NO. \n-00013bf0: 2020 2020 5741 5252 414e 5459 2046 4f52      WARRANTY FOR\n-00013c00: 2054 4845 2050 524f 4752 414d 2c20 544f   THE PROGRAM, TO\n-00013c10: 2054 4845 2045 5854 454e 5420 5045 524d   THE EXTENT PERM\n-00013c20: 4954 5445 4420 4259 2041 5050 4c49 4341  ITTED BY APPLICA\n-00013c30: 424c 450a 2020 2020 204c 4157 2e20 4558  BLE.     LAW. EX\n-00013c40: 4345 5054 2057 4845 4e20 4f54 4845 5257  CEPT WHEN OTHERW\n-00013c50: 4953 4520 5354 4154 4544 2049 4e20 5752  ISE STATED IN WR\n-00013c60: 4954 494e 4720 5448 4520 434f 5059 5249  ITING THE COPYRI\n-00013c70: 4748 5420 484f 4c44 4552 530a 2020 2020  GHT HOLDERS.    \n-00013c80: 2041 4e44 2f4f 5220 4f54 4845 5220 5041   AND/OR OTHER PA\n-00013c90: 5254 4945 5320 5052 4f56 4944 4520 5448  RTIES PROVIDE TH\n-00013ca0: 4520 5052 4f47 5241 4d20 2241 5320 4953  E PROGRAM \"AS IS\n-00013cb0: 2220 5749 5448 4f55 5420 5741 5252 414e  \" WITHOUT WARRAN\n-00013cc0: 5459 0a20 2020 2020 4f46 2041 4e59 204b  TY.     OF ANY K\n-00013cd0: 494e 442c 2045 4954 4845 5220 4558 5052  IND, EITHER EXPR\n-00013ce0: 4553 5345 4420 4f52 2049 4d50 4c49 4544  ESSED OR IMPLIED\n-00013cf0: 2c20 494e 434c 5544 494e 472c 2042 5554  , INCLUDING, BUT\n-00013d00: 204e 4f54 0a20 2020 2020 4c49 4d49 5445   NOT.     LIMITE\n-00013d10: 4420 544f 2c20 5448 4520 494d 504c 4945  D TO, THE IMPLIE\n-00013d20: 4420 5741 5252 414e 5449 4553 204f 4620  D WARRANTIES OF \n-00013d30: 4d45 5243 4841 4e54 4142 494c 4954 5920  MERCHANTABILITY \n-00013d40: 414e 4420 4649 544e 4553 530a 2020 2020  AND FITNESS.    \n-00013d50: 2046 4f52 2041 2050 4152 5449 4355 4c41   FOR A PARTICULA\n-00013d60: 5220 5055 5250 4f53 452e 2054 4845 2045  R PURPOSE. THE E\n-00013d70: 4e54 4952 4520 5249 534b 2041 5320 544f  NTIRE RISK AS TO\n-00013d80: 2054 4845 2051 5541 4c49 5459 2041 4e44   THE QUALITY AND\n-00013d90: 0a20 2020 2020 5045 5246 4f52 4d41 4e43  .     PERFORMANC\n-00013da0: 4520 4f46 2054 4845 2050 524f 4752 414d  E OF THE PROGRAM\n-00013db0: 2049 5320 5749 5448 2059 4f55 2e20 5348   IS WITH YOU. SH\n-00013dc0: 4f55 4c44 2054 4845 2050 524f 4752 414d  OULD THE PROGRAM\n-00013dd0: 2050 524f 5645 0a20 2020 2020 4445 4645   PROVE.     DEFE\n-00013de0: 4354 4956 452c 2059 4f55 2041 5353 554d  CTIVE, YOU ASSUM\n-00013df0: 4520 5448 4520 434f 5354 204f 4620 414c  E THE COST OF AL\n-00013e00: 4c20 4e45 4345 5353 4152 5920 5345 5256  L NECESSARY SERV\n-00013e10: 4943 494e 472c 2052 4550 4149 520a 2020  ICING, REPAIR.  \n-00013e20: 2020 204f 5220 434f 5252 4543 5449 4f4e     OR CORRECTION\n-00013e30: 2e0a 0a20 2032 2e20 494e 204e 4f20 4556  ...  2. IN NO EV\n-00013e40: 454e 5420 554e 4c45 5353 2052 4551 5549  ENT UNLESS REQUI\n-00013e50: 5245 4420 4259 2041 5050 4c49 4341 424c  RED BY APPLICABL\n-00013e60: 4520 4c41 5720 4f52 2041 4752 4545 4420  E LAW OR AGREED \n-00013e70: 544f 2049 4e0a 2020 2020 2057 5249 5449  TO IN.     WRITI\n-00013e80: 4e47 2057 494c 4c20 414e 5920 434f 5059  NG WILL ANY COPY\n-00013e90: 5249 4748 5420 484f 4c44 4552 2c20 4f52  RIGHT HOLDER, OR\n-00013ea0: 2041 4e59 204f 5448 4552 2050 4152 5459   ANY OTHER PARTY\n-00013eb0: 2057 484f 204d 4159 0a20 2020 2020 4d4f   WHO MAY.     MO\n-00013ec0: 4449 4659 2041 4e44 2f4f 5220 5245 4449  DIFY AND/OR REDI\n-00013ed0: 5354 5249 4255 5445 2054 4845 2050 524f  STRIBUTE THE PRO\n-00013ee0: 4752 414d 2041 5320 5045 524d 4954 5445  GRAM AS PERMITTE\n-00013ef0: 4420 4142 4f56 452c 2042 450a 2020 2020  D ABOVE, BE.    \n-00013f00: 204c 4941 424c 4520 544f 2059 4f55 2046   LIABLE TO YOU F\n-00013f10: 4f52 2044 414d 4147 4553 2c20 494e 434c  OR DAMAGES, INCL\n-00013f20: 5544 494e 4720 414e 5920 4745 4e45 5241  UDING ANY GENERA\n-00013f30: 4c2c 2053 5045 4349 414c 2c0a 2020 2020  L, SPECIAL,.    \n-00013f40: 2049 4e43 4944 454e 5441 4c20 4f52 2043   INCIDENTAL OR C\n-00013f50: 4f4e 5345 5155 454e 5449 414c 2044 414d  ONSEQUENTIAL DAM\n-00013f60: 4147 4553 2041 5249 5349 4e47 204f 5554  AGES ARISING OUT\n-00013f70: 204f 4620 5448 4520 5553 4520 4f52 0a20   OF THE USE OR. \n-00013f80: 2020 2020 494e 4142 494c 4954 5920 544f      INABILITY TO\n-00013f90: 2055 5345 2054 4845 2050 524f 4752 414d   USE THE PROGRAM\n-00013fa0: 2028 494e 434c 5544 494e 4720 4255 5420   (INCLUDING BUT \n-00013fb0: 4e4f 5420 4c49 4d49 5445 4420 544f 204c  NOT LIMITED TO L\n-00013fc0: 4f53 5320 4f46 0a20 2020 2020 4441 5441  OSS OF.     DATA\n-00013fd0: 204f 5220 4441 5441 2042 4549 4e47 2052   OR DATA BEING R\n-00013fe0: 454e 4445 5245 4420 494e 4143 4355 5241  ENDERED INACCURA\n-00013ff0: 5445 204f 5220 4c4f 5353 4553 2053 5553  TE OR LOSSES SUS\n-00014000: 5441 494e 4544 2042 5920 594f 550a 2020  TAINED BY YOU.  \n-00014010: 2020 204f 5220 5448 4952 4420 5041 5254     OR THIRD PART\n-00014020: 4945 5320 4f52 2041 2046 4149 4c55 5245  IES OR A FAILURE\n-00014030: 204f 4620 5448 4520 5052 4f47 5241 4d20   OF THE PROGRAM \n-00014040: 544f 204f 5045 5241 5445 2057 4954 4820  TO OPERATE WITH \n-00014050: 414e 590a 2020 2020 204f 5448 4552 2050  ANY.     OTHER P\n-00014060: 524f 4752 414d 5329 2c20 4556 454e 2049  ROGRAMS), EVEN I\n-00014070: 4620 5355 4348 2048 4f4c 4445 5220 4f52  F SUCH HOLDER OR\n-00014080: 204f 5448 4552 2050 4152 5459 2048 4153   OTHER PARTY HAS\n-00014090: 2042 4545 4e0a 2020 2020 2041 4456 4953   BEEN.     ADVIS\n-000140a0: 4544 204f 4620 5448 4520 504f 5353 4942  ED OF THE POSSIB\n-000140b0: 494c 4954 5920 4f46 2053 5543 4820 4441  ILITY OF SUCH DA\n-000140c0: 4d41 4745 532e 0a0a 2020 2020 2020 2020  MAGES...        \n-000140d0: 2020 2020 2020 2020 2020 2020 2020 454e                EN\n-000140e0: 4420 4f46 2054 4552 4d53 2041 4e44 2043  D OF TERMS AND C\n-000140f0: 4f4e 4449 5449 4f4e 530a 0a41 2e32 2041  ONDITIONS..A.2 A\n-00014100: 7070 656e 6469 783a 2048 6f77 2074 6f20  ppendix: How to \n-00014110: 4170 706c 7920 5468 6573 6520 5465 726d  Apply These Term\n-00014120: 7320 746f 2059 6f75 7220 4e65 7720 5072  s to Your New Pr\n-00014130: 6f67 7261 6d73 0a3d 3d3d 3d3d 3d3d 3d3d  ograms.=========\n+00010d30: 2020 474e 5520 4745 4e45 5241 4c20 5055    GNU GENERAL PU\n+00010d40: 424c 4943 204c 4943 454e 5345 2076 322b  BLIC LICENSE v2+\n+00010d50: 0a20 2020 2054 4552 4d53 2041 4e44 2043  .    TERMS AND C\n+00010d60: 4f4e 4449 5449 4f4e 5320 464f 5220 434f  ONDITIONS FOR CO\n+00010d70: 5059 494e 472c 2044 4953 5452 4942 5554  PYING, DISTRIBUT\n+00010d80: 494f 4e20 414e 4420 4d4f 4449 4649 4341  ION AND MODIFICA\n+00010d90: 5449 4f4e 0a0a 2020 302e 2054 6869 7320  TION..  0. This \n+00010da0: 4c69 6365 6e73 6520 6170 706c 6965 7320  License applies \n+00010db0: 746f 2061 6e79 2070 726f 6772 616d 206f  to any program o\n+00010dc0: 7220 6f74 6865 7220 776f 726b 2077 6869  r other work whi\n+00010dd0: 6368 2063 6f6e 7461 696e 7320 610a 2020  ch contains a.  \n+00010de0: 2020 206e 6f74 6963 6520 706c 6163 6564     notice placed\n+00010df0: 2062 7920 7468 6520 636f 7079 7269 6768   by the copyrigh\n+00010e00: 7420 686f 6c64 6572 2073 6179 696e 6720  t holder saying \n+00010e10: 6974 206d 6179 2062 6520 6469 7374 7269  it may be distri\n+00010e20: 6275 7465 640a 2020 2020 2075 6e64 6572  buted.     under\n+00010e30: 2074 6865 2074 6572 6d73 206f 6620 7468   the terms of th\n+00010e40: 6973 2047 656e 6572 616c 2050 7562 6c69  is General Publi\n+00010e50: 6320 4c69 6365 6e73 652e 2020 5468 6520  c License.  The \n+00010e60: 2250 726f 6772 616d 222c 0a20 2020 2020  \"Program\",.     \n+00010e70: 6265 6c6f 772c 2072 6566 6572 7320 746f  below, refers to\n+00010e80: 2061 6e79 2073 7563 6820 7072 6f67 7261   any such progra\n+00010e90: 6d20 6f72 2077 6f72 6b2c 2061 6e64 2061  m or work, and a\n+00010ea0: 2022 776f 726b 2062 6173 6564 206f 6e20   \"work based on \n+00010eb0: 7468 650a 2020 2020 2050 726f 6772 616d  the.     Program\n+00010ec0: 2220 6d65 616e 7320 6569 7468 6572 2074  \" means either t\n+00010ed0: 6865 2050 726f 6772 616d 206f 7220 616e  he Program or an\n+00010ee0: 7920 6465 7269 7661 7469 7665 2077 6f72  y derivative wor\n+00010ef0: 6b20 756e 6465 720a 2020 2020 2063 6f70  k under.     cop\n+00010f00: 7972 6967 6874 206c 6177 3a20 7468 6174  yright law: that\n+00010f10: 2069 7320 746f 2073 6179 2c20 6120 776f   is to say, a wo\n+00010f20: 726b 2063 6f6e 7461 696e 696e 6720 7468  rk containing th\n+00010f30: 6520 5072 6f67 7261 6d20 6f72 2061 0a20  e Program or a. \n+00010f40: 2020 2020 706f 7274 696f 6e20 6f66 2069      portion of i\n+00010f50: 742c 2065 6974 6865 7220 7665 7262 6174  t, either verbat\n+00010f60: 696d 206f 7220 7769 7468 206d 6f64 6966  im or with modif\n+00010f70: 6963 6174 696f 6e73 2061 6e64 2f6f 720a  ications and/or.\n+00010f80: 2020 2020 2074 7261 6e73 6c61 7465 6420       translated \n+00010f90: 696e 746f 2061 6e6f 7468 6572 206c 616e  into another lan\n+00010fa0: 6775 6167 652e 2020 2848 6572 6569 6e61  guage.  (Hereina\n+00010fb0: 6674 6572 2c20 7472 616e 736c 6174 696f  fter, translatio\n+00010fc0: 6e20 6973 0a20 2020 2020 696e 636c 7564  n is.     includ\n+00010fd0: 6564 2077 6974 686f 7574 206c 696d 6974  ed without limit\n+00010fe0: 6174 696f 6e20 696e 2074 6865 2074 6572  ation in the ter\n+00010ff0: 6d20 226d 6f64 6966 6963 6174 696f 6e22  m \"modification\"\n+00011000: 2e29 2020 4561 6368 0a20 2020 2020 6c69  .)  Each.     li\n+00011010: 6365 6e73 6565 2069 7320 6164 6472 6573  censee is addres\n+00011020: 7365 6420 6173 2022 796f 7522 2e0a 0a20  sed as \"you\"... \n+00011030: 2020 2020 4163 7469 7669 7469 6573 206f      Activities o\n+00011040: 7468 6572 2074 6861 6e20 636f 7079 696e  ther than copyin\n+00011050: 672c 2064 6973 7472 6962 7574 696f 6e20  g, distribution \n+00011060: 616e 6420 6d6f 6469 6669 6361 7469 6f6e  and modification\n+00011070: 2061 7265 0a20 2020 2020 6e6f 7420 636f   are.     not co\n+00011080: 7665 7265 6420 6279 2074 6869 7320 4c69  vered by this Li\n+00011090: 6365 6e73 653b 2074 6865 7920 6172 6520  cense; they are \n+000110a0: 6f75 7473 6964 6520 6974 7320 7363 6f70  outside its scop\n+000110b0: 652e 2020 5468 6520 6163 740a 2020 2020  e.  The act.    \n+000110c0: 206f 6620 7275 6e6e 696e 6720 7468 6520   of running the \n+000110d0: 5072 6f67 7261 6d20 6973 206e 6f74 2072  Program is not r\n+000110e0: 6573 7472 6963 7465 642c 2061 6e64 2074  estricted, and t\n+000110f0: 6865 206f 7574 7075 7420 6672 6f6d 2074  he output from t\n+00011100: 6865 0a20 2020 2020 5072 6f67 7261 6d20  he.     Program \n+00011110: 6973 2063 6f76 6572 6564 206f 6e6c 7920  is covered only \n+00011120: 6966 2069 7473 2063 6f6e 7465 6e74 7320  if its contents \n+00011130: 636f 6e73 7469 7475 7465 2061 2077 6f72  constitute a wor\n+00011140: 6b20 6261 7365 6420 6f6e 0a20 2020 2020  k based on.     \n+00011150: 7468 6520 5072 6f67 7261 6d20 2869 6e64  the Program (ind\n+00011160: 6570 656e 6465 6e74 206f 6620 6861 7669  ependent of havi\n+00011170: 6e67 2062 6565 6e20 6d61 6465 2062 7920  ng been made by \n+00011180: 7275 6e6e 696e 6720 7468 650a 2020 2020  running the.    \n+00011190: 2050 726f 6772 616d 292e 2020 5768 6574   Program).  Whet\n+000111a0: 6865 7220 7468 6174 2069 7320 7472 7565  her that is true\n+000111b0: 2064 6570 656e 6473 206f 6e20 7768 6174   depends on what\n+000111c0: 2074 6865 2050 726f 6772 616d 2064 6f65   the Program doe\n+000111d0: 732e 0a0a 2020 312e 2059 6f75 206d 6179  s...  1. You may\n+000111e0: 2063 6f70 7920 616e 6420 6469 7374 7269   copy and distri\n+000111f0: 6275 7465 2076 6572 6261 7469 6d20 636f  bute verbatim co\n+00011200: 7069 6573 206f 6620 7468 6520 5072 6f67  pies of the Prog\n+00011210: 7261 6d27 7320 736f 7572 6365 0a20 2020  ram's source.   \n+00011220: 2020 636f 6465 2061 7320 796f 7520 7265    code as you re\n+00011230: 6365 6976 6520 6974 2c20 696e 2061 6e79  ceive it, in any\n+00011240: 206d 6564 6975 6d2c 2070 726f 7669 6465   medium, provide\n+00011250: 6420 7468 6174 2079 6f75 0a20 2020 2020  d that you.     \n+00011260: 636f 6e73 7069 6375 6f75 736c 7920 616e  conspicuously an\n+00011270: 6420 6170 7072 6f70 7269 6174 656c 7920  d appropriately \n+00011280: 7075 626c 6973 6820 6f6e 2065 6163 6820  publish on each \n+00011290: 636f 7079 2061 6e20 6170 7072 6f70 7269  copy an appropri\n+000112a0: 6174 650a 2020 2020 2063 6f70 7972 6967  ate.     copyrig\n+000112b0: 6874 206e 6f74 6963 6520 616e 6420 6469  ht notice and di\n+000112c0: 7363 6c61 696d 6572 206f 6620 7761 7272  sclaimer of warr\n+000112d0: 616e 7479 3b20 6b65 6570 2069 6e74 6163  anty; keep intac\n+000112e0: 7420 616c 6c20 7468 650a 2020 2020 206e  t all the.     n\n+000112f0: 6f74 6963 6573 2074 6861 7420 7265 6665  otices that refe\n+00011300: 7220 746f 2074 6869 7320 4c69 6365 6e73  r to this Licens\n+00011310: 6520 616e 6420 746f 2074 6865 2061 6273  e and to the abs\n+00011320: 656e 6365 206f 6620 616e 790a 2020 2020  ence of any.    \n+00011330: 2077 6172 7261 6e74 793b 2061 6e64 2067   warranty; and g\n+00011340: 6976 6520 616e 7920 6f74 6865 7220 7265  ive any other re\n+00011350: 6369 7069 656e 7473 206f 6620 7468 6520  cipients of the \n+00011360: 5072 6f67 7261 6d20 6120 636f 7079 206f  Program a copy o\n+00011370: 660a 2020 2020 2074 6869 7320 4c69 6365  f.     this Lice\n+00011380: 6e73 6520 616c 6f6e 6720 7769 7468 2074  nse along with t\n+00011390: 6865 2050 726f 6772 616d 2e0a 0a20 2020  he Program...   \n+000113a0: 2020 596f 7520 6d61 7920 6368 6172 6765    You may charge\n+000113b0: 2061 2066 6565 2066 6f72 2074 6865 2070   a fee for the p\n+000113c0: 6879 7369 6361 6c20 6163 7420 6f66 2074  hysical act of t\n+000113d0: 7261 6e73 6665 7272 696e 6720 6120 636f  ransferring a co\n+000113e0: 7079 2c0a 2020 2020 2061 6e64 2079 6f75  py,.     and you\n+000113f0: 206d 6179 2061 7420 796f 7572 206f 7074   may at your opt\n+00011400: 696f 6e20 6f66 6665 7220 7761 7272 616e  ion offer warran\n+00011410: 7479 2070 726f 7465 6374 696f 6e20 696e  ty protection in\n+00011420: 2065 7863 6861 6e67 650a 2020 2020 2066   exchange.     f\n+00011430: 6f72 2061 2066 6565 2e0a 0a20 2032 2e20  or a fee...  2. \n+00011440: 596f 7520 6d61 7920 6d6f 6469 6679 2079  You may modify y\n+00011450: 6f75 7220 636f 7079 206f 7220 636f 7069  our copy or copi\n+00011460: 6573 206f 6620 7468 6520 5072 6f67 7261  es of the Progra\n+00011470: 6d20 6f72 2061 6e79 2070 6f72 7469 6f6e  m or any portion\n+00011480: 206f 660a 2020 2020 2069 742c 2074 6875   of.     it, thu\n+00011490: 7320 666f 726d 696e 6720 6120 776f 726b  s forming a work\n+000114a0: 2062 6173 6564 206f 6e20 7468 6520 5072   based on the Pr\n+000114b0: 6f67 7261 6d2c 2061 6e64 2063 6f70 7920  ogram, and copy \n+000114c0: 616e 640a 2020 2020 2064 6973 7472 6962  and.     distrib\n+000114d0: 7574 6520 7375 6368 206d 6f64 6966 6963  ute such modific\n+000114e0: 6174 696f 6e73 206f 7220 776f 726b 2075  ations or work u\n+000114f0: 6e64 6572 2074 6865 2074 6572 6d73 206f  nder the terms o\n+00011500: 6620 5365 6374 696f 6e20 310a 2020 2020  f Section 1.    \n+00011510: 2061 626f 7665 2c20 7072 6f76 6964 6564   above, provided\n+00011520: 2074 6861 7420 796f 7520 616c 736f 206d   that you also m\n+00011530: 6565 7420 616c 6c20 6f66 2074 6865 7365  eet all of these\n+00011540: 2063 6f6e 6469 7469 6f6e 733a 0a0a 2020   conditions:..  \n+00011550: 2020 2020 2061 2e20 596f 7520 6d75 7374       a. You must\n+00011560: 2063 6175 7365 2074 6865 206d 6f64 6966   cause the modif\n+00011570: 6965 6420 6669 6c65 7320 746f 2063 6172  ied files to car\n+00011580: 7279 2070 726f 6d69 6e65 6e74 206e 6f74  ry prominent not\n+00011590: 6963 6573 0a20 2020 2020 2020 2020 2073  ices.          s\n+000115a0: 7461 7469 6e67 2074 6861 7420 796f 7520  tating that you \n+000115b0: 6368 616e 6765 6420 7468 6520 6669 6c65  changed the file\n+000115c0: 7320 616e 6420 7468 6520 6461 7465 206f  s and the date o\n+000115d0: 6620 616e 7920 6368 616e 6765 2e0a 0a20  f any change... \n+000115e0: 2020 2020 2020 622e 2059 6f75 206d 7573        b. You mus\n+000115f0: 7420 6361 7573 6520 616e 7920 776f 726b  t cause any work\n+00011600: 2074 6861 7420 796f 7520 6469 7374 7269   that you distri\n+00011610: 6275 7465 206f 7220 7075 626c 6973 682c  bute or publish,\n+00011620: 2074 6861 740a 2020 2020 2020 2020 2020   that.          \n+00011630: 696e 2077 686f 6c65 206f 7220 696e 2070  in whole or in p\n+00011640: 6172 7420 636f 6e74 6169 6e73 206f 7220  art contains or \n+00011650: 6973 2064 6572 6976 6564 2066 726f 6d20  is derived from \n+00011660: 7468 6520 5072 6f67 7261 6d20 6f72 0a20  the Program or. \n+00011670: 2020 2020 2020 2020 2061 6e79 2070 6172           any par\n+00011680: 7420 7468 6572 656f 662c 2074 6f20 6265  t thereof, to be\n+00011690: 206c 6963 656e 7365 6420 6173 2061 2077   licensed as a w\n+000116a0: 686f 6c65 2061 7420 6e6f 2063 6861 7267  hole at no charg\n+000116b0: 6520 746f 0a20 2020 2020 2020 2020 2061  e to.          a\n+000116c0: 6c6c 2074 6869 7264 2070 6172 7469 6573  ll third parties\n+000116d0: 2075 6e64 6572 2074 6865 2074 6572 6d73   under the terms\n+000116e0: 206f 6620 7468 6973 204c 6963 656e 7365   of this License\n+000116f0: 2e0a 0a20 2020 2020 2020 632e 2049 6620  ...       c. If \n+00011700: 7468 6520 6d6f 6469 6669 6564 2070 726f  the modified pro\n+00011710: 6772 616d 206e 6f72 6d61 6c6c 7920 7265  gram normally re\n+00011720: 6164 7320 636f 6d6d 616e 6473 2069 6e74  ads commands int\n+00011730: 6572 6163 7469 7665 6c79 0a20 2020 2020  eractively.     \n+00011740: 2020 2020 2077 6865 6e20 7275 6e2c 2079       when run, y\n+00011750: 6f75 206d 7573 7420 6361 7573 6520 6974  ou must cause it\n+00011760: 2c20 7768 656e 2073 7461 7274 6564 2072  , when started r\n+00011770: 756e 6e69 6e67 2066 6f72 2073 7563 680a  unning for such.\n+00011780: 2020 2020 2020 2020 2020 696e 7465 7261            intera\n+00011790: 6374 6976 6520 7573 6520 696e 2074 6865  ctive use in the\n+000117a0: 206d 6f73 7420 6f72 6469 6e61 7279 2077   most ordinary w\n+000117b0: 6179 2c20 746f 2070 7269 6e74 206f 7220  ay, to print or \n+000117c0: 6469 7370 6c61 790a 2020 2020 2020 2020  display.        \n+000117d0: 2020 616e 2061 6e6e 6f75 6e63 656d 656e    an announcemen\n+000117e0: 7420 696e 636c 7564 696e 6720 616e 2061  t including an a\n+000117f0: 7070 726f 7072 6961 7465 2063 6f70 7972  ppropriate copyr\n+00011800: 6967 6874 206e 6f74 6963 6520 616e 640a  ight notice and.\n+00011810: 2020 2020 2020 2020 2020 6120 6e6f 7469            a noti\n+00011820: 6365 2074 6861 7420 7468 6572 6520 6973  ce that there is\n+00011830: 206e 6f20 7761 7272 616e 7479 2028 6f72   no warranty (or\n+00011840: 2065 6c73 652c 2073 6179 696e 6720 7468   else, saying th\n+00011850: 6174 2079 6f75 0a20 2020 2020 2020 2020  at you.         \n+00011860: 2070 726f 7669 6465 2061 2077 6172 7261   provide a warra\n+00011870: 6e74 7929 2061 6e64 2074 6861 7420 7573  nty) and that us\n+00011880: 6572 7320 6d61 7920 7265 6469 7374 7269  ers may redistri\n+00011890: 6275 7465 2074 6865 0a20 2020 2020 2020  bute the.       \n+000118a0: 2020 2070 726f 6772 616d 2075 6e64 6572     program under\n+000118b0: 2074 6865 7365 2063 6f6e 6469 7469 6f6e   these condition\n+000118c0: 732c 2061 6e64 2074 656c 6c69 6e67 2074  s, and telling t\n+000118d0: 6865 2075 7365 7220 686f 7720 746f 0a20  he user how to. \n+000118e0: 2020 2020 2020 2020 2076 6965 7720 6120           view a \n+000118f0: 636f 7079 206f 6620 7468 6973 204c 6963  copy of this Lic\n+00011900: 656e 7365 2e20 2028 4578 6365 7074 696f  ense.  (Exceptio\n+00011910: 6e3a 2069 6620 7468 6520 5072 6f67 7261  n: if the Progra\n+00011920: 6d0a 2020 2020 2020 2020 2020 6974 7365  m.          itse\n+00011930: 6c66 2069 7320 696e 7465 7261 6374 6976  lf is interactiv\n+00011940: 6520 6275 7420 646f 6573 206e 6f74 206e  e but does not n\n+00011950: 6f72 6d61 6c6c 7920 7072 696e 7420 7375  ormally print su\n+00011960: 6368 2061 6e0a 2020 2020 2020 2020 2020  ch an.          \n+00011970: 616e 6e6f 756e 6365 6d65 6e74 2c20 796f  announcement, yo\n+00011980: 7572 2077 6f72 6b20 6261 7365 6420 6f6e  ur work based on\n+00011990: 2074 6865 2050 726f 6772 616d 2069 7320   the Program is \n+000119a0: 6e6f 7420 7265 7175 6972 6564 0a20 2020  not required.   \n+000119b0: 2020 2020 2020 2074 6f20 7072 696e 7420         to print \n+000119c0: 616e 2061 6e6e 6f75 6e63 656d 656e 742e  an announcement.\n+000119d0: 290a 0a20 2020 2020 5468 6573 6520 7265  )..     These re\n+000119e0: 7175 6972 656d 656e 7473 2061 7070 6c79  quirements apply\n+000119f0: 2074 6f20 7468 6520 6d6f 6469 6669 6564   to the modified\n+00011a00: 2077 6f72 6b20 6173 2061 2077 686f 6c65   work as a whole\n+00011a10: 2e20 2049 660a 2020 2020 2069 6465 6e74  .  If.     ident\n+00011a20: 6966 6961 626c 6520 7365 6374 696f 6e73  ifiable sections\n+00011a30: 206f 6620 7468 6174 2077 6f72 6b20 6172   of that work ar\n+00011a40: 6520 6e6f 7420 6465 7269 7665 6420 6672  e not derived fr\n+00011a50: 6f6d 2074 6865 0a20 2020 2020 5072 6f67  om the.     Prog\n+00011a60: 7261 6d2c 2061 6e64 2063 616e 2062 6520  ram, and can be \n+00011a70: 7265 6173 6f6e 6162 6c79 2063 6f6e 7369  reasonably consi\n+00011a80: 6465 7265 6420 696e 6465 7065 6e64 656e  dered independen\n+00011a90: 7420 616e 6420 7365 7061 7261 7465 0a20  t and separate. \n+00011aa0: 2020 2020 776f 726b 7320 696e 2074 6865      works in the\n+00011ab0: 6d73 656c 7665 732c 2074 6865 6e20 7468  mselves, then th\n+00011ac0: 6973 204c 6963 656e 7365 2c20 616e 6420  is License, and \n+00011ad0: 6974 7320 7465 726d 732c 2064 6f20 6e6f  its terms, do no\n+00011ae0: 7420 6170 706c 790a 2020 2020 2074 6f20  t apply.     to \n+00011af0: 7468 6f73 6520 7365 6374 696f 6e73 2077  those sections w\n+00011b00: 6865 6e20 796f 7520 6469 7374 7269 6275  hen you distribu\n+00011b10: 7465 2074 6865 6d20 6173 2073 6570 6172  te them as separ\n+00011b20: 6174 6520 776f 726b 732e 2020 4275 740a  ate works.  But.\n+00011b30: 2020 2020 2077 6865 6e20 796f 7520 6469       when you di\n+00011b40: 7374 7269 6275 7465 2074 6865 2073 616d  stribute the sam\n+00011b50: 6520 7365 6374 696f 6e73 2061 7320 7061  e sections as pa\n+00011b60: 7274 206f 6620 6120 7768 6f6c 6520 7768  rt of a whole wh\n+00011b70: 6963 6820 6973 2061 0a20 2020 2020 776f  ich is a.     wo\n+00011b80: 726b 2062 6173 6564 206f 6e20 7468 6520  rk based on the \n+00011b90: 5072 6f67 7261 6d2c 2074 6865 2064 6973  Program, the dis\n+00011ba0: 7472 6962 7574 696f 6e20 6f66 2074 6865  tribution of the\n+00011bb0: 2077 686f 6c65 206d 7573 7420 6265 206f   whole must be o\n+00011bc0: 6e0a 2020 2020 2074 6865 2074 6572 6d73  n.     the terms\n+00011bd0: 206f 6620 7468 6973 204c 6963 656e 7365   of this License\n+00011be0: 2c20 7768 6f73 6520 7065 726d 6973 7369  , whose permissi\n+00011bf0: 6f6e 7320 666f 7220 6f74 6865 7220 6c69  ons for other li\n+00011c00: 6365 6e73 6565 730a 2020 2020 2065 7874  censees.     ext\n+00011c10: 656e 6420 746f 2074 6865 2065 6e74 6972  end to the entir\n+00011c20: 6520 7768 6f6c 652c 2061 6e64 2074 6875  e whole, and thu\n+00011c30: 7320 746f 2065 6163 6820 616e 6420 6576  s to each and ev\n+00011c40: 6572 7920 7061 7274 0a20 2020 2020 7265  ery part.     re\n+00011c50: 6761 7264 6c65 7373 206f 6620 7768 6f20  gardless of who \n+00011c60: 7772 6f74 6520 6974 2e0a 0a20 2020 2020  wrote it...     \n+00011c70: 5468 7573 2c20 6974 2069 7320 6e6f 7420  Thus, it is not \n+00011c80: 7468 6520 696e 7465 6e74 206f 6620 7468  the intent of th\n+00011c90: 6973 2073 6563 7469 6f6e 2074 6f20 636c  is section to cl\n+00011ca0: 6169 6d20 7269 6768 7473 206f 720a 2020  aim rights or.  \n+00011cb0: 2020 2063 6f6e 7465 7374 2079 6f75 7220     contest your \n+00011cc0: 7269 6768 7473 2074 6f20 776f 726b 2077  rights to work w\n+00011cd0: 7269 7474 656e 2065 6e74 6972 656c 7920  ritten entirely \n+00011ce0: 6279 2079 6f75 3b20 7261 7468 6572 2c20  by you; rather, \n+00011cf0: 7468 650a 2020 2020 2069 6e74 656e 7420  the.     intent \n+00011d00: 6973 2074 6f20 6578 6572 6369 7365 2074  is to exercise t\n+00011d10: 6865 2072 6967 6874 2074 6f20 636f 6e74  he right to cont\n+00011d20: 726f 6c20 7468 6520 6469 7374 7269 6275  rol the distribu\n+00011d30: 7469 6f6e 206f 660a 2020 2020 2064 6572  tion of.     der\n+00011d40: 6976 6174 6976 6520 6f72 2063 6f6c 6c65  ivative or colle\n+00011d50: 6374 6976 6520 776f 726b 7320 6261 7365  ctive works base\n+00011d60: 6420 6f6e 2074 6865 2050 726f 6772 616d  d on the Program\n+00011d70: 2e0a 0a20 2020 2020 496e 2061 6464 6974  ...     In addit\n+00011d80: 696f 6e2c 206d 6572 6520 6167 6772 6567  ion, mere aggreg\n+00011d90: 6174 696f 6e20 6f66 2061 6e6f 7468 6572  ation of another\n+00011da0: 2077 6f72 6b20 6e6f 7420 6261 7365 6420   work not based \n+00011db0: 6f6e 2074 6865 0a20 2020 2020 5072 6f67  on the.     Prog\n+00011dc0: 7261 6d20 7769 7468 2074 6865 2050 726f  ram with the Pro\n+00011dd0: 6772 616d 2028 6f72 2077 6974 6820 6120  gram (or with a \n+00011de0: 776f 726b 2062 6173 6564 206f 6e20 7468  work based on th\n+00011df0: 6520 5072 6f67 7261 6d29 206f 6e20 610a  e Program) on a.\n+00011e00: 2020 2020 2076 6f6c 756d 6520 6f66 2061       volume of a\n+00011e10: 2073 746f 7261 6765 206f 7220 6469 7374   storage or dist\n+00011e20: 7269 6275 7469 6f6e 206d 6564 6975 6d20  ribution medium \n+00011e30: 646f 6573 206e 6f74 2062 7269 6e67 2074  does not bring t\n+00011e40: 6865 206f 7468 6572 0a20 2020 2020 776f  he other.     wo\n+00011e50: 726b 2075 6e64 6572 2074 6865 2073 636f  rk under the sco\n+00011e60: 7065 206f 6620 7468 6973 204c 6963 656e  pe of this Licen\n+00011e70: 7365 2e0a 0a20 2033 2e20 596f 7520 6d61  se...  3. You ma\n+00011e80: 7920 636f 7079 2061 6e64 2064 6973 7472  y copy and distr\n+00011e90: 6962 7574 6520 7468 6520 5072 6f67 7261  ibute the Progra\n+00011ea0: 6d20 286f 7220 6120 776f 726b 2062 6173  m (or a work bas\n+00011eb0: 6564 206f 6e20 6974 2c0a 2020 2020 2075  ed on it,.     u\n+00011ec0: 6e64 6572 2053 6563 7469 6f6e 2032 2920  nder Section 2) \n+00011ed0: 696e 206f 626a 6563 7420 636f 6465 206f  in object code o\n+00011ee0: 7220 6578 6563 7574 6162 6c65 2066 6f72  r executable for\n+00011ef0: 6d20 756e 6465 7220 7468 6520 7465 726d  m under the term\n+00011f00: 730a 2020 2020 206f 6620 5365 6374 696f  s.     of Sectio\n+00011f10: 6e73 2031 2061 6e64 2032 2061 626f 7665  ns 1 and 2 above\n+00011f20: 2070 726f 7669 6465 6420 7468 6174 2079   provided that y\n+00011f30: 6f75 2061 6c73 6f20 646f 206f 6e65 206f  ou also do one o\n+00011f40: 6620 7468 650a 2020 2020 2066 6f6c 6c6f  f the.     follo\n+00011f50: 7769 6e67 3a0a 0a20 2020 2020 2020 612e  wing:..       a.\n+00011f60: 2041 6363 6f6d 7061 6e79 2069 7420 7769   Accompany it wi\n+00011f70: 7468 2074 6865 2063 6f6d 706c 6574 6520  th the complete \n+00011f80: 636f 7272 6573 706f 6e64 696e 6720 6d61  corresponding ma\n+00011f90: 6368 696e 652d 7265 6164 6162 6c65 0a20  chine-readable. \n+00011fa0: 2020 2020 2020 2020 2073 6f75 7263 6520           source \n+00011fb0: 636f 6465 2c20 7768 6963 6820 6d75 7374  code, which must\n+00011fc0: 2062 6520 6469 7374 7269 6275 7465 6420   be distributed \n+00011fd0: 756e 6465 7220 7468 6520 7465 726d 7320  under the terms \n+00011fe0: 6f66 0a20 2020 2020 2020 2020 2053 6563  of.          Sec\n+00011ff0: 7469 6f6e 7320 3120 616e 6420 3220 6162  tions 1 and 2 ab\n+00012000: 6f76 6520 6f6e 2061 206d 6564 6975 6d20  ove on a medium \n+00012010: 6375 7374 6f6d 6172 696c 7920 7573 6564  customarily used\n+00012020: 2066 6f72 0a20 2020 2020 2020 2020 2073   for.          s\n+00012030: 6f66 7477 6172 6520 696e 7465 7263 6861  oftware intercha\n+00012040: 6e67 653b 206f 722c 0a0a 2020 2020 2020  nge; or,..      \n+00012050: 2062 2e20 4163 636f 6d70 616e 7920 6974   b. Accompany it\n+00012060: 2077 6974 6820 6120 7772 6974 7465 6e20   with a written \n+00012070: 6f66 6665 722c 2076 616c 6964 2066 6f72  offer, valid for\n+00012080: 2061 7420 6c65 6173 7420 7468 7265 650a   at least three.\n+00012090: 2020 2020 2020 2020 2020 7965 6172 732c            years,\n+000120a0: 2074 6f20 6769 7665 2061 6e79 2074 6869   to give any thi\n+000120b0: 7264 2070 6172 7479 2c20 666f 7220 6120  rd party, for a \n+000120c0: 6368 6172 6765 206e 6f20 6d6f 7265 2074  charge no more t\n+000120d0: 6861 6e20 796f 7572 0a20 2020 2020 2020  han your.       \n+000120e0: 2020 2063 6f73 7420 6f66 2070 6879 7369     cost of physi\n+000120f0: 6361 6c6c 7920 7065 7266 6f72 6d69 6e67  cally performing\n+00012100: 2073 6f75 7263 6520 6469 7374 7269 6275   source distribu\n+00012110: 7469 6f6e 2c20 6120 636f 6d70 6c65 7465  tion, a complete\n+00012120: 0a20 2020 2020 2020 2020 206d 6163 6869  .          machi\n+00012130: 6e65 2d72 6561 6461 626c 6520 636f 7079  ne-readable copy\n+00012140: 206f 6620 7468 6520 636f 7272 6573 706f   of the correspo\n+00012150: 6e64 696e 6720 736f 7572 6365 2063 6f64  nding source cod\n+00012160: 652c 2074 6f20 6265 0a20 2020 2020 2020  e, to be.       \n+00012170: 2020 2064 6973 7472 6962 7574 6564 2075     distributed u\n+00012180: 6e64 6572 2074 6865 2074 6572 6d73 206f  nder the terms o\n+00012190: 6620 5365 6374 696f 6e73 2031 2061 6e64  f Sections 1 and\n+000121a0: 2032 2061 626f 7665 206f 6e20 610a 2020   2 above on a.  \n+000121b0: 2020 2020 2020 2020 6d65 6469 756d 2063          medium c\n+000121c0: 7573 746f 6d61 7269 6c79 2075 7365 6420  ustomarily used \n+000121d0: 666f 7220 736f 6674 7761 7265 2069 6e74  for software int\n+000121e0: 6572 6368 616e 6765 3b20 6f72 2c0a 0a20  erchange; or,.. \n+000121f0: 2020 2020 2020 632e 2041 6363 6f6d 7061        c. Accompa\n+00012200: 6e79 2069 7420 7769 7468 2074 6865 2069  ny it with the i\n+00012210: 6e66 6f72 6d61 7469 6f6e 2079 6f75 2072  nformation you r\n+00012220: 6563 6569 7665 6420 6173 2074 6f20 7468  eceived as to th\n+00012230: 6520 6f66 6665 720a 2020 2020 2020 2020  e offer.        \n+00012240: 2020 746f 2064 6973 7472 6962 7574 6520    to distribute \n+00012250: 636f 7272 6573 706f 6e64 696e 6720 736f  corresponding so\n+00012260: 7572 6365 2063 6f64 652e 2020 2854 6869  urce code.  (Thi\n+00012270: 7320 616c 7465 726e 6174 6976 6520 6973  s alternative is\n+00012280: 0a20 2020 2020 2020 2020 2061 6c6c 6f77  .          allow\n+00012290: 6564 206f 6e6c 7920 666f 7220 6e6f 6e63  ed only for nonc\n+000122a0: 6f6d 6d65 7263 6961 6c20 6469 7374 7269  ommercial distri\n+000122b0: 6275 7469 6f6e 2061 6e64 206f 6e6c 7920  bution and only \n+000122c0: 6966 2079 6f75 0a20 2020 2020 2020 2020  if you.         \n+000122d0: 2072 6563 6569 7665 6420 7468 6520 7072   received the pr\n+000122e0: 6f67 7261 6d20 696e 206f 626a 6563 7420  ogram in object \n+000122f0: 636f 6465 206f 7220 6578 6563 7574 6162  code or executab\n+00012300: 6c65 2066 6f72 6d20 7769 7468 0a20 2020  le form with.   \n+00012310: 2020 2020 2020 2073 7563 6820 616e 206f         such an o\n+00012320: 6666 6572 2c20 696e 2061 6363 6f72 6420  ffer, in accord \n+00012330: 7769 7468 2053 7562 7365 6374 696f 6e20  with Subsection \n+00012340: 6220 6162 6f76 652e 290a 0a20 2020 2020  b above.)..     \n+00012350: 5468 6520 736f 7572 6365 2063 6f64 6520  The source code \n+00012360: 666f 7220 6120 776f 726b 206d 6561 6e73  for a work means\n+00012370: 2074 6865 2070 7265 6665 7272 6564 2066   the preferred f\n+00012380: 6f72 6d20 6f66 2074 6865 2077 6f72 6b20  orm of the work \n+00012390: 666f 720a 2020 2020 206d 616b 696e 6720  for.     making \n+000123a0: 6d6f 6469 6669 6361 7469 6f6e 7320 746f  modifications to\n+000123b0: 2069 742e 2020 466f 7220 616e 2065 7865   it.  For an exe\n+000123c0: 6375 7461 626c 6520 776f 726b 2c20 636f  cutable work, co\n+000123d0: 6d70 6c65 7465 0a20 2020 2020 736f 7572  mplete.     sour\n+000123e0: 6365 2063 6f64 6520 6d65 616e 7320 616c  ce code means al\n+000123f0: 6c20 7468 6520 736f 7572 6365 2063 6f64  l the source cod\n+00012400: 6520 666f 7220 616c 6c20 6d6f 6475 6c65  e for all module\n+00012410: 7320 6974 2063 6f6e 7461 696e 732c 0a20  s it contains,. \n+00012420: 2020 2020 706c 7573 2061 6e79 2061 7373      plus any ass\n+00012430: 6f63 6961 7465 6420 696e 7465 7266 6163  ociated interfac\n+00012440: 6520 6465 6669 6e69 7469 6f6e 2066 696c  e definition fil\n+00012450: 6573 2c20 706c 7573 2074 6865 2073 6372  es, plus the scr\n+00012460: 6970 7473 0a20 2020 2020 7573 6564 2074  ipts.     used t\n+00012470: 6f20 636f 6e74 726f 6c20 636f 6d70 696c  o control compil\n+00012480: 6174 696f 6e20 616e 6420 696e 7374 616c  ation and instal\n+00012490: 6c61 7469 6f6e 206f 6620 7468 6520 6578  lation of the ex\n+000124a0: 6563 7574 6162 6c65 2e0a 2020 2020 2048  ecutable..     H\n+000124b0: 6f77 6576 6572 2c20 6173 2061 2073 7065  owever, as a spe\n+000124c0: 6369 616c 2065 7863 6570 7469 6f6e 2c20  cial exception, \n+000124d0: 7468 6520 736f 7572 6365 2063 6f64 6520  the source code \n+000124e0: 6469 7374 7269 6275 7465 6420 6e65 6564  distributed need\n+000124f0: 0a20 2020 2020 6e6f 7420 696e 636c 7564  .     not includ\n+00012500: 6520 616e 7974 6869 6e67 2074 6861 7420  e anything that \n+00012510: 6973 206e 6f72 6d61 6c6c 7920 6469 7374  is normally dist\n+00012520: 7269 6275 7465 6420 2869 6e20 6569 7468  ributed (in eith\n+00012530: 6572 2073 6f75 7263 650a 2020 2020 206f  er source.     o\n+00012540: 7220 6269 6e61 7279 2066 6f72 6d29 2077  r binary form) w\n+00012550: 6974 6820 7468 6520 6d61 6a6f 7220 636f  ith the major co\n+00012560: 6d70 6f6e 656e 7473 2028 636f 6d70 696c  mponents (compil\n+00012570: 6572 2c20 6b65 726e 656c 2c20 616e 6420  er, kernel, and \n+00012580: 736f 0a20 2020 2020 6f6e 2920 6f66 2074  so.     on) of t\n+00012590: 6865 206f 7065 7261 7469 6e67 2073 7973  he operating sys\n+000125a0: 7465 6d20 6f6e 2077 6869 6368 2074 6865  tem on which the\n+000125b0: 2065 7865 6375 7461 626c 6520 7275 6e73   executable runs\n+000125c0: 2c20 756e 6c65 7373 0a20 2020 2020 7468  , unless.     th\n+000125d0: 6174 2063 6f6d 706f 6e65 6e74 2069 7473  at component its\n+000125e0: 656c 6620 6163 636f 6d70 616e 6965 7320  elf accompanies \n+000125f0: 7468 6520 6578 6563 7574 6162 6c65 2e0a  the executable..\n+00012600: 0a20 2020 2020 4966 2064 6973 7472 6962  .     If distrib\n+00012610: 7574 696f 6e20 6f66 2065 7865 6375 7461  ution of executa\n+00012620: 626c 6520 6f72 206f 626a 6563 7420 636f  ble or object co\n+00012630: 6465 2069 7320 6d61 6465 2062 7920 6f66  de is made by of\n+00012640: 6665 7269 6e67 0a20 2020 2020 6163 6365  fering.     acce\n+00012650: 7373 2074 6f20 636f 7079 2066 726f 6d20  ss to copy from \n+00012660: 6120 6465 7369 676e 6174 6564 2070 6c61  a designated pla\n+00012670: 6365 2c20 7468 656e 206f 6666 6572 696e  ce, then offerin\n+00012680: 6720 6571 7569 7661 6c65 6e74 0a20 2020  g equivalent.   \n+00012690: 2020 6163 6365 7373 2074 6f20 636f 7079    access to copy\n+000126a0: 2074 6865 2073 6f75 7263 6520 636f 6465   the source code\n+000126b0: 2066 726f 6d20 7468 6520 7361 6d65 2070   from the same p\n+000126c0: 6c61 6365 2063 6f75 6e74 7320 6173 0a20  lace counts as. \n+000126d0: 2020 2020 6469 7374 7269 6275 7469 6f6e      distribution\n+000126e0: 206f 6620 7468 6520 736f 7572 6365 2063   of the source c\n+000126f0: 6f64 652c 2065 7665 6e20 7468 6f75 6768  ode, even though\n+00012700: 2074 6869 7264 2070 6172 7469 6573 2061   third parties a\n+00012710: 7265 206e 6f74 0a20 2020 2020 636f 6d70  re not.     comp\n+00012720: 656c 6c65 6420 746f 2063 6f70 7920 7468  elled to copy th\n+00012730: 6520 736f 7572 6365 2061 6c6f 6e67 2077  e source along w\n+00012740: 6974 6820 7468 6520 6f62 6a65 6374 2063  ith the object c\n+00012750: 6f64 652e 0a0a 2020 342e 2059 6f75 206d  ode...  4. You m\n+00012760: 6179 206e 6f74 2063 6f70 792c 206d 6f64  ay not copy, mod\n+00012770: 6966 792c 2073 7562 6c69 6365 6e73 652c  ify, sublicense,\n+00012780: 206f 7220 6469 7374 7269 6275 7465 2074   or distribute t\n+00012790: 6865 2050 726f 6772 616d 0a20 2020 2020  he Program.     \n+000127a0: 6578 6365 7074 2061 7320 6578 7072 6573  except as expres\n+000127b0: 736c 7920 7072 6f76 6964 6564 2075 6e64  sly provided und\n+000127c0: 6572 2074 6869 7320 4c69 6365 6e73 652e  er this License.\n+000127d0: 2020 416e 7920 6174 7465 6d70 740a 2020    Any attempt.  \n+000127e0: 2020 206f 7468 6572 7769 7365 2074 6f20     otherwise to \n+000127f0: 636f 7079 2c20 6d6f 6469 6679 2c20 7375  copy, modify, su\n+00012800: 626c 6963 656e 7365 206f 7220 6469 7374  blicense or dist\n+00012810: 7269 6275 7465 2074 6865 2050 726f 6772  ribute the Progr\n+00012820: 616d 2069 730a 2020 2020 2076 6f69 642c  am is.     void,\n+00012830: 2061 6e64 2077 696c 6c20 6175 746f 6d61   and will automa\n+00012840: 7469 6361 6c6c 7920 7465 726d 696e 6174  tically terminat\n+00012850: 6520 796f 7572 2072 6967 6874 7320 756e  e your rights un\n+00012860: 6465 7220 7468 6973 0a20 2020 2020 4c69  der this.     Li\n+00012870: 6365 6e73 652e 2020 486f 7765 7665 722c  cense.  However,\n+00012880: 2070 6172 7469 6573 2077 686f 2068 6176   parties who hav\n+00012890: 6520 7265 6365 6976 6564 2063 6f70 6965  e received copie\n+000128a0: 732c 206f 7220 7269 6768 7473 2c0a 2020  s, or rights,.  \n+000128b0: 2020 2066 726f 6d20 796f 7520 756e 6465     from you unde\n+000128c0: 7220 7468 6973 204c 6963 656e 7365 2077  r this License w\n+000128d0: 696c 6c20 6e6f 7420 6861 7665 2074 6865  ill not have the\n+000128e0: 6972 206c 6963 656e 7365 7320 7465 726d  ir licenses term\n+000128f0: 696e 6174 6564 0a20 2020 2020 736f 206c  inated.     so l\n+00012900: 6f6e 6720 6173 2073 7563 6820 7061 7274  ong as such part\n+00012910: 6965 7320 7265 6d61 696e 2069 6e20 6675  ies remain in fu\n+00012920: 6c6c 2063 6f6d 706c 6961 6e63 652e 0a0a  ll compliance...\n+00012930: 2020 352e 2059 6f75 2061 7265 206e 6f74    5. You are not\n+00012940: 2072 6571 7569 7265 6420 746f 2061 6363   required to acc\n+00012950: 6570 7420 7468 6973 204c 6963 656e 7365  ept this License\n+00012960: 2c20 7369 6e63 6520 796f 7520 6861 7665  , since you have\n+00012970: 206e 6f74 0a20 2020 2020 7369 676e 6564   not.     signed\n+00012980: 2069 742e 2020 486f 7765 7665 722c 206e   it.  However, n\n+00012990: 6f74 6869 6e67 2065 6c73 6520 6772 616e  othing else gran\n+000129a0: 7473 2079 6f75 2070 6572 6d69 7373 696f  ts you permissio\n+000129b0: 6e20 746f 206d 6f64 6966 790a 2020 2020  n to modify.    \n+000129c0: 206f 7220 6469 7374 7269 6275 7465 2074   or distribute t\n+000129d0: 6865 2050 726f 6772 616d 206f 7220 6974  he Program or it\n+000129e0: 7320 6465 7269 7661 7469 7665 2077 6f72  s derivative wor\n+000129f0: 6b73 2e20 2054 6865 7365 2061 6374 696f  ks.  These actio\n+00012a00: 6e73 0a20 2020 2020 6172 6520 7072 6f68  ns.     are proh\n+00012a10: 6962 6974 6564 2062 7920 6c61 7720 6966  ibited by law if\n+00012a20: 2079 6f75 2064 6f20 6e6f 7420 6163 6365   you do not acce\n+00012a30: 7074 2074 6869 7320 4c69 6365 6e73 652e  pt this License.\n+00012a40: 0a20 2020 2020 5468 6572 6566 6f72 652c  .     Therefore,\n+00012a50: 2062 7920 6d6f 6469 6679 696e 6720 6f72   by modifying or\n+00012a60: 2064 6973 7472 6962 7574 696e 6720 7468   distributing th\n+00012a70: 6520 5072 6f67 7261 6d20 286f 7220 616e  e Program (or an\n+00012a80: 7920 776f 726b 0a20 2020 2020 6261 7365  y work.     base\n+00012a90: 6420 6f6e 2074 6865 2050 726f 6772 616d  d on the Program\n+00012aa0: 292c 2079 6f75 2069 6e64 6963 6174 6520  ), you indicate \n+00012ab0: 796f 7572 2061 6363 6570 7461 6e63 6520  your acceptance \n+00012ac0: 6f66 2074 6869 7320 4c69 6365 6e73 650a  of this License.\n+00012ad0: 2020 2020 2074 6f20 646f 2073 6f2c 2061       to do so, a\n+00012ae0: 6e64 2061 6c6c 2069 7473 2074 6572 6d73  nd all its terms\n+00012af0: 2061 6e64 2063 6f6e 6469 7469 6f6e 7320   and conditions \n+00012b00: 666f 7220 636f 7079 696e 672c 0a20 2020  for copying,.   \n+00012b10: 2020 6469 7374 7269 6275 7469 6e67 206f    distributing o\n+00012b20: 7220 6d6f 6469 6679 696e 6720 7468 6520  r modifying the \n+00012b30: 5072 6f67 7261 6d20 6f72 2077 6f72 6b73  Program or works\n+00012b40: 2062 6173 6564 206f 6e20 6974 2e0a 0a20   based on it... \n+00012b50: 2036 2e20 4561 6368 2074 696d 6520 796f   6. Each time yo\n+00012b60: 7520 7265 6469 7374 7269 6275 7465 2074  u redistribute t\n+00012b70: 6865 2050 726f 6772 616d 2028 6f72 2061  he Program (or a\n+00012b80: 6e79 2077 6f72 6b20 6261 7365 6420 6f6e  ny work based on\n+00012b90: 2074 6865 0a20 2020 2020 5072 6f67 7261   the.     Progra\n+00012ba0: 6d29 2c20 7468 6520 7265 6369 7069 656e  m), the recipien\n+00012bb0: 7420 6175 746f 6d61 7469 6361 6c6c 7920  t automatically \n+00012bc0: 7265 6365 6976 6573 2061 206c 6963 656e  receives a licen\n+00012bd0: 7365 2066 726f 6d20 7468 650a 2020 2020  se from the.    \n+00012be0: 206f 7269 6769 6e61 6c20 6c69 6365 6e73   original licens\n+00012bf0: 6f72 2074 6f20 636f 7079 2c20 6469 7374  or to copy, dist\n+00012c00: 7269 6275 7465 206f 7220 6d6f 6469 6679  ribute or modify\n+00012c10: 2074 6865 2050 726f 6772 616d 2073 7562   the Program sub\n+00012c20: 6a65 6374 0a20 2020 2020 746f 2074 6865  ject.     to the\n+00012c30: 7365 2074 6572 6d73 2061 6e64 2063 6f6e  se terms and con\n+00012c40: 6469 7469 6f6e 732e 2020 596f 7520 6d61  ditions.  You ma\n+00012c50: 7920 6e6f 7420 696d 706f 7365 2061 6e79  y not impose any\n+00012c60: 2066 7572 7468 6572 0a20 2020 2020 7265   further.     re\n+00012c70: 7374 7269 6374 696f 6e73 206f 6e20 7468  strictions on th\n+00012c80: 6520 7265 6369 7069 656e 7473 2720 6578  e recipients' ex\n+00012c90: 6572 6369 7365 206f 6620 7468 6520 7269  ercise of the ri\n+00012ca0: 6768 7473 2067 7261 6e74 6564 0a20 2020  ghts granted.   \n+00012cb0: 2020 6865 7265 696e 2e20 2059 6f75 2061    herein.  You a\n+00012cc0: 7265 206e 6f74 2072 6573 706f 6e73 6962  re not responsib\n+00012cd0: 6c65 2066 6f72 2065 6e66 6f72 6369 6e67  le for enforcing\n+00012ce0: 2063 6f6d 706c 6961 6e63 6520 6279 2074   compliance by t\n+00012cf0: 6869 7264 0a20 2020 2020 7061 7274 6965  hird.     partie\n+00012d00: 7320 746f 2074 6869 7320 4c69 6365 6e73  s to this Licens\n+00012d10: 652e 0a0a 2020 372e 2049 662c 2061 7320  e...  7. If, as \n+00012d20: 6120 636f 6e73 6571 7565 6e63 6520 6f66  a consequence of\n+00012d30: 2061 2063 6f75 7274 206a 7564 676d 656e   a court judgmen\n+00012d40: 7420 6f72 2061 6c6c 6567 6174 696f 6e20  t or allegation \n+00012d50: 6f66 2070 6174 656e 740a 2020 2020 2069  of patent.     i\n+00012d60: 6e66 7269 6e67 656d 656e 7420 6f72 2066  nfringement or f\n+00012d70: 6f72 2061 6e79 206f 7468 6572 2072 6561  or any other rea\n+00012d80: 736f 6e20 286e 6f74 206c 696d 6974 6564  son (not limited\n+00012d90: 2074 6f20 7061 7465 6e74 0a20 2020 2020   to patent.     \n+00012da0: 6973 7375 6573 292c 2063 6f6e 6469 7469  issues), conditi\n+00012db0: 6f6e 7320 6172 6520 696d 706f 7365 6420  ons are imposed \n+00012dc0: 6f6e 2079 6f75 2028 7768 6574 6865 7220  on you (whether \n+00012dd0: 6279 2063 6f75 7274 206f 7264 6572 2c0a  by court order,.\n+00012de0: 2020 2020 2061 6772 6565 6d65 6e74 206f       agreement o\n+00012df0: 7220 6f74 6865 7277 6973 6529 2074 6861  r otherwise) tha\n+00012e00: 7420 636f 6e74 7261 6469 6374 2074 6865  t contradict the\n+00012e10: 2063 6f6e 6469 7469 6f6e 7320 6f66 2074   conditions of t\n+00012e20: 6869 730a 2020 2020 204c 6963 656e 7365  his.     License\n+00012e30: 2c20 7468 6579 2064 6f20 6e6f 7420 6578  , they do not ex\n+00012e40: 6375 7365 2079 6f75 2066 726f 6d20 7468  cuse you from th\n+00012e50: 6520 636f 6e64 6974 696f 6e73 206f 6620  e conditions of \n+00012e60: 7468 6973 0a20 2020 2020 4c69 6365 6e73  this.     Licens\n+00012e70: 652e 2020 4966 2079 6f75 2063 616e 6e6f  e.  If you canno\n+00012e80: 7420 6469 7374 7269 6275 7465 2073 6f20  t distribute so \n+00012e90: 6173 2074 6f20 7361 7469 7366 7920 7369  as to satisfy si\n+00012ea0: 6d75 6c74 616e 656f 7573 6c79 0a20 2020  multaneously.   \n+00012eb0: 2020 796f 7572 206f 626c 6967 6174 696f    your obligatio\n+00012ec0: 6e73 2075 6e64 6572 2074 6869 7320 4c69  ns under this Li\n+00012ed0: 6365 6e73 6520 616e 6420 616e 7920 6f74  cense and any ot\n+00012ee0: 6865 7220 7065 7274 696e 656e 740a 2020  her pertinent.  \n+00012ef0: 2020 206f 626c 6967 6174 696f 6e73 2c20     obligations, \n+00012f00: 7468 656e 2061 7320 6120 636f 6e73 6571  then as a conseq\n+00012f10: 7565 6e63 6520 796f 7520 6d61 7920 6e6f  uence you may no\n+00012f20: 7420 6469 7374 7269 6275 7465 2074 6865  t distribute the\n+00012f30: 0a20 2020 2020 5072 6f67 7261 6d20 6174  .     Program at\n+00012f40: 2061 6c6c 2e20 2046 6f72 2065 7861 6d70   all.  For examp\n+00012f50: 6c65 2c20 6966 2061 2070 6174 656e 7420  le, if a patent \n+00012f60: 6c69 6365 6e73 6520 776f 756c 6420 6e6f  license would no\n+00012f70: 7420 7065 726d 6974 0a20 2020 2020 726f  t permit.     ro\n+00012f80: 7961 6c74 792d 6672 6565 2072 6564 6973  yalty-free redis\n+00012f90: 7472 6962 7574 696f 6e20 6f66 2074 6865  tribution of the\n+00012fa0: 2050 726f 6772 616d 2062 7920 616c 6c20   Program by all \n+00012fb0: 7468 6f73 6520 7768 6f20 7265 6365 6976  those who receiv\n+00012fc0: 650a 2020 2020 2063 6f70 6965 7320 6469  e.     copies di\n+00012fd0: 7265 6374 6c79 206f 7220 696e 6469 7265  rectly or indire\n+00012fe0: 6374 6c79 2074 6872 6f75 6768 2079 6f75  ctly through you\n+00012ff0: 2c20 7468 656e 2074 6865 206f 6e6c 7920  , then the only \n+00013000: 7761 7920 796f 750a 2020 2020 2063 6f75  way you.     cou\n+00013010: 6c64 2073 6174 6973 6679 2062 6f74 6820  ld satisfy both \n+00013020: 6974 2061 6e64 2074 6869 7320 4c69 6365  it and this Lice\n+00013030: 6e73 6520 776f 756c 6420 6265 2074 6f20  nse would be to \n+00013040: 7265 6672 6169 6e20 656e 7469 7265 6c79  refrain entirely\n+00013050: 0a20 2020 2020 6672 6f6d 2064 6973 7472  .     from distr\n+00013060: 6962 7574 696f 6e20 6f66 2074 6865 2050  ibution of the P\n+00013070: 726f 6772 616d 2e0a 0a20 2020 2020 4966  rogram...     If\n+00013080: 2061 6e79 2070 6f72 7469 6f6e 206f 6620   any portion of \n+00013090: 7468 6973 2073 6563 7469 6f6e 2069 7320  this section is \n+000130a0: 6865 6c64 2069 6e76 616c 6964 206f 7220  held invalid or \n+000130b0: 756e 656e 666f 7263 6561 626c 650a 2020  unenforceable.  \n+000130c0: 2020 2075 6e64 6572 2061 6e79 2070 6172     under any par\n+000130d0: 7469 6375 6c61 7220 6369 7263 756d 7374  ticular circumst\n+000130e0: 616e 6365 2c20 7468 6520 6261 6c61 6e63  ance, the balanc\n+000130f0: 6520 6f66 2074 6865 2073 6563 7469 6f6e  e of the section\n+00013100: 2069 730a 2020 2020 2069 6e74 656e 6465   is.     intende\n+00013110: 6420 746f 2061 7070 6c79 2061 6e64 2074  d to apply and t\n+00013120: 6865 2073 6563 7469 6f6e 2061 7320 6120  he section as a \n+00013130: 7768 6f6c 6520 6973 2069 6e74 656e 6465  whole is intende\n+00013140: 6420 746f 2061 7070 6c79 0a20 2020 2020  d to apply.     \n+00013150: 696e 206f 7468 6572 2063 6972 6375 6d73  in other circums\n+00013160: 7461 6e63 6573 2e0a 0a20 2020 2020 4974  tances...     It\n+00013170: 2069 7320 6e6f 7420 7468 6520 7075 7270   is not the purp\n+00013180: 6f73 6520 6f66 2074 6869 7320 7365 6374  ose of this sect\n+00013190: 696f 6e20 746f 2069 6e64 7563 6520 796f  ion to induce yo\n+000131a0: 7520 746f 2069 6e66 7269 6e67 6520 616e  u to infringe an\n+000131b0: 790a 2020 2020 2070 6174 656e 7473 206f  y.     patents o\n+000131c0: 7220 6f74 6865 7220 7072 6f70 6572 7479  r other property\n+000131d0: 2072 6967 6874 2063 6c61 696d 7320 6f72   right claims or\n+000131e0: 2074 6f20 636f 6e74 6573 7420 7661 6c69   to contest vali\n+000131f0: 6469 7479 206f 660a 2020 2020 2061 6e79  dity of.     any\n+00013200: 2073 7563 6820 636c 6169 6d73 3b20 7468   such claims; th\n+00013210: 6973 2073 6563 7469 6f6e 2068 6173 2074  is section has t\n+00013220: 6865 2073 6f6c 6520 7075 7270 6f73 6520  he sole purpose \n+00013230: 6f66 2070 726f 7465 6374 696e 670a 2020  of protecting.  \n+00013240: 2020 2074 6865 2069 6e74 6567 7269 7479     the integrity\n+00013250: 206f 6620 7468 6520 6672 6565 2073 6f66   of the free sof\n+00013260: 7477 6172 6520 6469 7374 7269 6275 7469  tware distributi\n+00013270: 6f6e 2073 7973 7465 6d2c 2077 6869 6368  on system, which\n+00013280: 2069 730a 2020 2020 2069 6d70 6c65 6d65   is.     impleme\n+00013290: 6e74 6564 2062 7920 7075 626c 6963 206c  nted by public l\n+000132a0: 6963 656e 7365 2070 7261 6374 6963 6573  icense practices\n+000132b0: 2e20 204d 616e 7920 7065 6f70 6c65 2068  .  Many people h\n+000132c0: 6176 6520 6d61 6465 0a20 2020 2020 6765  ave made.     ge\n+000132d0: 6e65 726f 7573 2063 6f6e 7472 6962 7574  nerous contribut\n+000132e0: 696f 6e73 2074 6f20 7468 6520 7769 6465  ions to the wide\n+000132f0: 2072 616e 6765 206f 6620 736f 6674 7761   range of softwa\n+00013300: 7265 2064 6973 7472 6962 7574 6564 0a20  re distributed. \n+00013310: 2020 2020 7468 726f 7567 6820 7468 6174      through that\n+00013320: 2073 7973 7465 6d20 696e 2072 656c 6961   system in relia\n+00013330: 6e63 6520 6f6e 2063 6f6e 7369 7374 656e  nce on consisten\n+00013340: 7420 6170 706c 6963 6174 696f 6e20 6f66  t application of\n+00013350: 2074 6861 740a 2020 2020 2073 7973 7465   that.     syste\n+00013360: 6d3b 2069 7420 6973 2075 7020 746f 2074  m; it is up to t\n+00013370: 6865 2061 7574 686f 722f 646f 6e6f 7220  he author/donor \n+00013380: 746f 2064 6563 6964 6520 6966 2068 6520  to decide if he \n+00013390: 6f72 2073 6865 2069 730a 2020 2020 2077  or she is.     w\n+000133a0: 696c 6c69 6e67 2074 6f20 6469 7374 7269  illing to distri\n+000133b0: 6275 7465 2073 6f66 7477 6172 6520 7468  bute software th\n+000133c0: 726f 7567 6820 616e 7920 6f74 6865 7220  rough any other \n+000133d0: 7379 7374 656d 2061 6e64 2061 0a20 2020  system and a.   \n+000133e0: 2020 6c69 6365 6e73 6565 2063 616e 6e6f    licensee canno\n+000133f0: 7420 696d 706f 7365 2074 6861 7420 6368  t impose that ch\n+00013400: 6f69 6365 2e0a 0a20 2020 2020 5468 6973  oice...     This\n+00013410: 2073 6563 7469 6f6e 2069 7320 696e 7465   section is inte\n+00013420: 6e64 6564 2074 6f20 6d61 6b65 2074 686f  nded to make tho\n+00013430: 726f 7567 686c 7920 636c 6561 7220 7768  roughly clear wh\n+00013440: 6174 2069 7320 6265 6c69 6576 6564 0a20  at is believed. \n+00013450: 2020 2020 746f 2062 6520 6120 636f 6e73      to be a cons\n+00013460: 6571 7565 6e63 6520 6f66 2074 6865 2072  equence of the r\n+00013470: 6573 7420 6f66 2074 6869 7320 4c69 6365  est of this Lice\n+00013480: 6e73 652e 0a0a 2020 382e 2049 6620 7468  nse...  8. If th\n+00013490: 6520 6469 7374 7269 6275 7469 6f6e 2061  e distribution a\n+000134a0: 6e64 2f6f 7220 7573 6520 6f66 2074 6865  nd/or use of the\n+000134b0: 2050 726f 6772 616d 2069 7320 7265 7374   Program is rest\n+000134c0: 7269 6374 6564 2069 6e0a 2020 2020 2063  ricted in.     c\n+000134d0: 6572 7461 696e 2063 6f75 6e74 7269 6573  ertain countries\n+000134e0: 2065 6974 6865 7220 6279 2070 6174 656e   either by paten\n+000134f0: 7473 206f 7220 6279 2063 6f70 7972 6967  ts or by copyrig\n+00013500: 6874 6564 2069 6e74 6572 6661 6365 732c  hted interfaces,\n+00013510: 0a20 2020 2020 7468 6520 6f72 6967 696e  .     the origin\n+00013520: 616c 2063 6f70 7972 6967 6874 2068 6f6c  al copyright hol\n+00013530: 6465 7220 7768 6f20 706c 6163 6573 2074  der who places t\n+00013540: 6865 2050 726f 6772 616d 2075 6e64 6572  he Program under\n+00013550: 2074 6869 730a 2020 2020 204c 6963 656e   this.     Licen\n+00013560: 7365 206d 6179 2061 6464 2061 6e20 6578  se may add an ex\n+00013570: 706c 6963 6974 2067 656f 6772 6170 6869  plicit geographi\n+00013580: 6361 6c20 6469 7374 7269 6275 7469 6f6e  cal distribution\n+00013590: 206c 696d 6974 6174 696f 6e0a 2020 2020   limitation.    \n+000135a0: 2065 7863 6c75 6469 6e67 2074 686f 7365   excluding those\n+000135b0: 2063 6f75 6e74 7269 6573 2c20 736f 2074   countries, so t\n+000135c0: 6861 7420 6469 7374 7269 6275 7469 6f6e  hat distribution\n+000135d0: 2069 7320 7065 726d 6974 7465 6420 6f6e   is permitted on\n+000135e0: 6c79 0a20 2020 2020 696e 206f 7220 616d  ly.     in or am\n+000135f0: 6f6e 6720 636f 756e 7472 6965 7320 6e6f  ong countries no\n+00013600: 7420 7468 7573 2065 7863 6c75 6465 642e  t thus excluded.\n+00013610: 2020 496e 2073 7563 6820 6361 7365 2c20    In such case, \n+00013620: 7468 6973 0a20 2020 2020 4c69 6365 6e73  this.     Licens\n+00013630: 6520 696e 636f 7270 6f72 6174 6573 2074  e incorporates t\n+00013640: 6865 206c 696d 6974 6174 696f 6e20 6173  he limitation as\n+00013650: 2069 6620 7772 6974 7465 6e20 696e 2074   if written in t\n+00013660: 6865 2062 6f64 7920 6f66 0a20 2020 2020  he body of.     \n+00013670: 7468 6973 204c 6963 656e 7365 2e0a 0a20  this License... \n+00013680: 2039 2e20 5468 6520 4672 6565 2053 6f66   9. The Free Sof\n+00013690: 7477 6172 6520 466f 756e 6461 7469 6f6e  tware Foundation\n+000136a0: 206d 6179 2070 7562 6c69 7368 2072 6576   may publish rev\n+000136b0: 6973 6564 2061 6e64 2f6f 7220 6e65 770a  ised and/or new.\n+000136c0: 2020 2020 2076 6572 7369 6f6e 7320 6f66       versions of\n+000136d0: 2074 6865 2047 656e 6572 616c 2050 7562   the General Pub\n+000136e0: 6c69 6320 4c69 6365 6e73 6520 6672 6f6d  lic License from\n+000136f0: 2074 696d 6520 746f 2074 696d 652e 2020   time to time.  \n+00013700: 5375 6368 206e 6577 0a20 2020 2020 7665  Such new.     ve\n+00013710: 7273 696f 6e73 2077 696c 6c20 6265 2073  rsions will be s\n+00013720: 696d 696c 6172 2069 6e20 7370 6972 6974  imilar in spirit\n+00013730: 2074 6f20 7468 6520 7072 6573 656e 7420   to the present \n+00013740: 7665 7273 696f 6e2c 2062 7574 206d 6179  version, but may\n+00013750: 0a20 2020 2020 6469 6666 6572 2069 6e20  .     differ in \n+00013760: 6465 7461 696c 2074 6f20 6164 6472 6573  detail to addres\n+00013770: 7320 6e65 7720 7072 6f62 6c65 6d73 206f  s new problems o\n+00013780: 7220 636f 6e63 6572 6e73 2e0a 0a20 2020  r concerns...   \n+00013790: 2020 4561 6368 2076 6572 7369 6f6e 2069    Each version i\n+000137a0: 7320 6769 7665 6e20 6120 6469 7374 696e  s given a distin\n+000137b0: 6775 6973 6869 6e67 2076 6572 7369 6f6e  guishing version\n+000137c0: 206e 756d 6265 722e 2020 4966 2074 6865   number.  If the\n+000137d0: 0a20 2020 2020 5072 6f67 7261 6d20 7370  .     Program sp\n+000137e0: 6563 6966 6965 7320 6120 7665 7273 696f  ecifies a versio\n+000137f0: 6e20 6e75 6d62 6572 206f 6620 7468 6973  n number of this\n+00013800: 204c 6963 656e 7365 2077 6869 6368 2061   License which a\n+00013810: 7070 6c69 6573 2074 6f0a 2020 2020 2069  pplies to.     i\n+00013820: 7420 616e 6420 2261 6e79 206c 6174 6572  t and \"any later\n+00013830: 2076 6572 7369 6f6e 222c 2079 6f75 2068   version\", you h\n+00013840: 6176 6520 7468 6520 6f70 7469 6f6e 206f  ave the option o\n+00013850: 6620 666f 6c6c 6f77 696e 6720 7468 650a  f following the.\n+00013860: 2020 2020 2074 6572 6d73 2061 6e64 2063       terms and c\n+00013870: 6f6e 6469 7469 6f6e 7320 6569 7468 6572  onditions either\n+00013880: 206f 6620 7468 6174 2076 6572 7369 6f6e   of that version\n+00013890: 206f 7220 6f66 2061 6e79 206c 6174 6572   or of any later\n+000138a0: 2076 6572 7369 6f6e 0a20 2020 2020 7075   version.     pu\n+000138b0: 626c 6973 6865 6420 6279 2074 6865 2046  blished by the F\n+000138c0: 7265 6520 536f 6674 7761 7265 2046 6f75  ree Software Fou\n+000138d0: 6e64 6174 696f 6e2e 2020 4966 2074 6865  ndation.  If the\n+000138e0: 2050 726f 6772 616d 2064 6f65 7320 6e6f   Program does no\n+000138f0: 740a 2020 2020 2073 7065 6369 6679 2061  t.     specify a\n+00013900: 2076 6572 7369 6f6e 206e 756d 6265 7220   version number \n+00013910: 6f66 2074 6869 7320 4c69 6365 6e73 652c  of this License,\n+00013920: 2079 6f75 206d 6179 2063 686f 6f73 6520   you may choose \n+00013930: 616e 790a 2020 2020 2076 6572 7369 6f6e  any.     version\n+00013940: 2065 7665 7220 7075 626c 6973 6865 6420   ever published \n+00013950: 6279 2074 6865 2046 7265 6520 536f 6674  by the Free Soft\n+00013960: 7761 7265 2046 6f75 6e64 6174 696f 6e2e  ware Foundation.\n+00013970: 0a0a 2020 3130 2e20 4966 2079 6f75 2077  ..  10. If you w\n+00013980: 6973 6820 746f 2069 6e63 6f72 706f 7261  ish to incorpora\n+00013990: 7465 2070 6172 7473 206f 6620 7468 6520  te parts of the \n+000139a0: 5072 6f67 7261 6d20 696e 746f 206f 7468  Program into oth\n+000139b0: 6572 2066 7265 650a 2020 2020 2070 726f  er free.     pro\n+000139c0: 6772 616d 7320 7768 6f73 6520 6469 7374  grams whose dist\n+000139d0: 7269 6275 7469 6f6e 2063 6f6e 6469 7469  ribution conditi\n+000139e0: 6f6e 7320 6172 6520 6469 6666 6572 656e  ons are differen\n+000139f0: 742c 2077 7269 7465 2074 6f20 7468 650a  t, write to the.\n+00013a00: 2020 2020 2061 7574 686f 7220 746f 2061       author to a\n+00013a10: 736b 2066 6f72 2070 6572 6d69 7373 696f  sk for permissio\n+00013a20: 6e2e 2020 466f 7220 736f 6674 7761 7265  n.  For software\n+00013a30: 2077 6869 6368 2069 7320 636f 7079 7269   which is copyri\n+00013a40: 6768 7465 6420 6279 0a20 2020 2020 7468  ghted by.     th\n+00013a50: 6520 4672 6565 2053 6f66 7477 6172 6520  e Free Software \n+00013a60: 466f 756e 6461 7469 6f6e 2c20 7772 6974  Foundation, writ\n+00013a70: 6520 746f 2074 6865 2046 7265 6520 536f  e to the Free So\n+00013a80: 6674 7761 7265 0a20 2020 2020 466f 756e  ftware.     Foun\n+00013a90: 6461 7469 6f6e 3b20 7765 2073 6f6d 6574  dation; we somet\n+00013aa0: 696d 6573 206d 616b 6520 6578 6365 7074  imes make except\n+00013ab0: 696f 6e73 2066 6f72 2074 6869 732e 2020  ions for this.  \n+00013ac0: 4f75 7220 6465 6369 7369 6f6e 0a20 2020  Our decision.   \n+00013ad0: 2020 7769 6c6c 2062 6520 6775 6964 6564    will be guided\n+00013ae0: 2062 7920 7468 6520 7477 6f20 676f 616c   by the two goal\n+00013af0: 7320 6f66 2070 7265 7365 7276 696e 6720  s of preserving \n+00013b00: 7468 6520 6672 6565 2073 7461 7475 7320  the free status \n+00013b10: 6f66 0a20 2020 2020 616c 6c20 6465 7269  of.     all deri\n+00013b20: 7661 7469 7665 7320 6f66 206f 7572 2066  vatives of our f\n+00013b30: 7265 6520 736f 6674 7761 7265 2061 6e64  ree software and\n+00013b40: 206f 6620 7072 6f6d 6f74 696e 6720 7468   of promoting th\n+00013b50: 6520 7368 6172 696e 670a 2020 2020 2061  e sharing.     a\n+00013b60: 6e64 2072 6575 7365 206f 6620 736f 6674  nd reuse of soft\n+00013b70: 7761 7265 2067 656e 6572 616c 6c79 2e0a  ware generally..\n+00013b80: 0a20 2020 2020 2020 2020 2020 2020 2020  .               \n+00013b90: 2020 2020 2020 2020 2020 2020 2020 204e                 N\n+00013ba0: 4f20 5741 5252 414e 5459 0a0a 2020 312e  O WARRANTY..  1.\n+00013bb0: 2042 4543 4155 5345 2054 4845 2050 524f   BECAUSE THE PRO\n+00013bc0: 4752 414d 2049 5320 4c49 4345 4e53 4544  GRAM IS LICENSED\n+00013bd0: 2046 5245 4520 4f46 2043 4841 5247 452c   FREE OF CHARGE,\n+00013be0: 2054 4845 5245 2049 5320 4e4f 0a20 2020   THERE IS NO.   \n+00013bf0: 2020 5741 5252 414e 5459 2046 4f52 2054    WARRANTY FOR T\n+00013c00: 4845 2050 524f 4752 414d 2c20 544f 2054  HE PROGRAM, TO T\n+00013c10: 4845 2045 5854 454e 5420 5045 524d 4954  HE EXTENT PERMIT\n+00013c20: 5445 4420 4259 2041 5050 4c49 4341 424c  TED BY APPLICABL\n+00013c30: 450a 2020 2020 204c 4157 2e20 4558 4345  E.     LAW. EXCE\n+00013c40: 5054 2057 4845 4e20 4f54 4845 5257 4953  PT WHEN OTHERWIS\n+00013c50: 4520 5354 4154 4544 2049 4e20 5752 4954  E STATED IN WRIT\n+00013c60: 494e 4720 5448 4520 434f 5059 5249 4748  ING THE COPYRIGH\n+00013c70: 5420 484f 4c44 4552 530a 2020 2020 2041  T HOLDERS.     A\n+00013c80: 4e44 2f4f 5220 4f54 4845 5220 5041 5254  ND/OR OTHER PART\n+00013c90: 4945 5320 5052 4f56 4944 4520 5448 4520  IES PROVIDE THE \n+00013ca0: 5052 4f47 5241 4d20 2241 5320 4953 2220  PROGRAM \"AS IS\" \n+00013cb0: 5749 5448 4f55 5420 5741 5252 414e 5459  WITHOUT WARRANTY\n+00013cc0: 0a20 2020 2020 4f46 2041 4e59 204b 494e  .     OF ANY KIN\n+00013cd0: 442c 2045 4954 4845 5220 4558 5052 4553  D, EITHER EXPRES\n+00013ce0: 5345 4420 4f52 2049 4d50 4c49 4544 2c20  SED OR IMPLIED, \n+00013cf0: 494e 434c 5544 494e 472c 2042 5554 204e  INCLUDING, BUT N\n+00013d00: 4f54 0a20 2020 2020 4c49 4d49 5445 4420  OT.     LIMITED \n+00013d10: 544f 2c20 5448 4520 494d 504c 4945 4420  TO, THE IMPLIED \n+00013d20: 5741 5252 414e 5449 4553 204f 4620 4d45  WARRANTIES OF ME\n+00013d30: 5243 4841 4e54 4142 494c 4954 5920 414e  RCHANTABILITY AN\n+00013d40: 4420 4649 544e 4553 530a 2020 2020 2046  D FITNESS.     F\n+00013d50: 4f52 2041 2050 4152 5449 4355 4c41 5220  OR A PARTICULAR \n+00013d60: 5055 5250 4f53 452e 2054 4845 2045 4e54  PURPOSE. THE ENT\n+00013d70: 4952 4520 5249 534b 2041 5320 544f 2054  IRE RISK AS TO T\n+00013d80: 4845 2051 5541 4c49 5459 2041 4e44 0a20  HE QUALITY AND. \n+00013d90: 2020 2020 5045 5246 4f52 4d41 4e43 4520      PERFORMANCE \n+00013da0: 4f46 2054 4845 2050 524f 4752 414d 2049  OF THE PROGRAM I\n+00013db0: 5320 5749 5448 2059 4f55 2e20 5348 4f55  S WITH YOU. SHOU\n+00013dc0: 4c44 2054 4845 2050 524f 4752 414d 2050  LD THE PROGRAM P\n+00013dd0: 524f 5645 0a20 2020 2020 4445 4645 4354  ROVE.     DEFECT\n+00013de0: 4956 452c 2059 4f55 2041 5353 554d 4520  IVE, YOU ASSUME \n+00013df0: 5448 4520 434f 5354 204f 4620 414c 4c20  THE COST OF ALL \n+00013e00: 4e45 4345 5353 4152 5920 5345 5256 4943  NECESSARY SERVIC\n+00013e10: 494e 472c 2052 4550 4149 520a 2020 2020  ING, REPAIR.    \n+00013e20: 204f 5220 434f 5252 4543 5449 4f4e 2e0a   OR CORRECTION..\n+00013e30: 0a20 2032 2e20 494e 204e 4f20 4556 454e  .  2. IN NO EVEN\n+00013e40: 5420 554e 4c45 5353 2052 4551 5549 5245  T UNLESS REQUIRE\n+00013e50: 4420 4259 2041 5050 4c49 4341 424c 4520  D BY APPLICABLE \n+00013e60: 4c41 5720 4f52 2041 4752 4545 4420 544f  LAW OR AGREED TO\n+00013e70: 2049 4e0a 2020 2020 2057 5249 5449 4e47   IN.     WRITING\n+00013e80: 2057 494c 4c20 414e 5920 434f 5059 5249   WILL ANY COPYRI\n+00013e90: 4748 5420 484f 4c44 4552 2c20 4f52 2041  GHT HOLDER, OR A\n+00013ea0: 4e59 204f 5448 4552 2050 4152 5459 2057  NY OTHER PARTY W\n+00013eb0: 484f 204d 4159 0a20 2020 2020 4d4f 4449  HO MAY.     MODI\n+00013ec0: 4659 2041 4e44 2f4f 5220 5245 4449 5354  FY AND/OR REDIST\n+00013ed0: 5249 4255 5445 2054 4845 2050 524f 4752  RIBUTE THE PROGR\n+00013ee0: 414d 2041 5320 5045 524d 4954 5445 4420  AM AS PERMITTED \n+00013ef0: 4142 4f56 452c 2042 450a 2020 2020 204c  ABOVE, BE.     L\n+00013f00: 4941 424c 4520 544f 2059 4f55 2046 4f52  IABLE TO YOU FOR\n+00013f10: 2044 414d 4147 4553 2c20 494e 434c 5544   DAMAGES, INCLUD\n+00013f20: 494e 4720 414e 5920 4745 4e45 5241 4c2c  ING ANY GENERAL,\n+00013f30: 2053 5045 4349 414c 2c0a 2020 2020 2049   SPECIAL,.     I\n+00013f40: 4e43 4944 454e 5441 4c20 4f52 2043 4f4e  NCIDENTAL OR CON\n+00013f50: 5345 5155 454e 5449 414c 2044 414d 4147  SEQUENTIAL DAMAG\n+00013f60: 4553 2041 5249 5349 4e47 204f 5554 204f  ES ARISING OUT O\n+00013f70: 4620 5448 4520 5553 4520 4f52 0a20 2020  F THE USE OR.   \n+00013f80: 2020 494e 4142 494c 4954 5920 544f 2055    INABILITY TO U\n+00013f90: 5345 2054 4845 2050 524f 4752 414d 2028  SE THE PROGRAM (\n+00013fa0: 494e 434c 5544 494e 4720 4255 5420 4e4f  INCLUDING BUT NO\n+00013fb0: 5420 4c49 4d49 5445 4420 544f 204c 4f53  T LIMITED TO LOS\n+00013fc0: 5320 4f46 0a20 2020 2020 4441 5441 204f  S OF.     DATA O\n+00013fd0: 5220 4441 5441 2042 4549 4e47 2052 454e  R DATA BEING REN\n+00013fe0: 4445 5245 4420 494e 4143 4355 5241 5445  DERED INACCURATE\n+00013ff0: 204f 5220 4c4f 5353 4553 2053 5553 5441   OR LOSSES SUSTA\n+00014000: 494e 4544 2042 5920 594f 550a 2020 2020  INED BY YOU.    \n+00014010: 204f 5220 5448 4952 4420 5041 5254 4945   OR THIRD PARTIE\n+00014020: 5320 4f52 2041 2046 4149 4c55 5245 204f  S OR A FAILURE O\n+00014030: 4620 5448 4520 5052 4f47 5241 4d20 544f  F THE PROGRAM TO\n+00014040: 204f 5045 5241 5445 2057 4954 4820 414e   OPERATE WITH AN\n+00014050: 590a 2020 2020 204f 5448 4552 2050 524f  Y.     OTHER PRO\n+00014060: 4752 414d 5329 2c20 4556 454e 2049 4620  GRAMS), EVEN IF \n+00014070: 5355 4348 2048 4f4c 4445 5220 4f52 204f  SUCH HOLDER OR O\n+00014080: 5448 4552 2050 4152 5459 2048 4153 2042  THER PARTY HAS B\n+00014090: 4545 4e0a 2020 2020 2041 4456 4953 4544  EEN.     ADVISED\n+000140a0: 204f 4620 5448 4520 504f 5353 4942 494c   OF THE POSSIBIL\n+000140b0: 4954 5920 4f46 2053 5543 4820 4441 4d41  ITY OF SUCH DAMA\n+000140c0: 4745 532e 0a0a 2020 2020 2020 2020 2020  GES...          \n+000140d0: 2020 2020 2020 2020 2020 2020 454e 4420              END \n+000140e0: 4f46 2054 4552 4d53 2041 4e44 2043 4f4e  OF TERMS AND CON\n+000140f0: 4449 5449 4f4e 530a 0a41 2e32 2041 7070  DITIONS..A.2 App\n+00014100: 656e 6469 783a 2048 6f77 2074 6f20 4170  endix: How to Ap\n+00014110: 706c 7920 5468 6573 6520 5465 726d 7320  ply These Terms \n+00014120: 746f 2059 6f75 7220 4e65 7720 5072 6f67  to Your New Prog\n+00014130: 7261 6d73 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d  rams.===========\n 00014140: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================\n 00014150: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================\n 00014160: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================\n-00014170: 3d3d 0a0a 4966 2079 6f75 2064 6576 656c  ==..If you devel\n-00014180: 6f70 2061 206e 6577 2070 726f 6772 616d  op a new program\n-00014190: 2c20 616e 6420 796f 7520 7761 6e74 2069  , and you want i\n-000141a0: 7420 746f 2062 6520 6f66 2074 6865 2067  t to be of the g\n-000141b0: 7265 6174 6573 740a 706f 7373 6962 6c65  reatest.possible\n-000141c0: 2075 7365 2074 6f20 7468 6520 7075 626c   use to the publ\n-000141d0: 6963 2c20 7468 6520 6265 7374 2077 6179  ic, the best way\n-000141e0: 2074 6f20 6163 6869 6576 6520 7468 6973   to achieve this\n-000141f0: 2069 7320 746f 206d 616b 6520 6974 0a66   is to make it.f\n-00014200: 7265 6520 736f 6674 7761 7265 2077 6869  ree software whi\n-00014210: 6368 2065 7665 7279 6f6e 6520 6361 6e20  ch everyone can \n-00014220: 7265 6469 7374 7269 6275 7465 2061 6e64  redistribute and\n-00014230: 2063 6861 6e67 6520 756e 6465 7220 7468   change under th\n-00014240: 6573 650a 7465 726d 732e 0a0a 2020 2054  ese.terms...   T\n-00014250: 6f20 646f 2073 6f2c 2061 7474 6163 6820  o do so, attach \n-00014260: 7468 6520 666f 6c6c 6f77 696e 6720 6e6f  the following no\n-00014270: 7469 6365 7320 746f 2074 6865 2070 726f  tices to the pro\n-00014280: 6772 616d 2e20 2049 7420 6973 2073 6166  gram.  It is saf\n-00014290: 6573 740a 746f 2061 7474 6163 6820 7468  est.to attach th\n-000142a0: 656d 2074 6f20 7468 6520 7374 6172 7420  em to the start \n-000142b0: 6f66 2065 6163 6820 736f 7572 6365 2066  of each source f\n-000142c0: 696c 6520 746f 206d 6f73 7420 6566 6665  ile to most effe\n-000142d0: 6374 6976 656c 790a 636f 6e76 6579 2074  ctively.convey t\n-000142e0: 6865 2065 7863 6c75 7369 6f6e 206f 6620  he exclusion of \n-000142f0: 7761 7272 616e 7479 3b20 616e 6420 6561  warranty; and ea\n-00014300: 6368 2066 696c 6520 7368 6f75 6c64 2068  ch file should h\n-00014310: 6176 6520 6174 206c 6561 7374 2074 6865  ave at least the\n-00014320: 0a22 636f 7079 7269 6768 7422 206c 696e  .\"copyright\" lin\n-00014330: 6520 616e 6420 6120 706f 696e 7465 7220  e and a pointer \n-00014340: 746f 2077 6865 7265 2074 6865 2066 756c  to where the ful\n-00014350: 6c20 6e6f 7469 6365 2069 7320 666f 756e  l notice is foun\n-00014360: 642e 0a0a 2020 2020 204f 4e45 204c 494e  d...     ONE LIN\n-00014370: 4520 544f 2047 4956 4520 5448 4520 5052  E TO GIVE THE PR\n-00014380: 4f47 5241 4d27 5320 4e41 4d45 2041 4e44  OGRAM'S NAME AND\n-00014390: 2041 2042 5249 4546 2049 4445 4120 4f46   A BRIEF IDEA OF\n-000143a0: 2057 4841 5420 4954 2044 4f45 532e 0a20   WHAT IT DOES.. \n-000143b0: 2020 2020 436f 7079 7269 6768 7420 2843      Copyright (C\n-000143c0: 2920 5959 5959 2020 4e41 4d45 204f 4620  ) YYYY  NAME OF \n-000143d0: 4155 5448 4f52 0a0a 2020 2020 2054 6869  AUTHOR..     Thi\n-000143e0: 7320 7072 6f67 7261 6d20 6973 2066 7265  s program is fre\n-000143f0: 6520 736f 6674 7761 7265 3b20 796f 7520  e software; you \n-00014400: 6361 6e20 7265 6469 7374 7269 6275 7465  can redistribute\n-00014410: 2069 7420 616e 642f 6f72 206d 6f64 6966   it and/or modif\n-00014420: 790a 2020 2020 2069 7420 756e 6465 7220  y.     it under \n-00014430: 7468 6520 7465 726d 7320 6f66 2074 6865  the terms of the\n-00014440: 2047 4e55 2047 656e 6572 616c 2050 7562   GNU General Pub\n-00014450: 6c69 6320 4c69 6365 6e73 6520 6173 2070  lic License as p\n-00014460: 7562 6c69 7368 6564 2062 790a 2020 2020  ublished by.    \n-00014470: 2074 6865 2046 7265 6520 536f 6674 7761   the Free Softwa\n-00014480: 7265 2046 6f75 6e64 6174 696f 6e3b 2065  re Foundation; e\n-00014490: 6974 6865 7220 7665 7273 696f 6e20 3220  ither version 2 \n-000144a0: 6f66 2074 6865 204c 6963 656e 7365 2c20  of the License, \n-000144b0: 6f72 0a20 2020 2020 2861 7420 796f 7572  or.     (at your\n-000144c0: 206f 7074 696f 6e29 2061 6e79 206c 6174   option) any lat\n-000144d0: 6572 2076 6572 7369 6f6e 2e0a 0a20 2020  er version...   \n-000144e0: 2020 5468 6973 2070 726f 6772 616d 2069    This program i\n-000144f0: 7320 6469 7374 7269 6275 7465 6420 696e  s distributed in\n-00014500: 2074 6865 2068 6f70 6520 7468 6174 2069   the hope that i\n-00014510: 7420 7769 6c6c 2062 6520 7573 6566 756c  t will be useful\n-00014520: 2c0a 2020 2020 2062 7574 2057 4954 484f  ,.     but WITHO\n-00014530: 5554 2041 4e59 2057 4152 5241 4e54 593b  UT ANY WARRANTY;\n-00014540: 2077 6974 686f 7574 2065 7665 6e20 7468   without even th\n-00014550: 6520 696d 706c 6965 6420 7761 7272 616e  e implied warran\n-00014560: 7479 206f 660a 2020 2020 204d 4552 4348  ty of.     MERCH\n-00014570: 414e 5441 4249 4c49 5459 206f 7220 4649  ANTABILITY or FI\n-00014580: 544e 4553 5320 464f 5220 4120 5041 5254  TNESS FOR A PART\n-00014590: 4943 554c 4152 2050 5552 504f 5345 2e20  ICULAR PURPOSE. \n-000145a0: 2053 6565 2074 6865 0a20 2020 2020 474e   See the.     GN\n-000145b0: 5520 4765 6e65 7261 6c20 5075 626c 6963  U General Public\n-000145c0: 204c 6963 656e 7365 2066 6f72 206d 6f72   License for mor\n-000145d0: 6520 6465 7461 696c 732e 0a0a 2020 2020  e details...    \n-000145e0: 2059 6f75 2073 686f 756c 6420 6861 7665   You should have\n-000145f0: 2072 6563 6569 7665 6420 6120 636f 7079   received a copy\n-00014600: 206f 6620 7468 6520 474e 5520 4765 6e65   of the GNU Gene\n-00014610: 7261 6c20 5075 626c 6963 204c 6963 656e  ral Public Licen\n-00014620: 7365 0a20 2020 2020 616c 6f6e 6720 7769  se.     along wi\n-00014630: 7468 2074 6869 7320 7072 6f67 7261 6d3b  th this program;\n-00014640: 2069 6620 6e6f 742c 2077 7269 7465 2074   if not, write t\n-00014650: 6f20 7468 6520 4672 6565 2053 6f66 7477  o the Free Softw\n-00014660: 6172 650a 2020 2020 2046 6f75 6e64 6174  are.     Foundat\n-00014670: 696f 6e2c 2049 6e63 2e2c 2035 3120 4672  ion, Inc., 51 Fr\n-00014680: 616e 6b6c 696e 2053 7472 6565 742c 2046  anklin Street, F\n-00014690: 6966 7468 2046 6c6f 6f72 2c20 426f 7374  ifth Floor, Bost\n-000146a0: 6f6e 2c20 4d41 2020 3032 3131 302d 3133  on, MA  02110-13\n-000146b0: 3031 2c20 5553 412e 0a0a 2020 2041 6c73  01, USA...   Als\n-000146c0: 6f20 6164 6420 696e 666f 726d 6174 696f  o add informatio\n-000146d0: 6e20 6f6e 2068 6f77 2074 6f20 636f 6e74  n on how to cont\n-000146e0: 6163 7420 796f 7520 6279 2065 6c65 6374  act you by elect\n-000146f0: 726f 6e69 6320 616e 6420 7061 7065 720a  ronic and paper.\n-00014700: 6d61 696c 2e0a 0a20 2020 4966 2074 6865  mail...   If the\n-00014710: 2070 726f 6772 616d 2069 7320 696e 7465   program is inte\n-00014720: 7261 6374 6976 652c 206d 616b 6520 6974  ractive, make it\n-00014730: 206f 7574 7075 7420 6120 7368 6f72 7420   output a short \n-00014740: 6e6f 7469 6365 206c 696b 650a 7468 6973  notice like.this\n-00014750: 2077 6865 6e20 6974 2073 7461 7274 7320   when it starts \n-00014760: 696e 2061 6e20 696e 7465 7261 6374 6976  in an interactiv\n-00014770: 6520 6d6f 6465 3a0a 0a20 2020 2020 476e  e mode:..     Gn\n-00014780: 6f6d 6f76 6973 696f 6e20 7665 7273 696f  omovision versio\n-00014790: 6e20 3639 2c20 436f 7079 7269 6768 7420  n 69, Copyright \n-000147a0: 2843 2920 5945 4152 204e 414d 4520 4f46  (C) YEAR NAME OF\n-000147b0: 2041 5554 484f 520a 2020 2020 2047 6e6f   AUTHOR.     Gno\n-000147c0: 6d6f 7669 7369 6f6e 2063 6f6d 6573 2077  movision comes w\n-000147d0: 6974 6820 4142 534f 4c55 5445 4c59 204e  ith ABSOLUTELY N\n-000147e0: 4f20 5741 5252 414e 5459 3b20 666f 7220  O WARRANTY; for \n-000147f0: 6465 7461 696c 7320 7479 7065 2060 7368  details type `sh\n-00014800: 6f77 2077 272e 0a20 2020 2020 5468 6973  ow w'..     This\n-00014810: 2069 7320 6672 6565 2073 6f66 7477 6172   is free softwar\n-00014820: 652c 2061 6e64 2079 6f75 2061 7265 2077  e, and you are w\n-00014830: 656c 636f 6d65 2074 6f20 7265 6469 7374  elcome to redist\n-00014840: 7269 6275 7465 2069 740a 2020 2020 2075  ribute it.     u\n-00014850: 6e64 6572 2063 6572 7461 696e 2063 6f6e  nder certain con\n-00014860: 6469 7469 6f6e 733b 2074 7970 6520 6073  ditions; type `s\n-00014870: 686f 7720 6327 2066 6f72 2064 6574 6169  how c' for detai\n-00014880: 6c73 2e0a 0a20 2020 5468 6520 6879 706f  ls...   The hypo\n-00014890: 7468 6574 6963 616c 2063 6f6d 6d61 6e64  thetical command\n-000148a0: 7320 2773 686f 7720 7727 2061 6e64 2027  s 'show w' and '\n-000148b0: 7368 6f77 2063 2720 7368 6f75 6c64 2073  show c' should s\n-000148c0: 686f 7720 7468 650a 6170 7072 6f70 7269  how the.appropri\n-000148d0: 6174 6520 7061 7274 7320 6f66 2074 6865  ate parts of the\n-000148e0: 2047 656e 6572 616c 2050 7562 6c69 6320   General Public \n-000148f0: 4c69 6365 6e73 652e 2020 4f66 2063 6f75  License.  Of cou\n-00014900: 7273 652c 2074 6865 0a63 6f6d 6d61 6e64  rse, the.command\n-00014910: 7320 796f 7520 7573 6520 6d61 7920 6265  s you use may be\n-00014920: 2063 616c 6c65 6420 736f 6d65 7468 696e   called somethin\n-00014930: 6720 6f74 6865 7220 7468 616e 2027 7368  g other than 'sh\n-00014940: 6f77 2077 2720 616e 6420 2773 686f 770a  ow w' and 'show.\n-00014950: 6327 3b20 7468 6579 2063 6f75 6c64 2065  c'; they could e\n-00014960: 7665 6e20 6265 206d 6f75 7365 2d63 6c69  ven be mouse-cli\n-00014970: 636b 7320 6f72 206d 656e 7520 6974 656d  cks or menu item\n-00014980: 732d 2d77 6861 7465 7665 7220 7375 6974  s--whatever suit\n-00014990: 7320 796f 7572 0a70 726f 6772 616d 2e0a  s your.program..\n-000149a0: 0a20 2020 596f 7520 7368 6f75 6c64 2061  .   You should a\n-000149b0: 6c73 6f20 6765 7420 796f 7572 2065 6d70  lso get your emp\n-000149c0: 6c6f 7965 7220 2869 6620 796f 7520 776f  loyer (if you wo\n-000149d0: 726b 2061 7320 6120 7072 6f67 7261 6d6d  rk as a programm\n-000149e0: 6572 2920 6f72 0a79 6f75 7220 7363 686f  er) or.your scho\n-000149f0: 6f6c 2c20 6966 2061 6e79 2c20 746f 2073  ol, if any, to s\n-00014a00: 6967 6e20 6120 2263 6f70 7972 6967 6874  ign a \"copyright\n-00014a10: 2064 6973 636c 6169 6d65 7222 2066 6f72   disclaimer\" for\n-00014a20: 2074 6865 2070 726f 6772 616d 2c0a 6966   the program,.if\n-00014a30: 206e 6563 6573 7361 7279 2e20 2048 6572   necessary.  Her\n-00014a40: 6520 6973 2061 2073 616d 706c 653b 2061  e is a sample; a\n-00014a50: 6c74 6572 2074 6865 206e 616d 6573 3a0a  lter the names:.\n-00014a60: 0a20 2020 2020 596f 796f 6479 6e65 2c20  .     Yoyodyne, \n-00014a70: 496e 632e 2c20 6865 7265 6279 2064 6973  Inc., hereby dis\n-00014a80: 636c 6169 6d73 2061 6c6c 2063 6f70 7972  claims all copyr\n-00014a90: 6967 6874 2069 6e74 6572 6573 7420 696e  ight interest in\n-00014aa0: 2074 6865 2070 726f 6772 616d 0a20 2020   the program.   \n-00014ab0: 2020 6047 6e6f 6d6f 7669 7369 6f6e 2720    `Gnomovision' \n-00014ac0: 2877 6869 6368 206d 616b 6573 2070 6173  (which makes pas\n-00014ad0: 7365 7320 6174 2063 6f6d 7069 6c65 7273  ses at compilers\n-00014ae0: 2920 7772 6974 7465 6e20 6279 204a 616d  ) written by Jam\n-00014af0: 6573 2048 6163 6b65 722e 0a0a 2020 2020  es Hacker...    \n-00014b00: 2053 4947 4e41 5455 5245 204f 4620 5459   SIGNATURE OF TY\n-00014b10: 2043 4f4f 4e2c 2031 2041 7072 696c 2031   COON, 1 April 1\n-00014b20: 3938 390a 2020 2020 2054 7920 436f 6f6e  989.     Ty Coon\n-00014b30: 2c20 5072 6573 6964 656e 7420 6f66 2056  , President of V\n-00014b40: 6963 650a 0a20 2020 5468 6973 2047 656e  ice..   This Gen\n-00014b50: 6572 616c 2050 7562 6c69 6320 4c69 6365  eral Public Lice\n-00014b60: 6e73 6520 646f 6573 206e 6f74 2070 6572  nse does not per\n-00014b70: 6d69 7420 696e 636f 7270 6f72 6174 696e  mit incorporatin\n-00014b80: 6720 796f 7572 0a70 726f 6772 616d 2069  g your.program i\n-00014b90: 6e74 6f20 7072 6f70 7269 6574 6172 7920  nto proprietary \n-00014ba0: 7072 6f67 7261 6d73 2e20 2049 6620 796f  programs.  If yo\n-00014bb0: 7572 2070 726f 6772 616d 2069 7320 6120  ur program is a \n-00014bc0: 7375 6272 6f75 7469 6e65 0a6c 6962 7261  subroutine.libra\n-00014bd0: 7279 2c20 796f 7520 6d61 7920 636f 6e73  ry, you may cons\n-00014be0: 6964 6572 2069 7420 6d6f 7265 2075 7365  ider it more use\n-00014bf0: 6675 6c20 746f 2070 6572 6d69 7420 6c69  ful to permit li\n-00014c00: 6e6b 696e 6720 7072 6f70 7269 6574 6172  nking proprietar\n-00014c10: 790a 6170 706c 6963 6174 696f 6e73 2077  y.applications w\n-00014c20: 6974 6820 7468 6520 6c69 6272 6172 792e  ith the library.\n-00014c30: 2020 4966 2074 6869 7320 6973 2077 6861    If this is wha\n-00014c40: 7420 796f 7520 7761 6e74 2074 6f20 646f  t you want to do\n-00014c50: 2c20 7573 6520 7468 650a 474e 5520 4c65  , use the.GNU Le\n-00014c60: 7373 6572 2047 656e 6572 616c 2050 7562  sser General Pub\n-00014c70: 6c69 6320 4c69 6365 6e73 6520 696e 7374  lic License inst\n-00014c80: 6561 6420 6f66 2074 6869 7320 4c69 6365  ead of this Lice\n-00014c90: 6e73 652e 0a0a 1f0a 4669 6c65 3a20 6c69  nse.....File: li\n-00014ca0: 6266 6b6f 2e69 6e66 6f2c 2020 4e6f 6465  bfko.info,  Node\n-00014cb0: 3a20 436f 6e63 6570 7420 496e 6465 782c  : Concept Index,\n-00014cc0: 2020 4e65 7874 3a20 4675 6e63 7469 6f6e    Next: Function\n-00014cd0: 2061 6e64 2044 6174 6120 496e 6465 782c   and Data Index,\n-00014ce0: 2020 5072 6576 3a20 4c69 6272 6172 7920    Prev: Library \n-00014cf0: 436f 7079 696e 672c 2020 5570 3a20 546f  Copying,  Up: To\n-00014d00: 700a 0a43 6f6e 6365 7074 2049 6e64 6578  p..Concept Index\n-00014d10: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a  .*************..\n-00014d20: 0008 5b69 6e64 6578 0008 5d0a 2a20 4d65  ..[index..].* Me\n-00014d30: 6e75 3a0a 0a2a 2063 6f6d 7069 6c69 6e67  nu:..* compiling\n-00014d40: 2c20 7769 7468 206c 6962 666b 6f3a 2020  , with libfko:  \n-00014d50: 2020 2020 2020 2020 2020 2020 2020 436f                Co\n-00014d60: 6d70 696c 696e 6720 7769 7468 206c 6962  mpiling with lib\n-00014d70: 666b 6f2e 0a20 2020 2020 2020 2020 2020  fko..           \n+00014170: 0a0a 4966 2079 6f75 2064 6576 656c 6f70  ..If you develop\n+00014180: 2061 206e 6577 2070 726f 6772 616d 2c20   a new program, \n+00014190: 616e 6420 796f 7520 7761 6e74 2069 7420  and you want it \n+000141a0: 746f 2062 6520 6f66 2074 6865 2067 7265  to be of the gre\n+000141b0: 6174 6573 740a 706f 7373 6962 6c65 2075  atest.possible u\n+000141c0: 7365 2074 6f20 7468 6520 7075 626c 6963  se to the public\n+000141d0: 2c20 7468 6520 6265 7374 2077 6179 2074  , the best way t\n+000141e0: 6f20 6163 6869 6576 6520 7468 6973 2069  o achieve this i\n+000141f0: 7320 746f 206d 616b 6520 6974 0a66 7265  s to make it.fre\n+00014200: 6520 736f 6674 7761 7265 2077 6869 6368  e software which\n+00014210: 2065 7665 7279 6f6e 6520 6361 6e20 7265   everyone can re\n+00014220: 6469 7374 7269 6275 7465 2061 6e64 2063  distribute and c\n+00014230: 6861 6e67 6520 756e 6465 7220 7468 6573  hange under thes\n+00014240: 650a 7465 726d 732e 0a0a 2020 2054 6f20  e.terms...   To \n+00014250: 646f 2073 6f2c 2061 7474 6163 6820 7468  do so, attach th\n+00014260: 6520 666f 6c6c 6f77 696e 6720 6e6f 7469  e following noti\n+00014270: 6365 7320 746f 2074 6865 2070 726f 6772  ces to the progr\n+00014280: 616d 2e20 2049 7420 6973 2073 6166 6573  am.  It is safes\n+00014290: 740a 746f 2061 7474 6163 6820 7468 656d  t.to attach them\n+000142a0: 2074 6f20 7468 6520 7374 6172 7420 6f66   to the start of\n+000142b0: 2065 6163 6820 736f 7572 6365 2066 696c   each source fil\n+000142c0: 6520 746f 206d 6f73 7420 6566 6665 6374  e to most effect\n+000142d0: 6976 656c 790a 636f 6e76 6579 2074 6865  ively.convey the\n+000142e0: 2065 7863 6c75 7369 6f6e 206f 6620 7761   exclusion of wa\n+000142f0: 7272 616e 7479 3b20 616e 6420 6561 6368  rranty; and each\n+00014300: 2066 696c 6520 7368 6f75 6c64 2068 6176   file should hav\n+00014310: 6520 6174 206c 6561 7374 2074 6865 0a22  e at least the.\"\n+00014320: 636f 7079 7269 6768 7422 206c 696e 6520  copyright\" line \n+00014330: 616e 6420 6120 706f 696e 7465 7220 746f  and a pointer to\n+00014340: 2077 6865 7265 2074 6865 2066 756c 6c20   where the full \n+00014350: 6e6f 7469 6365 2069 7320 666f 756e 642e  notice is found.\n+00014360: 0a0a 2020 2020 204f 4e45 204c 494e 4520  ..     ONE LINE \n+00014370: 544f 2047 4956 4520 5448 4520 5052 4f47  TO GIVE THE PROG\n+00014380: 5241 4d27 5320 4e41 4d45 2041 4e44 2041  RAM'S NAME AND A\n+00014390: 2042 5249 4546 2049 4445 4120 4f46 2057   BRIEF IDEA OF W\n+000143a0: 4841 5420 4954 2044 4f45 532e 0a20 2020  HAT IT DOES..   \n+000143b0: 2020 436f 7079 7269 6768 7420 2843 2920    Copyright (C) \n+000143c0: 5959 5959 2020 4e41 4d45 204f 4620 4155  YYYY  NAME OF AU\n+000143d0: 5448 4f52 0a0a 2020 2020 2054 6869 7320  THOR..     This \n+000143e0: 7072 6f67 7261 6d20 6973 2066 7265 6520  program is free \n+000143f0: 736f 6674 7761 7265 3b20 796f 7520 6361  software; you ca\n+00014400: 6e20 7265 6469 7374 7269 6275 7465 2069  n redistribute i\n+00014410: 7420 616e 642f 6f72 206d 6f64 6966 790a  t and/or modify.\n+00014420: 2020 2020 2069 7420 756e 6465 7220 7468       it under th\n+00014430: 6520 7465 726d 7320 6f66 2074 6865 2047  e terms of the G\n+00014440: 4e55 2047 656e 6572 616c 2050 7562 6c69  NU General Publi\n+00014450: 6320 4c69 6365 6e73 6520 6173 2070 7562  c License as pub\n+00014460: 6c69 7368 6564 2062 790a 2020 2020 2074  lished by.     t\n+00014470: 6865 2046 7265 6520 536f 6674 7761 7265  he Free Software\n+00014480: 2046 6f75 6e64 6174 696f 6e3b 2065 6974   Foundation; eit\n+00014490: 6865 7220 7665 7273 696f 6e20 3220 6f66  her version 2 of\n+000144a0: 2074 6865 204c 6963 656e 7365 2c20 6f72   the License, or\n+000144b0: 0a20 2020 2020 2861 7420 796f 7572 206f  .     (at your o\n+000144c0: 7074 696f 6e29 2061 6e79 206c 6174 6572  ption) any later\n+000144d0: 2076 6572 7369 6f6e 2e0a 0a20 2020 2020   version...     \n+000144e0: 5468 6973 2070 726f 6772 616d 2069 7320  This program is \n+000144f0: 6469 7374 7269 6275 7465 6420 696e 2074  distributed in t\n+00014500: 6865 2068 6f70 6520 7468 6174 2069 7420  he hope that it \n+00014510: 7769 6c6c 2062 6520 7573 6566 756c 2c0a  will be useful,.\n+00014520: 2020 2020 2062 7574 2057 4954 484f 5554       but WITHOUT\n+00014530: 2041 4e59 2057 4152 5241 4e54 593b 2077   ANY WARRANTY; w\n+00014540: 6974 686f 7574 2065 7665 6e20 7468 6520  ithout even the \n+00014550: 696d 706c 6965 6420 7761 7272 616e 7479  implied warranty\n+00014560: 206f 660a 2020 2020 204d 4552 4348 414e   of.     MERCHAN\n+00014570: 5441 4249 4c49 5459 206f 7220 4649 544e  TABILITY or FITN\n+00014580: 4553 5320 464f 5220 4120 5041 5254 4943  ESS FOR A PARTIC\n+00014590: 554c 4152 2050 5552 504f 5345 2e20 2053  ULAR PURPOSE.  S\n+000145a0: 6565 2074 6865 0a20 2020 2020 474e 5520  ee the.     GNU \n+000145b0: 4765 6e65 7261 6c20 5075 626c 6963 204c  General Public L\n+000145c0: 6963 656e 7365 2066 6f72 206d 6f72 6520  icense for more \n+000145d0: 6465 7461 696c 732e 0a0a 2020 2020 2059  details...     Y\n+000145e0: 6f75 2073 686f 756c 6420 6861 7665 2072  ou should have r\n+000145f0: 6563 6569 7665 6420 6120 636f 7079 206f  eceived a copy o\n+00014600: 6620 7468 6520 474e 5520 4765 6e65 7261  f the GNU Genera\n+00014610: 6c20 5075 626c 6963 204c 6963 656e 7365  l Public License\n+00014620: 0a20 2020 2020 616c 6f6e 6720 7769 7468  .     along with\n+00014630: 2074 6869 7320 7072 6f67 7261 6d3b 2069   this program; i\n+00014640: 6620 6e6f 742c 2077 7269 7465 2074 6f20  f not, write to \n+00014650: 7468 6520 4672 6565 2053 6f66 7477 6172  the Free Softwar\n+00014660: 650a 2020 2020 2046 6f75 6e64 6174 696f  e.     Foundatio\n+00014670: 6e2c 2049 6e63 2e2c 2035 3120 4672 616e  n, Inc., 51 Fran\n+00014680: 6b6c 696e 2053 7472 6565 742c 2046 6966  klin Street, Fif\n+00014690: 7468 2046 6c6f 6f72 2c20 426f 7374 6f6e  th Floor, Boston\n+000146a0: 2c20 4d41 2020 3032 3131 302d 3133 3031  , MA  02110-1301\n+000146b0: 2c20 5553 412e 0a0a 2020 2041 6c73 6f20  , USA...   Also \n+000146c0: 6164 6420 696e 666f 726d 6174 696f 6e20  add information \n+000146d0: 6f6e 2068 6f77 2074 6f20 636f 6e74 6163  on how to contac\n+000146e0: 7420 796f 7520 6279 2065 6c65 6374 726f  t you by electro\n+000146f0: 6e69 6320 616e 6420 7061 7065 720a 6d61  nic and paper.ma\n+00014700: 696c 2e0a 0a20 2020 4966 2074 6865 2070  il...   If the p\n+00014710: 726f 6772 616d 2069 7320 696e 7465 7261  rogram is intera\n+00014720: 6374 6976 652c 206d 616b 6520 6974 206f  ctive, make it o\n+00014730: 7574 7075 7420 6120 7368 6f72 7420 6e6f  utput a short no\n+00014740: 7469 6365 206c 696b 650a 7468 6973 2077  tice like.this w\n+00014750: 6865 6e20 6974 2073 7461 7274 7320 696e  hen it starts in\n+00014760: 2061 6e20 696e 7465 7261 6374 6976 6520   an interactive \n+00014770: 6d6f 6465 3a0a 0a20 2020 2020 476e 6f6d  mode:..     Gnom\n+00014780: 6f76 6973 696f 6e20 7665 7273 696f 6e20  ovision version \n+00014790: 3639 2c20 436f 7079 7269 6768 7420 2843  69, Copyright (C\n+000147a0: 2920 5945 4152 204e 414d 4520 4f46 2041  ) YEAR NAME OF A\n+000147b0: 5554 484f 520a 2020 2020 2047 6e6f 6d6f  UTHOR.     Gnomo\n+000147c0: 7669 7369 6f6e 2063 6f6d 6573 2077 6974  vision comes wit\n+000147d0: 6820 4142 534f 4c55 5445 4c59 204e 4f20  h ABSOLUTELY NO \n+000147e0: 5741 5252 414e 5459 3b20 666f 7220 6465  WARRANTY; for de\n+000147f0: 7461 696c 7320 7479 7065 2060 7368 6f77  tails type `show\n+00014800: 2077 272e 0a20 2020 2020 5468 6973 2069   w'..     This i\n+00014810: 7320 6672 6565 2073 6f66 7477 6172 652c  s free software,\n+00014820: 2061 6e64 2079 6f75 2061 7265 2077 656c   and you are wel\n+00014830: 636f 6d65 2074 6f20 7265 6469 7374 7269  come to redistri\n+00014840: 6275 7465 2069 740a 2020 2020 2075 6e64  bute it.     und\n+00014850: 6572 2063 6572 7461 696e 2063 6f6e 6469  er certain condi\n+00014860: 7469 6f6e 733b 2074 7970 6520 6073 686f  tions; type `sho\n+00014870: 7720 6327 2066 6f72 2064 6574 6169 6c73  w c' for details\n+00014880: 2e0a 0a20 2020 5468 6520 6879 706f 7468  ...   The hypoth\n+00014890: 6574 6963 616c 2063 6f6d 6d61 6e64 7320  etical commands \n+000148a0: 2773 686f 7720 7727 2061 6e64 2027 7368  'show w' and 'sh\n+000148b0: 6f77 2063 2720 7368 6f75 6c64 2073 686f  ow c' should sho\n+000148c0: 7720 7468 650a 6170 7072 6f70 7269 6174  w the.appropriat\n+000148d0: 6520 7061 7274 7320 6f66 2074 6865 2047  e parts of the G\n+000148e0: 656e 6572 616c 2050 7562 6c69 6320 4c69  eneral Public Li\n+000148f0: 6365 6e73 652e 2020 4f66 2063 6f75 7273  cense.  Of cours\n+00014900: 652c 2074 6865 0a63 6f6d 6d61 6e64 7320  e, the.commands \n+00014910: 796f 7520 7573 6520 6d61 7920 6265 2063  you use may be c\n+00014920: 616c 6c65 6420 736f 6d65 7468 696e 6720  alled something \n+00014930: 6f74 6865 7220 7468 616e 2027 7368 6f77  other than 'show\n+00014940: 2077 2720 616e 6420 2773 686f 770a 6327   w' and 'show.c'\n+00014950: 3b20 7468 6579 2063 6f75 6c64 2065 7665  ; they could eve\n+00014960: 6e20 6265 206d 6f75 7365 2d63 6c69 636b  n be mouse-click\n+00014970: 7320 6f72 206d 656e 7520 6974 656d 732d  s or menu items-\n+00014980: 2d77 6861 7465 7665 7220 7375 6974 7320  -whatever suits \n+00014990: 796f 7572 0a70 726f 6772 616d 2e0a 0a20  your.program... \n+000149a0: 2020 596f 7520 7368 6f75 6c64 2061 6c73    You should als\n+000149b0: 6f20 6765 7420 796f 7572 2065 6d70 6c6f  o get your emplo\n+000149c0: 7965 7220 2869 6620 796f 7520 776f 726b  yer (if you work\n+000149d0: 2061 7320 6120 7072 6f67 7261 6d6d 6572   as a programmer\n+000149e0: 2920 6f72 0a79 6f75 7220 7363 686f 6f6c  ) or.your school\n+000149f0: 2c20 6966 2061 6e79 2c20 746f 2073 6967  , if any, to sig\n+00014a00: 6e20 6120 2263 6f70 7972 6967 6874 2064  n a \"copyright d\n+00014a10: 6973 636c 6169 6d65 7222 2066 6f72 2074  isclaimer\" for t\n+00014a20: 6865 2070 726f 6772 616d 2c0a 6966 206e  he program,.if n\n+00014a30: 6563 6573 7361 7279 2e20 2048 6572 6520  ecessary.  Here \n+00014a40: 6973 2061 2073 616d 706c 653b 2061 6c74  is a sample; alt\n+00014a50: 6572 2074 6865 206e 616d 6573 3a0a 0a20  er the names:.. \n+00014a60: 2020 2020 596f 796f 6479 6e65 2c20 496e      Yoyodyne, In\n+00014a70: 632e 2c20 6865 7265 6279 2064 6973 636c  c., hereby discl\n+00014a80: 6169 6d73 2061 6c6c 2063 6f70 7972 6967  aims all copyrig\n+00014a90: 6874 2069 6e74 6572 6573 7420 696e 2074  ht interest in t\n+00014aa0: 6865 2070 726f 6772 616d 0a20 2020 2020  he program.     \n+00014ab0: 6047 6e6f 6d6f 7669 7369 6f6e 2720 2877  `Gnomovision' (w\n+00014ac0: 6869 6368 206d 616b 6573 2070 6173 7365  hich makes passe\n+00014ad0: 7320 6174 2063 6f6d 7069 6c65 7273 2920  s at compilers) \n+00014ae0: 7772 6974 7465 6e20 6279 204a 616d 6573  written by James\n+00014af0: 2048 6163 6b65 722e 0a0a 2020 2020 2053   Hacker...     S\n+00014b00: 4947 4e41 5455 5245 204f 4620 5459 2043  IGNATURE OF TY C\n+00014b10: 4f4f 4e2c 2031 2041 7072 696c 2031 3938  OON, 1 April 198\n+00014b20: 390a 2020 2020 2054 7920 436f 6f6e 2c20  9.     Ty Coon, \n+00014b30: 5072 6573 6964 656e 7420 6f66 2056 6963  President of Vic\n+00014b40: 650a 0a20 2020 5468 6973 2047 656e 6572  e..   This Gener\n+00014b50: 616c 2050 7562 6c69 6320 4c69 6365 6e73  al Public Licens\n+00014b60: 6520 646f 6573 206e 6f74 2070 6572 6d69  e does not permi\n+00014b70: 7420 696e 636f 7270 6f72 6174 696e 6720  t incorporating \n+00014b80: 796f 7572 0a70 726f 6772 616d 2069 6e74  your.program int\n+00014b90: 6f20 7072 6f70 7269 6574 6172 7920 7072  o proprietary pr\n+00014ba0: 6f67 7261 6d73 2e20 2049 6620 796f 7572  ograms.  If your\n+00014bb0: 2070 726f 6772 616d 2069 7320 6120 7375   program is a su\n+00014bc0: 6272 6f75 7469 6e65 0a6c 6962 7261 7279  broutine.library\n+00014bd0: 2c20 796f 7520 6d61 7920 636f 6e73 6964  , you may consid\n+00014be0: 6572 2069 7420 6d6f 7265 2075 7365 6675  er it more usefu\n+00014bf0: 6c20 746f 2070 6572 6d69 7420 6c69 6e6b  l to permit link\n+00014c00: 696e 6720 7072 6f70 7269 6574 6172 790a  ing proprietary.\n+00014c10: 6170 706c 6963 6174 696f 6e73 2077 6974  applications wit\n+00014c20: 6820 7468 6520 6c69 6272 6172 792e 2020  h the library.  \n+00014c30: 4966 2074 6869 7320 6973 2077 6861 7420  If this is what \n+00014c40: 796f 7520 7761 6e74 2074 6f20 646f 2c20  you want to do, \n+00014c50: 7573 6520 7468 650a 474e 5520 4c65 7373  use the.GNU Less\n+00014c60: 6572 2047 656e 6572 616c 2050 7562 6c69  er General Publi\n+00014c70: 6320 4c69 6365 6e73 6520 696e 7374 6561  c License instea\n+00014c80: 6420 6f66 2074 6869 7320 4c69 6365 6e73  d of this Licens\n+00014c90: 652e 0a0a 1f0a 4669 6c65 3a20 6c69 6266  e.....File: libf\n+00014ca0: 6b6f 2e69 6e66 6f2c 2020 4e6f 6465 3a20  ko.info,  Node: \n+00014cb0: 436f 6e63 6570 7420 496e 6465 782c 2020  Concept Index,  \n+00014cc0: 4e65 7874 3a20 4675 6e63 7469 6f6e 2061  Next: Function a\n+00014cd0: 6e64 2044 6174 6120 496e 6465 782c 2020  nd Data Index,  \n+00014ce0: 5072 6576 3a20 4c69 6272 6172 7920 436f  Prev: Library Co\n+00014cf0: 7079 696e 672c 2020 5570 3a20 546f 700a  pying,  Up: Top.\n+00014d00: 0a43 6f6e 6365 7074 2049 6e64 6578 0a2a  .Concept Index.*\n+00014d10: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 0008  ************....\n+00014d20: 5b69 6e64 6578 0008 5d0a 2a20 4d65 6e75  [index..].* Menu\n+00014d30: 3a0a 0a2a 2063 6f6d 7069 6c69 6e67 2c20  :..* compiling, \n+00014d40: 7769 7468 206c 6962 666b 6f3a 2020 2020  with libfko:    \n+00014d50: 2020 2020 2020 2020 2020 2020 436f 6d70              Comp\n+00014d60: 696c 696e 6720 7769 7468 206c 6962 666b  iling with libfk\n+00014d70: 6f2e 0a20 2020 2020 2020 2020 2020 2020  o..             \n 00014d80: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 00014d90: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 00014da0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00014db0: 2020 2028 6c69 6e65 2020 2036 290a 2a20     (line   6).* \n-00014dc0: 636f 6e74 6578 742c 2063 7265 6174 696f  context, creatio\n-00014dd0: 6e3a 2020 2020 2020 2020 2020 2020 2020  n:              \n-00014de0: 2020 2020 2020 2043 7265 6174 696e 6720         Creating \n-00014df0: 436f 6e74 6578 7473 2e20 2020 286c 696e  Contexts.   (lin\n-00014e00: 6520 2020 3629 0a2a 2063 6f6e 7465 7874  e   6).* context\n-00014e10: 2c20 6465 7374 7275 6374 696f 6e3a 2020  , destruction:  \n-00014e20: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00014e30: 4465 7374 726f 7969 6e67 2043 6f6e 7465  Destroying Conte\n-00014e40: 7874 732e 2028 6c69 6e65 2020 2036 290a  xts. (line   6).\n-00014e50: 2a20 6465 6661 756c 7420 656e 6372 7970  * default encryp\n-00014e60: 7469 6f6e 3a20 2020 2020 2020 2020 2020  tion:           \n-00014e70: 2020 2020 2020 2020 2045 6e63 7279 7074           Encrypt\n-00014e80: 696f 6e20 416c 676f 7269 7468 6d73 2e0a  ion Algorithms..\n+00014db0: 2028 6c69 6e65 2020 2036 290a 2a20 636f   (line   6).* co\n+00014dc0: 6e74 6578 742c 2063 7265 6174 696f 6e3a  ntext, creation:\n+00014dd0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n+00014de0: 2020 2020 2043 7265 6174 696e 6720 436f       Creating Co\n+00014df0: 6e74 6578 7473 2e20 2020 286c 696e 6520  ntexts.   (line \n+00014e00: 2020 3629 0a2a 2063 6f6e 7465 7874 2c20    6).* context, \n+00014e10: 6465 7374 7275 6374 696f 6e3a 2020 2020  destruction:    \n+00014e20: 2020 2020 2020 2020 2020 2020 2020 4465                De\n+00014e30: 7374 726f 7969 6e67 2043 6f6e 7465 7874  stroying Context\n+00014e40: 732e 2028 6c69 6e65 2020 2036 290a 2a20  s. (line   6).* \n+00014e50: 6465 6661 756c 7420 656e 6372 7970 7469  default encrypti\n+00014e60: 6f6e 3a20 2020 2020 2020 2020 2020 2020  on:             \n+00014e70: 2020 2020 2020 2045 6e63 7279 7074 696f         Encryptio\n+00014e80: 6e20 416c 676f 7269 7468 6d73 2e0a 2020  n Algorithms..  \n 00014e90: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 00014ea0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 00014eb0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00014ec0: 2020 2020 2020 2020 2020 2020 2020 286c                (l\n-00014ed0: 696e 6520 2020 3629 0a2a 2064 6566 6175  ine   6).* defau\n-00014ee0: 6c74 206d 6573 7361 6765 2064 6967 6573  lt message diges\n-00014ef0: 743a 2020 2020 2020 2020 2020 2020 2020  t:              \n-00014f00: 2020 4469 6765 7374 732e 2020 2020 2020    Digests.      \n-00014f10: 2020 2020 2020 2028 6c69 6e65 2020 2036         (line   6\n-00014f20: 290a 2a20 6465 6661 756c 7420 6d65 7373  ).* default mess\n-00014f30: 6167 6520 6469 6765 7374 203c 313e 3a20  age digest <1>: \n-00014f40: 2020 2020 2020 2020 2020 2048 4d41 4320             HMAC \n-00014f50: 4469 6765 7374 732e 2020 2020 2020 2020  Digests.        \n-00014f60: 286c 696e 6520 2020 3629 0a2a 2064 6967  (line   6).* dig\n-00014f70: 6573 7420 7479 7065 733a 2020 2020 2020  est types:      \n+00014ec0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin\n+00014ed0: 6520 2020 3629 0a2a 2064 6566 6175 6c74  e   6).* default\n+00014ee0: 206d 6573 7361 6765 2064 6967 6573 743a   message digest:\n+00014ef0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n+00014f00: 4469 6765 7374 732e 2020 2020 2020 2020  Digests.        \n+00014f10: 2020 2020 2028 6c69 6e65 2020 2036 290a       (line   6).\n+00014f20: 2a20 6465 6661 756c 7420 6d65 7373 6167  * default messag\n+00014f30: 6520 6469 6765 7374 203c 313e 3a20 2020  e digest <1>:   \n+00014f40: 2020 2020 2020 2020 2048 4d41 4320 4469           HMAC Di\n+00014f50: 6765 7374 732e 2020 2020 2020 2020 286c  gests.        (l\n+00014f60: 696e 6520 2020 3629 0a2a 2064 6967 6573  ine   6).* diges\n+00014f70: 7420 7479 7065 733a 2020 2020 2020 2020  t types:        \n 00014f80: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00014f90: 2020 2020 4469 6765 7374 732e 2020 2020      Digests.    \n-00014fa0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  \n-00014fb0: 2036 290a 2a20 656e 6372 7970 7469 6f6e   6).* encryption\n-00014fc0: 2074 7970 6573 3a20 2020 2020 2020 2020   types:         \n-00014fd0: 2020 2020 2020 2020 2020 2020 2045 6e63               Enc\n-00014fe0: 7279 7074 696f 6e20 416c 676f 7269 7468  ryption Algorith\n-00014ff0: 6d73 2e0a 2020 2020 2020 2020 2020 2020  ms..            \n+00014f90: 2020 4469 6765 7374 732e 2020 2020 2020    Digests.      \n+00014fa0: 2020 2020 2020 2028 6c69 6e65 2020 2036         (line   6\n+00014fb0: 290a 2a20 656e 6372 7970 7469 6f6e 2074  ).* encryption t\n+00014fc0: 7970 6573 3a20 2020 2020 2020 2020 2020  ypes:           \n+00014fd0: 2020 2020 2020 2020 2020 2045 6e63 7279             Encry\n+00014fe0: 7074 696f 6e20 416c 676f 7269 7468 6d73  ption Algorithms\n+00014ff0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              \n 00015000: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 00015010: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 00015020: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015030: 2020 286c 696e 6520 2020 3629 0a2a 2065    (line   6).* e\n-00015040: 7272 6f72 2063 6f64 6573 3a20 2020 2020  rror codes:     \n+00015030: 286c 696e 6520 2020 3629 0a2a 2065 7272  (line   6).* err\n+00015040: 6f72 2063 6f64 6573 3a20 2020 2020 2020  or codes:       \n 00015050: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015060: 2020 2020 2020 4572 726f 7220 4861 6e64        Error Hand\n-00015070: 6c69 6e67 2e20 2020 2020 2028 6c69 6e65  ling.      (line\n-00015080: 2020 2036 290a 2a20 6572 726f 7220 636f     6).* error co\n-00015090: 6465 732c 2067 7067 6d65 2072 656c 6174  des, gpgme relat\n-000150a0: 6564 3a20 2020 2020 2020 2020 2020 2045  ed:            E\n-000150b0: 7272 6f72 2048 616e 646c 696e 672e 2020  rror Handling.  \n-000150c0: 2020 2020 286c 696e 6520 3234 3129 0a2a      (line 241).*\n-000150d0: 2065 7272 6f72 2068 616e 646c 696e 673a   error handling:\n+00015060: 2020 2020 4572 726f 7220 4861 6e64 6c69      Error Handli\n+00015070: 6e67 2e20 2020 2020 2028 6c69 6e65 2020  ng.      (line  \n+00015080: 2036 290a 2a20 6572 726f 7220 636f 6465   6).* error code\n+00015090: 732c 2067 7067 6d65 2072 656c 6174 6564  s, gpgme related\n+000150a0: 3a20 2020 2020 2020 2020 2020 2045 7272  :            Err\n+000150b0: 6f72 2048 616e 646c 696e 672e 2020 2020  or Handling.    \n+000150c0: 2020 286c 696e 6520 3234 3129 0a2a 2065    (line 241).* e\n+000150d0: 7272 6f72 2068 616e 646c 696e 673a 2020  rror handling:  \n 000150e0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000150f0: 2020 2020 2020 2020 4572 726f 7220 4861          Error Ha\n-00015100: 6e64 6c69 6e67 2e20 2020 2020 2028 6c69  ndling.      (li\n-00015110: 6e65 2020 2036 290a 2a20 6572 726f 7220  ne   6).* error \n-00015120: 7374 7269 6e67 733a 2020 2020 2020 2020  strings:        \n-00015130: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015140: 2045 7272 6f72 2048 616e 646c 696e 672e   Error Handling.\n-00015150: 2020 2020 2020 286c 696e 6520 2020 3629        (line   6)\n-00015160: 0a2a 2046 6972 6577 616c 6c20 4b6e 6f63  .* Firewall Knoc\n-00015170: 6b20 4f70 6572 6174 6f72 2c20 696e 7472  k Operator, intr\n-00015180: 6f3a 2020 2020 2020 2020 496e 7472 6f64  o:        Introd\n-00015190: 7563 7469 6f6e 2e20 2020 2020 2020 2028  uction.        (\n-000151a0: 6c69 6e65 2020 2036 290a 2a20 666b 6f2e  line   6).* fko.\n-000151b0: 683a 2020 2020 2020 2020 2020 2020 2020  h:              \n+000150f0: 2020 2020 2020 4572 726f 7220 4861 6e64        Error Hand\n+00015100: 6c69 6e67 2e20 2020 2020 2028 6c69 6e65  ling.      (line\n+00015110: 2020 2036 290a 2a20 6572 726f 7220 7374     6).* error st\n+00015120: 7269 6e67 733a 2020 2020 2020 2020 2020  rings:          \n+00015130: 2020 2020 2020 2020 2020 2020 2020 2045                 E\n+00015140: 7272 6f72 2048 616e 646c 696e 672e 2020  rror Handling.  \n+00015150: 2020 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*\n+00015160: 2046 6972 6577 616c 6c20 4b6e 6f63 6b20   Firewall Knock \n+00015170: 4f70 6572 6174 6f72 2c20 696e 7472 6f3a  Operator, intro:\n+00015180: 2020 2020 2020 2020 496e 7472 6f64 7563          Introduc\n+00015190: 7469 6f6e 2e20 2020 2020 2020 2028 6c69  tion.        (li\n+000151a0: 6e65 2020 2036 290a 2a20 666b 6f2e 683a  ne   6).* fko.h:\n+000151b0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 000151c0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000151d0: 2020 206c 6962 666b 6f20 4865 6164 6572     libfko Header\n-000151e0: 2e20 2020 2020 2020 286c 696e 6520 2020  .       (line   \n-000151f0: 3629 0a2a 2066 776b 6e6f 703a 2020 2020  6).* fwknop:    \n+000151d0: 206c 6962 666b 6f20 4865 6164 6572 2e20   libfko Header. \n+000151e0: 2020 2020 2020 286c 696e 6520 2020 3629        (line   6)\n+000151f0: 0a2a 2066 776b 6e6f 703a 2020 2020 2020  .* fwknop:      \n 00015200: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015210: 2020 2020 2020 2020 2020 2020 496e 7472              Intr\n-00015220: 6f64 7563 7469 6f6e 2e20 2020 2020 2020  oduction.       \n-00015230: 2028 6c69 6e65 2020 2036 290a 2a20 6770   (line   6).* gp\n-00015240: 672d 7370 6563 6966 6963 2066 756e 6374  g-specific funct\n-00015250: 696f 6e73 3a20 2020 2020 2020 2020 2020  ions:           \n-00015260: 2020 2020 2053 6574 7469 6e67 2053 5041       Setting SPA\n-00015270: 2044 6174 612e 2020 2020 286c 696e 6520   Data.    (line \n-00015280: 3131 3229 0a2a 2067 7067 2d73 7065 6369  112).* gpg-speci\n-00015290: 6669 6320 6675 6e63 7469 6f6e 7320 3c31  fic functions <1\n-000152a0: 3e3a 2020 2020 2020 2020 2020 2020 5265  >:            Re\n-000152b0: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat\n-000152c0: 612e 2028 6c69 6e65 2031 3238 290a 2a20  a. (line 128).* \n-000152d0: 6770 672d 7370 6563 6966 6963 2066 756e  gpg-specific fun\n-000152e0: 6374 696f 6e73 203c 323e 3a20 2020 2020  ctions <2>:     \n-000152f0: 2020 2020 2020 2055 7469 6c69 7479 2046         Utility F\n-00015300: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin\n-00015310: 6520 2035 3229 0a2a 2067 7067 2d73 7065  e  52).* gpg-spe\n-00015320: 6369 6669 6320 6675 6e63 7469 6f6e 7320  cific functions \n-00015330: 3c33 3e3a 2020 2020 2020 2020 2020 2020  <3>:            \n-00015340: 4572 726f 7220 4861 6e64 6c69 6e67 2e20  Error Handling. \n-00015350: 2020 2020 2028 6c69 6e65 2033 3130 290a       (line 310).\n-00015360: 2a20 4750 4c76 322b 2c20 4765 6e65 7261  * GPLv2+, Genera\n-00015370: 6c20 5075 626c 6963 204c 6963 656e 7365  l Public License\n-00015380: 3a20 2020 2020 2020 204c 6962 7261 7279  :        Library\n-00015390: 2043 6f70 7969 6e67 2e20 2020 2020 286c   Copying.     (l\n-000153a0: 696e 6520 2020 3629 0a2a 2068 6561 6465  ine   6).* heade\n-000153b0: 7220 6669 6c65 3a20 2020 2020 2020 2020  r file:         \n+00015210: 2020 2020 2020 2020 2020 496e 7472 6f64            Introd\n+00015220: 7563 7469 6f6e 2e20 2020 2020 2020 2028  uction.        (\n+00015230: 6c69 6e65 2020 2036 290a 2a20 6770 672d  line   6).* gpg-\n+00015240: 7370 6563 6966 6963 2066 756e 6374 696f  specific functio\n+00015250: 6e73 3a20 2020 2020 2020 2020 2020 2020  ns:             \n+00015260: 2020 2053 6574 7469 6e67 2053 5041 2044     Setting SPA D\n+00015270: 6174 612e 2020 2020 286c 696e 6520 3131  ata.    (line 11\n+00015280: 3229 0a2a 2067 7067 2d73 7065 6369 6669  2).* gpg-specifi\n+00015290: 6320 6675 6e63 7469 6f6e 7320 3c31 3e3a  c functions <1>:\n+000152a0: 2020 2020 2020 2020 2020 2020 5265 7472              Retr\n+000152b0: 6965 7669 6e67 2053 5041 2044 6174 612e  ieving SPA Data.\n+000152c0: 2028 6c69 6e65 2031 3238 290a 2a20 6770   (line 128).* gp\n+000152d0: 672d 7370 6563 6966 6963 2066 756e 6374  g-specific funct\n+000152e0: 696f 6e73 203c 323e 3a20 2020 2020 2020  ions <2>:       \n+000152f0: 2020 2020 2055 7469 6c69 7479 2046 756e       Utility Fun\n+00015300: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line \n+00015310: 2035 3229 0a2a 2067 7067 2d73 7065 6369   52).* gpg-speci\n+00015320: 6669 6320 6675 6e63 7469 6f6e 7320 3c33  fic functions <3\n+00015330: 3e3a 2020 2020 2020 2020 2020 2020 4572  >:            Er\n+00015340: 726f 7220 4861 6e64 6c69 6e67 2e20 2020  ror Handling.   \n+00015350: 2020 2028 6c69 6e65 2033 3130 290a 2a20     (line 310).* \n+00015360: 4750 4c76 322b 2c20 4765 6e65 7261 6c20  GPLv2+, General \n+00015370: 5075 626c 6963 204c 6963 656e 7365 3a20  Public License: \n+00015380: 2020 2020 2020 204c 6962 7261 7279 2043         Library C\n+00015390: 6f70 7969 6e67 2e20 2020 2020 286c 696e  opying.     (lin\n+000153a0: 6520 2020 3629 0a2a 2068 6561 6465 7220  e   6).* header \n+000153b0: 6669 6c65 3a20 2020 2020 2020 2020 2020  file:           \n 000153c0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000153d0: 2020 6c69 6266 6b6f 2048 6561 6465 722e    libfko Header.\n-000153e0: 2020 2020 2020 2028 6c69 6e65 2020 2036         (line   6\n-000153f0: 290a 2a20 484d 4143 2064 6967 6573 7420  ).* HMAC digest \n-00015400: 7479 7065 733a 2020 2020 2020 2020 2020  types:          \n-00015410: 2020 2020 2020 2020 2020 2048 4d41 4320             HMAC \n-00015420: 4469 6765 7374 732e 2020 2020 2020 2020  Digests.        \n-00015430: 286c 696e 6520 2020 3629 0a2a 2069 6e63  (line   6).* inc\n-00015440: 6c75 6465 2066 696c 653a 2020 2020 2020  lude file:      \n+000153d0: 6c69 6266 6b6f 2048 6561 6465 722e 2020  libfko Header.  \n+000153e0: 2020 2020 2028 6c69 6e65 2020 2036 290a       (line   6).\n+000153f0: 2a20 484d 4143 2064 6967 6573 7420 7479  * HMAC digest ty\n+00015400: 7065 733a 2020 2020 2020 2020 2020 2020  pes:            \n+00015410: 2020 2020 2020 2020 2048 4d41 4320 4469           HMAC Di\n+00015420: 6765 7374 732e 2020 2020 2020 2020 286c  gests.        (l\n+00015430: 696e 6520 2020 3629 0a2a 2069 6e63 6c75  ine   6).* inclu\n+00015440: 6465 2066 696c 653a 2020 2020 2020 2020  de file:        \n 00015450: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015460: 2020 2020 6c69 6266 6b6f 2048 6561 6465      libfko Heade\n-00015470: 722e 2020 2020 2020 2028 6c69 6e65 2020  r.       (line  \n-00015480: 2036 290a 2a20 6c69 6e6b 696e 672c 2077   6).* linking, w\n-00015490: 6974 6820 6c69 6266 6b6f 3a20 2020 2020  ith libfko:     \n-000154a0: 2020 2020 2020 2020 2020 2020 2043 6f6d               Com\n-000154b0: 7069 6c69 6e67 2077 6974 6820 6c69 6266  piling with libf\n-000154c0: 6b6f 2e0a 2020 2020 2020 2020 2020 2020  ko..            \n+00015460: 2020 6c69 6266 6b6f 2048 6561 6465 722e    libfko Header.\n+00015470: 2020 2020 2020 2028 6c69 6e65 2020 2036         (line   6\n+00015480: 290a 2a20 6c69 6e6b 696e 672c 2077 6974  ).* linking, wit\n+00015490: 6820 6c69 6266 6b6f 3a20 2020 2020 2020  h libfko:       \n+000154a0: 2020 2020 2020 2020 2020 2043 6f6d 7069             Compi\n+000154b0: 6c69 6e67 2077 6974 6820 6c69 6266 6b6f  ling with libfko\n+000154c0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              \n 000154d0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 000154e0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 000154f0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015500: 2020 286c 696e 6520 2020 3629 0a2a 206d    (line   6).* m\n-00015510: 6573 7361 6765 2064 6967 6573 7420 7479  essage digest ty\n-00015520: 7065 733a 2020 2020 2020 2020 2020 2020  pes:            \n-00015530: 2020 2020 2020 4469 6765 7374 732e 2020        Digests.  \n-00015540: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line\n-00015550: 2020 2036 290a 2a20 6d65 7373 6167 6520     6).* message \n-00015560: 6469 6765 7374 2074 7970 6573 203c 313e  digest types <1>\n-00015570: 3a20 2020 2020 2020 2020 2020 2020 2048  :              H\n-00015580: 4d41 4320 4469 6765 7374 732e 2020 2020  MAC Digests.    \n-00015590: 2020 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*\n-000155a0: 206d 6573 7361 6765 2074 7970 6573 3a20   message types: \n+00015500: 286c 696e 6520 2020 3629 0a2a 206d 6573  (line   6).* mes\n+00015510: 7361 6765 2064 6967 6573 7420 7479 7065  sage digest type\n+00015520: 733a 2020 2020 2020 2020 2020 2020 2020  s:              \n+00015530: 2020 2020 4469 6765 7374 732e 2020 2020      Digests.    \n+00015540: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  \n+00015550: 2036 290a 2a20 6d65 7373 6167 6520 6469   6).* message di\n+00015560: 6765 7374 2074 7970 6573 203c 313e 3a20  gest types <1>: \n+00015570: 2020 2020 2020 2020 2020 2020 2048 4d41               HMA\n+00015580: 4320 4469 6765 7374 732e 2020 2020 2020  C Digests.      \n+00015590: 2020 286c 696e 6520 2020 3629 0a2a 206d    (line   6).* m\n+000155a0: 6573 7361 6765 2074 7970 6573 3a20 2020  essage types:   \n 000155b0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000155c0: 2020 2020 2020 2020 5350 4120 4d65 7373          SPA Mess\n-000155d0: 6167 6573 2e20 2020 2020 2020 2028 6c69  ages.        (li\n-000155e0: 6e65 2020 2036 290a 2a20 5369 6e67 6c65  ne   6).* Single\n-000155f0: 2050 6163 6b65 7420 4175 7468 6f72 697a   Packet Authoriz\n-00015600: 6174 696f 6e2c 2069 6e74 726f 3a20 2020  ation, intro:   \n-00015610: 2049 6e74 726f 6475 6374 696f 6e2e 2020   Introduction.  \n-00015620: 2020 2020 2020 286c 696e 6520 2020 3629        (line   6)\n-00015630: 0a2a 2073 7061 2064 6174 612c 2072 6574  .* spa data, ret\n-00015640: 7269 6576 696e 6720 7661 6c75 6573 3a20  rieving values: \n-00015650: 2020 2020 2020 2020 2020 5265 7472 6965            Retrie\n-00015660: 7669 6e67 2053 5041 2044 6174 612e 2028  ving SPA Data. (\n-00015670: 6c69 6e65 2020 2036 290a 2a20 7370 6120  line   6).* spa \n-00015680: 6461 7461 2c20 7365 7474 696e 6720 7661  data, setting va\n-00015690: 6c75 6573 3a20 2020 2020 2020 2020 2020  lues:           \n-000156a0: 2020 2053 6574 7469 6e67 2053 5041 2044     Setting SPA D\n-000156b0: 6174 612e 2020 2020 286c 696e 6520 2020  ata.    (line   \n-000156c0: 3629 0a2a 2073 7061 2064 6174 612c 2075  6).* spa data, u\n-000156d0: 7469 6c69 7479 2066 756e 6374 696f 6e73  tility functions\n-000156e0: 3a20 2020 2020 2020 2020 2020 5574 696c  :           Util\n-000156f0: 6974 7920 4675 6e63 7469 6f6e 732e 2020  ity Functions.  \n-00015700: 2028 6c69 6e65 2020 2036 290a 2a20 7370   (line   6).* sp\n-00015710: 612c 2064 6174 6120 6372 6561 7469 6f6e  a, data creation\n-00015720: 2063 6f64 6520 7361 6d70 6c65 3a20 2020   code sample:   \n-00015730: 2020 2020 2043 7265 6174 696e 6720 6120       Creating a \n-00015740: 5350 4120 4d65 7373 6167 652e 0a20 2020  SPA Message..   \n+000155c0: 2020 2020 2020 5350 4120 4d65 7373 6167        SPA Messag\n+000155d0: 6573 2e20 2020 2020 2020 2028 6c69 6e65  es.        (line\n+000155e0: 2020 2036 290a 2a20 5369 6e67 6c65 2050     6).* Single P\n+000155f0: 6163 6b65 7420 4175 7468 6f72 697a 6174  acket Authorizat\n+00015600: 696f 6e2c 2069 6e74 726f 3a20 2020 2049  ion, intro:    I\n+00015610: 6e74 726f 6475 6374 696f 6e2e 2020 2020  ntroduction.    \n+00015620: 2020 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*\n+00015630: 2073 7061 2064 6174 612c 2072 6574 7269   spa data, retri\n+00015640: 6576 696e 6720 7661 6c75 6573 3a20 2020  eving values:   \n+00015650: 2020 2020 2020 2020 5265 7472 6965 7669          Retrievi\n+00015660: 6e67 2053 5041 2044 6174 612e 2028 6c69  ng SPA Data. (li\n+00015670: 6e65 2020 2036 290a 2a20 7370 6120 6461  ne   6).* spa da\n+00015680: 7461 2c20 7365 7474 696e 6720 7661 6c75  ta, setting valu\n+00015690: 6573 3a20 2020 2020 2020 2020 2020 2020  es:             \n+000156a0: 2053 6574 7469 6e67 2053 5041 2044 6174   Setting SPA Dat\n+000156b0: 612e 2020 2020 286c 696e 6520 2020 3629  a.    (line   6)\n+000156c0: 0a2a 2073 7061 2064 6174 612c 2075 7469  .* spa data, uti\n+000156d0: 6c69 7479 2066 756e 6374 696f 6e73 3a20  lity functions: \n+000156e0: 2020 2020 2020 2020 2020 5574 696c 6974            Utilit\n+000156f0: 7920 4675 6e63 7469 6f6e 732e 2020 2028  y Functions.   (\n+00015700: 6c69 6e65 2020 2036 290a 2a20 7370 612c  line   6).* spa,\n+00015710: 2064 6174 6120 6372 6561 7469 6f6e 2063   data creation c\n+00015720: 6f64 6520 7361 6d70 6c65 3a20 2020 2020  ode sample:     \n+00015730: 2020 2043 7265 6174 696e 6720 6120 5350     Creating a SP\n+00015740: 4120 4d65 7373 6167 652e 0a20 2020 2020  A Message..     \n 00015750: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 00015760: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 00015770: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015780: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line\n-00015790: 2020 2036 290a 2a20 5350 412c 2064 6174     6).* SPA, dat\n-000157a0: 6120 666f 726d 6174 3a20 2020 2020 2020  a format:       \n-000157b0: 2020 2020 2020 2020 2020 2020 2020 2053                 S\n-000157c0: 5041 2044 6174 6120 466f 726d 6174 2e20  PA Data Format. \n-000157d0: 2020 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*\n-000157e0: 2053 5041 2c20 696e 7472 6f3a 2020 2020   SPA, intro:    \n+00015780: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  \n+00015790: 2036 290a 2a20 5350 412c 2064 6174 6120   6).* SPA, data \n+000157a0: 666f 726d 6174 3a20 2020 2020 2020 2020  format:         \n+000157b0: 2020 2020 2020 2020 2020 2020 2053 5041               SPA\n+000157c0: 2044 6174 6120 466f 726d 6174 2e20 2020   Data Format.   \n+000157d0: 2020 286c 696e 6520 2020 3629 0a2a 2053    (line   6).* S\n+000157e0: 5041 2c20 696e 7472 6f3a 2020 2020 2020  PA, intro:      \n 000157f0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015800: 2020 2020 2020 2020 496e 7472 6f64 7563          Introduc\n-00015810: 7469 6f6e 2e20 2020 2020 2020 2028 6c69  tion.        (li\n-00015820: 6e65 2020 2036 290a 2a20 7370 612c 206d  ne   6).* spa, m\n-00015830: 6573 7361 6765 2064 6174 6120 6372 6561  essage data crea\n-00015840: 7469 6f6e 3a20 2020 2020 2020 2020 2020  tion:           \n-00015850: 2043 7265 6174 696e 6720 6120 5350 4120   Creating a SPA \n-00015860: 4d65 7373 6167 652e 0a20 2020 2020 2020  Message..       \n+00015800: 2020 2020 2020 496e 7472 6f64 7563 7469        Introducti\n+00015810: 6f6e 2e20 2020 2020 2020 2028 6c69 6e65  on.        (line\n+00015820: 2020 2036 290a 2a20 7370 612c 206d 6573     6).* spa, mes\n+00015830: 7361 6765 2064 6174 6120 6372 6561 7469  sage data creati\n+00015840: 6f6e 3a20 2020 2020 2020 2020 2020 2043  on:            C\n+00015850: 7265 6174 696e 6720 6120 5350 4120 4d65  reating a SPA Me\n+00015860: 7373 6167 652e 0a20 2020 2020 2020 2020  ssage..         \n 00015870: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 00015880: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 00015890: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000158a0: 2020 2020 2020 2028 6c69 6e65 2020 2036         (line   6\n-000158b0: 290a 2a20 7370 612c 206d 6573 7361 6765  ).* spa, message\n-000158c0: 2074 7970 6573 3a20 2020 2020 2020 2020   types:         \n-000158d0: 2020 2020 2020 2020 2020 2053 5041 204d             SPA M\n-000158e0: 6573 7361 6765 732e 2020 2020 2020 2020  essages.        \n-000158f0: 286c 696e 6520 2020 3629 0a2a 2075 7469  (line   6).* uti\n-00015900: 6c69 7479 2066 756e 6374 696f 6e73 3a20  lity functions: \n+000158a0: 2020 2020 2028 6c69 6e65 2020 2036 290a       (line   6).\n+000158b0: 2a20 7370 612c 206d 6573 7361 6765 2074  * spa, message t\n+000158c0: 7970 6573 3a20 2020 2020 2020 2020 2020  ypes:           \n+000158d0: 2020 2020 2020 2020 2053 5041 204d 6573           SPA Mes\n+000158e0: 7361 6765 732e 2020 2020 2020 2020 286c  sages.        (l\n+000158f0: 696e 6520 2020 3629 0a2a 2075 7469 6c69  ine   6).* utili\n+00015900: 7479 2066 756e 6374 696f 6e73 3a20 2020  ty functions:   \n 00015910: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015920: 2020 2020 5574 696c 6974 7920 4675 6e63      Utility Func\n-00015930: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  \n-00015940: 2036 290a 0a1f 0a46 696c 653a 206c 6962   6)....File: lib\n-00015950: 666b 6f2e 696e 666f 2c20 204e 6f64 653a  fko.info,  Node:\n-00015960: 2046 756e 6374 696f 6e20 616e 6420 4461   Function and Da\n-00015970: 7461 2049 6e64 6578 2c20 2050 7265 763a  ta Index,  Prev:\n-00015980: 2043 6f6e 6365 7074 2049 6e64 6578 2c20   Concept Index, \n-00015990: 2055 703a 2054 6f70 0a0a 4675 6e63 7469   Up: Top..Functi\n-000159a0: 6f6e 2061 6e64 2044 6174 6120 496e 6465  on and Data Inde\n-000159b0: 780a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  x.**************\n-000159c0: 2a2a 2a2a 2a2a 2a2a 2a0a 0a00 085b 696e  *********....[in\n-000159d0: 6465 7800 085d 0a2a 204d 656e 753a 0a0a  dex..].* Menu:..\n-000159e0: 2a20 6572 726f 725f 636f 6465 3a20 2020  * error_code:   \n+00015920: 2020 5574 696c 6974 7920 4675 6e63 7469    Utility Functi\n+00015930: 6f6e 732e 2020 2028 6c69 6e65 2020 2036  ons.   (line   6\n+00015940: 290a 0a1f 0a46 696c 653a 206c 6962 666b  )....File: libfk\n+00015950: 6f2e 696e 666f 2c20 204e 6f64 653a 2046  o.info,  Node: F\n+00015960: 756e 6374 696f 6e20 616e 6420 4461 7461  unction and Data\n+00015970: 2049 6e64 6578 2c20 2050 7265 763a 2043   Index,  Prev: C\n+00015980: 6f6e 6365 7074 2049 6e64 6578 2c20 2055  oncept Index,  U\n+00015990: 703a 2054 6f70 0a0a 4675 6e63 7469 6f6e  p: Top..Function\n+000159a0: 2061 6e64 2044 6174 6120 496e 6465 780a   and Data Index.\n+000159b0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ****************\n+000159c0: 2a2a 2a2a 2a2a 2a0a 0a00 085b 696e 6465  *******....[inde\n+000159d0: 7800 085d 0a2a 204d 656e 753a 0a0a 2a20  x..].* Menu:..* \n+000159e0: 6572 726f 725f 636f 6465 3a20 2020 2020  error_code:     \n 000159f0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015a00: 2020 2020 2020 2020 2045 7272 6f72 2048           Error H\n-00015a10: 616e 646c 696e 672e 2020 2020 2020 286c  andling.      (l\n-00015a20: 696e 6520 2031 3829 0a2a 2065 7272 6f72  ine  18).* error\n-00015a30: 5f63 6f64 6520 3c31 3e3a 2020 2020 2020  _code <1>:      \n+00015a00: 2020 2020 2020 2045 7272 6f72 2048 616e         Error Han\n+00015a10: 646c 696e 672e 2020 2020 2020 286c 696e  dling.      (lin\n+00015a20: 6520 2031 3829 0a2a 2065 7272 6f72 5f63  e  18).* error_c\n+00015a30: 6f64 6520 3c31 3e3a 2020 2020 2020 2020  ode <1>:        \n 00015a40: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015a50: 2020 4572 726f 7220 4861 6e64 6c69 6e67    Error Handling\n-00015a60: 2e20 2020 2020 2028 6c69 6e65 2032 3431  .      (line 241\n-00015a70: 290a 2a20 666b 6f5f 6465 636f 6465 5f73  ).* fko_decode_s\n-00015a80: 7061 5f64 6174 613a 2020 2020 2020 2020  pa_data:        \n-00015a90: 2020 2020 2020 2020 2020 2055 7469 6c69             Utili\n-00015aa0: 7479 2046 756e 6374 696f 6e73 2e20 2020  ty Functions.   \n-00015ab0: 286c 696e 6520 2033 3829 0a2a 2066 6b6f  (line  38).* fko\n-00015ac0: 5f64 6563 7279 7074 5f73 7061 5f64 6174  _decrypt_spa_dat\n-00015ad0: 613a 2020 2020 2020 2020 2020 2020 2020  a:              \n-00015ae0: 2020 2020 5574 696c 6974 7920 4675 6e63      Utility Func\n-00015af0: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  \n-00015b00: 3233 290a 2a20 666b 6f5f 6465 7374 726f  23).* fko_destro\n-00015b10: 793a 2020 2020 2020 2020 2020 2020 2020  y:              \n-00015b20: 2020 2020 2020 2020 2020 2020 2044 6573               Des\n-00015b30: 7472 6f79 696e 6720 436f 6e74 6578 7473  troying Contexts\n-00015b40: 2e20 286c 696e 6520 2031 3129 0a2a 2066  . (line  11).* f\n-00015b50: 6b6f 5f64 6967 6573 745f 7479 7065 5f74  ko_digest_type_t\n-00015b60: 3a20 2020 2020 2020 2020 2020 2020 2020  :               \n-00015b70: 2020 2020 2020 4469 6765 7374 732e 2020        Digests.  \n-00015b80: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line\n-00015b90: 2020 3137 290a 2a20 666b 6f5f 6469 6765    17).* fko_dige\n-00015ba0: 7374 5f74 7970 655f 7420 3c31 3e3a 2020  st_type_t <1>:  \n-00015bb0: 2020 2020 2020 2020 2020 2020 2020 2048                 H\n-00015bc0: 4d41 4320 4469 6765 7374 732e 2020 2020  MAC Digests.    \n-00015bd0: 2020 2020 286c 696e 6520 2031 3429 0a2a      (line  14).*\n-00015be0: 2066 6b6f 5f65 6e63 6f64 655f 7370 615f   fko_encode_spa_\n-00015bf0: 6461 7461 3a20 2020 2020 2020 2020 2020  data:           \n-00015c00: 2020 2020 2020 2020 5574 696c 6974 7920          Utility \n-00015c10: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li\n-00015c20: 6e65 2020 3434 290a 2a20 666b 6f5f 656e  ne  44).* fko_en\n-00015c30: 6372 7970 7469 6f6e 5f74 7970 655f 743a  cryption_type_t:\n-00015c40: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015c50: 2045 6e63 7279 7074 696f 6e20 416c 676f   Encryption Algo\n-00015c60: 7269 7468 6d73 2e0a 2020 2020 2020 2020  rithms..        \n+00015a50: 4572 726f 7220 4861 6e64 6c69 6e67 2e20  Error Handling. \n+00015a60: 2020 2020 2028 6c69 6e65 2032 3431 290a       (line 241).\n+00015a70: 2a20 666b 6f5f 6465 636f 6465 5f73 7061  * fko_decode_spa\n+00015a80: 5f64 6174 613a 2020 2020 2020 2020 2020  _data:          \n+00015a90: 2020 2020 2020 2020 2055 7469 6c69 7479           Utility\n+00015aa0: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l\n+00015ab0: 696e 6520 2033 3829 0a2a 2066 6b6f 5f64  ine  38).* fko_d\n+00015ac0: 6563 7279 7074 5f73 7061 5f64 6174 613a  ecrypt_spa_data:\n+00015ad0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n+00015ae0: 2020 5574 696c 6974 7920 4675 6e63 7469    Utility Functi\n+00015af0: 6f6e 732e 2020 2028 6c69 6e65 2020 3233  ons.   (line  23\n+00015b00: 290a 2a20 666b 6f5f 6465 7374 726f 793a  ).* fko_destroy:\n+00015b10: 2020 2020 2020 2020 2020 2020 2020 2020                  \n+00015b20: 2020 2020 2020 2020 2020 2044 6573 7472             Destr\n+00015b30: 6f79 696e 6720 436f 6e74 6578 7473 2e20  oying Contexts. \n+00015b40: 286c 696e 6520 2031 3129 0a2a 2066 6b6f  (line  11).* fko\n+00015b50: 5f64 6967 6573 745f 7479 7065 5f74 3a20  _digest_type_t: \n+00015b60: 2020 2020 2020 2020 2020 2020 2020 2020                  \n+00015b70: 2020 2020 4469 6765 7374 732e 2020 2020      Digests.    \n+00015b80: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  \n+00015b90: 3137 290a 2a20 666b 6f5f 6469 6765 7374  17).* fko_digest\n+00015ba0: 5f74 7970 655f 7420 3c31 3e3a 2020 2020  _type_t <1>:    \n+00015bb0: 2020 2020 2020 2020 2020 2020 2048 4d41               HMA\n+00015bc0: 4320 4469 6765 7374 732e 2020 2020 2020  C Digests.      \n+00015bd0: 2020 286c 696e 6520 2031 3429 0a2a 2066    (line  14).* f\n+00015be0: 6b6f 5f65 6e63 6f64 655f 7370 615f 6461  ko_encode_spa_da\n+00015bf0: 7461 3a20 2020 2020 2020 2020 2020 2020  ta:             \n+00015c00: 2020 2020 2020 5574 696c 6974 7920 4675        Utility Fu\n+00015c10: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line\n+00015c20: 2020 3434 290a 2a20 666b 6f5f 656e 6372    44).* fko_encr\n+00015c30: 7970 7469 6f6e 5f74 7970 655f 743a 2020  yption_type_t:  \n+00015c40: 2020 2020 2020 2020 2020 2020 2020 2045                 E\n+00015c50: 6e63 7279 7074 696f 6e20 416c 676f 7269  ncryption Algori\n+00015c60: 7468 6d73 2e0a 2020 2020 2020 2020 2020  thms..          \n 00015c70: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 00015c80: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 00015c90: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015ca0: 2020 2020 2020 286c 696e 6520 2031 3029        (line  10)\n-00015cb0: 0a2a 2066 6b6f 5f65 6e63 7279 7074 5f73  .* fko_encrypt_s\n-00015cc0: 7061 5f64 6174 613a 2020 2020 2020 2020  pa_data:        \n-00015cd0: 2020 2020 2020 2020 2020 5574 696c 6974            Utilit\n-00015ce0: 7920 4675 6e63 7469 6f6e 732e 2020 2028  y Functions.   (\n-00015cf0: 6c69 6e65 2020 3332 290a 2a20 666b 6f5f  line  32).* fko_\n-00015d00: 6572 7273 7472 3a20 2020 2020 2020 2020  errstr:         \n+00015ca0: 2020 2020 286c 696e 6520 2031 3029 0a2a      (line  10).*\n+00015cb0: 2066 6b6f 5f65 6e63 7279 7074 5f73 7061   fko_encrypt_spa\n+00015cc0: 5f64 6174 613a 2020 2020 2020 2020 2020  _data:          \n+00015cd0: 2020 2020 2020 2020 5574 696c 6974 7920          Utility \n+00015ce0: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li\n+00015cf0: 6e65 2020 3332 290a 2a20 666b 6f5f 6572  ne  32).* fko_er\n+00015d00: 7273 7472 3a20 2020 2020 2020 2020 2020  rstr:           \n 00015d10: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015d20: 2020 2045 7272 6f72 2048 616e 646c 696e     Error Handlin\n-00015d30: 672e 2020 2020 2020 286c 696e 6520 2031  g.      (line  1\n-00015d40: 3129 0a2a 2066 6b6f 5f67 6574 5f65 6e63  1).* fko_get_enc\n-00015d50: 6f64 6564 5f64 6174 613a 2020 2020 2020  oded_data:      \n-00015d60: 2020 2020 2020 2020 2020 2020 5265 7472              Retr\n-00015d70: 6965 7669 6e67 2053 5041 2044 6174 612e  ieving SPA Data.\n-00015d80: 2028 6c69 6e65 2031 3133 290a 2a20 666b   (line 113).* fk\n-00015d90: 6f5f 6765 745f 6770 675f 6578 653a 2020  o_get_gpg_exe:  \n+00015d20: 2045 7272 6f72 2048 616e 646c 696e 672e   Error Handling.\n+00015d30: 2020 2020 2020 286c 696e 6520 2031 3129        (line  11)\n+00015d40: 0a2a 2066 6b6f 5f67 6574 5f65 6e63 6f64  .* fko_get_encod\n+00015d50: 6564 5f64 6174 613a 2020 2020 2020 2020  ed_data:        \n+00015d60: 2020 2020 2020 2020 2020 5265 7472 6965            Retrie\n+00015d70: 7669 6e67 2053 5041 2044 6174 612e 2028  ving SPA Data. (\n+00015d80: 6c69 6e65 2031 3133 290a 2a20 666b 6f5f  line 113).* fko_\n+00015d90: 6765 745f 6770 675f 6578 653a 2020 2020  get_gpg_exe:    \n 00015da0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015db0: 2020 2020 2052 6574 7269 6576 696e 6720       Retrieving \n-00015dc0: 5350 4120 4461 7461 2e20 286c 696e 6520  SPA Data. (line \n-00015dd0: 3138 3229 0a2a 2066 6b6f 5f67 6574 5f67  182).* fko_get_g\n-00015de0: 7067 5f68 6f6d 655f 6469 723a 2020 2020  pg_home_dir:    \n-00015df0: 2020 2020 2020 2020 2020 2020 2020 5265                Re\n-00015e00: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat\n-00015e10: 612e 2028 6c69 6e65 2031 3431 290a 2a20  a. (line 141).* \n-00015e20: 666b 6f5f 6765 745f 6770 675f 6967 6e6f  fko_get_gpg_igno\n-00015e30: 7265 5f76 6572 6966 795f 6572 726f 723a  re_verify_error:\n-00015e40: 2020 2020 2020 2052 6574 7269 6576 696e         Retrievin\n-00015e50: 6720 5350 4120 4461 7461 2e20 286c 696e  g SPA Data. (lin\n-00015e60: 6520 3135 3229 0a2a 2066 6b6f 5f67 6574  e 152).* fko_get\n-00015e70: 5f67 7067 5f72 6563 6970 6965 6e74 3a20  _gpg_recipient: \n-00015e80: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015e90: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D\n-00015ea0: 6174 612e 2028 6c69 6e65 2031 3330 290a  ata. (line 130).\n-00015eb0: 2a20 666b 6f5f 6765 745f 6770 675f 7369  * fko_get_gpg_si\n-00015ec0: 676e 6174 7572 655f 6670 723a 2020 2020  gnature_fpr:    \n-00015ed0: 2020 2020 2020 2020 2052 6574 7269 6576           Retriev\n-00015ee0: 696e 6720 5350 4120 4461 7461 2e20 286c  ing SPA Data. (l\n-00015ef0: 696e 6520 3136 3429 0a2a 2066 6b6f 5f67  ine 164).* fko_g\n-00015f00: 6574 5f67 7067 5f73 6967 6e61 7475 7265  et_gpg_signature\n-00015f10: 5f69 643a 2020 2020 2020 2020 2020 2020  _id:            \n-00015f20: 2020 5265 7472 6965 7669 6e67 2053 5041    Retrieving SPA\n-00015f30: 2044 6174 612e 2028 6c69 6e65 2031 3538   Data. (line 158\n-00015f40: 290a 2a20 666b 6f5f 6765 745f 6770 675f  ).* fko_get_gpg_\n-00015f50: 7369 676e 6174 7572 655f 7374 6174 7573  signature_status\n-00015f60: 3a20 2020 2020 2020 2020 2052 6574 7269  :          Retri\n-00015f70: 6576 696e 6720 5350 4120 4461 7461 2e20  eving SPA Data. \n-00015f80: 286c 696e 6520 3137 3629 0a2a 2066 6b6f  (line 176).* fko\n-00015f90: 5f67 6574 5f67 7067 5f73 6967 6e61 7475  _get_gpg_signatu\n-00015fa0: 7265 5f73 756d 6d61 7279 3a20 2020 2020  re_summary:     \n-00015fb0: 2020 2020 5265 7472 6965 7669 6e67 2053      Retrieving S\n-00015fc0: 5041 2044 6174 612e 2028 6c69 6e65 2031  PA Data. (line 1\n-00015fd0: 3730 290a 2a20 666b 6f5f 6765 745f 6770  70).* fko_get_gp\n-00015fe0: 675f 7369 676e 6174 7572 655f 7665 7269  g_signature_veri\n-00015ff0: 6679 3a20 2020 2020 2020 2020 2052 6574  fy:          Ret\n-00016000: 7269 6576 696e 6720 5350 4120 4461 7461  rieving SPA Data\n-00016010: 2e20 286c 696e 6520 3134 3629 0a2a 2066  . (line 146).* f\n-00016020: 6b6f 5f67 6574 5f67 7067 5f73 6967 6e65  ko_get_gpg_signe\n-00016030: 723a 2020 2020 2020 2020 2020 2020 2020  r:              \n-00016040: 2020 2020 2020 5265 7472 6965 7669 6e67        Retrieving\n-00016050: 2053 5041 2044 6174 612e 2028 6c69 6e65   SPA Data. (line\n-00016060: 2031 3336 290a 2a20 666b 6f5f 6765 745f   136).* fko_get_\n-00016070: 7261 6e64 5f76 616c 7565 3a20 2020 2020  rand_value:     \n-00016080: 2020 2020 2020 2020 2020 2020 2020 2052                 R\n-00016090: 6574 7269 6576 696e 6720 5350 4120 4461  etrieving SPA Da\n-000160a0: 7461 2e20 286c 696e 6520 2031 3829 0a2a  ta. (line  18).*\n-000160b0: 2066 6b6f 5f67 6574 5f73 7061 5f63 6c69   fko_get_spa_cli\n-000160c0: 656e 745f 7469 6d65 6f75 743a 2020 2020  ent_timeout:    \n-000160d0: 2020 2020 2020 2020 5265 7472 6965 7669          Retrievi\n-000160e0: 6e67 2053 5041 2044 6174 612e 2028 6c69  ng SPA Data. (li\n-000160f0: 6e65 2020 3735 290a 2a20 666b 6f5f 6765  ne  75).* fko_ge\n-00016100: 745f 7370 615f 6461 7461 3a20 2020 2020  t_spa_data:     \n-00016110: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00016120: 2052 6574 7269 6576 696e 6720 5350 4120   Retrieving SPA \n-00016130: 4461 7461 2e20 286c 696e 6520 2031 3229  Data. (line  12)\n-00016140: 0a2a 2066 6b6f 5f67 6574 5f73 7061 5f64  .* fko_get_spa_d\n-00016150: 6967 6573 743a 2020 2020 2020 2020 2020  igest:          \n-00016160: 2020 2020 2020 2020 2020 5265 7472 6965            Retrie\n-00016170: 7669 6e67 2053 5041 2044 6174 612e 2028  ving SPA Data. (\n-00016180: 6c69 6e65 2020 3935 290a 2a20 666b 6f5f  line  95).* fko_\n-00016190: 6765 745f 7370 615f 6469 6765 7374 5f74  get_spa_digest_t\n-000161a0: 7970 653a 2020 2020 2020 2020 2020 2020  ype:            \n-000161b0: 2020 2052 6574 7269 6576 696e 6720 5350     Retrieving SP\n-000161c0: 4120 4461 7461 2e20 286c 696e 6520 2038  A Data. (line  8\n-000161d0: 3129 0a2a 2066 6b6f 5f67 6574 5f73 7061  1).* fko_get_spa\n-000161e0: 5f65 6e63 7279 7074 696f 6e5f 7479 7065  _encryption_type\n-000161f0: 3a20 2020 2020 2020 2020 2020 5265 7472  :           Retr\n-00016200: 6965 7669 6e67 2053 5041 2044 6174 612e  ieving SPA Data.\n-00016210: 2028 6c69 6e65 2031 3035 290a 2a20 666b   (line 105).* fk\n-00016220: 6f5f 6765 745f 7370 615f 686d 6163 3a20  o_get_spa_hmac: \n+00015db0: 2020 2052 6574 7269 6576 696e 6720 5350     Retrieving SP\n+00015dc0: 4120 4461 7461 2e20 286c 696e 6520 3138  A Data. (line 18\n+00015dd0: 3229 0a2a 2066 6b6f 5f67 6574 5f67 7067  2).* fko_get_gpg\n+00015de0: 5f68 6f6d 655f 6469 723a 2020 2020 2020  _home_dir:      \n+00015df0: 2020 2020 2020 2020 2020 2020 5265 7472              Retr\n+00015e00: 6965 7669 6e67 2053 5041 2044 6174 612e  ieving SPA Data.\n+00015e10: 2028 6c69 6e65 2031 3431 290a 2a20 666b   (line 141).* fk\n+00015e20: 6f5f 6765 745f 6770 675f 6967 6e6f 7265  o_get_gpg_ignore\n+00015e30: 5f76 6572 6966 795f 6572 726f 723a 2020  _verify_error:  \n+00015e40: 2020 2020 2052 6574 7269 6576 696e 6720       Retrieving \n+00015e50: 5350 4120 4461 7461 2e20 286c 696e 6520  SPA Data. (line \n+00015e60: 3135 3229 0a2a 2066 6b6f 5f67 6574 5f67  152).* fko_get_g\n+00015e70: 7067 5f72 6563 6970 6965 6e74 3a20 2020  pg_recipient:   \n+00015e80: 2020 2020 2020 2020 2020 2020 2020 5265                Re\n+00015e90: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat\n+00015ea0: 612e 2028 6c69 6e65 2031 3330 290a 2a20  a. (line 130).* \n+00015eb0: 666b 6f5f 6765 745f 6770 675f 7369 676e  fko_get_gpg_sign\n+00015ec0: 6174 7572 655f 6670 723a 2020 2020 2020  ature_fpr:      \n+00015ed0: 2020 2020 2020 2052 6574 7269 6576 696e         Retrievin\n+00015ee0: 6720 5350 4120 4461 7461 2e20 286c 696e  g SPA Data. (lin\n+00015ef0: 6520 3136 3429 0a2a 2066 6b6f 5f67 6574  e 164).* fko_get\n+00015f00: 5f67 7067 5f73 6967 6e61 7475 7265 5f69  _gpg_signature_i\n+00015f10: 643a 2020 2020 2020 2020 2020 2020 2020  d:              \n+00015f20: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D\n+00015f30: 6174 612e 2028 6c69 6e65 2031 3538 290a  ata. (line 158).\n+00015f40: 2a20 666b 6f5f 6765 745f 6770 675f 7369  * fko_get_gpg_si\n+00015f50: 676e 6174 7572 655f 7374 6174 7573 3a20  gnature_status: \n+00015f60: 2020 2020 2020 2020 2052 6574 7269 6576           Retriev\n+00015f70: 696e 6720 5350 4120 4461 7461 2e20 286c  ing SPA Data. (l\n+00015f80: 696e 6520 3137 3629 0a2a 2066 6b6f 5f67  ine 176).* fko_g\n+00015f90: 6574 5f67 7067 5f73 6967 6e61 7475 7265  et_gpg_signature\n+00015fa0: 5f73 756d 6d61 7279 3a20 2020 2020 2020  _summary:       \n+00015fb0: 2020 5265 7472 6965 7669 6e67 2053 5041    Retrieving SPA\n+00015fc0: 2044 6174 612e 2028 6c69 6e65 2031 3730   Data. (line 170\n+00015fd0: 290a 2a20 666b 6f5f 6765 745f 6770 675f  ).* fko_get_gpg_\n+00015fe0: 7369 676e 6174 7572 655f 7665 7269 6679  signature_verify\n+00015ff0: 3a20 2020 2020 2020 2020 2052 6574 7269  :          Retri\n+00016000: 6576 696e 6720 5350 4120 4461 7461 2e20  eving SPA Data. \n+00016010: 286c 696e 6520 3134 3629 0a2a 2066 6b6f  (line 146).* fko\n+00016020: 5f67 6574 5f67 7067 5f73 6967 6e65 723a  _get_gpg_signer:\n+00016030: 2020 2020 2020 2020 2020 2020 2020 2020                  \n+00016040: 2020 2020 5265 7472 6965 7669 6e67 2053      Retrieving S\n+00016050: 5041 2044 6174 612e 2028 6c69 6e65 2031  PA Data. (line 1\n+00016060: 3336 290a 2a20 666b 6f5f 6765 745f 7261  36).* fko_get_ra\n+00016070: 6e64 5f76 616c 7565 3a20 2020 2020 2020  nd_value:       \n+00016080: 2020 2020 2020 2020 2020 2020 2052 6574               Ret\n+00016090: 7269 6576 696e 6720 5350 4120 4461 7461  rieving SPA Data\n+000160a0: 2e20 286c 696e 6520 2031 3829 0a2a 2066  . (line  18).* f\n+000160b0: 6b6f 5f67 6574 5f73 7061 5f63 6c69 656e  ko_get_spa_clien\n+000160c0: 745f 7469 6d65 6f75 743a 2020 2020 2020  t_timeout:      \n+000160d0: 2020 2020 2020 5265 7472 6965 7669 6e67        Retrieving\n+000160e0: 2053 5041 2044 6174 612e 2028 6c69 6e65   SPA Data. (line\n+000160f0: 2020 3735 290a 2a20 666b 6f5f 6765 745f    75).* fko_get_\n+00016100: 7370 615f 6461 7461 3a20 2020 2020 2020  spa_data:       \n+00016110: 2020 2020 2020 2020 2020 2020 2020 2052                 R\n+00016120: 6574 7269 6576 696e 6720 5350 4120 4461  etrieving SPA Da\n+00016130: 7461 2e20 286c 696e 6520 2031 3229 0a2a  ta. (line  12).*\n+00016140: 2066 6b6f 5f67 6574 5f73 7061 5f64 6967   fko_get_spa_dig\n+00016150: 6573 743a 2020 2020 2020 2020 2020 2020  est:            \n+00016160: 2020 2020 2020 2020 5265 7472 6965 7669          Retrievi\n+00016170: 6e67 2053 5041 2044 6174 612e 2028 6c69  ng SPA Data. (li\n+00016180: 6e65 2020 3935 290a 2a20 666b 6f5f 6765  ne  95).* fko_ge\n+00016190: 745f 7370 615f 6469 6765 7374 5f74 7970  t_spa_digest_typ\n+000161a0: 653a 2020 2020 2020 2020 2020 2020 2020  e:              \n+000161b0: 2052 6574 7269 6576 696e 6720 5350 4120   Retrieving SPA \n+000161c0: 4461 7461 2e20 286c 696e 6520 2038 3129  Data. (line  81)\n+000161d0: 0a2a 2066 6b6f 5f67 6574 5f73 7061 5f65  .* fko_get_spa_e\n+000161e0: 6e63 7279 7074 696f 6e5f 7479 7065 3a20  ncryption_type: \n+000161f0: 2020 2020 2020 2020 2020 5265 7472 6965            Retrie\n+00016200: 7669 6e67 2053 5041 2044 6174 612e 2028  ving SPA Data. (\n+00016210: 6c69 6e65 2031 3035 290a 2a20 666b 6f5f  line 105).* fko_\n+00016220: 6765 745f 7370 615f 686d 6163 3a20 2020  get_spa_hmac:   \n 00016230: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00016240: 2020 2020 2052 6574 7269 6576 696e 6720       Retrieving \n-00016250: 5350 4120 4461 7461 2e20 286c 696e 6520  SPA Data. (line \n-00016260: 3130 3029 0a2a 2066 6b6f 5f67 6574 5f73  100).* fko_get_s\n-00016270: 7061 5f68 6d61 635f 7479 7065 3a20 2020  pa_hmac_type:   \n-00016280: 2020 2020 2020 2020 2020 2020 2020 5265                Re\n-00016290: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat\n-000162a0: 612e 2028 6c69 6e65 2020 3838 290a 2a20  a. (line  88).* \n-000162b0: 666b 6f5f 6765 745f 7370 615f 6d65 7373  fko_get_spa_mess\n-000162c0: 6167 653a 2020 2020 2020 2020 2020 2020  age:            \n-000162d0: 2020 2020 2020 2052 6574 7269 6576 696e         Retrievin\n-000162e0: 6720 5350 4120 4461 7461 2e20 286c 696e  g SPA Data. (lin\n-000162f0: 6520 2035 3629 0a2a 2066 6b6f 5f67 6574  e  56).* fko_get\n-00016300: 5f73 7061 5f6d 6573 7361 6765 5f74 7970  _spa_message_typ\n-00016310: 653a 2020 2020 2020 2020 2020 2020 2020  e:              \n-00016320: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D\n-00016330: 6174 612e 2028 6c69 6e65 2020 3334 290a  ata. (line  34).\n-00016340: 2a20 666b 6f5f 6765 745f 7370 615f 6e61  * fko_get_spa_na\n-00016350: 745f 6163 6365 7373 3a20 2020 2020 2020  t_access:       \n-00016360: 2020 2020 2020 2020 2052 6574 7269 6576           Retriev\n-00016370: 696e 6720 5350 4120 4461 7461 2e20 286c  ing SPA Data. (l\n-00016380: 696e 6520 2036 3129 0a2a 2066 6b6f 5f67  ine  61).* fko_g\n-00016390: 6574 5f73 7061 5f73 6572 7665 725f 6175  et_spa_server_au\n-000163a0: 7468 3a20 2020 2020 2020 2020 2020 2020  th:             \n-000163b0: 2020 5265 7472 6965 7669 6e67 2053 5041    Retrieving SPA\n-000163c0: 2044 6174 612e 2028 6c69 6e65 2020 3638   Data. (line  68\n-000163d0: 290a 2a20 666b 6f5f 6765 745f 7469 6d65  ).* fko_get_time\n-000163e0: 7374 616d 703a 2020 2020 2020 2020 2020  stamp:          \n-000163f0: 2020 2020 2020 2020 2020 2052 6574 7269             Retri\n-00016400: 6576 696e 6720 5350 4120 4461 7461 2e20  eving SPA Data. \n-00016410: 286c 696e 6520 2032 3929 0a2a 2066 6b6f  (line  29).* fko\n-00016420: 5f67 6574 5f75 7365 726e 616d 653a 2020  _get_username:  \n+00016240: 2020 2052 6574 7269 6576 696e 6720 5350     Retrieving SP\n+00016250: 4120 4461 7461 2e20 286c 696e 6520 3130  A Data. (line 10\n+00016260: 3029 0a2a 2066 6b6f 5f67 6574 5f73 7061  0).* fko_get_spa\n+00016270: 5f68 6d61 635f 7479 7065 3a20 2020 2020  _hmac_type:     \n+00016280: 2020 2020 2020 2020 2020 2020 5265 7472              Retr\n+00016290: 6965 7669 6e67 2053 5041 2044 6174 612e  ieving SPA Data.\n+000162a0: 2028 6c69 6e65 2020 3838 290a 2a20 666b   (line  88).* fk\n+000162b0: 6f5f 6765 745f 7370 615f 6d65 7373 6167  o_get_spa_messag\n+000162c0: 653a 2020 2020 2020 2020 2020 2020 2020  e:              \n+000162d0: 2020 2020 2052 6574 7269 6576 696e 6720       Retrieving \n+000162e0: 5350 4120 4461 7461 2e20 286c 696e 6520  SPA Data. (line \n+000162f0: 2035 3629 0a2a 2066 6b6f 5f67 6574 5f73   56).* fko_get_s\n+00016300: 7061 5f6d 6573 7361 6765 5f74 7970 653a  pa_message_type:\n+00016310: 2020 2020 2020 2020 2020 2020 2020 5265                Re\n+00016320: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat\n+00016330: 612e 2028 6c69 6e65 2020 3334 290a 2a20  a. (line  34).* \n+00016340: 666b 6f5f 6765 745f 7370 615f 6e61 745f  fko_get_spa_nat_\n+00016350: 6163 6365 7373 3a20 2020 2020 2020 2020  access:         \n+00016360: 2020 2020 2020 2052 6574 7269 6576 696e         Retrievin\n+00016370: 6720 5350 4120 4461 7461 2e20 286c 696e  g SPA Data. (lin\n+00016380: 6520 2036 3129 0a2a 2066 6b6f 5f67 6574  e  61).* fko_get\n+00016390: 5f73 7061 5f73 6572 7665 725f 6175 7468  _spa_server_auth\n+000163a0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               \n+000163b0: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D\n+000163c0: 6174 612e 2028 6c69 6e65 2020 3638 290a  ata. (line  68).\n+000163d0: 2a20 666b 6f5f 6765 745f 7469 6d65 7374  * fko_get_timest\n+000163e0: 616d 703a 2020 2020 2020 2020 2020 2020  amp:            \n+000163f0: 2020 2020 2020 2020 2052 6574 7269 6576           Retriev\n+00016400: 696e 6720 5350 4120 4461 7461 2e20 286c  ing SPA Data. (l\n+00016410: 696e 6520 2032 3929 0a2a 2066 6b6f 5f67  ine  29).* fko_g\n+00016420: 6574 5f75 7365 726e 616d 653a 2020 2020  et_username:    \n 00016430: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00016440: 2020 2020 5265 7472 6965 7669 6e67 2053      Retrieving S\n-00016450: 5041 2044 6174 612e 2028 6c69 6e65 2020  PA Data. (line  \n-00016460: 3234 290a 2a20 666b 6f5f 6765 745f 7665  24).* fko_get_ve\n-00016470: 7273 696f 6e3a 2020 2020 2020 2020 2020  rsion:          \n-00016480: 2020 2020 2020 2020 2020 2020 2052 6574               Ret\n-00016490: 7269 6576 696e 6720 5350 4120 4461 7461  rieving SPA Data\n-000164a0: 2e20 286c 696e 6520 3132 3029 0a2a 2066  . (line 120).* f\n-000164b0: 6b6f 5f67 7067 5f65 7272 7374 723a 2020  ko_gpg_errstr:  \n+00016440: 2020 5265 7472 6965 7669 6e67 2053 5041    Retrieving SPA\n+00016450: 2044 6174 612e 2028 6c69 6e65 2020 3234   Data. (line  24\n+00016460: 290a 2a20 666b 6f5f 6765 745f 7665 7273  ).* fko_get_vers\n+00016470: 696f 6e3a 2020 2020 2020 2020 2020 2020  ion:            \n+00016480: 2020 2020 2020 2020 2020 2052 6574 7269             Retri\n+00016490: 6576 696e 6720 5350 4120 4461 7461 2e20  eving SPA Data. \n+000164a0: 286c 696e 6520 3132 3029 0a2a 2066 6b6f  (line 120).* fko\n+000164b0: 5f67 7067 5f65 7272 7374 723a 2020 2020  _gpg_errstr:    \n 000164c0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000164d0: 2020 2020 2020 4572 726f 7220 4861 6e64        Error Hand\n-000164e0: 6c69 6e67 2e20 2020 2020 2028 6c69 6e65  ling.      (line\n-000164f0: 2033 3130 290a 2a20 666b 6f5f 6770 675f   310).* fko_gpg_\n-00016500: 7369 676e 6174 7572 655f 6670 725f 6d61  signature_fpr_ma\n-00016510: 7463 683a 2020 2020 2020 2020 2020 2055  tch:           U\n-00016520: 7469 6c69 7479 2046 756e 6374 696f 6e73  tility Functions\n-00016530: 2e20 2020 286c 696e 6520 2036 3129 0a2a  .   (line  61).*\n-00016540: 2066 6b6f 5f67 7067 5f73 6967 6e61 7475   fko_gpg_signatu\n-00016550: 7265 5f69 645f 6d61 7463 683a 2020 2020  re_id_match:    \n-00016560: 2020 2020 2020 2020 5574 696c 6974 7920          Utility \n-00016570: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li\n-00016580: 6e65 2020 3534 290a 2a20 666b 6f5f 6d65  ne  54).* fko_me\n-00016590: 7373 6167 655f 7479 7065 5f74 3a20 2020  ssage_type_t:   \n-000165a0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000165b0: 2053 5041 204d 6573 7361 6765 732e 2020   SPA Messages.  \n-000165c0: 2020 2020 2020 286c 696e 6520 2031 3129        (line  11)\n-000165d0: 0a2a 2066 6b6f 5f6e 6577 3a20 2020 2020  .* fko_new:     \n+000164d0: 2020 2020 4572 726f 7220 4861 6e64 6c69      Error Handli\n+000164e0: 6e67 2e20 2020 2020 2028 6c69 6e65 2033  ng.      (line 3\n+000164f0: 3130 290a 2a20 666b 6f5f 6770 675f 7369  10).* fko_gpg_si\n+00016500: 676e 6174 7572 655f 6670 725f 6d61 7463  gnature_fpr_matc\n+00016510: 683a 2020 2020 2020 2020 2020 2055 7469  h:           Uti\n+00016520: 6c69 7479 2046 756e 6374 696f 6e73 2e20  lity Functions. \n+00016530: 2020 286c 696e 6520 2036 3129 0a2a 2066    (line  61).* f\n+00016540: 6b6f 5f67 7067 5f73 6967 6e61 7475 7265  ko_gpg_signature\n+00016550: 5f69 645f 6d61 7463 683a 2020 2020 2020  _id_match:      \n+00016560: 2020 2020 2020 5574 696c 6974 7920 4675        Utility Fu\n+00016570: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line\n+00016580: 2020 3534 290a 2a20 666b 6f5f 6d65 7373    54).* fko_mess\n+00016590: 6167 655f 7479 7065 5f74 3a20 2020 2020  age_type_t:     \n+000165a0: 2020 2020 2020 2020 2020 2020 2020 2053                 S\n+000165b0: 5041 204d 6573 7361 6765 732e 2020 2020  PA Messages.    \n+000165c0: 2020 2020 286c 696e 6520 2031 3129 0a2a      (line  11).*\n+000165d0: 2066 6b6f 5f6e 6577 3a20 2020 2020 2020   fko_new:       \n 000165e0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000165f0: 2020 2020 2020 2020 2020 4372 6561 7469            Creati\n-00016600: 6e67 2043 6f6e 7465 7874 732e 2020 2028  ng Contexts.   (\n-00016610: 6c69 6e65 2020 3135 290a 2a20 666b 6f5f  line  15).* fko_\n-00016620: 6e65 775f 7769 7468 5f64 6174 613a 2020  new_with_data:  \n+000165f0: 2020 2020 2020 2020 4372 6561 7469 6e67          Creating\n+00016600: 2043 6f6e 7465 7874 732e 2020 2028 6c69   Contexts.   (li\n+00016610: 6e65 2020 3135 290a 2a20 666b 6f5f 6e65  ne  15).* fko_ne\n+00016620: 775f 7769 7468 5f64 6174 613a 2020 2020  w_with_data:    \n 00016630: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00016640: 2020 2043 7265 6174 696e 6720 436f 6e74     Creating Cont\n-00016650: 6578 7473 2e20 2020 286c 696e 6520 2033  exts.   (line  3\n-00016660: 3829 0a2a 2066 6b6f 5f73 6574 5f67 7067  8).* fko_set_gpg\n-00016670: 5f65 7865 3a20 2020 2020 2020 2020 2020  _exe:           \n-00016680: 2020 2020 2020 2020 2020 2020 5365 7474              Sett\n-00016690: 696e 6720 5350 4120 4461 7461 2e20 2020  ing SPA Data.   \n-000166a0: 2028 6c69 6e65 2031 3436 290a 2a20 666b   (line 146).* fk\n-000166b0: 6f5f 7365 745f 6770 675f 686f 6d65 5f64  o_set_gpg_home_d\n-000166c0: 6972 3a20 2020 2020 2020 2020 2020 2020  ir:             \n-000166d0: 2020 2020 2053 6574 7469 6e67 2053 5041       Setting SPA\n-000166e0: 2044 6174 612e 2020 2020 286c 696e 6520   Data.    (line \n-000166f0: 3132 3629 0a2a 2066 6b6f 5f73 6574 5f67  126).* fko_set_g\n-00016700: 7067 5f69 676e 6f72 655f 7665 7269 6679  pg_ignore_verify\n-00016710: 5f65 7272 6f72 3a20 2020 2020 2020 5365  _error:       Se\n-00016720: 7474 696e 6720 5350 4120 4461 7461 2e20  tting SPA Data. \n-00016730: 2020 2028 6c69 6e65 2031 3339 290a 2a20     (line 139).* \n-00016740: 666b 6f5f 7365 745f 6770 675f 7265 6369  fko_set_gpg_reci\n-00016750: 7069 656e 743a 2020 2020 2020 2020 2020  pient:          \n-00016760: 2020 2020 2020 2053 6574 7469 6e67 2053         Setting S\n-00016770: 5041 2044 6174 612e 2020 2020 286c 696e  PA Data.    (lin\n-00016780: 6520 3131 3429 0a2a 2066 6b6f 5f73 6574  e 114).* fko_set\n-00016790: 5f67 7067 5f73 6967 6e61 7475 7265 5f76  _gpg_signature_v\n-000167a0: 6572 6966 793a 2020 2020 2020 2020 2020  erify:          \n-000167b0: 5365 7474 696e 6720 5350 4120 4461 7461  Setting SPA Data\n-000167c0: 2e20 2020 2028 6c69 6e65 2031 3331 290a  .    (line 131).\n-000167d0: 2a20 666b 6f5f 7365 745f 6770 675f 7369  * fko_set_gpg_si\n-000167e0: 676e 6572 3a20 2020 2020 2020 2020 2020  gner:           \n-000167f0: 2020 2020 2020 2020 2053 6574 7469 6e67           Setting\n-00016800: 2053 5041 2044 6174 612e 2020 2020 286c   SPA Data.    (l\n-00016810: 696e 6520 3132 3129 0a2a 2066 6b6f 5f73  ine 121).* fko_s\n-00016820: 6574 5f72 616e 645f 7661 6c75 653a 2020  et_rand_value:  \n+00016640: 2043 7265 6174 696e 6720 436f 6e74 6578   Creating Contex\n+00016650: 7473 2e20 2020 286c 696e 6520 2033 3829  ts.   (line  38)\n+00016660: 0a2a 2066 6b6f 5f73 6574 5f67 7067 5f65  .* fko_set_gpg_e\n+00016670: 7865 3a20 2020 2020 2020 2020 2020 2020  xe:             \n+00016680: 2020 2020 2020 2020 2020 5365 7474 696e            Settin\n+00016690: 6720 5350 4120 4461 7461 2e20 2020 2028  g SPA Data.    (\n+000166a0: 6c69 6e65 2031 3436 290a 2a20 666b 6f5f  line 146).* fko_\n+000166b0: 7365 745f 6770 675f 686f 6d65 5f64 6972  set_gpg_home_dir\n+000166c0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               \n+000166d0: 2020 2053 6574 7469 6e67 2053 5041 2044     Setting SPA D\n+000166e0: 6174 612e 2020 2020 286c 696e 6520 3132  ata.    (line 12\n+000166f0: 3629 0a2a 2066 6b6f 5f73 6574 5f67 7067  6).* fko_set_gpg\n+00016700: 5f69 676e 6f72 655f 7665 7269 6679 5f65  _ignore_verify_e\n+00016710: 7272 6f72 3a20 2020 2020 2020 5365 7474  rror:       Sett\n+00016720: 696e 6720 5350 4120 4461 7461 2e20 2020  ing SPA Data.   \n+00016730: 2028 6c69 6e65 2031 3339 290a 2a20 666b   (line 139).* fk\n+00016740: 6f5f 7365 745f 6770 675f 7265 6369 7069  o_set_gpg_recipi\n+00016750: 656e 743a 2020 2020 2020 2020 2020 2020  ent:            \n+00016760: 2020 2020 2053 6574 7469 6e67 2053 5041       Setting SPA\n+00016770: 2044 6174 612e 2020 2020 286c 696e 6520   Data.    (line \n+00016780: 3131 3429 0a2a 2066 6b6f 5f73 6574 5f67  114).* fko_set_g\n+00016790: 7067 5f73 6967 6e61 7475 7265 5f76 6572  pg_signature_ver\n+000167a0: 6966 793a 2020 2020 2020 2020 2020 5365  ify:          Se\n+000167b0: 7474 696e 6720 5350 4120 4461 7461 2e20  tting SPA Data. \n+000167c0: 2020 2028 6c69 6e65 2031 3331 290a 2a20     (line 131).* \n+000167d0: 666b 6f5f 7365 745f 6770 675f 7369 676e  fko_set_gpg_sign\n+000167e0: 6572 3a20 2020 2020 2020 2020 2020 2020  er:             \n+000167f0: 2020 2020 2020 2053 6574 7469 6e67 2053         Setting S\n+00016800: 5041 2044 6174 612e 2020 2020 286c 696e  PA Data.    (lin\n+00016810: 6520 3132 3129 0a2a 2066 6b6f 5f73 6574  e 121).* fko_set\n+00016820: 5f72 616e 645f 7661 6c75 653a 2020 2020  _rand_value:    \n 00016830: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00016840: 2020 5365 7474 696e 6720 5350 4120 4461    Setting SPA Da\n-00016850: 7461 2e20 2020 2028 6c69 6e65 2020 3334  ta.    (line  34\n-00016860: 290a 2a20 666b 6f5f 7365 745f 7370 615f  ).* fko_set_spa_\n-00016870: 636c 6965 6e74 5f74 696d 656f 7574 3a20  client_timeout: \n-00016880: 2020 2020 2020 2020 2020 2053 6574 7469             Setti\n-00016890: 6e67 2053 5041 2044 6174 612e 2020 2020  ng SPA Data.    \n-000168a0: 286c 696e 6520 2038 3029 0a2a 2066 6b6f  (line  80).* fko\n-000168b0: 5f73 6574 5f73 7061 5f64 6174 613a 2020  _set_spa_data:  \n+00016840: 5365 7474 696e 6720 5350 4120 4461 7461  Setting SPA Data\n+00016850: 2e20 2020 2028 6c69 6e65 2020 3334 290a  .    (line  34).\n+00016860: 2a20 666b 6f5f 7365 745f 7370 615f 636c  * fko_set_spa_cl\n+00016870: 6965 6e74 5f74 696d 656f 7574 3a20 2020  ient_timeout:   \n+00016880: 2020 2020 2020 2020 2053 6574 7469 6e67           Setting\n+00016890: 2053 5041 2044 6174 612e 2020 2020 286c   SPA Data.    (l\n+000168a0: 696e 6520 2038 3029 0a2a 2066 6b6f 5f73  ine  80).* fko_s\n+000168b0: 6574 5f73 7061 5f64 6174 613a 2020 2020  et_spa_data:    \n 000168c0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000168d0: 2020 2020 5365 7474 696e 6720 5350 4120      Setting SPA \n-000168e0: 4461 7461 2e20 2020 2028 6c69 6e65 2031  Data.    (line 1\n-000168f0: 3035 290a 2a20 666b 6f5f 7365 745f 7370  05).* fko_set_sp\n-00016900: 615f 6469 6765 7374 3a20 2020 2020 2020  a_digest:       \n-00016910: 2020 2020 2020 2020 2020 2020 2053 6574               Set\n-00016920: 7469 6e67 2053 5041 2044 6174 612e 2020  ting SPA Data.  \n-00016930: 2020 286c 696e 6520 2038 3929 0a2a 2066    (line  89).* f\n-00016940: 6b6f 5f73 6574 5f73 7061 5f64 6967 6573  ko_set_spa_diges\n-00016950: 745f 7479 7065 3a20 2020 2020 2020 2020  t_type:         \n-00016960: 2020 2020 2020 5365 7474 696e 6720 5350        Setting SP\n-00016970: 4120 4461 7461 2e20 2020 2028 6c69 6e65  A Data.    (line\n-00016980: 2020 3131 290a 2a20 666b 6f5f 7365 745f    11).* fko_set_\n-00016990: 7370 615f 656e 6372 7970 7469 6f6e 5f74  spa_encryption_t\n-000169a0: 7970 653a 2020 2020 2020 2020 2020 2053  ype:           S\n-000169b0: 6574 7469 6e67 2053 5041 2044 6174 612e  etting SPA Data.\n-000169c0: 2020 2020 286c 696e 6520 2032 3729 0a2a      (line  27).*\n-000169d0: 2066 6b6f 5f73 6574 5f73 7061 5f68 6d61   fko_set_spa_hma\n-000169e0: 633a 2020 2020 2020 2020 2020 2020 2020  c:              \n-000169f0: 2020 2020 2020 2020 5365 7474 696e 6720          Setting \n-00016a00: 5350 4120 4461 7461 2e20 2020 2028 6c69  SPA Data.    (li\n-00016a10: 6e65 2020 3937 290a 2a20 666b 6f5f 7365  ne  97).* fko_se\n-00016a20: 745f 7370 615f 686d 6163 5f74 7970 653a  t_spa_hmac_type:\n-00016a30: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00016a40: 2053 6574 7469 6e67 2053 5041 2044 6174   Setting SPA Dat\n-00016a50: 612e 2020 2020 286c 696e 6520 2031 3929  a.    (line  19)\n-00016a60: 0a2a 2066 6b6f 5f73 6574 5f73 7061 5f6d  .* fko_set_spa_m\n-00016a70: 6573 7361 6765 3a20 2020 2020 2020 2020  essage:         \n-00016a80: 2020 2020 2020 2020 2020 5365 7474 696e            Settin\n-00016a90: 6720 5350 4120 4461 7461 2e20 2020 2028  g SPA Data.    (\n-00016aa0: 6c69 6e65 2020 3633 290a 2a20 666b 6f5f  line  63).* fko_\n-00016ab0: 7365 745f 7370 615f 6d65 7373 6167 655f  set_spa_message_\n-00016ac0: 7479 7065 3a20 2020 2020 2020 2020 2020  type:           \n-00016ad0: 2020 2053 6574 7469 6e67 2053 5041 2044     Setting SPA D\n-00016ae0: 6174 612e 2020 2020 286c 696e 6520 2035  ata.    (line  5\n-00016af0: 3629 0a2a 2066 6b6f 5f73 6574 5f73 7061  6).* fko_set_spa\n-00016b00: 5f6e 6174 5f61 6363 6573 733a 2020 2020  _nat_access:    \n-00016b10: 2020 2020 2020 2020 2020 2020 5365 7474              Sett\n-00016b20: 696e 6720 5350 4120 4461 7461 2e20 2020  ing SPA Data.   \n-00016b30: 2028 6c69 6e65 2020 3639 290a 2a20 666b   (line  69).* fk\n-00016b40: 6f5f 7365 745f 7370 615f 7365 7276 6572  o_set_spa_server\n-00016b50: 5f61 7574 683a 2020 2020 2020 2020 2020  _auth:          \n-00016b60: 2020 2020 2053 6574 7469 6e67 2053 5041       Setting SPA\n-00016b70: 2044 6174 612e 2020 2020 286c 696e 6520   Data.    (line \n-00016b80: 2037 3529 0a2a 2066 6b6f 5f73 6574 5f74   75).* fko_set_t\n-00016b90: 696d 6573 7461 6d70 3a20 2020 2020 2020  imestamp:       \n-00016ba0: 2020 2020 2020 2020 2020 2020 2020 5365                Se\n-00016bb0: 7474 696e 6720 5350 4120 4461 7461 2e20  tting SPA Data. \n-00016bc0: 2020 2028 6c69 6e65 2020 3532 290a 2a20     (line  52).* \n-00016bd0: 666b 6f5f 7365 745f 7573 6572 6e61 6d65  fko_set_username\n-00016be0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               \n-00016bf0: 2020 2020 2020 2053 6574 7469 6e67 2053         Setting S\n-00016c00: 5041 2044 6174 612e 2020 2020 286c 696e  PA Data.    (lin\n-00016c10: 6520 2034 3229 0a2a 2066 6b6f 5f73 7061  e  42).* fko_spa\n-00016c20: 5f64 6174 615f 6669 6e61 6c3a 2020 2020  _data_final:    \n-00016c30: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00016c40: 5574 696c 6974 7920 4675 6e63 7469 6f6e  Utility Function\n-00016c50: 732e 2020 2028 6c69 6e65 2020 3136 290a  s.   (line  16).\n-00016c60: 2a20 7370 615f 6d65 7373 6167 655f 6669  * spa_message_fi\n-00016c70: 656c 6473 3a20 2020 2020 2020 2020 2020  elds:           \n-00016c80: 2020 2020 2020 2020 2053 5041 2044 6174           SPA Dat\n-00016c90: 6120 466f 726d 6174 2e20 2020 2020 286c  a Format.     (l\n-00016ca0: 696e 6520 2031 3229 0a0a 0a1f 0a54 6167  ine  12).....Tag\n-00016cb0: 2054 6162 6c65 3a0a 4e6f 6465 3a20 546f   Table:.Node: To\n-00016cc0: 707f 3131 3139 0a4e 6f64 653a 2049 6e74  p.1119.Node: Int\n-00016cd0: 726f 6475 6374 696f 6e7f 3433 3137 0a4e  roduction.4317.N\n-00016ce0: 6f64 653a 2047 6574 7469 6e67 2053 7461  ode: Getting Sta\n-00016cf0: 7274 6564 7f36 3032 370a 4e6f 6465 3a20  rted.6027.Node: \n-00016d00: 4665 6174 7572 6573 7f36 3632 330a 4e6f  Features.6623.No\n-00016d10: 6465 3a20 4f76 6572 7669 6577 7f37 3638  de: Overview.768\n-00016d20: 310a 4e6f 6465 3a20 5350 4120 4461 7461  1.Node: SPA Data\n-00016d30: 2046 6f72 6d61 747f 3837 3430 0a4e 6f64   Format.8740.Nod\n-00016d40: 653a 2050 7265 7061 7261 7469 6f6e 7f31  e: Preparation.1\n-00016d50: 3133 3736 0a4e 6f64 653a 206c 6962 666b  1376.Node: libfk\n-00016d60: 6f20 4865 6164 6572 7f31 3139 3336 0a4e  o Header.11936.N\n-00016d70: 6f64 653a 2043 6f6d 7069 6c69 6e67 2077  ode: Compiling w\n-00016d80: 6974 6820 6c69 6266 6b6f 7f31 3234 3739  ith libfko.12479\n-00016d90: 0a4e 6f64 653a 2053 5041 2050 6172 616d  .Node: SPA Param\n-00016da0: 6574 6572 2054 7970 6573 7f31 3335 3634  eter Types.13564\n-00016db0: 0a4e 6f64 653a 2044 6967 6573 7473 7f31  .Node: Digests.1\n-00016dc0: 3430 3736 0a4e 6f64 653a 2053 5041 204d  4076.Node: SPA M\n-00016dd0: 6573 7361 6765 737f 3135 3133 390a 4e6f  essages.15139.No\n-00016de0: 6465 3a20 456e 6372 7970 7469 6f6e 2041  de: Encryption A\n-00016df0: 6c67 6f72 6974 686d 737f 3137 3235 390a  lgorithms.17259.\n-00016e00: 4e6f 6465 3a20 484d 4143 2044 6967 6573  Node: HMAC Diges\n-00016e10: 7473 7f31 3833 3937 0a4e 6f64 653a 2055  ts.18397.Node: U\n-00016e20: 7369 6e67 206c 6962 666b 6f7f 3139 3239  sing libfko.1929\n-00016e30: 380a 4e6f 6465 3a20 4372 6561 7469 6e67  8.Node: Creating\n-00016e40: 2043 6f6e 7465 7874 737f 3230 3133 370a   Contexts.20137.\n-00016e50: 4e6f 6465 3a20 4465 7374 726f 7969 6e67  Node: Destroying\n-00016e60: 2043 6f6e 7465 7874 737f 3235 3132 340a   Contexts.25124.\n-00016e70: 4e6f 6465 3a20 4372 6561 7469 6e67 2061  Node: Creating a\n-00016e80: 2053 5041 204d 6573 7361 6765 7f32 3537   SPA Message.257\n-00016e90: 3435 0a4e 6f64 653a 2053 6574 7469 6e67  45.Node: Setting\n-00016ea0: 2053 5041 2044 6174 617f 3330 3537 390a   SPA Data.30579.\n-00016eb0: 4e6f 6465 3a20 5265 7472 6965 7669 6e67  Node: Retrieving\n-00016ec0: 2053 5041 2044 6174 617f 3338 3134 300a   SPA Data.38140.\n-00016ed0: 4e6f 6465 3a20 5574 696c 6974 7920 4675  Node: Utility Fu\n-00016ee0: 6e63 7469 6f6e 737f 3437 3132 330a 4e6f  nctions.47123.No\n-00016ef0: 6465 3a20 4572 726f 7220 4861 6e64 6c69  de: Error Handli\n-00016f00: 6e67 7f35 3035 3034 0a4e 6f64 653a 204c  ng.50504.Node: L\n-00016f10: 6962 7261 7279 2043 6f70 7969 6e67 7f36  ibrary Copying.6\n-00016f20: 3538 3530 0a4e 6f64 653a 2043 6f6e 6365  5850.Node: Conce\n-00016f30: 7074 2049 6e64 6578 7f38 3531 3432 0a4e  pt Index.85142.N\n-00016f40: 6f64 653a 2046 756e 6374 696f 6e20 616e  ode: Function an\n-00016f50: 6420 4461 7461 2049 6e64 6578 7f38 3833  d Data Index.883\n-00016f60: 3839 0a1f 0a45 6e64 2054 6167 2054 6162  89...End Tag Tab\n-00016f70: 6c65 0a0a 1f0a 4c6f 6361 6c20 5661 7269  le....Local Vari\n-00016f80: 6162 6c65 733a 0a63 6f64 696e 673a 2075  ables:.coding: u\n-00016f90: 7466 2d38 0a45 6e64 3a0a                 tf-8.End:.\n+000168d0: 2020 5365 7474 696e 6720 5350 4120 4461    Setting SPA Da\n+000168e0: 7461 2e20 2020 2028 6c69 6e65 2031 3035  ta.    (line 105\n+000168f0: 290a 2a20 666b 6f5f 7365 745f 7370 615f  ).* fko_set_spa_\n+00016900: 6469 6765 7374 3a20 2020 2020 2020 2020  digest:         \n+00016910: 2020 2020 2020 2020 2020 2053 6574 7469             Setti\n+00016920: 6e67 2053 5041 2044 6174 612e 2020 2020  ng SPA Data.    \n+00016930: 286c 696e 6520 2038 3929 0a2a 2066 6b6f  (line  89).* fko\n+00016940: 5f73 6574 5f73 7061 5f64 6967 6573 745f  _set_spa_digest_\n+00016950: 7479 7065 3a20 2020 2020 2020 2020 2020  type:           \n+00016960: 2020 2020 5365 7474 696e 6720 5350 4120      Setting SPA \n+00016970: 4461 7461 2e20 2020 2028 6c69 6e65 2020  Data.    (line  \n+00016980: 3131 290a 2a20 666b 6f5f 7365 745f 7370  11).* fko_set_sp\n+00016990: 615f 656e 6372 7970 7469 6f6e 5f74 7970  a_encryption_typ\n+000169a0: 653a 2020 2020 2020 2020 2020 2053 6574  e:           Set\n+000169b0: 7469 6e67 2053 5041 2044 6174 612e 2020  ting SPA Data.  \n+000169c0: 2020 286c 696e 6520 2032 3729 0a2a 2066    (line  27).* f\n+000169d0: 6b6f 5f73 6574 5f73 7061 5f68 6d61 633a  ko_set_spa_hmac:\n+000169e0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n+000169f0: 2020 2020 2020 5365 7474 696e 6720 5350        Setting SP\n+00016a00: 4120 4461 7461 2e20 2020 2028 6c69 6e65  A Data.    (line\n+00016a10: 2020 3937 290a 2a20 666b 6f5f 7365 745f    97).* fko_set_\n+00016a20: 7370 615f 686d 6163 5f74 7970 653a 2020  spa_hmac_type:  \n+00016a30: 2020 2020 2020 2020 2020 2020 2020 2053                 S\n+00016a40: 6574 7469 6e67 2053 5041 2044 6174 612e  etting SPA Data.\n+00016a50: 2020 2020 286c 696e 6520 2031 3929 0a2a      (line  19).*\n+00016a60: 2066 6b6f 5f73 6574 5f73 7061 5f6d 6573   fko_set_spa_mes\n+00016a70: 7361 6765 3a20 2020 2020 2020 2020 2020  sage:           \n+00016a80: 2020 2020 2020 2020 5365 7474 696e 6720          Setting \n+00016a90: 5350 4120 4461 7461 2e20 2020 2028 6c69  SPA Data.    (li\n+00016aa0: 6e65 2020 3633 290a 2a20 666b 6f5f 7365  ne  63).* fko_se\n+00016ab0: 745f 7370 615f 6d65 7373 6167 655f 7479  t_spa_message_ty\n+00016ac0: 7065 3a20 2020 2020 2020 2020 2020 2020  pe:             \n+00016ad0: 2053 6574 7469 6e67 2053 5041 2044 6174   Setting SPA Dat\n+00016ae0: 612e 2020 2020 286c 696e 6520 2035 3629  a.    (line  56)\n+00016af0: 0a2a 2066 6b6f 5f73 6574 5f73 7061 5f6e  .* fko_set_spa_n\n+00016b00: 6174 5f61 6363 6573 733a 2020 2020 2020  at_access:      \n+00016b10: 2020 2020 2020 2020 2020 5365 7474 696e            Settin\n+00016b20: 6720 5350 4120 4461 7461 2e20 2020 2028  g SPA Data.    (\n+00016b30: 6c69 6e65 2020 3639 290a 2a20 666b 6f5f  line  69).* fko_\n+00016b40: 7365 745f 7370 615f 7365 7276 6572 5f61  set_spa_server_a\n+00016b50: 7574 683a 2020 2020 2020 2020 2020 2020  uth:            \n+00016b60: 2020 2053 6574 7469 6e67 2053 5041 2044     Setting SPA D\n+00016b70: 6174 612e 2020 2020 286c 696e 6520 2037  ata.    (line  7\n+00016b80: 3529 0a2a 2066 6b6f 5f73 6574 5f74 696d  5).* fko_set_tim\n+00016b90: 6573 7461 6d70 3a20 2020 2020 2020 2020  estamp:         \n+00016ba0: 2020 2020 2020 2020 2020 2020 5365 7474              Sett\n+00016bb0: 696e 6720 5350 4120 4461 7461 2e20 2020  ing SPA Data.   \n+00016bc0: 2028 6c69 6e65 2020 3532 290a 2a20 666b   (line  52).* fk\n+00016bd0: 6f5f 7365 745f 7573 6572 6e61 6d65 3a20  o_set_username: \n+00016be0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n+00016bf0: 2020 2020 2053 6574 7469 6e67 2053 5041       Setting SPA\n+00016c00: 2044 6174 612e 2020 2020 286c 696e 6520   Data.    (line \n+00016c10: 2034 3229 0a2a 2066 6b6f 5f73 7061 5f64   42).* fko_spa_d\n+00016c20: 6174 615f 6669 6e61 6c3a 2020 2020 2020  ata_final:      \n+00016c30: 2020 2020 2020 2020 2020 2020 2020 5574                Ut\n+00016c40: 696c 6974 7920 4675 6e63 7469 6f6e 732e  ility Functions.\n+00016c50: 2020 2028 6c69 6e65 2020 3136 290a 2a20     (line  16).* \n+00016c60: 7370 615f 6d65 7373 6167 655f 6669 656c  spa_message_fiel\n+00016c70: 6473 3a20 2020 2020 2020 2020 2020 2020  ds:             \n+00016c80: 2020 2020 2020 2053 5041 2044 6174 6120         SPA Data \n+00016c90: 466f 726d 6174 2e20 2020 2020 286c 696e  Format.     (lin\n+00016ca0: 6520 2031 3229 0a0a 0a1f 0a54 6167 2054  e  12).....Tag T\n+00016cb0: 6162 6c65 3a0a 4e6f 6465 3a20 546f 707f  able:.Node: Top.\n+00016cc0: 3131 3138 0a4e 6f64 653a 2049 6e74 726f  1118.Node: Intro\n+00016cd0: 6475 6374 696f 6e7f 3433 3135 0a4e 6f64  duction.4315.Nod\n+00016ce0: 653a 2047 6574 7469 6e67 2053 7461 7274  e: Getting Start\n+00016cf0: 6564 7f36 3032 350a 4e6f 6465 3a20 4665  ed.6025.Node: Fe\n+00016d00: 6174 7572 6573 7f36 3632 310a 4e6f 6465  atures.6621.Node\n+00016d10: 3a20 4f76 6572 7669 6577 7f37 3637 390a  : Overview.7679.\n+00016d20: 4e6f 6465 3a20 5350 4120 4461 7461 2046  Node: SPA Data F\n+00016d30: 6f72 6d61 747f 3837 3338 0a4e 6f64 653a  ormat.8738.Node:\n+00016d40: 2050 7265 7061 7261 7469 6f6e 7f31 3133   Preparation.113\n+00016d50: 3734 0a4e 6f64 653a 206c 6962 666b 6f20  74.Node: libfko \n+00016d60: 4865 6164 6572 7f31 3139 3334 0a4e 6f64  Header.11934.Nod\n+00016d70: 653a 2043 6f6d 7069 6c69 6e67 2077 6974  e: Compiling wit\n+00016d80: 6820 6c69 6266 6b6f 7f31 3234 3737 0a4e  h libfko.12477.N\n+00016d90: 6f64 653a 2053 5041 2050 6172 616d 6574  ode: SPA Paramet\n+00016da0: 6572 2054 7970 6573 7f31 3335 3632 0a4e  er Types.13562.N\n+00016db0: 6f64 653a 2044 6967 6573 7473 7f31 3430  ode: Digests.140\n+00016dc0: 3734 0a4e 6f64 653a 2053 5041 204d 6573  74.Node: SPA Mes\n+00016dd0: 7361 6765 737f 3135 3133 370a 4e6f 6465  sages.15137.Node\n+00016de0: 3a20 456e 6372 7970 7469 6f6e 2041 6c67  : Encryption Alg\n+00016df0: 6f72 6974 686d 737f 3137 3235 370a 4e6f  orithms.17257.No\n+00016e00: 6465 3a20 484d 4143 2044 6967 6573 7473  de: HMAC Digests\n+00016e10: 7f31 3833 3935 0a4e 6f64 653a 2055 7369  .18395.Node: Usi\n+00016e20: 6e67 206c 6962 666b 6f7f 3139 3239 360a  ng libfko.19296.\n+00016e30: 4e6f 6465 3a20 4372 6561 7469 6e67 2043  Node: Creating C\n+00016e40: 6f6e 7465 7874 737f 3230 3133 350a 4e6f  ontexts.20135.No\n+00016e50: 6465 3a20 4465 7374 726f 7969 6e67 2043  de: Destroying C\n+00016e60: 6f6e 7465 7874 737f 3235 3132 320a 4e6f  ontexts.25122.No\n+00016e70: 6465 3a20 4372 6561 7469 6e67 2061 2053  de: Creating a S\n+00016e80: 5041 204d 6573 7361 6765 7f32 3537 3433  PA Message.25743\n+00016e90: 0a4e 6f64 653a 2053 6574 7469 6e67 2053  .Node: Setting S\n+00016ea0: 5041 2044 6174 617f 3330 3537 370a 4e6f  PA Data.30577.No\n+00016eb0: 6465 3a20 5265 7472 6965 7669 6e67 2053  de: Retrieving S\n+00016ec0: 5041 2044 6174 617f 3338 3133 380a 4e6f  PA Data.38138.No\n+00016ed0: 6465 3a20 5574 696c 6974 7920 4675 6e63  de: Utility Func\n+00016ee0: 7469 6f6e 737f 3437 3132 310a 4e6f 6465  tions.47121.Node\n+00016ef0: 3a20 4572 726f 7220 4861 6e64 6c69 6e67  : Error Handling\n+00016f00: 7f35 3035 3032 0a4e 6f64 653a 204c 6962  .50502.Node: Lib\n+00016f10: 7261 7279 2043 6f70 7969 6e67 7f36 3538  rary Copying.658\n+00016f20: 3438 0a4e 6f64 653a 2043 6f6e 6365 7074  48.Node: Concept\n+00016f30: 2049 6e64 6578 7f38 3531 3430 0a4e 6f64   Index.85140.Nod\n+00016f40: 653a 2046 756e 6374 696f 6e20 616e 6420  e: Function and \n+00016f50: 4461 7461 2049 6e64 6578 7f38 3833 3837  Data Index.88387\n+00016f60: 0a1f 0a45 6e64 2054 6167 2054 6162 6c65  ...End Tag Table\n+00016f70: 0a0a 1f0a 4c6f 6361 6c20 5661 7269 6162  ....Local Variab\n+00016f80: 6c65 733a 0a63 6f64 696e 673a 2075 7466  les:.coding: utf\n+00016f90: 2d38 0a45 6e64 3a0a                      -8.End:.\n"}]}]}]}]}]}