{"diffoscope-json-version": 1, "source1": "/srv/reproducible-results/rbuild-debian/r-b-build.JqbNhicv/b1/fwknop_2.6.10-16_i386.changes", "source2": "/srv/reproducible-results/rbuild-debian/r-b-build.JqbNhicv/b2/fwknop_2.6.10-16_i386.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  06b7e2cfa2f94b3f8ff1fd5e587aa25f 75320 debug optional fwknop-client-dbgsym_2.6.10-16_i386.deb\n  3b4cf461431826e73068af4d0a367ffe 73248 admin optional fwknop-client_2.6.10-16_i386.deb\n  9031c660260d3b0f2d13c8e708bb6f36 116160 debug optional fwknop-server-dbgsym_2.6.10-16_i386.deb\n  7182e7b901055b121bfb9de5778f67f4 106828 admin optional fwknop-server_2.6.10-16_i386.deb\n- 1a2bb128899bac60239c379399609839 49412 doc optional libfko-doc_2.6.10-16_all.deb\n+ 13e42f7ae17f81ec9029cf0644e15913 49400 doc optional libfko-doc_2.6.10-16_all.deb\n  c0b0faa5c3437cbab60ef84ed37acf56 59300 debug optional libfko-perl-dbgsym_2.6.10-16_i386.deb\n  e79a11b1a245cad0f360af8ff7f717e0 49808 perl optional libfko-perl_2.6.10-16_i386.deb\n  10fba27bd4e250da202dcd1f89c0f982 94160 debug optional libfko3-dbgsym_2.6.10-16_i386.deb\n- 9764921f3ac17e696da6cefc1dd79617 97572 libdevel optional libfko3-dev_2.6.10-16_i386.deb\n+ 87630f472831448e1bb467df73ff4ab1 97580 libdevel optional libfko3-dev_2.6.10-16_i386.deb\n  3abcee37d6199b50e58c0d68f2c0d4ed 64424 libs optional libfko3_2.6.10-16_i386.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     1744 2023-04-11 03:52:01.000000 control.tar.xz\n--rw-r--r--   0        0        0    47476 2023-04-11 03:52:01.000000 data.tar.xz\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    47468 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)     4546 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)    14795 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)     8990 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)     8947 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)     4102 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)     4653 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)     4849 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)    24840 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)     4377 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)    20451 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)     3593 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)     4550 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)     5235 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)    22664 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)     4204 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)     3570 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)    20031 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)     6886 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)     6031 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)     3484 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)    17274 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)     4016 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)     9250 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)     7166 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)     3818 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)     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 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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 20 February 2025).\n+2.6.10, last updated 18 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 20 February 2025).\n+(version 2.6.10, last updated 18 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_i386.deb", "source2": "libfko3-dev_2.6.10-16_i386.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     1140 2023-04-11 03:52:01.000000 control.tar.xz\n--rw-r--r--   0        0        0    96240 2023-04-11 03:52:01.000000 data.tar.xz\n+-rw-r--r--   0        0        0    96248 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)    23954 2023-04-11 03:52:01.000000 ./usr/share/info/libfko.info.gz\n+-rw-r--r--   0 root         (0) root         (0)    23961 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/i386-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 2032 3020 4665 6272 7561  pdated 20 Februa\n-000000b0: 7279 2032 3032 3529 2e0a 0a20 2020 436f  ry 2025)...   Co\n-000000c0: 7079 7269 6768 7420 2843 2920 3230 3039  pyright (C) 2009\n-000000d0: 2d32 3031 3320 4461 6d69 656e 2053 7475  -2013 Damien Stu\n-000000e0: 6172 742e 0a0a 2020 2020 2054 6865 206c  art...     The l\n-000000f0: 6962 666b 6f20 6d61 6e75 616c 2069 7320  ibfko manual is \n-00000100: 6672 6565 3b20 796f 7520 6361 6e20 7265  free; you can re\n-00000110: 6469 7374 7269 6275 7465 2069 7420 616e  distribute it an\n-00000120: 642f 6f72 206d 6f64 6966 7920 6974 0a20  d/or modify it. \n-00000130: 2020 2020 756e 6465 7220 7468 6520 7465      under the te\n-00000140: 726d 7320 6f66 2074 6865 2047 4e55 2047  rms of the GNU G\n-00000150: 656e 6572 616c 2050 7562 6c69 6320 4c69  eneral Public Li\n-00000160: 6365 6e73 6520 6173 2070 7562 6c69 7368  cense as publish\n-00000170: 6564 2062 790a 2020 2020 2074 6865 2046  ed by.     the F\n-00000180: 7265 6520 536f 6674 7761 7265 2046 6f75  ree Software Fou\n-00000190: 6e64 6174 696f 6e3b 2065 6974 6865 7220  ndation; either \n-000001a0: 7665 7273 696f 6e20 3220 6f66 2074 6865  version 2 of the\n-000001b0: 204c 6963 656e 7365 2c20 6f72 0a20 2020   License, or.   \n-000001c0: 2020 2861 7420 796f 7572 206f 7074 696f    (at your optio\n-000001d0: 6e29 2061 6e79 206c 6174 6572 2076 6572  n) any later ver\n-000001e0: 7369 6f6e 2e0a 0a20 2020 2020 5468 6520  sion...     The \n-000001f0: 6c69 6266 6b6f 206d 616e 7561 6c20 6973  libfko manual is\n-00000200: 2064 6973 7472 6962 7574 6564 2069 6e20   distributed in \n-00000210: 7468 6520 686f 7065 2074 6861 7420 6974  the hope that it\n-00000220: 2077 696c 6c20 6265 0a20 2020 2020 7573   will be.     us\n-00000230: 6566 756c 2c20 6275 7420 5749 5448 4f55  eful, but WITHOU\n-00000240: 5420 414e 5920 5741 5252 414e 5459 3b20  T ANY WARRANTY; \n-00000250: 7769 7468 6f75 7420 6576 656e 2074 6865  without even the\n-00000260: 2069 6d70 6c69 6564 2077 6172 7261 6e74   implied warrant\n-00000270: 790a 2020 2020 206f 6620 4d45 5243 4841  y.     of MERCHA\n-00000280: 4e54 4142 494c 4954 5920 6f72 2046 4954  NTABILITY or FIT\n-00000290: 4e45 5353 2046 4f52 2041 2050 4152 5449  NESS FOR A PARTI\n-000002a0: 4355 4c41 5220 5055 5250 4f53 452e 2053  CULAR PURPOSE. S\n-000002b0: 6565 2074 6865 2047 4e55 0a20 2020 2020  ee the GNU.     \n-000002c0: 4765 6e65 7261 6c20 5075 626c 6963 204c  General Public L\n-000002d0: 6963 656e 7365 2066 6f72 206d 6f72 6520  icense for more \n-000002e0: 6465 7461 696c 732e 0a0a 2020 2020 2059  details...     Y\n-000002f0: 6f75 2073 686f 756c 6420 6861 7665 2072  ou should have r\n-00000300: 6563 6569 7665 6420 6120 636f 7079 206f  eceived a copy o\n-00000310: 6620 7468 6520 474e 5520 4765 6e65 7261  f the GNU Genera\n-00000320: 6c20 5075 626c 6963 204c 6963 656e 7365  l Public License\n-00000330: 0a20 2020 2020 616c 6f6e 6720 7769 7468  .     along with\n-00000340: 2074 6869 7320 6d61 6e75 616c 3b20 6966   this manual; if\n-00000350: 206e 6f74 2c20 7772 6974 6520 746f 2074   not, write to t\n-00000360: 6865 2046 7265 6520 536f 6674 7761 7265  he Free Software\n-00000370: 0a20 2020 2020 466f 756e 6461 7469 6f6e  .     Foundation\n-00000380: 2c20 496e 632e 2c20 3531 2046 7261 6e6b  , Inc., 51 Frank\n-00000390: 6c69 6e20 5374 7265 6574 2c20 4669 6674  lin Street, Fift\n-000003a0: 6820 466c 6f6f 722c 2042 6f73 746f 6e2c  h Floor, Boston,\n-000003b0: 204d 410a 2020 2020 2030 3231 3130 2d31   MA.     02110-1\n-000003c0: 3330 3120 5553 410a 494e 464f 2d44 4952  301 USA.INFO-DIR\n-000003d0: 2d53 4543 5449 4f4e 204e 6574 776f 726b  -SECTION Network\n-000003e0: 2053 6563 7572 6974 790a 5354 4152 542d   Security.START-\n-000003f0: 494e 464f 2d44 4952 2d45 4e54 5259 0a2a  INFO-DIR-ENTRY.*\n-00000400: 206c 6962 666b 6f3a 2028 6c69 6266 6b6f   libfko: (libfko\n-00000410: 292e 2020 2020 5468 6520 4669 7265 5761  ).    The FireWa\n-00000420: 6c6c 204b 4e6f 636b 204f 5065 7261 746f  ll KNock OPerato\n-00000430: 7220 2866 776b 6e6f 7029 204c 6962 7261  r (fwknop) Libra\n-00000440: 7279 202d 206c 6962 666b 6f0a 454e 442d  ry - libfko.END-\n-00000450: 494e 464f 2d44 4952 2d45 4e54 5259 0a0a  INFO-DIR-ENTRY..\n-00000460: 1f0a 4669 6c65 3a20 6c69 6266 6b6f 2e69  ..File: libfko.i\n-00000470: 6e66 6f2c 2020 4e6f 6465 3a20 546f 702c  nfo,  Node: Top,\n-00000480: 2020 4e65 7874 3a20 496e 7472 6f64 7563    Next: Introduc\n-00000490: 7469 6f6e 2c20 2055 703a 2028 6469 7229  tion,  Up: (dir)\n-000004a0: 0a0a 4d61 696e 204d 656e 750a 2a2a 2a2a  ..Main Menu.****\n-000004b0: 2a2a 2a2a 2a0a 0a54 6869 7320 6d61 6e75  *****..This manu\n-000004c0: 616c 2069 7320 666f 7220 7468 6520 4669  al is for the Fi\n-000004d0: 7265 7761 6c6c 204b 6e6f 636b 204f 7065  rewall Knock Ope\n-000004e0: 7261 746f 7220 6c69 6272 6172 792c 206c  rator library, l\n-000004f0: 6962 666b 6f2e 0a28 7665 7273 696f 6e20  ibfko..(version \n-00000500: 322e 362e 3130 2c20 6c61 7374 2075 7064  2.6.10, last upd\n-00000510: 6174 6564 2032 3020 4665 6272 7561 7279  ated 20 February\n-00000520: 2032 3032 3529 2e0a 0a20 2020 436f 7079   2025)...   Copy\n-00000530: 7269 6768 7420 2843 2920 3230 3039 2d32  right (C) 2009-2\n-00000540: 3031 3320 4461 6d69 656e 2053 7475 6172  013 Damien Stuar\n-00000550: 742e 0a0a 2020 2020 2054 6865 206c 6962  t...     The lib\n-00000560: 666b 6f20 6d61 6e75 616c 2069 7320 6672  fko manual is fr\n-00000570: 6565 3b20 796f 7520 6361 6e20 7265 6469  ee; you can redi\n-00000580: 7374 7269 6275 7465 2069 7420 616e 642f  stribute it and/\n-00000590: 6f72 206d 6f64 6966 7920 6974 0a20 2020  or modify it.   \n-000005a0: 2020 756e 6465 7220 7468 6520 7465 726d    under the term\n-000005b0: 7320 6f66 2074 6865 2047 4e55 2047 656e  s of the GNU Gen\n-000005c0: 6572 616c 2050 7562 6c69 6320 4c69 6365  eral Public Lice\n-000005d0: 6e73 6520 6173 2070 7562 6c69 7368 6564  nse as published\n-000005e0: 2062 790a 2020 2020 2074 6865 2046 7265   by.     the Fre\n-000005f0: 6520 536f 6674 7761 7265 2046 6f75 6e64  e Software Found\n-00000600: 6174 696f 6e3b 2065 6974 6865 7220 7665  ation; either ve\n-00000610: 7273 696f 6e20 3220 6f66 2074 6865 204c  rsion 2 of the L\n-00000620: 6963 656e 7365 2c20 6f72 0a20 2020 2020  icense, or.     \n-00000630: 2861 7420 796f 7572 206f 7074 696f 6e29  (at your option)\n-00000640: 2061 6e79 206c 6174 6572 2076 6572 7369   any later versi\n-00000650: 6f6e 2e0a 0a20 2020 2020 5468 6520 6c69  on...     The li\n-00000660: 6266 6b6f 206d 616e 7561 6c20 6973 2064  bfko manual is d\n-00000670: 6973 7472 6962 7574 6564 2069 6e20 7468  istributed in th\n-00000680: 6520 686f 7065 2074 6861 7420 6974 2077  e hope that it w\n-00000690: 696c 6c20 6265 0a20 2020 2020 7573 6566  ill be.     usef\n-000006a0: 756c 2c20 6275 7420 5749 5448 4f55 5420  ul, but WITHOUT \n-000006b0: 414e 5920 5741 5252 414e 5459 3b20 7769  ANY WARRANTY; wi\n-000006c0: 7468 6f75 7420 6576 656e 2074 6865 2069  thout even the i\n-000006d0: 6d70 6c69 6564 2077 6172 7261 6e74 790a  mplied warranty.\n-000006e0: 2020 2020 206f 6620 4d45 5243 4841 4e54       of MERCHANT\n-000006f0: 4142 494c 4954 5920 6f72 2046 4954 4e45  ABILITY or FITNE\n-00000700: 5353 2046 4f52 2041 2050 4152 5449 4355  SS FOR A PARTICU\n-00000710: 4c41 5220 5055 5250 4f53 452e 2053 6565  LAR PURPOSE. See\n-00000720: 2074 6865 2047 4e55 0a20 2020 2020 4765   the GNU.     Ge\n-00000730: 6e65 7261 6c20 5075 626c 6963 204c 6963  neral Public Lic\n-00000740: 656e 7365 2066 6f72 206d 6f72 6520 6465  ense for more de\n-00000750: 7461 696c 732e 0a0a 2020 2020 2059 6f75  tails...     You\n-00000760: 2073 686f 756c 6420 6861 7665 2072 6563   should have rec\n-00000770: 6569 7665 6420 6120 636f 7079 206f 6620  eived a copy of \n-00000780: 7468 6520 474e 5520 4765 6e65 7261 6c20  the GNU General \n-00000790: 5075 626c 6963 204c 6963 656e 7365 0a20  Public License. \n-000007a0: 2020 2020 616c 6f6e 6720 7769 7468 2074      along with t\n-000007b0: 6869 7320 6d61 6e75 616c 3b20 6966 206e  his manual; if n\n-000007c0: 6f74 2c20 7772 6974 6520 746f 2074 6865  ot, write to the\n-000007d0: 2046 7265 6520 536f 6674 7761 7265 0a20   Free Software. \n-000007e0: 2020 2020 466f 756e 6461 7469 6f6e 2c20      Foundation, \n-000007f0: 496e 632e 2c20 3531 2046 7261 6e6b 6c69  Inc., 51 Frankli\n-00000800: 6e20 5374 7265 6574 2c20 4669 6674 6820  n Street, Fifth \n-00000810: 466c 6f6f 722c 2042 6f73 746f 6e2c 204d  Floor, Boston, M\n-00000820: 410a 2020 2020 2030 3231 3130 2d31 3330  A.     02110-130\n-00000830: 3120 5553 410a 0a2a 204d 656e 753a 0a0a  1 USA..* Menu:..\n-00000840: 2a20 496e 7472 6f64 7563 7469 6f6e 3a3a  * Introduction::\n+000000a0: 7064 6174 6564 2031 3820 4a61 6e75 6172  pdated 18 Januar\n+000000b0: 7920 3230 3234 292e 0a0a 2020 2043 6f70  y 2024)...   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 3138 204a 616e 7561 7279 2032  ted 18 January 2\n+00000520: 3032 3429 2e0a 0a20 2020 436f 7079 7269  024)...   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: 2020 486f 7720 746f 2075 7365 2074 6869    How to use thi\n-00000870: 7320 6d61 6e75 616c 0a2a 2050 7265 7061  s manual.* Prepa\n-00000880: 7261 7469 6f6e 3a3a 2020 2020 2020 2020  ration::        \n-00000890: 2020 2020 2020 2020 2020 2057 6861 7420             What \n-000008a0: 796f 7520 7368 6f75 6c64 2064 6f20 6265  you should do be\n-000008b0: 666f 7265 2075 7369 6e67 2074 6865 206c  fore using the l\n-000008c0: 6962 7261 7279 0a2a 2055 7369 6e67 206c  ibrary.* Using l\n-000008d0: 6962 666b 6f3a 3a20 2020 2020 2020 2020  ibfko::         \n-000008e0: 2020 2020 2020 2020 2048 6f77 2074 6f20           How to \n-000008f0: 7573 6520 6c69 6266 6b6f 2069 6e20 796f  use libfko in yo\n-00000900: 7572 2070 726f 6772 616d 0a0a 4170 7065  ur program..Appe\n-00000910: 6e64 6963 6573 0a0a 2a20 4c69 6272 6172  ndices..* Librar\n-00000920: 7920 436f 7079 696e 673a 3a20 2020 2020  y Copying::     \n-00000930: 2020 2020 2020 2020 2020 5468 6520 474e            The GN\n-00000940: 5520 4765 6e65 7261 6c20 5075 626c 6963  U General Public\n-00000950: 204c 6963 656e 7365 2073 6179 730a 2020   License says.  \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 00000960: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000970: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000980: 686f 7720 796f 7520 6361 6e20 636f 7079  how you can copy\n-00000990: 2061 6e64 2073 6861 7265 0a49 6e64 6963   and share.Indic\n-000009a0: 6573 0a0a 2a20 436f 6e63 6570 7420 496e  es..* Concept In\n-000009b0: 6465 783a 3a20 2020 2020 2020 2020 2020  dex::           \n-000009c0: 2020 2020 2020 496e 6465 7820 6f66 2063        Index of c\n-000009d0: 6f6e 6365 7074 7320 616e 6420 7072 6f67  oncepts and prog\n-000009e0: 7261 6d73 0a2a 2046 756e 6374 696f 6e20  rams.* Function \n-000009f0: 616e 6420 4461 7461 2049 6e64 6578 3a3a  and Data Index::\n-00000a00: 2020 2020 2020 2049 6e64 6578 206f 6620         Index of \n-00000a10: 6675 6e63 7469 6f6e 732c 2076 6172 6961  functions, varia\n-00000a20: 626c 6573 2061 6e64 2064 6174 6120 7479  bles and data ty\n-00000a30: 7065 730a 0a20 2d2d 2054 6865 2044 6574  pes.. -- The Det\n-00000a40: 6169 6c65 6420 4e6f 6465 204c 6973 7469  ailed Node Listi\n-00000a50: 6e67 202d 2d0a 0a49 6e74 726f 6475 6374  ng --..Introduct\n-00000a60: 696f 6e0a 0a2a 2047 6574 7469 6e67 2053  ion..* Getting S\n-00000a70: 7461 7274 6564 3a3a 2020 2020 2020 2020  tarted::        \n-00000a80: 2020 2020 2020 2050 7572 706f 7365 206f         Purpose o\n-00000a90: 6620 7468 6520 6d61 6e75 616c 2c20 616e  f the manual, an\n-00000aa0: 6420 686f 7720 746f 2075 7365 2069 740a  d how to use it.\n-00000ab0: 2a20 4665 6174 7572 6573 3a3a 2020 2020  * Features::    \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: 2020 5265 6173 6f6e 7320 746f 2069 6e73    Reasons to ins\n-00000ae0: 7461 6c6c 2061 6e64 2075 7365 206c 6962  tall and use lib\n-00000af0: 666b 6f0a 2a20 4f76 6572 7669 6577 3a3a  fko.* Overview::\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 00000b00: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000b10: 2020 2020 2020 4261 7369 6320 6f76 6572        Basic over\n-00000b20: 7669 6577 206f 6620 5350 4120 616e 640a  view of SPA and.\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 00000b30: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 00000b40: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000b50: 2020 6172 6368 6974 6563 7475 7265 206f    architecture o\n-00000b60: 6620 7468 6520 6c69 6266 6b6f 206c 6962  f the libfko lib\n-00000b70: 7261 7279 0a0a 4f76 6572 7669 6577 0a0a  rary..Overview..\n-00000b80: 2a20 5350 4120 4461 7461 2046 6f72 6d61  * SPA Data Forma\n-00000b90: 743a 3a20 2020 2020 2020 2020 2020 2020  t::             \n-00000ba0: 2020 4465 7363 7269 7074 696f 6e20 6f66    Description of\n-00000bb0: 2074 6865 2053 5041 2064 6174 610a 2020   the SPA data.  \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 00000bc0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000bd0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000be0: 666f 726d 6174 2e0a 0a50 7265 7061 7261  format...Prepara\n-00000bf0: 7469 6f6e 0a0a 2a20 6c69 6266 6b6f 2048  tion..* libfko H\n-00000c00: 6561 6465 723a 3a20 2020 2020 2020 2020  eader::         \n-00000c10: 2020 2020 2020 2020 5768 6174 2068 6561          What hea\n-00000c20: 6465 7220 6669 6c65 2079 6f75 206e 6565  der file you nee\n-00000c30: 6420 746f 2069 6e63 6c75 6465 0a2a 2043  d to include.* C\n-00000c40: 6f6d 7069 6c69 6e67 2077 6974 6820 6c69  ompiling with li\n-00000c50: 6266 6b6f 3a3a 2020 2020 2020 2020 2057  bfko::         W\n-00000c60: 6861 7420 796f 7520 6e65 6564 2074 6f20  hat you need to \n-00000c70: 636f 6d70 696c 6520 616e 6420 6c69 6e6b  compile and link\n-00000c80: 2079 6f75 720a 2020 2020 2020 2020 2020   your.          \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 00000c90: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000ca0: 2020 2020 2020 2020 7072 6f67 7261 6d20          program \n-00000cb0: 7769 7468 206c 6962 666b 6f0a 2a20 5350  with libfko.* SP\n-00000cc0: 4120 5061 7261 6d65 7465 7220 5479 7065  A Parameter Type\n-00000cd0: 733a 3a20 2020 2020 2020 2020 2020 5468  s::           Th\n-00000ce0: 6520 6176 6169 6c61 626c 6520 6469 6765  e available dige\n-00000cf0: 7374 732c 206d 6573 7361 6765 2074 7970  sts, message typ\n-00000d00: 6573 2061 6e64 0a20 2020 2020 2020 2020  es and.         \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 00000d10: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000d20: 2020 2020 2020 2020 206d 6f64 6573 206f           modes o\n-00000d30: 6620 656e 6372 7970 7469 6f6e 2066 6f72  f encryption for\n-00000d40: 2053 5041 2064 6174 610a 5573 696e 6720   SPA data.Using \n-00000d50: 6c69 6266 6b6f 0a0a 2a20 4372 6561 7469  libfko..* Creati\n-00000d60: 6e67 2043 6f6e 7465 7874 733a 3a20 2020  ng Contexts::   \n-00000d70: 2020 2020 2020 2020 2020 4372 6561 7469            Creati\n-00000d80: 6e67 2061 206e 6577 2066 6b6f 2063 6f6e  ng a new fko con\n-00000d90: 7465 7874 0a2a 2044 6573 7472 6f79 696e  text.* Destroyin\n-00000da0: 6720 436f 6e74 6578 7473 3a3a 2020 2020  g Contexts::    \n-00000db0: 2020 2020 2020 2052 656c 6561 7369 6e67         Releasing\n-00000dc0: 2061 6e20 666b 6f20 636f 6e74 6578 740a   an fko context.\n-00000dd0: 2a20 4372 6561 7469 6e67 2061 2053 5041  * Creating a SPA\n-00000de0: 204d 6573 7361 6765 3a3a 2020 2020 2020   Message::      \n-00000df0: 2020 5768 6174 2069 7420 7461 6b65 7320    What it takes \n-00000e00: 746f 2063 7265 6174 6520 6120 5350 410a  to create a SPA.\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 00000e10: 2020 2020 2020 2020 2020 2020 2020 2020                  \n 00000e20: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000e30: 2020 6d65 7373 6167 650a 2a20 5365 7474    message.* Sett\n-00000e40: 696e 6720 5350 4120 4461 7461 3a3a 2020  ing SPA Data::  \n-00000e50: 2020 2020 2020 2020 2020 2020 5365 7474              Sett\n-00000e60: 696e 6720 5350 4120 6461 7461 0a2a 2052  ing SPA data.* R\n-00000e70: 6574 7269 6576 696e 6720 5350 4120 4461  etrieving SPA Da\n-00000e80: 7461 3a3a 2020 2020 2020 2020 2020 2052  ta::           R\n-00000e90: 6574 7269 6576 696e 6720 5350 4120 6461  etrieving SPA da\n-00000ea0: 7461 0a2a 2055 7469 6c69 7479 2046 756e  ta.* Utility Fun\n-00000eb0: 6374 696f 6e73 3a3a 2020 2020 2020 2020  ctions::        \n-00000ec0: 2020 2020 204f 7468 6572 2075 7469 6c69       Other utili\n-00000ed0: 7479 2c20 6d69 7363 656c 6c61 6e65 6f75  ty, miscellaneou\n-00000ee0: 732c 2061 6e64 2073 656c 646f 6d0a 2020  s, and seldom.  \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 00000ef0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000f00: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00000f10: 7573 6564 2066 756e 6374 696f 6e73 0a2a  used functions.*\n-00000f20: 2045 7272 6f72 2048 616e 646c 696e 673a   Error Handling:\n-00000f30: 3a20 2020 2020 2020 2020 2020 2020 2020  :               \n-00000f40: 2050 6f73 7369 626c 6520 6572 726f 7273   Possible errors\n-00000f50: 2061 6e64 2074 6865 6972 206d 6561 6e69   and their meani\n-00000f60: 6e67 0a0a 5350 4120 5061 7261 6d65 7465  ng..SPA Paramete\n-00000f70: 7220 5479 7065 730a 0a2a 2044 6967 6573  r Types..* Diges\n-00000f80: 7473 3a3a 2020 2020 2020 2020 2020 2020  ts::            \n-00000f90: 2020 2020 2020 2020 2020 2054 6865 206d             The m\n-00000fa0: 6573 7361 6765 2064 6967 6573 7420 6861  essage digest ha\n-00000fb0: 7368 6573 2073 7570 706f 7274 6564 2062  shes supported b\n-00000fc0: 7920 6c69 6266 6b6f 0a2a 2053 5041 204d  y libfko.* SPA M\n-00000fd0: 6573 7361 6765 733a 3a20 2020 2020 2020  essages::       \n-00000fe0: 2020 2020 2020 2020 2020 2054 6865 2066             The f\n-00000ff0: 6b6f 2053 5041 206d 6573 7361 6765 2074  ko SPA message t\n-00001000: 7970 6573 0a20 2020 2020 2020 2020 2020  ypes.           \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 00001010: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00001020: 2020 2020 2020 2073 7570 706f 7274 6564         supported\n-00001030: 2062 7920 6c69 6266 6b6f 2028 616e 6420   by libfko (and \n-00001040: 6677 6b6e 6f70 290a 2a20 456e 6372 7970  fwknop).* Encryp\n-00001050: 7469 6f6e 2041 6c67 6f72 6974 686d 733a  tion Algorithms:\n-00001060: 3a20 2020 2020 2020 2020 456e 6372 7970  :         Encryp\n-00001070: 7469 6f6e 2073 6368 656d 6573 2073 7570  tion schemes sup\n-00001080: 706f 7274 6564 2062 7920 6c69 6266 6b6f  ported by libfko\n-00001090: 0a2a 2048 4d41 4320 4469 6765 7374 733a  .* HMAC Digests:\n-000010a0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               \n-000010b0: 2020 2044 6967 6573 7473 2074 6861 7420     Digests that \n-000010c0: 6361 6e20 6265 2075 7365 6420 746f 2062  can be used to b\n-000010d0: 7569 6c64 2061 6e20 484d 4143 0a0a 0a1f  uild an HMAC....\n-000010e0: 0a46 696c 653a 206c 6962 666b 6f2e 696e  .File: libfko.in\n-000010f0: 666f 2c20 204e 6f64 653a 2049 6e74 726f  fo,  Node: Intro\n-00001100: 6475 6374 696f 6e2c 2020 4e65 7874 3a20  duction,  Next: \n-00001110: 5072 6570 6172 6174 696f 6e2c 2020 5072  Preparation,  Pr\n-00001120: 6576 3a20 546f 702c 2020 5570 3a20 546f  ev: Top,  Up: To\n-00001130: 700a 0a31 2049 6e74 726f 6475 6374 696f  p..1 Introductio\n-00001140: 6e0a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  n.**************\n-00001150: 0a0a 5468 6520 2246 6972 6577 616c 6c20  ..The \"Firewall \n-00001160: 4b6e 6f63 6b20 4f70 6572 6174 6f72 204c  Knock Operator L\n-00001170: 6962 7261 7279 2220 286c 6962 666b 6f29  ibrary\" (libfko)\n-00001180: 2069 7320 6120 4320 6c61 6e67 7561 6765   is a C language\n-00001190: 206c 6962 7261 7279 0a74 6861 7420 696d   library.that im\n-000011a0: 706c 656d 656e 7473 2074 6865 2066 756e  plements the fun\n-000011b0: 6374 696f 6e73 206e 6565 6465 6420 746f  ctions needed to\n-000011c0: 2063 7265 6174 6520 616e 642f 6f72 2070   create and/or p\n-000011d0: 6172 7365 2022 5369 6e67 6c65 0a50 6163  arse \"Single.Pac\n-000011e0: 6b65 7420 4175 7468 6f72 697a 6174 696f  ket Authorizatio\n-000011f0: 6e22 2028 5350 4129 2064 6174 612e 2020  n\" (SPA) data.  \n-00001200: 4974 2069 7320 6465 7369 676e 6564 2074  It is designed t\n-00001210: 6f20 6162 7374 7261 6374 2074 6865 0a64  o abstract the.d\n-00001220: 6574 6169 6c73 206f 6620 656e 636f 6469  etails of encodi\n-00001230: 6e67 2c20 656e 6372 7970 7469 6f6e 2c20  ng, encryption, \n-00001240: 6465 636f 6469 6e67 2c20 7061 7273 696e  decoding, parsin\n-00001250: 672c 2061 6e64 2076 6572 6966 7969 6e67  g, and verifying\n-00001260: 2053 5041 0a6d 6573 7361 6765 7320 7375   SPA.messages su\n-00001270: 6368 2061 7320 7468 6f73 6520 7573 6564  ch as those used\n-00001280: 2062 7920 4d69 6368 6165 6c20 5261 7368   by Michael Rash\n-00001290: 2773 2022 4669 7265 7761 6c6c 204b 6e6f  's \"Firewall Kno\n-000012a0: 636b 204f 7065 7261 746f 7222 0a28 6677  ck Operator\".(fw\n-000012b0: 6b6e 6f70 292e 0a0a 2020 2022 6677 6b6e  knop)...   \"fwkn\n-000012c0: 6f70 2220 696d 706c 656d 656e 7473 2061  op\" implements a\n-000012d0: 6e20 6175 7468 6f72 697a 6174 696f 6e20  n authorization \n-000012e0: 7363 6865 6d65 206b 6e6f 776e 2061 7320  scheme known as \n-000012f0: 5369 6e67 6c65 2050 6163 6b65 740a 4175  Single Packet.Au\n-00001300: 7468 6f72 697a 6174 696f 6e20 2853 5041  thorization (SPA\n-00001310: 2920 666f 7220 7374 726f 6e67 2073 6572  ) for strong ser\n-00001320: 7669 6365 2070 726f 7465 6374 696f 6e2e  vice protection.\n-00001330: 2020 5350 4120 7265 7175 6972 6573 206f    SPA requires o\n-00001340: 6e6c 7920 610a 7369 6e67 6c65 2070 6163  nly a.single pac\n-00001350: 6b65 7420 7768 6963 6820 6973 2065 6e63  ket which is enc\n-00001360: 7279 7074 6564 2c20 6e6f 6e2d 7265 706c  rypted, non-repl\n-00001370: 6179 6162 6c65 2c20 616e 6420 6175 7468  ayable, and auth\n-00001380: 656e 7469 6361 7465 6420 7669 610a 616e  enticated via.an\n-00001390: 2048 4d41 4320 696e 206f 7264 6572 2074   HMAC in order t\n-000013a0: 6f20 636f 6d6d 756e 6963 6174 6520 6465  o communicate de\n-000013b0: 7369 7265 6420 6163 6365 7373 2074 6f20  sired access to \n-000013c0: 6120 7365 7276 6963 6520 7468 6174 2069  a service that i\n-000013d0: 730a 6869 6464 656e 2062 6568 696e 6420  s.hidden behind \n-000013e0: 6120 6669 7265 7761 6c6c 2069 6e20 6120  a firewall in a \n-000013f0: 6465 6661 756c 742d 6472 6f70 2066 696c  default-drop fil\n-00001400: 7465 7269 6e67 2073 7461 6e63 652e 2020  tering stance.  \n-00001410: 5468 6520 6d61 696e 0a61 7070 6c69 6361  The main.applica\n-00001420: 7469 6f6e 206f 6620 5350 4120 6973 2074  tion of SPA is t\n-00001430: 6f20 7573 6520 6120 6669 7265 7761 6c6c  o use a firewall\n-00001440: 2074 6f20 6472 6f70 2061 6c6c 2061 7474   to drop all att\n-00001450: 656d 7074 7320 746f 2063 6f6e 6e65 6374  empts to connect\n-00001460: 0a74 6f20 7365 7276 6963 6573 2073 7563  .to services suc\n-00001470: 6820 6173 2027 5353 4827 2069 6e20 6f72  h as 'SSH' in or\n-00001480: 6465 7220 746f 206d 616b 6520 7468 6520  der to make the \n-00001490: 6578 706c 6f69 7461 7469 6f6e 206f 660a  exploitation of.\n-000014a0: 7675 6c6e 6572 6162 696c 6974 6965 7320  vulnerabilities \n-000014b0: 2862 6f74 6820 302d 6461 7920 616e 6420  (both 0-day and \n-000014c0: 756e 7061 7463 6865 6420 636f 6465 2920  unpatched code) \n-000014d0: 6d6f 7265 2064 6966 6669 6375 6c74 2e20  more difficult. \n-000014e0: 2041 6e79 0a73 6572 7669 6365 2074 6861   Any.service tha\n-000014f0: 7420 6973 2070 726f 7465 6374 6564 2062  t is protected b\n-00001500: 7920 5350 4120 6e61 7475 7261 6c6c 7920  y SPA naturally \n-00001510: 6361 6e6e 6f74 2062 6520 7363 616e 6e65  cannot be scanne\n-00001520: 6420 666f 7220 7769 7468 0a27 4e6d 6170  d for with.'Nmap\n-00001530: 272e 2020 5468 6520 6677 6b6e 6f70 2070  '.  The fwknop p\n-00001540: 726f 6a65 6374 2073 7570 706f 7274 7320  roject supports \n-00001550: 7468 7265 6520 6469 6666 6572 656e 7420  three different \n-00001560: 6669 7265 7761 6c6c 733a 0a27 6970 7461  firewalls:.'ipta\n-00001570: 626c 6573 2720 6f6e 204c 696e 7578 2073  bles' on Linux s\n-00001580: 7973 7465 6d73 2c20 2770 6627 206f 6e20  ystems, 'pf' on \n-00001590: 4f70 656e 4253 442c 2061 6e64 2027 6970  OpenBSD, and 'ip\n-000015a0: 6677 2720 6f6e 2046 7265 6542 5344 2061  fw' on FreeBSD a\n-000015b0: 6e64 0a4d 6163 204f 5320 582e 0a0a 2020  nd.Mac OS X...  \n-000015c0: 206c 6962 666b 6f20 6973 206e 6f74 2061   libfko is not a\n-000015d0: 6e20 696d 706c 656d 656e 7461 7469 6f6e  n implementation\n-000015e0: 206f 6620 616e 2066 776b 6e6f 7020 636c   of an fwknop cl\n-000015f0: 6965 6e74 206f 7220 7365 7276 6572 2e20  ient or server. \n-00001600: 2049 740a 7369 6d70 6c79 2070 726f 7669   It.simply provi\n-00001610: 6465 7320 7468 6520 6675 6e63 7469 6f6e  des the function\n-00001620: 7320 666f 7220 6d61 6e61 6769 6e67 2074  s for managing t\n-00001630: 6865 2053 5041 2064 6174 6120 7573 6564  he SPA data used\n-00001640: 2062 7920 7468 6f73 650a 7072 6f67 7261   by those.progra\n-00001650: 6d73 2e0a 0a0a 466f 7220 6d6f 7265 2069  ms....For more i\n-00001660: 6e66 6f72 6d61 7469 6f6e 206f 6e20 6677  nformation on fw\n-00001670: 6b6e 6f70 2061 6e64 2053 5041 2c20 676f  knop and SPA, go\n-00001680: 2074 6f0a 3c68 7474 703a 2f2f 7777 772e   to.<http://www.\n-00001690: 6369 7068 6572 6479 6e65 2e6f 7267 2f66  cipherdyne.org/f\n-000016a0: 776b 6e6f 703e 2e0a 0a2a 204d 656e 753a  wknop>...* Menu:\n-000016b0: 0a0a 2a20 4765 7474 696e 6720 5374 6172  ..* Getting Star\n-000016c0: 7465 643a 3a20 2020 2020 2020 2020 2020  ted::           \n-000016d0: 2020 2020 5075 7270 6f73 6520 6f66 2074      Purpose of t\n-000016e0: 6865 206d 616e 7561 6c2c 2061 6e64 2068  he manual, and h\n-000016f0: 6f77 2074 6f20 7573 6520 6974 0a2a 2046  ow to use it.* F\n-00001700: 6561 7475 7265 733a 3a20 2020 2020 2020  eatures::       \n-00001710: 2020 2020 2020 2020 2020 2020 2020 2052                 R\n-00001720: 6561 736f 6e73 2074 6f20 696e 7374 616c  easons to instal\n-00001730: 6c20 616e 6420 7573 6520 6c69 6266 6b6f  l and use libfko\n-00001740: 0a2a 204f 7665 7276 6965 773a 3a20 2020  .* Overview::   \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: 2020 2042 6173 6963 2061 7263 6869 7465     Basic archite\n-00001770: 6374 7572 6520 6f66 2074 6865 206c 6962  cture of the lib\n-00001780: 666b 6f20 6c69 6272 6172 790a 0a1f 0a46  fko library....F\n-00001790: 696c 653a 206c 6962 666b 6f2e 696e 666f  ile: libfko.info\n-000017a0: 2c20 204e 6f64 653a 2047 6574 7469 6e67  ,  Node: Getting\n-000017b0: 2053 7461 7274 6564 2c20 204e 6578 743a   Started,  Next:\n-000017c0: 2046 6561 7475 7265 732c 2020 5570 3a20   Features,  Up: \n-000017d0: 496e 7472 6f64 7563 7469 6f6e 0a0a 312e  Introduction..1.\n-000017e0: 3120 4765 7474 696e 6720 5374 6172 7465  1 Getting Starte\n-000017f0: 640a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  d.==============\n-00001800: 3d3d 3d3d 3d0a 0a54 6869 7320 6d61 6e75  =====..This manu\n-00001810: 616c 2064 6f63 756d 656e 7473 2074 6865  al documents the\n-00001820: 2022 4669 7265 7761 6c6c 204b 6e6f 636b   \"Firewall Knock\n-00001830: 204f 7065 7261 746f 7222 206c 6962 7261   Operator\" libra\n-00001840: 7279 2070 726f 6772 616d 6d69 6e67 0a69  ry programming.i\n-00001850: 6e74 6572 6661 6365 2e20 2041 6c6c 2066  nterface.  All f\n-00001860: 756e 6374 696f 6e73 2061 6e64 2064 6174  unctions and dat\n-00001870: 6120 7479 7065 7320 7072 6f76 6964 6564  a types provided\n-00001880: 2062 7920 7468 6520 6c69 6272 6172 7920   by the library \n-00001890: 6172 650a 6578 706c 6169 6e65 642e 0a0a  are.explained...\n-000018a0: 2020 2054 6869 7320 6d61 6e75 616c 2063     This manual c\n-000018b0: 616e 2062 6520 7573 6564 2069 6e20 6120  an be used in a \n-000018c0: 636f 7570 6c65 206f 6620 7761 7973 2e20  couple of ways. \n-000018d0: 2049 6620 7265 6164 2066 726f 6d20 7468   If read from th\n-000018e0: 650a 6265 6769 6e6e 696e 6720 746f 2074  e.beginning to t\n-000018f0: 6865 2065 6e64 2c20 6974 2073 686f 756c  he end, it shoul\n-00001900: 6420 6769 7665 2061 2067 6f6f 6420 696e  d give a good in\n-00001910: 7472 6f64 7563 7469 6f6e 2069 6e74 6f20  troduction into \n-00001920: 7468 650a 6c69 6272 6172 7920 616e 6420  the.library and \n-00001930: 686f 7720 6974 2063 616e 2062 6520 7573  how it can be us\n-00001940: 6564 2069 6e20 616e 2061 7070 6c69 6361  ed in an applica\n-00001950: 7469 6f6e 2e20 204c 6174 6572 206f 6e2c  tion.  Later on,\n-00001960: 2074 6865 206d 616e 7561 6c0a 6361 6e20   the manual.can \n-00001970: 6265 2075 7365 6420 6173 2061 2072 6566  be used as a ref\n-00001980: 6572 656e 6365 206d 616e 7561 6c20 746f  erence manual to\n-00001990: 2067 6574 206a 7573 7420 7468 6520 696e   get just the in\n-000019a0: 666f 726d 6174 696f 6e20 6e65 6564 6564  formation needed\n-000019b0: 0a61 626f 7574 2061 6e79 2070 6172 7469  .about any parti\n-000019c0: 6375 6c61 7220 696e 7465 7266 6163 6520  cular interface \n-000019d0: 6f66 2074 6865 206c 6962 7261 7279 2e0a  of the library..\n-000019e0: 0a1f 0a46 696c 653a 206c 6962 666b 6f2e  ...File: libfko.\n-000019f0: 696e 666f 2c20 204e 6f64 653a 2046 6561  info,  Node: Fea\n-00001a00: 7475 7265 732c 2020 4e65 7874 3a20 4f76  tures,  Next: Ov\n-00001a10: 6572 7669 6577 2c20 2050 7265 763a 2047  erview,  Prev: G\n-00001a20: 6574 7469 6e67 2053 7461 7274 6564 2c20  etting Started, \n-00001a30: 2055 703a 2049 6e74 726f 6475 6374 696f   Up: Introductio\n-00001a40: 6e0a 0a31 2e32 2046 6561 7475 7265 730a  n..1.2 Features.\n-00001a50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468  ============..Th\n-00001a60: 6520 7072 696d 6172 7920 6164 7661 6e74  e primary advant\n-00001a70: 6167 6520 6f66 2075 7369 6e67 206c 6962  age of using lib\n-00001a80: 666b 6f20 6973 2069 7420 7072 6f76 6964  fko is it provid\n-00001a90: 6573 2061 2073 696e 676c 6520 4150 4920  es a single API \n-00001aa0: 666f 720a 6569 7468 6572 2063 7265 6174  for.either creat\n-00001ab0: 696e 6720 6f72 2070 6172 7369 6e67 2053  ing or parsing S\n-00001ac0: 5041 2064 6174 612e 2020 4164 6469 7469  PA data.  Additi\n-00001ad0: 6f6e 616c 2061 6476 616e 7461 6765 7320  onal advantages \n-00001ae0: 696e 636c 7564 653a 0a0a 4974 2773 2066  include:..It's f\n-00001af0: 7265 6520 736f 6674 7761 7265 0a20 2020  ree software.   \n-00001b00: 2020 416e 7962 6f64 7920 6361 6e20 7573    Anybody can us\n-00001b10: 652c 206d 6f64 6966 792c 2061 6e64 2072  e, modify, and r\n-00001b20: 6564 6973 7472 6962 7574 6520 6974 2075  edistribute it u\n-00001b30: 6e64 6572 2074 6865 2074 6572 6d73 206f  nder the terms o\n-00001b40: 6620 7468 650a 2020 2020 2047 4e55 2047  f the.     GNU G\n-00001b50: 656e 6572 616c 2050 7562 6c69 6320 4c69  eneral Public Li\n-00001b60: 6365 6e73 6520 7632 206f 7220 616e 7920  cense v2 or any \n-00001b70: 6c61 7465 7220 7665 7273 696f 6e20 282a  later version (*\n-00001b80: 6e6f 7465 204c 6962 7261 7279 0a20 2020  note Library.   \n-00001b90: 2020 436f 7079 696e 673a 3a29 2e0a 0a49    Copying::)...I\n-00001ba0: 7427 7320 6c69 6768 7477 6569 6768 740a  t's lightweight.\n-00001bb0: 2020 2020 2054 6865 2050 6572 6c2d 6261       The Perl-ba\n-00001bc0: 7365 6420 696d 706c 656d 656e 7461 7469  sed implementati\n-00001bd0: 6f6e 2072 6571 7569 7265 7320 7365 7665  on requires seve\n-00001be0: 7261 6c20 6164 6469 7469 6f6e 616c 2050  ral additional P\n-00001bf0: 6572 6c0a 2020 2020 206d 6f64 756c 6573  erl.     modules\n-00001c00: 2061 6e64 2068 6173 2061 2072 656c 6174   and has a relat\n-00001c10: 6976 656c 7920 6c61 7267 6520 666f 6f74  ively large foot\n-00001c20: 7072 696e 7420 696e 206d 656d 6f72 792e  print in memory.\n-00001c30: 2020 5468 6973 0a20 2020 2020 432d 6261    This.     C-ba\n-00001c40: 7365 6420 6c69 6272 6172 7920 656c 696d  sed library elim\n-00001c50: 696e 6174 6573 2074 686f 7365 2064 6570  inates those dep\n-00001c60: 656e 6465 6e63 6965 7320 616e 6420 6861  endencies and ha\n-00001c70: 7320 6120 6d75 6368 0a20 2020 2020 736d  s a much.     sm\n-00001c80: 616c 6c65 7220 666f 6f74 7072 696e 742e  aller footprint.\n-00001c90: 2020 5573 696e 6720 7468 6973 206c 6962    Using this lib\n-00001ca0: 7261 7279 2061 6c6c 6f77 7320 5350 4120  rary allows SPA \n-00001cb0: 746f 2065 6173 696c 790a 2020 2020 2066  to easily.     f\n-00001cc0: 756e 6374 696f 6e20 6f6e 2065 6d62 6564  unction on embed\n-00001cd0: 6465 6420 6f70 6572 6174 696e 6720 7379  ded operating sy\n-00001ce0: 7374 656d 7320 7375 6368 2061 7320 4f70  stems such as Op\n-00001cf0: 656e 5752 542e 0a0a 4974 2773 2065 6173  enWRT...It's eas\n-00001d00: 790a 2020 2020 206c 6962 666b 6f20 6869  y.     libfko hi\n-00001d10: 6465 7320 6d61 6e79 206f 6620 7468 6520  des many of the \n-00001d20: 676f 7279 2064 6574 6169 6c73 206f 6620  gory details of \n-00001d30: 6677 6b6e 6f70 2773 2053 5041 206d 6573  fwknop's SPA mes\n-00001d40: 7361 6765 2064 6174 610a 2020 2020 2066  sage data.     f\n-00001d50: 6f72 6d61 742c 2065 6e63 6f64 696e 672c  ormat, encoding,\n-00001d60: 2064 6563 6f64 696e 672c 2065 6e63 7279   decoding, encry\n-00001d70: 7074 696e 672c 2064 6563 7279 7074 696e  pting, decryptin\n-00001d80: 672c 2061 7574 6865 6e74 6963 6174 696e  g, authenticatin\n-00001d90: 672c 0a20 2020 2020 616e 6420 7061 7273  g,.     and pars\n-00001da0: 696e 672e 2020 496e 206d 6f73 7420 6361  ing.  In most ca\n-00001db0: 7365 732c 206f 6e6c 7920 6120 6665 7720  ses, only a few \n-00001dc0: 6675 6e63 7469 6f6e 2063 616c 6c73 2077  function calls w\n-00001dd0: 696c 6c20 6265 0a20 2020 2020 6e65 6564  ill be.     need\n-00001de0: 6564 2063 7265 6174 6520 6f72 2070 6172  ed create or par\n-00001df0: 7365 2061 2053 5041 206d 6573 7361 6765  se a SPA message\n-00001e00: 2e0a 0a1f 0a46 696c 653a 206c 6962 666b  .....File: libfk\n-00001e10: 6f2e 696e 666f 2c20 204e 6f64 653a 204f  o.info,  Node: O\n-00001e20: 7665 7276 6965 772c 2020 5072 6576 3a20  verview,  Prev: \n-00001e30: 4665 6174 7572 6573 2c20 2055 703a 2049  Features,  Up: I\n-00001e40: 6e74 726f 6475 6374 696f 6e0a 0a31 2e33  ntroduction..1.3\n-00001e50: 204f 7665 7276 6965 770a 3d3d 3d3d 3d3d   Overview.======\n-00001e60: 3d3d 3d3d 3d3d 0a0a 2a20 4d65 6e75 3a0a  ======..* Menu:.\n-00001e70: 0a2a 2053 5041 2044 6174 6120 466f 726d  .* SPA Data Form\n-00001e80: 6174 3a3a 2020 2020 2020 2020 2020 2020  at::            \n-00001e90: 2020 2044 6573 6372 6970 7469 6f6e 206f     Description o\n-00001ea0: 6620 7468 6520 5350 4120 6461 7461 0a20  f the SPA data. \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+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 00001eb0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00001ec0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00001ed0: 2066 6f72 6d61 742e 0a0a 6c69 6266 6b6f   format...libfko\n-00001ee0: 2066 756e 6374 696f 6e61 6c69 7479 2063   functionality c\n-00001ef0: 616e 2062 6520 6469 7669 6465 6420 696e  an be divided in\n-00001f00: 746f 2074 776f 2072 6f6c 6573 2e20 204f  to two roles.  O\n-00001f10: 6e65 2069 7320 7468 6520 6372 6561 7469  ne is the creati\n-00001f20: 6f6e 0a6f 6620 616e 2065 6e63 7279 7074  on.of an encrypt\n-00001f30: 6564 2053 5041 206d 6573 7361 6765 2074  ed SPA message t\n-00001f40: 6f67 6574 6865 7220 7769 7468 2061 6e20  ogether with an \n-00001f50: 484d 4143 2066 6f72 2061 7574 6865 6e74  HMAC for authent\n-00001f60: 6963 6174 696f 6e2e 0a54 6865 206f 7468  ication..The oth\n-00001f70: 6572 2069 7320 7468 6520 7461 6b69 6e67  er is the taking\n-00001f80: 2061 6e20 656e 6372 7970 7465 6420 5350   an encrypted SP\n-00001f90: 4120 6d65 7373 6167 6520 746f 2061 7574  A message to aut\n-00001fa0: 6865 6e74 6963 6174 652c 0a64 6563 6f64  henticate,.decod\n-00001fb0: 652c 2070 6172 7365 2c20 616e 6420 6578  e, parse, and ex\n-00001fc0: 7472 6163 7420 7468 6520 6f72 6967 696e  tract the origin\n-00001fd0: 616c 2064 6174 612e 0a0a 2020 2054 6865  al data...   The\n-00001fe0: 2061 6374 7561 6c20 5350 4120 6461 7461   actual SPA data\n-00001ff0: 2068 616e 646c 696e 6720 616e 6420 6f70   handling and op\n-00002000: 6572 6174 696f 6e73 2061 7265 2073 6574  erations are set\n-00002010: 2077 6974 6869 6e20 6120 636f 6e74 6578   within a contex\n-00002020: 742e 0a54 6865 2063 6f6e 7465 7874 2072  t..The context r\n-00002030: 6570 7265 7365 6e74 7320 6120 7369 6e67  epresents a sing\n-00002040: 6c65 2053 5041 206d 6573 7361 6765 2061  le SPA message a\n-00002050: 6e64 2070 726f 7669 6465 7320 636f 6e66  nd provides conf\n-00002060: 6967 7572 6174 696f 6e0a 7061 7261 6d65  iguration.parame\n-00002070: 7465 7273 2061 6e64 2064 6174 6120 7365  ters and data se\n-00002080: 7474 696e 6773 2066 6f72 2064 6566 696e  ttings for defin\n-00002090: 696e 6720 7468 6174 206d 6573 7361 6765  ing that message\n-000020a0: 2e20 2041 6c6c 206f 7065 7261 7469 6f6e  .  All operation\n-000020b0: 730a 6f6e 2074 6865 2064 6174 6120 6f63  s.on the data oc\n-000020c0: 6375 7220 7769 7468 696e 2074 6861 7420  cur within that \n-000020d0: 636f 6e74 6578 742e 0a0a 2020 2053 6f6d  context...   Som\n-000020e0: 6520 6f70 6572 6174 696f 6e73 206f 6e20  e operations on \n-000020f0: 7468 6520 636f 6e74 6578 7420 6d75 7374  the context must\n-00002100: 206f 6363 7572 2062 6566 6f72 6520 6f74   occur before ot\n-00002110: 6865 7273 2e20 2044 6574 6169 6c73 206f  hers.  Details o\n-00002120: 660a 7468 6573 6520 6465 7065 6e64 656e  f.these dependen\n-00002130: 6369 6573 2061 7265 2063 6f76 6572 6564  cies are covered\n-00002140: 2069 6e20 2a6e 6f74 6520 4372 6561 7469   in *note Creati\n-00002150: 6e67 2061 2053 5041 204d 6573 7361 6765  ng a SPA Message\n-00002160: 3a3a 2e0a 0a57 6974 6820 6c69 6266 6b6f  ::...With libfko\n-00002170: 2c20 776f 726b 696e 6720 7769 7468 2053  , working with S\n-00002180: 5041 206d 6573 7361 6765 2064 6174 6120  PA message data \n-00002190: 6261 7369 6361 6c6c 7920 636f 6e73 6973  basically consis\n-000021a0: 7473 206f 6620 7468 650a 666f 6c6c 6f77  ts of the.follow\n-000021b0: 696e 6720 7374 6570 7320 696e 206f 7264  ing steps in ord\n-000021c0: 6572 3a0a 0a20 2020 2a20 4372 6561 7465  er:..   * Create\n-000021d0: 2061 206e 6577 2063 6f6e 7465 7874 0a20   a new context. \n-000021e0: 2020 2a20 576f 726b 2077 6974 6820 2867    * Work with (g\n-000021f0: 6574 2f73 6574 2920 7468 6520 5350 4120  et/set) the SPA \n-00002200: 6461 7461 2066 6965 6c64 730a 2020 202a  data fields.   *\n-00002210: 2044 6573 7472 6f79 2074 6865 2063 6f6e   Destroy the con\n-00002220: 7465 7874 0a0a 1f0a 4669 6c65 3a20 6c69  text....File: li\n-00002230: 6266 6b6f 2e69 6e66 6f2c 2020 4e6f 6465  bfko.info,  Node\n-00002240: 3a20 5350 4120 4461 7461 2046 6f72 6d61  : SPA Data Forma\n-00002250: 742c 2020 5570 3a20 4f76 6572 7669 6577  t,  Up: Overview\n-00002260: 0a0a 312e 332e 3120 5350 4120 4461 7461  ..1.3.1 SPA Data\n-00002270: 2046 6f72 6d61 740a 2d2d 2d2d 2d2d 2d2d   Format.--------\n-00002280: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54  -------------..T\n-00002290: 6865 2066 6f72 6d61 7420 6f66 2074 6865  he format of the\n-000022a0: 2053 5041 206d 6573 7361 6765 2064 6174   SPA message dat\n-000022b0: 6120 7573 6564 2062 7920 6677 6b6e 6f70  a used by fwknop\n-000022c0: 2028 6265 666f 7265 2065 6e63 7279 7074   (before encrypt\n-000022d0: 696f 6e20 616e 640a 6265 666f 7265 2061  ion and.before a\n-000022e0: 6e20 484d 4143 2069 7320 6170 706c 6965  n HMAC is applie\n-000022f0: 6429 2069 7320 6120 636f 6c6f 6e2d 6465  d) is a colon-de\n-00002300: 6c69 6d69 7465 6420 7374 7269 6e67 2063  limited string c\n-00002310: 6f6e 7461 696e 696e 6720 7468 650a 696e  ontaining the.in\n-00002320: 6469 7669 6475 616c 2053 5041 2064 6174  dividual SPA dat\n-00002330: 6120 6669 656c 6473 2e20 2053 6f6d 6520  a fields.  Some \n-00002340: 6f66 2074 6865 7365 2066 6965 6c64 7320  of these fields \n-00002350: 6172 6520 6261 7365 3634 2d65 6e63 6f64  are base64-encod\n-00002360: 6564 2069 6e0a 7468 6520 6669 6e61 6c20  ed in.the final \n-00002370: 656e 636f 6469 6e67 2070 726f 6365 7373  encoding process\n-00002380: 2061 7320 6469 6374 6174 6564 2062 7920   as dictated by \n-00002390: 7468 6520 6375 7272 656e 7420 6677 6b6e  the current fwkn\n-000023a0: 6f70 0a69 6d70 6c65 6d65 6e74 6174 696f  op.implementatio\n-000023b0: 6e2e 0a0a 202d 2d20 5661 7269 6162 6c65  n... -- Variable\n-000023c0: 3a20 6461 7461 2073 7061 5f6d 6573 7361  : data spa_messa\n-000023d0: 6765 5f66 6965 6c64 730a 2020 2020 2055  ge_fields.     U\n-000023e0: 7369 6e67 2074 6865 206c 6962 666b 6f20  sing the libfko \n-000023f0: 6e61 6d65 7320 666f 7220 7468 6520 6461  names for the da\n-00002400: 7461 2066 6965 6c64 732c 2074 6865 206c  ta fields, the l\n-00002410: 6973 7420 6f66 2074 6865 7365 0a20 2020  ist of these.   \n-00002420: 2020 6669 656c 6473 2028 696e 206f 7264    fields (in ord\n-00002430: 6572 2920 666f 6c6c 6f77 733a 0a20 2020  er) follows:.   \n-00002440: 2020 272a 7261 6e64 5f76 616c 7565 2a20    '*rand_value* \n-00002450: 2d20 5f44 6566 6175 6c74 3a20 5261 6e64  - _Default: Rand\n-00002460: 6f6d 2028 6372 6561 7465 6420 7570 6f6e  om (created upon\n-00002470: 2063 6f6e 7465 7874 2063 7265 6174 696f   context creatio\n-00002480: 6e29 5f27 0a20 2020 2020 2020 2020 2041  n)_'.          A\n-00002490: 2031 362d 6279 7465 2072 616e 646f 6d20   16-byte random \n-000024a0: 6e75 6d65 7269 6320 7374 7269 6e67 2e0a  numeric string..\n-000024b0: 2020 2020 2027 2a75 7365 726e 616d 652a       '*username*\n-000024c0: 202d 205f 4465 6661 756c 743a 2043 7572   - _Default: Cur\n-000024d0: 7265 6e74 206c 6f67 696e 2075 7365 7220  rent login user \n-000024e0: 6f72 2056 616c 7565 206f 6620 5350 4f4f  or Value of SPOO\n-000024f0: 465f 5553 4552 2065 6e76 2076 6172 5f27  F_USER env var_'\n-00002500: 0a20 2020 2020 2020 2020 2054 6865 2062  .          The b\n-00002510: 6173 6536 342d 656e 636f 6465 6420 7573  ase64-encoded us\n-00002520: 6572 6e61 6d65 2061 7373 6f63 6961 7465  ername associate\n-00002530: 6420 7769 7468 2074 6869 7320 5350 4120  d with this SPA \n-00002540: 6461 7461 2e0a 2020 2020 2027 2a74 696d  data..     '*tim\n-00002550: 6573 7461 6d70 2a20 2d20 5f44 6566 6175  estamp* - _Defau\n-00002560: 6c74 3a20 5468 6520 556e 6978 2074 696d  lt: The Unix tim\n-00002570: 6520 6174 2063 7265 6174 696f 6e5f 270a  e at creation_'.\n-00002580: 2020 2020 2020 2020 2020 5468 6520 556e            The Un\n-00002590: 6978 2074 696d 6573 7461 6d70 2076 616c  ix timestamp val\n-000025a0: 7565 2e0a 2020 2020 2027 2a76 6572 7369  ue..     '*versi\n-000025b0: 6f6e 2a20 2d20 5f44 6566 6175 6c74 3a20  on* - _Default: \n-000025c0: 7468 6520 6375 7272 656e 7420 6677 6b6e  the current fwkn\n-000025d0: 6f70 2076 6572 7369 6f6e 5f27 0a20 2020  op version_'.   \n-000025e0: 2020 2020 2020 2054 6865 2063 7572 7265         The curre\n-000025f0: 6e74 2066 776b 6e6f 7020 7665 7273 696f  nt fwknop versio\n-00002600: 6e20 7468 6174 2073 7570 706f 7274 7320  n that supports \n-00002610: 7468 6973 2066 6f72 6d61 742e 2020 5468  this format.  Th\n-00002620: 6973 0a20 2020 2020 2020 2020 2066 6965  is.          fie\n-00002630: 6c64 2069 7320 6e6f 7420 7573 6572 2073  ld is not user s\n-00002640: 6574 7461 626c 652e 0a20 2020 2020 272a  ettable..     '*\n-00002650: 7370 615f 6d65 7373 6167 655f 7479 7065  spa_message_type\n-00002660: 2a20 2d20 5f44 6566 6175 6c74 3a20 5350  * - _Default: SP\n-00002670: 4120 6163 6365 7373 206d 6573 7361 6765  A access message\n-00002680: 2028 464b 4f5f 4143 4345 5353 5f4d 5347   (FKO_ACCESS_MSG\n-00002690: 295f 270a 2020 2020 2020 2020 2020 5468  )_'.          Th\n-000026a0: 6520 5350 4120 6d65 7373 6167 6520 7479  e SPA message ty\n-000026b0: 7065 2076 616c 7565 2066 6f72 2074 6869  pe value for thi\n-000026c0: 7320 6d65 7373 6167 652e 0a20 2020 2020  s message..     \n-000026d0: 272a 7370 615f 6d65 7373 6167 652a 270a  '*spa_message*'.\n-000026e0: 2020 2020 2020 2020 2020 5468 6520 6261            The ba\n-000026f0: 7365 3634 2d65 6e63 6f64 6564 2053 5041  se64-encoded SPA\n-00002700: 206d 6573 7361 6765 2069 7473 656c 6620   message itself \n-00002710: 2861 6e20 6163 6365 7373 2072 6571 7565  (an access reque\n-00002720: 7374 206f 720a 2020 2020 2020 2020 2020  st or.          \n-00002730: 636f 6d6d 616e 6420 7374 7269 6e67 292e  command string).\n-00002740: 0a20 2020 2020 272a 7370 615f 6e61 745f  .     '*spa_nat_\n-00002750: 6163 6365 7373 2a27 0a20 2020 2020 2020  access*'.       \n-00002760: 2020 2041 6e20 6f70 7469 6f6e 616c 2062     An optional b\n-00002770: 6173 6536 342d 656e 636f 6465 6420 7265  ase64-encoded re\n-00002780: 7175 6573 7420 666f 7220 4e41 5420 6163  quest for NAT ac\n-00002790: 6365 7373 2e0a 2020 2020 2027 2a73 7061  cess..     '*spa\n-000027a0: 5f73 6572 7665 725f 6175 7468 2a27 0a20  _server_auth*'. \n-000027b0: 2020 2020 2020 2020 2041 6e20 6f70 7469           An opti\n-000027c0: 6f6e 616c 2062 6173 6536 342d 656e 636f  onal base64-enco\n-000027d0: 6465 6420 7374 7269 6e67 2074 6861 7420  ded string that \n-000027e0: 6361 6e20 6265 2075 7365 6420 6173 2061  can be used as a\n-000027f0: 6e0a 2020 2020 2020 2020 2020 6164 6469  n.          addi\n-00002800: 7469 6f6e 616c 2061 7574 6865 6e74 6963  tional authentic\n-00002810: 6174 696f 6e20 6d65 6368 616e 6973 6d20  ation mechanism \n-00002820: 6174 2074 6865 2066 776b 6e6f 7020 7365  at the fwknop se\n-00002830: 7276 6572 2e0a 2020 2020 2027 2a73 7061  rver..     '*spa\n-00002840: 5f63 6c69 656e 745f 7469 6d65 6f75 742a  _client_timeout*\n-00002850: 270a 2020 2020 2020 2020 2020 416e 206f  '.          An o\n-00002860: 7074 696f 6e61 6c20 636c 6965 6e74 2074  ptional client t\n-00002870: 696d 656f 7574 2076 616c 7565 2074 6861  imeout value tha\n-00002880: 7420 6361 6e20 6265 2073 7570 706c 6965  t can be supplie\n-00002890: 6420 746f 2074 6865 0a20 2020 2020 2020  d to the.       \n-000028a0: 2020 2066 776b 6e6f 7020 7365 7276 6572     fwknop server\n-000028b0: 2e0a 2020 2020 2027 2a73 7061 5f64 6967  ..     '*spa_dig\n-000028c0: 6573 742a 202d 205f 436f 6d70 7574 6564  est* - _Computed\n-000028d0: 2076 616c 7565 5f27 0a20 2020 2020 2020   value_'.       \n-000028e0: 2020 2054 6865 2064 6967 6573 7420 6f66     The digest of\n-000028f0: 2074 6865 2070 7265 7669 6f75 7320 6669   the previous fi\n-00002900: 656c 6473 2028 696e 636c 7564 696e 6720  elds (including \n-00002910: 7468 6520 6465 6c69 6d69 7465 7273 292e  the delimiters).\n-00002920: 0a0a 2020 2057 6974 6820 616c 6c20 6669  ..   With all fi\n-00002930: 656c 6473 2064 6566 696e 6564 2c20 6120  elds defined, a \n-00002940: 636f 6d70 6c65 7465 2028 756e 656e 636f  complete (unenco\n-00002950: 6465 6429 2053 5041 206d 6573 7361 6765  ded) SPA message\n-00002960: 2077 6f75 6c64 0a6c 6f6f 6b20 736f 6d65   would.look some\n-00002970: 7468 696e 6720 6c69 6b65 2074 6865 2066  thing like the f\n-00002980: 6f6c 6c6f 7769 6e67 2065 7861 6d70 6c65  ollowing example\n-00002990: 2028 4e6f 7465 3a20 5468 6520 6c69 6e65   (Note: The line\n-000029a0: 2069 7320 6272 6f6b 656e 2066 6f72 0a72   is broken for.r\n-000029b0: 6561 6461 6269 6c69 7479 2061 6e64 2074  eadability and t\n-000029c0: 6865 2075 7365 726e 616d 652c 206d 6573  he username, mes\n-000029d0: 7361 6765 2c20 6e61 745f 6163 6365 7373  sage, nat_access\n-000029e0: 2c20 616e 6420 7365 7276 6572 5f61 7574  , and server_aut\n-000029f0: 680a 6669 656c 6473 2061 7265 206e 6f74  h.fields are not\n-00002a00: 2062 6173 6536 342d 656e 636f 6465 6429   base64-encoded)\n-00002a10: 3a0a 0a0a 2020 2020 2038 3330 3735 3430  :...     8307540\n-00002a20: 3938 3231 3736 3533 393a 6a75 7365 723a  982176539:juser:\n-00002a30: 3132 3330 3636 3531 3732 3a32 2e35 3a31  1230665172:2.5:1\n-00002a40: 3a31 2e31 2e31 2e31 2c74 6370 2f32 323a  :1.1.1.1,tcp/22:\n-00002a50: 3139 322e 3136 382e 312e 322c 3232 3a0a  192.168.1.2,22:.\n-00002a60: 2020 2020 2063 7279 7074 2c6d 7970 773a       crypt,mypw:\n-00002a70: 3132 303a 7873 776a 3856 307a 4d52 372f  120:xswj8V0zMR7/\n-00002a80: 374d 5639 7051 5261 7253 4b57 4731 6c39  7MV9pQRarSKWG1l9\n-00002a90: 5a66 6a76 2b6b 6258 614b 724a 2b52 410a  Zfjv+kbXaKrJ+RA.\n-00002aa0: 0a20 2020 466f 7220 6d6f 7374 206f 6620  .   For most of \n-00002ab0: 7468 6520 6669 656c 6473 2c20 796f 7520  the fields, you \n-00002ac0: 6e65 6564 206e 6f74 2062 6520 746f 6f20  need not be too \n-00002ad0: 636f 6e63 6572 6e65 6420 6162 6f75 7420  concerned about \n-00002ae0: 7468 650a 666f 726d 6174 2061 7320 6c69  the.format as li\n-00002af0: 6266 6b6f 2068 616e 646c 6573 2074 6861  bfko handles tha\n-00002b00: 742e 2020 5468 6520 6578 6365 7074 696f  t.  The exceptio\n-00002b10: 6e73 2061 7265 2074 6865 2027 7370 615f  ns are the 'spa_\n-00002b20: 6d65 7373 6167 6527 2c0a 2773 7061 5f6e  message',.'spa_n\n-00002b30: 6174 5f61 6363 6573 7327 2c20 616e 6420  at_access', and \n-00002b40: 2773 7061 5f73 6572 7665 725f 6175 7468  'spa_server_auth\n-00002b50: 272e 2020 5468 6520 666f 726d 6174 7320  '.  The formats \n-00002b60: 666f 7220 7468 6573 6520 6172 6520 6e6f  for these are no\n-00002b70: 740a 6861 6e64 6c65 6420 6279 206c 6962  t.handled by lib\n-00002b80: 666b 6f20 6475 7269 6e67 2063 7265 6174  fko during creat\n-00002b90: 696f 6e2e 2020 486f 7765 7665 722c 2074  ion.  However, t\n-00002ba0: 6865 7920 6172 6520 6368 6563 6b65 6420  hey are checked \n-00002bb0: 666f 7220 666f 726d 6174 0a76 616c 6964  for format.valid\n-00002bc0: 6974 7920 6475 7269 6e67 2074 6865 2065  ity during the e\n-00002bd0: 6e64 636f 6469 6e67 2061 6e64 2064 6563  ndcoding and dec\n-00002be0: 6f64 696e 6720 2877 6865 6e20 7061 7273  oding (when pars\n-00002bf0: 696e 6720 696e 636f 6d69 6e67 2920 5350  ing incoming) SP\n-00002c00: 410a 6461 7461 2e20 204d 6f72 6520 696e  A.data.  More in\n-00002c10: 666f 726d 6174 696f 6e20 6f6e 2074 6865  formation on the\n-00002c20: 2073 7065 6369 6669 6373 206f 6620 7468   specifics of th\n-00002c30: 6520 666f 726d 6174 7320 666f 7220 7468  e formats for th\n-00002c40: 6573 6520 6669 656c 6473 0a63 616e 2062  ese fields.can b\n-00002c50: 6520 666f 756e 6420 696e 202a 6e6f 7465  e found in *note\n-00002c60: 2053 5041 204d 6573 7361 6765 733a 3a2e   SPA Messages::.\n-00002c70: 0a0a 1f0a 4669 6c65 3a20 6c69 6266 6b6f  ....File: libfko\n-00002c80: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5072  .info,  Node: Pr\n-00002c90: 6570 6172 6174 696f 6e2c 2020 4e65 7874  eparation,  Next\n-00002ca0: 3a20 5573 696e 6720 6c69 6266 6b6f 2c20  : Using libfko, \n-00002cb0: 2050 7265 763a 2049 6e74 726f 6475 6374   Prev: Introduct\n-00002cc0: 696f 6e2c 2020 5570 3a20 546f 700a 0a32  ion,  Up: Top..2\n-00002cd0: 2050 7265 7061 7261 7469 6f6e 0a2a 2a2a   Preparation.***\n-00002ce0: 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 5468 6973  **********..This\n-00002cf0: 2063 6861 7074 6572 2070 726f 7669 6465   chapter provide\n-00002d00: 7320 696e 666f 726d 6174 696f 6e20 6e65  s information ne\n-00002d10: 6564 6564 2074 6f20 7072 6570 6172 6520  eded to prepare \n-00002d20: 666f 7220 7573 696e 6720 6c69 6266 6b6f  for using libfko\n-00002d30: 2069 6e0a 796f 7572 2070 726f 6772 616d   in.your program\n-00002d40: 732e 0a0a 2a20 4d65 6e75 3a0a 0a2a 206c  s...* Menu:..* l\n-00002d50: 6962 666b 6f20 4865 6164 6572 3a3a 2020  ibfko Header::  \n-00002d60: 2020 2020 2020 2020 2020 2020 2020 2057                 W\n-00002d70: 6861 7420 6865 6164 6572 2066 696c 6520  hat header file \n-00002d80: 796f 7520 6e65 6564 2074 6f20 696e 636c  you need to incl\n-00002d90: 7564 650a 2a20 436f 6d70 696c 696e 6720  ude.* Compiling \n-00002da0: 7769 7468 206c 6962 666b 6f3a 3a20 2020  with libfko::   \n-00002db0: 2020 2020 2020 5768 6174 2079 6f75 206e        What you n\n-00002dc0: 6565 6420 746f 2063 6f6d 7069 6c65 2061  eed to compile a\n-00002dd0: 6e64 206c 696e 6b20 796f 7572 0a20 2020  nd link your.   \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 00002de0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00002df0: 2020 2020 2020 2020 2020 2020 2020 2070                 p\n-00002e00: 726f 6772 616d 2077 6974 6820 6c69 6266  rogram with libf\n-00002e10: 6b6f 0a2a 2053 5041 2050 6172 616d 6574  ko.* SPA Paramet\n-00002e20: 6572 2054 7970 6573 3a3a 2020 2020 2020  er Types::      \n-00002e30: 2020 2020 2054 6865 2061 7661 696c 6162       The availab\n-00002e40: 6c65 2064 6967 6573 7473 2c20 6d65 7373  le digests, mess\n-00002e50: 6167 6520 7479 7065 7320 616e 640a 2020  age types and.  \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 00002e60: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00002e70: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00002e80: 6d6f 6465 7320 6f66 2065 6e63 7279 7074  modes of encrypt\n-00002e90: 696f 6e20 666f 7220 5350 4120 6461 7461  ion for SPA data\n-00002ea0: 0a0a 1f0a 4669 6c65 3a20 6c69 6266 6b6f  ....File: libfko\n-00002eb0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6c69  .info,  Node: li\n-00002ec0: 6266 6b6f 2048 6561 6465 722c 2020 4e65  bfko Header,  Ne\n-00002ed0: 7874 3a20 436f 6d70 696c 696e 6720 7769  xt: Compiling wi\n-00002ee0: 7468 206c 6962 666b 6f2c 2020 5570 3a20  th libfko,  Up: \n-00002ef0: 5072 6570 6172 6174 696f 6e0a 0a32 2e31  Preparation..2.1\n-00002f00: 206c 6962 666b 6f20 4865 6164 6572 0a3d   libfko Header.=\n-00002f10: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================\n-00002f20: 0a0a 416c 6c20 696e 7465 7266 6163 6573  ..All interfaces\n-00002f30: 2028 6461 7461 2074 7970 6573 2061 6e64   (data types and\n-00002f40: 2066 756e 6374 696f 6e73 2920 6f66 2074   functions) of t\n-00002f50: 6865 206c 6962 7261 7279 2061 7265 2064  he library are d\n-00002f60: 6566 696e 6564 2069 6e0a 7468 6520 6865  efined in.the he\n-00002f70: 6164 6572 2066 696c 6520 2766 6b6f 2e68  ader file 'fko.h\n-00002f80: 272e 2020 596f 7520 6d75 7374 2069 6e63  '.  You must inc\n-00002f90: 6c75 6465 2074 6869 7320 696e 2061 6c6c  lude this in all\n-00002fa0: 2070 726f 6772 616d 7320 7573 696e 670a   programs using.\n-00002fb0: 7468 6520 6c69 6272 6172 792c 2065 6974  the library, eit\n-00002fc0: 6865 7220 6469 7265 6374 6c79 206f 7220  her directly or \n-00002fd0: 7468 726f 7567 6820 736f 6d65 206f 7468  through some oth\n-00002fe0: 6572 2068 6561 6465 7220 6669 6c65 2c20  er header file, \n-00002ff0: 6c69 6b65 0a74 6869 733a 0a0a 2020 2020  like.this:..    \n-00003000: 2023 696e 636c 7564 6520 3c66 6b6f 2e68   #include <fko.h\n-00003010: 3e0a 0a20 2020 5468 6520 6e61 6d65 2073  >..   The name s\n-00003020: 7061 6365 206f 6620 464b 4f20 6973 2027  pace of FKO is '\n-00003030: 666b 6f5f 2a27 2066 6f72 2066 756e 6374  fko_*' for funct\n-00003040: 696f 6e20 6e61 6d65 7320 616e 6420 6461  ion names and da\n-00003050: 7461 2074 7970 6573 0a61 6e64 2027 464b  ta types.and 'FK\n-00003060: 4f5f 2a27 2066 6f72 206f 7468 6572 2073  O_*' for other s\n-00003070: 796d 626f 6c73 2e20 204f 7468 6572 2073  ymbols.  Other s\n-00003080: 796d 626f 6c73 2069 6e74 6572 6e61 6c20  ymbols internal \n-00003090: 746f 2046 4b4f 206d 6179 2074 616b 650a  to FKO may take.\n-000030a0: 7468 6520 666f 726d 2027 5f66 6b6f 5f2a  the form '_fko_*\n-000030b0: 2720 616e 6420 275f 464b 4f5f 2a27 2e0a  ' and '_FKO_*'..\n-000030c0: 0a1f 0a46 696c 653a 206c 6962 666b 6f2e  ...File: libfko.\n-000030d0: 696e 666f 2c20 204e 6f64 653a 2043 6f6d  info,  Node: Com\n-000030e0: 7069 6c69 6e67 2077 6974 6820 6c69 6266  piling with libf\n-000030f0: 6b6f 2c20 204e 6578 743a 2053 5041 2050  ko,  Next: SPA P\n-00003100: 6172 616d 6574 6572 2054 7970 6573 2c20  arameter Types, \n-00003110: 2050 7265 763a 206c 6962 666b 6f20 4865   Prev: libfko He\n-00003120: 6164 6572 2c20 2055 703a 2050 7265 7061  ader,  Up: Prepa\n-00003130: 7261 7469 6f6e 0a0a 322e 3220 436f 6d70  ration..2.2 Comp\n-00003140: 696c 696e 6720 7769 7468 206c 6962 666b  iling with libfk\n-00003150: 6f0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  o.==============\n-00003160: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 6620  ===========..If \n-00003170: 796f 7520 7761 6e74 2074 6f20 636f 6d70  you want to comp\n-00003180: 696c 6520 6120 736f 7572 6365 2066 696c  ile a source fil\n-00003190: 6520 696e 636c 7564 696e 6720 7468 6520  e including the \n-000031a0: 2766 6b6f 2e68 2720 6865 6164 6572 2066  'fko.h' header f\n-000031b0: 696c 652c 0a79 6f75 206d 7573 7420 6d61  ile,.you must ma\n-000031c0: 6b65 2073 7572 6520 7468 6174 2074 6865  ke sure that the\n-000031d0: 2063 6f6d 7069 6c65 7220 6361 6e20 6669   compiler can fi\n-000031e0: 6e64 2069 7420 696e 2074 6865 2064 6972  nd it in the dir\n-000031f0: 6563 746f 7279 0a68 6965 7261 7263 6879  ectory.hierarchy\n-00003200: 2e20 2054 6869 7320 6973 2061 6363 6f6d  .  This is accom\n-00003210: 706c 6973 6865 6420 6279 2061 6464 696e  plished by addin\n-00003220: 6720 7468 6520 7061 7468 2074 6f20 7468  g the path to th\n-00003230: 6520 6469 7265 6374 6f72 7920 696e 0a77  e directory in.w\n-00003240: 6869 6368 2074 6865 2068 6561 6465 7220  hich the header \n-00003250: 6669 6c65 2069 7320 6c6f 6361 7465 6420  file is located \n-00003260: 746f 2074 6865 2063 6f6d 7069 6c65 7273  to the compilers\n-00003270: 2069 6e63 6c75 6465 2066 696c 6520 7365   include file se\n-00003280: 6172 6368 0a70 6174 6820 2876 6961 2074  arch.path (via t\n-00003290: 6865 2027 2d49 2720 6f70 7469 6f6e 292e  he '-I' option).\n-000032a0: 0a0a 2020 2046 6f72 2065 7861 6d70 6c65  ..   For example\n-000032b0: 2c20 6966 2079 6f75 2069 6e73 7461 6c6c  , if you install\n-000032c0: 6564 206c 6962 666b 6f20 696e 2027 2f6f  ed libfko in '/o\n-000032d0: 7074 2f66 6b6f 272c 2079 6f75 206d 6179  pt/fko', you may\n-000032e0: 2077 616e 7420 746f 0a61 6464 2027 2d49   want to.add '-I\n-000032f0: 2f6f 7074 2f66 6b6f 2f69 6e63 6c75 6465  /opt/fko/include\n-00003300: 2720 746f 2027 4346 4c41 4753 272c 206f  ' to 'CFLAGS', o\n-00003310: 7220 6469 7265 6374 6c79 206f 6e20 7468  r directly on th\n-00003320: 6520 636f 6d6d 616e 642d 6c69 6e65 3a0a  e command-line:.\n-00003330: 0a20 2020 2020 6763 6320 2d63 2066 6f6f  .     gcc -c foo\n-00003340: 2e63 202d 492f 6f70 742f 666b 6f2f 696e  .c -I/opt/fko/in\n-00003350: 636c 7564 6520 2e2e 2e0a 0a20 2020 5468  clude .....   Th\n-00003360: 6520 7361 6d65 2069 7320 7472 7565 2077  e same is true w\n-00003370: 6865 6e20 6c69 6e6b 696e 6720 6120 7072  hen linking a pr\n-00003380: 6f67 7261 6d20 7769 7468 2074 6865 206c  ogram with the l\n-00003390: 6962 7261 7279 2e20 2049 6e20 7468 6973  ibrary.  In this\n-000033a0: 0a63 6173 652c 2074 6865 206c 696e 6b65  .case, the linke\n-000033b0: 7220 6861 7320 746f 2066 696e 6420 7468  r has to find th\n-000033c0: 6520 6c69 6272 6172 7920 6669 6c65 732e  e library files.\n-000033d0: 2020 466f 7220 7468 6973 2074 6f20 776f    For this to wo\n-000033e0: 726b 2c20 7468 650a 7061 7468 2074 6f20  rk, the.path to \n-000033f0: 7468 6520 6c69 6272 6172 7920 6669 6c65  the library file\n-00003400: 7320 6861 7320 746f 2062 6520 6164 6465  s has to be adde\n-00003410: 6420 746f 2074 6865 206c 6962 7261 7279  d to the library\n-00003420: 2073 6561 7263 6820 7061 7468 0a28 7669   search path.(vi\n-00003430: 6120 7468 6520 272d 4c27 206f 7074 696f  a the '-L' optio\n-00003440: 6e29 2e0a 0a20 2020 436f 6e74 696e 7569  n)...   Continui\n-00003450: 6e67 2077 6974 6820 7468 6520 6578 616d  ng with the exam\n-00003460: 706c 6520 6162 6f76 6520 796f 7520 6d61  ple above you ma\n-00003470: 7920 7761 6e74 2074 6f20 6164 640a 272d  y want to add.'-\n-00003480: 4c2f 6f70 742f 666b 6f2f 6c69 6227 2074  L/opt/fko/lib' t\n-00003490: 6f20 274c 4446 4c41 4753 272c 206f 7220  o 'LDFLAGS', or \n-000034a0: 6469 7265 6374 6c79 206f 6e20 7468 6520  directly on the \n-000034b0: 636f 6d6d 616e 642d 6c69 6e65 3a0a 0a20  command-line:.. \n-000034c0: 2020 2020 6763 6320 2d6f 2066 6f6f 2066      gcc -o foo f\n-000034d0: 6f6f 2e63 202d 492f 6f70 742f 666b 6f2f  oo.c -I/opt/fko/\n-000034e0: 696e 636c 7564 6520 2d4c 2f6f 7074 2f66  include -L/opt/f\n-000034f0: 6b6f 2f6c 6962 202d 6c66 6b6f 0a0a 1f0a  ko/lib -lfko....\n-00003500: 4669 6c65 3a20 6c69 6266 6b6f 2e69 6e66  File: libfko.inf\n-00003510: 6f2c 2020 4e6f 6465 3a20 5350 4120 5061  o,  Node: SPA Pa\n-00003520: 7261 6d65 7465 7220 5479 7065 732c 2020  rameter Types,  \n-00003530: 5072 6576 3a20 436f 6d70 696c 696e 6720  Prev: Compiling \n-00003540: 7769 7468 206c 6962 666b 6f2c 2020 5570  with libfko,  Up\n-00003550: 3a20 5072 6570 6172 6174 696f 6e0a 0a32  : Preparation..2\n-00003560: 2e33 2053 5041 2050 6172 616d 6574 6572  .3 SPA Parameter\n-00003570: 2054 7970 6573 0a3d 3d3d 3d3d 3d3d 3d3d   Types.=========\n-00003580: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a  ==============..\n-00003590: 2a20 4d65 6e75 3a0a 0a2a 2044 6967 6573  * Menu:..* Diges\n-000035a0: 7473 3a3a 2020 2020 2020 2020 2020 2020  ts::            \n-000035b0: 2020 2020 2020 2020 2020 2054 6865 206d             The m\n-000035c0: 6573 7361 6765 2064 6967 6573 7420 6861  essage digest ha\n-000035d0: 7368 6573 2073 7570 706f 7274 6564 2062  shes supported b\n-000035e0: 7920 6c69 6266 6b6f 0a2a 2053 5041 204d  y libfko.* SPA M\n-000035f0: 6573 7361 6765 733a 3a20 2020 2020 2020  essages::       \n-00003600: 2020 2020 2020 2020 2020 2054 6865 2066             The f\n-00003610: 6b6f 2053 5041 206d 6573 7361 6765 2074  ko SPA message t\n-00003620: 7970 6573 0a20 2020 2020 2020 2020 2020  ypes.           \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+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 00003630: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00003640: 2020 2020 2020 2073 7570 706f 7274 6564         supported\n-00003650: 2062 7920 6c69 6266 6b6f 2028 616e 6420   by libfko (and \n-00003660: 6677 6b6e 6f70 290a 2a20 456e 6372 7970  fwknop).* Encryp\n-00003670: 7469 6f6e 2041 6c67 6f72 6974 686d 733a  tion Algorithms:\n-00003680: 3a20 2020 2020 2020 2020 456e 6372 7970  :         Encryp\n-00003690: 7469 6f6e 2073 6368 656d 6573 2073 7570  tion schemes sup\n-000036a0: 706f 7274 6564 2062 7920 6c69 6266 6b6f  ported by libfko\n-000036b0: 0a2a 2048 4d41 4320 4469 6765 7374 733a  .* HMAC Digests:\n-000036c0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               \n-000036d0: 2020 2044 6967 6573 7473 2074 6861 7420     Digests that \n-000036e0: 6361 6e20 6265 2075 7365 6420 746f 2062  can be used to b\n-000036f0: 7569 6c64 2061 6e20 484d 4143 0a0a 1f0a  uild an HMAC....\n-00003700: 4669 6c65 3a20 6c69 6266 6b6f 2e69 6e66  File: libfko.inf\n-00003710: 6f2c 2020 4e6f 6465 3a20 4469 6765 7374  o,  Node: Digest\n-00003720: 732c 2020 4e65 7874 3a20 5350 4120 4d65  s,  Next: SPA Me\n-00003730: 7373 6167 6573 2c20 2055 703a 2053 5041  ssages,  Up: SPA\n-00003740: 2050 6172 616d 6574 6572 2054 7970 6573   Parameter Types\n-00003750: 0a0a 322e 332e 3120 4469 6765 7374 730a  ..2.3.1 Digests.\n-00003760: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54  -------------..T\n-00003770: 6865 2066 776b 6e6f 7020 7379 7374 656d  he fwknop system\n-00003780: 2065 6d70 6c6f 7973 2061 206d 6573 7361   employs a messa\n-00003790: 6765 2064 6967 6573 7420 6861 7368 206f  ge digest hash o\n-000037a0: 6620 7468 6520 5350 4120 6461 7461 2061  f the SPA data a\n-000037b0: 7320 6f6e 650a 6f66 2074 6865 2064 6174  s one.of the dat\n-000037c0: 6120 6669 656c 6473 2074 6f20 6163 7420  a fields to act \n-000037d0: 6120 7369 676e 6174 7572 6520 7768 6963  a signature whic\n-000037e0: 6820 6361 6e20 6265 2075 7365 6420 6174  h can be used at\n-000037f0: 2074 6865 2072 6563 6569 7669 6e67 0a65   the receiving.e\n-00003800: 6e64 2074 6f20 7665 7269 6679 2074 6865  nd to verify the\n-00003810: 2064 6174 6120 6973 2076 616c 6964 2028   data is valid (\n-00003820: 616c 7468 6f75 6768 2074 6869 7320 6665  although this fe\n-00003830: 6174 7572 6520 6861 7320 6265 656e 0a73  ature has been.s\n-00003840: 7570 6572 6365 6465 6420 6279 2074 6865  uperceded by the\n-00003850: 2075 7361 6765 206f 6620 616e 2048 4d41   usage of an HMA\n-00003860: 4320 666f 7220 7072 6f70 6572 206d 6573  C for proper mes\n-00003870: 7361 6765 2061 7574 6865 6e74 6963 6174  sage authenticat\n-00003880: 696f 6e20 616e 640a 7665 7269 6669 6361  ion and.verifica\n-00003890: 7469 6f6e 206f 6620 696e 7465 6772 6974  tion of integrit\n-000038a0: 7929 2e20 2054 6865 2072 6573 756c 7469  y).  The resulti\n-000038b0: 6e67 2064 6967 6573 7420 6973 2062 6173  ng digest is bas\n-000038c0: 6536 342d 656e 636f 6465 640a 6265 666f  e64-encoded.befo\n-000038d0: 7265 2069 7420 6973 2061 6464 6564 2074  re it is added t\n-000038e0: 6f20 7468 6520 5350 4120 6461 7461 2e0a  o the SPA data..\n-000038f0: 0a20 2020 4375 7272 656e 746c 792c 206c  .   Currently, l\n-00003900: 6962 666b 6f20 7375 7070 6f72 7473 2074  ibfko supports t\n-00003910: 6865 2073 616d 6520 6d65 7373 6167 6520  he same message \n-00003920: 6469 6765 7374 7320 6173 2074 6865 206c  digests as the l\n-00003930: 6567 6163 790a 6677 6b6e 6f70 2070 6c75  egacy.fwknop plu\n-00003940: 7320 7477 6f20 6f74 6865 7273 2028 5348  s two others (SH\n-00003950: 4133 3834 2061 6e64 2053 4841 3531 3229  A384 and SHA512)\n-00003960: 2e20 2054 6865 7365 2061 7265 2028 696e  .  These are (in\n-00003970: 206f 7264 6572 206f 660a 7374 7265 6e67   order of.streng\n-00003980: 7468 293a 0a0a 202d 2d20 5661 7269 6162  th):.. -- Variab\n-00003990: 6c65 3a20 696e 7420 666b 6f5f 6469 6765  le: int fko_dige\n-000039a0: 7374 5f74 7970 655f 740a 2020 2020 2027  st_type_t.     '\n-000039b0: 464b 4f5f 4449 4745 5354 5f4d 4435 270a  FKO_DIGEST_MD5'.\n-000039c0: 2020 2020 2027 464b 4f5f 4449 4745 5354       'FKO_DIGEST\n-000039d0: 5f53 4841 3127 0a20 2020 2020 2746 4b4f  _SHA1'.     'FKO\n-000039e0: 5f44 4947 4553 545f 5348 4132 3536 2028  _DIGEST_SHA256 (\n-000039f0: 6c69 6266 6b6f 2064 6566 6175 6c74 2927  libfko default)'\n-00003a00: 0a20 2020 2020 2746 4b4f 5f44 4947 4553  .     'FKO_DIGES\n-00003a10: 545f 5348 4133 3834 270a 2020 2020 2027  T_SHA384'.     '\n-00003a20: 464b 4f5f 4449 4745 5354 5f53 4841 3531  FKO_DIGEST_SHA51\n-00003a30: 3227 0a0a 2020 2041 7320 696e 6469 6361  2'..   As indica\n-00003a40: 7465 6420 696e 2074 6865 206c 6973 7420  ted in the list \n-00003a50: 6162 6f76 652c 2053 4841 3235 3620 6973  above, SHA256 is\n-00003a60: 2074 6865 2064 6566 6175 6c74 2e20 2054   the default.  T\n-00003a70: 6869 7320 6d65 616e 730a 7468 6520 6469  his means.the di\n-00003a80: 6765 7374 2074 7970 6520 646f 6573 206e  gest type does n\n-00003a90: 6f74 206e 6565 6420 746f 2062 6520 6578  ot need to be ex\n-00003aa0: 706c 6963 6974 6c79 2073 6574 2075 6e6c  plicitly set unl\n-00003ab0: 6573 7320 796f 7520 7769 7368 2074 6f0a  ess you wish to.\n-00003ac0: 7573 6520 6f6e 6520 6f66 2074 6865 206f  use one of the o\n-00003ad0: 7468 6572 2076 616c 7565 732e 2020 5468  ther values.  Th\n-00003ae0: 6973 2061 7070 6c69 6573 2074 6f20 616c  is applies to al\n-00003af0: 6c20 6c69 6266 6b6f 2053 5041 2064 6174  l libfko SPA dat\n-00003b00: 6120 6669 656c 6473 0a74 6861 7420 6861  a fields.that ha\n-00003b10: 7665 2061 2064 6566 6175 6c74 2076 616c  ve a default val\n-00003b20: 7565 2e0a 0a1f 0a46 696c 653a 206c 6962  ue.....File: lib\n-00003b30: 666b 6f2e 696e 666f 2c20 204e 6f64 653a  fko.info,  Node:\n-00003b40: 2053 5041 204d 6573 7361 6765 732c 2020   SPA Messages,  \n-00003b50: 4e65 7874 3a20 456e 6372 7970 7469 6f6e  Next: Encryption\n-00003b60: 2041 6c67 6f72 6974 686d 732c 2020 5072   Algorithms,  Pr\n-00003b70: 6576 3a20 4469 6765 7374 732c 2020 5570  ev: Digests,  Up\n-00003b80: 3a20 5350 4120 5061 7261 6d65 7465 7220  : SPA Parameter \n-00003b90: 5479 7065 730a 0a32 2e33 2e32 2053 5041  Types..2.3.2 SPA\n-00003ba0: 204d 6573 7361 6765 730a 2d2d 2d2d 2d2d   Messages.------\n-00003bb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468  ------------..Th\n-00003bc0: 6520 6677 6b6e 6f70 2073 7973 7465 6d20  e fwknop system \n-00003bd0: 2861 6e64 2073 7562 7365 7175 656e 746c  (and subsequentl\n-00003be0: 7920 6c69 6266 6b6f 292c 2073 7570 706f  y libfko), suppo\n-00003bf0: 7274 2061 2073 7065 6369 6669 6320 7365  rt a specific se\n-00003c00: 7420 6f66 0a6d 6573 7361 6765 2074 7970  t of.message typ\n-00003c10: 6573 2e20 2054 6865 206d 6573 7361 6765  es.  The message\n-00003c20: 2074 7970 6520 7661 6c75 6520 6973 2075   type value is u\n-00003c30: 7365 6420 6279 2066 776b 6e6f 7020 746f  sed by fwknop to\n-00003c40: 2068 656c 700a 6465 7465 726d 696e 6520   help.determine \n-00003c50: 7468 6520 636f 7272 6563 7420 6d65 7373  the correct mess\n-00003c60: 6167 6520 666f 726d 6174 2061 6e64 2063  age format and c\n-00003c70: 6f6e 7465 6e74 2e20 2054 6865 7365 206d  ontent.  These m\n-00003c80: 6573 7361 6765 2074 7970 6573 0a61 7265  essage types.are\n-00003c90: 3a0a 0a20 2d2d 2056 6172 6961 626c 653a  :.. -- Variable:\n-00003ca0: 2069 6e74 2066 6b6f 5f6d 6573 7361 6765   int fko_message\n-00003cb0: 5f74 7970 655f 740a 2020 2020 2027 464b  _type_t.     'FK\n-00003cc0: 4f5f 434f 4d4d 414e 445f 4d53 4727 0a20  O_COMMAND_MSG'. \n-00003cd0: 2020 2020 2020 2020 2041 2072 6571 7565           A reque\n-00003ce0: 7374 2074 6f20 6861 7665 2074 6865 2066  st to have the f\n-00003cf0: 776b 6e6f 7020 7365 7276 6572 2065 7865  wknop server exe\n-00003d00: 6375 7465 2074 6865 2067 6976 656e 2063  cute the given c\n-00003d10: 6f6d 6d61 6e64 2e0a 2020 2020 2020 2020  ommand..        \n-00003d20: 2020 5468 6520 666f 726d 6174 2066 6f72    The format for\n-00003d30: 2074 6869 7320 7479 7065 2069 733a 2027   this type is: '\n-00003d40: 3c69 7020 6f66 2072 6571 7565 7374 6f72  <ip of requestor\n-00003d50: 3e2c 3c63 6f6d 6d61 6e64 0a20 2020 2020  >,<command.     \n-00003d60: 2020 2020 2074 6578 743e 272e 0a20 2020       text>'..   \n-00003d70: 2020 2020 2020 2020 2020 2020 2231 3932              \"192\n-00003d80: 2e31 3638 2e31 2e32 2c75 6e61 6d65 202d  .168.1.2,uname -\n-00003d90: 6122 0a0a 2020 2020 2027 464b 4f5f 4143  a\"..     'FKO_AC\n-00003da0: 4345 5353 5f4d 5347 270a 2020 2020 2020  CESS_MSG'.      \n-00003db0: 2020 2020 4120 6261 7369 6320 6163 6365      A basic acce\n-00003dc0: 7373 2072 6571 7565 7374 2e20 2054 6869  ss request.  Thi\n-00003dd0: 7320 6973 2074 6865 206d 6f73 7420 636f  s is the most co\n-00003de0: 6d6d 6f6e 2074 7970 6520 696e 2075 7365  mmon type in use\n-00003df0: 2e0a 2020 2020 2020 2020 2020 5468 6520  ..          The \n-00003e00: 666f 726d 6174 2066 6f72 2074 6869 7320  format for this \n-00003e10: 7479 7065 2069 733a 2027 3c69 7020 6f66  type is: '<ip of\n-00003e20: 0a20 2020 2020 2020 2020 2072 6571 7565  .          reque\n-00003e30: 7374 6f72 3e2c 3c70 726f 746f 636f 6c3e  stor>,<protocol>\n-00003e40: 2f3c 706f 7274 3e27 2e20 204e 6f74 6520  /<port>'.  Note \n-00003e50: 7468 6174 206d 756c 7469 706c 650a 2020  that multiple.  \n-00003e60: 2020 2020 2020 2020 7072 6f74 6f63 6f6c          protocol\n-00003e70: 2f70 6f72 7420 656e 7472 6965 7320 6172  /port entries ar\n-00003e80: 6520 616c 6c6f 7765 642e 0a20 2020 2020  e allowed..     \n-00003e90: 2020 2020 2020 2020 2020 2231 3932 2e31            \"192.1\n-00003ea0: 3638 2e31 2e32 2c74 6370 2f32 3222 0a20  68.1.2,tcp/22\". \n-00003eb0: 2020 2020 2020 2020 2020 2020 2020 2231                \"1\n-00003ec0: 3932 2e31 3638 2e31 2e32 2c74 6370 2f32  92.168.1.2,tcp/2\n-00003ed0: 322c 7564 702f 3530 3035 220a 0a20 2020  2,udp/5005\"..   \n-00003ee0: 2020 2746 4b4f 5f4e 4154 5f41 4343 4553    'FKO_NAT_ACCES\n-00003ef0: 535f 4d53 4727 0a20 2020 2020 2020 2020  S_MSG'.         \n-00003f00: 2041 6e20 6163 6365 7373 2072 6571 7565   An access reque\n-00003f10: 7374 2074 6861 7420 616c 736f 2070 726f  st that also pro\n-00003f20: 7669 6465 2069 6e66 6f72 6d61 7469 6f6e  vide information\n-00003f30: 2066 6f72 2074 6865 2066 776b 6e6f 700a   for the fwknop.\n-00003f40: 2020 2020 2020 2020 2020 7365 7276 6572            server\n-00003f50: 2074 6f20 6372 6561 7465 2061 204e 6574   to create a Net\n-00003f60: 776f 726b 2041 6464 7265 7373 2054 7261  work Address Tra\n-00003f70: 6e73 6c61 7469 6f6e 2028 4e41 5420 746f  nslation (NAT to\n-00003f80: 2061 6e0a 2020 2020 2020 2020 2020 696e   an.          in\n-00003f90: 7465 726e 616c 2061 6464 7265 7373 2e20  ternal address. \n-00003fa0: 2054 6865 2066 6f72 6d61 7420 666f 7220   The format for \n-00003fb0: 7468 6973 2073 7472 696e 6720 6973 3a20  this string is: \n-00003fc0: 273c 696e 7465 726e 616c 0a20 2020 2020  '<internal.     \n-00003fd0: 2020 2020 2069 703e 2c3c 6578 7420 6e61       ip>,<ext na\n-00003fe0: 7420 706f 7274 3e27 2e0a 2020 2020 2020  t port>'..      \n-00003ff0: 2020 2020 2020 2020 2022 3130 2e31 302e           \"10.10.\n-00004000: 312e 322c 3939 3232 220a 0a20 2020 2020  1.2,9922\"..     \n-00004010: 2746 4b4f 5f43 4c49 454e 545f 5449 4d45  'FKO_CLIENT_TIME\n-00004020: 4f55 545f 4143 4345 5353 5f4d 5347 270a  OUT_ACCESS_MSG'.\n-00004030: 2020 2020 2020 2020 2020 5468 6973 2069            This i\n-00004040: 7320 616e 2046 4b4f 5f41 4343 4553 535f  s an FKO_ACCESS_\n-00004050: 5245 5155 4553 5420 7769 7468 2061 2074  REQUEST with a t\n-00004060: 696d 656f 7574 2070 6172 616d 6574 6572  imeout parameter\n-00004070: 2066 6f72 2074 6865 0a20 2020 2020 2020   for the.       \n-00004080: 2020 2066 776b 6e6f 7020 7365 7276 6572     fwknop server\n-00004090: 2e20 2054 6865 2074 696d 656f 7574 2076  .  The timeout v\n-000040a0: 616c 7565 2069 7320 7072 6f76 6964 6564  alue is provided\n-000040b0: 2076 6961 2074 6865 0a20 2020 2020 2020   via the.       \n-000040c0: 2020 2027 636c 6965 6e74 5f74 696d 656f     'client_timeo\n-000040d0: 7574 2720 6461 7461 2066 6965 6c64 2e0a  ut' data field..\n-000040e0: 0a20 2020 2020 2746 4b4f 5f43 4c49 454e  .     'FKO_CLIEN\n-000040f0: 545f 5449 4d45 4f55 545f 4e41 545f 4143  T_TIMEOUT_NAT_AC\n-00004100: 4345 5353 5f4d 5347 270a 2020 2020 2020  CESS_MSG'.      \n-00004110: 2020 2020 5468 6973 2069 7320 616e 2046      This is an F\n-00004120: 4b4f 5f4e 4154 5f41 4343 4553 535f 5245  KO_NAT_ACCESS_RE\n-00004130: 5155 4553 5420 7769 7468 2061 2074 696d  QUEST with a tim\n-00004140: 656f 7574 2070 6172 616d 6574 6572 2066  eout parameter f\n-00004150: 6f72 0a20 2020 2020 2020 2020 2074 6865  or.          the\n-00004160: 2066 776b 6e6f 7020 7365 7276 6572 2e20   fwknop server. \n-00004170: 2054 6865 2074 696d 656f 7574 2076 616c   The timeout val\n-00004180: 7565 2069 7320 7072 6f76 6964 6564 2076  ue is provided v\n-00004190: 6961 2074 6865 0a20 2020 2020 2020 2020  ia the.         \n-000041a0: 2027 636c 6965 6e74 5f74 696d 656f 7574   'client_timeout\n-000041b0: 2720 6461 7461 2066 6965 6c64 2e0a 0a20  ' data field... \n-000041c0: 2020 2020 2746 4b4f 5f4c 4f43 414c 5f4e      'FKO_LOCAL_N\n-000041d0: 4154 5f41 4343 4553 535f 4d53 4727 0a20  AT_ACCESS_MSG'. \n-000041e0: 2020 2020 2020 2020 2054 6869 7320 6973           This is\n-000041f0: 2073 696d 696c 6172 2074 6f20 7468 6520   similar to the \n-00004200: 464b 4f5f 4e41 545f 4143 4345 5353 2072  FKO_NAT_ACCESS r\n-00004210: 6571 7565 7374 2065 7863 6570 7420 7468  equest except th\n-00004220: 6520 4e41 540a 2020 2020 2020 2020 2020  e NAT.          \n-00004230: 6973 2074 6f20 7468 6520 6c6f 6361 6c20  is to the local \n-00004240: 746f 2074 6865 2073 6572 7665 7220 2869  to the server (i\n-00004250: 2e65 2e20 2061 2073 6572 7669 6365 206c  .e.  a service l\n-00004260: 6973 7465 6e69 6e67 206f 6e0a 2020 2020  istening on.    \n-00004270: 2020 2020 2020 3132 372e 302e 302e 3129        127.0.0.1)\n-00004280: 2e0a 0a20 2020 2020 2746 4b4f 5f43 4c49  ...     'FKO_CLI\n-00004290: 454e 545f 5449 4d45 4f55 545f 4c4f 4341  ENT_TIMEOUT_LOCA\n-000042a0: 4c5f 4e41 545f 4143 4345 5353 5f4d 5347  L_NAT_ACCESS_MSG\n-000042b0: 270a 2020 2020 2020 2020 2020 5468 6973  '.          This\n-000042c0: 2069 7320 616e 2046 4b4f 5f4c 4f43 414c   is an FKO_LOCAL\n-000042d0: 5f4e 4154 5f41 4343 4553 535f 5245 5155  _NAT_ACCESS_REQU\n-000042e0: 4553 5420 7769 7468 2061 2074 696d 656f  EST with a timeo\n-000042f0: 7574 0a20 2020 2020 2020 2020 2070 6172  ut.          par\n-00004300: 616d 6574 6572 2066 6f72 2074 6865 2066  ameter for the f\n-00004310: 776b 6e6f 7020 7365 7276 6572 2e20 2054  wknop server.  T\n-00004320: 6865 2074 696d 656f 7574 2076 616c 7565  he timeout value\n-00004330: 2069 730a 2020 2020 2020 2020 2020 7072   is.          pr\n-00004340: 6f76 6964 6564 2076 6961 2074 6865 2027  ovided via the '\n-00004350: 636c 6965 6e74 5f74 696d 656f 7574 2720  client_timeout' \n-00004360: 6461 7461 2066 6965 6c64 2e0a 0a1f 0a46  data field.....F\n-00004370: 696c 653a 206c 6962 666b 6f2e 696e 666f  ile: libfko.info\n-00004380: 2c20 204e 6f64 653a 2045 6e63 7279 7074  ,  Node: Encrypt\n-00004390: 696f 6e20 416c 676f 7269 7468 6d73 2c20  ion Algorithms, \n-000043a0: 204e 6578 743a 2048 4d41 4320 4469 6765   Next: HMAC Dige\n-000043b0: 7374 732c 2020 5072 6576 3a20 5350 4120  sts,  Prev: SPA \n-000043c0: 4d65 7373 6167 6573 2c20 2055 703a 2053  Messages,  Up: S\n-000043d0: 5041 2050 6172 616d 6574 6572 2054 7970  PA Parameter Typ\n-000043e0: 6573 0a0a 322e 332e 3320 456e 6372 7970  es..2.3.3 Encryp\n-000043f0: 7469 6f6e 2041 6c67 6f72 6974 686d 730a  tion Algorithms.\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 00004400: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------\n-00004410: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a4f 6e65  -----------..One\n-00004420: 206f 6620 7468 6520 6669 6e61 6c20 7374   of the final st\n-00004430: 6570 7320 2862 6566 6f72 6520 7468 6520  eps (before the \n-00004440: 484d 4143 2069 7320 6361 6c63 756c 6174  HMAC is calculat\n-00004450: 6564 2061 6e64 2061 7070 6c69 6564 2920  ed and applied) \n-00004460: 696e 0a63 7265 6174 696e 6720 616e 2066  in.creating an f\n-00004470: 776b 6e6f 7020 5350 4120 6d65 7373 6167  wknop SPA messag\n-00004480: 6520 6973 2065 6e63 7279 7074 696e 6720  e is encrypting \n-00004490: 7468 6520 656e 7469 7265 206d 6573 7361  the entire messa\n-000044a0: 6765 2e0a 4375 7272 656e 746c 792c 2066  ge..Currently, f\n-000044b0: 776b 6e6f 7020 7375 7070 6f72 7473 2074  wknop supports t\n-000044c0: 776f 206d 6574 686f 6473 206f 6620 656e  wo methods of en\n-000044d0: 6372 7970 7469 6f6e 3a0a 0a20 2d2d 2056  cryption:.. -- V\n-000044e0: 6172 6961 626c 653a 2069 6e74 2066 6b6f  ariable: int fko\n-000044f0: 5f65 6e63 7279 7074 696f 6e5f 7479 7065  _encryption_type\n-00004500: 5f74 0a20 2020 2020 2746 4b4f 5f45 4e43  _t.     'FKO_ENC\n-00004510: 5259 5054 494f 4e5f 5249 4a4e 4441 454c  RYPTION_RIJNDAEL\n-00004520: 2028 6465 6661 756c 7429 270a 2020 2020   (default)'.    \n-00004530: 2027 464b 4f5f 454e 4352 5950 5449 4f4e   'FKO_ENCRYPTION\n-00004540: 5f47 5047 270a 0a20 2020 4173 2069 6e64  _GPG'..   As ind\n-00004550: 6963 6174 6564 2c20 6c69 6266 6b6f 2075  icated, libfko u\n-00004560: 7365 7320 5269 6a6e 6461 656c 2065 6e63  ses Rijndael enc\n-00004570: 7279 7074 696f 6e20 6279 2064 6566 6175  ryption by defau\n-00004580: 6c74 2e20 2052 696a 6e64 6165 6c0a 656e  lt.  Rijndael.en\n-00004590: 6372 7970 7469 6f6e 2069 7320 7375 6666  cryption is suff\n-000045a0: 6963 6965 6e74 2066 6f72 206d 6f73 7420  icient for most \n-000045b0: 7573 6572 7320 616e 6420 7072 6f64 7563  users and produc\n-000045c0: 6573 2061 206d 7563 6820 736d 616c 6c65  es a much smalle\n-000045d0: 7220 6461 7461 0a70 6163 6b65 7420 7468  r data.packet th\n-000045e0: 616e 2047 5047 2028 6265 7477 6565 6e20  an GPG (between \n-000045f0: 3134 3020 6279 7465 7320 7769 7468 204d  140 bytes with M\n-00004600: 4435 2064 6967 6573 7420 746f 2061 726f  D5 digest to aro\n-00004610: 756e 6420 3232 3520 6279 7465 730a 6f72  und 225 bytes.or\n-00004620: 2073 6f20 7769 7468 2053 4841 3531 322c   so with SHA512,\n-00004630: 2063 6f6d 7061 7265 6420 746f 2061 726f   compared to aro\n-00004640: 756e 6420 3131 3030 2066 6f72 2073 6967  und 1100 for sig\n-00004650: 6e65 6420 4750 4729 2e20 2057 6865 6e0a  ned GPG).  When.\n-00004660: 5269 6a6e 6461 656c 2069 7320 7573 6564  Rijndael is used\n-00004670: 2c20 7468 6520 656e 6372 7970 7469 6f6e  , the encryption\n-00004680: 206b 6579 2069 7473 656c 6620 6973 2064   key itself is d\n-00004690: 6572 6976 6564 2066 726f 6d20 7468 6520  erived from the \n-000046a0: 7375 7070 6c69 6564 0a70 6173 7370 6872  supplied.passphr\n-000046b0: 6173 6520 7669 6120 7468 6520 5042 4b44  ase via the PBKD\n-000046c0: 4631 2061 6c67 6f72 6974 686d 2c20 616e  F1 algorithm, an\n-000046d0: 6420 4342 4320 6d6f 6465 2069 7320 7365  d CBC mode is se\n-000046e0: 742e 0a0a 2020 2048 6f77 6576 6572 2c20  t...   However, \n-000046f0: 736f 6d65 206d 6179 2070 7265 6665 7220  some may prefer \n-00004700: 7468 6520 6869 6768 6572 206c 6576 656c  the higher level\n-00004710: 206f 6620 7365 6375 7269 7479 2070 726f   of security pro\n-00004720: 7669 6465 6420 6279 0a47 5047 2e20 2057  vided by.GPG.  W\n-00004730: 6865 6e20 7365 6c65 6374 6564 2c20 6164  hen selected, ad\n-00004740: 6469 7469 6f6e 616c 2070 6172 616d 6574  ditional paramet\n-00004750: 6572 7320 7375 6368 2061 7320 5f72 6563  ers such as _rec\n-00004760: 6970 6965 6e74 5f20 616e 640a 5f73 6967  ipient_ and._sig\n-00004770: 6e65 725f 206d 6179 2062 6520 7365 7420  ner_ may be set \n-00004780: 6173 2077 656c 6c2e 2020 5365 6520 2a6e  as well.  See *n\n-00004790: 6f74 6520 5365 7474 696e 6720 5350 4120  ote Setting SPA \n-000047a0: 4461 7461 3a3a 2066 6f72 2064 6574 6169  Data:: for detai\n-000047b0: 6c20 6f6e 0a73 6574 7469 6e67 2074 6865  l on.setting the\n-000047c0: 7365 2061 6e64 206f 7468 6572 2053 5041  se and other SPA\n-000047d0: 2064 6174 6120 6669 656c 6473 2e0a 0a1f   data fields....\n-000047e0: 0a46 696c 653a 206c 6962 666b 6f2e 696e  .File: libfko.in\n-000047f0: 666f 2c20 204e 6f64 653a 2048 4d41 4320  fo,  Node: HMAC \n-00004800: 4469 6765 7374 732c 2020 5072 6576 3a20  Digests,  Prev: \n-00004810: 456e 6372 7970 7469 6f6e 2041 6c67 6f72  Encryption Algor\n-00004820: 6974 686d 732c 2020 5570 3a20 5350 4120  ithms,  Up: SPA \n-00004830: 5061 7261 6d65 7465 7220 5479 7065 730a  Parameter Types.\n-00004840: 0a32 2e33 2e34 2048 4d41 4320 4469 6765  .2.3.4 HMAC Dige\n-00004850: 7374 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  sts.------------\n-00004860: 2d2d 2d2d 2d2d 0a0a 5468 6520 6677 6b6e  ------..The fwkn\n-00004870: 6f70 2070 726f 6a65 6374 2065 6d70 6c6f  op project emplo\n-00004880: 7973 2061 6e20 484d 4143 2069 6e20 7468  ys an HMAC in th\n-00004890: 6520 656e 6372 7970 742d 7468 656e 2d61  e encrypt-then-a\n-000048a0: 7574 6865 6e74 6963 6174 650a 6d6f 6465  uthenticate.mode\n-000048b0: 6c20 666f 7220 7374 726f 6e67 2053 5041  l for strong SPA\n-000048c0: 206d 6573 7361 6765 2061 7574 6865 6e74   message authent\n-000048d0: 6963 6174 696f 6e2e 2020 5468 6520 484d  ication.  The HM\n-000048e0: 4143 2069 7473 656c 6620 6973 2064 6572  AC itself is der\n-000048f0: 6976 6564 0a66 726f 6d20 6120 6469 6765  ived.from a dige\n-00004900: 7374 206f 6620 7468 6520 656e 6372 7970  st of the encryp\n-00004910: 7465 6420 5350 4120 6d65 7373 6167 6520  ted SPA message \n-00004920: 616c 6f6e 6720 7769 7468 2061 2064 6564  along with a ded\n-00004930: 6963 6174 6564 2048 4d41 430a 6b65 792e  icated HMAC.key.\n-00004940: 0a0a 2020 2043 7572 7265 6e74 6c79 2c20  ..   Currently, \n-00004950: 6c69 6266 6b6f 2073 7570 706f 7274 7320  libfko supports \n-00004960: 7468 6520 7361 6d65 206d 6573 7361 6765  the same message\n-00004970: 2064 6967 6573 7473 2061 7320 6d65 6e74   digests as ment\n-00004980: 696f 6e65 6420 696e 0a74 6865 2044 6967  ioned in.the Dig\n-00004990: 6573 7420 7365 6374 696f 6e20 6162 6f76  est section abov\n-000049a0: 652c 2061 6e64 2074 6865 7365 2061 7265  e, and these are\n-000049b0: 2028 696e 206f 7264 6572 206f 6620 7374   (in order of st\n-000049c0: 7265 6e67 7468 293a 0a0a 202d 2d20 5661  rength):.. -- Va\n-000049d0: 7269 6162 6c65 3a20 696e 7420 666b 6f5f  riable: int fko_\n-000049e0: 6469 6765 7374 5f74 7970 655f 740a 2020  digest_type_t.  \n-000049f0: 2020 2027 464b 4f5f 484d 4143 5f4d 4435     'FKO_HMAC_MD5\n-00004a00: 270a 2020 2020 2027 464b 4f5f 484d 4143  '.     'FKO_HMAC\n-00004a10: 5f53 4841 3127 0a20 2020 2020 2746 4b4f  _SHA1'.     'FKO\n-00004a20: 5f48 4d41 435f 5348 4132 3536 2028 6c69  _HMAC_SHA256 (li\n-00004a30: 6266 6b6f 2064 6566 6175 6c74 2927 0a20  bfko default)'. \n-00004a40: 2020 2020 2746 4b4f 5f48 4d41 435f 5348      'FKO_HMAC_SH\n-00004a50: 4133 3834 270a 2020 2020 2027 464b 4f5f  A384'.     'FKO_\n-00004a60: 484d 4143 5f53 4841 3531 3227 0a0a 2020  HMAC_SHA512'..  \n-00004a70: 2041 7320 696e 6469 6361 7465 6420 696e   As indicated in\n-00004a80: 2074 6865 206c 6973 7420 6162 6f76 652c   the list above,\n-00004a90: 2053 4841 3235 3620 6973 2074 6865 2064   SHA256 is the d\n-00004aa0: 6566 6175 6c74 2e20 2054 6869 7320 6d65  efault.  This me\n-00004ab0: 616e 730a 7468 6520 484d 4143 2064 6967  ans.the HMAC dig\n-00004ac0: 6573 7420 7479 7065 2064 6f65 7320 6e6f  est type does no\n-00004ad0: 7420 6e65 6564 2074 6f20 6265 2065 7870  t need to be exp\n-00004ae0: 6c69 6369 746c 7920 7365 7420 756e 6c65  licitly set unle\n-00004af0: 7373 2079 6f75 2077 6973 680a 746f 2075  ss you wish.to u\n-00004b00: 7365 206f 6e65 206f 6620 7468 6520 6f74  se one of the ot\n-00004b10: 6865 7220 7661 6c75 6573 2e20 2054 6869  her values.  Thi\n-00004b20: 7320 6170 706c 6965 7320 746f 2061 6c6c  s applies to all\n-00004b30: 206c 6962 666b 6f20 5350 4120 6461 7461   libfko SPA data\n-00004b40: 0a66 6965 6c64 7320 7468 6174 2068 6176  .fields that hav\n-00004b50: 6520 6120 6465 6661 756c 7420 7661 6c75  e a default valu\n-00004b60: 652e 0a0a 1f0a 4669 6c65 3a20 6c69 6266  e.....File: libf\n-00004b70: 6b6f 2e69 6e66 6f2c 2020 4e6f 6465 3a20  ko.info,  Node: \n-00004b80: 5573 696e 6720 6c69 6266 6b6f 2c20 204e  Using libfko,  N\n-00004b90: 6578 743a 204c 6962 7261 7279 2043 6f70  ext: Library Cop\n-00004ba0: 7969 6e67 2c20 2050 7265 763a 2050 7265  ying,  Prev: Pre\n-00004bb0: 7061 7261 7469 6f6e 2c20 2055 703a 2054  paration,  Up: T\n-00004bc0: 6f70 0a0a 3320 5573 696e 6720 6c69 6266  op..3 Using libf\n-00004bd0: 6b6f 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ko.*************\n-00004be0: 2a0a 0a54 6869 7320 6368 6170 7465 7220  *..This chapter \n-00004bf0: 7072 6f76 6964 6573 2074 6865 2022 686f  provides the \"ho\n-00004c00: 7774 6f22 2066 6f72 2075 7369 6e67 206c  wto\" for using l\n-00004c10: 6962 666b 6f2c 2069 6e63 6c75 6469 6e67  ibfko, including\n-00004c20: 2072 6571 7569 7265 640a 6675 6e63 7469   required.functi\n-00004c30: 6f6e 7320 616e 6420 7061 7261 6d65 7465  ons and paramete\n-00004c40: 7220 6368 6f69 6365 732e 2020 496e 2073  r choices.  In s\n-00004c50: 6f6d 6520 7365 6374 696f 6e73 2c20 636f  ome sections, co\n-00004c60: 6465 2073 616d 706c 6573 2061 7265 0a70  de samples are.p\n-00004c70: 726f 7669 6465 6420 746f 2066 7572 7468  rovided to furth\n-00004c80: 6572 2069 6c6c 7573 7472 6174 6520 7573  er illustrate us\n-00004c90: 6167 652e 0a0a 2a20 4d65 6e75 3a0a 0a2a  age...* Menu:..*\n-00004ca0: 2043 7265 6174 696e 6720 436f 6e74 6578   Creating Contex\n-00004cb0: 7473 3a3a 2020 2020 2020 2020 2020 2020  ts::            \n-00004cc0: 2043 7265 6174 696e 6720 6120 6e65 7720   Creating a new \n-00004cd0: 666b 6f20 636f 6e74 6578 740a 2a20 4465  fko context.* De\n-00004ce0: 7374 726f 7969 6e67 2043 6f6e 7465 7874  stroying Context\n-00004cf0: 733a 3a20 2020 2020 2020 2020 2020 5265  s::           Re\n-00004d00: 6c65 6173 696e 6720 616e 2066 6b6f 2063  leasing an fko c\n-00004d10: 6f6e 7465 7874 0a2a 2043 7265 6174 696e  ontext.* Creatin\n-00004d20: 6720 6120 5350 4120 4d65 7373 6167 653a  g a SPA Message:\n-00004d30: 3a20 2020 2020 2020 2057 6861 7420 6974  :        What it\n-00004d40: 2074 616b 6573 2074 6f20 6372 6561 7465   takes to create\n-00004d50: 2061 2053 5041 0a20 2020 2020 2020 2020   a SPA.         \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 00004d60: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00004d70: 2020 2020 2020 2020 206d 6573 7361 6765           message\n-00004d80: 0a2a 2053 6574 7469 6e67 2053 5041 2044  .* Setting SPA D\n-00004d90: 6174 613a 3a20 2020 2020 2020 2020 2020  ata::           \n-00004da0: 2020 2053 6574 7469 6e67 2053 5041 2064     Setting SPA d\n-00004db0: 6174 610a 2a20 5265 7472 6965 7669 6e67  ata.* Retrieving\n-00004dc0: 2053 5041 2044 6174 613a 3a20 2020 2020   SPA Data::     \n-00004dd0: 2020 2020 2020 5265 7472 6965 7669 6e67        Retrieving\n-00004de0: 2053 5041 2064 6174 610a 2a20 5574 696c   SPA data.* Util\n-00004df0: 6974 7920 4675 6e63 7469 6f6e 733a 3a20  ity Functions:: \n-00004e00: 2020 2020 2020 2020 2020 2020 4f74 6865              Othe\n-00004e10: 7220 7574 696c 6974 792c 206d 6973 6365  r utility, misce\n-00004e20: 6c6c 616e 656f 7573 2c20 616e 6420 7365  llaneous, and se\n-00004e30: 6c64 6f6d 0a20 2020 2020 2020 2020 2020  ldom.           \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 00004e40: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00004e50: 2020 2020 2020 2075 7365 6420 6675 6e63         used func\n-00004e60: 7469 6f6e 730a 2a20 4572 726f 7220 4861  tions.* Error Ha\n-00004e70: 6e64 6c69 6e67 3a3a 2020 2020 2020 2020  ndling::        \n-00004e80: 2020 2020 2020 2020 506f 7373 6962 6c65          Possible\n-00004e90: 2065 7272 6f72 7320 616e 6420 7468 6569   errors and thei\n-00004ea0: 7220 6d65 616e 696e 670a 0a1f 0a46 696c  r meaning....Fil\n-00004eb0: 653a 206c 6962 666b 6f2e 696e 666f 2c20  e: libfko.info, \n-00004ec0: 204e 6f64 653a 2043 7265 6174 696e 6720   Node: Creating \n-00004ed0: 436f 6e74 6578 7473 2c20 204e 6578 743a  Contexts,  Next:\n-00004ee0: 2044 6573 7472 6f79 696e 6720 436f 6e74   Destroying Cont\n-00004ef0: 6578 7473 2c20 2055 703a 2055 7369 6e67  exts,  Up: Using\n-00004f00: 206c 6962 666b 6f0a 0a33 2e31 2043 7265   libfko..3.1 Cre\n-00004f10: 6174 696e 6720 436f 6e74 6578 7473 0a3d  ating Contexts.=\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 00004f20: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================\n-00004f30: 3d3d 3d3d 0a0a 4265 666f 7265 2064 6f69  ====..Before doi\n-00004f40: 6e67 2061 6e79 7468 696e 6720 7769 7468  ng anything with\n-00004f50: 206c 6962 666b 6f2c 2079 6f75 206e 6565   libfko, you nee\n-00004f60: 6420 746f 2063 7265 6174 6520 6120 636f  d to create a co\n-00004f70: 6e74 6578 742e 2020 410a 636f 6e74 6578  ntext.  A.contex\n-00004f80: 7420 6973 2063 7265 6174 6564 2066 6f72  t is created for\n-00004f90: 206f 6e65 206f 6620 7477 6f20 7265 6173   one of two reas\n-00004fa0: 6f6e 732e 2020 4f6e 6520 6973 2066 6f72  ons.  One is for\n-00004fb0: 2074 6865 2070 7572 706f 7365 206f 660a   the purpose of.\n-00004fc0: 6275 696c 6469 6e67 2061 206e 6577 2066  building a new f\n-00004fd0: 6b6f 2053 5041 206d 6573 7361 6765 2066  ko SPA message f\n-00004fe0: 726f 6d20 7363 7261 7463 6820 2874 7970  rom scratch (typ\n-00004ff0: 6963 616c 6c79 2074 6f20 6265 2070 6163  ically to be pac\n-00005000: 6b61 6765 640a 616e 6420 7365 6e74 2074  kaged.and sent t\n-00005010: 6f20 616e 2066 776b 6e6f 7020 7365 7276  o an fwknop serv\n-00005020: 6572 2073 6f6d 6577 6865 7265 292e 2020  er somewhere).  \n-00005030: 5468 6520 6f74 6865 7220 776f 756c 6420  The other would \n-00005040: 6265 2061 2063 6f6e 7465 7874 0a66 6f72  be a context.for\n-00005050: 2074 616b 696e 6720 616e 2065 7869 7374   taking an exist\n-00005060: 696e 6720 5350 4120 6d65 7373 6167 6520  ing SPA message \n-00005070: 666f 7220 6465 636f 6469 6e67 2c20 7061  for decoding, pa\n-00005080: 7273 696e 672c 2061 6e64 2064 6174 610a  rsing, and data.\n-00005090: 6578 7472 6163 7469 6f6e 2e0a 0a46 6f72  extraction...For\n-000050a0: 2062 7569 6c64 696e 6720 6120 6e65 7720   building a new \n-000050b0: 666b 6f20 5350 4120 6d65 7373 6167 652c  fko SPA message,\n-000050c0: 2079 6f75 2077 696c 6c20 7573 6520 7468   you will use th\n-000050d0: 6520 2766 6b6f 5f6e 6577 2720 6675 6e63  e 'fko_new' func\n-000050e0: 7469 6f6e 3a0a 0a20 2d2d 2046 756e 6374  tion:.. -- Funct\n-000050f0: 696f 6e3a 2069 6e74 2066 6b6f 5f6e 6577  ion: int fko_new\n-00005100: 2028 666b 6f5f 6374 785f 7420 2a43 5458   (fko_ctx_t *CTX\n-00005110: 290a 2020 2020 2054 6865 2066 756e 6374  ).     The funct\n-00005120: 696f 6e20 2766 6b6f 5f6e 6577 2720 7365  ion 'fko_new' se\n-00005130: 7473 2075 7020 616e 6420 696e 6974 6961  ts up and initia\n-00005140: 6c69 7a65 7320 6120 6e65 7720 2766 6b6f  lizes a new 'fko\n-00005150: 5f63 7478 5f74 270a 2020 2020 206f 626a  _ctx_t'.     obj\n-00005160: 6563 742c 2070 7265 2d70 6f70 756c 6174  ect, pre-populat\n-00005170: 6573 2064 6566 6175 6c74 2076 616c 7565  es default value\n-00005180: 7320 616e 6420 7265 7475 726e 7320 6120  s and returns a \n-00005190: 6861 6e64 6c65 2066 6f72 2069 7420 696e  handle for it in\n-000051a0: 0a20 2020 2020 4354 582e 2020 5468 6520  .     CTX.  The \n-000051b0: 6675 6e63 7469 6f6e 2072 6574 7572 6e73  function returns\n-000051c0: 2074 6865 2065 7272 6f72 2063 6f64 6520   the error code \n-000051d0: 2746 4b4f 5f53 5543 4345 5353 2720 6966  'FKO_SUCCESS' if\n-000051e0: 2074 6865 0a20 2020 2020 636f 6e74 6578   the.     contex\n-000051f0: 7420 7761 7320 7375 6363 6573 7366 756c  t was successful\n-00005200: 6c79 2063 7265 6174 6564 2e20 204f 7468  ly created.  Oth\n-00005210: 6572 7769 7365 2061 6e20 616e 6f74 6865  erwise an anothe\n-00005220: 7220 6572 726f 7220 636f 6465 0a20 2020  r error code.   \n-00005230: 2020 7769 6c6c 2062 6520 7265 7475 726e    will be return\n-00005240: 6564 2028 2a6e 6f74 6520 4572 726f 7220  ed (*note Error \n-00005250: 4861 6e64 6c69 6e67 3a3a 2066 6f72 2064  Handling:: for d\n-00005260: 6574 6169 6c73 206f 6e20 7468 6520 7661  etails on the va\n-00005270: 7269 6f75 730a 2020 2020 2065 7272 6f72  rious.     error\n-00005280: 2063 6f64 6573 2061 6e64 2074 6865 6972   codes and their\n-00005290: 206d 6561 6e69 6e67 7329 2e0a 0a20 2020   meanings)...   \n-000052a0: 2020 666b 6f5f 6374 785f 7420 2020 6374    fko_ctx_t   ct\n-000052b0: 783b 0a20 2020 2020 696e 7420 2020 2020  x;.     int     \n-000052c0: 2020 2020 7263 3b0a 0a20 2020 2020 7263      rc;..     rc\n-000052d0: 203d 2066 6b6f 5f6e 6577 2826 6374 7829   = fko_new(&ctx)\n-000052e0: 3b0a 0a20 2020 2020 6966 2872 6320 213d  ;..     if(rc !=\n-000052f0: 2046 4b4f 5f53 5543 4345 5353 290a 2020   FKO_SUCCESS).  \n-00005300: 2020 207b 0a20 2020 2020 2020 2020 6670     {.         fp\n-00005310: 7269 6e74 6628 7374 6465 7272 2c20 2245  rintf(stderr, \"E\n-00005320: 7272 6f72 2025 6920 6672 6f6d 2066 6b6f  rror %i from fko\n-00005330: 5f6e 6577 3a20 2573 5c6e 222c 0a20 2020  _new: %s\\n\",.   \n-00005340: 2020 2020 2020 2020 2020 7263 2c20 666b            rc, fk\n-00005350: 6f5f 6572 7273 7472 2872 6329 293b 0a20  o_errstr(rc));. \n-00005360: 2020 2020 2020 2020 6578 6974 2831 293b          exit(1);\n-00005370: 0a20 2020 2020 7d0a 0a46 6f72 2061 2063  .     }..For a c\n-00005380: 6f6e 7465 7874 2074 6861 7420 7769 6c6c  ontext that will\n-00005390: 2062 6520 7573 6564 2066 6f72 2072 6563   be used for rec\n-000053a0: 6569 7669 6e67 2061 6e64 2070 6172 7369  eiving and parsi\n-000053b0: 6e67 2061 6e20 6578 6973 7469 6e67 0a53  ng an existing.S\n-000053c0: 5041 206d 6573 7361 6765 2c20 796f 7520  PA message, you \n-000053d0: 7769 6c6c 2075 7365 2074 6865 2027 666b  will use the 'fk\n-000053e0: 6f5f 6e65 775f 7769 7468 5f64 6174 6127  o_new_with_data'\n-000053f0: 2066 756e 6374 696f 6e3a 0a0a 202d 2d20   function:.. -- \n-00005400: 4675 6e63 7469 6f6e 3a20 696e 7420 666b  Function: int fk\n-00005410: 6f5f 6e65 775f 7769 7468 5f64 6174 6120  o_new_with_data \n-00005420: 2866 6b6f 5f63 7478 5f74 202a 4354 582c  (fko_ctx_t *CTX,\n-00005430: 2063 6f6e 7374 2063 6861 7220 2a44 4154   const char *DAT\n-00005440: 412c 0a20 2020 2020 2020 2020 2063 6f6e  A,.          con\n-00005450: 7374 2063 6861 7220 2a4b 4559 2c20 636f  st char *KEY, co\n-00005460: 6e73 7420 6368 6172 204b 4559 5f4c 454e  nst char KEY_LEN\n-00005470: 2c20 696e 7420 454e 4352 5950 5449 4f4e  , int ENCRYPTION\n-00005480: 5f4d 4f44 452c 0a20 2020 2020 2020 2020  _MODE,.         \n-00005490: 2063 6f6e 7374 2063 6861 7220 484d 4143   const char HMAC\n-000054a0: 5f4b 4559 2c20 636f 6e73 7420 696e 7420  _KEY, const int \n-000054b0: 484d 4143 5f54 5950 4529 0a0a 2020 2020  HMAC_TYPE)..    \n-000054c0: 2054 6865 2066 756e 6374 696f 6e20 2766   The function 'f\n-000054d0: 6b6f 5f6e 6577 5f77 6974 685f 6461 7461  ko_new_with_data\n-000054e0: 2720 7365 7473 2075 7020 616e 6420 696e  ' sets up and in\n-000054f0: 6974 6961 6c69 7a65 7320 6120 6e65 770a  itializes a new.\n-00005500: 2020 2020 2027 666b 6f5f 6374 785f 7427       'fko_ctx_t'\n-00005510: 2063 6f6e 7465 7874 2c20 6275 7420 696e   context, but in\n-00005520: 7374 6561 6420 6f66 2069 6e69 7469 616c  stead of initial\n-00005530: 697a 696e 6720 6465 6661 756c 7420 7661  izing default va\n-00005540: 6c75 6573 2c20 6974 0a20 2020 2020 7374  lues, it.     st\n-00005550: 6f72 6573 2074 6865 2065 6e63 7279 7074  ores the encrypt\n-00005560: 6564 206d 6573 7361 6765 2064 6174 6120  ed message data \n-00005570: 616e 6420 6d61 6b65 7320 6974 2072 6561  and makes it rea\n-00005580: 6479 2066 6f72 2070 6172 7369 6e67 2e0a  dy for parsing..\n-00005590: 2020 2020 2054 6869 7320 6361 6e20 6265       This can be\n-000055a0: 2064 6f6e 6520 696e 206f 6e65 206f 6620   done in one of \n-000055b0: 7477 6f20 7761 7973 2e20 204f 6e65 2069  two ways.  One i\n-000055c0: 7320 746f 2070 6173 7320 274e 554c 4c27  s to pass 'NULL'\n-000055d0: 2066 6f72 2074 6865 0a20 2020 2020 7468   for the.     th\n-000055e0: 6972 6420 6172 6775 6d65 6e74 2e20 2054  ird argument.  T\n-000055f0: 6865 2063 6f6e 7465 7874 2077 696c 6c20  he context will \n-00005600: 6265 2063 7265 6174 6564 2061 6e64 2074  be created and t\n-00005610: 6865 2064 6174 6120 7769 6c6c 2062 650a  he data will be.\n-00005620: 2020 2020 2073 746f 7265 642c 2062 7574       stored, but\n-00005630: 206e 6f20 6465 6372 7970 7469 6f6e 206f   no decryption o\n-00005640: 7220 6465 636f 6469 6e67 2074 616b 6573  r decoding takes\n-00005650: 2070 6c61 6365 2e20 2049 6e20 7468 6973   place.  In this\n-00005660: 2063 6173 652c 0a20 2020 2020 796f 7520   case,.     you \n-00005670: 7769 6c6c 206e 6565 6420 746f 2063 616c  will need to cal\n-00005680: 6c20 2766 6b6f 5f64 6563 7279 7074 5f73  l 'fko_decrypt_s\n-00005690: 7061 5f64 6174 6127 2061 7420 6120 6c61  pa_data' at a la\n-000056a0: 7465 7220 7469 6d65 2e20 2054 6865 0a20  ter time.  The. \n-000056b0: 2020 2020 6f74 6865 7220 7761 7920 746f      other way to\n-000056c0: 2064 6f20 6974 2069 7320 746f 2073 7570   do it is to sup\n-000056d0: 706c 7920 7468 6520 4b45 5920 7661 6c75  ply the KEY valu\n-000056e0: 6520 2864 6563 7279 7074 696f 6e0a 2020  e (decryption.  \n-000056f0: 2020 2070 6173 7370 6872 6173 6529 2061     passphrase) a\n-00005700: 6e64 2061 7373 6f63 6174 6564 206c 656e  nd assocated len\n-00005710: 6774 682e 2020 496e 2074 6869 7320 6361  gth.  In this ca\n-00005720: 7365 2c20 7468 6520 636f 6e74 6578 7420  se, the context \n-00005730: 6973 0a20 2020 2020 6372 6561 7465 642c  is.     created,\n-00005740: 2074 6865 2053 5041 2064 6174 6120 6973   the SPA data is\n-00005750: 2064 6563 7279 7074 6564 2c20 6465 636f   decrypted, deco\n-00005760: 6465 642c 2070 6172 7365 642c 2061 6e64  ded, parsed, and\n-00005770: 2073 746f 7265 6420 696e 0a20 2020 2020   stored in.     \n-00005780: 7468 6520 636f 6e74 6578 7420 7265 6164  the context read\n-00005790: 7920 666f 7220 7265 7472 6965 7661 6c2e  y for retrieval.\n-000057a0: 2020 4966 2061 6e20 484d 4143 2069 7320    If an HMAC is \n-000057b0: 616c 736f 2064 6573 6972 6564 206f 720a  also desired or.\n-000057c0: 2020 2020 2072 6571 7569 7265 642c 2074       required, t\n-000057d0: 6865 6e20 7468 6520 484d 4143 5f4b 4559  hen the HMAC_KEY\n-000057e0: 2061 6e64 2061 7373 6f63 6961 7465 6420   and associated \n-000057f0: 6c65 6e67 7468 2063 616e 2062 6520 7061  length can be pa\n-00005800: 7373 6564 2069 6e2e 0a20 2020 2020 5468  ssed in..     Th\n-00005810: 6973 2077 696c 6c20 6361 7573 6520 6c69  is will cause li\n-00005820: 6266 6b6f 2074 6f20 6175 7468 656e 7469  bfko to authenti\n-00005830: 6361 7465 2074 6865 2053 5041 2064 6174  cate the SPA dat\n-00005840: 6120 6265 666f 7265 0a20 2020 2020 6465  a before.     de\n-00005850: 6372 7970 7469 6f6e 2069 7320 6174 7465  cryption is atte\n-00005860: 6d70 7465 642c 2061 6e64 2074 6869 7320  mpted, and this \n-00005870: 6973 2073 7472 6f6e 676c 7920 7265 636f  is strongly reco\n-00005880: 6d6d 656e 6465 6420 746f 2064 6f2e 0a0a  mmended to do...\n-00005890: 2020 2020 2054 6865 2027 666b 6f5f 6e65       The 'fko_ne\n-000058a0: 775f 7769 7468 5f64 6174 6127 2066 756e  w_with_data' fun\n-000058b0: 6374 696f 6e20 7265 7475 726e 7320 7468  ction returns th\n-000058c0: 6520 6572 726f 7220 636f 6465 0a20 2020  e error code.   \n-000058d0: 2020 2746 4b4f 5f53 5543 4345 5353 2720    'FKO_SUCCESS' \n-000058e0: 6966 2074 6865 2063 6f6e 7465 7874 2077  if the context w\n-000058f0: 6173 2073 7563 6365 7373 6675 6c6c 7920  as successfully \n-00005900: 6372 6561 7465 642e 2020 4966 2061 6e79  created.  If any\n-00005910: 206f 660a 2020 2020 2074 6865 2069 6e74   of.     the int\n-00005920: 6572 6d65 6469 6174 6520 7374 6570 7320  ermediate steps \n-00005930: 696e 2070 6172 7369 6e67 2074 6865 2064  in parsing the d\n-00005940: 6174 612c 2076 616c 6964 6174 696e 6720  ata, validating \n-00005950: 7468 6520 5350 410a 2020 2020 206d 6573  the SPA.     mes\n-00005960: 7361 6765 2064 6967 6573 742c 206f 7220  sage digest, or \n-00005970: 616e 7920 6f74 6865 7220 696e 7465 726e  any other intern\n-00005980: 616c 2061 6374 696f 6e20 6661 696c 732c  al action fails,\n-00005990: 2074 6865 6e20 7468 650a 2020 2020 2061   then the.     a\n-000059a0: 7070 726f 7072 6961 7465 2065 7272 6f72  ppropriate error\n-000059b0: 2063 6f64 6520 6973 2072 6574 7572 6e65   code is returne\n-000059c0: 642e 0a0a 5468 6520 6d6f 7374 2063 6f6d  d...The most com\n-000059d0: 6d6f 6e20 2873 696d 706c 6529 2063 6173  mon (simple) cas\n-000059e0: 652e 2e2e 0a0a 2020 2020 2066 6b6f 5f63  e.....     fko_c\n-000059f0: 7478 5f74 2020 2063 7478 3b0a 2020 2020  tx_t   ctx;.    \n-00005a00: 2063 6861 7220 2020 2020 2020 2a73 7061   char       *spa\n-00005a10: 5f64 6174 613b 0a20 2020 2020 6368 6172  _data;.     char\n-00005a20: 2020 2020 2020 202a 6b65 793b 0a20 2020         *key;.   \n-00005a30: 2020 696e 7420 2020 2020 2020 2020 6b65    int         ke\n-00005a40: 795f 6c65 6e3b 0a20 2020 2020 6368 6172  y_len;.     char\n-00005a50: 2020 2020 2020 202a 686d 6163 5f6b 6579         *hmac_key\n-00005a60: 3b0a 2020 2020 2069 6e74 2020 2020 2020  ;.     int      \n-00005a70: 2020 2068 6d61 635f 6b65 795f 6c65 6e3b     hmac_key_len;\n-00005a80: 0a20 2020 2020 696e 7420 2020 2020 2020  .     int       \n-00005a90: 2020 686d 6163 5f74 7970 6520 3d20 464b    hmac_type = FK\n-00005aa0: 4f5f 484d 4143 5f53 4841 3235 363b 0a20  O_HMAC_SHA256;. \n-00005ab0: 2020 2020 696e 7420 2020 2020 2020 2020      int         \n-00005ac0: 656e 635f 6d6f 6465 2020 3d20 464b 4f5f  enc_mode  = FKO_\n-00005ad0: 454e 435f 4d4f 4445 5f43 4243 3b0a 2020  ENC_MODE_CBC;.  \n-00005ae0: 2020 2069 6e74 2072 633b 0a0a 2020 2020     int rc;..    \n-00005af0: 202f 2a20 4173 7375 6d65 2077 6520 6361   /* Assume we ca\n-00005b00: 6c6c 6564 2063 6f64 6520 7468 6174 2072  lled code that r\n-00005b10: 6574 7269 6576 6573 2074 6865 2064 6174  etrieves the dat\n-00005b20: 6120 616e 6420 6b65 790a 2020 2020 202a  a and key.     *\n-00005b30: 2f0a 0a20 2020 2020 7263 203d 2066 6b6f  /..     rc = fko\n-00005b40: 5f6e 6577 5f77 6974 685f 6461 7461 2826  _new_with_data(&\n-00005b50: 6374 782c 2073 7061 5f64 6174 612c 206b  ctx, spa_data, k\n-00005b60: 6579 2c20 6b65 795f 6c65 6e2c 205c 5c0a  ey, key_len, \\\\.\n-00005b70: 2020 2020 2020 2020 2065 6e63 5f6d 6f64           enc_mod\n-00005b80: 652c 2068 6d61 635f 6b65 792c 2068 6d61  e, hmac_key, hma\n-00005b90: 635f 6b65 795f 6c65 6e2c 2068 6d61 635f  c_key_len, hmac_\n-00005ba0: 7479 7065 293b 0a0a 2020 2020 2069 6628  type);..     if(\n-00005bb0: 7263 2021 3d20 464b 4f5f 5355 4343 4553  rc != FKO_SUCCES\n-00005bc0: 5329 0a20 2020 2020 7b0a 2020 2020 2020  S).     {.      \n-00005bd0: 2020 2066 7072 696e 7466 2873 7464 6572     fprintf(stder\n-00005be0: 722c 2022 4572 726f 7220 2569 2066 726f  r, \"Error %i fro\n-00005bf0: 6d20 666b 6f5f 6e65 775f 7769 7468 5f64  m fko_new_with_d\n-00005c00: 6174 613a 2025 735c 6e22 2c0a 2020 2020  ata: %s\\n\",.    \n-00005c10: 2020 2020 2020 2020 2072 632c 2066 6b6f           rc, fko\n-00005c20: 6572 7273 7472 2872 6329 293b 0a20 2020  errstr(rc));.   \n-00005c30: 2020 2020 2020 6578 6974 2831 293b 0a20        exit(1);. \n-00005c40: 2020 2020 7d0a 0a4f 722c 2070 6572 6861      }..Or, perha\n-00005c50: 7073 2079 6f75 206e 6565 6420 746f 2064  ps you need to d\n-00005c60: 6566 6572 2064 6563 7279 7074 696f 6e20  efer decryption \n-00005c70: 616e 6420 7061 7273 696e 6720 746f 2061  and parsing to a\n-00005c80: 206c 6174 6572 2070 6f69 6e74 2069 6e0a   later point in.\n-00005c90: 7468 6520 7072 6f67 7261 6d2e 2020 5765  the program.  We\n-00005ca0: 2063 6f75 6c64 2075 7365 2066 6b6f 5f6e   could use fko_n\n-00005cb0: 6577 5f77 6974 685f 6461 7461 2829 2c20  ew_with_data(), \n-00005cc0: 7061 7373 696e 6720 4e55 4c4c 2066 6f72  passing NULL for\n-00005cd0: 2074 6865 0a64 6563 7279 7074 696f 6e20   the.decryption \n-00005ce0: 6b65 7920 616e 6420 484d 4143 206b 6579  key and HMAC key\n-00005cf0: 732c 206f 7220 7765 2063 6f75 6c64 2075  s, or we could u\n-00005d00: 7365 2066 6b6f 5f6e 6577 2829 2074 6f20  se fko_new() to \n-00005d10: 6372 6561 7465 2061 6e0a 656d 7074 7920  create an.empty \n-00005d20: 636f 6e74 6578 742c 2074 6865 6e20 7573  context, then us\n-00005d30: 6520 666b 6f5f 7365 745f 7370 615f 6461  e fko_set_spa_da\n-00005d40: 7461 2829 2074 6f20 6164 6420 7468 6520  ta() to add the \n-00005d50: 656e 6379 7074 6564 2064 6174 6120 2873  encypted data (s\n-00005d60: 6565 0a63 6f6d 6d65 6e74 7320 696e 2074  ee.comments in t\n-00005d70: 6865 2063 6f64 6520 7361 6d70 6c65 7329  he code samples)\n-00005d80: 2e0a 0a20 2020 2020 666b 6f5f 6374 785f  ...     fko_ctx_\n-00005d90: 7420 2020 6374 783b 0a20 2020 2020 6368  t   ctx;.     ch\n-00005da0: 6172 2020 2020 2020 202a 7370 615f 6461  ar       *spa_da\n-00005db0: 7461 3b0a 2020 2020 2063 6861 7220 2020  ta;.     char   \n-00005dc0: 2020 2020 2a6b 6579 3b0a 2020 2020 2069      *key;.     i\n-00005dd0: 6e74 2072 633b 0a0a 2020 2020 202f 2a20  nt rc;..     /* \n-00005de0: 4173 7375 6d65 2077 6520 6361 6c6c 6564  Assume we called\n-00005df0: 2063 6f64 6520 7468 6174 2072 6574 7269   code that retri\n-00005e00: 6576 6573 2074 6865 2064 6174 6120 616e  eves the data an\n-00005e10: 6420 6b65 790a 2020 2020 202a 2f0a 0a20  d key.     */.. \n-00005e20: 2020 2020 7263 203d 2066 6b6f 5f6e 6577      rc = fko_new\n-00005e30: 5f77 6974 685f 6461 7461 2826 6374 782c  _with_data(&ctx,\n-00005e40: 2073 7061 5f64 6174 612c 204e 554c 4c2c   spa_data, NULL,\n-00005e50: 2030 2c0a 2020 2020 2020 2020 2020 2020   0,.            \n-00005e60: 2046 4b4f 5f45 4e43 5f4d 4f44 455f 4342   FKO_ENC_MODE_CB\n-00005e70: 432c 204e 554c 4c2c 2030 2c20 464b 4f5f  C, NULL, 0, FKO_\n-00005e80: 484d 4143 5f53 4841 3235 3629 3b0a 0a20  HMAC_SHA256);.. \n-00005e90: 2020 2020 6966 2872 6320 213d 2046 4b4f      if(rc != FKO\n-00005ea0: 5f53 5543 4345 5353 290a 2020 2020 207b  _SUCCESS).     {\n-00005eb0: 0a20 2020 2020 2020 2020 6670 7269 6e74  .         fprint\n-00005ec0: 6628 7374 6465 7272 2c20 2245 7272 6f72  f(stderr, \"Error\n-00005ed0: 2066 726f 6d20 666b 6f5f 6e65 775f 7769   from fko_new_wi\n-00005ee0: 7468 5f64 6174 613a 2025 735c 6e22 2c0a  th_data: %s\\n\",.\n-00005ef0: 2020 2020 2020 2020 2020 2020 2066 6b6f               fko\n-00005f00: 5f65 7272 7374 7228 7263 2929 3b0a 2020  _errstr(rc));.  \n-00005f10: 2020 2020 2020 2065 7869 7428 3129 3b0a         exit(1);.\n-00005f20: 2020 2020 207d 0a0a 2020 2020 202f 2a20       }..     /* \n-00005f30: 5765 2063 6f75 6c64 2061 6c73 6f20 6a75  We could also ju\n-00005f40: 7374 2063 7265 6174 6520 616e 6420 656d  st create and em\n-00005f50: 7074 7920 636f 6e74 6578 7420 616e 6420  pty context and \n-00005f60: 6164 6420 7468 650a 2020 2020 2020 2a20  add the.      * \n-00005f70: 656e 6372 7970 7465 6420 6461 7461 2061  encrypted data a\n-00005f80: 7320 666f 6c6c 6f77 733a 0a20 2020 2020  s follows:.     \n-00005f90: 202a 0a20 2020 2020 202a 2072 6320 3d20   *.      * rc = \n-00005fa0: 666b 6f5f 6e65 7728 2663 7478 293b 0a20  fko_new(&ctx);. \n-00005fb0: 2020 2020 202a 202e 2e2e 2063 6865 636b       * ... check\n-00005fc0: 2072 6320 2e2e 2e0a 2020 2020 2020 2a20   rc ....      * \n-00005fd0: 7263 203d 2066 6b6f 5f73 6574 5f73 7061  rc = fko_set_spa\n-00005fe0: 5f64 6174 6128 6374 782c 2073 7061 5f64  _data(ctx, spa_d\n-00005ff0: 6174 6129 3b0a 2020 2020 2020 2a20 2e2e  ata);.      * ..\n-00006000: 2e0a 2020 2020 202a 2f0a 0a20 2020 2020  ..     */..     \n-00006010: 2f2a 2041 7373 756d 6520 7765 2063 616c  /* Assume we cal\n-00006020: 6c65 6420 6f74 6865 7220 636f 6465 2061  led other code a\n-00006030: 6e64 2066 756e 6374 696f 6e73 2e2e 2e20  nd functions... \n-00006040: 202a 2f0a 0a20 2020 2020 2f2a 2056 6572   */..     /* Ver\n-00006050: 6966 7920 484d 4143 0a20 2020 2020 2a2f  ify HMAC.     */\n-00006060: 0a20 2020 2020 7263 203d 2066 6b6f 5f76  .     rc = fko_v\n-00006070: 6572 6966 795f 686d 6163 2863 7478 2c20  erify_hmac(ctx, \n-00006080: 686d 6163 5f6b 6579 2c20 686d 6163 5f6b  hmac_key, hmac_k\n-00006090: 6579 5f6c 656e 293b 0a20 2020 2020 6966  ey_len);.     if\n-000060a0: 2872 6320 213d 2046 4b4f 5f53 5543 4345  (rc != FKO_SUCCE\n-000060b0: 5353 290a 2020 2020 207b 0a20 2020 2020  SS).     {.     \n-000060c0: 2020 2020 6670 7269 6e74 6628 7374 6465      fprintf(stde\n-000060d0: 7272 2c20 2245 7272 6f72 2066 726f 6d20  rr, \"Error from \n-000060e0: 666b 6f5f 7665 7269 6679 5f68 6d61 633a  fko_verify_hmac:\n-000060f0: 2025 735c 6e22 2c0a 2020 2020 2020 2020   %s\\n\",.        \n-00006100: 2020 2020 2066 6b6f 5f65 7272 7374 7228       fko_errstr(\n-00006110: 7263 2929 3b0a 2020 2020 2020 2020 2065  rc));.         e\n-00006120: 7869 7428 3129 3b0a 2020 2020 207d 0a0a  xit(1);.     }..\n-00006130: 2020 2020 202f 2a20 4465 6372 7970 7420       /* Decrypt \n-00006140: 616e 6420 6465 636f 6465 2e2e 2e0a 2020  and decode....  \n-00006150: 2020 202a 2f0a 2020 2020 2072 6320 3d20     */.     rc = \n-00006160: 666b 6f5f 6465 6372 7970 745f 7370 615f  fko_decrypt_spa_\n-00006170: 6461 7461 2863 7478 2c20 6b65 792c 206b  data(ctx, key, k\n-00006180: 6579 5f6c 656e 293b 0a0a 2020 2020 2069  ey_len);..     i\n-00006190: 6628 7263 2021 3d20 464b 4f5f 5355 4343  f(rc != FKO_SUCC\n-000061a0: 4553 5329 0a20 2020 2020 7b0a 2020 2020  ESS).     {.    \n-000061b0: 2020 2020 2066 7072 696e 7466 2873 7464       fprintf(std\n-000061c0: 6572 722c 2022 4572 726f 7220 6672 6f6d  err, \"Error from\n-000061d0: 2066 6b6f 5f64 6563 7279 7074 5f73 7061   fko_decrypt_spa\n-000061e0: 5f64 6174 613a 2025 735c 6e22 2c0a 2020  _data: %s\\n\",.  \n-000061f0: 2020 2020 2020 2020 2020 2066 6b6f 5f65             fko_e\n-00006200: 7272 7374 7228 7263 2929 3b0a 2020 2020  rrstr(rc));.    \n-00006210: 2020 2020 2065 7869 7428 3129 3b0a 2020       exit(1);.  \n-00006220: 2020 207d 0a0a 1f0a 4669 6c65 3a20 6c69     }....File: li\n-00006230: 6266 6b6f 2e69 6e66 6f2c 2020 4e6f 6465  bfko.info,  Node\n-00006240: 3a20 4465 7374 726f 7969 6e67 2043 6f6e  : Destroying Con\n-00006250: 7465 7874 732c 2020 4e65 7874 3a20 4372  texts,  Next: Cr\n-00006260: 6561 7469 6e67 2061 2053 5041 204d 6573  eating a SPA Mes\n-00006270: 7361 6765 2c20 2050 7265 763a 2043 7265  sage,  Prev: Cre\n-00006280: 6174 696e 6720 436f 6e74 6578 7473 2c20  ating Contexts, \n-00006290: 2055 703a 2055 7369 6e67 206c 6962 666b   Up: Using libfk\n-000062a0: 6f0a 0a33 2e32 2044 6573 7472 6f79 696e  o..3.2 Destroyin\n-000062b0: 6720 436f 6e74 6578 7473 0a3d 3d3d 3d3d  g Contexts.=====\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: 3d3d 0a0a 5768 656e 2079 6f75 2061 7265  ==..When you are\n-000062e0: 2064 6f6e 6520 7769 7468 2074 6865 2063   done with the c\n-000062f0: 6f6e 7465 7874 2c20 796f 7520 6d75 7374  ontext, you must\n-00006300: 2064 6573 7472 6f79 2069 7420 696e 206f   destroy it in o\n-00006310: 7264 6572 2074 6f20 6672 6565 0a75 7020  rder to free.up \n-00006320: 7468 6520 6d65 6d6f 7279 2061 6e64 2072  the memory and r\n-00006330: 6573 6f75 7263 6573 2069 7420 7761 7320  esources it was \n-00006340: 7573 696e 672e 2020 5468 6973 2069 7320  using.  This is \n-00006350: 6573 7065 6369 616c 6c79 2069 6d70 6f72  especially impor\n-00006360: 7461 6e74 0a69 6e20 7072 6f67 7261 6d73  tant.in programs\n-00006370: 2074 6861 7420 7072 6f63 6573 7320 5350   that process SP\n-00006380: 4120 6461 7461 2072 6570 6561 7465 646c  A data repeatedl\n-00006390: 7920 2869 2e65 2e20 2069 6e20 6120 6c6f  y (i.e.  in a lo\n-000063a0: 6f70 292e 2020 4661 696c 7572 650a 746f  op).  Failure.to\n-000063b0: 2064 6573 7472 6f79 2074 6865 2063 6f6e   destroy the con\n-000063c0: 7465 7874 2063 616e 2063 6175 7365 206d  text can cause m\n-000063d0: 656d 6f72 7920 6c65 616b 7320 696e 2079  emory leaks in y\n-000063e0: 6f75 7220 7072 6f67 7261 6d2e 0a0a 202d  our program... -\n-000063f0: 2d20 4675 6e63 7469 6f6e 3a20 766f 6964  - Function: void\n-00006400: 2066 6b6f 5f64 6573 7472 6f79 2028 666b   fko_destroy (fk\n-00006410: 6f5f 6374 785f 7420 4354 5829 0a20 2020  o_ctx_t CTX).   \n-00006420: 2020 5468 6520 6675 6e63 7469 6f6e 2027    The function '\n-00006430: 666b 6f5f 6465 7374 726f 7927 2064 6573  fko_destroy' des\n-00006440: 7472 6f79 7320 7468 6520 636f 6e74 6578  troys the contex\n-00006450: 7420 7769 7468 2074 6865 2068 616e 646c  t with the handl\n-00006460: 6520 4354 580a 2020 2020 2061 6e64 2072  e CTX.     and r\n-00006470: 656c 6561 7365 7320 616c 6c20 6173 736f  eleases all asso\n-00006480: 6369 6174 6564 2072 6573 6f75 7263 6573  ciated resources\n-00006490: 2e0a 0a1f 0a46 696c 653a 206c 6962 666b  .....File: libfk\n-000064a0: 6f2e 696e 666f 2c20 204e 6f64 653a 2043  o.info,  Node: C\n-000064b0: 7265 6174 696e 6720 6120 5350 4120 4d65  reating a SPA Me\n-000064c0: 7373 6167 652c 2020 4e65 7874 3a20 5365  ssage,  Next: Se\n-000064d0: 7474 696e 6720 5350 4120 4461 7461 2c20  tting SPA Data, \n-000064e0: 2050 7265 763a 2044 6573 7472 6f79 696e   Prev: Destroyin\n-000064f0: 6720 436f 6e74 6578 7473 2c20 2055 703a  g Contexts,  Up:\n-00006500: 2055 7369 6e67 206c 6962 666b 6f0a 0a33   Using libfko..3\n-00006510: 2e33 2043 7265 6174 696e 6720 6120 5350  .3 Creating a SP\n-00006520: 4120 4d65 7373 6167 650a 3d3d 3d3d 3d3d  A Message.======\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 00006530: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================\n-00006540: 3d3d 3d3d 0a0a 5468 6973 2073 6563 7469  ====..This secti\n-00006550: 6f6e 2064 6573 6372 6962 6573 2074 6865  on describes the\n-00006560: 2070 726f 6365 7373 2066 6f72 2063 7265   process for cre\n-00006570: 6174 696e 6720 6120 6e65 7720 666b 6f20  ating a new fko \n-00006580: 5350 4120 6d65 7373 6167 652e 0a41 6674  SPA message..Aft\n-00006590: 6572 2063 7265 6174 696e 6720 6120 636f  er creating a co\n-000065a0: 6e74 6578 742c 2074 6865 7265 2061 7265  ntext, there are\n-000065b0: 2073 7469 6c6c 2073 6f6d 6520 7265 7175   still some requ\n-000065c0: 6973 6974 6520 5350 4120 6461 7461 2066  isite SPA data f\n-000065d0: 6965 6c64 730a 616e 6420 5350 4120 7061  ields.and SPA pa\n-000065e0: 7261 6d65 7465 7273 2074 6861 7420 6e65  rameters that ne\n-000065f0: 6564 2074 6f20 6265 2073 6574 2062 6566  ed to be set bef\n-00006600: 6f72 6520 7468 6520 6669 6e61 6c20 656e  ore the final en\n-00006610: 6372 7970 7465 640a 6d65 7373 6167 6520  crypted.message \n-00006620: 6973 2072 6561 6479 2e0a 0a20 2020 5468  is ready...   Th\n-00006630: 6520 666f 6c6c 6f77 696e 6720 6c69 7374  e following list\n-00006640: 2063 6f6e 7461 696e 7320 7468 6520 6d69   contains the mi\n-00006650: 6e69 6d75 6d20 7265 7175 6972 6564 2066  nimum required f\n-00006660: 6965 6c64 7320 666f 7220 610a 636f 6d70  ields for a.comp\n-00006670: 6c65 7465 2066 6b6f 2053 5041 206d 6573  lete fko SPA mes\n-00006680: 7361 6765 2e20 2059 6f75 2073 686f 756c  sage.  You shoul\n-00006690: 6420 616c 736f 2074 616b 6520 6e6f 7465  d also take note\n-000066a0: 206f 6620 7468 6520 6f72 6465 7220 6f66   of the order of\n-000066b0: 0a74 6865 7365 2070 6172 616d 6574 6572  .these parameter\n-000066c0: 7320 6173 2077 656c 6c2e 2020 5365 7474  s as well.  Sett\n-000066d0: 696e 6720 7468 6520 2274 7970 6522 2070  ing the \"type\" p\n-000066e0: 6172 616d 6574 6572 7320 6669 7273 7420  arameters first \n-000066f0: 6973 0a72 6563 6f6d 6d65 6e64 6564 2028  is.recommended (\n-00006700: 6966 2079 6f75 2077 616e 7420 6120 7479  if you want a ty\n-00006710: 7065 206f 7468 6572 2074 6861 6e20 7468  pe other than th\n-00006720: 6520 6465 6661 756c 7429 2e0a 0a20 2020  e default)...   \n-00006730: 2a20 6469 6765 7374 5f74 7970 6520 2d20  * digest_type - \n-00006740: 5f28 6465 6661 756c 7420 6d61 7920 7375  _(default may su\n-00006750: 6666 6963 6529 5f0a 2020 202a 206d 6573  ffice)_.   * mes\n-00006760: 7361 6765 5f74 7970 6520 2d20 5f28 6465  sage_type - _(de\n-00006770: 6661 756c 7420 6d61 7920 7375 6666 6963  fault may suffic\n-00006780: 6529 5f0a 2020 202a 2065 6e63 7279 7074  e)_.   * encrypt\n-00006790: 696f 6e5f 7479 7065 202d 205f 2864 6566  ion_type - _(def\n-000067a0: 6175 6c74 206d 6179 2073 7566 6669 6365  ault may suffice\n-000067b0: 295f 0a20 2020 2a20 7261 6e64 5f76 616c  )_.   * rand_val\n-000067c0: 202d 205f 2864 6566 6175 6c74 2073 686f   - _(default sho\n-000067d0: 756c 6420 7375 6666 6963 6529 5f0a 2020  uld suffice)_.  \n-000067e0: 202a 2074 696d 655f 7374 616d 7020 2d20   * time_stamp - \n-000067f0: 5f28 6465 6661 756c 7420 7368 6f75 6c64  _(default should\n-00006800: 2073 7566 6669 6365 295f 0a20 2020 2a20   suffice)_.   * \n-00006810: 7573 6572 6e61 6d65 202d 205f 2864 6566  username - _(def\n-00006820: 6175 6c74 206d 6179 2073 7566 6669 6365  ault may suffice\n-00006830: 295f 0a20 2020 2a20 7370 615f 6d65 7373  )_.   * spa_mess\n-00006840: 6167 6520 2d20 5f28 6d75 7374 2062 6520  age - _(must be \n-00006850: 6578 706c 6963 6974 6c79 2073 6574 295f  explicitly set)_\n-00006860: 0a0a 5f49 6620 7573 696e 6720 6770 6720  .._If using gpg \n-00006870: 656e 6372 7970 7469 6f6e 3a5f 0a0a 2020  encryption:_..  \n-00006880: 202a 2067 7067 5f72 6563 6970 6965 6e74   * gpg_recipient\n-00006890: 202d 205f 286d 7573 7420 6265 2065 7870   - _(must be exp\n-000068a0: 6c69 6369 746c 7920 7365 7429 5f0a 2020  licitly set)_.  \n-000068b0: 202a 2067 7067 5f73 6967 6e65 7220 2d20   * gpg_signer - \n-000068c0: 5f28 6f70 7469 6f6e 616c 2c20 6275 7420  _(optional, but \n-000068d0: 7265 636f 6d6d 656e 6465 6420 2d20 6d75  recommended - mu\n-000068e0: 7374 2062 6520 6578 706c 6963 6974 6c79  st be explicitly\n-000068f0: 2073 6574 0a20 2020 2020 6966 2075 7365   set.     if use\n-00006900: 6429 5f0a 2020 202a 2067 7067 5f68 6f6d  d)_.   * gpg_hom\n-00006910: 655f 6469 7220 2d20 5f28 6465 6661 756c  e_dir - _(defaul\n-00006920: 7420 6d61 7920 7375 6666 6963 6520 2d20  t may suffice - \n-00006930: 7479 7069 6361 6c6c 7920 2448 4f4d 452f  typically $HOME/\n-00006940: 2e67 6e75 7067 295f 0a0a 2020 2057 6865  .gnupg)_..   Whe\n-00006950: 6e20 6120 636f 6e74 6578 7420 6973 2069  n a context is i\n-00006960: 6e69 7469 616c 697a 6564 2c20 736f 6d65  nitialized, some\n-00006970: 206f 6620 7468 6520 5350 4120 6461 7461   of the SPA data\n-00006980: 2066 6965 6c64 7320 6172 650a 7072 652d   fields are.pre-\n-00006990: 7365 7420 7769 7468 2064 6566 6175 6c74  set with default\n-000069a0: 2076 616c 7565 7320 282a 6e6f 7465 2053   values (*note S\n-000069b0: 5041 2044 6174 6120 466f 726d 6174 3a3a  PA Data Format::\n-000069c0: 292e 2020 466f 7220 6669 656c 6473 2073  ).  For fields s\n-000069d0: 7563 680a 6173 2027 7261 6e64 5f76 616c  uch.as 'rand_val\n-000069e0: 272c 2027 7573 6572 6e61 6d65 272c 2027  ', 'username', '\n-000069f0: 7469 6d65 7374 616d 7027 2c20 276d 6573  timestamp', 'mes\n-00006a00: 7361 6765 5f74 7970 6527 2c20 616e 640a  sage_type', and.\n-00006a10: 2764 6967 6573 745f 7479 7065 272c 2074  'digest_type', t\n-00006a20: 6865 7365 2064 6566 6175 6c74 7320 6d61  hese defaults ma\n-00006a30: 7920 6265 2073 7566 6669 6369 656e 742e  y be sufficient.\n-00006a40: 0a0a 2020 2054 6865 2066 756e 6374 696f  ..   The functio\n-00006a50: 6e73 2075 7365 6420 746f 2073 6574 2074  ns used to set t\n-00006a60: 6865 2076 6172 696f 7573 2053 5041 2064  he various SPA d\n-00006a70: 6174 6120 6669 656c 6473 2061 6e64 2070  ata fields and p\n-00006a80: 6172 616d 6574 6572 730a 6172 6520 6465  arameters.are de\n-00006a90: 7363 7269 6265 6420 696e 2064 6574 6169  scribed in detai\n-00006aa0: 6c20 696e 202a 6e6f 7465 2053 6574 7469  l in *note Setti\n-00006ab0: 6e67 2053 5041 2044 6174 613a 3a2e 0a0a  ng SPA Data::...\n-00006ac0: 2a4e 6f74 652a 3a20 4174 7465 6d70 7473  *Note*: Attempts\n-00006ad0: 2074 6f20 6361 6c6c 2061 6e79 2022 2766   to call any \"'f\n-00006ae0: 6b6f 5f27 2220 6675 6e63 7469 6f6e 206f  ko_'\" function o\n-00006af0: 6e20 6120 636f 6e74 6578 7420 7468 6174  n a context that\n-00006b00: 2068 6173 206e 6f74 0a62 6565 6e20 696e   has not.been in\n-00006b10: 6974 6961 6c69 7a65 6420 6361 6e20 6861  itialized can ha\n-00006b20: 7665 2075 6e64 6566 696e 6564 2063 6f6e  ve undefined con\n-00006b30: 7365 7175 656e 6365 732e 2020 4c69 6266  sequences.  Libf\n-00006b40: 6b6f 2077 696c 6c20 6174 7465 6d70 740a  ko will attempt.\n-00006b50: 746f 2072 6563 6f76 6572 2c20 616e 6420  to recover, and \n-00006b60: 6966 2073 7563 6365 7373 6675 6c2c 2077  if successful, w\n-00006b70: 696c 6c20 7265 7475 726e 2061 2073 7461  ill return a sta\n-00006b80: 7475 7320 6f66 0a27 464b 4f5f 4552 524f  tus of.'FKO_ERRO\n-00006b90: 525f 4354 585f 4e4f 545f 494e 4954 4941  R_CTX_NOT_INITIA\n-00006ba0: 4c49 5a45 4427 2e0a 0a20 2020 4120 636f  LIZED'...   A co\n-00006bb0: 6d6d 6f6e 2053 5041 206d 6573 7361 6765  mmon SPA message\n-00006bc0: 2069 7320 6120 7369 6d70 6c65 2061 6363   is a simple acc\n-00006bd0: 6573 7320 7265 7175 6573 742e 2020 5468  ess request.  Th\n-00006be0: 6973 2072 6571 7565 7374 2061 736b 730a  is request asks.\n-00006bf0: 7468 6520 6677 6b6e 6f70 2073 6572 7665  the fwknop serve\n-00006c00: 7220 746f 2063 7265 6174 6520 6120 7465  r to create a te\n-00006c10: 6d70 6f72 6172 7920 6669 7265 7761 6c6c  mporary firewall\n-00006c20: 2072 756c 6520 746f 2061 6c6c 6f77 2061   rule to allow a\n-00006c30: 0a70 6172 7469 6375 6c61 7220 4950 2061  .particular IP a\n-00006c40: 6464 7265 7373 2061 6363 6573 7320 746f  ddress access to\n-00006c50: 2061 2070 6172 7469 6375 6c61 7220 706f   a particular po\n-00006c60: 7274 206f 6e20 7468 6520 6677 6b6e 6f70  rt on the fwknop\n-00006c70: 2073 6572 7665 722e 0a41 7373 756d 696e   server..Assumin\n-00006c80: 6720 7468 6520 6465 6661 756c 7473 2061  g the defaults a\n-00006c90: 7265 2066 696e 6520 666f 7220 7468 6973  re fine for this\n-00006ca0: 2c20 616c 6c20 7765 206e 6565 6420 746f  , all we need to\n-00006cb0: 2064 6f20 6973 2063 7265 6174 6520 7468   do is create th\n-00006cc0: 650a 636f 6e74 6578 742c 2073 6574 2074  e.context, set t\n-00006cd0: 6865 206d 6573 7361 6765 2064 6174 6120  he message data \n-00006ce0: 6669 656c 642c 2063 616c 6c20 7468 6520  field, call the \n-00006cf0: 2766 6b6f 5f73 7061 5f64 6174 615f 6669  'fko_spa_data_fi\n-00006d00: 6e61 6c27 0a66 756e 6374 696f 6e20 746f  nal'.function to\n-00006d10: 2065 6e63 6f64 6520 616e 6420 656e 6372   encode and encr\n-00006d20: 7970 742c 2070 726f 6365 7373 2074 6865  ypt, process the\n-00006d30: 206d 6573 7361 6765 2c20 7468 656e 2064   message, then d\n-00006d40: 6573 7472 6f79 2074 6865 0a63 6f6e 7465  estroy the.conte\n-00006d50: 7874 2e20 2042 656c 6f77 2c20 7765 2068  xt.  Below, we h\n-00006d60: 6176 6520 6120 636f 6e74 7269 7665 6420  ave a contrived \n-00006d70: 6269 7420 6f66 2063 6f64 6520 6465 6d6f  bit of code demo\n-00006d80: 6e73 7472 6174 696e 6720 7468 6973 3a0a  nstrating this:.\n-00006d90: 0a20 2020 2020 696e 740a 2020 2020 206d  .     int.     m\n-00006da0: 6169 6e28 696e 7420 6172 6763 2c20 6368  ain(int argc, ch\n-00006db0: 6172 202a 2a61 7267 7629 0a20 2020 2020  ar **argv).     \n-00006dc0: 7b0a 2020 2020 2020 2020 2066 6b6f 5f63  {.         fko_c\n-00006dd0: 7478 5f74 2020 2063 7478 3b20 2020 2020  tx_t   ctx;     \n-00006de0: 2020 2020 2020 2f2a 2046 4b4f 2043 6f6e        /* FKO Con\n-00006df0: 7465 7874 202a 2f0a 2020 2020 2020 2020  text */.        \n-00006e00: 2063 6861 7220 2020 2020 2020 2a6b 6579   char       *key\n-00006e10: 3b20 2020 2020 2020 2020 2020 2f2a 2045  ;           /* E\n-00006e20: 6e63 7279 7074 696f 6e20 7061 7373 7068  ncryption passph\n-00006e30: 7261 7365 202a 2f0a 2020 2020 2020 2020  rase */.        \n-00006e40: 2063 6861 7220 2020 2020 2020 2a68 6d61   char       *hma\n-00006e50: 635f 6b65 793b 2020 2020 2020 2f2a 2048  c_key;      /* H\n-00006e60: 4d41 4320 6b65 7920 2a2f 0a20 2020 2020  MAC key */.     \n-00006e70: 2020 2020 6368 6172 2020 2020 2020 202a      char       *\n-00006e80: 6669 6e61 6c5f 7370 613b 2020 2020 202f  final_spa;     /\n-00006e90: 2a20 4669 6e61 6c20 656e 6372 7970 7465  * Final encrypte\n-00006ea0: 6420 5350 4120 6461 7461 202a 2f0a 2020  d SPA data */.  \n-00006eb0: 2020 2020 2020 2069 6e74 2020 2020 2020         int      \n-00006ec0: 2020 206b 6579 5f6c 656e 3b20 2020 2020     key_len;     \n-00006ed0: 2020 2f2a 204c 656e 6774 6820 6f66 2065    /* Length of e\n-00006ee0: 6e63 7279 7074 696f 6e20 6b65 7920 2a2f  ncryption key */\n-00006ef0: 0a20 2020 2020 2020 2020 696e 7420 2020  .         int   \n-00006f00: 2020 2020 2020 686d 6163 5f6b 6579 5f6c        hmac_key_l\n-00006f10: 656e 3b20 202f 2a20 4c65 6e67 7468 206f  en;  /* Length o\n-00006f20: 6620 484d 4143 206b 6579 202a 2f0a 2020  f HMAC key */.  \n-00006f30: 2020 2020 2020 2069 6e74 2020 2020 2020         int      \n-00006f40: 2020 2072 633b 2020 2020 2020 2020 2020     rc;          \n-00006f50: 2020 2f2a 2052 6573 756c 7420 636f 6465    /* Result code\n-00006f60: 202a 2f0a 2020 2020 2020 2020 2069 6e74   */.         int\n-00006f70: 2020 2020 2020 2020 2068 6d61 635f 7479           hmac_ty\n-00006f80: 7065 203d 2046 4b4f 5f48 4d41 435f 5348  pe = FKO_HMAC_SH\n-00006f90: 4132 3536 3b20 2020 2f2a 2044 6566 6175  A256;   /* Defau\n-00006fa0: 6c74 2048 4d41 4320 6469 6765 7374 202a  lt HMAC digest *\n-00006fb0: 2f0a 2020 2020 2020 2020 2069 6e74 2020  /.         int  \n-00006fc0: 2020 2020 2020 2065 6e63 5f6d 6f64 6520         enc_mode \n-00006fd0: 203d 2046 4b4f 5f45 4e43 5f4d 4f44 455f   = FKO_ENC_MODE_\n-00006fe0: 4153 594d 4d45 5452 4943 3b20 202f 2a20  ASYMMETRIC;  /* \n-00006ff0: 5573 6520 4750 4720 2a2f 0a0a 2020 2020  Use GPG */..    \n-00007000: 2020 2020 202f 2a20 2041 7373 756d 6520       /*  Assume \n-00007010: 7765 2070 726f 6365 7373 6564 2074 6865  we processed the\n-00007020: 2063 6f6d 6d61 6e64 206c 696e 650a 2020   command line.  \n-00007030: 2020 2020 2020 2020 2a20 2061 6e64 2072          *  and r\n-00007040: 6574 7269 6576 6564 2074 6865 2070 6173  etrieved the pas\n-00007050: 7377 6f72 6420 616e 6420 7468 6520 484d  sword and the HM\n-00007060: 4143 206b 6579 2061 6e64 0a20 2020 2020  AC key and.     \n-00007070: 2020 2020 2a20 2020 7365 7420 7468 6569      *   set thei\n-00007080: 7220 6173 736f 6369 6174 6564 206c 656e  r associated len\n-00007090: 6774 6873 2e0a 2020 2020 2020 2020 202a  gths..         *\n-000070a0: 2f0a 0a20 2020 2020 2020 2020 2f2a 2043  /..         /* C\n-000070b0: 7265 6174 6520 7468 6520 636f 6e74 6578  reate the contex\n-000070c0: 7420 2a2f 0a20 2020 2020 2020 2020 7263  t */.         rc\n-000070d0: 203d 2066 6b6f 5f6e 6577 2826 6374 7829   = fko_new(&ctx)\n-000070e0: 3b0a 2020 2020 2020 2020 2069 6628 7263  ;.         if(rc\n-000070f0: 2021 3d20 464b 4f5f 5355 4343 4553 5329   != FKO_SUCCESS)\n-00007100: 0a20 2020 2020 2020 2020 7b0a 2020 2020  .         {.    \n-00007110: 2020 2020 2020 2020 2066 7072 696e 7466           fprintf\n-00007120: 2873 7464 6572 722c 2022 4572 726f 7220  (stderr, \"Error \n-00007130: 6372 6561 7469 6e67 2063 6f6e 7465 7874  creating context\n-00007140: 3a20 2573 5c6e 222c 2066 6b6f 5f65 7272  : %s\\n\", fko_err\n-00007150: 7374 7228 7263 2929 3b0a 2020 2020 2020  str(rc));.      \n-00007160: 2020 2020 2020 2065 7869 7428 3129 3b0a         exit(1);.\n-00007170: 2020 2020 2020 2020 207d 0a0a 2020 2020           }..    \n-00007180: 2020 2020 202f 2a20 5365 7420 7468 6520       /* Set the \n-00007190: 5350 4120 6d65 7373 6167 6520 6669 656c  SPA message fiel\n-000071a0: 6420 2d20 6173 6b69 6e67 2074 6f20 6f70  d - asking to op\n-000071b0: 656e 2074 6370 2070 6f72 7420 3232 0a20  en tcp port 22. \n-000071c0: 2020 2020 2020 2020 202a 2066 6f72 2074           * for t\n-000071d0: 6865 2073 7973 7465 6d20 6174 2031 3932  he system at 192\n-000071e0: 2e31 3638 2e30 2e33 330a 2020 2020 2020  .168.0.33.      \n-000071f0: 2020 202a 2f0a 2020 2020 2020 2020 2072     */.         r\n-00007200: 6320 3d20 666b 6f5f 7365 745f 7370 615f  c = fko_set_spa_\n-00007210: 6d65 7373 6167 6528 6374 782c 2022 3139  message(ctx, \"19\n-00007220: 322e 3136 382e 302e 3333 2c74 6370 2f32  2.168.0.33,tcp/2\n-00007230: 3222 293b 0a20 2020 2020 2020 2020 6966  2\");.         if\n-00007240: 2872 6320 213d 2046 4b4f 5f53 5543 4345  (rc != FKO_SUCCE\n-00007250: 5353 290a 2020 2020 2020 2020 207b 0a20  SS).         {. \n-00007260: 2020 2020 2020 2020 2020 2020 6670 7269              fpri\n-00007270: 6e74 6628 7374 6465 7272 2c20 2253 6574  ntf(stderr, \"Set\n-00007280: 2053 5041 206d 6573 7361 6765 2066 6169   SPA message fai\n-00007290: 6c65 643a 2025 735c 6e22 2c20 666b 6f5f  led: %s\\n\", fko_\n-000072a0: 6572 7273 7472 2872 6329 293b 0a20 2020  errstr(rc));.   \n-000072b0: 2020 2020 2020 2020 2020 6578 6974 2831            exit(1\n-000072c0: 293b 0a20 2020 2020 2020 2020 7d0a 0a20  );.         }.. \n-000072d0: 2020 2020 2020 2020 2f2a 204c 6574 2075          /* Let u\n-000072e0: 7320 6173 7375 6d65 2077 6520 6172 6520  s assume we are \n-000072f0: 7573 696e 6720 4750 4720 656e 6372 7970  using GPG encryp\n-00007300: 7469 6f6e 2e20 2053 6f20 7765 206e 6565  tion.  So we nee\n-00007310: 6420 746f 0a20 2020 2020 2020 2020 202a  d to.          *\n-00007320: 2073 6574 2074 6865 2065 6e63 7279 7074   set the encrypt\n-00007330: 696f 6e20 7479 7065 2061 6e64 2073 6574  ion type and set\n-00007340: 2074 6865 2072 6571 7569 7265 6420 4750   the required GP\n-00007350: 4720 7061 7261 6d65 7465 7273 0a20 2020  G parameters.   \n-00007360: 2020 2020 2020 202a 2028 7765 2063 616e         * (we can\n-00007370: 2073 6b69 7020 6368 6563 6b69 6e67 2072   skip checking r\n-00007380: 6574 7572 6e20 7661 6c75 6573 2066 6f72  eturn values for\n-00007390: 2062 7265 7669 7479 292e 0a20 2020 2020   brevity)..     \n-000073a0: 2020 2020 2a2f 0a20 2020 2020 2020 2020      */.         \n-000073b0: 7263 203d 2066 6b6f 5f73 6574 5f73 7061  rc = fko_set_spa\n-000073c0: 5f65 6e63 7279 7074 696f 6e5f 7479 7065  _encryption_type\n-000073d0: 2863 7478 2c20 464b 4f5f 454e 4352 5950  (ctx, FKO_ENCRYP\n-000073e0: 5449 4f4e 5f47 5047 293b 0a0a 2020 2020  TION_GPG);..    \n-000073f0: 2020 2020 202f 2a20 4b65 7920 666f 7220       /* Key for \n-00007400: 7468 6520 7265 6369 7069 656e 7420 2a2f  the recipient */\n-00007410: 0a20 2020 2020 2020 2020 7263 203d 2066  .         rc = f\n-00007420: 6b6f 5f73 6574 5f67 7067 5f72 6563 6970  ko_set_gpg_recip\n-00007430: 6965 6e74 2863 7478 2c20 2272 6563 6970  ient(ctx, \"recip\n-00007440: 4073 6f6d 652e 7768 6572 6522 293b 0a0a  @some.where\");..\n-00007450: 2020 2020 2020 2020 202f 2a20 4b65 7920           /* Key \n-00007460: 666f 7220 7468 6520 7369 676e 6572 2028  for the signer (\n-00007470: 6966 2079 6f75 2077 616e 7420 746f 2073  if you want to s\n-00007480: 6967 6e20 6974 2920 2a2f 0a20 2020 2020  ign it) */.     \n-00007490: 2020 2020 7263 203d 2066 6b6f 5f73 6574      rc = fko_set\n-000074a0: 5f67 7067 5f73 6967 6e65 7228 6374 782c  _gpg_signer(ctx,\n-000074b0: 2022 6d65 4072 6967 6874 2e68 6572 6522   \"me@right.here\"\n-000074c0: 293b 0a0a 2020 2020 2020 2020 202f 2a20  );..         /* \n-000074d0: 4669 6e61 6c69 7a65 2074 6865 2053 5041  Finalize the SPA\n-000074e0: 2064 6174 6120 2a2f 0a20 2020 2020 2020   data */.       \n-000074f0: 2020 7263 203d 2066 6b6f 5f73 7061 5f64    rc = fko_spa_d\n-00007500: 6174 615f 6669 6e61 6c28 6374 782c 206b  ata_final(ctx, k\n-00007510: 6579 2c20 6b65 795f 6c65 6e2c 2065 6e63  ey, key_len, enc\n-00007520: 5f6d 6f64 652c 0a20 2020 2020 2020 2020  _mode,.         \n-00007530: 2020 2020 2020 2020 686d 6163 5f6b 6579          hmac_key\n-00007540: 2c20 686d 6163 5f6b 6579 5f6c 656e 2c20  , hmac_key_len, \n-00007550: 686d 6163 5f74 7970 6529 3b0a 2020 2020  hmac_type);.    \n-00007560: 2020 2020 2069 6628 7263 2021 3d20 464b       if(rc != FK\n-00007570: 4f5f 5355 4343 4553 5329 0a20 2020 2020  O_SUCCESS).     \n-00007580: 2020 2020 7b0a 2020 2020 2020 2020 2020      {.          \n-00007590: 2020 2066 7072 696e 7466 2873 7464 6572     fprintf(stder\n-000075a0: 722c 2022 4572 726f 7220 656e 636f 6469  r, \"Error encodi\n-000075b0: 6e67 2053 5041 2064 6174 613a 2025 735c  ng SPA data: %s\\\n-000075c0: 6e22 2c0a 2020 2020 2020 2020 2020 2020  n\",.            \n-000075d0: 2020 2020 2066 6b6f 5f65 7272 7374 7228       fko_errstr(\n-000075e0: 7263 2929 3b0a 2020 2020 2020 2020 2020  rc));.          \n-000075f0: 2020 2065 7869 7428 3129 3b0a 2020 2020     exit(1);.    \n-00007600: 2020 2020 207d 0a0a 2020 2020 2020 2020       }..        \n-00007610: 202f 2a20 5461 6b65 2074 6865 2066 696e   /* Take the fin\n-00007620: 616c 206d 6573 7361 6765 2061 6e64 2064  al message and d\n-00007630: 6f20 736f 6d65 7468 696e 6720 7769 7468  o something with\n-00007640: 2069 7420 2a2f 0a20 2020 2020 2020 2020   it */.         \n-00007650: 7263 203d 2066 6b6f 5f67 6574 5f73 7061  rc = fko_get_spa\n-00007660: 5f64 6174 6128 6374 782c 2026 6669 6e61  _data(ctx, &fina\n-00007670: 6c5f 7370 6129 3b0a 0a20 2020 2020 2020  l_spa);..       \n-00007680: 2020 2f2a 2041 7373 756d 6520 7468 6973    /* Assume this\n-00007690: 2066 756e 6374 696f 6e20 7061 636b 7320   function packs \n-000076a0: 7468 6520 7370 6120 6461 7461 2069 6e74  the spa data int\n-000076b0: 6f20 6120 5544 500a 2020 2020 2020 2020  o a UDP.        \n-000076c0: 2020 2a20 7061 636b 6574 2061 6e64 2073    * packet and s\n-000076d0: 656e 6473 2069 7420 746f 2074 6865 2073  ends it to the s\n-000076e0: 6572 7665 722e 0a20 2020 2020 2020 2020  erver..         \n-000076f0: 2a2f 0a20 2020 2020 2020 2020 7365 6e64  */.         send\n-00007700: 5f73 7061 5f6d 6573 7361 6765 2866 696e  _spa_message(fin\n-00007710: 616c 5f73 7061 293b 0a0a 2020 2020 2020  al_spa);..      \n-00007720: 2020 202f 2a20 446f 6e65 2077 6974 6820     /* Done with \n-00007730: 7468 6520 636f 6e74 6578 7420 2a2f 0a20  the context */. \n-00007740: 2020 2020 2020 2020 666b 6f5f 6465 7374          fko_dest\n-00007750: 726f 7928 6374 7829 3b0a 0a20 2020 2020  roy(ctx);..     \n-00007760: 2020 2020 6578 6974 2830 293b 0a20 2020      exit(0);.   \n-00007770: 2020 7d0a 0a1f 0a46 696c 653a 206c 6962    }....File: lib\n-00007780: 666b 6f2e 696e 666f 2c20 204e 6f64 653a  fko.info,  Node:\n-00007790: 2053 6574 7469 6e67 2053 5041 2044 6174   Setting SPA Dat\n-000077a0: 612c 2020 4e65 7874 3a20 5265 7472 6965  a,  Next: Retrie\n-000077b0: 7669 6e67 2053 5041 2044 6174 612c 2020  ving SPA Data,  \n-000077c0: 5072 6576 3a20 4372 6561 7469 6e67 2061  Prev: Creating a\n-000077d0: 2053 5041 204d 6573 7361 6765 2c20 2055   SPA Message,  U\n-000077e0: 703a 2055 7369 6e67 206c 6962 666b 6f0a  p: Using libfko.\n-000077f0: 0a33 2e34 2053 6574 7469 6e67 2053 5041  .3.4 Setting SPA\n-00007800: 2044 6174 610a 3d3d 3d3d 3d3d 3d3d 3d3d   Data.==========\n-00007810: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6973  ==========..This\n-00007820: 2073 6563 7469 6f6e 2064 6573 6372 6962   section describ\n-00007830: 6573 2074 6865 2066 756e 6374 696f 6e73  es the functions\n-00007840: 2075 7365 6420 666f 7220 7365 7474 696e   used for settin\n-00007850: 6720 7468 6520 7661 7269 6f75 7320 5350  g the various SP\n-00007860: 410a 6461 7461 2066 6965 6c64 7320 616e  A.data fields an\n-00007870: 6420 7061 7261 6d65 7465 7273 2e20 2041  d parameters.  A\n-00007880: 6c6c 206f 6620 7468 6573 6520 6675 6e63  ll of these func\n-00007890: 7469 6f6e 7320 7265 7475 726e 2061 6e20  tions return an \n-000078a0: 696e 7465 6765 720a 7265 7072 6573 656e  integer.represen\n-000078b0: 7469 6e67 2074 6865 2072 6574 7572 6e20  ting the return \n-000078c0: 7374 6174 7573 206f 6620 7468 6520 6675  status of the fu\n-000078d0: 6e63 7469 6f6e 2e20 2057 6865 6e20 7375  nction.  When su\n-000078e0: 6363 6573 6675 6c6c 2c20 7468 6579 0a77  ccesfull, they.w\n-000078f0: 696c 6c20 7265 7475 726e 2027 464b 4f5f  ill return 'FKO_\n-00007900: 5355 4343 4553 5327 2e20 204f 7468 6572  SUCCESS'.  Other\n-00007910: 7769 7365 2c20 616e 2065 7272 6f72 2063  wise, an error c\n-00007920: 6f64 6520 7661 6c75 6520 6973 2072 6574  ode value is ret\n-00007930: 7572 6e65 642e 0a0a 202d 2d20 4675 6e63  urned... -- Func\n-00007940: 7469 6f6e 3a20 696e 7420 666b 6f5f 7365  tion: int fko_se\n-00007950: 745f 7370 615f 6469 6765 7374 5f74 7970  t_spa_digest_typ\n-00007960: 6520 2866 6b6f 5f63 7478 5f74 2043 5458  e (fko_ctx_t CTX\n-00007970: 2c20 7368 6f72 740a 2020 2020 2020 2020  , short.        \n-00007980: 2020 4449 4745 5354 5f54 5950 4529 3b0a    DIGEST_TYPE);.\n-00007990: 2020 2020 2053 6574 2074 6865 206d 6573       Set the mes\n-000079a0: 7361 6765 2064 6967 6573 7420 7479 7065  sage digest type\n-000079b0: 2e20 2056 616c 6964 2076 616c 7565 7320  .  Valid values \n-000079c0: 6361 6e20 6265 2066 6f75 6e64 2069 6e20  can be found in \n-000079d0: 2a6e 6f74 650a 2020 2020 2044 6967 6573  *note.     Diges\n-000079e0: 7473 3a3a 206f 6620 7468 6973 206d 616e  ts:: of this man\n-000079f0: 7561 6c2e 2020 4966 2061 2076 616c 7565  ual.  If a value\n-00007a00: 206f 7468 6572 2074 6861 6e20 7468 6520   other than the \n-00007a10: 7468 6f73 6520 7468 6174 2061 7265 0a20  those that are. \n-00007a20: 2020 2020 7375 7070 6f72 7465 6420 6973      supported is\n-00007a30: 2067 6976 656e 2c20 7468 6520 6675 6e63   given, the func\n-00007a40: 7469 6f6e 2077 696c 6c20 7265 7475 726e  tion will return\n-00007a50: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-00007a60: 5f49 4e56 414c 4944 5f44 4154 4127 2e20  _INVALID_DATA'. \n-00007a70: 2046 6f72 2065 7861 6d70 6c65 3a0a 2020   For example:.  \n-00007a80: 2020 2020 2020 2020 2020 2020 7263 203d              rc =\n-00007a90: 2066 6b6f 5f73 6574 5f64 6967 6573 745f   fko_set_digest_\n-00007aa0: 7479 7065 2863 7478 2c20 464b 4f5f 4449  type(ctx, FKO_DI\n-00007ab0: 4745 5354 5f53 4841 3129 3b0a 0a20 2d2d  GEST_SHA1);.. --\n-00007ac0: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f\n-00007ad0: 6b6f 5f73 6574 5f73 7061 5f68 6d61 635f  ko_set_spa_hmac_\n-00007ae0: 7479 7065 2028 666b 6f5f 6374 785f 7420  type (fko_ctx_t \n-00007af0: 4354 582c 2073 686f 7274 0a20 2020 2020  CTX, short.     \n-00007b00: 2020 2020 2048 4d41 435f 5459 5045 293b       HMAC_TYPE);\n-00007b10: 0a20 2020 2020 5365 7420 7468 6520 6d65  .     Set the me\n-00007b20: 7373 6167 6520 686d 6163 2074 7970 652e  ssage hmac type.\n-00007b30: 2020 5661 6c69 6420 7661 6c75 6573 2063    Valid values c\n-00007b40: 616e 2062 6520 666f 756e 6420 696e 202a  an be found in *\n-00007b50: 6e6f 7465 2048 4d41 430a 2020 2020 2044  note HMAC.     D\n-00007b60: 6967 6573 7473 3a3a 206f 6620 7468 6973  igests:: of this\n-00007b70: 206d 616e 7561 6c2e 2020 4966 2061 2076   manual.  If a v\n-00007b80: 616c 7565 206f 7468 6572 2074 6861 6e20  alue other than \n-00007b90: 7468 6520 7468 6f73 6520 7468 6174 2061  the those that a\n-00007ba0: 7265 0a20 2020 2020 7375 7070 6f72 7465  re.     supporte\n-00007bb0: 6420 6973 2067 6976 656e 2c20 7468 6520  d is given, the \n-00007bc0: 6675 6e63 7469 6f6e 2077 696c 6c20 7265  function will re\n-00007bd0: 7475 726e 0a20 2020 2020 2746 4b4f 5f45  turn.     'FKO_E\n-00007be0: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n-00007bf0: 4127 2e20 2046 6f72 2065 7861 6d70 6c65  A'.  For example\n-00007c00: 3a0a 2020 2020 2020 2020 2020 2020 2020  :.              \n-00007c10: 7263 203d 2066 6b6f 5f73 6574 5f68 6d61  rc = fko_set_hma\n-00007c20: 635f 7479 7065 2863 7478 2c20 464b 4f5f  c_type(ctx, FKO_\n-00007c30: 484d 4143 5f53 4841 3235 3629 3b0a 0a20  HMAC_SHA256);.. \n-00007c40: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int\n-00007c50: 2066 6b6f 5f73 6574 5f73 7061 5f65 6e63   fko_set_spa_enc\n-00007c60: 7279 7074 696f 6e5f 7479 7065 2028 666b  ryption_type (fk\n-00007c70: 6f5f 6374 785f 7420 4354 582c 2073 686f  o_ctx_t CTX, sho\n-00007c80: 7274 0a20 2020 2020 2020 2020 2045 4e43  rt.          ENC\n-00007c90: 5259 5054 5f54 5950 4529 3b0a 2020 2020  RYPT_TYPE);.    \n-00007ca0: 2053 6574 2074 6865 2065 6e63 7279 7469   Set the encryti\n-00007cb0: 6f6e 2061 6c67 6f72 6974 686d 2074 6f20  on algorithm to \n-00007cc0: 7573 6520 7768 656e 2065 6372 7970 7469  use when ecrypti\n-00007cd0: 6e67 2074 6865 2066 696e 616c 2053 5041  ng the final SPA\n-00007ce0: 0a20 2020 2020 6461 7461 2e20 2056 616c  .     data.  Val\n-00007cf0: 6964 2076 616c 7565 7320 6361 6e20 6265  id values can be\n-00007d00: 2066 6f75 6e64 2069 6e20 2a6e 6f74 6520   found in *note \n-00007d10: 456e 6372 7970 7469 6f6e 2041 6c67 6f72  Encryption Algor\n-00007d20: 6974 686d 733a 3a0a 2020 2020 206f 6620  ithms::.     of \n-00007d30: 7468 6973 206d 616e 7561 6c2e 2020 466f  this manual.  Fo\n-00007d40: 7220 6578 616d 706c 653a 0a20 2020 2020  r example:.     \n-00007d50: 2020 2020 2020 2020 2072 6320 3d20 666b           rc = fk\n-00007d60: 6f5f 7365 745f 656e 6372 7970 7469 6f6e  o_set_encryption\n-00007d70: 5f74 7970 6528 6374 782c 2046 4b4f 5f45  _type(ctx, FKO_E\n-00007d80: 4e43 5259 5054 494f 4e5f 5249 4a4e 4441  NCRYPTION_RIJNDA\n-00007d90: 454c 293b 0a0a 202d 2d20 4675 6e63 7469  EL);.. -- Functi\n-00007da0: 6f6e 3a20 696e 7420 666b 6f5f 7365 745f  on: int fko_set_\n-00007db0: 7261 6e64 5f76 616c 7565 2028 666b 6f5f  rand_value (fko_\n-00007dc0: 6374 785f 7420 4354 582c 2063 6f6e 7374  ctx_t CTX, const\n-00007dd0: 2063 6861 7220 2a56 414c 293b 0a20 2020   char *VAL);.   \n-00007de0: 2020 5365 7420 7468 6520 7261 6e64 6f6d    Set the random\n-00007df0: 2076 616c 7565 2070 6f72 7469 6f6e 206f   value portion o\n-00007e00: 6620 7468 6520 7370 6120 6461 7461 2074  f the spa data t\n-00007e10: 6f20 7468 6520 6769 7665 6e20 7661 6c75  o the given valu\n-00007e20: 650a 2020 2020 2028 5641 4c29 2e20 2054  e.     (VAL).  T\n-00007e30: 6865 2067 6976 656e 2076 616c 7565 206d  he given value m\n-00007e40: 7573 7420 6265 2061 2070 6f69 6e74 6572  ust be a pointer\n-00007e50: 2074 6f20 6120 3136 2d63 6861 7261 6374   to a 16-charact\n-00007e60: 6572 2064 6563 696d 616c 0a20 2020 2020  er decimal.     \n-00007e70: 6e75 6d65 7269 6320 7374 7269 6e67 206f  numeric string o\n-00007e80: 7220 4e55 4c4c 2e20 4966 2074 6865 2076  r NULL. If the v\n-00007e90: 616c 7565 2069 7320 4e55 4c4c 2c20 7468  alue is NULL, th\n-00007ea0: 6520 6675 6e63 7469 6f6e 2067 656e 6572  e function gener\n-00007eb0: 6174 650a 2020 2020 2061 206e 6577 2072  ate.     a new r\n-00007ec0: 616e 646f 6d20 7661 6c75 652e 2020 4966  andom value.  If\n-00007ed0: 2061 2073 7472 696e 6720 7661 6c75 6520   a string value \n-00007ee0: 6973 2070 726f 7669 6465 642c 2069 7420  is provided, it \n-00007ef0: 6d75 7374 2062 6520 610a 2020 2020 2031  must be a.     1\n-00007f00: 362d 6368 6172 6163 7465 7220 6465 6369  6-character deci\n-00007f10: 6d61 6c20 7374 7269 6e67 2e20 204f 7468  mal string.  Oth\n-00007f20: 6572 7769 7365 2c20 7468 6520 6675 6e63  erwise, the func\n-00007f30: 7469 6f6e 2077 696c 6c20 7265 7475 726e  tion will return\n-00007f40: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-00007f50: 5f49 4e56 414c 4944 5f44 4154 4127 2e0a  _INVALID_DATA'..\n-00007f60: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i\n-00007f70: 6e74 2066 6b6f 5f73 6574 5f75 7365 726e  nt fko_set_usern\n-00007f80: 616d 6520 2866 6b6f 5f63 7478 5f74 2043  ame (fko_ctx_t C\n-00007f90: 5458 2c20 636f 6e73 7420 6368 6172 0a20  TX, const char. \n-00007fa0: 2020 2020 2020 2020 202a 5553 4552 4e41           *USERNA\n-00007fb0: 4d45 293b 0a20 2020 2020 5365 7420 7468  ME);.     Set th\n-00007fc0: 6520 7573 6572 6e61 6d65 2066 6965 6c64  e username field\n-00007fd0: 206f 6620 7468 6520 5350 4120 6461 7461   of the SPA data\n-00007fe0: 2e20 2049 6620 5553 4552 4e41 4d45 2069  .  If USERNAME i\n-00007ff0: 7320 4e55 4c4c 2c0a 2020 2020 206c 6962  s NULL,.     lib\n-00008000: 666b 6f20 7769 6c6c 2066 6972 7374 206c  fko will first l\n-00008010: 6f6f 6b20 666f 7220 7468 6520 656e 7669  ook for the envi\n-00008020: 726f 6e6d 656e 7420 7661 7269 6162 6c65  ronment variable\n-00008030: 2027 5350 4f4f 465f 5553 4552 270a 2020   'SPOOF_USER'.  \n-00008040: 2020 2061 6e64 2075 7365 2069 7473 2076     and use its v\n-00008050: 616c 7565 2069 6620 666f 756e 642e 2020  alue if found.  \n-00008060: 4f74 6865 7277 6973 652c 2069 7420 7769  Otherwise, it wi\n-00008070: 6c6c 2074 7279 2074 6f20 6465 7465 726d  ll try to determ\n-00008080: 696e 650a 2020 2020 2074 6865 2075 7365  ine.     the use\n-00008090: 726e 616d 6520 6974 7365 6c66 2075 7369  rname itself usi\n-000080a0: 6e67 2076 6172 696f 7573 206d 6574 686f  ng various metho\n-000080b0: 6473 2073 7461 7274 696e 6720 7769 7468  ds starting with\n-000080c0: 2027 6375 7365 7227 206f 720a 2020 2020   'cuser' or.    \n-000080d0: 2027 6765 746c 6f67 696e 272c 2074 6865   'getlogin', the\n-000080e0: 6e20 6661 6c6c 6261 636b 2074 6f20 7468  n fallback to th\n-000080f0: 6520 656e 7669 726f 6e6d 656e 7420 7661  e environment va\n-00008100: 7269 6162 6c65 7320 274c 4f47 4e41 4d45  riables 'LOGNAME\n-00008110: 2720 6f72 0a20 2020 2020 2755 5345 5227  ' or.     'USER'\n-00008120: 2e20 2049 6620 6e6f 6e65 206f 6620 7468  .  If none of th\n-00008130: 6f73 6520 776f 726b 2c20 7468 6520 6675  ose work, the fu\n-00008140: 6e63 7469 6f6e 2077 696c 6c20 7265 7475  nction will retu\n-00008150: 726e 0a20 2020 2020 2746 4b4f 5f45 5252  rn.     'FKO_ERR\n-00008160: 4f52 5f55 5345 524e 414d 455f 554e 4b4e  OR_USERNAME_UNKN\n-00008170: 4f57 4e27 2e0a 0a20 2d2d 2046 756e 6374  OWN'... -- Funct\n-00008180: 696f 6e3a 2069 6e74 2066 6b6f 5f73 6574  ion: int fko_set\n-00008190: 5f74 696d 6573 7461 6d70 2028 666b 6f5f  _timestamp (fko_\n-000081a0: 6374 785f 7420 4354 582c 2069 6e74 204f  ctx_t CTX, int O\n-000081b0: 4646 5345 5429 3b0a 2020 2020 2053 6574  FFSET);.     Set\n-000081c0: 7320 7468 6520 7469 6d65 7374 616d 7020  s the timestamp \n-000081d0: 7661 6c75 6520 6f66 2074 6865 2053 5041  value of the SPA\n-000081e0: 2064 6174 6120 746f 2074 6865 2063 7572   data to the cur\n-000081f0: 7265 6e74 2074 696d 6520 706c 7573 0a20  rent time plus. \n-00008200: 2020 2020 7468 6520 6f66 6673 6574 2076      the offset v\n-00008210: 616c 7565 2e0a 0a20 2d2d 2046 756e 6374  alue... -- Funct\n-00008220: 696f 6e3a 2069 6e74 2066 6b6f 5f73 6574  ion: int fko_set\n-00008230: 5f73 7061 5f6d 6573 7361 6765 5f74 7970  _spa_message_typ\n-00008240: 6520 2866 6b6f 5f63 7478 5f74 2043 5458  e (fko_ctx_t CTX\n-00008250: 2c20 7368 6f72 740a 2020 2020 2020 2020  , short.        \n-00008260: 2020 4d53 475f 5459 5045 293b 0a20 2020    MSG_TYPE);.   \n-00008270: 2020 5365 7473 2074 6865 206d 6573 7361    Sets the messa\n-00008280: 6765 2074 7970 6520 666f 7220 7468 6520  ge type for the \n-00008290: 5350 4120 6461 7461 2e20 2054 6865 2063  SPA data.  The c\n-000082a0: 686f 6963 6573 2066 6f72 2074 6865 0a20  hoices for the. \n-000082b0: 2020 2020 2773 7061 5f6d 6573 7361 6765      'spa_message\n-000082c0: 5f74 7970 6527 2061 7265 206c 6973 7465  _type' are liste\n-000082d0: 6420 696e 202a 6e6f 7465 2053 5041 204d  d in *note SPA M\n-000082e0: 6573 7361 6765 733a 3a2e 2020 466f 720a  essages::.  For.\n-000082f0: 2020 2020 2065 7861 6d70 6c65 3a0a 2020       example:.  \n-00008300: 2020 2020 2020 2020 2020 2020 7263 203d              rc =\n-00008310: 2066 6b6f 5f73 6574 5f73 7061 5f6d 6573   fko_set_spa_mes\n-00008320: 7361 6765 5f74 7970 6528 6374 782c 2046  sage_type(ctx, F\n-00008330: 4b4f 5f41 4343 4553 535f 4d53 4729 3b0a  KO_ACCESS_MSG);.\n-00008340: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i\n-00008350: 6e74 2066 6b6f 5f73 6574 5f73 7061 5f6d  nt fko_set_spa_m\n-00008360: 6573 7361 6765 2028 666b 6f5f 6374 785f  essage (fko_ctx_\n-00008370: 7420 4354 582c 2063 6f6e 7374 2063 6861  t CTX, const cha\n-00008380: 720a 2020 2020 2020 2020 2020 2a4d 5347  r.          *MSG\n-00008390: 5f53 5452 494e 4729 3b0a 2020 2020 2053  _STRING);.     S\n-000083a0: 6574 2074 6865 2053 5041 206d 6573 7361  et the SPA messa\n-000083b0: 6765 2073 7472 696e 6720 746f 2074 6865  ge string to the\n-000083c0: 2067 6976 656e 2076 616c 7565 2e20 2049   given value.  I\n-000083d0: 6620 7468 6973 2073 7472 696e 6720 646f  f this string do\n-000083e0: 6573 0a20 2020 2020 6e6f 7420 636f 6e66  es.     not conf\n-000083f0: 6f72 6d20 746f 2074 6865 2072 6571 7569  orm to the requi\n-00008400: 7265 6420 2773 7061 5f6e 6174 5f61 6363  red 'spa_nat_acc\n-00008410: 6573 7327 2066 6f72 6d61 742c 2074 6865  ess' format, the\n-00008420: 2066 756e 6374 696f 6e0a 2020 2020 2077   function.     w\n-00008430: 696c 6c20 7265 7475 726e 2027 464b 4f5f  ill return 'FKO_\n-00008440: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n-00008450: 5441 272e 0a0a 202d 2d20 4675 6e63 7469  TA'... -- Functi\n-00008460: 6f6e 3a20 696e 7420 666b 6f5f 7365 745f  on: int fko_set_\n-00008470: 7370 615f 6e61 745f 6163 6365 7373 2028  spa_nat_access (\n-00008480: 666b 6f5f 6374 785f 7420 4354 582c 2063  fko_ctx_t CTX, c\n-00008490: 6f6e 7374 2063 6861 720a 2020 2020 2020  onst char.      \n-000084a0: 2020 2020 2a4e 4154 5f41 4343 4553 5329      *NAT_ACCESS)\n-000084b0: 3b0a 2020 2020 2053 6574 2074 6865 206f  ;.     Set the o\n-000084c0: 7074 696f 6e61 6c20 5350 4120 6e61 7420  ptional SPA nat \n-000084d0: 6163 6365 7373 2073 7472 696e 6720 746f  access string to\n-000084e0: 2074 6865 2067 6976 656e 2076 616c 7565   the given value\n-000084f0: 2e20 2049 6620 7468 6973 0a20 2020 2020  .  If this.     \n-00008500: 7374 7269 6e67 2064 6f65 7320 6e6f 7420  string does not \n-00008510: 636f 6e66 6f72 6d20 746f 2074 6865 2072  conform to the r\n-00008520: 6571 7569 7265 6420 2773 7061 5f6e 6174  equired 'spa_nat\n-00008530: 5f61 6363 6573 7327 2066 6f72 6d61 742c  _access' format,\n-00008540: 0a20 2020 2020 7468 6520 6675 6e63 7469  .     the functi\n-00008550: 6f6e 2077 696c 6c20 7265 7475 726e 2027  on will return '\n-00008560: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n-00008570: 445f 4441 5441 272e 0a0a 202d 2d20 4675  D_DATA'... -- Fu\n-00008580: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_\n-00008590: 7365 745f 7370 615f 7365 7276 6572 5f61  set_spa_server_a\n-000085a0: 7574 6820 2866 6b6f 5f63 7478 5f74 2043  uth (fko_ctx_t C\n-000085b0: 5458 2c20 636f 6e73 7420 6368 6172 0a20  TX, const char. \n-000085c0: 2020 2020 2020 2020 202a 5345 5256 4552           *SERVER\n-000085d0: 5f41 5554 4829 3b0a 2020 2020 2053 6574  _AUTH);.     Set\n-000085e0: 2074 6865 206f 7074 696f 6e61 6c20 2876   the optional (v\n-000085f0: 6572 7920 7365 6c64 6f6d 2075 7365 6429  ery seldom used)\n-00008600: 2053 5041 2073 6572 7665 7220 6175 7468   SPA server auth\n-00008610: 2066 6561 7475 7265 2074 6f20 7468 650a   feature to the.\n-00008620: 2020 2020 2067 6976 656e 2076 616c 7565       given value\n-00008630: 2e20 2054 6869 7320 7061 7261 6d65 7465  .  This paramete\n-00008640: 7220 6d61 7920 6265 636f 6d65 2064 6570  r may become dep\n-00008650: 7265 6361 7465 642e 0a0a 202d 2d20 4675  recated... -- Fu\n-00008660: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_\n-00008670: 7365 745f 7370 615f 636c 6965 6e74 5f74  set_spa_client_t\n-00008680: 696d 656f 7574 2028 666b 6f5f 6374 785f  imeout (fko_ctx_\n-00008690: 7420 4354 582c 2069 6e74 0a20 2020 2020  t CTX, int.     \n-000086a0: 2020 2020 2054 494d 454f 5554 293b 0a20       TIMEOUT);. \n-000086b0: 2020 2020 5365 7473 2074 6865 2053 5041      Sets the SPA\n-000086c0: 2063 6c69 656e 7420 7469 6d65 6f75 7420   client timeout \n-000086d0: 7661 6c75 652e 2020 4966 2074 6865 2074  value.  If the t\n-000086e0: 696d 656f 7574 2069 7320 7365 7420 746f  imeout is set to\n-000086f0: 2061 0a20 2020 2020 7661 6c75 6520 6772   a.     value gr\n-00008700: 6561 7465 7220 7468 616e 2030 2c20 6974  eater than 0, it\n-00008710: 2069 7320 6173 7375 6d65 6420 7468 6520   is assumed the \n-00008720: 2773 7061 5f6d 6573 7361 6765 5f74 7970  'spa_message_typ\n-00008730: 6527 2073 6574 7469 6e67 0a20 2020 2020  e' setting.     \n-00008740: 7368 6f75 6c64 2062 6520 6f6e 6520 6f66  should be one of\n-00008750: 2074 6865 2022 5449 4d45 4f55 5422 2076   the \"TIMEOUT\" v\n-00008760: 6172 6961 6e74 732e 2020 5468 6973 2066  ariants.  This f\n-00008770: 756e 6374 696f 6e20 7769 6c6c 2063 6861  unction will cha\n-00008780: 6e67 650a 2020 2020 2074 6865 2027 6d65  nge.     the 'me\n-00008790: 7373 6167 655f 7479 7065 2720 746f 2074  ssage_type' to t\n-000087a0: 6865 2061 7070 726f 7072 6961 7465 2073  he appropriate s\n-000087b0: 6574 7469 6e67 2069 6620 6e65 6365 7373  etting if necess\n-000087c0: 6172 792e 0a20 2020 2020 486f 7765 7665  ary..     Howeve\n-000087d0: 722c 2069 7420 6973 2072 6563 6f6d 6d65  r, it is recomme\n-000087e0: 6e64 6564 2079 6f75 2073 6574 2074 6865  nded you set the\n-000087f0: 2063 6f72 7265 6374 2027 6d65 7373 6167   correct 'messag\n-00008800: 655f 7479 7065 2720 6168 6561 640a 2020  e_type' ahead.  \n-00008810: 2020 206f 6620 7469 6d65 2e0a 0a20 2d2d     of time... --\n-00008820: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f\n-00008830: 6b6f 5f73 6574 5f73 7061 5f64 6967 6573  ko_set_spa_diges\n-00008840: 7420 2866 6b6f 5f63 7478 5f74 2043 5458  t (fko_ctx_t CTX\n-00008850: 293b 0a20 2020 2020 496e 6974 6961 7465  );.     Initiate\n-00008860: 7320 6120 6361 6c63 756c 6174 696f 6e20  s a calculation \n-00008870: 286f 7220 7265 6361 6c63 756c 6174 696f  (or recalculatio\n-00008880: 6e29 206f 6620 7468 6520 6d65 7373 6167  n) of the messag\n-00008890: 6520 6469 6765 7374 0a20 2020 2020 6861  e digest.     ha\n-000088a0: 7368 2066 6f72 2074 6865 2063 7572 7265  sh for the curre\n-000088b0: 6e74 2053 5041 2064 6174 612e 2020 4966  nt SPA data.  If\n-000088c0: 2074 6865 2072 6571 7569 7265 6420 6461   the required da\n-000088d0: 7461 2066 6965 6c64 7320 6172 6520 6e6f  ta fields are no\n-000088e0: 740a 2020 2020 2073 6574 2074 6869 7320  t.     set this \n-000088f0: 6675 6e63 7469 6f6e 2077 696c 6c20 7265  function will re\n-00008900: 7475 726e 2027 464b 4f5f 4552 524f 525f  turn 'FKO_ERROR_\n-00008910: 4d49 5353 494e 475f 454e 434f 4445 445f  MISSING_ENCODED_\n-00008920: 4441 5441 272e 0a20 2020 2020 2a4e 6f74  DATA'..     *Not\n-00008930: 652a 3a20 4974 2073 686f 756c 6420 6e6f  e*: It should no\n-00008940: 7420 6265 206e 6563 6573 7361 7279 2074  t be necessary t\n-00008950: 6f20 6361 6c6c 2074 6869 7320 6675 6e63  o call this func\n-00008960: 7469 6f6e 2064 6972 6563 746c 790a 2020  tion directly.  \n-00008970: 2020 2061 7320 6974 2077 696c 6c20 6265     as it will be\n-00008980: 2063 616c 6c65 6420 6175 746f 6d61 7469   called automati\n-00008990: 6361 6c6c 7920 6279 206f 7468 6572 2066  cally by other f\n-000089a0: 756e 6374 696f 6e73 2064 7572 696e 6720  unctions during \n-000089b0: 6e6f 726d 616c 0a20 2020 2020 7072 6f63  normal.     proc\n-000089c0: 6573 7369 6e67 2028 6d6f 7374 206e 6f74  essing (most not\n-000089d0: 6162 6c79 2027 666b 6f5f 7370 615f 6461  ably 'fko_spa_da\n-000089e0: 7461 5f66 696e 616c 2729 2e0a 0a20 2d2d  ta_final')... --\n-000089f0: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f\n-00008a00: 6b6f 5f73 6574 5f73 7061 5f68 6d61 6320  ko_set_spa_hmac \n-00008a10: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, \n-00008a20: 636f 6e73 7420 6368 6172 202a 484d 4143  const char *HMAC\n-00008a30: 5f4b 4559 2c0a 2020 2020 2020 2020 2020  _KEY,.          \n-00008a40: 636f 6e73 7420 696e 7420 484d 4143 5f4b  const int HMAC_K\n-00008a50: 4559 5f4c 454e 293b 0a20 2020 2020 496e  EY_LEN);.     In\n-00008a60: 6974 6961 7465 7320 6120 6361 6c63 756c  itiates a calcul\n-00008a70: 6174 696f 6e20 286f 7220 7265 6361 6c63  ation (or recalc\n-00008a80: 756c 6174 696f 6e29 206f 6620 7468 6520  ulation) of the \n-00008a90: 6d65 7373 6167 6520 484d 4143 2066 6f72  message HMAC for\n-00008aa0: 0a20 2020 2020 7468 6520 6375 7272 656e  .     the curren\n-00008ab0: 7420 5350 4120 6461 7461 2e20 202a 4e6f  t SPA data.  *No\n-00008ac0: 7465 2a3a 2049 7420 7368 6f75 6c64 206e  te*: It should n\n-00008ad0: 6f74 2062 6520 6e65 6365 7373 6172 7920  ot be necessary \n-00008ae0: 746f 2063 616c 6c0a 2020 2020 2074 6869  to call.     thi\n-00008af0: 7320 6675 6e63 7469 6f6e 2064 6972 6563  s function direc\n-00008b00: 746c 7920 6173 2069 7420 7769 6c6c 2062  tly as it will b\n-00008b10: 6520 6361 6c6c 6564 2061 7574 6f6d 6174  e called automat\n-00008b20: 6963 616c 6c79 2062 7920 6f74 6865 720a  ically by other.\n-00008b30: 2020 2020 2066 756e 6374 696f 6e73 2064       functions d\n-00008b40: 7572 696e 6720 6e6f 726d 616c 2070 726f  uring normal pro\n-00008b50: 6365 7373 696e 6720 286d 6f73 7420 6e6f  cessing (most no\n-00008b60: 7461 626c 790a 2020 2020 2027 666b 6f5f  tably.     'fko_\n-00008b70: 7370 615f 6461 7461 5f66 696e 616c 2729  spa_data_final')\n-00008b80: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:\n-00008b90: 2069 6e74 2066 6b6f 5f73 6574 5f73 7061   int fko_set_spa\n-00008ba0: 5f64 6174 6120 2866 6b6f 5f63 7478 5f74  _data (fko_ctx_t\n-00008bb0: 2043 5458 2c20 6368 6172 202a 454e 435f   CTX, char *ENC_\n-00008bc0: 4441 5441 293b 0a20 2020 2020 5468 6973  DATA);.     This\n-00008bd0: 2066 756e 6374 696f 6e20 6973 2075 7365   function is use\n-00008be0: 6420 746f 2070 6c61 6365 2065 6e63 7279  d to place encry\n-00008bf0: 7074 6564 2053 5041 2064 6174 6120 696e  pted SPA data in\n-00008c00: 746f 2061 206e 6577 6c79 0a20 2020 2020  to a newly.     \n-00008c10: 6372 6561 7465 6420 656d 7074 7920 636f  created empty co\n-00008c20: 6e74 6578 7420 2869 2e65 2e20 2077 6974  ntext (i.e.  wit\n-00008c30: 6820 2766 6b6f 5f6e 6577 2729 2e20 2049  h 'fko_new').  I\n-00008c40: 6e20 6d6f 7374 2063 6173 6573 2c20 796f  n most cases, yo\n-00008c50: 750a 2020 2020 2077 6f75 6c64 2075 7365  u.     would use\n-00008c60: 2027 666b 6f5f 6e65 775f 7769 7468 5f64   'fko_new_with_d\n-00008c70: 6174 6127 2073 6f20 796f 7520 776f 756c  ata' so you woul\n-00008c80: 646e 2774 2068 6176 6520 746f 2074 616b  dn't have to tak\n-00008c90: 6520 7468 650a 2020 2020 2065 7874 7261  e the.     extra\n-00008ca0: 2073 7465 7020 746f 2075 7365 2074 6869   step to use thi\n-00008cb0: 7320 6675 6e63 7469 6f6e 2e20 2048 6f77  s function.  How\n-00008cc0: 6576 6572 2c20 736f 6d65 206d 6179 2066  ever, some may f\n-00008cd0: 696e 6420 6120 7265 6173 6f6e 0a20 2020  ind a reason.   \n-00008ce0: 2020 746f 2064 6f20 6974 2069 6e20 7468    to do it in th\n-00008cf0: 6973 2077 6179 2e0a 0a5f 4750 472d 7370  is way..._GPG-sp\n-00008d00: 6563 6966 6963 2066 756e 6374 696f 6e73  ecific functions\n-00008d10: 3a5f 0a0a 202d 2d20 4675 6e63 7469 6f6e  :_.. -- Function\n-00008d20: 3a20 696e 7420 666b 6f5f 7365 745f 6770  : int fko_set_gp\n-00008d30: 675f 7265 6369 7069 656e 7420 2866 6b6f  g_recipient (fko\n-00008d40: 5f63 7478 5f74 2043 5458 2c20 636f 6e73  _ctx_t CTX, cons\n-00008d50: 7420 6368 6172 0a20 2020 2020 2020 2020  t char.         \n-00008d60: 2052 4543 4950 4945 4e54 293b 0a20 2020   RECIPIENT);.   \n-00008d70: 2020 5365 7473 2074 6865 2047 5047 206b    Sets the GPG k\n-00008d80: 6579 2066 6f72 2074 6865 2072 6563 6970  ey for the recip\n-00008d90: 6965 6e74 2e20 2054 6869 7320 776f 756c  ient.  This woul\n-00008da0: 6420 6265 2074 6865 2072 6563 6970 6965  d be the recipie\n-00008db0: 6e74 2773 0a20 2020 2020 7075 626c 6963  nt's.     public\n-00008dc0: 206b 6579 2075 7365 6420 746f 2065 6e63   key used to enc\n-00008dd0: 7972 7074 2074 6865 2053 5041 2064 6174  yrpt the SPA dat\n-00008de0: 612e 2020 596f 7520 6361 6e20 7573 6520  a.  You can use \n-00008df0: 7468 6520 7573 6572 206e 616d 650a 2020  the user name.  \n-00008e00: 2020 2028 2272 6563 6970 4074 6865 2e64     (\"recip@the.d\n-00008e10: 6573 742e 636f 6d22 2920 6f72 2074 6865  est.com\") or the\n-00008e20: 206b 6579 2049 4420 2822 3545 5858 5858   key ID (\"5EXXXX\n-00008e30: 4343 2229 2e20 4174 2070 7265 7365 6e74  CC\"). At present\n-00008e40: 2c0a 2020 2020 206d 756c 7469 706c 6520  ,.     multiple \n-00008e50: 7265 6369 7069 656e 7473 2061 7265 206e  recipients are n\n-00008e60: 6f74 2073 7570 706f 7274 6564 2e0a 0a20  ot supported... \n-00008e70: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int\n-00008e80: 2066 6b6f 5f73 6574 5f67 7067 5f73 6967   fko_set_gpg_sig\n-00008e90: 6e65 7220 2866 6b6f 5f63 7478 5f74 2043  ner (fko_ctx_t C\n-00008ea0: 5458 2c20 636f 6e73 7420 6368 6172 2053  TX, const char S\n-00008eb0: 4947 4e45 5229 3b0a 2020 2020 2053 6574  IGNER);.     Set\n-00008ec0: 7320 7468 6520 4750 4720 6b65 7920 666f  s the GPG key fo\n-00008ed0: 7220 7369 676e 696e 6720 7468 6520 6461  r signing the da\n-00008ee0: 7461 2e20 2054 6869 7320 776f 756c 6420  ta.  This would \n-00008ef0: 6265 2074 6865 2073 656e 6465 7227 730a  be the sender's.\n-00008f00: 2020 2020 206b 6579 2075 7365 6420 746f       key used to\n-00008f10: 2073 6967 6e20 7468 6520 5350 4120 6461   sign the SPA da\n-00008f20: 7461 2e20 2059 6f75 2063 616e 2075 7365  ta.  You can use\n-00008f30: 2074 6865 2075 7365 7220 6e61 6d65 206f   the user name o\n-00008f40: 7220 6b65 790a 2020 2020 2049 442e 0a0a  r key.     ID...\n-00008f50: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in\n-00008f60: 7420 666b 6f5f 7365 745f 6770 675f 686f  t fko_set_gpg_ho\n-00008f70: 6d65 5f64 6972 2028 666b 6f5f 6374 785f  me_dir (fko_ctx_\n-00008f80: 7420 4354 582c 2063 6f6e 7374 2063 6861  t CTX, const cha\n-00008f90: 720a 2020 2020 2020 2020 2020 484f 4d45  r.          HOME\n-00008fa0: 5f44 4952 293b 0a20 2020 2020 5365 7473  _DIR);.     Sets\n-00008fb0: 2074 6865 2047 5047 2068 6f6d 6520 6469   the GPG home di\n-00008fc0: 7265 6374 6f72 7920 666f 7220 7468 6520  rectory for the \n-00008fd0: 6375 7272 656e 7420 6770 676d 6520 636f  current gpgme co\n-00008fe0: 6e74 6578 742e 2020 5468 6973 0a20 2020  ntext.  This.   \n-00008ff0: 2020 616c 6c6f 7773 2066 6f72 2075 7369    allows for usi\n-00009000: 6e67 2061 6c74 6572 6e61 7465 206b 6579  ng alternate key\n-00009010: 7269 6e67 732c 2067 7067 2063 6f6e 6669  rings, gpg confi\n-00009020: 6775 7261 7469 6f6e 732c 2065 7463 2e0a  gurations, etc..\n-00009030: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i\n-00009040: 6e74 2066 6b6f 5f73 6574 5f67 7067 5f73  nt fko_set_gpg_s\n-00009050: 6967 6e61 7475 7265 5f76 6572 6966 7920  ignature_verify \n-00009060: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, \n-00009070: 756e 7369 676e 6564 0a20 2020 2020 2020  unsigned.       \n-00009080: 2020 2063 6861 7220 5645 5249 4659 293b     char VERIFY);\n-00009090: 0a20 2020 2020 5365 7473 2074 6865 2076  .     Sets the v\n-000090a0: 6572 6966 7920 4750 4720 7369 676e 6174  erify GPG signat\n-000090b0: 7572 6520 666c 6167 2e20 2057 6865 6e20  ure flag.  When \n-000090c0: 7365 7420 746f 2061 2074 7275 6520 7661  set to a true va\n-000090d0: 6c75 652c 2074 6865 0a20 2020 2020 4750  lue, the.     GP\n-000090e0: 4720 7369 676e 6174 7572 6520 6973 2065  G signature is e\n-000090f0: 7874 7261 6374 6564 2061 6e64 2063 6865  xtracted and che\n-00009100: 636b 6564 2066 6f72 2076 616c 6964 6974  cked for validit\n-00009110: 7920 6475 7269 6e67 2074 6865 0a20 2020  y during the.   \n-00009120: 2020 6465 6372 7970 7469 6f6e 2f64 6563    decryption/dec\n-00009130: 6f64 696e 6720 7068 6173 652e 2020 5768  oding phase.  Wh\n-00009140: 656e 2073 6574 2074 6f20 6661 6c73 652c  en set to false,\n-00009150: 206e 6f20 6174 7465 6d70 7420 6973 206d   no attempt is m\n-00009160: 6164 650a 2020 2020 2074 6f20 6163 6365  ade.     to acce\n-00009170: 7373 206f 7220 6368 6563 6b20 7468 6520  ss or check the \n-00009180: 7369 676e 6174 7572 652e 2020 5468 6973  signature.  This\n-00009190: 2066 6c61 6720 6973 2073 6574 2074 6f20   flag is set to \n-000091a0: 7472 7565 2062 790a 2020 2020 2064 6566  true by.     def\n-000091b0: 6175 6c74 2e0a 0a20 2d2d 2046 756e 6374  ault... -- Funct\n-000091c0: 696f 6e3a 2069 6e74 2066 6b6f 5f73 6574  ion: int fko_set\n-000091d0: 5f67 7067 5f69 676e 6f72 655f 7665 7269  _gpg_ignore_veri\n-000091e0: 6679 5f65 7272 6f72 2028 666b 6f5f 6374  fy_error (fko_ct\n-000091f0: 785f 7420 4354 582c 0a20 2020 2020 2020  x_t CTX,.       \n-00009200: 2020 2075 6e73 6967 6e65 6420 6368 6172     unsigned char\n-00009210: 2049 474e 4f52 4529 3b0a 2020 2020 2053   IGNORE);.     S\n-00009220: 6574 7320 7468 6520 6967 6e6f 7265 2073  ets the ignore s\n-00009230: 6967 6e61 7475 7265 2076 6572 6966 7920  ignature verify \n-00009240: 6572 726f 7220 666c 6167 2e20 2057 6865  error flag.  Whe\n-00009250: 6e20 7365 7420 746f 2061 2074 7275 650a  n set to a true.\n-00009260: 2020 2020 2076 616c 7565 2e20 2041 6e79       value.  Any\n-00009270: 2073 6967 6e61 7475 7265 2076 6572 6966   signature verif\n-00009280: 6963 6174 696f 6e20 6572 726f 7273 2061  ication errors a\n-00009290: 7265 2069 676e 6f72 6564 2028 6275 7420  re ignored (but \n-000092a0: 7374 696c 6c0a 2020 2020 2063 6170 7475  still.     captu\n-000092b0: 7265 6429 2061 6e64 2074 6865 2064 6563  red) and the dec\n-000092c0: 6f64 696e 6720 7072 6f63 6573 7320 7769  oding process wi\n-000092d0: 6c6c 2063 6f6e 7469 6e75 652e 2020 5468  ll continue.  Th\n-000092e0: 6520 6465 6661 756c 740a 2020 2020 2076  e default.     v\n-000092f0: 616c 7565 206f 6620 7468 6973 2066 6c61  alue of this fla\n-00009300: 6720 6973 2066 616c 7365 2e0a 0a20 2d2d  g is false... --\n-00009310: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f\n-00009320: 6b6f 5f73 6574 5f67 7067 5f65 7865 2028  ko_set_gpg_exe (\n-00009330: 666b 6f5f 6374 785f 7420 4354 582c 2063  fko_ctx_t CTX, c\n-00009340: 6f6e 7374 2063 6861 7220 4750 475f 4558  onst char GPG_EX\n-00009350: 4529 3b0a 2020 2020 2053 6574 7320 7468  E);.     Sets th\n-00009360: 6520 7061 7468 2074 6f20 7468 6520 4750  e path to the GP\n-00009370: 4720 6578 6563 7574 6162 6c65 2074 6861  G executable tha\n-00009380: 7420 5f67 7067 6d65 5f20 7769 6c6c 2075  t _gpgme_ will u\n-00009390: 7365 2e20 2042 790a 2020 2020 2064 6566  se.  By.     def\n-000093a0: 6175 6c74 2c20 5f6c 6962 666b 6f5f 2066  ault, _libfko_ f\n-000093b0: 6f72 6365 7320 5f67 7067 6d65 5f20 746f  orces _gpgme_ to\n-000093c0: 2075 7365 2027 6770 6727 2069 6e20 6361   use 'gpg' in ca\n-000093d0: 7365 205f 6770 676d 655f 2077 6173 0a20  se _gpgme_ was. \n-000093e0: 2020 2020 636f 6d70 696c 6564 2074 6f20      compiled to \n-000093f0: 7573 6520 2767 7067 3227 2061 7320 6974  use 'gpg2' as it\n-00009400: 7320 6465 6661 756c 7420 656e 6769 6e65  s default engine\n-00009410: 2e20 2059 6f75 2063 616e 2075 7365 2074  .  You can use t\n-00009420: 6869 730a 2020 2020 2066 756e 6374 696f  his.     functio\n-00009430: 6e20 746f 206f 7665 7272 6964 6520 616e  n to override an\n-00009440: 6420 7365 7420 7768 6174 2047 5047 2065  d set what GPG e\n-00009450: 7865 6375 7461 626c 6520 5f67 7067 6d65  xecutable _gpgme\n-00009460: 5f20 7769 6c6c 2075 7365 2e0a 0a2a 4e6f  _ will use...*No\n-00009470: 7465 2a3a 204f 6e20 6120 6c69 6266 6b6f  te*: On a libfko\n-00009480: 2062 7569 6c64 2077 6974 686f 7574 2047   build without G\n-00009490: 5047 2073 7570 706f 7274 2c20 7468 6520  PG support, the \n-000094a0: 4750 472d 7265 6c61 7465 6420 6675 6e63  GPG-related func\n-000094b0: 7469 6f6e 730a 6162 6f76 6520 7769 6c6c  tions.above will\n-000094c0: 2073 696d 706c 7920 7265 7475 726e 2074   simply return t\n-000094d0: 6865 2046 4b4f 5f45 5252 4f52 5f55 4e53  he FKO_ERROR_UNS\n-000094e0: 5550 504f 5254 4544 5f46 4541 5455 5245  UPPORTED_FEATURE\n-000094f0: 2065 7272 6f72 2063 6f64 652e 0a0a 1f0a   error code.....\n-00009500: 4669 6c65 3a20 6c69 6266 6b6f 2e69 6e66  File: libfko.inf\n-00009510: 6f2c 2020 4e6f 6465 3a20 5265 7472 6965  o,  Node: Retrie\n-00009520: 7669 6e67 2053 5041 2044 6174 612c 2020  ving SPA Data,  \n-00009530: 4e65 7874 3a20 5574 696c 6974 7920 4675  Next: Utility Fu\n-00009540: 6e63 7469 6f6e 732c 2020 5072 6576 3a20  nctions,  Prev: \n-00009550: 5365 7474 696e 6720 5350 4120 4461 7461  Setting SPA Data\n-00009560: 2c20 2055 703a 2055 7369 6e67 206c 6962  ,  Up: Using lib\n-00009570: 666b 6f0a 0a33 2e35 2052 6574 7269 6576  fko..3.5 Retriev\n-00009580: 696e 6720 5350 4120 4461 7461 0a3d 3d3d  ing SPA Data.===\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 00009590: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================\n-000095a0: 3d3d 3d3d 0a0a 5468 6973 2073 6563 7469  ====..This secti\n-000095b0: 6f6e 2064 6573 6372 6962 6573 2074 6865  on describes the\n-000095c0: 2066 756e 6374 696f 6e73 2075 7365 6420   functions used \n-000095d0: 666f 7220 7265 7472 6965 7669 6e67 2074  for retrieving t\n-000095e0: 6865 2076 6172 696f 7573 2053 5041 0a64  he various SPA.d\n-000095f0: 6174 6120 6669 656c 6473 2061 6e64 2070  ata fields and p\n-00009600: 6172 616d 6574 6572 7320 7365 7474 696e  arameters settin\n-00009610: 6773 2e20 2054 6865 7920 616c 6c20 7265  gs.  They all re\n-00009620: 7475 726e 2061 6e20 464b 4f20 6572 726f  turn an FKO erro\n-00009630: 7220 636f 6465 2e0a 5468 6520 7661 6c75  r code..The valu\n-00009640: 6520 6f66 2074 6865 2072 6573 7065 6374  e of the respect\n-00009650: 6976 6520 6669 656c 6420 6f72 2070 6172  ive field or par\n-00009660: 6d65 7465 7220 7468 6174 2069 7320 6265  meter that is be\n-00009670: 696e 6720 7265 7472 6965 7665 640a 7769  ing retrieved.wi\n-00009680: 6c6c 2070 6c61 6365 6420 696e 746f 2074  ll placed into t\n-00009690: 6865 2076 6172 6961 626c 6573 2077 686f  he variables who\n-000096a0: 7365 2061 6464 7265 7373 6573 2061 7265  se addresses are\n-000096b0: 2070 6173 7365 6420 746f 2074 6865 0a66   passed to the.f\n-000096c0: 756e 6374 696f 6e2e 0a0a 202d 2d20 4675  unction... -- Fu\n-000096d0: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_\n-000096e0: 6765 745f 7370 615f 6461 7461 2028 666b  get_spa_data (fk\n-000096f0: 6f5f 6374 785f 7420 4354 582c 2063 6861  o_ctx_t CTX, cha\n-00009700: 7220 2a2a 5350 415f 4441 5441 293b 0a20  r **SPA_DATA);. \n-00009710: 2020 2020 4173 7369 676e 7320 7468 6520      Assigns the \n-00009720: 706f 696e 7465 7220 746f 2074 6865 2073  pointer to the s\n-00009730: 7472 696e 6720 686f 6c64 696e 6720 7468  tring holding th\n-00009740: 6520 6669 6e61 6c20 656e 6372 7970 7465  e final encrypte\n-00009750: 6420 5350 410a 2020 2020 2064 6174 6120  d SPA.     data \n-00009760: 746f 2074 6865 2061 6464 7265 7373 2053  to the address S\n-00009770: 5041 5f44 4154 4120 6973 2070 6f69 6e74  PA_DATA is point\n-00009780: 696e 6720 746f 2e20 2054 6869 7320 6973  ing to.  This is\n-00009790: 2074 6865 2064 6174 6120 7468 6174 0a20   the data that. \n-000097a0: 2020 2020 776f 756c 6420 6265 2070 6163      would be pac\n-000097b0: 6b61 6765 6420 696e 746f 2061 2070 6163  kaged into a pac\n-000097c0: 6b65 7420 616e 6420 7365 6e74 2074 6f20  ket and sent to \n-000097d0: 616e 2066 776b 6e6f 7020 7365 7276 6572  an fwknop server\n-000097e0: 2e20 2054 6865 0a20 2020 2020 7265 7475  .  The.     retu\n-000097f0: 726e 2076 616c 7565 2069 7320 616e 2046  rn value is an F\n-00009800: 4b4f 2065 7272 6f72 2073 7461 7475 732e  KO error status.\n-00009810: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: \n-00009820: 696e 7420 666b 6f5f 6765 745f 7261 6e64  int fko_get_rand\n-00009830: 5f76 616c 7565 2028 666b 6f5f 6374 785f  _value (fko_ctx_\n-00009840: 7420 4354 582c 2063 6861 7220 2a2a 5241  t CTX, char **RA\n-00009850: 4e44 5f56 414c 293b 0a20 2020 2020 4173  ND_VAL);.     As\n-00009860: 7369 676e 7320 7468 6520 706f 696e 7465  signs the pointe\n-00009870: 7220 746f 2074 6865 2073 7472 696e 6720  r to the string \n-00009880: 686f 6c64 696e 6720 7468 6520 7261 6e64  holding the rand\n-00009890: 6f6d 2031 362d 6368 6172 6163 7465 720a  om 16-character.\n-000098a0: 2020 2020 2064 6563 696d 616c 206e 756d       decimal num\n-000098b0: 6265 7220 2827 7261 6e64 5f76 616c 2729  ber ('rand_val')\n-000098c0: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with\n-000098d0: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con\n-000098e0: 7465 7874 2074 6f0a 2020 2020 2074 6865  text to.     the\n-000098f0: 2061 6464 7265 7373 2052 414e 445f 5641   address RAND_VA\n-00009900: 4c20 6973 2070 6f69 6e74 696e 6720 746f  L is pointing to\n-00009910: 2e20 2054 6865 2072 6574 7572 6e20 7661  .  The return va\n-00009920: 6c75 6520 6973 2061 6e20 464b 4f0a 2020  lue is an FKO.  \n-00009930: 2020 2065 7272 6f72 2073 7461 7475 732e     error status.\n-00009940: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: \n-00009950: 696e 7420 666b 6f5f 6765 745f 7573 6572  int fko_get_user\n-00009960: 6e61 6d65 2028 666b 6f5f 6374 785f 7420  name (fko_ctx_t \n-00009970: 4354 582c 2063 6861 7220 2a2a 5553 4552  CTX, char **USER\n-00009980: 4e41 4d45 293b 0a20 2020 2020 4173 7369  NAME);.     Assi\n-00009990: 676e 7320 7468 6520 706f 696e 7465 7220  gns the pointer \n-000099a0: 746f 2074 6865 2073 7472 696e 6720 686f  to the string ho\n-000099b0: 6c64 696e 6720 7468 6520 7573 6572 6e61  lding the userna\n-000099c0: 6d65 2061 7373 6f63 6961 7465 640a 2020  me associated.  \n-000099d0: 2020 2077 6974 6820 7468 6520 6375 7272     with the curr\n-000099e0: 656e 7420 636f 6e74 6578 7420 746f 2074  ent context to t\n-000099f0: 6865 2061 6464 7265 7373 2052 414e 445f  he address RAND_\n-00009a00: 5641 4c20 6973 2070 6f69 6e74 696e 6720  VAL is pointing \n-00009a10: 746f 2e0a 2020 2020 2054 6865 2072 6574  to..     The ret\n-00009a20: 7572 6e20 7661 6c75 6520 6973 2061 6e20  urn value is an \n-00009a30: 464b 4f20 6572 726f 7220 7374 6174 7573  FKO error status\n-00009a40: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:\n-00009a50: 2069 6e74 2066 6b6f 5f67 6574 5f74 696d   int fko_get_tim\n-00009a60: 6573 7461 6d70 2028 666b 6f5f 6374 785f  estamp (fko_ctx_\n-00009a70: 7420 4354 582c 2074 696d 655f 7420 2a54  t CTX, time_t *T\n-00009a80: 494d 4553 5441 4d50 293b 0a20 2020 2020  IMESTAMP);.     \n-00009a90: 5365 7473 2074 6865 2076 616c 7565 206f  Sets the value o\n-00009aa0: 6620 7468 6520 5449 4d45 5354 414d 5020  f the TIMESTAMP \n-00009ab0: 7661 7269 6162 6c65 2074 6f20 7468 6520  variable to the \n-00009ac0: 7469 6d65 7374 616d 7020 7661 6c75 650a  timestamp value.\n-00009ad0: 2020 2020 2061 7373 6f63 6961 7465 6420       associated \n-00009ae0: 7769 7468 2074 6865 2063 7572 7265 6e74  with the current\n-00009af0: 2063 6f6e 7465 7874 2e20 2054 6865 2072   context.  The r\n-00009b00: 6574 7572 6e20 7661 6c75 6520 6973 2061  eturn value is a\n-00009b10: 6e20 464b 4f0a 2020 2020 2065 7272 6f72  n FKO.     error\n-00009b20: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu\n-00009b30: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_\n-00009b40: 6765 745f 7370 615f 6d65 7373 6167 655f  get_spa_message_\n-00009b50: 7479 7065 2028 666b 6f5f 6374 785f 7420  type (fko_ctx_t \n-00009b60: 4354 582c 2073 686f 7274 0a20 2020 2020  CTX, short.     \n-00009b70: 2020 2020 202a 4d53 475f 5459 5045 293b       *MSG_TYPE);\n-00009b80: 0a20 2020 2020 5365 7473 2074 6865 2076  .     Sets the v\n-00009b90: 616c 7565 206f 6620 7468 6520 4d53 475f  alue of the MSG_\n-00009ba0: 5459 5045 2076 6172 6961 626c 6520 746f  TYPE variable to\n-00009bb0: 2074 6865 2053 5041 206d 6573 7361 6765   the SPA message\n-00009bc0: 2074 7970 650a 2020 2020 2076 616c 7565   type.     value\n-00009bd0: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with\n-00009be0: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con\n-00009bf0: 7465 7874 2e20 2054 6869 7320 7661 6c75  text.  This valu\n-00009c00: 6520 6361 6e20 6265 0a20 2020 2020 6368  e can be.     ch\n-00009c10: 6563 6b65 6420 6167 6169 6e73 7420 7468  ecked against th\n-00009c20: 6520 6c69 7374 206f 6620 7661 6c69 6420  e list of valid \n-00009c30: 6d65 7373 6167 655f 7479 7065 7320 6c69  message_types li\n-00009c40: 7374 6564 2069 6e20 2a6e 6f74 6520 5350  sted in *note SP\n-00009c50: 410a 2020 2020 204d 6573 7361 6765 733a  A.     Messages:\n-00009c60: 3a20 6f66 2074 6869 7320 6d61 6e75 616c  : of this manual\n-00009c70: 2e20 2046 6f72 2065 7861 6d70 6c65 3a0a  .  For example:.\n-00009c80: 2020 2020 2020 2020 2020 2020 2020 7368                sh\n-00009c90: 6f72 7420 6d73 675f 7479 7065 3b0a 0a20  ort msg_type;.. \n-00009ca0: 2020 2020 2020 2020 2020 2020 2072 6320               rc \n-00009cb0: 3d20 666b 6f5f 6765 745f 7370 615f 6d65  = fko_get_spa_me\n-00009cc0: 7373 6167 655f 7479 7065 2863 7478 2c20  ssage_type(ctx, \n-00009cd0: 266d 7367 5f74 7970 6529 3b0a 0a20 2020  &msg_type);..   \n-00009ce0: 2020 2020 2020 2020 2020 2073 7769 7463             switc\n-00009cf0: 6828 6d73 675f 7479 7065 290a 2020 2020  h(msg_type).    \n-00009d00: 2020 2020 2020 2020 2020 7b0a 2020 2020            {.    \n-00009d10: 2020 2020 2020 2020 2020 2020 2020 6361                ca\n-00009d20: 7365 2046 4b4f 5f41 4343 4553 535f 4d53  se FKO_ACCESS_MS\n-00009d30: 473a 0a20 2020 2020 2020 2020 2020 2020  G:.             \n-00009d40: 2020 2020 2020 2020 2070 726f 6365 7373           process\n-00009d50: 5f61 6363 6573 735f 6d73 6728 2e2e 2e29  _access_msg(...)\n-00009d60: 3b0a 2020 2020 2020 2020 2020 2020 2020  ;.              \n-00009d70: 2020 2020 2020 2020 6272 6561 6b3b 0a20          break;. \n-00009d80: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00009d90: 2063 6173 6520 464b 4f5f 4e41 545f 4143   case FKO_NAT_AC\n-00009da0: 4345 5353 5f4d 5347 3a0a 2020 2020 2020  CESS_MSG:.      \n-00009db0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00009dc0: 7072 6f63 6573 735f 6e61 745f 6163 6365  process_nat_acce\n-00009dd0: 7373 5f6d 7367 282e 2e2e 293b 0a20 2020  ss_msg(...);.   \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+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: 2020 2062 7265 616b 3b0a 2020 2020 2020     break;.      \n-00009e00: 2020 2020 2020 2020 2f2a 2e2e 2e61 6e64          /*...and\n-00009e10: 2073 6f20 6f6e 2e2e 2e2a 2f0a 2020 2020   so on...*/.    \n-00009e20: 2020 2020 2020 2020 2020 7d0a 2020 2020            }.    \n-00009e30: 2054 6865 2072 6574 7572 6e20 7661 6c75   The return valu\n-00009e40: 6520 6973 2061 6e20 464b 4f20 6572 726f  e is an FKO erro\n-00009e50: 7220 7374 6174 7573 2e0a 0a20 2d2d 2046  r status... -- F\n-00009e60: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko\n-00009e70: 5f67 6574 5f73 7061 5f6d 6573 7361 6765  _get_spa_message\n-00009e80: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,\n-00009e90: 2063 6861 7220 2a2a 5350 415f 4d53 4729   char **SPA_MSG)\n-00009ea0: 3b0a 2020 2020 2041 7373 6967 6e73 2074  ;.     Assigns t\n-00009eb0: 6865 2070 6f69 6e74 6572 2074 6f20 7468  he pointer to th\n-00009ec0: 6520 7374 7269 6e67 2068 6f6c 6469 6e67  e string holding\n-00009ed0: 2074 6865 2074 6865 2066 6b6f 2053 5041   the the fko SPA\n-00009ee0: 2072 6571 7565 7374 0a20 2020 2020 6d65   request.     me\n-00009ef0: 7373 6167 6520 6173 736f 6369 6174 6564  ssage associated\n-00009f00: 2077 6974 6820 7468 6520 6375 7272 656e   with the curren\n-00009f10: 7420 636f 6e74 6578 7420 746f 2074 6865  t context to the\n-00009f20: 2061 6464 7265 7373 2053 5041 5f4d 5347   address SPA_MSG\n-00009f30: 0a20 2020 2020 6973 2070 6f69 6e74 696e  .     is pointin\n-00009f40: 6720 746f 2e20 2054 6865 2072 6574 7572  g to.  The retur\n-00009f50: 6e20 7661 6c75 6520 6973 2061 6e20 464b  n value is an FK\n-00009f60: 4f20 6572 726f 7220 7374 6174 7573 2e0a  O error status..\n-00009f70: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i\n-00009f80: 6e74 2066 6b6f 5f67 6574 5f73 7061 5f6e  nt fko_get_spa_n\n-00009f90: 6174 5f61 6363 6573 7320 2866 6b6f 5f63  at_access (fko_c\n-00009fa0: 7478 5f74 2043 5458 2c20 6368 6172 0a20  tx_t CTX, char. \n-00009fb0: 2020 2020 2020 2020 202a 2a4e 4154 5f41           **NAT_A\n-00009fc0: 4343 4553 5329 3b0a 2020 2020 2041 7373  CCESS);.     Ass\n-00009fd0: 6967 6e73 2074 6865 2070 6f69 6e74 6572  igns the pointer\n-00009fe0: 2074 6f20 7468 6520 7374 7269 6e67 2068   to the string h\n-00009ff0: 6f6c 6469 6e67 2074 6865 2074 6865 2066  olding the the f\n-0000a000: 6b6f 2053 5041 206e 6174 0a20 2020 2020  ko SPA nat.     \n-0000a010: 6163 6365 7373 206d 6573 7361 6765 2061  access message a\n-0000a020: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t\n-0000a030: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte\n-0000a040: 7874 2074 6f20 7468 6520 6164 6472 6573  xt to the addres\n-0000a050: 730a 2020 2020 204e 4154 5f41 4343 4553  s.     NAT_ACCES\n-0000a060: 5320 6973 2070 6f69 6e74 696e 6720 746f  S is pointing to\n-0000a070: 2e20 2054 6865 2072 6574 7572 6e20 7661  .  The return va\n-0000a080: 6c75 6520 6973 2061 6e20 464b 4f20 6572  lue is an FKO er\n-0000a090: 726f 720a 2020 2020 2073 7461 7475 732e  ror.     status.\n-0000a0a0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: \n-0000a0b0: 696e 7420 666b 6f5f 6765 745f 7370 615f  int fko_get_spa_\n-0000a0c0: 7365 7276 6572 5f61 7574 6820 2866 6b6f  server_auth (fko\n-0000a0d0: 5f63 7478 5f74 2043 5458 2c20 6368 6172  _ctx_t CTX, char\n-0000a0e0: 0a20 2020 2020 2020 2020 202a 2a53 4552  .          **SER\n-0000a0f0: 5645 525f 4155 5448 293b 0a20 2020 2020  VER_AUTH);.     \n-0000a100: 4173 7369 676e 7320 7468 6520 706f 696e  Assigns the poin\n-0000a110: 7465 7220 746f 2074 6865 2073 7472 696e  ter to the strin\n-0000a120: 6720 686f 6c64 696e 6720 7468 6520 7468  g holding the th\n-0000a130: 6520 666b 6f20 5350 4120 7365 7276 6572  e fko SPA server\n-0000a140: 0a20 2020 2020 6175 7468 206d 6573 7361  .     auth messa\n-0000a150: 6765 2061 7373 6f63 6961 7465 6420 7769  ge associated wi\n-0000a160: 7468 2074 6865 2063 7572 7265 6e74 2063  th the current c\n-0000a170: 6f6e 7465 7874 2074 6f20 7468 6520 6164  ontext to the ad\n-0000a180: 6472 6573 730a 2020 2020 2053 4552 5645  dress.     SERVE\n-0000a190: 525f 4155 5448 2069 7320 706f 696e 7469  R_AUTH is pointi\n-0000a1a0: 6e67 2074 6f2e 2020 5468 6520 7265 7475  ng to.  The retu\n-0000a1b0: 726e 2076 616c 7565 2069 7320 616e 2046  rn value is an F\n-0000a1c0: 4b4f 2065 7272 6f72 0a20 2020 2020 7374  KO error.     st\n-0000a1d0: 6174 7573 2e0a 0a20 2d2d 2046 756e 6374  atus... -- Funct\n-0000a1e0: 696f 6e3a 2069 6e74 2066 6b6f 5f67 6574  ion: int fko_get\n-0000a1f0: 5f73 7061 5f63 6c69 656e 745f 7469 6d65  _spa_client_time\n-0000a200: 6f75 7420 2866 6b6f 5f63 7478 5f74 2043  out (fko_ctx_t C\n-0000a210: 5458 2c20 696e 740a 2020 2020 2020 2020  TX, int.        \n-0000a220: 2020 2a43 4c49 454e 545f 5449 4d45 4f55    *CLIENT_TIMEOU\n-0000a230: 5429 3b0a 2020 2020 2053 6574 7320 7468  T);.     Sets th\n-0000a240: 6520 7661 6c75 6520 6f66 2074 6865 2043  e value of the C\n-0000a250: 4c49 454e 545f 5449 4d45 4f55 5420 7661  LIENT_TIMEOUT va\n-0000a260: 7269 6162 6c65 2074 6f20 7468 6520 636c  riable to the cl\n-0000a270: 6965 6e74 5f74 696d 656f 7574 0a20 2020  ient_timeout.   \n-0000a280: 2020 7661 6c75 6520 6173 736f 6369 6174    value associat\n-0000a290: 6564 2077 6974 6820 7468 6520 6375 7272  ed with the curr\n-0000a2a0: 656e 7420 636f 6e74 6578 742e 2020 5468  ent context.  Th\n-0000a2b0: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i\n-0000a2c0: 7320 616e 0a20 2020 2020 464b 4f20 6572  s an.     FKO er\n-0000a2d0: 726f 7220 7374 6174 7573 2e0a 0a20 2d2d  ror status... --\n-0000a2e0: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f\n-0000a2f0: 6b6f 5f67 6574 5f73 7061 5f64 6967 6573  ko_get_spa_diges\n-0000a300: 745f 7479 7065 2028 666b 6f5f 6374 785f  t_type (fko_ctx_\n-0000a310: 7420 4354 582c 2073 686f 7274 0a20 2020  t CTX, short.   \n-0000a320: 2020 2020 2020 202a 4449 4745 5354 5f54         *DIGEST_T\n-0000a330: 5950 4529 3b0a 2020 2020 2053 6574 7320  YPE);.     Sets \n-0000a340: 7468 6520 7661 6c75 6520 6f66 2074 6865  the value of the\n-0000a350: 2044 4947 4553 545f 5459 5045 2076 6172   DIGEST_TYPE var\n-0000a360: 6961 626c 6520 746f 2074 6865 2064 6967  iable to the dig\n-0000a370: 6573 7420 7479 7065 2076 616c 7565 0a20  est type value. \n-0000a380: 2020 2020 6173 736f 6369 6174 6564 2077      associated w\n-0000a390: 6974 6820 7468 6520 6375 7272 656e 7420  ith the current \n-0000a3a0: 636f 6e74 6578 742e 2020 5468 6973 2076  context.  This v\n-0000a3b0: 616c 7565 2063 616e 2062 6520 6368 6563  alue can be chec\n-0000a3c0: 6b65 640a 2020 2020 2061 6761 696e 7374  ked.     against\n-0000a3d0: 2074 6865 206c 6973 7420 6f66 2076 616c   the list of val\n-0000a3e0: 6964 2064 6967 6573 745f 7479 7065 7320  id digest_types \n-0000a3f0: 6c69 7374 6564 2069 6e20 2a6e 6f74 6520  listed in *note \n-0000a400: 4469 6765 7374 733a 3a20 6f66 0a20 2020  Digests:: of.   \n-0000a410: 2020 7468 6973 206d 616e 7561 6c2e 2020    this manual.  \n-0000a420: 5468 6520 7265 7475 726e 2076 616c 7565  The return value\n-0000a430: 2069 7320 616e 2046 4b4f 2065 7272 6f72   is an FKO error\n-0000a440: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu\n-0000a450: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_\n-0000a460: 6765 745f 7370 615f 686d 6163 5f74 7970  get_spa_hmac_typ\n-0000a470: 6520 2866 6b6f 5f63 7478 5f74 2043 5458  e (fko_ctx_t CTX\n-0000a480: 2c20 7368 6f72 740a 2020 2020 2020 2020  , short.        \n-0000a490: 2020 2a48 4d41 435f 5459 5045 293b 0a20    *HMAC_TYPE);. \n-0000a4a0: 2020 2020 5365 7473 2074 6865 2076 616c      Sets the val\n-0000a4b0: 7565 206f 6620 7468 6520 484d 4143 5f54  ue of the HMAC_T\n-0000a4c0: 5950 4520 7661 7269 6162 6c65 2074 6f20  YPE variable to \n-0000a4d0: 7468 6520 484d 4143 2074 7970 6520 7661  the HMAC type va\n-0000a4e0: 6c75 650a 2020 2020 2061 7373 6f63 6961  lue.     associa\n-0000a4f0: 7465 6420 7769 7468 2074 6865 2063 7572  ted with the cur\n-0000a500: 7265 6e74 2063 6f6e 7465 7874 2e20 2054  rent context.  T\n-0000a510: 6869 7320 7661 6c75 6520 6361 6e20 6265  his value can be\n-0000a520: 2063 6865 636b 6564 0a20 2020 2020 6167   checked.     ag\n-0000a530: 6169 6e73 7420 7468 6520 6c69 7374 206f  ainst the list o\n-0000a540: 6620 7661 6c69 6420 686d 6163 5f74 7970  f valid hmac_typ\n-0000a550: 6573 206c 6973 7465 6420 696e 202a 6e6f  es listed in *no\n-0000a560: 7465 2048 4d41 4320 4469 6765 7374 733a  te HMAC Digests:\n-0000a570: 3a0a 2020 2020 206f 6620 7468 6973 206d  :.     of this m\n-0000a580: 616e 7561 6c2e 2020 5468 6520 7265 7475  anual.  The retu\n-0000a590: 726e 2076 616c 7565 2069 7320 616e 2046  rn value is an F\n-0000a5a0: 4b4f 2065 7272 6f72 2073 7461 7475 732e  KO error status.\n-0000a5b0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: \n-0000a5c0: 696e 7420 666b 6f5f 6765 745f 7370 615f  int fko_get_spa_\n-0000a5d0: 6469 6765 7374 2028 666b 6f5f 6374 785f  digest (fko_ctx_\n-0000a5e0: 7420 4354 582c 2063 6861 7220 2a2a 5350  t CTX, char **SP\n-0000a5f0: 415f 4449 4745 5354 293b 0a20 2020 2020  A_DIGEST);.     \n-0000a600: 4173 7369 676e 7320 7468 6520 706f 696e  Assigns the poin\n-0000a610: 7465 7220 746f 2074 6865 2073 7472 696e  ter to the strin\n-0000a620: 6720 686f 6c64 696e 6720 7468 6520 7468  g holding the th\n-0000a630: 6520 666b 6f20 5350 4120 6469 6765 7374  e fko SPA digest\n-0000a640: 0a20 2020 2020 7661 6c75 6520 6173 736f  .     value asso\n-0000a650: 6369 6174 6564 2077 6974 6820 7468 6520  ciated with the \n-0000a660: 6375 7272 656e 7420 636f 6e74 6578 7420  current context \n-0000a670: 746f 2074 6865 2061 6464 7265 7373 2053  to the address S\n-0000a680: 5041 5f44 4947 4553 540a 2020 2020 2069  PA_DIGEST.     i\n-0000a690: 7320 706f 696e 7469 6e67 2074 6f2e 2020  s pointing to.  \n-0000a6a0: 5468 6520 7265 7475 726e 2076 616c 7565  The return value\n-0000a6b0: 2069 7320 616e 2046 4b4f 2065 7272 6f72   is an FKO error\n-0000a6c0: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu\n-0000a6d0: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_\n-0000a6e0: 6765 745f 7370 615f 686d 6163 2028 666b  get_spa_hmac (fk\n-0000a6f0: 6f5f 6374 785f 7420 4354 582c 2063 6861  o_ctx_t CTX, cha\n-0000a700: 7220 2a2a 5350 415f 484d 4143 293b 0a20  r **SPA_HMAC);. \n-0000a710: 2020 2020 4173 7369 676e 7320 7468 6520      Assigns the \n-0000a720: 706f 696e 7465 7220 746f 2074 6865 2073  pointer to the s\n-0000a730: 7472 696e 6720 686f 6c64 696e 6720 7468  tring holding th\n-0000a740: 6520 7468 6520 666b 6f20 5350 4120 484d  e the fko SPA HM\n-0000a750: 4143 0a20 2020 2020 7661 6c75 6520 6173  AC.     value as\n-0000a760: 736f 6369 6174 6564 2077 6974 6820 7468  sociated with th\n-0000a770: 6520 6375 7272 656e 7420 636f 6e74 6578  e current contex\n-0000a780: 7420 746f 2074 6865 2061 6464 7265 7373  t to the address\n-0000a790: 2053 5041 5f48 4d41 430a 2020 2020 2069   SPA_HMAC.     i\n-0000a7a0: 7320 706f 696e 7469 6e67 2074 6f2e 2020  s pointing to.  \n-0000a7b0: 5468 6520 7265 7475 726e 2076 616c 7565  The return value\n-0000a7c0: 2069 7320 616e 2046 4b4f 2065 7272 6f72   is an FKO error\n-0000a7d0: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu\n-0000a7e0: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_\n-0000a7f0: 6765 745f 7370 615f 656e 6372 7970 7469  get_spa_encrypti\n-0000a800: 6f6e 5f74 7970 6520 2866 6b6f 5f63 7478  on_type (fko_ctx\n-0000a810: 5f74 2043 5458 2c20 7368 6f72 740a 2020  _t CTX, short.  \n-0000a820: 2020 2020 2020 2020 2a45 4e43 5f54 5950          *ENC_TYP\n-0000a830: 4529 3b0a 2020 2020 2053 6574 7320 7468  E);.     Sets th\n-0000a840: 6520 7661 6c75 6520 6f66 2074 6865 2045  e value of the E\n-0000a850: 4e43 5f54 5950 4520 7661 7269 6162 6c65  NC_TYPE variable\n-0000a860: 2074 6f20 7468 6520 656e 6372 7970 7469   to the encrypti\n-0000a870: 6f6e 2074 7970 650a 2020 2020 2076 616c  on type.     val\n-0000a880: 7565 2061 7373 6f63 6961 7465 6420 7769  ue associated wi\n-0000a890: 7468 2074 6865 2063 7572 7265 6e74 2063  th the current c\n-0000a8a0: 6f6e 7465 7874 2e20 2054 6869 7320 7661  ontext.  This va\n-0000a8b0: 6c75 6520 6361 6e20 6265 0a20 2020 2020  lue can be.     \n-0000a8c0: 6368 6563 6b65 6420 6167 6169 6e73 7420  checked against \n-0000a8d0: 7468 6520 6c69 7374 206f 6620 7661 6c69  the list of vali\n-0000a8e0: 6420 6469 6765 7374 5f74 7970 6573 206c  d digest_types l\n-0000a8f0: 6973 7465 6420 696e 202a 6e6f 7465 0a20  isted in *note. \n-0000a900: 2020 2020 456e 6372 7970 7469 6f6e 2041      Encryption A\n-0000a910: 6c67 6f72 6974 686d 733a 3a20 6f66 2074  lgorithms:: of t\n-0000a920: 6869 7320 6d61 6e75 616c 2e20 2054 6865  his manual.  The\n-0000a930: 2072 6574 7572 6e20 7661 6c75 6520 6973   return value is\n-0000a940: 2061 6e20 464b 4f0a 2020 2020 2065 7272   an FKO.     err\n-0000a950: 6f72 2073 7461 7475 732e 0a0a 202d 2d20  or status... -- \n-0000a960: 4675 6e63 7469 6f6e 3a20 696e 7420 666b  Function: int fk\n-0000a970: 6f5f 6765 745f 656e 636f 6465 645f 6461  o_get_encoded_da\n-0000a980: 7461 2028 666b 6f5f 6374 785f 7420 4354  ta (fko_ctx_t CT\n-0000a990: 582c 2063 6861 7220 2a2a 454e 435f 4d53  X, char **ENC_MS\n-0000a9a0: 4729 3b0a 2020 2020 2041 7373 6967 6e73  G);.     Assigns\n-0000a9b0: 2074 6865 2070 6f69 6e74 6572 2074 6f20   the pointer to \n-0000a9c0: 7468 6520 7374 7269 6e67 2068 6f6c 6469  the string holdi\n-0000a9d0: 6e67 2074 6865 2074 6865 2065 6e63 6f64  ng the the encod\n-0000a9e0: 6564 2053 5041 2064 6174 610a 2020 2020  ed SPA data.    \n-0000a9f0: 2028 6265 666f 7265 2065 6e63 7279 7074   (before encrypt\n-0000aa00: 696f 6e29 2061 7373 6f63 6961 7465 6420  ion) associated \n-0000aa10: 7769 7468 2074 6865 2063 7572 7265 6e74  with the current\n-0000aa20: 2063 6f6e 7465 7874 2074 6f20 7468 650a   context to the.\n-0000aa30: 2020 2020 2061 6464 7265 7373 2045 4e43       address ENC\n-0000aa40: 5f4d 5347 2069 7320 706f 696e 7469 6e67  _MSG is pointing\n-0000aa50: 2074 6f2e 2020 5468 6973 2069 7320 696e   to.  This is in\n-0000aa60: 7465 726d 6564 6961 7465 2064 6174 6120  termediate data \n-0000aa70: 7468 6174 0a20 2020 2020 776f 756c 6420  that.     would \n-0000aa80: 6e6f 7420 6e6f 726d 616c 6c79 2062 6520  not normally be \n-0000aa90: 6f66 2075 7365 2075 6e6c 6573 7320 6465  of use unless de\n-0000aaa0: 6275 6767 696e 6720 7468 6520 6c69 6272  bugging the libr\n-0000aab0: 6172 792e 2020 5468 650a 2020 2020 2072  ary.  The.     r\n-0000aac0: 6574 7572 6e20 7661 6c75 6520 6973 2061  eturn value is a\n-0000aad0: 6e20 464b 4f20 6572 726f 7220 7374 6174  n FKO error stat\n-0000aae0: 7573 2e0a 0a20 2d2d 2046 756e 6374 696f  us... -- Functio\n-0000aaf0: 6e3a 2069 6e74 2066 6b6f 5f67 6574 5f76  n: int fko_get_v\n-0000ab00: 6572 7369 6f6e 2028 666b 6f5f 6374 785f  ersion (fko_ctx_\n-0000ab10: 7420 4354 582c 2063 6861 7220 2a2a 464b  t CTX, char **FK\n-0000ab20: 4f5f 5645 5253 494f 4e29 3b0a 2020 2020  O_VERSION);.    \n-0000ab30: 2041 7373 6967 6e73 2074 6865 2070 6f69   Assigns the poi\n-0000ab40: 6e74 6572 2074 6f20 7468 6520 7374 7269  nter to the stri\n-0000ab50: 6e67 2068 6f6c 6469 6e67 2074 6865 2074  ng holding the t\n-0000ab60: 6865 2053 5041 2076 6572 7369 6f6e 2076  he SPA version v\n-0000ab70: 616c 7565 0a20 2020 2020 6173 736f 6369  alue.     associ\n-0000ab80: 6174 6564 2077 6974 6820 7468 6520 6375  ated with the cu\n-0000ab90: 7272 656e 7420 636f 6e74 6578 7420 746f  rrent context to\n-0000aba0: 2074 6865 2061 6464 7265 7373 2046 4b4f   the address FKO\n-0000abb0: 5f56 4552 5349 4f4e 2069 730a 2020 2020  _VERSION is.    \n-0000abc0: 2070 6f69 6e74 696e 6720 746f 2e20 2054   pointing to.  T\n-0000abd0: 6869 7320 6973 2061 2073 7461 7469 6320  his is a static \n-0000abe0: 7661 6c75 6520 666f 7220 5350 4120 6461  value for SPA da\n-0000abf0: 7461 2074 6861 7420 6973 2062 6569 6e67  ta that is being\n-0000ac00: 0a20 2020 2020 6372 6561 7465 6420 696e  .     created in\n-0000ac10: 2061 206e 6577 2063 6f6e 7465 7874 2e20   a new context. \n-0000ac20: 2046 6f72 2064 6174 6120 7061 7273 6564   For data parsed\n-0000ac30: 2066 726f 6d20 616e 2065 7874 6572 6e61   from an externa\n-0000ac40: 6c20 736f 7572 6365 2c0a 2020 2020 2074  l source,.     t\n-0000ac50: 6865 2076 6572 7369 6f6e 2073 7472 696e  he version strin\n-0000ac60: 6720 7769 6c6c 2062 6520 7768 6174 6576  g will be whatev\n-0000ac70: 6572 2076 6572 7369 6f6e 2074 6865 2073  er version the s\n-0000ac80: 656e 6469 6e67 2063 6c69 656e 740a 2020  ending client.  \n-0000ac90: 2020 2075 7365 642e 2020 5468 6520 7265     used.  The re\n-0000aca0: 7475 726e 2076 616c 7565 2069 7320 616e  turn value is an\n-0000acb0: 2046 4b4f 2065 7272 6f72 2073 7461 7475   FKO error statu\n-0000acc0: 732e 0a0a 5f47 5047 2d73 7065 6369 6669  s..._GPG-specifi\n-0000acd0: 6320 6675 6e63 7469 6f6e 733a 5f0a 0a20  c functions:_.. \n-0000ace0: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int\n-0000acf0: 2066 6b6f 5f67 6574 5f67 7067 5f72 6563   fko_get_gpg_rec\n-0000ad00: 6970 6965 6e74 2028 666b 6f5f 6374 785f  ipient (fko_ctx_\n-0000ad10: 7420 4354 582c 2063 6861 720a 2020 2020  t CTX, char.    \n-0000ad20: 2020 2020 2020 2a2a 5245 4349 5049 454e        **RECIPIEN\n-0000ad30: 5429 3b0a 2020 2020 2041 7373 6967 6e73  T);.     Assigns\n-0000ad40: 2074 6865 2070 6f69 6e74 6572 2074 6f20   the pointer to \n-0000ad50: 7468 6520 7374 7269 6e67 2068 6f6c 6469  the string holdi\n-0000ad60: 6e67 2074 6865 2074 6865 2047 5047 2072  ng the the GPG r\n-0000ad70: 6563 6970 6965 6e74 2049 440a 2020 2020  ecipient ID.    \n-0000ad80: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with\n-0000ad90: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con\n-0000ada0: 7465 7874 2074 6f20 7468 6520 6164 6472  text to the addr\n-0000adb0: 6573 7320 5245 4349 5049 454e 5420 6973  ess RECIPIENT is\n-0000adc0: 0a20 2020 2020 706f 696e 7469 6e67 2074  .     pointing t\n-0000add0: 6f2e 2020 5468 6520 7265 7475 726e 2076  o.  The return v\n-0000ade0: 616c 7565 2069 7320 616e 2046 4b4f 2065  alue is an FKO e\n-0000adf0: 7272 6f72 2073 7461 7475 732e 0a0a 202d  rror status... -\n-0000ae00: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int \n-0000ae10: 666b 6f5f 6765 745f 6770 675f 7369 676e  fko_get_gpg_sign\n-0000ae20: 6572 2028 666b 6f5f 6374 785f 7420 4354  er (fko_ctx_t CT\n-0000ae30: 582c 2063 6861 7220 2a2a 5349 474e 4552  X, char **SIGNER\n-0000ae40: 293b 0a20 2020 2020 4173 7369 676e 7320  );.     Assigns \n-0000ae50: 7468 6520 706f 696e 7465 7220 746f 2074  the pointer to t\n-0000ae60: 6865 2073 7472 696e 6720 686f 6c64 696e  he string holdin\n-0000ae70: 6720 7468 6520 7468 6520 4750 4720 7369  g the the GPG si\n-0000ae80: 676e 6572 2049 440a 2020 2020 2061 7373  gner ID.     ass\n-0000ae90: 6f63 6961 7465 6420 7769 7468 2074 6865  ociated with the\n-0000aea0: 2063 7572 7265 6e74 2063 6f6e 7465 7874   current context\n-0000aeb0: 2074 6f20 7468 6520 6164 6472 6573 7320   to the address \n-0000aec0: 5349 474e 4552 2069 730a 2020 2020 2070  SIGNER is.     p\n-0000aed0: 6f69 6e74 696e 6720 746f 2e20 2054 6865  ointing to.  The\n-0000aee0: 2072 6574 7572 6e20 7661 6c75 6520 6973   return value is\n-0000aef0: 2061 6e20 464b 4f20 6572 726f 7220 7374   an FKO error st\n-0000af00: 6174 7573 2e0a 0a20 2d2d 2046 756e 6374  atus... -- Funct\n-0000af10: 696f 6e3a 2069 6e74 2066 6b6f 5f67 6574  ion: int fko_get\n-0000af20: 5f67 7067 5f68 6f6d 655f 6469 7220 2866  _gpg_home_dir (f\n-0000af30: 6b6f 5f63 7478 5f74 2043 5458 2c20 6368  ko_ctx_t CTX, ch\n-0000af40: 6172 202a 2a47 5047 5f44 4952 293b 0a20  ar **GPG_DIR);. \n-0000af50: 2020 2020 4173 7369 676e 7320 7468 6520      Assigns the \n-0000af60: 706f 696e 7465 7220 746f 2074 6865 2073  pointer to the s\n-0000af70: 7472 696e 6720 686f 6c64 696e 6720 7468  tring holding th\n-0000af80: 6520 7468 6520 4750 4720 686f 6d65 0a20  e the GPG home. \n-0000af90: 2020 2020 6469 7265 6374 6f72 7920 6173      directory as\n-0000afa0: 736f 6369 6174 6564 2077 6974 6820 7468  sociated with th\n-0000afb0: 6520 6375 7272 656e 7420 636f 6e74 6578  e current contex\n-0000afc0: 7420 746f 2074 6865 2061 6464 7265 7373  t to the address\n-0000afd0: 0a20 2020 2020 4750 475f 4449 5220 6973  .     GPG_DIR is\n-0000afe0: 2070 6f69 6e74 696e 6720 746f 2e20 2054   pointing to.  T\n-0000aff0: 6865 2072 6574 7572 6e20 7661 6c75 6520  he return value \n-0000b000: 6973 2061 6e20 464b 4f20 6572 726f 7220  is an FKO error \n-0000b010: 7374 6174 7573 2e0a 0a20 2d2d 2046 756e  status... -- Fun\n-0000b020: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f67  ction: int fko_g\n-0000b030: 6574 5f67 7067 5f73 6967 6e61 7475 7265  et_gpg_signature\n-0000b040: 5f76 6572 6966 7920 2866 6b6f 5f63 7478  _verify (fko_ctx\n-0000b050: 5f74 2043 5458 2c20 756e 7369 676e 6564  _t CTX, unsigned\n-0000b060: 0a20 2020 2020 2020 2020 2063 6861 7220  .          char \n-0000b070: 2a56 414c 293b 0a20 2020 2020 5365 7473  *VAL);.     Sets\n-0000b080: 2074 6865 2076 616c 7565 206f 6620 7468   the value of th\n-0000b090: 6520 5641 4c20 7661 7269 6162 6c65 2074  e VAL variable t\n-0000b0a0: 6f20 7468 6520 6375 7272 656e 740a 2020  o the current.  \n-0000b0b0: 2020 2067 7067 5f73 6967 6e61 7475 7265     gpg_signature\n-0000b0c0: 5f76 6572 6966 7920 666c 6167 2076 616c  _verify flag val\n-0000b0d0: 7565 2061 7373 6f63 6961 7465 6420 7769  ue associated wi\n-0000b0e0: 7468 2074 6865 2063 7572 7265 6e74 0a20  th the current. \n-0000b0f0: 2020 2020 636f 6e74 6578 742e 2020 5468      context.  Th\n-0000b100: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i\n-0000b110: 7320 616e 2046 4b4f 2065 7272 6f72 2073  s an FKO error s\n-0000b120: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func\n-0000b130: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge\n-0000b140: 745f 6770 675f 6967 6e6f 7265 5f76 6572  t_gpg_ignore_ver\n-0000b150: 6966 795f 6572 726f 7220 2866 6b6f 5f63  ify_error (fko_c\n-0000b160: 7478 5f74 2043 5458 2c0a 2020 2020 2020  tx_t CTX,.      \n-0000b170: 2020 2020 756e 7369 676e 6564 2063 6861      unsigned cha\n-0000b180: 7220 2a56 414c 293b 0a20 2020 2020 5365  r *VAL);.     Se\n-0000b190: 7473 2074 6865 2076 616c 7565 206f 6620  ts the value of \n-0000b1a0: 7468 6520 5641 4c20 7661 7269 6162 6c65  the VAL variable\n-0000b1b0: 2074 6f20 7468 6520 6375 7272 656e 740a   to the current.\n-0000b1c0: 2020 2020 2069 676e 6f72 655f 7665 7269       ignore_veri\n-0000b1d0: 6679 5f65 7272 6f72 2066 6c61 6720 7661  fy_error flag va\n-0000b1e0: 6c75 6520 6173 736f 6369 6174 6564 2077  lue associated w\n-0000b1f0: 6974 6820 7468 6520 6375 7272 656e 7420  ith the current \n-0000b200: 636f 6e74 6578 742e 0a20 2020 2020 5468  context..     Th\n-0000b210: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i\n-0000b220: 7320 616e 2046 4b4f 2065 7272 6f72 2073  s an FKO error s\n-0000b230: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func\n-0000b240: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge\n-0000b250: 745f 6770 675f 7369 676e 6174 7572 655f  t_gpg_signature_\n-0000b260: 6964 2028 666b 6f5f 6374 785f 7420 4354  id (fko_ctx_t CT\n-0000b270: 582c 2063 6861 720a 2020 2020 2020 2020  X, char.        \n-0000b280: 2020 2a2a 5349 475f 4944 293b 0a20 2020    **SIG_ID);.   \n-0000b290: 2020 4173 7369 676e 7320 7468 6520 706f    Assigns the po\n-0000b2a0: 696e 7465 7220 746f 2074 6865 2073 7472  inter to the str\n-0000b2b0: 696e 6720 686f 6c64 696e 6720 7468 6520  ing holding the \n-0000b2c0: 7468 6520 4750 4720 7369 676e 6174 7572  the GPG signatur\n-0000b2d0: 6520 4944 0a20 2020 2020 6173 736f 6369  e ID.     associ\n-0000b2e0: 6174 6564 2077 6974 6820 7468 6520 6375  ated with the cu\n-0000b2f0: 7272 656e 7420 636f 6e74 6578 7420 746f  rrent context to\n-0000b300: 2074 6865 2061 6464 7265 7373 2053 4947   the address SIG\n-0000b310: 5f49 4420 6973 0a20 2020 2020 706f 696e  _ID is.     poin\n-0000b320: 7469 6e67 2074 6f2e 2020 5468 6520 7265  ting to.  The re\n-0000b330: 7475 726e 2076 616c 7565 2069 7320 616e  turn value is an\n-0000b340: 2046 4b4f 2065 7272 6f72 2073 7461 7475   FKO error statu\n-0000b350: 732e 0a0a 202d 2d20 4675 6e63 7469 6f6e  s... -- Function\n-0000b360: 3a20 696e 7420 666b 6f5f 6765 745f 6770  : int fko_get_gp\n-0000b370: 675f 7369 676e 6174 7572 655f 6670 7220  g_signature_fpr \n-0000b380: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, \n-0000b390: 6368 6172 0a20 2020 2020 2020 2020 202a  char.          *\n-0000b3a0: 2a53 4947 5f46 5052 293b 0a20 2020 2020  *SIG_FPR);.     \n-0000b3b0: 4173 7369 676e 7320 7468 6520 706f 696e  Assigns the poin\n-0000b3c0: 7465 7220 746f 2074 6865 2073 7472 696e  ter to the strin\n-0000b3d0: 6720 686f 6c64 696e 6720 7468 6520 7468  g holding the th\n-0000b3e0: 6520 4750 4720 7369 676e 6174 7572 650a  e GPG signature.\n-0000b3f0: 2020 2020 2066 696e 6765 7270 7269 6e74       fingerprint\n-0000b400: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with\n-0000b410: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con\n-0000b420: 7465 7874 2074 6f20 7468 6520 6164 6472  text to the addr\n-0000b430: 6573 730a 2020 2020 2053 4947 5f46 5052  ess.     SIG_FPR\n-0000b440: 2069 7320 706f 696e 7469 6e67 2074 6f2e   is pointing to.\n-0000b450: 2020 5468 6520 7265 7475 726e 2076 616c    The return val\n-0000b460: 7565 2069 7320 616e 2046 4b4f 2065 7272  ue is an FKO err\n-0000b470: 6f72 2073 7461 7475 732e 0a0a 202d 2d20  or status... -- \n-0000b480: 4675 6e63 7469 6f6e 3a20 696e 7420 666b  Function: int fk\n-0000b490: 6f5f 6765 745f 6770 675f 7369 676e 6174  o_get_gpg_signat\n-0000b4a0: 7572 655f 7375 6d6d 6172 7920 2866 6b6f  ure_summary (fko\n-0000b4b0: 5f63 7478 5f74 2043 5458 2c20 696e 740a  _ctx_t CTX, int.\n-0000b4c0: 2020 2020 2020 2020 2020 2a53 4947 5f53            *SIG_S\n-0000b4d0: 554d 293b 0a20 2020 2020 5365 7473 2074  UM);.     Sets t\n-0000b4e0: 6865 2076 616c 7565 206f 6620 7468 6520  he value of the \n-0000b4f0: 5349 475f 5355 4d20 7661 7269 6162 6c65  SIG_SUM variable\n-0000b500: 2074 6f20 7468 6520 4750 4720 7369 676e   to the GPG sign\n-0000b510: 6174 7572 6520 7375 6d6d 6172 790a 2020  ature summary.  \n-0000b520: 2020 2076 616c 7565 2061 7373 6f63 6961     value associa\n-0000b530: 7465 6420 7769 7468 2074 6865 2063 7572  ted with the cur\n-0000b540: 7265 6e74 2063 6f6e 7465 7874 2e20 2054  rent context.  T\n-0000b550: 6865 2072 6574 7572 6e20 7661 6c75 6520  he return value \n-0000b560: 6973 2061 6e0a 2020 2020 2046 4b4f 2065  is an.     FKO e\n-0000b570: 7272 6f72 2073 7461 7475 732e 0a0a 202d  rror status... -\n-0000b580: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int \n-0000b590: 666b 6f5f 6765 745f 6770 675f 7369 676e  fko_get_gpg_sign\n-0000b5a0: 6174 7572 655f 7374 6174 7573 2028 666b  ature_status (fk\n-0000b5b0: 6f5f 6374 785f 7420 4354 582c 2069 6e74  o_ctx_t CTX, int\n-0000b5c0: 0a20 2020 2020 2020 2020 202a 5349 475f  .          *SIG_\n-0000b5d0: 5354 4154 293b 0a20 2020 2020 5365 7473  STAT);.     Sets\n-0000b5e0: 2074 6865 2076 616c 7565 206f 6620 7468   the value of th\n-0000b5f0: 6520 5349 475f 5354 4154 2076 6172 6961  e SIG_STAT varia\n-0000b600: 626c 6520 746f 2074 6865 2047 5047 2073  ble to the GPG s\n-0000b610: 6967 6e61 7475 7265 2065 7272 6f72 0a20  ignature error. \n-0000b620: 2020 2020 7374 6174 7573 2076 616c 7565      status value\n-0000b630: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with\n-0000b640: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con\n-0000b650: 7465 7874 2e20 2054 6865 2072 6574 7572  text.  The retur\n-0000b660: 6e20 7661 6c75 650a 2020 2020 2069 7320  n value.     is \n-0000b670: 616e 2046 4b4f 2065 7272 6f72 2073 7461  an FKO error sta\n-0000b680: 7475 732e 0a0a 202d 2d20 4675 6e63 7469  tus... -- Functi\n-0000b690: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_\n-0000b6a0: 6770 675f 6578 6520 2866 6b6f 5f63 7478  gpg_exe (fko_ctx\n-0000b6b0: 5f74 2043 5458 2c20 6368 6172 202a 2a47  _t CTX, char **G\n-0000b6c0: 5047 5f45 5845 293b 0a20 2020 2020 4173  PG_EXE);.     As\n-0000b6d0: 7369 676e 7320 7468 6520 706f 696e 7465  signs the pointe\n-0000b6e0: 7220 746f 2074 6865 2073 7472 696e 6720  r to the string \n-0000b6f0: 686f 6c64 696e 6720 7468 6520 7468 6520  holding the the \n-0000b700: 4750 4720 6578 6563 7574 6162 6c65 0a20  GPG executable. \n-0000b710: 2020 2020 7061 7468 2061 7373 6f63 6961      path associa\n-0000b720: 7465 6420 7769 7468 2074 6865 2063 7572  ted with the cur\n-0000b730: 7265 6e74 2063 6f6e 7465 7874 2074 6f20  rent context to \n-0000b740: 7468 6520 6164 6472 6573 7320 4750 475f  the address GPG_\n-0000b750: 4558 4520 6973 0a20 2020 2020 706f 696e  EXE is.     poin\n-0000b760: 7469 6e67 2074 6f2e 2020 5468 6520 7265  ting to.  The re\n-0000b770: 7475 726e 2076 616c 7565 2069 7320 616e  turn value is an\n-0000b780: 2046 4b4f 2065 7272 6f72 2073 7461 7475   FKO error statu\n-0000b790: 732e 0a0a 2a4e 6f74 652a 3a20 5468 6520  s...*Note*: The \n-0000b7a0: 6368 6172 2a20 7661 6c75 6573 2072 6574  char* values ret\n-0000b7b0: 7269 6576 6564 2062 7920 7468 6520 4750  rieved by the GP\n-0000b7c0: 472d 7265 6c61 7465 6420 6675 6e63 7469  G-related functi\n-0000b7d0: 6f6e 7320 6162 6f76 650a 7769 6c6c 2062  ons above.will b\n-0000b7e0: 6520 4e55 4c4c 2069 6620 7468 6520 636f  e NULL if the co\n-0000b7f0: 6e74 6578 7420 7661 6c75 6520 7761 7320  ntext value was \n-0000b800: 6e6f 7420 7072 6576 696f 7573 6c79 2073  not previously s\n-0000b810: 6574 2e0a 0a1f 0a46 696c 653a 206c 6962  et.....File: lib\n-0000b820: 666b 6f2e 696e 666f 2c20 204e 6f64 653a  fko.info,  Node:\n-0000b830: 2055 7469 6c69 7479 2046 756e 6374 696f   Utility Functio\n-0000b840: 6e73 2c20 204e 6578 743a 2045 7272 6f72  ns,  Next: Error\n-0000b850: 2048 616e 646c 696e 672c 2020 5072 6576   Handling,  Prev\n-0000b860: 3a20 5265 7472 6965 7669 6e67 2053 5041  : Retrieving SPA\n-0000b870: 2044 6174 612c 2020 5570 3a20 5573 696e   Data,  Up: Usin\n-0000b880: 6720 6c69 6266 6b6f 0a0a 332e 3620 5574  g libfko..3.6 Ut\n-0000b890: 696c 6974 7920 4675 6e63 7469 6f6e 730a  ility Functions.\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 0000b8a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================\n-0000b8b0: 3d3d 3d3d 3d0a 0a54 6869 7320 7365 6374  =====..This sect\n-0000b8c0: 696f 6e20 6465 7363 7269 6265 7320 7468  ion describes th\n-0000b8d0: 6520 6675 6e63 7469 6f6e 7320 6e6f 7420  e functions not \n-0000b8e0: 636f 7665 7265 6420 656c 7365 7768 6572  covered elsewher\n-0000b8f0: 6520 696e 2074 6869 730a 6d61 6e75 616c  e in this.manual\n-0000b900: 2e20 2054 6865 7365 2061 7265 2075 7469  .  These are uti\n-0000b910: 6c69 7479 2066 756e 6374 696f 6e73 2074  lity functions t\n-0000b920: 6861 7420 6f70 6572 6174 6520 6f6e 2074  hat operate on t\n-0000b930: 6865 2064 6174 6120 696e 2074 6865 2066  he data in the f\n-0000b940: 6b6f 0a63 6f6e 7465 7874 2e20 2041 6c6c  ko.context.  All\n-0000b950: 2062 7574 2027 666b 6f5f 7370 615f 6461   but 'fko_spa_da\n-0000b960: 7461 5f66 696e 616c 2720 6172 6520 6361  ta_final' are ca\n-0000b970: 6c6c 6564 2062 7920 6f74 6865 7220 6675  lled by other fu\n-0000b980: 6e63 7469 6f6e 7320 616e 640a 6172 6520  nctions and.are \n-0000b990: 6e6f 7420 6e6f 726d 616c 6c79 2065 7870  not normally exp\n-0000b9a0: 6c69 6369 746c 7920 6361 6c6c 6564 2062  licitly called b\n-0000b9b0: 7920 7468 6520 7573 6572 2e20 2048 6f77  y the user.  How\n-0000b9c0: 6576 6572 2c20 7468 6579 2063 616e 2062  ever, they can b\n-0000b9d0: 652c 0a73 6f20 7468 6579 2061 7265 206c  e,.so they are l\n-0000b9e0: 6973 7465 6420 6865 7265 2e0a 0a20 2020  isted here...   \n-0000b9f0: 416c 6c20 6f66 2074 6865 7365 2066 756e  All of these fun\n-0000ba00: 6374 696f 6e73 2072 6574 7572 6e20 616e  ctions return an\n-0000ba10: 2069 6e74 6567 6572 2072 6570 7265 7365   integer represe\n-0000ba20: 6e74 696e 6720 7468 6520 7265 7475 726e  nting the return\n-0000ba30: 0a73 7461 7475 7320 6f66 2074 6865 2066  .status of the f\n-0000ba40: 756e 6374 696f 6e2e 2020 5768 656e 2073  unction.  When s\n-0000ba50: 7563 6365 7366 756c 6c2c 2074 6865 7920  uccesfull, they \n-0000ba60: 7769 6c6c 2072 6574 7572 6e0a 2746 4b4f  will return.'FKO\n-0000ba70: 5f53 5543 4345 5353 272e 2020 4f74 6865  _SUCCESS'.  Othe\n-0000ba80: 7277 6973 652c 2061 6e20 6572 726f 7220  rwise, an error \n-0000ba90: 636f 6465 2076 616c 7565 2069 7320 7265  code value is re\n-0000baa0: 7475 726e 6564 2e0a 0a20 2d2d 2046 756e  turned... -- Fun\n-0000bab0: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f73  ction: int fko_s\n-0000bac0: 7061 5f64 6174 615f 6669 6e61 6c20 2866  pa_data_final (f\n-0000bad0: 6b6f 5f63 7478 5f74 2043 5458 2c20 6368  ko_ctx_t CTX, ch\n-0000bae0: 6172 202a 454e 435f 4b45 592c 2069 6e74  ar *ENC_KEY, int\n-0000baf0: 0a20 2020 2020 2020 2020 204b 454e 5f4c  .          KEN_L\n-0000bb00: 454e 2c20 6368 6172 202a 484d 4143 5f4b  EN, char *HMAC_K\n-0000bb10: 4559 2c20 696e 7420 484d 4143 5f4b 4559  EY, int HMAC_KEY\n-0000bb20: 5f4c 454e 293b 0a20 2020 2020 5468 6973  _LEN);.     This\n-0000bb30: 2066 756e 6374 696f 6e20 6973 2074 6865   function is the\n-0000bb40: 2066 696e 616c 2073 7465 7020 696e 2063   final step in c\n-0000bb50: 7265 6174 696e 6720 6120 636f 6d70 6c65  reating a comple\n-0000bb60: 7465 2065 6e63 7279 7074 6564 0a20 2020  te encrypted.   \n-0000bb70: 2020 5350 4120 6461 7461 2073 7472 696e    SPA data strin\n-0000bb80: 6720 7375 6974 6162 6c65 2066 6f72 2074  g suitable for t\n-0000bb90: 7261 6e73 6d69 7373 696f 6e20 746f 2061  ransmission to a\n-0000bba0: 6e20 6677 6b6e 6f70 2073 6572 7665 722e  n fwknop server.\n-0000bbb0: 2020 4974 0a20 2020 2020 646f 6573 2072    It.     does r\n-0000bbc0: 6571 7569 7265 2061 6c6c 206f 6620 7468  equire all of th\n-0000bbd0: 6520 7265 7175 6973 6974 6520 5350 4120  e requisite SPA \n-0000bbe0: 6461 7461 2066 6965 6c64 7320 6265 2073  data fields be s\n-0000bbf0: 6574 2c20 6f74 6865 7277 6973 650a 2020  et, otherwise.  \n-0000bc00: 2020 2069 7420 7769 6c6c 2066 6169 6c20     it will fail \n-0000bc10: 7769 7468 2061 6e20 6170 7072 6f70 7269  with an appropri\n-0000bc20: 6174 6520 6572 726f 7220 636f 6465 2e0a  ate error code..\n-0000bc30: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i\n-0000bc40: 6e74 2066 6b6f 5f64 6563 7279 7074 5f73  nt fko_decrypt_s\n-0000bc50: 7061 5f64 6174 6120 2866 6b6f 5f63 7478  pa_data (fko_ctx\n-0000bc60: 5f74 2043 5458 2c20 6368 6172 202a 4445  _t CTX, char *DE\n-0000bc70: 435f 4b45 592c 0a20 2020 2020 2020 2020  C_KEY,.         \n-0000bc80: 2069 6e74 204b 4559 5f4c 454e 293b 0a20   int KEY_LEN);. \n-0000bc90: 2020 2020 5768 656e 2067 6976 656e 2074      When given t\n-0000bca0: 6865 2063 6f72 7265 6374 204b 4559 2028  he correct KEY (\n-0000bcb0: 7061 7373 776f 7264 292c 2074 6869 7320  password), this \n-0000bcc0: 6675 6e63 7469 6f6e 2064 6563 7279 7074  function decrypt\n-0000bcd0: 732c 0a20 2020 2020 6465 636f 6465 732c  s,.     decodes,\n-0000bce0: 2061 6e64 2070 6172 7365 7320 7468 6520   and parses the \n-0000bcf0: 656e 6372 7970 7465 6420 5350 4120 6461  encrypted SPA da\n-0000bd00: 7461 2074 6861 7420 7761 7320 7375 7070  ta that was supp\n-0000bd10: 6c69 6564 2074 6f20 7468 650a 2020 2020  lied to the.    \n-0000bd20: 2063 6f6e 7465 7874 2076 6961 2074 6865   context via the\n-0000bd30: 2027 666b 6f5f 6e65 775f 7769 7468 5f64   'fko_new_with_d\n-0000bd40: 6174 6127 2066 756e 6374 696f 6e20 7468  ata' function th\n-0000bd50: 6174 2077 6173 2061 6c73 6f20 6361 6c6c  at was also call\n-0000bd60: 6564 0a20 2020 2020 7769 7468 6f75 7420  ed.     without \n-0000bd70: 7468 6520 4b45 5920 7661 6c75 652e 2020  the KEY value.  \n-0000bd80: 4f6e 6365 2074 6865 2064 6174 6120 6973  Once the data is\n-0000bd90: 2064 6563 7279 7074 6564 2c20 7468 6973   decrypted, this\n-0000bda0: 2066 756e 6374 696f 6e0a 2020 2020 2077   function.     w\n-0000bdb0: 696c 6c20 616c 736f 2063 616c 6c20 2766  ill also call 'f\n-0000bdc0: 6b6f 5f64 6563 6f64 655f 7370 615f 6461  ko_decode_spa_da\n-0000bdd0: 7461 2720 746f 2064 6563 6f64 652c 2070  ta' to decode, p\n-0000bde0: 6172 7365 2c20 7661 6c69 6461 7465 2c0a  arse, validate,.\n-0000bdf0: 2020 2020 2061 6e64 2073 746f 7265 2074       and store t\n-0000be00: 6865 2064 6174 6120 6669 656c 6473 2069  he data fields i\n-0000be10: 6e20 7468 6520 636f 6e74 6578 7420 666f  n the context fo\n-0000be20: 7220 6c61 7465 7220 7265 7472 6965 7661  r later retrieva\n-0000be30: 6c2e 0a0a 202d 2d20 4675 6e63 7469 6f6e  l... -- Function\n-0000be40: 3a20 696e 7420 666b 6f5f 656e 6372 7970  : int fko_encryp\n-0000be50: 745f 7370 615f 6461 7461 2028 666b 6f5f  t_spa_data (fko_\n-0000be60: 6374 785f 7420 4354 582c 2063 6861 7220  ctx_t CTX, char \n-0000be70: 2a45 4e43 5f4b 4559 2c0a 2020 2020 2020  *ENC_KEY,.      \n-0000be80: 2020 2020 696e 7420 4b45 595f 4c45 4e29      int KEY_LEN)\n-0000be90: 3b0a 2020 2020 2045 6e63 7279 7074 7320  ;.     Encrypts \n-0000bea0: 7468 6520 696e 7465 726d 6564 6961 7465  the intermediate\n-0000beb0: 2065 6e63 6f64 6564 2053 5041 2064 6174   encoded SPA dat\n-0000bec0: 6120 7374 6f72 6564 2069 6e20 7468 6520  a stored in the \n-0000bed0: 636f 6e74 6578 742e 0a20 2020 2020 5468  context..     Th\n-0000bee0: 6973 2066 756e 6374 696f 6e20 7769 6c6c  is function will\n-0000bef0: 2063 616c 6c20 2766 6b6f 5f65 6e63 6f64   call 'fko_encod\n-0000bf00: 6527 2069 6620 6e65 6365 7373 6172 792e  e' if necessary.\n-0000bf10: 2020 4974 2069 7320 6e6f 726d 616c 6c79    It is normally\n-0000bf20: 0a20 2020 2020 6e6f 7420 6361 6c6c 6564  .     not called\n-0000bf30: 2064 6972 6563 746c 7920 6173 2069 7420   directly as it \n-0000bf40: 6973 2063 616c 6c65 6420 6672 6f6d 2027  is called from '\n-0000bf50: 666b 6f5f 7370 615f 6461 7461 5f66 696e  fko_spa_data_fin\n-0000bf60: 616c 272e 0a0a 202d 2d20 4675 6e63 7469  al'... -- Functi\n-0000bf70: 6f6e 3a20 696e 7420 666b 6f5f 6465 636f  on: int fko_deco\n-0000bf80: 6465 5f73 7061 5f64 6174 6120 2866 6b6f  de_spa_data (fko\n-0000bf90: 5f63 7478 5f74 2043 5458 293b 0a20 2020  _ctx_t CTX);.   \n-0000bfa0: 2020 5468 6973 2066 756e 6374 696f 6e20    This function \n-0000bfb0: 7065 7266 6f72 6d73 2074 6865 2064 6563  performs the dec\n-0000bfc0: 6f64 696e 672c 2070 6172 7369 6e67 2c20  oding, parsing, \n-0000bfd0: 7661 6c69 6461 7469 6f6e 206f 6620 7468  validation of th\n-0000bfe0: 6520 5350 410a 2020 2020 2064 6174 6120  e SPA.     data \n-0000bff0: 7468 6174 2077 6173 206a 7573 7420 6465  that was just de\n-0000c000: 6372 7970 7465 642e 2020 4974 2069 7320  crypted.  It is \n-0000c010: 6e6f 726d 616c 6c79 206e 6f74 2063 616c  normally not cal\n-0000c020: 6c65 6420 6469 7265 6374 6c79 0a20 2020  led directly.   \n-0000c030: 2020 6173 2069 7420 6973 2063 616c 6c65    as it is calle\n-0000c040: 6420 6672 6f6d 2027 666b 6f5f 6465 6372  d from 'fko_decr\n-0000c050: 7970 745f 7370 615f 6461 7461 2720 2877  ypt_spa_data' (w\n-0000c060: 6869 6368 2069 7320 696e 2074 7572 6e0a  hich is in turn.\n-0000c070: 2020 2020 2063 616c 6c65 6420 6672 6f6d       called from\n-0000c080: 2027 666b 6f5f 6e65 775f 7769 7468 5f64   'fko_new_with_d\n-0000c090: 6174 6127 2069 6620 6120 7061 7373 776f  ata' if a passwo\n-0000c0a0: 7264 2069 7320 7375 7070 6c69 6564 2074  rd is supplied t\n-0000c0b0: 6f20 6974 292e 0a0a 202d 2d20 4675 6e63  o it)... -- Func\n-0000c0c0: 7469 6f6e 3a20 696e 7420 666b 6f5f 656e  tion: int fko_en\n-0000c0d0: 636f 6465 5f73 7061 5f64 6174 6120 2866  code_spa_data (f\n-0000c0e0: 6b6f 5f63 7478 5f74 2043 5458 293b 0a20  ko_ctx_t CTX);. \n-0000c0f0: 2020 2020 5065 7266 6f72 6d73 2074 6865      Performs the\n-0000c100: 2062 6173 6536 3420 656e 636f 6469 6e67   base64 encoding\n-0000c110: 206f 6620 7468 6f73 6520 5350 4120 6461   of those SPA da\n-0000c120: 7461 2066 6965 6c64 7320 7468 6174 206e  ta fields that n\n-0000c130: 6565 6420 746f 0a20 2020 2020 6265 2065  eed to.     be e\n-0000c140: 6e63 6f64 6564 2c20 7065 7266 6f72 6d73  ncoded, performs\n-0000c150: 2073 6f6d 6520 6461 7461 2076 616c 6964   some data valid\n-0000c160: 6174 696f 6e2c 2061 6e64 2063 616c 6c73  ation, and calls\n-0000c170: 0a20 2020 2020 2766 6b70 5f73 6574 5f73  .     'fkp_set_s\n-0000c180: 7061 5f64 6967 6573 7427 2074 6f20 7265  pa_digest' to re\n-0000c190: 636f 6d70 7574 6520 7468 6520 5350 4120  compute the SPA \n-0000c1a0: 6d65 7373 6167 6520 6469 6765 7374 2e20  message digest. \n-0000c1b0: 2049 7420 6973 0a20 2020 2020 6e6f 726d   It is.     norm\n-0000c1c0: 616c 6c79 206e 6f74 2063 616c 6c65 6420  ally not called \n-0000c1d0: 6469 7265 6374 6c79 2061 7320 6974 2069  directly as it i\n-0000c1e0: 7320 6361 6c6c 6564 2066 726f 6d0a 2020  s called from.  \n-0000c1f0: 2020 2027 666b 6f5f 656e 6372 7970 745f     'fko_encrypt_\n-0000c200: 7370 615f 6461 7461 2720 2877 6869 6368  spa_data' (which\n-0000c210: 2069 7320 696e 2074 7572 6e20 6361 6c6c   is in turn call\n-0000c220: 6564 2066 726f 6d0a 2020 2020 2027 666b  ed from.     'fk\n-0000c230: 6f5f 7370 615f 6461 7461 5f66 696e 616c  o_spa_data_final\n-0000c240: 2729 2e0a 0a5f 4750 472d 7370 6563 6966  ')..._GPG-specif\n-0000c250: 6963 2075 7469 6c69 7479 2066 756e 6374  ic utility funct\n-0000c260: 696f 6e73 3a5f 0a0a 202d 2d20 4675 6e63  ions:_.. -- Func\n-0000c270: 7469 6f6e 3a20 696e 7420 666b 6f5f 6770  tion: int fko_gp\n-0000c280: 675f 7369 676e 6174 7572 655f 6964 5f6d  g_signature_id_m\n-0000c290: 6174 6368 2028 666b 6f5f 6374 785f 7420  atch (fko_ctx_t \n-0000c2a0: 4354 582c 2063 6f6e 7374 2063 6861 720a  CTX, const char.\n-0000c2b0: 2020 2020 2020 2020 2020 2a49 442c 2075            *ID, u\n-0000c2c0: 6e73 6967 6e65 6420 6368 6172 202a 4944  nsigned char *ID\n-0000c2d0: 5f4d 4154 4348 293b 0a20 2020 2020 5365  _MATCH);.     Se\n-0000c2e0: 7473 2074 6865 2076 616c 7565 206f 6620  ts the value of \n-0000c2f0: 7468 6520 4944 5f4d 4154 4348 2076 6172  the ID_MATCH var\n-0000c300: 6961 626c 6520 746f 2074 7275 6520 2831  iable to true (1\n-0000c310: 2920 6966 2074 6865 2076 616c 7565 206f  ) if the value o\n-0000c320: 660a 2020 2020 2049 4420 6d61 7463 6865  f.     ID matche\n-0000c330: 7320 7468 6520 4944 206f 6620 7468 6520  s the ID of the \n-0000c340: 4750 4720 7369 676e 6174 7572 6520 6173  GPG signature as\n-0000c350: 736f 6369 6174 6564 2077 6974 6820 7468  sociated with th\n-0000c360: 6520 6375 7272 656e 740a 2020 2020 2063  e current.     c\n-0000c370: 6f6e 7465 7874 2e20 204f 7468 6572 7769  ontext.  Otherwi\n-0000c380: 7365 2c20 4944 5f4d 4154 4348 2069 7320  se, ID_MATCH is \n-0000c390: 7365 7420 746f 2066 616c 7365 2028 3029  set to false (0)\n-0000c3a0: 2e20 2054 6865 2072 6574 7572 6e0a 2020  .  The return.  \n-0000c3b0: 2020 2076 616c 7565 2069 7320 616e 2046     value is an F\n-0000c3c0: 4b4f 2065 7272 6f72 2073 7461 7475 732e  KO error status.\n-0000c3d0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: \n-0000c3e0: 696e 7420 666b 6f5f 6770 675f 7369 676e  int fko_gpg_sign\n-0000c3f0: 6174 7572 655f 6670 725f 6d61 7463 6820  ature_fpr_match \n-0000c400: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, \n-0000c410: 636f 6e73 7420 6368 6172 0a20 2020 2020  const char.     \n-0000c420: 2020 2020 202a 4650 522c 2075 6e73 6967       *FPR, unsig\n-0000c430: 6e65 6420 6368 6172 202a 4650 525f 4d41  ned char *FPR_MA\n-0000c440: 5443 4829 3b0a 2020 2020 2053 6574 7320  TCH);.     Sets \n-0000c450: 7468 6520 7661 6c75 6520 6f66 2074 6865  the value of the\n-0000c460: 2046 5052 5f4d 4154 4348 2076 6172 6961   FPR_MATCH varia\n-0000c470: 626c 6520 746f 2074 7275 6520 2831 2920  ble to true (1) \n-0000c480: 6966 2074 6865 2076 616c 7565 0a20 2020  if the value.   \n-0000c490: 2020 6f66 2046 5052 206d 6174 6368 6573    of FPR matches\n-0000c4a0: 2074 6865 2066 696e 6765 7270 7269 6e74   the fingerprint\n-0000c4b0: 206f 6620 7468 6520 4750 4720 7369 676e   of the GPG sign\n-0000c4c0: 6174 7572 6520 6173 736f 6369 6174 6564  ature associated\n-0000c4d0: 2077 6974 680a 2020 2020 2074 6865 2063   with.     the c\n-0000c4e0: 7572 7265 6e74 2063 6f6e 7465 7874 2e20  urrent context. \n-0000c4f0: 204f 7468 6572 7769 7365 2c20 4650 525f   Otherwise, FPR_\n-0000c500: 4d41 5443 4820 6973 2073 6574 2074 6f20  MATCH is set to \n-0000c510: 6661 6c73 6520 2830 292e 0a20 2020 2020  false (0)..     \n-0000c520: 5468 6520 7265 7475 726e 2076 616c 7565  The return value\n-0000c530: 2069 7320 616e 2046 4b4f 2065 7272 6f72   is an FKO error\n-0000c540: 2073 7461 7475 732e 0a0a 1f0a 4669 6c65   status.....File\n-0000c550: 3a20 6c69 6266 6b6f 2e69 6e66 6f2c 2020  : libfko.info,  \n-0000c560: 4e6f 6465 3a20 4572 726f 7220 4861 6e64  Node: Error Hand\n-0000c570: 6c69 6e67 2c20 2050 7265 763a 2055 7469  ling,  Prev: Uti\n-0000c580: 6c69 7479 2046 756e 6374 696f 6e73 2c20  lity Functions, \n-0000c590: 2055 703a 2055 7369 6e67 206c 6962 666b   Up: Using libfk\n-0000c5a0: 6f0a 0a33 2e37 2045 7272 6f72 2048 616e  o..3.7 Error Han\n-0000c5b0: 646c 696e 670a 3d3d 3d3d 3d3d 3d3d 3d3d  dling.==========\n-0000c5c0: 3d3d 3d3d 3d3d 3d3d 0a0a 4d6f 7374 2066  ========..Most f\n-0000c5d0: 6b6f 2066 756e 6374 696f 6e73 2072 6574  ko functions ret\n-0000c5e0: 7572 6e20 616e 2069 6e74 6567 6572 2076  urn an integer v\n-0000c5f0: 616c 7565 2074 6861 7420 636f 7272 6573  alue that corres\n-0000c600: 706f 6e64 7320 746f 2065 6974 6865 720a  ponds to either.\n-0000c610: 7375 6363 6573 7320 2830 292c 206f 7220  success (0), or \n-0000c620: 6f6e 6520 6f66 2074 6865 206e 6f6e 2d7a  one of the non-z\n-0000c630: 6572 6f20 7661 6c75 6573 2074 6861 7220  ero values thar \n-0000c640: 636f 7272 6573 706f 6e64 7320 746f 2061  corresponds to a\n-0000c650: 206e 756d 6265 720a 6f66 2070 6f73 7369   number.of possi\n-0000c660: 626c 6520 6572 726f 7273 2e20 206c 6962  ble errors.  lib\n-0000c670: 666b 6f20 7072 6f76 6964 6573 2061 2066  fko provides a f\n-0000c680: 756e 6374 696f 6e20 746f 2067 6574 2061  unction to get a\n-0000c690: 2064 6573 6372 6970 7469 7665 0a73 7472   descriptive.str\n-0000c6a0: 696e 6720 666f 7220 7468 6520 6769 7665  ing for the give\n-0000c6b0: 6e20 6572 726f 7220 636f 6465 2e0a 0a20  n error code... \n-0000c6c0: 2d2d 2046 756e 6374 696f 6e3a 2063 6f6e  -- Function: con\n-0000c6d0: 7374 2063 6861 7220 2a20 666b 6f5f 6572  st char * fko_er\n-0000c6e0: 7273 7472 2028 696e 7420 4552 525f 434f  rstr (int ERR_CO\n-0000c6f0: 4445 290a 2020 2020 2054 6865 2066 756e  DE).     The fun\n-0000c700: 6374 696f 6e20 2766 6b6f 5f65 7272 7374  ction 'fko_errst\n-0000c710: 7227 2072 6574 7572 6e73 2061 2070 6f69  r' returns a poi\n-0000c720: 6e74 6572 2074 6f20 6120 7374 6174 6963  nter to a static\n-0000c730: 616c 6c79 0a20 2020 2020 616c 6c6f 6361  ally.     alloca\n-0000c740: 7465 6420 7374 7269 6e67 2063 6f6e 7461  ted string conta\n-0000c750: 696e 696e 6720 7468 6520 6465 7363 7269  ining the descri\n-0000c760: 7074 696f 6e20 6f66 2074 6865 2065 7272  ption of the err\n-0000c770: 6f72 2e0a 0a54 6865 206c 6973 7420 6f66  or...The list of\n-0000c780: 2074 6865 2070 6f73 7369 626c 6520 6572   the possible er\n-0000c790: 726f 7220 636f 6465 7320 616e 6420 7468  ror codes and th\n-0000c7a0: 6569 7220 636f 7272 6573 706f 6e64 696e  eir correspondin\n-0000c7b0: 670a 6465 7363 7269 7074 696f 6e73 2061  g.descriptions a\n-0000c7c0: 7320 7265 7475 726e 6564 2062 7920 2766  s returned by 'f\n-0000c7d0: 6b6f 5f65 7272 7374 7227 2066 6f6c 6c6f  ko_errstr' follo\n-0000c7e0: 7773 3a0a 0a20 2d2d 2056 6172 6961 626c  ws:.. -- Variabl\n-0000c7f0: 653a 2069 6e74 2065 7272 6f72 5f63 6f64  e: int error_cod\n-0000c800: 650a 2020 2020 2027 464b 4f5f 5355 4343  e.     'FKO_SUCC\n-0000c810: 4553 5327 0a20 2020 2020 2020 2020 2053  ESS'.          S\n-0000c820: 7563 6365 7373 0a20 2020 2020 2746 4b4f  uccess.     'FKO\n-0000c830: 5f45 5252 4f52 5f43 5458 5f4e 4f54 5f49  _ERROR_CTX_NOT_I\n-0000c840: 4e49 5449 414c 495a 4544 270a 2020 2020  NITIALIZED'.    \n-0000c850: 2020 2020 2020 464b 4f20 436f 6e74 6578        FKO Contex\n-0000c860: 7420 6973 206e 6f74 2069 6e69 7469 616c  t is not initial\n-0000c870: 697a 6564 0a20 2020 2020 2746 4b4f 5f45  ized.     'FKO_E\n-0000c880: 5252 4f52 5f4d 454d 4f52 595f 414c 4c4f  RROR_MEMORY_ALLO\n-0000c890: 4341 5449 4f4e 270a 2020 2020 2020 2020  CATION'.        \n-0000c8a0: 2020 556e 6162 6c65 2074 6f20 616c 6c6f    Unable to allo\n-0000c8b0: 6361 7465 206d 656d 6f72 790a 2020 2020  cate memory.    \n-0000c8c0: 2027 464b 4f5f 4552 524f 525f 4649 4c45   'FKO_ERROR_FILE\n-0000c8d0: 5359 5354 454d 5f4f 5045 5241 5449 4f4e  SYSTEM_OPERATION\n-0000c8e0: 270a 2020 2020 2020 2020 2020 5265 6164  '.          Read\n-0000c8f0: 2f77 7269 7465 2062 7974 6573 206d 6973  /write bytes mis\n-0000c900: 6d61 7463 680a 2020 2020 2027 464b 4f5f  match.     'FKO_\n-0000c910: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n-0000c920: 5441 270a 2020 2020 2020 2020 2020 4172  TA'.          Ar\n-0000c930: 6773 2063 6f6e 7461 696e 2069 6e76 616c  gs contain inval\n-0000c940: 6964 2064 6174 610a 2020 2020 2027 464b  id data.     'FK\n-0000c950: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n-0000c960: 4441 5441 5f43 4c49 454e 545f 5449 4d45  DATA_CLIENT_TIME\n-0000c970: 4f55 545f 4e45 4741 5449 5645 270a 2020  OUT_NEGATIVE'.  \n-0000c980: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n-0000c990: 6461 7461 3a20 6e65 6761 7469 7665 2074  data: negative t\n-0000c9a0: 696d 656f 7574 2076 616c 7565 0a20 2020  imeout value.   \n-0000c9b0: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n-0000c9c0: 414c 4944 5f44 4154 415f 4445 434f 4445  ALID_DATA_DECODE\n-0000c9d0: 5f4d 5347 4c45 4e5f 5641 4c49 4446 4149  _MSGLEN_VALIDFAI\n-0000c9e0: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv\n-0000c9f0: 616c 6964 2064 6174 613a 2069 6e76 616c  alid data: inval\n-0000ca00: 6964 206d 6573 7361 6765 206c 656e 6774  id message lengt\n-0000ca10: 680a 2020 2020 2027 464b 4f5f 4552 524f  h.     'FKO_ERRO\n-0000ca20: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D\n-0000ca30: 4543 4f44 455f 4e4f 4e5f 4153 4349 4927  ECODE_NON_ASCII'\n-0000ca40: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n-0000ca50: 6964 2064 6174 613a 2063 6f6e 7461 696e  id data: contain\n-0000ca60: 7320 6e6f 6e2d 6173 6369 6920 6368 6172  s non-ascii char\n-0000ca70: 6163 7465 7273 0a20 2020 2020 2746 4b4f  acters.     'FKO\n-0000ca80: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n-0000ca90: 4154 415f 4445 434f 4445 5f4c 545f 4d49  ATA_DECODE_LT_MI\n-0000caa0: 4e5f 4649 454c 4453 270a 2020 2020 2020  N_FIELDS'.      \n-0000cab0: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n-0000cac0: 3a20 696e 7375 6666 6963 6965 6e74 206e  : insufficient n\n-0000cad0: 756d 6265 7220 6f66 2064 6174 6120 6669  umber of data fi\n-0000cae0: 656c 6473 0a20 2020 2020 2746 4b4f 5f45  elds.     'FKO_E\n-0000caf0: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n-0000cb00: 415f 4445 434f 4445 5f47 545f 4d41 585f  A_DECODE_GT_MAX_\n-0000cb10: 4649 454c 4453 270a 2020 2020 2020 2020  FIELDS'.        \n-0000cb20: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n-0000cb30: 746f 6f20 6d61 6e79 2064 6174 6120 6669  too many data fi\n-0000cb40: 656c 6473 0a20 2020 2020 2746 4b4f 5f45  elds.     'FKO_E\n-0000cb50: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n-0000cb60: 415f 4445 434f 4445 5f57 524f 4e47 5f4e  A_DECODE_WRONG_N\n-0000cb70: 554d 5f46 4945 4c44 5327 0a20 2020 2020  UM_FIELDS'.     \n-0000cb80: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat\n-0000cb90: 613a 2069 6e76 616c 6964 206e 756d 6265  a: invalid numbe\n-0000cba0: 7220 6f66 2066 6965 6c64 730a 2020 2020  r of fields.    \n-0000cbb0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n-0000cbc0: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_\n-0000cbd0: 454e 435f 4d53 475f 4c45 4e5f 4d54 5f54  ENC_MSG_LEN_MT_T\n-0000cbe0: 5f53 495a 4527 0a20 2020 2020 2020 2020  _SIZE'.         \n-0000cbf0: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d\n-0000cc00: 6563 6f64 653a 2065 6e63 6f64 6564 206d  ecode: encoded m\n-0000cc10: 6573 7361 6765 202d 2064 6967 6573 7420  essage - digest \n-0000cc20: 7369 7a65 2069 7320 6e6f 740a 2020 2020  size is not.    \n-0000cc30: 2020 2020 2020 7661 6c69 640a 2020 2020        valid.    \n-0000cc40: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n-0000cc50: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_\n-0000cc60: 5241 4e44 5f4d 4953 5349 4e47 270a 2020  RAND_MISSING'.  \n-0000cc70: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n-0000cc80: 6461 7461 3a20 6465 636f 6465 3a20 6d69  data: decode: mi\n-0000cc90: 7373 696e 6720 7261 6e64 6f6d 2064 6174  ssing random dat\n-0000cca0: 610a 2020 2020 2027 464b 4f5f 4552 524f  a.     'FKO_ERRO\n-0000ccb0: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D\n-0000ccc0: 4543 4f44 455f 5553 4552 4e41 4d45 5f4d  ECODE_USERNAME_M\n-0000ccd0: 4953 5349 4e47 270a 2020 2020 2020 2020  ISSING'.        \n-0000cce0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n-0000ccf0: 6465 636f 6465 3a20 6d69 7373 696e 6720  decode: missing \n-0000cd00: 7573 6572 6e61 6d65 0a20 2020 2020 2746  username.     'F\n-0000cd10: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n-0000cd20: 5f44 4154 415f 4445 434f 4445 5f55 5345  _DATA_DECODE_USE\n-0000cd30: 524e 414d 455f 544f 4f42 4947 270a 2020  RNAME_TOOBIG'.  \n-0000cd40: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n-0000cd50: 6461 7461 3a20 6465 636f 6465 3a20 7573  data: decode: us\n-0000cd60: 6572 6e61 6d65 2074 6f20 6c61 7267 650a  ername to large.\n-0000cd70: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000cd80: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC\n-0000cd90: 4f44 455f 5553 4552 4e41 4d45 5f44 4543  ODE_USERNAME_DEC\n-0000cda0: 4f44 4546 4149 4c27 0a20 2020 2020 2020  ODEFAIL'.       \n-0000cdb0: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:\n-0000cdc0: 2064 6563 6f64 653a 2066 6169 6c65 6420   decode: failed \n-0000cdd0: 746f 2064 6563 6f64 6520 7573 6572 6e61  to decode userna\n-0000cde0: 6d65 0a20 2020 2020 2746 4b4f 5f45 5252  me.     'FKO_ERR\n-0000cdf0: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_\n-0000ce00: 4445 434f 4445 5f55 5345 524e 414d 455f  DECODE_USERNAME_\n-0000ce10: 5641 4c49 4446 4149 4c27 0a20 2020 2020  VALIDFAIL'.     \n-0000ce20: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat\n-0000ce30: 613a 2064 6563 6f64 653a 2069 6e76 616c  a: decode: inval\n-0000ce40: 6964 2075 7365 726e 616d 650a 2020 2020  id username.    \n-0000ce50: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n-0000ce60: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_\n-0000ce70: 5449 4d45 5354 414d 505f 4d49 5353 494e  TIMESTAMP_MISSIN\n-0000ce80: 4727 0a20 2020 2020 2020 2020 2049 6e76  G'.          Inv\n-0000ce90: 616c 6964 2064 6174 613a 2064 6563 6f64  alid data: decod\n-0000cea0: 653a 206d 6973 7369 6e67 2074 696d 6573  e: missing times\n-0000ceb0: 7461 6d70 0a20 2020 2020 2746 4b4f 5f45  tamp.     'FKO_E\n-0000cec0: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n-0000ced0: 415f 4445 434f 4445 5f54 494d 4553 5441  A_DECODE_TIMESTA\n-0000cee0: 4d50 5f54 4f4f 4249 4727 0a20 2020 2020  MP_TOOBIG'.     \n-0000cef0: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat\n-0000cf00: 613a 2064 6563 6f64 653a 2074 696d 6573  a: decode: times\n-0000cf10: 7461 6d70 2074 6f6f 206c 6172 6765 0a20  tamp too large. \n-0000cf20: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n-0000cf30: 4e56 414c 4944 5f44 4154 415f 4445 434f  NVALID_DATA_DECO\n-0000cf40: 4445 5f54 494d 4553 5441 4d50 5f44 4543  DE_TIMESTAMP_DEC\n-0000cf50: 4f44 4546 4149 4c27 0a20 2020 2020 2020  ODEFAIL'.       \n-0000cf60: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:\n-0000cf70: 2064 6563 6f64 653a 2066 6169 6c65 6420   decode: failed \n-0000cf80: 746f 2064 6563 6f64 6520 7469 6d65 7374  to decode timest\n-0000cf90: 616d 700a 2020 2020 2027 464b 4f5f 4552  amp.     'FKO_ER\n-0000cfa0: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n-0000cfb0: 5f44 4543 4f44 455f 5645 5253 494f 4e5f  _DECODE_VERSION_\n-0000cfc0: 4d49 5353 494e 4727 0a20 2020 2020 2020  MISSING'.       \n-0000cfd0: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:\n-0000cfe0: 2064 6563 6f64 653a 206d 6973 7369 6e67   decode: missing\n-0000cff0: 2076 6572 7369 6f6e 2064 6174 610a 2020   version data.  \n-0000d000: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n-0000d010: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD\n-0000d020: 455f 5645 5253 494f 4e5f 544f 4f42 4947  E_VERSION_TOOBIG\n-0000d030: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva\n-0000d040: 6c69 6420 6461 7461 3a20 6465 636f 6465  lid data: decode\n-0000d050: 3a20 7665 7273 696f 6e20 6461 7461 2069  : version data i\n-0000d060: 7320 746f 6f20 6c61 7267 650a 2020 2020  s too large.    \n-0000d070: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n-0000d080: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_\n-0000d090: 4d53 4754 5950 455f 4d49 5353 494e 4727  MSGTYPE_MISSING'\n-0000d0a0: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n-0000d0b0: 6964 2064 6174 613a 2064 6563 6f64 653a  id data: decode:\n-0000d0c0: 206d 6973 7369 6e67 206d 6573 7361 6765   missing message\n-0000d0d0: 2074 7970 650a 2020 2020 2027 464b 4f5f   type.     'FKO_\n-0000d0e0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n-0000d0f0: 5441 5f44 4543 4f44 455f 4d53 4754 5950  TA_DECODE_MSGTYP\n-0000d100: 455f 544f 4f42 4947 270a 2020 2020 2020  E_TOOBIG'.      \n-0000d110: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n-0000d120: 3a20 6465 636f 6465 3a20 6d65 7373 6167  : decode: messag\n-0000d130: 6520 7479 7065 2069 7320 746f 6f20 6c61  e type is too la\n-0000d140: 7267 650a 2020 2020 2027 464b 4f5f 4552  rge.     'FKO_ER\n-0000d150: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n-0000d160: 5f44 4543 4f44 455f 4d53 4754 5950 455f  _DECODE_MSGTYPE_\n-0000d170: 4445 434f 4445 4641 494c 270a 2020 2020  DECODEFAIL'.    \n-0000d180: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n-0000d190: 7461 3a20 6465 636f 6465 3a20 6661 696c  ta: decode: fail\n-0000d1a0: 6564 2074 6f20 6465 636f 6465 206d 6573  ed to decode mes\n-0000d1b0: 7361 6765 2074 7970 650a 2020 2020 2027  sage type.     '\n-0000d1c0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n-0000d1d0: 445f 4441 5441 5f44 4543 4f44 455f 4d45  D_DATA_DECODE_ME\n-0000d1e0: 5353 4147 455f 4d49 5353 494e 4727 0a20  SSAGE_MISSING'. \n-0000d1f0: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n-0000d200: 2064 6174 613a 2064 6563 6f64 653a 206d   data: decode: m\n-0000d210: 6973 7369 6e67 206d 6573 7361 6765 2064  issing message d\n-0000d220: 6174 610a 2020 2020 2027 464b 4f5f 4552  ata.     'FKO_ER\n-0000d230: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n-0000d240: 5f44 4543 4f44 455f 4d45 5353 4147 455f  _DECODE_MESSAGE_\n-0000d250: 544f 4f42 4947 270a 2020 2020 2020 2020  TOOBIG'.        \n-0000d260: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n-0000d270: 6465 636f 6465 3a20 6d65 7373 6167 6520  decode: message \n-0000d280: 6461 7461 2069 7320 746f 6f20 6c61 7267  data is too larg\n-0000d290: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO\n-0000d2a0: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D\n-0000d2b0: 4543 4f44 455f 4d45 5353 4147 455f 4445  ECODE_MESSAGE_DE\n-0000d2c0: 434f 4445 4641 494c 270a 2020 2020 2020  CODEFAIL'.      \n-0000d2d0: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n-0000d2e0: 3a20 6465 636f 6465 3a20 6661 696c 6564  : decode: failed\n-0000d2f0: 2074 6f20 6465 636f 6465 206d 6573 7361   to decode messa\n-0000d300: 6765 2064 6174 610a 2020 2020 2027 464b  ge data.     'FK\n-0000d310: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n-0000d320: 4441 5441 5f44 4543 4f44 455f 4d45 5353  DATA_DECODE_MESS\n-0000d330: 4147 455f 5641 4c49 4446 4149 4c27 0a20  AGE_VALIDFAIL'. \n-0000d340: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n-0000d350: 2064 6174 613a 2064 6563 6f64 653a 2069   data: decode: i\n-0000d360: 6e76 616c 6964 206d 6573 7361 6765 2064  nvalid message d\n-0000d370: 6174 610a 2020 2020 2027 464b 4f5f 4552  ata.     'FKO_ER\n-0000d380: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n-0000d390: 5f44 4543 4f44 455f 4143 4345 5353 5f56  _DECODE_ACCESS_V\n-0000d3a0: 414c 4944 4641 494c 270a 2020 2020 2020  ALIDFAIL'.      \n-0000d3b0: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n-0000d3c0: 3a20 6465 636f 6465 3a20 696e 766c 6961  : decode: invlia\n-0000d3d0: 6420 6163 6365 7373 2064 6174 610a 2020  d access data.  \n-0000d3e0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n-0000d3f0: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD\n-0000d400: 455f 4e41 5441 4343 4553 535f 4d49 5353  E_NATACCESS_MISS\n-0000d410: 494e 4727 0a20 2020 2020 2020 2020 2049  ING'.          I\n-0000d420: 6e76 616c 6964 2064 6174 613a 2064 6563  nvalid data: dec\n-0000d430: 6f64 653a 206d 6973 7369 6e67 204e 4154  ode: missing NAT\n-0000d440: 2061 6363 6573 7320 6461 7461 0a20 2020   access data.   \n-0000d450: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n-0000d460: 414c 4944 5f44 4154 415f 4445 434f 4445  ALID_DATA_DECODE\n-0000d470: 5f4e 4154 4143 4345 5353 5f54 4f4f 4249  _NATACCESS_TOOBI\n-0000d480: 4727 0a20 2020 2020 2020 2020 2049 6e76  G'.          Inv\n-0000d490: 616c 6964 2064 6174 613a 2064 6563 6f64  alid data: decod\n-0000d4a0: 653a 204e 4154 2061 6363 6573 7320 6461  e: NAT access da\n-0000d4b0: 7461 2069 7320 746f 6f20 6c61 7267 650a  ta is too large.\n-0000d4c0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000d4d0: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC\n-0000d4e0: 4f44 455f 4e41 5441 4343 4553 535f 4445  ODE_NATACCESS_DE\n-0000d4f0: 434f 4445 4641 494c 270a 2020 2020 2020  CODEFAIL'.      \n-0000d500: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n-0000d510: 3a20 6465 636f 6465 3a20 6661 696c 6564  : decode: failed\n-0000d520: 2074 6f20 6465 636f 6465 204e 4154 2061   to decode NAT a\n-0000d530: 6363 6573 7320 6461 7461 0a20 2020 2020  ccess data.     \n-0000d540: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n-0000d550: 4944 5f44 4154 415f 4445 434f 4445 5f4e  ID_DATA_DECODE_N\n-0000d560: 4154 4143 4345 5353 5f56 414c 4944 4641  ATACCESS_VALIDFA\n-0000d570: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In\n-0000d580: 7661 6c69 6420 6461 7461 3a20 6465 636f  valid data: deco\n-0000d590: 6465 3a20 696e 7661 6c69 6420 4e41 5420  de: invalid NAT \n-0000d5a0: 6163 6365 7373 0a20 2020 2020 2746 4b4f  access.     'FKO\n-0000d5b0: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n-0000d5c0: 4154 415f 4445 434f 4445 5f53 5256 4155  ATA_DECODE_SRVAU\n-0000d5d0: 5448 5f4d 4953 5349 4e47 270a 2020 2020  TH_MISSING'.    \n-0000d5e0: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n-0000d5f0: 7461 3a20 6465 636f 6465 3a20 6d69 7373  ta: decode: miss\n-0000d600: 696e 6720 7365 7276 6572 2061 7574 680a  ing server auth.\n-0000d610: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000d620: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC\n-0000d630: 4f44 455f 5352 5641 5554 485f 4445 434f  ODE_SRVAUTH_DECO\n-0000d640: 4445 4641 494c 270a 2020 2020 2020 2020  DEFAIL'.        \n-0000d650: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n-0000d660: 6465 636f 6465 3a20 7365 7276 6572 2061  decode: server a\n-0000d670: 7574 6820 6465 636f 6465 2066 6169 6c0a  uth decode fail.\n-0000d680: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000d690: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC\n-0000d6a0: 4f44 455f 5350 415f 4558 5452 415f 544f  ODE_SPA_EXTRA_TO\n-0000d6b0: 4f42 4947 270a 2020 2020 2020 2020 2020  OBIG'.          \n-0000d6c0: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de\n-0000d6d0: 636f 6465 3a20 5350 4120 6578 7472 6120  code: SPA extra \n-0000d6e0: 746f 6f20 6c61 7267 650a 2020 2020 2027  too large.     '\n-0000d6f0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n-0000d700: 445f 4441 5441 5f44 4543 4f44 455f 4558  D_DATA_DECODE_EX\n-0000d710: 5452 415f 544f 4f42 4947 270a 2020 2020  TRA_TOOBIG'.    \n-0000d720: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n-0000d730: 7461 3a20 6465 636f 6465 3a20 6578 7472  ta: decode: extr\n-0000d740: 6120 746f 6f20 6c61 7267 650a 2020 2020  a too large.    \n-0000d750: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n-0000d760: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_\n-0000d770: 4558 5452 415f 4445 434f 4445 4641 494c  EXTRA_DECODEFAIL\n-0000d780: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva\n-0000d790: 6c69 6420 6461 7461 3a20 6465 636f 6465  lid data: decode\n-0000d7a0: 3a20 6578 7472 6120 6465 636f 6465 2066  : extra decode f\n-0000d7b0: 6169 6c65 640a 2020 2020 2027 464b 4f5f  ailed.     'FKO_\n-0000d7c0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n-0000d7d0: 5441 5f44 4543 4f44 455f 5449 4d45 4f55  TA_DECODE_TIMEOU\n-0000d7e0: 545f 4d49 5353 494e 4727 0a20 2020 2020  T_MISSING'.     \n-0000d7f0: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat\n-0000d800: 613a 2064 6563 6f64 653a 206d 6973 7369  a: decode: missi\n-0000d810: 6e67 2074 696d 656f 7574 0a20 2020 2020  ng timeout.     \n-0000d820: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n-0000d830: 4944 5f44 4154 415f 4445 434f 4445 5f54  ID_DATA_DECODE_T\n-0000d840: 494d 454f 5554 5f54 4f4f 4249 4727 0a20  IMEOUT_TOOBIG'. \n-0000d850: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n-0000d860: 2064 6174 613a 2064 6563 6f64 6520 7469   data: decode ti\n-0000d870: 6d65 6f75 7420 7661 6c75 6520 6973 2074  meout value is t\n-0000d880: 6f6f 206c 6172 6765 0a20 2020 2020 2746  oo large.     'F\n-0000d890: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n-0000d8a0: 5f44 4154 415f 4445 434f 4445 5f54 494d  _DATA_DECODE_TIM\n-0000d8b0: 454f 5554 5f56 414c 4944 4641 494c 270a  EOUT_VALIDFAIL'.\n-0000d8c0: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n-0000d8d0: 6420 6461 7461 3a20 6465 636f 6465 2069  d data: decode i\n-0000d8e0: 6e76 616c 6964 2074 696d 656f 7574 0a20  nvalid timeout. \n-0000d8f0: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n-0000d900: 4e56 414c 4944 5f44 4154 415f 4445 434f  NVALID_DATA_DECO\n-0000d910: 4445 5f54 494d 454f 5554 5f44 4543 4f44  DE_TIMEOUT_DECOD\n-0000d920: 4546 4149 4c27 0a20 2020 2020 2020 2020  EFAIL'.         \n-0000d930: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d\n-0000d940: 6563 6f64 653a 2074 696d 656f 7574 2064  ecode: timeout d\n-0000d950: 6563 6f64 6520 6661 696c 6564 0a20 2020  ecode failed.   \n-0000d960: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n-0000d970: 414c 4944 5f44 4154 415f 454e 434f 4445  ALID_DATA_ENCODE\n-0000d980: 5f4d 4553 5341 4745 5f54 4f4f 4249 4727  _MESSAGE_TOOBIG'\n-0000d990: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n-0000d9a0: 6964 2064 6174 613a 2065 6e63 6f64 653a  id data: encode:\n-0000d9b0: 206d 6573 7361 6765 2069 7320 746f 6f20   message is too \n-0000d9c0: 6c61 7267 650a 2020 2020 2027 464b 4f5f  large.     'FKO_\n-0000d9d0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n-0000d9e0: 5441 5f45 4e43 4f44 455f 4d53 474c 454e  TA_ENCODE_MSGLEN\n-0000d9f0: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    \n-0000da00: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n-0000da10: 7461 3a20 656e 636f 6465 3a20 696e 7661  ta: encode: inva\n-0000da20: 6c69 6420 6d65 7373 6167 6520 6c65 6e67  lid message leng\n-0000da30: 7468 0a20 2020 2020 2746 4b4f 5f45 5252  th.     'FKO_ERR\n-0000da40: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_\n-0000da50: 454e 434f 4445 5f44 4947 4553 545f 5641  ENCODE_DIGEST_VA\n-0000da60: 4c49 4446 4149 4c27 0a20 2020 2020 2020  LIDFAIL'.       \n-0000da70: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:\n-0000da80: 2065 6e63 6f64 653a 2069 6e76 616c 6964   encode: invalid\n-0000da90: 2064 6967 6573 740a 2020 2020 2027 464b   digest.     'FK\n-0000daa0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n-0000dab0: 4441 5441 5f45 4e43 4f44 455f 4449 4745  DATA_ENCODE_DIGE\n-0000dac0: 5354 5f54 4f4f 4249 4727 0a20 2020 2020  ST_TOOBIG'.     \n-0000dad0: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat\n-0000dae0: 613a 2065 6e63 6f64 653a 2064 6967 6573  a: encode: diges\n-0000daf0: 7420 6973 2074 6f6f 206c 6172 6765 0a20  t is too large. \n-0000db00: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n-0000db10: 4e56 414c 4944 5f44 4154 415f 454e 434f  NVALID_DATA_ENCO\n-0000db20: 4445 5f4e 4f54 4241 5345 3634 270a 2020  DE_NOTBASE64'.  \n-0000db30: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n-0000db40: 6461 7461 3a20 656e 636f 6465 6420 6461  data: encoded da\n-0000db50: 7461 2069 7320 6e6f 7420 4261 7365 3634  ta is not Base64\n-0000db60: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-0000db70: 5f49 4e56 414c 4944 5f44 4154 415f 454e  _INVALID_DATA_EN\n-0000db80: 4352 5950 545f 4d53 474c 454e 5f56 414c  CRYPT_MSGLEN_VAL\n-0000db90: 4944 4641 494c 270a 2020 2020 2020 2020  IDFAIL'.        \n-0000dba0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n-0000dbb0: 656e 6372 7970 743a 2069 6e76 616c 6964  encrypt: invalid\n-0000dbc0: 206d 6573 7361 6765 206c 656e 6774 680a   message length.\n-0000dbd0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000dbe0: 494e 5641 4c49 445f 4441 5441 5f45 4e43  INVALID_DATA_ENC\n-0000dbf0: 5259 5054 5f44 4947 4553 544c 454e 5f56  RYPT_DIGESTLEN_V\n-0000dc00: 414c 4944 4641 494c 270a 2020 2020 2020  ALIDFAIL'.      \n-0000dc10: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n-0000dc20: 3a20 656e 6372 7970 743a 2069 6e76 616c  : encrypt: inval\n-0000dc30: 6964 2064 6967 6573 7420 6c65 6e67 7468  id digest length\n-0000dc40: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-0000dc50: 5f49 4e56 414c 4944 5f44 4154 415f 454e  _INVALID_DATA_EN\n-0000dc60: 4352 5950 545f 5054 4c45 4e5f 5641 4c49  CRYPT_PTLEN_VALI\n-0000dc70: 4446 4149 4c27 0a20 2020 2020 2020 2020  DFAIL'.         \n-0000dc80: 2049 6e76 616c 6964 2064 6174 613a 2065   Invalid data: e\n-0000dc90: 6e63 7279 7074 3a20 696e 7661 6c69 6420  ncrypt: invalid \n-0000dca0: 706c 6169 6e74 6578 7420 6c65 6e67 7468  plaintext length\n-0000dcb0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-0000dcc0: 5f49 4e56 414c 4944 5f44 4154 415f 454e  _INVALID_DATA_EN\n-0000dcd0: 4352 5950 545f 5245 5355 4c54 5f4d 5347  CRYPT_RESULT_MSG\n-0000dce0: 4c45 4e5f 5641 4c49 4446 4149 4c27 0a20  LEN_VALIDFAIL'. \n-0000dcf0: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n-0000dd00: 2064 6174 613a 2065 6e63 7279 7074 3a20   data: encrypt: \n-0000dd10: 696e 7661 6c69 6420 656e 6372 7970 7420  invalid encrypt \n-0000dd20: 7265 7375 6c74 206d 6573 7361 6765 206c  result message l\n-0000dd30: 656e 6774 680a 2020 2020 2027 464b 4f5f  ength.     'FKO_\n-0000dd40: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n-0000dd50: 5441 5f45 4e43 5259 5054 5f43 4950 4845  TA_ENCRYPT_CIPHE\n-0000dd60: 524c 454e 5f44 4543 4f44 4546 4149 4c27  RLEN_DECODEFAIL'\n-0000dd70: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n-0000dd80: 6964 2064 6174 613a 2065 6e63 7279 7074  id data: encrypt\n-0000dd90: 3a20 6465 636f 6465 2063 6970 6865 7220  : decode cipher \n-0000dda0: 6c65 6e67 7468 2066 6169 6c65 640a 2020  length failed.  \n-0000ddb0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n-0000ddc0: 5641 4c49 445f 4441 5441 5f45 4e43 5259  VALID_DATA_ENCRY\n-0000ddd0: 5054 5f43 4950 4845 524c 454e 5f56 414c  PT_CIPHERLEN_VAL\n-0000dde0: 4944 4641 494c 270a 2020 2020 2020 2020  IDFAIL'.        \n-0000ddf0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n-0000de00: 656e 6372 7970 743a 2069 6e76 616c 6964  encrypt: invalid\n-0000de10: 2063 6970 6865 7220 6c65 6e67 7468 0a20   cipher length. \n-0000de20: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n-0000de30: 4e56 414c 4944 5f44 4154 415f 454e 4352  NVALID_DATA_ENCR\n-0000de40: 5950 545f 4445 4352 5950 5445 445f 4d45  YPT_DECRYPTED_ME\n-0000de50: 5353 4147 455f 4d49 5353 494e 4727 0a20  SSAGE_MISSING'. \n-0000de60: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid\n-0000de70: 2064 6174 613a 2065 6e63 7279 7074 3a20   data: encrypt: \n-0000de80: 6d69 7373 696e 6720 6465 6372 7970 7465  missing decrypte\n-0000de90: 6420 6d65 7373 6167 650a 2020 2020 2027  d message.     '\n-0000dea0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n-0000deb0: 445f 4441 5441 5f45 4e43 5259 5054 5f44  D_DATA_ENCRYPT_D\n-0000dec0: 4543 5259 5054 4544 5f4d 5347 4c45 4e5f  ECRYPTED_MSGLEN_\n-0000ded0: 5641 4c49 4446 4149 4c27 0a20 2020 2020  VALIDFAIL'.     \n-0000dee0: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat\n-0000def0: 613a 2065 6e63 7279 7074 3a20 696e 7661  a: encrypt: inva\n-0000df00: 6c69 6420 6465 6372 7970 7465 6420 6d65  lid decrypted me\n-0000df10: 7373 6167 6520 6c65 6e67 7468 0a20 2020  ssage length.   \n-0000df20: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n-0000df30: 414c 4944 5f44 4154 415f 454e 4352 5950  ALID_DATA_ENCRYP\n-0000df40: 545f 5459 5045 5f56 414c 4944 4641 494c  T_TYPE_VALIDFAIL\n-0000df50: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva\n-0000df60: 6c69 6420 6461 7461 3a20 656e 6372 7970  lid data: encryp\n-0000df70: 743a 2069 6e76 616c 6964 2065 6e63 7279  t: invalid encry\n-0000df80: 7074 696f 6e20 7479 7065 0a20 2020 2020  ption type.     \n-0000df90: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n-0000dfa0: 4944 5f44 4154 415f 454e 4352 5950 545f  ID_DATA_ENCRYPT_\n-0000dfb0: 4d4f 4445 5f56 414c 4944 4641 494c 270a  MODE_VALIDFAIL'.\n-0000dfc0: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n-0000dfd0: 6420 6461 7461 3a20 656e 6372 7970 743a  d data: encrypt:\n-0000dfe0: 2069 6e76 616c 6964 2065 6e63 7279 7074   invalid encrypt\n-0000dff0: 696f 6e20 6d6f 6465 0a20 2020 2020 2746  ion mode.     'F\n-0000e000: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n-0000e010: 5f44 4154 415f 454e 4352 5950 545f 5459  _DATA_ENCRYPT_TY\n-0000e020: 5045 5f55 4e4b 4e4f 574e 270a 2020 2020  PE_UNKNOWN'.    \n-0000e030: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n-0000e040: 7461 3a20 656e 6372 7970 743a 2075 6e6b  ta: encrypt: unk\n-0000e050: 6e6f 776e 2065 6e63 7279 7074 696f 6e20  nown encryption \n-0000e060: 7479 7065 0a20 2020 2020 2746 4b4f 5f45  type.     'FKO_E\n-0000e070: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT\n-0000e080: 415f 4655 4e43 535f 4e45 575f 454e 434d  A_FUNCS_NEW_ENCM\n-0000e090: 5347 5f4d 4953 5349 4e47 270a 2020 2020  SG_MISSING'.    \n-0000e0a0: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n-0000e0b0: 7461 3a20 6d69 7373 696e 6720 656e 636f  ta: missing enco\n-0000e0c0: 6465 6420 6d65 7373 6167 650a 2020 2020  ded message.    \n-0000e0d0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n-0000e0e0: 4c49 445f 4441 5441 5f46 554e 4353 5f4e  LID_DATA_FUNCS_N\n-0000e0f0: 4557 5f4d 5347 4c45 4e5f 5641 4c49 4446  EW_MSGLEN_VALIDF\n-0000e100: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I\n-0000e110: 6e76 616c 6964 2064 6174 613a 2069 6e76  nvalid data: inv\n-0000e120: 616c 6964 206d 6573 7361 6765 206c 656e  alid message len\n-0000e130: 6774 6820 6672 6f6d 206e 6577 0a20 2020  gth from new.   \n-0000e140: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n-0000e150: 414c 4944 5f44 4154 415f 4655 4e43 535f  ALID_DATA_FUNCS_\n-0000e160: 4745 4e5f 4b45 594c 454e 5f56 414c 4944  GEN_KEYLEN_VALID\n-0000e170: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          \n-0000e180: 496e 7661 6c69 6420 6461 7461 3a20 696e  Invalid data: in\n-0000e190: 7661 6c69 6420 6b65 7920 6c65 6e67 7468  valid key length\n-0000e1a0: 2066 726f 6d20 6765 6e5f 6b65 796c 656e   from gen_keylen\n-0000e1b0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-0000e1c0: 5f49 4e56 414c 4944 5f44 4154 415f 4655  _INVALID_DATA_FU\n-0000e1d0: 4e43 535f 4745 4e5f 484d 4143 4c45 4e5f  NCS_GEN_HMACLEN_\n-0000e1e0: 5641 4c49 4446 4149 4c27 0a20 2020 2020  VALIDFAIL'.     \n-0000e1f0: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat\n-0000e200: 613a 2067 656e 5f68 6d61 636c 656e 2066  a: gen_hmaclen f\n-0000e210: 6169 6c75 7265 0a20 2020 2020 2746 4b4f  ailure.     'FKO\n-0000e220: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n-0000e230: 4154 415f 4655 4e43 535f 4745 4e5f 4b45  ATA_FUNCS_GEN_KE\n-0000e240: 595f 454e 434f 4445 4641 494c 270a 2020  Y_ENCODEFAIL'.  \n-0000e250: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n-0000e260: 6461 7461 3a20 6765 6e5f 6b65 793a 2065  data: gen_key: e\n-0000e270: 6e63 6f64 6520 6661 696c 7572 650a 2020  ncode failure.  \n-0000e280: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n-0000e290: 5641 4c49 445f 4441 5441 5f46 554e 4353  VALID_DATA_FUNCS\n-0000e2a0: 5f47 454e 5f48 4d41 435f 454e 434f 4445  _GEN_HMAC_ENCODE\n-0000e2b0: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          \n-0000e2c0: 496e 7661 6c69 6420 6461 7461 3a20 6765  Invalid data: ge\n-0000e2d0: 6e5f 686d 6163 3a20 656e 636f 6465 2066  n_hmac: encode f\n-0000e2e0: 6169 6c75 7265 0a20 2020 2020 2746 4b4f  ailure.     'FKO\n-0000e2f0: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n-0000e300: 4154 415f 4655 4e43 535f 5345 545f 4d53  ATA_FUNCS_SET_MS\n-0000e310: 474c 454e 5f56 414c 4944 4641 494c 270a  GLEN_VALIDFAIL'.\n-0000e320: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n-0000e330: 6420 6461 7461 3a20 7365 745f 7370 615f  d data: set_spa_\n-0000e340: 6461 7461 3a20 696e 7661 6c69 6420 6d65  data: invalid me\n-0000e350: 7373 6167 6520 6c65 6e67 7468 0a20 2020  ssage length.   \n-0000e360: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n-0000e370: 414c 4944 5f44 4154 415f 484d 4143 5f4d  ALID_DATA_HMAC_M\n-0000e380: 5347 4c45 4e5f 5641 4c49 4446 4149 4c27  SGLEN_VALIDFAIL'\n-0000e390: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n-0000e3a0: 6964 2064 6174 613a 2069 6e76 616c 6964  id data: invalid\n-0000e3b0: 2048 4d41 4320 6d73 676c 656e 0a20 2020   HMAC msglen.   \n-0000e3c0: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n-0000e3d0: 414c 4944 5f44 4154 415f 484d 4143 5f45  ALID_DATA_HMAC_E\n-0000e3e0: 4e43 4d53 474c 454e 5f56 414c 4944 4641  NCMSGLEN_VALIDFA\n-0000e3f0: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In\n-0000e400: 7661 6c69 6420 6461 7461 3a20 696e 7661  valid data: inva\n-0000e410: 6c69 6420 6c65 6e67 7468 2066 6f72 2065  lid length for e\n-0000e420: 6e63 7279 7074 6564 206d 6573 7361 6765  ncrypted message\n-0000e430: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-0000e440: 5f49 4e56 414c 4944 5f44 4154 415f 484d  _INVALID_DATA_HM\n-0000e450: 4143 5f43 4f4d 5041 5245 4641 494c 270a  AC_COMPAREFAIL'.\n-0000e460: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n-0000e470: 6420 6461 7461 3a20 484d 4143 2063 6f6d  d data: HMAC com\n-0000e480: 7061 7269 736f 6e20 6661 696c 6564 0a20  parison failed. \n-0000e490: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n-0000e4a0: 4e56 414c 4944 5f44 4154 415f 484d 4143  NVALID_DATA_HMAC\n-0000e4b0: 5f54 5950 455f 5641 4c49 4446 4149 4c27  _TYPE_VALIDFAIL'\n-0000e4c0: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n-0000e4d0: 6964 2064 6174 613a 2069 6e76 616c 6964  id data: invalid\n-0000e4e0: 2048 4d41 4320 7479 7065 0a20 2020 2020   HMAC type.     \n-0000e4f0: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n-0000e500: 4944 5f44 4154 415f 484d 4143 5f4c 454e  ID_DATA_HMAC_LEN\n-0000e510: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    \n-0000e520: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da\n-0000e530: 7461 3a20 696e 7661 6c69 6420 484d 4143  ta: invalid HMAC\n-0000e540: 206c 656e 6774 680a 2020 2020 2027 464b   length.     'FK\n-0000e550: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n-0000e560: 4441 5441 5f4d 4553 5341 4745 5f50 4f52  DATA_MESSAGE_POR\n-0000e570: 545f 4d49 5353 494e 4727 0a20 2020 2020  T_MISSING'.     \n-0000e580: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat\n-0000e590: 613a 206d 6973 7369 6e67 2070 6f72 740a  a: missing port.\n-0000e5a0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000e5b0: 494e 5641 4c49 445f 4441 5441 5f4d 4553  INVALID_DATA_MES\n-0000e5c0: 5341 4745 5f54 5950 455f 5641 4c49 4446  SAGE_TYPE_VALIDF\n-0000e5d0: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I\n-0000e5e0: 6e76 616c 6964 2064 6174 613a 2069 6e76  nvalid data: inv\n-0000e5f0: 616c 6964 206d 6573 7361 6765 2074 7970  alid message typ\n-0000e600: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO\n-0000e610: 525f 494e 5641 4c49 445f 4441 5441 5f4d  R_INVALID_DATA_M\n-0000e620: 4553 5341 4745 5f45 4d50 5459 270a 2020  ESSAGE_EMPTY'.  \n-0000e630: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n-0000e640: 6461 7461 3a20 656d 7074 7920 6461 7461  data: empty data\n-0000e650: 206d 6573 7361 6765 0a20 2020 2020 2746   message.     'F\n-0000e660: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n-0000e670: 5f44 4154 415f 4d45 5353 4147 455f 434d  _DATA_MESSAGE_CM\n-0000e680: 445f 4d49 5353 494e 4727 0a20 2020 2020  D_MISSING'.     \n-0000e690: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat\n-0000e6a0: 613a 206d 6973 7369 6e67 2063 6f6d 6d61  a: missing comma\n-0000e6b0: 6e64 206d 6573 7361 6765 0a20 2020 2020  nd message.     \n-0000e6c0: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL\n-0000e6d0: 4944 5f44 4154 415f 4d45 5353 4147 455f  ID_DATA_MESSAGE_\n-0000e6e0: 4143 4345 5353 5f4d 4953 5349 4e47 270a  ACCESS_MISSING'.\n-0000e6f0: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n-0000e700: 6420 6461 7461 3a20 6d69 7373 696e 6720  d data: missing \n-0000e710: 6163 6365 7373 206d 6573 7361 6765 0a20  access message. \n-0000e720: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I\n-0000e730: 4e56 414c 4944 5f44 4154 415f 4d45 5353  NVALID_DATA_MESS\n-0000e740: 4147 455f 4e41 545f 4d49 5353 494e 4727  AGE_NAT_MISSING'\n-0000e750: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n-0000e760: 6964 2064 6174 613a 206d 6973 7369 6e67  id data: missing\n-0000e770: 204e 4154 2064 6174 610a 2020 2020 2027   NAT data.     '\n-0000e780: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n-0000e790: 445f 4441 5441 5f4d 4553 5341 4745 5f50  D_DATA_MESSAGE_P\n-0000e7a0: 4f52 5450 524f 544f 5f4d 4953 5349 4e47  ORTPROTO_MISSING\n-0000e7b0: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva\n-0000e7c0: 6c69 6420 6461 7461 3a20 6d69 7373 696e  lid data: missin\n-0000e7d0: 6720 7072 6f74 6f2f 706f 7274 2064 6174  g proto/port dat\n-0000e7e0: 610a 2020 2020 2027 464b 4f5f 4552 524f  a.     'FKO_ERRO\n-0000e7f0: 525f 494e 5641 4c49 445f 4441 5441 5f4e  R_INVALID_DATA_N\n-0000e800: 4154 5f45 4d50 5459 270a 2020 2020 2020  AT_EMPTY'.      \n-0000e810: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data\n-0000e820: 3a20 656d 7074 7920 4e41 5420 7661 6c75  : empty NAT valu\n-0000e830: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO\n-0000e840: 525f 494e 5641 4c49 445f 4441 5441 5f52  R_INVALID_DATA_R\n-0000e850: 414e 445f 4c45 4e5f 5641 4c49 4446 4149  AND_LEN_VALIDFAI\n-0000e860: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv\n-0000e870: 616c 6964 2064 6174 613a 2069 6e76 616c  alid data: inval\n-0000e880: 6964 2072 616e 646f 6d20 6461 7461 206c  id random data l\n-0000e890: 656e 6774 680a 2020 2020 2027 464b 4f5f  ength.     'FKO_\n-0000e8a0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA\n-0000e8b0: 5441 5f53 5256 4155 5448 5f4d 4953 5349  TA_SRVAUTH_MISSI\n-0000e8c0: 4e47 270a 2020 2020 2020 2020 2020 496e  NG'.          In\n-0000e8d0: 7661 6c69 6420 6461 7461 3a20 7365 7276  valid data: serv\n-0000e8e0: 6572 2061 7574 6820 6d69 7373 696e 670a  er auth missing.\n-0000e8f0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000e900: 494e 5641 4c49 445f 4441 5441 5f54 494d  INVALID_DATA_TIM\n-0000e910: 4553 5441 4d50 5f56 414c 4944 4641 494c  ESTAMP_VALIDFAIL\n-0000e920: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva\n-0000e930: 6c69 6420 6461 7461 3a20 696e 7661 6c69  lid data: invali\n-0000e940: 6420 7469 6d65 7374 616d 7020 7661 6c75  d timestamp valu\n-0000e950: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO\n-0000e960: 525f 494e 5641 4c49 445f 4441 5441 5f55  R_INVALID_DATA_U\n-0000e970: 5345 525f 4d49 5353 494e 4727 0a20 2020  SER_MISSING'.   \n-0000e980: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d\n-0000e990: 6174 613a 206d 6973 7369 6e67 2075 7365  ata: missing use\n-0000e9a0: 7220 6461 7461 0a20 2020 2020 2746 4b4f  r data.     'FKO\n-0000e9b0: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n-0000e9c0: 4154 415f 5553 4552 5f46 4952 5354 4348  ATA_USER_FIRSTCH\n-0000e9d0: 4152 5f56 414c 4944 4641 494c 270a 2020  AR_VALIDFAIL'.  \n-0000e9e0: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n-0000e9f0: 6461 7461 3a20 7573 6572 2066 6972 7374  data: user first\n-0000ea00: 2063 6861 7220 6e6f 7420 7661 6c69 640a   char not valid.\n-0000ea10: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000ea20: 494e 5641 4c49 445f 4441 5441 5f55 5345  INVALID_DATA_USE\n-0000ea30: 525f 5245 4d43 4841 525f 5641 4c49 4446  R_REMCHAR_VALIDF\n-0000ea40: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I\n-0000ea50: 6e76 616c 6964 2064 6174 613a 2075 7365  nvalid data: use\n-0000ea60: 7220 7265 6d63 6861 7220 6e6f 7420 7661  r remchar not va\n-0000ea70: 6c69 640a 2020 2020 2027 464b 4f5f 4552  lid.     'FKO_ER\n-0000ea80: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n-0000ea90: 5f55 5449 4c5f 5354 5254 4f4c 5f4c 545f  _UTIL_STRTOL_LT_\n-0000eaa0: 4d49 4e27 0a20 2020 2020 2020 2020 2049  MIN'.          I\n-0000eab0: 6e76 616c 6964 2064 6174 613a 2075 7469  nvalid data: uti\n-0000eac0: 6c20 636f 6e76 6572 7369 6f6e 2074 6f20  l conversion to \n-0000ead0: 6c6f 6e67 206c 6573 7320 7468 616e 206d  long less than m\n-0000eae0: 696e 696d 756d 0a20 2020 2020 2746 4b4f  inimum.     'FKO\n-0000eaf0: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n-0000eb00: 4154 415f 5554 494c 5f53 5452 544f 4c5f  ATA_UTIL_STRTOL_\n-0000eb10: 4754 5f4d 4158 270a 2020 2020 2020 2020  GT_MAX'.        \n-0000eb20: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n-0000eb30: 7574 696c 2063 6f6e 7665 7273 696f 6e20  util conversion \n-0000eb40: 746f 206c 6f6e 6720 6772 6561 7465 7220  to long greater \n-0000eb50: 7468 616e 206d 6178 696d 756d 0a20 2020  than maximum.   \n-0000eb60: 2020 2746 4b4f 5f45 5252 4f52 5f44 4154    'FKO_ERROR_DAT\n-0000eb70: 415f 544f 4f5f 4c41 5247 4527 0a20 2020  A_TOO_LARGE'.   \n-0000eb80: 2020 2020 2020 2056 616c 7565 206f 7220         Value or \n-0000eb90: 5369 7a65 206f 6620 7468 6520 6461 7461  Size of the data\n-0000eba0: 2065 7863 6565 6465 6420 7468 6520 6d61   exceeded the ma\n-0000ebb0: 7820 616c 6c6f 7765 640a 2020 2020 2027  x allowed.     '\n-0000ebc0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI\n-0000ebd0: 445f 4b45 595f 4c45 4e27 0a20 2020 2020  D_KEY_LEN'.     \n-0000ebe0: 2020 2020 2049 6e76 616c 6964 206b 6579       Invalid key\n-0000ebf0: 206c 656e 6774 680a 2020 2020 2027 464b   length.     'FK\n-0000ec00: 4f5f 4552 524f 525f 5553 4552 4e41 4d45  O_ERROR_USERNAME\n-0000ec10: 5f55 4e4b 4e4f 574e 270a 2020 2020 2020  _UNKNOWN'.      \n-0000ec20: 2020 2020 556e 6162 6c65 2074 6f20 6465      Unable to de\n-0000ec30: 7465 726d 696e 6520 7573 6572 6e61 6d65  termine username\n-0000ec40: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-0000ec50: 5f49 4e43 4f4d 504c 4554 455f 5350 415f  _INCOMPLETE_SPA_\n-0000ec60: 4441 5441 270a 2020 2020 2020 2020 2020  DATA'.          \n-0000ec70: 4d69 7373 696e 6720 6f72 2069 6e63 6f6d  Missing or incom\n-0000ec80: 706c 6574 6520 5350 4120 6461 7461 0a20  plete SPA data. \n-0000ec90: 2020 2020 2746 4b4f 5f45 5252 4f52 5f4d      'FKO_ERROR_M\n-0000eca0: 4953 5349 4e47 5f45 4e43 4f44 4544 5f44  ISSING_ENCODED_D\n-0000ecb0: 4154 4127 0a20 2020 2020 2020 2020 2054  ATA'.          T\n-0000ecc0: 6865 7265 2069 7320 6e6f 2065 6e63 6f64  here is no encod\n-0000ecd0: 6564 2064 6174 6120 746f 2070 726f 6365  ed data to proce\n-0000ece0: 7373 0a20 2020 2020 2746 4b4f 5f45 5252  ss.     'FKO_ERR\n-0000ecf0: 4f52 5f49 4e56 414c 4944 5f44 4947 4553  OR_INVALID_DIGES\n-0000ed00: 545f 5459 5045 270a 2020 2020 2020 2020  T_TYPE'.        \n-0000ed10: 2020 496e 7661 6c69 6420 6469 6765 7374    Invalid digest\n-0000ed20: 2074 7970 650a 2020 2020 2027 464b 4f5f   type.     'FKO_\n-0000ed30: 4552 524f 525f 494e 5641 4c49 445f 414c  ERROR_INVALID_AL\n-0000ed40: 4c4f 575f 4950 270a 2020 2020 2020 2020  LOW_IP'.        \n-0000ed50: 2020 496e 7661 6c69 6420 616c 6c6f 7720    Invalid allow \n-0000ed60: 4950 2061 6464 7265 7373 2069 6e20 7468  IP address in th\n-0000ed70: 6520 5350 4120 6d65 7373 6167 6520 6461  e SPA message da\n-0000ed80: 7461 0a20 2020 2020 2746 4b4f 5f45 5252  ta.     'FKO_ERR\n-0000ed90: 4f52 5f49 4e56 414c 4944 5f53 5041 5f43  OR_INVALID_SPA_C\n-0000eda0: 4f4d 4d41 4e44 5f4d 5347 270a 2020 2020  OMMAND_MSG'.    \n-0000edb0: 2020 2020 2020 496e 7661 6c69 6420 5350        Invalid SP\n-0000edc0: 4120 636f 6d6d 616e 6420 6d65 7373 6167  A command messag\n-0000edd0: 6520 666f 726d 6174 0a20 2020 2020 2746  e format.     'F\n-0000ede0: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n-0000edf0: 5f53 5041 5f41 4343 4553 535f 4d53 4727  _SPA_ACCESS_MSG'\n-0000ee00: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n-0000ee10: 6964 2053 5041 2061 6363 6573 7320 6d65  id SPA access me\n-0000ee20: 7373 6167 6520 666f 726d 6174 0a20 2020  ssage format.   \n-0000ee30: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n-0000ee40: 414c 4944 5f53 5041 5f4e 4154 5f41 4343  ALID_SPA_NAT_ACC\n-0000ee50: 4553 535f 4d53 4727 0a20 2020 2020 2020  ESS_MSG'.       \n-0000ee60: 2020 2049 6e76 616c 6964 2053 5041 206e     Invalid SPA n\n-0000ee70: 6174 5f61 6363 6573 7320 6d65 7373 6167  at_access messag\n-0000ee80: 6520 666f 726d 6174 0a20 2020 2020 2746  e format.     'F\n-0000ee90: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID\n-0000eea0: 5f45 4e43 5259 5054 494f 4e5f 5459 5045  _ENCRYPTION_TYPE\n-0000eeb0: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva\n-0000eec0: 6c69 6420 656e 6372 7970 7469 6f6e 2074  lid encryption t\n-0000eed0: 7970 650a 2020 2020 2027 464b 4f5f 4552  ype.     'FKO_ER\n-0000eee0: 524f 525f 5752 4f4e 475f 454e 4352 5950  ROR_WRONG_ENCRYP\n-0000eef0: 5449 4f4e 5f54 5950 4527 0a20 2020 2020  TION_TYPE'.     \n-0000ef00: 2020 2020 2057 726f 6e67 206f 7220 696e       Wrong or in\n-0000ef10: 6170 7072 6f70 7269 6174 6520 656e 6372  appropriate encr\n-0000ef20: 7970 7469 6f6e 2074 7970 6520 666f 7220  yption type for \n-0000ef30: 7468 6973 206f 7065 7261 7469 6f6e 0a20  this operation. \n-0000ef40: 2020 2020 2746 4b4f 5f45 5252 4f52 5f44      'FKO_ERROR_D\n-0000ef50: 4543 5259 5054 494f 4e5f 5349 5a45 270a  ECRYPTION_SIZE'.\n-0000ef60: 2020 2020 2020 2020 2020 556e 6578 7065            Unexpe\n-0000ef70: 6374 6564 206f 7220 696e 7661 6c69 6420  cted or invalid \n-0000ef80: 7369 7a65 2066 6f72 2064 6563 7279 7074  size for decrypt\n-0000ef90: 6564 2064 6174 610a 2020 2020 2027 464b  ed data.     'FK\n-0000efa0: 4f5f 4552 524f 525f 4445 4352 5950 5449  O_ERROR_DECRYPTI\n-0000efb0: 4f4e 5f46 4149 4c55 5245 270a 2020 2020  ON_FAILURE'.    \n-0000efc0: 2020 2020 2020 4465 6372 7970 7469 6f6e        Decryption\n-0000efd0: 2066 6169 6c65 6420 6f72 2064 6563 7279   failed or decry\n-0000efe0: 7074 6564 2064 6174 6120 6973 2069 6e76  pted data is inv\n-0000eff0: 616c 6964 0a20 2020 2020 2746 4b4f 5f45  alid.     'FKO_E\n-0000f000: 5252 4f52 5f44 4947 4553 545f 5645 5249  RROR_DIGEST_VERI\n-0000f010: 4649 4341 5449 4f4e 5f46 4149 4c45 4427  FICATION_FAILED'\n-0000f020: 0a20 2020 2020 2020 2020 2054 6865 2063  .          The c\n-0000f030: 6f6d 7075 7465 6420 6469 6765 7374 2064  omputed digest d\n-0000f040: 6964 206e 6f74 206d 6174 6368 2074 6865  id not match the\n-0000f050: 2064 6967 6573 7420 696e 2074 6865 2073   digest in the s\n-0000f060: 7061 2064 6174 610a 2020 2020 2027 464b  pa data.     'FK\n-0000f070: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n-0000f080: 484d 4143 5f4b 4559 5f4c 454e 270a 2020  HMAC_KEY_LEN'.  \n-0000f090: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid \n-0000f0a0: 484d 4143 206b 6579 206c 656e 6774 680a  HMAC key length.\n-0000f0b0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000f0c0: 554e 5355 5050 4f52 5445 445f 484d 4143  UNSUPPORTED_HMAC\n-0000f0d0: 5f4d 4f44 4527 0a20 2020 2020 2020 2020  _MODE'.         \n-0000f0e0: 2055 6e73 7570 706f 7274 6564 2048 4d41   Unsupported HMA\n-0000f0f0: 4320 6d6f 6465 2028 6465 6661 756c 743a  C mode (default:\n-0000f100: 2053 4841 3235 3629 0a20 2020 2020 2746   SHA256).     'F\n-0000f110: 4b4f 5f45 5252 4f52 5f55 4e53 5550 504f  KO_ERROR_UNSUPPO\n-0000f120: 5254 4544 5f46 4541 5455 5245 270a 2020  RTED_FEATURE'.  \n-0000f130: 2020 2020 2020 2020 556e 7375 7070 6f72          Unsuppor\n-0000f140: 7465 6420 6f72 2075 6e69 6d70 6c65 6d65  ted or unimpleme\n-0000f150: 6e74 6564 2066 6561 7475 7265 206f 7220  nted feature or \n-0000f160: 6675 6e63 7469 6f6e 0a20 2020 2020 2746  function.     'F\n-0000f170: 4b4f 5f45 5252 4f52 5f5a 4552 4f5f 4f55  KO_ERROR_ZERO_OU\n-0000f180: 545f 4441 5441 270a 2020 2020 2020 2020  T_DATA'.        \n-0000f190: 2020 436f 756c 6420 6e6f 7420 7a65 726f    Could not zero\n-0000f1a0: 206f 7574 2073 656e 7369 7469 7665 2064   out sensitive d\n-0000f1b0: 6174 610a 2020 2020 2027 464b 4f5f 4552  ata.     'FKO_ER\n-0000f1c0: 524f 525f 554e 4b4e 4f57 4e27 0a20 2020  ROR_UNKNOWN'.   \n-0000f1d0: 2020 2020 2020 2055 6e6b 6e6f 776e 2f55         Unknown/U\n-0000f1e0: 6e63 6c61 7373 6966 6965 6420 6572 726f  nclassified erro\n-0000f1f0: 720a 0a20 2020 4966 2047 5047 2073 7570  r..   If GPG sup\n-0000f200: 706f 7274 2069 7320 6176 6169 6c61 626c  port is availabl\n-0000f210: 652c 2074 6865 7265 2061 7265 2061 6464  e, there are add\n-0000f220: 6974 696f 6e61 6c20 706f 7373 6962 6c65  itional possible\n-0000f230: 2065 7272 6f72 0a63 6f6e 6469 7469 6f6e   error.condition\n-0000f240: 7320 616e 6420 6572 726f 7220 636f 6465  s and error code\n-0000f250: 732e 2020 5468 6520 4750 4720 7375 7070  s.  The GPG supp\n-0000f260: 6f72 7420 6973 2069 6d70 6c65 6d65 6e74  ort is implement\n-0000f270: 6564 2076 6961 2047 5047 4d45 2e0a 5468  ed via GPGME..Th\n-0000f280: 6520 6c69 6266 6b6f 2065 7272 6f72 2068  e libfko error h\n-0000f290: 616e 646c 696e 6720 636f 6465 2077 7261  andling code wra\n-0000f2a0: 7073 206d 616e 7920 6f66 2074 6865 2047  ps many of the G\n-0000f2b0: 5047 4d45 2065 7272 6f72 2063 6f64 6573  PGME error codes\n-0000f2c0: 2074 6861 740a 6d61 7920 6265 2065 6e63   that.may be enc\n-0000f2d0: 6f75 6e74 6572 6564 2077 6869 6c65 2075  ountered while u\n-0000f2e0: 7369 6e67 206c 6962 666b 6f27 7320 4750  sing libfko's GP\n-0000f2f0: 4720 7265 6c61 7465 6420 6675 6e63 7469  G related functi\n-0000f300: 6f6e 732e 2020 5468 6573 650a 6172 653a  ons.  These.are:\n-0000f310: 0a0a 202d 2d20 5661 7269 6162 6c65 3a20  .. -- Variable: \n-0000f320: 696e 7420 6572 726f 725f 636f 6465 2028  int error_code (\n-0000f330: 6770 676d 6520 7375 7070 6f72 7420 6f6e  gpgme support on\n-0000f340: 6c79 290a 2020 2020 2027 464b 4f5f 4552  ly).     'FKO_ER\n-0000f350: 524f 525f 4d49 5353 494e 475f 4750 475f  ROR_MISSING_GPG_\n-0000f360: 4b45 595f 4441 5441 270a 2020 2020 2020  KEY_DATA'.      \n-0000f370: 2020 2020 4d69 7373 696e 6720 4750 4720      Missing GPG \n-0000f380: 6b65 7920 6461 7461 2028 7369 676e 6572  key data (signer\n-0000f390: 206f 7220 7265 6369 7069 656e 7420 6e6f   or recipient no\n-0000f3a0: 7420 7365 7429 0a20 2020 2020 2746 4b4f  t set).     'FKO\n-0000f3b0: 5f45 5252 4f52 5f47 5047 4d45 5f4e 4f5f  _ERROR_GPGME_NO_\n-0000f3c0: 4f50 454e 5047 5027 0a20 2020 2020 2020  OPENPGP'.       \n-0000f3d0: 2020 2054 6869 7320 4750 474d 4520 696d     This GPGME im\n-0000f3e0: 706c 656d 656e 7461 7469 6f6e 2064 6f65  plementation doe\n-0000f3f0: 7320 6e6f 7420 7375 7070 6f72 7420 4f70  s not support Op\n-0000f400: 656e 5047 500a 2020 2020 2027 464b 4f5f  enPGP.     'FKO_\n-0000f410: 4552 524f 525f 4750 474d 455f 434f 4e54  ERROR_GPGME_CONT\n-0000f420: 4558 5427 0a20 2020 2020 2020 2020 2055  EXT'.          U\n-0000f430: 6e61 626c 6520 746f 2063 7265 6174 6520  nable to create \n-0000f440: 4750 474d 4520 636f 6e74 6578 740a 2020  GPGME context.  \n-0000f450: 2020 2027 464b 4f5f 4552 524f 525f 4750     'FKO_ERROR_GP\n-0000f460: 474d 455f 504c 4149 4e54 4558 545f 4441  GME_PLAINTEXT_DA\n-0000f470: 5441 5f4f 424a 270a 2020 2020 2020 2020  TA_OBJ'.        \n-0000f480: 2020 4572 726f 7220 6372 6561 7469 6e67    Error creating\n-0000f490: 2074 6865 2070 6c61 696e 7465 7874 2064   the plaintext d\n-0000f4a0: 6174 6120 6f62 6a65 6374 0a20 2020 2020  ata object.     \n-0000f4b0: 2746 4b4f 5f45 5252 4f52 5f47 5047 4d45  'FKO_ERROR_GPGME\n-0000f4c0: 5f53 4554 5f50 524f 544f 434f 4c27 0a20  _SET_PROTOCOL'. \n-0000f4d0: 2020 2020 2020 2020 2055 6e61 626c 6520           Unable \n-0000f4e0: 746f 2073 6574 2047 5047 4d45 2074 6f20  to set GPGME to \n-0000f4f0: 7573 6520 4f70 656e 5047 5020 7072 6f74  use OpenPGP prot\n-0000f500: 6f63 6f6c 0a20 2020 2020 2746 4b4f 5f45  ocol.     'FKO_E\n-0000f510: 5252 4f52 5f47 5047 4d45 5f43 4950 4845  RROR_GPGME_CIPHE\n-0000f520: 525f 4441 5441 5f4f 424a 270a 2020 2020  R_DATA_OBJ'.    \n-0000f530: 2020 2020 2020 4572 726f 7220 6372 6561        Error crea\n-0000f540: 7469 6e67 2074 6865 2065 6e63 7279 7074  ting the encrypt\n-0000f550: 6564 2064 6174 6120 6461 7461 206f 626a  ed data data obj\n-0000f560: 6563 740a 2020 2020 2027 464b 4f5f 4552  ect.     'FKO_ER\n-0000f570: 524f 525f 4750 474d 455f 4241 445f 5041  ROR_GPGME_BAD_PA\n-0000f580: 5353 5048 5241 5345 270a 2020 2020 2020  SSPHRASE'.      \n-0000f590: 2020 2020 5468 6520 4750 4720 7061 7373      The GPG pass\n-0000f5a0: 7068 7261 7365 2077 6173 206e 6f74 2076  phrase was not v\n-0000f5b0: 616c 6964 0a20 2020 2020 2746 4b4f 5f45  alid.     'FKO_E\n-0000f5c0: 5252 4f52 5f47 5047 4d45 5f45 4e43 5259  RROR_GPGME_ENCRY\n-0000f5d0: 5054 5f53 4947 4e27 0a20 2020 2020 2020  PT_SIGN'.       \n-0000f5e0: 2020 2045 7272 6f72 2064 7572 696e 6720     Error during \n-0000f5f0: 7468 6520 656e 6372 7970 7420 616e 6420  the encrypt and \n-0000f600: 7369 676e 206f 7065 7261 7469 6f6e 0a20  sign operation. \n-0000f610: 2020 2020 2746 4b4f 5f45 5252 4f52 5f47      'FKO_ERROR_G\n-0000f620: 5047 4d45 5f43 4f4e 5445 5854 5f53 4947  PGME_CONTEXT_SIG\n-0000f630: 4e45 525f 4b45 5927 0a20 2020 2020 2020  NER_KEY'.       \n-0000f640: 2020 2055 6e61 626c 6520 746f 2063 7265     Unable to cre\n-0000f650: 6174 6520 4750 474d 4520 636f 6e74 6578  ate GPGME contex\n-0000f660: 7420 666f 7220 7468 6520 7369 676e 6572  t for the signer\n-0000f670: 206b 6579 0a20 2020 2020 2746 4b4f 5f45   key.     'FKO_E\n-0000f680: 5252 4f52 5f47 5047 4d45 5f53 4947 4e45  RROR_GPGME_SIGNE\n-0000f690: 525f 4b45 594c 4953 545f 5354 4152 5427  R_KEYLIST_START'\n-0000f6a0: 0a20 2020 2020 2020 2020 2045 7272 6f72  .          Error\n-0000f6b0: 2066 726f 6d20 7369 676e 6572 206b 6579   from signer key\n-0000f6c0: 6c69 7374 2073 7461 7274 206f 7065 7261  list start opera\n-0000f6d0: 7469 6f6e 0a20 2020 2020 2746 4b4f 5f45  tion.     'FKO_E\n-0000f6e0: 5252 4f52 5f47 5047 4d45 5f53 4947 4e45  RROR_GPGME_SIGNE\n-0000f6f0: 525f 4b45 595f 4e4f 545f 464f 554e 4427  R_KEY_NOT_FOUND'\n-0000f700: 0a20 2020 2020 2020 2020 2054 6865 206b  .          The k\n-0000f710: 6579 2066 6f72 2074 6865 2067 6976 656e  ey for the given\n-0000f720: 2073 6967 6e65 7220 7761 7320 6e6f 7420   signer was not \n-0000f730: 666f 756e 640a 2020 2020 2027 464b 4f5f  found.     'FKO_\n-0000f740: 4552 524f 525f 4750 474d 455f 5349 474e  ERROR_GPGME_SIGN\n-0000f750: 4552 5f4b 4559 5f41 4d42 4947 554f 5553  ER_KEY_AMBIGUOUS\n-0000f760: 270a 2020 2020 2020 2020 2020 416d 6269  '.          Ambi\n-0000f770: 6775 6f75 7320 6e61 6d65 2f69 6420 666f  guous name/id fo\n-0000f780: 7220 7468 6520 7369 676e 6572 206b 6579  r the signer key\n-0000f790: 2028 6d75 6c74 6970 6c65 206d 6174 6368   (multiple match\n-0000f7a0: 6573 290a 2020 2020 2027 464b 4f5f 4552  es).     'FKO_ER\n-0000f7b0: 524f 525f 4750 474d 455f 4144 445f 5349  ROR_GPGME_ADD_SI\n-0000f7c0: 474e 4552 270a 2020 2020 2020 2020 2020  GNER'.          \n-0000f7d0: 4572 726f 7220 6164 6469 6e67 2074 6865  Error adding the\n-0000f7e0: 2073 6967 6e65 7220 6b65 7920 746f 2074   signer key to t\n-0000f7f0: 6865 2067 7067 6d65 2063 6f6e 7465 7874  he gpgme context\n-0000f800: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR\n-0000f810: 5f47 5047 4d45 5f43 4f4e 5445 5854 5f52  _GPGME_CONTEXT_R\n-0000f820: 4543 4950 4945 4e54 5f4b 4559 270a 2020  ECIPIENT_KEY'.  \n-0000f830: 2020 2020 2020 2020 556e 6162 6c65 2074          Unable t\n-0000f840: 6f20 6372 6561 7465 2047 5047 4d45 2063  o create GPGME c\n-0000f850: 6f6e 7465 7874 2066 6f72 2074 6865 2072  ontext for the r\n-0000f860: 6563 6970 6965 6e74 206b 6579 0a20 2020  ecipient key.   \n-0000f870: 2020 2746 4b4f 5f45 5252 4f52 5f47 5047    'FKO_ERROR_GPG\n-0000f880: 4d45 5f52 4543 4950 4945 4e54 5f4b 4559  ME_RECIPIENT_KEY\n-0000f890: 4c49 5354 5f53 5441 5254 270a 2020 2020  LIST_START'.    \n-0000f8a0: 2020 2020 2020 4572 726f 7220 6672 6f6d        Error from\n-0000f8b0: 2073 6967 6e65 7220 6b65 796c 6973 7420   signer keylist \n-0000f8c0: 7374 6172 7420 6f70 6572 6174 696f 6e0a  start operation.\n-0000f8d0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_\n-0000f8e0: 4750 474d 455f 5245 4349 5049 454e 545f  GPGME_RECIPIENT_\n-0000f8f0: 4b45 595f 4e4f 545f 464f 554e 4427 0a20  KEY_NOT_FOUND'. \n-0000f900: 2020 2020 2020 2020 2054 6865 206b 6579           The key\n-0000f910: 2066 6f72 2074 6865 2067 6976 656e 2072   for the given r\n-0000f920: 6563 6970 6965 6e74 2077 6173 206e 6f74  ecipient was not\n-0000f930: 2066 6f75 6e64 0a20 2020 2020 2746 4b4f   found.     'FKO\n-0000f940: 5f45 5252 4f52 5f47 5047 4d45 5f52 4543  _ERROR_GPGME_REC\n-0000f950: 4950 4945 4e54 5f4b 4559 5f41 4d42 4947  IPIENT_KEY_AMBIG\n-0000f960: 554f 5553 270a 2020 2020 2020 2020 2020  UOUS'.          \n-0000f970: 416d 6269 6775 6f75 7320 6e61 6d65 2f69  Ambiguous name/i\n-0000f980: 6420 666f 7220 7468 6520 7265 6369 7069  d for the recipi\n-0000f990: 656e 7420 6b65 7920 286d 756c 7469 706c  ent key (multipl\n-0000f9a0: 6520 6d61 7463 6865 7329 0a20 2020 2020  e matches).     \n-0000f9b0: 2746 4b4f 5f45 5252 4f52 5f47 5047 4d45  'FKO_ERROR_GPGME\n-0000f9c0: 5f44 4543 5259 5054 5f46 4149 4c45 4427  _DECRYPT_FAILED'\n-0000f9d0: 0a20 2020 2020 2020 2020 2044 6563 7279  .          Decry\n-0000f9e0: 7074 696f 6e20 6f70 6572 6174 696f 6e20  ption operation \n-0000f9f0: 6661 696c 6564 0a20 2020 2020 2746 4b4f  failed.     'FKO\n-0000fa00: 5f45 5252 4f52 5f47 5047 4d45 5f42 4144  _ERROR_GPGME_BAD\n-0000fa10: 5f47 5047 5f45 5845 270a 2020 2020 2020  _GPG_EXE'.      \n-0000fa20: 2020 2020 556e 6162 6c65 2074 6f20 7374      Unable to st\n-0000fa30: 6174 2074 6865 2067 6976 656e 2047 5047  at the given GPG\n-0000fa40: 2065 7865 6375 7461 626c 650a 2020 2020   executable.    \n-0000fa50: 2027 464b 4f5f 4552 524f 525f 4750 474d   'FKO_ERROR_GPGM\n-0000fa60: 455f 4241 445f 484f 4d45 5f44 4952 270a  E_BAD_HOME_DIR'.\n-0000fa70: 2020 2020 2020 2020 2020 556e 6162 6c65            Unable\n-0000fa80: 2074 6f20 7374 6174 2074 6865 2067 6976   to stat the giv\n-0000fa90: 656e 2047 5047 2068 6f6d 6520 6469 7265  en GPG home dire\n-0000faa0: 6374 6f72 790a 2020 2020 2027 464b 4f5f  ctory.     'FKO_\n-0000fab0: 4552 524f 525f 4750 474d 455f 5345 545f  ERROR_GPGME_SET_\n-0000fac0: 484f 4d45 5f44 4952 270a 2020 2020 2020  HOME_DIR'.      \n-0000fad0: 2020 2020 556e 6162 6c65 2074 6f20 7365      Unable to se\n-0000fae0: 7420 7468 6520 6769 7665 6e20 4750 4720  t the given GPG \n-0000faf0: 686f 6d65 2064 6972 6563 746f 7279 0a20  home directory. \n-0000fb00: 2020 2020 2746 4b4f 5f45 5252 4f52 5f47      'FKO_ERROR_G\n-0000fb10: 5047 4d45 5f4e 4f5f 5349 474e 4154 5552  PGME_NO_SIGNATUR\n-0000fb20: 4527 0a20 2020 2020 2020 2020 204d 6973  E'.          Mis\n-0000fb30: 7369 6e67 2047 5047 2073 6967 6e61 7475  sing GPG signatu\n-0000fb40: 7265 0a20 2020 2020 2746 4b4f 5f45 5252  re.     'FKO_ERR\n-0000fb50: 4f52 5f47 5047 4d45 5f42 4144 5f53 4947  OR_GPGME_BAD_SIG\n-0000fb60: 4e41 5455 5245 270a 2020 2020 2020 2020  NATURE'.        \n-0000fb70: 2020 4261 6420 4750 4720 7369 676e 6174    Bad GPG signat\n-0000fb80: 7572 650a 2020 2020 2027 464b 4f5f 4552  ure.     'FKO_ER\n-0000fb90: 524f 525f 4750 474d 455f 5349 474e 4154  ROR_GPGME_SIGNAT\n-0000fba0: 5552 455f 5645 5249 4659 5f44 4953 4142  URE_VERIFY_DISAB\n-0000fbb0: 4c45 4427 0a20 2020 2020 2020 2020 2054  LED'.          T\n-0000fbc0: 7279 696e 6720 746f 2063 6865 636b 2073  rying to check s\n-0000fbd0: 6967 6e61 7475 7265 2077 6974 6820 7665  ignature with ve\n-0000fbe0: 7269 6669 6361 7469 6f6e 2064 6973 6162  rification disab\n-0000fbf0: 6c65 640a 2020 2020 2027 464b 4f5f 4552  led.     'FKO_ER\n-0000fc00: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA\n-0000fc10: 5f45 4e43 5259 5054 5f47 5047 5f4d 4553  _ENCRYPT_GPG_MES\n-0000fc20: 5341 4745 5f56 414c 4944 4641 494c 270a  SAGE_VALIDFAIL'.\n-0000fc30: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n-0000fc40: 6420 6461 7461 3a20 656e 6372 7970 743a  d data: encrypt:\n-0000fc50: 2069 6e76 616c 6964 2047 5047 2d65 6e63   invalid GPG-enc\n-0000fc60: 7279 7074 206d 6573 7361 6765 0a20 2020  rypt message.   \n-0000fc70: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV\n-0000fc80: 414c 4944 5f44 4154 415f 454e 4352 5950  ALID_DATA_ENCRYP\n-0000fc90: 545f 4750 475f 4449 4745 5354 5f56 414c  T_GPG_DIGEST_VAL\n-0000fca0: 4944 4641 494c 270a 2020 2020 2020 2020  IDFAIL'.        \n-0000fcb0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: \n-0000fcc0: 656e 6372 7970 743a 2069 6e76 616c 6964  encrypt: invalid\n-0000fcd0: 2047 5047 2064 6967 6573 740a 2020 2020   GPG digest.    \n-0000fce0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA\n-0000fcf0: 4c49 445f 4441 5441 5f45 4e43 5259 5054  LID_DATA_ENCRYPT\n-0000fd00: 5f47 5047 5f4d 5347 4c45 4e5f 5641 4c49  _GPG_MSGLEN_VALI\n-0000fd10: 4446 4149 4c27 0a20 2020 2020 2020 2020  DFAIL'.         \n-0000fd20: 2049 6e76 616c 6964 2064 6174 613a 2065   Invalid data: e\n-0000fd30: 6e63 7279 7074 3a20 696e 7661 6c69 6420  ncrypt: invalid \n-0000fd40: 4750 4720 6d65 7373 6167 6520 6c65 6e67  GPG message leng\n-0000fd50: 7468 0a20 2020 2020 2746 4b4f 5f45 5252  th.     'FKO_ERR\n-0000fd60: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_\n-0000fd70: 454e 4352 5950 545f 4750 475f 5245 5355  ENCRYPT_GPG_RESU\n-0000fd80: 4c54 5f4d 5347 4c45 4e5f 5641 4c49 4446  LT_MSGLEN_VALIDF\n-0000fd90: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I\n-0000fda0: 6e76 616c 6964 2064 6174 613a 2065 6e63  nvalid data: enc\n-0000fdb0: 7279 7074 3a20 696e 7661 6c69 6420 4750  rypt: invalid GP\n-0000fdc0: 4720 7265 7375 6c74 206d 6573 7361 6765  G result message\n-0000fdd0: 206c 656e 6774 680a 2020 2020 2027 464b   length.     'FK\n-0000fde0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_\n-0000fdf0: 4441 5441 5f45 4e43 5259 5054 5f47 5047  DATA_ENCRYPT_GPG\n-0000fe00: 5f43 4950 4845 525f 4445 434f 4445 4641  _CIPHER_DECODEFA\n-0000fe10: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In\n-0000fe20: 7661 6c69 6420 6461 7461 3a20 656e 6372  valid data: encr\n-0000fe30: 7970 743a 2047 5047 2063 6970 6865 7220  ypt: GPG cipher \n-0000fe40: 6661 696c 6564 0a20 2020 2020 2746 4b4f  failed.     'FKO\n-0000fe50: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D\n-0000fe60: 4154 415f 454e 4352 5950 545f 4750 475f  ATA_ENCRYPT_GPG_\n-0000fe70: 454e 434f 4445 444d 5347 5f4e 554c 4c27  ENCODEDMSG_NULL'\n-0000fe80: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval\n-0000fe90: 6964 2064 6174 613a 2065 6e63 7279 7074  id data: encrypt\n-0000fea0: 3a20 4750 472d 656e 636f 6465 6420 6d65  : GPG-encoded me\n-0000feb0: 7373 6167 6520 6973 204e 554c 4c0a 2020  ssage is NULL.  \n-0000fec0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN\n-0000fed0: 5641 4c49 445f 4441 5441 5f45 4e43 5259  VALID_DATA_ENCRY\n-0000fee0: 5054 5f47 5047 5f45 4e43 4f44 4544 4d53  PT_GPG_ENCODEDMS\n-0000fef0: 474c 454e 5f56 414c 4944 4641 494c 270a  GLEN_VALIDFAIL'.\n-0000ff00: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali\n-0000ff10: 6420 6461 7461 3a20 656e 6372 7970 743a  d data: encrypt:\n-0000ff20: 2069 6e76 616c 6964 2047 5047 2d65 6e63   invalid GPG-enc\n-0000ff30: 7279 7074 6564 206d 6573 7361 6765 206c  rypted message l\n-0000ff40: 656e 6774 680a 0a20 2020 596f 7520 6361  ength..   You ca\n-0000ff50: 6e20 7573 6520 7468 6520 2749 535f 4750  n use the 'IS_GP\n-0000ff60: 474d 455f 4552 524f 5228 6572 725f 636f  GME_ERROR(err_co\n-0000ff70: 6465 2927 206d 6163 726f 2074 6f20 6465  de)' macro to de\n-0000ff80: 7465 726d 696e 6520 7768 6574 6865 720a  termine whether.\n-0000ff90: 6f72 206e 6f74 2061 6e20 6572 726f 7220  or not an error \n-0000ffa0: 6964 2047 5047 4d45 2072 656c 6174 6564  id GPGME related\n-0000ffb0: 2e20 2049 6620 7468 6520 6d61 6372 6f20  .  If the macro \n-0000ffc0: 6576 616c 7561 7465 7320 746f 2061 2074  evaluates to a t\n-0000ffd0: 7275 650a 7661 6c75 652c 2079 6f75 206d  rue.value, you m\n-0000ffe0: 6179 2062 6520 6162 6c65 2074 6f20 6765  ay be able to ge\n-0000fff0: 7420 6164 6469 7469 6f6e 616c 2069 6e66  t additional inf\n-00010000: 6f72 6d61 7469 6f6e 2061 626f 7574 2074  ormation about t\n-00010010: 6865 2065 7272 6f72 0a75 7369 6e67 2074  he error.using t\n-00010020: 6865 2066 6f6c 6c6f 7769 6e67 2066 756e  he following fun\n-00010030: 6374 696f 6e3a 0a0a 202d 2d20 4675 6e63  ction:.. -- Func\n-00010040: 7469 6f6e 3a20 636f 6e73 7420 6368 6172  tion: const char\n-00010050: 202a 2066 6b6f 5f67 7067 5f65 7272 7374   * fko_gpg_errst\n-00010060: 7220 2869 6e74 2045 5252 5f43 4f44 4529  r (int ERR_CODE)\n-00010070: 0a20 2020 2020 5468 6520 6675 6e63 7469  .     The functi\n-00010080: 6f6e 2027 666b 6f5f 6572 7273 7472 2720  on 'fko_errstr' \n-00010090: 7265 7475 726e 7320 6120 706f 696e 7465  returns a pointe\n-000100a0: 7220 746f 2061 2073 7461 7469 6361 6c6c  r to a staticall\n-000100b0: 790a 2020 2020 2061 6c6c 6f63 6174 6564  y.     allocated\n-000100c0: 2073 7472 696e 6720 636f 6e74 6169 6e69   string containi\n-000100d0: 6e67 2074 6865 2064 6573 6372 6970 7469  ng the descripti\n-000100e0: 6f6e 206f 6620 7468 6520 4750 474d 4520  on of the GPGME \n-000100f0: 6572 726f 722e 0a0a 2a4e 6f74 652a 3a20  error...*Note*: \n-00010100: 466f 7220 736f 6d65 2065 7272 6f72 732c  For some errors,\n-00010110: 2074 6869 7320 6675 6e63 7469 6f6e 206d   this function m\n-00010120: 6179 2072 6574 7572 6e20 616e 2065 6d70  ay return an emp\n-00010130: 7479 2073 7472 696e 672e 0a0a 1f0a 4669  ty string.....Fi\n-00010140: 6c65 3a20 6c69 6266 6b6f 2e69 6e66 6f2c  le: libfko.info,\n-00010150: 2020 4e6f 6465 3a20 4c69 6272 6172 7920    Node: Library \n-00010160: 436f 7079 696e 672c 2020 4e65 7874 3a20  Copying,  Next: \n-00010170: 436f 6e63 6570 7420 496e 6465 782c 2020  Concept Index,  \n-00010180: 5072 6576 3a20 5573 696e 6720 6c69 6266  Prev: Using libf\n-00010190: 6b6f 2c20 2055 703a 2054 6f70 0a0a 4170  ko,  Up: Top..Ap\n-000101a0: 7065 6e64 6978 2041 2047 4e55 2047 454e  pendix A GNU GEN\n-000101b0: 4552 414c 2050 5542 4c49 4320 4c49 4345  ERAL PUBLIC LICE\n-000101c0: 4e53 450a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  NSE.************\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 000101d0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ****************\n-000101e0: 2a2a 2a2a 2a2a 2a2a 2a0a 0a20 2020 2020  *********..     \n-000101f0: 2020 2020 2020 2020 2056 6572 7369 6f6e           Version\n-00010200: 2032 2028 6f72 2061 6e79 206c 6174 6572   2 (or any later\n-00010210: 2076 6572 7369 6f6e 292c 204a 756e 6520   version), June \n-00010220: 3139 3931 0a0a 2020 2020 2043 6f70 7972  1991..     Copyr\n-00010230: 6967 6874 2028 4329 2031 3938 392c 2031  ight (C) 1989, 1\n-00010240: 3939 3120 4672 6565 2053 6f66 7477 6172  991 Free Softwar\n-00010250: 6520 466f 756e 6461 7469 6f6e 2c20 496e  e Foundation, In\n-00010260: 632e 0a20 2020 2020 3531 2046 7261 6e6b  c..     51 Frank\n-00010270: 6c69 6e20 5374 7265 6574 2c20 4669 6674  lin Street, Fift\n-00010280: 6820 466c 6f6f 722c 2042 6f73 746f 6e2c  h Floor, Boston,\n-00010290: 204d 4120 2030 3231 3130 2d31 3330 312c   MA  02110-1301,\n-000102a0: 2055 5341 0a0a 2020 2020 2045 7665 7279   USA..     Every\n-000102b0: 6f6e 6520 6973 2070 6572 6d69 7474 6564  one is permitted\n-000102c0: 2074 6f20 636f 7079 2061 6e64 2064 6973   to copy and dis\n-000102d0: 7472 6962 7574 6520 7665 7262 6174 696d  tribute verbatim\n-000102e0: 2063 6f70 6965 730a 2020 2020 206f 6620   copies.     of \n-000102f0: 7468 6973 206c 6963 656e 7365 2064 6f63  this license doc\n-00010300: 756d 656e 742c 2062 7574 2063 6861 6e67  ument, but chang\n-00010310: 696e 6720 6974 2069 7320 6e6f 7420 616c  ing it is not al\n-00010320: 6c6f 7765 642e 0a0a 412e 3120 5072 6561  lowed...A.1 Prea\n-00010330: 6d62 6c65 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d  mble.===========\n-00010340: 3d0a 0a54 6865 206c 6963 656e 7365 7320  =..The licenses \n-00010350: 666f 7220 6d6f 7374 2073 6f66 7477 6172  for most softwar\n-00010360: 6520 6172 6520 6465 7369 676e 6564 2074  e are designed t\n-00010370: 6f20 7461 6b65 2061 7761 7920 796f 7572  o take away your\n-00010380: 2066 7265 6564 6f6d 2074 6f0a 7368 6172   freedom to.shar\n-00010390: 6520 616e 6420 6368 616e 6765 2069 742e  e and change it.\n-000103a0: 2020 4279 2063 6f6e 7472 6173 742c 2074    By contrast, t\n-000103b0: 6865 2047 4e55 2047 656e 6572 616c 2050  he GNU General P\n-000103c0: 7562 6c69 6320 4c69 6365 6e73 6520 6973  ublic License is\n-000103d0: 0a69 6e74 656e 6465 6420 746f 2067 7561  .intended to gua\n-000103e0: 7261 6e74 6565 2079 6f75 7220 6672 6565  rantee your free\n-000103f0: 646f 6d20 746f 2073 6861 7265 2061 6e64  dom to share and\n-00010400: 2063 6861 6e67 6520 6672 6565 2073 6f66   change free sof\n-00010410: 7477 6172 652d 2d74 6f0a 6d61 6b65 2073  tware--to.make s\n-00010420: 7572 6520 7468 6520 736f 6674 7761 7265  ure the software\n-00010430: 2069 7320 6672 6565 2066 6f72 2061 6c6c   is free for all\n-00010440: 2069 7473 2075 7365 7273 2e20 2054 6869   its users.  Thi\n-00010450: 7320 4765 6e65 7261 6c20 5075 626c 6963  s General Public\n-00010460: 0a4c 6963 656e 7365 2061 7070 6c69 6573  .License applies\n-00010470: 2074 6f20 6d6f 7374 206f 6620 7468 6520   to most of the \n-00010480: 4672 6565 2053 6f66 7477 6172 6520 466f  Free Software Fo\n-00010490: 756e 6461 7469 6f6e 2773 2073 6f66 7477  undation's softw\n-000104a0: 6172 6520 616e 640a 746f 2061 6e79 206f  are and.to any o\n-000104b0: 7468 6572 2070 726f 6772 616d 2077 686f  ther program who\n-000104c0: 7365 2061 7574 686f 7273 2063 6f6d 6d69  se authors commi\n-000104d0: 7420 746f 2075 7369 6e67 2069 742e 2020  t to using it.  \n-000104e0: 2853 6f6d 6520 6f74 6865 7220 4672 6565  (Some other Free\n-000104f0: 0a53 6f66 7477 6172 6520 466f 756e 6461  .Software Founda\n-00010500: 7469 6f6e 2073 6f66 7477 6172 6520 6973  tion software is\n-00010510: 2063 6f76 6572 6564 2062 7920 7468 6520   covered by the \n-00010520: 474e 5520 4c65 7373 6572 2047 656e 6572  GNU Lesser Gener\n-00010530: 616c 2050 7562 6c69 630a 4c69 6365 6e73  al Public.Licens\n-00010540: 6520 696e 7374 6561 642e 2920 2059 6f75  e instead.)  You\n-00010550: 2063 616e 2061 7070 6c79 2069 7420 746f   can apply it to\n-00010560: 2079 6f75 7220 7072 6f67 7261 6d73 2c20   your programs, \n-00010570: 746f 6f2e 0a0a 2020 2057 6865 6e20 7765  too...   When we\n-00010580: 2073 7065 616b 206f 6620 6672 6565 2073   speak of free s\n-00010590: 6f66 7477 6172 652c 2077 6520 6172 6520  oftware, we are \n-000105a0: 7265 6665 7272 696e 6720 746f 2066 7265  referring to fre\n-000105b0: 6564 6f6d 2c20 6e6f 740a 7072 6963 652e  edom, not.price.\n-000105c0: 2020 4f75 7220 4765 6e65 7261 6c20 5075    Our General Pu\n-000105d0: 626c 6963 204c 6963 656e 7365 7320 6172  blic Licenses ar\n-000105e0: 6520 6465 7369 676e 6564 2074 6f20 6d61  e designed to ma\n-000105f0: 6b65 2073 7572 6520 7468 6174 2079 6f75  ke sure that you\n-00010600: 0a68 6176 6520 7468 6520 6672 6565 646f  .have the freedo\n-00010610: 6d20 746f 2064 6973 7472 6962 7574 6520  m to distribute \n-00010620: 636f 7069 6573 206f 6620 6672 6565 2073  copies of free s\n-00010630: 6f66 7477 6172 6520 2861 6e64 2063 6861  oftware (and cha\n-00010640: 7267 6520 666f 720a 7468 6973 2073 6572  rge for.this ser\n-00010650: 7669 6365 2069 6620 796f 7520 7769 7368  vice if you wish\n-00010660: 292c 2074 6861 7420 796f 7520 7265 6365  ), that you rece\n-00010670: 6976 6520 736f 7572 6365 2063 6f64 6520  ive source code \n-00010680: 6f72 2063 616e 2067 6574 2069 7420 6966  or can get it if\n-00010690: 0a79 6f75 2077 616e 7420 6974 2c20 7468  .you want it, th\n-000106a0: 6174 2079 6f75 2063 616e 2063 6861 6e67  at you can chang\n-000106b0: 6520 7468 6520 736f 6674 7761 7265 206f  e the software o\n-000106c0: 7220 7573 6520 7069 6563 6573 206f 6620  r use pieces of \n-000106d0: 6974 2069 6e20 6e65 770a 6672 6565 2070  it in new.free p\n-000106e0: 726f 6772 616d 733b 2061 6e64 2074 6861  rograms; and tha\n-000106f0: 7420 796f 7520 6b6e 6f77 2079 6f75 2063  t you know you c\n-00010700: 616e 2064 6f20 7468 6573 6520 7468 696e  an do these thin\n-00010710: 6773 2e0a 0a20 2020 546f 2070 726f 7465  gs...   To prote\n-00010720: 6374 2079 6f75 7220 7269 6768 7473 2c20  ct your rights, \n-00010730: 7765 206e 6565 6420 746f 206d 616b 6520  we need to make \n-00010740: 7265 7374 7269 6374 696f 6e73 2074 6861  restrictions tha\n-00010750: 7420 666f 7262 6964 0a61 6e79 6f6e 6520  t forbid.anyone \n-00010760: 746f 2064 656e 7920 796f 7520 7468 6573  to deny you thes\n-00010770: 6520 7269 6768 7473 206f 7220 746f 2061  e rights or to a\n-00010780: 736b 2079 6f75 2074 6f20 7375 7272 656e  sk you to surren\n-00010790: 6465 7220 7468 6520 7269 6768 7473 2e0a  der the rights..\n-000107a0: 5468 6573 6520 7265 7374 7269 6374 696f  These restrictio\n-000107b0: 6e73 2074 7261 6e73 6c61 7465 2074 6f20  ns translate to \n-000107c0: 6365 7274 6169 6e20 7265 7370 6f6e 7369  certain responsi\n-000107d0: 6269 6c69 7469 6573 2066 6f72 2079 6f75  bilities for you\n-000107e0: 2069 6620 796f 750a 6469 7374 7269 6275   if you.distribu\n-000107f0: 7465 2063 6f70 6965 7320 6f66 2074 6865  te copies of the\n-00010800: 2073 6f66 7477 6172 652c 206f 7220 6966   software, or if\n-00010810: 2079 6f75 206d 6f64 6966 7920 6974 2e0a   you modify it..\n-00010820: 0a20 2020 466f 7220 6578 616d 706c 652c  .   For example,\n-00010830: 2069 6620 796f 7520 6469 7374 7269 6275   if you distribu\n-00010840: 7465 2063 6f70 6965 7320 6f66 2073 7563  te copies of suc\n-00010850: 6820 6120 7072 6f67 7261 6d2c 2077 6865  h a program, whe\n-00010860: 7468 6572 0a67 7261 7469 7320 6f72 2066  ther.gratis or f\n-00010870: 6f72 2061 2066 6565 2c20 796f 7520 6d75  or a fee, you mu\n-00010880: 7374 2067 6976 6520 7468 6520 7265 6369  st give the reci\n-00010890: 7069 656e 7473 2061 6c6c 2074 6865 2072  pients all the r\n-000108a0: 6967 6874 7320 7468 6174 0a79 6f75 2068  ights that.you h\n-000108b0: 6176 652e 2020 596f 7520 6d75 7374 206d  ave.  You must m\n-000108c0: 616b 6520 7375 7265 2074 6861 7420 7468  ake sure that th\n-000108d0: 6579 2c20 746f 6f2c 2072 6563 6569 7665  ey, too, receive\n-000108e0: 206f 7220 6361 6e20 6765 7420 7468 650a   or can get the.\n-000108f0: 736f 7572 6365 2063 6f64 652e 2020 416e  source code.  An\n-00010900: 6420 796f 7520 6d75 7374 2073 686f 7720  d you must show \n-00010910: 7468 656d 2074 6865 7365 2074 6572 6d73  them these terms\n-00010920: 2073 6f20 7468 6579 206b 6e6f 7720 7468   so they know th\n-00010930: 6569 720a 7269 6768 7473 2e0a 0a20 2020  eir.rights...   \n-00010940: 5765 2070 726f 7465 6374 2079 6f75 7220  We protect your \n-00010950: 7269 6768 7473 2077 6974 6820 7477 6f20  rights with two \n-00010960: 7374 6570 733a 2028 3129 2063 6f70 7972  steps: (1) copyr\n-00010970: 6967 6874 2074 6865 2073 6f66 7477 6172  ight the softwar\n-00010980: 652c 0a61 6e64 2028 3229 206f 6666 6572  e,.and (2) offer\n-00010990: 2079 6f75 2074 6869 7320 6c69 6365 6e73   you this licens\n-000109a0: 6520 7768 6963 6820 6769 7665 7320 796f  e which gives yo\n-000109b0: 7520 6c65 6761 6c20 7065 726d 6973 7369  u legal permissi\n-000109c0: 6f6e 2074 6f20 636f 7079 2c0a 6469 7374  on to copy,.dist\n-000109d0: 7269 6275 7465 2061 6e64 2f6f 7220 6d6f  ribute and/or mo\n-000109e0: 6469 6679 2074 6865 2073 6f66 7477 6172  dify the softwar\n-000109f0: 652e 0a0a 2020 2041 6c73 6f2c 2066 6f72  e...   Also, for\n-00010a00: 2065 6163 6820 6175 7468 6f72 2773 2070   each author's p\n-00010a10: 726f 7465 6374 696f 6e20 616e 6420 6f75  rotection and ou\n-00010a20: 7273 2c20 7765 2077 616e 7420 746f 206d  rs, we want to m\n-00010a30: 616b 6520 6365 7274 6169 6e0a 7468 6174  ake certain.that\n-00010a40: 2065 7665 7279 6f6e 6520 756e 6465 7273   everyone unders\n-00010a50: 7461 6e64 7320 7468 6174 2074 6865 7265  tands that there\n-00010a60: 2069 7320 6e6f 2077 6172 7261 6e74 7920   is no warranty \n-00010a70: 666f 7220 7468 6973 2066 7265 650a 736f  for this free.so\n-00010a80: 6674 7761 7265 2e20 2049 6620 7468 6520  ftware.  If the \n-00010a90: 736f 6674 7761 7265 2069 7320 6d6f 6469  software is modi\n-00010aa0: 6669 6564 2062 7920 736f 6d65 6f6e 6520  fied by someone \n-00010ab0: 656c 7365 2061 6e64 2070 6173 7365 6420  else and passed \n-00010ac0: 6f6e 2c20 7765 0a77 616e 7420 6974 7320  on, we.want its \n-00010ad0: 7265 6369 7069 656e 7473 2074 6f20 6b6e  recipients to kn\n-00010ae0: 6f77 2074 6861 7420 7768 6174 2074 6865  ow that what the\n-00010af0: 7920 6861 7665 2069 7320 6e6f 7420 7468  y have is not th\n-00010b00: 6520 6f72 6967 696e 616c 2c20 736f 0a74  e original, so.t\n-00010b10: 6861 7420 616e 7920 7072 6f62 6c65 6d73  hat any problems\n-00010b20: 2069 6e74 726f 6475 6365 6420 6279 206f   introduced by o\n-00010b30: 7468 6572 7320 7769 6c6c 206e 6f74 2072  thers will not r\n-00010b40: 6566 6c65 6374 206f 6e20 7468 6520 6f72  eflect on the or\n-00010b50: 6967 696e 616c 0a61 7574 686f 7273 2720  iginal.authors' \n-00010b60: 7265 7075 7461 7469 6f6e 732e 0a0a 2020  reputations...  \n-00010b70: 2046 696e 616c 6c79 2c20 616e 7920 6672   Finally, any fr\n-00010b80: 6565 2070 726f 6772 616d 2069 7320 7468  ee program is th\n-00010b90: 7265 6174 656e 6564 2063 6f6e 7374 616e  reatened constan\n-00010ba0: 746c 7920 6279 2073 6f66 7477 6172 650a  tly by software.\n-00010bb0: 7061 7465 6e74 732e 2020 5765 2077 6973  patents.  We wis\n-00010bc0: 6820 746f 2061 766f 6964 2074 6865 2064  h to avoid the d\n-00010bd0: 616e 6765 7220 7468 6174 2072 6564 6973  anger that redis\n-00010be0: 7472 6962 7574 6f72 7320 6f66 2061 2066  tributors of a f\n-00010bf0: 7265 650a 7072 6f67 7261 6d20 7769 6c6c  ree.program will\n-00010c00: 2069 6e64 6976 6964 7561 6c6c 7920 6f62   individually ob\n-00010c10: 7461 696e 2070 6174 656e 7420 6c69 6365  tain patent lice\n-00010c20: 6e73 6573 2c20 696e 2065 6666 6563 7420  nses, in effect \n-00010c30: 6d61 6b69 6e67 2074 6865 0a70 726f 6772  making the.progr\n-00010c40: 616d 2070 726f 7072 6965 7461 7279 2e20  am proprietary. \n-00010c50: 2054 6f20 7072 6576 656e 7420 7468 6973   To prevent this\n-00010c60: 2c20 7765 2068 6176 6520 6d61 6465 2069  , we have made i\n-00010c70: 7420 636c 6561 7220 7468 6174 2061 6e79  t clear that any\n-00010c80: 0a70 6174 656e 7420 6d75 7374 2062 6520  .patent must be \n-00010c90: 6c69 6365 6e73 6564 2066 6f72 2065 7665  licensed for eve\n-00010ca0: 7279 6f6e 6527 7320 6672 6565 2075 7365  ryone's free use\n-00010cb0: 206f 7220 6e6f 7420 6c69 6365 6e73 6564   or not licensed\n-00010cc0: 2061 7420 616c 6c2e 0a0a 2020 2054 6865   at all...   The\n-00010cd0: 2070 7265 6369 7365 2074 6572 6d73 2061   precise terms a\n-00010ce0: 6e64 2063 6f6e 6469 7469 6f6e 7320 666f  nd conditions fo\n-00010cf0: 7220 636f 7079 696e 672c 2064 6973 7472  r copying, distr\n-00010d00: 6962 7574 696f 6e20 616e 640a 6d6f 6469  ibution and.modi\n-00010d10: 6669 6361 7469 6f6e 2066 6f6c 6c6f 772e  fication follow.\n-00010d20: 0a0a 2020 2020 2020 2020 2020 2020 2020  ..              \n-00010d30: 2020 2020 2020 474e 5520 4745 4e45 5241        GNU GENERA\n-00010d40: 4c20 5055 424c 4943 204c 4943 454e 5345  L PUBLIC LICENSE\n-00010d50: 2076 322b 0a20 2020 2054 4552 4d53 2041   v2+.    TERMS A\n-00010d60: 4e44 2043 4f4e 4449 5449 4f4e 5320 464f  ND CONDITIONS FO\n-00010d70: 5220 434f 5059 494e 472c 2044 4953 5452  R COPYING, DISTR\n-00010d80: 4942 5554 494f 4e20 414e 4420 4d4f 4449  IBUTION AND MODI\n-00010d90: 4649 4341 5449 4f4e 0a0a 2020 302e 2054  FICATION..  0. T\n-00010da0: 6869 7320 4c69 6365 6e73 6520 6170 706c  his License appl\n-00010db0: 6965 7320 746f 2061 6e79 2070 726f 6772  ies to any progr\n-00010dc0: 616d 206f 7220 6f74 6865 7220 776f 726b  am or other work\n-00010dd0: 2077 6869 6368 2063 6f6e 7461 696e 7320   which contains \n-00010de0: 610a 2020 2020 206e 6f74 6963 6520 706c  a.     notice pl\n-00010df0: 6163 6564 2062 7920 7468 6520 636f 7079  aced by the copy\n-00010e00: 7269 6768 7420 686f 6c64 6572 2073 6179  right holder say\n-00010e10: 696e 6720 6974 206d 6179 2062 6520 6469  ing it may be di\n-00010e20: 7374 7269 6275 7465 640a 2020 2020 2075  stributed.     u\n-00010e30: 6e64 6572 2074 6865 2074 6572 6d73 206f  nder the terms o\n-00010e40: 6620 7468 6973 2047 656e 6572 616c 2050  f this General P\n-00010e50: 7562 6c69 6320 4c69 6365 6e73 652e 2020  ublic License.  \n-00010e60: 5468 6520 2250 726f 6772 616d 222c 0a20  The \"Program\",. \n-00010e70: 2020 2020 6265 6c6f 772c 2072 6566 6572      below, refer\n-00010e80: 7320 746f 2061 6e79 2073 7563 6820 7072  s to any such pr\n-00010e90: 6f67 7261 6d20 6f72 2077 6f72 6b2c 2061  ogram or work, a\n-00010ea0: 6e64 2061 2022 776f 726b 2062 6173 6564  nd a \"work based\n-00010eb0: 206f 6e20 7468 650a 2020 2020 2050 726f   on the.     Pro\n-00010ec0: 6772 616d 2220 6d65 616e 7320 6569 7468  gram\" means eith\n-00010ed0: 6572 2074 6865 2050 726f 6772 616d 206f  er the Program o\n-00010ee0: 7220 616e 7920 6465 7269 7661 7469 7665  r any derivative\n-00010ef0: 2077 6f72 6b20 756e 6465 720a 2020 2020   work under.    \n-00010f00: 2063 6f70 7972 6967 6874 206c 6177 3a20   copyright law: \n-00010f10: 7468 6174 2069 7320 746f 2073 6179 2c20  that is to say, \n-00010f20: 6120 776f 726b 2063 6f6e 7461 696e 696e  a work containin\n-00010f30: 6720 7468 6520 5072 6f67 7261 6d20 6f72  g the Program or\n-00010f40: 2061 0a20 2020 2020 706f 7274 696f 6e20   a.     portion \n-00010f50: 6f66 2069 742c 2065 6974 6865 7220 7665  of it, either ve\n-00010f60: 7262 6174 696d 206f 7220 7769 7468 206d  rbatim or with m\n-00010f70: 6f64 6966 6963 6174 696f 6e73 2061 6e64  odifications and\n-00010f80: 2f6f 720a 2020 2020 2074 7261 6e73 6c61  /or.     transla\n-00010f90: 7465 6420 696e 746f 2061 6e6f 7468 6572  ted into another\n-00010fa0: 206c 616e 6775 6167 652e 2020 2848 6572   language.  (Her\n-00010fb0: 6569 6e61 6674 6572 2c20 7472 616e 736c  einafter, transl\n-00010fc0: 6174 696f 6e20 6973 0a20 2020 2020 696e  ation is.     in\n-00010fd0: 636c 7564 6564 2077 6974 686f 7574 206c  cluded without l\n-00010fe0: 696d 6974 6174 696f 6e20 696e 2074 6865  imitation in the\n-00010ff0: 2074 6572 6d20 226d 6f64 6966 6963 6174   term \"modificat\n-00011000: 696f 6e22 2e29 2020 4561 6368 0a20 2020  ion\".)  Each.   \n-00011010: 2020 6c69 6365 6e73 6565 2069 7320 6164    licensee is ad\n-00011020: 6472 6573 7365 6420 6173 2022 796f 7522  dressed as \"you\"\n-00011030: 2e0a 0a20 2020 2020 4163 7469 7669 7469  ...     Activiti\n-00011040: 6573 206f 7468 6572 2074 6861 6e20 636f  es other than co\n-00011050: 7079 696e 672c 2064 6973 7472 6962 7574  pying, distribut\n-00011060: 696f 6e20 616e 6420 6d6f 6469 6669 6361  ion and modifica\n-00011070: 7469 6f6e 2061 7265 0a20 2020 2020 6e6f  tion are.     no\n-00011080: 7420 636f 7665 7265 6420 6279 2074 6869  t covered by thi\n-00011090: 7320 4c69 6365 6e73 653b 2074 6865 7920  s License; they \n-000110a0: 6172 6520 6f75 7473 6964 6520 6974 7320  are outside its \n-000110b0: 7363 6f70 652e 2020 5468 6520 6163 740a  scope.  The act.\n-000110c0: 2020 2020 206f 6620 7275 6e6e 696e 6720       of running \n-000110d0: 7468 6520 5072 6f67 7261 6d20 6973 206e  the Program is n\n-000110e0: 6f74 2072 6573 7472 6963 7465 642c 2061  ot restricted, a\n-000110f0: 6e64 2074 6865 206f 7574 7075 7420 6672  nd the output fr\n-00011100: 6f6d 2074 6865 0a20 2020 2020 5072 6f67  om the.     Prog\n-00011110: 7261 6d20 6973 2063 6f76 6572 6564 206f  ram is covered o\n-00011120: 6e6c 7920 6966 2069 7473 2063 6f6e 7465  nly if its conte\n-00011130: 6e74 7320 636f 6e73 7469 7475 7465 2061  nts constitute a\n-00011140: 2077 6f72 6b20 6261 7365 6420 6f6e 0a20   work based on. \n-00011150: 2020 2020 7468 6520 5072 6f67 7261 6d20      the Program \n-00011160: 2869 6e64 6570 656e 6465 6e74 206f 6620  (independent of \n-00011170: 6861 7669 6e67 2062 6565 6e20 6d61 6465  having been made\n-00011180: 2062 7920 7275 6e6e 696e 6720 7468 650a   by running the.\n-00011190: 2020 2020 2050 726f 6772 616d 292e 2020       Program).  \n-000111a0: 5768 6574 6865 7220 7468 6174 2069 7320  Whether that is \n-000111b0: 7472 7565 2064 6570 656e 6473 206f 6e20  true depends on \n-000111c0: 7768 6174 2074 6865 2050 726f 6772 616d  what the Program\n-000111d0: 2064 6f65 732e 0a0a 2020 312e 2059 6f75   does...  1. You\n-000111e0: 206d 6179 2063 6f70 7920 616e 6420 6469   may copy and di\n-000111f0: 7374 7269 6275 7465 2076 6572 6261 7469  stribute verbati\n-00011200: 6d20 636f 7069 6573 206f 6620 7468 6520  m copies of the \n-00011210: 5072 6f67 7261 6d27 7320 736f 7572 6365  Program's source\n-00011220: 0a20 2020 2020 636f 6465 2061 7320 796f  .     code as yo\n-00011230: 7520 7265 6365 6976 6520 6974 2c20 696e  u receive it, in\n-00011240: 2061 6e79 206d 6564 6975 6d2c 2070 726f   any medium, pro\n-00011250: 7669 6465 6420 7468 6174 2079 6f75 0a20  vided that you. \n-00011260: 2020 2020 636f 6e73 7069 6375 6f75 736c      conspicuousl\n-00011270: 7920 616e 6420 6170 7072 6f70 7269 6174  y and appropriat\n-00011280: 656c 7920 7075 626c 6973 6820 6f6e 2065  ely publish on e\n-00011290: 6163 6820 636f 7079 2061 6e20 6170 7072  ach copy an appr\n-000112a0: 6f70 7269 6174 650a 2020 2020 2063 6f70  opriate.     cop\n-000112b0: 7972 6967 6874 206e 6f74 6963 6520 616e  yright notice an\n-000112c0: 6420 6469 7363 6c61 696d 6572 206f 6620  d disclaimer of \n-000112d0: 7761 7272 616e 7479 3b20 6b65 6570 2069  warranty; keep i\n-000112e0: 6e74 6163 7420 616c 6c20 7468 650a 2020  ntact all the.  \n-000112f0: 2020 206e 6f74 6963 6573 2074 6861 7420     notices that \n-00011300: 7265 6665 7220 746f 2074 6869 7320 4c69  refer to this Li\n-00011310: 6365 6e73 6520 616e 6420 746f 2074 6865  cense and to the\n-00011320: 2061 6273 656e 6365 206f 6620 616e 790a   absence of any.\n-00011330: 2020 2020 2077 6172 7261 6e74 793b 2061       warranty; a\n-00011340: 6e64 2067 6976 6520 616e 7920 6f74 6865  nd give any othe\n-00011350: 7220 7265 6369 7069 656e 7473 206f 6620  r recipients of \n-00011360: 7468 6520 5072 6f67 7261 6d20 6120 636f  the Program a co\n-00011370: 7079 206f 660a 2020 2020 2074 6869 7320  py of.     this \n-00011380: 4c69 6365 6e73 6520 616c 6f6e 6720 7769  License along wi\n-00011390: 7468 2074 6865 2050 726f 6772 616d 2e0a  th the Program..\n-000113a0: 0a20 2020 2020 596f 7520 6d61 7920 6368  .     You may ch\n-000113b0: 6172 6765 2061 2066 6565 2066 6f72 2074  arge a fee for t\n-000113c0: 6865 2070 6879 7369 6361 6c20 6163 7420  he physical act \n-000113d0: 6f66 2074 7261 6e73 6665 7272 696e 6720  of transferring \n-000113e0: 6120 636f 7079 2c0a 2020 2020 2061 6e64  a copy,.     and\n-000113f0: 2079 6f75 206d 6179 2061 7420 796f 7572   you may at your\n-00011400: 206f 7074 696f 6e20 6f66 6665 7220 7761   option offer wa\n-00011410: 7272 616e 7479 2070 726f 7465 6374 696f  rranty protectio\n-00011420: 6e20 696e 2065 7863 6861 6e67 650a 2020  n in exchange.  \n-00011430: 2020 2066 6f72 2061 2066 6565 2e0a 0a20     for a fee... \n-00011440: 2032 2e20 596f 7520 6d61 7920 6d6f 6469   2. You may modi\n-00011450: 6679 2079 6f75 7220 636f 7079 206f 7220  fy your copy or \n-00011460: 636f 7069 6573 206f 6620 7468 6520 5072  copies of the Pr\n-00011470: 6f67 7261 6d20 6f72 2061 6e79 2070 6f72  ogram or any por\n-00011480: 7469 6f6e 206f 660a 2020 2020 2069 742c  tion of.     it,\n-00011490: 2074 6875 7320 666f 726d 696e 6720 6120   thus forming a \n-000114a0: 776f 726b 2062 6173 6564 206f 6e20 7468  work based on th\n-000114b0: 6520 5072 6f67 7261 6d2c 2061 6e64 2063  e Program, and c\n-000114c0: 6f70 7920 616e 640a 2020 2020 2064 6973  opy and.     dis\n-000114d0: 7472 6962 7574 6520 7375 6368 206d 6f64  tribute such mod\n-000114e0: 6966 6963 6174 696f 6e73 206f 7220 776f  ifications or wo\n-000114f0: 726b 2075 6e64 6572 2074 6865 2074 6572  rk under the ter\n-00011500: 6d73 206f 6620 5365 6374 696f 6e20 310a  ms of Section 1.\n-00011510: 2020 2020 2061 626f 7665 2c20 7072 6f76       above, prov\n-00011520: 6964 6564 2074 6861 7420 796f 7520 616c  ided that you al\n-00011530: 736f 206d 6565 7420 616c 6c20 6f66 2074  so meet all of t\n-00011540: 6865 7365 2063 6f6e 6469 7469 6f6e 733a  hese conditions:\n-00011550: 0a0a 2020 2020 2020 2061 2e20 596f 7520  ..       a. You \n-00011560: 6d75 7374 2063 6175 7365 2074 6865 206d  must cause the m\n-00011570: 6f64 6966 6965 6420 6669 6c65 7320 746f  odified files to\n-00011580: 2063 6172 7279 2070 726f 6d69 6e65 6e74   carry prominent\n-00011590: 206e 6f74 6963 6573 0a20 2020 2020 2020   notices.       \n-000115a0: 2020 2073 7461 7469 6e67 2074 6861 7420     stating that \n-000115b0: 796f 7520 6368 616e 6765 6420 7468 6520  you changed the \n-000115c0: 6669 6c65 7320 616e 6420 7468 6520 6461  files and the da\n-000115d0: 7465 206f 6620 616e 7920 6368 616e 6765  te of any change\n-000115e0: 2e0a 0a20 2020 2020 2020 622e 2059 6f75  ...       b. You\n-000115f0: 206d 7573 7420 6361 7573 6520 616e 7920   must cause any \n-00011600: 776f 726b 2074 6861 7420 796f 7520 6469  work that you di\n-00011610: 7374 7269 6275 7465 206f 7220 7075 626c  stribute or publ\n-00011620: 6973 682c 2074 6861 740a 2020 2020 2020  ish, that.      \n-00011630: 2020 2020 696e 2077 686f 6c65 206f 7220      in whole or \n-00011640: 696e 2070 6172 7420 636f 6e74 6169 6e73  in part contains\n-00011650: 206f 7220 6973 2064 6572 6976 6564 2066   or is derived f\n-00011660: 726f 6d20 7468 6520 5072 6f67 7261 6d20  rom the Program \n-00011670: 6f72 0a20 2020 2020 2020 2020 2061 6e79  or.          any\n-00011680: 2070 6172 7420 7468 6572 656f 662c 2074   part thereof, t\n-00011690: 6f20 6265 206c 6963 656e 7365 6420 6173  o be licensed as\n-000116a0: 2061 2077 686f 6c65 2061 7420 6e6f 2063   a whole at no c\n-000116b0: 6861 7267 6520 746f 0a20 2020 2020 2020  harge to.       \n-000116c0: 2020 2061 6c6c 2074 6869 7264 2070 6172     all third par\n-000116d0: 7469 6573 2075 6e64 6572 2074 6865 2074  ties under the t\n-000116e0: 6572 6d73 206f 6620 7468 6973 204c 6963  erms of this Lic\n-000116f0: 656e 7365 2e0a 0a20 2020 2020 2020 632e  ense...       c.\n-00011700: 2049 6620 7468 6520 6d6f 6469 6669 6564   If the modified\n-00011710: 2070 726f 6772 616d 206e 6f72 6d61 6c6c   program normall\n-00011720: 7920 7265 6164 7320 636f 6d6d 616e 6473  y reads commands\n-00011730: 2069 6e74 6572 6163 7469 7665 6c79 0a20   interactively. \n-00011740: 2020 2020 2020 2020 2077 6865 6e20 7275           when ru\n-00011750: 6e2c 2079 6f75 206d 7573 7420 6361 7573  n, you must caus\n-00011760: 6520 6974 2c20 7768 656e 2073 7461 7274  e it, when start\n-00011770: 6564 2072 756e 6e69 6e67 2066 6f72 2073  ed running for s\n-00011780: 7563 680a 2020 2020 2020 2020 2020 696e  uch.          in\n-00011790: 7465 7261 6374 6976 6520 7573 6520 696e  teractive use in\n-000117a0: 2074 6865 206d 6f73 7420 6f72 6469 6e61   the most ordina\n-000117b0: 7279 2077 6179 2c20 746f 2070 7269 6e74  ry way, to print\n-000117c0: 206f 7220 6469 7370 6c61 790a 2020 2020   or display.    \n-000117d0: 2020 2020 2020 616e 2061 6e6e 6f75 6e63        an announc\n-000117e0: 656d 656e 7420 696e 636c 7564 696e 6720  ement including \n-000117f0: 616e 2061 7070 726f 7072 6961 7465 2063  an appropriate c\n-00011800: 6f70 7972 6967 6874 206e 6f74 6963 6520  opyright notice \n-00011810: 616e 640a 2020 2020 2020 2020 2020 6120  and.          a \n-00011820: 6e6f 7469 6365 2074 6861 7420 7468 6572  notice that ther\n-00011830: 6520 6973 206e 6f20 7761 7272 616e 7479  e is no warranty\n-00011840: 2028 6f72 2065 6c73 652c 2073 6179 696e   (or else, sayin\n-00011850: 6720 7468 6174 2079 6f75 0a20 2020 2020  g that you.     \n-00011860: 2020 2020 2070 726f 7669 6465 2061 2077       provide a w\n-00011870: 6172 7261 6e74 7929 2061 6e64 2074 6861  arranty) and tha\n-00011880: 7420 7573 6572 7320 6d61 7920 7265 6469  t users may redi\n-00011890: 7374 7269 6275 7465 2074 6865 0a20 2020  stribute the.   \n-000118a0: 2020 2020 2020 2070 726f 6772 616d 2075         program u\n-000118b0: 6e64 6572 2074 6865 7365 2063 6f6e 6469  nder these condi\n-000118c0: 7469 6f6e 732c 2061 6e64 2074 656c 6c69  tions, and telli\n-000118d0: 6e67 2074 6865 2075 7365 7220 686f 7720  ng the user how \n-000118e0: 746f 0a20 2020 2020 2020 2020 2076 6965  to.          vie\n-000118f0: 7720 6120 636f 7079 206f 6620 7468 6973  w a copy of this\n-00011900: 204c 6963 656e 7365 2e20 2028 4578 6365   License.  (Exce\n-00011910: 7074 696f 6e3a 2069 6620 7468 6520 5072  ption: if the Pr\n-00011920: 6f67 7261 6d0a 2020 2020 2020 2020 2020  ogram.          \n-00011930: 6974 7365 6c66 2069 7320 696e 7465 7261  itself is intera\n-00011940: 6374 6976 6520 6275 7420 646f 6573 206e  ctive but does n\n-00011950: 6f74 206e 6f72 6d61 6c6c 7920 7072 696e  ot normally prin\n-00011960: 7420 7375 6368 2061 6e0a 2020 2020 2020  t such an.      \n-00011970: 2020 2020 616e 6e6f 756e 6365 6d65 6e74      announcement\n-00011980: 2c20 796f 7572 2077 6f72 6b20 6261 7365  , your work base\n-00011990: 6420 6f6e 2074 6865 2050 726f 6772 616d  d on the Program\n-000119a0: 2069 7320 6e6f 7420 7265 7175 6972 6564   is not required\n-000119b0: 0a20 2020 2020 2020 2020 2074 6f20 7072  .          to pr\n-000119c0: 696e 7420 616e 2061 6e6e 6f75 6e63 656d  int an announcem\n-000119d0: 656e 742e 290a 0a20 2020 2020 5468 6573  ent.)..     Thes\n-000119e0: 6520 7265 7175 6972 656d 656e 7473 2061  e requirements a\n-000119f0: 7070 6c79 2074 6f20 7468 6520 6d6f 6469  pply to the modi\n-00011a00: 6669 6564 2077 6f72 6b20 6173 2061 2077  fied work as a w\n-00011a10: 686f 6c65 2e20 2049 660a 2020 2020 2069  hole.  If.     i\n-00011a20: 6465 6e74 6966 6961 626c 6520 7365 6374  dentifiable sect\n-00011a30: 696f 6e73 206f 6620 7468 6174 2077 6f72  ions of that wor\n-00011a40: 6b20 6172 6520 6e6f 7420 6465 7269 7665  k are not derive\n-00011a50: 6420 6672 6f6d 2074 6865 0a20 2020 2020  d from the.     \n-00011a60: 5072 6f67 7261 6d2c 2061 6e64 2063 616e  Program, and can\n-00011a70: 2062 6520 7265 6173 6f6e 6162 6c79 2063   be reasonably c\n-00011a80: 6f6e 7369 6465 7265 6420 696e 6465 7065  onsidered indepe\n-00011a90: 6e64 656e 7420 616e 6420 7365 7061 7261  ndent and separa\n-00011aa0: 7465 0a20 2020 2020 776f 726b 7320 696e  te.     works in\n-00011ab0: 2074 6865 6d73 656c 7665 732c 2074 6865   themselves, the\n-00011ac0: 6e20 7468 6973 204c 6963 656e 7365 2c20  n this License, \n-00011ad0: 616e 6420 6974 7320 7465 726d 732c 2064  and its terms, d\n-00011ae0: 6f20 6e6f 7420 6170 706c 790a 2020 2020  o not apply.    \n-00011af0: 2074 6f20 7468 6f73 6520 7365 6374 696f   to those sectio\n-00011b00: 6e73 2077 6865 6e20 796f 7520 6469 7374  ns when you dist\n-00011b10: 7269 6275 7465 2074 6865 6d20 6173 2073  ribute them as s\n-00011b20: 6570 6172 6174 6520 776f 726b 732e 2020  eparate works.  \n-00011b30: 4275 740a 2020 2020 2077 6865 6e20 796f  But.     when yo\n-00011b40: 7520 6469 7374 7269 6275 7465 2074 6865  u distribute the\n-00011b50: 2073 616d 6520 7365 6374 696f 6e73 2061   same sections a\n-00011b60: 7320 7061 7274 206f 6620 6120 7768 6f6c  s part of a whol\n-00011b70: 6520 7768 6963 6820 6973 2061 0a20 2020  e which is a.   \n-00011b80: 2020 776f 726b 2062 6173 6564 206f 6e20    work based on \n-00011b90: 7468 6520 5072 6f67 7261 6d2c 2074 6865  the Program, the\n-00011ba0: 2064 6973 7472 6962 7574 696f 6e20 6f66   distribution of\n-00011bb0: 2074 6865 2077 686f 6c65 206d 7573 7420   the whole must \n-00011bc0: 6265 206f 6e0a 2020 2020 2074 6865 2074  be on.     the t\n-00011bd0: 6572 6d73 206f 6620 7468 6973 204c 6963  erms of this Lic\n-00011be0: 656e 7365 2c20 7768 6f73 6520 7065 726d  ense, whose perm\n-00011bf0: 6973 7369 6f6e 7320 666f 7220 6f74 6865  issions for othe\n-00011c00: 7220 6c69 6365 6e73 6565 730a 2020 2020  r licensees.    \n-00011c10: 2065 7874 656e 6420 746f 2074 6865 2065   extend to the e\n-00011c20: 6e74 6972 6520 7768 6f6c 652c 2061 6e64  ntire whole, and\n-00011c30: 2074 6875 7320 746f 2065 6163 6820 616e   thus to each an\n-00011c40: 6420 6576 6572 7920 7061 7274 0a20 2020  d every part.   \n-00011c50: 2020 7265 6761 7264 6c65 7373 206f 6620    regardless of \n-00011c60: 7768 6f20 7772 6f74 6520 6974 2e0a 0a20  who wrote it... \n-00011c70: 2020 2020 5468 7573 2c20 6974 2069 7320      Thus, it is \n-00011c80: 6e6f 7420 7468 6520 696e 7465 6e74 206f  not the intent o\n-00011c90: 6620 7468 6973 2073 6563 7469 6f6e 2074  f this section t\n-00011ca0: 6f20 636c 6169 6d20 7269 6768 7473 206f  o claim rights o\n-00011cb0: 720a 2020 2020 2063 6f6e 7465 7374 2079  r.     contest y\n-00011cc0: 6f75 7220 7269 6768 7473 2074 6f20 776f  our rights to wo\n-00011cd0: 726b 2077 7269 7474 656e 2065 6e74 6972  rk written entir\n-00011ce0: 656c 7920 6279 2079 6f75 3b20 7261 7468  ely by you; rath\n-00011cf0: 6572 2c20 7468 650a 2020 2020 2069 6e74  er, the.     int\n-00011d00: 656e 7420 6973 2074 6f20 6578 6572 6369  ent is to exerci\n-00011d10: 7365 2074 6865 2072 6967 6874 2074 6f20  se the right to \n-00011d20: 636f 6e74 726f 6c20 7468 6520 6469 7374  control the dist\n-00011d30: 7269 6275 7469 6f6e 206f 660a 2020 2020  ribution of.    \n-00011d40: 2064 6572 6976 6174 6976 6520 6f72 2063   derivative or c\n-00011d50: 6f6c 6c65 6374 6976 6520 776f 726b 7320  ollective works \n-00011d60: 6261 7365 6420 6f6e 2074 6865 2050 726f  based on the Pro\n-00011d70: 6772 616d 2e0a 0a20 2020 2020 496e 2061  gram...     In a\n-00011d80: 6464 6974 696f 6e2c 206d 6572 6520 6167  ddition, mere ag\n-00011d90: 6772 6567 6174 696f 6e20 6f66 2061 6e6f  gregation of ano\n-00011da0: 7468 6572 2077 6f72 6b20 6e6f 7420 6261  ther work not ba\n-00011db0: 7365 6420 6f6e 2074 6865 0a20 2020 2020  sed on the.     \n-00011dc0: 5072 6f67 7261 6d20 7769 7468 2074 6865  Program with the\n-00011dd0: 2050 726f 6772 616d 2028 6f72 2077 6974   Program (or wit\n-00011de0: 6820 6120 776f 726b 2062 6173 6564 206f  h a work based o\n-00011df0: 6e20 7468 6520 5072 6f67 7261 6d29 206f  n the Program) o\n-00011e00: 6e20 610a 2020 2020 2076 6f6c 756d 6520  n a.     volume \n-00011e10: 6f66 2061 2073 746f 7261 6765 206f 7220  of a storage or \n-00011e20: 6469 7374 7269 6275 7469 6f6e 206d 6564  distribution med\n-00011e30: 6975 6d20 646f 6573 206e 6f74 2062 7269  ium does not bri\n-00011e40: 6e67 2074 6865 206f 7468 6572 0a20 2020  ng the other.   \n-00011e50: 2020 776f 726b 2075 6e64 6572 2074 6865    work under the\n-00011e60: 2073 636f 7065 206f 6620 7468 6973 204c   scope of this L\n-00011e70: 6963 656e 7365 2e0a 0a20 2033 2e20 596f  icense...  3. Yo\n-00011e80: 7520 6d61 7920 636f 7079 2061 6e64 2064  u may copy and d\n-00011e90: 6973 7472 6962 7574 6520 7468 6520 5072  istribute the Pr\n-00011ea0: 6f67 7261 6d20 286f 7220 6120 776f 726b  ogram (or a work\n-00011eb0: 2062 6173 6564 206f 6e20 6974 2c0a 2020   based on it,.  \n-00011ec0: 2020 2075 6e64 6572 2053 6563 7469 6f6e     under Section\n-00011ed0: 2032 2920 696e 206f 626a 6563 7420 636f   2) in object co\n-00011ee0: 6465 206f 7220 6578 6563 7574 6162 6c65  de or executable\n-00011ef0: 2066 6f72 6d20 756e 6465 7220 7468 6520   form under the \n-00011f00: 7465 726d 730a 2020 2020 206f 6620 5365  terms.     of Se\n-00011f10: 6374 696f 6e73 2031 2061 6e64 2032 2061  ctions 1 and 2 a\n-00011f20: 626f 7665 2070 726f 7669 6465 6420 7468  bove provided th\n-00011f30: 6174 2079 6f75 2061 6c73 6f20 646f 206f  at you also do o\n-00011f40: 6e65 206f 6620 7468 650a 2020 2020 2066  ne of the.     f\n-00011f50: 6f6c 6c6f 7769 6e67 3a0a 0a20 2020 2020  ollowing:..     \n-00011f60: 2020 612e 2041 6363 6f6d 7061 6e79 2069    a. Accompany i\n-00011f70: 7420 7769 7468 2074 6865 2063 6f6d 706c  t with the compl\n-00011f80: 6574 6520 636f 7272 6573 706f 6e64 696e  ete correspondin\n-00011f90: 6720 6d61 6368 696e 652d 7265 6164 6162  g machine-readab\n-00011fa0: 6c65 0a20 2020 2020 2020 2020 2073 6f75  le.          sou\n-00011fb0: 7263 6520 636f 6465 2c20 7768 6963 6820  rce code, which \n-00011fc0: 6d75 7374 2062 6520 6469 7374 7269 6275  must be distribu\n-00011fd0: 7465 6420 756e 6465 7220 7468 6520 7465  ted under the te\n-00011fe0: 726d 7320 6f66 0a20 2020 2020 2020 2020  rms of.         \n-00011ff0: 2053 6563 7469 6f6e 7320 3120 616e 6420   Sections 1 and \n-00012000: 3220 6162 6f76 6520 6f6e 2061 206d 6564  2 above on a med\n-00012010: 6975 6d20 6375 7374 6f6d 6172 696c 7920  ium customarily \n-00012020: 7573 6564 2066 6f72 0a20 2020 2020 2020  used for.       \n-00012030: 2020 2073 6f66 7477 6172 6520 696e 7465     software inte\n-00012040: 7263 6861 6e67 653b 206f 722c 0a0a 2020  rchange; or,..  \n-00012050: 2020 2020 2062 2e20 4163 636f 6d70 616e       b. Accompan\n-00012060: 7920 6974 2077 6974 6820 6120 7772 6974  y it with a writ\n-00012070: 7465 6e20 6f66 6665 722c 2076 616c 6964  ten offer, valid\n-00012080: 2066 6f72 2061 7420 6c65 6173 7420 7468   for at least th\n-00012090: 7265 650a 2020 2020 2020 2020 2020 7965  ree.          ye\n-000120a0: 6172 732c 2074 6f20 6769 7665 2061 6e79  ars, to give any\n-000120b0: 2074 6869 7264 2070 6172 7479 2c20 666f   third party, fo\n-000120c0: 7220 6120 6368 6172 6765 206e 6f20 6d6f  r a charge no mo\n-000120d0: 7265 2074 6861 6e20 796f 7572 0a20 2020  re than your.   \n-000120e0: 2020 2020 2020 2063 6f73 7420 6f66 2070         cost of p\n-000120f0: 6879 7369 6361 6c6c 7920 7065 7266 6f72  hysically perfor\n-00012100: 6d69 6e67 2073 6f75 7263 6520 6469 7374  ming source dist\n-00012110: 7269 6275 7469 6f6e 2c20 6120 636f 6d70  ribution, a comp\n-00012120: 6c65 7465 0a20 2020 2020 2020 2020 206d  lete.          m\n-00012130: 6163 6869 6e65 2d72 6561 6461 626c 6520  achine-readable \n-00012140: 636f 7079 206f 6620 7468 6520 636f 7272  copy of the corr\n-00012150: 6573 706f 6e64 696e 6720 736f 7572 6365  esponding source\n-00012160: 2063 6f64 652c 2074 6f20 6265 0a20 2020   code, to be.   \n-00012170: 2020 2020 2020 2064 6973 7472 6962 7574         distribut\n-00012180: 6564 2075 6e64 6572 2074 6865 2074 6572  ed under the ter\n-00012190: 6d73 206f 6620 5365 6374 696f 6e73 2031  ms of Sections 1\n-000121a0: 2061 6e64 2032 2061 626f 7665 206f 6e20   and 2 above on \n-000121b0: 610a 2020 2020 2020 2020 2020 6d65 6469  a.          medi\n-000121c0: 756d 2063 7573 746f 6d61 7269 6c79 2075  um customarily u\n-000121d0: 7365 6420 666f 7220 736f 6674 7761 7265  sed for software\n-000121e0: 2069 6e74 6572 6368 616e 6765 3b20 6f72   interchange; or\n-000121f0: 2c0a 0a20 2020 2020 2020 632e 2041 6363  ,..       c. Acc\n-00012200: 6f6d 7061 6e79 2069 7420 7769 7468 2074  ompany it with t\n-00012210: 6865 2069 6e66 6f72 6d61 7469 6f6e 2079  he information y\n-00012220: 6f75 2072 6563 6569 7665 6420 6173 2074  ou received as t\n-00012230: 6f20 7468 6520 6f66 6665 720a 2020 2020  o the offer.    \n-00012240: 2020 2020 2020 746f 2064 6973 7472 6962        to distrib\n-00012250: 7574 6520 636f 7272 6573 706f 6e64 696e  ute correspondin\n-00012260: 6720 736f 7572 6365 2063 6f64 652e 2020  g source code.  \n-00012270: 2854 6869 7320 616c 7465 726e 6174 6976  (This alternativ\n-00012280: 6520 6973 0a20 2020 2020 2020 2020 2061  e is.          a\n-00012290: 6c6c 6f77 6564 206f 6e6c 7920 666f 7220  llowed only for \n-000122a0: 6e6f 6e63 6f6d 6d65 7263 6961 6c20 6469  noncommercial di\n-000122b0: 7374 7269 6275 7469 6f6e 2061 6e64 206f  stribution and o\n-000122c0: 6e6c 7920 6966 2079 6f75 0a20 2020 2020  nly if you.     \n-000122d0: 2020 2020 2072 6563 6569 7665 6420 7468       received th\n-000122e0: 6520 7072 6f67 7261 6d20 696e 206f 626a  e program in obj\n-000122f0: 6563 7420 636f 6465 206f 7220 6578 6563  ect code or exec\n-00012300: 7574 6162 6c65 2066 6f72 6d20 7769 7468  utable form with\n-00012310: 0a20 2020 2020 2020 2020 2073 7563 6820  .          such \n-00012320: 616e 206f 6666 6572 2c20 696e 2061 6363  an offer, in acc\n-00012330: 6f72 6420 7769 7468 2053 7562 7365 6374  ord with Subsect\n-00012340: 696f 6e20 6220 6162 6f76 652e 290a 0a20  ion b above.).. \n-00012350: 2020 2020 5468 6520 736f 7572 6365 2063      The source c\n-00012360: 6f64 6520 666f 7220 6120 776f 726b 206d  ode for a work m\n-00012370: 6561 6e73 2074 6865 2070 7265 6665 7272  eans the preferr\n-00012380: 6564 2066 6f72 6d20 6f66 2074 6865 2077  ed form of the w\n-00012390: 6f72 6b20 666f 720a 2020 2020 206d 616b  ork for.     mak\n-000123a0: 696e 6720 6d6f 6469 6669 6361 7469 6f6e  ing modification\n-000123b0: 7320 746f 2069 742e 2020 466f 7220 616e  s to it.  For an\n-000123c0: 2065 7865 6375 7461 626c 6520 776f 726b   executable work\n-000123d0: 2c20 636f 6d70 6c65 7465 0a20 2020 2020  , complete.     \n-000123e0: 736f 7572 6365 2063 6f64 6520 6d65 616e  source code mean\n-000123f0: 7320 616c 6c20 7468 6520 736f 7572 6365  s all the source\n-00012400: 2063 6f64 6520 666f 7220 616c 6c20 6d6f   code for all mo\n-00012410: 6475 6c65 7320 6974 2063 6f6e 7461 696e  dules it contain\n-00012420: 732c 0a20 2020 2020 706c 7573 2061 6e79  s,.     plus any\n-00012430: 2061 7373 6f63 6961 7465 6420 696e 7465   associated inte\n-00012440: 7266 6163 6520 6465 6669 6e69 7469 6f6e  rface definition\n-00012450: 2066 696c 6573 2c20 706c 7573 2074 6865   files, plus the\n-00012460: 2073 6372 6970 7473 0a20 2020 2020 7573   scripts.     us\n-00012470: 6564 2074 6f20 636f 6e74 726f 6c20 636f  ed to control co\n-00012480: 6d70 696c 6174 696f 6e20 616e 6420 696e  mpilation and in\n-00012490: 7374 616c 6c61 7469 6f6e 206f 6620 7468  stallation of th\n-000124a0: 6520 6578 6563 7574 6162 6c65 2e0a 2020  e executable..  \n-000124b0: 2020 2048 6f77 6576 6572 2c20 6173 2061     However, as a\n-000124c0: 2073 7065 6369 616c 2065 7863 6570 7469   special excepti\n-000124d0: 6f6e 2c20 7468 6520 736f 7572 6365 2063  on, the source c\n-000124e0: 6f64 6520 6469 7374 7269 6275 7465 6420  ode distributed \n-000124f0: 6e65 6564 0a20 2020 2020 6e6f 7420 696e  need.     not in\n-00012500: 636c 7564 6520 616e 7974 6869 6e67 2074  clude anything t\n-00012510: 6861 7420 6973 206e 6f72 6d61 6c6c 7920  hat is normally \n-00012520: 6469 7374 7269 6275 7465 6420 2869 6e20  distributed (in \n-00012530: 6569 7468 6572 2073 6f75 7263 650a 2020  either source.  \n-00012540: 2020 206f 7220 6269 6e61 7279 2066 6f72     or binary for\n-00012550: 6d29 2077 6974 6820 7468 6520 6d61 6a6f  m) with the majo\n-00012560: 7220 636f 6d70 6f6e 656e 7473 2028 636f  r components (co\n-00012570: 6d70 696c 6572 2c20 6b65 726e 656c 2c20  mpiler, kernel, \n-00012580: 616e 6420 736f 0a20 2020 2020 6f6e 2920  and so.     on) \n-00012590: 6f66 2074 6865 206f 7065 7261 7469 6e67  of the operating\n-000125a0: 2073 7973 7465 6d20 6f6e 2077 6869 6368   system on which\n-000125b0: 2074 6865 2065 7865 6375 7461 626c 6520   the executable \n-000125c0: 7275 6e73 2c20 756e 6c65 7373 0a20 2020  runs, unless.   \n-000125d0: 2020 7468 6174 2063 6f6d 706f 6e65 6e74    that component\n-000125e0: 2069 7473 656c 6620 6163 636f 6d70 616e   itself accompan\n-000125f0: 6965 7320 7468 6520 6578 6563 7574 6162  ies the executab\n-00012600: 6c65 2e0a 0a20 2020 2020 4966 2064 6973  le...     If dis\n-00012610: 7472 6962 7574 696f 6e20 6f66 2065 7865  tribution of exe\n-00012620: 6375 7461 626c 6520 6f72 206f 626a 6563  cutable or objec\n-00012630: 7420 636f 6465 2069 7320 6d61 6465 2062  t code is made b\n-00012640: 7920 6f66 6665 7269 6e67 0a20 2020 2020  y offering.     \n-00012650: 6163 6365 7373 2074 6f20 636f 7079 2066  access to copy f\n-00012660: 726f 6d20 6120 6465 7369 676e 6174 6564  rom a designated\n-00012670: 2070 6c61 6365 2c20 7468 656e 206f 6666   place, then off\n-00012680: 6572 696e 6720 6571 7569 7661 6c65 6e74  ering equivalent\n-00012690: 0a20 2020 2020 6163 6365 7373 2074 6f20  .     access to \n-000126a0: 636f 7079 2074 6865 2073 6f75 7263 6520  copy the source \n-000126b0: 636f 6465 2066 726f 6d20 7468 6520 7361  code from the sa\n-000126c0: 6d65 2070 6c61 6365 2063 6f75 6e74 7320  me place counts \n-000126d0: 6173 0a20 2020 2020 6469 7374 7269 6275  as.     distribu\n-000126e0: 7469 6f6e 206f 6620 7468 6520 736f 7572  tion of the sour\n-000126f0: 6365 2063 6f64 652c 2065 7665 6e20 7468  ce code, even th\n-00012700: 6f75 6768 2074 6869 7264 2070 6172 7469  ough third parti\n-00012710: 6573 2061 7265 206e 6f74 0a20 2020 2020  es are not.     \n-00012720: 636f 6d70 656c 6c65 6420 746f 2063 6f70  compelled to cop\n-00012730: 7920 7468 6520 736f 7572 6365 2061 6c6f  y the source alo\n-00012740: 6e67 2077 6974 6820 7468 6520 6f62 6a65  ng with the obje\n-00012750: 6374 2063 6f64 652e 0a0a 2020 342e 2059  ct code...  4. Y\n-00012760: 6f75 206d 6179 206e 6f74 2063 6f70 792c  ou may not copy,\n-00012770: 206d 6f64 6966 792c 2073 7562 6c69 6365   modify, sublice\n-00012780: 6e73 652c 206f 7220 6469 7374 7269 6275  nse, or distribu\n-00012790: 7465 2074 6865 2050 726f 6772 616d 0a20  te the Program. \n-000127a0: 2020 2020 6578 6365 7074 2061 7320 6578      except as ex\n-000127b0: 7072 6573 736c 7920 7072 6f76 6964 6564  pressly provided\n-000127c0: 2075 6e64 6572 2074 6869 7320 4c69 6365   under this Lice\n-000127d0: 6e73 652e 2020 416e 7920 6174 7465 6d70  nse.  Any attemp\n-000127e0: 740a 2020 2020 206f 7468 6572 7769 7365  t.     otherwise\n-000127f0: 2074 6f20 636f 7079 2c20 6d6f 6469 6679   to copy, modify\n-00012800: 2c20 7375 626c 6963 656e 7365 206f 7220  , sublicense or \n-00012810: 6469 7374 7269 6275 7465 2074 6865 2050  distribute the P\n-00012820: 726f 6772 616d 2069 730a 2020 2020 2076  rogram is.     v\n-00012830: 6f69 642c 2061 6e64 2077 696c 6c20 6175  oid, and will au\n-00012840: 746f 6d61 7469 6361 6c6c 7920 7465 726d  tomatically term\n-00012850: 696e 6174 6520 796f 7572 2072 6967 6874  inate your right\n-00012860: 7320 756e 6465 7220 7468 6973 0a20 2020  s under this.   \n-00012870: 2020 4c69 6365 6e73 652e 2020 486f 7765    License.  Howe\n-00012880: 7665 722c 2070 6172 7469 6573 2077 686f  ver, parties who\n-00012890: 2068 6176 6520 7265 6365 6976 6564 2063   have received c\n-000128a0: 6f70 6965 732c 206f 7220 7269 6768 7473  opies, or rights\n-000128b0: 2c0a 2020 2020 2066 726f 6d20 796f 7520  ,.     from you \n-000128c0: 756e 6465 7220 7468 6973 204c 6963 656e  under this Licen\n-000128d0: 7365 2077 696c 6c20 6e6f 7420 6861 7665  se will not have\n-000128e0: 2074 6865 6972 206c 6963 656e 7365 7320   their licenses \n-000128f0: 7465 726d 696e 6174 6564 0a20 2020 2020  terminated.     \n-00012900: 736f 206c 6f6e 6720 6173 2073 7563 6820  so long as such \n-00012910: 7061 7274 6965 7320 7265 6d61 696e 2069  parties remain i\n-00012920: 6e20 6675 6c6c 2063 6f6d 706c 6961 6e63  n full complianc\n-00012930: 652e 0a0a 2020 352e 2059 6f75 2061 7265  e...  5. You are\n-00012940: 206e 6f74 2072 6571 7569 7265 6420 746f   not required to\n-00012950: 2061 6363 6570 7420 7468 6973 204c 6963   accept this Lic\n-00012960: 656e 7365 2c20 7369 6e63 6520 796f 7520  ense, since you \n-00012970: 6861 7665 206e 6f74 0a20 2020 2020 7369  have not.     si\n-00012980: 676e 6564 2069 742e 2020 486f 7765 7665  gned it.  Howeve\n-00012990: 722c 206e 6f74 6869 6e67 2065 6c73 6520  r, nothing else \n-000129a0: 6772 616e 7473 2079 6f75 2070 6572 6d69  grants you permi\n-000129b0: 7373 696f 6e20 746f 206d 6f64 6966 790a  ssion to modify.\n-000129c0: 2020 2020 206f 7220 6469 7374 7269 6275       or distribu\n-000129d0: 7465 2074 6865 2050 726f 6772 616d 206f  te the Program o\n-000129e0: 7220 6974 7320 6465 7269 7661 7469 7665  r its derivative\n-000129f0: 2077 6f72 6b73 2e20 2054 6865 7365 2061   works.  These a\n-00012a00: 6374 696f 6e73 0a20 2020 2020 6172 6520  ctions.     are \n-00012a10: 7072 6f68 6962 6974 6564 2062 7920 6c61  prohibited by la\n-00012a20: 7720 6966 2079 6f75 2064 6f20 6e6f 7420  w if you do not \n-00012a30: 6163 6365 7074 2074 6869 7320 4c69 6365  accept this Lice\n-00012a40: 6e73 652e 0a20 2020 2020 5468 6572 6566  nse..     Theref\n-00012a50: 6f72 652c 2062 7920 6d6f 6469 6679 696e  ore, by modifyin\n-00012a60: 6720 6f72 2064 6973 7472 6962 7574 696e  g or distributin\n-00012a70: 6720 7468 6520 5072 6f67 7261 6d20 286f  g the Program (o\n-00012a80: 7220 616e 7920 776f 726b 0a20 2020 2020  r any work.     \n-00012a90: 6261 7365 6420 6f6e 2074 6865 2050 726f  based on the Pro\n-00012aa0: 6772 616d 292c 2079 6f75 2069 6e64 6963  gram), you indic\n-00012ab0: 6174 6520 796f 7572 2061 6363 6570 7461  ate your accepta\n-00012ac0: 6e63 6520 6f66 2074 6869 7320 4c69 6365  nce of this Lice\n-00012ad0: 6e73 650a 2020 2020 2074 6f20 646f 2073  nse.     to do s\n-00012ae0: 6f2c 2061 6e64 2061 6c6c 2069 7473 2074  o, and all its t\n-00012af0: 6572 6d73 2061 6e64 2063 6f6e 6469 7469  erms and conditi\n-00012b00: 6f6e 7320 666f 7220 636f 7079 696e 672c  ons for copying,\n-00012b10: 0a20 2020 2020 6469 7374 7269 6275 7469  .     distributi\n-00012b20: 6e67 206f 7220 6d6f 6469 6679 696e 6720  ng or modifying \n-00012b30: 7468 6520 5072 6f67 7261 6d20 6f72 2077  the Program or w\n-00012b40: 6f72 6b73 2062 6173 6564 206f 6e20 6974  orks based on it\n-00012b50: 2e0a 0a20 2036 2e20 4561 6368 2074 696d  ...  6. Each tim\n-00012b60: 6520 796f 7520 7265 6469 7374 7269 6275  e you redistribu\n-00012b70: 7465 2074 6865 2050 726f 6772 616d 2028  te the Program (\n-00012b80: 6f72 2061 6e79 2077 6f72 6b20 6261 7365  or any work base\n-00012b90: 6420 6f6e 2074 6865 0a20 2020 2020 5072  d on the.     Pr\n-00012ba0: 6f67 7261 6d29 2c20 7468 6520 7265 6369  ogram), the reci\n-00012bb0: 7069 656e 7420 6175 746f 6d61 7469 6361  pient automatica\n-00012bc0: 6c6c 7920 7265 6365 6976 6573 2061 206c  lly receives a l\n-00012bd0: 6963 656e 7365 2066 726f 6d20 7468 650a  icense from the.\n-00012be0: 2020 2020 206f 7269 6769 6e61 6c20 6c69       original li\n-00012bf0: 6365 6e73 6f72 2074 6f20 636f 7079 2c20  censor to copy, \n-00012c00: 6469 7374 7269 6275 7465 206f 7220 6d6f  distribute or mo\n-00012c10: 6469 6679 2074 6865 2050 726f 6772 616d  dify the Program\n-00012c20: 2073 7562 6a65 6374 0a20 2020 2020 746f   subject.     to\n-00012c30: 2074 6865 7365 2074 6572 6d73 2061 6e64   these terms and\n-00012c40: 2063 6f6e 6469 7469 6f6e 732e 2020 596f   conditions.  Yo\n-00012c50: 7520 6d61 7920 6e6f 7420 696d 706f 7365  u may not impose\n-00012c60: 2061 6e79 2066 7572 7468 6572 0a20 2020   any further.   \n-00012c70: 2020 7265 7374 7269 6374 696f 6e73 206f    restrictions o\n-00012c80: 6e20 7468 6520 7265 6369 7069 656e 7473  n the recipients\n-00012c90: 2720 6578 6572 6369 7365 206f 6620 7468  ' exercise of th\n-00012ca0: 6520 7269 6768 7473 2067 7261 6e74 6564  e rights granted\n-00012cb0: 0a20 2020 2020 6865 7265 696e 2e20 2059  .     herein.  Y\n-00012cc0: 6f75 2061 7265 206e 6f74 2072 6573 706f  ou are not respo\n-00012cd0: 6e73 6962 6c65 2066 6f72 2065 6e66 6f72  nsible for enfor\n-00012ce0: 6369 6e67 2063 6f6d 706c 6961 6e63 6520  cing compliance \n-00012cf0: 6279 2074 6869 7264 0a20 2020 2020 7061  by third.     pa\n-00012d00: 7274 6965 7320 746f 2074 6869 7320 4c69  rties to this Li\n-00012d10: 6365 6e73 652e 0a0a 2020 372e 2049 662c  cense...  7. If,\n-00012d20: 2061 7320 6120 636f 6e73 6571 7565 6e63   as a consequenc\n-00012d30: 6520 6f66 2061 2063 6f75 7274 206a 7564  e of a court jud\n-00012d40: 676d 656e 7420 6f72 2061 6c6c 6567 6174  gment or allegat\n-00012d50: 696f 6e20 6f66 2070 6174 656e 740a 2020  ion of patent.  \n-00012d60: 2020 2069 6e66 7269 6e67 656d 656e 7420     infringement \n-00012d70: 6f72 2066 6f72 2061 6e79 206f 7468 6572  or for any other\n-00012d80: 2072 6561 736f 6e20 286e 6f74 206c 696d   reason (not lim\n-00012d90: 6974 6564 2074 6f20 7061 7465 6e74 0a20  ited to patent. \n-00012da0: 2020 2020 6973 7375 6573 292c 2063 6f6e      issues), con\n-00012db0: 6469 7469 6f6e 7320 6172 6520 696d 706f  ditions are impo\n-00012dc0: 7365 6420 6f6e 2079 6f75 2028 7768 6574  sed on you (whet\n-00012dd0: 6865 7220 6279 2063 6f75 7274 206f 7264  her by court ord\n-00012de0: 6572 2c0a 2020 2020 2061 6772 6565 6d65  er,.     agreeme\n-00012df0: 6e74 206f 7220 6f74 6865 7277 6973 6529  nt or otherwise)\n-00012e00: 2074 6861 7420 636f 6e74 7261 6469 6374   that contradict\n-00012e10: 2074 6865 2063 6f6e 6469 7469 6f6e 7320   the conditions \n-00012e20: 6f66 2074 6869 730a 2020 2020 204c 6963  of this.     Lic\n-00012e30: 656e 7365 2c20 7468 6579 2064 6f20 6e6f  ense, they do no\n-00012e40: 7420 6578 6375 7365 2079 6f75 2066 726f  t excuse you fro\n-00012e50: 6d20 7468 6520 636f 6e64 6974 696f 6e73  m the conditions\n-00012e60: 206f 6620 7468 6973 0a20 2020 2020 4c69   of this.     Li\n-00012e70: 6365 6e73 652e 2020 4966 2079 6f75 2063  cense.  If you c\n-00012e80: 616e 6e6f 7420 6469 7374 7269 6275 7465  annot distribute\n-00012e90: 2073 6f20 6173 2074 6f20 7361 7469 7366   so as to satisf\n-00012ea0: 7920 7369 6d75 6c74 616e 656f 7573 6c79  y simultaneously\n-00012eb0: 0a20 2020 2020 796f 7572 206f 626c 6967  .     your oblig\n-00012ec0: 6174 696f 6e73 2075 6e64 6572 2074 6869  ations under thi\n-00012ed0: 7320 4c69 6365 6e73 6520 616e 6420 616e  s License and an\n-00012ee0: 7920 6f74 6865 7220 7065 7274 696e 656e  y other pertinen\n-00012ef0: 740a 2020 2020 206f 626c 6967 6174 696f  t.     obligatio\n-00012f00: 6e73 2c20 7468 656e 2061 7320 6120 636f  ns, then as a co\n-00012f10: 6e73 6571 7565 6e63 6520 796f 7520 6d61  nsequence you ma\n-00012f20: 7920 6e6f 7420 6469 7374 7269 6275 7465  y not distribute\n-00012f30: 2074 6865 0a20 2020 2020 5072 6f67 7261   the.     Progra\n-00012f40: 6d20 6174 2061 6c6c 2e20 2046 6f72 2065  m at all.  For e\n-00012f50: 7861 6d70 6c65 2c20 6966 2061 2070 6174  xample, if a pat\n-00012f60: 656e 7420 6c69 6365 6e73 6520 776f 756c  ent license woul\n-00012f70: 6420 6e6f 7420 7065 726d 6974 0a20 2020  d not permit.   \n-00012f80: 2020 726f 7961 6c74 792d 6672 6565 2072    royalty-free r\n-00012f90: 6564 6973 7472 6962 7574 696f 6e20 6f66  edistribution of\n-00012fa0: 2074 6865 2050 726f 6772 616d 2062 7920   the Program by \n-00012fb0: 616c 6c20 7468 6f73 6520 7768 6f20 7265  all those who re\n-00012fc0: 6365 6976 650a 2020 2020 2063 6f70 6965  ceive.     copie\n-00012fd0: 7320 6469 7265 6374 6c79 206f 7220 696e  s directly or in\n-00012fe0: 6469 7265 6374 6c79 2074 6872 6f75 6768  directly through\n-00012ff0: 2079 6f75 2c20 7468 656e 2074 6865 206f   you, then the o\n-00013000: 6e6c 7920 7761 7920 796f 750a 2020 2020  nly way you.    \n-00013010: 2063 6f75 6c64 2073 6174 6973 6679 2062   could satisfy b\n-00013020: 6f74 6820 6974 2061 6e64 2074 6869 7320  oth it and this \n-00013030: 4c69 6365 6e73 6520 776f 756c 6420 6265  License would be\n-00013040: 2074 6f20 7265 6672 6169 6e20 656e 7469   to refrain enti\n-00013050: 7265 6c79 0a20 2020 2020 6672 6f6d 2064  rely.     from d\n-00013060: 6973 7472 6962 7574 696f 6e20 6f66 2074  istribution of t\n-00013070: 6865 2050 726f 6772 616d 2e0a 0a20 2020  he Program...   \n-00013080: 2020 4966 2061 6e79 2070 6f72 7469 6f6e    If any portion\n-00013090: 206f 6620 7468 6973 2073 6563 7469 6f6e   of this section\n-000130a0: 2069 7320 6865 6c64 2069 6e76 616c 6964   is held invalid\n-000130b0: 206f 7220 756e 656e 666f 7263 6561 626c   or unenforceabl\n-000130c0: 650a 2020 2020 2075 6e64 6572 2061 6e79  e.     under any\n-000130d0: 2070 6172 7469 6375 6c61 7220 6369 7263   particular circ\n-000130e0: 756d 7374 616e 6365 2c20 7468 6520 6261  umstance, the ba\n-000130f0: 6c61 6e63 6520 6f66 2074 6865 2073 6563  lance of the sec\n-00013100: 7469 6f6e 2069 730a 2020 2020 2069 6e74  tion is.     int\n-00013110: 656e 6465 6420 746f 2061 7070 6c79 2061  ended to apply a\n-00013120: 6e64 2074 6865 2073 6563 7469 6f6e 2061  nd the section a\n-00013130: 7320 6120 7768 6f6c 6520 6973 2069 6e74  s a whole is int\n-00013140: 656e 6465 6420 746f 2061 7070 6c79 0a20  ended to apply. \n-00013150: 2020 2020 696e 206f 7468 6572 2063 6972      in other cir\n-00013160: 6375 6d73 7461 6e63 6573 2e0a 0a20 2020  cumstances...   \n-00013170: 2020 4974 2069 7320 6e6f 7420 7468 6520    It is not the \n-00013180: 7075 7270 6f73 6520 6f66 2074 6869 7320  purpose of this \n-00013190: 7365 6374 696f 6e20 746f 2069 6e64 7563  section to induc\n-000131a0: 6520 796f 7520 746f 2069 6e66 7269 6e67  e you to infring\n-000131b0: 6520 616e 790a 2020 2020 2070 6174 656e  e any.     paten\n-000131c0: 7473 206f 7220 6f74 6865 7220 7072 6f70  ts or other prop\n-000131d0: 6572 7479 2072 6967 6874 2063 6c61 696d  erty right claim\n-000131e0: 7320 6f72 2074 6f20 636f 6e74 6573 7420  s or to contest \n-000131f0: 7661 6c69 6469 7479 206f 660a 2020 2020  validity of.    \n-00013200: 2061 6e79 2073 7563 6820 636c 6169 6d73   any such claims\n-00013210: 3b20 7468 6973 2073 6563 7469 6f6e 2068  ; this section h\n-00013220: 6173 2074 6865 2073 6f6c 6520 7075 7270  as the sole purp\n-00013230: 6f73 6520 6f66 2070 726f 7465 6374 696e  ose of protectin\n-00013240: 670a 2020 2020 2074 6865 2069 6e74 6567  g.     the integ\n-00013250: 7269 7479 206f 6620 7468 6520 6672 6565  rity of the free\n-00013260: 2073 6f66 7477 6172 6520 6469 7374 7269   software distri\n-00013270: 6275 7469 6f6e 2073 7973 7465 6d2c 2077  bution system, w\n-00013280: 6869 6368 2069 730a 2020 2020 2069 6d70  hich is.     imp\n-00013290: 6c65 6d65 6e74 6564 2062 7920 7075 626c  lemented by publ\n-000132a0: 6963 206c 6963 656e 7365 2070 7261 6374  ic license pract\n-000132b0: 6963 6573 2e20 204d 616e 7920 7065 6f70  ices.  Many peop\n-000132c0: 6c65 2068 6176 6520 6d61 6465 0a20 2020  le have made.   \n-000132d0: 2020 6765 6e65 726f 7573 2063 6f6e 7472    generous contr\n-000132e0: 6962 7574 696f 6e73 2074 6f20 7468 6520  ibutions to the \n-000132f0: 7769 6465 2072 616e 6765 206f 6620 736f  wide range of so\n-00013300: 6674 7761 7265 2064 6973 7472 6962 7574  ftware distribut\n-00013310: 6564 0a20 2020 2020 7468 726f 7567 6820  ed.     through \n-00013320: 7468 6174 2073 7973 7465 6d20 696e 2072  that system in r\n-00013330: 656c 6961 6e63 6520 6f6e 2063 6f6e 7369  eliance on consi\n-00013340: 7374 656e 7420 6170 706c 6963 6174 696f  stent applicatio\n-00013350: 6e20 6f66 2074 6861 740a 2020 2020 2073  n of that.     s\n-00013360: 7973 7465 6d3b 2069 7420 6973 2075 7020  ystem; it is up \n-00013370: 746f 2074 6865 2061 7574 686f 722f 646f  to the author/do\n-00013380: 6e6f 7220 746f 2064 6563 6964 6520 6966  nor to decide if\n-00013390: 2068 6520 6f72 2073 6865 2069 730a 2020   he or she is.  \n-000133a0: 2020 2077 696c 6c69 6e67 2074 6f20 6469     willing to di\n-000133b0: 7374 7269 6275 7465 2073 6f66 7477 6172  stribute softwar\n-000133c0: 6520 7468 726f 7567 6820 616e 7920 6f74  e through any ot\n-000133d0: 6865 7220 7379 7374 656d 2061 6e64 2061  her system and a\n-000133e0: 0a20 2020 2020 6c69 6365 6e73 6565 2063  .     licensee c\n-000133f0: 616e 6e6f 7420 696d 706f 7365 2074 6861  annot impose tha\n-00013400: 7420 6368 6f69 6365 2e0a 0a20 2020 2020  t choice...     \n-00013410: 5468 6973 2073 6563 7469 6f6e 2069 7320  This section is \n-00013420: 696e 7465 6e64 6564 2074 6f20 6d61 6b65  intended to make\n-00013430: 2074 686f 726f 7567 686c 7920 636c 6561   thoroughly clea\n-00013440: 7220 7768 6174 2069 7320 6265 6c69 6576  r what is believ\n-00013450: 6564 0a20 2020 2020 746f 2062 6520 6120  ed.     to be a \n-00013460: 636f 6e73 6571 7565 6e63 6520 6f66 2074  consequence of t\n-00013470: 6865 2072 6573 7420 6f66 2074 6869 7320  he rest of this \n-00013480: 4c69 6365 6e73 652e 0a0a 2020 382e 2049  License...  8. I\n-00013490: 6620 7468 6520 6469 7374 7269 6275 7469  f the distributi\n-000134a0: 6f6e 2061 6e64 2f6f 7220 7573 6520 6f66  on and/or use of\n-000134b0: 2074 6865 2050 726f 6772 616d 2069 7320   the Program is \n-000134c0: 7265 7374 7269 6374 6564 2069 6e0a 2020  restricted in.  \n-000134d0: 2020 2063 6572 7461 696e 2063 6f75 6e74     certain count\n-000134e0: 7269 6573 2065 6974 6865 7220 6279 2070  ries either by p\n-000134f0: 6174 656e 7473 206f 7220 6279 2063 6f70  atents or by cop\n-00013500: 7972 6967 6874 6564 2069 6e74 6572 6661  yrighted interfa\n-00013510: 6365 732c 0a20 2020 2020 7468 6520 6f72  ces,.     the or\n-00013520: 6967 696e 616c 2063 6f70 7972 6967 6874  iginal copyright\n-00013530: 2068 6f6c 6465 7220 7768 6f20 706c 6163   holder who plac\n-00013540: 6573 2074 6865 2050 726f 6772 616d 2075  es the Program u\n-00013550: 6e64 6572 2074 6869 730a 2020 2020 204c  nder this.     L\n-00013560: 6963 656e 7365 206d 6179 2061 6464 2061  icense may add a\n-00013570: 6e20 6578 706c 6963 6974 2067 656f 6772  n explicit geogr\n-00013580: 6170 6869 6361 6c20 6469 7374 7269 6275  aphical distribu\n-00013590: 7469 6f6e 206c 696d 6974 6174 696f 6e0a  tion limitation.\n-000135a0: 2020 2020 2065 7863 6c75 6469 6e67 2074       excluding t\n-000135b0: 686f 7365 2063 6f75 6e74 7269 6573 2c20  hose countries, \n-000135c0: 736f 2074 6861 7420 6469 7374 7269 6275  so that distribu\n-000135d0: 7469 6f6e 2069 7320 7065 726d 6974 7465  tion is permitte\n-000135e0: 6420 6f6e 6c79 0a20 2020 2020 696e 206f  d only.     in o\n-000135f0: 7220 616d 6f6e 6720 636f 756e 7472 6965  r among countrie\n-00013600: 7320 6e6f 7420 7468 7573 2065 7863 6c75  s not thus exclu\n-00013610: 6465 642e 2020 496e 2073 7563 6820 6361  ded.  In such ca\n-00013620: 7365 2c20 7468 6973 0a20 2020 2020 4c69  se, this.     Li\n-00013630: 6365 6e73 6520 696e 636f 7270 6f72 6174  cense incorporat\n-00013640: 6573 2074 6865 206c 696d 6974 6174 696f  es the limitatio\n-00013650: 6e20 6173 2069 6620 7772 6974 7465 6e20  n as if written \n-00013660: 696e 2074 6865 2062 6f64 7920 6f66 0a20  in the body of. \n-00013670: 2020 2020 7468 6973 204c 6963 656e 7365      this License\n-00013680: 2e0a 0a20 2039 2e20 5468 6520 4672 6565  ...  9. The Free\n-00013690: 2053 6f66 7477 6172 6520 466f 756e 6461   Software Founda\n-000136a0: 7469 6f6e 206d 6179 2070 7562 6c69 7368  tion may publish\n-000136b0: 2072 6576 6973 6564 2061 6e64 2f6f 7220   revised and/or \n-000136c0: 6e65 770a 2020 2020 2076 6572 7369 6f6e  new.     version\n-000136d0: 7320 6f66 2074 6865 2047 656e 6572 616c  s of the General\n-000136e0: 2050 7562 6c69 6320 4c69 6365 6e73 6520   Public License \n-000136f0: 6672 6f6d 2074 696d 6520 746f 2074 696d  from time to tim\n-00013700: 652e 2020 5375 6368 206e 6577 0a20 2020  e.  Such new.   \n-00013710: 2020 7665 7273 696f 6e73 2077 696c 6c20    versions will \n-00013720: 6265 2073 696d 696c 6172 2069 6e20 7370  be similar in sp\n-00013730: 6972 6974 2074 6f20 7468 6520 7072 6573  irit to the pres\n-00013740: 656e 7420 7665 7273 696f 6e2c 2062 7574  ent version, but\n-00013750: 206d 6179 0a20 2020 2020 6469 6666 6572   may.     differ\n-00013760: 2069 6e20 6465 7461 696c 2074 6f20 6164   in detail to ad\n-00013770: 6472 6573 7320 6e65 7720 7072 6f62 6c65  dress new proble\n-00013780: 6d73 206f 7220 636f 6e63 6572 6e73 2e0a  ms or concerns..\n-00013790: 0a20 2020 2020 4561 6368 2076 6572 7369  .     Each versi\n-000137a0: 6f6e 2069 7320 6769 7665 6e20 6120 6469  on is given a di\n-000137b0: 7374 696e 6775 6973 6869 6e67 2076 6572  stinguishing ver\n-000137c0: 7369 6f6e 206e 756d 6265 722e 2020 4966  sion number.  If\n-000137d0: 2074 6865 0a20 2020 2020 5072 6f67 7261   the.     Progra\n-000137e0: 6d20 7370 6563 6966 6965 7320 6120 7665  m specifies a ve\n-000137f0: 7273 696f 6e20 6e75 6d62 6572 206f 6620  rsion number of \n-00013800: 7468 6973 204c 6963 656e 7365 2077 6869  this License whi\n-00013810: 6368 2061 7070 6c69 6573 2074 6f0a 2020  ch applies to.  \n-00013820: 2020 2069 7420 616e 6420 2261 6e79 206c     it and \"any l\n-00013830: 6174 6572 2076 6572 7369 6f6e 222c 2079  ater version\", y\n-00013840: 6f75 2068 6176 6520 7468 6520 6f70 7469  ou have the opti\n-00013850: 6f6e 206f 6620 666f 6c6c 6f77 696e 6720  on of following \n-00013860: 7468 650a 2020 2020 2074 6572 6d73 2061  the.     terms a\n-00013870: 6e64 2063 6f6e 6469 7469 6f6e 7320 6569  nd conditions ei\n-00013880: 7468 6572 206f 6620 7468 6174 2076 6572  ther of that ver\n-00013890: 7369 6f6e 206f 7220 6f66 2061 6e79 206c  sion or of any l\n-000138a0: 6174 6572 2076 6572 7369 6f6e 0a20 2020  ater version.   \n-000138b0: 2020 7075 626c 6973 6865 6420 6279 2074    published by t\n-000138c0: 6865 2046 7265 6520 536f 6674 7761 7265  he Free Software\n-000138d0: 2046 6f75 6e64 6174 696f 6e2e 2020 4966   Foundation.  If\n-000138e0: 2074 6865 2050 726f 6772 616d 2064 6f65   the Program doe\n-000138f0: 7320 6e6f 740a 2020 2020 2073 7065 6369  s not.     speci\n-00013900: 6679 2061 2076 6572 7369 6f6e 206e 756d  fy a version num\n-00013910: 6265 7220 6f66 2074 6869 7320 4c69 6365  ber of this Lice\n-00013920: 6e73 652c 2079 6f75 206d 6179 2063 686f  nse, you may cho\n-00013930: 6f73 6520 616e 790a 2020 2020 2076 6572  ose any.     ver\n-00013940: 7369 6f6e 2065 7665 7220 7075 626c 6973  sion ever publis\n-00013950: 6865 6420 6279 2074 6865 2046 7265 6520  hed by the Free \n-00013960: 536f 6674 7761 7265 2046 6f75 6e64 6174  Software Foundat\n-00013970: 696f 6e2e 0a0a 2020 3130 2e20 4966 2079  ion...  10. If y\n-00013980: 6f75 2077 6973 6820 746f 2069 6e63 6f72  ou wish to incor\n-00013990: 706f 7261 7465 2070 6172 7473 206f 6620  porate parts of \n-000139a0: 7468 6520 5072 6f67 7261 6d20 696e 746f  the Program into\n-000139b0: 206f 7468 6572 2066 7265 650a 2020 2020   other free.    \n-000139c0: 2070 726f 6772 616d 7320 7768 6f73 6520   programs whose \n-000139d0: 6469 7374 7269 6275 7469 6f6e 2063 6f6e  distribution con\n-000139e0: 6469 7469 6f6e 7320 6172 6520 6469 6666  ditions are diff\n-000139f0: 6572 656e 742c 2077 7269 7465 2074 6f20  erent, write to \n-00013a00: 7468 650a 2020 2020 2061 7574 686f 7220  the.     author \n-00013a10: 746f 2061 736b 2066 6f72 2070 6572 6d69  to ask for permi\n-00013a20: 7373 696f 6e2e 2020 466f 7220 736f 6674  ssion.  For soft\n-00013a30: 7761 7265 2077 6869 6368 2069 7320 636f  ware which is co\n-00013a40: 7079 7269 6768 7465 6420 6279 0a20 2020  pyrighted by.   \n-00013a50: 2020 7468 6520 4672 6565 2053 6f66 7477    the Free Softw\n-00013a60: 6172 6520 466f 756e 6461 7469 6f6e 2c20  are Foundation, \n-00013a70: 7772 6974 6520 746f 2074 6865 2046 7265  write to the Fre\n-00013a80: 6520 536f 6674 7761 7265 0a20 2020 2020  e Software.     \n-00013a90: 466f 756e 6461 7469 6f6e 3b20 7765 2073  Foundation; we s\n-00013aa0: 6f6d 6574 696d 6573 206d 616b 6520 6578  ometimes make ex\n-00013ab0: 6365 7074 696f 6e73 2066 6f72 2074 6869  ceptions for thi\n-00013ac0: 732e 2020 4f75 7220 6465 6369 7369 6f6e  s.  Our decision\n-00013ad0: 0a20 2020 2020 7769 6c6c 2062 6520 6775  .     will be gu\n-00013ae0: 6964 6564 2062 7920 7468 6520 7477 6f20  ided by the two \n-00013af0: 676f 616c 7320 6f66 2070 7265 7365 7276  goals of preserv\n-00013b00: 696e 6720 7468 6520 6672 6565 2073 7461  ing the free sta\n-00013b10: 7475 7320 6f66 0a20 2020 2020 616c 6c20  tus of.     all \n-00013b20: 6465 7269 7661 7469 7665 7320 6f66 206f  derivatives of o\n-00013b30: 7572 2066 7265 6520 736f 6674 7761 7265  ur free software\n-00013b40: 2061 6e64 206f 6620 7072 6f6d 6f74 696e   and of promotin\n-00013b50: 6720 7468 6520 7368 6172 696e 670a 2020  g the sharing.  \n-00013b60: 2020 2061 6e64 2072 6575 7365 206f 6620     and reuse of \n-00013b70: 736f 6674 7761 7265 2067 656e 6572 616c  software general\n-00013b80: 6c79 2e0a 0a20 2020 2020 2020 2020 2020  ly...           \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+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: 2020 204e 4f20 5741 5252 414e 5459 0a0a     NO WARRANTY..\n-00013bb0: 2020 312e 2042 4543 4155 5345 2054 4845    1. BECAUSE THE\n-00013bc0: 2050 524f 4752 414d 2049 5320 4c49 4345   PROGRAM IS LICE\n-00013bd0: 4e53 4544 2046 5245 4520 4f46 2043 4841  NSED FREE OF CHA\n-00013be0: 5247 452c 2054 4845 5245 2049 5320 4e4f  RGE, THERE IS NO\n-00013bf0: 0a20 2020 2020 5741 5252 414e 5459 2046  .     WARRANTY F\n-00013c00: 4f52 2054 4845 2050 524f 4752 414d 2c20  OR THE PROGRAM, \n-00013c10: 544f 2054 4845 2045 5854 454e 5420 5045  TO THE EXTENT PE\n-00013c20: 524d 4954 5445 4420 4259 2041 5050 4c49  RMITTED BY APPLI\n-00013c30: 4341 424c 450a 2020 2020 204c 4157 2e20  CABLE.     LAW. \n-00013c40: 4558 4345 5054 2057 4845 4e20 4f54 4845  EXCEPT WHEN OTHE\n-00013c50: 5257 4953 4520 5354 4154 4544 2049 4e20  RWISE STATED IN \n-00013c60: 5752 4954 494e 4720 5448 4520 434f 5059  WRITING THE COPY\n-00013c70: 5249 4748 5420 484f 4c44 4552 530a 2020  RIGHT HOLDERS.  \n-00013c80: 2020 2041 4e44 2f4f 5220 4f54 4845 5220     AND/OR OTHER \n-00013c90: 5041 5254 4945 5320 5052 4f56 4944 4520  PARTIES PROVIDE \n-00013ca0: 5448 4520 5052 4f47 5241 4d20 2241 5320  THE PROGRAM \"AS \n-00013cb0: 4953 2220 5749 5448 4f55 5420 5741 5252  IS\" WITHOUT WARR\n-00013cc0: 414e 5459 0a20 2020 2020 4f46 2041 4e59  ANTY.     OF ANY\n-00013cd0: 204b 494e 442c 2045 4954 4845 5220 4558   KIND, EITHER EX\n-00013ce0: 5052 4553 5345 4420 4f52 2049 4d50 4c49  PRESSED OR IMPLI\n-00013cf0: 4544 2c20 494e 434c 5544 494e 472c 2042  ED, INCLUDING, B\n-00013d00: 5554 204e 4f54 0a20 2020 2020 4c49 4d49  UT NOT.     LIMI\n-00013d10: 5445 4420 544f 2c20 5448 4520 494d 504c  TED TO, THE IMPL\n-00013d20: 4945 4420 5741 5252 414e 5449 4553 204f  IED WARRANTIES O\n-00013d30: 4620 4d45 5243 4841 4e54 4142 494c 4954  F MERCHANTABILIT\n-00013d40: 5920 414e 4420 4649 544e 4553 530a 2020  Y AND FITNESS.  \n-00013d50: 2020 2046 4f52 2041 2050 4152 5449 4355     FOR A PARTICU\n-00013d60: 4c41 5220 5055 5250 4f53 452e 2054 4845  LAR PURPOSE. THE\n-00013d70: 2045 4e54 4952 4520 5249 534b 2041 5320   ENTIRE RISK AS \n-00013d80: 544f 2054 4845 2051 5541 4c49 5459 2041  TO THE QUALITY A\n-00013d90: 4e44 0a20 2020 2020 5045 5246 4f52 4d41  ND.     PERFORMA\n-00013da0: 4e43 4520 4f46 2054 4845 2050 524f 4752  NCE OF THE PROGR\n-00013db0: 414d 2049 5320 5749 5448 2059 4f55 2e20  AM IS WITH YOU. \n-00013dc0: 5348 4f55 4c44 2054 4845 2050 524f 4752  SHOULD THE PROGR\n-00013dd0: 414d 2050 524f 5645 0a20 2020 2020 4445  AM PROVE.     DE\n-00013de0: 4645 4354 4956 452c 2059 4f55 2041 5353  FECTIVE, YOU ASS\n-00013df0: 554d 4520 5448 4520 434f 5354 204f 4620  UME THE COST OF \n-00013e00: 414c 4c20 4e45 4345 5353 4152 5920 5345  ALL NECESSARY SE\n-00013e10: 5256 4943 494e 472c 2052 4550 4149 520a  RVICING, REPAIR.\n-00013e20: 2020 2020 204f 5220 434f 5252 4543 5449       OR CORRECTI\n-00013e30: 4f4e 2e0a 0a20 2032 2e20 494e 204e 4f20  ON...  2. IN NO \n-00013e40: 4556 454e 5420 554e 4c45 5353 2052 4551  EVENT UNLESS REQ\n-00013e50: 5549 5245 4420 4259 2041 5050 4c49 4341  UIRED BY APPLICA\n-00013e60: 424c 4520 4c41 5720 4f52 2041 4752 4545  BLE LAW OR AGREE\n-00013e70: 4420 544f 2049 4e0a 2020 2020 2057 5249  D TO IN.     WRI\n-00013e80: 5449 4e47 2057 494c 4c20 414e 5920 434f  TING WILL ANY CO\n-00013e90: 5059 5249 4748 5420 484f 4c44 4552 2c20  PYRIGHT HOLDER, \n-00013ea0: 4f52 2041 4e59 204f 5448 4552 2050 4152  OR ANY OTHER PAR\n-00013eb0: 5459 2057 484f 204d 4159 0a20 2020 2020  TY WHO MAY.     \n-00013ec0: 4d4f 4449 4659 2041 4e44 2f4f 5220 5245  MODIFY AND/OR RE\n-00013ed0: 4449 5354 5249 4255 5445 2054 4845 2050  DISTRIBUTE THE P\n-00013ee0: 524f 4752 414d 2041 5320 5045 524d 4954  ROGRAM AS PERMIT\n-00013ef0: 5445 4420 4142 4f56 452c 2042 450a 2020  TED ABOVE, BE.  \n-00013f00: 2020 204c 4941 424c 4520 544f 2059 4f55     LIABLE TO YOU\n-00013f10: 2046 4f52 2044 414d 4147 4553 2c20 494e   FOR DAMAGES, IN\n-00013f20: 434c 5544 494e 4720 414e 5920 4745 4e45  CLUDING ANY GENE\n-00013f30: 5241 4c2c 2053 5045 4349 414c 2c0a 2020  RAL, SPECIAL,.  \n-00013f40: 2020 2049 4e43 4944 454e 5441 4c20 4f52     INCIDENTAL OR\n-00013f50: 2043 4f4e 5345 5155 454e 5449 414c 2044   CONSEQUENTIAL D\n-00013f60: 414d 4147 4553 2041 5249 5349 4e47 204f  AMAGES ARISING O\n-00013f70: 5554 204f 4620 5448 4520 5553 4520 4f52  UT OF THE USE OR\n-00013f80: 0a20 2020 2020 494e 4142 494c 4954 5920  .     INABILITY \n-00013f90: 544f 2055 5345 2054 4845 2050 524f 4752  TO USE THE PROGR\n-00013fa0: 414d 2028 494e 434c 5544 494e 4720 4255  AM (INCLUDING BU\n-00013fb0: 5420 4e4f 5420 4c49 4d49 5445 4420 544f  T NOT LIMITED TO\n-00013fc0: 204c 4f53 5320 4f46 0a20 2020 2020 4441   LOSS OF.     DA\n-00013fd0: 5441 204f 5220 4441 5441 2042 4549 4e47  TA OR DATA BEING\n-00013fe0: 2052 454e 4445 5245 4420 494e 4143 4355   RENDERED INACCU\n-00013ff0: 5241 5445 204f 5220 4c4f 5353 4553 2053  RATE OR LOSSES S\n-00014000: 5553 5441 494e 4544 2042 5920 594f 550a  USTAINED BY YOU.\n-00014010: 2020 2020 204f 5220 5448 4952 4420 5041       OR THIRD PA\n-00014020: 5254 4945 5320 4f52 2041 2046 4149 4c55  RTIES OR A FAILU\n-00014030: 5245 204f 4620 5448 4520 5052 4f47 5241  RE OF THE PROGRA\n-00014040: 4d20 544f 204f 5045 5241 5445 2057 4954  M TO OPERATE WIT\n-00014050: 4820 414e 590a 2020 2020 204f 5448 4552  H ANY.     OTHER\n-00014060: 2050 524f 4752 414d 5329 2c20 4556 454e   PROGRAMS), EVEN\n-00014070: 2049 4620 5355 4348 2048 4f4c 4445 5220   IF SUCH HOLDER \n-00014080: 4f52 204f 5448 4552 2050 4152 5459 2048  OR OTHER PARTY H\n-00014090: 4153 2042 4545 4e0a 2020 2020 2041 4456  AS BEEN.     ADV\n-000140a0: 4953 4544 204f 4620 5448 4520 504f 5353  ISED OF THE POSS\n-000140b0: 4942 494c 4954 5920 4f46 2053 5543 4820  IBILITY OF SUCH \n-000140c0: 4441 4d41 4745 532e 0a0a 2020 2020 2020  DAMAGES...      \n-000140d0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000140e0: 454e 4420 4f46 2054 4552 4d53 2041 4e44  END OF TERMS AND\n-000140f0: 2043 4f4e 4449 5449 4f4e 530a 0a41 2e32   CONDITIONS..A.2\n-00014100: 2041 7070 656e 6469 783a 2048 6f77 2074   Appendix: How t\n-00014110: 6f20 4170 706c 7920 5468 6573 6520 5465  o Apply These Te\n-00014120: 726d 7320 746f 2059 6f75 7220 4e65 7720  rms to Your New \n-00014130: 5072 6f67 7261 6d73 0a3d 3d3d 3d3d 3d3d  Programs.=======\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 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 3d3d 0a0a 4966 2079 6f75 2064 6576  ====..If you dev\n-00014180: 656c 6f70 2061 206e 6577 2070 726f 6772  elop a new progr\n-00014190: 616d 2c20 616e 6420 796f 7520 7761 6e74  am, and you want\n-000141a0: 2069 7420 746f 2062 6520 6f66 2074 6865   it to be of the\n-000141b0: 2067 7265 6174 6573 740a 706f 7373 6962   greatest.possib\n-000141c0: 6c65 2075 7365 2074 6f20 7468 6520 7075  le use to the pu\n-000141d0: 626c 6963 2c20 7468 6520 6265 7374 2077  blic, the best w\n-000141e0: 6179 2074 6f20 6163 6869 6576 6520 7468  ay to achieve th\n-000141f0: 6973 2069 7320 746f 206d 616b 6520 6974  is is to make it\n-00014200: 0a66 7265 6520 736f 6674 7761 7265 2077  .free software w\n-00014210: 6869 6368 2065 7665 7279 6f6e 6520 6361  hich everyone ca\n-00014220: 6e20 7265 6469 7374 7269 6275 7465 2061  n redistribute a\n-00014230: 6e64 2063 6861 6e67 6520 756e 6465 7220  nd change under \n-00014240: 7468 6573 650a 7465 726d 732e 0a0a 2020  these.terms...  \n-00014250: 2054 6f20 646f 2073 6f2c 2061 7474 6163   To do so, attac\n-00014260: 6820 7468 6520 666f 6c6c 6f77 696e 6720  h the following \n-00014270: 6e6f 7469 6365 7320 746f 2074 6865 2070  notices to the p\n-00014280: 726f 6772 616d 2e20 2049 7420 6973 2073  rogram.  It is s\n-00014290: 6166 6573 740a 746f 2061 7474 6163 6820  afest.to attach \n-000142a0: 7468 656d 2074 6f20 7468 6520 7374 6172  them to the star\n-000142b0: 7420 6f66 2065 6163 6820 736f 7572 6365  t of each source\n-000142c0: 2066 696c 6520 746f 206d 6f73 7420 6566   file to most ef\n-000142d0: 6665 6374 6976 656c 790a 636f 6e76 6579  fectively.convey\n-000142e0: 2074 6865 2065 7863 6c75 7369 6f6e 206f   the exclusion o\n-000142f0: 6620 7761 7272 616e 7479 3b20 616e 6420  f warranty; and \n-00014300: 6561 6368 2066 696c 6520 7368 6f75 6c64  each file should\n-00014310: 2068 6176 6520 6174 206c 6561 7374 2074   have at least t\n-00014320: 6865 0a22 636f 7079 7269 6768 7422 206c  he.\"copyright\" l\n-00014330: 696e 6520 616e 6420 6120 706f 696e 7465  ine and a pointe\n-00014340: 7220 746f 2077 6865 7265 2074 6865 2066  r to where the f\n-00014350: 756c 6c20 6e6f 7469 6365 2069 7320 666f  ull notice is fo\n-00014360: 756e 642e 0a0a 2020 2020 204f 4e45 204c  und...     ONE L\n-00014370: 494e 4520 544f 2047 4956 4520 5448 4520  INE TO GIVE THE \n-00014380: 5052 4f47 5241 4d27 5320 4e41 4d45 2041  PROGRAM'S NAME A\n-00014390: 4e44 2041 2042 5249 4546 2049 4445 4120  ND A BRIEF IDEA \n-000143a0: 4f46 2057 4841 5420 4954 2044 4f45 532e  OF WHAT IT DOES.\n-000143b0: 0a20 2020 2020 436f 7079 7269 6768 7420  .     Copyright \n-000143c0: 2843 2920 5959 5959 2020 4e41 4d45 204f  (C) YYYY  NAME O\n-000143d0: 4620 4155 5448 4f52 0a0a 2020 2020 2054  F AUTHOR..     T\n-000143e0: 6869 7320 7072 6f67 7261 6d20 6973 2066  his program is f\n-000143f0: 7265 6520 736f 6674 7761 7265 3b20 796f  ree software; yo\n-00014400: 7520 6361 6e20 7265 6469 7374 7269 6275  u can redistribu\n-00014410: 7465 2069 7420 616e 642f 6f72 206d 6f64  te it and/or mod\n-00014420: 6966 790a 2020 2020 2069 7420 756e 6465  ify.     it unde\n-00014430: 7220 7468 6520 7465 726d 7320 6f66 2074  r the terms of t\n-00014440: 6865 2047 4e55 2047 656e 6572 616c 2050  he GNU General P\n-00014450: 7562 6c69 6320 4c69 6365 6e73 6520 6173  ublic License as\n-00014460: 2070 7562 6c69 7368 6564 2062 790a 2020   published by.  \n-00014470: 2020 2074 6865 2046 7265 6520 536f 6674     the Free Soft\n-00014480: 7761 7265 2046 6f75 6e64 6174 696f 6e3b  ware Foundation;\n-00014490: 2065 6974 6865 7220 7665 7273 696f 6e20   either version \n-000144a0: 3220 6f66 2074 6865 204c 6963 656e 7365  2 of the License\n-000144b0: 2c20 6f72 0a20 2020 2020 2861 7420 796f  , or.     (at yo\n-000144c0: 7572 206f 7074 696f 6e29 2061 6e79 206c  ur option) any l\n-000144d0: 6174 6572 2076 6572 7369 6f6e 2e0a 0a20  ater version... \n-000144e0: 2020 2020 5468 6973 2070 726f 6772 616d      This program\n-000144f0: 2069 7320 6469 7374 7269 6275 7465 6420   is distributed \n-00014500: 696e 2074 6865 2068 6f70 6520 7468 6174  in the hope that\n-00014510: 2069 7420 7769 6c6c 2062 6520 7573 6566   it will be usef\n-00014520: 756c 2c0a 2020 2020 2062 7574 2057 4954  ul,.     but WIT\n-00014530: 484f 5554 2041 4e59 2057 4152 5241 4e54  HOUT ANY WARRANT\n-00014540: 593b 2077 6974 686f 7574 2065 7665 6e20  Y; without even \n-00014550: 7468 6520 696d 706c 6965 6420 7761 7272  the implied warr\n-00014560: 616e 7479 206f 660a 2020 2020 204d 4552  anty of.     MER\n-00014570: 4348 414e 5441 4249 4c49 5459 206f 7220  CHANTABILITY or \n-00014580: 4649 544e 4553 5320 464f 5220 4120 5041  FITNESS FOR A PA\n-00014590: 5254 4943 554c 4152 2050 5552 504f 5345  RTICULAR PURPOSE\n-000145a0: 2e20 2053 6565 2074 6865 0a20 2020 2020  .  See the.     \n-000145b0: 474e 5520 4765 6e65 7261 6c20 5075 626c  GNU General Publ\n-000145c0: 6963 204c 6963 656e 7365 2066 6f72 206d  ic License for m\n-000145d0: 6f72 6520 6465 7461 696c 732e 0a0a 2020  ore details...  \n-000145e0: 2020 2059 6f75 2073 686f 756c 6420 6861     You should ha\n-000145f0: 7665 2072 6563 6569 7665 6420 6120 636f  ve received a co\n-00014600: 7079 206f 6620 7468 6520 474e 5520 4765  py of the GNU Ge\n-00014610: 6e65 7261 6c20 5075 626c 6963 204c 6963  neral Public Lic\n-00014620: 656e 7365 0a20 2020 2020 616c 6f6e 6720  ense.     along \n-00014630: 7769 7468 2074 6869 7320 7072 6f67 7261  with this progra\n-00014640: 6d3b 2069 6620 6e6f 742c 2077 7269 7465  m; if not, write\n-00014650: 2074 6f20 7468 6520 4672 6565 2053 6f66   to the Free Sof\n-00014660: 7477 6172 650a 2020 2020 2046 6f75 6e64  tware.     Found\n-00014670: 6174 696f 6e2c 2049 6e63 2e2c 2035 3120  ation, Inc., 51 \n-00014680: 4672 616e 6b6c 696e 2053 7472 6565 742c  Franklin Street,\n-00014690: 2046 6966 7468 2046 6c6f 6f72 2c20 426f   Fifth Floor, Bo\n-000146a0: 7374 6f6e 2c20 4d41 2020 3032 3131 302d  ston, MA  02110-\n-000146b0: 3133 3031 2c20 5553 412e 0a0a 2020 2041  1301, USA...   A\n-000146c0: 6c73 6f20 6164 6420 696e 666f 726d 6174  lso add informat\n-000146d0: 696f 6e20 6f6e 2068 6f77 2074 6f20 636f  ion on how to co\n-000146e0: 6e74 6163 7420 796f 7520 6279 2065 6c65  ntact you by ele\n-000146f0: 6374 726f 6e69 6320 616e 6420 7061 7065  ctronic and pape\n-00014700: 720a 6d61 696c 2e0a 0a20 2020 4966 2074  r.mail...   If t\n-00014710: 6865 2070 726f 6772 616d 2069 7320 696e  he program is in\n-00014720: 7465 7261 6374 6976 652c 206d 616b 6520  teractive, make \n-00014730: 6974 206f 7574 7075 7420 6120 7368 6f72  it output a shor\n-00014740: 7420 6e6f 7469 6365 206c 696b 650a 7468  t notice like.th\n-00014750: 6973 2077 6865 6e20 6974 2073 7461 7274  is when it start\n-00014760: 7320 696e 2061 6e20 696e 7465 7261 6374  s in an interact\n-00014770: 6976 6520 6d6f 6465 3a0a 0a20 2020 2020  ive mode:..     \n-00014780: 476e 6f6d 6f76 6973 696f 6e20 7665 7273  Gnomovision vers\n-00014790: 696f 6e20 3639 2c20 436f 7079 7269 6768  ion 69, Copyrigh\n-000147a0: 7420 2843 2920 5945 4152 204e 414d 4520  t (C) YEAR NAME \n-000147b0: 4f46 2041 5554 484f 520a 2020 2020 2047  OF AUTHOR.     G\n-000147c0: 6e6f 6d6f 7669 7369 6f6e 2063 6f6d 6573  nomovision comes\n-000147d0: 2077 6974 6820 4142 534f 4c55 5445 4c59   with ABSOLUTELY\n-000147e0: 204e 4f20 5741 5252 414e 5459 3b20 666f   NO WARRANTY; fo\n-000147f0: 7220 6465 7461 696c 7320 7479 7065 2060  r details type `\n-00014800: 7368 6f77 2077 272e 0a20 2020 2020 5468  show w'..     Th\n-00014810: 6973 2069 7320 6672 6565 2073 6f66 7477  is is free softw\n-00014820: 6172 652c 2061 6e64 2079 6f75 2061 7265  are, and you are\n-00014830: 2077 656c 636f 6d65 2074 6f20 7265 6469   welcome to redi\n-00014840: 7374 7269 6275 7465 2069 740a 2020 2020  stribute it.    \n-00014850: 2075 6e64 6572 2063 6572 7461 696e 2063   under certain c\n-00014860: 6f6e 6469 7469 6f6e 733b 2074 7970 6520  onditions; type \n-00014870: 6073 686f 7720 6327 2066 6f72 2064 6574  `show c' for det\n-00014880: 6169 6c73 2e0a 0a20 2020 5468 6520 6879  ails...   The hy\n-00014890: 706f 7468 6574 6963 616c 2063 6f6d 6d61  pothetical comma\n-000148a0: 6e64 7320 2773 686f 7720 7727 2061 6e64  nds 'show w' and\n-000148b0: 2027 7368 6f77 2063 2720 7368 6f75 6c64   'show c' should\n-000148c0: 2073 686f 7720 7468 650a 6170 7072 6f70   show the.approp\n-000148d0: 7269 6174 6520 7061 7274 7320 6f66 2074  riate parts of t\n-000148e0: 6865 2047 656e 6572 616c 2050 7562 6c69  he General Publi\n-000148f0: 6320 4c69 6365 6e73 652e 2020 4f66 2063  c License.  Of c\n-00014900: 6f75 7273 652c 2074 6865 0a63 6f6d 6d61  ourse, the.comma\n-00014910: 6e64 7320 796f 7520 7573 6520 6d61 7920  nds you use may \n-00014920: 6265 2063 616c 6c65 6420 736f 6d65 7468  be called someth\n-00014930: 696e 6720 6f74 6865 7220 7468 616e 2027  ing other than '\n-00014940: 7368 6f77 2077 2720 616e 6420 2773 686f  show w' and 'sho\n-00014950: 770a 6327 3b20 7468 6579 2063 6f75 6c64  w.c'; they could\n-00014960: 2065 7665 6e20 6265 206d 6f75 7365 2d63   even be mouse-c\n-00014970: 6c69 636b 7320 6f72 206d 656e 7520 6974  licks or menu it\n-00014980: 656d 732d 2d77 6861 7465 7665 7220 7375  ems--whatever su\n-00014990: 6974 7320 796f 7572 0a70 726f 6772 616d  its your.program\n-000149a0: 2e0a 0a20 2020 596f 7520 7368 6f75 6c64  ...   You should\n-000149b0: 2061 6c73 6f20 6765 7420 796f 7572 2065   also get your e\n-000149c0: 6d70 6c6f 7965 7220 2869 6620 796f 7520  mployer (if you \n-000149d0: 776f 726b 2061 7320 6120 7072 6f67 7261  work as a progra\n-000149e0: 6d6d 6572 2920 6f72 0a79 6f75 7220 7363  mmer) or.your sc\n-000149f0: 686f 6f6c 2c20 6966 2061 6e79 2c20 746f  hool, if any, to\n-00014a00: 2073 6967 6e20 6120 2263 6f70 7972 6967   sign a \"copyrig\n-00014a10: 6874 2064 6973 636c 6169 6d65 7222 2066  ht disclaimer\" f\n-00014a20: 6f72 2074 6865 2070 726f 6772 616d 2c0a  or the program,.\n-00014a30: 6966 206e 6563 6573 7361 7279 2e20 2048  if necessary.  H\n-00014a40: 6572 6520 6973 2061 2073 616d 706c 653b  ere is a sample;\n-00014a50: 2061 6c74 6572 2074 6865 206e 616d 6573   alter the names\n-00014a60: 3a0a 0a20 2020 2020 596f 796f 6479 6e65  :..     Yoyodyne\n-00014a70: 2c20 496e 632e 2c20 6865 7265 6279 2064  , Inc., hereby d\n-00014a80: 6973 636c 6169 6d73 2061 6c6c 2063 6f70  isclaims all cop\n-00014a90: 7972 6967 6874 2069 6e74 6572 6573 7420  yright interest \n-00014aa0: 696e 2074 6865 2070 726f 6772 616d 0a20  in the program. \n-00014ab0: 2020 2020 6047 6e6f 6d6f 7669 7369 6f6e      `Gnomovision\n-00014ac0: 2720 2877 6869 6368 206d 616b 6573 2070  ' (which makes p\n-00014ad0: 6173 7365 7320 6174 2063 6f6d 7069 6c65  asses at compile\n-00014ae0: 7273 2920 7772 6974 7465 6e20 6279 204a  rs) written by J\n-00014af0: 616d 6573 2048 6163 6b65 722e 0a0a 2020  ames Hacker...  \n-00014b00: 2020 2053 4947 4e41 5455 5245 204f 4620     SIGNATURE OF \n-00014b10: 5459 2043 4f4f 4e2c 2031 2041 7072 696c  TY COON, 1 April\n-00014b20: 2031 3938 390a 2020 2020 2054 7920 436f   1989.     Ty Co\n-00014b30: 6f6e 2c20 5072 6573 6964 656e 7420 6f66  on, President of\n-00014b40: 2056 6963 650a 0a20 2020 5468 6973 2047   Vice..   This G\n-00014b50: 656e 6572 616c 2050 7562 6c69 6320 4c69  eneral Public Li\n-00014b60: 6365 6e73 6520 646f 6573 206e 6f74 2070  cense does not p\n-00014b70: 6572 6d69 7420 696e 636f 7270 6f72 6174  ermit incorporat\n-00014b80: 696e 6720 796f 7572 0a70 726f 6772 616d  ing your.program\n-00014b90: 2069 6e74 6f20 7072 6f70 7269 6574 6172   into proprietar\n-00014ba0: 7920 7072 6f67 7261 6d73 2e20 2049 6620  y programs.  If \n-00014bb0: 796f 7572 2070 726f 6772 616d 2069 7320  your program is \n-00014bc0: 6120 7375 6272 6f75 7469 6e65 0a6c 6962  a subroutine.lib\n-00014bd0: 7261 7279 2c20 796f 7520 6d61 7920 636f  rary, you may co\n-00014be0: 6e73 6964 6572 2069 7420 6d6f 7265 2075  nsider it more u\n-00014bf0: 7365 6675 6c20 746f 2070 6572 6d69 7420  seful to permit \n-00014c00: 6c69 6e6b 696e 6720 7072 6f70 7269 6574  linking propriet\n-00014c10: 6172 790a 6170 706c 6963 6174 696f 6e73  ary.applications\n-00014c20: 2077 6974 6820 7468 6520 6c69 6272 6172   with the librar\n-00014c30: 792e 2020 4966 2074 6869 7320 6973 2077  y.  If this is w\n-00014c40: 6861 7420 796f 7520 7761 6e74 2074 6f20  hat you want to \n-00014c50: 646f 2c20 7573 6520 7468 650a 474e 5520  do, use the.GNU \n-00014c60: 4c65 7373 6572 2047 656e 6572 616c 2050  Lesser General P\n-00014c70: 7562 6c69 6320 4c69 6365 6e73 6520 696e  ublic License in\n-00014c80: 7374 6561 6420 6f66 2074 6869 7320 4c69  stead of this Li\n-00014c90: 6365 6e73 652e 0a0a 1f0a 4669 6c65 3a20  cense.....File: \n-00014ca0: 6c69 6266 6b6f 2e69 6e66 6f2c 2020 4e6f  libfko.info,  No\n-00014cb0: 6465 3a20 436f 6e63 6570 7420 496e 6465  de: Concept Inde\n-00014cc0: 782c 2020 4e65 7874 3a20 4675 6e63 7469  x,  Next: Functi\n-00014cd0: 6f6e 2061 6e64 2044 6174 6120 496e 6465  on and Data Inde\n-00014ce0: 782c 2020 5072 6576 3a20 4c69 6272 6172  x,  Prev: Librar\n-00014cf0: 7920 436f 7079 696e 672c 2020 5570 3a20  y Copying,  Up: \n-00014d00: 546f 700a 0a43 6f6e 6365 7074 2049 6e64  Top..Concept Ind\n-00014d10: 6578 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ex.*************\n-00014d20: 0a0a 0008 5b69 6e64 6578 0008 5d0a 2a20  ....[index..].* \n-00014d30: 4d65 6e75 3a0a 0a2a 2063 6f6d 7069 6c69  Menu:..* compili\n-00014d40: 6e67 2c20 7769 7468 206c 6962 666b 6f3a  ng, with libfko:\n-00014d50: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00014d60: 436f 6d70 696c 696e 6720 7769 7468 206c  Compiling with l\n-00014d70: 6962 666b 6f2e 0a20 2020 2020 2020 2020  ibfko..         \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 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 2020 2028 6c69 6e65 2020 2036 290a       (line   6).\n-00014dc0: 2a20 636f 6e74 6578 742c 2063 7265 6174  * context, creat\n-00014dd0: 696f 6e3a 2020 2020 2020 2020 2020 2020  ion:            \n-00014de0: 2020 2020 2020 2020 2043 7265 6174 696e           Creatin\n-00014df0: 6720 436f 6e74 6578 7473 2e20 2020 286c  g Contexts.   (l\n-00014e00: 696e 6520 2020 3629 0a2a 2063 6f6e 7465  ine   6).* conte\n-00014e10: 7874 2c20 6465 7374 7275 6374 696f 6e3a  xt, destruction:\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: 2020 4465 7374 726f 7969 6e67 2043 6f6e    Destroying Con\n-00014e40: 7465 7874 732e 2028 6c69 6e65 2020 2036  texts. (line   6\n-00014e50: 290a 2a20 6465 6661 756c 7420 656e 6372  ).* default encr\n-00014e60: 7970 7469 6f6e 3a20 2020 2020 2020 2020  yption:         \n-00014e70: 2020 2020 2020 2020 2020 2045 6e63 7279             Encry\n-00014e80: 7074 696f 6e20 416c 676f 7269 7468 6d73  ption Algorithms\n-00014e90: 2e0a 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+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 2020                  \n-00014ed0: 286c 696e 6520 2020 3629 0a2a 2064 6566  (line   6).* def\n-00014ee0: 6175 6c74 206d 6573 7361 6765 2064 6967  ault message dig\n-00014ef0: 6573 743a 2020 2020 2020 2020 2020 2020  est:            \n-00014f00: 2020 2020 4469 6765 7374 732e 2020 2020      Digests.    \n-00014f10: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  \n-00014f20: 2036 290a 2a20 6465 6661 756c 7420 6d65   6).* default me\n-00014f30: 7373 6167 6520 6469 6765 7374 203c 313e  ssage digest <1>\n-00014f40: 3a20 2020 2020 2020 2020 2020 2048 4d41  :            HMA\n-00014f50: 4320 4469 6765 7374 732e 2020 2020 2020  C Digests.      \n-00014f60: 2020 286c 696e 6520 2020 3629 0a2a 2064    (line   6).* d\n-00014f70: 6967 6573 7420 7479 7065 733a 2020 2020  igest types:    \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 00014f80: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00014f90: 2020 2020 2020 4469 6765 7374 732e 2020        Digests.  \n-00014fa0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line\n-00014fb0: 2020 2036 290a 2a20 656e 6372 7970 7469     6).* encrypti\n-00014fc0: 6f6e 2074 7970 6573 3a20 2020 2020 2020  on types:       \n-00014fd0: 2020 2020 2020 2020 2020 2020 2020 2045                 E\n-00014fe0: 6e63 7279 7074 696f 6e20 416c 676f 7269  ncryption Algori\n-00014ff0: 7468 6d73 2e0a 2020 2020 2020 2020 2020  thms..          \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 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 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*\n-00015040: 2065 7272 6f72 2063 6f64 6573 3a20 2020   error codes:   \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 00015050: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015060: 2020 2020 2020 2020 4572 726f 7220 4861          Error Ha\n-00015070: 6e64 6c69 6e67 2e20 2020 2020 2028 6c69  ndling.      (li\n-00015080: 6e65 2020 2036 290a 2a20 6572 726f 7220  ne   6).* error \n-00015090: 636f 6465 732c 2067 7067 6d65 2072 656c  codes, gpgme rel\n-000150a0: 6174 6564 3a20 2020 2020 2020 2020 2020  ated:           \n-000150b0: 2045 7272 6f72 2048 616e 646c 696e 672e   Error Handling.\n-000150c0: 2020 2020 2020 286c 696e 6520 3234 3129        (line 241)\n-000150d0: 0a2a 2065 7272 6f72 2068 616e 646c 696e  .* error handlin\n-000150e0: 673a 2020 2020 2020 2020 2020 2020 2020  g:              \n-000150f0: 2020 2020 2020 2020 2020 4572 726f 7220            Error \n-00015100: 4861 6e64 6c69 6e67 2e20 2020 2020 2028  Handling.      (\n-00015110: 6c69 6e65 2020 2036 290a 2a20 6572 726f  line   6).* erro\n-00015120: 7220 7374 7269 6e67 733a 2020 2020 2020  r strings:      \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+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: 2020 2045 7272 6f72 2048 616e 646c 696e     Error Handlin\n-00015150: 672e 2020 2020 2020 286c 696e 6520 2020  g.      (line   \n-00015160: 3629 0a2a 2046 6972 6577 616c 6c20 4b6e  6).* Firewall Kn\n-00015170: 6f63 6b20 4f70 6572 6174 6f72 2c20 696e  ock Operator, in\n-00015180: 7472 6f3a 2020 2020 2020 2020 496e 7472  tro:        Intr\n-00015190: 6f64 7563 7469 6f6e 2e20 2020 2020 2020  oduction.       \n-000151a0: 2028 6c69 6e65 2020 2036 290a 2a20 666b   (line   6).* fk\n-000151b0: 6f2e 683a 2020 2020 2020 2020 2020 2020  o.h:            \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 000151c0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000151d0: 2020 2020 206c 6962 666b 6f20 4865 6164       libfko Head\n-000151e0: 6572 2e20 2020 2020 2020 286c 696e 6520  er.       (line \n-000151f0: 2020 3629 0a2a 2066 776b 6e6f 703a 2020    6).* fwknop:  \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 00015200: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015210: 2020 2020 2020 2020 2020 2020 2020 496e                In\n-00015220: 7472 6f64 7563 7469 6f6e 2e20 2020 2020  troduction.     \n-00015230: 2020 2028 6c69 6e65 2020 2036 290a 2a20     (line   6).* \n-00015240: 6770 672d 7370 6563 6966 6963 2066 756e  gpg-specific fun\n-00015250: 6374 696f 6e73 3a20 2020 2020 2020 2020  ctions:         \n-00015260: 2020 2020 2020 2053 6574 7469 6e67 2053         Setting S\n-00015270: 5041 2044 6174 612e 2020 2020 286c 696e  PA Data.    (lin\n-00015280: 6520 3131 3229 0a2a 2067 7067 2d73 7065  e 112).* gpg-spe\n-00015290: 6369 6669 6320 6675 6e63 7469 6f6e 7320  cific functions \n-000152a0: 3c31 3e3a 2020 2020 2020 2020 2020 2020  <1>:            \n-000152b0: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D\n-000152c0: 6174 612e 2028 6c69 6e65 2031 3238 290a  ata. (line 128).\n-000152d0: 2a20 6770 672d 7370 6563 6966 6963 2066  * gpg-specific f\n-000152e0: 756e 6374 696f 6e73 203c 323e 3a20 2020  unctions <2>:   \n-000152f0: 2020 2020 2020 2020 2055 7469 6c69 7479           Utility\n-00015300: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l\n-00015310: 696e 6520 2035 3229 0a2a 2067 7067 2d73  ine  52).* gpg-s\n-00015320: 7065 6369 6669 6320 6675 6e63 7469 6f6e  pecific function\n-00015330: 7320 3c33 3e3a 2020 2020 2020 2020 2020  s <3>:          \n-00015340: 2020 4572 726f 7220 4861 6e64 6c69 6e67    Error Handling\n-00015350: 2e20 2020 2020 2028 6c69 6e65 2033 3130  .      (line 310\n-00015360: 290a 2a20 4750 4c76 322b 2c20 4765 6e65  ).* GPLv2+, Gene\n-00015370: 7261 6c20 5075 626c 6963 204c 6963 656e  ral Public Licen\n-00015380: 7365 3a20 2020 2020 2020 204c 6962 7261  se:        Libra\n-00015390: 7279 2043 6f70 7969 6e67 2e20 2020 2020  ry Copying.     \n-000153a0: 286c 696e 6520 2020 3629 0a2a 2068 6561  (line   6).* hea\n-000153b0: 6465 7220 6669 6c65 3a20 2020 2020 2020  der file:       \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 000153c0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000153d0: 2020 2020 6c69 6266 6b6f 2048 6561 6465      libfko Heade\n-000153e0: 722e 2020 2020 2020 2028 6c69 6e65 2020  r.       (line  \n-000153f0: 2036 290a 2a20 484d 4143 2064 6967 6573   6).* HMAC diges\n-00015400: 7420 7479 7065 733a 2020 2020 2020 2020  t types:        \n-00015410: 2020 2020 2020 2020 2020 2020 2048 4d41               HMA\n-00015420: 4320 4469 6765 7374 732e 2020 2020 2020  C Digests.      \n-00015430: 2020 286c 696e 6520 2020 3629 0a2a 2069    (line   6).* i\n-00015440: 6e63 6c75 6465 2066 696c 653a 2020 2020  nclude file:    \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 00015450: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015460: 2020 2020 2020 6c69 6266 6b6f 2048 6561        libfko Hea\n-00015470: 6465 722e 2020 2020 2020 2028 6c69 6e65  der.       (line\n-00015480: 2020 2036 290a 2a20 6c69 6e6b 696e 672c     6).* linking,\n-00015490: 2077 6974 6820 6c69 6266 6b6f 3a20 2020   with libfko:   \n-000154a0: 2020 2020 2020 2020 2020 2020 2020 2043                 C\n-000154b0: 6f6d 7069 6c69 6e67 2077 6974 6820 6c69  ompiling with li\n-000154c0: 6266 6b6f 2e0a 2020 2020 2020 2020 2020  bfko..          \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 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 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*\n-00015510: 206d 6573 7361 6765 2064 6967 6573 7420   message digest \n-00015520: 7479 7065 733a 2020 2020 2020 2020 2020  types:          \n-00015530: 2020 2020 2020 2020 4469 6765 7374 732e          Digests.\n-00015540: 2020 2020 2020 2020 2020 2020 2028 6c69               (li\n-00015550: 6e65 2020 2036 290a 2a20 6d65 7373 6167  ne   6).* messag\n-00015560: 6520 6469 6765 7374 2074 7970 6573 203c  e digest types <\n-00015570: 313e 3a20 2020 2020 2020 2020 2020 2020  1>:             \n-00015580: 2048 4d41 4320 4469 6765 7374 732e 2020   HMAC Digests.  \n-00015590: 2020 2020 2020 286c 696e 6520 2020 3629        (line   6)\n-000155a0: 0a2a 206d 6573 7361 6765 2074 7970 6573  .* message types\n-000155b0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               \n-000155c0: 2020 2020 2020 2020 2020 5350 4120 4d65            SPA Me\n-000155d0: 7373 6167 6573 2e20 2020 2020 2020 2028  ssages.        (\n-000155e0: 6c69 6e65 2020 2036 290a 2a20 5369 6e67  line   6).* Sing\n-000155f0: 6c65 2050 6163 6b65 7420 4175 7468 6f72  le Packet Author\n-00015600: 697a 6174 696f 6e2c 2069 6e74 726f 3a20  ization, intro: \n-00015610: 2020 2049 6e74 726f 6475 6374 696f 6e2e     Introduction.\n-00015620: 2020 2020 2020 2020 286c 696e 6520 2020          (line   \n-00015630: 3629 0a2a 2073 7061 2064 6174 612c 2072  6).* spa data, r\n-00015640: 6574 7269 6576 696e 6720 7661 6c75 6573  etrieving values\n-00015650: 3a20 2020 2020 2020 2020 2020 5265 7472  :           Retr\n-00015660: 6965 7669 6e67 2053 5041 2044 6174 612e  ieving SPA Data.\n-00015670: 2028 6c69 6e65 2020 2036 290a 2a20 7370   (line   6).* sp\n-00015680: 6120 6461 7461 2c20 7365 7474 696e 6720  a data, setting \n-00015690: 7661 6c75 6573 3a20 2020 2020 2020 2020  values:         \n-000156a0: 2020 2020 2053 6574 7469 6e67 2053 5041       Setting SPA\n-000156b0: 2044 6174 612e 2020 2020 286c 696e 6520   Data.    (line \n-000156c0: 2020 3629 0a2a 2073 7061 2064 6174 612c    6).* spa data,\n-000156d0: 2075 7469 6c69 7479 2066 756e 6374 696f   utility functio\n-000156e0: 6e73 3a20 2020 2020 2020 2020 2020 5574  ns:           Ut\n-000156f0: 696c 6974 7920 4675 6e63 7469 6f6e 732e  ility Functions.\n-00015700: 2020 2028 6c69 6e65 2020 2036 290a 2a20     (line   6).* \n-00015710: 7370 612c 2064 6174 6120 6372 6561 7469  spa, data creati\n-00015720: 6f6e 2063 6f64 6520 7361 6d70 6c65 3a20  on code sample: \n-00015730: 2020 2020 2020 2043 7265 6174 696e 6720         Creating \n-00015740: 6120 5350 4120 4d65 7373 6167 652e 0a20  a SPA Message.. \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+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 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 2020 2028 6c69               (li\n-00015790: 6e65 2020 2036 290a 2a20 5350 412c 2064  ne   6).* SPA, d\n-000157a0: 6174 6120 666f 726d 6174 3a20 2020 2020  ata format:     \n-000157b0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000157c0: 2053 5041 2044 6174 6120 466f 726d 6174   SPA Data Format\n-000157d0: 2e20 2020 2020 286c 696e 6520 2020 3629  .     (line   6)\n-000157e0: 0a2a 2053 5041 2c20 696e 7472 6f3a 2020  .* SPA, intro:  \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 000157f0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015800: 2020 2020 2020 2020 2020 496e 7472 6f64            Introd\n-00015810: 7563 7469 6f6e 2e20 2020 2020 2020 2028  uction.        (\n-00015820: 6c69 6e65 2020 2036 290a 2a20 7370 612c  line   6).* spa,\n-00015830: 206d 6573 7361 6765 2064 6174 6120 6372   message data cr\n-00015840: 6561 7469 6f6e 3a20 2020 2020 2020 2020  eation:         \n-00015850: 2020 2043 7265 6174 696e 6720 6120 5350     Creating a SP\n-00015860: 4120 4d65 7373 6167 652e 0a20 2020 2020  A Message..     \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 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 2020 2028 6c69 6e65 2020           (line  \n-000158b0: 2036 290a 2a20 7370 612c 206d 6573 7361   6).* spa, messa\n-000158c0: 6765 2074 7970 6573 3a20 2020 2020 2020  ge types:       \n-000158d0: 2020 2020 2020 2020 2020 2020 2053 5041               SPA\n-000158e0: 204d 6573 7361 6765 732e 2020 2020 2020   Messages.      \n-000158f0: 2020 286c 696e 6520 2020 3629 0a2a 2075    (line   6).* u\n-00015900: 7469 6c69 7479 2066 756e 6374 696f 6e73  tility functions\n-00015910: 3a20 2020 2020 2020 2020 2020 2020 2020  :               \n-00015920: 2020 2020 2020 5574 696c 6974 7920 4675        Utility Fu\n-00015930: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line\n-00015940: 2020 2036 290a 0a1f 0a46 696c 653a 206c     6)....File: l\n-00015950: 6962 666b 6f2e 696e 666f 2c20 204e 6f64  ibfko.info,  Nod\n-00015960: 653a 2046 756e 6374 696f 6e20 616e 6420  e: Function and \n-00015970: 4461 7461 2049 6e64 6578 2c20 2050 7265  Data Index,  Pre\n-00015980: 763a 2043 6f6e 6365 7074 2049 6e64 6578  v: Concept Index\n-00015990: 2c20 2055 703a 2054 6f70 0a0a 4675 6e63  ,  Up: Top..Func\n-000159a0: 7469 6f6e 2061 6e64 2044 6174 6120 496e  tion and Data In\n-000159b0: 6465 780a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  dex.************\n-000159c0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a00 085b  ***********....[\n-000159d0: 696e 6465 7800 085d 0a2a 204d 656e 753a  index..].* Menu:\n-000159e0: 0a0a 2a20 6572 726f 725f 636f 6465 3a20  ..* error_code: \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+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 000159f0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015a00: 2020 2020 2020 2020 2020 2045 7272 6f72             Error\n-00015a10: 2048 616e 646c 696e 672e 2020 2020 2020   Handling.      \n-00015a20: 286c 696e 6520 2031 3829 0a2a 2065 7272  (line  18).* err\n-00015a30: 6f72 5f63 6f64 6520 3c31 3e3a 2020 2020  or_code <1>:    \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 00015a40: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015a50: 2020 2020 4572 726f 7220 4861 6e64 6c69      Error Handli\n-00015a60: 6e67 2e20 2020 2020 2028 6c69 6e65 2032  ng.      (line 2\n-00015a70: 3431 290a 2a20 666b 6f5f 6465 636f 6465  41).* fko_decode\n-00015a80: 5f73 7061 5f64 6174 613a 2020 2020 2020  _spa_data:      \n-00015a90: 2020 2020 2020 2020 2020 2020 2055 7469               Uti\n-00015aa0: 6c69 7479 2046 756e 6374 696f 6e73 2e20  lity Functions. \n-00015ab0: 2020 286c 696e 6520 2033 3829 0a2a 2066    (line  38).* f\n-00015ac0: 6b6f 5f64 6563 7279 7074 5f73 7061 5f64  ko_decrypt_spa_d\n-00015ad0: 6174 613a 2020 2020 2020 2020 2020 2020  ata:            \n-00015ae0: 2020 2020 2020 5574 696c 6974 7920 4675        Utility Fu\n-00015af0: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line\n-00015b00: 2020 3233 290a 2a20 666b 6f5f 6465 7374    23).* fko_dest\n-00015b10: 726f 793a 2020 2020 2020 2020 2020 2020  roy:            \n-00015b20: 2020 2020 2020 2020 2020 2020 2020 2044                 D\n-00015b30: 6573 7472 6f79 696e 6720 436f 6e74 6578  estroying Contex\n-00015b40: 7473 2e20 286c 696e 6520 2031 3129 0a2a  ts. (line  11).*\n-00015b50: 2066 6b6f 5f64 6967 6573 745f 7479 7065   fko_digest_type\n-00015b60: 5f74 3a20 2020 2020 2020 2020 2020 2020  _t:             \n-00015b70: 2020 2020 2020 2020 4469 6765 7374 732e          Digests.\n-00015b80: 2020 2020 2020 2020 2020 2020 2028 6c69               (li\n-00015b90: 6e65 2020 3137 290a 2a20 666b 6f5f 6469  ne  17).* fko_di\n-00015ba0: 6765 7374 5f74 7970 655f 7420 3c31 3e3a  gest_type_t <1>:\n-00015bb0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015bc0: 2048 4d41 4320 4469 6765 7374 732e 2020   HMAC Digests.  \n-00015bd0: 2020 2020 2020 286c 696e 6520 2031 3429        (line  14)\n-00015be0: 0a2a 2066 6b6f 5f65 6e63 6f64 655f 7370  .* fko_encode_sp\n-00015bf0: 615f 6461 7461 3a20 2020 2020 2020 2020  a_data:         \n-00015c00: 2020 2020 2020 2020 2020 5574 696c 6974            Utilit\n-00015c10: 7920 4675 6e63 7469 6f6e 732e 2020 2028  y Functions.   (\n-00015c20: 6c69 6e65 2020 3434 290a 2a20 666b 6f5f  line  44).* fko_\n-00015c30: 656e 6372 7970 7469 6f6e 5f74 7970 655f  encryption_type_\n-00015c40: 743a 2020 2020 2020 2020 2020 2020 2020  t:              \n-00015c50: 2020 2045 6e63 7279 7074 696f 6e20 416c     Encryption Al\n-00015c60: 676f 7269 7468 6d73 2e0a 2020 2020 2020  gorithms..      \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 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 2020 286c 696e 6520 2031          (line  1\n-00015cb0: 3029 0a2a 2066 6b6f 5f65 6e63 7279 7074  0).* fko_encrypt\n-00015cc0: 5f73 7061 5f64 6174 613a 2020 2020 2020  _spa_data:      \n-00015cd0: 2020 2020 2020 2020 2020 2020 5574 696c              Util\n-00015ce0: 6974 7920 4675 6e63 7469 6f6e 732e 2020  ity Functions.  \n-00015cf0: 2028 6c69 6e65 2020 3332 290a 2a20 666b   (line  32).* fk\n-00015d00: 6f5f 6572 7273 7472 3a20 2020 2020 2020  o_errstr:       \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 00015d10: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015d20: 2020 2020 2045 7272 6f72 2048 616e 646c       Error Handl\n-00015d30: 696e 672e 2020 2020 2020 286c 696e 6520  ing.      (line \n-00015d40: 2031 3129 0a2a 2066 6b6f 5f67 6574 5f65   11).* fko_get_e\n-00015d50: 6e63 6f64 6564 5f64 6174 613a 2020 2020  ncoded_data:    \n-00015d60: 2020 2020 2020 2020 2020 2020 2020 5265                Re\n-00015d70: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat\n-00015d80: 612e 2028 6c69 6e65 2031 3133 290a 2a20  a. (line 113).* \n-00015d90: 666b 6f5f 6765 745f 6770 675f 6578 653a  fko_get_gpg_exe:\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 00015da0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015db0: 2020 2020 2020 2052 6574 7269 6576 696e         Retrievin\n-00015dc0: 6720 5350 4120 4461 7461 2e20 286c 696e  g SPA Data. (lin\n-00015dd0: 6520 3138 3229 0a2a 2066 6b6f 5f67 6574  e 182).* fko_get\n-00015de0: 5f67 7067 5f68 6f6d 655f 6469 723a 2020  _gpg_home_dir:  \n-00015df0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00015e00: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D\n-00015e10: 6174 612e 2028 6c69 6e65 2031 3431 290a  ata. (line 141).\n-00015e20: 2a20 666b 6f5f 6765 745f 6770 675f 6967  * fko_get_gpg_ig\n-00015e30: 6e6f 7265 5f76 6572 6966 795f 6572 726f  nore_verify_erro\n-00015e40: 723a 2020 2020 2020 2052 6574 7269 6576  r:       Retriev\n-00015e50: 696e 6720 5350 4120 4461 7461 2e20 286c  ing SPA Data. (l\n-00015e60: 696e 6520 3135 3229 0a2a 2066 6b6f 5f67  ine 152).* fko_g\n-00015e70: 6574 5f67 7067 5f72 6563 6970 6965 6e74  et_gpg_recipient\n-00015e80: 3a20 2020 2020 2020 2020 2020 2020 2020  :               \n-00015e90: 2020 5265 7472 6965 7669 6e67 2053 5041    Retrieving SPA\n-00015ea0: 2044 6174 612e 2028 6c69 6e65 2031 3330   Data. (line 130\n-00015eb0: 290a 2a20 666b 6f5f 6765 745f 6770 675f  ).* fko_get_gpg_\n-00015ec0: 7369 676e 6174 7572 655f 6670 723a 2020  signature_fpr:  \n-00015ed0: 2020 2020 2020 2020 2020 2052 6574 7269             Retri\n-00015ee0: 6576 696e 6720 5350 4120 4461 7461 2e20  eving SPA Data. \n-00015ef0: 286c 696e 6520 3136 3429 0a2a 2066 6b6f  (line 164).* fko\n-00015f00: 5f67 6574 5f67 7067 5f73 6967 6e61 7475  _get_gpg_signatu\n-00015f10: 7265 5f69 643a 2020 2020 2020 2020 2020  re_id:          \n-00015f20: 2020 2020 5265 7472 6965 7669 6e67 2053      Retrieving S\n-00015f30: 5041 2044 6174 612e 2028 6c69 6e65 2031  PA Data. (line 1\n-00015f40: 3538 290a 2a20 666b 6f5f 6765 745f 6770  58).* fko_get_gp\n-00015f50: 675f 7369 676e 6174 7572 655f 7374 6174  g_signature_stat\n-00015f60: 7573 3a20 2020 2020 2020 2020 2052 6574  us:          Ret\n-00015f70: 7269 6576 696e 6720 5350 4120 4461 7461  rieving SPA Data\n-00015f80: 2e20 286c 696e 6520 3137 3629 0a2a 2066  . (line 176).* f\n-00015f90: 6b6f 5f67 6574 5f67 7067 5f73 6967 6e61  ko_get_gpg_signa\n-00015fa0: 7475 7265 5f73 756d 6d61 7279 3a20 2020  ture_summary:   \n-00015fb0: 2020 2020 2020 5265 7472 6965 7669 6e67        Retrieving\n-00015fc0: 2053 5041 2044 6174 612e 2028 6c69 6e65   SPA Data. (line\n-00015fd0: 2031 3730 290a 2a20 666b 6f5f 6765 745f   170).* fko_get_\n-00015fe0: 6770 675f 7369 676e 6174 7572 655f 7665  gpg_signature_ve\n-00015ff0: 7269 6679 3a20 2020 2020 2020 2020 2052  rify:          R\n-00016000: 6574 7269 6576 696e 6720 5350 4120 4461  etrieving SPA Da\n-00016010: 7461 2e20 286c 696e 6520 3134 3629 0a2a  ta. (line 146).*\n-00016020: 2066 6b6f 5f67 6574 5f67 7067 5f73 6967   fko_get_gpg_sig\n-00016030: 6e65 723a 2020 2020 2020 2020 2020 2020  ner:            \n-00016040: 2020 2020 2020 2020 5265 7472 6965 7669          Retrievi\n-00016050: 6e67 2053 5041 2044 6174 612e 2028 6c69  ng SPA Data. (li\n-00016060: 6e65 2031 3336 290a 2a20 666b 6f5f 6765  ne 136).* fko_ge\n-00016070: 745f 7261 6e64 5f76 616c 7565 3a20 2020  t_rand_value:   \n-00016080: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00016090: 2052 6574 7269 6576 696e 6720 5350 4120   Retrieving SPA \n-000160a0: 4461 7461 2e20 286c 696e 6520 2031 3829  Data. (line  18)\n-000160b0: 0a2a 2066 6b6f 5f67 6574 5f73 7061 5f63  .* fko_get_spa_c\n-000160c0: 6c69 656e 745f 7469 6d65 6f75 743a 2020  lient_timeout:  \n-000160d0: 2020 2020 2020 2020 2020 5265 7472 6965            Retrie\n-000160e0: 7669 6e67 2053 5041 2044 6174 612e 2028  ving SPA Data. (\n-000160f0: 6c69 6e65 2020 3735 290a 2a20 666b 6f5f  line  75).* fko_\n-00016100: 6765 745f 7370 615f 6461 7461 3a20 2020  get_spa_data:   \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: 2020 2052 6574 7269 6576 696e 6720 5350     Retrieving SP\n-00016130: 4120 4461 7461 2e20 286c 696e 6520 2031  A Data. (line  1\n-00016140: 3229 0a2a 2066 6b6f 5f67 6574 5f73 7061  2).* fko_get_spa\n-00016150: 5f64 6967 6573 743a 2020 2020 2020 2020  _digest:        \n-00016160: 2020 2020 2020 2020 2020 2020 5265 7472              Retr\n-00016170: 6965 7669 6e67 2053 5041 2044 6174 612e  ieving SPA Data.\n-00016180: 2028 6c69 6e65 2020 3935 290a 2a20 666b   (line  95).* fk\n-00016190: 6f5f 6765 745f 7370 615f 6469 6765 7374  o_get_spa_digest\n-000161a0: 5f74 7970 653a 2020 2020 2020 2020 2020  _type:          \n-000161b0: 2020 2020 2052 6574 7269 6576 696e 6720       Retrieving \n-000161c0: 5350 4120 4461 7461 2e20 286c 696e 6520  SPA Data. (line \n-000161d0: 2038 3129 0a2a 2066 6b6f 5f67 6574 5f73   81).* fko_get_s\n-000161e0: 7061 5f65 6e63 7279 7074 696f 6e5f 7479  pa_encryption_ty\n-000161f0: 7065 3a20 2020 2020 2020 2020 2020 5265  pe:           Re\n-00016200: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat\n-00016210: 612e 2028 6c69 6e65 2031 3035 290a 2a20  a. (line 105).* \n-00016220: 666b 6f5f 6765 745f 7370 615f 686d 6163  fko_get_spa_hmac\n-00016230: 3a20 2020 2020 2020 2020 2020 2020 2020  :               \n-00016240: 2020 2020 2020 2052 6574 7269 6576 696e         Retrievin\n-00016250: 6720 5350 4120 4461 7461 2e20 286c 696e  g SPA Data. (lin\n-00016260: 6520 3130 3029 0a2a 2066 6b6f 5f67 6574  e 100).* fko_get\n-00016270: 5f73 7061 5f68 6d61 635f 7479 7065 3a20  _spa_hmac_type: \n-00016280: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00016290: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D\n-000162a0: 6174 612e 2028 6c69 6e65 2020 3838 290a  ata. (line  88).\n-000162b0: 2a20 666b 6f5f 6765 745f 7370 615f 6d65  * fko_get_spa_me\n-000162c0: 7373 6167 653a 2020 2020 2020 2020 2020  ssage:          \n-000162d0: 2020 2020 2020 2020 2052 6574 7269 6576           Retriev\n-000162e0: 696e 6720 5350 4120 4461 7461 2e20 286c  ing SPA Data. (l\n-000162f0: 696e 6520 2035 3629 0a2a 2066 6b6f 5f67  ine  56).* fko_g\n-00016300: 6574 5f73 7061 5f6d 6573 7361 6765 5f74  et_spa_message_t\n-00016310: 7970 653a 2020 2020 2020 2020 2020 2020  ype:            \n-00016320: 2020 5265 7472 6965 7669 6e67 2053 5041    Retrieving SPA\n-00016330: 2044 6174 612e 2028 6c69 6e65 2020 3334   Data. (line  34\n-00016340: 290a 2a20 666b 6f5f 6765 745f 7370 615f  ).* fko_get_spa_\n-00016350: 6e61 745f 6163 6365 7373 3a20 2020 2020  nat_access:     \n-00016360: 2020 2020 2020 2020 2020 2052 6574 7269             Retri\n-00016370: 6576 696e 6720 5350 4120 4461 7461 2e20  eving SPA Data. \n-00016380: 286c 696e 6520 2036 3129 0a2a 2066 6b6f  (line  61).* fko\n-00016390: 5f67 6574 5f73 7061 5f73 6572 7665 725f  _get_spa_server_\n-000163a0: 6175 7468 3a20 2020 2020 2020 2020 2020  auth:           \n-000163b0: 2020 2020 5265 7472 6965 7669 6e67 2053      Retrieving S\n-000163c0: 5041 2044 6174 612e 2028 6c69 6e65 2020  PA Data. (line  \n-000163d0: 3638 290a 2a20 666b 6f5f 6765 745f 7469  68).* fko_get_ti\n-000163e0: 6d65 7374 616d 703a 2020 2020 2020 2020  mestamp:        \n-000163f0: 2020 2020 2020 2020 2020 2020 2052 6574               Ret\n-00016400: 7269 6576 696e 6720 5350 4120 4461 7461  rieving SPA Data\n-00016410: 2e20 286c 696e 6520 2032 3929 0a2a 2066  . (line  29).* f\n-00016420: 6b6f 5f67 6574 5f75 7365 726e 616d 653a  ko_get_username:\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+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 00016430: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00016440: 2020 2020 2020 5265 7472 6965 7669 6e67        Retrieving\n-00016450: 2053 5041 2044 6174 612e 2028 6c69 6e65   SPA Data. (line\n-00016460: 2020 3234 290a 2a20 666b 6f5f 6765 745f    24).* fko_get_\n-00016470: 7665 7273 696f 6e3a 2020 2020 2020 2020  version:        \n-00016480: 2020 2020 2020 2020 2020 2020 2020 2052                 R\n-00016490: 6574 7269 6576 696e 6720 5350 4120 4461  etrieving SPA Da\n-000164a0: 7461 2e20 286c 696e 6520 3132 3029 0a2a  ta. (line 120).*\n-000164b0: 2066 6b6f 5f67 7067 5f65 7272 7374 723a   fko_gpg_errstr:\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 000164c0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000164d0: 2020 2020 2020 2020 4572 726f 7220 4861          Error Ha\n-000164e0: 6e64 6c69 6e67 2e20 2020 2020 2028 6c69  ndling.      (li\n-000164f0: 6e65 2033 3130 290a 2a20 666b 6f5f 6770  ne 310).* fko_gp\n-00016500: 675f 7369 676e 6174 7572 655f 6670 725f  g_signature_fpr_\n-00016510: 6d61 7463 683a 2020 2020 2020 2020 2020  match:          \n-00016520: 2055 7469 6c69 7479 2046 756e 6374 696f   Utility Functio\n-00016530: 6e73 2e20 2020 286c 696e 6520 2036 3129  ns.   (line  61)\n-00016540: 0a2a 2066 6b6f 5f67 7067 5f73 6967 6e61  .* fko_gpg_signa\n-00016550: 7475 7265 5f69 645f 6d61 7463 683a 2020  ture_id_match:  \n-00016560: 2020 2020 2020 2020 2020 5574 696c 6974            Utilit\n-00016570: 7920 4675 6e63 7469 6f6e 732e 2020 2028  y Functions.   (\n-00016580: 6c69 6e65 2020 3534 290a 2a20 666b 6f5f  line  54).* fko_\n-00016590: 6d65 7373 6167 655f 7479 7065 5f74 3a20  message_type_t: \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: 2020 2053 5041 204d 6573 7361 6765 732e     SPA Messages.\n-000165c0: 2020 2020 2020 2020 286c 696e 6520 2031          (line  1\n-000165d0: 3129 0a2a 2066 6b6f 5f6e 6577 3a20 2020  1).* fko_new:   \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 000165e0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000165f0: 2020 2020 2020 2020 2020 2020 4372 6561              Crea\n-00016600: 7469 6e67 2043 6f6e 7465 7874 732e 2020  ting Contexts.  \n-00016610: 2028 6c69 6e65 2020 3135 290a 2a20 666b   (line  15).* fk\n-00016620: 6f5f 6e65 775f 7769 7468 5f64 6174 613a  o_new_with_data:\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 00016630: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00016640: 2020 2020 2043 7265 6174 696e 6720 436f       Creating Co\n-00016650: 6e74 6578 7473 2e20 2020 286c 696e 6520  ntexts.   (line \n-00016660: 2033 3829 0a2a 2066 6b6f 5f73 6574 5f67   38).* fko_set_g\n-00016670: 7067 5f65 7865 3a20 2020 2020 2020 2020  pg_exe:         \n-00016680: 2020 2020 2020 2020 2020 2020 2020 5365                Se\n-00016690: 7474 696e 6720 5350 4120 4461 7461 2e20  tting SPA Data. \n-000166a0: 2020 2028 6c69 6e65 2031 3436 290a 2a20     (line 146).* \n-000166b0: 666b 6f5f 7365 745f 6770 675f 686f 6d65  fko_set_gpg_home\n-000166c0: 5f64 6972 3a20 2020 2020 2020 2020 2020  _dir:           \n-000166d0: 2020 2020 2020 2053 6574 7469 6e67 2053         Setting S\n-000166e0: 5041 2044 6174 612e 2020 2020 286c 696e  PA Data.    (lin\n-000166f0: 6520 3132 3629 0a2a 2066 6b6f 5f73 6574  e 126).* fko_set\n-00016700: 5f67 7067 5f69 676e 6f72 655f 7665 7269  _gpg_ignore_veri\n-00016710: 6679 5f65 7272 6f72 3a20 2020 2020 2020  fy_error:       \n-00016720: 5365 7474 696e 6720 5350 4120 4461 7461  Setting SPA Data\n-00016730: 2e20 2020 2028 6c69 6e65 2031 3339 290a  .    (line 139).\n-00016740: 2a20 666b 6f5f 7365 745f 6770 675f 7265  * fko_set_gpg_re\n-00016750: 6369 7069 656e 743a 2020 2020 2020 2020  cipient:        \n-00016760: 2020 2020 2020 2020 2053 6574 7469 6e67           Setting\n-00016770: 2053 5041 2044 6174 612e 2020 2020 286c   SPA Data.    (l\n-00016780: 696e 6520 3131 3429 0a2a 2066 6b6f 5f73  ine 114).* fko_s\n-00016790: 6574 5f67 7067 5f73 6967 6e61 7475 7265  et_gpg_signature\n-000167a0: 5f76 6572 6966 793a 2020 2020 2020 2020  _verify:        \n-000167b0: 2020 5365 7474 696e 6720 5350 4120 4461    Setting SPA Da\n-000167c0: 7461 2e20 2020 2028 6c69 6e65 2031 3331  ta.    (line 131\n-000167d0: 290a 2a20 666b 6f5f 7365 745f 6770 675f  ).* fko_set_gpg_\n-000167e0: 7369 676e 6572 3a20 2020 2020 2020 2020  signer:         \n-000167f0: 2020 2020 2020 2020 2020 2053 6574 7469             Setti\n-00016800: 6e67 2053 5041 2044 6174 612e 2020 2020  ng SPA Data.    \n-00016810: 286c 696e 6520 3132 3129 0a2a 2066 6b6f  (line 121).* fko\n-00016820: 5f73 6574 5f72 616e 645f 7661 6c75 653a  _set_rand_value:\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 00016830: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00016840: 2020 2020 5365 7474 696e 6720 5350 4120      Setting SPA \n-00016850: 4461 7461 2e20 2020 2028 6c69 6e65 2020  Data.    (line  \n-00016860: 3334 290a 2a20 666b 6f5f 7365 745f 7370  34).* fko_set_sp\n-00016870: 615f 636c 6965 6e74 5f74 696d 656f 7574  a_client_timeout\n-00016880: 3a20 2020 2020 2020 2020 2020 2053 6574  :            Set\n-00016890: 7469 6e67 2053 5041 2044 6174 612e 2020  ting SPA Data.  \n-000168a0: 2020 286c 696e 6520 2038 3029 0a2a 2066    (line  80).* f\n-000168b0: 6b6f 5f73 6574 5f73 7061 5f64 6174 613a  ko_set_spa_data:\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 000168c0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-000168d0: 2020 2020 2020 5365 7474 696e 6720 5350        Setting SP\n-000168e0: 4120 4461 7461 2e20 2020 2028 6c69 6e65  A Data.    (line\n-000168f0: 2031 3035 290a 2a20 666b 6f5f 7365 745f   105).* fko_set_\n-00016900: 7370 615f 6469 6765 7374 3a20 2020 2020  spa_digest:     \n-00016910: 2020 2020 2020 2020 2020 2020 2020 2053                 S\n-00016920: 6574 7469 6e67 2053 5041 2044 6174 612e  etting SPA Data.\n-00016930: 2020 2020 286c 696e 6520 2038 3929 0a2a      (line  89).*\n-00016940: 2066 6b6f 5f73 6574 5f73 7061 5f64 6967   fko_set_spa_dig\n-00016950: 6573 745f 7479 7065 3a20 2020 2020 2020  est_type:       \n-00016960: 2020 2020 2020 2020 5365 7474 696e 6720          Setting \n-00016970: 5350 4120 4461 7461 2e20 2020 2028 6c69  SPA Data.    (li\n-00016980: 6e65 2020 3131 290a 2a20 666b 6f5f 7365  ne  11).* fko_se\n-00016990: 745f 7370 615f 656e 6372 7970 7469 6f6e  t_spa_encryption\n-000169a0: 5f74 7970 653a 2020 2020 2020 2020 2020  _type:          \n-000169b0: 2053 6574 7469 6e67 2053 5041 2044 6174   Setting SPA Dat\n-000169c0: 612e 2020 2020 286c 696e 6520 2032 3729  a.    (line  27)\n-000169d0: 0a2a 2066 6b6f 5f73 6574 5f73 7061 5f68  .* fko_set_spa_h\n-000169e0: 6d61 633a 2020 2020 2020 2020 2020 2020  mac:            \n-000169f0: 2020 2020 2020 2020 2020 5365 7474 696e            Settin\n-00016a00: 6720 5350 4120 4461 7461 2e20 2020 2028  g SPA Data.    (\n-00016a10: 6c69 6e65 2020 3937 290a 2a20 666b 6f5f  line  97).* fko_\n-00016a20: 7365 745f 7370 615f 686d 6163 5f74 7970  set_spa_hmac_typ\n-00016a30: 653a 2020 2020 2020 2020 2020 2020 2020  e:              \n-00016a40: 2020 2053 6574 7469 6e67 2053 5041 2044     Setting SPA D\n-00016a50: 6174 612e 2020 2020 286c 696e 6520 2031  ata.    (line  1\n-00016a60: 3929 0a2a 2066 6b6f 5f73 6574 5f73 7061  9).* fko_set_spa\n-00016a70: 5f6d 6573 7361 6765 3a20 2020 2020 2020  _message:       \n-00016a80: 2020 2020 2020 2020 2020 2020 5365 7474              Sett\n-00016a90: 696e 6720 5350 4120 4461 7461 2e20 2020  ing SPA Data.   \n-00016aa0: 2028 6c69 6e65 2020 3633 290a 2a20 666b   (line  63).* fk\n-00016ab0: 6f5f 7365 745f 7370 615f 6d65 7373 6167  o_set_spa_messag\n-00016ac0: 655f 7479 7065 3a20 2020 2020 2020 2020  e_type:         \n-00016ad0: 2020 2020 2053 6574 7469 6e67 2053 5041       Setting SPA\n-00016ae0: 2044 6174 612e 2020 2020 286c 696e 6520   Data.    (line \n-00016af0: 2035 3629 0a2a 2066 6b6f 5f73 6574 5f73   56).* fko_set_s\n-00016b00: 7061 5f6e 6174 5f61 6363 6573 733a 2020  pa_nat_access:  \n-00016b10: 2020 2020 2020 2020 2020 2020 2020 5365                Se\n-00016b20: 7474 696e 6720 5350 4120 4461 7461 2e20  tting SPA Data. \n-00016b30: 2020 2028 6c69 6e65 2020 3639 290a 2a20     (line  69).* \n-00016b40: 666b 6f5f 7365 745f 7370 615f 7365 7276  fko_set_spa_serv\n-00016b50: 6572 5f61 7574 683a 2020 2020 2020 2020  er_auth:        \n-00016b60: 2020 2020 2020 2053 6574 7469 6e67 2053         Setting S\n-00016b70: 5041 2044 6174 612e 2020 2020 286c 696e  PA Data.    (lin\n-00016b80: 6520 2037 3529 0a2a 2066 6b6f 5f73 6574  e  75).* fko_set\n-00016b90: 5f74 696d 6573 7461 6d70 3a20 2020 2020  _timestamp:     \n-00016ba0: 2020 2020 2020 2020 2020 2020 2020 2020                  \n-00016bb0: 5365 7474 696e 6720 5350 4120 4461 7461  Setting SPA Data\n-00016bc0: 2e20 2020 2028 6c69 6e65 2020 3532 290a  .    (line  52).\n-00016bd0: 2a20 666b 6f5f 7365 745f 7573 6572 6e61  * fko_set_userna\n-00016be0: 6d65 3a20 2020 2020 2020 2020 2020 2020  me:             \n-00016bf0: 2020 2020 2020 2020 2053 6574 7469 6e67           Setting\n-00016c00: 2053 5041 2044 6174 612e 2020 2020 286c   SPA Data.    (l\n-00016c10: 696e 6520 2034 3229 0a2a 2066 6b6f 5f73  ine  42).* fko_s\n-00016c20: 7061 5f64 6174 615f 6669 6e61 6c3a 2020  pa_data_final:  \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: 2020 5574 696c 6974 7920 4675 6e63 7469    Utility Functi\n-00016c50: 6f6e 732e 2020 2028 6c69 6e65 2020 3136  ons.   (line  16\n-00016c60: 290a 2a20 7370 615f 6d65 7373 6167 655f  ).* spa_message_\n-00016c70: 6669 656c 6473 3a20 2020 2020 2020 2020  fields:         \n-00016c80: 2020 2020 2020 2020 2020 2053 5041 2044             SPA D\n-00016c90: 6174 6120 466f 726d 6174 2e20 2020 2020  ata Format.     \n-00016ca0: 286c 696e 6520 2031 3229 0a0a 0a1f 0a54  (line  12).....T\n-00016cb0: 6167 2054 6162 6c65 3a0a 4e6f 6465 3a20  ag Table:.Node: \n-00016cc0: 546f 707f 3131 3230 0a4e 6f64 653a 2049  Top.1120.Node: I\n-00016cd0: 6e74 726f 6475 6374 696f 6e7f 3433 3139  ntroduction.4319\n-00016ce0: 0a4e 6f64 653a 2047 6574 7469 6e67 2053  .Node: Getting S\n-00016cf0: 7461 7274 6564 7f36 3032 390a 4e6f 6465  tarted.6029.Node\n-00016d00: 3a20 4665 6174 7572 6573 7f36 3632 350a  : Features.6625.\n-00016d10: 4e6f 6465 3a20 4f76 6572 7669 6577 7f37  Node: Overview.7\n-00016d20: 3638 330a 4e6f 6465 3a20 5350 4120 4461  683.Node: SPA Da\n-00016d30: 7461 2046 6f72 6d61 747f 3837 3432 0a4e  ta Format.8742.N\n-00016d40: 6f64 653a 2050 7265 7061 7261 7469 6f6e  ode: Preparation\n-00016d50: 7f31 3133 3738 0a4e 6f64 653a 206c 6962  .11378.Node: lib\n-00016d60: 666b 6f20 4865 6164 6572 7f31 3139 3338  fko Header.11938\n-00016d70: 0a4e 6f64 653a 2043 6f6d 7069 6c69 6e67  .Node: Compiling\n-00016d80: 2077 6974 6820 6c69 6266 6b6f 7f31 3234   with libfko.124\n-00016d90: 3831 0a4e 6f64 653a 2053 5041 2050 6172  81.Node: SPA Par\n-00016da0: 616d 6574 6572 2054 7970 6573 7f31 3335  ameter Types.135\n-00016db0: 3636 0a4e 6f64 653a 2044 6967 6573 7473  66.Node: Digests\n-00016dc0: 7f31 3430 3738 0a4e 6f64 653a 2053 5041  .14078.Node: SPA\n-00016dd0: 204d 6573 7361 6765 737f 3135 3134 310a   Messages.15141.\n-00016de0: 4e6f 6465 3a20 456e 6372 7970 7469 6f6e  Node: Encryption\n-00016df0: 2041 6c67 6f72 6974 686d 737f 3137 3236   Algorithms.1726\n-00016e00: 310a 4e6f 6465 3a20 484d 4143 2044 6967  1.Node: HMAC Dig\n-00016e10: 6573 7473 7f31 3833 3939 0a4e 6f64 653a  ests.18399.Node:\n-00016e20: 2055 7369 6e67 206c 6962 666b 6f7f 3139   Using libfko.19\n-00016e30: 3330 300a 4e6f 6465 3a20 4372 6561 7469  300.Node: Creati\n-00016e40: 6e67 2043 6f6e 7465 7874 737f 3230 3133  ng Contexts.2013\n-00016e50: 390a 4e6f 6465 3a20 4465 7374 726f 7969  9.Node: Destroyi\n-00016e60: 6e67 2043 6f6e 7465 7874 737f 3235 3132  ng Contexts.2512\n-00016e70: 360a 4e6f 6465 3a20 4372 6561 7469 6e67  6.Node: Creating\n-00016e80: 2061 2053 5041 204d 6573 7361 6765 7f32   a SPA Message.2\n-00016e90: 3537 3437 0a4e 6f64 653a 2053 6574 7469  5747.Node: Setti\n-00016ea0: 6e67 2053 5041 2044 6174 617f 3330 3538  ng SPA Data.3058\n-00016eb0: 310a 4e6f 6465 3a20 5265 7472 6965 7669  1.Node: Retrievi\n-00016ec0: 6e67 2053 5041 2044 6174 617f 3338 3134  ng SPA Data.3814\n-00016ed0: 320a 4e6f 6465 3a20 5574 696c 6974 7920  2.Node: Utility \n-00016ee0: 4675 6e63 7469 6f6e 737f 3437 3132 350a  Functions.47125.\n-00016ef0: 4e6f 6465 3a20 4572 726f 7220 4861 6e64  Node: Error Hand\n-00016f00: 6c69 6e67 7f35 3035 3036 0a4e 6f64 653a  ling.50506.Node:\n-00016f10: 204c 6962 7261 7279 2043 6f70 7969 6e67   Library Copying\n-00016f20: 7f36 3538 3532 0a4e 6f64 653a 2043 6f6e  .65852.Node: Con\n-00016f30: 6365 7074 2049 6e64 6578 7f38 3531 3434  cept Index.85144\n-00016f40: 0a4e 6f64 653a 2046 756e 6374 696f 6e20  .Node: Function \n-00016f50: 616e 6420 4461 7461 2049 6e64 6578 7f38  and Data Index.8\n-00016f60: 3833 3931 0a1f 0a45 6e64 2054 6167 2054  8391...End Tag T\n-00016f70: 6162 6c65 0a0a 1f0a 4c6f 6361 6c20 5661  able....Local Va\n-00016f80: 7269 6162 6c65 733a 0a63 6f64 696e 673a  riables:.coding:\n-00016f90: 2075 7466 2d38 0a45 6e64 3a0a             utf-8.End:.\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"}]}]}]}]}]}