--- /srv/reproducible-results/rbuild-debian/r-b-build.fuPHIY1N/b1/fwknop_2.6.10-16_arm64.changes
+++ /srv/reproducible-results/rbuild-debian/r-b-build.fuPHIY1N/b2/fwknop_2.6.10-16_arm64.changes
├── Files
│ @@ -1,12 +1,12 @@
│  
│   8ed6a3bb75179a6688e7936b452d7b26 23260 admin optional fwknop-apparmor-profile_2.6.10-16_all.deb
│   d6d296ddd1bd5663f03514fb0c5bfde5 82768 debug optional fwknop-client-dbgsym_2.6.10-16_arm64.deb
│   926d0cb3f75089b78f21433326eb7de5 69440 admin optional fwknop-client_2.6.10-16_arm64.deb
│   0b2a5118296574cd2c7630247e372150 132348 debug optional fwknop-server-dbgsym_2.6.10-16_arm64.deb
│   39b42adddeaf0f95010b5733d3a44576 99776 admin optional fwknop-server_2.6.10-16_arm64.deb
│ - df47ba2dd49eeed74465bc952ca0b1bf 49392 doc optional libfko-doc_2.6.10-16_all.deb
│ + 7bff9ed7992b03e614701e5307b54c24 49396 doc optional libfko-doc_2.6.10-16_all.deb
│   ad0cd042a8bd238e5b7e4403ed1889cb 67556 debug optional libfko-perl-dbgsym_2.6.10-16_arm64.deb
│   1c0cd71f1f97946bfd564ab296e6c872 48272 perl optional libfko-perl_2.6.10-16_arm64.deb
│   b1691678eef1d262e56b994d081be08e 106952 debug optional libfko3-dbgsym_2.6.10-16_arm64.deb
│ - f1bdbb2baa61e074ffe6e4072d16ae0b 91772 libdevel optional libfko3-dev_2.6.10-16_arm64.deb
│ + 7fc2e207274291439b74e42bc5fb133e 91760 libdevel optional libfko3-dev_2.6.10-16_arm64.deb
│   39ba7d3b83bf7c377abd506d18129ed1 58112 libs optional libfko3_2.6.10-16_arm64.deb
├── libfko-doc_2.6.10-16_all.deb
│ ├── file list
│ │ @@ -1,3 +1,3 @@
│ │  -rw-r--r--   0        0        0        4 2023-04-11 03:52:01.000000 debian-binary
│ │ --rw-r--r--   0        0        0     1740 2023-04-11 03:52:01.000000 control.tar.xz
│ │ +-rw-r--r--   0        0        0     1744 2023-04-11 03:52:01.000000 control.tar.xz
│ │  -rw-r--r--   0        0        0    47460 2023-04-11 03:52:01.000000 data.tar.xz
│ ├── control.tar.xz
│ │ ├── control.tar
│ │ │ ├── ./md5sums
│ │ │ │ ├── ./md5sums
│ │ │ │ │┄ Files differ
│ ├── data.tar.xz
│ │ ├── data.tar
│ │ │ ├── file list
│ │ │ │ @@ -3,34 +3,34 @@
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/doc/
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1453 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/changelog.Debian.gz
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)    17337 2018-08-07 00:41:32.000000 ./usr/share/doc/libfko-doc/changelog.gz
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     5077 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/copyright
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ --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
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     4544 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Compiling-with-libfko.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    14793 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Concept-Index.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     8988 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Creating-Contexts.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     8945 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Creating-a-SPA-Message.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     4100 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Destroying-Contexts.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     4651 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Digests.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     4847 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Encryption-Algorithms.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    24838 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Error-Handling.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     4375 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Features.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    20449 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Function-and-Data-Index.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     3591 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Getting-Started.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     4548 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/HMAC-Digests.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     5233 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Introduction.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    22662 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Library-Copying.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     4202 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Overview.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     3568 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Preparation.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    20029 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Retrieving-SPA-Data.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     6884 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/SPA-Data-Format.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     6029 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/SPA-Messages.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     3482 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/SPA-Parameter-Types.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    17272 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Setting-SPA-Data.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     4014 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Using-libfko.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     9248 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Utility-Functions.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     7162 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/index.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     3816 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/libfko-Header.html
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/doc-base/
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      245 2023-04-11 03:52:01.000000 ./usr/share/doc-base/libfko-doc.libfko
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Compiling-with-libfko.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Concept-Index.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Creating-Contexts.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Creating-a-SPA-Message.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Destroying-Contexts.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Digests.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Encryption-Algorithms.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Error-Handling.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Features.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Function-and-Data-Index.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Getting-Started.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/HMAC-Digests.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Introduction.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Library-Copying.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Overview.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Preparation.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Retrieving-SPA-Data.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/SPA-Data-Format.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/SPA-Messages.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/SPA-Parameter-Types.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Setting-SPA-Data.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Using-libfko.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/Utility-Functions.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/index.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
│ │ │ │ @@ -72,15 +72,15 @@
│ │ │ │  <p>
│ │ │ │  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>
│ │ │ │  </div>
│ │ │ │  <hr>
│ │ │ │  <span id="Main-Menu"></span><h1 class="top">Main Menu</h1>
│ │ │ │  
│ │ │ │  <p>This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  </p>
│ │ │ │  <p>Copyright &copy; 2009-2013 Damien Stuart.
│ │ │ │  </p>
│ │ │ │  <blockquote>
│ │ │ │  <p>The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -9,15 +9,15 @@
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │              ****** Firewall Knock Operator Library - libfko ******
│ │ │ │ │  Next: Introduction   [Contents][Index]
│ │ │ │ │  ===============================================================================
│ │ │ │ │  ****** Main Menu ******
│ │ │ │ │  This manual is for the Firewall Knock Operator library, libfko. (version
│ │ │ │ │ -2.6.10, last updated 9 February 2025).
│ │ │ │ │ +2.6.10, last updated 8 January 2024).
│ │ │ │ │  Copyright © 2009-2013 Damien Stuart.
│ │ │ │ │       The libfko manual is free; you can redistribute it and/or modify it
│ │ │ │ │       under the terms of the GNU General Public License as published by the
│ │ │ │ │       Free Software Foundation; either version 2 of the License, or (at
│ │ │ │ │       your option) any later version.
│ │ │ │ │       The libfko manual is distributed in the hope that it will be useful,
│ │ │ │ │       but WITHOUT ANY WARRANTY; without even the implied warranty of
│ │ │ ├── ./usr/share/doc/libfko-doc/libfko.html/libfko-Header.html
│ │ │ │ @@ -1,15 +1,15 @@
│ │ │ │  <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
│ │ │ │  <html>
│ │ │ │  <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
│ │ │ │  <head>
│ │ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ │  <!-- 
│ │ │ │  This manual is for the Firewall Knock Operator library, libfko.
│ │ │ │ -(version 2.6.10, last updated 9 February 2025).
│ │ │ │ +(version 2.6.10, last updated 8 January 2024).
│ │ │ │  
│ │ │ │  Copyright (C) 2009-2013 Damien Stuart.
│ │ │ │  
│ │ │ │  The libfko manual is free; you can redistribute it and/or modify
│ │ │ │  it under the terms of the GNU General Public License as published by
│ │ │ │  the Free Software Foundation; either version 2 of the License, or
│ │ │ │  (at your option) any later version.
├── libfko3-dev_2.6.10-16_arm64.deb
│ ├── file list
│ │ @@ -1,3 +1,3 @@
│ │  -rw-r--r--   0        0        0        4 2023-04-11 03:52:01.000000 debian-binary
│ │  -rw-r--r--   0        0        0     1144 2023-04-11 03:52:01.000000 control.tar.xz
│ │ --rw-r--r--   0        0        0    90436 2023-04-11 03:52:01.000000 data.tar.xz
│ │ +-rw-r--r--   0        0        0    90424 2023-04-11 03:52:01.000000 data.tar.xz
│ ├── control.tar.xz
│ │ ├── control.tar
│ │ │ ├── ./md5sums
│ │ │ │ ├── ./md5sums
│ │ │ │ │┄ Files differ
│ ├── data.tar.xz
│ │ ├── data.tar
│ │ │ ├── file list
│ │ │ │ @@ -9,9 +9,9 @@
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/doc/
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko3-dev/
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      593 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko3-dev/README.Debian
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1451 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko3-dev/changelog.Debian.gz
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)    17337 2018-08-07 00:41:32.000000 ./usr/share/doc/libfko3-dev/changelog.gz
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     5077 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko3-dev/copyright
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/share/info/
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    23961 2023-04-11 03:52:01.000000 ./usr/share/info/libfko.info.gz
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    23958 2023-04-11 03:52:01.000000 ./usr/share/info/libfko.info.gz
│ │ │ │  lrwxrwxrwx   0 root         (0) root         (0)        0 2023-04-11 03:52:01.000000 ./usr/lib/aarch64-linux-gnu/libfko.so -> libfko.so.3.0.0
│ │ │ ├── ./usr/share/info/libfko.info.gz
│ │ │ │ ├── libfko.info
│ │ │ │ │ @@ -4,5879 +4,5879 @@
│ │ │ │ │  00000030: 6e20 362e 3820 6672 6f6d 206c 6962 666b  n 6.8 from libfk
│ │ │ │ │  00000040: 6f2e 7465 7869 2e0a 0a54 6869 7320 6d61  o.texi...This ma
│ │ │ │ │  00000050: 6e75 616c 2069 7320 666f 7220 7468 6520  nual is for the 
│ │ │ │ │  00000060: 4669 7265 7761 6c6c 204b 6e6f 636b 204f  Firewall Knock O
│ │ │ │ │  00000070: 7065 7261 746f 7220 6c69 6272 6172 792c  perator library,
│ │ │ │ │  00000080: 206c 6962 666b 6f2e 0a28 7665 7273 696f   libfko..(versio
│ │ │ │ │  00000090: 6e20 322e 362e 3130 2c20 6c61 7374 2075  n 2.6.10, last u
│ │ │ │ │ -000000a0: 7064 6174 6564 2039 2046 6562 7275 6172  pdated 9 Februar
│ │ │ │ │ -000000b0: 7920 3230 3235 292e 0a0a 2020 2043 6f70  y 2025)...   Cop
│ │ │ │ │ -000000c0: 7972 6967 6874 2028 4329 2032 3030 392d  yright (C) 2009-
│ │ │ │ │ -000000d0: 3230 3133 2044 616d 6965 6e20 5374 7561  2013 Damien Stua
│ │ │ │ │ -000000e0: 7274 2e0a 0a20 2020 2020 5468 6520 6c69  rt...     The li
│ │ │ │ │ -000000f0: 6266 6b6f 206d 616e 7561 6c20 6973 2066  bfko manual is f
│ │ │ │ │ -00000100: 7265 653b 2079 6f75 2063 616e 2072 6564  ree; you can red
│ │ │ │ │ -00000110: 6973 7472 6962 7574 6520 6974 2061 6e64  istribute it and
│ │ │ │ │ -00000120: 2f6f 7220 6d6f 6469 6679 2069 740a 2020  /or modify it.  
│ │ │ │ │ -00000130: 2020 2075 6e64 6572 2074 6865 2074 6572     under the ter
│ │ │ │ │ -00000140: 6d73 206f 6620 7468 6520 474e 5520 4765  ms of the GNU Ge
│ │ │ │ │ -00000150: 6e65 7261 6c20 5075 626c 6963 204c 6963  neral Public Lic
│ │ │ │ │ -00000160: 656e 7365 2061 7320 7075 626c 6973 6865  ense as publishe
│ │ │ │ │ -00000170: 6420 6279 0a20 2020 2020 7468 6520 4672  d by.     the Fr
│ │ │ │ │ -00000180: 6565 2053 6f66 7477 6172 6520 466f 756e  ee Software Foun
│ │ │ │ │ -00000190: 6461 7469 6f6e 3b20 6569 7468 6572 2076  dation; either v
│ │ │ │ │ -000001a0: 6572 7369 6f6e 2032 206f 6620 7468 6520  ersion 2 of the 
│ │ │ │ │ -000001b0: 4c69 6365 6e73 652c 206f 720a 2020 2020  License, or.    
│ │ │ │ │ -000001c0: 2028 6174 2079 6f75 7220 6f70 7469 6f6e   (at your option
│ │ │ │ │ -000001d0: 2920 616e 7920 6c61 7465 7220 7665 7273  ) any later vers
│ │ │ │ │ -000001e0: 696f 6e2e 0a0a 2020 2020 2054 6865 206c  ion...     The l
│ │ │ │ │ -000001f0: 6962 666b 6f20 6d61 6e75 616c 2069 7320  ibfko manual is 
│ │ │ │ │ -00000200: 6469 7374 7269 6275 7465 6420 696e 2074  distributed in t
│ │ │ │ │ -00000210: 6865 2068 6f70 6520 7468 6174 2069 7420  he hope that it 
│ │ │ │ │ -00000220: 7769 6c6c 2062 650a 2020 2020 2075 7365  will be.     use
│ │ │ │ │ -00000230: 6675 6c2c 2062 7574 2057 4954 484f 5554  ful, but WITHOUT
│ │ │ │ │ -00000240: 2041 4e59 2057 4152 5241 4e54 593b 2077   ANY WARRANTY; w
│ │ │ │ │ -00000250: 6974 686f 7574 2065 7665 6e20 7468 6520  ithout even the 
│ │ │ │ │ -00000260: 696d 706c 6965 6420 7761 7272 616e 7479  implied warranty
│ │ │ │ │ -00000270: 0a20 2020 2020 6f66 204d 4552 4348 414e  .     of MERCHAN
│ │ │ │ │ -00000280: 5441 4249 4c49 5459 206f 7220 4649 544e  TABILITY or FITN
│ │ │ │ │ -00000290: 4553 5320 464f 5220 4120 5041 5254 4943  ESS FOR A PARTIC
│ │ │ │ │ -000002a0: 554c 4152 2050 5552 504f 5345 2e20 5365  ULAR PURPOSE. Se
│ │ │ │ │ -000002b0: 6520 7468 6520 474e 550a 2020 2020 2047  e the GNU.     G
│ │ │ │ │ -000002c0: 656e 6572 616c 2050 7562 6c69 6320 4c69  eneral Public Li
│ │ │ │ │ -000002d0: 6365 6e73 6520 666f 7220 6d6f 7265 2064  cense for more d
│ │ │ │ │ -000002e0: 6574 6169 6c73 2e0a 0a20 2020 2020 596f  etails...     Yo
│ │ │ │ │ -000002f0: 7520 7368 6f75 6c64 2068 6176 6520 7265  u should have re
│ │ │ │ │ -00000300: 6365 6976 6564 2061 2063 6f70 7920 6f66  ceived a copy of
│ │ │ │ │ -00000310: 2074 6865 2047 4e55 2047 656e 6572 616c   the GNU General
│ │ │ │ │ -00000320: 2050 7562 6c69 6320 4c69 6365 6e73 650a   Public License.
│ │ │ │ │ -00000330: 2020 2020 2061 6c6f 6e67 2077 6974 6820       along with 
│ │ │ │ │ -00000340: 7468 6973 206d 616e 7561 6c3b 2069 6620  this manual; if 
│ │ │ │ │ -00000350: 6e6f 742c 2077 7269 7465 2074 6f20 7468  not, write to th
│ │ │ │ │ -00000360: 6520 4672 6565 2053 6f66 7477 6172 650a  e Free Software.
│ │ │ │ │ -00000370: 2020 2020 2046 6f75 6e64 6174 696f 6e2c       Foundation,
│ │ │ │ │ -00000380: 2049 6e63 2e2c 2035 3120 4672 616e 6b6c   Inc., 51 Frankl
│ │ │ │ │ -00000390: 696e 2053 7472 6565 742c 2046 6966 7468  in Street, Fifth
│ │ │ │ │ -000003a0: 2046 6c6f 6f72 2c20 426f 7374 6f6e 2c20   Floor, Boston, 
│ │ │ │ │ -000003b0: 4d41 0a20 2020 2020 3032 3131 302d 3133  MA.     02110-13
│ │ │ │ │ -000003c0: 3031 2055 5341 0a49 4e46 4f2d 4449 522d  01 USA.INFO-DIR-
│ │ │ │ │ -000003d0: 5345 4354 494f 4e20 4e65 7477 6f72 6b20  SECTION Network 
│ │ │ │ │ -000003e0: 5365 6375 7269 7479 0a53 5441 5254 2d49  Security.START-I
│ │ │ │ │ -000003f0: 4e46 4f2d 4449 522d 454e 5452 590a 2a20  NFO-DIR-ENTRY.* 
│ │ │ │ │ -00000400: 6c69 6266 6b6f 3a20 286c 6962 666b 6f29  libfko: (libfko)
│ │ │ │ │ -00000410: 2e20 2020 2054 6865 2046 6972 6557 616c  .    The FireWal
│ │ │ │ │ -00000420: 6c20 4b4e 6f63 6b20 4f50 6572 6174 6f72  l KNock OPerator
│ │ │ │ │ -00000430: 2028 6677 6b6e 6f70 2920 4c69 6272 6172   (fwknop) Librar
│ │ │ │ │ -00000440: 7920 2d20 6c69 6266 6b6f 0a45 4e44 2d49  y - libfko.END-I
│ │ │ │ │ -00000450: 4e46 4f2d 4449 522d 454e 5452 590a 0a1f  NFO-DIR-ENTRY...
│ │ │ │ │ -00000460: 0a46 696c 653a 206c 6962 666b 6f2e 696e  .File: libfko.in
│ │ │ │ │ -00000470: 666f 2c20 204e 6f64 653a 2054 6f70 2c20  fo,  Node: Top, 
│ │ │ │ │ -00000480: 204e 6578 743a 2049 6e74 726f 6475 6374   Next: Introduct
│ │ │ │ │ -00000490: 696f 6e2c 2020 5570 3a20 2864 6972 290a  ion,  Up: (dir).
│ │ │ │ │ -000004a0: 0a4d 6169 6e20 4d65 6e75 0a2a 2a2a 2a2a  .Main Menu.*****
│ │ │ │ │ -000004b0: 2a2a 2a2a 0a0a 5468 6973 206d 616e 7561  ****..This manua
│ │ │ │ │ -000004c0: 6c20 6973 2066 6f72 2074 6865 2046 6972  l is for the Fir
│ │ │ │ │ -000004d0: 6577 616c 6c20 4b6e 6f63 6b20 4f70 6572  ewall Knock Oper
│ │ │ │ │ -000004e0: 6174 6f72 206c 6962 7261 7279 2c20 6c69  ator library, li
│ │ │ │ │ -000004f0: 6266 6b6f 2e0a 2876 6572 7369 6f6e 2032  bfko..(version 2
│ │ │ │ │ -00000500: 2e36 2e31 302c 206c 6173 7420 7570 6461  .6.10, last upda
│ │ │ │ │ -00000510: 7465 6420 3920 4665 6272 7561 7279 2032  ted 9 February 2
│ │ │ │ │ -00000520: 3032 3529 2e0a 0a20 2020 436f 7079 7269  025)...   Copyri
│ │ │ │ │ -00000530: 6768 7420 2843 2920 3230 3039 2d32 3031  ght (C) 2009-201
│ │ │ │ │ -00000540: 3320 4461 6d69 656e 2053 7475 6172 742e  3 Damien Stuart.
│ │ │ │ │ -00000550: 0a0a 2020 2020 2054 6865 206c 6962 666b  ..     The libfk
│ │ │ │ │ -00000560: 6f20 6d61 6e75 616c 2069 7320 6672 6565  o manual is free
│ │ │ │ │ -00000570: 3b20 796f 7520 6361 6e20 7265 6469 7374  ; you can redist
│ │ │ │ │ -00000580: 7269 6275 7465 2069 7420 616e 642f 6f72  ribute it and/or
│ │ │ │ │ -00000590: 206d 6f64 6966 7920 6974 0a20 2020 2020   modify it.     
│ │ │ │ │ -000005a0: 756e 6465 7220 7468 6520 7465 726d 7320  under the terms 
│ │ │ │ │ -000005b0: 6f66 2074 6865 2047 4e55 2047 656e 6572  of the GNU Gener
│ │ │ │ │ -000005c0: 616c 2050 7562 6c69 6320 4c69 6365 6e73  al Public Licens
│ │ │ │ │ -000005d0: 6520 6173 2070 7562 6c69 7368 6564 2062  e as published b
│ │ │ │ │ -000005e0: 790a 2020 2020 2074 6865 2046 7265 6520  y.     the Free 
│ │ │ │ │ -000005f0: 536f 6674 7761 7265 2046 6f75 6e64 6174  Software Foundat
│ │ │ │ │ -00000600: 696f 6e3b 2065 6974 6865 7220 7665 7273  ion; either vers
│ │ │ │ │ -00000610: 696f 6e20 3220 6f66 2074 6865 204c 6963  ion 2 of the Lic
│ │ │ │ │ -00000620: 656e 7365 2c20 6f72 0a20 2020 2020 2861  ense, or.     (a
│ │ │ │ │ -00000630: 7420 796f 7572 206f 7074 696f 6e29 2061  t your option) a
│ │ │ │ │ -00000640: 6e79 206c 6174 6572 2076 6572 7369 6f6e  ny later version
│ │ │ │ │ -00000650: 2e0a 0a20 2020 2020 5468 6520 6c69 6266  ...     The libf
│ │ │ │ │ -00000660: 6b6f 206d 616e 7561 6c20 6973 2064 6973  ko manual is dis
│ │ │ │ │ -00000670: 7472 6962 7574 6564 2069 6e20 7468 6520  tributed in the 
│ │ │ │ │ -00000680: 686f 7065 2074 6861 7420 6974 2077 696c  hope that it wil
│ │ │ │ │ -00000690: 6c20 6265 0a20 2020 2020 7573 6566 756c  l be.     useful
│ │ │ │ │ -000006a0: 2c20 6275 7420 5749 5448 4f55 5420 414e  , but WITHOUT AN
│ │ │ │ │ -000006b0: 5920 5741 5252 414e 5459 3b20 7769 7468  Y WARRANTY; with
│ │ │ │ │ -000006c0: 6f75 7420 6576 656e 2074 6865 2069 6d70  out even the imp
│ │ │ │ │ -000006d0: 6c69 6564 2077 6172 7261 6e74 790a 2020  lied warranty.  
│ │ │ │ │ -000006e0: 2020 206f 6620 4d45 5243 4841 4e54 4142     of MERCHANTAB
│ │ │ │ │ -000006f0: 494c 4954 5920 6f72 2046 4954 4e45 5353  ILITY or FITNESS
│ │ │ │ │ -00000700: 2046 4f52 2041 2050 4152 5449 4355 4c41   FOR A PARTICULA
│ │ │ │ │ -00000710: 5220 5055 5250 4f53 452e 2053 6565 2074  R PURPOSE. See t
│ │ │ │ │ -00000720: 6865 2047 4e55 0a20 2020 2020 4765 6e65  he GNU.     Gene
│ │ │ │ │ -00000730: 7261 6c20 5075 626c 6963 204c 6963 656e  ral Public Licen
│ │ │ │ │ -00000740: 7365 2066 6f72 206d 6f72 6520 6465 7461  se for more deta
│ │ │ │ │ -00000750: 696c 732e 0a0a 2020 2020 2059 6f75 2073  ils...     You s
│ │ │ │ │ -00000760: 686f 756c 6420 6861 7665 2072 6563 6569  hould have recei
│ │ │ │ │ -00000770: 7665 6420 6120 636f 7079 206f 6620 7468  ved a copy of th
│ │ │ │ │ -00000780: 6520 474e 5520 4765 6e65 7261 6c20 5075  e GNU General Pu
│ │ │ │ │ -00000790: 626c 6963 204c 6963 656e 7365 0a20 2020  blic License.   
│ │ │ │ │ -000007a0: 2020 616c 6f6e 6720 7769 7468 2074 6869    along with thi
│ │ │ │ │ -000007b0: 7320 6d61 6e75 616c 3b20 6966 206e 6f74  s manual; if not
│ │ │ │ │ -000007c0: 2c20 7772 6974 6520 746f 2074 6865 2046  , write to the F
│ │ │ │ │ -000007d0: 7265 6520 536f 6674 7761 7265 0a20 2020  ree Software.   
│ │ │ │ │ -000007e0: 2020 466f 756e 6461 7469 6f6e 2c20 496e    Foundation, In
│ │ │ │ │ -000007f0: 632e 2c20 3531 2046 7261 6e6b 6c69 6e20  c., 51 Franklin 
│ │ │ │ │ -00000800: 5374 7265 6574 2c20 4669 6674 6820 466c  Street, Fifth Fl
│ │ │ │ │ -00000810: 6f6f 722c 2042 6f73 746f 6e2c 204d 410a  oor, Boston, MA.
│ │ │ │ │ -00000820: 2020 2020 2030 3231 3130 2d31 3330 3120       02110-1301 
│ │ │ │ │ -00000830: 5553 410a 0a2a 204d 656e 753a 0a0a 2a20  USA..* Menu:..* 
│ │ │ │ │ -00000840: 496e 7472 6f64 7563 7469 6f6e 3a3a 2020  Introduction::  
│ │ │ │ │ -00000850: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000860: 486f 7720 746f 2075 7365 2074 6869 7320  How to use this 
│ │ │ │ │ -00000870: 6d61 6e75 616c 0a2a 2050 7265 7061 7261  manual.* Prepara
│ │ │ │ │ -00000880: 7469 6f6e 3a3a 2020 2020 2020 2020 2020  tion::          
│ │ │ │ │ -00000890: 2020 2020 2020 2020 2057 6861 7420 796f           What yo
│ │ │ │ │ -000008a0: 7520 7368 6f75 6c64 2064 6f20 6265 666f  u should do befo
│ │ │ │ │ -000008b0: 7265 2075 7369 6e67 2074 6865 206c 6962  re using the lib
│ │ │ │ │ -000008c0: 7261 7279 0a2a 2055 7369 6e67 206c 6962  rary.* Using lib
│ │ │ │ │ -000008d0: 666b 6f3a 3a20 2020 2020 2020 2020 2020  fko::           
│ │ │ │ │ -000008e0: 2020 2020 2020 2048 6f77 2074 6f20 7573         How to us
│ │ │ │ │ -000008f0: 6520 6c69 6266 6b6f 2069 6e20 796f 7572  e libfko in your
│ │ │ │ │ -00000900: 2070 726f 6772 616d 0a0a 4170 7065 6e64   program..Append
│ │ │ │ │ -00000910: 6963 6573 0a0a 2a20 4c69 6272 6172 7920  ices..* Library 
│ │ │ │ │ -00000920: 436f 7079 696e 673a 3a20 2020 2020 2020  Copying::       
│ │ │ │ │ -00000930: 2020 2020 2020 2020 5468 6520 474e 5520          The GNU 
│ │ │ │ │ -00000940: 4765 6e65 7261 6c20 5075 626c 6963 204c  General Public L
│ │ │ │ │ -00000950: 6963 656e 7365 2073 6179 730a 2020 2020  icense says.    
│ │ │ │ │ +000000a0: 7064 6174 6564 2038 204a 616e 7561 7279  pdated 8 January
│ │ │ │ │ +000000b0: 2032 3032 3429 2e0a 0a20 2020 436f 7079   2024)...   Copy
│ │ │ │ │ +000000c0: 7269 6768 7420 2843 2920 3230 3039 2d32  right (C) 2009-2
│ │ │ │ │ +000000d0: 3031 3320 4461 6d69 656e 2053 7475 6172  013 Damien Stuar
│ │ │ │ │ +000000e0: 742e 0a0a 2020 2020 2054 6865 206c 6962  t...     The lib
│ │ │ │ │ +000000f0: 666b 6f20 6d61 6e75 616c 2069 7320 6672  fko manual is fr
│ │ │ │ │ +00000100: 6565 3b20 796f 7520 6361 6e20 7265 6469  ee; you can redi
│ │ │ │ │ +00000110: 7374 7269 6275 7465 2069 7420 616e 642f  stribute it and/
│ │ │ │ │ +00000120: 6f72 206d 6f64 6966 7920 6974 0a20 2020  or modify it.   
│ │ │ │ │ +00000130: 2020 756e 6465 7220 7468 6520 7465 726d    under the term
│ │ │ │ │ +00000140: 7320 6f66 2074 6865 2047 4e55 2047 656e  s of the GNU Gen
│ │ │ │ │ +00000150: 6572 616c 2050 7562 6c69 6320 4c69 6365  eral Public Lice
│ │ │ │ │ +00000160: 6e73 6520 6173 2070 7562 6c69 7368 6564  nse as published
│ │ │ │ │ +00000170: 2062 790a 2020 2020 2074 6865 2046 7265   by.     the Fre
│ │ │ │ │ +00000180: 6520 536f 6674 7761 7265 2046 6f75 6e64  e Software Found
│ │ │ │ │ +00000190: 6174 696f 6e3b 2065 6974 6865 7220 7665  ation; either ve
│ │ │ │ │ +000001a0: 7273 696f 6e20 3220 6f66 2074 6865 204c  rsion 2 of the L
│ │ │ │ │ +000001b0: 6963 656e 7365 2c20 6f72 0a20 2020 2020  icense, or.     
│ │ │ │ │ +000001c0: 2861 7420 796f 7572 206f 7074 696f 6e29  (at your option)
│ │ │ │ │ +000001d0: 2061 6e79 206c 6174 6572 2076 6572 7369   any later versi
│ │ │ │ │ +000001e0: 6f6e 2e0a 0a20 2020 2020 5468 6520 6c69  on...     The li
│ │ │ │ │ +000001f0: 6266 6b6f 206d 616e 7561 6c20 6973 2064  bfko manual is d
│ │ │ │ │ +00000200: 6973 7472 6962 7574 6564 2069 6e20 7468  istributed in th
│ │ │ │ │ +00000210: 6520 686f 7065 2074 6861 7420 6974 2077  e hope that it w
│ │ │ │ │ +00000220: 696c 6c20 6265 0a20 2020 2020 7573 6566  ill be.     usef
│ │ │ │ │ +00000230: 756c 2c20 6275 7420 5749 5448 4f55 5420  ul, but WITHOUT 
│ │ │ │ │ +00000240: 414e 5920 5741 5252 414e 5459 3b20 7769  ANY WARRANTY; wi
│ │ │ │ │ +00000250: 7468 6f75 7420 6576 656e 2074 6865 2069  thout even the i
│ │ │ │ │ +00000260: 6d70 6c69 6564 2077 6172 7261 6e74 790a  mplied warranty.
│ │ │ │ │ +00000270: 2020 2020 206f 6620 4d45 5243 4841 4e54       of MERCHANT
│ │ │ │ │ +00000280: 4142 494c 4954 5920 6f72 2046 4954 4e45  ABILITY or FITNE
│ │ │ │ │ +00000290: 5353 2046 4f52 2041 2050 4152 5449 4355  SS FOR A PARTICU
│ │ │ │ │ +000002a0: 4c41 5220 5055 5250 4f53 452e 2053 6565  LAR PURPOSE. See
│ │ │ │ │ +000002b0: 2074 6865 2047 4e55 0a20 2020 2020 4765   the GNU.     Ge
│ │ │ │ │ +000002c0: 6e65 7261 6c20 5075 626c 6963 204c 6963  neral Public Lic
│ │ │ │ │ +000002d0: 656e 7365 2066 6f72 206d 6f72 6520 6465  ense for more de
│ │ │ │ │ +000002e0: 7461 696c 732e 0a0a 2020 2020 2059 6f75  tails...     You
│ │ │ │ │ +000002f0: 2073 686f 756c 6420 6861 7665 2072 6563   should have rec
│ │ │ │ │ +00000300: 6569 7665 6420 6120 636f 7079 206f 6620  eived a copy of 
│ │ │ │ │ +00000310: 7468 6520 474e 5520 4765 6e65 7261 6c20  the GNU General 
│ │ │ │ │ +00000320: 5075 626c 6963 204c 6963 656e 7365 0a20  Public License. 
│ │ │ │ │ +00000330: 2020 2020 616c 6f6e 6720 7769 7468 2074      along with t
│ │ │ │ │ +00000340: 6869 7320 6d61 6e75 616c 3b20 6966 206e  his manual; if n
│ │ │ │ │ +00000350: 6f74 2c20 7772 6974 6520 746f 2074 6865  ot, write to the
│ │ │ │ │ +00000360: 2046 7265 6520 536f 6674 7761 7265 0a20   Free Software. 
│ │ │ │ │ +00000370: 2020 2020 466f 756e 6461 7469 6f6e 2c20      Foundation, 
│ │ │ │ │ +00000380: 496e 632e 2c20 3531 2046 7261 6e6b 6c69  Inc., 51 Frankli
│ │ │ │ │ +00000390: 6e20 5374 7265 6574 2c20 4669 6674 6820  n Street, Fifth 
│ │ │ │ │ +000003a0: 466c 6f6f 722c 2042 6f73 746f 6e2c 204d  Floor, Boston, M
│ │ │ │ │ +000003b0: 410a 2020 2020 2030 3231 3130 2d31 3330  A.     02110-130
│ │ │ │ │ +000003c0: 3120 5553 410a 494e 464f 2d44 4952 2d53  1 USA.INFO-DIR-S
│ │ │ │ │ +000003d0: 4543 5449 4f4e 204e 6574 776f 726b 2053  ECTION Network S
│ │ │ │ │ +000003e0: 6563 7572 6974 790a 5354 4152 542d 494e  ecurity.START-IN
│ │ │ │ │ +000003f0: 464f 2d44 4952 2d45 4e54 5259 0a2a 206c  FO-DIR-ENTRY.* l
│ │ │ │ │ +00000400: 6962 666b 6f3a 2028 6c69 6266 6b6f 292e  ibfko: (libfko).
│ │ │ │ │ +00000410: 2020 2020 5468 6520 4669 7265 5761 6c6c      The FireWall
│ │ │ │ │ +00000420: 204b 4e6f 636b 204f 5065 7261 746f 7220   KNock OPerator 
│ │ │ │ │ +00000430: 2866 776b 6e6f 7029 204c 6962 7261 7279  (fwknop) Library
│ │ │ │ │ +00000440: 202d 206c 6962 666b 6f0a 454e 442d 494e   - libfko.END-IN
│ │ │ │ │ +00000450: 464f 2d44 4952 2d45 4e54 5259 0a0a 1f0a  FO-DIR-ENTRY....
│ │ │ │ │ +00000460: 4669 6c65 3a20 6c69 6266 6b6f 2e69 6e66  File: libfko.inf
│ │ │ │ │ +00000470: 6f2c 2020 4e6f 6465 3a20 546f 702c 2020  o,  Node: Top,  
│ │ │ │ │ +00000480: 4e65 7874 3a20 496e 7472 6f64 7563 7469  Next: Introducti
│ │ │ │ │ +00000490: 6f6e 2c20 2055 703a 2028 6469 7229 0a0a  on,  Up: (dir)..
│ │ │ │ │ +000004a0: 4d61 696e 204d 656e 750a 2a2a 2a2a 2a2a  Main Menu.******
│ │ │ │ │ +000004b0: 2a2a 2a0a 0a54 6869 7320 6d61 6e75 616c  ***..This manual
│ │ │ │ │ +000004c0: 2069 7320 666f 7220 7468 6520 4669 7265   is for the Fire
│ │ │ │ │ +000004d0: 7761 6c6c 204b 6e6f 636b 204f 7065 7261  wall Knock Opera
│ │ │ │ │ +000004e0: 746f 7220 6c69 6272 6172 792c 206c 6962  tor library, lib
│ │ │ │ │ +000004f0: 666b 6f2e 0a28 7665 7273 696f 6e20 322e  fko..(version 2.
│ │ │ │ │ +00000500: 362e 3130 2c20 6c61 7374 2075 7064 6174  6.10, last updat
│ │ │ │ │ +00000510: 6564 2038 204a 616e 7561 7279 2032 3032  ed 8 January 202
│ │ │ │ │ +00000520: 3429 2e0a 0a20 2020 436f 7079 7269 6768  4)...   Copyrigh
│ │ │ │ │ +00000530: 7420 2843 2920 3230 3039 2d32 3031 3320  t (C) 2009-2013 
│ │ │ │ │ +00000540: 4461 6d69 656e 2053 7475 6172 742e 0a0a  Damien Stuart...
│ │ │ │ │ +00000550: 2020 2020 2054 6865 206c 6962 666b 6f20       The libfko 
│ │ │ │ │ +00000560: 6d61 6e75 616c 2069 7320 6672 6565 3b20  manual is free; 
│ │ │ │ │ +00000570: 796f 7520 6361 6e20 7265 6469 7374 7269  you can redistri
│ │ │ │ │ +00000580: 6275 7465 2069 7420 616e 642f 6f72 206d  bute it and/or m
│ │ │ │ │ +00000590: 6f64 6966 7920 6974 0a20 2020 2020 756e  odify it.     un
│ │ │ │ │ +000005a0: 6465 7220 7468 6520 7465 726d 7320 6f66  der the terms of
│ │ │ │ │ +000005b0: 2074 6865 2047 4e55 2047 656e 6572 616c   the GNU General
│ │ │ │ │ +000005c0: 2050 7562 6c69 6320 4c69 6365 6e73 6520   Public License 
│ │ │ │ │ +000005d0: 6173 2070 7562 6c69 7368 6564 2062 790a  as published by.
│ │ │ │ │ +000005e0: 2020 2020 2074 6865 2046 7265 6520 536f       the Free So
│ │ │ │ │ +000005f0: 6674 7761 7265 2046 6f75 6e64 6174 696f  ftware Foundatio
│ │ │ │ │ +00000600: 6e3b 2065 6974 6865 7220 7665 7273 696f  n; either versio
│ │ │ │ │ +00000610: 6e20 3220 6f66 2074 6865 204c 6963 656e  n 2 of the Licen
│ │ │ │ │ +00000620: 7365 2c20 6f72 0a20 2020 2020 2861 7420  se, or.     (at 
│ │ │ │ │ +00000630: 796f 7572 206f 7074 696f 6e29 2061 6e79  your option) any
│ │ │ │ │ +00000640: 206c 6174 6572 2076 6572 7369 6f6e 2e0a   later version..
│ │ │ │ │ +00000650: 0a20 2020 2020 5468 6520 6c69 6266 6b6f  .     The libfko
│ │ │ │ │ +00000660: 206d 616e 7561 6c20 6973 2064 6973 7472   manual is distr
│ │ │ │ │ +00000670: 6962 7574 6564 2069 6e20 7468 6520 686f  ibuted in the ho
│ │ │ │ │ +00000680: 7065 2074 6861 7420 6974 2077 696c 6c20  pe that it will 
│ │ │ │ │ +00000690: 6265 0a20 2020 2020 7573 6566 756c 2c20  be.     useful, 
│ │ │ │ │ +000006a0: 6275 7420 5749 5448 4f55 5420 414e 5920  but WITHOUT ANY 
│ │ │ │ │ +000006b0: 5741 5252 414e 5459 3b20 7769 7468 6f75  WARRANTY; withou
│ │ │ │ │ +000006c0: 7420 6576 656e 2074 6865 2069 6d70 6c69  t even the impli
│ │ │ │ │ +000006d0: 6564 2077 6172 7261 6e74 790a 2020 2020  ed warranty.    
│ │ │ │ │ +000006e0: 206f 6620 4d45 5243 4841 4e54 4142 494c   of MERCHANTABIL
│ │ │ │ │ +000006f0: 4954 5920 6f72 2046 4954 4e45 5353 2046  ITY or FITNESS F
│ │ │ │ │ +00000700: 4f52 2041 2050 4152 5449 4355 4c41 5220  OR A PARTICULAR 
│ │ │ │ │ +00000710: 5055 5250 4f53 452e 2053 6565 2074 6865  PURPOSE. See the
│ │ │ │ │ +00000720: 2047 4e55 0a20 2020 2020 4765 6e65 7261   GNU.     Genera
│ │ │ │ │ +00000730: 6c20 5075 626c 6963 204c 6963 656e 7365  l Public License
│ │ │ │ │ +00000740: 2066 6f72 206d 6f72 6520 6465 7461 696c   for more detail
│ │ │ │ │ +00000750: 732e 0a0a 2020 2020 2059 6f75 2073 686f  s...     You sho
│ │ │ │ │ +00000760: 756c 6420 6861 7665 2072 6563 6569 7665  uld have receive
│ │ │ │ │ +00000770: 6420 6120 636f 7079 206f 6620 7468 6520  d a copy of the 
│ │ │ │ │ +00000780: 474e 5520 4765 6e65 7261 6c20 5075 626c  GNU General Publ
│ │ │ │ │ +00000790: 6963 204c 6963 656e 7365 0a20 2020 2020  ic License.     
│ │ │ │ │ +000007a0: 616c 6f6e 6720 7769 7468 2074 6869 7320  along with this 
│ │ │ │ │ +000007b0: 6d61 6e75 616c 3b20 6966 206e 6f74 2c20  manual; if not, 
│ │ │ │ │ +000007c0: 7772 6974 6520 746f 2074 6865 2046 7265  write to the Fre
│ │ │ │ │ +000007d0: 6520 536f 6674 7761 7265 0a20 2020 2020  e Software.     
│ │ │ │ │ +000007e0: 466f 756e 6461 7469 6f6e 2c20 496e 632e  Foundation, Inc.
│ │ │ │ │ +000007f0: 2c20 3531 2046 7261 6e6b 6c69 6e20 5374  , 51 Franklin St
│ │ │ │ │ +00000800: 7265 6574 2c20 4669 6674 6820 466c 6f6f  reet, Fifth Floo
│ │ │ │ │ +00000810: 722c 2042 6f73 746f 6e2c 204d 410a 2020  r, Boston, MA.  
│ │ │ │ │ +00000820: 2020 2030 3231 3130 2d31 3330 3120 5553     02110-1301 US
│ │ │ │ │ +00000830: 410a 0a2a 204d 656e 753a 0a0a 2a20 496e  A..* Menu:..* In
│ │ │ │ │ +00000840: 7472 6f64 7563 7469 6f6e 3a3a 2020 2020  troduction::    
│ │ │ │ │ +00000850: 2020 2020 2020 2020 2020 2020 2020 486f                Ho
│ │ │ │ │ +00000860: 7720 746f 2075 7365 2074 6869 7320 6d61  w to use this ma
│ │ │ │ │ +00000870: 6e75 616c 0a2a 2050 7265 7061 7261 7469  nual.* Preparati
│ │ │ │ │ +00000880: 6f6e 3a3a 2020 2020 2020 2020 2020 2020  on::            
│ │ │ │ │ +00000890: 2020 2020 2020 2057 6861 7420 796f 7520         What you 
│ │ │ │ │ +000008a0: 7368 6f75 6c64 2064 6f20 6265 666f 7265  should do before
│ │ │ │ │ +000008b0: 2075 7369 6e67 2074 6865 206c 6962 7261   using the libra
│ │ │ │ │ +000008c0: 7279 0a2a 2055 7369 6e67 206c 6962 666b  ry.* Using libfk
│ │ │ │ │ +000008d0: 6f3a 3a20 2020 2020 2020 2020 2020 2020  o::             
│ │ │ │ │ +000008e0: 2020 2020 2048 6f77 2074 6f20 7573 6520       How to use 
│ │ │ │ │ +000008f0: 6c69 6266 6b6f 2069 6e20 796f 7572 2070  libfko in your p
│ │ │ │ │ +00000900: 726f 6772 616d 0a0a 4170 7065 6e64 6963  rogram..Appendic
│ │ │ │ │ +00000910: 6573 0a0a 2a20 4c69 6272 6172 7920 436f  es..* Library Co
│ │ │ │ │ +00000920: 7079 696e 673a 3a20 2020 2020 2020 2020  pying::         
│ │ │ │ │ +00000930: 2020 2020 2020 5468 6520 474e 5520 4765        The GNU Ge
│ │ │ │ │ +00000940: 6e65 7261 6c20 5075 626c 6963 204c 6963  neral Public Lic
│ │ │ │ │ +00000950: 656e 7365 2073 6179 730a 2020 2020 2020  ense says.      
│ │ │ │ │  00000960: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000970: 2020 2020 2020 2020 2020 2020 2020 686f                ho
│ │ │ │ │ -00000980: 7720 796f 7520 6361 6e20 636f 7079 2061  w you can copy a
│ │ │ │ │ -00000990: 6e64 2073 6861 7265 0a49 6e64 6963 6573  nd share.Indices
│ │ │ │ │ -000009a0: 0a0a 2a20 436f 6e63 6570 7420 496e 6465  ..* Concept Inde
│ │ │ │ │ -000009b0: 783a 3a20 2020 2020 2020 2020 2020 2020  x::             
│ │ │ │ │ -000009c0: 2020 2020 496e 6465 7820 6f66 2063 6f6e      Index of con
│ │ │ │ │ -000009d0: 6365 7074 7320 616e 6420 7072 6f67 7261  cepts and progra
│ │ │ │ │ -000009e0: 6d73 0a2a 2046 756e 6374 696f 6e20 616e  ms.* Function an
│ │ │ │ │ -000009f0: 6420 4461 7461 2049 6e64 6578 3a3a 2020  d Data Index::  
│ │ │ │ │ -00000a00: 2020 2020 2049 6e64 6578 206f 6620 6675       Index of fu
│ │ │ │ │ -00000a10: 6e63 7469 6f6e 732c 2076 6172 6961 626c  nctions, variabl
│ │ │ │ │ -00000a20: 6573 2061 6e64 2064 6174 6120 7479 7065  es and data type
│ │ │ │ │ -00000a30: 730a 0a20 2d2d 2054 6865 2044 6574 6169  s.. -- The Detai
│ │ │ │ │ -00000a40: 6c65 6420 4e6f 6465 204c 6973 7469 6e67  led Node Listing
│ │ │ │ │ -00000a50: 202d 2d0a 0a49 6e74 726f 6475 6374 696f   --..Introductio
│ │ │ │ │ -00000a60: 6e0a 0a2a 2047 6574 7469 6e67 2053 7461  n..* Getting Sta
│ │ │ │ │ -00000a70: 7274 6564 3a3a 2020 2020 2020 2020 2020  rted::          
│ │ │ │ │ -00000a80: 2020 2020 2050 7572 706f 7365 206f 6620       Purpose of 
│ │ │ │ │ -00000a90: 7468 6520 6d61 6e75 616c 2c20 616e 6420  the manual, and 
│ │ │ │ │ -00000aa0: 686f 7720 746f 2075 7365 2069 740a 2a20  how to use it.* 
│ │ │ │ │ -00000ab0: 4665 6174 7572 6573 3a3a 2020 2020 2020  Features::      
│ │ │ │ │ -00000ac0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000ad0: 5265 6173 6f6e 7320 746f 2069 6e73 7461  Reasons to insta
│ │ │ │ │ -00000ae0: 6c6c 2061 6e64 2075 7365 206c 6962 666b  ll and use libfk
│ │ │ │ │ -00000af0: 6f0a 2a20 4f76 6572 7669 6577 3a3a 2020  o.* Overview::  
│ │ │ │ │ +00000970: 2020 2020 2020 2020 2020 2020 686f 7720              how 
│ │ │ │ │ +00000980: 796f 7520 6361 6e20 636f 7079 2061 6e64  you can copy and
│ │ │ │ │ +00000990: 2073 6861 7265 0a49 6e64 6963 6573 0a0a   share.Indices..
│ │ │ │ │ +000009a0: 2a20 436f 6e63 6570 7420 496e 6465 783a  * Concept Index:
│ │ │ │ │ +000009b0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ │ +000009c0: 2020 496e 6465 7820 6f66 2063 6f6e 6365    Index of conce
│ │ │ │ │ +000009d0: 7074 7320 616e 6420 7072 6f67 7261 6d73  pts and programs
│ │ │ │ │ +000009e0: 0a2a 2046 756e 6374 696f 6e20 616e 6420  .* Function and 
│ │ │ │ │ +000009f0: 4461 7461 2049 6e64 6578 3a3a 2020 2020  Data Index::    
│ │ │ │ │ +00000a00: 2020 2049 6e64 6578 206f 6620 6675 6e63     Index of func
│ │ │ │ │ +00000a10: 7469 6f6e 732c 2076 6172 6961 626c 6573  tions, variables
│ │ │ │ │ +00000a20: 2061 6e64 2064 6174 6120 7479 7065 730a   and data types.
│ │ │ │ │ +00000a30: 0a20 2d2d 2054 6865 2044 6574 6169 6c65  . -- The Detaile
│ │ │ │ │ +00000a40: 6420 4e6f 6465 204c 6973 7469 6e67 202d  d Node Listing -
│ │ │ │ │ +00000a50: 2d0a 0a49 6e74 726f 6475 6374 696f 6e0a  -..Introduction.
│ │ │ │ │ +00000a60: 0a2a 2047 6574 7469 6e67 2053 7461 7274  .* Getting Start
│ │ │ │ │ +00000a70: 6564 3a3a 2020 2020 2020 2020 2020 2020  ed::            
│ │ │ │ │ +00000a80: 2020 2050 7572 706f 7365 206f 6620 7468     Purpose of th
│ │ │ │ │ +00000a90: 6520 6d61 6e75 616c 2c20 616e 6420 686f  e manual, and ho
│ │ │ │ │ +00000aa0: 7720 746f 2075 7365 2069 740a 2a20 4665  w to use it.* Fe
│ │ │ │ │ +00000ab0: 6174 7572 6573 3a3a 2020 2020 2020 2020  atures::        
│ │ │ │ │ +00000ac0: 2020 2020 2020 2020 2020 2020 2020 5265                Re
│ │ │ │ │ +00000ad0: 6173 6f6e 7320 746f 2069 6e73 7461 6c6c  asons to install
│ │ │ │ │ +00000ae0: 2061 6e64 2075 7365 206c 6962 666b 6f0a   and use libfko.
│ │ │ │ │ +00000af0: 2a20 4f76 6572 7669 6577 3a3a 2020 2020  * Overview::    
│ │ │ │ │  00000b00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000b10: 2020 2020 4261 7369 6320 6f76 6572 7669      Basic overvi
│ │ │ │ │ -00000b20: 6577 206f 6620 5350 4120 616e 640a 2020  ew of SPA and.  
│ │ │ │ │ +00000b10: 2020 4261 7369 6320 6f76 6572 7669 6577    Basic overview
│ │ │ │ │ +00000b20: 206f 6620 5350 4120 616e 640a 2020 2020   of SPA and.    
│ │ │ │ │  00000b30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000b40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000b50: 6172 6368 6974 6563 7475 7265 206f 6620  architecture of 
│ │ │ │ │ -00000b60: 7468 6520 6c69 6266 6b6f 206c 6962 7261  the libfko libra
│ │ │ │ │ -00000b70: 7279 0a0a 4f76 6572 7669 6577 0a0a 2a20  ry..Overview..* 
│ │ │ │ │ -00000b80: 5350 4120 4461 7461 2046 6f72 6d61 743a  SPA Data Format:
│ │ │ │ │ -00000b90: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ │ -00000ba0: 4465 7363 7269 7074 696f 6e20 6f66 2074  Description of t
│ │ │ │ │ -00000bb0: 6865 2053 5041 2064 6174 610a 2020 2020  he SPA data.    
│ │ │ │ │ +00000b40: 2020 2020 2020 2020 2020 2020 2020 6172                ar
│ │ │ │ │ +00000b50: 6368 6974 6563 7475 7265 206f 6620 7468  chitecture of th
│ │ │ │ │ +00000b60: 6520 6c69 6266 6b6f 206c 6962 7261 7279  e libfko library
│ │ │ │ │ +00000b70: 0a0a 4f76 6572 7669 6577 0a0a 2a20 5350  ..Overview..* SP
│ │ │ │ │ +00000b80: 4120 4461 7461 2046 6f72 6d61 743a 3a20  A Data Format:: 
│ │ │ │ │ +00000b90: 2020 2020 2020 2020 2020 2020 2020 4465                De
│ │ │ │ │ +00000ba0: 7363 7269 7074 696f 6e20 6f66 2074 6865  scription of the
│ │ │ │ │ +00000bb0: 2053 5041 2064 6174 610a 2020 2020 2020   SPA data.      
│ │ │ │ │  00000bc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000bd0: 2020 2020 2020 2020 2020 2020 2020 666f                fo
│ │ │ │ │ -00000be0: 726d 6174 2e0a 0a50 7265 7061 7261 7469  rmat...Preparati
│ │ │ │ │ -00000bf0: 6f6e 0a0a 2a20 6c69 6266 6b6f 2048 6561  on..* libfko Hea
│ │ │ │ │ -00000c00: 6465 723a 3a20 2020 2020 2020 2020 2020  der::           
│ │ │ │ │ -00000c10: 2020 2020 2020 5768 6174 2068 6561 6465        What heade
│ │ │ │ │ -00000c20: 7220 6669 6c65 2079 6f75 206e 6565 6420  r file you need 
│ │ │ │ │ -00000c30: 746f 2069 6e63 6c75 6465 0a2a 2043 6f6d  to include.* Com
│ │ │ │ │ -00000c40: 7069 6c69 6e67 2077 6974 6820 6c69 6266  piling with libf
│ │ │ │ │ -00000c50: 6b6f 3a3a 2020 2020 2020 2020 2057 6861  ko::         Wha
│ │ │ │ │ -00000c60: 7420 796f 7520 6e65 6564 2074 6f20 636f  t you need to co
│ │ │ │ │ -00000c70: 6d70 696c 6520 616e 6420 6c69 6e6b 2079  mpile and link y
│ │ │ │ │ -00000c80: 6f75 720a 2020 2020 2020 2020 2020 2020  our.            
│ │ │ │ │ +00000bd0: 2020 2020 2020 2020 2020 2020 666f 726d              form
│ │ │ │ │ +00000be0: 6174 2e0a 0a50 7265 7061 7261 7469 6f6e  at...Preparation
│ │ │ │ │ +00000bf0: 0a0a 2a20 6c69 6266 6b6f 2048 6561 6465  ..* libfko Heade
│ │ │ │ │ +00000c00: 723a 3a20 2020 2020 2020 2020 2020 2020  r::             
│ │ │ │ │ +00000c10: 2020 2020 5768 6174 2068 6561 6465 7220      What header 
│ │ │ │ │ +00000c20: 6669 6c65 2079 6f75 206e 6565 6420 746f  file you need to
│ │ │ │ │ +00000c30: 2069 6e63 6c75 6465 0a2a 2043 6f6d 7069   include.* Compi
│ │ │ │ │ +00000c40: 6c69 6e67 2077 6974 6820 6c69 6266 6b6f  ling with libfko
│ │ │ │ │ +00000c50: 3a3a 2020 2020 2020 2020 2057 6861 7420  ::         What 
│ │ │ │ │ +00000c60: 796f 7520 6e65 6564 2074 6f20 636f 6d70  you need to comp
│ │ │ │ │ +00000c70: 696c 6520 616e 6420 6c69 6e6b 2079 6f75  ile and link you
│ │ │ │ │ +00000c80: 720a 2020 2020 2020 2020 2020 2020 2020  r.              
│ │ │ │ │  00000c90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000ca0: 2020 2020 2020 7072 6f67 7261 6d20 7769        program wi
│ │ │ │ │ -00000cb0: 7468 206c 6962 666b 6f0a 2a20 5350 4120  th libfko.* SPA 
│ │ │ │ │ -00000cc0: 5061 7261 6d65 7465 7220 5479 7065 733a  Parameter Types:
│ │ │ │ │ -00000cd0: 3a20 2020 2020 2020 2020 2020 5468 6520  :           The 
│ │ │ │ │ -00000ce0: 6176 6169 6c61 626c 6520 6469 6765 7374  available digest
│ │ │ │ │ -00000cf0: 732c 206d 6573 7361 6765 2074 7970 6573  s, message types
│ │ │ │ │ -00000d00: 2061 6e64 0a20 2020 2020 2020 2020 2020   and.           
│ │ │ │ │ +00000ca0: 2020 2020 7072 6f67 7261 6d20 7769 7468      program with
│ │ │ │ │ +00000cb0: 206c 6962 666b 6f0a 2a20 5350 4120 5061   libfko.* SPA Pa
│ │ │ │ │ +00000cc0: 7261 6d65 7465 7220 5479 7065 733a 3a20  rameter Types:: 
│ │ │ │ │ +00000cd0: 2020 2020 2020 2020 2020 5468 6520 6176            The av
│ │ │ │ │ +00000ce0: 6169 6c61 626c 6520 6469 6765 7374 732c  ailable digests,
│ │ │ │ │ +00000cf0: 206d 6573 7361 6765 2074 7970 6573 2061   message types a
│ │ │ │ │ +00000d00: 6e64 0a20 2020 2020 2020 2020 2020 2020  nd.             
│ │ │ │ │  00000d10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000d20: 2020 2020 2020 206d 6f64 6573 206f 6620         modes of 
│ │ │ │ │ -00000d30: 656e 6372 7970 7469 6f6e 2066 6f72 2053  encryption for S
│ │ │ │ │ -00000d40: 5041 2064 6174 610a 5573 696e 6720 6c69  PA data.Using li
│ │ │ │ │ -00000d50: 6266 6b6f 0a0a 2a20 4372 6561 7469 6e67  bfko..* Creating
│ │ │ │ │ -00000d60: 2043 6f6e 7465 7874 733a 3a20 2020 2020   Contexts::     
│ │ │ │ │ -00000d70: 2020 2020 2020 2020 4372 6561 7469 6e67          Creating
│ │ │ │ │ -00000d80: 2061 206e 6577 2066 6b6f 2063 6f6e 7465   a new fko conte
│ │ │ │ │ -00000d90: 7874 0a2a 2044 6573 7472 6f79 696e 6720  xt.* Destroying 
│ │ │ │ │ -00000da0: 436f 6e74 6578 7473 3a3a 2020 2020 2020  Contexts::      
│ │ │ │ │ -00000db0: 2020 2020 2052 656c 6561 7369 6e67 2061       Releasing a
│ │ │ │ │ -00000dc0: 6e20 666b 6f20 636f 6e74 6578 740a 2a20  n fko context.* 
│ │ │ │ │ -00000dd0: 4372 6561 7469 6e67 2061 2053 5041 204d  Creating a SPA M
│ │ │ │ │ -00000de0: 6573 7361 6765 3a3a 2020 2020 2020 2020  essage::        
│ │ │ │ │ -00000df0: 5768 6174 2069 7420 7461 6b65 7320 746f  What it takes to
│ │ │ │ │ -00000e00: 2063 7265 6174 6520 6120 5350 410a 2020   create a SPA.  
│ │ │ │ │ +00000d20: 2020 2020 206d 6f64 6573 206f 6620 656e       modes of en
│ │ │ │ │ +00000d30: 6372 7970 7469 6f6e 2066 6f72 2053 5041  cryption for SPA
│ │ │ │ │ +00000d40: 2064 6174 610a 5573 696e 6720 6c69 6266   data.Using libf
│ │ │ │ │ +00000d50: 6b6f 0a0a 2a20 4372 6561 7469 6e67 2043  ko..* Creating C
│ │ │ │ │ +00000d60: 6f6e 7465 7874 733a 3a20 2020 2020 2020  ontexts::       
│ │ │ │ │ +00000d70: 2020 2020 2020 4372 6561 7469 6e67 2061        Creating a
│ │ │ │ │ +00000d80: 206e 6577 2066 6b6f 2063 6f6e 7465 7874   new fko context
│ │ │ │ │ +00000d90: 0a2a 2044 6573 7472 6f79 696e 6720 436f  .* Destroying Co
│ │ │ │ │ +00000da0: 6e74 6578 7473 3a3a 2020 2020 2020 2020  ntexts::        
│ │ │ │ │ +00000db0: 2020 2052 656c 6561 7369 6e67 2061 6e20     Releasing an 
│ │ │ │ │ +00000dc0: 666b 6f20 636f 6e74 6578 740a 2a20 4372  fko context.* Cr
│ │ │ │ │ +00000dd0: 6561 7469 6e67 2061 2053 5041 204d 6573  eating a SPA Mes
│ │ │ │ │ +00000de0: 7361 6765 3a3a 2020 2020 2020 2020 5768  sage::        Wh
│ │ │ │ │ +00000df0: 6174 2069 7420 7461 6b65 7320 746f 2063  at it takes to c
│ │ │ │ │ +00000e00: 7265 6174 6520 6120 5350 410a 2020 2020  reate a SPA.    
│ │ │ │ │  00000e10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000e20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000e30: 6d65 7373 6167 650a 2a20 5365 7474 696e  message.* Settin
│ │ │ │ │ -00000e40: 6720 5350 4120 4461 7461 3a3a 2020 2020  g SPA Data::    
│ │ │ │ │ -00000e50: 2020 2020 2020 2020 2020 5365 7474 696e            Settin
│ │ │ │ │ -00000e60: 6720 5350 4120 6461 7461 0a2a 2052 6574  g SPA data.* Ret
│ │ │ │ │ -00000e70: 7269 6576 696e 6720 5350 4120 4461 7461  rieving SPA Data
│ │ │ │ │ -00000e80: 3a3a 2020 2020 2020 2020 2020 2052 6574  ::           Ret
│ │ │ │ │ -00000e90: 7269 6576 696e 6720 5350 4120 6461 7461  rieving SPA data
│ │ │ │ │ -00000ea0: 0a2a 2055 7469 6c69 7479 2046 756e 6374  .* Utility Funct
│ │ │ │ │ -00000eb0: 696f 6e73 3a3a 2020 2020 2020 2020 2020  ions::          
│ │ │ │ │ -00000ec0: 2020 204f 7468 6572 2075 7469 6c69 7479     Other utility
│ │ │ │ │ -00000ed0: 2c20 6d69 7363 656c 6c61 6e65 6f75 732c  , miscellaneous,
│ │ │ │ │ -00000ee0: 2061 6e64 2073 656c 646f 6d0a 2020 2020   and seldom.    
│ │ │ │ │ +00000e20: 2020 2020 2020 2020 2020 2020 2020 6d65                me
│ │ │ │ │ +00000e30: 7373 6167 650a 2a20 5365 7474 696e 6720  ssage.* Setting 
│ │ │ │ │ +00000e40: 5350 4120 4461 7461 3a3a 2020 2020 2020  SPA Data::      
│ │ │ │ │ +00000e50: 2020 2020 2020 2020 5365 7474 696e 6720          Setting 
│ │ │ │ │ +00000e60: 5350 4120 6461 7461 0a2a 2052 6574 7269  SPA data.* Retri
│ │ │ │ │ +00000e70: 6576 696e 6720 5350 4120 4461 7461 3a3a  eving SPA Data::
│ │ │ │ │ +00000e80: 2020 2020 2020 2020 2020 2052 6574 7269             Retri
│ │ │ │ │ +00000e90: 6576 696e 6720 5350 4120 6461 7461 0a2a  eving SPA data.*
│ │ │ │ │ +00000ea0: 2055 7469 6c69 7479 2046 756e 6374 696f   Utility Functio
│ │ │ │ │ +00000eb0: 6e73 3a3a 2020 2020 2020 2020 2020 2020  ns::            
│ │ │ │ │ +00000ec0: 204f 7468 6572 2075 7469 6c69 7479 2c20   Other utility, 
│ │ │ │ │ +00000ed0: 6d69 7363 656c 6c61 6e65 6f75 732c 2061  miscellaneous, a
│ │ │ │ │ +00000ee0: 6e64 2073 656c 646f 6d0a 2020 2020 2020  nd seldom.      
│ │ │ │ │  00000ef0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000f00: 2020 2020 2020 2020 2020 2020 2020 7573                us
│ │ │ │ │ -00000f10: 6564 2066 756e 6374 696f 6e73 0a2a 2045  ed functions.* E
│ │ │ │ │ -00000f20: 7272 6f72 2048 616e 646c 696e 673a 3a20  rror Handling:: 
│ │ │ │ │ -00000f30: 2020 2020 2020 2020 2020 2020 2020 2050                 P
│ │ │ │ │ -00000f40: 6f73 7369 626c 6520 6572 726f 7273 2061  ossible errors a
│ │ │ │ │ -00000f50: 6e64 2074 6865 6972 206d 6561 6e69 6e67  nd their meaning
│ │ │ │ │ -00000f60: 0a0a 5350 4120 5061 7261 6d65 7465 7220  ..SPA Parameter 
│ │ │ │ │ -00000f70: 5479 7065 730a 0a2a 2044 6967 6573 7473  Types..* Digests
│ │ │ │ │ -00000f80: 3a3a 2020 2020 2020 2020 2020 2020 2020  ::              
│ │ │ │ │ -00000f90: 2020 2020 2020 2020 2054 6865 206d 6573           The mes
│ │ │ │ │ -00000fa0: 7361 6765 2064 6967 6573 7420 6861 7368  sage digest hash
│ │ │ │ │ -00000fb0: 6573 2073 7570 706f 7274 6564 2062 7920  es supported by 
│ │ │ │ │ -00000fc0: 6c69 6266 6b6f 0a2a 2053 5041 204d 6573  libfko.* SPA Mes
│ │ │ │ │ -00000fd0: 7361 6765 733a 3a20 2020 2020 2020 2020  sages::         
│ │ │ │ │ -00000fe0: 2020 2020 2020 2020 2054 6865 2066 6b6f           The fko
│ │ │ │ │ -00000ff0: 2053 5041 206d 6573 7361 6765 2074 7970   SPA message typ
│ │ │ │ │ -00001000: 6573 0a20 2020 2020 2020 2020 2020 2020  es.             
│ │ │ │ │ +00000f00: 2020 2020 2020 2020 2020 2020 7573 6564              used
│ │ │ │ │ +00000f10: 2066 756e 6374 696f 6e73 0a2a 2045 7272   functions.* Err
│ │ │ │ │ +00000f20: 6f72 2048 616e 646c 696e 673a 3a20 2020  or Handling::   
│ │ │ │ │ +00000f30: 2020 2020 2020 2020 2020 2020 2050 6f73               Pos
│ │ │ │ │ +00000f40: 7369 626c 6520 6572 726f 7273 2061 6e64  sible errors and
│ │ │ │ │ +00000f50: 2074 6865 6972 206d 6561 6e69 6e67 0a0a   their meaning..
│ │ │ │ │ +00000f60: 5350 4120 5061 7261 6d65 7465 7220 5479  SPA Parameter Ty
│ │ │ │ │ +00000f70: 7065 730a 0a2a 2044 6967 6573 7473 3a3a  pes..* Digests::
│ │ │ │ │ +00000f80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ +00000f90: 2020 2020 2020 2054 6865 206d 6573 7361         The messa
│ │ │ │ │ +00000fa0: 6765 2064 6967 6573 7420 6861 7368 6573  ge digest hashes
│ │ │ │ │ +00000fb0: 2073 7570 706f 7274 6564 2062 7920 6c69   supported by li
│ │ │ │ │ +00000fc0: 6266 6b6f 0a2a 2053 5041 204d 6573 7361  bfko.* SPA Messa
│ │ │ │ │ +00000fd0: 6765 733a 3a20 2020 2020 2020 2020 2020  ges::           
│ │ │ │ │ +00000fe0: 2020 2020 2020 2054 6865 2066 6b6f 2053         The fko S
│ │ │ │ │ +00000ff0: 5041 206d 6573 7361 6765 2074 7970 6573  PA message types
│ │ │ │ │ +00001000: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ │  00001010: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00001020: 2020 2020 2073 7570 706f 7274 6564 2062       supported b
│ │ │ │ │ -00001030: 7920 6c69 6266 6b6f 2028 616e 6420 6677  y libfko (and fw
│ │ │ │ │ -00001040: 6b6e 6f70 290a 2a20 456e 6372 7970 7469  knop).* Encrypti
│ │ │ │ │ -00001050: 6f6e 2041 6c67 6f72 6974 686d 733a 3a20  on Algorithms:: 
│ │ │ │ │ -00001060: 2020 2020 2020 2020 456e 6372 7970 7469          Encrypti
│ │ │ │ │ -00001070: 6f6e 2073 6368 656d 6573 2073 7570 706f  on schemes suppo
│ │ │ │ │ -00001080: 7274 6564 2062 7920 6c69 6266 6b6f 0a2a  rted by libfko.*
│ │ │ │ │ -00001090: 2048 4d41 4320 4469 6765 7374 733a 3a20   HMAC Digests:: 
│ │ │ │ │ -000010a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000010b0: 2044 6967 6573 7473 2074 6861 7420 6361   Digests that ca
│ │ │ │ │ -000010c0: 6e20 6265 2075 7365 6420 746f 2062 7569  n be used to bui
│ │ │ │ │ -000010d0: 6c64 2061 6e20 484d 4143 0a0a 0a1f 0a46  ld an HMAC.....F
│ │ │ │ │ -000010e0: 696c 653a 206c 6962 666b 6f2e 696e 666f  ile: libfko.info
│ │ │ │ │ -000010f0: 2c20 204e 6f64 653a 2049 6e74 726f 6475  ,  Node: Introdu
│ │ │ │ │ -00001100: 6374 696f 6e2c 2020 4e65 7874 3a20 5072  ction,  Next: Pr
│ │ │ │ │ -00001110: 6570 6172 6174 696f 6e2c 2020 5072 6576  eparation,  Prev
│ │ │ │ │ -00001120: 3a20 546f 702c 2020 5570 3a20 546f 700a  : Top,  Up: Top.
│ │ │ │ │ -00001130: 0a31 2049 6e74 726f 6475 6374 696f 6e0a  .1 Introduction.
│ │ │ │ │ -00001140: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a  **************..
│ │ │ │ │ -00001150: 5468 6520 2246 6972 6577 616c 6c20 4b6e  The "Firewall Kn
│ │ │ │ │ -00001160: 6f63 6b20 4f70 6572 6174 6f72 204c 6962  ock Operator Lib
│ │ │ │ │ -00001170: 7261 7279 2220 286c 6962 666b 6f29 2069  rary" (libfko) i
│ │ │ │ │ -00001180: 7320 6120 4320 6c61 6e67 7561 6765 206c  s a C language l
│ │ │ │ │ -00001190: 6962 7261 7279 0a74 6861 7420 696d 706c  ibrary.that impl
│ │ │ │ │ -000011a0: 656d 656e 7473 2074 6865 2066 756e 6374  ements the funct
│ │ │ │ │ -000011b0: 696f 6e73 206e 6565 6465 6420 746f 2063  ions needed to c
│ │ │ │ │ -000011c0: 7265 6174 6520 616e 642f 6f72 2070 6172  reate and/or par
│ │ │ │ │ -000011d0: 7365 2022 5369 6e67 6c65 0a50 6163 6b65  se "Single.Packe
│ │ │ │ │ -000011e0: 7420 4175 7468 6f72 697a 6174 696f 6e22  t Authorization"
│ │ │ │ │ -000011f0: 2028 5350 4129 2064 6174 612e 2020 4974   (SPA) data.  It
│ │ │ │ │ -00001200: 2069 7320 6465 7369 676e 6564 2074 6f20   is designed to 
│ │ │ │ │ -00001210: 6162 7374 7261 6374 2074 6865 0a64 6574  abstract the.det
│ │ │ │ │ -00001220: 6169 6c73 206f 6620 656e 636f 6469 6e67  ails of encoding
│ │ │ │ │ -00001230: 2c20 656e 6372 7970 7469 6f6e 2c20 6465  , encryption, de
│ │ │ │ │ -00001240: 636f 6469 6e67 2c20 7061 7273 696e 672c  coding, parsing,
│ │ │ │ │ -00001250: 2061 6e64 2076 6572 6966 7969 6e67 2053   and verifying S
│ │ │ │ │ -00001260: 5041 0a6d 6573 7361 6765 7320 7375 6368  PA.messages such
│ │ │ │ │ -00001270: 2061 7320 7468 6f73 6520 7573 6564 2062   as those used b
│ │ │ │ │ -00001280: 7920 4d69 6368 6165 6c20 5261 7368 2773  y Michael Rash's
│ │ │ │ │ -00001290: 2022 4669 7265 7761 6c6c 204b 6e6f 636b   "Firewall Knock
│ │ │ │ │ -000012a0: 204f 7065 7261 746f 7222 0a28 6677 6b6e   Operator".(fwkn
│ │ │ │ │ -000012b0: 6f70 292e 0a0a 2020 2022 6677 6b6e 6f70  op)...   "fwknop
│ │ │ │ │ -000012c0: 2220 696d 706c 656d 656e 7473 2061 6e20  " implements an 
│ │ │ │ │ -000012d0: 6175 7468 6f72 697a 6174 696f 6e20 7363  authorization sc
│ │ │ │ │ -000012e0: 6865 6d65 206b 6e6f 776e 2061 7320 5369  heme known as Si
│ │ │ │ │ -000012f0: 6e67 6c65 2050 6163 6b65 740a 4175 7468  ngle Packet.Auth
│ │ │ │ │ -00001300: 6f72 697a 6174 696f 6e20 2853 5041 2920  orization (SPA) 
│ │ │ │ │ -00001310: 666f 7220 7374 726f 6e67 2073 6572 7669  for strong servi
│ │ │ │ │ -00001320: 6365 2070 726f 7465 6374 696f 6e2e 2020  ce protection.  
│ │ │ │ │ -00001330: 5350 4120 7265 7175 6972 6573 206f 6e6c  SPA requires onl
│ │ │ │ │ -00001340: 7920 610a 7369 6e67 6c65 2070 6163 6b65  y a.single packe
│ │ │ │ │ -00001350: 7420 7768 6963 6820 6973 2065 6e63 7279  t which is encry
│ │ │ │ │ -00001360: 7074 6564 2c20 6e6f 6e2d 7265 706c 6179  pted, non-replay
│ │ │ │ │ -00001370: 6162 6c65 2c20 616e 6420 6175 7468 656e  able, and authen
│ │ │ │ │ -00001380: 7469 6361 7465 6420 7669 610a 616e 2048  ticated via.an H
│ │ │ │ │ -00001390: 4d41 4320 696e 206f 7264 6572 2074 6f20  MAC in order to 
│ │ │ │ │ -000013a0: 636f 6d6d 756e 6963 6174 6520 6465 7369  communicate desi
│ │ │ │ │ -000013b0: 7265 6420 6163 6365 7373 2074 6f20 6120  red access to a 
│ │ │ │ │ -000013c0: 7365 7276 6963 6520 7468 6174 2069 730a  service that is.
│ │ │ │ │ -000013d0: 6869 6464 656e 2062 6568 696e 6420 6120  hidden behind a 
│ │ │ │ │ -000013e0: 6669 7265 7761 6c6c 2069 6e20 6120 6465  firewall in a de
│ │ │ │ │ -000013f0: 6661 756c 742d 6472 6f70 2066 696c 7465  fault-drop filte
│ │ │ │ │ -00001400: 7269 6e67 2073 7461 6e63 652e 2020 5468  ring stance.  Th
│ │ │ │ │ -00001410: 6520 6d61 696e 0a61 7070 6c69 6361 7469  e main.applicati
│ │ │ │ │ -00001420: 6f6e 206f 6620 5350 4120 6973 2074 6f20  on of SPA is to 
│ │ │ │ │ -00001430: 7573 6520 6120 6669 7265 7761 6c6c 2074  use a firewall t
│ │ │ │ │ -00001440: 6f20 6472 6f70 2061 6c6c 2061 7474 656d  o drop all attem
│ │ │ │ │ -00001450: 7074 7320 746f 2063 6f6e 6e65 6374 0a74  pts to connect.t
│ │ │ │ │ -00001460: 6f20 7365 7276 6963 6573 2073 7563 6820  o services such 
│ │ │ │ │ -00001470: 6173 2027 5353 4827 2069 6e20 6f72 6465  as 'SSH' in orde
│ │ │ │ │ -00001480: 7220 746f 206d 616b 6520 7468 6520 6578  r to make the ex
│ │ │ │ │ -00001490: 706c 6f69 7461 7469 6f6e 206f 660a 7675  ploitation of.vu
│ │ │ │ │ -000014a0: 6c6e 6572 6162 696c 6974 6965 7320 2862  lnerabilities (b
│ │ │ │ │ -000014b0: 6f74 6820 302d 6461 7920 616e 6420 756e  oth 0-day and un
│ │ │ │ │ -000014c0: 7061 7463 6865 6420 636f 6465 2920 6d6f  patched code) mo
│ │ │ │ │ -000014d0: 7265 2064 6966 6669 6375 6c74 2e20 2041  re difficult.  A
│ │ │ │ │ -000014e0: 6e79 0a73 6572 7669 6365 2074 6861 7420  ny.service that 
│ │ │ │ │ -000014f0: 6973 2070 726f 7465 6374 6564 2062 7920  is protected by 
│ │ │ │ │ -00001500: 5350 4120 6e61 7475 7261 6c6c 7920 6361  SPA naturally ca
│ │ │ │ │ -00001510: 6e6e 6f74 2062 6520 7363 616e 6e65 6420  nnot be scanned 
│ │ │ │ │ -00001520: 666f 7220 7769 7468 0a27 4e6d 6170 272e  for with.'Nmap'.
│ │ │ │ │ -00001530: 2020 5468 6520 6677 6b6e 6f70 2070 726f    The fwknop pro
│ │ │ │ │ -00001540: 6a65 6374 2073 7570 706f 7274 7320 7468  ject supports th
│ │ │ │ │ -00001550: 7265 6520 6469 6666 6572 656e 7420 6669  ree different fi
│ │ │ │ │ -00001560: 7265 7761 6c6c 733a 0a27 6970 7461 626c  rewalls:.'iptabl
│ │ │ │ │ -00001570: 6573 2720 6f6e 204c 696e 7578 2073 7973  es' on Linux sys
│ │ │ │ │ -00001580: 7465 6d73 2c20 2770 6627 206f 6e20 4f70  tems, 'pf' on Op
│ │ │ │ │ -00001590: 656e 4253 442c 2061 6e64 2027 6970 6677  enBSD, and 'ipfw
│ │ │ │ │ -000015a0: 2720 6f6e 2046 7265 6542 5344 2061 6e64  ' on FreeBSD and
│ │ │ │ │ -000015b0: 0a4d 6163 204f 5320 582e 0a0a 2020 206c  .Mac OS X...   l
│ │ │ │ │ -000015c0: 6962 666b 6f20 6973 206e 6f74 2061 6e20  ibfko is not an 
│ │ │ │ │ -000015d0: 696d 706c 656d 656e 7461 7469 6f6e 206f  implementation o
│ │ │ │ │ -000015e0: 6620 616e 2066 776b 6e6f 7020 636c 6965  f an fwknop clie
│ │ │ │ │ -000015f0: 6e74 206f 7220 7365 7276 6572 2e20 2049  nt or server.  I
│ │ │ │ │ -00001600: 740a 7369 6d70 6c79 2070 726f 7669 6465  t.simply provide
│ │ │ │ │ -00001610: 7320 7468 6520 6675 6e63 7469 6f6e 7320  s the functions 
│ │ │ │ │ -00001620: 666f 7220 6d61 6e61 6769 6e67 2074 6865  for managing the
│ │ │ │ │ -00001630: 2053 5041 2064 6174 6120 7573 6564 2062   SPA data used b
│ │ │ │ │ -00001640: 7920 7468 6f73 650a 7072 6f67 7261 6d73  y those.programs
│ │ │ │ │ -00001650: 2e0a 0a0a 466f 7220 6d6f 7265 2069 6e66  ....For more inf
│ │ │ │ │ -00001660: 6f72 6d61 7469 6f6e 206f 6e20 6677 6b6e  ormation on fwkn
│ │ │ │ │ -00001670: 6f70 2061 6e64 2053 5041 2c20 676f 2074  op and SPA, go t
│ │ │ │ │ -00001680: 6f0a 3c68 7474 703a 2f2f 7777 772e 6369  o.<http://www.ci
│ │ │ │ │ -00001690: 7068 6572 6479 6e65 2e6f 7267 2f66 776b  pherdyne.org/fwk
│ │ │ │ │ -000016a0: 6e6f 703e 2e0a 0a2a 204d 656e 753a 0a0a  nop>...* Menu:..
│ │ │ │ │ -000016b0: 2a20 4765 7474 696e 6720 5374 6172 7465  * Getting Starte
│ │ │ │ │ -000016c0: 643a 3a20 2020 2020 2020 2020 2020 2020  d::             
│ │ │ │ │ -000016d0: 2020 5075 7270 6f73 6520 6f66 2074 6865    Purpose of the
│ │ │ │ │ -000016e0: 206d 616e 7561 6c2c 2061 6e64 2068 6f77   manual, and how
│ │ │ │ │ -000016f0: 2074 6f20 7573 6520 6974 0a2a 2046 6561   to use it.* Fea
│ │ │ │ │ -00001700: 7475 7265 733a 3a20 2020 2020 2020 2020  tures::         
│ │ │ │ │ -00001710: 2020 2020 2020 2020 2020 2020 2052 6561               Rea
│ │ │ │ │ -00001720: 736f 6e73 2074 6f20 696e 7374 616c 6c20  sons to install 
│ │ │ │ │ -00001730: 616e 6420 7573 6520 6c69 6266 6b6f 0a2a  and use libfko.*
│ │ │ │ │ -00001740: 204f 7665 7276 6965 773a 3a20 2020 2020   Overview::     
│ │ │ │ │ -00001750: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00001760: 2042 6173 6963 2061 7263 6869 7465 6374   Basic architect
│ │ │ │ │ -00001770: 7572 6520 6f66 2074 6865 206c 6962 666b  ure of the libfk
│ │ │ │ │ -00001780: 6f20 6c69 6272 6172 790a 0a1f 0a46 696c  o library....Fil
│ │ │ │ │ -00001790: 653a 206c 6962 666b 6f2e 696e 666f 2c20  e: libfko.info, 
│ │ │ │ │ -000017a0: 204e 6f64 653a 2047 6574 7469 6e67 2053   Node: Getting S
│ │ │ │ │ -000017b0: 7461 7274 6564 2c20 204e 6578 743a 2046  tarted,  Next: F
│ │ │ │ │ -000017c0: 6561 7475 7265 732c 2020 5570 3a20 496e  eatures,  Up: In
│ │ │ │ │ -000017d0: 7472 6f64 7563 7469 6f6e 0a0a 312e 3120  troduction..1.1 
│ │ │ │ │ -000017e0: 4765 7474 696e 6720 5374 6172 7465 640a  Getting Started.
│ │ │ │ │ +00001020: 2020 2073 7570 706f 7274 6564 2062 7920     supported by 
│ │ │ │ │ +00001030: 6c69 6266 6b6f 2028 616e 6420 6677 6b6e  libfko (and fwkn
│ │ │ │ │ +00001040: 6f70 290a 2a20 456e 6372 7970 7469 6f6e  op).* Encryption
│ │ │ │ │ +00001050: 2041 6c67 6f72 6974 686d 733a 3a20 2020   Algorithms::   
│ │ │ │ │ +00001060: 2020 2020 2020 456e 6372 7970 7469 6f6e        Encryption
│ │ │ │ │ +00001070: 2073 6368 656d 6573 2073 7570 706f 7274   schemes support
│ │ │ │ │ +00001080: 6564 2062 7920 6c69 6266 6b6f 0a2a 2048  ed by libfko.* H
│ │ │ │ │ +00001090: 4d41 4320 4469 6765 7374 733a 3a20 2020  MAC Digests::   
│ │ │ │ │ +000010a0: 2020 2020 2020 2020 2020 2020 2020 2044                 D
│ │ │ │ │ +000010b0: 6967 6573 7473 2074 6861 7420 6361 6e20  igests that can 
│ │ │ │ │ +000010c0: 6265 2075 7365 6420 746f 2062 7569 6c64  be used to build
│ │ │ │ │ +000010d0: 2061 6e20 484d 4143 0a0a 0a1f 0a46 696c   an HMAC.....Fil
│ │ │ │ │ +000010e0: 653a 206c 6962 666b 6f2e 696e 666f 2c20  e: libfko.info, 
│ │ │ │ │ +000010f0: 204e 6f64 653a 2049 6e74 726f 6475 6374   Node: Introduct
│ │ │ │ │ +00001100: 696f 6e2c 2020 4e65 7874 3a20 5072 6570  ion,  Next: Prep
│ │ │ │ │ +00001110: 6172 6174 696f 6e2c 2020 5072 6576 3a20  aration,  Prev: 
│ │ │ │ │ +00001120: 546f 702c 2020 5570 3a20 546f 700a 0a31  Top,  Up: Top..1
│ │ │ │ │ +00001130: 2049 6e74 726f 6475 6374 696f 6e0a 2a2a   Introduction.**
│ │ │ │ │ +00001140: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 5468  ************..Th
│ │ │ │ │ +00001150: 6520 2246 6972 6577 616c 6c20 4b6e 6f63  e "Firewall Knoc
│ │ │ │ │ +00001160: 6b20 4f70 6572 6174 6f72 204c 6962 7261  k Operator Libra
│ │ │ │ │ +00001170: 7279 2220 286c 6962 666b 6f29 2069 7320  ry" (libfko) is 
│ │ │ │ │ +00001180: 6120 4320 6c61 6e67 7561 6765 206c 6962  a C language lib
│ │ │ │ │ +00001190: 7261 7279 0a74 6861 7420 696d 706c 656d  rary.that implem
│ │ │ │ │ +000011a0: 656e 7473 2074 6865 2066 756e 6374 696f  ents the functio
│ │ │ │ │ +000011b0: 6e73 206e 6565 6465 6420 746f 2063 7265  ns needed to cre
│ │ │ │ │ +000011c0: 6174 6520 616e 642f 6f72 2070 6172 7365  ate and/or parse
│ │ │ │ │ +000011d0: 2022 5369 6e67 6c65 0a50 6163 6b65 7420   "Single.Packet 
│ │ │ │ │ +000011e0: 4175 7468 6f72 697a 6174 696f 6e22 2028  Authorization" (
│ │ │ │ │ +000011f0: 5350 4129 2064 6174 612e 2020 4974 2069  SPA) data.  It i
│ │ │ │ │ +00001200: 7320 6465 7369 676e 6564 2074 6f20 6162  s designed to ab
│ │ │ │ │ +00001210: 7374 7261 6374 2074 6865 0a64 6574 6169  stract the.detai
│ │ │ │ │ +00001220: 6c73 206f 6620 656e 636f 6469 6e67 2c20  ls of encoding, 
│ │ │ │ │ +00001230: 656e 6372 7970 7469 6f6e 2c20 6465 636f  encryption, deco
│ │ │ │ │ +00001240: 6469 6e67 2c20 7061 7273 696e 672c 2061  ding, parsing, a
│ │ │ │ │ +00001250: 6e64 2076 6572 6966 7969 6e67 2053 5041  nd verifying SPA
│ │ │ │ │ +00001260: 0a6d 6573 7361 6765 7320 7375 6368 2061  .messages such a
│ │ │ │ │ +00001270: 7320 7468 6f73 6520 7573 6564 2062 7920  s those used by 
│ │ │ │ │ +00001280: 4d69 6368 6165 6c20 5261 7368 2773 2022  Michael Rash's "
│ │ │ │ │ +00001290: 4669 7265 7761 6c6c 204b 6e6f 636b 204f  Firewall Knock O
│ │ │ │ │ +000012a0: 7065 7261 746f 7222 0a28 6677 6b6e 6f70  perator".(fwknop
│ │ │ │ │ +000012b0: 292e 0a0a 2020 2022 6677 6b6e 6f70 2220  )...   "fwknop" 
│ │ │ │ │ +000012c0: 696d 706c 656d 656e 7473 2061 6e20 6175  implements an au
│ │ │ │ │ +000012d0: 7468 6f72 697a 6174 696f 6e20 7363 6865  thorization sche
│ │ │ │ │ +000012e0: 6d65 206b 6e6f 776e 2061 7320 5369 6e67  me known as Sing
│ │ │ │ │ +000012f0: 6c65 2050 6163 6b65 740a 4175 7468 6f72  le Packet.Author
│ │ │ │ │ +00001300: 697a 6174 696f 6e20 2853 5041 2920 666f  ization (SPA) fo
│ │ │ │ │ +00001310: 7220 7374 726f 6e67 2073 6572 7669 6365  r strong service
│ │ │ │ │ +00001320: 2070 726f 7465 6374 696f 6e2e 2020 5350   protection.  SP
│ │ │ │ │ +00001330: 4120 7265 7175 6972 6573 206f 6e6c 7920  A requires only 
│ │ │ │ │ +00001340: 610a 7369 6e67 6c65 2070 6163 6b65 7420  a.single packet 
│ │ │ │ │ +00001350: 7768 6963 6820 6973 2065 6e63 7279 7074  which is encrypt
│ │ │ │ │ +00001360: 6564 2c20 6e6f 6e2d 7265 706c 6179 6162  ed, non-replayab
│ │ │ │ │ +00001370: 6c65 2c20 616e 6420 6175 7468 656e 7469  le, and authenti
│ │ │ │ │ +00001380: 6361 7465 6420 7669 610a 616e 2048 4d41  cated via.an HMA
│ │ │ │ │ +00001390: 4320 696e 206f 7264 6572 2074 6f20 636f  C in order to co
│ │ │ │ │ +000013a0: 6d6d 756e 6963 6174 6520 6465 7369 7265  mmunicate desire
│ │ │ │ │ +000013b0: 6420 6163 6365 7373 2074 6f20 6120 7365  d access to a se
│ │ │ │ │ +000013c0: 7276 6963 6520 7468 6174 2069 730a 6869  rvice that is.hi
│ │ │ │ │ +000013d0: 6464 656e 2062 6568 696e 6420 6120 6669  dden behind a fi
│ │ │ │ │ +000013e0: 7265 7761 6c6c 2069 6e20 6120 6465 6661  rewall in a defa
│ │ │ │ │ +000013f0: 756c 742d 6472 6f70 2066 696c 7465 7269  ult-drop filteri
│ │ │ │ │ +00001400: 6e67 2073 7461 6e63 652e 2020 5468 6520  ng stance.  The 
│ │ │ │ │ +00001410: 6d61 696e 0a61 7070 6c69 6361 7469 6f6e  main.application
│ │ │ │ │ +00001420: 206f 6620 5350 4120 6973 2074 6f20 7573   of SPA is to us
│ │ │ │ │ +00001430: 6520 6120 6669 7265 7761 6c6c 2074 6f20  e a firewall to 
│ │ │ │ │ +00001440: 6472 6f70 2061 6c6c 2061 7474 656d 7074  drop all attempt
│ │ │ │ │ +00001450: 7320 746f 2063 6f6e 6e65 6374 0a74 6f20  s to connect.to 
│ │ │ │ │ +00001460: 7365 7276 6963 6573 2073 7563 6820 6173  services such as
│ │ │ │ │ +00001470: 2027 5353 4827 2069 6e20 6f72 6465 7220   'SSH' in order 
│ │ │ │ │ +00001480: 746f 206d 616b 6520 7468 6520 6578 706c  to make the expl
│ │ │ │ │ +00001490: 6f69 7461 7469 6f6e 206f 660a 7675 6c6e  oitation of.vuln
│ │ │ │ │ +000014a0: 6572 6162 696c 6974 6965 7320 2862 6f74  erabilities (bot
│ │ │ │ │ +000014b0: 6820 302d 6461 7920 616e 6420 756e 7061  h 0-day and unpa
│ │ │ │ │ +000014c0: 7463 6865 6420 636f 6465 2920 6d6f 7265  tched code) more
│ │ │ │ │ +000014d0: 2064 6966 6669 6375 6c74 2e20 2041 6e79   difficult.  Any
│ │ │ │ │ +000014e0: 0a73 6572 7669 6365 2074 6861 7420 6973  .service that is
│ │ │ │ │ +000014f0: 2070 726f 7465 6374 6564 2062 7920 5350   protected by SP
│ │ │ │ │ +00001500: 4120 6e61 7475 7261 6c6c 7920 6361 6e6e  A naturally cann
│ │ │ │ │ +00001510: 6f74 2062 6520 7363 616e 6e65 6420 666f  ot be scanned fo
│ │ │ │ │ +00001520: 7220 7769 7468 0a27 4e6d 6170 272e 2020  r with.'Nmap'.  
│ │ │ │ │ +00001530: 5468 6520 6677 6b6e 6f70 2070 726f 6a65  The fwknop proje
│ │ │ │ │ +00001540: 6374 2073 7570 706f 7274 7320 7468 7265  ct supports thre
│ │ │ │ │ +00001550: 6520 6469 6666 6572 656e 7420 6669 7265  e different fire
│ │ │ │ │ +00001560: 7761 6c6c 733a 0a27 6970 7461 626c 6573  walls:.'iptables
│ │ │ │ │ +00001570: 2720 6f6e 204c 696e 7578 2073 7973 7465  ' on Linux syste
│ │ │ │ │ +00001580: 6d73 2c20 2770 6627 206f 6e20 4f70 656e  ms, 'pf' on Open
│ │ │ │ │ +00001590: 4253 442c 2061 6e64 2027 6970 6677 2720  BSD, and 'ipfw' 
│ │ │ │ │ +000015a0: 6f6e 2046 7265 6542 5344 2061 6e64 0a4d  on FreeBSD and.M
│ │ │ │ │ +000015b0: 6163 204f 5320 582e 0a0a 2020 206c 6962  ac OS X...   lib
│ │ │ │ │ +000015c0: 666b 6f20 6973 206e 6f74 2061 6e20 696d  fko is not an im
│ │ │ │ │ +000015d0: 706c 656d 656e 7461 7469 6f6e 206f 6620  plementation of 
│ │ │ │ │ +000015e0: 616e 2066 776b 6e6f 7020 636c 6965 6e74  an fwknop client
│ │ │ │ │ +000015f0: 206f 7220 7365 7276 6572 2e20 2049 740a   or server.  It.
│ │ │ │ │ +00001600: 7369 6d70 6c79 2070 726f 7669 6465 7320  simply provides 
│ │ │ │ │ +00001610: 7468 6520 6675 6e63 7469 6f6e 7320 666f  the functions fo
│ │ │ │ │ +00001620: 7220 6d61 6e61 6769 6e67 2074 6865 2053  r managing the S
│ │ │ │ │ +00001630: 5041 2064 6174 6120 7573 6564 2062 7920  PA data used by 
│ │ │ │ │ +00001640: 7468 6f73 650a 7072 6f67 7261 6d73 2e0a  those.programs..
│ │ │ │ │ +00001650: 0a0a 466f 7220 6d6f 7265 2069 6e66 6f72  ..For more infor
│ │ │ │ │ +00001660: 6d61 7469 6f6e 206f 6e20 6677 6b6e 6f70  mation on fwknop
│ │ │ │ │ +00001670: 2061 6e64 2053 5041 2c20 676f 2074 6f0a   and SPA, go to.
│ │ │ │ │ +00001680: 3c68 7474 703a 2f2f 7777 772e 6369 7068  <http://www.ciph
│ │ │ │ │ +00001690: 6572 6479 6e65 2e6f 7267 2f66 776b 6e6f  erdyne.org/fwkno
│ │ │ │ │ +000016a0: 703e 2e0a 0a2a 204d 656e 753a 0a0a 2a20  p>...* Menu:..* 
│ │ │ │ │ +000016b0: 4765 7474 696e 6720 5374 6172 7465 643a  Getting Started:
│ │ │ │ │ +000016c0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ │ +000016d0: 5075 7270 6f73 6520 6f66 2074 6865 206d  Purpose of the m
│ │ │ │ │ +000016e0: 616e 7561 6c2c 2061 6e64 2068 6f77 2074  anual, and how t
│ │ │ │ │ +000016f0: 6f20 7573 6520 6974 0a2a 2046 6561 7475  o use it.* Featu
│ │ │ │ │ +00001700: 7265 733a 3a20 2020 2020 2020 2020 2020  res::           
│ │ │ │ │ +00001710: 2020 2020 2020 2020 2020 2052 6561 736f             Reaso
│ │ │ │ │ +00001720: 6e73 2074 6f20 696e 7374 616c 6c20 616e  ns to install an
│ │ │ │ │ +00001730: 6420 7573 6520 6c69 6266 6b6f 0a2a 204f  d use libfko.* O
│ │ │ │ │ +00001740: 7665 7276 6965 773a 3a20 2020 2020 2020  verview::       
│ │ │ │ │ +00001750: 2020 2020 2020 2020 2020 2020 2020 2042                 B
│ │ │ │ │ +00001760: 6173 6963 2061 7263 6869 7465 6374 7572  asic architectur
│ │ │ │ │ +00001770: 6520 6f66 2074 6865 206c 6962 666b 6f20  e of the libfko 
│ │ │ │ │ +00001780: 6c69 6272 6172 790a 0a1f 0a46 696c 653a  library....File:
│ │ │ │ │ +00001790: 206c 6962 666b 6f2e 696e 666f 2c20 204e   libfko.info,  N
│ │ │ │ │ +000017a0: 6f64 653a 2047 6574 7469 6e67 2053 7461  ode: Getting Sta
│ │ │ │ │ +000017b0: 7274 6564 2c20 204e 6578 743a 2046 6561  rted,  Next: Fea
│ │ │ │ │ +000017c0: 7475 7265 732c 2020 5570 3a20 496e 7472  tures,  Up: Intr
│ │ │ │ │ +000017d0: 6f64 7563 7469 6f6e 0a0a 312e 3120 4765  oduction..1.1 Ge
│ │ │ │ │ +000017e0: 7474 696e 6720 5374 6172 7465 640a 3d3d  tting Started.==
│ │ │ │ │  000017f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ │ -00001800: 3d3d 3d0a 0a54 6869 7320 6d61 6e75 616c  ===..This manual
│ │ │ │ │ -00001810: 2064 6f63 756d 656e 7473 2074 6865 2022   documents the "
│ │ │ │ │ -00001820: 4669 7265 7761 6c6c 204b 6e6f 636b 204f  Firewall Knock O
│ │ │ │ │ -00001830: 7065 7261 746f 7222 206c 6962 7261 7279  perator" library
│ │ │ │ │ -00001840: 2070 726f 6772 616d 6d69 6e67 0a69 6e74   programming.int
│ │ │ │ │ -00001850: 6572 6661 6365 2e20 2041 6c6c 2066 756e  erface.  All fun
│ │ │ │ │ -00001860: 6374 696f 6e73 2061 6e64 2064 6174 6120  ctions and data 
│ │ │ │ │ -00001870: 7479 7065 7320 7072 6f76 6964 6564 2062  types provided b
│ │ │ │ │ -00001880: 7920 7468 6520 6c69 6272 6172 7920 6172  y the library ar
│ │ │ │ │ -00001890: 650a 6578 706c 6169 6e65 642e 0a0a 2020  e.explained...  
│ │ │ │ │ -000018a0: 2054 6869 7320 6d61 6e75 616c 2063 616e   This manual can
│ │ │ │ │ -000018b0: 2062 6520 7573 6564 2069 6e20 6120 636f   be used in a co
│ │ │ │ │ -000018c0: 7570 6c65 206f 6620 7761 7973 2e20 2049  uple of ways.  I
│ │ │ │ │ -000018d0: 6620 7265 6164 2066 726f 6d20 7468 650a  f read from the.
│ │ │ │ │ -000018e0: 6265 6769 6e6e 696e 6720 746f 2074 6865  beginning to the
│ │ │ │ │ -000018f0: 2065 6e64 2c20 6974 2073 686f 756c 6420   end, it should 
│ │ │ │ │ -00001900: 6769 7665 2061 2067 6f6f 6420 696e 7472  give a good intr
│ │ │ │ │ -00001910: 6f64 7563 7469 6f6e 2069 6e74 6f20 7468  oduction into th
│ │ │ │ │ -00001920: 650a 6c69 6272 6172 7920 616e 6420 686f  e.library and ho
│ │ │ │ │ -00001930: 7720 6974 2063 616e 2062 6520 7573 6564  w it can be used
│ │ │ │ │ -00001940: 2069 6e20 616e 2061 7070 6c69 6361 7469   in an applicati
│ │ │ │ │ -00001950: 6f6e 2e20 204c 6174 6572 206f 6e2c 2074  on.  Later on, t
│ │ │ │ │ -00001960: 6865 206d 616e 7561 6c0a 6361 6e20 6265  he manual.can be
│ │ │ │ │ -00001970: 2075 7365 6420 6173 2061 2072 6566 6572   used as a refer
│ │ │ │ │ -00001980: 656e 6365 206d 616e 7561 6c20 746f 2067  ence manual to g
│ │ │ │ │ -00001990: 6574 206a 7573 7420 7468 6520 696e 666f  et just the info
│ │ │ │ │ -000019a0: 726d 6174 696f 6e20 6e65 6564 6564 0a61  rmation needed.a
│ │ │ │ │ -000019b0: 626f 7574 2061 6e79 2070 6172 7469 6375  bout any particu
│ │ │ │ │ -000019c0: 6c61 7220 696e 7465 7266 6163 6520 6f66  lar interface of
│ │ │ │ │ -000019d0: 2074 6865 206c 6962 7261 7279 2e0a 0a1f   the library....
│ │ │ │ │ -000019e0: 0a46 696c 653a 206c 6962 666b 6f2e 696e  .File: libfko.in
│ │ │ │ │ -000019f0: 666f 2c20 204e 6f64 653a 2046 6561 7475  fo,  Node: Featu
│ │ │ │ │ -00001a00: 7265 732c 2020 4e65 7874 3a20 4f76 6572  res,  Next: Over
│ │ │ │ │ -00001a10: 7669 6577 2c20 2050 7265 763a 2047 6574  view,  Prev: Get
│ │ │ │ │ -00001a20: 7469 6e67 2053 7461 7274 6564 2c20 2055  ting Started,  U
│ │ │ │ │ -00001a30: 703a 2049 6e74 726f 6475 6374 696f 6e0a  p: Introduction.
│ │ │ │ │ -00001a40: 0a31 2e32 2046 6561 7475 7265 730a 3d3d  .1.2 Features.==
│ │ │ │ │ -00001a50: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520  ==========..The 
│ │ │ │ │ -00001a60: 7072 696d 6172 7920 6164 7661 6e74 6167  primary advantag
│ │ │ │ │ -00001a70: 6520 6f66 2075 7369 6e67 206c 6962 666b  e of using libfk
│ │ │ │ │ -00001a80: 6f20 6973 2069 7420 7072 6f76 6964 6573  o is it provides
│ │ │ │ │ -00001a90: 2061 2073 696e 676c 6520 4150 4920 666f   a single API fo
│ │ │ │ │ -00001aa0: 720a 6569 7468 6572 2063 7265 6174 696e  r.either creatin
│ │ │ │ │ -00001ab0: 6720 6f72 2070 6172 7369 6e67 2053 5041  g or parsing SPA
│ │ │ │ │ -00001ac0: 2064 6174 612e 2020 4164 6469 7469 6f6e   data.  Addition
│ │ │ │ │ -00001ad0: 616c 2061 6476 616e 7461 6765 7320 696e  al advantages in
│ │ │ │ │ -00001ae0: 636c 7564 653a 0a0a 4974 2773 2066 7265  clude:..It's fre
│ │ │ │ │ -00001af0: 6520 736f 6674 7761 7265 0a20 2020 2020  e software.     
│ │ │ │ │ -00001b00: 416e 7962 6f64 7920 6361 6e20 7573 652c  Anybody can use,
│ │ │ │ │ -00001b10: 206d 6f64 6966 792c 2061 6e64 2072 6564   modify, and red
│ │ │ │ │ -00001b20: 6973 7472 6962 7574 6520 6974 2075 6e64  istribute it und
│ │ │ │ │ -00001b30: 6572 2074 6865 2074 6572 6d73 206f 6620  er the terms of 
│ │ │ │ │ -00001b40: 7468 650a 2020 2020 2047 4e55 2047 656e  the.     GNU Gen
│ │ │ │ │ -00001b50: 6572 616c 2050 7562 6c69 6320 4c69 6365  eral Public Lice
│ │ │ │ │ -00001b60: 6e73 6520 7632 206f 7220 616e 7920 6c61  nse v2 or any la
│ │ │ │ │ -00001b70: 7465 7220 7665 7273 696f 6e20 282a 6e6f  ter version (*no
│ │ │ │ │ -00001b80: 7465 204c 6962 7261 7279 0a20 2020 2020  te Library.     
│ │ │ │ │ -00001b90: 436f 7079 696e 673a 3a29 2e0a 0a49 7427  Copying::)...It'
│ │ │ │ │ -00001ba0: 7320 6c69 6768 7477 6569 6768 740a 2020  s lightweight.  
│ │ │ │ │ -00001bb0: 2020 2054 6865 2050 6572 6c2d 6261 7365     The Perl-base
│ │ │ │ │ -00001bc0: 6420 696d 706c 656d 656e 7461 7469 6f6e  d implementation
│ │ │ │ │ -00001bd0: 2072 6571 7569 7265 7320 7365 7665 7261   requires severa
│ │ │ │ │ -00001be0: 6c20 6164 6469 7469 6f6e 616c 2050 6572  l additional Per
│ │ │ │ │ -00001bf0: 6c0a 2020 2020 206d 6f64 756c 6573 2061  l.     modules a
│ │ │ │ │ -00001c00: 6e64 2068 6173 2061 2072 656c 6174 6976  nd has a relativ
│ │ │ │ │ -00001c10: 656c 7920 6c61 7267 6520 666f 6f74 7072  ely large footpr
│ │ │ │ │ -00001c20: 696e 7420 696e 206d 656d 6f72 792e 2020  int in memory.  
│ │ │ │ │ -00001c30: 5468 6973 0a20 2020 2020 432d 6261 7365  This.     C-base
│ │ │ │ │ -00001c40: 6420 6c69 6272 6172 7920 656c 696d 696e  d library elimin
│ │ │ │ │ -00001c50: 6174 6573 2074 686f 7365 2064 6570 656e  ates those depen
│ │ │ │ │ -00001c60: 6465 6e63 6965 7320 616e 6420 6861 7320  dencies and has 
│ │ │ │ │ -00001c70: 6120 6d75 6368 0a20 2020 2020 736d 616c  a much.     smal
│ │ │ │ │ -00001c80: 6c65 7220 666f 6f74 7072 696e 742e 2020  ler footprint.  
│ │ │ │ │ -00001c90: 5573 696e 6720 7468 6973 206c 6962 7261  Using this libra
│ │ │ │ │ -00001ca0: 7279 2061 6c6c 6f77 7320 5350 4120 746f  ry allows SPA to
│ │ │ │ │ -00001cb0: 2065 6173 696c 790a 2020 2020 2066 756e   easily.     fun
│ │ │ │ │ -00001cc0: 6374 696f 6e20 6f6e 2065 6d62 6564 6465  ction on embedde
│ │ │ │ │ -00001cd0: 6420 6f70 6572 6174 696e 6720 7379 7374  d operating syst
│ │ │ │ │ -00001ce0: 656d 7320 7375 6368 2061 7320 4f70 656e  ems such as Open
│ │ │ │ │ -00001cf0: 5752 542e 0a0a 4974 2773 2065 6173 790a  WRT...It's easy.
│ │ │ │ │ -00001d00: 2020 2020 206c 6962 666b 6f20 6869 6465       libfko hide
│ │ │ │ │ -00001d10: 7320 6d61 6e79 206f 6620 7468 6520 676f  s many of the go
│ │ │ │ │ -00001d20: 7279 2064 6574 6169 6c73 206f 6620 6677  ry details of fw
│ │ │ │ │ -00001d30: 6b6e 6f70 2773 2053 5041 206d 6573 7361  knop's SPA messa
│ │ │ │ │ -00001d40: 6765 2064 6174 610a 2020 2020 2066 6f72  ge data.     for
│ │ │ │ │ -00001d50: 6d61 742c 2065 6e63 6f64 696e 672c 2064  mat, encoding, d
│ │ │ │ │ -00001d60: 6563 6f64 696e 672c 2065 6e63 7279 7074  ecoding, encrypt
│ │ │ │ │ -00001d70: 696e 672c 2064 6563 7279 7074 696e 672c  ing, decrypting,
│ │ │ │ │ -00001d80: 2061 7574 6865 6e74 6963 6174 696e 672c   authenticating,
│ │ │ │ │ -00001d90: 0a20 2020 2020 616e 6420 7061 7273 696e  .     and parsin
│ │ │ │ │ -00001da0: 672e 2020 496e 206d 6f73 7420 6361 7365  g.  In most case
│ │ │ │ │ -00001db0: 732c 206f 6e6c 7920 6120 6665 7720 6675  s, only a few fu
│ │ │ │ │ -00001dc0: 6e63 7469 6f6e 2063 616c 6c73 2077 696c  nction calls wil
│ │ │ │ │ -00001dd0: 6c20 6265 0a20 2020 2020 6e65 6564 6564  l be.     needed
│ │ │ │ │ -00001de0: 2063 7265 6174 6520 6f72 2070 6172 7365   create or parse
│ │ │ │ │ -00001df0: 2061 2053 5041 206d 6573 7361 6765 2e0a   a SPA message..
│ │ │ │ │ -00001e00: 0a1f 0a46 696c 653a 206c 6962 666b 6f2e  ...File: libfko.
│ │ │ │ │ -00001e10: 696e 666f 2c20 204e 6f64 653a 204f 7665  info,  Node: Ove
│ │ │ │ │ -00001e20: 7276 6965 772c 2020 5072 6576 3a20 4665  rview,  Prev: Fe
│ │ │ │ │ -00001e30: 6174 7572 6573 2c20 2055 703a 2049 6e74  atures,  Up: Int
│ │ │ │ │ -00001e40: 726f 6475 6374 696f 6e0a 0a31 2e33 204f  roduction..1.3 O
│ │ │ │ │ -00001e50: 7665 7276 6965 770a 3d3d 3d3d 3d3d 3d3d  verview.========
│ │ │ │ │ -00001e60: 3d3d 3d3d 0a0a 2a20 4d65 6e75 3a0a 0a2a  ====..* Menu:..*
│ │ │ │ │ -00001e70: 2053 5041 2044 6174 6120 466f 726d 6174   SPA Data Format
│ │ │ │ │ -00001e80: 3a3a 2020 2020 2020 2020 2020 2020 2020  ::              
│ │ │ │ │ -00001e90: 2044 6573 6372 6970 7469 6f6e 206f 6620   Description of 
│ │ │ │ │ -00001ea0: 7468 6520 5350 4120 6461 7461 0a20 2020  the SPA data.   
│ │ │ │ │ +00001800: 3d0a 0a54 6869 7320 6d61 6e75 616c 2064  =..This manual d
│ │ │ │ │ +00001810: 6f63 756d 656e 7473 2074 6865 2022 4669  ocuments the "Fi
│ │ │ │ │ +00001820: 7265 7761 6c6c 204b 6e6f 636b 204f 7065  rewall Knock Ope
│ │ │ │ │ +00001830: 7261 746f 7222 206c 6962 7261 7279 2070  rator" library p
│ │ │ │ │ +00001840: 726f 6772 616d 6d69 6e67 0a69 6e74 6572  rogramming.inter
│ │ │ │ │ +00001850: 6661 6365 2e20 2041 6c6c 2066 756e 6374  face.  All funct
│ │ │ │ │ +00001860: 696f 6e73 2061 6e64 2064 6174 6120 7479  ions and data ty
│ │ │ │ │ +00001870: 7065 7320 7072 6f76 6964 6564 2062 7920  pes provided by 
│ │ │ │ │ +00001880: 7468 6520 6c69 6272 6172 7920 6172 650a  the library are.
│ │ │ │ │ +00001890: 6578 706c 6169 6e65 642e 0a0a 2020 2054  explained...   T
│ │ │ │ │ +000018a0: 6869 7320 6d61 6e75 616c 2063 616e 2062  his manual can b
│ │ │ │ │ +000018b0: 6520 7573 6564 2069 6e20 6120 636f 7570  e used in a coup
│ │ │ │ │ +000018c0: 6c65 206f 6620 7761 7973 2e20 2049 6620  le of ways.  If 
│ │ │ │ │ +000018d0: 7265 6164 2066 726f 6d20 7468 650a 6265  read from the.be
│ │ │ │ │ +000018e0: 6769 6e6e 696e 6720 746f 2074 6865 2065  ginning to the e
│ │ │ │ │ +000018f0: 6e64 2c20 6974 2073 686f 756c 6420 6769  nd, it should gi
│ │ │ │ │ +00001900: 7665 2061 2067 6f6f 6420 696e 7472 6f64  ve a good introd
│ │ │ │ │ +00001910: 7563 7469 6f6e 2069 6e74 6f20 7468 650a  uction into the.
│ │ │ │ │ +00001920: 6c69 6272 6172 7920 616e 6420 686f 7720  library and how 
│ │ │ │ │ +00001930: 6974 2063 616e 2062 6520 7573 6564 2069  it can be used i
│ │ │ │ │ +00001940: 6e20 616e 2061 7070 6c69 6361 7469 6f6e  n an application
│ │ │ │ │ +00001950: 2e20 204c 6174 6572 206f 6e2c 2074 6865  .  Later on, the
│ │ │ │ │ +00001960: 206d 616e 7561 6c0a 6361 6e20 6265 2075   manual.can be u
│ │ │ │ │ +00001970: 7365 6420 6173 2061 2072 6566 6572 656e  sed as a referen
│ │ │ │ │ +00001980: 6365 206d 616e 7561 6c20 746f 2067 6574  ce manual to get
│ │ │ │ │ +00001990: 206a 7573 7420 7468 6520 696e 666f 726d   just the inform
│ │ │ │ │ +000019a0: 6174 696f 6e20 6e65 6564 6564 0a61 626f  ation needed.abo
│ │ │ │ │ +000019b0: 7574 2061 6e79 2070 6172 7469 6375 6c61  ut any particula
│ │ │ │ │ +000019c0: 7220 696e 7465 7266 6163 6520 6f66 2074  r interface of t
│ │ │ │ │ +000019d0: 6865 206c 6962 7261 7279 2e0a 0a1f 0a46  he library.....F
│ │ │ │ │ +000019e0: 696c 653a 206c 6962 666b 6f2e 696e 666f  ile: libfko.info
│ │ │ │ │ +000019f0: 2c20 204e 6f64 653a 2046 6561 7475 7265  ,  Node: Feature
│ │ │ │ │ +00001a00: 732c 2020 4e65 7874 3a20 4f76 6572 7669  s,  Next: Overvi
│ │ │ │ │ +00001a10: 6577 2c20 2050 7265 763a 2047 6574 7469  ew,  Prev: Getti
│ │ │ │ │ +00001a20: 6e67 2053 7461 7274 6564 2c20 2055 703a  ng Started,  Up:
│ │ │ │ │ +00001a30: 2049 6e74 726f 6475 6374 696f 6e0a 0a31   Introduction..1
│ │ │ │ │ +00001a40: 2e32 2046 6561 7475 7265 730a 3d3d 3d3d  .2 Features.====
│ │ │ │ │ +00001a50: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 7072  ========..The pr
│ │ │ │ │ +00001a60: 696d 6172 7920 6164 7661 6e74 6167 6520  imary advantage 
│ │ │ │ │ +00001a70: 6f66 2075 7369 6e67 206c 6962 666b 6f20  of using libfko 
│ │ │ │ │ +00001a80: 6973 2069 7420 7072 6f76 6964 6573 2061  is it provides a
│ │ │ │ │ +00001a90: 2073 696e 676c 6520 4150 4920 666f 720a   single API for.
│ │ │ │ │ +00001aa0: 6569 7468 6572 2063 7265 6174 696e 6720  either creating 
│ │ │ │ │ +00001ab0: 6f72 2070 6172 7369 6e67 2053 5041 2064  or parsing SPA d
│ │ │ │ │ +00001ac0: 6174 612e 2020 4164 6469 7469 6f6e 616c  ata.  Additional
│ │ │ │ │ +00001ad0: 2061 6476 616e 7461 6765 7320 696e 636c   advantages incl
│ │ │ │ │ +00001ae0: 7564 653a 0a0a 4974 2773 2066 7265 6520  ude:..It's free 
│ │ │ │ │ +00001af0: 736f 6674 7761 7265 0a20 2020 2020 416e  software.     An
│ │ │ │ │ +00001b00: 7962 6f64 7920 6361 6e20 7573 652c 206d  ybody can use, m
│ │ │ │ │ +00001b10: 6f64 6966 792c 2061 6e64 2072 6564 6973  odify, and redis
│ │ │ │ │ +00001b20: 7472 6962 7574 6520 6974 2075 6e64 6572  tribute it under
│ │ │ │ │ +00001b30: 2074 6865 2074 6572 6d73 206f 6620 7468   the terms of th
│ │ │ │ │ +00001b40: 650a 2020 2020 2047 4e55 2047 656e 6572  e.     GNU Gener
│ │ │ │ │ +00001b50: 616c 2050 7562 6c69 6320 4c69 6365 6e73  al Public Licens
│ │ │ │ │ +00001b60: 6520 7632 206f 7220 616e 7920 6c61 7465  e v2 or any late
│ │ │ │ │ +00001b70: 7220 7665 7273 696f 6e20 282a 6e6f 7465  r version (*note
│ │ │ │ │ +00001b80: 204c 6962 7261 7279 0a20 2020 2020 436f   Library.     Co
│ │ │ │ │ +00001b90: 7079 696e 673a 3a29 2e0a 0a49 7427 7320  pying::)...It's 
│ │ │ │ │ +00001ba0: 6c69 6768 7477 6569 6768 740a 2020 2020  lightweight.    
│ │ │ │ │ +00001bb0: 2054 6865 2050 6572 6c2d 6261 7365 6420   The Perl-based 
│ │ │ │ │ +00001bc0: 696d 706c 656d 656e 7461 7469 6f6e 2072  implementation r
│ │ │ │ │ +00001bd0: 6571 7569 7265 7320 7365 7665 7261 6c20  equires several 
│ │ │ │ │ +00001be0: 6164 6469 7469 6f6e 616c 2050 6572 6c0a  additional Perl.
│ │ │ │ │ +00001bf0: 2020 2020 206d 6f64 756c 6573 2061 6e64       modules and
│ │ │ │ │ +00001c00: 2068 6173 2061 2072 656c 6174 6976 656c   has a relativel
│ │ │ │ │ +00001c10: 7920 6c61 7267 6520 666f 6f74 7072 696e  y large footprin
│ │ │ │ │ +00001c20: 7420 696e 206d 656d 6f72 792e 2020 5468  t in memory.  Th
│ │ │ │ │ +00001c30: 6973 0a20 2020 2020 432d 6261 7365 6420  is.     C-based 
│ │ │ │ │ +00001c40: 6c69 6272 6172 7920 656c 696d 696e 6174  library eliminat
│ │ │ │ │ +00001c50: 6573 2074 686f 7365 2064 6570 656e 6465  es those depende
│ │ │ │ │ +00001c60: 6e63 6965 7320 616e 6420 6861 7320 6120  ncies and has a 
│ │ │ │ │ +00001c70: 6d75 6368 0a20 2020 2020 736d 616c 6c65  much.     smalle
│ │ │ │ │ +00001c80: 7220 666f 6f74 7072 696e 742e 2020 5573  r footprint.  Us
│ │ │ │ │ +00001c90: 696e 6720 7468 6973 206c 6962 7261 7279  ing this library
│ │ │ │ │ +00001ca0: 2061 6c6c 6f77 7320 5350 4120 746f 2065   allows SPA to e
│ │ │ │ │ +00001cb0: 6173 696c 790a 2020 2020 2066 756e 6374  asily.     funct
│ │ │ │ │ +00001cc0: 696f 6e20 6f6e 2065 6d62 6564 6465 6420  ion on embedded 
│ │ │ │ │ +00001cd0: 6f70 6572 6174 696e 6720 7379 7374 656d  operating system
│ │ │ │ │ +00001ce0: 7320 7375 6368 2061 7320 4f70 656e 5752  s such as OpenWR
│ │ │ │ │ +00001cf0: 542e 0a0a 4974 2773 2065 6173 790a 2020  T...It's easy.  
│ │ │ │ │ +00001d00: 2020 206c 6962 666b 6f20 6869 6465 7320     libfko hides 
│ │ │ │ │ +00001d10: 6d61 6e79 206f 6620 7468 6520 676f 7279  many of the gory
│ │ │ │ │ +00001d20: 2064 6574 6169 6c73 206f 6620 6677 6b6e   details of fwkn
│ │ │ │ │ +00001d30: 6f70 2773 2053 5041 206d 6573 7361 6765  op's SPA message
│ │ │ │ │ +00001d40: 2064 6174 610a 2020 2020 2066 6f72 6d61   data.     forma
│ │ │ │ │ +00001d50: 742c 2065 6e63 6f64 696e 672c 2064 6563  t, encoding, dec
│ │ │ │ │ +00001d60: 6f64 696e 672c 2065 6e63 7279 7074 696e  oding, encryptin
│ │ │ │ │ +00001d70: 672c 2064 6563 7279 7074 696e 672c 2061  g, decrypting, a
│ │ │ │ │ +00001d80: 7574 6865 6e74 6963 6174 696e 672c 0a20  uthenticating,. 
│ │ │ │ │ +00001d90: 2020 2020 616e 6420 7061 7273 696e 672e      and parsing.
│ │ │ │ │ +00001da0: 2020 496e 206d 6f73 7420 6361 7365 732c    In most cases,
│ │ │ │ │ +00001db0: 206f 6e6c 7920 6120 6665 7720 6675 6e63   only a few func
│ │ │ │ │ +00001dc0: 7469 6f6e 2063 616c 6c73 2077 696c 6c20  tion calls will 
│ │ │ │ │ +00001dd0: 6265 0a20 2020 2020 6e65 6564 6564 2063  be.     needed c
│ │ │ │ │ +00001de0: 7265 6174 6520 6f72 2070 6172 7365 2061  reate or parse a
│ │ │ │ │ +00001df0: 2053 5041 206d 6573 7361 6765 2e0a 0a1f   SPA message....
│ │ │ │ │ +00001e00: 0a46 696c 653a 206c 6962 666b 6f2e 696e  .File: libfko.in
│ │ │ │ │ +00001e10: 666f 2c20 204e 6f64 653a 204f 7665 7276  fo,  Node: Overv
│ │ │ │ │ +00001e20: 6965 772c 2020 5072 6576 3a20 4665 6174  iew,  Prev: Feat
│ │ │ │ │ +00001e30: 7572 6573 2c20 2055 703a 2049 6e74 726f  ures,  Up: Intro
│ │ │ │ │ +00001e40: 6475 6374 696f 6e0a 0a31 2e33 204f 7665  duction..1.3 Ove
│ │ │ │ │ +00001e50: 7276 6965 770a 3d3d 3d3d 3d3d 3d3d 3d3d  rview.==========
│ │ │ │ │ +00001e60: 3d3d 0a0a 2a20 4d65 6e75 3a0a 0a2a 2053  ==..* Menu:..* S
│ │ │ │ │ +00001e70: 5041 2044 6174 6120 466f 726d 6174 3a3a  PA Data Format::
│ │ │ │ │ +00001e80: 2020 2020 2020 2020 2020 2020 2020 2044                 D
│ │ │ │ │ +00001e90: 6573 6372 6970 7469 6f6e 206f 6620 7468  escription of th
│ │ │ │ │ +00001ea0: 6520 5350 4120 6461 7461 0a20 2020 2020  e SPA data.     
│ │ │ │ │  00001eb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00001ec0: 2020 2020 2020 2020 2020 2020 2020 2066                 f
│ │ │ │ │ -00001ed0: 6f72 6d61 742e 0a0a 6c69 6266 6b6f 2066  ormat...libfko f
│ │ │ │ │ -00001ee0: 756e 6374 696f 6e61 6c69 7479 2063 616e  unctionality can
│ │ │ │ │ -00001ef0: 2062 6520 6469 7669 6465 6420 696e 746f   be divided into
│ │ │ │ │ -00001f00: 2074 776f 2072 6f6c 6573 2e20 204f 6e65   two roles.  One
│ │ │ │ │ -00001f10: 2069 7320 7468 6520 6372 6561 7469 6f6e   is the creation
│ │ │ │ │ -00001f20: 0a6f 6620 616e 2065 6e63 7279 7074 6564  .of an encrypted
│ │ │ │ │ -00001f30: 2053 5041 206d 6573 7361 6765 2074 6f67   SPA message tog
│ │ │ │ │ -00001f40: 6574 6865 7220 7769 7468 2061 6e20 484d  ether with an HM
│ │ │ │ │ -00001f50: 4143 2066 6f72 2061 7574 6865 6e74 6963  AC for authentic
│ │ │ │ │ -00001f60: 6174 696f 6e2e 0a54 6865 206f 7468 6572  ation..The other
│ │ │ │ │ -00001f70: 2069 7320 7468 6520 7461 6b69 6e67 2061   is the taking a
│ │ │ │ │ -00001f80: 6e20 656e 6372 7970 7465 6420 5350 4120  n encrypted SPA 
│ │ │ │ │ -00001f90: 6d65 7373 6167 6520 746f 2061 7574 6865  message to authe
│ │ │ │ │ -00001fa0: 6e74 6963 6174 652c 0a64 6563 6f64 652c  nticate,.decode,
│ │ │ │ │ -00001fb0: 2070 6172 7365 2c20 616e 6420 6578 7472   parse, and extr
│ │ │ │ │ -00001fc0: 6163 7420 7468 6520 6f72 6967 696e 616c  act the original
│ │ │ │ │ -00001fd0: 2064 6174 612e 0a0a 2020 2054 6865 2061   data...   The a
│ │ │ │ │ -00001fe0: 6374 7561 6c20 5350 4120 6461 7461 2068  ctual SPA data h
│ │ │ │ │ -00001ff0: 616e 646c 696e 6720 616e 6420 6f70 6572  andling and oper
│ │ │ │ │ -00002000: 6174 696f 6e73 2061 7265 2073 6574 2077  ations are set w
│ │ │ │ │ -00002010: 6974 6869 6e20 6120 636f 6e74 6578 742e  ithin a context.
│ │ │ │ │ -00002020: 0a54 6865 2063 6f6e 7465 7874 2072 6570  .The context rep
│ │ │ │ │ -00002030: 7265 7365 6e74 7320 6120 7369 6e67 6c65  resents a single
│ │ │ │ │ -00002040: 2053 5041 206d 6573 7361 6765 2061 6e64   SPA message and
│ │ │ │ │ -00002050: 2070 726f 7669 6465 7320 636f 6e66 6967   provides config
│ │ │ │ │ -00002060: 7572 6174 696f 6e0a 7061 7261 6d65 7465  uration.paramete
│ │ │ │ │ -00002070: 7273 2061 6e64 2064 6174 6120 7365 7474  rs and data sett
│ │ │ │ │ -00002080: 696e 6773 2066 6f72 2064 6566 696e 696e  ings for definin
│ │ │ │ │ -00002090: 6720 7468 6174 206d 6573 7361 6765 2e20  g that message. 
│ │ │ │ │ -000020a0: 2041 6c6c 206f 7065 7261 7469 6f6e 730a   All operations.
│ │ │ │ │ -000020b0: 6f6e 2074 6865 2064 6174 6120 6f63 6375  on the data occu
│ │ │ │ │ -000020c0: 7220 7769 7468 696e 2074 6861 7420 636f  r within that co
│ │ │ │ │ -000020d0: 6e74 6578 742e 0a0a 2020 2053 6f6d 6520  ntext...   Some 
│ │ │ │ │ -000020e0: 6f70 6572 6174 696f 6e73 206f 6e20 7468  operations on th
│ │ │ │ │ -000020f0: 6520 636f 6e74 6578 7420 6d75 7374 206f  e context must o
│ │ │ │ │ -00002100: 6363 7572 2062 6566 6f72 6520 6f74 6865  ccur before othe
│ │ │ │ │ -00002110: 7273 2e20 2044 6574 6169 6c73 206f 660a  rs.  Details of.
│ │ │ │ │ -00002120: 7468 6573 6520 6465 7065 6e64 656e 6369  these dependenci
│ │ │ │ │ -00002130: 6573 2061 7265 2063 6f76 6572 6564 2069  es are covered i
│ │ │ │ │ -00002140: 6e20 2a6e 6f74 6520 4372 6561 7469 6e67  n *note Creating
│ │ │ │ │ -00002150: 2061 2053 5041 204d 6573 7361 6765 3a3a   a SPA Message::
│ │ │ │ │ -00002160: 2e0a 0a57 6974 6820 6c69 6266 6b6f 2c20  ...With libfko, 
│ │ │ │ │ -00002170: 776f 726b 696e 6720 7769 7468 2053 5041  working with SPA
│ │ │ │ │ -00002180: 206d 6573 7361 6765 2064 6174 6120 6261   message data ba
│ │ │ │ │ -00002190: 7369 6361 6c6c 7920 636f 6e73 6973 7473  sically consists
│ │ │ │ │ -000021a0: 206f 6620 7468 650a 666f 6c6c 6f77 696e   of the.followin
│ │ │ │ │ -000021b0: 6720 7374 6570 7320 696e 206f 7264 6572  g steps in order
│ │ │ │ │ -000021c0: 3a0a 0a20 2020 2a20 4372 6561 7465 2061  :..   * Create a
│ │ │ │ │ -000021d0: 206e 6577 2063 6f6e 7465 7874 0a20 2020   new context.   
│ │ │ │ │ -000021e0: 2a20 576f 726b 2077 6974 6820 2867 6574  * Work with (get
│ │ │ │ │ -000021f0: 2f73 6574 2920 7468 6520 5350 4120 6461  /set) the SPA da
│ │ │ │ │ -00002200: 7461 2066 6965 6c64 730a 2020 202a 2044  ta fields.   * D
│ │ │ │ │ -00002210: 6573 7472 6f79 2074 6865 2063 6f6e 7465  estroy the conte
│ │ │ │ │ -00002220: 7874 0a0a 1f0a 4669 6c65 3a20 6c69 6266  xt....File: libf
│ │ │ │ │ -00002230: 6b6f 2e69 6e66 6f2c 2020 4e6f 6465 3a20  ko.info,  Node: 
│ │ │ │ │ -00002240: 5350 4120 4461 7461 2046 6f72 6d61 742c  SPA Data Format,
│ │ │ │ │ -00002250: 2020 5570 3a20 4f76 6572 7669 6577 0a0a    Up: Overview..
│ │ │ │ │ -00002260: 312e 332e 3120 5350 4120 4461 7461 2046  1.3.1 SPA Data F
│ │ │ │ │ -00002270: 6f72 6d61 740a 2d2d 2d2d 2d2d 2d2d 2d2d  ormat.----------
│ │ │ │ │ -00002280: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865  -----------..The
│ │ │ │ │ -00002290: 2066 6f72 6d61 7420 6f66 2074 6865 2053   format of the S
│ │ │ │ │ -000022a0: 5041 206d 6573 7361 6765 2064 6174 6120  PA message data 
│ │ │ │ │ -000022b0: 7573 6564 2062 7920 6677 6b6e 6f70 2028  used by fwknop (
│ │ │ │ │ -000022c0: 6265 666f 7265 2065 6e63 7279 7074 696f  before encryptio
│ │ │ │ │ -000022d0: 6e20 616e 640a 6265 666f 7265 2061 6e20  n and.before an 
│ │ │ │ │ -000022e0: 484d 4143 2069 7320 6170 706c 6965 6429  HMAC is applied)
│ │ │ │ │ -000022f0: 2069 7320 6120 636f 6c6f 6e2d 6465 6c69   is a colon-deli
│ │ │ │ │ -00002300: 6d69 7465 6420 7374 7269 6e67 2063 6f6e  mited string con
│ │ │ │ │ -00002310: 7461 696e 696e 6720 7468 650a 696e 6469  taining the.indi
│ │ │ │ │ -00002320: 7669 6475 616c 2053 5041 2064 6174 6120  vidual SPA data 
│ │ │ │ │ -00002330: 6669 656c 6473 2e20 2053 6f6d 6520 6f66  fields.  Some of
│ │ │ │ │ -00002340: 2074 6865 7365 2066 6965 6c64 7320 6172   these fields ar
│ │ │ │ │ -00002350: 6520 6261 7365 3634 2d65 6e63 6f64 6564  e base64-encoded
│ │ │ │ │ -00002360: 2069 6e0a 7468 6520 6669 6e61 6c20 656e   in.the final en
│ │ │ │ │ -00002370: 636f 6469 6e67 2070 726f 6365 7373 2061  coding process a
│ │ │ │ │ -00002380: 7320 6469 6374 6174 6564 2062 7920 7468  s dictated by th
│ │ │ │ │ -00002390: 6520 6375 7272 656e 7420 6677 6b6e 6f70  e current fwknop
│ │ │ │ │ -000023a0: 0a69 6d70 6c65 6d65 6e74 6174 696f 6e2e  .implementation.
│ │ │ │ │ -000023b0: 0a0a 202d 2d20 5661 7269 6162 6c65 3a20  .. -- Variable: 
│ │ │ │ │ -000023c0: 6461 7461 2073 7061 5f6d 6573 7361 6765  data spa_message
│ │ │ │ │ -000023d0: 5f66 6965 6c64 730a 2020 2020 2055 7369  _fields.     Usi
│ │ │ │ │ -000023e0: 6e67 2074 6865 206c 6962 666b 6f20 6e61  ng the libfko na
│ │ │ │ │ -000023f0: 6d65 7320 666f 7220 7468 6520 6461 7461  mes for the data
│ │ │ │ │ -00002400: 2066 6965 6c64 732c 2074 6865 206c 6973   fields, the lis
│ │ │ │ │ -00002410: 7420 6f66 2074 6865 7365 0a20 2020 2020  t of these.     
│ │ │ │ │ -00002420: 6669 656c 6473 2028 696e 206f 7264 6572  fields (in order
│ │ │ │ │ -00002430: 2920 666f 6c6c 6f77 733a 0a20 2020 2020  ) follows:.     
│ │ │ │ │ -00002440: 272a 7261 6e64 5f76 616c 7565 2a20 2d20  '*rand_value* - 
│ │ │ │ │ -00002450: 5f44 6566 6175 6c74 3a20 5261 6e64 6f6d  _Default: Random
│ │ │ │ │ -00002460: 2028 6372 6561 7465 6420 7570 6f6e 2063   (created upon c
│ │ │ │ │ -00002470: 6f6e 7465 7874 2063 7265 6174 696f 6e29  ontext creation)
│ │ │ │ │ -00002480: 5f27 0a20 2020 2020 2020 2020 2041 2031  _'.          A 1
│ │ │ │ │ -00002490: 362d 6279 7465 2072 616e 646f 6d20 6e75  6-byte random nu
│ │ │ │ │ -000024a0: 6d65 7269 6320 7374 7269 6e67 2e0a 2020  meric string..  
│ │ │ │ │ -000024b0: 2020 2027 2a75 7365 726e 616d 652a 202d     '*username* -
│ │ │ │ │ -000024c0: 205f 4465 6661 756c 743a 2043 7572 7265   _Default: Curre
│ │ │ │ │ -000024d0: 6e74 206c 6f67 696e 2075 7365 7220 6f72  nt login user or
│ │ │ │ │ -000024e0: 2056 616c 7565 206f 6620 5350 4f4f 465f   Value of SPOOF_
│ │ │ │ │ -000024f0: 5553 4552 2065 6e76 2076 6172 5f27 0a20  USER env var_'. 
│ │ │ │ │ -00002500: 2020 2020 2020 2020 2054 6865 2062 6173           The bas
│ │ │ │ │ -00002510: 6536 342d 656e 636f 6465 6420 7573 6572  e64-encoded user
│ │ │ │ │ -00002520: 6e61 6d65 2061 7373 6f63 6961 7465 6420  name associated 
│ │ │ │ │ -00002530: 7769 7468 2074 6869 7320 5350 4120 6461  with this SPA da
│ │ │ │ │ -00002540: 7461 2e0a 2020 2020 2027 2a74 696d 6573  ta..     '*times
│ │ │ │ │ -00002550: 7461 6d70 2a20 2d20 5f44 6566 6175 6c74  tamp* - _Default
│ │ │ │ │ -00002560: 3a20 5468 6520 556e 6978 2074 696d 6520  : The Unix time 
│ │ │ │ │ -00002570: 6174 2063 7265 6174 696f 6e5f 270a 2020  at creation_'.  
│ │ │ │ │ -00002580: 2020 2020 2020 2020 5468 6520 556e 6978          The Unix
│ │ │ │ │ -00002590: 2074 696d 6573 7461 6d70 2076 616c 7565   timestamp value
│ │ │ │ │ -000025a0: 2e0a 2020 2020 2027 2a76 6572 7369 6f6e  ..     '*version
│ │ │ │ │ -000025b0: 2a20 2d20 5f44 6566 6175 6c74 3a20 7468  * - _Default: th
│ │ │ │ │ -000025c0: 6520 6375 7272 656e 7420 6677 6b6e 6f70  e current fwknop
│ │ │ │ │ -000025d0: 2076 6572 7369 6f6e 5f27 0a20 2020 2020   version_'.     
│ │ │ │ │ -000025e0: 2020 2020 2054 6865 2063 7572 7265 6e74       The current
│ │ │ │ │ -000025f0: 2066 776b 6e6f 7020 7665 7273 696f 6e20   fwknop version 
│ │ │ │ │ -00002600: 7468 6174 2073 7570 706f 7274 7320 7468  that supports th
│ │ │ │ │ -00002610: 6973 2066 6f72 6d61 742e 2020 5468 6973  is format.  This
│ │ │ │ │ -00002620: 0a20 2020 2020 2020 2020 2066 6965 6c64  .          field
│ │ │ │ │ -00002630: 2069 7320 6e6f 7420 7573 6572 2073 6574   is not user set
│ │ │ │ │ -00002640: 7461 626c 652e 0a20 2020 2020 272a 7370  table..     '*sp
│ │ │ │ │ -00002650: 615f 6d65 7373 6167 655f 7479 7065 2a20  a_message_type* 
│ │ │ │ │ -00002660: 2d20 5f44 6566 6175 6c74 3a20 5350 4120  - _Default: SPA 
│ │ │ │ │ -00002670: 6163 6365 7373 206d 6573 7361 6765 2028  access message (
│ │ │ │ │ -00002680: 464b 4f5f 4143 4345 5353 5f4d 5347 295f  FKO_ACCESS_MSG)_
│ │ │ │ │ -00002690: 270a 2020 2020 2020 2020 2020 5468 6520  '.          The 
│ │ │ │ │ -000026a0: 5350 4120 6d65 7373 6167 6520 7479 7065  SPA message type
│ │ │ │ │ -000026b0: 2076 616c 7565 2066 6f72 2074 6869 7320   value for this 
│ │ │ │ │ -000026c0: 6d65 7373 6167 652e 0a20 2020 2020 272a  message..     '*
│ │ │ │ │ -000026d0: 7370 615f 6d65 7373 6167 652a 270a 2020  spa_message*'.  
│ │ │ │ │ -000026e0: 2020 2020 2020 2020 5468 6520 6261 7365          The base
│ │ │ │ │ -000026f0: 3634 2d65 6e63 6f64 6564 2053 5041 206d  64-encoded SPA m
│ │ │ │ │ -00002700: 6573 7361 6765 2069 7473 656c 6620 2861  essage itself (a
│ │ │ │ │ -00002710: 6e20 6163 6365 7373 2072 6571 7565 7374  n access request
│ │ │ │ │ -00002720: 206f 720a 2020 2020 2020 2020 2020 636f   or.          co
│ │ │ │ │ -00002730: 6d6d 616e 6420 7374 7269 6e67 292e 0a20  mmand string).. 
│ │ │ │ │ -00002740: 2020 2020 272a 7370 615f 6e61 745f 6163      '*spa_nat_ac
│ │ │ │ │ -00002750: 6365 7373 2a27 0a20 2020 2020 2020 2020  cess*'.         
│ │ │ │ │ -00002760: 2041 6e20 6f70 7469 6f6e 616c 2062 6173   An optional bas
│ │ │ │ │ -00002770: 6536 342d 656e 636f 6465 6420 7265 7175  e64-encoded requ
│ │ │ │ │ -00002780: 6573 7420 666f 7220 4e41 5420 6163 6365  est for NAT acce
│ │ │ │ │ -00002790: 7373 2e0a 2020 2020 2027 2a73 7061 5f73  ss..     '*spa_s
│ │ │ │ │ -000027a0: 6572 7665 725f 6175 7468 2a27 0a20 2020  erver_auth*'.   
│ │ │ │ │ -000027b0: 2020 2020 2020 2041 6e20 6f70 7469 6f6e         An option
│ │ │ │ │ -000027c0: 616c 2062 6173 6536 342d 656e 636f 6465  al base64-encode
│ │ │ │ │ -000027d0: 6420 7374 7269 6e67 2074 6861 7420 6361  d string that ca
│ │ │ │ │ -000027e0: 6e20 6265 2075 7365 6420 6173 2061 6e0a  n be used as an.
│ │ │ │ │ -000027f0: 2020 2020 2020 2020 2020 6164 6469 7469            additi
│ │ │ │ │ -00002800: 6f6e 616c 2061 7574 6865 6e74 6963 6174  onal authenticat
│ │ │ │ │ -00002810: 696f 6e20 6d65 6368 616e 6973 6d20 6174  ion mechanism at
│ │ │ │ │ -00002820: 2074 6865 2066 776b 6e6f 7020 7365 7276   the fwknop serv
│ │ │ │ │ -00002830: 6572 2e0a 2020 2020 2027 2a73 7061 5f63  er..     '*spa_c
│ │ │ │ │ -00002840: 6c69 656e 745f 7469 6d65 6f75 742a 270a  lient_timeout*'.
│ │ │ │ │ -00002850: 2020 2020 2020 2020 2020 416e 206f 7074            An opt
│ │ │ │ │ -00002860: 696f 6e61 6c20 636c 6965 6e74 2074 696d  ional client tim
│ │ │ │ │ -00002870: 656f 7574 2076 616c 7565 2074 6861 7420  eout value that 
│ │ │ │ │ -00002880: 6361 6e20 6265 2073 7570 706c 6965 6420  can be supplied 
│ │ │ │ │ -00002890: 746f 2074 6865 0a20 2020 2020 2020 2020  to the.         
│ │ │ │ │ -000028a0: 2066 776b 6e6f 7020 7365 7276 6572 2e0a   fwknop server..
│ │ │ │ │ -000028b0: 2020 2020 2027 2a73 7061 5f64 6967 6573       '*spa_diges
│ │ │ │ │ -000028c0: 742a 202d 205f 436f 6d70 7574 6564 2076  t* - _Computed v
│ │ │ │ │ -000028d0: 616c 7565 5f27 0a20 2020 2020 2020 2020  alue_'.         
│ │ │ │ │ -000028e0: 2054 6865 2064 6967 6573 7420 6f66 2074   The digest of t
│ │ │ │ │ -000028f0: 6865 2070 7265 7669 6f75 7320 6669 656c  he previous fiel
│ │ │ │ │ -00002900: 6473 2028 696e 636c 7564 696e 6720 7468  ds (including th
│ │ │ │ │ -00002910: 6520 6465 6c69 6d69 7465 7273 292e 0a0a  e delimiters)...
│ │ │ │ │ -00002920: 2020 2057 6974 6820 616c 6c20 6669 656c     With all fiel
│ │ │ │ │ -00002930: 6473 2064 6566 696e 6564 2c20 6120 636f  ds defined, a co
│ │ │ │ │ -00002940: 6d70 6c65 7465 2028 756e 656e 636f 6465  mplete (unencode
│ │ │ │ │ -00002950: 6429 2053 5041 206d 6573 7361 6765 2077  d) SPA message w
│ │ │ │ │ -00002960: 6f75 6c64 0a6c 6f6f 6b20 736f 6d65 7468  ould.look someth
│ │ │ │ │ -00002970: 696e 6720 6c69 6b65 2074 6865 2066 6f6c  ing like the fol
│ │ │ │ │ -00002980: 6c6f 7769 6e67 2065 7861 6d70 6c65 2028  lowing example (
│ │ │ │ │ -00002990: 4e6f 7465 3a20 5468 6520 6c69 6e65 2069  Note: The line i
│ │ │ │ │ -000029a0: 7320 6272 6f6b 656e 2066 6f72 0a72 6561  s broken for.rea
│ │ │ │ │ -000029b0: 6461 6269 6c69 7479 2061 6e64 2074 6865  dability and the
│ │ │ │ │ -000029c0: 2075 7365 726e 616d 652c 206d 6573 7361   username, messa
│ │ │ │ │ -000029d0: 6765 2c20 6e61 745f 6163 6365 7373 2c20  ge, nat_access, 
│ │ │ │ │ -000029e0: 616e 6420 7365 7276 6572 5f61 7574 680a  and server_auth.
│ │ │ │ │ -000029f0: 6669 656c 6473 2061 7265 206e 6f74 2062  fields are not b
│ │ │ │ │ -00002a00: 6173 6536 342d 656e 636f 6465 6429 3a0a  ase64-encoded):.
│ │ │ │ │ -00002a10: 0a0a 2020 2020 2038 3330 3735 3430 3938  ..     830754098
│ │ │ │ │ -00002a20: 3231 3736 3533 393a 6a75 7365 723a 3132  2176539:juser:12
│ │ │ │ │ -00002a30: 3330 3636 3531 3732 3a32 2e35 3a31 3a31  30665172:2.5:1:1
│ │ │ │ │ -00002a40: 2e31 2e31 2e31 2c74 6370 2f32 323a 3139  .1.1.1,tcp/22:19
│ │ │ │ │ -00002a50: 322e 3136 382e 312e 322c 3232 3a0a 2020  2.168.1.2,22:.  
│ │ │ │ │ -00002a60: 2020 2063 7279 7074 2c6d 7970 773a 3132     crypt,mypw:12
│ │ │ │ │ -00002a70: 303a 7873 776a 3856 307a 4d52 372f 374d  0:xswj8V0zMR7/7M
│ │ │ │ │ -00002a80: 5639 7051 5261 7253 4b57 4731 6c39 5a66  V9pQRarSKWG1l9Zf
│ │ │ │ │ -00002a90: 6a76 2b6b 6258 614b 724a 2b52 410a 0a20  jv+kbXaKrJ+RA.. 
│ │ │ │ │ -00002aa0: 2020 466f 7220 6d6f 7374 206f 6620 7468    For most of th
│ │ │ │ │ -00002ab0: 6520 6669 656c 6473 2c20 796f 7520 6e65  e fields, you ne
│ │ │ │ │ -00002ac0: 6564 206e 6f74 2062 6520 746f 6f20 636f  ed not be too co
│ │ │ │ │ -00002ad0: 6e63 6572 6e65 6420 6162 6f75 7420 7468  ncerned about th
│ │ │ │ │ -00002ae0: 650a 666f 726d 6174 2061 7320 6c69 6266  e.format as libf
│ │ │ │ │ -00002af0: 6b6f 2068 616e 646c 6573 2074 6861 742e  ko handles that.
│ │ │ │ │ -00002b00: 2020 5468 6520 6578 6365 7074 696f 6e73    The exceptions
│ │ │ │ │ -00002b10: 2061 7265 2074 6865 2027 7370 615f 6d65   are the 'spa_me
│ │ │ │ │ -00002b20: 7373 6167 6527 2c0a 2773 7061 5f6e 6174  ssage',.'spa_nat
│ │ │ │ │ -00002b30: 5f61 6363 6573 7327 2c20 616e 6420 2773  _access', and 's
│ │ │ │ │ -00002b40: 7061 5f73 6572 7665 725f 6175 7468 272e  pa_server_auth'.
│ │ │ │ │ -00002b50: 2020 5468 6520 666f 726d 6174 7320 666f    The formats fo
│ │ │ │ │ -00002b60: 7220 7468 6573 6520 6172 6520 6e6f 740a  r these are not.
│ │ │ │ │ -00002b70: 6861 6e64 6c65 6420 6279 206c 6962 666b  handled by libfk
│ │ │ │ │ -00002b80: 6f20 6475 7269 6e67 2063 7265 6174 696f  o during creatio
│ │ │ │ │ -00002b90: 6e2e 2020 486f 7765 7665 722c 2074 6865  n.  However, the
│ │ │ │ │ -00002ba0: 7920 6172 6520 6368 6563 6b65 6420 666f  y are checked fo
│ │ │ │ │ -00002bb0: 7220 666f 726d 6174 0a76 616c 6964 6974  r format.validit
│ │ │ │ │ -00002bc0: 7920 6475 7269 6e67 2074 6865 2065 6e64  y during the end
│ │ │ │ │ -00002bd0: 636f 6469 6e67 2061 6e64 2064 6563 6f64  coding and decod
│ │ │ │ │ -00002be0: 696e 6720 2877 6865 6e20 7061 7273 696e  ing (when parsin
│ │ │ │ │ -00002bf0: 6720 696e 636f 6d69 6e67 2920 5350 410a  g incoming) SPA.
│ │ │ │ │ -00002c00: 6461 7461 2e20 204d 6f72 6520 696e 666f  data.  More info
│ │ │ │ │ -00002c10: 726d 6174 696f 6e20 6f6e 2074 6865 2073  rmation on the s
│ │ │ │ │ -00002c20: 7065 6369 6669 6373 206f 6620 7468 6520  pecifics of the 
│ │ │ │ │ -00002c30: 666f 726d 6174 7320 666f 7220 7468 6573  formats for thes
│ │ │ │ │ -00002c40: 6520 6669 656c 6473 0a63 616e 2062 6520  e fields.can be 
│ │ │ │ │ -00002c50: 666f 756e 6420 696e 202a 6e6f 7465 2053  found in *note S
│ │ │ │ │ -00002c60: 5041 204d 6573 7361 6765 733a 3a2e 0a0a  PA Messages::...
│ │ │ │ │ -00002c70: 1f0a 4669 6c65 3a20 6c69 6266 6b6f 2e69  ..File: libfko.i
│ │ │ │ │ -00002c80: 6e66 6f2c 2020 4e6f 6465 3a20 5072 6570  nfo,  Node: Prep
│ │ │ │ │ -00002c90: 6172 6174 696f 6e2c 2020 4e65 7874 3a20  aration,  Next: 
│ │ │ │ │ -00002ca0: 5573 696e 6720 6c69 6266 6b6f 2c20 2050  Using libfko,  P
│ │ │ │ │ -00002cb0: 7265 763a 2049 6e74 726f 6475 6374 696f  rev: Introductio
│ │ │ │ │ -00002cc0: 6e2c 2020 5570 3a20 546f 700a 0a32 2050  n,  Up: Top..2 P
│ │ │ │ │ -00002cd0: 7265 7061 7261 7469 6f6e 0a2a 2a2a 2a2a  reparation.*****
│ │ │ │ │ -00002ce0: 2a2a 2a2a 2a2a 2a2a 0a0a 5468 6973 2063  ********..This c
│ │ │ │ │ -00002cf0: 6861 7074 6572 2070 726f 7669 6465 7320  hapter provides 
│ │ │ │ │ -00002d00: 696e 666f 726d 6174 696f 6e20 6e65 6564  information need
│ │ │ │ │ -00002d10: 6564 2074 6f20 7072 6570 6172 6520 666f  ed to prepare fo
│ │ │ │ │ -00002d20: 7220 7573 696e 6720 6c69 6266 6b6f 2069  r using libfko i
│ │ │ │ │ -00002d30: 6e0a 796f 7572 2070 726f 6772 616d 732e  n.your programs.
│ │ │ │ │ -00002d40: 0a0a 2a20 4d65 6e75 3a0a 0a2a 206c 6962  ..* Menu:..* lib
│ │ │ │ │ -00002d50: 666b 6f20 4865 6164 6572 3a3a 2020 2020  fko Header::    
│ │ │ │ │ -00002d60: 2020 2020 2020 2020 2020 2020 2057 6861               Wha
│ │ │ │ │ -00002d70: 7420 6865 6164 6572 2066 696c 6520 796f  t header file yo
│ │ │ │ │ -00002d80: 7520 6e65 6564 2074 6f20 696e 636c 7564  u need to includ
│ │ │ │ │ -00002d90: 650a 2a20 436f 6d70 696c 696e 6720 7769  e.* Compiling wi
│ │ │ │ │ -00002da0: 7468 206c 6962 666b 6f3a 3a20 2020 2020  th libfko::     
│ │ │ │ │ -00002db0: 2020 2020 5768 6174 2079 6f75 206e 6565      What you nee
│ │ │ │ │ -00002dc0: 6420 746f 2063 6f6d 7069 6c65 2061 6e64  d to compile and
│ │ │ │ │ -00002dd0: 206c 696e 6b20 796f 7572 0a20 2020 2020   link your.     
│ │ │ │ │ +00001ec0: 2020 2020 2020 2020 2020 2020 2066 6f72               for
│ │ │ │ │ +00001ed0: 6d61 742e 0a0a 6c69 6266 6b6f 2066 756e  mat...libfko fun
│ │ │ │ │ +00001ee0: 6374 696f 6e61 6c69 7479 2063 616e 2062  ctionality can b
│ │ │ │ │ +00001ef0: 6520 6469 7669 6465 6420 696e 746f 2074  e divided into t
│ │ │ │ │ +00001f00: 776f 2072 6f6c 6573 2e20 204f 6e65 2069  wo roles.  One i
│ │ │ │ │ +00001f10: 7320 7468 6520 6372 6561 7469 6f6e 0a6f  s the creation.o
│ │ │ │ │ +00001f20: 6620 616e 2065 6e63 7279 7074 6564 2053  f an encrypted S
│ │ │ │ │ +00001f30: 5041 206d 6573 7361 6765 2074 6f67 6574  PA message toget
│ │ │ │ │ +00001f40: 6865 7220 7769 7468 2061 6e20 484d 4143  her with an HMAC
│ │ │ │ │ +00001f50: 2066 6f72 2061 7574 6865 6e74 6963 6174   for authenticat
│ │ │ │ │ +00001f60: 696f 6e2e 0a54 6865 206f 7468 6572 2069  ion..The other i
│ │ │ │ │ +00001f70: 7320 7468 6520 7461 6b69 6e67 2061 6e20  s the taking an 
│ │ │ │ │ +00001f80: 656e 6372 7970 7465 6420 5350 4120 6d65  encrypted SPA me
│ │ │ │ │ +00001f90: 7373 6167 6520 746f 2061 7574 6865 6e74  ssage to authent
│ │ │ │ │ +00001fa0: 6963 6174 652c 0a64 6563 6f64 652c 2070  icate,.decode, p
│ │ │ │ │ +00001fb0: 6172 7365 2c20 616e 6420 6578 7472 6163  arse, and extrac
│ │ │ │ │ +00001fc0: 7420 7468 6520 6f72 6967 696e 616c 2064  t the original d
│ │ │ │ │ +00001fd0: 6174 612e 0a0a 2020 2054 6865 2061 6374  ata...   The act
│ │ │ │ │ +00001fe0: 7561 6c20 5350 4120 6461 7461 2068 616e  ual SPA data han
│ │ │ │ │ +00001ff0: 646c 696e 6720 616e 6420 6f70 6572 6174  dling and operat
│ │ │ │ │ +00002000: 696f 6e73 2061 7265 2073 6574 2077 6974  ions are set wit
│ │ │ │ │ +00002010: 6869 6e20 6120 636f 6e74 6578 742e 0a54  hin a context..T
│ │ │ │ │ +00002020: 6865 2063 6f6e 7465 7874 2072 6570 7265  he context repre
│ │ │ │ │ +00002030: 7365 6e74 7320 6120 7369 6e67 6c65 2053  sents a single S
│ │ │ │ │ +00002040: 5041 206d 6573 7361 6765 2061 6e64 2070  PA message and p
│ │ │ │ │ +00002050: 726f 7669 6465 7320 636f 6e66 6967 7572  rovides configur
│ │ │ │ │ +00002060: 6174 696f 6e0a 7061 7261 6d65 7465 7273  ation.parameters
│ │ │ │ │ +00002070: 2061 6e64 2064 6174 6120 7365 7474 696e   and data settin
│ │ │ │ │ +00002080: 6773 2066 6f72 2064 6566 696e 696e 6720  gs for defining 
│ │ │ │ │ +00002090: 7468 6174 206d 6573 7361 6765 2e20 2041  that message.  A
│ │ │ │ │ +000020a0: 6c6c 206f 7065 7261 7469 6f6e 730a 6f6e  ll operations.on
│ │ │ │ │ +000020b0: 2074 6865 2064 6174 6120 6f63 6375 7220   the data occur 
│ │ │ │ │ +000020c0: 7769 7468 696e 2074 6861 7420 636f 6e74  within that cont
│ │ │ │ │ +000020d0: 6578 742e 0a0a 2020 2053 6f6d 6520 6f70  ext...   Some op
│ │ │ │ │ +000020e0: 6572 6174 696f 6e73 206f 6e20 7468 6520  erations on the 
│ │ │ │ │ +000020f0: 636f 6e74 6578 7420 6d75 7374 206f 6363  context must occ
│ │ │ │ │ +00002100: 7572 2062 6566 6f72 6520 6f74 6865 7273  ur before others
│ │ │ │ │ +00002110: 2e20 2044 6574 6169 6c73 206f 660a 7468  .  Details of.th
│ │ │ │ │ +00002120: 6573 6520 6465 7065 6e64 656e 6369 6573  ese dependencies
│ │ │ │ │ +00002130: 2061 7265 2063 6f76 6572 6564 2069 6e20   are covered in 
│ │ │ │ │ +00002140: 2a6e 6f74 6520 4372 6561 7469 6e67 2061  *note Creating a
│ │ │ │ │ +00002150: 2053 5041 204d 6573 7361 6765 3a3a 2e0a   SPA Message::..
│ │ │ │ │ +00002160: 0a57 6974 6820 6c69 6266 6b6f 2c20 776f  .With libfko, wo
│ │ │ │ │ +00002170: 726b 696e 6720 7769 7468 2053 5041 206d  rking with SPA m
│ │ │ │ │ +00002180: 6573 7361 6765 2064 6174 6120 6261 7369  essage data basi
│ │ │ │ │ +00002190: 6361 6c6c 7920 636f 6e73 6973 7473 206f  cally consists o
│ │ │ │ │ +000021a0: 6620 7468 650a 666f 6c6c 6f77 696e 6720  f the.following 
│ │ │ │ │ +000021b0: 7374 6570 7320 696e 206f 7264 6572 3a0a  steps in order:.
│ │ │ │ │ +000021c0: 0a20 2020 2a20 4372 6561 7465 2061 206e  .   * Create a n
│ │ │ │ │ +000021d0: 6577 2063 6f6e 7465 7874 0a20 2020 2a20  ew context.   * 
│ │ │ │ │ +000021e0: 576f 726b 2077 6974 6820 2867 6574 2f73  Work with (get/s
│ │ │ │ │ +000021f0: 6574 2920 7468 6520 5350 4120 6461 7461  et) the SPA data
│ │ │ │ │ +00002200: 2066 6965 6c64 730a 2020 202a 2044 6573   fields.   * Des
│ │ │ │ │ +00002210: 7472 6f79 2074 6865 2063 6f6e 7465 7874  troy the context
│ │ │ │ │ +00002220: 0a0a 1f0a 4669 6c65 3a20 6c69 6266 6b6f  ....File: libfko
│ │ │ │ │ +00002230: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5350  .info,  Node: SP
│ │ │ │ │ +00002240: 4120 4461 7461 2046 6f72 6d61 742c 2020  A Data Format,  
│ │ │ │ │ +00002250: 5570 3a20 4f76 6572 7669 6577 0a0a 312e  Up: Overview..1.
│ │ │ │ │ +00002260: 332e 3120 5350 4120 4461 7461 2046 6f72  3.1 SPA Data For
│ │ │ │ │ +00002270: 6d61 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  mat.------------
│ │ │ │ │ +00002280: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 2066  ---------..The f
│ │ │ │ │ +00002290: 6f72 6d61 7420 6f66 2074 6865 2053 5041  ormat of the SPA
│ │ │ │ │ +000022a0: 206d 6573 7361 6765 2064 6174 6120 7573   message data us
│ │ │ │ │ +000022b0: 6564 2062 7920 6677 6b6e 6f70 2028 6265  ed by fwknop (be
│ │ │ │ │ +000022c0: 666f 7265 2065 6e63 7279 7074 696f 6e20  fore encryption 
│ │ │ │ │ +000022d0: 616e 640a 6265 666f 7265 2061 6e20 484d  and.before an HM
│ │ │ │ │ +000022e0: 4143 2069 7320 6170 706c 6965 6429 2069  AC is applied) i
│ │ │ │ │ +000022f0: 7320 6120 636f 6c6f 6e2d 6465 6c69 6d69  s a colon-delimi
│ │ │ │ │ +00002300: 7465 6420 7374 7269 6e67 2063 6f6e 7461  ted string conta
│ │ │ │ │ +00002310: 696e 696e 6720 7468 650a 696e 6469 7669  ining the.indivi
│ │ │ │ │ +00002320: 6475 616c 2053 5041 2064 6174 6120 6669  dual SPA data fi
│ │ │ │ │ +00002330: 656c 6473 2e20 2053 6f6d 6520 6f66 2074  elds.  Some of t
│ │ │ │ │ +00002340: 6865 7365 2066 6965 6c64 7320 6172 6520  hese fields are 
│ │ │ │ │ +00002350: 6261 7365 3634 2d65 6e63 6f64 6564 2069  base64-encoded i
│ │ │ │ │ +00002360: 6e0a 7468 6520 6669 6e61 6c20 656e 636f  n.the final enco
│ │ │ │ │ +00002370: 6469 6e67 2070 726f 6365 7373 2061 7320  ding process as 
│ │ │ │ │ +00002380: 6469 6374 6174 6564 2062 7920 7468 6520  dictated by the 
│ │ │ │ │ +00002390: 6375 7272 656e 7420 6677 6b6e 6f70 0a69  current fwknop.i
│ │ │ │ │ +000023a0: 6d70 6c65 6d65 6e74 6174 696f 6e2e 0a0a  mplementation...
│ │ │ │ │ +000023b0: 202d 2d20 5661 7269 6162 6c65 3a20 6461   -- Variable: da
│ │ │ │ │ +000023c0: 7461 2073 7061 5f6d 6573 7361 6765 5f66  ta spa_message_f
│ │ │ │ │ +000023d0: 6965 6c64 730a 2020 2020 2055 7369 6e67  ields.     Using
│ │ │ │ │ +000023e0: 2074 6865 206c 6962 666b 6f20 6e61 6d65   the libfko name
│ │ │ │ │ +000023f0: 7320 666f 7220 7468 6520 6461 7461 2066  s for the data f
│ │ │ │ │ +00002400: 6965 6c64 732c 2074 6865 206c 6973 7420  ields, the list 
│ │ │ │ │ +00002410: 6f66 2074 6865 7365 0a20 2020 2020 6669  of these.     fi
│ │ │ │ │ +00002420: 656c 6473 2028 696e 206f 7264 6572 2920  elds (in order) 
│ │ │ │ │ +00002430: 666f 6c6c 6f77 733a 0a20 2020 2020 272a  follows:.     '*
│ │ │ │ │ +00002440: 7261 6e64 5f76 616c 7565 2a20 2d20 5f44  rand_value* - _D
│ │ │ │ │ +00002450: 6566 6175 6c74 3a20 5261 6e64 6f6d 2028  efault: Random (
│ │ │ │ │ +00002460: 6372 6561 7465 6420 7570 6f6e 2063 6f6e  created upon con
│ │ │ │ │ +00002470: 7465 7874 2063 7265 6174 696f 6e29 5f27  text creation)_'
│ │ │ │ │ +00002480: 0a20 2020 2020 2020 2020 2041 2031 362d  .          A 16-
│ │ │ │ │ +00002490: 6279 7465 2072 616e 646f 6d20 6e75 6d65  byte random nume
│ │ │ │ │ +000024a0: 7269 6320 7374 7269 6e67 2e0a 2020 2020  ric string..    
│ │ │ │ │ +000024b0: 2027 2a75 7365 726e 616d 652a 202d 205f   '*username* - _
│ │ │ │ │ +000024c0: 4465 6661 756c 743a 2043 7572 7265 6e74  Default: Current
│ │ │ │ │ +000024d0: 206c 6f67 696e 2075 7365 7220 6f72 2056   login user or V
│ │ │ │ │ +000024e0: 616c 7565 206f 6620 5350 4f4f 465f 5553  alue of SPOOF_US
│ │ │ │ │ +000024f0: 4552 2065 6e76 2076 6172 5f27 0a20 2020  ER env var_'.   
│ │ │ │ │ +00002500: 2020 2020 2020 2054 6865 2062 6173 6536         The base6
│ │ │ │ │ +00002510: 342d 656e 636f 6465 6420 7573 6572 6e61  4-encoded userna
│ │ │ │ │ +00002520: 6d65 2061 7373 6f63 6961 7465 6420 7769  me associated wi
│ │ │ │ │ +00002530: 7468 2074 6869 7320 5350 4120 6461 7461  th this SPA data
│ │ │ │ │ +00002540: 2e0a 2020 2020 2027 2a74 696d 6573 7461  ..     '*timesta
│ │ │ │ │ +00002550: 6d70 2a20 2d20 5f44 6566 6175 6c74 3a20  mp* - _Default: 
│ │ │ │ │ +00002560: 5468 6520 556e 6978 2074 696d 6520 6174  The Unix time at
│ │ │ │ │ +00002570: 2063 7265 6174 696f 6e5f 270a 2020 2020   creation_'.    
│ │ │ │ │ +00002580: 2020 2020 2020 5468 6520 556e 6978 2074        The Unix t
│ │ │ │ │ +00002590: 696d 6573 7461 6d70 2076 616c 7565 2e0a  imestamp value..
│ │ │ │ │ +000025a0: 2020 2020 2027 2a76 6572 7369 6f6e 2a20       '*version* 
│ │ │ │ │ +000025b0: 2d20 5f44 6566 6175 6c74 3a20 7468 6520  - _Default: the 
│ │ │ │ │ +000025c0: 6375 7272 656e 7420 6677 6b6e 6f70 2076  current fwknop v
│ │ │ │ │ +000025d0: 6572 7369 6f6e 5f27 0a20 2020 2020 2020  ersion_'.       
│ │ │ │ │ +000025e0: 2020 2054 6865 2063 7572 7265 6e74 2066     The current f
│ │ │ │ │ +000025f0: 776b 6e6f 7020 7665 7273 696f 6e20 7468  wknop version th
│ │ │ │ │ +00002600: 6174 2073 7570 706f 7274 7320 7468 6973  at supports this
│ │ │ │ │ +00002610: 2066 6f72 6d61 742e 2020 5468 6973 0a20   format.  This. 
│ │ │ │ │ +00002620: 2020 2020 2020 2020 2066 6965 6c64 2069           field i
│ │ │ │ │ +00002630: 7320 6e6f 7420 7573 6572 2073 6574 7461  s not user setta
│ │ │ │ │ +00002640: 626c 652e 0a20 2020 2020 272a 7370 615f  ble..     '*spa_
│ │ │ │ │ +00002650: 6d65 7373 6167 655f 7479 7065 2a20 2d20  message_type* - 
│ │ │ │ │ +00002660: 5f44 6566 6175 6c74 3a20 5350 4120 6163  _Default: SPA ac
│ │ │ │ │ +00002670: 6365 7373 206d 6573 7361 6765 2028 464b  cess message (FK
│ │ │ │ │ +00002680: 4f5f 4143 4345 5353 5f4d 5347 295f 270a  O_ACCESS_MSG)_'.
│ │ │ │ │ +00002690: 2020 2020 2020 2020 2020 5468 6520 5350            The SP
│ │ │ │ │ +000026a0: 4120 6d65 7373 6167 6520 7479 7065 2076  A message type v
│ │ │ │ │ +000026b0: 616c 7565 2066 6f72 2074 6869 7320 6d65  alue for this me
│ │ │ │ │ +000026c0: 7373 6167 652e 0a20 2020 2020 272a 7370  ssage..     '*sp
│ │ │ │ │ +000026d0: 615f 6d65 7373 6167 652a 270a 2020 2020  a_message*'.    
│ │ │ │ │ +000026e0: 2020 2020 2020 5468 6520 6261 7365 3634        The base64
│ │ │ │ │ +000026f0: 2d65 6e63 6f64 6564 2053 5041 206d 6573  -encoded SPA mes
│ │ │ │ │ +00002700: 7361 6765 2069 7473 656c 6620 2861 6e20  sage itself (an 
│ │ │ │ │ +00002710: 6163 6365 7373 2072 6571 7565 7374 206f  access request o
│ │ │ │ │ +00002720: 720a 2020 2020 2020 2020 2020 636f 6d6d  r.          comm
│ │ │ │ │ +00002730: 616e 6420 7374 7269 6e67 292e 0a20 2020  and string)..   
│ │ │ │ │ +00002740: 2020 272a 7370 615f 6e61 745f 6163 6365    '*spa_nat_acce
│ │ │ │ │ +00002750: 7373 2a27 0a20 2020 2020 2020 2020 2041  ss*'.          A
│ │ │ │ │ +00002760: 6e20 6f70 7469 6f6e 616c 2062 6173 6536  n optional base6
│ │ │ │ │ +00002770: 342d 656e 636f 6465 6420 7265 7175 6573  4-encoded reques
│ │ │ │ │ +00002780: 7420 666f 7220 4e41 5420 6163 6365 7373  t for NAT access
│ │ │ │ │ +00002790: 2e0a 2020 2020 2027 2a73 7061 5f73 6572  ..     '*spa_ser
│ │ │ │ │ +000027a0: 7665 725f 6175 7468 2a27 0a20 2020 2020  ver_auth*'.     
│ │ │ │ │ +000027b0: 2020 2020 2041 6e20 6f70 7469 6f6e 616c       An optional
│ │ │ │ │ +000027c0: 2062 6173 6536 342d 656e 636f 6465 6420   base64-encoded 
│ │ │ │ │ +000027d0: 7374 7269 6e67 2074 6861 7420 6361 6e20  string that can 
│ │ │ │ │ +000027e0: 6265 2075 7365 6420 6173 2061 6e0a 2020  be used as an.  
│ │ │ │ │ +000027f0: 2020 2020 2020 2020 6164 6469 7469 6f6e          addition
│ │ │ │ │ +00002800: 616c 2061 7574 6865 6e74 6963 6174 696f  al authenticatio
│ │ │ │ │ +00002810: 6e20 6d65 6368 616e 6973 6d20 6174 2074  n mechanism at t
│ │ │ │ │ +00002820: 6865 2066 776b 6e6f 7020 7365 7276 6572  he fwknop server
│ │ │ │ │ +00002830: 2e0a 2020 2020 2027 2a73 7061 5f63 6c69  ..     '*spa_cli
│ │ │ │ │ +00002840: 656e 745f 7469 6d65 6f75 742a 270a 2020  ent_timeout*'.  
│ │ │ │ │ +00002850: 2020 2020 2020 2020 416e 206f 7074 696f          An optio
│ │ │ │ │ +00002860: 6e61 6c20 636c 6965 6e74 2074 696d 656f  nal client timeo
│ │ │ │ │ +00002870: 7574 2076 616c 7565 2074 6861 7420 6361  ut value that ca
│ │ │ │ │ +00002880: 6e20 6265 2073 7570 706c 6965 6420 746f  n be supplied to
│ │ │ │ │ +00002890: 2074 6865 0a20 2020 2020 2020 2020 2066   the.          f
│ │ │ │ │ +000028a0: 776b 6e6f 7020 7365 7276 6572 2e0a 2020  wknop server..  
│ │ │ │ │ +000028b0: 2020 2027 2a73 7061 5f64 6967 6573 742a     '*spa_digest*
│ │ │ │ │ +000028c0: 202d 205f 436f 6d70 7574 6564 2076 616c   - _Computed val
│ │ │ │ │ +000028d0: 7565 5f27 0a20 2020 2020 2020 2020 2054  ue_'.          T
│ │ │ │ │ +000028e0: 6865 2064 6967 6573 7420 6f66 2074 6865  he digest of the
│ │ │ │ │ +000028f0: 2070 7265 7669 6f75 7320 6669 656c 6473   previous fields
│ │ │ │ │ +00002900: 2028 696e 636c 7564 696e 6720 7468 6520   (including the 
│ │ │ │ │ +00002910: 6465 6c69 6d69 7465 7273 292e 0a0a 2020  delimiters)...  
│ │ │ │ │ +00002920: 2057 6974 6820 616c 6c20 6669 656c 6473   With all fields
│ │ │ │ │ +00002930: 2064 6566 696e 6564 2c20 6120 636f 6d70   defined, a comp
│ │ │ │ │ +00002940: 6c65 7465 2028 756e 656e 636f 6465 6429  lete (unencoded)
│ │ │ │ │ +00002950: 2053 5041 206d 6573 7361 6765 2077 6f75   SPA message wou
│ │ │ │ │ +00002960: 6c64 0a6c 6f6f 6b20 736f 6d65 7468 696e  ld.look somethin
│ │ │ │ │ +00002970: 6720 6c69 6b65 2074 6865 2066 6f6c 6c6f  g like the follo
│ │ │ │ │ +00002980: 7769 6e67 2065 7861 6d70 6c65 2028 4e6f  wing example (No
│ │ │ │ │ +00002990: 7465 3a20 5468 6520 6c69 6e65 2069 7320  te: The line is 
│ │ │ │ │ +000029a0: 6272 6f6b 656e 2066 6f72 0a72 6561 6461  broken for.reada
│ │ │ │ │ +000029b0: 6269 6c69 7479 2061 6e64 2074 6865 2075  bility and the u
│ │ │ │ │ +000029c0: 7365 726e 616d 652c 206d 6573 7361 6765  sername, message
│ │ │ │ │ +000029d0: 2c20 6e61 745f 6163 6365 7373 2c20 616e  , nat_access, an
│ │ │ │ │ +000029e0: 6420 7365 7276 6572 5f61 7574 680a 6669  d server_auth.fi
│ │ │ │ │ +000029f0: 656c 6473 2061 7265 206e 6f74 2062 6173  elds are not bas
│ │ │ │ │ +00002a00: 6536 342d 656e 636f 6465 6429 3a0a 0a0a  e64-encoded):...
│ │ │ │ │ +00002a10: 2020 2020 2038 3330 3735 3430 3938 3231       83075409821
│ │ │ │ │ +00002a20: 3736 3533 393a 6a75 7365 723a 3132 3330  76539:juser:1230
│ │ │ │ │ +00002a30: 3636 3531 3732 3a32 2e35 3a31 3a31 2e31  665172:2.5:1:1.1
│ │ │ │ │ +00002a40: 2e31 2e31 2c74 6370 2f32 323a 3139 322e  .1.1,tcp/22:192.
│ │ │ │ │ +00002a50: 3136 382e 312e 322c 3232 3a0a 2020 2020  168.1.2,22:.    
│ │ │ │ │ +00002a60: 2063 7279 7074 2c6d 7970 773a 3132 303a   crypt,mypw:120:
│ │ │ │ │ +00002a70: 7873 776a 3856 307a 4d52 372f 374d 5639  xswj8V0zMR7/7MV9
│ │ │ │ │ +00002a80: 7051 5261 7253 4b57 4731 6c39 5a66 6a76  pQRarSKWG1l9Zfjv
│ │ │ │ │ +00002a90: 2b6b 6258 614b 724a 2b52 410a 0a20 2020  +kbXaKrJ+RA..   
│ │ │ │ │ +00002aa0: 466f 7220 6d6f 7374 206f 6620 7468 6520  For most of the 
│ │ │ │ │ +00002ab0: 6669 656c 6473 2c20 796f 7520 6e65 6564  fields, you need
│ │ │ │ │ +00002ac0: 206e 6f74 2062 6520 746f 6f20 636f 6e63   not be too conc
│ │ │ │ │ +00002ad0: 6572 6e65 6420 6162 6f75 7420 7468 650a  erned about the.
│ │ │ │ │ +00002ae0: 666f 726d 6174 2061 7320 6c69 6266 6b6f  format as libfko
│ │ │ │ │ +00002af0: 2068 616e 646c 6573 2074 6861 742e 2020   handles that.  
│ │ │ │ │ +00002b00: 5468 6520 6578 6365 7074 696f 6e73 2061  The exceptions a
│ │ │ │ │ +00002b10: 7265 2074 6865 2027 7370 615f 6d65 7373  re the 'spa_mess
│ │ │ │ │ +00002b20: 6167 6527 2c0a 2773 7061 5f6e 6174 5f61  age',.'spa_nat_a
│ │ │ │ │ +00002b30: 6363 6573 7327 2c20 616e 6420 2773 7061  ccess', and 'spa
│ │ │ │ │ +00002b40: 5f73 6572 7665 725f 6175 7468 272e 2020  _server_auth'.  
│ │ │ │ │ +00002b50: 5468 6520 666f 726d 6174 7320 666f 7220  The formats for 
│ │ │ │ │ +00002b60: 7468 6573 6520 6172 6520 6e6f 740a 6861  these are not.ha
│ │ │ │ │ +00002b70: 6e64 6c65 6420 6279 206c 6962 666b 6f20  ndled by libfko 
│ │ │ │ │ +00002b80: 6475 7269 6e67 2063 7265 6174 696f 6e2e  during creation.
│ │ │ │ │ +00002b90: 2020 486f 7765 7665 722c 2074 6865 7920    However, they 
│ │ │ │ │ +00002ba0: 6172 6520 6368 6563 6b65 6420 666f 7220  are checked for 
│ │ │ │ │ +00002bb0: 666f 726d 6174 0a76 616c 6964 6974 7920  format.validity 
│ │ │ │ │ +00002bc0: 6475 7269 6e67 2074 6865 2065 6e64 636f  during the endco
│ │ │ │ │ +00002bd0: 6469 6e67 2061 6e64 2064 6563 6f64 696e  ding and decodin
│ │ │ │ │ +00002be0: 6720 2877 6865 6e20 7061 7273 696e 6720  g (when parsing 
│ │ │ │ │ +00002bf0: 696e 636f 6d69 6e67 2920 5350 410a 6461  incoming) SPA.da
│ │ │ │ │ +00002c00: 7461 2e20 204d 6f72 6520 696e 666f 726d  ta.  More inform
│ │ │ │ │ +00002c10: 6174 696f 6e20 6f6e 2074 6865 2073 7065  ation on the spe
│ │ │ │ │ +00002c20: 6369 6669 6373 206f 6620 7468 6520 666f  cifics of the fo
│ │ │ │ │ +00002c30: 726d 6174 7320 666f 7220 7468 6573 6520  rmats for these 
│ │ │ │ │ +00002c40: 6669 656c 6473 0a63 616e 2062 6520 666f  fields.can be fo
│ │ │ │ │ +00002c50: 756e 6420 696e 202a 6e6f 7465 2053 5041  und in *note SPA
│ │ │ │ │ +00002c60: 204d 6573 7361 6765 733a 3a2e 0a0a 1f0a   Messages::.....
│ │ │ │ │ +00002c70: 4669 6c65 3a20 6c69 6266 6b6f 2e69 6e66  File: libfko.inf
│ │ │ │ │ +00002c80: 6f2c 2020 4e6f 6465 3a20 5072 6570 6172  o,  Node: Prepar
│ │ │ │ │ +00002c90: 6174 696f 6e2c 2020 4e65 7874 3a20 5573  ation,  Next: Us
│ │ │ │ │ +00002ca0: 696e 6720 6c69 6266 6b6f 2c20 2050 7265  ing libfko,  Pre
│ │ │ │ │ +00002cb0: 763a 2049 6e74 726f 6475 6374 696f 6e2c  v: Introduction,
│ │ │ │ │ +00002cc0: 2020 5570 3a20 546f 700a 0a32 2050 7265    Up: Top..2 Pre
│ │ │ │ │ +00002cd0: 7061 7261 7469 6f6e 0a2a 2a2a 2a2a 2a2a  paration.*******
│ │ │ │ │ +00002ce0: 2a2a 2a2a 2a2a 0a0a 5468 6973 2063 6861  ******..This cha
│ │ │ │ │ +00002cf0: 7074 6572 2070 726f 7669 6465 7320 696e  pter provides in
│ │ │ │ │ +00002d00: 666f 726d 6174 696f 6e20 6e65 6564 6564  formation needed
│ │ │ │ │ +00002d10: 2074 6f20 7072 6570 6172 6520 666f 7220   to prepare for 
│ │ │ │ │ +00002d20: 7573 696e 6720 6c69 6266 6b6f 2069 6e0a  using libfko in.
│ │ │ │ │ +00002d30: 796f 7572 2070 726f 6772 616d 732e 0a0a  your programs...
│ │ │ │ │ +00002d40: 2a20 4d65 6e75 3a0a 0a2a 206c 6962 666b  * Menu:..* libfk
│ │ │ │ │ +00002d50: 6f20 4865 6164 6572 3a3a 2020 2020 2020  o Header::      
│ │ │ │ │ +00002d60: 2020 2020 2020 2020 2020 2057 6861 7420             What 
│ │ │ │ │ +00002d70: 6865 6164 6572 2066 696c 6520 796f 7520  header file you 
│ │ │ │ │ +00002d80: 6e65 6564 2074 6f20 696e 636c 7564 650a  need to include.
│ │ │ │ │ +00002d90: 2a20 436f 6d70 696c 696e 6720 7769 7468  * Compiling with
│ │ │ │ │ +00002da0: 206c 6962 666b 6f3a 3a20 2020 2020 2020   libfko::       
│ │ │ │ │ +00002db0: 2020 5768 6174 2079 6f75 206e 6565 6420    What you need 
│ │ │ │ │ +00002dc0: 746f 2063 6f6d 7069 6c65 2061 6e64 206c  to compile and l
│ │ │ │ │ +00002dd0: 696e 6b20 796f 7572 0a20 2020 2020 2020  ink your.       
│ │ │ │ │  00002de0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00002df0: 2020 2020 2020 2020 2020 2020 2070 726f               pro
│ │ │ │ │ -00002e00: 6772 616d 2077 6974 6820 6c69 6266 6b6f  gram with libfko
│ │ │ │ │ -00002e10: 0a2a 2053 5041 2050 6172 616d 6574 6572  .* SPA Parameter
│ │ │ │ │ -00002e20: 2054 7970 6573 3a3a 2020 2020 2020 2020   Types::        
│ │ │ │ │ -00002e30: 2020 2054 6865 2061 7661 696c 6162 6c65     The available
│ │ │ │ │ -00002e40: 2064 6967 6573 7473 2c20 6d65 7373 6167   digests, messag
│ │ │ │ │ -00002e50: 6520 7479 7065 7320 616e 640a 2020 2020  e types and.    
│ │ │ │ │ +00002df0: 2020 2020 2020 2020 2020 2070 726f 6772             progr
│ │ │ │ │ +00002e00: 616d 2077 6974 6820 6c69 6266 6b6f 0a2a  am with libfko.*
│ │ │ │ │ +00002e10: 2053 5041 2050 6172 616d 6574 6572 2054   SPA Parameter T
│ │ │ │ │ +00002e20: 7970 6573 3a3a 2020 2020 2020 2020 2020  ypes::          
│ │ │ │ │ +00002e30: 2054 6865 2061 7661 696c 6162 6c65 2064   The available d
│ │ │ │ │ +00002e40: 6967 6573 7473 2c20 6d65 7373 6167 6520  igests, message 
│ │ │ │ │ +00002e50: 7479 7065 7320 616e 640a 2020 2020 2020  types and.      
│ │ │ │ │  00002e60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00002e70: 2020 2020 2020 2020 2020 2020 2020 6d6f                mo
│ │ │ │ │ -00002e80: 6465 7320 6f66 2065 6e63 7279 7074 696f  des of encryptio
│ │ │ │ │ -00002e90: 6e20 666f 7220 5350 4120 6461 7461 0a0a  n for SPA data..
│ │ │ │ │ -00002ea0: 1f0a 4669 6c65 3a20 6c69 6266 6b6f 2e69  ..File: libfko.i
│ │ │ │ │ -00002eb0: 6e66 6f2c 2020 4e6f 6465 3a20 6c69 6266  nfo,  Node: libf
│ │ │ │ │ -00002ec0: 6b6f 2048 6561 6465 722c 2020 4e65 7874  ko Header,  Next
│ │ │ │ │ -00002ed0: 3a20 436f 6d70 696c 696e 6720 7769 7468  : Compiling with
│ │ │ │ │ -00002ee0: 206c 6962 666b 6f2c 2020 5570 3a20 5072   libfko,  Up: Pr
│ │ │ │ │ -00002ef0: 6570 6172 6174 696f 6e0a 0a32 2e31 206c  eparation..2.1 l
│ │ │ │ │ -00002f00: 6962 666b 6f20 4865 6164 6572 0a3d 3d3d  ibfko Header.===
│ │ │ │ │ -00002f10: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a  ==============..
│ │ │ │ │ -00002f20: 416c 6c20 696e 7465 7266 6163 6573 2028  All interfaces (
│ │ │ │ │ -00002f30: 6461 7461 2074 7970 6573 2061 6e64 2066  data types and f
│ │ │ │ │ -00002f40: 756e 6374 696f 6e73 2920 6f66 2074 6865  unctions) of the
│ │ │ │ │ -00002f50: 206c 6962 7261 7279 2061 7265 2064 6566   library are def
│ │ │ │ │ -00002f60: 696e 6564 2069 6e0a 7468 6520 6865 6164  ined in.the head
│ │ │ │ │ -00002f70: 6572 2066 696c 6520 2766 6b6f 2e68 272e  er file 'fko.h'.
│ │ │ │ │ -00002f80: 2020 596f 7520 6d75 7374 2069 6e63 6c75    You must inclu
│ │ │ │ │ -00002f90: 6465 2074 6869 7320 696e 2061 6c6c 2070  de this in all p
│ │ │ │ │ -00002fa0: 726f 6772 616d 7320 7573 696e 670a 7468  rograms using.th
│ │ │ │ │ -00002fb0: 6520 6c69 6272 6172 792c 2065 6974 6865  e library, eithe
│ │ │ │ │ -00002fc0: 7220 6469 7265 6374 6c79 206f 7220 7468  r directly or th
│ │ │ │ │ -00002fd0: 726f 7567 6820 736f 6d65 206f 7468 6572  rough some other
│ │ │ │ │ -00002fe0: 2068 6561 6465 7220 6669 6c65 2c20 6c69   header file, li
│ │ │ │ │ -00002ff0: 6b65 0a74 6869 733a 0a0a 2020 2020 2023  ke.this:..     #
│ │ │ │ │ -00003000: 696e 636c 7564 6520 3c66 6b6f 2e68 3e0a  include <fko.h>.
│ │ │ │ │ -00003010: 0a20 2020 5468 6520 6e61 6d65 2073 7061  .   The name spa
│ │ │ │ │ -00003020: 6365 206f 6620 464b 4f20 6973 2027 666b  ce of FKO is 'fk
│ │ │ │ │ -00003030: 6f5f 2a27 2066 6f72 2066 756e 6374 696f  o_*' for functio
│ │ │ │ │ -00003040: 6e20 6e61 6d65 7320 616e 6420 6461 7461  n names and data
│ │ │ │ │ -00003050: 2074 7970 6573 0a61 6e64 2027 464b 4f5f   types.and 'FKO_
│ │ │ │ │ -00003060: 2a27 2066 6f72 206f 7468 6572 2073 796d  *' for other sym
│ │ │ │ │ -00003070: 626f 6c73 2e20 204f 7468 6572 2073 796d  bols.  Other sym
│ │ │ │ │ -00003080: 626f 6c73 2069 6e74 6572 6e61 6c20 746f  bols internal to
│ │ │ │ │ -00003090: 2046 4b4f 206d 6179 2074 616b 650a 7468   FKO may take.th
│ │ │ │ │ -000030a0: 6520 666f 726d 2027 5f66 6b6f 5f2a 2720  e form '_fko_*' 
│ │ │ │ │ -000030b0: 616e 6420 275f 464b 4f5f 2a27 2e0a 0a1f  and '_FKO_*'....
│ │ │ │ │ -000030c0: 0a46 696c 653a 206c 6962 666b 6f2e 696e  .File: libfko.in
│ │ │ │ │ -000030d0: 666f 2c20 204e 6f64 653a 2043 6f6d 7069  fo,  Node: Compi
│ │ │ │ │ -000030e0: 6c69 6e67 2077 6974 6820 6c69 6266 6b6f  ling with libfko
│ │ │ │ │ -000030f0: 2c20 204e 6578 743a 2053 5041 2050 6172  ,  Next: SPA Par
│ │ │ │ │ -00003100: 616d 6574 6572 2054 7970 6573 2c20 2050  ameter Types,  P
│ │ │ │ │ -00003110: 7265 763a 206c 6962 666b 6f20 4865 6164  rev: libfko Head
│ │ │ │ │ -00003120: 6572 2c20 2055 703a 2050 7265 7061 7261  er,  Up: Prepara
│ │ │ │ │ -00003130: 7469 6f6e 0a0a 322e 3220 436f 6d70 696c  tion..2.2 Compil
│ │ │ │ │ -00003140: 696e 6720 7769 7468 206c 6962 666b 6f0a  ing with libfko.
│ │ │ │ │ +00002e70: 2020 2020 2020 2020 2020 2020 6d6f 6465              mode
│ │ │ │ │ +00002e80: 7320 6f66 2065 6e63 7279 7074 696f 6e20  s of encryption 
│ │ │ │ │ +00002e90: 666f 7220 5350 4120 6461 7461 0a0a 1f0a  for SPA data....
│ │ │ │ │ +00002ea0: 4669 6c65 3a20 6c69 6266 6b6f 2e69 6e66  File: libfko.inf
│ │ │ │ │ +00002eb0: 6f2c 2020 4e6f 6465 3a20 6c69 6266 6b6f  o,  Node: libfko
│ │ │ │ │ +00002ec0: 2048 6561 6465 722c 2020 4e65 7874 3a20   Header,  Next: 
│ │ │ │ │ +00002ed0: 436f 6d70 696c 696e 6720 7769 7468 206c  Compiling with l
│ │ │ │ │ +00002ee0: 6962 666b 6f2c 2020 5570 3a20 5072 6570  ibfko,  Up: Prep
│ │ │ │ │ +00002ef0: 6172 6174 696f 6e0a 0a32 2e31 206c 6962  aration..2.1 lib
│ │ │ │ │ +00002f00: 666b 6f20 4865 6164 6572 0a3d 3d3d 3d3d  fko Header.=====
│ │ │ │ │ +00002f10: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 416c  ============..Al
│ │ │ │ │ +00002f20: 6c20 696e 7465 7266 6163 6573 2028 6461  l interfaces (da
│ │ │ │ │ +00002f30: 7461 2074 7970 6573 2061 6e64 2066 756e  ta types and fun
│ │ │ │ │ +00002f40: 6374 696f 6e73 2920 6f66 2074 6865 206c  ctions) of the l
│ │ │ │ │ +00002f50: 6962 7261 7279 2061 7265 2064 6566 696e  ibrary are defin
│ │ │ │ │ +00002f60: 6564 2069 6e0a 7468 6520 6865 6164 6572  ed in.the header
│ │ │ │ │ +00002f70: 2066 696c 6520 2766 6b6f 2e68 272e 2020   file 'fko.h'.  
│ │ │ │ │ +00002f80: 596f 7520 6d75 7374 2069 6e63 6c75 6465  You must include
│ │ │ │ │ +00002f90: 2074 6869 7320 696e 2061 6c6c 2070 726f   this in all pro
│ │ │ │ │ +00002fa0: 6772 616d 7320 7573 696e 670a 7468 6520  grams using.the 
│ │ │ │ │ +00002fb0: 6c69 6272 6172 792c 2065 6974 6865 7220  library, either 
│ │ │ │ │ +00002fc0: 6469 7265 6374 6c79 206f 7220 7468 726f  directly or thro
│ │ │ │ │ +00002fd0: 7567 6820 736f 6d65 206f 7468 6572 2068  ugh some other h
│ │ │ │ │ +00002fe0: 6561 6465 7220 6669 6c65 2c20 6c69 6b65  eader file, like
│ │ │ │ │ +00002ff0: 0a74 6869 733a 0a0a 2020 2020 2023 696e  .this:..     #in
│ │ │ │ │ +00003000: 636c 7564 6520 3c66 6b6f 2e68 3e0a 0a20  clude <fko.h>.. 
│ │ │ │ │ +00003010: 2020 5468 6520 6e61 6d65 2073 7061 6365    The name space
│ │ │ │ │ +00003020: 206f 6620 464b 4f20 6973 2027 666b 6f5f   of FKO is 'fko_
│ │ │ │ │ +00003030: 2a27 2066 6f72 2066 756e 6374 696f 6e20  *' for function 
│ │ │ │ │ +00003040: 6e61 6d65 7320 616e 6420 6461 7461 2074  names and data t
│ │ │ │ │ +00003050: 7970 6573 0a61 6e64 2027 464b 4f5f 2a27  ypes.and 'FKO_*'
│ │ │ │ │ +00003060: 2066 6f72 206f 7468 6572 2073 796d 626f   for other symbo
│ │ │ │ │ +00003070: 6c73 2e20 204f 7468 6572 2073 796d 626f  ls.  Other symbo
│ │ │ │ │ +00003080: 6c73 2069 6e74 6572 6e61 6c20 746f 2046  ls internal to F
│ │ │ │ │ +00003090: 4b4f 206d 6179 2074 616b 650a 7468 6520  KO may take.the 
│ │ │ │ │ +000030a0: 666f 726d 2027 5f66 6b6f 5f2a 2720 616e  form '_fko_*' an
│ │ │ │ │ +000030b0: 6420 275f 464b 4f5f 2a27 2e0a 0a1f 0a46  d '_FKO_*'.....F
│ │ │ │ │ +000030c0: 696c 653a 206c 6962 666b 6f2e 696e 666f  ile: libfko.info
│ │ │ │ │ +000030d0: 2c20 204e 6f64 653a 2043 6f6d 7069 6c69  ,  Node: Compili
│ │ │ │ │ +000030e0: 6e67 2077 6974 6820 6c69 6266 6b6f 2c20  ng with libfko, 
│ │ │ │ │ +000030f0: 204e 6578 743a 2053 5041 2050 6172 616d   Next: SPA Param
│ │ │ │ │ +00003100: 6574 6572 2054 7970 6573 2c20 2050 7265  eter Types,  Pre
│ │ │ │ │ +00003110: 763a 206c 6962 666b 6f20 4865 6164 6572  v: libfko Header
│ │ │ │ │ +00003120: 2c20 2055 703a 2050 7265 7061 7261 7469  ,  Up: Preparati
│ │ │ │ │ +00003130: 6f6e 0a0a 322e 3220 436f 6d70 696c 696e  on..2.2 Compilin
│ │ │ │ │ +00003140: 6720 7769 7468 206c 6962 666b 6f0a 3d3d  g with libfko.==
│ │ │ │ │  00003150: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ │ -00003160: 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 6620 796f  =========..If yo
│ │ │ │ │ -00003170: 7520 7761 6e74 2074 6f20 636f 6d70 696c  u want to compil
│ │ │ │ │ -00003180: 6520 6120 736f 7572 6365 2066 696c 6520  e a source file 
│ │ │ │ │ -00003190: 696e 636c 7564 696e 6720 7468 6520 2766  including the 'f
│ │ │ │ │ -000031a0: 6b6f 2e68 2720 6865 6164 6572 2066 696c  ko.h' header fil
│ │ │ │ │ -000031b0: 652c 0a79 6f75 206d 7573 7420 6d61 6b65  e,.you must make
│ │ │ │ │ -000031c0: 2073 7572 6520 7468 6174 2074 6865 2063   sure that the c
│ │ │ │ │ -000031d0: 6f6d 7069 6c65 7220 6361 6e20 6669 6e64  ompiler can find
│ │ │ │ │ -000031e0: 2069 7420 696e 2074 6865 2064 6972 6563   it in the direc
│ │ │ │ │ -000031f0: 746f 7279 0a68 6965 7261 7263 6879 2e20  tory.hierarchy. 
│ │ │ │ │ -00003200: 2054 6869 7320 6973 2061 6363 6f6d 706c   This is accompl
│ │ │ │ │ -00003210: 6973 6865 6420 6279 2061 6464 696e 6720  ished by adding 
│ │ │ │ │ -00003220: 7468 6520 7061 7468 2074 6f20 7468 6520  the path to the 
│ │ │ │ │ -00003230: 6469 7265 6374 6f72 7920 696e 0a77 6869  directory in.whi
│ │ │ │ │ -00003240: 6368 2074 6865 2068 6561 6465 7220 6669  ch the header fi
│ │ │ │ │ -00003250: 6c65 2069 7320 6c6f 6361 7465 6420 746f  le is located to
│ │ │ │ │ -00003260: 2074 6865 2063 6f6d 7069 6c65 7273 2069   the compilers i
│ │ │ │ │ -00003270: 6e63 6c75 6465 2066 696c 6520 7365 6172  nclude file sear
│ │ │ │ │ -00003280: 6368 0a70 6174 6820 2876 6961 2074 6865  ch.path (via the
│ │ │ │ │ -00003290: 2027 2d49 2720 6f70 7469 6f6e 292e 0a0a   '-I' option)...
│ │ │ │ │ -000032a0: 2020 2046 6f72 2065 7861 6d70 6c65 2c20     For example, 
│ │ │ │ │ -000032b0: 6966 2079 6f75 2069 6e73 7461 6c6c 6564  if you installed
│ │ │ │ │ -000032c0: 206c 6962 666b 6f20 696e 2027 2f6f 7074   libfko in '/opt
│ │ │ │ │ -000032d0: 2f66 6b6f 272c 2079 6f75 206d 6179 2077  /fko', you may w
│ │ │ │ │ -000032e0: 616e 7420 746f 0a61 6464 2027 2d49 2f6f  ant to.add '-I/o
│ │ │ │ │ -000032f0: 7074 2f66 6b6f 2f69 6e63 6c75 6465 2720  pt/fko/include' 
│ │ │ │ │ -00003300: 746f 2027 4346 4c41 4753 272c 206f 7220  to 'CFLAGS', or 
│ │ │ │ │ -00003310: 6469 7265 6374 6c79 206f 6e20 7468 6520  directly on the 
│ │ │ │ │ -00003320: 636f 6d6d 616e 642d 6c69 6e65 3a0a 0a20  command-line:.. 
│ │ │ │ │ -00003330: 2020 2020 6763 6320 2d63 2066 6f6f 2e63      gcc -c foo.c
│ │ │ │ │ -00003340: 202d 492f 6f70 742f 666b 6f2f 696e 636c   -I/opt/fko/incl
│ │ │ │ │ -00003350: 7564 6520 2e2e 2e0a 0a20 2020 5468 6520  ude .....   The 
│ │ │ │ │ -00003360: 7361 6d65 2069 7320 7472 7565 2077 6865  same is true whe
│ │ │ │ │ -00003370: 6e20 6c69 6e6b 696e 6720 6120 7072 6f67  n linking a prog
│ │ │ │ │ -00003380: 7261 6d20 7769 7468 2074 6865 206c 6962  ram with the lib
│ │ │ │ │ -00003390: 7261 7279 2e20 2049 6e20 7468 6973 0a63  rary.  In this.c
│ │ │ │ │ -000033a0: 6173 652c 2074 6865 206c 696e 6b65 7220  ase, the linker 
│ │ │ │ │ -000033b0: 6861 7320 746f 2066 696e 6420 7468 6520  has to find the 
│ │ │ │ │ -000033c0: 6c69 6272 6172 7920 6669 6c65 732e 2020  library files.  
│ │ │ │ │ -000033d0: 466f 7220 7468 6973 2074 6f20 776f 726b  For this to work
│ │ │ │ │ -000033e0: 2c20 7468 650a 7061 7468 2074 6f20 7468  , the.path to th
│ │ │ │ │ -000033f0: 6520 6c69 6272 6172 7920 6669 6c65 7320  e library files 
│ │ │ │ │ -00003400: 6861 7320 746f 2062 6520 6164 6465 6420  has to be added 
│ │ │ │ │ -00003410: 746f 2074 6865 206c 6962 7261 7279 2073  to the library s
│ │ │ │ │ -00003420: 6561 7263 6820 7061 7468 0a28 7669 6120  earch path.(via 
│ │ │ │ │ -00003430: 7468 6520 272d 4c27 206f 7074 696f 6e29  the '-L' option)
│ │ │ │ │ -00003440: 2e0a 0a20 2020 436f 6e74 696e 7569 6e67  ...   Continuing
│ │ │ │ │ -00003450: 2077 6974 6820 7468 6520 6578 616d 706c   with the exampl
│ │ │ │ │ -00003460: 6520 6162 6f76 6520 796f 7520 6d61 7920  e above you may 
│ │ │ │ │ -00003470: 7761 6e74 2074 6f20 6164 640a 272d 4c2f  want to add.'-L/
│ │ │ │ │ -00003480: 6f70 742f 666b 6f2f 6c69 6227 2074 6f20  opt/fko/lib' to 
│ │ │ │ │ -00003490: 274c 4446 4c41 4753 272c 206f 7220 6469  'LDFLAGS', or di
│ │ │ │ │ -000034a0: 7265 6374 6c79 206f 6e20 7468 6520 636f  rectly on the co
│ │ │ │ │ -000034b0: 6d6d 616e 642d 6c69 6e65 3a0a 0a20 2020  mmand-line:..   
│ │ │ │ │ -000034c0: 2020 6763 6320 2d6f 2066 6f6f 2066 6f6f    gcc -o foo foo
│ │ │ │ │ -000034d0: 2e63 202d 492f 6f70 742f 666b 6f2f 696e  .c -I/opt/fko/in
│ │ │ │ │ -000034e0: 636c 7564 6520 2d4c 2f6f 7074 2f66 6b6f  clude -L/opt/fko
│ │ │ │ │ -000034f0: 2f6c 6962 202d 6c66 6b6f 0a0a 1f0a 4669  /lib -lfko....Fi
│ │ │ │ │ -00003500: 6c65 3a20 6c69 6266 6b6f 2e69 6e66 6f2c  le: libfko.info,
│ │ │ │ │ -00003510: 2020 4e6f 6465 3a20 5350 4120 5061 7261    Node: SPA Para
│ │ │ │ │ -00003520: 6d65 7465 7220 5479 7065 732c 2020 5072  meter Types,  Pr
│ │ │ │ │ -00003530: 6576 3a20 436f 6d70 696c 696e 6720 7769  ev: Compiling wi
│ │ │ │ │ -00003540: 7468 206c 6962 666b 6f2c 2020 5570 3a20  th libfko,  Up: 
│ │ │ │ │ -00003550: 5072 6570 6172 6174 696f 6e0a 0a32 2e33  Preparation..2.3
│ │ │ │ │ -00003560: 2053 5041 2050 6172 616d 6574 6572 2054   SPA Parameter T
│ │ │ │ │ -00003570: 7970 6573 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d  ypes.===========
│ │ │ │ │ -00003580: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 2a20  ============..* 
│ │ │ │ │ -00003590: 4d65 6e75 3a0a 0a2a 2044 6967 6573 7473  Menu:..* Digests
│ │ │ │ │ -000035a0: 3a3a 2020 2020 2020 2020 2020 2020 2020  ::              
│ │ │ │ │ -000035b0: 2020 2020 2020 2020 2054 6865 206d 6573           The mes
│ │ │ │ │ -000035c0: 7361 6765 2064 6967 6573 7420 6861 7368  sage digest hash
│ │ │ │ │ -000035d0: 6573 2073 7570 706f 7274 6564 2062 7920  es supported by 
│ │ │ │ │ -000035e0: 6c69 6266 6b6f 0a2a 2053 5041 204d 6573  libfko.* SPA Mes
│ │ │ │ │ -000035f0: 7361 6765 733a 3a20 2020 2020 2020 2020  sages::         
│ │ │ │ │ -00003600: 2020 2020 2020 2020 2054 6865 2066 6b6f           The fko
│ │ │ │ │ -00003610: 2053 5041 206d 6573 7361 6765 2074 7970   SPA message typ
│ │ │ │ │ -00003620: 6573 0a20 2020 2020 2020 2020 2020 2020  es.             
│ │ │ │ │ +00003160: 3d3d 3d3d 3d3d 3d0a 0a49 6620 796f 7520  =======..If you 
│ │ │ │ │ +00003170: 7761 6e74 2074 6f20 636f 6d70 696c 6520  want to compile 
│ │ │ │ │ +00003180: 6120 736f 7572 6365 2066 696c 6520 696e  a source file in
│ │ │ │ │ +00003190: 636c 7564 696e 6720 7468 6520 2766 6b6f  cluding the 'fko
│ │ │ │ │ +000031a0: 2e68 2720 6865 6164 6572 2066 696c 652c  .h' header file,
│ │ │ │ │ +000031b0: 0a79 6f75 206d 7573 7420 6d61 6b65 2073  .you must make s
│ │ │ │ │ +000031c0: 7572 6520 7468 6174 2074 6865 2063 6f6d  ure that the com
│ │ │ │ │ +000031d0: 7069 6c65 7220 6361 6e20 6669 6e64 2069  piler can find i
│ │ │ │ │ +000031e0: 7420 696e 2074 6865 2064 6972 6563 746f  t in the directo
│ │ │ │ │ +000031f0: 7279 0a68 6965 7261 7263 6879 2e20 2054  ry.hierarchy.  T
│ │ │ │ │ +00003200: 6869 7320 6973 2061 6363 6f6d 706c 6973  his is accomplis
│ │ │ │ │ +00003210: 6865 6420 6279 2061 6464 696e 6720 7468  hed by adding th
│ │ │ │ │ +00003220: 6520 7061 7468 2074 6f20 7468 6520 6469  e path to the di
│ │ │ │ │ +00003230: 7265 6374 6f72 7920 696e 0a77 6869 6368  rectory in.which
│ │ │ │ │ +00003240: 2074 6865 2068 6561 6465 7220 6669 6c65   the header file
│ │ │ │ │ +00003250: 2069 7320 6c6f 6361 7465 6420 746f 2074   is located to t
│ │ │ │ │ +00003260: 6865 2063 6f6d 7069 6c65 7273 2069 6e63  he compilers inc
│ │ │ │ │ +00003270: 6c75 6465 2066 696c 6520 7365 6172 6368  lude file search
│ │ │ │ │ +00003280: 0a70 6174 6820 2876 6961 2074 6865 2027  .path (via the '
│ │ │ │ │ +00003290: 2d49 2720 6f70 7469 6f6e 292e 0a0a 2020  -I' option)...  
│ │ │ │ │ +000032a0: 2046 6f72 2065 7861 6d70 6c65 2c20 6966   For example, if
│ │ │ │ │ +000032b0: 2079 6f75 2069 6e73 7461 6c6c 6564 206c   you installed l
│ │ │ │ │ +000032c0: 6962 666b 6f20 696e 2027 2f6f 7074 2f66  ibfko in '/opt/f
│ │ │ │ │ +000032d0: 6b6f 272c 2079 6f75 206d 6179 2077 616e  ko', you may wan
│ │ │ │ │ +000032e0: 7420 746f 0a61 6464 2027 2d49 2f6f 7074  t to.add '-I/opt
│ │ │ │ │ +000032f0: 2f66 6b6f 2f69 6e63 6c75 6465 2720 746f  /fko/include' to
│ │ │ │ │ +00003300: 2027 4346 4c41 4753 272c 206f 7220 6469   'CFLAGS', or di
│ │ │ │ │ +00003310: 7265 6374 6c79 206f 6e20 7468 6520 636f  rectly on the co
│ │ │ │ │ +00003320: 6d6d 616e 642d 6c69 6e65 3a0a 0a20 2020  mmand-line:..   
│ │ │ │ │ +00003330: 2020 6763 6320 2d63 2066 6f6f 2e63 202d    gcc -c foo.c -
│ │ │ │ │ +00003340: 492f 6f70 742f 666b 6f2f 696e 636c 7564  I/opt/fko/includ
│ │ │ │ │ +00003350: 6520 2e2e 2e0a 0a20 2020 5468 6520 7361  e .....   The sa
│ │ │ │ │ +00003360: 6d65 2069 7320 7472 7565 2077 6865 6e20  me is true when 
│ │ │ │ │ +00003370: 6c69 6e6b 696e 6720 6120 7072 6f67 7261  linking a progra
│ │ │ │ │ +00003380: 6d20 7769 7468 2074 6865 206c 6962 7261  m with the libra
│ │ │ │ │ +00003390: 7279 2e20 2049 6e20 7468 6973 0a63 6173  ry.  In this.cas
│ │ │ │ │ +000033a0: 652c 2074 6865 206c 696e 6b65 7220 6861  e, the linker ha
│ │ │ │ │ +000033b0: 7320 746f 2066 696e 6420 7468 6520 6c69  s to find the li
│ │ │ │ │ +000033c0: 6272 6172 7920 6669 6c65 732e 2020 466f  brary files.  Fo
│ │ │ │ │ +000033d0: 7220 7468 6973 2074 6f20 776f 726b 2c20  r this to work, 
│ │ │ │ │ +000033e0: 7468 650a 7061 7468 2074 6f20 7468 6520  the.path to the 
│ │ │ │ │ +000033f0: 6c69 6272 6172 7920 6669 6c65 7320 6861  library files ha
│ │ │ │ │ +00003400: 7320 746f 2062 6520 6164 6465 6420 746f  s to be added to
│ │ │ │ │ +00003410: 2074 6865 206c 6962 7261 7279 2073 6561   the library sea
│ │ │ │ │ +00003420: 7263 6820 7061 7468 0a28 7669 6120 7468  rch path.(via th
│ │ │ │ │ +00003430: 6520 272d 4c27 206f 7074 696f 6e29 2e0a  e '-L' option)..
│ │ │ │ │ +00003440: 0a20 2020 436f 6e74 696e 7569 6e67 2077  .   Continuing w
│ │ │ │ │ +00003450: 6974 6820 7468 6520 6578 616d 706c 6520  ith the example 
│ │ │ │ │ +00003460: 6162 6f76 6520 796f 7520 6d61 7920 7761  above you may wa
│ │ │ │ │ +00003470: 6e74 2074 6f20 6164 640a 272d 4c2f 6f70  nt to add.'-L/op
│ │ │ │ │ +00003480: 742f 666b 6f2f 6c69 6227 2074 6f20 274c  t/fko/lib' to 'L
│ │ │ │ │ +00003490: 4446 4c41 4753 272c 206f 7220 6469 7265  DFLAGS', or dire
│ │ │ │ │ +000034a0: 6374 6c79 206f 6e20 7468 6520 636f 6d6d  ctly on the comm
│ │ │ │ │ +000034b0: 616e 642d 6c69 6e65 3a0a 0a20 2020 2020  and-line:..     
│ │ │ │ │ +000034c0: 6763 6320 2d6f 2066 6f6f 2066 6f6f 2e63  gcc -o foo foo.c
│ │ │ │ │ +000034d0: 202d 492f 6f70 742f 666b 6f2f 696e 636c   -I/opt/fko/incl
│ │ │ │ │ +000034e0: 7564 6520 2d4c 2f6f 7074 2f66 6b6f 2f6c  ude -L/opt/fko/l
│ │ │ │ │ +000034f0: 6962 202d 6c66 6b6f 0a0a 1f0a 4669 6c65  ib -lfko....File
│ │ │ │ │ +00003500: 3a20 6c69 6266 6b6f 2e69 6e66 6f2c 2020  : libfko.info,  
│ │ │ │ │ +00003510: 4e6f 6465 3a20 5350 4120 5061 7261 6d65  Node: SPA Parame
│ │ │ │ │ +00003520: 7465 7220 5479 7065 732c 2020 5072 6576  ter Types,  Prev
│ │ │ │ │ +00003530: 3a20 436f 6d70 696c 696e 6720 7769 7468  : Compiling with
│ │ │ │ │ +00003540: 206c 6962 666b 6f2c 2020 5570 3a20 5072   libfko,  Up: Pr
│ │ │ │ │ +00003550: 6570 6172 6174 696f 6e0a 0a32 2e33 2053  eparation..2.3 S
│ │ │ │ │ +00003560: 5041 2050 6172 616d 6574 6572 2054 7970  PA Parameter Typ
│ │ │ │ │ +00003570: 6573 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  es.=============
│ │ │ │ │ +00003580: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 2a20 4d65  ==========..* Me
│ │ │ │ │ +00003590: 6e75 3a0a 0a2a 2044 6967 6573 7473 3a3a  nu:..* Digests::
│ │ │ │ │ +000035a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ +000035b0: 2020 2020 2020 2054 6865 206d 6573 7361         The messa
│ │ │ │ │ +000035c0: 6765 2064 6967 6573 7420 6861 7368 6573  ge digest hashes
│ │ │ │ │ +000035d0: 2073 7570 706f 7274 6564 2062 7920 6c69   supported by li
│ │ │ │ │ +000035e0: 6266 6b6f 0a2a 2053 5041 204d 6573 7361  bfko.* SPA Messa
│ │ │ │ │ +000035f0: 6765 733a 3a20 2020 2020 2020 2020 2020  ges::           
│ │ │ │ │ +00003600: 2020 2020 2020 2054 6865 2066 6b6f 2053         The fko S
│ │ │ │ │ +00003610: 5041 206d 6573 7361 6765 2074 7970 6573  PA message types
│ │ │ │ │ +00003620: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ │  00003630: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00003640: 2020 2020 2073 7570 706f 7274 6564 2062       supported b
│ │ │ │ │ -00003650: 7920 6c69 6266 6b6f 2028 616e 6420 6677  y libfko (and fw
│ │ │ │ │ -00003660: 6b6e 6f70 290a 2a20 456e 6372 7970 7469  knop).* Encrypti
│ │ │ │ │ -00003670: 6f6e 2041 6c67 6f72 6974 686d 733a 3a20  on Algorithms:: 
│ │ │ │ │ -00003680: 2020 2020 2020 2020 456e 6372 7970 7469          Encrypti
│ │ │ │ │ -00003690: 6f6e 2073 6368 656d 6573 2073 7570 706f  on schemes suppo
│ │ │ │ │ -000036a0: 7274 6564 2062 7920 6c69 6266 6b6f 0a2a  rted by libfko.*
│ │ │ │ │ -000036b0: 2048 4d41 4320 4469 6765 7374 733a 3a20   HMAC Digests:: 
│ │ │ │ │ -000036c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000036d0: 2044 6967 6573 7473 2074 6861 7420 6361   Digests that ca
│ │ │ │ │ -000036e0: 6e20 6265 2075 7365 6420 746f 2062 7569  n be used to bui
│ │ │ │ │ -000036f0: 6c64 2061 6e20 484d 4143 0a0a 1f0a 4669  ld an HMAC....Fi
│ │ │ │ │ -00003700: 6c65 3a20 6c69 6266 6b6f 2e69 6e66 6f2c  le: libfko.info,
│ │ │ │ │ -00003710: 2020 4e6f 6465 3a20 4469 6765 7374 732c    Node: Digests,
│ │ │ │ │ -00003720: 2020 4e65 7874 3a20 5350 4120 4d65 7373    Next: SPA Mess
│ │ │ │ │ -00003730: 6167 6573 2c20 2055 703a 2053 5041 2050  ages,  Up: SPA P
│ │ │ │ │ -00003740: 6172 616d 6574 6572 2054 7970 6573 0a0a  arameter Types..
│ │ │ │ │ -00003750: 322e 332e 3120 4469 6765 7374 730a 2d2d  2.3.1 Digests.--
│ │ │ │ │ -00003760: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865  -----------..The
│ │ │ │ │ -00003770: 2066 776b 6e6f 7020 7379 7374 656d 2065   fwknop system e
│ │ │ │ │ -00003780: 6d70 6c6f 7973 2061 206d 6573 7361 6765  mploys a message
│ │ │ │ │ -00003790: 2064 6967 6573 7420 6861 7368 206f 6620   digest hash of 
│ │ │ │ │ -000037a0: 7468 6520 5350 4120 6461 7461 2061 7320  the SPA data as 
│ │ │ │ │ -000037b0: 6f6e 650a 6f66 2074 6865 2064 6174 6120  one.of the data 
│ │ │ │ │ -000037c0: 6669 656c 6473 2074 6f20 6163 7420 6120  fields to act a 
│ │ │ │ │ -000037d0: 7369 676e 6174 7572 6520 7768 6963 6820  signature which 
│ │ │ │ │ -000037e0: 6361 6e20 6265 2075 7365 6420 6174 2074  can be used at t
│ │ │ │ │ -000037f0: 6865 2072 6563 6569 7669 6e67 0a65 6e64  he receiving.end
│ │ │ │ │ -00003800: 2074 6f20 7665 7269 6679 2074 6865 2064   to verify the d
│ │ │ │ │ -00003810: 6174 6120 6973 2076 616c 6964 2028 616c  ata is valid (al
│ │ │ │ │ -00003820: 7468 6f75 6768 2074 6869 7320 6665 6174  though this feat
│ │ │ │ │ -00003830: 7572 6520 6861 7320 6265 656e 0a73 7570  ure has been.sup
│ │ │ │ │ -00003840: 6572 6365 6465 6420 6279 2074 6865 2075  erceded by the u
│ │ │ │ │ -00003850: 7361 6765 206f 6620 616e 2048 4d41 4320  sage of an HMAC 
│ │ │ │ │ -00003860: 666f 7220 7072 6f70 6572 206d 6573 7361  for proper messa
│ │ │ │ │ -00003870: 6765 2061 7574 6865 6e74 6963 6174 696f  ge authenticatio
│ │ │ │ │ -00003880: 6e20 616e 640a 7665 7269 6669 6361 7469  n and.verificati
│ │ │ │ │ -00003890: 6f6e 206f 6620 696e 7465 6772 6974 7929  on of integrity)
│ │ │ │ │ -000038a0: 2e20 2054 6865 2072 6573 756c 7469 6e67  .  The resulting
│ │ │ │ │ -000038b0: 2064 6967 6573 7420 6973 2062 6173 6536   digest is base6
│ │ │ │ │ -000038c0: 342d 656e 636f 6465 640a 6265 666f 7265  4-encoded.before
│ │ │ │ │ -000038d0: 2069 7420 6973 2061 6464 6564 2074 6f20   it is added to 
│ │ │ │ │ -000038e0: 7468 6520 5350 4120 6461 7461 2e0a 0a20  the SPA data... 
│ │ │ │ │ -000038f0: 2020 4375 7272 656e 746c 792c 206c 6962    Currently, lib
│ │ │ │ │ -00003900: 666b 6f20 7375 7070 6f72 7473 2074 6865  fko supports the
│ │ │ │ │ -00003910: 2073 616d 6520 6d65 7373 6167 6520 6469   same message di
│ │ │ │ │ -00003920: 6765 7374 7320 6173 2074 6865 206c 6567  gests as the leg
│ │ │ │ │ -00003930: 6163 790a 6677 6b6e 6f70 2070 6c75 7320  acy.fwknop plus 
│ │ │ │ │ -00003940: 7477 6f20 6f74 6865 7273 2028 5348 4133  two others (SHA3
│ │ │ │ │ -00003950: 3834 2061 6e64 2053 4841 3531 3229 2e20  84 and SHA512). 
│ │ │ │ │ -00003960: 2054 6865 7365 2061 7265 2028 696e 206f   These are (in o
│ │ │ │ │ -00003970: 7264 6572 206f 660a 7374 7265 6e67 7468  rder of.strength
│ │ │ │ │ -00003980: 293a 0a0a 202d 2d20 5661 7269 6162 6c65  ):.. -- Variable
│ │ │ │ │ -00003990: 3a20 696e 7420 666b 6f5f 6469 6765 7374  : int fko_digest
│ │ │ │ │ -000039a0: 5f74 7970 655f 740a 2020 2020 2027 464b  _type_t.     'FK
│ │ │ │ │ -000039b0: 4f5f 4449 4745 5354 5f4d 4435 270a 2020  O_DIGEST_MD5'.  
│ │ │ │ │ -000039c0: 2020 2027 464b 4f5f 4449 4745 5354 5f53     'FKO_DIGEST_S
│ │ │ │ │ -000039d0: 4841 3127 0a20 2020 2020 2746 4b4f 5f44  HA1'.     'FKO_D
│ │ │ │ │ -000039e0: 4947 4553 545f 5348 4132 3536 2028 6c69  IGEST_SHA256 (li
│ │ │ │ │ -000039f0: 6266 6b6f 2064 6566 6175 6c74 2927 0a20  bfko default)'. 
│ │ │ │ │ -00003a00: 2020 2020 2746 4b4f 5f44 4947 4553 545f      'FKO_DIGEST_
│ │ │ │ │ -00003a10: 5348 4133 3834 270a 2020 2020 2027 464b  SHA384'.     'FK
│ │ │ │ │ -00003a20: 4f5f 4449 4745 5354 5f53 4841 3531 3227  O_DIGEST_SHA512'
│ │ │ │ │ -00003a30: 0a0a 2020 2041 7320 696e 6469 6361 7465  ..   As indicate
│ │ │ │ │ -00003a40: 6420 696e 2074 6865 206c 6973 7420 6162  d in the list ab
│ │ │ │ │ -00003a50: 6f76 652c 2053 4841 3235 3620 6973 2074  ove, SHA256 is t
│ │ │ │ │ -00003a60: 6865 2064 6566 6175 6c74 2e20 2054 6869  he default.  Thi
│ │ │ │ │ -00003a70: 7320 6d65 616e 730a 7468 6520 6469 6765  s means.the dige
│ │ │ │ │ -00003a80: 7374 2074 7970 6520 646f 6573 206e 6f74  st type does not
│ │ │ │ │ -00003a90: 206e 6565 6420 746f 2062 6520 6578 706c   need to be expl
│ │ │ │ │ -00003aa0: 6963 6974 6c79 2073 6574 2075 6e6c 6573  icitly set unles
│ │ │ │ │ -00003ab0: 7320 796f 7520 7769 7368 2074 6f0a 7573  s you wish to.us
│ │ │ │ │ -00003ac0: 6520 6f6e 6520 6f66 2074 6865 206f 7468  e one of the oth
│ │ │ │ │ -00003ad0: 6572 2076 616c 7565 732e 2020 5468 6973  er values.  This
│ │ │ │ │ -00003ae0: 2061 7070 6c69 6573 2074 6f20 616c 6c20   applies to all 
│ │ │ │ │ -00003af0: 6c69 6266 6b6f 2053 5041 2064 6174 6120  libfko SPA data 
│ │ │ │ │ -00003b00: 6669 656c 6473 0a74 6861 7420 6861 7665  fields.that have
│ │ │ │ │ -00003b10: 2061 2064 6566 6175 6c74 2076 616c 7565   a default value
│ │ │ │ │ -00003b20: 2e0a 0a1f 0a46 696c 653a 206c 6962 666b  .....File: libfk
│ │ │ │ │ -00003b30: 6f2e 696e 666f 2c20 204e 6f64 653a 2053  o.info,  Node: S
│ │ │ │ │ -00003b40: 5041 204d 6573 7361 6765 732c 2020 4e65  PA Messages,  Ne
│ │ │ │ │ -00003b50: 7874 3a20 456e 6372 7970 7469 6f6e 2041  xt: Encryption A
│ │ │ │ │ -00003b60: 6c67 6f72 6974 686d 732c 2020 5072 6576  lgorithms,  Prev
│ │ │ │ │ -00003b70: 3a20 4469 6765 7374 732c 2020 5570 3a20  : Digests,  Up: 
│ │ │ │ │ -00003b80: 5350 4120 5061 7261 6d65 7465 7220 5479  SPA Parameter Ty
│ │ │ │ │ -00003b90: 7065 730a 0a32 2e33 2e32 2053 5041 204d  pes..2.3.2 SPA M
│ │ │ │ │ -00003ba0: 6573 7361 6765 730a 2d2d 2d2d 2d2d 2d2d  essages.--------
│ │ │ │ │ -00003bb0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520  ----------..The 
│ │ │ │ │ -00003bc0: 6677 6b6e 6f70 2073 7973 7465 6d20 2861  fwknop system (a
│ │ │ │ │ -00003bd0: 6e64 2073 7562 7365 7175 656e 746c 7920  nd subsequently 
│ │ │ │ │ -00003be0: 6c69 6266 6b6f 292c 2073 7570 706f 7274  libfko), support
│ │ │ │ │ -00003bf0: 2061 2073 7065 6369 6669 6320 7365 7420   a specific set 
│ │ │ │ │ -00003c00: 6f66 0a6d 6573 7361 6765 2074 7970 6573  of.message types
│ │ │ │ │ -00003c10: 2e20 2054 6865 206d 6573 7361 6765 2074  .  The message t
│ │ │ │ │ -00003c20: 7970 6520 7661 6c75 6520 6973 2075 7365  ype value is use
│ │ │ │ │ -00003c30: 6420 6279 2066 776b 6e6f 7020 746f 2068  d by fwknop to h
│ │ │ │ │ -00003c40: 656c 700a 6465 7465 726d 696e 6520 7468  elp.determine th
│ │ │ │ │ -00003c50: 6520 636f 7272 6563 7420 6d65 7373 6167  e correct messag
│ │ │ │ │ -00003c60: 6520 666f 726d 6174 2061 6e64 2063 6f6e  e format and con
│ │ │ │ │ -00003c70: 7465 6e74 2e20 2054 6865 7365 206d 6573  tent.  These mes
│ │ │ │ │ -00003c80: 7361 6765 2074 7970 6573 0a61 7265 3a0a  sage types.are:.
│ │ │ │ │ -00003c90: 0a20 2d2d 2056 6172 6961 626c 653a 2069  . -- Variable: i
│ │ │ │ │ -00003ca0: 6e74 2066 6b6f 5f6d 6573 7361 6765 5f74  nt fko_message_t
│ │ │ │ │ -00003cb0: 7970 655f 740a 2020 2020 2027 464b 4f5f  ype_t.     'FKO_
│ │ │ │ │ -00003cc0: 434f 4d4d 414e 445f 4d53 4727 0a20 2020  COMMAND_MSG'.   
│ │ │ │ │ -00003cd0: 2020 2020 2020 2041 2072 6571 7565 7374         A request
│ │ │ │ │ -00003ce0: 2074 6f20 6861 7665 2074 6865 2066 776b   to have the fwk
│ │ │ │ │ -00003cf0: 6e6f 7020 7365 7276 6572 2065 7865 6375  nop server execu
│ │ │ │ │ -00003d00: 7465 2074 6865 2067 6976 656e 2063 6f6d  te the given com
│ │ │ │ │ -00003d10: 6d61 6e64 2e0a 2020 2020 2020 2020 2020  mand..          
│ │ │ │ │ -00003d20: 5468 6520 666f 726d 6174 2066 6f72 2074  The format for t
│ │ │ │ │ -00003d30: 6869 7320 7479 7065 2069 733a 2027 3c69  his type is: '<i
│ │ │ │ │ -00003d40: 7020 6f66 2072 6571 7565 7374 6f72 3e2c  p of requestor>,
│ │ │ │ │ -00003d50: 3c63 6f6d 6d61 6e64 0a20 2020 2020 2020  <command.       
│ │ │ │ │ -00003d60: 2020 2074 6578 743e 272e 0a20 2020 2020     text>'..     
│ │ │ │ │ -00003d70: 2020 2020 2020 2020 2020 2231 3932 2e31            "192.1
│ │ │ │ │ -00003d80: 3638 2e31 2e32 2c75 6e61 6d65 202d 6122  68.1.2,uname -a"
│ │ │ │ │ -00003d90: 0a0a 2020 2020 2027 464b 4f5f 4143 4345  ..     'FKO_ACCE
│ │ │ │ │ -00003da0: 5353 5f4d 5347 270a 2020 2020 2020 2020  SS_MSG'.        
│ │ │ │ │ -00003db0: 2020 4120 6261 7369 6320 6163 6365 7373    A basic access
│ │ │ │ │ -00003dc0: 2072 6571 7565 7374 2e20 2054 6869 7320   request.  This 
│ │ │ │ │ -00003dd0: 6973 2074 6865 206d 6f73 7420 636f 6d6d  is the most comm
│ │ │ │ │ -00003de0: 6f6e 2074 7970 6520 696e 2075 7365 2e0a  on type in use..
│ │ │ │ │ -00003df0: 2020 2020 2020 2020 2020 5468 6520 666f            The fo
│ │ │ │ │ -00003e00: 726d 6174 2066 6f72 2074 6869 7320 7479  rmat for this ty
│ │ │ │ │ -00003e10: 7065 2069 733a 2027 3c69 7020 6f66 0a20  pe is: '<ip of. 
│ │ │ │ │ -00003e20: 2020 2020 2020 2020 2072 6571 7565 7374           request
│ │ │ │ │ -00003e30: 6f72 3e2c 3c70 726f 746f 636f 6c3e 2f3c  or>,<protocol>/<
│ │ │ │ │ -00003e40: 706f 7274 3e27 2e20 204e 6f74 6520 7468  port>'.  Note th
│ │ │ │ │ -00003e50: 6174 206d 756c 7469 706c 650a 2020 2020  at multiple.    
│ │ │ │ │ -00003e60: 2020 2020 2020 7072 6f74 6f63 6f6c 2f70        protocol/p
│ │ │ │ │ -00003e70: 6f72 7420 656e 7472 6965 7320 6172 6520  ort entries are 
│ │ │ │ │ -00003e80: 616c 6c6f 7765 642e 0a20 2020 2020 2020  allowed..       
│ │ │ │ │ -00003e90: 2020 2020 2020 2020 2231 3932 2e31 3638          "192.168
│ │ │ │ │ -00003ea0: 2e31 2e32 2c74 6370 2f32 3222 0a20 2020  .1.2,tcp/22".   
│ │ │ │ │ -00003eb0: 2020 2020 2020 2020 2020 2020 2231 3932              "192
│ │ │ │ │ -00003ec0: 2e31 3638 2e31 2e32 2c74 6370 2f32 322c  .168.1.2,tcp/22,
│ │ │ │ │ -00003ed0: 7564 702f 3530 3035 220a 0a20 2020 2020  udp/5005"..     
│ │ │ │ │ -00003ee0: 2746 4b4f 5f4e 4154 5f41 4343 4553 535f  'FKO_NAT_ACCESS_
│ │ │ │ │ -00003ef0: 4d53 4727 0a20 2020 2020 2020 2020 2041  MSG'.          A
│ │ │ │ │ -00003f00: 6e20 6163 6365 7373 2072 6571 7565 7374  n access request
│ │ │ │ │ -00003f10: 2074 6861 7420 616c 736f 2070 726f 7669   that also provi
│ │ │ │ │ -00003f20: 6465 2069 6e66 6f72 6d61 7469 6f6e 2066  de information f
│ │ │ │ │ -00003f30: 6f72 2074 6865 2066 776b 6e6f 700a 2020  or the fwknop.  
│ │ │ │ │ -00003f40: 2020 2020 2020 2020 7365 7276 6572 2074          server t
│ │ │ │ │ -00003f50: 6f20 6372 6561 7465 2061 204e 6574 776f  o create a Netwo
│ │ │ │ │ -00003f60: 726b 2041 6464 7265 7373 2054 7261 6e73  rk Address Trans
│ │ │ │ │ -00003f70: 6c61 7469 6f6e 2028 4e41 5420 746f 2061  lation (NAT to a
│ │ │ │ │ -00003f80: 6e0a 2020 2020 2020 2020 2020 696e 7465  n.          inte
│ │ │ │ │ -00003f90: 726e 616c 2061 6464 7265 7373 2e20 2054  rnal address.  T
│ │ │ │ │ -00003fa0: 6865 2066 6f72 6d61 7420 666f 7220 7468  he format for th
│ │ │ │ │ -00003fb0: 6973 2073 7472 696e 6720 6973 3a20 273c  is string is: '<
│ │ │ │ │ -00003fc0: 696e 7465 726e 616c 0a20 2020 2020 2020  internal.       
│ │ │ │ │ -00003fd0: 2020 2069 703e 2c3c 6578 7420 6e61 7420     ip>,<ext nat 
│ │ │ │ │ -00003fe0: 706f 7274 3e27 2e0a 2020 2020 2020 2020  port>'..        
│ │ │ │ │ -00003ff0: 2020 2020 2020 2022 3130 2e31 302e 312e         "10.10.1.
│ │ │ │ │ -00004000: 322c 3939 3232 220a 0a20 2020 2020 2746  2,9922"..     'F
│ │ │ │ │ -00004010: 4b4f 5f43 4c49 454e 545f 5449 4d45 4f55  KO_CLIENT_TIMEOU
│ │ │ │ │ -00004020: 545f 4143 4345 5353 5f4d 5347 270a 2020  T_ACCESS_MSG'.  
│ │ │ │ │ -00004030: 2020 2020 2020 2020 5468 6973 2069 7320          This is 
│ │ │ │ │ -00004040: 616e 2046 4b4f 5f41 4343 4553 535f 5245  an FKO_ACCESS_RE
│ │ │ │ │ -00004050: 5155 4553 5420 7769 7468 2061 2074 696d  QUEST with a tim
│ │ │ │ │ -00004060: 656f 7574 2070 6172 616d 6574 6572 2066  eout parameter f
│ │ │ │ │ -00004070: 6f72 2074 6865 0a20 2020 2020 2020 2020  or the.         
│ │ │ │ │ -00004080: 2066 776b 6e6f 7020 7365 7276 6572 2e20   fwknop server. 
│ │ │ │ │ -00004090: 2054 6865 2074 696d 656f 7574 2076 616c   The timeout val
│ │ │ │ │ -000040a0: 7565 2069 7320 7072 6f76 6964 6564 2076  ue is provided v
│ │ │ │ │ -000040b0: 6961 2074 6865 0a20 2020 2020 2020 2020  ia the.         
│ │ │ │ │ -000040c0: 2027 636c 6965 6e74 5f74 696d 656f 7574   'client_timeout
│ │ │ │ │ -000040d0: 2720 6461 7461 2066 6965 6c64 2e0a 0a20  ' data field... 
│ │ │ │ │ -000040e0: 2020 2020 2746 4b4f 5f43 4c49 454e 545f      'FKO_CLIENT_
│ │ │ │ │ -000040f0: 5449 4d45 4f55 545f 4e41 545f 4143 4345  TIMEOUT_NAT_ACCE
│ │ │ │ │ -00004100: 5353 5f4d 5347 270a 2020 2020 2020 2020  SS_MSG'.        
│ │ │ │ │ -00004110: 2020 5468 6973 2069 7320 616e 2046 4b4f    This is an FKO
│ │ │ │ │ -00004120: 5f4e 4154 5f41 4343 4553 535f 5245 5155  _NAT_ACCESS_REQU
│ │ │ │ │ -00004130: 4553 5420 7769 7468 2061 2074 696d 656f  EST with a timeo
│ │ │ │ │ -00004140: 7574 2070 6172 616d 6574 6572 2066 6f72  ut parameter for
│ │ │ │ │ -00004150: 0a20 2020 2020 2020 2020 2074 6865 2066  .          the f
│ │ │ │ │ -00004160: 776b 6e6f 7020 7365 7276 6572 2e20 2054  wknop server.  T
│ │ │ │ │ -00004170: 6865 2074 696d 656f 7574 2076 616c 7565  he timeout value
│ │ │ │ │ -00004180: 2069 7320 7072 6f76 6964 6564 2076 6961   is provided via
│ │ │ │ │ -00004190: 2074 6865 0a20 2020 2020 2020 2020 2027   the.          '
│ │ │ │ │ -000041a0: 636c 6965 6e74 5f74 696d 656f 7574 2720  client_timeout' 
│ │ │ │ │ -000041b0: 6461 7461 2066 6965 6c64 2e0a 0a20 2020  data field...   
│ │ │ │ │ -000041c0: 2020 2746 4b4f 5f4c 4f43 414c 5f4e 4154    'FKO_LOCAL_NAT
│ │ │ │ │ -000041d0: 5f41 4343 4553 535f 4d53 4727 0a20 2020  _ACCESS_MSG'.   
│ │ │ │ │ -000041e0: 2020 2020 2020 2054 6869 7320 6973 2073         This is s
│ │ │ │ │ -000041f0: 696d 696c 6172 2074 6f20 7468 6520 464b  imilar to the FK
│ │ │ │ │ -00004200: 4f5f 4e41 545f 4143 4345 5353 2072 6571  O_NAT_ACCESS req
│ │ │ │ │ -00004210: 7565 7374 2065 7863 6570 7420 7468 6520  uest except the 
│ │ │ │ │ -00004220: 4e41 540a 2020 2020 2020 2020 2020 6973  NAT.          is
│ │ │ │ │ -00004230: 2074 6f20 7468 6520 6c6f 6361 6c20 746f   to the local to
│ │ │ │ │ -00004240: 2074 6865 2073 6572 7665 7220 2869 2e65   the server (i.e
│ │ │ │ │ -00004250: 2e20 2061 2073 6572 7669 6365 206c 6973  .  a service lis
│ │ │ │ │ -00004260: 7465 6e69 6e67 206f 6e0a 2020 2020 2020  tening on.      
│ │ │ │ │ -00004270: 2020 2020 3132 372e 302e 302e 3129 2e0a      127.0.0.1)..
│ │ │ │ │ -00004280: 0a20 2020 2020 2746 4b4f 5f43 4c49 454e  .     'FKO_CLIEN
│ │ │ │ │ -00004290: 545f 5449 4d45 4f55 545f 4c4f 4341 4c5f  T_TIMEOUT_LOCAL_
│ │ │ │ │ -000042a0: 4e41 545f 4143 4345 5353 5f4d 5347 270a  NAT_ACCESS_MSG'.
│ │ │ │ │ -000042b0: 2020 2020 2020 2020 2020 5468 6973 2069            This i
│ │ │ │ │ -000042c0: 7320 616e 2046 4b4f 5f4c 4f43 414c 5f4e  s an FKO_LOCAL_N
│ │ │ │ │ -000042d0: 4154 5f41 4343 4553 535f 5245 5155 4553  AT_ACCESS_REQUES
│ │ │ │ │ -000042e0: 5420 7769 7468 2061 2074 696d 656f 7574  T with a timeout
│ │ │ │ │ -000042f0: 0a20 2020 2020 2020 2020 2070 6172 616d  .          param
│ │ │ │ │ -00004300: 6574 6572 2066 6f72 2074 6865 2066 776b  eter for the fwk
│ │ │ │ │ -00004310: 6e6f 7020 7365 7276 6572 2e20 2054 6865  nop server.  The
│ │ │ │ │ -00004320: 2074 696d 656f 7574 2076 616c 7565 2069   timeout value i
│ │ │ │ │ -00004330: 730a 2020 2020 2020 2020 2020 7072 6f76  s.          prov
│ │ │ │ │ -00004340: 6964 6564 2076 6961 2074 6865 2027 636c  ided via the 'cl
│ │ │ │ │ -00004350: 6965 6e74 5f74 696d 656f 7574 2720 6461  ient_timeout' da
│ │ │ │ │ -00004360: 7461 2066 6965 6c64 2e0a 0a1f 0a46 696c  ta field.....Fil
│ │ │ │ │ -00004370: 653a 206c 6962 666b 6f2e 696e 666f 2c20  e: libfko.info, 
│ │ │ │ │ -00004380: 204e 6f64 653a 2045 6e63 7279 7074 696f   Node: Encryptio
│ │ │ │ │ -00004390: 6e20 416c 676f 7269 7468 6d73 2c20 204e  n Algorithms,  N
│ │ │ │ │ -000043a0: 6578 743a 2048 4d41 4320 4469 6765 7374  ext: HMAC Digest
│ │ │ │ │ -000043b0: 732c 2020 5072 6576 3a20 5350 4120 4d65  s,  Prev: SPA Me
│ │ │ │ │ -000043c0: 7373 6167 6573 2c20 2055 703a 2053 5041  ssages,  Up: SPA
│ │ │ │ │ -000043d0: 2050 6172 616d 6574 6572 2054 7970 6573   Parameter Types
│ │ │ │ │ -000043e0: 0a0a 322e 332e 3320 456e 6372 7970 7469  ..2.3.3 Encrypti
│ │ │ │ │ -000043f0: 6f6e 2041 6c67 6f72 6974 686d 730a 2d2d  on Algorithms.--
│ │ │ │ │ +00003640: 2020 2073 7570 706f 7274 6564 2062 7920     supported by 
│ │ │ │ │ +00003650: 6c69 6266 6b6f 2028 616e 6420 6677 6b6e  libfko (and fwkn
│ │ │ │ │ +00003660: 6f70 290a 2a20 456e 6372 7970 7469 6f6e  op).* Encryption
│ │ │ │ │ +00003670: 2041 6c67 6f72 6974 686d 733a 3a20 2020   Algorithms::   
│ │ │ │ │ +00003680: 2020 2020 2020 456e 6372 7970 7469 6f6e        Encryption
│ │ │ │ │ +00003690: 2073 6368 656d 6573 2073 7570 706f 7274   schemes support
│ │ │ │ │ +000036a0: 6564 2062 7920 6c69 6266 6b6f 0a2a 2048  ed by libfko.* H
│ │ │ │ │ +000036b0: 4d41 4320 4469 6765 7374 733a 3a20 2020  MAC Digests::   
│ │ │ │ │ +000036c0: 2020 2020 2020 2020 2020 2020 2020 2044                 D
│ │ │ │ │ +000036d0: 6967 6573 7473 2074 6861 7420 6361 6e20  igests that can 
│ │ │ │ │ +000036e0: 6265 2075 7365 6420 746f 2062 7569 6c64  be used to build
│ │ │ │ │ +000036f0: 2061 6e20 484d 4143 0a0a 1f0a 4669 6c65   an HMAC....File
│ │ │ │ │ +00003700: 3a20 6c69 6266 6b6f 2e69 6e66 6f2c 2020  : libfko.info,  
│ │ │ │ │ +00003710: 4e6f 6465 3a20 4469 6765 7374 732c 2020  Node: Digests,  
│ │ │ │ │ +00003720: 4e65 7874 3a20 5350 4120 4d65 7373 6167  Next: SPA Messag
│ │ │ │ │ +00003730: 6573 2c20 2055 703a 2053 5041 2050 6172  es,  Up: SPA Par
│ │ │ │ │ +00003740: 616d 6574 6572 2054 7970 6573 0a0a 322e  ameter Types..2.
│ │ │ │ │ +00003750: 332e 3120 4469 6765 7374 730a 2d2d 2d2d  3.1 Digests.----
│ │ │ │ │ +00003760: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 2066  ---------..The f
│ │ │ │ │ +00003770: 776b 6e6f 7020 7379 7374 656d 2065 6d70  wknop system emp
│ │ │ │ │ +00003780: 6c6f 7973 2061 206d 6573 7361 6765 2064  loys a message d
│ │ │ │ │ +00003790: 6967 6573 7420 6861 7368 206f 6620 7468  igest hash of th
│ │ │ │ │ +000037a0: 6520 5350 4120 6461 7461 2061 7320 6f6e  e SPA data as on
│ │ │ │ │ +000037b0: 650a 6f66 2074 6865 2064 6174 6120 6669  e.of the data fi
│ │ │ │ │ +000037c0: 656c 6473 2074 6f20 6163 7420 6120 7369  elds to act a si
│ │ │ │ │ +000037d0: 676e 6174 7572 6520 7768 6963 6820 6361  gnature which ca
│ │ │ │ │ +000037e0: 6e20 6265 2075 7365 6420 6174 2074 6865  n be used at the
│ │ │ │ │ +000037f0: 2072 6563 6569 7669 6e67 0a65 6e64 2074   receiving.end t
│ │ │ │ │ +00003800: 6f20 7665 7269 6679 2074 6865 2064 6174  o verify the dat
│ │ │ │ │ +00003810: 6120 6973 2076 616c 6964 2028 616c 7468  a is valid (alth
│ │ │ │ │ +00003820: 6f75 6768 2074 6869 7320 6665 6174 7572  ough this featur
│ │ │ │ │ +00003830: 6520 6861 7320 6265 656e 0a73 7570 6572  e has been.super
│ │ │ │ │ +00003840: 6365 6465 6420 6279 2074 6865 2075 7361  ceded by the usa
│ │ │ │ │ +00003850: 6765 206f 6620 616e 2048 4d41 4320 666f  ge of an HMAC fo
│ │ │ │ │ +00003860: 7220 7072 6f70 6572 206d 6573 7361 6765  r proper message
│ │ │ │ │ +00003870: 2061 7574 6865 6e74 6963 6174 696f 6e20   authentication 
│ │ │ │ │ +00003880: 616e 640a 7665 7269 6669 6361 7469 6f6e  and.verification
│ │ │ │ │ +00003890: 206f 6620 696e 7465 6772 6974 7929 2e20   of integrity). 
│ │ │ │ │ +000038a0: 2054 6865 2072 6573 756c 7469 6e67 2064   The resulting d
│ │ │ │ │ +000038b0: 6967 6573 7420 6973 2062 6173 6536 342d  igest is base64-
│ │ │ │ │ +000038c0: 656e 636f 6465 640a 6265 666f 7265 2069  encoded.before i
│ │ │ │ │ +000038d0: 7420 6973 2061 6464 6564 2074 6f20 7468  t is added to th
│ │ │ │ │ +000038e0: 6520 5350 4120 6461 7461 2e0a 0a20 2020  e SPA data...   
│ │ │ │ │ +000038f0: 4375 7272 656e 746c 792c 206c 6962 666b  Currently, libfk
│ │ │ │ │ +00003900: 6f20 7375 7070 6f72 7473 2074 6865 2073  o supports the s
│ │ │ │ │ +00003910: 616d 6520 6d65 7373 6167 6520 6469 6765  ame message dige
│ │ │ │ │ +00003920: 7374 7320 6173 2074 6865 206c 6567 6163  sts as the legac
│ │ │ │ │ +00003930: 790a 6677 6b6e 6f70 2070 6c75 7320 7477  y.fwknop plus tw
│ │ │ │ │ +00003940: 6f20 6f74 6865 7273 2028 5348 4133 3834  o others (SHA384
│ │ │ │ │ +00003950: 2061 6e64 2053 4841 3531 3229 2e20 2054   and SHA512).  T
│ │ │ │ │ +00003960: 6865 7365 2061 7265 2028 696e 206f 7264  hese are (in ord
│ │ │ │ │ +00003970: 6572 206f 660a 7374 7265 6e67 7468 293a  er of.strength):
│ │ │ │ │ +00003980: 0a0a 202d 2d20 5661 7269 6162 6c65 3a20  .. -- Variable: 
│ │ │ │ │ +00003990: 696e 7420 666b 6f5f 6469 6765 7374 5f74  int fko_digest_t
│ │ │ │ │ +000039a0: 7970 655f 740a 2020 2020 2027 464b 4f5f  ype_t.     'FKO_
│ │ │ │ │ +000039b0: 4449 4745 5354 5f4d 4435 270a 2020 2020  DIGEST_MD5'.    
│ │ │ │ │ +000039c0: 2027 464b 4f5f 4449 4745 5354 5f53 4841   'FKO_DIGEST_SHA
│ │ │ │ │ +000039d0: 3127 0a20 2020 2020 2746 4b4f 5f44 4947  1'.     'FKO_DIG
│ │ │ │ │ +000039e0: 4553 545f 5348 4132 3536 2028 6c69 6266  EST_SHA256 (libf
│ │ │ │ │ +000039f0: 6b6f 2064 6566 6175 6c74 2927 0a20 2020  ko default)'.   
│ │ │ │ │ +00003a00: 2020 2746 4b4f 5f44 4947 4553 545f 5348    'FKO_DIGEST_SH
│ │ │ │ │ +00003a10: 4133 3834 270a 2020 2020 2027 464b 4f5f  A384'.     'FKO_
│ │ │ │ │ +00003a20: 4449 4745 5354 5f53 4841 3531 3227 0a0a  DIGEST_SHA512'..
│ │ │ │ │ +00003a30: 2020 2041 7320 696e 6469 6361 7465 6420     As indicated 
│ │ │ │ │ +00003a40: 696e 2074 6865 206c 6973 7420 6162 6f76  in the list abov
│ │ │ │ │ +00003a50: 652c 2053 4841 3235 3620 6973 2074 6865  e, SHA256 is the
│ │ │ │ │ +00003a60: 2064 6566 6175 6c74 2e20 2054 6869 7320   default.  This 
│ │ │ │ │ +00003a70: 6d65 616e 730a 7468 6520 6469 6765 7374  means.the digest
│ │ │ │ │ +00003a80: 2074 7970 6520 646f 6573 206e 6f74 206e   type does not n
│ │ │ │ │ +00003a90: 6565 6420 746f 2062 6520 6578 706c 6963  eed to be explic
│ │ │ │ │ +00003aa0: 6974 6c79 2073 6574 2075 6e6c 6573 7320  itly set unless 
│ │ │ │ │ +00003ab0: 796f 7520 7769 7368 2074 6f0a 7573 6520  you wish to.use 
│ │ │ │ │ +00003ac0: 6f6e 6520 6f66 2074 6865 206f 7468 6572  one of the other
│ │ │ │ │ +00003ad0: 2076 616c 7565 732e 2020 5468 6973 2061   values.  This a
│ │ │ │ │ +00003ae0: 7070 6c69 6573 2074 6f20 616c 6c20 6c69  pplies to all li
│ │ │ │ │ +00003af0: 6266 6b6f 2053 5041 2064 6174 6120 6669  bfko SPA data fi
│ │ │ │ │ +00003b00: 656c 6473 0a74 6861 7420 6861 7665 2061  elds.that have a
│ │ │ │ │ +00003b10: 2064 6566 6175 6c74 2076 616c 7565 2e0a   default value..
│ │ │ │ │ +00003b20: 0a1f 0a46 696c 653a 206c 6962 666b 6f2e  ...File: libfko.
│ │ │ │ │ +00003b30: 696e 666f 2c20 204e 6f64 653a 2053 5041  info,  Node: SPA
│ │ │ │ │ +00003b40: 204d 6573 7361 6765 732c 2020 4e65 7874   Messages,  Next
│ │ │ │ │ +00003b50: 3a20 456e 6372 7970 7469 6f6e 2041 6c67  : Encryption Alg
│ │ │ │ │ +00003b60: 6f72 6974 686d 732c 2020 5072 6576 3a20  orithms,  Prev: 
│ │ │ │ │ +00003b70: 4469 6765 7374 732c 2020 5570 3a20 5350  Digests,  Up: SP
│ │ │ │ │ +00003b80: 4120 5061 7261 6d65 7465 7220 5479 7065  A Parameter Type
│ │ │ │ │ +00003b90: 730a 0a32 2e33 2e32 2053 5041 204d 6573  s..2.3.2 SPA Mes
│ │ │ │ │ +00003ba0: 7361 6765 730a 2d2d 2d2d 2d2d 2d2d 2d2d  sages.----------
│ │ │ │ │ +00003bb0: 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520 6677  --------..The fw
│ │ │ │ │ +00003bc0: 6b6e 6f70 2073 7973 7465 6d20 2861 6e64  knop system (and
│ │ │ │ │ +00003bd0: 2073 7562 7365 7175 656e 746c 7920 6c69   subsequently li
│ │ │ │ │ +00003be0: 6266 6b6f 292c 2073 7570 706f 7274 2061  bfko), support a
│ │ │ │ │ +00003bf0: 2073 7065 6369 6669 6320 7365 7420 6f66   specific set of
│ │ │ │ │ +00003c00: 0a6d 6573 7361 6765 2074 7970 6573 2e20  .message types. 
│ │ │ │ │ +00003c10: 2054 6865 206d 6573 7361 6765 2074 7970   The message typ
│ │ │ │ │ +00003c20: 6520 7661 6c75 6520 6973 2075 7365 6420  e value is used 
│ │ │ │ │ +00003c30: 6279 2066 776b 6e6f 7020 746f 2068 656c  by fwknop to hel
│ │ │ │ │ +00003c40: 700a 6465 7465 726d 696e 6520 7468 6520  p.determine the 
│ │ │ │ │ +00003c50: 636f 7272 6563 7420 6d65 7373 6167 6520  correct message 
│ │ │ │ │ +00003c60: 666f 726d 6174 2061 6e64 2063 6f6e 7465  format and conte
│ │ │ │ │ +00003c70: 6e74 2e20 2054 6865 7365 206d 6573 7361  nt.  These messa
│ │ │ │ │ +00003c80: 6765 2074 7970 6573 0a61 7265 3a0a 0a20  ge types.are:.. 
│ │ │ │ │ +00003c90: 2d2d 2056 6172 6961 626c 653a 2069 6e74  -- Variable: int
│ │ │ │ │ +00003ca0: 2066 6b6f 5f6d 6573 7361 6765 5f74 7970   fko_message_typ
│ │ │ │ │ +00003cb0: 655f 740a 2020 2020 2027 464b 4f5f 434f  e_t.     'FKO_CO
│ │ │ │ │ +00003cc0: 4d4d 414e 445f 4d53 4727 0a20 2020 2020  MMAND_MSG'.     
│ │ │ │ │ +00003cd0: 2020 2020 2041 2072 6571 7565 7374 2074       A request t
│ │ │ │ │ +00003ce0: 6f20 6861 7665 2074 6865 2066 776b 6e6f  o have the fwkno
│ │ │ │ │ +00003cf0: 7020 7365 7276 6572 2065 7865 6375 7465  p server execute
│ │ │ │ │ +00003d00: 2074 6865 2067 6976 656e 2063 6f6d 6d61   the given comma
│ │ │ │ │ +00003d10: 6e64 2e0a 2020 2020 2020 2020 2020 5468  nd..          Th
│ │ │ │ │ +00003d20: 6520 666f 726d 6174 2066 6f72 2074 6869  e format for thi
│ │ │ │ │ +00003d30: 7320 7479 7065 2069 733a 2027 3c69 7020  s type is: '<ip 
│ │ │ │ │ +00003d40: 6f66 2072 6571 7565 7374 6f72 3e2c 3c63  of requestor>,<c
│ │ │ │ │ +00003d50: 6f6d 6d61 6e64 0a20 2020 2020 2020 2020  ommand.         
│ │ │ │ │ +00003d60: 2074 6578 743e 272e 0a20 2020 2020 2020   text>'..       
│ │ │ │ │ +00003d70: 2020 2020 2020 2020 2231 3932 2e31 3638          "192.168
│ │ │ │ │ +00003d80: 2e31 2e32 2c75 6e61 6d65 202d 6122 0a0a  .1.2,uname -a"..
│ │ │ │ │ +00003d90: 2020 2020 2027 464b 4f5f 4143 4345 5353       'FKO_ACCESS
│ │ │ │ │ +00003da0: 5f4d 5347 270a 2020 2020 2020 2020 2020  _MSG'.          
│ │ │ │ │ +00003db0: 4120 6261 7369 6320 6163 6365 7373 2072  A basic access r
│ │ │ │ │ +00003dc0: 6571 7565 7374 2e20 2054 6869 7320 6973  equest.  This is
│ │ │ │ │ +00003dd0: 2074 6865 206d 6f73 7420 636f 6d6d 6f6e   the most common
│ │ │ │ │ +00003de0: 2074 7970 6520 696e 2075 7365 2e0a 2020   type in use..  
│ │ │ │ │ +00003df0: 2020 2020 2020 2020 5468 6520 666f 726d          The form
│ │ │ │ │ +00003e00: 6174 2066 6f72 2074 6869 7320 7479 7065  at for this type
│ │ │ │ │ +00003e10: 2069 733a 2027 3c69 7020 6f66 0a20 2020   is: '<ip of.   
│ │ │ │ │ +00003e20: 2020 2020 2020 2072 6571 7565 7374 6f72         requestor
│ │ │ │ │ +00003e30: 3e2c 3c70 726f 746f 636f 6c3e 2f3c 706f  >,<protocol>/<po
│ │ │ │ │ +00003e40: 7274 3e27 2e20 204e 6f74 6520 7468 6174  rt>'.  Note that
│ │ │ │ │ +00003e50: 206d 756c 7469 706c 650a 2020 2020 2020   multiple.      
│ │ │ │ │ +00003e60: 2020 2020 7072 6f74 6f63 6f6c 2f70 6f72      protocol/por
│ │ │ │ │ +00003e70: 7420 656e 7472 6965 7320 6172 6520 616c  t entries are al
│ │ │ │ │ +00003e80: 6c6f 7765 642e 0a20 2020 2020 2020 2020  lowed..         
│ │ │ │ │ +00003e90: 2020 2020 2020 2231 3932 2e31 3638 2e31        "192.168.1
│ │ │ │ │ +00003ea0: 2e32 2c74 6370 2f32 3222 0a20 2020 2020  .2,tcp/22".     
│ │ │ │ │ +00003eb0: 2020 2020 2020 2020 2020 2231 3932 2e31            "192.1
│ │ │ │ │ +00003ec0: 3638 2e31 2e32 2c74 6370 2f32 322c 7564  68.1.2,tcp/22,ud
│ │ │ │ │ +00003ed0: 702f 3530 3035 220a 0a20 2020 2020 2746  p/5005"..     'F
│ │ │ │ │ +00003ee0: 4b4f 5f4e 4154 5f41 4343 4553 535f 4d53  KO_NAT_ACCESS_MS
│ │ │ │ │ +00003ef0: 4727 0a20 2020 2020 2020 2020 2041 6e20  G'.          An 
│ │ │ │ │ +00003f00: 6163 6365 7373 2072 6571 7565 7374 2074  access request t
│ │ │ │ │ +00003f10: 6861 7420 616c 736f 2070 726f 7669 6465  hat also provide
│ │ │ │ │ +00003f20: 2069 6e66 6f72 6d61 7469 6f6e 2066 6f72   information for
│ │ │ │ │ +00003f30: 2074 6865 2066 776b 6e6f 700a 2020 2020   the fwknop.    
│ │ │ │ │ +00003f40: 2020 2020 2020 7365 7276 6572 2074 6f20        server to 
│ │ │ │ │ +00003f50: 6372 6561 7465 2061 204e 6574 776f 726b  create a Network
│ │ │ │ │ +00003f60: 2041 6464 7265 7373 2054 7261 6e73 6c61   Address Transla
│ │ │ │ │ +00003f70: 7469 6f6e 2028 4e41 5420 746f 2061 6e0a  tion (NAT to an.
│ │ │ │ │ +00003f80: 2020 2020 2020 2020 2020 696e 7465 726e            intern
│ │ │ │ │ +00003f90: 616c 2061 6464 7265 7373 2e20 2054 6865  al address.  The
│ │ │ │ │ +00003fa0: 2066 6f72 6d61 7420 666f 7220 7468 6973   format for this
│ │ │ │ │ +00003fb0: 2073 7472 696e 6720 6973 3a20 273c 696e   string is: '<in
│ │ │ │ │ +00003fc0: 7465 726e 616c 0a20 2020 2020 2020 2020  ternal.         
│ │ │ │ │ +00003fd0: 2069 703e 2c3c 6578 7420 6e61 7420 706f   ip>,<ext nat po
│ │ │ │ │ +00003fe0: 7274 3e27 2e0a 2020 2020 2020 2020 2020  rt>'..          
│ │ │ │ │ +00003ff0: 2020 2020 2022 3130 2e31 302e 312e 322c       "10.10.1.2,
│ │ │ │ │ +00004000: 3939 3232 220a 0a20 2020 2020 2746 4b4f  9922"..     'FKO
│ │ │ │ │ +00004010: 5f43 4c49 454e 545f 5449 4d45 4f55 545f  _CLIENT_TIMEOUT_
│ │ │ │ │ +00004020: 4143 4345 5353 5f4d 5347 270a 2020 2020  ACCESS_MSG'.    
│ │ │ │ │ +00004030: 2020 2020 2020 5468 6973 2069 7320 616e        This is an
│ │ │ │ │ +00004040: 2046 4b4f 5f41 4343 4553 535f 5245 5155   FKO_ACCESS_REQU
│ │ │ │ │ +00004050: 4553 5420 7769 7468 2061 2074 696d 656f  EST with a timeo
│ │ │ │ │ +00004060: 7574 2070 6172 616d 6574 6572 2066 6f72  ut parameter for
│ │ │ │ │ +00004070: 2074 6865 0a20 2020 2020 2020 2020 2066   the.          f
│ │ │ │ │ +00004080: 776b 6e6f 7020 7365 7276 6572 2e20 2054  wknop server.  T
│ │ │ │ │ +00004090: 6865 2074 696d 656f 7574 2076 616c 7565  he timeout value
│ │ │ │ │ +000040a0: 2069 7320 7072 6f76 6964 6564 2076 6961   is provided via
│ │ │ │ │ +000040b0: 2074 6865 0a20 2020 2020 2020 2020 2027   the.          '
│ │ │ │ │ +000040c0: 636c 6965 6e74 5f74 696d 656f 7574 2720  client_timeout' 
│ │ │ │ │ +000040d0: 6461 7461 2066 6965 6c64 2e0a 0a20 2020  data field...   
│ │ │ │ │ +000040e0: 2020 2746 4b4f 5f43 4c49 454e 545f 5449    'FKO_CLIENT_TI
│ │ │ │ │ +000040f0: 4d45 4f55 545f 4e41 545f 4143 4345 5353  MEOUT_NAT_ACCESS
│ │ │ │ │ +00004100: 5f4d 5347 270a 2020 2020 2020 2020 2020  _MSG'.          
│ │ │ │ │ +00004110: 5468 6973 2069 7320 616e 2046 4b4f 5f4e  This is an FKO_N
│ │ │ │ │ +00004120: 4154 5f41 4343 4553 535f 5245 5155 4553  AT_ACCESS_REQUES
│ │ │ │ │ +00004130: 5420 7769 7468 2061 2074 696d 656f 7574  T with a timeout
│ │ │ │ │ +00004140: 2070 6172 616d 6574 6572 2066 6f72 0a20   parameter for. 
│ │ │ │ │ +00004150: 2020 2020 2020 2020 2074 6865 2066 776b           the fwk
│ │ │ │ │ +00004160: 6e6f 7020 7365 7276 6572 2e20 2054 6865  nop server.  The
│ │ │ │ │ +00004170: 2074 696d 656f 7574 2076 616c 7565 2069   timeout value i
│ │ │ │ │ +00004180: 7320 7072 6f76 6964 6564 2076 6961 2074  s provided via t
│ │ │ │ │ +00004190: 6865 0a20 2020 2020 2020 2020 2027 636c  he.          'cl
│ │ │ │ │ +000041a0: 6965 6e74 5f74 696d 656f 7574 2720 6461  ient_timeout' da
│ │ │ │ │ +000041b0: 7461 2066 6965 6c64 2e0a 0a20 2020 2020  ta field...     
│ │ │ │ │ +000041c0: 2746 4b4f 5f4c 4f43 414c 5f4e 4154 5f41  'FKO_LOCAL_NAT_A
│ │ │ │ │ +000041d0: 4343 4553 535f 4d53 4727 0a20 2020 2020  CCESS_MSG'.     
│ │ │ │ │ +000041e0: 2020 2020 2054 6869 7320 6973 2073 696d       This is sim
│ │ │ │ │ +000041f0: 696c 6172 2074 6f20 7468 6520 464b 4f5f  ilar to the FKO_
│ │ │ │ │ +00004200: 4e41 545f 4143 4345 5353 2072 6571 7565  NAT_ACCESS reque
│ │ │ │ │ +00004210: 7374 2065 7863 6570 7420 7468 6520 4e41  st except the NA
│ │ │ │ │ +00004220: 540a 2020 2020 2020 2020 2020 6973 2074  T.          is t
│ │ │ │ │ +00004230: 6f20 7468 6520 6c6f 6361 6c20 746f 2074  o the local to t
│ │ │ │ │ +00004240: 6865 2073 6572 7665 7220 2869 2e65 2e20  he server (i.e. 
│ │ │ │ │ +00004250: 2061 2073 6572 7669 6365 206c 6973 7465   a service liste
│ │ │ │ │ +00004260: 6e69 6e67 206f 6e0a 2020 2020 2020 2020  ning on.        
│ │ │ │ │ +00004270: 2020 3132 372e 302e 302e 3129 2e0a 0a20    127.0.0.1)... 
│ │ │ │ │ +00004280: 2020 2020 2746 4b4f 5f43 4c49 454e 545f      'FKO_CLIENT_
│ │ │ │ │ +00004290: 5449 4d45 4f55 545f 4c4f 4341 4c5f 4e41  TIMEOUT_LOCAL_NA
│ │ │ │ │ +000042a0: 545f 4143 4345 5353 5f4d 5347 270a 2020  T_ACCESS_MSG'.  
│ │ │ │ │ +000042b0: 2020 2020 2020 2020 5468 6973 2069 7320          This is 
│ │ │ │ │ +000042c0: 616e 2046 4b4f 5f4c 4f43 414c 5f4e 4154  an FKO_LOCAL_NAT
│ │ │ │ │ +000042d0: 5f41 4343 4553 535f 5245 5155 4553 5420  _ACCESS_REQUEST 
│ │ │ │ │ +000042e0: 7769 7468 2061 2074 696d 656f 7574 0a20  with a timeout. 
│ │ │ │ │ +000042f0: 2020 2020 2020 2020 2070 6172 616d 6574           paramet
│ │ │ │ │ +00004300: 6572 2066 6f72 2074 6865 2066 776b 6e6f  er for the fwkno
│ │ │ │ │ +00004310: 7020 7365 7276 6572 2e20 2054 6865 2074  p server.  The t
│ │ │ │ │ +00004320: 696d 656f 7574 2076 616c 7565 2069 730a  imeout value is.
│ │ │ │ │ +00004330: 2020 2020 2020 2020 2020 7072 6f76 6964            provid
│ │ │ │ │ +00004340: 6564 2076 6961 2074 6865 2027 636c 6965  ed via the 'clie
│ │ │ │ │ +00004350: 6e74 5f74 696d 656f 7574 2720 6461 7461  nt_timeout' data
│ │ │ │ │ +00004360: 2066 6965 6c64 2e0a 0a1f 0a46 696c 653a   field.....File:
│ │ │ │ │ +00004370: 206c 6962 666b 6f2e 696e 666f 2c20 204e   libfko.info,  N
│ │ │ │ │ +00004380: 6f64 653a 2045 6e63 7279 7074 696f 6e20  ode: Encryption 
│ │ │ │ │ +00004390: 416c 676f 7269 7468 6d73 2c20 204e 6578  Algorithms,  Nex
│ │ │ │ │ +000043a0: 743a 2048 4d41 4320 4469 6765 7374 732c  t: HMAC Digests,
│ │ │ │ │ +000043b0: 2020 5072 6576 3a20 5350 4120 4d65 7373    Prev: SPA Mess
│ │ │ │ │ +000043c0: 6167 6573 2c20 2055 703a 2053 5041 2050  ages,  Up: SPA P
│ │ │ │ │ +000043d0: 6172 616d 6574 6572 2054 7970 6573 0a0a  arameter Types..
│ │ │ │ │ +000043e0: 322e 332e 3320 456e 6372 7970 7469 6f6e  2.3.3 Encryption
│ │ │ │ │ +000043f0: 2041 6c67 6f72 6974 686d 730a 2d2d 2d2d   Algorithms.----
│ │ │ │ │  00004400: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ │ -00004410: 2d2d 2d2d 2d2d 2d2d 2d0a 0a4f 6e65 206f  ---------..One o
│ │ │ │ │ -00004420: 6620 7468 6520 6669 6e61 6c20 7374 6570  f the final step
│ │ │ │ │ -00004430: 7320 2862 6566 6f72 6520 7468 6520 484d  s (before the HM
│ │ │ │ │ -00004440: 4143 2069 7320 6361 6c63 756c 6174 6564  AC is calculated
│ │ │ │ │ -00004450: 2061 6e64 2061 7070 6c69 6564 2920 696e   and applied) in
│ │ │ │ │ -00004460: 0a63 7265 6174 696e 6720 616e 2066 776b  .creating an fwk
│ │ │ │ │ -00004470: 6e6f 7020 5350 4120 6d65 7373 6167 6520  nop SPA message 
│ │ │ │ │ -00004480: 6973 2065 6e63 7279 7074 696e 6720 7468  is encrypting th
│ │ │ │ │ -00004490: 6520 656e 7469 7265 206d 6573 7361 6765  e entire message
│ │ │ │ │ -000044a0: 2e0a 4375 7272 656e 746c 792c 2066 776b  ..Currently, fwk
│ │ │ │ │ -000044b0: 6e6f 7020 7375 7070 6f72 7473 2074 776f  nop supports two
│ │ │ │ │ -000044c0: 206d 6574 686f 6473 206f 6620 656e 6372   methods of encr
│ │ │ │ │ -000044d0: 7970 7469 6f6e 3a0a 0a20 2d2d 2056 6172  yption:.. -- Var
│ │ │ │ │ -000044e0: 6961 626c 653a 2069 6e74 2066 6b6f 5f65  iable: int fko_e
│ │ │ │ │ -000044f0: 6e63 7279 7074 696f 6e5f 7479 7065 5f74  ncryption_type_t
│ │ │ │ │ -00004500: 0a20 2020 2020 2746 4b4f 5f45 4e43 5259  .     'FKO_ENCRY
│ │ │ │ │ -00004510: 5054 494f 4e5f 5249 4a4e 4441 454c 2028  PTION_RIJNDAEL (
│ │ │ │ │ -00004520: 6465 6661 756c 7429 270a 2020 2020 2027  default)'.     '
│ │ │ │ │ -00004530: 464b 4f5f 454e 4352 5950 5449 4f4e 5f47  FKO_ENCRYPTION_G
│ │ │ │ │ -00004540: 5047 270a 0a20 2020 4173 2069 6e64 6963  PG'..   As indic
│ │ │ │ │ -00004550: 6174 6564 2c20 6c69 6266 6b6f 2075 7365  ated, libfko use
│ │ │ │ │ -00004560: 7320 5269 6a6e 6461 656c 2065 6e63 7279  s Rijndael encry
│ │ │ │ │ -00004570: 7074 696f 6e20 6279 2064 6566 6175 6c74  ption by default
│ │ │ │ │ -00004580: 2e20 2052 696a 6e64 6165 6c0a 656e 6372  .  Rijndael.encr
│ │ │ │ │ -00004590: 7970 7469 6f6e 2069 7320 7375 6666 6963  yption is suffic
│ │ │ │ │ -000045a0: 6965 6e74 2066 6f72 206d 6f73 7420 7573  ient for most us
│ │ │ │ │ -000045b0: 6572 7320 616e 6420 7072 6f64 7563 6573  ers and produces
│ │ │ │ │ -000045c0: 2061 206d 7563 6820 736d 616c 6c65 7220   a much smaller 
│ │ │ │ │ -000045d0: 6461 7461 0a70 6163 6b65 7420 7468 616e  data.packet than
│ │ │ │ │ -000045e0: 2047 5047 2028 6265 7477 6565 6e20 3134   GPG (between 14
│ │ │ │ │ -000045f0: 3020 6279 7465 7320 7769 7468 204d 4435  0 bytes with MD5
│ │ │ │ │ -00004600: 2064 6967 6573 7420 746f 2061 726f 756e   digest to aroun
│ │ │ │ │ -00004610: 6420 3232 3520 6279 7465 730a 6f72 2073  d 225 bytes.or s
│ │ │ │ │ -00004620: 6f20 7769 7468 2053 4841 3531 322c 2063  o with SHA512, c
│ │ │ │ │ -00004630: 6f6d 7061 7265 6420 746f 2061 726f 756e  ompared to aroun
│ │ │ │ │ -00004640: 6420 3131 3030 2066 6f72 2073 6967 6e65  d 1100 for signe
│ │ │ │ │ -00004650: 6420 4750 4729 2e20 2057 6865 6e0a 5269  d GPG).  When.Ri
│ │ │ │ │ -00004660: 6a6e 6461 656c 2069 7320 7573 6564 2c20  jndael is used, 
│ │ │ │ │ -00004670: 7468 6520 656e 6372 7970 7469 6f6e 206b  the encryption k
│ │ │ │ │ -00004680: 6579 2069 7473 656c 6620 6973 2064 6572  ey itself is der
│ │ │ │ │ -00004690: 6976 6564 2066 726f 6d20 7468 6520 7375  ived from the su
│ │ │ │ │ -000046a0: 7070 6c69 6564 0a70 6173 7370 6872 6173  pplied.passphras
│ │ │ │ │ -000046b0: 6520 7669 6120 7468 6520 5042 4b44 4631  e via the PBKDF1
│ │ │ │ │ -000046c0: 2061 6c67 6f72 6974 686d 2c20 616e 6420   algorithm, and 
│ │ │ │ │ -000046d0: 4342 4320 6d6f 6465 2069 7320 7365 742e  CBC mode is set.
│ │ │ │ │ -000046e0: 0a0a 2020 2048 6f77 6576 6572 2c20 736f  ..   However, so
│ │ │ │ │ -000046f0: 6d65 206d 6179 2070 7265 6665 7220 7468  me may prefer th
│ │ │ │ │ -00004700: 6520 6869 6768 6572 206c 6576 656c 206f  e higher level o
│ │ │ │ │ -00004710: 6620 7365 6375 7269 7479 2070 726f 7669  f security provi
│ │ │ │ │ -00004720: 6465 6420 6279 0a47 5047 2e20 2057 6865  ded by.GPG.  Whe
│ │ │ │ │ -00004730: 6e20 7365 6c65 6374 6564 2c20 6164 6469  n selected, addi
│ │ │ │ │ -00004740: 7469 6f6e 616c 2070 6172 616d 6574 6572  tional parameter
│ │ │ │ │ -00004750: 7320 7375 6368 2061 7320 5f72 6563 6970  s such as _recip
│ │ │ │ │ -00004760: 6965 6e74 5f20 616e 640a 5f73 6967 6e65  ient_ and._signe
│ │ │ │ │ -00004770: 725f 206d 6179 2062 6520 7365 7420 6173  r_ may be set as
│ │ │ │ │ -00004780: 2077 656c 6c2e 2020 5365 6520 2a6e 6f74   well.  See *not
│ │ │ │ │ -00004790: 6520 5365 7474 696e 6720 5350 4120 4461  e Setting SPA Da
│ │ │ │ │ -000047a0: 7461 3a3a 2066 6f72 2064 6574 6169 6c20  ta:: for detail 
│ │ │ │ │ -000047b0: 6f6e 0a73 6574 7469 6e67 2074 6865 7365  on.setting these
│ │ │ │ │ -000047c0: 2061 6e64 206f 7468 6572 2053 5041 2064   and other SPA d
│ │ │ │ │ -000047d0: 6174 6120 6669 656c 6473 2e0a 0a1f 0a46  ata fields.....F
│ │ │ │ │ -000047e0: 696c 653a 206c 6962 666b 6f2e 696e 666f  ile: libfko.info
│ │ │ │ │ -000047f0: 2c20 204e 6f64 653a 2048 4d41 4320 4469  ,  Node: HMAC Di
│ │ │ │ │ -00004800: 6765 7374 732c 2020 5072 6576 3a20 456e  gests,  Prev: En
│ │ │ │ │ -00004810: 6372 7970 7469 6f6e 2041 6c67 6f72 6974  cryption Algorit
│ │ │ │ │ -00004820: 686d 732c 2020 5570 3a20 5350 4120 5061  hms,  Up: SPA Pa
│ │ │ │ │ -00004830: 7261 6d65 7465 7220 5479 7065 730a 0a32  rameter Types..2
│ │ │ │ │ -00004840: 2e33 2e34 2048 4d41 4320 4469 6765 7374  .3.4 HMAC Digest
│ │ │ │ │ -00004850: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  s.--------------
│ │ │ │ │ -00004860: 2d2d 2d2d 0a0a 5468 6520 6677 6b6e 6f70  ----..The fwknop
│ │ │ │ │ -00004870: 2070 726f 6a65 6374 2065 6d70 6c6f 7973   project employs
│ │ │ │ │ -00004880: 2061 6e20 484d 4143 2069 6e20 7468 6520   an HMAC in the 
│ │ │ │ │ -00004890: 656e 6372 7970 742d 7468 656e 2d61 7574  encrypt-then-aut
│ │ │ │ │ -000048a0: 6865 6e74 6963 6174 650a 6d6f 6465 6c20  henticate.model 
│ │ │ │ │ -000048b0: 666f 7220 7374 726f 6e67 2053 5041 206d  for strong SPA m
│ │ │ │ │ -000048c0: 6573 7361 6765 2061 7574 6865 6e74 6963  essage authentic
│ │ │ │ │ -000048d0: 6174 696f 6e2e 2020 5468 6520 484d 4143  ation.  The HMAC
│ │ │ │ │ -000048e0: 2069 7473 656c 6620 6973 2064 6572 6976   itself is deriv
│ │ │ │ │ -000048f0: 6564 0a66 726f 6d20 6120 6469 6765 7374  ed.from a digest
│ │ │ │ │ -00004900: 206f 6620 7468 6520 656e 6372 7970 7465   of the encrypte
│ │ │ │ │ -00004910: 6420 5350 4120 6d65 7373 6167 6520 616c  d SPA message al
│ │ │ │ │ -00004920: 6f6e 6720 7769 7468 2061 2064 6564 6963  ong with a dedic
│ │ │ │ │ -00004930: 6174 6564 2048 4d41 430a 6b65 792e 0a0a  ated HMAC.key...
│ │ │ │ │ -00004940: 2020 2043 7572 7265 6e74 6c79 2c20 6c69     Currently, li
│ │ │ │ │ -00004950: 6266 6b6f 2073 7570 706f 7274 7320 7468  bfko supports th
│ │ │ │ │ -00004960: 6520 7361 6d65 206d 6573 7361 6765 2064  e same message d
│ │ │ │ │ -00004970: 6967 6573 7473 2061 7320 6d65 6e74 696f  igests as mentio
│ │ │ │ │ -00004980: 6e65 6420 696e 0a74 6865 2044 6967 6573  ned in.the Diges
│ │ │ │ │ -00004990: 7420 7365 6374 696f 6e20 6162 6f76 652c  t section above,
│ │ │ │ │ -000049a0: 2061 6e64 2074 6865 7365 2061 7265 2028   and these are (
│ │ │ │ │ -000049b0: 696e 206f 7264 6572 206f 6620 7374 7265  in order of stre
│ │ │ │ │ -000049c0: 6e67 7468 293a 0a0a 202d 2d20 5661 7269  ngth):.. -- Vari
│ │ │ │ │ -000049d0: 6162 6c65 3a20 696e 7420 666b 6f5f 6469  able: int fko_di
│ │ │ │ │ -000049e0: 6765 7374 5f74 7970 655f 740a 2020 2020  gest_type_t.    
│ │ │ │ │ -000049f0: 2027 464b 4f5f 484d 4143 5f4d 4435 270a   'FKO_HMAC_MD5'.
│ │ │ │ │ -00004a00: 2020 2020 2027 464b 4f5f 484d 4143 5f53       'FKO_HMAC_S
│ │ │ │ │ -00004a10: 4841 3127 0a20 2020 2020 2746 4b4f 5f48  HA1'.     'FKO_H
│ │ │ │ │ -00004a20: 4d41 435f 5348 4132 3536 2028 6c69 6266  MAC_SHA256 (libf
│ │ │ │ │ -00004a30: 6b6f 2064 6566 6175 6c74 2927 0a20 2020  ko default)'.   
│ │ │ │ │ -00004a40: 2020 2746 4b4f 5f48 4d41 435f 5348 4133    'FKO_HMAC_SHA3
│ │ │ │ │ -00004a50: 3834 270a 2020 2020 2027 464b 4f5f 484d  84'.     'FKO_HM
│ │ │ │ │ -00004a60: 4143 5f53 4841 3531 3227 0a0a 2020 2041  AC_SHA512'..   A
│ │ │ │ │ -00004a70: 7320 696e 6469 6361 7465 6420 696e 2074  s indicated in t
│ │ │ │ │ -00004a80: 6865 206c 6973 7420 6162 6f76 652c 2053  he list above, S
│ │ │ │ │ -00004a90: 4841 3235 3620 6973 2074 6865 2064 6566  HA256 is the def
│ │ │ │ │ -00004aa0: 6175 6c74 2e20 2054 6869 7320 6d65 616e  ault.  This mean
│ │ │ │ │ -00004ab0: 730a 7468 6520 484d 4143 2064 6967 6573  s.the HMAC diges
│ │ │ │ │ -00004ac0: 7420 7479 7065 2064 6f65 7320 6e6f 7420  t type does not 
│ │ │ │ │ -00004ad0: 6e65 6564 2074 6f20 6265 2065 7870 6c69  need to be expli
│ │ │ │ │ -00004ae0: 6369 746c 7920 7365 7420 756e 6c65 7373  citly set unless
│ │ │ │ │ -00004af0: 2079 6f75 2077 6973 680a 746f 2075 7365   you wish.to use
│ │ │ │ │ -00004b00: 206f 6e65 206f 6620 7468 6520 6f74 6865   one of the othe
│ │ │ │ │ -00004b10: 7220 7661 6c75 6573 2e20 2054 6869 7320  r values.  This 
│ │ │ │ │ -00004b20: 6170 706c 6965 7320 746f 2061 6c6c 206c  applies to all l
│ │ │ │ │ -00004b30: 6962 666b 6f20 5350 4120 6461 7461 0a66  ibfko SPA data.f
│ │ │ │ │ -00004b40: 6965 6c64 7320 7468 6174 2068 6176 6520  ields that have 
│ │ │ │ │ -00004b50: 6120 6465 6661 756c 7420 7661 6c75 652e  a default value.
│ │ │ │ │ -00004b60: 0a0a 1f0a 4669 6c65 3a20 6c69 6266 6b6f  ....File: libfko
│ │ │ │ │ -00004b70: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5573  .info,  Node: Us
│ │ │ │ │ -00004b80: 696e 6720 6c69 6266 6b6f 2c20 204e 6578  ing libfko,  Nex
│ │ │ │ │ -00004b90: 743a 204c 6962 7261 7279 2043 6f70 7969  t: Library Copyi
│ │ │ │ │ -00004ba0: 6e67 2c20 2050 7265 763a 2050 7265 7061  ng,  Prev: Prepa
│ │ │ │ │ -00004bb0: 7261 7469 6f6e 2c20 2055 703a 2054 6f70  ration,  Up: Top
│ │ │ │ │ -00004bc0: 0a0a 3320 5573 696e 6720 6c69 6266 6b6f  ..3 Using libfko
│ │ │ │ │ -00004bd0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a  .**************.
│ │ │ │ │ -00004be0: 0a54 6869 7320 6368 6170 7465 7220 7072  .This chapter pr
│ │ │ │ │ -00004bf0: 6f76 6964 6573 2074 6865 2022 686f 7774  ovides the "howt
│ │ │ │ │ -00004c00: 6f22 2066 6f72 2075 7369 6e67 206c 6962  o" for using lib
│ │ │ │ │ -00004c10: 666b 6f2c 2069 6e63 6c75 6469 6e67 2072  fko, including r
│ │ │ │ │ -00004c20: 6571 7569 7265 640a 6675 6e63 7469 6f6e  equired.function
│ │ │ │ │ -00004c30: 7320 616e 6420 7061 7261 6d65 7465 7220  s and parameter 
│ │ │ │ │ -00004c40: 6368 6f69 6365 732e 2020 496e 2073 6f6d  choices.  In som
│ │ │ │ │ -00004c50: 6520 7365 6374 696f 6e73 2c20 636f 6465  e sections, code
│ │ │ │ │ -00004c60: 2073 616d 706c 6573 2061 7265 0a70 726f   samples are.pro
│ │ │ │ │ -00004c70: 7669 6465 6420 746f 2066 7572 7468 6572  vided to further
│ │ │ │ │ -00004c80: 2069 6c6c 7573 7472 6174 6520 7573 6167   illustrate usag
│ │ │ │ │ -00004c90: 652e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2043  e...* Menu:..* C
│ │ │ │ │ -00004ca0: 7265 6174 696e 6720 436f 6e74 6578 7473  reating Contexts
│ │ │ │ │ -00004cb0: 3a3a 2020 2020 2020 2020 2020 2020 2043  ::             C
│ │ │ │ │ -00004cc0: 7265 6174 696e 6720 6120 6e65 7720 666b  reating a new fk
│ │ │ │ │ -00004cd0: 6f20 636f 6e74 6578 740a 2a20 4465 7374  o context.* Dest
│ │ │ │ │ -00004ce0: 726f 7969 6e67 2043 6f6e 7465 7874 733a  roying Contexts:
│ │ │ │ │ -00004cf0: 3a20 2020 2020 2020 2020 2020 5265 6c65  :           Rele
│ │ │ │ │ -00004d00: 6173 696e 6720 616e 2066 6b6f 2063 6f6e  asing an fko con
│ │ │ │ │ -00004d10: 7465 7874 0a2a 2043 7265 6174 696e 6720  text.* Creating 
│ │ │ │ │ -00004d20: 6120 5350 4120 4d65 7373 6167 653a 3a20  a SPA Message:: 
│ │ │ │ │ -00004d30: 2020 2020 2020 2057 6861 7420 6974 2074         What it t
│ │ │ │ │ -00004d40: 616b 6573 2074 6f20 6372 6561 7465 2061  akes to create a
│ │ │ │ │ -00004d50: 2053 5041 0a20 2020 2020 2020 2020 2020   SPA.           
│ │ │ │ │ +00004410: 2d2d 2d2d 2d2d 2d0a 0a4f 6e65 206f 6620  -------..One of 
│ │ │ │ │ +00004420: 7468 6520 6669 6e61 6c20 7374 6570 7320  the final steps 
│ │ │ │ │ +00004430: 2862 6566 6f72 6520 7468 6520 484d 4143  (before the HMAC
│ │ │ │ │ +00004440: 2069 7320 6361 6c63 756c 6174 6564 2061   is calculated a
│ │ │ │ │ +00004450: 6e64 2061 7070 6c69 6564 2920 696e 0a63  nd applied) in.c
│ │ │ │ │ +00004460: 7265 6174 696e 6720 616e 2066 776b 6e6f  reating an fwkno
│ │ │ │ │ +00004470: 7020 5350 4120 6d65 7373 6167 6520 6973  p SPA message is
│ │ │ │ │ +00004480: 2065 6e63 7279 7074 696e 6720 7468 6520   encrypting the 
│ │ │ │ │ +00004490: 656e 7469 7265 206d 6573 7361 6765 2e0a  entire message..
│ │ │ │ │ +000044a0: 4375 7272 656e 746c 792c 2066 776b 6e6f  Currently, fwkno
│ │ │ │ │ +000044b0: 7020 7375 7070 6f72 7473 2074 776f 206d  p supports two m
│ │ │ │ │ +000044c0: 6574 686f 6473 206f 6620 656e 6372 7970  ethods of encryp
│ │ │ │ │ +000044d0: 7469 6f6e 3a0a 0a20 2d2d 2056 6172 6961  tion:.. -- Varia
│ │ │ │ │ +000044e0: 626c 653a 2069 6e74 2066 6b6f 5f65 6e63  ble: int fko_enc
│ │ │ │ │ +000044f0: 7279 7074 696f 6e5f 7479 7065 5f74 0a20  ryption_type_t. 
│ │ │ │ │ +00004500: 2020 2020 2746 4b4f 5f45 4e43 5259 5054      'FKO_ENCRYPT
│ │ │ │ │ +00004510: 494f 4e5f 5249 4a4e 4441 454c 2028 6465  ION_RIJNDAEL (de
│ │ │ │ │ +00004520: 6661 756c 7429 270a 2020 2020 2027 464b  fault)'.     'FK
│ │ │ │ │ +00004530: 4f5f 454e 4352 5950 5449 4f4e 5f47 5047  O_ENCRYPTION_GPG
│ │ │ │ │ +00004540: 270a 0a20 2020 4173 2069 6e64 6963 6174  '..   As indicat
│ │ │ │ │ +00004550: 6564 2c20 6c69 6266 6b6f 2075 7365 7320  ed, libfko uses 
│ │ │ │ │ +00004560: 5269 6a6e 6461 656c 2065 6e63 7279 7074  Rijndael encrypt
│ │ │ │ │ +00004570: 696f 6e20 6279 2064 6566 6175 6c74 2e20  ion by default. 
│ │ │ │ │ +00004580: 2052 696a 6e64 6165 6c0a 656e 6372 7970   Rijndael.encryp
│ │ │ │ │ +00004590: 7469 6f6e 2069 7320 7375 6666 6963 6965  tion is sufficie
│ │ │ │ │ +000045a0: 6e74 2066 6f72 206d 6f73 7420 7573 6572  nt for most user
│ │ │ │ │ +000045b0: 7320 616e 6420 7072 6f64 7563 6573 2061  s and produces a
│ │ │ │ │ +000045c0: 206d 7563 6820 736d 616c 6c65 7220 6461   much smaller da
│ │ │ │ │ +000045d0: 7461 0a70 6163 6b65 7420 7468 616e 2047  ta.packet than G
│ │ │ │ │ +000045e0: 5047 2028 6265 7477 6565 6e20 3134 3020  PG (between 140 
│ │ │ │ │ +000045f0: 6279 7465 7320 7769 7468 204d 4435 2064  bytes with MD5 d
│ │ │ │ │ +00004600: 6967 6573 7420 746f 2061 726f 756e 6420  igest to around 
│ │ │ │ │ +00004610: 3232 3520 6279 7465 730a 6f72 2073 6f20  225 bytes.or so 
│ │ │ │ │ +00004620: 7769 7468 2053 4841 3531 322c 2063 6f6d  with SHA512, com
│ │ │ │ │ +00004630: 7061 7265 6420 746f 2061 726f 756e 6420  pared to around 
│ │ │ │ │ +00004640: 3131 3030 2066 6f72 2073 6967 6e65 6420  1100 for signed 
│ │ │ │ │ +00004650: 4750 4729 2e20 2057 6865 6e0a 5269 6a6e  GPG).  When.Rijn
│ │ │ │ │ +00004660: 6461 656c 2069 7320 7573 6564 2c20 7468  dael is used, th
│ │ │ │ │ +00004670: 6520 656e 6372 7970 7469 6f6e 206b 6579  e encryption key
│ │ │ │ │ +00004680: 2069 7473 656c 6620 6973 2064 6572 6976   itself is deriv
│ │ │ │ │ +00004690: 6564 2066 726f 6d20 7468 6520 7375 7070  ed from the supp
│ │ │ │ │ +000046a0: 6c69 6564 0a70 6173 7370 6872 6173 6520  lied.passphrase 
│ │ │ │ │ +000046b0: 7669 6120 7468 6520 5042 4b44 4631 2061  via the PBKDF1 a
│ │ │ │ │ +000046c0: 6c67 6f72 6974 686d 2c20 616e 6420 4342  lgorithm, and CB
│ │ │ │ │ +000046d0: 4320 6d6f 6465 2069 7320 7365 742e 0a0a  C mode is set...
│ │ │ │ │ +000046e0: 2020 2048 6f77 6576 6572 2c20 736f 6d65     However, some
│ │ │ │ │ +000046f0: 206d 6179 2070 7265 6665 7220 7468 6520   may prefer the 
│ │ │ │ │ +00004700: 6869 6768 6572 206c 6576 656c 206f 6620  higher level of 
│ │ │ │ │ +00004710: 7365 6375 7269 7479 2070 726f 7669 6465  security provide
│ │ │ │ │ +00004720: 6420 6279 0a47 5047 2e20 2057 6865 6e20  d by.GPG.  When 
│ │ │ │ │ +00004730: 7365 6c65 6374 6564 2c20 6164 6469 7469  selected, additi
│ │ │ │ │ +00004740: 6f6e 616c 2070 6172 616d 6574 6572 7320  onal parameters 
│ │ │ │ │ +00004750: 7375 6368 2061 7320 5f72 6563 6970 6965  such as _recipie
│ │ │ │ │ +00004760: 6e74 5f20 616e 640a 5f73 6967 6e65 725f  nt_ and._signer_
│ │ │ │ │ +00004770: 206d 6179 2062 6520 7365 7420 6173 2077   may be set as w
│ │ │ │ │ +00004780: 656c 6c2e 2020 5365 6520 2a6e 6f74 6520  ell.  See *note 
│ │ │ │ │ +00004790: 5365 7474 696e 6720 5350 4120 4461 7461  Setting SPA Data
│ │ │ │ │ +000047a0: 3a3a 2066 6f72 2064 6574 6169 6c20 6f6e  :: for detail on
│ │ │ │ │ +000047b0: 0a73 6574 7469 6e67 2074 6865 7365 2061  .setting these a
│ │ │ │ │ +000047c0: 6e64 206f 7468 6572 2053 5041 2064 6174  nd other SPA dat
│ │ │ │ │ +000047d0: 6120 6669 656c 6473 2e0a 0a1f 0a46 696c  a fields.....Fil
│ │ │ │ │ +000047e0: 653a 206c 6962 666b 6f2e 696e 666f 2c20  e: libfko.info, 
│ │ │ │ │ +000047f0: 204e 6f64 653a 2048 4d41 4320 4469 6765   Node: HMAC Dige
│ │ │ │ │ +00004800: 7374 732c 2020 5072 6576 3a20 456e 6372  sts,  Prev: Encr
│ │ │ │ │ +00004810: 7970 7469 6f6e 2041 6c67 6f72 6974 686d  yption Algorithm
│ │ │ │ │ +00004820: 732c 2020 5570 3a20 5350 4120 5061 7261  s,  Up: SPA Para
│ │ │ │ │ +00004830: 6d65 7465 7220 5479 7065 730a 0a32 2e33  meter Types..2.3
│ │ │ │ │ +00004840: 2e34 2048 4d41 4320 4469 6765 7374 730a  .4 HMAC Digests.
│ │ │ │ │ +00004850: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ │ +00004860: 2d2d 0a0a 5468 6520 6677 6b6e 6f70 2070  --..The fwknop p
│ │ │ │ │ +00004870: 726f 6a65 6374 2065 6d70 6c6f 7973 2061  roject employs a
│ │ │ │ │ +00004880: 6e20 484d 4143 2069 6e20 7468 6520 656e  n HMAC in the en
│ │ │ │ │ +00004890: 6372 7970 742d 7468 656e 2d61 7574 6865  crypt-then-authe
│ │ │ │ │ +000048a0: 6e74 6963 6174 650a 6d6f 6465 6c20 666f  nticate.model fo
│ │ │ │ │ +000048b0: 7220 7374 726f 6e67 2053 5041 206d 6573  r strong SPA mes
│ │ │ │ │ +000048c0: 7361 6765 2061 7574 6865 6e74 6963 6174  sage authenticat
│ │ │ │ │ +000048d0: 696f 6e2e 2020 5468 6520 484d 4143 2069  ion.  The HMAC i
│ │ │ │ │ +000048e0: 7473 656c 6620 6973 2064 6572 6976 6564  tself is derived
│ │ │ │ │ +000048f0: 0a66 726f 6d20 6120 6469 6765 7374 206f  .from a digest o
│ │ │ │ │ +00004900: 6620 7468 6520 656e 6372 7970 7465 6420  f the encrypted 
│ │ │ │ │ +00004910: 5350 4120 6d65 7373 6167 6520 616c 6f6e  SPA message alon
│ │ │ │ │ +00004920: 6720 7769 7468 2061 2064 6564 6963 6174  g with a dedicat
│ │ │ │ │ +00004930: 6564 2048 4d41 430a 6b65 792e 0a0a 2020  ed HMAC.key...  
│ │ │ │ │ +00004940: 2043 7572 7265 6e74 6c79 2c20 6c69 6266   Currently, libf
│ │ │ │ │ +00004950: 6b6f 2073 7570 706f 7274 7320 7468 6520  ko supports the 
│ │ │ │ │ +00004960: 7361 6d65 206d 6573 7361 6765 2064 6967  same message dig
│ │ │ │ │ +00004970: 6573 7473 2061 7320 6d65 6e74 696f 6e65  ests as mentione
│ │ │ │ │ +00004980: 6420 696e 0a74 6865 2044 6967 6573 7420  d in.the Digest 
│ │ │ │ │ +00004990: 7365 6374 696f 6e20 6162 6f76 652c 2061  section above, a
│ │ │ │ │ +000049a0: 6e64 2074 6865 7365 2061 7265 2028 696e  nd these are (in
│ │ │ │ │ +000049b0: 206f 7264 6572 206f 6620 7374 7265 6e67   order of streng
│ │ │ │ │ +000049c0: 7468 293a 0a0a 202d 2d20 5661 7269 6162  th):.. -- Variab
│ │ │ │ │ +000049d0: 6c65 3a20 696e 7420 666b 6f5f 6469 6765  le: int fko_dige
│ │ │ │ │ +000049e0: 7374 5f74 7970 655f 740a 2020 2020 2027  st_type_t.     '
│ │ │ │ │ +000049f0: 464b 4f5f 484d 4143 5f4d 4435 270a 2020  FKO_HMAC_MD5'.  
│ │ │ │ │ +00004a00: 2020 2027 464b 4f5f 484d 4143 5f53 4841     'FKO_HMAC_SHA
│ │ │ │ │ +00004a10: 3127 0a20 2020 2020 2746 4b4f 5f48 4d41  1'.     'FKO_HMA
│ │ │ │ │ +00004a20: 435f 5348 4132 3536 2028 6c69 6266 6b6f  C_SHA256 (libfko
│ │ │ │ │ +00004a30: 2064 6566 6175 6c74 2927 0a20 2020 2020   default)'.     
│ │ │ │ │ +00004a40: 2746 4b4f 5f48 4d41 435f 5348 4133 3834  'FKO_HMAC_SHA384
│ │ │ │ │ +00004a50: 270a 2020 2020 2027 464b 4f5f 484d 4143  '.     'FKO_HMAC
│ │ │ │ │ +00004a60: 5f53 4841 3531 3227 0a0a 2020 2041 7320  _SHA512'..   As 
│ │ │ │ │ +00004a70: 696e 6469 6361 7465 6420 696e 2074 6865  indicated in the
│ │ │ │ │ +00004a80: 206c 6973 7420 6162 6f76 652c 2053 4841   list above, SHA
│ │ │ │ │ +00004a90: 3235 3620 6973 2074 6865 2064 6566 6175  256 is the defau
│ │ │ │ │ +00004aa0: 6c74 2e20 2054 6869 7320 6d65 616e 730a  lt.  This means.
│ │ │ │ │ +00004ab0: 7468 6520 484d 4143 2064 6967 6573 7420  the HMAC digest 
│ │ │ │ │ +00004ac0: 7479 7065 2064 6f65 7320 6e6f 7420 6e65  type does not ne
│ │ │ │ │ +00004ad0: 6564 2074 6f20 6265 2065 7870 6c69 6369  ed to be explici
│ │ │ │ │ +00004ae0: 746c 7920 7365 7420 756e 6c65 7373 2079  tly set unless y
│ │ │ │ │ +00004af0: 6f75 2077 6973 680a 746f 2075 7365 206f  ou wish.to use o
│ │ │ │ │ +00004b00: 6e65 206f 6620 7468 6520 6f74 6865 7220  ne of the other 
│ │ │ │ │ +00004b10: 7661 6c75 6573 2e20 2054 6869 7320 6170  values.  This ap
│ │ │ │ │ +00004b20: 706c 6965 7320 746f 2061 6c6c 206c 6962  plies to all lib
│ │ │ │ │ +00004b30: 666b 6f20 5350 4120 6461 7461 0a66 6965  fko SPA data.fie
│ │ │ │ │ +00004b40: 6c64 7320 7468 6174 2068 6176 6520 6120  lds that have a 
│ │ │ │ │ +00004b50: 6465 6661 756c 7420 7661 6c75 652e 0a0a  default value...
│ │ │ │ │ +00004b60: 1f0a 4669 6c65 3a20 6c69 6266 6b6f 2e69  ..File: libfko.i
│ │ │ │ │ +00004b70: 6e66 6f2c 2020 4e6f 6465 3a20 5573 696e  nfo,  Node: Usin
│ │ │ │ │ +00004b80: 6720 6c69 6266 6b6f 2c20 204e 6578 743a  g libfko,  Next:
│ │ │ │ │ +00004b90: 204c 6962 7261 7279 2043 6f70 7969 6e67   Library Copying
│ │ │ │ │ +00004ba0: 2c20 2050 7265 763a 2050 7265 7061 7261  ,  Prev: Prepara
│ │ │ │ │ +00004bb0: 7469 6f6e 2c20 2055 703a 2054 6f70 0a0a  tion,  Up: Top..
│ │ │ │ │ +00004bc0: 3320 5573 696e 6720 6c69 6266 6b6f 0a2a  3 Using libfko.*
│ │ │ │ │ +00004bd0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54  *************..T
│ │ │ │ │ +00004be0: 6869 7320 6368 6170 7465 7220 7072 6f76  his chapter prov
│ │ │ │ │ +00004bf0: 6964 6573 2074 6865 2022 686f 7774 6f22  ides the "howto"
│ │ │ │ │ +00004c00: 2066 6f72 2075 7369 6e67 206c 6962 666b   for using libfk
│ │ │ │ │ +00004c10: 6f2c 2069 6e63 6c75 6469 6e67 2072 6571  o, including req
│ │ │ │ │ +00004c20: 7569 7265 640a 6675 6e63 7469 6f6e 7320  uired.functions 
│ │ │ │ │ +00004c30: 616e 6420 7061 7261 6d65 7465 7220 6368  and parameter ch
│ │ │ │ │ +00004c40: 6f69 6365 732e 2020 496e 2073 6f6d 6520  oices.  In some 
│ │ │ │ │ +00004c50: 7365 6374 696f 6e73 2c20 636f 6465 2073  sections, code s
│ │ │ │ │ +00004c60: 616d 706c 6573 2061 7265 0a70 726f 7669  amples are.provi
│ │ │ │ │ +00004c70: 6465 6420 746f 2066 7572 7468 6572 2069  ded to further i
│ │ │ │ │ +00004c80: 6c6c 7573 7472 6174 6520 7573 6167 652e  llustrate usage.
│ │ │ │ │ +00004c90: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2043 7265  ..* Menu:..* Cre
│ │ │ │ │ +00004ca0: 6174 696e 6720 436f 6e74 6578 7473 3a3a  ating Contexts::
│ │ │ │ │ +00004cb0: 2020 2020 2020 2020 2020 2020 2043 7265               Cre
│ │ │ │ │ +00004cc0: 6174 696e 6720 6120 6e65 7720 666b 6f20  ating a new fko 
│ │ │ │ │ +00004cd0: 636f 6e74 6578 740a 2a20 4465 7374 726f  context.* Destro
│ │ │ │ │ +00004ce0: 7969 6e67 2043 6f6e 7465 7874 733a 3a20  ying Contexts:: 
│ │ │ │ │ +00004cf0: 2020 2020 2020 2020 2020 5265 6c65 6173            Releas
│ │ │ │ │ +00004d00: 696e 6720 616e 2066 6b6f 2063 6f6e 7465  ing an fko conte
│ │ │ │ │ +00004d10: 7874 0a2a 2043 7265 6174 696e 6720 6120  xt.* Creating a 
│ │ │ │ │ +00004d20: 5350 4120 4d65 7373 6167 653a 3a20 2020  SPA Message::   
│ │ │ │ │ +00004d30: 2020 2020 2057 6861 7420 6974 2074 616b       What it tak
│ │ │ │ │ +00004d40: 6573 2074 6f20 6372 6561 7465 2061 2053  es to create a S
│ │ │ │ │ +00004d50: 5041 0a20 2020 2020 2020 2020 2020 2020  PA.             
│ │ │ │ │  00004d60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00004d70: 2020 2020 2020 206d 6573 7361 6765 0a2a         message.*
│ │ │ │ │ -00004d80: 2053 6574 7469 6e67 2053 5041 2044 6174   Setting SPA Dat
│ │ │ │ │ -00004d90: 613a 3a20 2020 2020 2020 2020 2020 2020  a::             
│ │ │ │ │ -00004da0: 2053 6574 7469 6e67 2053 5041 2064 6174   Setting SPA dat
│ │ │ │ │ -00004db0: 610a 2a20 5265 7472 6965 7669 6e67 2053  a.* Retrieving S
│ │ │ │ │ -00004dc0: 5041 2044 6174 613a 3a20 2020 2020 2020  PA Data::       
│ │ │ │ │ -00004dd0: 2020 2020 5265 7472 6965 7669 6e67 2053      Retrieving S
│ │ │ │ │ -00004de0: 5041 2064 6174 610a 2a20 5574 696c 6974  PA data.* Utilit
│ │ │ │ │ -00004df0: 7920 4675 6e63 7469 6f6e 733a 3a20 2020  y Functions::   
│ │ │ │ │ -00004e00: 2020 2020 2020 2020 2020 4f74 6865 7220            Other 
│ │ │ │ │ -00004e10: 7574 696c 6974 792c 206d 6973 6365 6c6c  utility, miscell
│ │ │ │ │ -00004e20: 616e 656f 7573 2c20 616e 6420 7365 6c64  aneous, and seld
│ │ │ │ │ -00004e30: 6f6d 0a20 2020 2020 2020 2020 2020 2020  om.             
│ │ │ │ │ +00004d70: 2020 2020 206d 6573 7361 6765 0a2a 2053       message.* S
│ │ │ │ │ +00004d80: 6574 7469 6e67 2053 5041 2044 6174 613a  etting SPA Data:
│ │ │ │ │ +00004d90: 3a20 2020 2020 2020 2020 2020 2020 2053  :              S
│ │ │ │ │ +00004da0: 6574 7469 6e67 2053 5041 2064 6174 610a  etting SPA data.
│ │ │ │ │ +00004db0: 2a20 5265 7472 6965 7669 6e67 2053 5041  * Retrieving SPA
│ │ │ │ │ +00004dc0: 2044 6174 613a 3a20 2020 2020 2020 2020   Data::         
│ │ │ │ │ +00004dd0: 2020 5265 7472 6965 7669 6e67 2053 5041    Retrieving SPA
│ │ │ │ │ +00004de0: 2064 6174 610a 2a20 5574 696c 6974 7920   data.* Utility 
│ │ │ │ │ +00004df0: 4675 6e63 7469 6f6e 733a 3a20 2020 2020  Functions::     
│ │ │ │ │ +00004e00: 2020 2020 2020 2020 4f74 6865 7220 7574          Other ut
│ │ │ │ │ +00004e10: 696c 6974 792c 206d 6973 6365 6c6c 616e  ility, miscellan
│ │ │ │ │ +00004e20: 656f 7573 2c20 616e 6420 7365 6c64 6f6d  eous, and seldom
│ │ │ │ │ +00004e30: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ │  00004e40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00004e50: 2020 2020 2075 7365 6420 6675 6e63 7469       used functi
│ │ │ │ │ -00004e60: 6f6e 730a 2a20 4572 726f 7220 4861 6e64  ons.* Error Hand
│ │ │ │ │ -00004e70: 6c69 6e67 3a3a 2020 2020 2020 2020 2020  ling::          
│ │ │ │ │ -00004e80: 2020 2020 2020 506f 7373 6962 6c65 2065        Possible e
│ │ │ │ │ -00004e90: 7272 6f72 7320 616e 6420 7468 6569 7220  rrors and their 
│ │ │ │ │ -00004ea0: 6d65 616e 696e 670a 0a1f 0a46 696c 653a  meaning....File:
│ │ │ │ │ -00004eb0: 206c 6962 666b 6f2e 696e 666f 2c20 204e   libfko.info,  N
│ │ │ │ │ -00004ec0: 6f64 653a 2043 7265 6174 696e 6720 436f  ode: Creating Co
│ │ │ │ │ -00004ed0: 6e74 6578 7473 2c20 204e 6578 743a 2044  ntexts,  Next: D
│ │ │ │ │ -00004ee0: 6573 7472 6f79 696e 6720 436f 6e74 6578  estroying Contex
│ │ │ │ │ -00004ef0: 7473 2c20 2055 703a 2055 7369 6e67 206c  ts,  Up: Using l
│ │ │ │ │ -00004f00: 6962 666b 6f0a 0a33 2e31 2043 7265 6174  ibfko..3.1 Creat
│ │ │ │ │ -00004f10: 696e 6720 436f 6e74 6578 7473 0a3d 3d3d  ing Contexts.===
│ │ │ │ │ +00004e50: 2020 2075 7365 6420 6675 6e63 7469 6f6e     used function
│ │ │ │ │ +00004e60: 730a 2a20 4572 726f 7220 4861 6e64 6c69  s.* Error Handli
│ │ │ │ │ +00004e70: 6e67 3a3a 2020 2020 2020 2020 2020 2020  ng::            
│ │ │ │ │ +00004e80: 2020 2020 506f 7373 6962 6c65 2065 7272      Possible err
│ │ │ │ │ +00004e90: 6f72 7320 616e 6420 7468 6569 7220 6d65  ors and their me
│ │ │ │ │ +00004ea0: 616e 696e 670a 0a1f 0a46 696c 653a 206c  aning....File: l
│ │ │ │ │ +00004eb0: 6962 666b 6f2e 696e 666f 2c20 204e 6f64  ibfko.info,  Nod
│ │ │ │ │ +00004ec0: 653a 2043 7265 6174 696e 6720 436f 6e74  e: Creating Cont
│ │ │ │ │ +00004ed0: 6578 7473 2c20 204e 6578 743a 2044 6573  exts,  Next: Des
│ │ │ │ │ +00004ee0: 7472 6f79 696e 6720 436f 6e74 6578 7473  troying Contexts
│ │ │ │ │ +00004ef0: 2c20 2055 703a 2055 7369 6e67 206c 6962  ,  Up: Using lib
│ │ │ │ │ +00004f00: 666b 6f0a 0a33 2e31 2043 7265 6174 696e  fko..3.1 Creatin
│ │ │ │ │ +00004f10: 6720 436f 6e74 6578 7473 0a3d 3d3d 3d3d  g Contexts.=====
│ │ │ │ │  00004f20: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ │ -00004f30: 3d3d 0a0a 4265 666f 7265 2064 6f69 6e67  ==..Before doing
│ │ │ │ │ -00004f40: 2061 6e79 7468 696e 6720 7769 7468 206c   anything with l
│ │ │ │ │ -00004f50: 6962 666b 6f2c 2079 6f75 206e 6565 6420  ibfko, you need 
│ │ │ │ │ -00004f60: 746f 2063 7265 6174 6520 6120 636f 6e74  to create a cont
│ │ │ │ │ -00004f70: 6578 742e 2020 410a 636f 6e74 6578 7420  ext.  A.context 
│ │ │ │ │ -00004f80: 6973 2063 7265 6174 6564 2066 6f72 206f  is created for o
│ │ │ │ │ -00004f90: 6e65 206f 6620 7477 6f20 7265 6173 6f6e  ne of two reason
│ │ │ │ │ -00004fa0: 732e 2020 4f6e 6520 6973 2066 6f72 2074  s.  One is for t
│ │ │ │ │ -00004fb0: 6865 2070 7572 706f 7365 206f 660a 6275  he purpose of.bu
│ │ │ │ │ -00004fc0: 696c 6469 6e67 2061 206e 6577 2066 6b6f  ilding a new fko
│ │ │ │ │ -00004fd0: 2053 5041 206d 6573 7361 6765 2066 726f   SPA message fro
│ │ │ │ │ -00004fe0: 6d20 7363 7261 7463 6820 2874 7970 6963  m scratch (typic
│ │ │ │ │ -00004ff0: 616c 6c79 2074 6f20 6265 2070 6163 6b61  ally to be packa
│ │ │ │ │ -00005000: 6765 640a 616e 6420 7365 6e74 2074 6f20  ged.and sent to 
│ │ │ │ │ -00005010: 616e 2066 776b 6e6f 7020 7365 7276 6572  an fwknop server
│ │ │ │ │ -00005020: 2073 6f6d 6577 6865 7265 292e 2020 5468   somewhere).  Th
│ │ │ │ │ -00005030: 6520 6f74 6865 7220 776f 756c 6420 6265  e other would be
│ │ │ │ │ -00005040: 2061 2063 6f6e 7465 7874 0a66 6f72 2074   a context.for t
│ │ │ │ │ -00005050: 616b 696e 6720 616e 2065 7869 7374 696e  aking an existin
│ │ │ │ │ -00005060: 6720 5350 4120 6d65 7373 6167 6520 666f  g SPA message fo
│ │ │ │ │ -00005070: 7220 6465 636f 6469 6e67 2c20 7061 7273  r decoding, pars
│ │ │ │ │ -00005080: 696e 672c 2061 6e64 2064 6174 610a 6578  ing, and data.ex
│ │ │ │ │ -00005090: 7472 6163 7469 6f6e 2e0a 0a46 6f72 2062  traction...For b
│ │ │ │ │ -000050a0: 7569 6c64 696e 6720 6120 6e65 7720 666b  uilding a new fk
│ │ │ │ │ -000050b0: 6f20 5350 4120 6d65 7373 6167 652c 2079  o SPA message, y
│ │ │ │ │ -000050c0: 6f75 2077 696c 6c20 7573 6520 7468 6520  ou will use the 
│ │ │ │ │ -000050d0: 2766 6b6f 5f6e 6577 2720 6675 6e63 7469  'fko_new' functi
│ │ │ │ │ -000050e0: 6f6e 3a0a 0a20 2d2d 2046 756e 6374 696f  on:.. -- Functio
│ │ │ │ │ -000050f0: 6e3a 2069 6e74 2066 6b6f 5f6e 6577 2028  n: int fko_new (
│ │ │ │ │ -00005100: 666b 6f5f 6374 785f 7420 2a43 5458 290a  fko_ctx_t *CTX).
│ │ │ │ │ -00005110: 2020 2020 2054 6865 2066 756e 6374 696f       The functio
│ │ │ │ │ -00005120: 6e20 2766 6b6f 5f6e 6577 2720 7365 7473  n 'fko_new' sets
│ │ │ │ │ -00005130: 2075 7020 616e 6420 696e 6974 6961 6c69   up and initiali
│ │ │ │ │ -00005140: 7a65 7320 6120 6e65 7720 2766 6b6f 5f63  zes a new 'fko_c
│ │ │ │ │ -00005150: 7478 5f74 270a 2020 2020 206f 626a 6563  tx_t'.     objec
│ │ │ │ │ -00005160: 742c 2070 7265 2d70 6f70 756c 6174 6573  t, pre-populates
│ │ │ │ │ -00005170: 2064 6566 6175 6c74 2076 616c 7565 7320   default values 
│ │ │ │ │ -00005180: 616e 6420 7265 7475 726e 7320 6120 6861  and returns a ha
│ │ │ │ │ -00005190: 6e64 6c65 2066 6f72 2069 7420 696e 0a20  ndle for it in. 
│ │ │ │ │ -000051a0: 2020 2020 4354 582e 2020 5468 6520 6675      CTX.  The fu
│ │ │ │ │ -000051b0: 6e63 7469 6f6e 2072 6574 7572 6e73 2074  nction returns t
│ │ │ │ │ -000051c0: 6865 2065 7272 6f72 2063 6f64 6520 2746  he error code 'F
│ │ │ │ │ -000051d0: 4b4f 5f53 5543 4345 5353 2720 6966 2074  KO_SUCCESS' if t
│ │ │ │ │ -000051e0: 6865 0a20 2020 2020 636f 6e74 6578 7420  he.     context 
│ │ │ │ │ -000051f0: 7761 7320 7375 6363 6573 7366 756c 6c79  was successfully
│ │ │ │ │ -00005200: 2063 7265 6174 6564 2e20 204f 7468 6572   created.  Other
│ │ │ │ │ -00005210: 7769 7365 2061 6e20 616e 6f74 6865 7220  wise an another 
│ │ │ │ │ -00005220: 6572 726f 7220 636f 6465 0a20 2020 2020  error code.     
│ │ │ │ │ -00005230: 7769 6c6c 2062 6520 7265 7475 726e 6564  will be returned
│ │ │ │ │ -00005240: 2028 2a6e 6f74 6520 4572 726f 7220 4861   (*note Error Ha
│ │ │ │ │ -00005250: 6e64 6c69 6e67 3a3a 2066 6f72 2064 6574  ndling:: for det
│ │ │ │ │ -00005260: 6169 6c73 206f 6e20 7468 6520 7661 7269  ails on the vari
│ │ │ │ │ -00005270: 6f75 730a 2020 2020 2065 7272 6f72 2063  ous.     error c
│ │ │ │ │ -00005280: 6f64 6573 2061 6e64 2074 6865 6972 206d  odes and their m
│ │ │ │ │ -00005290: 6561 6e69 6e67 7329 2e0a 0a20 2020 2020  eanings)...     
│ │ │ │ │ -000052a0: 666b 6f5f 6374 785f 7420 2020 6374 783b  fko_ctx_t   ctx;
│ │ │ │ │ -000052b0: 0a20 2020 2020 696e 7420 2020 2020 2020  .     int       
│ │ │ │ │ -000052c0: 2020 7263 3b0a 0a20 2020 2020 7263 203d    rc;..     rc =
│ │ │ │ │ -000052d0: 2066 6b6f 5f6e 6577 2826 6374 7829 3b0a   fko_new(&ctx);.
│ │ │ │ │ -000052e0: 0a20 2020 2020 6966 2872 6320 213d 2046  .     if(rc != F
│ │ │ │ │ -000052f0: 4b4f 5f53 5543 4345 5353 290a 2020 2020  KO_SUCCESS).    
│ │ │ │ │ -00005300: 207b 0a20 2020 2020 2020 2020 6670 7269   {.         fpri
│ │ │ │ │ -00005310: 6e74 6628 7374 6465 7272 2c20 2245 7272  ntf(stderr, "Err
│ │ │ │ │ -00005320: 6f72 2025 6920 6672 6f6d 2066 6b6f 5f6e  or %i from fko_n
│ │ │ │ │ -00005330: 6577 3a20 2573 5c6e 222c 0a20 2020 2020  ew: %s\n",.     
│ │ │ │ │ -00005340: 2020 2020 2020 2020 7263 2c20 666b 6f5f          rc, fko_
│ │ │ │ │ -00005350: 6572 7273 7472 2872 6329 293b 0a20 2020  errstr(rc));.   
│ │ │ │ │ -00005360: 2020 2020 2020 6578 6974 2831 293b 0a20        exit(1);. 
│ │ │ │ │ -00005370: 2020 2020 7d0a 0a46 6f72 2061 2063 6f6e      }..For a con
│ │ │ │ │ -00005380: 7465 7874 2074 6861 7420 7769 6c6c 2062  text that will b
│ │ │ │ │ -00005390: 6520 7573 6564 2066 6f72 2072 6563 6569  e used for recei
│ │ │ │ │ -000053a0: 7669 6e67 2061 6e64 2070 6172 7369 6e67  ving and parsing
│ │ │ │ │ -000053b0: 2061 6e20 6578 6973 7469 6e67 0a53 5041   an existing.SPA
│ │ │ │ │ -000053c0: 206d 6573 7361 6765 2c20 796f 7520 7769   message, you wi
│ │ │ │ │ -000053d0: 6c6c 2075 7365 2074 6865 2027 666b 6f5f  ll use the 'fko_
│ │ │ │ │ -000053e0: 6e65 775f 7769 7468 5f64 6174 6127 2066  new_with_data' f
│ │ │ │ │ -000053f0: 756e 6374 696f 6e3a 0a0a 202d 2d20 4675  unction:.. -- Fu
│ │ │ │ │ -00005400: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_
│ │ │ │ │ -00005410: 6e65 775f 7769 7468 5f64 6174 6120 2866  new_with_data (f
│ │ │ │ │ -00005420: 6b6f 5f63 7478 5f74 202a 4354 582c 2063  ko_ctx_t *CTX, c
│ │ │ │ │ -00005430: 6f6e 7374 2063 6861 7220 2a44 4154 412c  onst char *DATA,
│ │ │ │ │ -00005440: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ │ -00005450: 2063 6861 7220 2a4b 4559 2c20 636f 6e73   char *KEY, cons
│ │ │ │ │ -00005460: 7420 6368 6172 204b 4559 5f4c 454e 2c20  t char KEY_LEN, 
│ │ │ │ │ -00005470: 696e 7420 454e 4352 5950 5449 4f4e 5f4d  int ENCRYPTION_M
│ │ │ │ │ -00005480: 4f44 452c 0a20 2020 2020 2020 2020 2063  ODE,.          c
│ │ │ │ │ -00005490: 6f6e 7374 2063 6861 7220 484d 4143 5f4b  onst char HMAC_K
│ │ │ │ │ -000054a0: 4559 2c20 636f 6e73 7420 696e 7420 484d  EY, const int HM
│ │ │ │ │ -000054b0: 4143 5f54 5950 4529 0a0a 2020 2020 2054  AC_TYPE)..     T
│ │ │ │ │ -000054c0: 6865 2066 756e 6374 696f 6e20 2766 6b6f  he function 'fko
│ │ │ │ │ -000054d0: 5f6e 6577 5f77 6974 685f 6461 7461 2720  _new_with_data' 
│ │ │ │ │ -000054e0: 7365 7473 2075 7020 616e 6420 696e 6974  sets up and init
│ │ │ │ │ -000054f0: 6961 6c69 7a65 7320 6120 6e65 770a 2020  ializes a new.  
│ │ │ │ │ -00005500: 2020 2027 666b 6f5f 6374 785f 7427 2063     'fko_ctx_t' c
│ │ │ │ │ -00005510: 6f6e 7465 7874 2c20 6275 7420 696e 7374  ontext, but inst
│ │ │ │ │ -00005520: 6561 6420 6f66 2069 6e69 7469 616c 697a  ead of initializ
│ │ │ │ │ -00005530: 696e 6720 6465 6661 756c 7420 7661 6c75  ing default valu
│ │ │ │ │ -00005540: 6573 2c20 6974 0a20 2020 2020 7374 6f72  es, it.     stor
│ │ │ │ │ -00005550: 6573 2074 6865 2065 6e63 7279 7074 6564  es the encrypted
│ │ │ │ │ -00005560: 206d 6573 7361 6765 2064 6174 6120 616e   message data an
│ │ │ │ │ -00005570: 6420 6d61 6b65 7320 6974 2072 6561 6479  d makes it ready
│ │ │ │ │ -00005580: 2066 6f72 2070 6172 7369 6e67 2e0a 2020   for parsing..  
│ │ │ │ │ -00005590: 2020 2054 6869 7320 6361 6e20 6265 2064     This can be d
│ │ │ │ │ -000055a0: 6f6e 6520 696e 206f 6e65 206f 6620 7477  one in one of tw
│ │ │ │ │ -000055b0: 6f20 7761 7973 2e20 204f 6e65 2069 7320  o ways.  One is 
│ │ │ │ │ -000055c0: 746f 2070 6173 7320 274e 554c 4c27 2066  to pass 'NULL' f
│ │ │ │ │ -000055d0: 6f72 2074 6865 0a20 2020 2020 7468 6972  or the.     thir
│ │ │ │ │ -000055e0: 6420 6172 6775 6d65 6e74 2e20 2054 6865  d argument.  The
│ │ │ │ │ -000055f0: 2063 6f6e 7465 7874 2077 696c 6c20 6265   context will be
│ │ │ │ │ -00005600: 2063 7265 6174 6564 2061 6e64 2074 6865   created and the
│ │ │ │ │ -00005610: 2064 6174 6120 7769 6c6c 2062 650a 2020   data will be.  
│ │ │ │ │ -00005620: 2020 2073 746f 7265 642c 2062 7574 206e     stored, but n
│ │ │ │ │ -00005630: 6f20 6465 6372 7970 7469 6f6e 206f 7220  o decryption or 
│ │ │ │ │ -00005640: 6465 636f 6469 6e67 2074 616b 6573 2070  decoding takes p
│ │ │ │ │ -00005650: 6c61 6365 2e20 2049 6e20 7468 6973 2063  lace.  In this c
│ │ │ │ │ -00005660: 6173 652c 0a20 2020 2020 796f 7520 7769  ase,.     you wi
│ │ │ │ │ -00005670: 6c6c 206e 6565 6420 746f 2063 616c 6c20  ll need to call 
│ │ │ │ │ -00005680: 2766 6b6f 5f64 6563 7279 7074 5f73 7061  'fko_decrypt_spa
│ │ │ │ │ -00005690: 5f64 6174 6127 2061 7420 6120 6c61 7465  _data' at a late
│ │ │ │ │ -000056a0: 7220 7469 6d65 2e20 2054 6865 0a20 2020  r time.  The.   
│ │ │ │ │ -000056b0: 2020 6f74 6865 7220 7761 7920 746f 2064    other way to d
│ │ │ │ │ -000056c0: 6f20 6974 2069 7320 746f 2073 7570 706c  o it is to suppl
│ │ │ │ │ -000056d0: 7920 7468 6520 4b45 5920 7661 6c75 6520  y the KEY value 
│ │ │ │ │ -000056e0: 2864 6563 7279 7074 696f 6e0a 2020 2020  (decryption.    
│ │ │ │ │ -000056f0: 2070 6173 7370 6872 6173 6529 2061 6e64   passphrase) and
│ │ │ │ │ -00005700: 2061 7373 6f63 6174 6564 206c 656e 6774   assocated lengt
│ │ │ │ │ -00005710: 682e 2020 496e 2074 6869 7320 6361 7365  h.  In this case
│ │ │ │ │ -00005720: 2c20 7468 6520 636f 6e74 6578 7420 6973  , the context is
│ │ │ │ │ -00005730: 0a20 2020 2020 6372 6561 7465 642c 2074  .     created, t
│ │ │ │ │ -00005740: 6865 2053 5041 2064 6174 6120 6973 2064  he SPA data is d
│ │ │ │ │ -00005750: 6563 7279 7074 6564 2c20 6465 636f 6465  ecrypted, decode
│ │ │ │ │ -00005760: 642c 2070 6172 7365 642c 2061 6e64 2073  d, parsed, and s
│ │ │ │ │ -00005770: 746f 7265 6420 696e 0a20 2020 2020 7468  tored in.     th
│ │ │ │ │ -00005780: 6520 636f 6e74 6578 7420 7265 6164 7920  e context ready 
│ │ │ │ │ -00005790: 666f 7220 7265 7472 6965 7661 6c2e 2020  for retrieval.  
│ │ │ │ │ -000057a0: 4966 2061 6e20 484d 4143 2069 7320 616c  If an HMAC is al
│ │ │ │ │ -000057b0: 736f 2064 6573 6972 6564 206f 720a 2020  so desired or.  
│ │ │ │ │ -000057c0: 2020 2072 6571 7569 7265 642c 2074 6865     required, the
│ │ │ │ │ -000057d0: 6e20 7468 6520 484d 4143 5f4b 4559 2061  n the HMAC_KEY a
│ │ │ │ │ -000057e0: 6e64 2061 7373 6f63 6961 7465 6420 6c65  nd associated le
│ │ │ │ │ -000057f0: 6e67 7468 2063 616e 2062 6520 7061 7373  ngth can be pass
│ │ │ │ │ -00005800: 6564 2069 6e2e 0a20 2020 2020 5468 6973  ed in..     This
│ │ │ │ │ -00005810: 2077 696c 6c20 6361 7573 6520 6c69 6266   will cause libf
│ │ │ │ │ -00005820: 6b6f 2074 6f20 6175 7468 656e 7469 6361  ko to authentica
│ │ │ │ │ -00005830: 7465 2074 6865 2053 5041 2064 6174 6120  te the SPA data 
│ │ │ │ │ -00005840: 6265 666f 7265 0a20 2020 2020 6465 6372  before.     decr
│ │ │ │ │ -00005850: 7970 7469 6f6e 2069 7320 6174 7465 6d70  yption is attemp
│ │ │ │ │ -00005860: 7465 642c 2061 6e64 2074 6869 7320 6973  ted, and this is
│ │ │ │ │ -00005870: 2073 7472 6f6e 676c 7920 7265 636f 6d6d   strongly recomm
│ │ │ │ │ -00005880: 656e 6465 6420 746f 2064 6f2e 0a0a 2020  ended to do...  
│ │ │ │ │ -00005890: 2020 2054 6865 2027 666b 6f5f 6e65 775f     The 'fko_new_
│ │ │ │ │ -000058a0: 7769 7468 5f64 6174 6127 2066 756e 6374  with_data' funct
│ │ │ │ │ -000058b0: 696f 6e20 7265 7475 726e 7320 7468 6520  ion returns the 
│ │ │ │ │ -000058c0: 6572 726f 7220 636f 6465 0a20 2020 2020  error code.     
│ │ │ │ │ -000058d0: 2746 4b4f 5f53 5543 4345 5353 2720 6966  'FKO_SUCCESS' if
│ │ │ │ │ -000058e0: 2074 6865 2063 6f6e 7465 7874 2077 6173   the context was
│ │ │ │ │ -000058f0: 2073 7563 6365 7373 6675 6c6c 7920 6372   successfully cr
│ │ │ │ │ -00005900: 6561 7465 642e 2020 4966 2061 6e79 206f  eated.  If any o
│ │ │ │ │ -00005910: 660a 2020 2020 2074 6865 2069 6e74 6572  f.     the inter
│ │ │ │ │ -00005920: 6d65 6469 6174 6520 7374 6570 7320 696e  mediate steps in
│ │ │ │ │ -00005930: 2070 6172 7369 6e67 2074 6865 2064 6174   parsing the dat
│ │ │ │ │ -00005940: 612c 2076 616c 6964 6174 696e 6720 7468  a, validating th
│ │ │ │ │ -00005950: 6520 5350 410a 2020 2020 206d 6573 7361  e SPA.     messa
│ │ │ │ │ -00005960: 6765 2064 6967 6573 742c 206f 7220 616e  ge digest, or an
│ │ │ │ │ -00005970: 7920 6f74 6865 7220 696e 7465 726e 616c  y other internal
│ │ │ │ │ -00005980: 2061 6374 696f 6e20 6661 696c 732c 2074   action fails, t
│ │ │ │ │ -00005990: 6865 6e20 7468 650a 2020 2020 2061 7070  hen the.     app
│ │ │ │ │ -000059a0: 726f 7072 6961 7465 2065 7272 6f72 2063  ropriate error c
│ │ │ │ │ -000059b0: 6f64 6520 6973 2072 6574 7572 6e65 642e  ode is returned.
│ │ │ │ │ -000059c0: 0a0a 5468 6520 6d6f 7374 2063 6f6d 6d6f  ..The most commo
│ │ │ │ │ -000059d0: 6e20 2873 696d 706c 6529 2063 6173 652e  n (simple) case.
│ │ │ │ │ -000059e0: 2e2e 0a0a 2020 2020 2066 6b6f 5f63 7478  ....     fko_ctx
│ │ │ │ │ -000059f0: 5f74 2020 2063 7478 3b0a 2020 2020 2063  _t   ctx;.     c
│ │ │ │ │ -00005a00: 6861 7220 2020 2020 2020 2a73 7061 5f64  har       *spa_d
│ │ │ │ │ -00005a10: 6174 613b 0a20 2020 2020 6368 6172 2020  ata;.     char  
│ │ │ │ │ -00005a20: 2020 2020 202a 6b65 793b 0a20 2020 2020       *key;.     
│ │ │ │ │ -00005a30: 696e 7420 2020 2020 2020 2020 6b65 795f  int         key_
│ │ │ │ │ -00005a40: 6c65 6e3b 0a20 2020 2020 6368 6172 2020  len;.     char  
│ │ │ │ │ -00005a50: 2020 2020 202a 686d 6163 5f6b 6579 3b0a       *hmac_key;.
│ │ │ │ │ -00005a60: 2020 2020 2069 6e74 2020 2020 2020 2020       int        
│ │ │ │ │ -00005a70: 2068 6d61 635f 6b65 795f 6c65 6e3b 0a20   hmac_key_len;. 
│ │ │ │ │ -00005a80: 2020 2020 696e 7420 2020 2020 2020 2020      int         
│ │ │ │ │ -00005a90: 686d 6163 5f74 7970 6520 3d20 464b 4f5f  hmac_type = FKO_
│ │ │ │ │ -00005aa0: 484d 4143 5f53 4841 3235 363b 0a20 2020  HMAC_SHA256;.   
│ │ │ │ │ -00005ab0: 2020 696e 7420 2020 2020 2020 2020 656e    int         en
│ │ │ │ │ -00005ac0: 635f 6d6f 6465 2020 3d20 464b 4f5f 454e  c_mode  = FKO_EN
│ │ │ │ │ -00005ad0: 435f 4d4f 4445 5f43 4243 3b0a 2020 2020  C_MODE_CBC;.    
│ │ │ │ │ -00005ae0: 2069 6e74 2072 633b 0a0a 2020 2020 202f   int rc;..     /
│ │ │ │ │ -00005af0: 2a20 4173 7375 6d65 2077 6520 6361 6c6c  * Assume we call
│ │ │ │ │ -00005b00: 6564 2063 6f64 6520 7468 6174 2072 6574  ed code that ret
│ │ │ │ │ -00005b10: 7269 6576 6573 2074 6865 2064 6174 6120  rieves the data 
│ │ │ │ │ -00005b20: 616e 6420 6b65 790a 2020 2020 202a 2f0a  and key.     */.
│ │ │ │ │ -00005b30: 0a20 2020 2020 7263 203d 2066 6b6f 5f6e  .     rc = fko_n
│ │ │ │ │ -00005b40: 6577 5f77 6974 685f 6461 7461 2826 6374  ew_with_data(&ct
│ │ │ │ │ -00005b50: 782c 2073 7061 5f64 6174 612c 206b 6579  x, spa_data, key
│ │ │ │ │ -00005b60: 2c20 6b65 795f 6c65 6e2c 205c 5c0a 2020  , key_len, \\.  
│ │ │ │ │ -00005b70: 2020 2020 2020 2065 6e63 5f6d 6f64 652c         enc_mode,
│ │ │ │ │ -00005b80: 2068 6d61 635f 6b65 792c 2068 6d61 635f   hmac_key, hmac_
│ │ │ │ │ -00005b90: 6b65 795f 6c65 6e2c 2068 6d61 635f 7479  key_len, hmac_ty
│ │ │ │ │ -00005ba0: 7065 293b 0a0a 2020 2020 2069 6628 7263  pe);..     if(rc
│ │ │ │ │ -00005bb0: 2021 3d20 464b 4f5f 5355 4343 4553 5329   != FKO_SUCCESS)
│ │ │ │ │ -00005bc0: 0a20 2020 2020 7b0a 2020 2020 2020 2020  .     {.        
│ │ │ │ │ -00005bd0: 2066 7072 696e 7466 2873 7464 6572 722c   fprintf(stderr,
│ │ │ │ │ -00005be0: 2022 4572 726f 7220 2569 2066 726f 6d20   "Error %i from 
│ │ │ │ │ -00005bf0: 666b 6f5f 6e65 775f 7769 7468 5f64 6174  fko_new_with_dat
│ │ │ │ │ -00005c00: 613a 2025 735c 6e22 2c0a 2020 2020 2020  a: %s\n",.      
│ │ │ │ │ -00005c10: 2020 2020 2020 2072 632c 2066 6b6f 6572         rc, fkoer
│ │ │ │ │ -00005c20: 7273 7472 2872 6329 293b 0a20 2020 2020  rstr(rc));.     
│ │ │ │ │ -00005c30: 2020 2020 6578 6974 2831 293b 0a20 2020      exit(1);.   
│ │ │ │ │ -00005c40: 2020 7d0a 0a4f 722c 2070 6572 6861 7073    }..Or, perhaps
│ │ │ │ │ -00005c50: 2079 6f75 206e 6565 6420 746f 2064 6566   you need to def
│ │ │ │ │ -00005c60: 6572 2064 6563 7279 7074 696f 6e20 616e  er decryption an
│ │ │ │ │ -00005c70: 6420 7061 7273 696e 6720 746f 2061 206c  d parsing to a l
│ │ │ │ │ -00005c80: 6174 6572 2070 6f69 6e74 2069 6e0a 7468  ater point in.th
│ │ │ │ │ -00005c90: 6520 7072 6f67 7261 6d2e 2020 5765 2063  e program.  We c
│ │ │ │ │ -00005ca0: 6f75 6c64 2075 7365 2066 6b6f 5f6e 6577  ould use fko_new
│ │ │ │ │ -00005cb0: 5f77 6974 685f 6461 7461 2829 2c20 7061  _with_data(), pa
│ │ │ │ │ -00005cc0: 7373 696e 6720 4e55 4c4c 2066 6f72 2074  ssing NULL for t
│ │ │ │ │ -00005cd0: 6865 0a64 6563 7279 7074 696f 6e20 6b65  he.decryption ke
│ │ │ │ │ -00005ce0: 7920 616e 6420 484d 4143 206b 6579 732c  y and HMAC keys,
│ │ │ │ │ -00005cf0: 206f 7220 7765 2063 6f75 6c64 2075 7365   or we could use
│ │ │ │ │ -00005d00: 2066 6b6f 5f6e 6577 2829 2074 6f20 6372   fko_new() to cr
│ │ │ │ │ -00005d10: 6561 7465 2061 6e0a 656d 7074 7920 636f  eate an.empty co
│ │ │ │ │ -00005d20: 6e74 6578 742c 2074 6865 6e20 7573 6520  ntext, then use 
│ │ │ │ │ -00005d30: 666b 6f5f 7365 745f 7370 615f 6461 7461  fko_set_spa_data
│ │ │ │ │ -00005d40: 2829 2074 6f20 6164 6420 7468 6520 656e  () to add the en
│ │ │ │ │ -00005d50: 6379 7074 6564 2064 6174 6120 2873 6565  cypted data (see
│ │ │ │ │ -00005d60: 0a63 6f6d 6d65 6e74 7320 696e 2074 6865  .comments in the
│ │ │ │ │ -00005d70: 2063 6f64 6520 7361 6d70 6c65 7329 2e0a   code samples)..
│ │ │ │ │ -00005d80: 0a20 2020 2020 666b 6f5f 6374 785f 7420  .     fko_ctx_t 
│ │ │ │ │ -00005d90: 2020 6374 783b 0a20 2020 2020 6368 6172    ctx;.     char
│ │ │ │ │ -00005da0: 2020 2020 2020 202a 7370 615f 6461 7461         *spa_data
│ │ │ │ │ -00005db0: 3b0a 2020 2020 2063 6861 7220 2020 2020  ;.     char     
│ │ │ │ │ -00005dc0: 2020 2a6b 6579 3b0a 2020 2020 2069 6e74    *key;.     int
│ │ │ │ │ -00005dd0: 2072 633b 0a0a 2020 2020 202f 2a20 4173   rc;..     /* As
│ │ │ │ │ -00005de0: 7375 6d65 2077 6520 6361 6c6c 6564 2063  sume we called c
│ │ │ │ │ -00005df0: 6f64 6520 7468 6174 2072 6574 7269 6576  ode that retriev
│ │ │ │ │ -00005e00: 6573 2074 6865 2064 6174 6120 616e 6420  es the data and 
│ │ │ │ │ -00005e10: 6b65 790a 2020 2020 202a 2f0a 0a20 2020  key.     */..   
│ │ │ │ │ -00005e20: 2020 7263 203d 2066 6b6f 5f6e 6577 5f77    rc = fko_new_w
│ │ │ │ │ -00005e30: 6974 685f 6461 7461 2826 6374 782c 2073  ith_data(&ctx, s
│ │ │ │ │ -00005e40: 7061 5f64 6174 612c 204e 554c 4c2c 2030  pa_data, NULL, 0
│ │ │ │ │ -00005e50: 2c0a 2020 2020 2020 2020 2020 2020 2046  ,.             F
│ │ │ │ │ -00005e60: 4b4f 5f45 4e43 5f4d 4f44 455f 4342 432c  KO_ENC_MODE_CBC,
│ │ │ │ │ -00005e70: 204e 554c 4c2c 2030 2c20 464b 4f5f 484d   NULL, 0, FKO_HM
│ │ │ │ │ -00005e80: 4143 5f53 4841 3235 3629 3b0a 0a20 2020  AC_SHA256);..   
│ │ │ │ │ -00005e90: 2020 6966 2872 6320 213d 2046 4b4f 5f53    if(rc != FKO_S
│ │ │ │ │ -00005ea0: 5543 4345 5353 290a 2020 2020 207b 0a20  UCCESS).     {. 
│ │ │ │ │ -00005eb0: 2020 2020 2020 2020 6670 7269 6e74 6628          fprintf(
│ │ │ │ │ -00005ec0: 7374 6465 7272 2c20 2245 7272 6f72 2066  stderr, "Error f
│ │ │ │ │ -00005ed0: 726f 6d20 666b 6f5f 6e65 775f 7769 7468  rom fko_new_with
│ │ │ │ │ -00005ee0: 5f64 6174 613a 2025 735c 6e22 2c0a 2020  _data: %s\n",.  
│ │ │ │ │ -00005ef0: 2020 2020 2020 2020 2020 2066 6b6f 5f65             fko_e
│ │ │ │ │ -00005f00: 7272 7374 7228 7263 2929 3b0a 2020 2020  rrstr(rc));.    
│ │ │ │ │ -00005f10: 2020 2020 2065 7869 7428 3129 3b0a 2020       exit(1);.  
│ │ │ │ │ -00005f20: 2020 207d 0a0a 2020 2020 202f 2a20 5765     }..     /* We
│ │ │ │ │ -00005f30: 2063 6f75 6c64 2061 6c73 6f20 6a75 7374   could also just
│ │ │ │ │ -00005f40: 2063 7265 6174 6520 616e 6420 656d 7074   create and empt
│ │ │ │ │ -00005f50: 7920 636f 6e74 6578 7420 616e 6420 6164  y context and ad
│ │ │ │ │ -00005f60: 6420 7468 650a 2020 2020 2020 2a20 656e  d the.      * en
│ │ │ │ │ -00005f70: 6372 7970 7465 6420 6461 7461 2061 7320  crypted data as 
│ │ │ │ │ -00005f80: 666f 6c6c 6f77 733a 0a20 2020 2020 202a  follows:.      *
│ │ │ │ │ -00005f90: 0a20 2020 2020 202a 2072 6320 3d20 666b  .      * rc = fk
│ │ │ │ │ -00005fa0: 6f5f 6e65 7728 2663 7478 293b 0a20 2020  o_new(&ctx);.   
│ │ │ │ │ -00005fb0: 2020 202a 202e 2e2e 2063 6865 636b 2072     * ... check r
│ │ │ │ │ -00005fc0: 6320 2e2e 2e0a 2020 2020 2020 2a20 7263  c ....      * rc
│ │ │ │ │ -00005fd0: 203d 2066 6b6f 5f73 6574 5f73 7061 5f64   = fko_set_spa_d
│ │ │ │ │ -00005fe0: 6174 6128 6374 782c 2073 7061 5f64 6174  ata(ctx, spa_dat
│ │ │ │ │ -00005ff0: 6129 3b0a 2020 2020 2020 2a20 2e2e 2e0a  a);.      * ....
│ │ │ │ │ -00006000: 2020 2020 202a 2f0a 0a20 2020 2020 2f2a       */..     /*
│ │ │ │ │ -00006010: 2041 7373 756d 6520 7765 2063 616c 6c65   Assume we calle
│ │ │ │ │ -00006020: 6420 6f74 6865 7220 636f 6465 2061 6e64  d other code and
│ │ │ │ │ -00006030: 2066 756e 6374 696f 6e73 2e2e 2e20 202a   functions...  *
│ │ │ │ │ -00006040: 2f0a 0a20 2020 2020 2f2a 2056 6572 6966  /..     /* Verif
│ │ │ │ │ -00006050: 7920 484d 4143 0a20 2020 2020 2a2f 0a20  y HMAC.     */. 
│ │ │ │ │ -00006060: 2020 2020 7263 203d 2066 6b6f 5f76 6572      rc = fko_ver
│ │ │ │ │ -00006070: 6966 795f 686d 6163 2863 7478 2c20 686d  ify_hmac(ctx, hm
│ │ │ │ │ -00006080: 6163 5f6b 6579 2c20 686d 6163 5f6b 6579  ac_key, hmac_key
│ │ │ │ │ -00006090: 5f6c 656e 293b 0a20 2020 2020 6966 2872  _len);.     if(r
│ │ │ │ │ -000060a0: 6320 213d 2046 4b4f 5f53 5543 4345 5353  c != FKO_SUCCESS
│ │ │ │ │ -000060b0: 290a 2020 2020 207b 0a20 2020 2020 2020  ).     {.       
│ │ │ │ │ -000060c0: 2020 6670 7269 6e74 6628 7374 6465 7272    fprintf(stderr
│ │ │ │ │ -000060d0: 2c20 2245 7272 6f72 2066 726f 6d20 666b  , "Error from fk
│ │ │ │ │ -000060e0: 6f5f 7665 7269 6679 5f68 6d61 633a 2025  o_verify_hmac: %
│ │ │ │ │ -000060f0: 735c 6e22 2c0a 2020 2020 2020 2020 2020  s\n",.          
│ │ │ │ │ -00006100: 2020 2066 6b6f 5f65 7272 7374 7228 7263     fko_errstr(rc
│ │ │ │ │ -00006110: 2929 3b0a 2020 2020 2020 2020 2065 7869  ));.         exi
│ │ │ │ │ -00006120: 7428 3129 3b0a 2020 2020 207d 0a0a 2020  t(1);.     }..  
│ │ │ │ │ -00006130: 2020 202f 2a20 4465 6372 7970 7420 616e     /* Decrypt an
│ │ │ │ │ -00006140: 6420 6465 636f 6465 2e2e 2e0a 2020 2020  d decode....    
│ │ │ │ │ -00006150: 202a 2f0a 2020 2020 2072 6320 3d20 666b   */.     rc = fk
│ │ │ │ │ -00006160: 6f5f 6465 6372 7970 745f 7370 615f 6461  o_decrypt_spa_da
│ │ │ │ │ -00006170: 7461 2863 7478 2c20 6b65 792c 206b 6579  ta(ctx, key, key
│ │ │ │ │ -00006180: 5f6c 656e 293b 0a0a 2020 2020 2069 6628  _len);..     if(
│ │ │ │ │ -00006190: 7263 2021 3d20 464b 4f5f 5355 4343 4553  rc != FKO_SUCCES
│ │ │ │ │ -000061a0: 5329 0a20 2020 2020 7b0a 2020 2020 2020  S).     {.      
│ │ │ │ │ -000061b0: 2020 2066 7072 696e 7466 2873 7464 6572     fprintf(stder
│ │ │ │ │ -000061c0: 722c 2022 4572 726f 7220 6672 6f6d 2066  r, "Error from f
│ │ │ │ │ -000061d0: 6b6f 5f64 6563 7279 7074 5f73 7061 5f64  ko_decrypt_spa_d
│ │ │ │ │ -000061e0: 6174 613a 2025 735c 6e22 2c0a 2020 2020  ata: %s\n",.    
│ │ │ │ │ -000061f0: 2020 2020 2020 2020 2066 6b6f 5f65 7272           fko_err
│ │ │ │ │ -00006200: 7374 7228 7263 2929 3b0a 2020 2020 2020  str(rc));.      
│ │ │ │ │ -00006210: 2020 2065 7869 7428 3129 3b0a 2020 2020     exit(1);.    
│ │ │ │ │ -00006220: 207d 0a0a 1f0a 4669 6c65 3a20 6c69 6266   }....File: libf
│ │ │ │ │ -00006230: 6b6f 2e69 6e66 6f2c 2020 4e6f 6465 3a20  ko.info,  Node: 
│ │ │ │ │ -00006240: 4465 7374 726f 7969 6e67 2043 6f6e 7465  Destroying Conte
│ │ │ │ │ -00006250: 7874 732c 2020 4e65 7874 3a20 4372 6561  xts,  Next: Crea
│ │ │ │ │ -00006260: 7469 6e67 2061 2053 5041 204d 6573 7361  ting a SPA Messa
│ │ │ │ │ -00006270: 6765 2c20 2050 7265 763a 2043 7265 6174  ge,  Prev: Creat
│ │ │ │ │ -00006280: 696e 6720 436f 6e74 6578 7473 2c20 2055  ing Contexts,  U
│ │ │ │ │ -00006290: 703a 2055 7369 6e67 206c 6962 666b 6f0a  p: Using libfko.
│ │ │ │ │ -000062a0: 0a33 2e32 2044 6573 7472 6f79 696e 6720  .3.2 Destroying 
│ │ │ │ │ -000062b0: 436f 6e74 6578 7473 0a3d 3d3d 3d3d 3d3d  Contexts.=======
│ │ │ │ │ -000062c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ │ -000062d0: 0a0a 5768 656e 2079 6f75 2061 7265 2064  ..When you are d
│ │ │ │ │ -000062e0: 6f6e 6520 7769 7468 2074 6865 2063 6f6e  one with the con
│ │ │ │ │ -000062f0: 7465 7874 2c20 796f 7520 6d75 7374 2064  text, you must d
│ │ │ │ │ -00006300: 6573 7472 6f79 2069 7420 696e 206f 7264  estroy it in ord
│ │ │ │ │ -00006310: 6572 2074 6f20 6672 6565 0a75 7020 7468  er to free.up th
│ │ │ │ │ -00006320: 6520 6d65 6d6f 7279 2061 6e64 2072 6573  e memory and res
│ │ │ │ │ -00006330: 6f75 7263 6573 2069 7420 7761 7320 7573  ources it was us
│ │ │ │ │ -00006340: 696e 672e 2020 5468 6973 2069 7320 6573  ing.  This is es
│ │ │ │ │ -00006350: 7065 6369 616c 6c79 2069 6d70 6f72 7461  pecially importa
│ │ │ │ │ -00006360: 6e74 0a69 6e20 7072 6f67 7261 6d73 2074  nt.in programs t
│ │ │ │ │ -00006370: 6861 7420 7072 6f63 6573 7320 5350 4120  hat process SPA 
│ │ │ │ │ -00006380: 6461 7461 2072 6570 6561 7465 646c 7920  data repeatedly 
│ │ │ │ │ -00006390: 2869 2e65 2e20 2069 6e20 6120 6c6f 6f70  (i.e.  in a loop
│ │ │ │ │ -000063a0: 292e 2020 4661 696c 7572 650a 746f 2064  ).  Failure.to d
│ │ │ │ │ -000063b0: 6573 7472 6f79 2074 6865 2063 6f6e 7465  estroy the conte
│ │ │ │ │ -000063c0: 7874 2063 616e 2063 6175 7365 206d 656d  xt can cause mem
│ │ │ │ │ -000063d0: 6f72 7920 6c65 616b 7320 696e 2079 6f75  ory leaks in you
│ │ │ │ │ -000063e0: 7220 7072 6f67 7261 6d2e 0a0a 202d 2d20  r program... -- 
│ │ │ │ │ -000063f0: 4675 6e63 7469 6f6e 3a20 766f 6964 2066  Function: void f
│ │ │ │ │ -00006400: 6b6f 5f64 6573 7472 6f79 2028 666b 6f5f  ko_destroy (fko_
│ │ │ │ │ -00006410: 6374 785f 7420 4354 5829 0a20 2020 2020  ctx_t CTX).     
│ │ │ │ │ -00006420: 5468 6520 6675 6e63 7469 6f6e 2027 666b  The function 'fk
│ │ │ │ │ -00006430: 6f5f 6465 7374 726f 7927 2064 6573 7472  o_destroy' destr
│ │ │ │ │ -00006440: 6f79 7320 7468 6520 636f 6e74 6578 7420  oys the context 
│ │ │ │ │ -00006450: 7769 7468 2074 6865 2068 616e 646c 6520  with the handle 
│ │ │ │ │ -00006460: 4354 580a 2020 2020 2061 6e64 2072 656c  CTX.     and rel
│ │ │ │ │ -00006470: 6561 7365 7320 616c 6c20 6173 736f 6369  eases all associ
│ │ │ │ │ -00006480: 6174 6564 2072 6573 6f75 7263 6573 2e0a  ated resources..
│ │ │ │ │ -00006490: 0a1f 0a46 696c 653a 206c 6962 666b 6f2e  ...File: libfko.
│ │ │ │ │ -000064a0: 696e 666f 2c20 204e 6f64 653a 2043 7265  info,  Node: Cre
│ │ │ │ │ -000064b0: 6174 696e 6720 6120 5350 4120 4d65 7373  ating a SPA Mess
│ │ │ │ │ -000064c0: 6167 652c 2020 4e65 7874 3a20 5365 7474  age,  Next: Sett
│ │ │ │ │ -000064d0: 696e 6720 5350 4120 4461 7461 2c20 2050  ing SPA Data,  P
│ │ │ │ │ -000064e0: 7265 763a 2044 6573 7472 6f79 696e 6720  rev: Destroying 
│ │ │ │ │ -000064f0: 436f 6e74 6578 7473 2c20 2055 703a 2055  Contexts,  Up: U
│ │ │ │ │ -00006500: 7369 6e67 206c 6962 666b 6f0a 0a33 2e33  sing libfko..3.3
│ │ │ │ │ -00006510: 2043 7265 6174 696e 6720 6120 5350 4120   Creating a SPA 
│ │ │ │ │ -00006520: 4d65 7373 6167 650a 3d3d 3d3d 3d3d 3d3d  Message.========
│ │ │ │ │ +00004f30: 0a0a 4265 666f 7265 2064 6f69 6e67 2061  ..Before doing a
│ │ │ │ │ +00004f40: 6e79 7468 696e 6720 7769 7468 206c 6962  nything with lib
│ │ │ │ │ +00004f50: 666b 6f2c 2079 6f75 206e 6565 6420 746f  fko, you need to
│ │ │ │ │ +00004f60: 2063 7265 6174 6520 6120 636f 6e74 6578   create a contex
│ │ │ │ │ +00004f70: 742e 2020 410a 636f 6e74 6578 7420 6973  t.  A.context is
│ │ │ │ │ +00004f80: 2063 7265 6174 6564 2066 6f72 206f 6e65   created for one
│ │ │ │ │ +00004f90: 206f 6620 7477 6f20 7265 6173 6f6e 732e   of two reasons.
│ │ │ │ │ +00004fa0: 2020 4f6e 6520 6973 2066 6f72 2074 6865    One is for the
│ │ │ │ │ +00004fb0: 2070 7572 706f 7365 206f 660a 6275 696c   purpose of.buil
│ │ │ │ │ +00004fc0: 6469 6e67 2061 206e 6577 2066 6b6f 2053  ding a new fko S
│ │ │ │ │ +00004fd0: 5041 206d 6573 7361 6765 2066 726f 6d20  PA message from 
│ │ │ │ │ +00004fe0: 7363 7261 7463 6820 2874 7970 6963 616c  scratch (typical
│ │ │ │ │ +00004ff0: 6c79 2074 6f20 6265 2070 6163 6b61 6765  ly to be package
│ │ │ │ │ +00005000: 640a 616e 6420 7365 6e74 2074 6f20 616e  d.and sent to an
│ │ │ │ │ +00005010: 2066 776b 6e6f 7020 7365 7276 6572 2073   fwknop server s
│ │ │ │ │ +00005020: 6f6d 6577 6865 7265 292e 2020 5468 6520  omewhere).  The 
│ │ │ │ │ +00005030: 6f74 6865 7220 776f 756c 6420 6265 2061  other would be a
│ │ │ │ │ +00005040: 2063 6f6e 7465 7874 0a66 6f72 2074 616b   context.for tak
│ │ │ │ │ +00005050: 696e 6720 616e 2065 7869 7374 696e 6720  ing an existing 
│ │ │ │ │ +00005060: 5350 4120 6d65 7373 6167 6520 666f 7220  SPA message for 
│ │ │ │ │ +00005070: 6465 636f 6469 6e67 2c20 7061 7273 696e  decoding, parsin
│ │ │ │ │ +00005080: 672c 2061 6e64 2064 6174 610a 6578 7472  g, and data.extr
│ │ │ │ │ +00005090: 6163 7469 6f6e 2e0a 0a46 6f72 2062 7569  action...For bui
│ │ │ │ │ +000050a0: 6c64 696e 6720 6120 6e65 7720 666b 6f20  lding a new fko 
│ │ │ │ │ +000050b0: 5350 4120 6d65 7373 6167 652c 2079 6f75  SPA message, you
│ │ │ │ │ +000050c0: 2077 696c 6c20 7573 6520 7468 6520 2766   will use the 'f
│ │ │ │ │ +000050d0: 6b6f 5f6e 6577 2720 6675 6e63 7469 6f6e  ko_new' function
│ │ │ │ │ +000050e0: 3a0a 0a20 2d2d 2046 756e 6374 696f 6e3a  :.. -- Function:
│ │ │ │ │ +000050f0: 2069 6e74 2066 6b6f 5f6e 6577 2028 666b   int fko_new (fk
│ │ │ │ │ +00005100: 6f5f 6374 785f 7420 2a43 5458 290a 2020  o_ctx_t *CTX).  
│ │ │ │ │ +00005110: 2020 2054 6865 2066 756e 6374 696f 6e20     The function 
│ │ │ │ │ +00005120: 2766 6b6f 5f6e 6577 2720 7365 7473 2075  'fko_new' sets u
│ │ │ │ │ +00005130: 7020 616e 6420 696e 6974 6961 6c69 7a65  p and initialize
│ │ │ │ │ +00005140: 7320 6120 6e65 7720 2766 6b6f 5f63 7478  s a new 'fko_ctx
│ │ │ │ │ +00005150: 5f74 270a 2020 2020 206f 626a 6563 742c  _t'.     object,
│ │ │ │ │ +00005160: 2070 7265 2d70 6f70 756c 6174 6573 2064   pre-populates d
│ │ │ │ │ +00005170: 6566 6175 6c74 2076 616c 7565 7320 616e  efault values an
│ │ │ │ │ +00005180: 6420 7265 7475 726e 7320 6120 6861 6e64  d returns a hand
│ │ │ │ │ +00005190: 6c65 2066 6f72 2069 7420 696e 0a20 2020  le for it in.   
│ │ │ │ │ +000051a0: 2020 4354 582e 2020 5468 6520 6675 6e63    CTX.  The func
│ │ │ │ │ +000051b0: 7469 6f6e 2072 6574 7572 6e73 2074 6865  tion returns the
│ │ │ │ │ +000051c0: 2065 7272 6f72 2063 6f64 6520 2746 4b4f   error code 'FKO
│ │ │ │ │ +000051d0: 5f53 5543 4345 5353 2720 6966 2074 6865  _SUCCESS' if the
│ │ │ │ │ +000051e0: 0a20 2020 2020 636f 6e74 6578 7420 7761  .     context wa
│ │ │ │ │ +000051f0: 7320 7375 6363 6573 7366 756c 6c79 2063  s successfully c
│ │ │ │ │ +00005200: 7265 6174 6564 2e20 204f 7468 6572 7769  reated.  Otherwi
│ │ │ │ │ +00005210: 7365 2061 6e20 616e 6f74 6865 7220 6572  se an another er
│ │ │ │ │ +00005220: 726f 7220 636f 6465 0a20 2020 2020 7769  ror code.     wi
│ │ │ │ │ +00005230: 6c6c 2062 6520 7265 7475 726e 6564 2028  ll be returned (
│ │ │ │ │ +00005240: 2a6e 6f74 6520 4572 726f 7220 4861 6e64  *note Error Hand
│ │ │ │ │ +00005250: 6c69 6e67 3a3a 2066 6f72 2064 6574 6169  ling:: for detai
│ │ │ │ │ +00005260: 6c73 206f 6e20 7468 6520 7661 7269 6f75  ls on the variou
│ │ │ │ │ +00005270: 730a 2020 2020 2065 7272 6f72 2063 6f64  s.     error cod
│ │ │ │ │ +00005280: 6573 2061 6e64 2074 6865 6972 206d 6561  es and their mea
│ │ │ │ │ +00005290: 6e69 6e67 7329 2e0a 0a20 2020 2020 666b  nings)...     fk
│ │ │ │ │ +000052a0: 6f5f 6374 785f 7420 2020 6374 783b 0a20  o_ctx_t   ctx;. 
│ │ │ │ │ +000052b0: 2020 2020 696e 7420 2020 2020 2020 2020      int         
│ │ │ │ │ +000052c0: 7263 3b0a 0a20 2020 2020 7263 203d 2066  rc;..     rc = f
│ │ │ │ │ +000052d0: 6b6f 5f6e 6577 2826 6374 7829 3b0a 0a20  ko_new(&ctx);.. 
│ │ │ │ │ +000052e0: 2020 2020 6966 2872 6320 213d 2046 4b4f      if(rc != FKO
│ │ │ │ │ +000052f0: 5f53 5543 4345 5353 290a 2020 2020 207b  _SUCCESS).     {
│ │ │ │ │ +00005300: 0a20 2020 2020 2020 2020 6670 7269 6e74  .         fprint
│ │ │ │ │ +00005310: 6628 7374 6465 7272 2c20 2245 7272 6f72  f(stderr, "Error
│ │ │ │ │ +00005320: 2025 6920 6672 6f6d 2066 6b6f 5f6e 6577   %i from fko_new
│ │ │ │ │ +00005330: 3a20 2573 5c6e 222c 0a20 2020 2020 2020  : %s\n",.       
│ │ │ │ │ +00005340: 2020 2020 2020 7263 2c20 666b 6f5f 6572        rc, fko_er
│ │ │ │ │ +00005350: 7273 7472 2872 6329 293b 0a20 2020 2020  rstr(rc));.     
│ │ │ │ │ +00005360: 2020 2020 6578 6974 2831 293b 0a20 2020      exit(1);.   
│ │ │ │ │ +00005370: 2020 7d0a 0a46 6f72 2061 2063 6f6e 7465    }..For a conte
│ │ │ │ │ +00005380: 7874 2074 6861 7420 7769 6c6c 2062 6520  xt that will be 
│ │ │ │ │ +00005390: 7573 6564 2066 6f72 2072 6563 6569 7669  used for receivi
│ │ │ │ │ +000053a0: 6e67 2061 6e64 2070 6172 7369 6e67 2061  ng and parsing a
│ │ │ │ │ +000053b0: 6e20 6578 6973 7469 6e67 0a53 5041 206d  n existing.SPA m
│ │ │ │ │ +000053c0: 6573 7361 6765 2c20 796f 7520 7769 6c6c  essage, you will
│ │ │ │ │ +000053d0: 2075 7365 2074 6865 2027 666b 6f5f 6e65   use the 'fko_ne
│ │ │ │ │ +000053e0: 775f 7769 7468 5f64 6174 6127 2066 756e  w_with_data' fun
│ │ │ │ │ +000053f0: 6374 696f 6e3a 0a0a 202d 2d20 4675 6e63  ction:.. -- Func
│ │ │ │ │ +00005400: 7469 6f6e 3a20 696e 7420 666b 6f5f 6e65  tion: int fko_ne
│ │ │ │ │ +00005410: 775f 7769 7468 5f64 6174 6120 2866 6b6f  w_with_data (fko
│ │ │ │ │ +00005420: 5f63 7478 5f74 202a 4354 582c 2063 6f6e  _ctx_t *CTX, con
│ │ │ │ │ +00005430: 7374 2063 6861 7220 2a44 4154 412c 0a20  st char *DATA,. 
│ │ │ │ │ +00005440: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ │ +00005450: 6861 7220 2a4b 4559 2c20 636f 6e73 7420  har *KEY, const 
│ │ │ │ │ +00005460: 6368 6172 204b 4559 5f4c 454e 2c20 696e  char KEY_LEN, in
│ │ │ │ │ +00005470: 7420 454e 4352 5950 5449 4f4e 5f4d 4f44  t ENCRYPTION_MOD
│ │ │ │ │ +00005480: 452c 0a20 2020 2020 2020 2020 2063 6f6e  E,.          con
│ │ │ │ │ +00005490: 7374 2063 6861 7220 484d 4143 5f4b 4559  st char HMAC_KEY
│ │ │ │ │ +000054a0: 2c20 636f 6e73 7420 696e 7420 484d 4143  , const int HMAC
│ │ │ │ │ +000054b0: 5f54 5950 4529 0a0a 2020 2020 2054 6865  _TYPE)..     The
│ │ │ │ │ +000054c0: 2066 756e 6374 696f 6e20 2766 6b6f 5f6e   function 'fko_n
│ │ │ │ │ +000054d0: 6577 5f77 6974 685f 6461 7461 2720 7365  ew_with_data' se
│ │ │ │ │ +000054e0: 7473 2075 7020 616e 6420 696e 6974 6961  ts up and initia
│ │ │ │ │ +000054f0: 6c69 7a65 7320 6120 6e65 770a 2020 2020  lizes a new.    
│ │ │ │ │ +00005500: 2027 666b 6f5f 6374 785f 7427 2063 6f6e   'fko_ctx_t' con
│ │ │ │ │ +00005510: 7465 7874 2c20 6275 7420 696e 7374 6561  text, but instea
│ │ │ │ │ +00005520: 6420 6f66 2069 6e69 7469 616c 697a 696e  d of initializin
│ │ │ │ │ +00005530: 6720 6465 6661 756c 7420 7661 6c75 6573  g default values
│ │ │ │ │ +00005540: 2c20 6974 0a20 2020 2020 7374 6f72 6573  , it.     stores
│ │ │ │ │ +00005550: 2074 6865 2065 6e63 7279 7074 6564 206d   the encrypted m
│ │ │ │ │ +00005560: 6573 7361 6765 2064 6174 6120 616e 6420  essage data and 
│ │ │ │ │ +00005570: 6d61 6b65 7320 6974 2072 6561 6479 2066  makes it ready f
│ │ │ │ │ +00005580: 6f72 2070 6172 7369 6e67 2e0a 2020 2020  or parsing..    
│ │ │ │ │ +00005590: 2054 6869 7320 6361 6e20 6265 2064 6f6e   This can be don
│ │ │ │ │ +000055a0: 6520 696e 206f 6e65 206f 6620 7477 6f20  e in one of two 
│ │ │ │ │ +000055b0: 7761 7973 2e20 204f 6e65 2069 7320 746f  ways.  One is to
│ │ │ │ │ +000055c0: 2070 6173 7320 274e 554c 4c27 2066 6f72   pass 'NULL' for
│ │ │ │ │ +000055d0: 2074 6865 0a20 2020 2020 7468 6972 6420   the.     third 
│ │ │ │ │ +000055e0: 6172 6775 6d65 6e74 2e20 2054 6865 2063  argument.  The c
│ │ │ │ │ +000055f0: 6f6e 7465 7874 2077 696c 6c20 6265 2063  ontext will be c
│ │ │ │ │ +00005600: 7265 6174 6564 2061 6e64 2074 6865 2064  reated and the d
│ │ │ │ │ +00005610: 6174 6120 7769 6c6c 2062 650a 2020 2020  ata will be.    
│ │ │ │ │ +00005620: 2073 746f 7265 642c 2062 7574 206e 6f20   stored, but no 
│ │ │ │ │ +00005630: 6465 6372 7970 7469 6f6e 206f 7220 6465  decryption or de
│ │ │ │ │ +00005640: 636f 6469 6e67 2074 616b 6573 2070 6c61  coding takes pla
│ │ │ │ │ +00005650: 6365 2e20 2049 6e20 7468 6973 2063 6173  ce.  In this cas
│ │ │ │ │ +00005660: 652c 0a20 2020 2020 796f 7520 7769 6c6c  e,.     you will
│ │ │ │ │ +00005670: 206e 6565 6420 746f 2063 616c 6c20 2766   need to call 'f
│ │ │ │ │ +00005680: 6b6f 5f64 6563 7279 7074 5f73 7061 5f64  ko_decrypt_spa_d
│ │ │ │ │ +00005690: 6174 6127 2061 7420 6120 6c61 7465 7220  ata' at a later 
│ │ │ │ │ +000056a0: 7469 6d65 2e20 2054 6865 0a20 2020 2020  time.  The.     
│ │ │ │ │ +000056b0: 6f74 6865 7220 7761 7920 746f 2064 6f20  other way to do 
│ │ │ │ │ +000056c0: 6974 2069 7320 746f 2073 7570 706c 7920  it is to supply 
│ │ │ │ │ +000056d0: 7468 6520 4b45 5920 7661 6c75 6520 2864  the KEY value (d
│ │ │ │ │ +000056e0: 6563 7279 7074 696f 6e0a 2020 2020 2070  ecryption.     p
│ │ │ │ │ +000056f0: 6173 7370 6872 6173 6529 2061 6e64 2061  assphrase) and a
│ │ │ │ │ +00005700: 7373 6f63 6174 6564 206c 656e 6774 682e  ssocated length.
│ │ │ │ │ +00005710: 2020 496e 2074 6869 7320 6361 7365 2c20    In this case, 
│ │ │ │ │ +00005720: 7468 6520 636f 6e74 6578 7420 6973 0a20  the context is. 
│ │ │ │ │ +00005730: 2020 2020 6372 6561 7465 642c 2074 6865      created, the
│ │ │ │ │ +00005740: 2053 5041 2064 6174 6120 6973 2064 6563   SPA data is dec
│ │ │ │ │ +00005750: 7279 7074 6564 2c20 6465 636f 6465 642c  rypted, decoded,
│ │ │ │ │ +00005760: 2070 6172 7365 642c 2061 6e64 2073 746f   parsed, and sto
│ │ │ │ │ +00005770: 7265 6420 696e 0a20 2020 2020 7468 6520  red in.     the 
│ │ │ │ │ +00005780: 636f 6e74 6578 7420 7265 6164 7920 666f  context ready fo
│ │ │ │ │ +00005790: 7220 7265 7472 6965 7661 6c2e 2020 4966  r retrieval.  If
│ │ │ │ │ +000057a0: 2061 6e20 484d 4143 2069 7320 616c 736f   an HMAC is also
│ │ │ │ │ +000057b0: 2064 6573 6972 6564 206f 720a 2020 2020   desired or.    
│ │ │ │ │ +000057c0: 2072 6571 7569 7265 642c 2074 6865 6e20   required, then 
│ │ │ │ │ +000057d0: 7468 6520 484d 4143 5f4b 4559 2061 6e64  the HMAC_KEY and
│ │ │ │ │ +000057e0: 2061 7373 6f63 6961 7465 6420 6c65 6e67   associated leng
│ │ │ │ │ +000057f0: 7468 2063 616e 2062 6520 7061 7373 6564  th can be passed
│ │ │ │ │ +00005800: 2069 6e2e 0a20 2020 2020 5468 6973 2077   in..     This w
│ │ │ │ │ +00005810: 696c 6c20 6361 7573 6520 6c69 6266 6b6f  ill cause libfko
│ │ │ │ │ +00005820: 2074 6f20 6175 7468 656e 7469 6361 7465   to authenticate
│ │ │ │ │ +00005830: 2074 6865 2053 5041 2064 6174 6120 6265   the SPA data be
│ │ │ │ │ +00005840: 666f 7265 0a20 2020 2020 6465 6372 7970  fore.     decryp
│ │ │ │ │ +00005850: 7469 6f6e 2069 7320 6174 7465 6d70 7465  tion is attempte
│ │ │ │ │ +00005860: 642c 2061 6e64 2074 6869 7320 6973 2073  d, and this is s
│ │ │ │ │ +00005870: 7472 6f6e 676c 7920 7265 636f 6d6d 656e  trongly recommen
│ │ │ │ │ +00005880: 6465 6420 746f 2064 6f2e 0a0a 2020 2020  ded to do...    
│ │ │ │ │ +00005890: 2054 6865 2027 666b 6f5f 6e65 775f 7769   The 'fko_new_wi
│ │ │ │ │ +000058a0: 7468 5f64 6174 6127 2066 756e 6374 696f  th_data' functio
│ │ │ │ │ +000058b0: 6e20 7265 7475 726e 7320 7468 6520 6572  n returns the er
│ │ │ │ │ +000058c0: 726f 7220 636f 6465 0a20 2020 2020 2746  ror code.     'F
│ │ │ │ │ +000058d0: 4b4f 5f53 5543 4345 5353 2720 6966 2074  KO_SUCCESS' if t
│ │ │ │ │ +000058e0: 6865 2063 6f6e 7465 7874 2077 6173 2073  he context was s
│ │ │ │ │ +000058f0: 7563 6365 7373 6675 6c6c 7920 6372 6561  uccessfully crea
│ │ │ │ │ +00005900: 7465 642e 2020 4966 2061 6e79 206f 660a  ted.  If any of.
│ │ │ │ │ +00005910: 2020 2020 2074 6865 2069 6e74 6572 6d65       the interme
│ │ │ │ │ +00005920: 6469 6174 6520 7374 6570 7320 696e 2070  diate steps in p
│ │ │ │ │ +00005930: 6172 7369 6e67 2074 6865 2064 6174 612c  arsing the data,
│ │ │ │ │ +00005940: 2076 616c 6964 6174 696e 6720 7468 6520   validating the 
│ │ │ │ │ +00005950: 5350 410a 2020 2020 206d 6573 7361 6765  SPA.     message
│ │ │ │ │ +00005960: 2064 6967 6573 742c 206f 7220 616e 7920   digest, or any 
│ │ │ │ │ +00005970: 6f74 6865 7220 696e 7465 726e 616c 2061  other internal a
│ │ │ │ │ +00005980: 6374 696f 6e20 6661 696c 732c 2074 6865  ction fails, the
│ │ │ │ │ +00005990: 6e20 7468 650a 2020 2020 2061 7070 726f  n the.     appro
│ │ │ │ │ +000059a0: 7072 6961 7465 2065 7272 6f72 2063 6f64  priate error cod
│ │ │ │ │ +000059b0: 6520 6973 2072 6574 7572 6e65 642e 0a0a  e is returned...
│ │ │ │ │ +000059c0: 5468 6520 6d6f 7374 2063 6f6d 6d6f 6e20  The most common 
│ │ │ │ │ +000059d0: 2873 696d 706c 6529 2063 6173 652e 2e2e  (simple) case...
│ │ │ │ │ +000059e0: 0a0a 2020 2020 2066 6b6f 5f63 7478 5f74  ..     fko_ctx_t
│ │ │ │ │ +000059f0: 2020 2063 7478 3b0a 2020 2020 2063 6861     ctx;.     cha
│ │ │ │ │ +00005a00: 7220 2020 2020 2020 2a73 7061 5f64 6174  r       *spa_dat
│ │ │ │ │ +00005a10: 613b 0a20 2020 2020 6368 6172 2020 2020  a;.     char    
│ │ │ │ │ +00005a20: 2020 202a 6b65 793b 0a20 2020 2020 696e     *key;.     in
│ │ │ │ │ +00005a30: 7420 2020 2020 2020 2020 6b65 795f 6c65  t         key_le
│ │ │ │ │ +00005a40: 6e3b 0a20 2020 2020 6368 6172 2020 2020  n;.     char    
│ │ │ │ │ +00005a50: 2020 202a 686d 6163 5f6b 6579 3b0a 2020     *hmac_key;.  
│ │ │ │ │ +00005a60: 2020 2069 6e74 2020 2020 2020 2020 2068     int         h
│ │ │ │ │ +00005a70: 6d61 635f 6b65 795f 6c65 6e3b 0a20 2020  mac_key_len;.   
│ │ │ │ │ +00005a80: 2020 696e 7420 2020 2020 2020 2020 686d    int         hm
│ │ │ │ │ +00005a90: 6163 5f74 7970 6520 3d20 464b 4f5f 484d  ac_type = FKO_HM
│ │ │ │ │ +00005aa0: 4143 5f53 4841 3235 363b 0a20 2020 2020  AC_SHA256;.     
│ │ │ │ │ +00005ab0: 696e 7420 2020 2020 2020 2020 656e 635f  int         enc_
│ │ │ │ │ +00005ac0: 6d6f 6465 2020 3d20 464b 4f5f 454e 435f  mode  = FKO_ENC_
│ │ │ │ │ +00005ad0: 4d4f 4445 5f43 4243 3b0a 2020 2020 2069  MODE_CBC;.     i
│ │ │ │ │ +00005ae0: 6e74 2072 633b 0a0a 2020 2020 202f 2a20  nt rc;..     /* 
│ │ │ │ │ +00005af0: 4173 7375 6d65 2077 6520 6361 6c6c 6564  Assume we called
│ │ │ │ │ +00005b00: 2063 6f64 6520 7468 6174 2072 6574 7269   code that retri
│ │ │ │ │ +00005b10: 6576 6573 2074 6865 2064 6174 6120 616e  eves the data an
│ │ │ │ │ +00005b20: 6420 6b65 790a 2020 2020 202a 2f0a 0a20  d key.     */.. 
│ │ │ │ │ +00005b30: 2020 2020 7263 203d 2066 6b6f 5f6e 6577      rc = fko_new
│ │ │ │ │ +00005b40: 5f77 6974 685f 6461 7461 2826 6374 782c  _with_data(&ctx,
│ │ │ │ │ +00005b50: 2073 7061 5f64 6174 612c 206b 6579 2c20   spa_data, key, 
│ │ │ │ │ +00005b60: 6b65 795f 6c65 6e2c 205c 5c0a 2020 2020  key_len, \\.    
│ │ │ │ │ +00005b70: 2020 2020 2065 6e63 5f6d 6f64 652c 2068       enc_mode, h
│ │ │ │ │ +00005b80: 6d61 635f 6b65 792c 2068 6d61 635f 6b65  mac_key, hmac_ke
│ │ │ │ │ +00005b90: 795f 6c65 6e2c 2068 6d61 635f 7479 7065  y_len, hmac_type
│ │ │ │ │ +00005ba0: 293b 0a0a 2020 2020 2069 6628 7263 2021  );..     if(rc !
│ │ │ │ │ +00005bb0: 3d20 464b 4f5f 5355 4343 4553 5329 0a20  = FKO_SUCCESS). 
│ │ │ │ │ +00005bc0: 2020 2020 7b0a 2020 2020 2020 2020 2066      {.         f
│ │ │ │ │ +00005bd0: 7072 696e 7466 2873 7464 6572 722c 2022  printf(stderr, "
│ │ │ │ │ +00005be0: 4572 726f 7220 2569 2066 726f 6d20 666b  Error %i from fk
│ │ │ │ │ +00005bf0: 6f5f 6e65 775f 7769 7468 5f64 6174 613a  o_new_with_data:
│ │ │ │ │ +00005c00: 2025 735c 6e22 2c0a 2020 2020 2020 2020   %s\n",.        
│ │ │ │ │ +00005c10: 2020 2020 2072 632c 2066 6b6f 6572 7273       rc, fkoerrs
│ │ │ │ │ +00005c20: 7472 2872 6329 293b 0a20 2020 2020 2020  tr(rc));.       
│ │ │ │ │ +00005c30: 2020 6578 6974 2831 293b 0a20 2020 2020    exit(1);.     
│ │ │ │ │ +00005c40: 7d0a 0a4f 722c 2070 6572 6861 7073 2079  }..Or, perhaps y
│ │ │ │ │ +00005c50: 6f75 206e 6565 6420 746f 2064 6566 6572  ou need to defer
│ │ │ │ │ +00005c60: 2064 6563 7279 7074 696f 6e20 616e 6420   decryption and 
│ │ │ │ │ +00005c70: 7061 7273 696e 6720 746f 2061 206c 6174  parsing to a lat
│ │ │ │ │ +00005c80: 6572 2070 6f69 6e74 2069 6e0a 7468 6520  er point in.the 
│ │ │ │ │ +00005c90: 7072 6f67 7261 6d2e 2020 5765 2063 6f75  program.  We cou
│ │ │ │ │ +00005ca0: 6c64 2075 7365 2066 6b6f 5f6e 6577 5f77  ld use fko_new_w
│ │ │ │ │ +00005cb0: 6974 685f 6461 7461 2829 2c20 7061 7373  ith_data(), pass
│ │ │ │ │ +00005cc0: 696e 6720 4e55 4c4c 2066 6f72 2074 6865  ing NULL for the
│ │ │ │ │ +00005cd0: 0a64 6563 7279 7074 696f 6e20 6b65 7920  .decryption key 
│ │ │ │ │ +00005ce0: 616e 6420 484d 4143 206b 6579 732c 206f  and HMAC keys, o
│ │ │ │ │ +00005cf0: 7220 7765 2063 6f75 6c64 2075 7365 2066  r we could use f
│ │ │ │ │ +00005d00: 6b6f 5f6e 6577 2829 2074 6f20 6372 6561  ko_new() to crea
│ │ │ │ │ +00005d10: 7465 2061 6e0a 656d 7074 7920 636f 6e74  te an.empty cont
│ │ │ │ │ +00005d20: 6578 742c 2074 6865 6e20 7573 6520 666b  ext, then use fk
│ │ │ │ │ +00005d30: 6f5f 7365 745f 7370 615f 6461 7461 2829  o_set_spa_data()
│ │ │ │ │ +00005d40: 2074 6f20 6164 6420 7468 6520 656e 6379   to add the ency
│ │ │ │ │ +00005d50: 7074 6564 2064 6174 6120 2873 6565 0a63  pted data (see.c
│ │ │ │ │ +00005d60: 6f6d 6d65 6e74 7320 696e 2074 6865 2063  omments in the c
│ │ │ │ │ +00005d70: 6f64 6520 7361 6d70 6c65 7329 2e0a 0a20  ode samples)... 
│ │ │ │ │ +00005d80: 2020 2020 666b 6f5f 6374 785f 7420 2020      fko_ctx_t   
│ │ │ │ │ +00005d90: 6374 783b 0a20 2020 2020 6368 6172 2020  ctx;.     char  
│ │ │ │ │ +00005da0: 2020 2020 202a 7370 615f 6461 7461 3b0a       *spa_data;.
│ │ │ │ │ +00005db0: 2020 2020 2063 6861 7220 2020 2020 2020       char       
│ │ │ │ │ +00005dc0: 2a6b 6579 3b0a 2020 2020 2069 6e74 2072  *key;.     int r
│ │ │ │ │ +00005dd0: 633b 0a0a 2020 2020 202f 2a20 4173 7375  c;..     /* Assu
│ │ │ │ │ +00005de0: 6d65 2077 6520 6361 6c6c 6564 2063 6f64  me we called cod
│ │ │ │ │ +00005df0: 6520 7468 6174 2072 6574 7269 6576 6573  e that retrieves
│ │ │ │ │ +00005e00: 2074 6865 2064 6174 6120 616e 6420 6b65   the data and ke
│ │ │ │ │ +00005e10: 790a 2020 2020 202a 2f0a 0a20 2020 2020  y.     */..     
│ │ │ │ │ +00005e20: 7263 203d 2066 6b6f 5f6e 6577 5f77 6974  rc = fko_new_wit
│ │ │ │ │ +00005e30: 685f 6461 7461 2826 6374 782c 2073 7061  h_data(&ctx, spa
│ │ │ │ │ +00005e40: 5f64 6174 612c 204e 554c 4c2c 2030 2c0a  _data, NULL, 0,.
│ │ │ │ │ +00005e50: 2020 2020 2020 2020 2020 2020 2046 4b4f               FKO
│ │ │ │ │ +00005e60: 5f45 4e43 5f4d 4f44 455f 4342 432c 204e  _ENC_MODE_CBC, N
│ │ │ │ │ +00005e70: 554c 4c2c 2030 2c20 464b 4f5f 484d 4143  ULL, 0, FKO_HMAC
│ │ │ │ │ +00005e80: 5f53 4841 3235 3629 3b0a 0a20 2020 2020  _SHA256);..     
│ │ │ │ │ +00005e90: 6966 2872 6320 213d 2046 4b4f 5f53 5543  if(rc != FKO_SUC
│ │ │ │ │ +00005ea0: 4345 5353 290a 2020 2020 207b 0a20 2020  CESS).     {.   
│ │ │ │ │ +00005eb0: 2020 2020 2020 6670 7269 6e74 6628 7374        fprintf(st
│ │ │ │ │ +00005ec0: 6465 7272 2c20 2245 7272 6f72 2066 726f  derr, "Error fro
│ │ │ │ │ +00005ed0: 6d20 666b 6f5f 6e65 775f 7769 7468 5f64  m fko_new_with_d
│ │ │ │ │ +00005ee0: 6174 613a 2025 735c 6e22 2c0a 2020 2020  ata: %s\n",.    
│ │ │ │ │ +00005ef0: 2020 2020 2020 2020 2066 6b6f 5f65 7272           fko_err
│ │ │ │ │ +00005f00: 7374 7228 7263 2929 3b0a 2020 2020 2020  str(rc));.      
│ │ │ │ │ +00005f10: 2020 2065 7869 7428 3129 3b0a 2020 2020     exit(1);.    
│ │ │ │ │ +00005f20: 207d 0a0a 2020 2020 202f 2a20 5765 2063   }..     /* We c
│ │ │ │ │ +00005f30: 6f75 6c64 2061 6c73 6f20 6a75 7374 2063  ould also just c
│ │ │ │ │ +00005f40: 7265 6174 6520 616e 6420 656d 7074 7920  reate and empty 
│ │ │ │ │ +00005f50: 636f 6e74 6578 7420 616e 6420 6164 6420  context and add 
│ │ │ │ │ +00005f60: 7468 650a 2020 2020 2020 2a20 656e 6372  the.      * encr
│ │ │ │ │ +00005f70: 7970 7465 6420 6461 7461 2061 7320 666f  ypted data as fo
│ │ │ │ │ +00005f80: 6c6c 6f77 733a 0a20 2020 2020 202a 0a20  llows:.      *. 
│ │ │ │ │ +00005f90: 2020 2020 202a 2072 6320 3d20 666b 6f5f       * rc = fko_
│ │ │ │ │ +00005fa0: 6e65 7728 2663 7478 293b 0a20 2020 2020  new(&ctx);.     
│ │ │ │ │ +00005fb0: 202a 202e 2e2e 2063 6865 636b 2072 6320   * ... check rc 
│ │ │ │ │ +00005fc0: 2e2e 2e0a 2020 2020 2020 2a20 7263 203d  ....      * rc =
│ │ │ │ │ +00005fd0: 2066 6b6f 5f73 6574 5f73 7061 5f64 6174   fko_set_spa_dat
│ │ │ │ │ +00005fe0: 6128 6374 782c 2073 7061 5f64 6174 6129  a(ctx, spa_data)
│ │ │ │ │ +00005ff0: 3b0a 2020 2020 2020 2a20 2e2e 2e0a 2020  ;.      * ....  
│ │ │ │ │ +00006000: 2020 202a 2f0a 0a20 2020 2020 2f2a 2041     */..     /* A
│ │ │ │ │ +00006010: 7373 756d 6520 7765 2063 616c 6c65 6420  ssume we called 
│ │ │ │ │ +00006020: 6f74 6865 7220 636f 6465 2061 6e64 2066  other code and f
│ │ │ │ │ +00006030: 756e 6374 696f 6e73 2e2e 2e20 202a 2f0a  unctions...  */.
│ │ │ │ │ +00006040: 0a20 2020 2020 2f2a 2056 6572 6966 7920  .     /* Verify 
│ │ │ │ │ +00006050: 484d 4143 0a20 2020 2020 2a2f 0a20 2020  HMAC.     */.   
│ │ │ │ │ +00006060: 2020 7263 203d 2066 6b6f 5f76 6572 6966    rc = fko_verif
│ │ │ │ │ +00006070: 795f 686d 6163 2863 7478 2c20 686d 6163  y_hmac(ctx, hmac
│ │ │ │ │ +00006080: 5f6b 6579 2c20 686d 6163 5f6b 6579 5f6c  _key, hmac_key_l
│ │ │ │ │ +00006090: 656e 293b 0a20 2020 2020 6966 2872 6320  en);.     if(rc 
│ │ │ │ │ +000060a0: 213d 2046 4b4f 5f53 5543 4345 5353 290a  != FKO_SUCCESS).
│ │ │ │ │ +000060b0: 2020 2020 207b 0a20 2020 2020 2020 2020       {.         
│ │ │ │ │ +000060c0: 6670 7269 6e74 6628 7374 6465 7272 2c20  fprintf(stderr, 
│ │ │ │ │ +000060d0: 2245 7272 6f72 2066 726f 6d20 666b 6f5f  "Error from fko_
│ │ │ │ │ +000060e0: 7665 7269 6679 5f68 6d61 633a 2025 735c  verify_hmac: %s\
│ │ │ │ │ +000060f0: 6e22 2c0a 2020 2020 2020 2020 2020 2020  n",.            
│ │ │ │ │ +00006100: 2066 6b6f 5f65 7272 7374 7228 7263 2929   fko_errstr(rc))
│ │ │ │ │ +00006110: 3b0a 2020 2020 2020 2020 2065 7869 7428  ;.         exit(
│ │ │ │ │ +00006120: 3129 3b0a 2020 2020 207d 0a0a 2020 2020  1);.     }..    
│ │ │ │ │ +00006130: 202f 2a20 4465 6372 7970 7420 616e 6420   /* Decrypt and 
│ │ │ │ │ +00006140: 6465 636f 6465 2e2e 2e0a 2020 2020 202a  decode....     *
│ │ │ │ │ +00006150: 2f0a 2020 2020 2072 6320 3d20 666b 6f5f  /.     rc = fko_
│ │ │ │ │ +00006160: 6465 6372 7970 745f 7370 615f 6461 7461  decrypt_spa_data
│ │ │ │ │ +00006170: 2863 7478 2c20 6b65 792c 206b 6579 5f6c  (ctx, key, key_l
│ │ │ │ │ +00006180: 656e 293b 0a0a 2020 2020 2069 6628 7263  en);..     if(rc
│ │ │ │ │ +00006190: 2021 3d20 464b 4f5f 5355 4343 4553 5329   != FKO_SUCCESS)
│ │ │ │ │ +000061a0: 0a20 2020 2020 7b0a 2020 2020 2020 2020  .     {.        
│ │ │ │ │ +000061b0: 2066 7072 696e 7466 2873 7464 6572 722c   fprintf(stderr,
│ │ │ │ │ +000061c0: 2022 4572 726f 7220 6672 6f6d 2066 6b6f   "Error from fko
│ │ │ │ │ +000061d0: 5f64 6563 7279 7074 5f73 7061 5f64 6174  _decrypt_spa_dat
│ │ │ │ │ +000061e0: 613a 2025 735c 6e22 2c0a 2020 2020 2020  a: %s\n",.      
│ │ │ │ │ +000061f0: 2020 2020 2020 2066 6b6f 5f65 7272 7374         fko_errst
│ │ │ │ │ +00006200: 7228 7263 2929 3b0a 2020 2020 2020 2020  r(rc));.        
│ │ │ │ │ +00006210: 2065 7869 7428 3129 3b0a 2020 2020 207d   exit(1);.     }
│ │ │ │ │ +00006220: 0a0a 1f0a 4669 6c65 3a20 6c69 6266 6b6f  ....File: libfko
│ │ │ │ │ +00006230: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4465  .info,  Node: De
│ │ │ │ │ +00006240: 7374 726f 7969 6e67 2043 6f6e 7465 7874  stroying Context
│ │ │ │ │ +00006250: 732c 2020 4e65 7874 3a20 4372 6561 7469  s,  Next: Creati
│ │ │ │ │ +00006260: 6e67 2061 2053 5041 204d 6573 7361 6765  ng a SPA Message
│ │ │ │ │ +00006270: 2c20 2050 7265 763a 2043 7265 6174 696e  ,  Prev: Creatin
│ │ │ │ │ +00006280: 6720 436f 6e74 6578 7473 2c20 2055 703a  g Contexts,  Up:
│ │ │ │ │ +00006290: 2055 7369 6e67 206c 6962 666b 6f0a 0a33   Using libfko..3
│ │ │ │ │ +000062a0: 2e32 2044 6573 7472 6f79 696e 6720 436f  .2 Destroying Co
│ │ │ │ │ +000062b0: 6e74 6578 7473 0a3d 3d3d 3d3d 3d3d 3d3d  ntexts.=========
│ │ │ │ │ +000062c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a  ==============..
│ │ │ │ │ +000062d0: 5768 656e 2079 6f75 2061 7265 2064 6f6e  When you are don
│ │ │ │ │ +000062e0: 6520 7769 7468 2074 6865 2063 6f6e 7465  e with the conte
│ │ │ │ │ +000062f0: 7874 2c20 796f 7520 6d75 7374 2064 6573  xt, you must des
│ │ │ │ │ +00006300: 7472 6f79 2069 7420 696e 206f 7264 6572  troy it in order
│ │ │ │ │ +00006310: 2074 6f20 6672 6565 0a75 7020 7468 6520   to free.up the 
│ │ │ │ │ +00006320: 6d65 6d6f 7279 2061 6e64 2072 6573 6f75  memory and resou
│ │ │ │ │ +00006330: 7263 6573 2069 7420 7761 7320 7573 696e  rces it was usin
│ │ │ │ │ +00006340: 672e 2020 5468 6973 2069 7320 6573 7065  g.  This is espe
│ │ │ │ │ +00006350: 6369 616c 6c79 2069 6d70 6f72 7461 6e74  cially important
│ │ │ │ │ +00006360: 0a69 6e20 7072 6f67 7261 6d73 2074 6861  .in programs tha
│ │ │ │ │ +00006370: 7420 7072 6f63 6573 7320 5350 4120 6461  t process SPA da
│ │ │ │ │ +00006380: 7461 2072 6570 6561 7465 646c 7920 2869  ta repeatedly (i
│ │ │ │ │ +00006390: 2e65 2e20 2069 6e20 6120 6c6f 6f70 292e  .e.  in a loop).
│ │ │ │ │ +000063a0: 2020 4661 696c 7572 650a 746f 2064 6573    Failure.to des
│ │ │ │ │ +000063b0: 7472 6f79 2074 6865 2063 6f6e 7465 7874  troy the context
│ │ │ │ │ +000063c0: 2063 616e 2063 6175 7365 206d 656d 6f72   can cause memor
│ │ │ │ │ +000063d0: 7920 6c65 616b 7320 696e 2079 6f75 7220  y leaks in your 
│ │ │ │ │ +000063e0: 7072 6f67 7261 6d2e 0a0a 202d 2d20 4675  program... -- Fu
│ │ │ │ │ +000063f0: 6e63 7469 6f6e 3a20 766f 6964 2066 6b6f  nction: void fko
│ │ │ │ │ +00006400: 5f64 6573 7472 6f79 2028 666b 6f5f 6374  _destroy (fko_ct
│ │ │ │ │ +00006410: 785f 7420 4354 5829 0a20 2020 2020 5468  x_t CTX).     Th
│ │ │ │ │ +00006420: 6520 6675 6e63 7469 6f6e 2027 666b 6f5f  e function 'fko_
│ │ │ │ │ +00006430: 6465 7374 726f 7927 2064 6573 7472 6f79  destroy' destroy
│ │ │ │ │ +00006440: 7320 7468 6520 636f 6e74 6578 7420 7769  s the context wi
│ │ │ │ │ +00006450: 7468 2074 6865 2068 616e 646c 6520 4354  th the handle CT
│ │ │ │ │ +00006460: 580a 2020 2020 2061 6e64 2072 656c 6561  X.     and relea
│ │ │ │ │ +00006470: 7365 7320 616c 6c20 6173 736f 6369 6174  ses all associat
│ │ │ │ │ +00006480: 6564 2072 6573 6f75 7263 6573 2e0a 0a1f  ed resources....
│ │ │ │ │ +00006490: 0a46 696c 653a 206c 6962 666b 6f2e 696e  .File: libfko.in
│ │ │ │ │ +000064a0: 666f 2c20 204e 6f64 653a 2043 7265 6174  fo,  Node: Creat
│ │ │ │ │ +000064b0: 696e 6720 6120 5350 4120 4d65 7373 6167  ing a SPA Messag
│ │ │ │ │ +000064c0: 652c 2020 4e65 7874 3a20 5365 7474 696e  e,  Next: Settin
│ │ │ │ │ +000064d0: 6720 5350 4120 4461 7461 2c20 2050 7265  g SPA Data,  Pre
│ │ │ │ │ +000064e0: 763a 2044 6573 7472 6f79 696e 6720 436f  v: Destroying Co
│ │ │ │ │ +000064f0: 6e74 6578 7473 2c20 2055 703a 2055 7369  ntexts,  Up: Usi
│ │ │ │ │ +00006500: 6e67 206c 6962 666b 6f0a 0a33 2e33 2043  ng libfko..3.3 C
│ │ │ │ │ +00006510: 7265 6174 696e 6720 6120 5350 4120 4d65  reating a SPA Me
│ │ │ │ │ +00006520: 7373 6167 650a 3d3d 3d3d 3d3d 3d3d 3d3d  ssage.==========
│ │ │ │ │  00006530: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ │ -00006540: 3d3d 0a0a 5468 6973 2073 6563 7469 6f6e  ==..This section
│ │ │ │ │ -00006550: 2064 6573 6372 6962 6573 2074 6865 2070   describes the p
│ │ │ │ │ -00006560: 726f 6365 7373 2066 6f72 2063 7265 6174  rocess for creat
│ │ │ │ │ -00006570: 696e 6720 6120 6e65 7720 666b 6f20 5350  ing a new fko SP
│ │ │ │ │ -00006580: 4120 6d65 7373 6167 652e 0a41 6674 6572  A message..After
│ │ │ │ │ -00006590: 2063 7265 6174 696e 6720 6120 636f 6e74   creating a cont
│ │ │ │ │ -000065a0: 6578 742c 2074 6865 7265 2061 7265 2073  ext, there are s
│ │ │ │ │ -000065b0: 7469 6c6c 2073 6f6d 6520 7265 7175 6973  till some requis
│ │ │ │ │ -000065c0: 6974 6520 5350 4120 6461 7461 2066 6965  ite SPA data fie
│ │ │ │ │ -000065d0: 6c64 730a 616e 6420 5350 4120 7061 7261  lds.and SPA para
│ │ │ │ │ -000065e0: 6d65 7465 7273 2074 6861 7420 6e65 6564  meters that need
│ │ │ │ │ -000065f0: 2074 6f20 6265 2073 6574 2062 6566 6f72   to be set befor
│ │ │ │ │ -00006600: 6520 7468 6520 6669 6e61 6c20 656e 6372  e the final encr
│ │ │ │ │ -00006610: 7970 7465 640a 6d65 7373 6167 6520 6973  ypted.message is
│ │ │ │ │ -00006620: 2072 6561 6479 2e0a 0a20 2020 5468 6520   ready...   The 
│ │ │ │ │ -00006630: 666f 6c6c 6f77 696e 6720 6c69 7374 2063  following list c
│ │ │ │ │ -00006640: 6f6e 7461 696e 7320 7468 6520 6d69 6e69  ontains the mini
│ │ │ │ │ -00006650: 6d75 6d20 7265 7175 6972 6564 2066 6965  mum required fie
│ │ │ │ │ -00006660: 6c64 7320 666f 7220 610a 636f 6d70 6c65  lds for a.comple
│ │ │ │ │ -00006670: 7465 2066 6b6f 2053 5041 206d 6573 7361  te fko SPA messa
│ │ │ │ │ -00006680: 6765 2e20 2059 6f75 2073 686f 756c 6420  ge.  You should 
│ │ │ │ │ -00006690: 616c 736f 2074 616b 6520 6e6f 7465 206f  also take note o
│ │ │ │ │ -000066a0: 6620 7468 6520 6f72 6465 7220 6f66 0a74  f the order of.t
│ │ │ │ │ -000066b0: 6865 7365 2070 6172 616d 6574 6572 7320  hese parameters 
│ │ │ │ │ -000066c0: 6173 2077 656c 6c2e 2020 5365 7474 696e  as well.  Settin
│ │ │ │ │ -000066d0: 6720 7468 6520 2274 7970 6522 2070 6172  g the "type" par
│ │ │ │ │ -000066e0: 616d 6574 6572 7320 6669 7273 7420 6973  ameters first is
│ │ │ │ │ -000066f0: 0a72 6563 6f6d 6d65 6e64 6564 2028 6966  .recommended (if
│ │ │ │ │ -00006700: 2079 6f75 2077 616e 7420 6120 7479 7065   you want a type
│ │ │ │ │ -00006710: 206f 7468 6572 2074 6861 6e20 7468 6520   other than the 
│ │ │ │ │ -00006720: 6465 6661 756c 7429 2e0a 0a20 2020 2a20  default)...   * 
│ │ │ │ │ -00006730: 6469 6765 7374 5f74 7970 6520 2d20 5f28  digest_type - _(
│ │ │ │ │ -00006740: 6465 6661 756c 7420 6d61 7920 7375 6666  default may suff
│ │ │ │ │ -00006750: 6963 6529 5f0a 2020 202a 206d 6573 7361  ice)_.   * messa
│ │ │ │ │ -00006760: 6765 5f74 7970 6520 2d20 5f28 6465 6661  ge_type - _(defa
│ │ │ │ │ -00006770: 756c 7420 6d61 7920 7375 6666 6963 6529  ult may suffice)
│ │ │ │ │ -00006780: 5f0a 2020 202a 2065 6e63 7279 7074 696f  _.   * encryptio
│ │ │ │ │ -00006790: 6e5f 7479 7065 202d 205f 2864 6566 6175  n_type - _(defau
│ │ │ │ │ -000067a0: 6c74 206d 6179 2073 7566 6669 6365 295f  lt may suffice)_
│ │ │ │ │ -000067b0: 0a20 2020 2a20 7261 6e64 5f76 616c 202d  .   * rand_val -
│ │ │ │ │ -000067c0: 205f 2864 6566 6175 6c74 2073 686f 756c   _(default shoul
│ │ │ │ │ -000067d0: 6420 7375 6666 6963 6529 5f0a 2020 202a  d suffice)_.   *
│ │ │ │ │ -000067e0: 2074 696d 655f 7374 616d 7020 2d20 5f28   time_stamp - _(
│ │ │ │ │ -000067f0: 6465 6661 756c 7420 7368 6f75 6c64 2073  default should s
│ │ │ │ │ -00006800: 7566 6669 6365 295f 0a20 2020 2a20 7573  uffice)_.   * us
│ │ │ │ │ -00006810: 6572 6e61 6d65 202d 205f 2864 6566 6175  ername - _(defau
│ │ │ │ │ -00006820: 6c74 206d 6179 2073 7566 6669 6365 295f  lt may suffice)_
│ │ │ │ │ -00006830: 0a20 2020 2a20 7370 615f 6d65 7373 6167  .   * spa_messag
│ │ │ │ │ -00006840: 6520 2d20 5f28 6d75 7374 2062 6520 6578  e - _(must be ex
│ │ │ │ │ -00006850: 706c 6963 6974 6c79 2073 6574 295f 0a0a  plicitly set)_..
│ │ │ │ │ -00006860: 5f49 6620 7573 696e 6720 6770 6720 656e  _If using gpg en
│ │ │ │ │ -00006870: 6372 7970 7469 6f6e 3a5f 0a0a 2020 202a  cryption:_..   *
│ │ │ │ │ -00006880: 2067 7067 5f72 6563 6970 6965 6e74 202d   gpg_recipient -
│ │ │ │ │ -00006890: 205f 286d 7573 7420 6265 2065 7870 6c69   _(must be expli
│ │ │ │ │ -000068a0: 6369 746c 7920 7365 7429 5f0a 2020 202a  citly set)_.   *
│ │ │ │ │ -000068b0: 2067 7067 5f73 6967 6e65 7220 2d20 5f28   gpg_signer - _(
│ │ │ │ │ -000068c0: 6f70 7469 6f6e 616c 2c20 6275 7420 7265  optional, but re
│ │ │ │ │ -000068d0: 636f 6d6d 656e 6465 6420 2d20 6d75 7374  commended - must
│ │ │ │ │ -000068e0: 2062 6520 6578 706c 6963 6974 6c79 2073   be explicitly s
│ │ │ │ │ -000068f0: 6574 0a20 2020 2020 6966 2075 7365 6429  et.     if used)
│ │ │ │ │ -00006900: 5f0a 2020 202a 2067 7067 5f68 6f6d 655f  _.   * gpg_home_
│ │ │ │ │ -00006910: 6469 7220 2d20 5f28 6465 6661 756c 7420  dir - _(default 
│ │ │ │ │ -00006920: 6d61 7920 7375 6666 6963 6520 2d20 7479  may suffice - ty
│ │ │ │ │ -00006930: 7069 6361 6c6c 7920 2448 4f4d 452f 2e67  pically $HOME/.g
│ │ │ │ │ -00006940: 6e75 7067 295f 0a0a 2020 2057 6865 6e20  nupg)_..   When 
│ │ │ │ │ -00006950: 6120 636f 6e74 6578 7420 6973 2069 6e69  a context is ini
│ │ │ │ │ -00006960: 7469 616c 697a 6564 2c20 736f 6d65 206f  tialized, some o
│ │ │ │ │ -00006970: 6620 7468 6520 5350 4120 6461 7461 2066  f the SPA data f
│ │ │ │ │ -00006980: 6965 6c64 7320 6172 650a 7072 652d 7365  ields are.pre-se
│ │ │ │ │ -00006990: 7420 7769 7468 2064 6566 6175 6c74 2076  t with default v
│ │ │ │ │ -000069a0: 616c 7565 7320 282a 6e6f 7465 2053 5041  alues (*note SPA
│ │ │ │ │ -000069b0: 2044 6174 6120 466f 726d 6174 3a3a 292e   Data Format::).
│ │ │ │ │ -000069c0: 2020 466f 7220 6669 656c 6473 2073 7563    For fields suc
│ │ │ │ │ -000069d0: 680a 6173 2027 7261 6e64 5f76 616c 272c  h.as 'rand_val',
│ │ │ │ │ -000069e0: 2027 7573 6572 6e61 6d65 272c 2027 7469   'username', 'ti
│ │ │ │ │ -000069f0: 6d65 7374 616d 7027 2c20 276d 6573 7361  mestamp', 'messa
│ │ │ │ │ -00006a00: 6765 5f74 7970 6527 2c20 616e 640a 2764  ge_type', and.'d
│ │ │ │ │ -00006a10: 6967 6573 745f 7479 7065 272c 2074 6865  igest_type', the
│ │ │ │ │ -00006a20: 7365 2064 6566 6175 6c74 7320 6d61 7920  se defaults may 
│ │ │ │ │ -00006a30: 6265 2073 7566 6669 6369 656e 742e 0a0a  be sufficient...
│ │ │ │ │ -00006a40: 2020 2054 6865 2066 756e 6374 696f 6e73     The functions
│ │ │ │ │ -00006a50: 2075 7365 6420 746f 2073 6574 2074 6865   used to set the
│ │ │ │ │ -00006a60: 2076 6172 696f 7573 2053 5041 2064 6174   various SPA dat
│ │ │ │ │ -00006a70: 6120 6669 656c 6473 2061 6e64 2070 6172  a fields and par
│ │ │ │ │ -00006a80: 616d 6574 6572 730a 6172 6520 6465 7363  ameters.are desc
│ │ │ │ │ -00006a90: 7269 6265 6420 696e 2064 6574 6169 6c20  ribed in detail 
│ │ │ │ │ -00006aa0: 696e 202a 6e6f 7465 2053 6574 7469 6e67  in *note Setting
│ │ │ │ │ -00006ab0: 2053 5041 2044 6174 613a 3a2e 0a0a 2a4e   SPA Data::...*N
│ │ │ │ │ -00006ac0: 6f74 652a 3a20 4174 7465 6d70 7473 2074  ote*: Attempts t
│ │ │ │ │ -00006ad0: 6f20 6361 6c6c 2061 6e79 2022 2766 6b6f  o call any "'fko
│ │ │ │ │ -00006ae0: 5f27 2220 6675 6e63 7469 6f6e 206f 6e20  _'" function on 
│ │ │ │ │ -00006af0: 6120 636f 6e74 6578 7420 7468 6174 2068  a context that h
│ │ │ │ │ -00006b00: 6173 206e 6f74 0a62 6565 6e20 696e 6974  as not.been init
│ │ │ │ │ -00006b10: 6961 6c69 7a65 6420 6361 6e20 6861 7665  ialized can have
│ │ │ │ │ -00006b20: 2075 6e64 6566 696e 6564 2063 6f6e 7365   undefined conse
│ │ │ │ │ -00006b30: 7175 656e 6365 732e 2020 4c69 6266 6b6f  quences.  Libfko
│ │ │ │ │ -00006b40: 2077 696c 6c20 6174 7465 6d70 740a 746f   will attempt.to
│ │ │ │ │ -00006b50: 2072 6563 6f76 6572 2c20 616e 6420 6966   recover, and if
│ │ │ │ │ -00006b60: 2073 7563 6365 7373 6675 6c2c 2077 696c   successful, wil
│ │ │ │ │ -00006b70: 6c20 7265 7475 726e 2061 2073 7461 7475  l return a statu
│ │ │ │ │ -00006b80: 7320 6f66 0a27 464b 4f5f 4552 524f 525f  s of.'FKO_ERROR_
│ │ │ │ │ -00006b90: 4354 585f 4e4f 545f 494e 4954 4941 4c49  CTX_NOT_INITIALI
│ │ │ │ │ -00006ba0: 5a45 4427 2e0a 0a20 2020 4120 636f 6d6d  ZED'...   A comm
│ │ │ │ │ -00006bb0: 6f6e 2053 5041 206d 6573 7361 6765 2069  on SPA message i
│ │ │ │ │ -00006bc0: 7320 6120 7369 6d70 6c65 2061 6363 6573  s a simple acces
│ │ │ │ │ -00006bd0: 7320 7265 7175 6573 742e 2020 5468 6973  s request.  This
│ │ │ │ │ -00006be0: 2072 6571 7565 7374 2061 736b 730a 7468   request asks.th
│ │ │ │ │ -00006bf0: 6520 6677 6b6e 6f70 2073 6572 7665 7220  e fwknop server 
│ │ │ │ │ -00006c00: 746f 2063 7265 6174 6520 6120 7465 6d70  to create a temp
│ │ │ │ │ -00006c10: 6f72 6172 7920 6669 7265 7761 6c6c 2072  orary firewall r
│ │ │ │ │ -00006c20: 756c 6520 746f 2061 6c6c 6f77 2061 0a70  ule to allow a.p
│ │ │ │ │ -00006c30: 6172 7469 6375 6c61 7220 4950 2061 6464  articular IP add
│ │ │ │ │ -00006c40: 7265 7373 2061 6363 6573 7320 746f 2061  ress access to a
│ │ │ │ │ -00006c50: 2070 6172 7469 6375 6c61 7220 706f 7274   particular port
│ │ │ │ │ -00006c60: 206f 6e20 7468 6520 6677 6b6e 6f70 2073   on the fwknop s
│ │ │ │ │ -00006c70: 6572 7665 722e 0a41 7373 756d 696e 6720  erver..Assuming 
│ │ │ │ │ -00006c80: 7468 6520 6465 6661 756c 7473 2061 7265  the defaults are
│ │ │ │ │ -00006c90: 2066 696e 6520 666f 7220 7468 6973 2c20   fine for this, 
│ │ │ │ │ -00006ca0: 616c 6c20 7765 206e 6565 6420 746f 2064  all we need to d
│ │ │ │ │ -00006cb0: 6f20 6973 2063 7265 6174 6520 7468 650a  o is create the.
│ │ │ │ │ -00006cc0: 636f 6e74 6578 742c 2073 6574 2074 6865  context, set the
│ │ │ │ │ -00006cd0: 206d 6573 7361 6765 2064 6174 6120 6669   message data fi
│ │ │ │ │ -00006ce0: 656c 642c 2063 616c 6c20 7468 6520 2766  eld, call the 'f
│ │ │ │ │ -00006cf0: 6b6f 5f73 7061 5f64 6174 615f 6669 6e61  ko_spa_data_fina
│ │ │ │ │ -00006d00: 6c27 0a66 756e 6374 696f 6e20 746f 2065  l'.function to e
│ │ │ │ │ -00006d10: 6e63 6f64 6520 616e 6420 656e 6372 7970  ncode and encryp
│ │ │ │ │ -00006d20: 742c 2070 726f 6365 7373 2074 6865 206d  t, process the m
│ │ │ │ │ -00006d30: 6573 7361 6765 2c20 7468 656e 2064 6573  essage, then des
│ │ │ │ │ -00006d40: 7472 6f79 2074 6865 0a63 6f6e 7465 7874  troy the.context
│ │ │ │ │ -00006d50: 2e20 2042 656c 6f77 2c20 7765 2068 6176  .  Below, we hav
│ │ │ │ │ -00006d60: 6520 6120 636f 6e74 7269 7665 6420 6269  e a contrived bi
│ │ │ │ │ -00006d70: 7420 6f66 2063 6f64 6520 6465 6d6f 6e73  t of code demons
│ │ │ │ │ -00006d80: 7472 6174 696e 6720 7468 6973 3a0a 0a20  trating this:.. 
│ │ │ │ │ -00006d90: 2020 2020 696e 740a 2020 2020 206d 6169      int.     mai
│ │ │ │ │ -00006da0: 6e28 696e 7420 6172 6763 2c20 6368 6172  n(int argc, char
│ │ │ │ │ -00006db0: 202a 2a61 7267 7629 0a20 2020 2020 7b0a   **argv).     {.
│ │ │ │ │ -00006dc0: 2020 2020 2020 2020 2066 6b6f 5f63 7478           fko_ctx
│ │ │ │ │ -00006dd0: 5f74 2020 2063 7478 3b20 2020 2020 2020  _t   ctx;       
│ │ │ │ │ -00006de0: 2020 2020 2f2a 2046 4b4f 2043 6f6e 7465      /* FKO Conte
│ │ │ │ │ -00006df0: 7874 202a 2f0a 2020 2020 2020 2020 2063  xt */.         c
│ │ │ │ │ -00006e00: 6861 7220 2020 2020 2020 2a6b 6579 3b20  har       *key; 
│ │ │ │ │ -00006e10: 2020 2020 2020 2020 2020 2f2a 2045 6e63            /* Enc
│ │ │ │ │ -00006e20: 7279 7074 696f 6e20 7061 7373 7068 7261  ryption passphra
│ │ │ │ │ -00006e30: 7365 202a 2f0a 2020 2020 2020 2020 2063  se */.         c
│ │ │ │ │ -00006e40: 6861 7220 2020 2020 2020 2a68 6d61 635f  har       *hmac_
│ │ │ │ │ -00006e50: 6b65 793b 2020 2020 2020 2f2a 2048 4d41  key;      /* HMA
│ │ │ │ │ -00006e60: 4320 6b65 7920 2a2f 0a20 2020 2020 2020  C key */.       
│ │ │ │ │ -00006e70: 2020 6368 6172 2020 2020 2020 202a 6669    char       *fi
│ │ │ │ │ -00006e80: 6e61 6c5f 7370 613b 2020 2020 202f 2a20  nal_spa;     /* 
│ │ │ │ │ -00006e90: 4669 6e61 6c20 656e 6372 7970 7465 6420  Final encrypted 
│ │ │ │ │ -00006ea0: 5350 4120 6461 7461 202a 2f0a 2020 2020  SPA data */.    
│ │ │ │ │ -00006eb0: 2020 2020 2069 6e74 2020 2020 2020 2020       int        
│ │ │ │ │ -00006ec0: 206b 6579 5f6c 656e 3b20 2020 2020 2020   key_len;       
│ │ │ │ │ -00006ed0: 2f2a 204c 656e 6774 6820 6f66 2065 6e63  /* Length of enc
│ │ │ │ │ -00006ee0: 7279 7074 696f 6e20 6b65 7920 2a2f 0a20  ryption key */. 
│ │ │ │ │ -00006ef0: 2020 2020 2020 2020 696e 7420 2020 2020          int     
│ │ │ │ │ -00006f00: 2020 2020 686d 6163 5f6b 6579 5f6c 656e      hmac_key_len
│ │ │ │ │ -00006f10: 3b20 202f 2a20 4c65 6e67 7468 206f 6620  ;  /* Length of 
│ │ │ │ │ -00006f20: 484d 4143 206b 6579 202a 2f0a 2020 2020  HMAC key */.    
│ │ │ │ │ -00006f30: 2020 2020 2069 6e74 2020 2020 2020 2020       int        
│ │ │ │ │ -00006f40: 2072 633b 2020 2020 2020 2020 2020 2020   rc;            
│ │ │ │ │ -00006f50: 2f2a 2052 6573 756c 7420 636f 6465 202a  /* Result code *
│ │ │ │ │ -00006f60: 2f0a 2020 2020 2020 2020 2069 6e74 2020  /.         int  
│ │ │ │ │ -00006f70: 2020 2020 2020 2068 6d61 635f 7479 7065         hmac_type
│ │ │ │ │ -00006f80: 203d 2046 4b4f 5f48 4d41 435f 5348 4132   = FKO_HMAC_SHA2
│ │ │ │ │ -00006f90: 3536 3b20 2020 2f2a 2044 6566 6175 6c74  56;   /* Default
│ │ │ │ │ -00006fa0: 2048 4d41 4320 6469 6765 7374 202a 2f0a   HMAC digest */.
│ │ │ │ │ -00006fb0: 2020 2020 2020 2020 2069 6e74 2020 2020           int    
│ │ │ │ │ -00006fc0: 2020 2020 2065 6e63 5f6d 6f64 6520 203d       enc_mode  =
│ │ │ │ │ -00006fd0: 2046 4b4f 5f45 4e43 5f4d 4f44 455f 4153   FKO_ENC_MODE_AS
│ │ │ │ │ -00006fe0: 594d 4d45 5452 4943 3b20 202f 2a20 5573  YMMETRIC;  /* Us
│ │ │ │ │ -00006ff0: 6520 4750 4720 2a2f 0a0a 2020 2020 2020  e GPG */..      
│ │ │ │ │ -00007000: 2020 202f 2a20 2041 7373 756d 6520 7765     /*  Assume we
│ │ │ │ │ -00007010: 2070 726f 6365 7373 6564 2074 6865 2063   processed the c
│ │ │ │ │ -00007020: 6f6d 6d61 6e64 206c 696e 650a 2020 2020  ommand line.    
│ │ │ │ │ -00007030: 2020 2020 2020 2a20 2061 6e64 2072 6574        *  and ret
│ │ │ │ │ -00007040: 7269 6576 6564 2074 6865 2070 6173 7377  rieved the passw
│ │ │ │ │ -00007050: 6f72 6420 616e 6420 7468 6520 484d 4143  ord and the HMAC
│ │ │ │ │ -00007060: 206b 6579 2061 6e64 0a20 2020 2020 2020   key and.       
│ │ │ │ │ -00007070: 2020 2a20 2020 7365 7420 7468 6569 7220    *   set their 
│ │ │ │ │ -00007080: 6173 736f 6369 6174 6564 206c 656e 6774  associated lengt
│ │ │ │ │ -00007090: 6873 2e0a 2020 2020 2020 2020 202a 2f0a  hs..         */.
│ │ │ │ │ -000070a0: 0a20 2020 2020 2020 2020 2f2a 2043 7265  .         /* Cre
│ │ │ │ │ -000070b0: 6174 6520 7468 6520 636f 6e74 6578 7420  ate the context 
│ │ │ │ │ -000070c0: 2a2f 0a20 2020 2020 2020 2020 7263 203d  */.         rc =
│ │ │ │ │ -000070d0: 2066 6b6f 5f6e 6577 2826 6374 7829 3b0a   fko_new(&ctx);.
│ │ │ │ │ -000070e0: 2020 2020 2020 2020 2069 6628 7263 2021           if(rc !
│ │ │ │ │ -000070f0: 3d20 464b 4f5f 5355 4343 4553 5329 0a20  = FKO_SUCCESS). 
│ │ │ │ │ -00007100: 2020 2020 2020 2020 7b0a 2020 2020 2020          {.      
│ │ │ │ │ -00007110: 2020 2020 2020 2066 7072 696e 7466 2873         fprintf(s
│ │ │ │ │ -00007120: 7464 6572 722c 2022 4572 726f 7220 6372  tderr, "Error cr
│ │ │ │ │ -00007130: 6561 7469 6e67 2063 6f6e 7465 7874 3a20  eating context: 
│ │ │ │ │ -00007140: 2573 5c6e 222c 2066 6b6f 5f65 7272 7374  %s\n", fko_errst
│ │ │ │ │ -00007150: 7228 7263 2929 3b0a 2020 2020 2020 2020  r(rc));.        
│ │ │ │ │ -00007160: 2020 2020 2065 7869 7428 3129 3b0a 2020       exit(1);.  
│ │ │ │ │ -00007170: 2020 2020 2020 207d 0a0a 2020 2020 2020         }..      
│ │ │ │ │ -00007180: 2020 202f 2a20 5365 7420 7468 6520 5350     /* Set the SP
│ │ │ │ │ -00007190: 4120 6d65 7373 6167 6520 6669 656c 6420  A message field 
│ │ │ │ │ -000071a0: 2d20 6173 6b69 6e67 2074 6f20 6f70 656e  - asking to open
│ │ │ │ │ -000071b0: 2074 6370 2070 6f72 7420 3232 0a20 2020   tcp port 22.   
│ │ │ │ │ -000071c0: 2020 2020 2020 202a 2066 6f72 2074 6865         * for the
│ │ │ │ │ -000071d0: 2073 7973 7465 6d20 6174 2031 3932 2e31   system at 192.1
│ │ │ │ │ -000071e0: 3638 2e30 2e33 330a 2020 2020 2020 2020  68.0.33.        
│ │ │ │ │ -000071f0: 202a 2f0a 2020 2020 2020 2020 2072 6320   */.         rc 
│ │ │ │ │ -00007200: 3d20 666b 6f5f 7365 745f 7370 615f 6d65  = fko_set_spa_me
│ │ │ │ │ -00007210: 7373 6167 6528 6374 782c 2022 3139 322e  ssage(ctx, "192.
│ │ │ │ │ -00007220: 3136 382e 302e 3333 2c74 6370 2f32 3222  168.0.33,tcp/22"
│ │ │ │ │ -00007230: 293b 0a20 2020 2020 2020 2020 6966 2872  );.         if(r
│ │ │ │ │ -00007240: 6320 213d 2046 4b4f 5f53 5543 4345 5353  c != FKO_SUCCESS
│ │ │ │ │ -00007250: 290a 2020 2020 2020 2020 207b 0a20 2020  ).         {.   
│ │ │ │ │ -00007260: 2020 2020 2020 2020 2020 6670 7269 6e74            fprint
│ │ │ │ │ -00007270: 6628 7374 6465 7272 2c20 2253 6574 2053  f(stderr, "Set S
│ │ │ │ │ -00007280: 5041 206d 6573 7361 6765 2066 6169 6c65  PA message faile
│ │ │ │ │ -00007290: 643a 2025 735c 6e22 2c20 666b 6f5f 6572  d: %s\n", fko_er
│ │ │ │ │ -000072a0: 7273 7472 2872 6329 293b 0a20 2020 2020  rstr(rc));.     
│ │ │ │ │ -000072b0: 2020 2020 2020 2020 6578 6974 2831 293b          exit(1);
│ │ │ │ │ -000072c0: 0a20 2020 2020 2020 2020 7d0a 0a20 2020  .         }..   
│ │ │ │ │ -000072d0: 2020 2020 2020 2f2a 204c 6574 2075 7320        /* Let us 
│ │ │ │ │ -000072e0: 6173 7375 6d65 2077 6520 6172 6520 7573  assume we are us
│ │ │ │ │ -000072f0: 696e 6720 4750 4720 656e 6372 7970 7469  ing GPG encrypti
│ │ │ │ │ -00007300: 6f6e 2e20 2053 6f20 7765 206e 6565 6420  on.  So we need 
│ │ │ │ │ -00007310: 746f 0a20 2020 2020 2020 2020 202a 2073  to.          * s
│ │ │ │ │ -00007320: 6574 2074 6865 2065 6e63 7279 7074 696f  et the encryptio
│ │ │ │ │ -00007330: 6e20 7479 7065 2061 6e64 2073 6574 2074  n type and set t
│ │ │ │ │ -00007340: 6865 2072 6571 7569 7265 6420 4750 4720  he required GPG 
│ │ │ │ │ -00007350: 7061 7261 6d65 7465 7273 0a20 2020 2020  parameters.     
│ │ │ │ │ -00007360: 2020 2020 202a 2028 7765 2063 616e 2073       * (we can s
│ │ │ │ │ -00007370: 6b69 7020 6368 6563 6b69 6e67 2072 6574  kip checking ret
│ │ │ │ │ -00007380: 7572 6e20 7661 6c75 6573 2066 6f72 2062  urn values for b
│ │ │ │ │ -00007390: 7265 7669 7479 292e 0a20 2020 2020 2020  revity)..       
│ │ │ │ │ -000073a0: 2020 2a2f 0a20 2020 2020 2020 2020 7263    */.         rc
│ │ │ │ │ -000073b0: 203d 2066 6b6f 5f73 6574 5f73 7061 5f65   = fko_set_spa_e
│ │ │ │ │ -000073c0: 6e63 7279 7074 696f 6e5f 7479 7065 2863  ncryption_type(c
│ │ │ │ │ -000073d0: 7478 2c20 464b 4f5f 454e 4352 5950 5449  tx, FKO_ENCRYPTI
│ │ │ │ │ -000073e0: 4f4e 5f47 5047 293b 0a0a 2020 2020 2020  ON_GPG);..      
│ │ │ │ │ -000073f0: 2020 202f 2a20 4b65 7920 666f 7220 7468     /* Key for th
│ │ │ │ │ -00007400: 6520 7265 6369 7069 656e 7420 2a2f 0a20  e recipient */. 
│ │ │ │ │ -00007410: 2020 2020 2020 2020 7263 203d 2066 6b6f          rc = fko
│ │ │ │ │ -00007420: 5f73 6574 5f67 7067 5f72 6563 6970 6965  _set_gpg_recipie
│ │ │ │ │ -00007430: 6e74 2863 7478 2c20 2272 6563 6970 4073  nt(ctx, "recip@s
│ │ │ │ │ -00007440: 6f6d 652e 7768 6572 6522 293b 0a0a 2020  ome.where");..  
│ │ │ │ │ -00007450: 2020 2020 2020 202f 2a20 4b65 7920 666f         /* Key fo
│ │ │ │ │ -00007460: 7220 7468 6520 7369 676e 6572 2028 6966  r the signer (if
│ │ │ │ │ -00007470: 2079 6f75 2077 616e 7420 746f 2073 6967   you want to sig
│ │ │ │ │ -00007480: 6e20 6974 2920 2a2f 0a20 2020 2020 2020  n it) */.       
│ │ │ │ │ -00007490: 2020 7263 203d 2066 6b6f 5f73 6574 5f67    rc = fko_set_g
│ │ │ │ │ -000074a0: 7067 5f73 6967 6e65 7228 6374 782c 2022  pg_signer(ctx, "
│ │ │ │ │ -000074b0: 6d65 4072 6967 6874 2e68 6572 6522 293b  me@right.here");
│ │ │ │ │ -000074c0: 0a0a 2020 2020 2020 2020 202f 2a20 4669  ..         /* Fi
│ │ │ │ │ -000074d0: 6e61 6c69 7a65 2074 6865 2053 5041 2064  nalize the SPA d
│ │ │ │ │ -000074e0: 6174 6120 2a2f 0a20 2020 2020 2020 2020  ata */.         
│ │ │ │ │ -000074f0: 7263 203d 2066 6b6f 5f73 7061 5f64 6174  rc = fko_spa_dat
│ │ │ │ │ -00007500: 615f 6669 6e61 6c28 6374 782c 206b 6579  a_final(ctx, key
│ │ │ │ │ -00007510: 2c20 6b65 795f 6c65 6e2c 2065 6e63 5f6d  , key_len, enc_m
│ │ │ │ │ -00007520: 6f64 652c 0a20 2020 2020 2020 2020 2020  ode,.           
│ │ │ │ │ -00007530: 2020 2020 2020 686d 6163 5f6b 6579 2c20        hmac_key, 
│ │ │ │ │ -00007540: 686d 6163 5f6b 6579 5f6c 656e 2c20 686d  hmac_key_len, hm
│ │ │ │ │ -00007550: 6163 5f74 7970 6529 3b0a 2020 2020 2020  ac_type);.      
│ │ │ │ │ -00007560: 2020 2069 6628 7263 2021 3d20 464b 4f5f     if(rc != FKO_
│ │ │ │ │ -00007570: 5355 4343 4553 5329 0a20 2020 2020 2020  SUCCESS).       
│ │ │ │ │ -00007580: 2020 7b0a 2020 2020 2020 2020 2020 2020    {.            
│ │ │ │ │ -00007590: 2066 7072 696e 7466 2873 7464 6572 722c   fprintf(stderr,
│ │ │ │ │ -000075a0: 2022 4572 726f 7220 656e 636f 6469 6e67   "Error encoding
│ │ │ │ │ -000075b0: 2053 5041 2064 6174 613a 2025 735c 6e22   SPA data: %s\n"
│ │ │ │ │ -000075c0: 2c0a 2020 2020 2020 2020 2020 2020 2020  ,.              
│ │ │ │ │ -000075d0: 2020 2066 6b6f 5f65 7272 7374 7228 7263     fko_errstr(rc
│ │ │ │ │ -000075e0: 2929 3b0a 2020 2020 2020 2020 2020 2020  ));.            
│ │ │ │ │ -000075f0: 2065 7869 7428 3129 3b0a 2020 2020 2020   exit(1);.      
│ │ │ │ │ -00007600: 2020 207d 0a0a 2020 2020 2020 2020 202f     }..         /
│ │ │ │ │ -00007610: 2a20 5461 6b65 2074 6865 2066 696e 616c  * Take the final
│ │ │ │ │ -00007620: 206d 6573 7361 6765 2061 6e64 2064 6f20   message and do 
│ │ │ │ │ -00007630: 736f 6d65 7468 696e 6720 7769 7468 2069  something with i
│ │ │ │ │ -00007640: 7420 2a2f 0a20 2020 2020 2020 2020 7263  t */.         rc
│ │ │ │ │ -00007650: 203d 2066 6b6f 5f67 6574 5f73 7061 5f64   = fko_get_spa_d
│ │ │ │ │ -00007660: 6174 6128 6374 782c 2026 6669 6e61 6c5f  ata(ctx, &final_
│ │ │ │ │ -00007670: 7370 6129 3b0a 0a20 2020 2020 2020 2020  spa);..         
│ │ │ │ │ -00007680: 2f2a 2041 7373 756d 6520 7468 6973 2066  /* Assume this f
│ │ │ │ │ -00007690: 756e 6374 696f 6e20 7061 636b 7320 7468  unction packs th
│ │ │ │ │ -000076a0: 6520 7370 6120 6461 7461 2069 6e74 6f20  e spa data into 
│ │ │ │ │ -000076b0: 6120 5544 500a 2020 2020 2020 2020 2020  a UDP.          
│ │ │ │ │ -000076c0: 2a20 7061 636b 6574 2061 6e64 2073 656e  * packet and sen
│ │ │ │ │ -000076d0: 6473 2069 7420 746f 2074 6865 2073 6572  ds it to the ser
│ │ │ │ │ -000076e0: 7665 722e 0a20 2020 2020 2020 2020 2a2f  ver..         */
│ │ │ │ │ -000076f0: 0a20 2020 2020 2020 2020 7365 6e64 5f73  .         send_s
│ │ │ │ │ -00007700: 7061 5f6d 6573 7361 6765 2866 696e 616c  pa_message(final
│ │ │ │ │ -00007710: 5f73 7061 293b 0a0a 2020 2020 2020 2020  _spa);..        
│ │ │ │ │ -00007720: 202f 2a20 446f 6e65 2077 6974 6820 7468   /* Done with th
│ │ │ │ │ -00007730: 6520 636f 6e74 6578 7420 2a2f 0a20 2020  e context */.   
│ │ │ │ │ -00007740: 2020 2020 2020 666b 6f5f 6465 7374 726f        fko_destro
│ │ │ │ │ -00007750: 7928 6374 7829 3b0a 0a20 2020 2020 2020  y(ctx);..       
│ │ │ │ │ -00007760: 2020 6578 6974 2830 293b 0a20 2020 2020    exit(0);.     
│ │ │ │ │ -00007770: 7d0a 0a1f 0a46 696c 653a 206c 6962 666b  }....File: libfk
│ │ │ │ │ -00007780: 6f2e 696e 666f 2c20 204e 6f64 653a 2053  o.info,  Node: S
│ │ │ │ │ -00007790: 6574 7469 6e67 2053 5041 2044 6174 612c  etting SPA Data,
│ │ │ │ │ -000077a0: 2020 4e65 7874 3a20 5265 7472 6965 7669    Next: Retrievi
│ │ │ │ │ -000077b0: 6e67 2053 5041 2044 6174 612c 2020 5072  ng SPA Data,  Pr
│ │ │ │ │ -000077c0: 6576 3a20 4372 6561 7469 6e67 2061 2053  ev: Creating a S
│ │ │ │ │ -000077d0: 5041 204d 6573 7361 6765 2c20 2055 703a  PA Message,  Up:
│ │ │ │ │ -000077e0: 2055 7369 6e67 206c 6962 666b 6f0a 0a33   Using libfko..3
│ │ │ │ │ -000077f0: 2e34 2053 6574 7469 6e67 2053 5041 2044  .4 Setting SPA D
│ │ │ │ │ -00007800: 6174 610a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ata.============
│ │ │ │ │ -00007810: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6973 2073  ========..This s
│ │ │ │ │ -00007820: 6563 7469 6f6e 2064 6573 6372 6962 6573  ection describes
│ │ │ │ │ -00007830: 2074 6865 2066 756e 6374 696f 6e73 2075   the functions u
│ │ │ │ │ -00007840: 7365 6420 666f 7220 7365 7474 696e 6720  sed for setting 
│ │ │ │ │ -00007850: 7468 6520 7661 7269 6f75 7320 5350 410a  the various SPA.
│ │ │ │ │ -00007860: 6461 7461 2066 6965 6c64 7320 616e 6420  data fields and 
│ │ │ │ │ -00007870: 7061 7261 6d65 7465 7273 2e20 2041 6c6c  parameters.  All
│ │ │ │ │ -00007880: 206f 6620 7468 6573 6520 6675 6e63 7469   of these functi
│ │ │ │ │ -00007890: 6f6e 7320 7265 7475 726e 2061 6e20 696e  ons return an in
│ │ │ │ │ -000078a0: 7465 6765 720a 7265 7072 6573 656e 7469  teger.representi
│ │ │ │ │ -000078b0: 6e67 2074 6865 2072 6574 7572 6e20 7374  ng the return st
│ │ │ │ │ -000078c0: 6174 7573 206f 6620 7468 6520 6675 6e63  atus of the func
│ │ │ │ │ -000078d0: 7469 6f6e 2e20 2057 6865 6e20 7375 6363  tion.  When succ
│ │ │ │ │ -000078e0: 6573 6675 6c6c 2c20 7468 6579 0a77 696c  esfull, they.wil
│ │ │ │ │ -000078f0: 6c20 7265 7475 726e 2027 464b 4f5f 5355  l return 'FKO_SU
│ │ │ │ │ -00007900: 4343 4553 5327 2e20 204f 7468 6572 7769  CCESS'.  Otherwi
│ │ │ │ │ -00007910: 7365 2c20 616e 2065 7272 6f72 2063 6f64  se, an error cod
│ │ │ │ │ -00007920: 6520 7661 6c75 6520 6973 2072 6574 7572  e value is retur
│ │ │ │ │ -00007930: 6e65 642e 0a0a 202d 2d20 4675 6e63 7469  ned... -- Functi
│ │ │ │ │ -00007940: 6f6e 3a20 696e 7420 666b 6f5f 7365 745f  on: int fko_set_
│ │ │ │ │ -00007950: 7370 615f 6469 6765 7374 5f74 7970 6520  spa_digest_type 
│ │ │ │ │ -00007960: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, 
│ │ │ │ │ -00007970: 7368 6f72 740a 2020 2020 2020 2020 2020  short.          
│ │ │ │ │ -00007980: 4449 4745 5354 5f54 5950 4529 3b0a 2020  DIGEST_TYPE);.  
│ │ │ │ │ -00007990: 2020 2053 6574 2074 6865 206d 6573 7361     Set the messa
│ │ │ │ │ -000079a0: 6765 2064 6967 6573 7420 7479 7065 2e20  ge digest type. 
│ │ │ │ │ -000079b0: 2056 616c 6964 2076 616c 7565 7320 6361   Valid values ca
│ │ │ │ │ -000079c0: 6e20 6265 2066 6f75 6e64 2069 6e20 2a6e  n be found in *n
│ │ │ │ │ -000079d0: 6f74 650a 2020 2020 2044 6967 6573 7473  ote.     Digests
│ │ │ │ │ -000079e0: 3a3a 206f 6620 7468 6973 206d 616e 7561  :: of this manua
│ │ │ │ │ -000079f0: 6c2e 2020 4966 2061 2076 616c 7565 206f  l.  If a value o
│ │ │ │ │ -00007a00: 7468 6572 2074 6861 6e20 7468 6520 7468  ther than the th
│ │ │ │ │ -00007a10: 6f73 6520 7468 6174 2061 7265 0a20 2020  ose that are.   
│ │ │ │ │ -00007a20: 2020 7375 7070 6f72 7465 6420 6973 2067    supported is g
│ │ │ │ │ -00007a30: 6976 656e 2c20 7468 6520 6675 6e63 7469  iven, the functi
│ │ │ │ │ -00007a40: 6f6e 2077 696c 6c20 7265 7475 726e 0a20  on will return. 
│ │ │ │ │ -00007a50: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ -00007a60: 4e56 414c 4944 5f44 4154 4127 2e20 2046  NVALID_DATA'.  F
│ │ │ │ │ -00007a70: 6f72 2065 7861 6d70 6c65 3a0a 2020 2020  or example:.    
│ │ │ │ │ -00007a80: 2020 2020 2020 2020 2020 7263 203d 2066            rc = f
│ │ │ │ │ -00007a90: 6b6f 5f73 6574 5f64 6967 6573 745f 7479  ko_set_digest_ty
│ │ │ │ │ -00007aa0: 7065 2863 7478 2c20 464b 4f5f 4449 4745  pe(ctx, FKO_DIGE
│ │ │ │ │ -00007ab0: 5354 5f53 4841 3129 3b0a 0a20 2d2d 2046  ST_SHA1);.. -- F
│ │ │ │ │ -00007ac0: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko
│ │ │ │ │ -00007ad0: 5f73 6574 5f73 7061 5f68 6d61 635f 7479  _set_spa_hmac_ty
│ │ │ │ │ -00007ae0: 7065 2028 666b 6f5f 6374 785f 7420 4354  pe (fko_ctx_t CT
│ │ │ │ │ -00007af0: 582c 2073 686f 7274 0a20 2020 2020 2020  X, short.       
│ │ │ │ │ -00007b00: 2020 2048 4d41 435f 5459 5045 293b 0a20     HMAC_TYPE);. 
│ │ │ │ │ -00007b10: 2020 2020 5365 7420 7468 6520 6d65 7373      Set the mess
│ │ │ │ │ -00007b20: 6167 6520 686d 6163 2074 7970 652e 2020  age hmac type.  
│ │ │ │ │ -00007b30: 5661 6c69 6420 7661 6c75 6573 2063 616e  Valid values can
│ │ │ │ │ -00007b40: 2062 6520 666f 756e 6420 696e 202a 6e6f   be found in *no
│ │ │ │ │ -00007b50: 7465 2048 4d41 430a 2020 2020 2044 6967  te HMAC.     Dig
│ │ │ │ │ -00007b60: 6573 7473 3a3a 206f 6620 7468 6973 206d  ests:: of this m
│ │ │ │ │ -00007b70: 616e 7561 6c2e 2020 4966 2061 2076 616c  anual.  If a val
│ │ │ │ │ -00007b80: 7565 206f 7468 6572 2074 6861 6e20 7468  ue other than th
│ │ │ │ │ -00007b90: 6520 7468 6f73 6520 7468 6174 2061 7265  e those that are
│ │ │ │ │ -00007ba0: 0a20 2020 2020 7375 7070 6f72 7465 6420  .     supported 
│ │ │ │ │ -00007bb0: 6973 2067 6976 656e 2c20 7468 6520 6675  is given, the fu
│ │ │ │ │ -00007bc0: 6e63 7469 6f6e 2077 696c 6c20 7265 7475  nction will retu
│ │ │ │ │ -00007bd0: 726e 0a20 2020 2020 2746 4b4f 5f45 5252  rn.     'FKO_ERR
│ │ │ │ │ -00007be0: 4f52 5f49 4e56 414c 4944 5f44 4154 4127  OR_INVALID_DATA'
│ │ │ │ │ -00007bf0: 2e20 2046 6f72 2065 7861 6d70 6c65 3a0a  .  For example:.
│ │ │ │ │ -00007c00: 2020 2020 2020 2020 2020 2020 2020 7263                rc
│ │ │ │ │ -00007c10: 203d 2066 6b6f 5f73 6574 5f68 6d61 635f   = fko_set_hmac_
│ │ │ │ │ -00007c20: 7479 7065 2863 7478 2c20 464b 4f5f 484d  type(ctx, FKO_HM
│ │ │ │ │ -00007c30: 4143 5f53 4841 3235 3629 3b0a 0a20 2d2d  AC_SHA256);.. --
│ │ │ │ │ -00007c40: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f
│ │ │ │ │ -00007c50: 6b6f 5f73 6574 5f73 7061 5f65 6e63 7279  ko_set_spa_encry
│ │ │ │ │ -00007c60: 7074 696f 6e5f 7479 7065 2028 666b 6f5f  ption_type (fko_
│ │ │ │ │ -00007c70: 6374 785f 7420 4354 582c 2073 686f 7274  ctx_t CTX, short
│ │ │ │ │ -00007c80: 0a20 2020 2020 2020 2020 2045 4e43 5259  .          ENCRY
│ │ │ │ │ -00007c90: 5054 5f54 5950 4529 3b0a 2020 2020 2053  PT_TYPE);.     S
│ │ │ │ │ -00007ca0: 6574 2074 6865 2065 6e63 7279 7469 6f6e  et the encrytion
│ │ │ │ │ -00007cb0: 2061 6c67 6f72 6974 686d 2074 6f20 7573   algorithm to us
│ │ │ │ │ -00007cc0: 6520 7768 656e 2065 6372 7970 7469 6e67  e when ecrypting
│ │ │ │ │ -00007cd0: 2074 6865 2066 696e 616c 2053 5041 0a20   the final SPA. 
│ │ │ │ │ -00007ce0: 2020 2020 6461 7461 2e20 2056 616c 6964      data.  Valid
│ │ │ │ │ -00007cf0: 2076 616c 7565 7320 6361 6e20 6265 2066   values can be f
│ │ │ │ │ -00007d00: 6f75 6e64 2069 6e20 2a6e 6f74 6520 456e  ound in *note En
│ │ │ │ │ -00007d10: 6372 7970 7469 6f6e 2041 6c67 6f72 6974  cryption Algorit
│ │ │ │ │ -00007d20: 686d 733a 3a0a 2020 2020 206f 6620 7468  hms::.     of th
│ │ │ │ │ -00007d30: 6973 206d 616e 7561 6c2e 2020 466f 7220  is manual.  For 
│ │ │ │ │ -00007d40: 6578 616d 706c 653a 0a20 2020 2020 2020  example:.       
│ │ │ │ │ -00007d50: 2020 2020 2020 2072 6320 3d20 666b 6f5f         rc = fko_
│ │ │ │ │ -00007d60: 7365 745f 656e 6372 7970 7469 6f6e 5f74  set_encryption_t
│ │ │ │ │ -00007d70: 7970 6528 6374 782c 2046 4b4f 5f45 4e43  ype(ctx, FKO_ENC
│ │ │ │ │ -00007d80: 5259 5054 494f 4e5f 5249 4a4e 4441 454c  RYPTION_RIJNDAEL
│ │ │ │ │ -00007d90: 293b 0a0a 202d 2d20 4675 6e63 7469 6f6e  );.. -- Function
│ │ │ │ │ -00007da0: 3a20 696e 7420 666b 6f5f 7365 745f 7261  : int fko_set_ra
│ │ │ │ │ -00007db0: 6e64 5f76 616c 7565 2028 666b 6f5f 6374  nd_value (fko_ct
│ │ │ │ │ -00007dc0: 785f 7420 4354 582c 2063 6f6e 7374 2063  x_t CTX, const c
│ │ │ │ │ -00007dd0: 6861 7220 2a56 414c 293b 0a20 2020 2020  har *VAL);.     
│ │ │ │ │ -00007de0: 5365 7420 7468 6520 7261 6e64 6f6d 2076  Set the random v
│ │ │ │ │ -00007df0: 616c 7565 2070 6f72 7469 6f6e 206f 6620  alue portion of 
│ │ │ │ │ -00007e00: 7468 6520 7370 6120 6461 7461 2074 6f20  the spa data to 
│ │ │ │ │ -00007e10: 7468 6520 6769 7665 6e20 7661 6c75 650a  the given value.
│ │ │ │ │ -00007e20: 2020 2020 2028 5641 4c29 2e20 2054 6865       (VAL).  The
│ │ │ │ │ -00007e30: 2067 6976 656e 2076 616c 7565 206d 7573   given value mus
│ │ │ │ │ -00007e40: 7420 6265 2061 2070 6f69 6e74 6572 2074  t be a pointer t
│ │ │ │ │ -00007e50: 6f20 6120 3136 2d63 6861 7261 6374 6572  o a 16-character
│ │ │ │ │ -00007e60: 2064 6563 696d 616c 0a20 2020 2020 6e75   decimal.     nu
│ │ │ │ │ -00007e70: 6d65 7269 6320 7374 7269 6e67 206f 7220  meric string or 
│ │ │ │ │ -00007e80: 4e55 4c4c 2e20 4966 2074 6865 2076 616c  NULL. If the val
│ │ │ │ │ -00007e90: 7565 2069 7320 4e55 4c4c 2c20 7468 6520  ue is NULL, the 
│ │ │ │ │ -00007ea0: 6675 6e63 7469 6f6e 2067 656e 6572 6174  function generat
│ │ │ │ │ -00007eb0: 650a 2020 2020 2061 206e 6577 2072 616e  e.     a new ran
│ │ │ │ │ -00007ec0: 646f 6d20 7661 6c75 652e 2020 4966 2061  dom value.  If a
│ │ │ │ │ -00007ed0: 2073 7472 696e 6720 7661 6c75 6520 6973   string value is
│ │ │ │ │ -00007ee0: 2070 726f 7669 6465 642c 2069 7420 6d75   provided, it mu
│ │ │ │ │ -00007ef0: 7374 2062 6520 610a 2020 2020 2031 362d  st be a.     16-
│ │ │ │ │ -00007f00: 6368 6172 6163 7465 7220 6465 6369 6d61  character decima
│ │ │ │ │ -00007f10: 6c20 7374 7269 6e67 2e20 204f 7468 6572  l string.  Other
│ │ │ │ │ -00007f20: 7769 7365 2c20 7468 6520 6675 6e63 7469  wise, the functi
│ │ │ │ │ -00007f30: 6f6e 2077 696c 6c20 7265 7475 726e 0a20  on will return. 
│ │ │ │ │ -00007f40: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ -00007f50: 4e56 414c 4944 5f44 4154 4127 2e0a 0a20  NVALID_DATA'... 
│ │ │ │ │ -00007f60: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ │ -00007f70: 2066 6b6f 5f73 6574 5f75 7365 726e 616d   fko_set_usernam
│ │ │ │ │ -00007f80: 6520 2866 6b6f 5f63 7478 5f74 2043 5458  e (fko_ctx_t CTX
│ │ │ │ │ -00007f90: 2c20 636f 6e73 7420 6368 6172 0a20 2020  , const char.   
│ │ │ │ │ -00007fa0: 2020 2020 2020 202a 5553 4552 4e41 4d45         *USERNAME
│ │ │ │ │ -00007fb0: 293b 0a20 2020 2020 5365 7420 7468 6520  );.     Set the 
│ │ │ │ │ -00007fc0: 7573 6572 6e61 6d65 2066 6965 6c64 206f  username field o
│ │ │ │ │ -00007fd0: 6620 7468 6520 5350 4120 6461 7461 2e20  f the SPA data. 
│ │ │ │ │ -00007fe0: 2049 6620 5553 4552 4e41 4d45 2069 7320   If USERNAME is 
│ │ │ │ │ -00007ff0: 4e55 4c4c 2c0a 2020 2020 206c 6962 666b  NULL,.     libfk
│ │ │ │ │ -00008000: 6f20 7769 6c6c 2066 6972 7374 206c 6f6f  o will first loo
│ │ │ │ │ -00008010: 6b20 666f 7220 7468 6520 656e 7669 726f  k for the enviro
│ │ │ │ │ -00008020: 6e6d 656e 7420 7661 7269 6162 6c65 2027  nment variable '
│ │ │ │ │ -00008030: 5350 4f4f 465f 5553 4552 270a 2020 2020  SPOOF_USER'.    
│ │ │ │ │ -00008040: 2061 6e64 2075 7365 2069 7473 2076 616c   and use its val
│ │ │ │ │ -00008050: 7565 2069 6620 666f 756e 642e 2020 4f74  ue if found.  Ot
│ │ │ │ │ -00008060: 6865 7277 6973 652c 2069 7420 7769 6c6c  herwise, it will
│ │ │ │ │ -00008070: 2074 7279 2074 6f20 6465 7465 726d 696e   try to determin
│ │ │ │ │ -00008080: 650a 2020 2020 2074 6865 2075 7365 726e  e.     the usern
│ │ │ │ │ -00008090: 616d 6520 6974 7365 6c66 2075 7369 6e67  ame itself using
│ │ │ │ │ -000080a0: 2076 6172 696f 7573 206d 6574 686f 6473   various methods
│ │ │ │ │ -000080b0: 2073 7461 7274 696e 6720 7769 7468 2027   starting with '
│ │ │ │ │ -000080c0: 6375 7365 7227 206f 720a 2020 2020 2027  cuser' or.     '
│ │ │ │ │ -000080d0: 6765 746c 6f67 696e 272c 2074 6865 6e20  getlogin', then 
│ │ │ │ │ -000080e0: 6661 6c6c 6261 636b 2074 6f20 7468 6520  fallback to the 
│ │ │ │ │ -000080f0: 656e 7669 726f 6e6d 656e 7420 7661 7269  environment vari
│ │ │ │ │ -00008100: 6162 6c65 7320 274c 4f47 4e41 4d45 2720  ables 'LOGNAME' 
│ │ │ │ │ -00008110: 6f72 0a20 2020 2020 2755 5345 5227 2e20  or.     'USER'. 
│ │ │ │ │ -00008120: 2049 6620 6e6f 6e65 206f 6620 7468 6f73   If none of thos
│ │ │ │ │ -00008130: 6520 776f 726b 2c20 7468 6520 6675 6e63  e work, the func
│ │ │ │ │ -00008140: 7469 6f6e 2077 696c 6c20 7265 7475 726e  tion will return
│ │ │ │ │ -00008150: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -00008160: 5f55 5345 524e 414d 455f 554e 4b4e 4f57  _USERNAME_UNKNOW
│ │ │ │ │ -00008170: 4e27 2e0a 0a20 2d2d 2046 756e 6374 696f  N'... -- Functio
│ │ │ │ │ -00008180: 6e3a 2069 6e74 2066 6b6f 5f73 6574 5f74  n: int fko_set_t
│ │ │ │ │ -00008190: 696d 6573 7461 6d70 2028 666b 6f5f 6374  imestamp (fko_ct
│ │ │ │ │ -000081a0: 785f 7420 4354 582c 2069 6e74 204f 4646  x_t CTX, int OFF
│ │ │ │ │ -000081b0: 5345 5429 3b0a 2020 2020 2053 6574 7320  SET);.     Sets 
│ │ │ │ │ -000081c0: 7468 6520 7469 6d65 7374 616d 7020 7661  the timestamp va
│ │ │ │ │ -000081d0: 6c75 6520 6f66 2074 6865 2053 5041 2064  lue of the SPA d
│ │ │ │ │ -000081e0: 6174 6120 746f 2074 6865 2063 7572 7265  ata to the curre
│ │ │ │ │ -000081f0: 6e74 2074 696d 6520 706c 7573 0a20 2020  nt time plus.   
│ │ │ │ │ -00008200: 2020 7468 6520 6f66 6673 6574 2076 616c    the offset val
│ │ │ │ │ -00008210: 7565 2e0a 0a20 2d2d 2046 756e 6374 696f  ue... -- Functio
│ │ │ │ │ -00008220: 6e3a 2069 6e74 2066 6b6f 5f73 6574 5f73  n: int fko_set_s
│ │ │ │ │ -00008230: 7061 5f6d 6573 7361 6765 5f74 7970 6520  pa_message_type 
│ │ │ │ │ -00008240: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, 
│ │ │ │ │ -00008250: 7368 6f72 740a 2020 2020 2020 2020 2020  short.          
│ │ │ │ │ -00008260: 4d53 475f 5459 5045 293b 0a20 2020 2020  MSG_TYPE);.     
│ │ │ │ │ -00008270: 5365 7473 2074 6865 206d 6573 7361 6765  Sets the message
│ │ │ │ │ -00008280: 2074 7970 6520 666f 7220 7468 6520 5350   type for the SP
│ │ │ │ │ -00008290: 4120 6461 7461 2e20 2054 6865 2063 686f  A data.  The cho
│ │ │ │ │ -000082a0: 6963 6573 2066 6f72 2074 6865 0a20 2020  ices for the.   
│ │ │ │ │ -000082b0: 2020 2773 7061 5f6d 6573 7361 6765 5f74    'spa_message_t
│ │ │ │ │ -000082c0: 7970 6527 2061 7265 206c 6973 7465 6420  ype' are listed 
│ │ │ │ │ -000082d0: 696e 202a 6e6f 7465 2053 5041 204d 6573  in *note SPA Mes
│ │ │ │ │ -000082e0: 7361 6765 733a 3a2e 2020 466f 720a 2020  sages::.  For.  
│ │ │ │ │ -000082f0: 2020 2065 7861 6d70 6c65 3a0a 2020 2020     example:.    
│ │ │ │ │ -00008300: 2020 2020 2020 2020 2020 7263 203d 2066            rc = f
│ │ │ │ │ -00008310: 6b6f 5f73 6574 5f73 7061 5f6d 6573 7361  ko_set_spa_messa
│ │ │ │ │ -00008320: 6765 5f74 7970 6528 6374 782c 2046 4b4f  ge_type(ctx, FKO
│ │ │ │ │ -00008330: 5f41 4343 4553 535f 4d53 4729 3b0a 0a20  _ACCESS_MSG);.. 
│ │ │ │ │ -00008340: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ │ -00008350: 2066 6b6f 5f73 6574 5f73 7061 5f6d 6573   fko_set_spa_mes
│ │ │ │ │ -00008360: 7361 6765 2028 666b 6f5f 6374 785f 7420  sage (fko_ctx_t 
│ │ │ │ │ -00008370: 4354 582c 2063 6f6e 7374 2063 6861 720a  CTX, const char.
│ │ │ │ │ -00008380: 2020 2020 2020 2020 2020 2a4d 5347 5f53            *MSG_S
│ │ │ │ │ -00008390: 5452 494e 4729 3b0a 2020 2020 2053 6574  TRING);.     Set
│ │ │ │ │ -000083a0: 2074 6865 2053 5041 206d 6573 7361 6765   the SPA message
│ │ │ │ │ -000083b0: 2073 7472 696e 6720 746f 2074 6865 2067   string to the g
│ │ │ │ │ -000083c0: 6976 656e 2076 616c 7565 2e20 2049 6620  iven value.  If 
│ │ │ │ │ -000083d0: 7468 6973 2073 7472 696e 6720 646f 6573  this string does
│ │ │ │ │ -000083e0: 0a20 2020 2020 6e6f 7420 636f 6e66 6f72  .     not confor
│ │ │ │ │ -000083f0: 6d20 746f 2074 6865 2072 6571 7569 7265  m to the require
│ │ │ │ │ -00008400: 6420 2773 7061 5f6e 6174 5f61 6363 6573  d 'spa_nat_acces
│ │ │ │ │ -00008410: 7327 2066 6f72 6d61 742c 2074 6865 2066  s' format, the f
│ │ │ │ │ -00008420: 756e 6374 696f 6e0a 2020 2020 2077 696c  unction.     wil
│ │ │ │ │ -00008430: 6c20 7265 7475 726e 2027 464b 4f5f 4552  l return 'FKO_ER
│ │ │ │ │ -00008440: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ -00008450: 272e 0a0a 202d 2d20 4675 6e63 7469 6f6e  '... -- Function
│ │ │ │ │ -00008460: 3a20 696e 7420 666b 6f5f 7365 745f 7370  : int fko_set_sp
│ │ │ │ │ -00008470: 615f 6e61 745f 6163 6365 7373 2028 666b  a_nat_access (fk
│ │ │ │ │ -00008480: 6f5f 6374 785f 7420 4354 582c 2063 6f6e  o_ctx_t CTX, con
│ │ │ │ │ -00008490: 7374 2063 6861 720a 2020 2020 2020 2020  st char.        
│ │ │ │ │ -000084a0: 2020 2a4e 4154 5f41 4343 4553 5329 3b0a    *NAT_ACCESS);.
│ │ │ │ │ -000084b0: 2020 2020 2053 6574 2074 6865 206f 7074       Set the opt
│ │ │ │ │ -000084c0: 696f 6e61 6c20 5350 4120 6e61 7420 6163  ional SPA nat ac
│ │ │ │ │ -000084d0: 6365 7373 2073 7472 696e 6720 746f 2074  cess string to t
│ │ │ │ │ -000084e0: 6865 2067 6976 656e 2076 616c 7565 2e20  he given value. 
│ │ │ │ │ -000084f0: 2049 6620 7468 6973 0a20 2020 2020 7374   If this.     st
│ │ │ │ │ -00008500: 7269 6e67 2064 6f65 7320 6e6f 7420 636f  ring does not co
│ │ │ │ │ -00008510: 6e66 6f72 6d20 746f 2074 6865 2072 6571  nform to the req
│ │ │ │ │ -00008520: 7569 7265 6420 2773 7061 5f6e 6174 5f61  uired 'spa_nat_a
│ │ │ │ │ -00008530: 6363 6573 7327 2066 6f72 6d61 742c 0a20  ccess' format,. 
│ │ │ │ │ -00008540: 2020 2020 7468 6520 6675 6e63 7469 6f6e      the function
│ │ │ │ │ -00008550: 2077 696c 6c20 7265 7475 726e 2027 464b   will return 'FK
│ │ │ │ │ -00008560: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ -00008570: 4441 5441 272e 0a0a 202d 2d20 4675 6e63  DATA'... -- Func
│ │ │ │ │ -00008580: 7469 6f6e 3a20 696e 7420 666b 6f5f 7365  tion: int fko_se
│ │ │ │ │ -00008590: 745f 7370 615f 7365 7276 6572 5f61 7574  t_spa_server_aut
│ │ │ │ │ -000085a0: 6820 2866 6b6f 5f63 7478 5f74 2043 5458  h (fko_ctx_t CTX
│ │ │ │ │ -000085b0: 2c20 636f 6e73 7420 6368 6172 0a20 2020  , const char.   
│ │ │ │ │ -000085c0: 2020 2020 2020 202a 5345 5256 4552 5f41         *SERVER_A
│ │ │ │ │ -000085d0: 5554 4829 3b0a 2020 2020 2053 6574 2074  UTH);.     Set t
│ │ │ │ │ -000085e0: 6865 206f 7074 696f 6e61 6c20 2876 6572  he optional (ver
│ │ │ │ │ -000085f0: 7920 7365 6c64 6f6d 2075 7365 6429 2053  y seldom used) S
│ │ │ │ │ -00008600: 5041 2073 6572 7665 7220 6175 7468 2066  PA server auth f
│ │ │ │ │ -00008610: 6561 7475 7265 2074 6f20 7468 650a 2020  eature to the.  
│ │ │ │ │ -00008620: 2020 2067 6976 656e 2076 616c 7565 2e20     given value. 
│ │ │ │ │ -00008630: 2054 6869 7320 7061 7261 6d65 7465 7220   This parameter 
│ │ │ │ │ -00008640: 6d61 7920 6265 636f 6d65 2064 6570 7265  may become depre
│ │ │ │ │ -00008650: 6361 7465 642e 0a0a 202d 2d20 4675 6e63  cated... -- Func
│ │ │ │ │ -00008660: 7469 6f6e 3a20 696e 7420 666b 6f5f 7365  tion: int fko_se
│ │ │ │ │ -00008670: 745f 7370 615f 636c 6965 6e74 5f74 696d  t_spa_client_tim
│ │ │ │ │ -00008680: 656f 7574 2028 666b 6f5f 6374 785f 7420  eout (fko_ctx_t 
│ │ │ │ │ -00008690: 4354 582c 2069 6e74 0a20 2020 2020 2020  CTX, int.       
│ │ │ │ │ -000086a0: 2020 2054 494d 454f 5554 293b 0a20 2020     TIMEOUT);.   
│ │ │ │ │ -000086b0: 2020 5365 7473 2074 6865 2053 5041 2063    Sets the SPA c
│ │ │ │ │ -000086c0: 6c69 656e 7420 7469 6d65 6f75 7420 7661  lient timeout va
│ │ │ │ │ -000086d0: 6c75 652e 2020 4966 2074 6865 2074 696d  lue.  If the tim
│ │ │ │ │ -000086e0: 656f 7574 2069 7320 7365 7420 746f 2061  eout is set to a
│ │ │ │ │ -000086f0: 0a20 2020 2020 7661 6c75 6520 6772 6561  .     value grea
│ │ │ │ │ -00008700: 7465 7220 7468 616e 2030 2c20 6974 2069  ter than 0, it i
│ │ │ │ │ -00008710: 7320 6173 7375 6d65 6420 7468 6520 2773  s assumed the 's
│ │ │ │ │ -00008720: 7061 5f6d 6573 7361 6765 5f74 7970 6527  pa_message_type'
│ │ │ │ │ -00008730: 2073 6574 7469 6e67 0a20 2020 2020 7368   setting.     sh
│ │ │ │ │ -00008740: 6f75 6c64 2062 6520 6f6e 6520 6f66 2074  ould be one of t
│ │ │ │ │ -00008750: 6865 2022 5449 4d45 4f55 5422 2076 6172  he "TIMEOUT" var
│ │ │ │ │ -00008760: 6961 6e74 732e 2020 5468 6973 2066 756e  iants.  This fun
│ │ │ │ │ -00008770: 6374 696f 6e20 7769 6c6c 2063 6861 6e67  ction will chang
│ │ │ │ │ -00008780: 650a 2020 2020 2074 6865 2027 6d65 7373  e.     the 'mess
│ │ │ │ │ -00008790: 6167 655f 7479 7065 2720 746f 2074 6865  age_type' to the
│ │ │ │ │ -000087a0: 2061 7070 726f 7072 6961 7465 2073 6574   appropriate set
│ │ │ │ │ -000087b0: 7469 6e67 2069 6620 6e65 6365 7373 6172  ting if necessar
│ │ │ │ │ -000087c0: 792e 0a20 2020 2020 486f 7765 7665 722c  y..     However,
│ │ │ │ │ -000087d0: 2069 7420 6973 2072 6563 6f6d 6d65 6e64   it is recommend
│ │ │ │ │ -000087e0: 6564 2079 6f75 2073 6574 2074 6865 2063  ed you set the c
│ │ │ │ │ -000087f0: 6f72 7265 6374 2027 6d65 7373 6167 655f  orrect 'message_
│ │ │ │ │ -00008800: 7479 7065 2720 6168 6561 640a 2020 2020  type' ahead.    
│ │ │ │ │ -00008810: 206f 6620 7469 6d65 2e0a 0a20 2d2d 2046   of time... -- F
│ │ │ │ │ -00008820: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko
│ │ │ │ │ -00008830: 5f73 6574 5f73 7061 5f64 6967 6573 7420  _set_spa_digest 
│ │ │ │ │ -00008840: 2866 6b6f 5f63 7478 5f74 2043 5458 293b  (fko_ctx_t CTX);
│ │ │ │ │ -00008850: 0a20 2020 2020 496e 6974 6961 7465 7320  .     Initiates 
│ │ │ │ │ -00008860: 6120 6361 6c63 756c 6174 696f 6e20 286f  a calculation (o
│ │ │ │ │ -00008870: 7220 7265 6361 6c63 756c 6174 696f 6e29  r recalculation)
│ │ │ │ │ -00008880: 206f 6620 7468 6520 6d65 7373 6167 6520   of the message 
│ │ │ │ │ -00008890: 6469 6765 7374 0a20 2020 2020 6861 7368  digest.     hash
│ │ │ │ │ -000088a0: 2066 6f72 2074 6865 2063 7572 7265 6e74   for the current
│ │ │ │ │ -000088b0: 2053 5041 2064 6174 612e 2020 4966 2074   SPA data.  If t
│ │ │ │ │ -000088c0: 6865 2072 6571 7569 7265 6420 6461 7461  he required data
│ │ │ │ │ -000088d0: 2066 6965 6c64 7320 6172 6520 6e6f 740a   fields are not.
│ │ │ │ │ -000088e0: 2020 2020 2073 6574 2074 6869 7320 6675       set this fu
│ │ │ │ │ -000088f0: 6e63 7469 6f6e 2077 696c 6c20 7265 7475  nction will retu
│ │ │ │ │ -00008900: 726e 2027 464b 4f5f 4552 524f 525f 4d49  rn 'FKO_ERROR_MI
│ │ │ │ │ -00008910: 5353 494e 475f 454e 434f 4445 445f 4441  SSING_ENCODED_DA
│ │ │ │ │ -00008920: 5441 272e 0a20 2020 2020 2a4e 6f74 652a  TA'..     *Note*
│ │ │ │ │ -00008930: 3a20 4974 2073 686f 756c 6420 6e6f 7420  : It should not 
│ │ │ │ │ -00008940: 6265 206e 6563 6573 7361 7279 2074 6f20  be necessary to 
│ │ │ │ │ -00008950: 6361 6c6c 2074 6869 7320 6675 6e63 7469  call this functi
│ │ │ │ │ -00008960: 6f6e 2064 6972 6563 746c 790a 2020 2020  on directly.    
│ │ │ │ │ -00008970: 2061 7320 6974 2077 696c 6c20 6265 2063   as it will be c
│ │ │ │ │ -00008980: 616c 6c65 6420 6175 746f 6d61 7469 6361  alled automatica
│ │ │ │ │ -00008990: 6c6c 7920 6279 206f 7468 6572 2066 756e  lly by other fun
│ │ │ │ │ -000089a0: 6374 696f 6e73 2064 7572 696e 6720 6e6f  ctions during no
│ │ │ │ │ -000089b0: 726d 616c 0a20 2020 2020 7072 6f63 6573  rmal.     proces
│ │ │ │ │ -000089c0: 7369 6e67 2028 6d6f 7374 206e 6f74 6162  sing (most notab
│ │ │ │ │ -000089d0: 6c79 2027 666b 6f5f 7370 615f 6461 7461  ly 'fko_spa_data
│ │ │ │ │ -000089e0: 5f66 696e 616c 2729 2e0a 0a20 2d2d 2046  _final')... -- F
│ │ │ │ │ -000089f0: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko
│ │ │ │ │ -00008a00: 5f73 6574 5f73 7061 5f68 6d61 6320 2866  _set_spa_hmac (f
│ │ │ │ │ -00008a10: 6b6f 5f63 7478 5f74 2043 5458 2c20 636f  ko_ctx_t CTX, co
│ │ │ │ │ -00008a20: 6e73 7420 6368 6172 202a 484d 4143 5f4b  nst char *HMAC_K
│ │ │ │ │ -00008a30: 4559 2c0a 2020 2020 2020 2020 2020 636f  EY,.          co
│ │ │ │ │ -00008a40: 6e73 7420 696e 7420 484d 4143 5f4b 4559  nst int HMAC_KEY
│ │ │ │ │ -00008a50: 5f4c 454e 293b 0a20 2020 2020 496e 6974  _LEN);.     Init
│ │ │ │ │ -00008a60: 6961 7465 7320 6120 6361 6c63 756c 6174  iates a calculat
│ │ │ │ │ -00008a70: 696f 6e20 286f 7220 7265 6361 6c63 756c  ion (or recalcul
│ │ │ │ │ -00008a80: 6174 696f 6e29 206f 6620 7468 6520 6d65  ation) of the me
│ │ │ │ │ -00008a90: 7373 6167 6520 484d 4143 2066 6f72 0a20  ssage HMAC for. 
│ │ │ │ │ -00008aa0: 2020 2020 7468 6520 6375 7272 656e 7420      the current 
│ │ │ │ │ -00008ab0: 5350 4120 6461 7461 2e20 202a 4e6f 7465  SPA data.  *Note
│ │ │ │ │ -00008ac0: 2a3a 2049 7420 7368 6f75 6c64 206e 6f74  *: It should not
│ │ │ │ │ -00008ad0: 2062 6520 6e65 6365 7373 6172 7920 746f   be necessary to
│ │ │ │ │ -00008ae0: 2063 616c 6c0a 2020 2020 2074 6869 7320   call.     this 
│ │ │ │ │ -00008af0: 6675 6e63 7469 6f6e 2064 6972 6563 746c  function directl
│ │ │ │ │ -00008b00: 7920 6173 2069 7420 7769 6c6c 2062 6520  y as it will be 
│ │ │ │ │ -00008b10: 6361 6c6c 6564 2061 7574 6f6d 6174 6963  called automatic
│ │ │ │ │ -00008b20: 616c 6c79 2062 7920 6f74 6865 720a 2020  ally by other.  
│ │ │ │ │ -00008b30: 2020 2066 756e 6374 696f 6e73 2064 7572     functions dur
│ │ │ │ │ -00008b40: 696e 6720 6e6f 726d 616c 2070 726f 6365  ing normal proce
│ │ │ │ │ -00008b50: 7373 696e 6720 286d 6f73 7420 6e6f 7461  ssing (most nota
│ │ │ │ │ -00008b60: 626c 790a 2020 2020 2027 666b 6f5f 7370  bly.     'fko_sp
│ │ │ │ │ -00008b70: 615f 6461 7461 5f66 696e 616c 2729 2e0a  a_data_final')..
│ │ │ │ │ -00008b80: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ │ -00008b90: 6e74 2066 6b6f 5f73 6574 5f73 7061 5f64  nt fko_set_spa_d
│ │ │ │ │ -00008ba0: 6174 6120 2866 6b6f 5f63 7478 5f74 2043  ata (fko_ctx_t C
│ │ │ │ │ -00008bb0: 5458 2c20 6368 6172 202a 454e 435f 4441  TX, char *ENC_DA
│ │ │ │ │ -00008bc0: 5441 293b 0a20 2020 2020 5468 6973 2066  TA);.     This f
│ │ │ │ │ -00008bd0: 756e 6374 696f 6e20 6973 2075 7365 6420  unction is used 
│ │ │ │ │ -00008be0: 746f 2070 6c61 6365 2065 6e63 7279 7074  to place encrypt
│ │ │ │ │ -00008bf0: 6564 2053 5041 2064 6174 6120 696e 746f  ed SPA data into
│ │ │ │ │ -00008c00: 2061 206e 6577 6c79 0a20 2020 2020 6372   a newly.     cr
│ │ │ │ │ -00008c10: 6561 7465 6420 656d 7074 7920 636f 6e74  eated empty cont
│ │ │ │ │ -00008c20: 6578 7420 2869 2e65 2e20 2077 6974 6820  ext (i.e.  with 
│ │ │ │ │ -00008c30: 2766 6b6f 5f6e 6577 2729 2e20 2049 6e20  'fko_new').  In 
│ │ │ │ │ -00008c40: 6d6f 7374 2063 6173 6573 2c20 796f 750a  most cases, you.
│ │ │ │ │ -00008c50: 2020 2020 2077 6f75 6c64 2075 7365 2027       would use '
│ │ │ │ │ -00008c60: 666b 6f5f 6e65 775f 7769 7468 5f64 6174  fko_new_with_dat
│ │ │ │ │ -00008c70: 6127 2073 6f20 796f 7520 776f 756c 646e  a' so you wouldn
│ │ │ │ │ -00008c80: 2774 2068 6176 6520 746f 2074 616b 6520  't have to take 
│ │ │ │ │ -00008c90: 7468 650a 2020 2020 2065 7874 7261 2073  the.     extra s
│ │ │ │ │ -00008ca0: 7465 7020 746f 2075 7365 2074 6869 7320  tep to use this 
│ │ │ │ │ -00008cb0: 6675 6e63 7469 6f6e 2e20 2048 6f77 6576  function.  Howev
│ │ │ │ │ -00008cc0: 6572 2c20 736f 6d65 206d 6179 2066 696e  er, some may fin
│ │ │ │ │ -00008cd0: 6420 6120 7265 6173 6f6e 0a20 2020 2020  d a reason.     
│ │ │ │ │ -00008ce0: 746f 2064 6f20 6974 2069 6e20 7468 6973  to do it in this
│ │ │ │ │ -00008cf0: 2077 6179 2e0a 0a5f 4750 472d 7370 6563   way..._GPG-spec
│ │ │ │ │ -00008d00: 6966 6963 2066 756e 6374 696f 6e73 3a5f  ific functions:_
│ │ │ │ │ -00008d10: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ │ -00008d20: 696e 7420 666b 6f5f 7365 745f 6770 675f  int fko_set_gpg_
│ │ │ │ │ -00008d30: 7265 6369 7069 656e 7420 2866 6b6f 5f63  recipient (fko_c
│ │ │ │ │ -00008d40: 7478 5f74 2043 5458 2c20 636f 6e73 7420  tx_t CTX, const 
│ │ │ │ │ -00008d50: 6368 6172 0a20 2020 2020 2020 2020 2052  char.          R
│ │ │ │ │ -00008d60: 4543 4950 4945 4e54 293b 0a20 2020 2020  ECIPIENT);.     
│ │ │ │ │ -00008d70: 5365 7473 2074 6865 2047 5047 206b 6579  Sets the GPG key
│ │ │ │ │ -00008d80: 2066 6f72 2074 6865 2072 6563 6970 6965   for the recipie
│ │ │ │ │ -00008d90: 6e74 2e20 2054 6869 7320 776f 756c 6420  nt.  This would 
│ │ │ │ │ -00008da0: 6265 2074 6865 2072 6563 6970 6965 6e74  be the recipient
│ │ │ │ │ -00008db0: 2773 0a20 2020 2020 7075 626c 6963 206b  's.     public k
│ │ │ │ │ -00008dc0: 6579 2075 7365 6420 746f 2065 6e63 7972  ey used to encyr
│ │ │ │ │ -00008dd0: 7074 2074 6865 2053 5041 2064 6174 612e  pt the SPA data.
│ │ │ │ │ -00008de0: 2020 596f 7520 6361 6e20 7573 6520 7468    You can use th
│ │ │ │ │ -00008df0: 6520 7573 6572 206e 616d 650a 2020 2020  e user name.    
│ │ │ │ │ -00008e00: 2028 2272 6563 6970 4074 6865 2e64 6573   ("recip@the.des
│ │ │ │ │ -00008e10: 742e 636f 6d22 2920 6f72 2074 6865 206b  t.com") or the k
│ │ │ │ │ -00008e20: 6579 2049 4420 2822 3545 5858 5858 4343  ey ID ("5EXXXXCC
│ │ │ │ │ -00008e30: 2229 2e20 4174 2070 7265 7365 6e74 2c0a  "). At present,.
│ │ │ │ │ -00008e40: 2020 2020 206d 756c 7469 706c 6520 7265       multiple re
│ │ │ │ │ -00008e50: 6369 7069 656e 7473 2061 7265 206e 6f74  cipients are not
│ │ │ │ │ -00008e60: 2073 7570 706f 7274 6564 2e0a 0a20 2d2d   supported... --
│ │ │ │ │ -00008e70: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f
│ │ │ │ │ -00008e80: 6b6f 5f73 6574 5f67 7067 5f73 6967 6e65  ko_set_gpg_signe
│ │ │ │ │ -00008e90: 7220 2866 6b6f 5f63 7478 5f74 2043 5458  r (fko_ctx_t CTX
│ │ │ │ │ -00008ea0: 2c20 636f 6e73 7420 6368 6172 2053 4947  , const char SIG
│ │ │ │ │ -00008eb0: 4e45 5229 3b0a 2020 2020 2053 6574 7320  NER);.     Sets 
│ │ │ │ │ -00008ec0: 7468 6520 4750 4720 6b65 7920 666f 7220  the GPG key for 
│ │ │ │ │ -00008ed0: 7369 676e 696e 6720 7468 6520 6461 7461  signing the data
│ │ │ │ │ -00008ee0: 2e20 2054 6869 7320 776f 756c 6420 6265  .  This would be
│ │ │ │ │ -00008ef0: 2074 6865 2073 656e 6465 7227 730a 2020   the sender's.  
│ │ │ │ │ -00008f00: 2020 206b 6579 2075 7365 6420 746f 2073     key used to s
│ │ │ │ │ -00008f10: 6967 6e20 7468 6520 5350 4120 6461 7461  ign the SPA data
│ │ │ │ │ -00008f20: 2e20 2059 6f75 2063 616e 2075 7365 2074  .  You can use t
│ │ │ │ │ -00008f30: 6865 2075 7365 7220 6e61 6d65 206f 7220  he user name or 
│ │ │ │ │ -00008f40: 6b65 790a 2020 2020 2049 442e 0a0a 202d  key.     ID... -
│ │ │ │ │ -00008f50: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ │ -00008f60: 666b 6f5f 7365 745f 6770 675f 686f 6d65  fko_set_gpg_home
│ │ │ │ │ -00008f70: 5f64 6972 2028 666b 6f5f 6374 785f 7420  _dir (fko_ctx_t 
│ │ │ │ │ -00008f80: 4354 582c 2063 6f6e 7374 2063 6861 720a  CTX, const char.
│ │ │ │ │ -00008f90: 2020 2020 2020 2020 2020 484f 4d45 5f44            HOME_D
│ │ │ │ │ -00008fa0: 4952 293b 0a20 2020 2020 5365 7473 2074  IR);.     Sets t
│ │ │ │ │ -00008fb0: 6865 2047 5047 2068 6f6d 6520 6469 7265  he GPG home dire
│ │ │ │ │ -00008fc0: 6374 6f72 7920 666f 7220 7468 6520 6375  ctory for the cu
│ │ │ │ │ -00008fd0: 7272 656e 7420 6770 676d 6520 636f 6e74  rrent gpgme cont
│ │ │ │ │ -00008fe0: 6578 742e 2020 5468 6973 0a20 2020 2020  ext.  This.     
│ │ │ │ │ -00008ff0: 616c 6c6f 7773 2066 6f72 2075 7369 6e67  allows for using
│ │ │ │ │ -00009000: 2061 6c74 6572 6e61 7465 206b 6579 7269   alternate keyri
│ │ │ │ │ -00009010: 6e67 732c 2067 7067 2063 6f6e 6669 6775  ngs, gpg configu
│ │ │ │ │ -00009020: 7261 7469 6f6e 732c 2065 7463 2e0a 0a20  rations, etc... 
│ │ │ │ │ -00009030: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ │ -00009040: 2066 6b6f 5f73 6574 5f67 7067 5f73 6967   fko_set_gpg_sig
│ │ │ │ │ -00009050: 6e61 7475 7265 5f76 6572 6966 7920 2866  nature_verify (f
│ │ │ │ │ -00009060: 6b6f 5f63 7478 5f74 2043 5458 2c20 756e  ko_ctx_t CTX, un
│ │ │ │ │ -00009070: 7369 676e 6564 0a20 2020 2020 2020 2020  signed.         
│ │ │ │ │ -00009080: 2063 6861 7220 5645 5249 4659 293b 0a20   char VERIFY);. 
│ │ │ │ │ -00009090: 2020 2020 5365 7473 2074 6865 2076 6572      Sets the ver
│ │ │ │ │ -000090a0: 6966 7920 4750 4720 7369 676e 6174 7572  ify GPG signatur
│ │ │ │ │ -000090b0: 6520 666c 6167 2e20 2057 6865 6e20 7365  e flag.  When se
│ │ │ │ │ -000090c0: 7420 746f 2061 2074 7275 6520 7661 6c75  t to a true valu
│ │ │ │ │ -000090d0: 652c 2074 6865 0a20 2020 2020 4750 4720  e, the.     GPG 
│ │ │ │ │ -000090e0: 7369 676e 6174 7572 6520 6973 2065 7874  signature is ext
│ │ │ │ │ -000090f0: 7261 6374 6564 2061 6e64 2063 6865 636b  racted and check
│ │ │ │ │ -00009100: 6564 2066 6f72 2076 616c 6964 6974 7920  ed for validity 
│ │ │ │ │ -00009110: 6475 7269 6e67 2074 6865 0a20 2020 2020  during the.     
│ │ │ │ │ -00009120: 6465 6372 7970 7469 6f6e 2f64 6563 6f64  decryption/decod
│ │ │ │ │ -00009130: 696e 6720 7068 6173 652e 2020 5768 656e  ing phase.  When
│ │ │ │ │ -00009140: 2073 6574 2074 6f20 6661 6c73 652c 206e   set to false, n
│ │ │ │ │ -00009150: 6f20 6174 7465 6d70 7420 6973 206d 6164  o attempt is mad
│ │ │ │ │ -00009160: 650a 2020 2020 2074 6f20 6163 6365 7373  e.     to access
│ │ │ │ │ -00009170: 206f 7220 6368 6563 6b20 7468 6520 7369   or check the si
│ │ │ │ │ -00009180: 676e 6174 7572 652e 2020 5468 6973 2066  gnature.  This f
│ │ │ │ │ -00009190: 6c61 6720 6973 2073 6574 2074 6f20 7472  lag is set to tr
│ │ │ │ │ -000091a0: 7565 2062 790a 2020 2020 2064 6566 6175  ue by.     defau
│ │ │ │ │ -000091b0: 6c74 2e0a 0a20 2d2d 2046 756e 6374 696f  lt... -- Functio
│ │ │ │ │ -000091c0: 6e3a 2069 6e74 2066 6b6f 5f73 6574 5f67  n: int fko_set_g
│ │ │ │ │ -000091d0: 7067 5f69 676e 6f72 655f 7665 7269 6679  pg_ignore_verify
│ │ │ │ │ -000091e0: 5f65 7272 6f72 2028 666b 6f5f 6374 785f  _error (fko_ctx_
│ │ │ │ │ -000091f0: 7420 4354 582c 0a20 2020 2020 2020 2020  t CTX,.         
│ │ │ │ │ -00009200: 2075 6e73 6967 6e65 6420 6368 6172 2049   unsigned char I
│ │ │ │ │ -00009210: 474e 4f52 4529 3b0a 2020 2020 2053 6574  GNORE);.     Set
│ │ │ │ │ -00009220: 7320 7468 6520 6967 6e6f 7265 2073 6967  s the ignore sig
│ │ │ │ │ -00009230: 6e61 7475 7265 2076 6572 6966 7920 6572  nature verify er
│ │ │ │ │ -00009240: 726f 7220 666c 6167 2e20 2057 6865 6e20  ror flag.  When 
│ │ │ │ │ -00009250: 7365 7420 746f 2061 2074 7275 650a 2020  set to a true.  
│ │ │ │ │ -00009260: 2020 2076 616c 7565 2e20 2041 6e79 2073     value.  Any s
│ │ │ │ │ -00009270: 6967 6e61 7475 7265 2076 6572 6966 6963  ignature verific
│ │ │ │ │ -00009280: 6174 696f 6e20 6572 726f 7273 2061 7265  ation errors are
│ │ │ │ │ -00009290: 2069 676e 6f72 6564 2028 6275 7420 7374   ignored (but st
│ │ │ │ │ -000092a0: 696c 6c0a 2020 2020 2063 6170 7475 7265  ill.     capture
│ │ │ │ │ -000092b0: 6429 2061 6e64 2074 6865 2064 6563 6f64  d) and the decod
│ │ │ │ │ -000092c0: 696e 6720 7072 6f63 6573 7320 7769 6c6c  ing process will
│ │ │ │ │ -000092d0: 2063 6f6e 7469 6e75 652e 2020 5468 6520   continue.  The 
│ │ │ │ │ -000092e0: 6465 6661 756c 740a 2020 2020 2076 616c  default.     val
│ │ │ │ │ -000092f0: 7565 206f 6620 7468 6973 2066 6c61 6720  ue of this flag 
│ │ │ │ │ -00009300: 6973 2066 616c 7365 2e0a 0a20 2d2d 2046  is false... -- F
│ │ │ │ │ -00009310: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko
│ │ │ │ │ -00009320: 5f73 6574 5f67 7067 5f65 7865 2028 666b  _set_gpg_exe (fk
│ │ │ │ │ -00009330: 6f5f 6374 785f 7420 4354 582c 2063 6f6e  o_ctx_t CTX, con
│ │ │ │ │ -00009340: 7374 2063 6861 7220 4750 475f 4558 4529  st char GPG_EXE)
│ │ │ │ │ -00009350: 3b0a 2020 2020 2053 6574 7320 7468 6520  ;.     Sets the 
│ │ │ │ │ -00009360: 7061 7468 2074 6f20 7468 6520 4750 4720  path to the GPG 
│ │ │ │ │ -00009370: 6578 6563 7574 6162 6c65 2074 6861 7420  executable that 
│ │ │ │ │ -00009380: 5f67 7067 6d65 5f20 7769 6c6c 2075 7365  _gpgme_ will use
│ │ │ │ │ -00009390: 2e20 2042 790a 2020 2020 2064 6566 6175  .  By.     defau
│ │ │ │ │ -000093a0: 6c74 2c20 5f6c 6962 666b 6f5f 2066 6f72  lt, _libfko_ for
│ │ │ │ │ -000093b0: 6365 7320 5f67 7067 6d65 5f20 746f 2075  ces _gpgme_ to u
│ │ │ │ │ -000093c0: 7365 2027 6770 6727 2069 6e20 6361 7365  se 'gpg' in case
│ │ │ │ │ -000093d0: 205f 6770 676d 655f 2077 6173 0a20 2020   _gpgme_ was.   
│ │ │ │ │ -000093e0: 2020 636f 6d70 696c 6564 2074 6f20 7573    compiled to us
│ │ │ │ │ -000093f0: 6520 2767 7067 3227 2061 7320 6974 7320  e 'gpg2' as its 
│ │ │ │ │ -00009400: 6465 6661 756c 7420 656e 6769 6e65 2e20  default engine. 
│ │ │ │ │ -00009410: 2059 6f75 2063 616e 2075 7365 2074 6869   You can use thi
│ │ │ │ │ -00009420: 730a 2020 2020 2066 756e 6374 696f 6e20  s.     function 
│ │ │ │ │ -00009430: 746f 206f 7665 7272 6964 6520 616e 6420  to override and 
│ │ │ │ │ -00009440: 7365 7420 7768 6174 2047 5047 2065 7865  set what GPG exe
│ │ │ │ │ -00009450: 6375 7461 626c 6520 5f67 7067 6d65 5f20  cutable _gpgme_ 
│ │ │ │ │ -00009460: 7769 6c6c 2075 7365 2e0a 0a2a 4e6f 7465  will use...*Note
│ │ │ │ │ -00009470: 2a3a 204f 6e20 6120 6c69 6266 6b6f 2062  *: On a libfko b
│ │ │ │ │ -00009480: 7569 6c64 2077 6974 686f 7574 2047 5047  uild without GPG
│ │ │ │ │ -00009490: 2073 7570 706f 7274 2c20 7468 6520 4750   support, the GP
│ │ │ │ │ -000094a0: 472d 7265 6c61 7465 6420 6675 6e63 7469  G-related functi
│ │ │ │ │ -000094b0: 6f6e 730a 6162 6f76 6520 7769 6c6c 2073  ons.above will s
│ │ │ │ │ -000094c0: 696d 706c 7920 7265 7475 726e 2074 6865  imply return the
│ │ │ │ │ -000094d0: 2046 4b4f 5f45 5252 4f52 5f55 4e53 5550   FKO_ERROR_UNSUP
│ │ │ │ │ -000094e0: 504f 5254 4544 5f46 4541 5455 5245 2065  PORTED_FEATURE e
│ │ │ │ │ -000094f0: 7272 6f72 2063 6f64 652e 0a0a 1f0a 4669  rror code.....Fi
│ │ │ │ │ -00009500: 6c65 3a20 6c69 6266 6b6f 2e69 6e66 6f2c  le: libfko.info,
│ │ │ │ │ -00009510: 2020 4e6f 6465 3a20 5265 7472 6965 7669    Node: Retrievi
│ │ │ │ │ -00009520: 6e67 2053 5041 2044 6174 612c 2020 4e65  ng SPA Data,  Ne
│ │ │ │ │ -00009530: 7874 3a20 5574 696c 6974 7920 4675 6e63  xt: Utility Func
│ │ │ │ │ -00009540: 7469 6f6e 732c 2020 5072 6576 3a20 5365  tions,  Prev: Se
│ │ │ │ │ -00009550: 7474 696e 6720 5350 4120 4461 7461 2c20  tting SPA Data, 
│ │ │ │ │ -00009560: 2055 703a 2055 7369 6e67 206c 6962 666b   Up: Using libfk
│ │ │ │ │ -00009570: 6f0a 0a33 2e35 2052 6574 7269 6576 696e  o..3.5 Retrievin
│ │ │ │ │ -00009580: 6720 5350 4120 4461 7461 0a3d 3d3d 3d3d  g SPA Data.=====
│ │ │ │ │ +00006540: 0a0a 5468 6973 2073 6563 7469 6f6e 2064  ..This section d
│ │ │ │ │ +00006550: 6573 6372 6962 6573 2074 6865 2070 726f  escribes the pro
│ │ │ │ │ +00006560: 6365 7373 2066 6f72 2063 7265 6174 696e  cess for creatin
│ │ │ │ │ +00006570: 6720 6120 6e65 7720 666b 6f20 5350 4120  g a new fko SPA 
│ │ │ │ │ +00006580: 6d65 7373 6167 652e 0a41 6674 6572 2063  message..After c
│ │ │ │ │ +00006590: 7265 6174 696e 6720 6120 636f 6e74 6578  reating a contex
│ │ │ │ │ +000065a0: 742c 2074 6865 7265 2061 7265 2073 7469  t, there are sti
│ │ │ │ │ +000065b0: 6c6c 2073 6f6d 6520 7265 7175 6973 6974  ll some requisit
│ │ │ │ │ +000065c0: 6520 5350 4120 6461 7461 2066 6965 6c64  e SPA data field
│ │ │ │ │ +000065d0: 730a 616e 6420 5350 4120 7061 7261 6d65  s.and SPA parame
│ │ │ │ │ +000065e0: 7465 7273 2074 6861 7420 6e65 6564 2074  ters that need t
│ │ │ │ │ +000065f0: 6f20 6265 2073 6574 2062 6566 6f72 6520  o be set before 
│ │ │ │ │ +00006600: 7468 6520 6669 6e61 6c20 656e 6372 7970  the final encryp
│ │ │ │ │ +00006610: 7465 640a 6d65 7373 6167 6520 6973 2072  ted.message is r
│ │ │ │ │ +00006620: 6561 6479 2e0a 0a20 2020 5468 6520 666f  eady...   The fo
│ │ │ │ │ +00006630: 6c6c 6f77 696e 6720 6c69 7374 2063 6f6e  llowing list con
│ │ │ │ │ +00006640: 7461 696e 7320 7468 6520 6d69 6e69 6d75  tains the minimu
│ │ │ │ │ +00006650: 6d20 7265 7175 6972 6564 2066 6965 6c64  m required field
│ │ │ │ │ +00006660: 7320 666f 7220 610a 636f 6d70 6c65 7465  s for a.complete
│ │ │ │ │ +00006670: 2066 6b6f 2053 5041 206d 6573 7361 6765   fko SPA message
│ │ │ │ │ +00006680: 2e20 2059 6f75 2073 686f 756c 6420 616c  .  You should al
│ │ │ │ │ +00006690: 736f 2074 616b 6520 6e6f 7465 206f 6620  so take note of 
│ │ │ │ │ +000066a0: 7468 6520 6f72 6465 7220 6f66 0a74 6865  the order of.the
│ │ │ │ │ +000066b0: 7365 2070 6172 616d 6574 6572 7320 6173  se parameters as
│ │ │ │ │ +000066c0: 2077 656c 6c2e 2020 5365 7474 696e 6720   well.  Setting 
│ │ │ │ │ +000066d0: 7468 6520 2274 7970 6522 2070 6172 616d  the "type" param
│ │ │ │ │ +000066e0: 6574 6572 7320 6669 7273 7420 6973 0a72  eters first is.r
│ │ │ │ │ +000066f0: 6563 6f6d 6d65 6e64 6564 2028 6966 2079  ecommended (if y
│ │ │ │ │ +00006700: 6f75 2077 616e 7420 6120 7479 7065 206f  ou want a type o
│ │ │ │ │ +00006710: 7468 6572 2074 6861 6e20 7468 6520 6465  ther than the de
│ │ │ │ │ +00006720: 6661 756c 7429 2e0a 0a20 2020 2a20 6469  fault)...   * di
│ │ │ │ │ +00006730: 6765 7374 5f74 7970 6520 2d20 5f28 6465  gest_type - _(de
│ │ │ │ │ +00006740: 6661 756c 7420 6d61 7920 7375 6666 6963  fault may suffic
│ │ │ │ │ +00006750: 6529 5f0a 2020 202a 206d 6573 7361 6765  e)_.   * message
│ │ │ │ │ +00006760: 5f74 7970 6520 2d20 5f28 6465 6661 756c  _type - _(defaul
│ │ │ │ │ +00006770: 7420 6d61 7920 7375 6666 6963 6529 5f0a  t may suffice)_.
│ │ │ │ │ +00006780: 2020 202a 2065 6e63 7279 7074 696f 6e5f     * encryption_
│ │ │ │ │ +00006790: 7479 7065 202d 205f 2864 6566 6175 6c74  type - _(default
│ │ │ │ │ +000067a0: 206d 6179 2073 7566 6669 6365 295f 0a20   may suffice)_. 
│ │ │ │ │ +000067b0: 2020 2a20 7261 6e64 5f76 616c 202d 205f    * rand_val - _
│ │ │ │ │ +000067c0: 2864 6566 6175 6c74 2073 686f 756c 6420  (default should 
│ │ │ │ │ +000067d0: 7375 6666 6963 6529 5f0a 2020 202a 2074  suffice)_.   * t
│ │ │ │ │ +000067e0: 696d 655f 7374 616d 7020 2d20 5f28 6465  ime_stamp - _(de
│ │ │ │ │ +000067f0: 6661 756c 7420 7368 6f75 6c64 2073 7566  fault should suf
│ │ │ │ │ +00006800: 6669 6365 295f 0a20 2020 2a20 7573 6572  fice)_.   * user
│ │ │ │ │ +00006810: 6e61 6d65 202d 205f 2864 6566 6175 6c74  name - _(default
│ │ │ │ │ +00006820: 206d 6179 2073 7566 6669 6365 295f 0a20   may suffice)_. 
│ │ │ │ │ +00006830: 2020 2a20 7370 615f 6d65 7373 6167 6520    * spa_message 
│ │ │ │ │ +00006840: 2d20 5f28 6d75 7374 2062 6520 6578 706c  - _(must be expl
│ │ │ │ │ +00006850: 6963 6974 6c79 2073 6574 295f 0a0a 5f49  icitly set)_.._I
│ │ │ │ │ +00006860: 6620 7573 696e 6720 6770 6720 656e 6372  f using gpg encr
│ │ │ │ │ +00006870: 7970 7469 6f6e 3a5f 0a0a 2020 202a 2067  yption:_..   * g
│ │ │ │ │ +00006880: 7067 5f72 6563 6970 6965 6e74 202d 205f  pg_recipient - _
│ │ │ │ │ +00006890: 286d 7573 7420 6265 2065 7870 6c69 6369  (must be explici
│ │ │ │ │ +000068a0: 746c 7920 7365 7429 5f0a 2020 202a 2067  tly set)_.   * g
│ │ │ │ │ +000068b0: 7067 5f73 6967 6e65 7220 2d20 5f28 6f70  pg_signer - _(op
│ │ │ │ │ +000068c0: 7469 6f6e 616c 2c20 6275 7420 7265 636f  tional, but reco
│ │ │ │ │ +000068d0: 6d6d 656e 6465 6420 2d20 6d75 7374 2062  mmended - must b
│ │ │ │ │ +000068e0: 6520 6578 706c 6963 6974 6c79 2073 6574  e explicitly set
│ │ │ │ │ +000068f0: 0a20 2020 2020 6966 2075 7365 6429 5f0a  .     if used)_.
│ │ │ │ │ +00006900: 2020 202a 2067 7067 5f68 6f6d 655f 6469     * gpg_home_di
│ │ │ │ │ +00006910: 7220 2d20 5f28 6465 6661 756c 7420 6d61  r - _(default ma
│ │ │ │ │ +00006920: 7920 7375 6666 6963 6520 2d20 7479 7069  y suffice - typi
│ │ │ │ │ +00006930: 6361 6c6c 7920 2448 4f4d 452f 2e67 6e75  cally $HOME/.gnu
│ │ │ │ │ +00006940: 7067 295f 0a0a 2020 2057 6865 6e20 6120  pg)_..   When a 
│ │ │ │ │ +00006950: 636f 6e74 6578 7420 6973 2069 6e69 7469  context is initi
│ │ │ │ │ +00006960: 616c 697a 6564 2c20 736f 6d65 206f 6620  alized, some of 
│ │ │ │ │ +00006970: 7468 6520 5350 4120 6461 7461 2066 6965  the SPA data fie
│ │ │ │ │ +00006980: 6c64 7320 6172 650a 7072 652d 7365 7420  lds are.pre-set 
│ │ │ │ │ +00006990: 7769 7468 2064 6566 6175 6c74 2076 616c  with default val
│ │ │ │ │ +000069a0: 7565 7320 282a 6e6f 7465 2053 5041 2044  ues (*note SPA D
│ │ │ │ │ +000069b0: 6174 6120 466f 726d 6174 3a3a 292e 2020  ata Format::).  
│ │ │ │ │ +000069c0: 466f 7220 6669 656c 6473 2073 7563 680a  For fields such.
│ │ │ │ │ +000069d0: 6173 2027 7261 6e64 5f76 616c 272c 2027  as 'rand_val', '
│ │ │ │ │ +000069e0: 7573 6572 6e61 6d65 272c 2027 7469 6d65  username', 'time
│ │ │ │ │ +000069f0: 7374 616d 7027 2c20 276d 6573 7361 6765  stamp', 'message
│ │ │ │ │ +00006a00: 5f74 7970 6527 2c20 616e 640a 2764 6967  _type', and.'dig
│ │ │ │ │ +00006a10: 6573 745f 7479 7065 272c 2074 6865 7365  est_type', these
│ │ │ │ │ +00006a20: 2064 6566 6175 6c74 7320 6d61 7920 6265   defaults may be
│ │ │ │ │ +00006a30: 2073 7566 6669 6369 656e 742e 0a0a 2020   sufficient...  
│ │ │ │ │ +00006a40: 2054 6865 2066 756e 6374 696f 6e73 2075   The functions u
│ │ │ │ │ +00006a50: 7365 6420 746f 2073 6574 2074 6865 2076  sed to set the v
│ │ │ │ │ +00006a60: 6172 696f 7573 2053 5041 2064 6174 6120  arious SPA data 
│ │ │ │ │ +00006a70: 6669 656c 6473 2061 6e64 2070 6172 616d  fields and param
│ │ │ │ │ +00006a80: 6574 6572 730a 6172 6520 6465 7363 7269  eters.are descri
│ │ │ │ │ +00006a90: 6265 6420 696e 2064 6574 6169 6c20 696e  bed in detail in
│ │ │ │ │ +00006aa0: 202a 6e6f 7465 2053 6574 7469 6e67 2053   *note Setting S
│ │ │ │ │ +00006ab0: 5041 2044 6174 613a 3a2e 0a0a 2a4e 6f74  PA Data::...*Not
│ │ │ │ │ +00006ac0: 652a 3a20 4174 7465 6d70 7473 2074 6f20  e*: Attempts to 
│ │ │ │ │ +00006ad0: 6361 6c6c 2061 6e79 2022 2766 6b6f 5f27  call any "'fko_'
│ │ │ │ │ +00006ae0: 2220 6675 6e63 7469 6f6e 206f 6e20 6120  " function on a 
│ │ │ │ │ +00006af0: 636f 6e74 6578 7420 7468 6174 2068 6173  context that has
│ │ │ │ │ +00006b00: 206e 6f74 0a62 6565 6e20 696e 6974 6961   not.been initia
│ │ │ │ │ +00006b10: 6c69 7a65 6420 6361 6e20 6861 7665 2075  lized can have u
│ │ │ │ │ +00006b20: 6e64 6566 696e 6564 2063 6f6e 7365 7175  ndefined consequ
│ │ │ │ │ +00006b30: 656e 6365 732e 2020 4c69 6266 6b6f 2077  ences.  Libfko w
│ │ │ │ │ +00006b40: 696c 6c20 6174 7465 6d70 740a 746f 2072  ill attempt.to r
│ │ │ │ │ +00006b50: 6563 6f76 6572 2c20 616e 6420 6966 2073  ecover, and if s
│ │ │ │ │ +00006b60: 7563 6365 7373 6675 6c2c 2077 696c 6c20  uccessful, will 
│ │ │ │ │ +00006b70: 7265 7475 726e 2061 2073 7461 7475 7320  return a status 
│ │ │ │ │ +00006b80: 6f66 0a27 464b 4f5f 4552 524f 525f 4354  of.'FKO_ERROR_CT
│ │ │ │ │ +00006b90: 585f 4e4f 545f 494e 4954 4941 4c49 5a45  X_NOT_INITIALIZE
│ │ │ │ │ +00006ba0: 4427 2e0a 0a20 2020 4120 636f 6d6d 6f6e  D'...   A common
│ │ │ │ │ +00006bb0: 2053 5041 206d 6573 7361 6765 2069 7320   SPA message is 
│ │ │ │ │ +00006bc0: 6120 7369 6d70 6c65 2061 6363 6573 7320  a simple access 
│ │ │ │ │ +00006bd0: 7265 7175 6573 742e 2020 5468 6973 2072  request.  This r
│ │ │ │ │ +00006be0: 6571 7565 7374 2061 736b 730a 7468 6520  equest asks.the 
│ │ │ │ │ +00006bf0: 6677 6b6e 6f70 2073 6572 7665 7220 746f  fwknop server to
│ │ │ │ │ +00006c00: 2063 7265 6174 6520 6120 7465 6d70 6f72   create a tempor
│ │ │ │ │ +00006c10: 6172 7920 6669 7265 7761 6c6c 2072 756c  ary firewall rul
│ │ │ │ │ +00006c20: 6520 746f 2061 6c6c 6f77 2061 0a70 6172  e to allow a.par
│ │ │ │ │ +00006c30: 7469 6375 6c61 7220 4950 2061 6464 7265  ticular IP addre
│ │ │ │ │ +00006c40: 7373 2061 6363 6573 7320 746f 2061 2070  ss access to a p
│ │ │ │ │ +00006c50: 6172 7469 6375 6c61 7220 706f 7274 206f  articular port o
│ │ │ │ │ +00006c60: 6e20 7468 6520 6677 6b6e 6f70 2073 6572  n the fwknop ser
│ │ │ │ │ +00006c70: 7665 722e 0a41 7373 756d 696e 6720 7468  ver..Assuming th
│ │ │ │ │ +00006c80: 6520 6465 6661 756c 7473 2061 7265 2066  e defaults are f
│ │ │ │ │ +00006c90: 696e 6520 666f 7220 7468 6973 2c20 616c  ine for this, al
│ │ │ │ │ +00006ca0: 6c20 7765 206e 6565 6420 746f 2064 6f20  l we need to do 
│ │ │ │ │ +00006cb0: 6973 2063 7265 6174 6520 7468 650a 636f  is create the.co
│ │ │ │ │ +00006cc0: 6e74 6578 742c 2073 6574 2074 6865 206d  ntext, set the m
│ │ │ │ │ +00006cd0: 6573 7361 6765 2064 6174 6120 6669 656c  essage data fiel
│ │ │ │ │ +00006ce0: 642c 2063 616c 6c20 7468 6520 2766 6b6f  d, call the 'fko
│ │ │ │ │ +00006cf0: 5f73 7061 5f64 6174 615f 6669 6e61 6c27  _spa_data_final'
│ │ │ │ │ +00006d00: 0a66 756e 6374 696f 6e20 746f 2065 6e63  .function to enc
│ │ │ │ │ +00006d10: 6f64 6520 616e 6420 656e 6372 7970 742c  ode and encrypt,
│ │ │ │ │ +00006d20: 2070 726f 6365 7373 2074 6865 206d 6573   process the mes
│ │ │ │ │ +00006d30: 7361 6765 2c20 7468 656e 2064 6573 7472  sage, then destr
│ │ │ │ │ +00006d40: 6f79 2074 6865 0a63 6f6e 7465 7874 2e20  oy the.context. 
│ │ │ │ │ +00006d50: 2042 656c 6f77 2c20 7765 2068 6176 6520   Below, we have 
│ │ │ │ │ +00006d60: 6120 636f 6e74 7269 7665 6420 6269 7420  a contrived bit 
│ │ │ │ │ +00006d70: 6f66 2063 6f64 6520 6465 6d6f 6e73 7472  of code demonstr
│ │ │ │ │ +00006d80: 6174 696e 6720 7468 6973 3a0a 0a20 2020  ating this:..   
│ │ │ │ │ +00006d90: 2020 696e 740a 2020 2020 206d 6169 6e28    int.     main(
│ │ │ │ │ +00006da0: 696e 7420 6172 6763 2c20 6368 6172 202a  int argc, char *
│ │ │ │ │ +00006db0: 2a61 7267 7629 0a20 2020 2020 7b0a 2020  *argv).     {.  
│ │ │ │ │ +00006dc0: 2020 2020 2020 2066 6b6f 5f63 7478 5f74         fko_ctx_t
│ │ │ │ │ +00006dd0: 2020 2063 7478 3b20 2020 2020 2020 2020     ctx;         
│ │ │ │ │ +00006de0: 2020 2f2a 2046 4b4f 2043 6f6e 7465 7874    /* FKO Context
│ │ │ │ │ +00006df0: 202a 2f0a 2020 2020 2020 2020 2063 6861   */.         cha
│ │ │ │ │ +00006e00: 7220 2020 2020 2020 2a6b 6579 3b20 2020  r       *key;   
│ │ │ │ │ +00006e10: 2020 2020 2020 2020 2f2a 2045 6e63 7279          /* Encry
│ │ │ │ │ +00006e20: 7074 696f 6e20 7061 7373 7068 7261 7365  ption passphrase
│ │ │ │ │ +00006e30: 202a 2f0a 2020 2020 2020 2020 2063 6861   */.         cha
│ │ │ │ │ +00006e40: 7220 2020 2020 2020 2a68 6d61 635f 6b65  r       *hmac_ke
│ │ │ │ │ +00006e50: 793b 2020 2020 2020 2f2a 2048 4d41 4320  y;      /* HMAC 
│ │ │ │ │ +00006e60: 6b65 7920 2a2f 0a20 2020 2020 2020 2020  key */.         
│ │ │ │ │ +00006e70: 6368 6172 2020 2020 2020 202a 6669 6e61  char       *fina
│ │ │ │ │ +00006e80: 6c5f 7370 613b 2020 2020 202f 2a20 4669  l_spa;     /* Fi
│ │ │ │ │ +00006e90: 6e61 6c20 656e 6372 7970 7465 6420 5350  nal encrypted SP
│ │ │ │ │ +00006ea0: 4120 6461 7461 202a 2f0a 2020 2020 2020  A data */.      
│ │ │ │ │ +00006eb0: 2020 2069 6e74 2020 2020 2020 2020 206b     int         k
│ │ │ │ │ +00006ec0: 6579 5f6c 656e 3b20 2020 2020 2020 2f2a  ey_len;       /*
│ │ │ │ │ +00006ed0: 204c 656e 6774 6820 6f66 2065 6e63 7279   Length of encry
│ │ │ │ │ +00006ee0: 7074 696f 6e20 6b65 7920 2a2f 0a20 2020  ption key */.   
│ │ │ │ │ +00006ef0: 2020 2020 2020 696e 7420 2020 2020 2020        int       
│ │ │ │ │ +00006f00: 2020 686d 6163 5f6b 6579 5f6c 656e 3b20    hmac_key_len; 
│ │ │ │ │ +00006f10: 202f 2a20 4c65 6e67 7468 206f 6620 484d   /* Length of HM
│ │ │ │ │ +00006f20: 4143 206b 6579 202a 2f0a 2020 2020 2020  AC key */.      
│ │ │ │ │ +00006f30: 2020 2069 6e74 2020 2020 2020 2020 2072     int         r
│ │ │ │ │ +00006f40: 633b 2020 2020 2020 2020 2020 2020 2f2a  c;            /*
│ │ │ │ │ +00006f50: 2052 6573 756c 7420 636f 6465 202a 2f0a   Result code */.
│ │ │ │ │ +00006f60: 2020 2020 2020 2020 2069 6e74 2020 2020           int    
│ │ │ │ │ +00006f70: 2020 2020 2068 6d61 635f 7479 7065 203d       hmac_type =
│ │ │ │ │ +00006f80: 2046 4b4f 5f48 4d41 435f 5348 4132 3536   FKO_HMAC_SHA256
│ │ │ │ │ +00006f90: 3b20 2020 2f2a 2044 6566 6175 6c74 2048  ;   /* Default H
│ │ │ │ │ +00006fa0: 4d41 4320 6469 6765 7374 202a 2f0a 2020  MAC digest */.  
│ │ │ │ │ +00006fb0: 2020 2020 2020 2069 6e74 2020 2020 2020         int      
│ │ │ │ │ +00006fc0: 2020 2065 6e63 5f6d 6f64 6520 203d 2046     enc_mode  = F
│ │ │ │ │ +00006fd0: 4b4f 5f45 4e43 5f4d 4f44 455f 4153 594d  KO_ENC_MODE_ASYM
│ │ │ │ │ +00006fe0: 4d45 5452 4943 3b20 202f 2a20 5573 6520  METRIC;  /* Use 
│ │ │ │ │ +00006ff0: 4750 4720 2a2f 0a0a 2020 2020 2020 2020  GPG */..        
│ │ │ │ │ +00007000: 202f 2a20 2041 7373 756d 6520 7765 2070   /*  Assume we p
│ │ │ │ │ +00007010: 726f 6365 7373 6564 2074 6865 2063 6f6d  rocessed the com
│ │ │ │ │ +00007020: 6d61 6e64 206c 696e 650a 2020 2020 2020  mand line.      
│ │ │ │ │ +00007030: 2020 2020 2a20 2061 6e64 2072 6574 7269      *  and retri
│ │ │ │ │ +00007040: 6576 6564 2074 6865 2070 6173 7377 6f72  eved the passwor
│ │ │ │ │ +00007050: 6420 616e 6420 7468 6520 484d 4143 206b  d and the HMAC k
│ │ │ │ │ +00007060: 6579 2061 6e64 0a20 2020 2020 2020 2020  ey and.         
│ │ │ │ │ +00007070: 2a20 2020 7365 7420 7468 6569 7220 6173  *   set their as
│ │ │ │ │ +00007080: 736f 6369 6174 6564 206c 656e 6774 6873  sociated lengths
│ │ │ │ │ +00007090: 2e0a 2020 2020 2020 2020 202a 2f0a 0a20  ..         */.. 
│ │ │ │ │ +000070a0: 2020 2020 2020 2020 2f2a 2043 7265 6174          /* Creat
│ │ │ │ │ +000070b0: 6520 7468 6520 636f 6e74 6578 7420 2a2f  e the context */
│ │ │ │ │ +000070c0: 0a20 2020 2020 2020 2020 7263 203d 2066  .         rc = f
│ │ │ │ │ +000070d0: 6b6f 5f6e 6577 2826 6374 7829 3b0a 2020  ko_new(&ctx);.  
│ │ │ │ │ +000070e0: 2020 2020 2020 2069 6628 7263 2021 3d20         if(rc != 
│ │ │ │ │ +000070f0: 464b 4f5f 5355 4343 4553 5329 0a20 2020  FKO_SUCCESS).   
│ │ │ │ │ +00007100: 2020 2020 2020 7b0a 2020 2020 2020 2020        {.        
│ │ │ │ │ +00007110: 2020 2020 2066 7072 696e 7466 2873 7464       fprintf(std
│ │ │ │ │ +00007120: 6572 722c 2022 4572 726f 7220 6372 6561  err, "Error crea
│ │ │ │ │ +00007130: 7469 6e67 2063 6f6e 7465 7874 3a20 2573  ting context: %s
│ │ │ │ │ +00007140: 5c6e 222c 2066 6b6f 5f65 7272 7374 7228  \n", fko_errstr(
│ │ │ │ │ +00007150: 7263 2929 3b0a 2020 2020 2020 2020 2020  rc));.          
│ │ │ │ │ +00007160: 2020 2065 7869 7428 3129 3b0a 2020 2020     exit(1);.    
│ │ │ │ │ +00007170: 2020 2020 207d 0a0a 2020 2020 2020 2020       }..        
│ │ │ │ │ +00007180: 202f 2a20 5365 7420 7468 6520 5350 4120   /* Set the SPA 
│ │ │ │ │ +00007190: 6d65 7373 6167 6520 6669 656c 6420 2d20  message field - 
│ │ │ │ │ +000071a0: 6173 6b69 6e67 2074 6f20 6f70 656e 2074  asking to open t
│ │ │ │ │ +000071b0: 6370 2070 6f72 7420 3232 0a20 2020 2020  cp port 22.     
│ │ │ │ │ +000071c0: 2020 2020 202a 2066 6f72 2074 6865 2073       * for the s
│ │ │ │ │ +000071d0: 7973 7465 6d20 6174 2031 3932 2e31 3638  ystem at 192.168
│ │ │ │ │ +000071e0: 2e30 2e33 330a 2020 2020 2020 2020 202a  .0.33.         *
│ │ │ │ │ +000071f0: 2f0a 2020 2020 2020 2020 2072 6320 3d20  /.         rc = 
│ │ │ │ │ +00007200: 666b 6f5f 7365 745f 7370 615f 6d65 7373  fko_set_spa_mess
│ │ │ │ │ +00007210: 6167 6528 6374 782c 2022 3139 322e 3136  age(ctx, "192.16
│ │ │ │ │ +00007220: 382e 302e 3333 2c74 6370 2f32 3222 293b  8.0.33,tcp/22");
│ │ │ │ │ +00007230: 0a20 2020 2020 2020 2020 6966 2872 6320  .         if(rc 
│ │ │ │ │ +00007240: 213d 2046 4b4f 5f53 5543 4345 5353 290a  != FKO_SUCCESS).
│ │ │ │ │ +00007250: 2020 2020 2020 2020 207b 0a20 2020 2020           {.     
│ │ │ │ │ +00007260: 2020 2020 2020 2020 6670 7269 6e74 6628          fprintf(
│ │ │ │ │ +00007270: 7374 6465 7272 2c20 2253 6574 2053 5041  stderr, "Set SPA
│ │ │ │ │ +00007280: 206d 6573 7361 6765 2066 6169 6c65 643a   message failed:
│ │ │ │ │ +00007290: 2025 735c 6e22 2c20 666b 6f5f 6572 7273   %s\n", fko_errs
│ │ │ │ │ +000072a0: 7472 2872 6329 293b 0a20 2020 2020 2020  tr(rc));.       
│ │ │ │ │ +000072b0: 2020 2020 2020 6578 6974 2831 293b 0a20        exit(1);. 
│ │ │ │ │ +000072c0: 2020 2020 2020 2020 7d0a 0a20 2020 2020          }..     
│ │ │ │ │ +000072d0: 2020 2020 2f2a 204c 6574 2075 7320 6173      /* Let us as
│ │ │ │ │ +000072e0: 7375 6d65 2077 6520 6172 6520 7573 696e  sume we are usin
│ │ │ │ │ +000072f0: 6720 4750 4720 656e 6372 7970 7469 6f6e  g GPG encryption
│ │ │ │ │ +00007300: 2e20 2053 6f20 7765 206e 6565 6420 746f  .  So we need to
│ │ │ │ │ +00007310: 0a20 2020 2020 2020 2020 202a 2073 6574  .          * set
│ │ │ │ │ +00007320: 2074 6865 2065 6e63 7279 7074 696f 6e20   the encryption 
│ │ │ │ │ +00007330: 7479 7065 2061 6e64 2073 6574 2074 6865  type and set the
│ │ │ │ │ +00007340: 2072 6571 7569 7265 6420 4750 4720 7061   required GPG pa
│ │ │ │ │ +00007350: 7261 6d65 7465 7273 0a20 2020 2020 2020  rameters.       
│ │ │ │ │ +00007360: 2020 202a 2028 7765 2063 616e 2073 6b69     * (we can ski
│ │ │ │ │ +00007370: 7020 6368 6563 6b69 6e67 2072 6574 7572  p checking retur
│ │ │ │ │ +00007380: 6e20 7661 6c75 6573 2066 6f72 2062 7265  n values for bre
│ │ │ │ │ +00007390: 7669 7479 292e 0a20 2020 2020 2020 2020  vity)..         
│ │ │ │ │ +000073a0: 2a2f 0a20 2020 2020 2020 2020 7263 203d  */.         rc =
│ │ │ │ │ +000073b0: 2066 6b6f 5f73 6574 5f73 7061 5f65 6e63   fko_set_spa_enc
│ │ │ │ │ +000073c0: 7279 7074 696f 6e5f 7479 7065 2863 7478  ryption_type(ctx
│ │ │ │ │ +000073d0: 2c20 464b 4f5f 454e 4352 5950 5449 4f4e  , FKO_ENCRYPTION
│ │ │ │ │ +000073e0: 5f47 5047 293b 0a0a 2020 2020 2020 2020  _GPG);..        
│ │ │ │ │ +000073f0: 202f 2a20 4b65 7920 666f 7220 7468 6520   /* Key for the 
│ │ │ │ │ +00007400: 7265 6369 7069 656e 7420 2a2f 0a20 2020  recipient */.   
│ │ │ │ │ +00007410: 2020 2020 2020 7263 203d 2066 6b6f 5f73        rc = fko_s
│ │ │ │ │ +00007420: 6574 5f67 7067 5f72 6563 6970 6965 6e74  et_gpg_recipient
│ │ │ │ │ +00007430: 2863 7478 2c20 2272 6563 6970 4073 6f6d  (ctx, "recip@som
│ │ │ │ │ +00007440: 652e 7768 6572 6522 293b 0a0a 2020 2020  e.where");..    
│ │ │ │ │ +00007450: 2020 2020 202f 2a20 4b65 7920 666f 7220       /* Key for 
│ │ │ │ │ +00007460: 7468 6520 7369 676e 6572 2028 6966 2079  the signer (if y
│ │ │ │ │ +00007470: 6f75 2077 616e 7420 746f 2073 6967 6e20  ou want to sign 
│ │ │ │ │ +00007480: 6974 2920 2a2f 0a20 2020 2020 2020 2020  it) */.         
│ │ │ │ │ +00007490: 7263 203d 2066 6b6f 5f73 6574 5f67 7067  rc = fko_set_gpg
│ │ │ │ │ +000074a0: 5f73 6967 6e65 7228 6374 782c 2022 6d65  _signer(ctx, "me
│ │ │ │ │ +000074b0: 4072 6967 6874 2e68 6572 6522 293b 0a0a  @right.here");..
│ │ │ │ │ +000074c0: 2020 2020 2020 2020 202f 2a20 4669 6e61           /* Fina
│ │ │ │ │ +000074d0: 6c69 7a65 2074 6865 2053 5041 2064 6174  lize the SPA dat
│ │ │ │ │ +000074e0: 6120 2a2f 0a20 2020 2020 2020 2020 7263  a */.         rc
│ │ │ │ │ +000074f0: 203d 2066 6b6f 5f73 7061 5f64 6174 615f   = fko_spa_data_
│ │ │ │ │ +00007500: 6669 6e61 6c28 6374 782c 206b 6579 2c20  final(ctx, key, 
│ │ │ │ │ +00007510: 6b65 795f 6c65 6e2c 2065 6e63 5f6d 6f64  key_len, enc_mod
│ │ │ │ │ +00007520: 652c 0a20 2020 2020 2020 2020 2020 2020  e,.             
│ │ │ │ │ +00007530: 2020 2020 686d 6163 5f6b 6579 2c20 686d      hmac_key, hm
│ │ │ │ │ +00007540: 6163 5f6b 6579 5f6c 656e 2c20 686d 6163  ac_key_len, hmac
│ │ │ │ │ +00007550: 5f74 7970 6529 3b0a 2020 2020 2020 2020  _type);.        
│ │ │ │ │ +00007560: 2069 6628 7263 2021 3d20 464b 4f5f 5355   if(rc != FKO_SU
│ │ │ │ │ +00007570: 4343 4553 5329 0a20 2020 2020 2020 2020  CCESS).         
│ │ │ │ │ +00007580: 7b0a 2020 2020 2020 2020 2020 2020 2066  {.             f
│ │ │ │ │ +00007590: 7072 696e 7466 2873 7464 6572 722c 2022  printf(stderr, "
│ │ │ │ │ +000075a0: 4572 726f 7220 656e 636f 6469 6e67 2053  Error encoding S
│ │ │ │ │ +000075b0: 5041 2064 6174 613a 2025 735c 6e22 2c0a  PA data: %s\n",.
│ │ │ │ │ +000075c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ +000075d0: 2066 6b6f 5f65 7272 7374 7228 7263 2929   fko_errstr(rc))
│ │ │ │ │ +000075e0: 3b0a 2020 2020 2020 2020 2020 2020 2065  ;.             e
│ │ │ │ │ +000075f0: 7869 7428 3129 3b0a 2020 2020 2020 2020  xit(1);.        
│ │ │ │ │ +00007600: 207d 0a0a 2020 2020 2020 2020 202f 2a20   }..         /* 
│ │ │ │ │ +00007610: 5461 6b65 2074 6865 2066 696e 616c 206d  Take the final m
│ │ │ │ │ +00007620: 6573 7361 6765 2061 6e64 2064 6f20 736f  essage and do so
│ │ │ │ │ +00007630: 6d65 7468 696e 6720 7769 7468 2069 7420  mething with it 
│ │ │ │ │ +00007640: 2a2f 0a20 2020 2020 2020 2020 7263 203d  */.         rc =
│ │ │ │ │ +00007650: 2066 6b6f 5f67 6574 5f73 7061 5f64 6174   fko_get_spa_dat
│ │ │ │ │ +00007660: 6128 6374 782c 2026 6669 6e61 6c5f 7370  a(ctx, &final_sp
│ │ │ │ │ +00007670: 6129 3b0a 0a20 2020 2020 2020 2020 2f2a  a);..         /*
│ │ │ │ │ +00007680: 2041 7373 756d 6520 7468 6973 2066 756e   Assume this fun
│ │ │ │ │ +00007690: 6374 696f 6e20 7061 636b 7320 7468 6520  ction packs the 
│ │ │ │ │ +000076a0: 7370 6120 6461 7461 2069 6e74 6f20 6120  spa data into a 
│ │ │ │ │ +000076b0: 5544 500a 2020 2020 2020 2020 2020 2a20  UDP.          * 
│ │ │ │ │ +000076c0: 7061 636b 6574 2061 6e64 2073 656e 6473  packet and sends
│ │ │ │ │ +000076d0: 2069 7420 746f 2074 6865 2073 6572 7665   it to the serve
│ │ │ │ │ +000076e0: 722e 0a20 2020 2020 2020 2020 2a2f 0a20  r..         */. 
│ │ │ │ │ +000076f0: 2020 2020 2020 2020 7365 6e64 5f73 7061          send_spa
│ │ │ │ │ +00007700: 5f6d 6573 7361 6765 2866 696e 616c 5f73  _message(final_s
│ │ │ │ │ +00007710: 7061 293b 0a0a 2020 2020 2020 2020 202f  pa);..         /
│ │ │ │ │ +00007720: 2a20 446f 6e65 2077 6974 6820 7468 6520  * Done with the 
│ │ │ │ │ +00007730: 636f 6e74 6578 7420 2a2f 0a20 2020 2020  context */.     
│ │ │ │ │ +00007740: 2020 2020 666b 6f5f 6465 7374 726f 7928      fko_destroy(
│ │ │ │ │ +00007750: 6374 7829 3b0a 0a20 2020 2020 2020 2020  ctx);..         
│ │ │ │ │ +00007760: 6578 6974 2830 293b 0a20 2020 2020 7d0a  exit(0);.     }.
│ │ │ │ │ +00007770: 0a1f 0a46 696c 653a 206c 6962 666b 6f2e  ...File: libfko.
│ │ │ │ │ +00007780: 696e 666f 2c20 204e 6f64 653a 2053 6574  info,  Node: Set
│ │ │ │ │ +00007790: 7469 6e67 2053 5041 2044 6174 612c 2020  ting SPA Data,  
│ │ │ │ │ +000077a0: 4e65 7874 3a20 5265 7472 6965 7669 6e67  Next: Retrieving
│ │ │ │ │ +000077b0: 2053 5041 2044 6174 612c 2020 5072 6576   SPA Data,  Prev
│ │ │ │ │ +000077c0: 3a20 4372 6561 7469 6e67 2061 2053 5041  : Creating a SPA
│ │ │ │ │ +000077d0: 204d 6573 7361 6765 2c20 2055 703a 2055   Message,  Up: U
│ │ │ │ │ +000077e0: 7369 6e67 206c 6962 666b 6f0a 0a33 2e34  sing libfko..3.4
│ │ │ │ │ +000077f0: 2053 6574 7469 6e67 2053 5041 2044 6174   Setting SPA Dat
│ │ │ │ │ +00007800: 610a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  a.==============
│ │ │ │ │ +00007810: 3d3d 3d3d 3d3d 0a0a 5468 6973 2073 6563  ======..This sec
│ │ │ │ │ +00007820: 7469 6f6e 2064 6573 6372 6962 6573 2074  tion describes t
│ │ │ │ │ +00007830: 6865 2066 756e 6374 696f 6e73 2075 7365  he functions use
│ │ │ │ │ +00007840: 6420 666f 7220 7365 7474 696e 6720 7468  d for setting th
│ │ │ │ │ +00007850: 6520 7661 7269 6f75 7320 5350 410a 6461  e various SPA.da
│ │ │ │ │ +00007860: 7461 2066 6965 6c64 7320 616e 6420 7061  ta fields and pa
│ │ │ │ │ +00007870: 7261 6d65 7465 7273 2e20 2041 6c6c 206f  rameters.  All o
│ │ │ │ │ +00007880: 6620 7468 6573 6520 6675 6e63 7469 6f6e  f these function
│ │ │ │ │ +00007890: 7320 7265 7475 726e 2061 6e20 696e 7465  s return an inte
│ │ │ │ │ +000078a0: 6765 720a 7265 7072 6573 656e 7469 6e67  ger.representing
│ │ │ │ │ +000078b0: 2074 6865 2072 6574 7572 6e20 7374 6174   the return stat
│ │ │ │ │ +000078c0: 7573 206f 6620 7468 6520 6675 6e63 7469  us of the functi
│ │ │ │ │ +000078d0: 6f6e 2e20 2057 6865 6e20 7375 6363 6573  on.  When succes
│ │ │ │ │ +000078e0: 6675 6c6c 2c20 7468 6579 0a77 696c 6c20  full, they.will 
│ │ │ │ │ +000078f0: 7265 7475 726e 2027 464b 4f5f 5355 4343  return 'FKO_SUCC
│ │ │ │ │ +00007900: 4553 5327 2e20 204f 7468 6572 7769 7365  ESS'.  Otherwise
│ │ │ │ │ +00007910: 2c20 616e 2065 7272 6f72 2063 6f64 6520  , an error code 
│ │ │ │ │ +00007920: 7661 6c75 6520 6973 2072 6574 7572 6e65  value is returne
│ │ │ │ │ +00007930: 642e 0a0a 202d 2d20 4675 6e63 7469 6f6e  d... -- Function
│ │ │ │ │ +00007940: 3a20 696e 7420 666b 6f5f 7365 745f 7370  : int fko_set_sp
│ │ │ │ │ +00007950: 615f 6469 6765 7374 5f74 7970 6520 2866  a_digest_type (f
│ │ │ │ │ +00007960: 6b6f 5f63 7478 5f74 2043 5458 2c20 7368  ko_ctx_t CTX, sh
│ │ │ │ │ +00007970: 6f72 740a 2020 2020 2020 2020 2020 4449  ort.          DI
│ │ │ │ │ +00007980: 4745 5354 5f54 5950 4529 3b0a 2020 2020  GEST_TYPE);.    
│ │ │ │ │ +00007990: 2053 6574 2074 6865 206d 6573 7361 6765   Set the message
│ │ │ │ │ +000079a0: 2064 6967 6573 7420 7479 7065 2e20 2056   digest type.  V
│ │ │ │ │ +000079b0: 616c 6964 2076 616c 7565 7320 6361 6e20  alid values can 
│ │ │ │ │ +000079c0: 6265 2066 6f75 6e64 2069 6e20 2a6e 6f74  be found in *not
│ │ │ │ │ +000079d0: 650a 2020 2020 2044 6967 6573 7473 3a3a  e.     Digests::
│ │ │ │ │ +000079e0: 206f 6620 7468 6973 206d 616e 7561 6c2e   of this manual.
│ │ │ │ │ +000079f0: 2020 4966 2061 2076 616c 7565 206f 7468    If a value oth
│ │ │ │ │ +00007a00: 6572 2074 6861 6e20 7468 6520 7468 6f73  er than the thos
│ │ │ │ │ +00007a10: 6520 7468 6174 2061 7265 0a20 2020 2020  e that are.     
│ │ │ │ │ +00007a20: 7375 7070 6f72 7465 6420 6973 2067 6976  supported is giv
│ │ │ │ │ +00007a30: 656e 2c20 7468 6520 6675 6e63 7469 6f6e  en, the function
│ │ │ │ │ +00007a40: 2077 696c 6c20 7265 7475 726e 0a20 2020   will return.   
│ │ │ │ │ +00007a50: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ +00007a60: 414c 4944 5f44 4154 4127 2e20 2046 6f72  ALID_DATA'.  For
│ │ │ │ │ +00007a70: 2065 7861 6d70 6c65 3a0a 2020 2020 2020   example:.      
│ │ │ │ │ +00007a80: 2020 2020 2020 2020 7263 203d 2066 6b6f          rc = fko
│ │ │ │ │ +00007a90: 5f73 6574 5f64 6967 6573 745f 7479 7065  _set_digest_type
│ │ │ │ │ +00007aa0: 2863 7478 2c20 464b 4f5f 4449 4745 5354  (ctx, FKO_DIGEST
│ │ │ │ │ +00007ab0: 5f53 4841 3129 3b0a 0a20 2d2d 2046 756e  _SHA1);.. -- Fun
│ │ │ │ │ +00007ac0: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f73  ction: int fko_s
│ │ │ │ │ +00007ad0: 6574 5f73 7061 5f68 6d61 635f 7479 7065  et_spa_hmac_type
│ │ │ │ │ +00007ae0: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,
│ │ │ │ │ +00007af0: 2073 686f 7274 0a20 2020 2020 2020 2020   short.         
│ │ │ │ │ +00007b00: 2048 4d41 435f 5459 5045 293b 0a20 2020   HMAC_TYPE);.   
│ │ │ │ │ +00007b10: 2020 5365 7420 7468 6520 6d65 7373 6167    Set the messag
│ │ │ │ │ +00007b20: 6520 686d 6163 2074 7970 652e 2020 5661  e hmac type.  Va
│ │ │ │ │ +00007b30: 6c69 6420 7661 6c75 6573 2063 616e 2062  lid values can b
│ │ │ │ │ +00007b40: 6520 666f 756e 6420 696e 202a 6e6f 7465  e found in *note
│ │ │ │ │ +00007b50: 2048 4d41 430a 2020 2020 2044 6967 6573   HMAC.     Diges
│ │ │ │ │ +00007b60: 7473 3a3a 206f 6620 7468 6973 206d 616e  ts:: of this man
│ │ │ │ │ +00007b70: 7561 6c2e 2020 4966 2061 2076 616c 7565  ual.  If a value
│ │ │ │ │ +00007b80: 206f 7468 6572 2074 6861 6e20 7468 6520   other than the 
│ │ │ │ │ +00007b90: 7468 6f73 6520 7468 6174 2061 7265 0a20  those that are. 
│ │ │ │ │ +00007ba0: 2020 2020 7375 7070 6f72 7465 6420 6973      supported is
│ │ │ │ │ +00007bb0: 2067 6976 656e 2c20 7468 6520 6675 6e63   given, the func
│ │ │ │ │ +00007bc0: 7469 6f6e 2077 696c 6c20 7265 7475 726e  tion will return
│ │ │ │ │ +00007bd0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ +00007be0: 5f49 4e56 414c 4944 5f44 4154 4127 2e20  _INVALID_DATA'. 
│ │ │ │ │ +00007bf0: 2046 6f72 2065 7861 6d70 6c65 3a0a 2020   For example:.  
│ │ │ │ │ +00007c00: 2020 2020 2020 2020 2020 2020 7263 203d              rc =
│ │ │ │ │ +00007c10: 2066 6b6f 5f73 6574 5f68 6d61 635f 7479   fko_set_hmac_ty
│ │ │ │ │ +00007c20: 7065 2863 7478 2c20 464b 4f5f 484d 4143  pe(ctx, FKO_HMAC
│ │ │ │ │ +00007c30: 5f53 4841 3235 3629 3b0a 0a20 2d2d 2046  _SHA256);.. -- F
│ │ │ │ │ +00007c40: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko
│ │ │ │ │ +00007c50: 5f73 6574 5f73 7061 5f65 6e63 7279 7074  _set_spa_encrypt
│ │ │ │ │ +00007c60: 696f 6e5f 7479 7065 2028 666b 6f5f 6374  ion_type (fko_ct
│ │ │ │ │ +00007c70: 785f 7420 4354 582c 2073 686f 7274 0a20  x_t CTX, short. 
│ │ │ │ │ +00007c80: 2020 2020 2020 2020 2045 4e43 5259 5054           ENCRYPT
│ │ │ │ │ +00007c90: 5f54 5950 4529 3b0a 2020 2020 2053 6574  _TYPE);.     Set
│ │ │ │ │ +00007ca0: 2074 6865 2065 6e63 7279 7469 6f6e 2061   the encrytion a
│ │ │ │ │ +00007cb0: 6c67 6f72 6974 686d 2074 6f20 7573 6520  lgorithm to use 
│ │ │ │ │ +00007cc0: 7768 656e 2065 6372 7970 7469 6e67 2074  when ecrypting t
│ │ │ │ │ +00007cd0: 6865 2066 696e 616c 2053 5041 0a20 2020  he final SPA.   
│ │ │ │ │ +00007ce0: 2020 6461 7461 2e20 2056 616c 6964 2076    data.  Valid v
│ │ │ │ │ +00007cf0: 616c 7565 7320 6361 6e20 6265 2066 6f75  alues can be fou
│ │ │ │ │ +00007d00: 6e64 2069 6e20 2a6e 6f74 6520 456e 6372  nd in *note Encr
│ │ │ │ │ +00007d10: 7970 7469 6f6e 2041 6c67 6f72 6974 686d  yption Algorithm
│ │ │ │ │ +00007d20: 733a 3a0a 2020 2020 206f 6620 7468 6973  s::.     of this
│ │ │ │ │ +00007d30: 206d 616e 7561 6c2e 2020 466f 7220 6578   manual.  For ex
│ │ │ │ │ +00007d40: 616d 706c 653a 0a20 2020 2020 2020 2020  ample:.         
│ │ │ │ │ +00007d50: 2020 2020 2072 6320 3d20 666b 6f5f 7365       rc = fko_se
│ │ │ │ │ +00007d60: 745f 656e 6372 7970 7469 6f6e 5f74 7970  t_encryption_typ
│ │ │ │ │ +00007d70: 6528 6374 782c 2046 4b4f 5f45 4e43 5259  e(ctx, FKO_ENCRY
│ │ │ │ │ +00007d80: 5054 494f 4e5f 5249 4a4e 4441 454c 293b  PTION_RIJNDAEL);
│ │ │ │ │ +00007d90: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ │ +00007da0: 696e 7420 666b 6f5f 7365 745f 7261 6e64  int fko_set_rand
│ │ │ │ │ +00007db0: 5f76 616c 7565 2028 666b 6f5f 6374 785f  _value (fko_ctx_
│ │ │ │ │ +00007dc0: 7420 4354 582c 2063 6f6e 7374 2063 6861  t CTX, const cha
│ │ │ │ │ +00007dd0: 7220 2a56 414c 293b 0a20 2020 2020 5365  r *VAL);.     Se
│ │ │ │ │ +00007de0: 7420 7468 6520 7261 6e64 6f6d 2076 616c  t the random val
│ │ │ │ │ +00007df0: 7565 2070 6f72 7469 6f6e 206f 6620 7468  ue portion of th
│ │ │ │ │ +00007e00: 6520 7370 6120 6461 7461 2074 6f20 7468  e spa data to th
│ │ │ │ │ +00007e10: 6520 6769 7665 6e20 7661 6c75 650a 2020  e given value.  
│ │ │ │ │ +00007e20: 2020 2028 5641 4c29 2e20 2054 6865 2067     (VAL).  The g
│ │ │ │ │ +00007e30: 6976 656e 2076 616c 7565 206d 7573 7420  iven value must 
│ │ │ │ │ +00007e40: 6265 2061 2070 6f69 6e74 6572 2074 6f20  be a pointer to 
│ │ │ │ │ +00007e50: 6120 3136 2d63 6861 7261 6374 6572 2064  a 16-character d
│ │ │ │ │ +00007e60: 6563 696d 616c 0a20 2020 2020 6e75 6d65  ecimal.     nume
│ │ │ │ │ +00007e70: 7269 6320 7374 7269 6e67 206f 7220 4e55  ric string or NU
│ │ │ │ │ +00007e80: 4c4c 2e20 4966 2074 6865 2076 616c 7565  LL. If the value
│ │ │ │ │ +00007e90: 2069 7320 4e55 4c4c 2c20 7468 6520 6675   is NULL, the fu
│ │ │ │ │ +00007ea0: 6e63 7469 6f6e 2067 656e 6572 6174 650a  nction generate.
│ │ │ │ │ +00007eb0: 2020 2020 2061 206e 6577 2072 616e 646f       a new rando
│ │ │ │ │ +00007ec0: 6d20 7661 6c75 652e 2020 4966 2061 2073  m value.  If a s
│ │ │ │ │ +00007ed0: 7472 696e 6720 7661 6c75 6520 6973 2070  tring value is p
│ │ │ │ │ +00007ee0: 726f 7669 6465 642c 2069 7420 6d75 7374  rovided, it must
│ │ │ │ │ +00007ef0: 2062 6520 610a 2020 2020 2031 362d 6368   be a.     16-ch
│ │ │ │ │ +00007f00: 6172 6163 7465 7220 6465 6369 6d61 6c20  aracter decimal 
│ │ │ │ │ +00007f10: 7374 7269 6e67 2e20 204f 7468 6572 7769  string.  Otherwi
│ │ │ │ │ +00007f20: 7365 2c20 7468 6520 6675 6e63 7469 6f6e  se, the function
│ │ │ │ │ +00007f30: 2077 696c 6c20 7265 7475 726e 0a20 2020   will return.   
│ │ │ │ │ +00007f40: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ +00007f50: 414c 4944 5f44 4154 4127 2e0a 0a20 2d2d  ALID_DATA'... --
│ │ │ │ │ +00007f60: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f
│ │ │ │ │ +00007f70: 6b6f 5f73 6574 5f75 7365 726e 616d 6520  ko_set_username 
│ │ │ │ │ +00007f80: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, 
│ │ │ │ │ +00007f90: 636f 6e73 7420 6368 6172 0a20 2020 2020  const char.     
│ │ │ │ │ +00007fa0: 2020 2020 202a 5553 4552 4e41 4d45 293b       *USERNAME);
│ │ │ │ │ +00007fb0: 0a20 2020 2020 5365 7420 7468 6520 7573  .     Set the us
│ │ │ │ │ +00007fc0: 6572 6e61 6d65 2066 6965 6c64 206f 6620  ername field of 
│ │ │ │ │ +00007fd0: 7468 6520 5350 4120 6461 7461 2e20 2049  the SPA data.  I
│ │ │ │ │ +00007fe0: 6620 5553 4552 4e41 4d45 2069 7320 4e55  f USERNAME is NU
│ │ │ │ │ +00007ff0: 4c4c 2c0a 2020 2020 206c 6962 666b 6f20  LL,.     libfko 
│ │ │ │ │ +00008000: 7769 6c6c 2066 6972 7374 206c 6f6f 6b20  will first look 
│ │ │ │ │ +00008010: 666f 7220 7468 6520 656e 7669 726f 6e6d  for the environm
│ │ │ │ │ +00008020: 656e 7420 7661 7269 6162 6c65 2027 5350  ent variable 'SP
│ │ │ │ │ +00008030: 4f4f 465f 5553 4552 270a 2020 2020 2061  OOF_USER'.     a
│ │ │ │ │ +00008040: 6e64 2075 7365 2069 7473 2076 616c 7565  nd use its value
│ │ │ │ │ +00008050: 2069 6620 666f 756e 642e 2020 4f74 6865   if found.  Othe
│ │ │ │ │ +00008060: 7277 6973 652c 2069 7420 7769 6c6c 2074  rwise, it will t
│ │ │ │ │ +00008070: 7279 2074 6f20 6465 7465 726d 696e 650a  ry to determine.
│ │ │ │ │ +00008080: 2020 2020 2074 6865 2075 7365 726e 616d       the usernam
│ │ │ │ │ +00008090: 6520 6974 7365 6c66 2075 7369 6e67 2076  e itself using v
│ │ │ │ │ +000080a0: 6172 696f 7573 206d 6574 686f 6473 2073  arious methods s
│ │ │ │ │ +000080b0: 7461 7274 696e 6720 7769 7468 2027 6375  tarting with 'cu
│ │ │ │ │ +000080c0: 7365 7227 206f 720a 2020 2020 2027 6765  ser' or.     'ge
│ │ │ │ │ +000080d0: 746c 6f67 696e 272c 2074 6865 6e20 6661  tlogin', then fa
│ │ │ │ │ +000080e0: 6c6c 6261 636b 2074 6f20 7468 6520 656e  llback to the en
│ │ │ │ │ +000080f0: 7669 726f 6e6d 656e 7420 7661 7269 6162  vironment variab
│ │ │ │ │ +00008100: 6c65 7320 274c 4f47 4e41 4d45 2720 6f72  les 'LOGNAME' or
│ │ │ │ │ +00008110: 0a20 2020 2020 2755 5345 5227 2e20 2049  .     'USER'.  I
│ │ │ │ │ +00008120: 6620 6e6f 6e65 206f 6620 7468 6f73 6520  f none of those 
│ │ │ │ │ +00008130: 776f 726b 2c20 7468 6520 6675 6e63 7469  work, the functi
│ │ │ │ │ +00008140: 6f6e 2077 696c 6c20 7265 7475 726e 0a20  on will return. 
│ │ │ │ │ +00008150: 2020 2020 2746 4b4f 5f45 5252 4f52 5f55      'FKO_ERROR_U
│ │ │ │ │ +00008160: 5345 524e 414d 455f 554e 4b4e 4f57 4e27  SERNAME_UNKNOWN'
│ │ │ │ │ +00008170: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:
│ │ │ │ │ +00008180: 2069 6e74 2066 6b6f 5f73 6574 5f74 696d   int fko_set_tim
│ │ │ │ │ +00008190: 6573 7461 6d70 2028 666b 6f5f 6374 785f  estamp (fko_ctx_
│ │ │ │ │ +000081a0: 7420 4354 582c 2069 6e74 204f 4646 5345  t CTX, int OFFSE
│ │ │ │ │ +000081b0: 5429 3b0a 2020 2020 2053 6574 7320 7468  T);.     Sets th
│ │ │ │ │ +000081c0: 6520 7469 6d65 7374 616d 7020 7661 6c75  e timestamp valu
│ │ │ │ │ +000081d0: 6520 6f66 2074 6865 2053 5041 2064 6174  e of the SPA dat
│ │ │ │ │ +000081e0: 6120 746f 2074 6865 2063 7572 7265 6e74  a to the current
│ │ │ │ │ +000081f0: 2074 696d 6520 706c 7573 0a20 2020 2020   time plus.     
│ │ │ │ │ +00008200: 7468 6520 6f66 6673 6574 2076 616c 7565  the offset value
│ │ │ │ │ +00008210: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:
│ │ │ │ │ +00008220: 2069 6e74 2066 6b6f 5f73 6574 5f73 7061   int fko_set_spa
│ │ │ │ │ +00008230: 5f6d 6573 7361 6765 5f74 7970 6520 2866  _message_type (f
│ │ │ │ │ +00008240: 6b6f 5f63 7478 5f74 2043 5458 2c20 7368  ko_ctx_t CTX, sh
│ │ │ │ │ +00008250: 6f72 740a 2020 2020 2020 2020 2020 4d53  ort.          MS
│ │ │ │ │ +00008260: 475f 5459 5045 293b 0a20 2020 2020 5365  G_TYPE);.     Se
│ │ │ │ │ +00008270: 7473 2074 6865 206d 6573 7361 6765 2074  ts the message t
│ │ │ │ │ +00008280: 7970 6520 666f 7220 7468 6520 5350 4120  ype for the SPA 
│ │ │ │ │ +00008290: 6461 7461 2e20 2054 6865 2063 686f 6963  data.  The choic
│ │ │ │ │ +000082a0: 6573 2066 6f72 2074 6865 0a20 2020 2020  es for the.     
│ │ │ │ │ +000082b0: 2773 7061 5f6d 6573 7361 6765 5f74 7970  'spa_message_typ
│ │ │ │ │ +000082c0: 6527 2061 7265 206c 6973 7465 6420 696e  e' are listed in
│ │ │ │ │ +000082d0: 202a 6e6f 7465 2053 5041 204d 6573 7361   *note SPA Messa
│ │ │ │ │ +000082e0: 6765 733a 3a2e 2020 466f 720a 2020 2020  ges::.  For.    
│ │ │ │ │ +000082f0: 2065 7861 6d70 6c65 3a0a 2020 2020 2020   example:.      
│ │ │ │ │ +00008300: 2020 2020 2020 2020 7263 203d 2066 6b6f          rc = fko
│ │ │ │ │ +00008310: 5f73 6574 5f73 7061 5f6d 6573 7361 6765  _set_spa_message
│ │ │ │ │ +00008320: 5f74 7970 6528 6374 782c 2046 4b4f 5f41  _type(ctx, FKO_A
│ │ │ │ │ +00008330: 4343 4553 535f 4d53 4729 3b0a 0a20 2d2d  CCESS_MSG);.. --
│ │ │ │ │ +00008340: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f
│ │ │ │ │ +00008350: 6b6f 5f73 6574 5f73 7061 5f6d 6573 7361  ko_set_spa_messa
│ │ │ │ │ +00008360: 6765 2028 666b 6f5f 6374 785f 7420 4354  ge (fko_ctx_t CT
│ │ │ │ │ +00008370: 582c 2063 6f6e 7374 2063 6861 720a 2020  X, const char.  
│ │ │ │ │ +00008380: 2020 2020 2020 2020 2a4d 5347 5f53 5452          *MSG_STR
│ │ │ │ │ +00008390: 494e 4729 3b0a 2020 2020 2053 6574 2074  ING);.     Set t
│ │ │ │ │ +000083a0: 6865 2053 5041 206d 6573 7361 6765 2073  he SPA message s
│ │ │ │ │ +000083b0: 7472 696e 6720 746f 2074 6865 2067 6976  tring to the giv
│ │ │ │ │ +000083c0: 656e 2076 616c 7565 2e20 2049 6620 7468  en value.  If th
│ │ │ │ │ +000083d0: 6973 2073 7472 696e 6720 646f 6573 0a20  is string does. 
│ │ │ │ │ +000083e0: 2020 2020 6e6f 7420 636f 6e66 6f72 6d20      not conform 
│ │ │ │ │ +000083f0: 746f 2074 6865 2072 6571 7569 7265 6420  to the required 
│ │ │ │ │ +00008400: 2773 7061 5f6e 6174 5f61 6363 6573 7327  'spa_nat_access'
│ │ │ │ │ +00008410: 2066 6f72 6d61 742c 2074 6865 2066 756e   format, the fun
│ │ │ │ │ +00008420: 6374 696f 6e0a 2020 2020 2077 696c 6c20  ction.     will 
│ │ │ │ │ +00008430: 7265 7475 726e 2027 464b 4f5f 4552 524f  return 'FKO_ERRO
│ │ │ │ │ +00008440: 525f 494e 5641 4c49 445f 4441 5441 272e  R_INVALID_DATA'.
│ │ │ │ │ +00008450: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ │ +00008460: 696e 7420 666b 6f5f 7365 745f 7370 615f  int fko_set_spa_
│ │ │ │ │ +00008470: 6e61 745f 6163 6365 7373 2028 666b 6f5f  nat_access (fko_
│ │ │ │ │ +00008480: 6374 785f 7420 4354 582c 2063 6f6e 7374  ctx_t CTX, const
│ │ │ │ │ +00008490: 2063 6861 720a 2020 2020 2020 2020 2020   char.          
│ │ │ │ │ +000084a0: 2a4e 4154 5f41 4343 4553 5329 3b0a 2020  *NAT_ACCESS);.  
│ │ │ │ │ +000084b0: 2020 2053 6574 2074 6865 206f 7074 696f     Set the optio
│ │ │ │ │ +000084c0: 6e61 6c20 5350 4120 6e61 7420 6163 6365  nal SPA nat acce
│ │ │ │ │ +000084d0: 7373 2073 7472 696e 6720 746f 2074 6865  ss string to the
│ │ │ │ │ +000084e0: 2067 6976 656e 2076 616c 7565 2e20 2049   given value.  I
│ │ │ │ │ +000084f0: 6620 7468 6973 0a20 2020 2020 7374 7269  f this.     stri
│ │ │ │ │ +00008500: 6e67 2064 6f65 7320 6e6f 7420 636f 6e66  ng does not conf
│ │ │ │ │ +00008510: 6f72 6d20 746f 2074 6865 2072 6571 7569  orm to the requi
│ │ │ │ │ +00008520: 7265 6420 2773 7061 5f6e 6174 5f61 6363  red 'spa_nat_acc
│ │ │ │ │ +00008530: 6573 7327 2066 6f72 6d61 742c 0a20 2020  ess' format,.   
│ │ │ │ │ +00008540: 2020 7468 6520 6675 6e63 7469 6f6e 2077    the function w
│ │ │ │ │ +00008550: 696c 6c20 7265 7475 726e 2027 464b 4f5f  ill return 'FKO_
│ │ │ │ │ +00008560: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ +00008570: 5441 272e 0a0a 202d 2d20 4675 6e63 7469  TA'... -- Functi
│ │ │ │ │ +00008580: 6f6e 3a20 696e 7420 666b 6f5f 7365 745f  on: int fko_set_
│ │ │ │ │ +00008590: 7370 615f 7365 7276 6572 5f61 7574 6820  spa_server_auth 
│ │ │ │ │ +000085a0: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, 
│ │ │ │ │ +000085b0: 636f 6e73 7420 6368 6172 0a20 2020 2020  const char.     
│ │ │ │ │ +000085c0: 2020 2020 202a 5345 5256 4552 5f41 5554       *SERVER_AUT
│ │ │ │ │ +000085d0: 4829 3b0a 2020 2020 2053 6574 2074 6865  H);.     Set the
│ │ │ │ │ +000085e0: 206f 7074 696f 6e61 6c20 2876 6572 7920   optional (very 
│ │ │ │ │ +000085f0: 7365 6c64 6f6d 2075 7365 6429 2053 5041  seldom used) SPA
│ │ │ │ │ +00008600: 2073 6572 7665 7220 6175 7468 2066 6561   server auth fea
│ │ │ │ │ +00008610: 7475 7265 2074 6f20 7468 650a 2020 2020  ture to the.    
│ │ │ │ │ +00008620: 2067 6976 656e 2076 616c 7565 2e20 2054   given value.  T
│ │ │ │ │ +00008630: 6869 7320 7061 7261 6d65 7465 7220 6d61  his parameter ma
│ │ │ │ │ +00008640: 7920 6265 636f 6d65 2064 6570 7265 6361  y become depreca
│ │ │ │ │ +00008650: 7465 642e 0a0a 202d 2d20 4675 6e63 7469  ted... -- Functi
│ │ │ │ │ +00008660: 6f6e 3a20 696e 7420 666b 6f5f 7365 745f  on: int fko_set_
│ │ │ │ │ +00008670: 7370 615f 636c 6965 6e74 5f74 696d 656f  spa_client_timeo
│ │ │ │ │ +00008680: 7574 2028 666b 6f5f 6374 785f 7420 4354  ut (fko_ctx_t CT
│ │ │ │ │ +00008690: 582c 2069 6e74 0a20 2020 2020 2020 2020  X, int.         
│ │ │ │ │ +000086a0: 2054 494d 454f 5554 293b 0a20 2020 2020   TIMEOUT);.     
│ │ │ │ │ +000086b0: 5365 7473 2074 6865 2053 5041 2063 6c69  Sets the SPA cli
│ │ │ │ │ +000086c0: 656e 7420 7469 6d65 6f75 7420 7661 6c75  ent timeout valu
│ │ │ │ │ +000086d0: 652e 2020 4966 2074 6865 2074 696d 656f  e.  If the timeo
│ │ │ │ │ +000086e0: 7574 2069 7320 7365 7420 746f 2061 0a20  ut is set to a. 
│ │ │ │ │ +000086f0: 2020 2020 7661 6c75 6520 6772 6561 7465      value greate
│ │ │ │ │ +00008700: 7220 7468 616e 2030 2c20 6974 2069 7320  r than 0, it is 
│ │ │ │ │ +00008710: 6173 7375 6d65 6420 7468 6520 2773 7061  assumed the 'spa
│ │ │ │ │ +00008720: 5f6d 6573 7361 6765 5f74 7970 6527 2073  _message_type' s
│ │ │ │ │ +00008730: 6574 7469 6e67 0a20 2020 2020 7368 6f75  etting.     shou
│ │ │ │ │ +00008740: 6c64 2062 6520 6f6e 6520 6f66 2074 6865  ld be one of the
│ │ │ │ │ +00008750: 2022 5449 4d45 4f55 5422 2076 6172 6961   "TIMEOUT" varia
│ │ │ │ │ +00008760: 6e74 732e 2020 5468 6973 2066 756e 6374  nts.  This funct
│ │ │ │ │ +00008770: 696f 6e20 7769 6c6c 2063 6861 6e67 650a  ion will change.
│ │ │ │ │ +00008780: 2020 2020 2074 6865 2027 6d65 7373 6167       the 'messag
│ │ │ │ │ +00008790: 655f 7479 7065 2720 746f 2074 6865 2061  e_type' to the a
│ │ │ │ │ +000087a0: 7070 726f 7072 6961 7465 2073 6574 7469  ppropriate setti
│ │ │ │ │ +000087b0: 6e67 2069 6620 6e65 6365 7373 6172 792e  ng if necessary.
│ │ │ │ │ +000087c0: 0a20 2020 2020 486f 7765 7665 722c 2069  .     However, i
│ │ │ │ │ +000087d0: 7420 6973 2072 6563 6f6d 6d65 6e64 6564  t is recommended
│ │ │ │ │ +000087e0: 2079 6f75 2073 6574 2074 6865 2063 6f72   you set the cor
│ │ │ │ │ +000087f0: 7265 6374 2027 6d65 7373 6167 655f 7479  rect 'message_ty
│ │ │ │ │ +00008800: 7065 2720 6168 6561 640a 2020 2020 206f  pe' ahead.     o
│ │ │ │ │ +00008810: 6620 7469 6d65 2e0a 0a20 2d2d 2046 756e  f time... -- Fun
│ │ │ │ │ +00008820: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f73  ction: int fko_s
│ │ │ │ │ +00008830: 6574 5f73 7061 5f64 6967 6573 7420 2866  et_spa_digest (f
│ │ │ │ │ +00008840: 6b6f 5f63 7478 5f74 2043 5458 293b 0a20  ko_ctx_t CTX);. 
│ │ │ │ │ +00008850: 2020 2020 496e 6974 6961 7465 7320 6120      Initiates a 
│ │ │ │ │ +00008860: 6361 6c63 756c 6174 696f 6e20 286f 7220  calculation (or 
│ │ │ │ │ +00008870: 7265 6361 6c63 756c 6174 696f 6e29 206f  recalculation) o
│ │ │ │ │ +00008880: 6620 7468 6520 6d65 7373 6167 6520 6469  f the message di
│ │ │ │ │ +00008890: 6765 7374 0a20 2020 2020 6861 7368 2066  gest.     hash f
│ │ │ │ │ +000088a0: 6f72 2074 6865 2063 7572 7265 6e74 2053  or the current S
│ │ │ │ │ +000088b0: 5041 2064 6174 612e 2020 4966 2074 6865  PA data.  If the
│ │ │ │ │ +000088c0: 2072 6571 7569 7265 6420 6461 7461 2066   required data f
│ │ │ │ │ +000088d0: 6965 6c64 7320 6172 6520 6e6f 740a 2020  ields are not.  
│ │ │ │ │ +000088e0: 2020 2073 6574 2074 6869 7320 6675 6e63     set this func
│ │ │ │ │ +000088f0: 7469 6f6e 2077 696c 6c20 7265 7475 726e  tion will return
│ │ │ │ │ +00008900: 2027 464b 4f5f 4552 524f 525f 4d49 5353   'FKO_ERROR_MISS
│ │ │ │ │ +00008910: 494e 475f 454e 434f 4445 445f 4441 5441  ING_ENCODED_DATA
│ │ │ │ │ +00008920: 272e 0a20 2020 2020 2a4e 6f74 652a 3a20  '..     *Note*: 
│ │ │ │ │ +00008930: 4974 2073 686f 756c 6420 6e6f 7420 6265  It should not be
│ │ │ │ │ +00008940: 206e 6563 6573 7361 7279 2074 6f20 6361   necessary to ca
│ │ │ │ │ +00008950: 6c6c 2074 6869 7320 6675 6e63 7469 6f6e  ll this function
│ │ │ │ │ +00008960: 2064 6972 6563 746c 790a 2020 2020 2061   directly.     a
│ │ │ │ │ +00008970: 7320 6974 2077 696c 6c20 6265 2063 616c  s it will be cal
│ │ │ │ │ +00008980: 6c65 6420 6175 746f 6d61 7469 6361 6c6c  led automaticall
│ │ │ │ │ +00008990: 7920 6279 206f 7468 6572 2066 756e 6374  y by other funct
│ │ │ │ │ +000089a0: 696f 6e73 2064 7572 696e 6720 6e6f 726d  ions during norm
│ │ │ │ │ +000089b0: 616c 0a20 2020 2020 7072 6f63 6573 7369  al.     processi
│ │ │ │ │ +000089c0: 6e67 2028 6d6f 7374 206e 6f74 6162 6c79  ng (most notably
│ │ │ │ │ +000089d0: 2027 666b 6f5f 7370 615f 6461 7461 5f66   'fko_spa_data_f
│ │ │ │ │ +000089e0: 696e 616c 2729 2e0a 0a20 2d2d 2046 756e  inal')... -- Fun
│ │ │ │ │ +000089f0: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f73  ction: int fko_s
│ │ │ │ │ +00008a00: 6574 5f73 7061 5f68 6d61 6320 2866 6b6f  et_spa_hmac (fko
│ │ │ │ │ +00008a10: 5f63 7478 5f74 2043 5458 2c20 636f 6e73  _ctx_t CTX, cons
│ │ │ │ │ +00008a20: 7420 6368 6172 202a 484d 4143 5f4b 4559  t char *HMAC_KEY
│ │ │ │ │ +00008a30: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ │ +00008a40: 7420 696e 7420 484d 4143 5f4b 4559 5f4c  t int HMAC_KEY_L
│ │ │ │ │ +00008a50: 454e 293b 0a20 2020 2020 496e 6974 6961  EN);.     Initia
│ │ │ │ │ +00008a60: 7465 7320 6120 6361 6c63 756c 6174 696f  tes a calculatio
│ │ │ │ │ +00008a70: 6e20 286f 7220 7265 6361 6c63 756c 6174  n (or recalculat
│ │ │ │ │ +00008a80: 696f 6e29 206f 6620 7468 6520 6d65 7373  ion) of the mess
│ │ │ │ │ +00008a90: 6167 6520 484d 4143 2066 6f72 0a20 2020  age HMAC for.   
│ │ │ │ │ +00008aa0: 2020 7468 6520 6375 7272 656e 7420 5350    the current SP
│ │ │ │ │ +00008ab0: 4120 6461 7461 2e20 202a 4e6f 7465 2a3a  A data.  *Note*:
│ │ │ │ │ +00008ac0: 2049 7420 7368 6f75 6c64 206e 6f74 2062   It should not b
│ │ │ │ │ +00008ad0: 6520 6e65 6365 7373 6172 7920 746f 2063  e necessary to c
│ │ │ │ │ +00008ae0: 616c 6c0a 2020 2020 2074 6869 7320 6675  all.     this fu
│ │ │ │ │ +00008af0: 6e63 7469 6f6e 2064 6972 6563 746c 7920  nction directly 
│ │ │ │ │ +00008b00: 6173 2069 7420 7769 6c6c 2062 6520 6361  as it will be ca
│ │ │ │ │ +00008b10: 6c6c 6564 2061 7574 6f6d 6174 6963 616c  lled automatical
│ │ │ │ │ +00008b20: 6c79 2062 7920 6f74 6865 720a 2020 2020  ly by other.    
│ │ │ │ │ +00008b30: 2066 756e 6374 696f 6e73 2064 7572 696e   functions durin
│ │ │ │ │ +00008b40: 6720 6e6f 726d 616c 2070 726f 6365 7373  g normal process
│ │ │ │ │ +00008b50: 696e 6720 286d 6f73 7420 6e6f 7461 626c  ing (most notabl
│ │ │ │ │ +00008b60: 790a 2020 2020 2027 666b 6f5f 7370 615f  y.     'fko_spa_
│ │ │ │ │ +00008b70: 6461 7461 5f66 696e 616c 2729 2e0a 0a20  data_final')... 
│ │ │ │ │ +00008b80: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ │ +00008b90: 2066 6b6f 5f73 6574 5f73 7061 5f64 6174   fko_set_spa_dat
│ │ │ │ │ +00008ba0: 6120 2866 6b6f 5f63 7478 5f74 2043 5458  a (fko_ctx_t CTX
│ │ │ │ │ +00008bb0: 2c20 6368 6172 202a 454e 435f 4441 5441  , char *ENC_DATA
│ │ │ │ │ +00008bc0: 293b 0a20 2020 2020 5468 6973 2066 756e  );.     This fun
│ │ │ │ │ +00008bd0: 6374 696f 6e20 6973 2075 7365 6420 746f  ction is used to
│ │ │ │ │ +00008be0: 2070 6c61 6365 2065 6e63 7279 7074 6564   place encrypted
│ │ │ │ │ +00008bf0: 2053 5041 2064 6174 6120 696e 746f 2061   SPA data into a
│ │ │ │ │ +00008c00: 206e 6577 6c79 0a20 2020 2020 6372 6561   newly.     crea
│ │ │ │ │ +00008c10: 7465 6420 656d 7074 7920 636f 6e74 6578  ted empty contex
│ │ │ │ │ +00008c20: 7420 2869 2e65 2e20 2077 6974 6820 2766  t (i.e.  with 'f
│ │ │ │ │ +00008c30: 6b6f 5f6e 6577 2729 2e20 2049 6e20 6d6f  ko_new').  In mo
│ │ │ │ │ +00008c40: 7374 2063 6173 6573 2c20 796f 750a 2020  st cases, you.  
│ │ │ │ │ +00008c50: 2020 2077 6f75 6c64 2075 7365 2027 666b     would use 'fk
│ │ │ │ │ +00008c60: 6f5f 6e65 775f 7769 7468 5f64 6174 6127  o_new_with_data'
│ │ │ │ │ +00008c70: 2073 6f20 796f 7520 776f 756c 646e 2774   so you wouldn't
│ │ │ │ │ +00008c80: 2068 6176 6520 746f 2074 616b 6520 7468   have to take th
│ │ │ │ │ +00008c90: 650a 2020 2020 2065 7874 7261 2073 7465  e.     extra ste
│ │ │ │ │ +00008ca0: 7020 746f 2075 7365 2074 6869 7320 6675  p to use this fu
│ │ │ │ │ +00008cb0: 6e63 7469 6f6e 2e20 2048 6f77 6576 6572  nction.  However
│ │ │ │ │ +00008cc0: 2c20 736f 6d65 206d 6179 2066 696e 6420  , some may find 
│ │ │ │ │ +00008cd0: 6120 7265 6173 6f6e 0a20 2020 2020 746f  a reason.     to
│ │ │ │ │ +00008ce0: 2064 6f20 6974 2069 6e20 7468 6973 2077   do it in this w
│ │ │ │ │ +00008cf0: 6179 2e0a 0a5f 4750 472d 7370 6563 6966  ay..._GPG-specif
│ │ │ │ │ +00008d00: 6963 2066 756e 6374 696f 6e73 3a5f 0a0a  ic functions:_..
│ │ │ │ │ +00008d10: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ │ +00008d20: 7420 666b 6f5f 7365 745f 6770 675f 7265  t fko_set_gpg_re
│ │ │ │ │ +00008d30: 6369 7069 656e 7420 2866 6b6f 5f63 7478  cipient (fko_ctx
│ │ │ │ │ +00008d40: 5f74 2043 5458 2c20 636f 6e73 7420 6368  _t CTX, const ch
│ │ │ │ │ +00008d50: 6172 0a20 2020 2020 2020 2020 2052 4543  ar.          REC
│ │ │ │ │ +00008d60: 4950 4945 4e54 293b 0a20 2020 2020 5365  IPIENT);.     Se
│ │ │ │ │ +00008d70: 7473 2074 6865 2047 5047 206b 6579 2066  ts the GPG key f
│ │ │ │ │ +00008d80: 6f72 2074 6865 2072 6563 6970 6965 6e74  or the recipient
│ │ │ │ │ +00008d90: 2e20 2054 6869 7320 776f 756c 6420 6265  .  This would be
│ │ │ │ │ +00008da0: 2074 6865 2072 6563 6970 6965 6e74 2773   the recipient's
│ │ │ │ │ +00008db0: 0a20 2020 2020 7075 626c 6963 206b 6579  .     public key
│ │ │ │ │ +00008dc0: 2075 7365 6420 746f 2065 6e63 7972 7074   used to encyrpt
│ │ │ │ │ +00008dd0: 2074 6865 2053 5041 2064 6174 612e 2020   the SPA data.  
│ │ │ │ │ +00008de0: 596f 7520 6361 6e20 7573 6520 7468 6520  You can use the 
│ │ │ │ │ +00008df0: 7573 6572 206e 616d 650a 2020 2020 2028  user name.     (
│ │ │ │ │ +00008e00: 2272 6563 6970 4074 6865 2e64 6573 742e  "recip@the.dest.
│ │ │ │ │ +00008e10: 636f 6d22 2920 6f72 2074 6865 206b 6579  com") or the key
│ │ │ │ │ +00008e20: 2049 4420 2822 3545 5858 5858 4343 2229   ID ("5EXXXXCC")
│ │ │ │ │ +00008e30: 2e20 4174 2070 7265 7365 6e74 2c0a 2020  . At present,.  
│ │ │ │ │ +00008e40: 2020 206d 756c 7469 706c 6520 7265 6369     multiple reci
│ │ │ │ │ +00008e50: 7069 656e 7473 2061 7265 206e 6f74 2073  pients are not s
│ │ │ │ │ +00008e60: 7570 706f 7274 6564 2e0a 0a20 2d2d 2046  upported... -- F
│ │ │ │ │ +00008e70: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko
│ │ │ │ │ +00008e80: 5f73 6574 5f67 7067 5f73 6967 6e65 7220  _set_gpg_signer 
│ │ │ │ │ +00008e90: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, 
│ │ │ │ │ +00008ea0: 636f 6e73 7420 6368 6172 2053 4947 4e45  const char SIGNE
│ │ │ │ │ +00008eb0: 5229 3b0a 2020 2020 2053 6574 7320 7468  R);.     Sets th
│ │ │ │ │ +00008ec0: 6520 4750 4720 6b65 7920 666f 7220 7369  e GPG key for si
│ │ │ │ │ +00008ed0: 676e 696e 6720 7468 6520 6461 7461 2e20  gning the data. 
│ │ │ │ │ +00008ee0: 2054 6869 7320 776f 756c 6420 6265 2074   This would be t
│ │ │ │ │ +00008ef0: 6865 2073 656e 6465 7227 730a 2020 2020  he sender's.    
│ │ │ │ │ +00008f00: 206b 6579 2075 7365 6420 746f 2073 6967   key used to sig
│ │ │ │ │ +00008f10: 6e20 7468 6520 5350 4120 6461 7461 2e20  n the SPA data. 
│ │ │ │ │ +00008f20: 2059 6f75 2063 616e 2075 7365 2074 6865   You can use the
│ │ │ │ │ +00008f30: 2075 7365 7220 6e61 6d65 206f 7220 6b65   user name or ke
│ │ │ │ │ +00008f40: 790a 2020 2020 2049 442e 0a0a 202d 2d20  y.     ID... -- 
│ │ │ │ │ +00008f50: 4675 6e63 7469 6f6e 3a20 696e 7420 666b  Function: int fk
│ │ │ │ │ +00008f60: 6f5f 7365 745f 6770 675f 686f 6d65 5f64  o_set_gpg_home_d
│ │ │ │ │ +00008f70: 6972 2028 666b 6f5f 6374 785f 7420 4354  ir (fko_ctx_t CT
│ │ │ │ │ +00008f80: 582c 2063 6f6e 7374 2063 6861 720a 2020  X, const char.  
│ │ │ │ │ +00008f90: 2020 2020 2020 2020 484f 4d45 5f44 4952          HOME_DIR
│ │ │ │ │ +00008fa0: 293b 0a20 2020 2020 5365 7473 2074 6865  );.     Sets the
│ │ │ │ │ +00008fb0: 2047 5047 2068 6f6d 6520 6469 7265 6374   GPG home direct
│ │ │ │ │ +00008fc0: 6f72 7920 666f 7220 7468 6520 6375 7272  ory for the curr
│ │ │ │ │ +00008fd0: 656e 7420 6770 676d 6520 636f 6e74 6578  ent gpgme contex
│ │ │ │ │ +00008fe0: 742e 2020 5468 6973 0a20 2020 2020 616c  t.  This.     al
│ │ │ │ │ +00008ff0: 6c6f 7773 2066 6f72 2075 7369 6e67 2061  lows for using a
│ │ │ │ │ +00009000: 6c74 6572 6e61 7465 206b 6579 7269 6e67  lternate keyring
│ │ │ │ │ +00009010: 732c 2067 7067 2063 6f6e 6669 6775 7261  s, gpg configura
│ │ │ │ │ +00009020: 7469 6f6e 732c 2065 7463 2e0a 0a20 2d2d  tions, etc... --
│ │ │ │ │ +00009030: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f
│ │ │ │ │ +00009040: 6b6f 5f73 6574 5f67 7067 5f73 6967 6e61  ko_set_gpg_signa
│ │ │ │ │ +00009050: 7475 7265 5f76 6572 6966 7920 2866 6b6f  ture_verify (fko
│ │ │ │ │ +00009060: 5f63 7478 5f74 2043 5458 2c20 756e 7369  _ctx_t CTX, unsi
│ │ │ │ │ +00009070: 676e 6564 0a20 2020 2020 2020 2020 2063  gned.          c
│ │ │ │ │ +00009080: 6861 7220 5645 5249 4659 293b 0a20 2020  har VERIFY);.   
│ │ │ │ │ +00009090: 2020 5365 7473 2074 6865 2076 6572 6966    Sets the verif
│ │ │ │ │ +000090a0: 7920 4750 4720 7369 676e 6174 7572 6520  y GPG signature 
│ │ │ │ │ +000090b0: 666c 6167 2e20 2057 6865 6e20 7365 7420  flag.  When set 
│ │ │ │ │ +000090c0: 746f 2061 2074 7275 6520 7661 6c75 652c  to a true value,
│ │ │ │ │ +000090d0: 2074 6865 0a20 2020 2020 4750 4720 7369   the.     GPG si
│ │ │ │ │ +000090e0: 676e 6174 7572 6520 6973 2065 7874 7261  gnature is extra
│ │ │ │ │ +000090f0: 6374 6564 2061 6e64 2063 6865 636b 6564  cted and checked
│ │ │ │ │ +00009100: 2066 6f72 2076 616c 6964 6974 7920 6475   for validity du
│ │ │ │ │ +00009110: 7269 6e67 2074 6865 0a20 2020 2020 6465  ring the.     de
│ │ │ │ │ +00009120: 6372 7970 7469 6f6e 2f64 6563 6f64 696e  cryption/decodin
│ │ │ │ │ +00009130: 6720 7068 6173 652e 2020 5768 656e 2073  g phase.  When s
│ │ │ │ │ +00009140: 6574 2074 6f20 6661 6c73 652c 206e 6f20  et to false, no 
│ │ │ │ │ +00009150: 6174 7465 6d70 7420 6973 206d 6164 650a  attempt is made.
│ │ │ │ │ +00009160: 2020 2020 2074 6f20 6163 6365 7373 206f       to access o
│ │ │ │ │ +00009170: 7220 6368 6563 6b20 7468 6520 7369 676e  r check the sign
│ │ │ │ │ +00009180: 6174 7572 652e 2020 5468 6973 2066 6c61  ature.  This fla
│ │ │ │ │ +00009190: 6720 6973 2073 6574 2074 6f20 7472 7565  g is set to true
│ │ │ │ │ +000091a0: 2062 790a 2020 2020 2064 6566 6175 6c74   by.     default
│ │ │ │ │ +000091b0: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:
│ │ │ │ │ +000091c0: 2069 6e74 2066 6b6f 5f73 6574 5f67 7067   int fko_set_gpg
│ │ │ │ │ +000091d0: 5f69 676e 6f72 655f 7665 7269 6679 5f65  _ignore_verify_e
│ │ │ │ │ +000091e0: 7272 6f72 2028 666b 6f5f 6374 785f 7420  rror (fko_ctx_t 
│ │ │ │ │ +000091f0: 4354 582c 0a20 2020 2020 2020 2020 2075  CTX,.          u
│ │ │ │ │ +00009200: 6e73 6967 6e65 6420 6368 6172 2049 474e  nsigned char IGN
│ │ │ │ │ +00009210: 4f52 4529 3b0a 2020 2020 2053 6574 7320  ORE);.     Sets 
│ │ │ │ │ +00009220: 7468 6520 6967 6e6f 7265 2073 6967 6e61  the ignore signa
│ │ │ │ │ +00009230: 7475 7265 2076 6572 6966 7920 6572 726f  ture verify erro
│ │ │ │ │ +00009240: 7220 666c 6167 2e20 2057 6865 6e20 7365  r flag.  When se
│ │ │ │ │ +00009250: 7420 746f 2061 2074 7275 650a 2020 2020  t to a true.    
│ │ │ │ │ +00009260: 2076 616c 7565 2e20 2041 6e79 2073 6967   value.  Any sig
│ │ │ │ │ +00009270: 6e61 7475 7265 2076 6572 6966 6963 6174  nature verificat
│ │ │ │ │ +00009280: 696f 6e20 6572 726f 7273 2061 7265 2069  ion errors are i
│ │ │ │ │ +00009290: 676e 6f72 6564 2028 6275 7420 7374 696c  gnored (but stil
│ │ │ │ │ +000092a0: 6c0a 2020 2020 2063 6170 7475 7265 6429  l.     captured)
│ │ │ │ │ +000092b0: 2061 6e64 2074 6865 2064 6563 6f64 696e   and the decodin
│ │ │ │ │ +000092c0: 6720 7072 6f63 6573 7320 7769 6c6c 2063  g process will c
│ │ │ │ │ +000092d0: 6f6e 7469 6e75 652e 2020 5468 6520 6465  ontinue.  The de
│ │ │ │ │ +000092e0: 6661 756c 740a 2020 2020 2076 616c 7565  fault.     value
│ │ │ │ │ +000092f0: 206f 6620 7468 6973 2066 6c61 6720 6973   of this flag is
│ │ │ │ │ +00009300: 2066 616c 7365 2e0a 0a20 2d2d 2046 756e   false... -- Fun
│ │ │ │ │ +00009310: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f73  ction: int fko_s
│ │ │ │ │ +00009320: 6574 5f67 7067 5f65 7865 2028 666b 6f5f  et_gpg_exe (fko_
│ │ │ │ │ +00009330: 6374 785f 7420 4354 582c 2063 6f6e 7374  ctx_t CTX, const
│ │ │ │ │ +00009340: 2063 6861 7220 4750 475f 4558 4529 3b0a   char GPG_EXE);.
│ │ │ │ │ +00009350: 2020 2020 2053 6574 7320 7468 6520 7061       Sets the pa
│ │ │ │ │ +00009360: 7468 2074 6f20 7468 6520 4750 4720 6578  th to the GPG ex
│ │ │ │ │ +00009370: 6563 7574 6162 6c65 2074 6861 7420 5f67  ecutable that _g
│ │ │ │ │ +00009380: 7067 6d65 5f20 7769 6c6c 2075 7365 2e20  pgme_ will use. 
│ │ │ │ │ +00009390: 2042 790a 2020 2020 2064 6566 6175 6c74   By.     default
│ │ │ │ │ +000093a0: 2c20 5f6c 6962 666b 6f5f 2066 6f72 6365  , _libfko_ force
│ │ │ │ │ +000093b0: 7320 5f67 7067 6d65 5f20 746f 2075 7365  s _gpgme_ to use
│ │ │ │ │ +000093c0: 2027 6770 6727 2069 6e20 6361 7365 205f   'gpg' in case _
│ │ │ │ │ +000093d0: 6770 676d 655f 2077 6173 0a20 2020 2020  gpgme_ was.     
│ │ │ │ │ +000093e0: 636f 6d70 696c 6564 2074 6f20 7573 6520  compiled to use 
│ │ │ │ │ +000093f0: 2767 7067 3227 2061 7320 6974 7320 6465  'gpg2' as its de
│ │ │ │ │ +00009400: 6661 756c 7420 656e 6769 6e65 2e20 2059  fault engine.  Y
│ │ │ │ │ +00009410: 6f75 2063 616e 2075 7365 2074 6869 730a  ou can use this.
│ │ │ │ │ +00009420: 2020 2020 2066 756e 6374 696f 6e20 746f       function to
│ │ │ │ │ +00009430: 206f 7665 7272 6964 6520 616e 6420 7365   override and se
│ │ │ │ │ +00009440: 7420 7768 6174 2047 5047 2065 7865 6375  t what GPG execu
│ │ │ │ │ +00009450: 7461 626c 6520 5f67 7067 6d65 5f20 7769  table _gpgme_ wi
│ │ │ │ │ +00009460: 6c6c 2075 7365 2e0a 0a2a 4e6f 7465 2a3a  ll use...*Note*:
│ │ │ │ │ +00009470: 204f 6e20 6120 6c69 6266 6b6f 2062 7569   On a libfko bui
│ │ │ │ │ +00009480: 6c64 2077 6974 686f 7574 2047 5047 2073  ld without GPG s
│ │ │ │ │ +00009490: 7570 706f 7274 2c20 7468 6520 4750 472d  upport, the GPG-
│ │ │ │ │ +000094a0: 7265 6c61 7465 6420 6675 6e63 7469 6f6e  related function
│ │ │ │ │ +000094b0: 730a 6162 6f76 6520 7769 6c6c 2073 696d  s.above will sim
│ │ │ │ │ +000094c0: 706c 7920 7265 7475 726e 2074 6865 2046  ply return the F
│ │ │ │ │ +000094d0: 4b4f 5f45 5252 4f52 5f55 4e53 5550 504f  KO_ERROR_UNSUPPO
│ │ │ │ │ +000094e0: 5254 4544 5f46 4541 5455 5245 2065 7272  RTED_FEATURE err
│ │ │ │ │ +000094f0: 6f72 2063 6f64 652e 0a0a 1f0a 4669 6c65  or code.....File
│ │ │ │ │ +00009500: 3a20 6c69 6266 6b6f 2e69 6e66 6f2c 2020  : libfko.info,  
│ │ │ │ │ +00009510: 4e6f 6465 3a20 5265 7472 6965 7669 6e67  Node: Retrieving
│ │ │ │ │ +00009520: 2053 5041 2044 6174 612c 2020 4e65 7874   SPA Data,  Next
│ │ │ │ │ +00009530: 3a20 5574 696c 6974 7920 4675 6e63 7469  : Utility Functi
│ │ │ │ │ +00009540: 6f6e 732c 2020 5072 6576 3a20 5365 7474  ons,  Prev: Sett
│ │ │ │ │ +00009550: 696e 6720 5350 4120 4461 7461 2c20 2055  ing SPA Data,  U
│ │ │ │ │ +00009560: 703a 2055 7369 6e67 206c 6962 666b 6f0a  p: Using libfko.
│ │ │ │ │ +00009570: 0a33 2e35 2052 6574 7269 6576 696e 6720  .3.5 Retrieving 
│ │ │ │ │ +00009580: 5350 4120 4461 7461 0a3d 3d3d 3d3d 3d3d  SPA Data.=======
│ │ │ │ │  00009590: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ │ -000095a0: 3d3d 0a0a 5468 6973 2073 6563 7469 6f6e  ==..This section
│ │ │ │ │ -000095b0: 2064 6573 6372 6962 6573 2074 6865 2066   describes the f
│ │ │ │ │ -000095c0: 756e 6374 696f 6e73 2075 7365 6420 666f  unctions used fo
│ │ │ │ │ -000095d0: 7220 7265 7472 6965 7669 6e67 2074 6865  r retrieving the
│ │ │ │ │ -000095e0: 2076 6172 696f 7573 2053 5041 0a64 6174   various SPA.dat
│ │ │ │ │ -000095f0: 6120 6669 656c 6473 2061 6e64 2070 6172  a fields and par
│ │ │ │ │ -00009600: 616d 6574 6572 7320 7365 7474 696e 6773  ameters settings
│ │ │ │ │ -00009610: 2e20 2054 6865 7920 616c 6c20 7265 7475  .  They all retu
│ │ │ │ │ -00009620: 726e 2061 6e20 464b 4f20 6572 726f 7220  rn an FKO error 
│ │ │ │ │ -00009630: 636f 6465 2e0a 5468 6520 7661 6c75 6520  code..The value 
│ │ │ │ │ -00009640: 6f66 2074 6865 2072 6573 7065 6374 6976  of the respectiv
│ │ │ │ │ -00009650: 6520 6669 656c 6420 6f72 2070 6172 6d65  e field or parme
│ │ │ │ │ -00009660: 7465 7220 7468 6174 2069 7320 6265 696e  ter that is bein
│ │ │ │ │ -00009670: 6720 7265 7472 6965 7665 640a 7769 6c6c  g retrieved.will
│ │ │ │ │ -00009680: 2070 6c61 6365 6420 696e 746f 2074 6865   placed into the
│ │ │ │ │ -00009690: 2076 6172 6961 626c 6573 2077 686f 7365   variables whose
│ │ │ │ │ -000096a0: 2061 6464 7265 7373 6573 2061 7265 2070   addresses are p
│ │ │ │ │ -000096b0: 6173 7365 6420 746f 2074 6865 0a66 756e  assed to the.fun
│ │ │ │ │ -000096c0: 6374 696f 6e2e 0a0a 202d 2d20 4675 6e63  ction... -- Func
│ │ │ │ │ -000096d0: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge
│ │ │ │ │ -000096e0: 745f 7370 615f 6461 7461 2028 666b 6f5f  t_spa_data (fko_
│ │ │ │ │ -000096f0: 6374 785f 7420 4354 582c 2063 6861 7220  ctx_t CTX, char 
│ │ │ │ │ -00009700: 2a2a 5350 415f 4441 5441 293b 0a20 2020  **SPA_DATA);.   
│ │ │ │ │ -00009710: 2020 4173 7369 676e 7320 7468 6520 706f    Assigns the po
│ │ │ │ │ -00009720: 696e 7465 7220 746f 2074 6865 2073 7472  inter to the str
│ │ │ │ │ -00009730: 696e 6720 686f 6c64 696e 6720 7468 6520  ing holding the 
│ │ │ │ │ -00009740: 6669 6e61 6c20 656e 6372 7970 7465 6420  final encrypted 
│ │ │ │ │ -00009750: 5350 410a 2020 2020 2064 6174 6120 746f  SPA.     data to
│ │ │ │ │ -00009760: 2074 6865 2061 6464 7265 7373 2053 5041   the address SPA
│ │ │ │ │ -00009770: 5f44 4154 4120 6973 2070 6f69 6e74 696e  _DATA is pointin
│ │ │ │ │ -00009780: 6720 746f 2e20 2054 6869 7320 6973 2074  g to.  This is t
│ │ │ │ │ -00009790: 6865 2064 6174 6120 7468 6174 0a20 2020  he data that.   
│ │ │ │ │ -000097a0: 2020 776f 756c 6420 6265 2070 6163 6b61    would be packa
│ │ │ │ │ -000097b0: 6765 6420 696e 746f 2061 2070 6163 6b65  ged into a packe
│ │ │ │ │ -000097c0: 7420 616e 6420 7365 6e74 2074 6f20 616e  t and sent to an
│ │ │ │ │ -000097d0: 2066 776b 6e6f 7020 7365 7276 6572 2e20   fwknop server. 
│ │ │ │ │ -000097e0: 2054 6865 0a20 2020 2020 7265 7475 726e   The.     return
│ │ │ │ │ -000097f0: 2076 616c 7565 2069 7320 616e 2046 4b4f   value is an FKO
│ │ │ │ │ -00009800: 2065 7272 6f72 2073 7461 7475 732e 0a0a   error status...
│ │ │ │ │ -00009810: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ │ -00009820: 7420 666b 6f5f 6765 745f 7261 6e64 5f76  t fko_get_rand_v
│ │ │ │ │ -00009830: 616c 7565 2028 666b 6f5f 6374 785f 7420  alue (fko_ctx_t 
│ │ │ │ │ -00009840: 4354 582c 2063 6861 7220 2a2a 5241 4e44  CTX, char **RAND
│ │ │ │ │ -00009850: 5f56 414c 293b 0a20 2020 2020 4173 7369  _VAL);.     Assi
│ │ │ │ │ -00009860: 676e 7320 7468 6520 706f 696e 7465 7220  gns the pointer 
│ │ │ │ │ -00009870: 746f 2074 6865 2073 7472 696e 6720 686f  to the string ho
│ │ │ │ │ -00009880: 6c64 696e 6720 7468 6520 7261 6e64 6f6d  lding the random
│ │ │ │ │ -00009890: 2031 362d 6368 6172 6163 7465 720a 2020   16-character.  
│ │ │ │ │ -000098a0: 2020 2064 6563 696d 616c 206e 756d 6265     decimal numbe
│ │ │ │ │ -000098b0: 7220 2827 7261 6e64 5f76 616c 2729 2061  r ('rand_val') a
│ │ │ │ │ -000098c0: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t
│ │ │ │ │ -000098d0: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte
│ │ │ │ │ -000098e0: 7874 2074 6f0a 2020 2020 2074 6865 2061  xt to.     the a
│ │ │ │ │ -000098f0: 6464 7265 7373 2052 414e 445f 5641 4c20  ddress RAND_VAL 
│ │ │ │ │ -00009900: 6973 2070 6f69 6e74 696e 6720 746f 2e20  is pointing to. 
│ │ │ │ │ -00009910: 2054 6865 2072 6574 7572 6e20 7661 6c75   The return valu
│ │ │ │ │ -00009920: 6520 6973 2061 6e20 464b 4f0a 2020 2020  e is an FKO.    
│ │ │ │ │ -00009930: 2065 7272 6f72 2073 7461 7475 732e 0a0a   error status...
│ │ │ │ │ -00009940: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ │ -00009950: 7420 666b 6f5f 6765 745f 7573 6572 6e61  t fko_get_userna
│ │ │ │ │ -00009960: 6d65 2028 666b 6f5f 6374 785f 7420 4354  me (fko_ctx_t CT
│ │ │ │ │ -00009970: 582c 2063 6861 7220 2a2a 5553 4552 4e41  X, char **USERNA
│ │ │ │ │ -00009980: 4d45 293b 0a20 2020 2020 4173 7369 676e  ME);.     Assign
│ │ │ │ │ -00009990: 7320 7468 6520 706f 696e 7465 7220 746f  s the pointer to
│ │ │ │ │ -000099a0: 2074 6865 2073 7472 696e 6720 686f 6c64   the string hold
│ │ │ │ │ -000099b0: 696e 6720 7468 6520 7573 6572 6e61 6d65  ing the username
│ │ │ │ │ -000099c0: 2061 7373 6f63 6961 7465 640a 2020 2020   associated.    
│ │ │ │ │ -000099d0: 2077 6974 6820 7468 6520 6375 7272 656e   with the curren
│ │ │ │ │ -000099e0: 7420 636f 6e74 6578 7420 746f 2074 6865  t context to the
│ │ │ │ │ -000099f0: 2061 6464 7265 7373 2052 414e 445f 5641   address RAND_VA
│ │ │ │ │ -00009a00: 4c20 6973 2070 6f69 6e74 696e 6720 746f  L is pointing to
│ │ │ │ │ -00009a10: 2e0a 2020 2020 2054 6865 2072 6574 7572  ..     The retur
│ │ │ │ │ -00009a20: 6e20 7661 6c75 6520 6973 2061 6e20 464b  n value is an FK
│ │ │ │ │ -00009a30: 4f20 6572 726f 7220 7374 6174 7573 2e0a  O error status..
│ │ │ │ │ -00009a40: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ │ -00009a50: 6e74 2066 6b6f 5f67 6574 5f74 696d 6573  nt fko_get_times
│ │ │ │ │ -00009a60: 7461 6d70 2028 666b 6f5f 6374 785f 7420  tamp (fko_ctx_t 
│ │ │ │ │ -00009a70: 4354 582c 2074 696d 655f 7420 2a54 494d  CTX, time_t *TIM
│ │ │ │ │ -00009a80: 4553 5441 4d50 293b 0a20 2020 2020 5365  ESTAMP);.     Se
│ │ │ │ │ -00009a90: 7473 2074 6865 2076 616c 7565 206f 6620  ts the value of 
│ │ │ │ │ -00009aa0: 7468 6520 5449 4d45 5354 414d 5020 7661  the TIMESTAMP va
│ │ │ │ │ -00009ab0: 7269 6162 6c65 2074 6f20 7468 6520 7469  riable to the ti
│ │ │ │ │ -00009ac0: 6d65 7374 616d 7020 7661 6c75 650a 2020  mestamp value.  
│ │ │ │ │ -00009ad0: 2020 2061 7373 6f63 6961 7465 6420 7769     associated wi
│ │ │ │ │ -00009ae0: 7468 2074 6865 2063 7572 7265 6e74 2063  th the current c
│ │ │ │ │ -00009af0: 6f6e 7465 7874 2e20 2054 6865 2072 6574  ontext.  The ret
│ │ │ │ │ -00009b00: 7572 6e20 7661 6c75 6520 6973 2061 6e20  urn value is an 
│ │ │ │ │ -00009b10: 464b 4f0a 2020 2020 2065 7272 6f72 2073  FKO.     error s
│ │ │ │ │ -00009b20: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func
│ │ │ │ │ -00009b30: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge
│ │ │ │ │ -00009b40: 745f 7370 615f 6d65 7373 6167 655f 7479  t_spa_message_ty
│ │ │ │ │ -00009b50: 7065 2028 666b 6f5f 6374 785f 7420 4354  pe (fko_ctx_t CT
│ │ │ │ │ -00009b60: 582c 2073 686f 7274 0a20 2020 2020 2020  X, short.       
│ │ │ │ │ -00009b70: 2020 202a 4d53 475f 5459 5045 293b 0a20     *MSG_TYPE);. 
│ │ │ │ │ -00009b80: 2020 2020 5365 7473 2074 6865 2076 616c      Sets the val
│ │ │ │ │ -00009b90: 7565 206f 6620 7468 6520 4d53 475f 5459  ue of the MSG_TY
│ │ │ │ │ -00009ba0: 5045 2076 6172 6961 626c 6520 746f 2074  PE variable to t
│ │ │ │ │ -00009bb0: 6865 2053 5041 206d 6573 7361 6765 2074  he SPA message t
│ │ │ │ │ -00009bc0: 7970 650a 2020 2020 2076 616c 7565 2061  ype.     value a
│ │ │ │ │ -00009bd0: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t
│ │ │ │ │ -00009be0: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte
│ │ │ │ │ -00009bf0: 7874 2e20 2054 6869 7320 7661 6c75 6520  xt.  This value 
│ │ │ │ │ -00009c00: 6361 6e20 6265 0a20 2020 2020 6368 6563  can be.     chec
│ │ │ │ │ -00009c10: 6b65 6420 6167 6169 6e73 7420 7468 6520  ked against the 
│ │ │ │ │ -00009c20: 6c69 7374 206f 6620 7661 6c69 6420 6d65  list of valid me
│ │ │ │ │ -00009c30: 7373 6167 655f 7479 7065 7320 6c69 7374  ssage_types list
│ │ │ │ │ -00009c40: 6564 2069 6e20 2a6e 6f74 6520 5350 410a  ed in *note SPA.
│ │ │ │ │ -00009c50: 2020 2020 204d 6573 7361 6765 733a 3a20       Messages:: 
│ │ │ │ │ -00009c60: 6f66 2074 6869 7320 6d61 6e75 616c 2e20  of this manual. 
│ │ │ │ │ -00009c70: 2046 6f72 2065 7861 6d70 6c65 3a0a 2020   For example:.  
│ │ │ │ │ -00009c80: 2020 2020 2020 2020 2020 2020 7368 6f72              shor
│ │ │ │ │ -00009c90: 7420 6d73 675f 7479 7065 3b0a 0a20 2020  t msg_type;..   
│ │ │ │ │ -00009ca0: 2020 2020 2020 2020 2020 2072 6320 3d20             rc = 
│ │ │ │ │ -00009cb0: 666b 6f5f 6765 745f 7370 615f 6d65 7373  fko_get_spa_mess
│ │ │ │ │ -00009cc0: 6167 655f 7479 7065 2863 7478 2c20 266d  age_type(ctx, &m
│ │ │ │ │ -00009cd0: 7367 5f74 7970 6529 3b0a 0a20 2020 2020  sg_type);..     
│ │ │ │ │ -00009ce0: 2020 2020 2020 2020 2073 7769 7463 6828           switch(
│ │ │ │ │ -00009cf0: 6d73 675f 7479 7065 290a 2020 2020 2020  msg_type).      
│ │ │ │ │ -00009d00: 2020 2020 2020 2020 7b0a 2020 2020 2020          {.      
│ │ │ │ │ -00009d10: 2020 2020 2020 2020 2020 2020 6361 7365              case
│ │ │ │ │ -00009d20: 2046 4b4f 5f41 4343 4553 535f 4d53 473a   FKO_ACCESS_MSG:
│ │ │ │ │ -00009d30: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ │ -00009d40: 2020 2020 2020 2070 726f 6365 7373 5f61         process_a
│ │ │ │ │ -00009d50: 6363 6573 735f 6d73 6728 2e2e 2e29 3b0a  ccess_msg(...);.
│ │ │ │ │ +000095a0: 0a0a 5468 6973 2073 6563 7469 6f6e 2064  ..This section d
│ │ │ │ │ +000095b0: 6573 6372 6962 6573 2074 6865 2066 756e  escribes the fun
│ │ │ │ │ +000095c0: 6374 696f 6e73 2075 7365 6420 666f 7220  ctions used for 
│ │ │ │ │ +000095d0: 7265 7472 6965 7669 6e67 2074 6865 2076  retrieving the v
│ │ │ │ │ +000095e0: 6172 696f 7573 2053 5041 0a64 6174 6120  arious SPA.data 
│ │ │ │ │ +000095f0: 6669 656c 6473 2061 6e64 2070 6172 616d  fields and param
│ │ │ │ │ +00009600: 6574 6572 7320 7365 7474 696e 6773 2e20  eters settings. 
│ │ │ │ │ +00009610: 2054 6865 7920 616c 6c20 7265 7475 726e   They all return
│ │ │ │ │ +00009620: 2061 6e20 464b 4f20 6572 726f 7220 636f   an FKO error co
│ │ │ │ │ +00009630: 6465 2e0a 5468 6520 7661 6c75 6520 6f66  de..The value of
│ │ │ │ │ +00009640: 2074 6865 2072 6573 7065 6374 6976 6520   the respective 
│ │ │ │ │ +00009650: 6669 656c 6420 6f72 2070 6172 6d65 7465  field or parmete
│ │ │ │ │ +00009660: 7220 7468 6174 2069 7320 6265 696e 6720  r that is being 
│ │ │ │ │ +00009670: 7265 7472 6965 7665 640a 7769 6c6c 2070  retrieved.will p
│ │ │ │ │ +00009680: 6c61 6365 6420 696e 746f 2074 6865 2076  laced into the v
│ │ │ │ │ +00009690: 6172 6961 626c 6573 2077 686f 7365 2061  ariables whose a
│ │ │ │ │ +000096a0: 6464 7265 7373 6573 2061 7265 2070 6173  ddresses are pas
│ │ │ │ │ +000096b0: 7365 6420 746f 2074 6865 0a66 756e 6374  sed to the.funct
│ │ │ │ │ +000096c0: 696f 6e2e 0a0a 202d 2d20 4675 6e63 7469  ion... -- Functi
│ │ │ │ │ +000096d0: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_
│ │ │ │ │ +000096e0: 7370 615f 6461 7461 2028 666b 6f5f 6374  spa_data (fko_ct
│ │ │ │ │ +000096f0: 785f 7420 4354 582c 2063 6861 7220 2a2a  x_t CTX, char **
│ │ │ │ │ +00009700: 5350 415f 4441 5441 293b 0a20 2020 2020  SPA_DATA);.     
│ │ │ │ │ +00009710: 4173 7369 676e 7320 7468 6520 706f 696e  Assigns the poin
│ │ │ │ │ +00009720: 7465 7220 746f 2074 6865 2073 7472 696e  ter to the strin
│ │ │ │ │ +00009730: 6720 686f 6c64 696e 6720 7468 6520 6669  g holding the fi
│ │ │ │ │ +00009740: 6e61 6c20 656e 6372 7970 7465 6420 5350  nal encrypted SP
│ │ │ │ │ +00009750: 410a 2020 2020 2064 6174 6120 746f 2074  A.     data to t
│ │ │ │ │ +00009760: 6865 2061 6464 7265 7373 2053 5041 5f44  he address SPA_D
│ │ │ │ │ +00009770: 4154 4120 6973 2070 6f69 6e74 696e 6720  ATA is pointing 
│ │ │ │ │ +00009780: 746f 2e20 2054 6869 7320 6973 2074 6865  to.  This is the
│ │ │ │ │ +00009790: 2064 6174 6120 7468 6174 0a20 2020 2020   data that.     
│ │ │ │ │ +000097a0: 776f 756c 6420 6265 2070 6163 6b61 6765  would be package
│ │ │ │ │ +000097b0: 6420 696e 746f 2061 2070 6163 6b65 7420  d into a packet 
│ │ │ │ │ +000097c0: 616e 6420 7365 6e74 2074 6f20 616e 2066  and sent to an f
│ │ │ │ │ +000097d0: 776b 6e6f 7020 7365 7276 6572 2e20 2054  wknop server.  T
│ │ │ │ │ +000097e0: 6865 0a20 2020 2020 7265 7475 726e 2076  he.     return v
│ │ │ │ │ +000097f0: 616c 7565 2069 7320 616e 2046 4b4f 2065  alue is an FKO e
│ │ │ │ │ +00009800: 7272 6f72 2073 7461 7475 732e 0a0a 202d  rror status... -
│ │ │ │ │ +00009810: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ │ +00009820: 666b 6f5f 6765 745f 7261 6e64 5f76 616c  fko_get_rand_val
│ │ │ │ │ +00009830: 7565 2028 666b 6f5f 6374 785f 7420 4354  ue (fko_ctx_t CT
│ │ │ │ │ +00009840: 582c 2063 6861 7220 2a2a 5241 4e44 5f56  X, char **RAND_V
│ │ │ │ │ +00009850: 414c 293b 0a20 2020 2020 4173 7369 676e  AL);.     Assign
│ │ │ │ │ +00009860: 7320 7468 6520 706f 696e 7465 7220 746f  s the pointer to
│ │ │ │ │ +00009870: 2074 6865 2073 7472 696e 6720 686f 6c64   the string hold
│ │ │ │ │ +00009880: 696e 6720 7468 6520 7261 6e64 6f6d 2031  ing the random 1
│ │ │ │ │ +00009890: 362d 6368 6172 6163 7465 720a 2020 2020  6-character.    
│ │ │ │ │ +000098a0: 2064 6563 696d 616c 206e 756d 6265 7220   decimal number 
│ │ │ │ │ +000098b0: 2827 7261 6e64 5f76 616c 2729 2061 7373  ('rand_val') ass
│ │ │ │ │ +000098c0: 6f63 6961 7465 6420 7769 7468 2074 6865  ociated with the
│ │ │ │ │ +000098d0: 2063 7572 7265 6e74 2063 6f6e 7465 7874   current context
│ │ │ │ │ +000098e0: 2074 6f0a 2020 2020 2074 6865 2061 6464   to.     the add
│ │ │ │ │ +000098f0: 7265 7373 2052 414e 445f 5641 4c20 6973  ress RAND_VAL is
│ │ │ │ │ +00009900: 2070 6f69 6e74 696e 6720 746f 2e20 2054   pointing to.  T
│ │ │ │ │ +00009910: 6865 2072 6574 7572 6e20 7661 6c75 6520  he return value 
│ │ │ │ │ +00009920: 6973 2061 6e20 464b 4f0a 2020 2020 2065  is an FKO.     e
│ │ │ │ │ +00009930: 7272 6f72 2073 7461 7475 732e 0a0a 202d  rror status... -
│ │ │ │ │ +00009940: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ │ +00009950: 666b 6f5f 6765 745f 7573 6572 6e61 6d65  fko_get_username
│ │ │ │ │ +00009960: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,
│ │ │ │ │ +00009970: 2063 6861 7220 2a2a 5553 4552 4e41 4d45   char **USERNAME
│ │ │ │ │ +00009980: 293b 0a20 2020 2020 4173 7369 676e 7320  );.     Assigns 
│ │ │ │ │ +00009990: 7468 6520 706f 696e 7465 7220 746f 2074  the pointer to t
│ │ │ │ │ +000099a0: 6865 2073 7472 696e 6720 686f 6c64 696e  he string holdin
│ │ │ │ │ +000099b0: 6720 7468 6520 7573 6572 6e61 6d65 2061  g the username a
│ │ │ │ │ +000099c0: 7373 6f63 6961 7465 640a 2020 2020 2077  ssociated.     w
│ │ │ │ │ +000099d0: 6974 6820 7468 6520 6375 7272 656e 7420  ith the current 
│ │ │ │ │ +000099e0: 636f 6e74 6578 7420 746f 2074 6865 2061  context to the a
│ │ │ │ │ +000099f0: 6464 7265 7373 2052 414e 445f 5641 4c20  ddress RAND_VAL 
│ │ │ │ │ +00009a00: 6973 2070 6f69 6e74 696e 6720 746f 2e0a  is pointing to..
│ │ │ │ │ +00009a10: 2020 2020 2054 6865 2072 6574 7572 6e20       The return 
│ │ │ │ │ +00009a20: 7661 6c75 6520 6973 2061 6e20 464b 4f20  value is an FKO 
│ │ │ │ │ +00009a30: 6572 726f 7220 7374 6174 7573 2e0a 0a20  error status... 
│ │ │ │ │ +00009a40: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ │ +00009a50: 2066 6b6f 5f67 6574 5f74 696d 6573 7461   fko_get_timesta
│ │ │ │ │ +00009a60: 6d70 2028 666b 6f5f 6374 785f 7420 4354  mp (fko_ctx_t CT
│ │ │ │ │ +00009a70: 582c 2074 696d 655f 7420 2a54 494d 4553  X, time_t *TIMES
│ │ │ │ │ +00009a80: 5441 4d50 293b 0a20 2020 2020 5365 7473  TAMP);.     Sets
│ │ │ │ │ +00009a90: 2074 6865 2076 616c 7565 206f 6620 7468   the value of th
│ │ │ │ │ +00009aa0: 6520 5449 4d45 5354 414d 5020 7661 7269  e TIMESTAMP vari
│ │ │ │ │ +00009ab0: 6162 6c65 2074 6f20 7468 6520 7469 6d65  able to the time
│ │ │ │ │ +00009ac0: 7374 616d 7020 7661 6c75 650a 2020 2020  stamp value.    
│ │ │ │ │ +00009ad0: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with
│ │ │ │ │ +00009ae0: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con
│ │ │ │ │ +00009af0: 7465 7874 2e20 2054 6865 2072 6574 7572  text.  The retur
│ │ │ │ │ +00009b00: 6e20 7661 6c75 6520 6973 2061 6e20 464b  n value is an FK
│ │ │ │ │ +00009b10: 4f0a 2020 2020 2065 7272 6f72 2073 7461  O.     error sta
│ │ │ │ │ +00009b20: 7475 732e 0a0a 202d 2d20 4675 6e63 7469  tus... -- Functi
│ │ │ │ │ +00009b30: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_
│ │ │ │ │ +00009b40: 7370 615f 6d65 7373 6167 655f 7479 7065  spa_message_type
│ │ │ │ │ +00009b50: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,
│ │ │ │ │ +00009b60: 2073 686f 7274 0a20 2020 2020 2020 2020   short.         
│ │ │ │ │ +00009b70: 202a 4d53 475f 5459 5045 293b 0a20 2020   *MSG_TYPE);.   
│ │ │ │ │ +00009b80: 2020 5365 7473 2074 6865 2076 616c 7565    Sets the value
│ │ │ │ │ +00009b90: 206f 6620 7468 6520 4d53 475f 5459 5045   of the MSG_TYPE
│ │ │ │ │ +00009ba0: 2076 6172 6961 626c 6520 746f 2074 6865   variable to the
│ │ │ │ │ +00009bb0: 2053 5041 206d 6573 7361 6765 2074 7970   SPA message typ
│ │ │ │ │ +00009bc0: 650a 2020 2020 2076 616c 7565 2061 7373  e.     value ass
│ │ │ │ │ +00009bd0: 6f63 6961 7465 6420 7769 7468 2074 6865  ociated with the
│ │ │ │ │ +00009be0: 2063 7572 7265 6e74 2063 6f6e 7465 7874   current context
│ │ │ │ │ +00009bf0: 2e20 2054 6869 7320 7661 6c75 6520 6361  .  This value ca
│ │ │ │ │ +00009c00: 6e20 6265 0a20 2020 2020 6368 6563 6b65  n be.     checke
│ │ │ │ │ +00009c10: 6420 6167 6169 6e73 7420 7468 6520 6c69  d against the li
│ │ │ │ │ +00009c20: 7374 206f 6620 7661 6c69 6420 6d65 7373  st of valid mess
│ │ │ │ │ +00009c30: 6167 655f 7479 7065 7320 6c69 7374 6564  age_types listed
│ │ │ │ │ +00009c40: 2069 6e20 2a6e 6f74 6520 5350 410a 2020   in *note SPA.  
│ │ │ │ │ +00009c50: 2020 204d 6573 7361 6765 733a 3a20 6f66     Messages:: of
│ │ │ │ │ +00009c60: 2074 6869 7320 6d61 6e75 616c 2e20 2046   this manual.  F
│ │ │ │ │ +00009c70: 6f72 2065 7861 6d70 6c65 3a0a 2020 2020  or example:.    
│ │ │ │ │ +00009c80: 2020 2020 2020 2020 2020 7368 6f72 7420            short 
│ │ │ │ │ +00009c90: 6d73 675f 7479 7065 3b0a 0a20 2020 2020  msg_type;..     
│ │ │ │ │ +00009ca0: 2020 2020 2020 2020 2072 6320 3d20 666b           rc = fk
│ │ │ │ │ +00009cb0: 6f5f 6765 745f 7370 615f 6d65 7373 6167  o_get_spa_messag
│ │ │ │ │ +00009cc0: 655f 7479 7065 2863 7478 2c20 266d 7367  e_type(ctx, &msg
│ │ │ │ │ +00009cd0: 5f74 7970 6529 3b0a 0a20 2020 2020 2020  _type);..       
│ │ │ │ │ +00009ce0: 2020 2020 2020 2073 7769 7463 6828 6d73         switch(ms
│ │ │ │ │ +00009cf0: 675f 7479 7065 290a 2020 2020 2020 2020  g_type).        
│ │ │ │ │ +00009d00: 2020 2020 2020 7b0a 2020 2020 2020 2020        {.        
│ │ │ │ │ +00009d10: 2020 2020 2020 2020 2020 6361 7365 2046            case F
│ │ │ │ │ +00009d20: 4b4f 5f41 4343 4553 535f 4d53 473a 0a20  KO_ACCESS_MSG:. 
│ │ │ │ │ +00009d30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ +00009d40: 2020 2020 2070 726f 6365 7373 5f61 6363       process_acc
│ │ │ │ │ +00009d50: 6573 735f 6d73 6728 2e2e 2e29 3b0a 2020  ess_msg(...);.  
│ │ │ │ │  00009d60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00009d70: 2020 2020 2020 6272 6561 6b3b 0a20 2020        break;.   
│ │ │ │ │ -00009d80: 2020 2020 2020 2020 2020 2020 2020 2063                 c
│ │ │ │ │ -00009d90: 6173 6520 464b 4f5f 4e41 545f 4143 4345  ase FKO_NAT_ACCE
│ │ │ │ │ -00009da0: 5353 5f4d 5347 3a0a 2020 2020 2020 2020  SS_MSG:.        
│ │ │ │ │ -00009db0: 2020 2020 2020 2020 2020 2020 2020 7072                pr
│ │ │ │ │ -00009dc0: 6f63 6573 735f 6e61 745f 6163 6365 7373  ocess_nat_access
│ │ │ │ │ -00009dd0: 5f6d 7367 282e 2e2e 293b 0a20 2020 2020  _msg(...);.     
│ │ │ │ │ -00009de0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00009df0: 2062 7265 616b 3b0a 2020 2020 2020 2020   break;.        
│ │ │ │ │ -00009e00: 2020 2020 2020 2f2a 2e2e 2e61 6e64 2073        /*...and s
│ │ │ │ │ -00009e10: 6f20 6f6e 2e2e 2e2a 2f0a 2020 2020 2020  o on...*/.      
│ │ │ │ │ -00009e20: 2020 2020 2020 2020 7d0a 2020 2020 2054          }.     T
│ │ │ │ │ -00009e30: 6865 2072 6574 7572 6e20 7661 6c75 6520  he return value 
│ │ │ │ │ -00009e40: 6973 2061 6e20 464b 4f20 6572 726f 7220  is an FKO error 
│ │ │ │ │ -00009e50: 7374 6174 7573 2e0a 0a20 2d2d 2046 756e  status... -- Fun
│ │ │ │ │ -00009e60: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f67  ction: int fko_g
│ │ │ │ │ -00009e70: 6574 5f73 7061 5f6d 6573 7361 6765 2028  et_spa_message (
│ │ │ │ │ -00009e80: 666b 6f5f 6374 785f 7420 4354 582c 2063  fko_ctx_t CTX, c
│ │ │ │ │ -00009e90: 6861 7220 2a2a 5350 415f 4d53 4729 3b0a  har **SPA_MSG);.
│ │ │ │ │ -00009ea0: 2020 2020 2041 7373 6967 6e73 2074 6865       Assigns the
│ │ │ │ │ -00009eb0: 2070 6f69 6e74 6572 2074 6f20 7468 6520   pointer to the 
│ │ │ │ │ -00009ec0: 7374 7269 6e67 2068 6f6c 6469 6e67 2074  string holding t
│ │ │ │ │ -00009ed0: 6865 2074 6865 2066 6b6f 2053 5041 2072  he the fko SPA r
│ │ │ │ │ -00009ee0: 6571 7565 7374 0a20 2020 2020 6d65 7373  equest.     mess
│ │ │ │ │ -00009ef0: 6167 6520 6173 736f 6369 6174 6564 2077  age associated w
│ │ │ │ │ -00009f00: 6974 6820 7468 6520 6375 7272 656e 7420  ith the current 
│ │ │ │ │ -00009f10: 636f 6e74 6578 7420 746f 2074 6865 2061  context to the a
│ │ │ │ │ -00009f20: 6464 7265 7373 2053 5041 5f4d 5347 0a20  ddress SPA_MSG. 
│ │ │ │ │ -00009f30: 2020 2020 6973 2070 6f69 6e74 696e 6720      is pointing 
│ │ │ │ │ -00009f40: 746f 2e20 2054 6865 2072 6574 7572 6e20  to.  The return 
│ │ │ │ │ -00009f50: 7661 6c75 6520 6973 2061 6e20 464b 4f20  value is an FKO 
│ │ │ │ │ -00009f60: 6572 726f 7220 7374 6174 7573 2e0a 0a20  error status... 
│ │ │ │ │ -00009f70: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ │ -00009f80: 2066 6b6f 5f67 6574 5f73 7061 5f6e 6174   fko_get_spa_nat
│ │ │ │ │ -00009f90: 5f61 6363 6573 7320 2866 6b6f 5f63 7478  _access (fko_ctx
│ │ │ │ │ -00009fa0: 5f74 2043 5458 2c20 6368 6172 0a20 2020  _t CTX, char.   
│ │ │ │ │ -00009fb0: 2020 2020 2020 202a 2a4e 4154 5f41 4343         **NAT_ACC
│ │ │ │ │ -00009fc0: 4553 5329 3b0a 2020 2020 2041 7373 6967  ESS);.     Assig
│ │ │ │ │ -00009fd0: 6e73 2074 6865 2070 6f69 6e74 6572 2074  ns the pointer t
│ │ │ │ │ -00009fe0: 6f20 7468 6520 7374 7269 6e67 2068 6f6c  o the string hol
│ │ │ │ │ -00009ff0: 6469 6e67 2074 6865 2074 6865 2066 6b6f  ding the the fko
│ │ │ │ │ -0000a000: 2053 5041 206e 6174 0a20 2020 2020 6163   SPA nat.     ac
│ │ │ │ │ -0000a010: 6365 7373 206d 6573 7361 6765 2061 7373  cess message ass
│ │ │ │ │ -0000a020: 6f63 6961 7465 6420 7769 7468 2074 6865  ociated with the
│ │ │ │ │ -0000a030: 2063 7572 7265 6e74 2063 6f6e 7465 7874   current context
│ │ │ │ │ -0000a040: 2074 6f20 7468 6520 6164 6472 6573 730a   to the address.
│ │ │ │ │ -0000a050: 2020 2020 204e 4154 5f41 4343 4553 5320       NAT_ACCESS 
│ │ │ │ │ -0000a060: 6973 2070 6f69 6e74 696e 6720 746f 2e20  is pointing to. 
│ │ │ │ │ -0000a070: 2054 6865 2072 6574 7572 6e20 7661 6c75   The return valu
│ │ │ │ │ -0000a080: 6520 6973 2061 6e20 464b 4f20 6572 726f  e is an FKO erro
│ │ │ │ │ -0000a090: 720a 2020 2020 2073 7461 7475 732e 0a0a  r.     status...
│ │ │ │ │ -0000a0a0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ │ -0000a0b0: 7420 666b 6f5f 6765 745f 7370 615f 7365  t fko_get_spa_se
│ │ │ │ │ -0000a0c0: 7276 6572 5f61 7574 6820 2866 6b6f 5f63  rver_auth (fko_c
│ │ │ │ │ -0000a0d0: 7478 5f74 2043 5458 2c20 6368 6172 0a20  tx_t CTX, char. 
│ │ │ │ │ -0000a0e0: 2020 2020 2020 2020 202a 2a53 4552 5645           **SERVE
│ │ │ │ │ -0000a0f0: 525f 4155 5448 293b 0a20 2020 2020 4173  R_AUTH);.     As
│ │ │ │ │ -0000a100: 7369 676e 7320 7468 6520 706f 696e 7465  signs the pointe
│ │ │ │ │ -0000a110: 7220 746f 2074 6865 2073 7472 696e 6720  r to the string 
│ │ │ │ │ -0000a120: 686f 6c64 696e 6720 7468 6520 7468 6520  holding the the 
│ │ │ │ │ -0000a130: 666b 6f20 5350 4120 7365 7276 6572 0a20  fko SPA server. 
│ │ │ │ │ -0000a140: 2020 2020 6175 7468 206d 6573 7361 6765      auth message
│ │ │ │ │ -0000a150: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with
│ │ │ │ │ -0000a160: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con
│ │ │ │ │ -0000a170: 7465 7874 2074 6f20 7468 6520 6164 6472  text to the addr
│ │ │ │ │ -0000a180: 6573 730a 2020 2020 2053 4552 5645 525f  ess.     SERVER_
│ │ │ │ │ -0000a190: 4155 5448 2069 7320 706f 696e 7469 6e67  AUTH is pointing
│ │ │ │ │ -0000a1a0: 2074 6f2e 2020 5468 6520 7265 7475 726e   to.  The return
│ │ │ │ │ -0000a1b0: 2076 616c 7565 2069 7320 616e 2046 4b4f   value is an FKO
│ │ │ │ │ -0000a1c0: 2065 7272 6f72 0a20 2020 2020 7374 6174   error.     stat
│ │ │ │ │ -0000a1d0: 7573 2e0a 0a20 2d2d 2046 756e 6374 696f  us... -- Functio
│ │ │ │ │ -0000a1e0: 6e3a 2069 6e74 2066 6b6f 5f67 6574 5f73  n: int fko_get_s
│ │ │ │ │ -0000a1f0: 7061 5f63 6c69 656e 745f 7469 6d65 6f75  pa_client_timeou
│ │ │ │ │ -0000a200: 7420 2866 6b6f 5f63 7478 5f74 2043 5458  t (fko_ctx_t CTX
│ │ │ │ │ -0000a210: 2c20 696e 740a 2020 2020 2020 2020 2020  , int.          
│ │ │ │ │ -0000a220: 2a43 4c49 454e 545f 5449 4d45 4f55 5429  *CLIENT_TIMEOUT)
│ │ │ │ │ -0000a230: 3b0a 2020 2020 2053 6574 7320 7468 6520  ;.     Sets the 
│ │ │ │ │ -0000a240: 7661 6c75 6520 6f66 2074 6865 2043 4c49  value of the CLI
│ │ │ │ │ -0000a250: 454e 545f 5449 4d45 4f55 5420 7661 7269  ENT_TIMEOUT vari
│ │ │ │ │ -0000a260: 6162 6c65 2074 6f20 7468 6520 636c 6965  able to the clie
│ │ │ │ │ -0000a270: 6e74 5f74 696d 656f 7574 0a20 2020 2020  nt_timeout.     
│ │ │ │ │ -0000a280: 7661 6c75 6520 6173 736f 6369 6174 6564  value associated
│ │ │ │ │ -0000a290: 2077 6974 6820 7468 6520 6375 7272 656e   with the curren
│ │ │ │ │ -0000a2a0: 7420 636f 6e74 6578 742e 2020 5468 6520  t context.  The 
│ │ │ │ │ -0000a2b0: 7265 7475 726e 2076 616c 7565 2069 7320  return value is 
│ │ │ │ │ -0000a2c0: 616e 0a20 2020 2020 464b 4f20 6572 726f  an.     FKO erro
│ │ │ │ │ -0000a2d0: 7220 7374 6174 7573 2e0a 0a20 2d2d 2046  r status... -- F
│ │ │ │ │ -0000a2e0: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko
│ │ │ │ │ -0000a2f0: 5f67 6574 5f73 7061 5f64 6967 6573 745f  _get_spa_digest_
│ │ │ │ │ -0000a300: 7479 7065 2028 666b 6f5f 6374 785f 7420  type (fko_ctx_t 
│ │ │ │ │ -0000a310: 4354 582c 2073 686f 7274 0a20 2020 2020  CTX, short.     
│ │ │ │ │ -0000a320: 2020 2020 202a 4449 4745 5354 5f54 5950       *DIGEST_TYP
│ │ │ │ │ -0000a330: 4529 3b0a 2020 2020 2053 6574 7320 7468  E);.     Sets th
│ │ │ │ │ -0000a340: 6520 7661 6c75 6520 6f66 2074 6865 2044  e value of the D
│ │ │ │ │ -0000a350: 4947 4553 545f 5459 5045 2076 6172 6961  IGEST_TYPE varia
│ │ │ │ │ -0000a360: 626c 6520 746f 2074 6865 2064 6967 6573  ble to the diges
│ │ │ │ │ -0000a370: 7420 7479 7065 2076 616c 7565 0a20 2020  t type value.   
│ │ │ │ │ -0000a380: 2020 6173 736f 6369 6174 6564 2077 6974    associated wit
│ │ │ │ │ -0000a390: 6820 7468 6520 6375 7272 656e 7420 636f  h the current co
│ │ │ │ │ -0000a3a0: 6e74 6578 742e 2020 5468 6973 2076 616c  ntext.  This val
│ │ │ │ │ -0000a3b0: 7565 2063 616e 2062 6520 6368 6563 6b65  ue can be checke
│ │ │ │ │ -0000a3c0: 640a 2020 2020 2061 6761 696e 7374 2074  d.     against t
│ │ │ │ │ -0000a3d0: 6865 206c 6973 7420 6f66 2076 616c 6964  he list of valid
│ │ │ │ │ -0000a3e0: 2064 6967 6573 745f 7479 7065 7320 6c69   digest_types li
│ │ │ │ │ -0000a3f0: 7374 6564 2069 6e20 2a6e 6f74 6520 4469  sted in *note Di
│ │ │ │ │ -0000a400: 6765 7374 733a 3a20 6f66 0a20 2020 2020  gests:: of.     
│ │ │ │ │ -0000a410: 7468 6973 206d 616e 7561 6c2e 2020 5468  this manual.  Th
│ │ │ │ │ -0000a420: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i
│ │ │ │ │ -0000a430: 7320 616e 2046 4b4f 2065 7272 6f72 2073  s an FKO error s
│ │ │ │ │ -0000a440: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func
│ │ │ │ │ -0000a450: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge
│ │ │ │ │ -0000a460: 745f 7370 615f 686d 6163 5f74 7970 6520  t_spa_hmac_type 
│ │ │ │ │ -0000a470: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, 
│ │ │ │ │ -0000a480: 7368 6f72 740a 2020 2020 2020 2020 2020  short.          
│ │ │ │ │ -0000a490: 2a48 4d41 435f 5459 5045 293b 0a20 2020  *HMAC_TYPE);.   
│ │ │ │ │ -0000a4a0: 2020 5365 7473 2074 6865 2076 616c 7565    Sets the value
│ │ │ │ │ -0000a4b0: 206f 6620 7468 6520 484d 4143 5f54 5950   of the HMAC_TYP
│ │ │ │ │ -0000a4c0: 4520 7661 7269 6162 6c65 2074 6f20 7468  E variable to th
│ │ │ │ │ -0000a4d0: 6520 484d 4143 2074 7970 6520 7661 6c75  e HMAC type valu
│ │ │ │ │ -0000a4e0: 650a 2020 2020 2061 7373 6f63 6961 7465  e.     associate
│ │ │ │ │ -0000a4f0: 6420 7769 7468 2074 6865 2063 7572 7265  d with the curre
│ │ │ │ │ -0000a500: 6e74 2063 6f6e 7465 7874 2e20 2054 6869  nt context.  Thi
│ │ │ │ │ -0000a510: 7320 7661 6c75 6520 6361 6e20 6265 2063  s value can be c
│ │ │ │ │ -0000a520: 6865 636b 6564 0a20 2020 2020 6167 6169  hecked.     agai
│ │ │ │ │ -0000a530: 6e73 7420 7468 6520 6c69 7374 206f 6620  nst the list of 
│ │ │ │ │ -0000a540: 7661 6c69 6420 686d 6163 5f74 7970 6573  valid hmac_types
│ │ │ │ │ -0000a550: 206c 6973 7465 6420 696e 202a 6e6f 7465   listed in *note
│ │ │ │ │ -0000a560: 2048 4d41 4320 4469 6765 7374 733a 3a0a   HMAC Digests::.
│ │ │ │ │ -0000a570: 2020 2020 206f 6620 7468 6973 206d 616e       of this man
│ │ │ │ │ -0000a580: 7561 6c2e 2020 5468 6520 7265 7475 726e  ual.  The return
│ │ │ │ │ -0000a590: 2076 616c 7565 2069 7320 616e 2046 4b4f   value is an FKO
│ │ │ │ │ -0000a5a0: 2065 7272 6f72 2073 7461 7475 732e 0a0a   error status...
│ │ │ │ │ -0000a5b0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ │ -0000a5c0: 7420 666b 6f5f 6765 745f 7370 615f 6469  t fko_get_spa_di
│ │ │ │ │ -0000a5d0: 6765 7374 2028 666b 6f5f 6374 785f 7420  gest (fko_ctx_t 
│ │ │ │ │ -0000a5e0: 4354 582c 2063 6861 7220 2a2a 5350 415f  CTX, char **SPA_
│ │ │ │ │ -0000a5f0: 4449 4745 5354 293b 0a20 2020 2020 4173  DIGEST);.     As
│ │ │ │ │ -0000a600: 7369 676e 7320 7468 6520 706f 696e 7465  signs the pointe
│ │ │ │ │ -0000a610: 7220 746f 2074 6865 2073 7472 696e 6720  r to the string 
│ │ │ │ │ -0000a620: 686f 6c64 696e 6720 7468 6520 7468 6520  holding the the 
│ │ │ │ │ -0000a630: 666b 6f20 5350 4120 6469 6765 7374 0a20  fko SPA digest. 
│ │ │ │ │ -0000a640: 2020 2020 7661 6c75 6520 6173 736f 6369      value associ
│ │ │ │ │ -0000a650: 6174 6564 2077 6974 6820 7468 6520 6375  ated with the cu
│ │ │ │ │ -0000a660: 7272 656e 7420 636f 6e74 6578 7420 746f  rrent context to
│ │ │ │ │ -0000a670: 2074 6865 2061 6464 7265 7373 2053 5041   the address SPA
│ │ │ │ │ -0000a680: 5f44 4947 4553 540a 2020 2020 2069 7320  _DIGEST.     is 
│ │ │ │ │ -0000a690: 706f 696e 7469 6e67 2074 6f2e 2020 5468  pointing to.  Th
│ │ │ │ │ -0000a6a0: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i
│ │ │ │ │ -0000a6b0: 7320 616e 2046 4b4f 2065 7272 6f72 2073  s an FKO error s
│ │ │ │ │ -0000a6c0: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func
│ │ │ │ │ -0000a6d0: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge
│ │ │ │ │ -0000a6e0: 745f 7370 615f 686d 6163 2028 666b 6f5f  t_spa_hmac (fko_
│ │ │ │ │ -0000a6f0: 6374 785f 7420 4354 582c 2063 6861 7220  ctx_t CTX, char 
│ │ │ │ │ -0000a700: 2a2a 5350 415f 484d 4143 293b 0a20 2020  **SPA_HMAC);.   
│ │ │ │ │ -0000a710: 2020 4173 7369 676e 7320 7468 6520 706f    Assigns the po
│ │ │ │ │ -0000a720: 696e 7465 7220 746f 2074 6865 2073 7472  inter to the str
│ │ │ │ │ -0000a730: 696e 6720 686f 6c64 696e 6720 7468 6520  ing holding the 
│ │ │ │ │ -0000a740: 7468 6520 666b 6f20 5350 4120 484d 4143  the fko SPA HMAC
│ │ │ │ │ -0000a750: 0a20 2020 2020 7661 6c75 6520 6173 736f  .     value asso
│ │ │ │ │ -0000a760: 6369 6174 6564 2077 6974 6820 7468 6520  ciated with the 
│ │ │ │ │ -0000a770: 6375 7272 656e 7420 636f 6e74 6578 7420  current context 
│ │ │ │ │ -0000a780: 746f 2074 6865 2061 6464 7265 7373 2053  to the address S
│ │ │ │ │ -0000a790: 5041 5f48 4d41 430a 2020 2020 2069 7320  PA_HMAC.     is 
│ │ │ │ │ -0000a7a0: 706f 696e 7469 6e67 2074 6f2e 2020 5468  pointing to.  Th
│ │ │ │ │ -0000a7b0: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i
│ │ │ │ │ -0000a7c0: 7320 616e 2046 4b4f 2065 7272 6f72 2073  s an FKO error s
│ │ │ │ │ -0000a7d0: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func
│ │ │ │ │ -0000a7e0: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge
│ │ │ │ │ -0000a7f0: 745f 7370 615f 656e 6372 7970 7469 6f6e  t_spa_encryption
│ │ │ │ │ -0000a800: 5f74 7970 6520 2866 6b6f 5f63 7478 5f74  _type (fko_ctx_t
│ │ │ │ │ -0000a810: 2043 5458 2c20 7368 6f72 740a 2020 2020   CTX, short.    
│ │ │ │ │ -0000a820: 2020 2020 2020 2a45 4e43 5f54 5950 4529        *ENC_TYPE)
│ │ │ │ │ -0000a830: 3b0a 2020 2020 2053 6574 7320 7468 6520  ;.     Sets the 
│ │ │ │ │ -0000a840: 7661 6c75 6520 6f66 2074 6865 2045 4e43  value of the ENC
│ │ │ │ │ -0000a850: 5f54 5950 4520 7661 7269 6162 6c65 2074  _TYPE variable t
│ │ │ │ │ -0000a860: 6f20 7468 6520 656e 6372 7970 7469 6f6e  o the encryption
│ │ │ │ │ -0000a870: 2074 7970 650a 2020 2020 2076 616c 7565   type.     value
│ │ │ │ │ -0000a880: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with
│ │ │ │ │ -0000a890: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con
│ │ │ │ │ -0000a8a0: 7465 7874 2e20 2054 6869 7320 7661 6c75  text.  This valu
│ │ │ │ │ -0000a8b0: 6520 6361 6e20 6265 0a20 2020 2020 6368  e can be.     ch
│ │ │ │ │ -0000a8c0: 6563 6b65 6420 6167 6169 6e73 7420 7468  ecked against th
│ │ │ │ │ -0000a8d0: 6520 6c69 7374 206f 6620 7661 6c69 6420  e list of valid 
│ │ │ │ │ -0000a8e0: 6469 6765 7374 5f74 7970 6573 206c 6973  digest_types lis
│ │ │ │ │ -0000a8f0: 7465 6420 696e 202a 6e6f 7465 0a20 2020  ted in *note.   
│ │ │ │ │ -0000a900: 2020 456e 6372 7970 7469 6f6e 2041 6c67    Encryption Alg
│ │ │ │ │ -0000a910: 6f72 6974 686d 733a 3a20 6f66 2074 6869  orithms:: of thi
│ │ │ │ │ -0000a920: 7320 6d61 6e75 616c 2e20 2054 6865 2072  s manual.  The r
│ │ │ │ │ -0000a930: 6574 7572 6e20 7661 6c75 6520 6973 2061  eturn value is a
│ │ │ │ │ -0000a940: 6e20 464b 4f0a 2020 2020 2065 7272 6f72  n FKO.     error
│ │ │ │ │ -0000a950: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu
│ │ │ │ │ -0000a960: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_
│ │ │ │ │ -0000a970: 6765 745f 656e 636f 6465 645f 6461 7461  get_encoded_data
│ │ │ │ │ -0000a980: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,
│ │ │ │ │ -0000a990: 2063 6861 7220 2a2a 454e 435f 4d53 4729   char **ENC_MSG)
│ │ │ │ │ -0000a9a0: 3b0a 2020 2020 2041 7373 6967 6e73 2074  ;.     Assigns t
│ │ │ │ │ -0000a9b0: 6865 2070 6f69 6e74 6572 2074 6f20 7468  he pointer to th
│ │ │ │ │ -0000a9c0: 6520 7374 7269 6e67 2068 6f6c 6469 6e67  e string holding
│ │ │ │ │ -0000a9d0: 2074 6865 2074 6865 2065 6e63 6f64 6564   the the encoded
│ │ │ │ │ -0000a9e0: 2053 5041 2064 6174 610a 2020 2020 2028   SPA data.     (
│ │ │ │ │ -0000a9f0: 6265 666f 7265 2065 6e63 7279 7074 696f  before encryptio
│ │ │ │ │ -0000aa00: 6e29 2061 7373 6f63 6961 7465 6420 7769  n) associated wi
│ │ │ │ │ -0000aa10: 7468 2074 6865 2063 7572 7265 6e74 2063  th the current c
│ │ │ │ │ -0000aa20: 6f6e 7465 7874 2074 6f20 7468 650a 2020  ontext to the.  
│ │ │ │ │ -0000aa30: 2020 2061 6464 7265 7373 2045 4e43 5f4d     address ENC_M
│ │ │ │ │ -0000aa40: 5347 2069 7320 706f 696e 7469 6e67 2074  SG is pointing t
│ │ │ │ │ -0000aa50: 6f2e 2020 5468 6973 2069 7320 696e 7465  o.  This is inte
│ │ │ │ │ -0000aa60: 726d 6564 6961 7465 2064 6174 6120 7468  rmediate data th
│ │ │ │ │ -0000aa70: 6174 0a20 2020 2020 776f 756c 6420 6e6f  at.     would no
│ │ │ │ │ -0000aa80: 7420 6e6f 726d 616c 6c79 2062 6520 6f66  t normally be of
│ │ │ │ │ -0000aa90: 2075 7365 2075 6e6c 6573 7320 6465 6275   use unless debu
│ │ │ │ │ -0000aaa0: 6767 696e 6720 7468 6520 6c69 6272 6172  gging the librar
│ │ │ │ │ -0000aab0: 792e 2020 5468 650a 2020 2020 2072 6574  y.  The.     ret
│ │ │ │ │ -0000aac0: 7572 6e20 7661 6c75 6520 6973 2061 6e20  urn value is an 
│ │ │ │ │ -0000aad0: 464b 4f20 6572 726f 7220 7374 6174 7573  FKO error status
│ │ │ │ │ -0000aae0: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:
│ │ │ │ │ -0000aaf0: 2069 6e74 2066 6b6f 5f67 6574 5f76 6572   int fko_get_ver
│ │ │ │ │ -0000ab00: 7369 6f6e 2028 666b 6f5f 6374 785f 7420  sion (fko_ctx_t 
│ │ │ │ │ -0000ab10: 4354 582c 2063 6861 7220 2a2a 464b 4f5f  CTX, char **FKO_
│ │ │ │ │ -0000ab20: 5645 5253 494f 4e29 3b0a 2020 2020 2041  VERSION);.     A
│ │ │ │ │ -0000ab30: 7373 6967 6e73 2074 6865 2070 6f69 6e74  ssigns the point
│ │ │ │ │ -0000ab40: 6572 2074 6f20 7468 6520 7374 7269 6e67  er to the string
│ │ │ │ │ -0000ab50: 2068 6f6c 6469 6e67 2074 6865 2074 6865   holding the the
│ │ │ │ │ -0000ab60: 2053 5041 2076 6572 7369 6f6e 2076 616c   SPA version val
│ │ │ │ │ -0000ab70: 7565 0a20 2020 2020 6173 736f 6369 6174  ue.     associat
│ │ │ │ │ -0000ab80: 6564 2077 6974 6820 7468 6520 6375 7272  ed with the curr
│ │ │ │ │ -0000ab90: 656e 7420 636f 6e74 6578 7420 746f 2074  ent context to t
│ │ │ │ │ -0000aba0: 6865 2061 6464 7265 7373 2046 4b4f 5f56  he address FKO_V
│ │ │ │ │ -0000abb0: 4552 5349 4f4e 2069 730a 2020 2020 2070  ERSION is.     p
│ │ │ │ │ -0000abc0: 6f69 6e74 696e 6720 746f 2e20 2054 6869  ointing to.  Thi
│ │ │ │ │ -0000abd0: 7320 6973 2061 2073 7461 7469 6320 7661  s is a static va
│ │ │ │ │ -0000abe0: 6c75 6520 666f 7220 5350 4120 6461 7461  lue for SPA data
│ │ │ │ │ -0000abf0: 2074 6861 7420 6973 2062 6569 6e67 0a20   that is being. 
│ │ │ │ │ -0000ac00: 2020 2020 6372 6561 7465 6420 696e 2061      created in a
│ │ │ │ │ -0000ac10: 206e 6577 2063 6f6e 7465 7874 2e20 2046   new context.  F
│ │ │ │ │ -0000ac20: 6f72 2064 6174 6120 7061 7273 6564 2066  or data parsed f
│ │ │ │ │ -0000ac30: 726f 6d20 616e 2065 7874 6572 6e61 6c20  rom an external 
│ │ │ │ │ -0000ac40: 736f 7572 6365 2c0a 2020 2020 2074 6865  source,.     the
│ │ │ │ │ -0000ac50: 2076 6572 7369 6f6e 2073 7472 696e 6720   version string 
│ │ │ │ │ -0000ac60: 7769 6c6c 2062 6520 7768 6174 6576 6572  will be whatever
│ │ │ │ │ -0000ac70: 2076 6572 7369 6f6e 2074 6865 2073 656e   version the sen
│ │ │ │ │ -0000ac80: 6469 6e67 2063 6c69 656e 740a 2020 2020  ding client.    
│ │ │ │ │ -0000ac90: 2075 7365 642e 2020 5468 6520 7265 7475   used.  The retu
│ │ │ │ │ -0000aca0: 726e 2076 616c 7565 2069 7320 616e 2046  rn value is an F
│ │ │ │ │ -0000acb0: 4b4f 2065 7272 6f72 2073 7461 7475 732e  KO error status.
│ │ │ │ │ -0000acc0: 0a0a 5f47 5047 2d73 7065 6369 6669 6320  .._GPG-specific 
│ │ │ │ │ -0000acd0: 6675 6e63 7469 6f6e 733a 5f0a 0a20 2d2d  functions:_.. --
│ │ │ │ │ -0000ace0: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f
│ │ │ │ │ -0000acf0: 6b6f 5f67 6574 5f67 7067 5f72 6563 6970  ko_get_gpg_recip
│ │ │ │ │ -0000ad00: 6965 6e74 2028 666b 6f5f 6374 785f 7420  ient (fko_ctx_t 
│ │ │ │ │ -0000ad10: 4354 582c 2063 6861 720a 2020 2020 2020  CTX, char.      
│ │ │ │ │ -0000ad20: 2020 2020 2a2a 5245 4349 5049 454e 5429      **RECIPIENT)
│ │ │ │ │ -0000ad30: 3b0a 2020 2020 2041 7373 6967 6e73 2074  ;.     Assigns t
│ │ │ │ │ -0000ad40: 6865 2070 6f69 6e74 6572 2074 6f20 7468  he pointer to th
│ │ │ │ │ -0000ad50: 6520 7374 7269 6e67 2068 6f6c 6469 6e67  e string holding
│ │ │ │ │ -0000ad60: 2074 6865 2074 6865 2047 5047 2072 6563   the the GPG rec
│ │ │ │ │ -0000ad70: 6970 6965 6e74 2049 440a 2020 2020 2061  ipient ID.     a
│ │ │ │ │ -0000ad80: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t
│ │ │ │ │ -0000ad90: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte
│ │ │ │ │ -0000ada0: 7874 2074 6f20 7468 6520 6164 6472 6573  xt to the addres
│ │ │ │ │ -0000adb0: 7320 5245 4349 5049 454e 5420 6973 0a20  s RECIPIENT is. 
│ │ │ │ │ -0000adc0: 2020 2020 706f 696e 7469 6e67 2074 6f2e      pointing to.
│ │ │ │ │ -0000add0: 2020 5468 6520 7265 7475 726e 2076 616c    The return val
│ │ │ │ │ -0000ade0: 7565 2069 7320 616e 2046 4b4f 2065 7272  ue is an FKO err
│ │ │ │ │ -0000adf0: 6f72 2073 7461 7475 732e 0a0a 202d 2d20  or status... -- 
│ │ │ │ │ -0000ae00: 4675 6e63 7469 6f6e 3a20 696e 7420 666b  Function: int fk
│ │ │ │ │ -0000ae10: 6f5f 6765 745f 6770 675f 7369 676e 6572  o_get_gpg_signer
│ │ │ │ │ -0000ae20: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,
│ │ │ │ │ -0000ae30: 2063 6861 7220 2a2a 5349 474e 4552 293b   char **SIGNER);
│ │ │ │ │ -0000ae40: 0a20 2020 2020 4173 7369 676e 7320 7468  .     Assigns th
│ │ │ │ │ -0000ae50: 6520 706f 696e 7465 7220 746f 2074 6865  e pointer to the
│ │ │ │ │ -0000ae60: 2073 7472 696e 6720 686f 6c64 696e 6720   string holding 
│ │ │ │ │ -0000ae70: 7468 6520 7468 6520 4750 4720 7369 676e  the the GPG sign
│ │ │ │ │ -0000ae80: 6572 2049 440a 2020 2020 2061 7373 6f63  er ID.     assoc
│ │ │ │ │ -0000ae90: 6961 7465 6420 7769 7468 2074 6865 2063  iated with the c
│ │ │ │ │ -0000aea0: 7572 7265 6e74 2063 6f6e 7465 7874 2074  urrent context t
│ │ │ │ │ -0000aeb0: 6f20 7468 6520 6164 6472 6573 7320 5349  o the address SI
│ │ │ │ │ -0000aec0: 474e 4552 2069 730a 2020 2020 2070 6f69  GNER is.     poi
│ │ │ │ │ -0000aed0: 6e74 696e 6720 746f 2e20 2054 6865 2072  nting to.  The r
│ │ │ │ │ -0000aee0: 6574 7572 6e20 7661 6c75 6520 6973 2061  eturn value is a
│ │ │ │ │ -0000aef0: 6e20 464b 4f20 6572 726f 7220 7374 6174  n FKO error stat
│ │ │ │ │ -0000af00: 7573 2e0a 0a20 2d2d 2046 756e 6374 696f  us... -- Functio
│ │ │ │ │ -0000af10: 6e3a 2069 6e74 2066 6b6f 5f67 6574 5f67  n: int fko_get_g
│ │ │ │ │ -0000af20: 7067 5f68 6f6d 655f 6469 7220 2866 6b6f  pg_home_dir (fko
│ │ │ │ │ -0000af30: 5f63 7478 5f74 2043 5458 2c20 6368 6172  _ctx_t CTX, char
│ │ │ │ │ -0000af40: 202a 2a47 5047 5f44 4952 293b 0a20 2020   **GPG_DIR);.   
│ │ │ │ │ -0000af50: 2020 4173 7369 676e 7320 7468 6520 706f    Assigns the po
│ │ │ │ │ -0000af60: 696e 7465 7220 746f 2074 6865 2073 7472  inter to the str
│ │ │ │ │ -0000af70: 696e 6720 686f 6c64 696e 6720 7468 6520  ing holding the 
│ │ │ │ │ -0000af80: 7468 6520 4750 4720 686f 6d65 0a20 2020  the GPG home.   
│ │ │ │ │ -0000af90: 2020 6469 7265 6374 6f72 7920 6173 736f    directory asso
│ │ │ │ │ -0000afa0: 6369 6174 6564 2077 6974 6820 7468 6520  ciated with the 
│ │ │ │ │ -0000afb0: 6375 7272 656e 7420 636f 6e74 6578 7420  current context 
│ │ │ │ │ -0000afc0: 746f 2074 6865 2061 6464 7265 7373 0a20  to the address. 
│ │ │ │ │ -0000afd0: 2020 2020 4750 475f 4449 5220 6973 2070      GPG_DIR is p
│ │ │ │ │ -0000afe0: 6f69 6e74 696e 6720 746f 2e20 2054 6865  ointing to.  The
│ │ │ │ │ -0000aff0: 2072 6574 7572 6e20 7661 6c75 6520 6973   return value is
│ │ │ │ │ -0000b000: 2061 6e20 464b 4f20 6572 726f 7220 7374   an FKO error st
│ │ │ │ │ -0000b010: 6174 7573 2e0a 0a20 2d2d 2046 756e 6374  atus... -- Funct
│ │ │ │ │ -0000b020: 696f 6e3a 2069 6e74 2066 6b6f 5f67 6574  ion: int fko_get
│ │ │ │ │ -0000b030: 5f67 7067 5f73 6967 6e61 7475 7265 5f76  _gpg_signature_v
│ │ │ │ │ -0000b040: 6572 6966 7920 2866 6b6f 5f63 7478 5f74  erify (fko_ctx_t
│ │ │ │ │ -0000b050: 2043 5458 2c20 756e 7369 676e 6564 0a20   CTX, unsigned. 
│ │ │ │ │ -0000b060: 2020 2020 2020 2020 2063 6861 7220 2a56           char *V
│ │ │ │ │ -0000b070: 414c 293b 0a20 2020 2020 5365 7473 2074  AL);.     Sets t
│ │ │ │ │ -0000b080: 6865 2076 616c 7565 206f 6620 7468 6520  he value of the 
│ │ │ │ │ -0000b090: 5641 4c20 7661 7269 6162 6c65 2074 6f20  VAL variable to 
│ │ │ │ │ -0000b0a0: 7468 6520 6375 7272 656e 740a 2020 2020  the current.    
│ │ │ │ │ -0000b0b0: 2067 7067 5f73 6967 6e61 7475 7265 5f76   gpg_signature_v
│ │ │ │ │ -0000b0c0: 6572 6966 7920 666c 6167 2076 616c 7565  erify flag value
│ │ │ │ │ -0000b0d0: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with
│ │ │ │ │ -0000b0e0: 2074 6865 2063 7572 7265 6e74 0a20 2020   the current.   
│ │ │ │ │ -0000b0f0: 2020 636f 6e74 6578 742e 2020 5468 6520    context.  The 
│ │ │ │ │ -0000b100: 7265 7475 726e 2076 616c 7565 2069 7320  return value is 
│ │ │ │ │ -0000b110: 616e 2046 4b4f 2065 7272 6f72 2073 7461  an FKO error sta
│ │ │ │ │ -0000b120: 7475 732e 0a0a 202d 2d20 4675 6e63 7469  tus... -- Functi
│ │ │ │ │ -0000b130: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_
│ │ │ │ │ -0000b140: 6770 675f 6967 6e6f 7265 5f76 6572 6966  gpg_ignore_verif
│ │ │ │ │ -0000b150: 795f 6572 726f 7220 2866 6b6f 5f63 7478  y_error (fko_ctx
│ │ │ │ │ -0000b160: 5f74 2043 5458 2c0a 2020 2020 2020 2020  _t CTX,.        
│ │ │ │ │ -0000b170: 2020 756e 7369 676e 6564 2063 6861 7220    unsigned char 
│ │ │ │ │ -0000b180: 2a56 414c 293b 0a20 2020 2020 5365 7473  *VAL);.     Sets
│ │ │ │ │ -0000b190: 2074 6865 2076 616c 7565 206f 6620 7468   the value of th
│ │ │ │ │ -0000b1a0: 6520 5641 4c20 7661 7269 6162 6c65 2074  e VAL variable t
│ │ │ │ │ -0000b1b0: 6f20 7468 6520 6375 7272 656e 740a 2020  o the current.  
│ │ │ │ │ -0000b1c0: 2020 2069 676e 6f72 655f 7665 7269 6679     ignore_verify
│ │ │ │ │ -0000b1d0: 5f65 7272 6f72 2066 6c61 6720 7661 6c75  _error flag valu
│ │ │ │ │ -0000b1e0: 6520 6173 736f 6369 6174 6564 2077 6974  e associated wit
│ │ │ │ │ -0000b1f0: 6820 7468 6520 6375 7272 656e 7420 636f  h the current co
│ │ │ │ │ -0000b200: 6e74 6578 742e 0a20 2020 2020 5468 6520  ntext..     The 
│ │ │ │ │ -0000b210: 7265 7475 726e 2076 616c 7565 2069 7320  return value is 
│ │ │ │ │ -0000b220: 616e 2046 4b4f 2065 7272 6f72 2073 7461  an FKO error sta
│ │ │ │ │ -0000b230: 7475 732e 0a0a 202d 2d20 4675 6e63 7469  tus... -- Functi
│ │ │ │ │ -0000b240: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_
│ │ │ │ │ -0000b250: 6770 675f 7369 676e 6174 7572 655f 6964  gpg_signature_id
│ │ │ │ │ -0000b260: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,
│ │ │ │ │ -0000b270: 2063 6861 720a 2020 2020 2020 2020 2020   char.          
│ │ │ │ │ -0000b280: 2a2a 5349 475f 4944 293b 0a20 2020 2020  **SIG_ID);.     
│ │ │ │ │ -0000b290: 4173 7369 676e 7320 7468 6520 706f 696e  Assigns the poin
│ │ │ │ │ -0000b2a0: 7465 7220 746f 2074 6865 2073 7472 696e  ter to the strin
│ │ │ │ │ -0000b2b0: 6720 686f 6c64 696e 6720 7468 6520 7468  g holding the th
│ │ │ │ │ -0000b2c0: 6520 4750 4720 7369 676e 6174 7572 6520  e GPG signature 
│ │ │ │ │ -0000b2d0: 4944 0a20 2020 2020 6173 736f 6369 6174  ID.     associat
│ │ │ │ │ -0000b2e0: 6564 2077 6974 6820 7468 6520 6375 7272  ed with the curr
│ │ │ │ │ -0000b2f0: 656e 7420 636f 6e74 6578 7420 746f 2074  ent context to t
│ │ │ │ │ -0000b300: 6865 2061 6464 7265 7373 2053 4947 5f49  he address SIG_I
│ │ │ │ │ -0000b310: 4420 6973 0a20 2020 2020 706f 696e 7469  D is.     pointi
│ │ │ │ │ -0000b320: 6e67 2074 6f2e 2020 5468 6520 7265 7475  ng to.  The retu
│ │ │ │ │ -0000b330: 726e 2076 616c 7565 2069 7320 616e 2046  rn value is an F
│ │ │ │ │ -0000b340: 4b4f 2065 7272 6f72 2073 7461 7475 732e  KO error status.
│ │ │ │ │ -0000b350: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ │ -0000b360: 696e 7420 666b 6f5f 6765 745f 6770 675f  int fko_get_gpg_
│ │ │ │ │ -0000b370: 7369 676e 6174 7572 655f 6670 7220 2866  signature_fpr (f
│ │ │ │ │ -0000b380: 6b6f 5f63 7478 5f74 2043 5458 2c20 6368  ko_ctx_t CTX, ch
│ │ │ │ │ -0000b390: 6172 0a20 2020 2020 2020 2020 202a 2a53  ar.          **S
│ │ │ │ │ -0000b3a0: 4947 5f46 5052 293b 0a20 2020 2020 4173  IG_FPR);.     As
│ │ │ │ │ -0000b3b0: 7369 676e 7320 7468 6520 706f 696e 7465  signs the pointe
│ │ │ │ │ -0000b3c0: 7220 746f 2074 6865 2073 7472 696e 6720  r to the string 
│ │ │ │ │ -0000b3d0: 686f 6c64 696e 6720 7468 6520 7468 6520  holding the the 
│ │ │ │ │ -0000b3e0: 4750 4720 7369 676e 6174 7572 650a 2020  GPG signature.  
│ │ │ │ │ -0000b3f0: 2020 2066 696e 6765 7270 7269 6e74 2061     fingerprint a
│ │ │ │ │ -0000b400: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t
│ │ │ │ │ -0000b410: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte
│ │ │ │ │ -0000b420: 7874 2074 6f20 7468 6520 6164 6472 6573  xt to the addres
│ │ │ │ │ -0000b430: 730a 2020 2020 2053 4947 5f46 5052 2069  s.     SIG_FPR i
│ │ │ │ │ -0000b440: 7320 706f 696e 7469 6e67 2074 6f2e 2020  s pointing to.  
│ │ │ │ │ -0000b450: 5468 6520 7265 7475 726e 2076 616c 7565  The return value
│ │ │ │ │ -0000b460: 2069 7320 616e 2046 4b4f 2065 7272 6f72   is an FKO error
│ │ │ │ │ -0000b470: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu
│ │ │ │ │ -0000b480: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_
│ │ │ │ │ -0000b490: 6765 745f 6770 675f 7369 676e 6174 7572  get_gpg_signatur
│ │ │ │ │ -0000b4a0: 655f 7375 6d6d 6172 7920 2866 6b6f 5f63  e_summary (fko_c
│ │ │ │ │ -0000b4b0: 7478 5f74 2043 5458 2c20 696e 740a 2020  tx_t CTX, int.  
│ │ │ │ │ -0000b4c0: 2020 2020 2020 2020 2a53 4947 5f53 554d          *SIG_SUM
│ │ │ │ │ -0000b4d0: 293b 0a20 2020 2020 5365 7473 2074 6865  );.     Sets the
│ │ │ │ │ -0000b4e0: 2076 616c 7565 206f 6620 7468 6520 5349   value of the SI
│ │ │ │ │ -0000b4f0: 475f 5355 4d20 7661 7269 6162 6c65 2074  G_SUM variable t
│ │ │ │ │ -0000b500: 6f20 7468 6520 4750 4720 7369 676e 6174  o the GPG signat
│ │ │ │ │ -0000b510: 7572 6520 7375 6d6d 6172 790a 2020 2020  ure summary.    
│ │ │ │ │ -0000b520: 2076 616c 7565 2061 7373 6f63 6961 7465   value associate
│ │ │ │ │ -0000b530: 6420 7769 7468 2074 6865 2063 7572 7265  d with the curre
│ │ │ │ │ -0000b540: 6e74 2063 6f6e 7465 7874 2e20 2054 6865  nt context.  The
│ │ │ │ │ -0000b550: 2072 6574 7572 6e20 7661 6c75 6520 6973   return value is
│ │ │ │ │ -0000b560: 2061 6e0a 2020 2020 2046 4b4f 2065 7272   an.     FKO err
│ │ │ │ │ -0000b570: 6f72 2073 7461 7475 732e 0a0a 202d 2d20  or status... -- 
│ │ │ │ │ -0000b580: 4675 6e63 7469 6f6e 3a20 696e 7420 666b  Function: int fk
│ │ │ │ │ -0000b590: 6f5f 6765 745f 6770 675f 7369 676e 6174  o_get_gpg_signat
│ │ │ │ │ -0000b5a0: 7572 655f 7374 6174 7573 2028 666b 6f5f  ure_status (fko_
│ │ │ │ │ -0000b5b0: 6374 785f 7420 4354 582c 2069 6e74 0a20  ctx_t CTX, int. 
│ │ │ │ │ -0000b5c0: 2020 2020 2020 2020 202a 5349 475f 5354           *SIG_ST
│ │ │ │ │ -0000b5d0: 4154 293b 0a20 2020 2020 5365 7473 2074  AT);.     Sets t
│ │ │ │ │ -0000b5e0: 6865 2076 616c 7565 206f 6620 7468 6520  he value of the 
│ │ │ │ │ -0000b5f0: 5349 475f 5354 4154 2076 6172 6961 626c  SIG_STAT variabl
│ │ │ │ │ -0000b600: 6520 746f 2074 6865 2047 5047 2073 6967  e to the GPG sig
│ │ │ │ │ -0000b610: 6e61 7475 7265 2065 7272 6f72 0a20 2020  nature error.   
│ │ │ │ │ -0000b620: 2020 7374 6174 7573 2076 616c 7565 2061    status value a
│ │ │ │ │ -0000b630: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t
│ │ │ │ │ -0000b640: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte
│ │ │ │ │ -0000b650: 7874 2e20 2054 6865 2072 6574 7572 6e20  xt.  The return 
│ │ │ │ │ -0000b660: 7661 6c75 650a 2020 2020 2069 7320 616e  value.     is an
│ │ │ │ │ -0000b670: 2046 4b4f 2065 7272 6f72 2073 7461 7475   FKO error statu
│ │ │ │ │ -0000b680: 732e 0a0a 202d 2d20 4675 6e63 7469 6f6e  s... -- Function
│ │ │ │ │ -0000b690: 3a20 696e 7420 666b 6f5f 6765 745f 6770  : int fko_get_gp
│ │ │ │ │ -0000b6a0: 675f 6578 6520 2866 6b6f 5f63 7478 5f74  g_exe (fko_ctx_t
│ │ │ │ │ -0000b6b0: 2043 5458 2c20 6368 6172 202a 2a47 5047   CTX, char **GPG
│ │ │ │ │ -0000b6c0: 5f45 5845 293b 0a20 2020 2020 4173 7369  _EXE);.     Assi
│ │ │ │ │ -0000b6d0: 676e 7320 7468 6520 706f 696e 7465 7220  gns the pointer 
│ │ │ │ │ -0000b6e0: 746f 2074 6865 2073 7472 696e 6720 686f  to the string ho
│ │ │ │ │ -0000b6f0: 6c64 696e 6720 7468 6520 7468 6520 4750  lding the the GP
│ │ │ │ │ -0000b700: 4720 6578 6563 7574 6162 6c65 0a20 2020  G executable.   
│ │ │ │ │ -0000b710: 2020 7061 7468 2061 7373 6f63 6961 7465    path associate
│ │ │ │ │ -0000b720: 6420 7769 7468 2074 6865 2063 7572 7265  d with the curre
│ │ │ │ │ -0000b730: 6e74 2063 6f6e 7465 7874 2074 6f20 7468  nt context to th
│ │ │ │ │ -0000b740: 6520 6164 6472 6573 7320 4750 475f 4558  e address GPG_EX
│ │ │ │ │ -0000b750: 4520 6973 0a20 2020 2020 706f 696e 7469  E is.     pointi
│ │ │ │ │ -0000b760: 6e67 2074 6f2e 2020 5468 6520 7265 7475  ng to.  The retu
│ │ │ │ │ -0000b770: 726e 2076 616c 7565 2069 7320 616e 2046  rn value is an F
│ │ │ │ │ -0000b780: 4b4f 2065 7272 6f72 2073 7461 7475 732e  KO error status.
│ │ │ │ │ -0000b790: 0a0a 2a4e 6f74 652a 3a20 5468 6520 6368  ..*Note*: The ch
│ │ │ │ │ -0000b7a0: 6172 2a20 7661 6c75 6573 2072 6574 7269  ar* values retri
│ │ │ │ │ -0000b7b0: 6576 6564 2062 7920 7468 6520 4750 472d  eved by the GPG-
│ │ │ │ │ -0000b7c0: 7265 6c61 7465 6420 6675 6e63 7469 6f6e  related function
│ │ │ │ │ -0000b7d0: 7320 6162 6f76 650a 7769 6c6c 2062 6520  s above.will be 
│ │ │ │ │ -0000b7e0: 4e55 4c4c 2069 6620 7468 6520 636f 6e74  NULL if the cont
│ │ │ │ │ -0000b7f0: 6578 7420 7661 6c75 6520 7761 7320 6e6f  ext value was no
│ │ │ │ │ -0000b800: 7420 7072 6576 696f 7573 6c79 2073 6574  t previously set
│ │ │ │ │ -0000b810: 2e0a 0a1f 0a46 696c 653a 206c 6962 666b  .....File: libfk
│ │ │ │ │ -0000b820: 6f2e 696e 666f 2c20 204e 6f64 653a 2055  o.info,  Node: U
│ │ │ │ │ -0000b830: 7469 6c69 7479 2046 756e 6374 696f 6e73  tility Functions
│ │ │ │ │ -0000b840: 2c20 204e 6578 743a 2045 7272 6f72 2048  ,  Next: Error H
│ │ │ │ │ -0000b850: 616e 646c 696e 672c 2020 5072 6576 3a20  andling,  Prev: 
│ │ │ │ │ -0000b860: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D
│ │ │ │ │ -0000b870: 6174 612c 2020 5570 3a20 5573 696e 6720  ata,  Up: Using 
│ │ │ │ │ -0000b880: 6c69 6266 6b6f 0a0a 332e 3620 5574 696c  libfko..3.6 Util
│ │ │ │ │ -0000b890: 6974 7920 4675 6e63 7469 6f6e 730a 3d3d  ity Functions.==
│ │ │ │ │ +00009d70: 2020 2020 6272 6561 6b3b 0a20 2020 2020      break;.     
│ │ │ │ │ +00009d80: 2020 2020 2020 2020 2020 2020 2063 6173               cas
│ │ │ │ │ +00009d90: 6520 464b 4f5f 4e41 545f 4143 4345 5353  e FKO_NAT_ACCESS
│ │ │ │ │ +00009da0: 5f4d 5347 3a0a 2020 2020 2020 2020 2020  _MSG:.          
│ │ │ │ │ +00009db0: 2020 2020 2020 2020 2020 2020 7072 6f63              proc
│ │ │ │ │ +00009dc0: 6573 735f 6e61 745f 6163 6365 7373 5f6d  ess_nat_access_m
│ │ │ │ │ +00009dd0: 7367 282e 2e2e 293b 0a20 2020 2020 2020  sg(...);.       
│ │ │ │ │ +00009de0: 2020 2020 2020 2020 2020 2020 2020 2062                 b
│ │ │ │ │ +00009df0: 7265 616b 3b0a 2020 2020 2020 2020 2020  reak;.          
│ │ │ │ │ +00009e00: 2020 2020 2f2a 2e2e 2e61 6e64 2073 6f20      /*...and so 
│ │ │ │ │ +00009e10: 6f6e 2e2e 2e2a 2f0a 2020 2020 2020 2020  on...*/.        
│ │ │ │ │ +00009e20: 2020 2020 2020 7d0a 2020 2020 2054 6865        }.     The
│ │ │ │ │ +00009e30: 2072 6574 7572 6e20 7661 6c75 6520 6973   return value is
│ │ │ │ │ +00009e40: 2061 6e20 464b 4f20 6572 726f 7220 7374   an FKO error st
│ │ │ │ │ +00009e50: 6174 7573 2e0a 0a20 2d2d 2046 756e 6374  atus... -- Funct
│ │ │ │ │ +00009e60: 696f 6e3a 2069 6e74 2066 6b6f 5f67 6574  ion: int fko_get
│ │ │ │ │ +00009e70: 5f73 7061 5f6d 6573 7361 6765 2028 666b  _spa_message (fk
│ │ │ │ │ +00009e80: 6f5f 6374 785f 7420 4354 582c 2063 6861  o_ctx_t CTX, cha
│ │ │ │ │ +00009e90: 7220 2a2a 5350 415f 4d53 4729 3b0a 2020  r **SPA_MSG);.  
│ │ │ │ │ +00009ea0: 2020 2041 7373 6967 6e73 2074 6865 2070     Assigns the p
│ │ │ │ │ +00009eb0: 6f69 6e74 6572 2074 6f20 7468 6520 7374  ointer to the st
│ │ │ │ │ +00009ec0: 7269 6e67 2068 6f6c 6469 6e67 2074 6865  ring holding the
│ │ │ │ │ +00009ed0: 2074 6865 2066 6b6f 2053 5041 2072 6571   the fko SPA req
│ │ │ │ │ +00009ee0: 7565 7374 0a20 2020 2020 6d65 7373 6167  uest.     messag
│ │ │ │ │ +00009ef0: 6520 6173 736f 6369 6174 6564 2077 6974  e associated wit
│ │ │ │ │ +00009f00: 6820 7468 6520 6375 7272 656e 7420 636f  h the current co
│ │ │ │ │ +00009f10: 6e74 6578 7420 746f 2074 6865 2061 6464  ntext to the add
│ │ │ │ │ +00009f20: 7265 7373 2053 5041 5f4d 5347 0a20 2020  ress SPA_MSG.   
│ │ │ │ │ +00009f30: 2020 6973 2070 6f69 6e74 696e 6720 746f    is pointing to
│ │ │ │ │ +00009f40: 2e20 2054 6865 2072 6574 7572 6e20 7661  .  The return va
│ │ │ │ │ +00009f50: 6c75 6520 6973 2061 6e20 464b 4f20 6572  lue is an FKO er
│ │ │ │ │ +00009f60: 726f 7220 7374 6174 7573 2e0a 0a20 2d2d  ror status... --
│ │ │ │ │ +00009f70: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f
│ │ │ │ │ +00009f80: 6b6f 5f67 6574 5f73 7061 5f6e 6174 5f61  ko_get_spa_nat_a
│ │ │ │ │ +00009f90: 6363 6573 7320 2866 6b6f 5f63 7478 5f74  ccess (fko_ctx_t
│ │ │ │ │ +00009fa0: 2043 5458 2c20 6368 6172 0a20 2020 2020   CTX, char.     
│ │ │ │ │ +00009fb0: 2020 2020 202a 2a4e 4154 5f41 4343 4553       **NAT_ACCES
│ │ │ │ │ +00009fc0: 5329 3b0a 2020 2020 2041 7373 6967 6e73  S);.     Assigns
│ │ │ │ │ +00009fd0: 2074 6865 2070 6f69 6e74 6572 2074 6f20   the pointer to 
│ │ │ │ │ +00009fe0: 7468 6520 7374 7269 6e67 2068 6f6c 6469  the string holdi
│ │ │ │ │ +00009ff0: 6e67 2074 6865 2074 6865 2066 6b6f 2053  ng the the fko S
│ │ │ │ │ +0000a000: 5041 206e 6174 0a20 2020 2020 6163 6365  PA nat.     acce
│ │ │ │ │ +0000a010: 7373 206d 6573 7361 6765 2061 7373 6f63  ss message assoc
│ │ │ │ │ +0000a020: 6961 7465 6420 7769 7468 2074 6865 2063  iated with the c
│ │ │ │ │ +0000a030: 7572 7265 6e74 2063 6f6e 7465 7874 2074  urrent context t
│ │ │ │ │ +0000a040: 6f20 7468 6520 6164 6472 6573 730a 2020  o the address.  
│ │ │ │ │ +0000a050: 2020 204e 4154 5f41 4343 4553 5320 6973     NAT_ACCESS is
│ │ │ │ │ +0000a060: 2070 6f69 6e74 696e 6720 746f 2e20 2054   pointing to.  T
│ │ │ │ │ +0000a070: 6865 2072 6574 7572 6e20 7661 6c75 6520  he return value 
│ │ │ │ │ +0000a080: 6973 2061 6e20 464b 4f20 6572 726f 720a  is an FKO error.
│ │ │ │ │ +0000a090: 2020 2020 2073 7461 7475 732e 0a0a 202d       status... -
│ │ │ │ │ +0000a0a0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ │ +0000a0b0: 666b 6f5f 6765 745f 7370 615f 7365 7276  fko_get_spa_serv
│ │ │ │ │ +0000a0c0: 6572 5f61 7574 6820 2866 6b6f 5f63 7478  er_auth (fko_ctx
│ │ │ │ │ +0000a0d0: 5f74 2043 5458 2c20 6368 6172 0a20 2020  _t CTX, char.   
│ │ │ │ │ +0000a0e0: 2020 2020 2020 202a 2a53 4552 5645 525f         **SERVER_
│ │ │ │ │ +0000a0f0: 4155 5448 293b 0a20 2020 2020 4173 7369  AUTH);.     Assi
│ │ │ │ │ +0000a100: 676e 7320 7468 6520 706f 696e 7465 7220  gns the pointer 
│ │ │ │ │ +0000a110: 746f 2074 6865 2073 7472 696e 6720 686f  to the string ho
│ │ │ │ │ +0000a120: 6c64 696e 6720 7468 6520 7468 6520 666b  lding the the fk
│ │ │ │ │ +0000a130: 6f20 5350 4120 7365 7276 6572 0a20 2020  o SPA server.   
│ │ │ │ │ +0000a140: 2020 6175 7468 206d 6573 7361 6765 2061    auth message a
│ │ │ │ │ +0000a150: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t
│ │ │ │ │ +0000a160: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte
│ │ │ │ │ +0000a170: 7874 2074 6f20 7468 6520 6164 6472 6573  xt to the addres
│ │ │ │ │ +0000a180: 730a 2020 2020 2053 4552 5645 525f 4155  s.     SERVER_AU
│ │ │ │ │ +0000a190: 5448 2069 7320 706f 696e 7469 6e67 2074  TH is pointing t
│ │ │ │ │ +0000a1a0: 6f2e 2020 5468 6520 7265 7475 726e 2076  o.  The return v
│ │ │ │ │ +0000a1b0: 616c 7565 2069 7320 616e 2046 4b4f 2065  alue is an FKO e
│ │ │ │ │ +0000a1c0: 7272 6f72 0a20 2020 2020 7374 6174 7573  rror.     status
│ │ │ │ │ +0000a1d0: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:
│ │ │ │ │ +0000a1e0: 2069 6e74 2066 6b6f 5f67 6574 5f73 7061   int fko_get_spa
│ │ │ │ │ +0000a1f0: 5f63 6c69 656e 745f 7469 6d65 6f75 7420  _client_timeout 
│ │ │ │ │ +0000a200: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, 
│ │ │ │ │ +0000a210: 696e 740a 2020 2020 2020 2020 2020 2a43  int.          *C
│ │ │ │ │ +0000a220: 4c49 454e 545f 5449 4d45 4f55 5429 3b0a  LIENT_TIMEOUT);.
│ │ │ │ │ +0000a230: 2020 2020 2053 6574 7320 7468 6520 7661       Sets the va
│ │ │ │ │ +0000a240: 6c75 6520 6f66 2074 6865 2043 4c49 454e  lue of the CLIEN
│ │ │ │ │ +0000a250: 545f 5449 4d45 4f55 5420 7661 7269 6162  T_TIMEOUT variab
│ │ │ │ │ +0000a260: 6c65 2074 6f20 7468 6520 636c 6965 6e74  le to the client
│ │ │ │ │ +0000a270: 5f74 696d 656f 7574 0a20 2020 2020 7661  _timeout.     va
│ │ │ │ │ +0000a280: 6c75 6520 6173 736f 6369 6174 6564 2077  lue associated w
│ │ │ │ │ +0000a290: 6974 6820 7468 6520 6375 7272 656e 7420  ith the current 
│ │ │ │ │ +0000a2a0: 636f 6e74 6578 742e 2020 5468 6520 7265  context.  The re
│ │ │ │ │ +0000a2b0: 7475 726e 2076 616c 7565 2069 7320 616e  turn value is an
│ │ │ │ │ +0000a2c0: 0a20 2020 2020 464b 4f20 6572 726f 7220  .     FKO error 
│ │ │ │ │ +0000a2d0: 7374 6174 7573 2e0a 0a20 2d2d 2046 756e  status... -- Fun
│ │ │ │ │ +0000a2e0: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f67  ction: int fko_g
│ │ │ │ │ +0000a2f0: 6574 5f73 7061 5f64 6967 6573 745f 7479  et_spa_digest_ty
│ │ │ │ │ +0000a300: 7065 2028 666b 6f5f 6374 785f 7420 4354  pe (fko_ctx_t CT
│ │ │ │ │ +0000a310: 582c 2073 686f 7274 0a20 2020 2020 2020  X, short.       
│ │ │ │ │ +0000a320: 2020 202a 4449 4745 5354 5f54 5950 4529     *DIGEST_TYPE)
│ │ │ │ │ +0000a330: 3b0a 2020 2020 2053 6574 7320 7468 6520  ;.     Sets the 
│ │ │ │ │ +0000a340: 7661 6c75 6520 6f66 2074 6865 2044 4947  value of the DIG
│ │ │ │ │ +0000a350: 4553 545f 5459 5045 2076 6172 6961 626c  EST_TYPE variabl
│ │ │ │ │ +0000a360: 6520 746f 2074 6865 2064 6967 6573 7420  e to the digest 
│ │ │ │ │ +0000a370: 7479 7065 2076 616c 7565 0a20 2020 2020  type value.     
│ │ │ │ │ +0000a380: 6173 736f 6369 6174 6564 2077 6974 6820  associated with 
│ │ │ │ │ +0000a390: 7468 6520 6375 7272 656e 7420 636f 6e74  the current cont
│ │ │ │ │ +0000a3a0: 6578 742e 2020 5468 6973 2076 616c 7565  ext.  This value
│ │ │ │ │ +0000a3b0: 2063 616e 2062 6520 6368 6563 6b65 640a   can be checked.
│ │ │ │ │ +0000a3c0: 2020 2020 2061 6761 696e 7374 2074 6865       against the
│ │ │ │ │ +0000a3d0: 206c 6973 7420 6f66 2076 616c 6964 2064   list of valid d
│ │ │ │ │ +0000a3e0: 6967 6573 745f 7479 7065 7320 6c69 7374  igest_types list
│ │ │ │ │ +0000a3f0: 6564 2069 6e20 2a6e 6f74 6520 4469 6765  ed in *note Dige
│ │ │ │ │ +0000a400: 7374 733a 3a20 6f66 0a20 2020 2020 7468  sts:: of.     th
│ │ │ │ │ +0000a410: 6973 206d 616e 7561 6c2e 2020 5468 6520  is manual.  The 
│ │ │ │ │ +0000a420: 7265 7475 726e 2076 616c 7565 2069 7320  return value is 
│ │ │ │ │ +0000a430: 616e 2046 4b4f 2065 7272 6f72 2073 7461  an FKO error sta
│ │ │ │ │ +0000a440: 7475 732e 0a0a 202d 2d20 4675 6e63 7469  tus... -- Functi
│ │ │ │ │ +0000a450: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_
│ │ │ │ │ +0000a460: 7370 615f 686d 6163 5f74 7970 6520 2866  spa_hmac_type (f
│ │ │ │ │ +0000a470: 6b6f 5f63 7478 5f74 2043 5458 2c20 7368  ko_ctx_t CTX, sh
│ │ │ │ │ +0000a480: 6f72 740a 2020 2020 2020 2020 2020 2a48  ort.          *H
│ │ │ │ │ +0000a490: 4d41 435f 5459 5045 293b 0a20 2020 2020  MAC_TYPE);.     
│ │ │ │ │ +0000a4a0: 5365 7473 2074 6865 2076 616c 7565 206f  Sets the value o
│ │ │ │ │ +0000a4b0: 6620 7468 6520 484d 4143 5f54 5950 4520  f the HMAC_TYPE 
│ │ │ │ │ +0000a4c0: 7661 7269 6162 6c65 2074 6f20 7468 6520  variable to the 
│ │ │ │ │ +0000a4d0: 484d 4143 2074 7970 6520 7661 6c75 650a  HMAC type value.
│ │ │ │ │ +0000a4e0: 2020 2020 2061 7373 6f63 6961 7465 6420       associated 
│ │ │ │ │ +0000a4f0: 7769 7468 2074 6865 2063 7572 7265 6e74  with the current
│ │ │ │ │ +0000a500: 2063 6f6e 7465 7874 2e20 2054 6869 7320   context.  This 
│ │ │ │ │ +0000a510: 7661 6c75 6520 6361 6e20 6265 2063 6865  value can be che
│ │ │ │ │ +0000a520: 636b 6564 0a20 2020 2020 6167 6169 6e73  cked.     agains
│ │ │ │ │ +0000a530: 7420 7468 6520 6c69 7374 206f 6620 7661  t the list of va
│ │ │ │ │ +0000a540: 6c69 6420 686d 6163 5f74 7970 6573 206c  lid hmac_types l
│ │ │ │ │ +0000a550: 6973 7465 6420 696e 202a 6e6f 7465 2048  isted in *note H
│ │ │ │ │ +0000a560: 4d41 4320 4469 6765 7374 733a 3a0a 2020  MAC Digests::.  
│ │ │ │ │ +0000a570: 2020 206f 6620 7468 6973 206d 616e 7561     of this manua
│ │ │ │ │ +0000a580: 6c2e 2020 5468 6520 7265 7475 726e 2076  l.  The return v
│ │ │ │ │ +0000a590: 616c 7565 2069 7320 616e 2046 4b4f 2065  alue is an FKO e
│ │ │ │ │ +0000a5a0: 7272 6f72 2073 7461 7475 732e 0a0a 202d  rror status... -
│ │ │ │ │ +0000a5b0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ │ +0000a5c0: 666b 6f5f 6765 745f 7370 615f 6469 6765  fko_get_spa_dige
│ │ │ │ │ +0000a5d0: 7374 2028 666b 6f5f 6374 785f 7420 4354  st (fko_ctx_t CT
│ │ │ │ │ +0000a5e0: 582c 2063 6861 7220 2a2a 5350 415f 4449  X, char **SPA_DI
│ │ │ │ │ +0000a5f0: 4745 5354 293b 0a20 2020 2020 4173 7369  GEST);.     Assi
│ │ │ │ │ +0000a600: 676e 7320 7468 6520 706f 696e 7465 7220  gns the pointer 
│ │ │ │ │ +0000a610: 746f 2074 6865 2073 7472 696e 6720 686f  to the string ho
│ │ │ │ │ +0000a620: 6c64 696e 6720 7468 6520 7468 6520 666b  lding the the fk
│ │ │ │ │ +0000a630: 6f20 5350 4120 6469 6765 7374 0a20 2020  o SPA digest.   
│ │ │ │ │ +0000a640: 2020 7661 6c75 6520 6173 736f 6369 6174    value associat
│ │ │ │ │ +0000a650: 6564 2077 6974 6820 7468 6520 6375 7272  ed with the curr
│ │ │ │ │ +0000a660: 656e 7420 636f 6e74 6578 7420 746f 2074  ent context to t
│ │ │ │ │ +0000a670: 6865 2061 6464 7265 7373 2053 5041 5f44  he address SPA_D
│ │ │ │ │ +0000a680: 4947 4553 540a 2020 2020 2069 7320 706f  IGEST.     is po
│ │ │ │ │ +0000a690: 696e 7469 6e67 2074 6f2e 2020 5468 6520  inting to.  The 
│ │ │ │ │ +0000a6a0: 7265 7475 726e 2076 616c 7565 2069 7320  return value is 
│ │ │ │ │ +0000a6b0: 616e 2046 4b4f 2065 7272 6f72 2073 7461  an FKO error sta
│ │ │ │ │ +0000a6c0: 7475 732e 0a0a 202d 2d20 4675 6e63 7469  tus... -- Functi
│ │ │ │ │ +0000a6d0: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_
│ │ │ │ │ +0000a6e0: 7370 615f 686d 6163 2028 666b 6f5f 6374  spa_hmac (fko_ct
│ │ │ │ │ +0000a6f0: 785f 7420 4354 582c 2063 6861 7220 2a2a  x_t CTX, char **
│ │ │ │ │ +0000a700: 5350 415f 484d 4143 293b 0a20 2020 2020  SPA_HMAC);.     
│ │ │ │ │ +0000a710: 4173 7369 676e 7320 7468 6520 706f 696e  Assigns the poin
│ │ │ │ │ +0000a720: 7465 7220 746f 2074 6865 2073 7472 696e  ter to the strin
│ │ │ │ │ +0000a730: 6720 686f 6c64 696e 6720 7468 6520 7468  g holding the th
│ │ │ │ │ +0000a740: 6520 666b 6f20 5350 4120 484d 4143 0a20  e fko SPA HMAC. 
│ │ │ │ │ +0000a750: 2020 2020 7661 6c75 6520 6173 736f 6369      value associ
│ │ │ │ │ +0000a760: 6174 6564 2077 6974 6820 7468 6520 6375  ated with the cu
│ │ │ │ │ +0000a770: 7272 656e 7420 636f 6e74 6578 7420 746f  rrent context to
│ │ │ │ │ +0000a780: 2074 6865 2061 6464 7265 7373 2053 5041   the address SPA
│ │ │ │ │ +0000a790: 5f48 4d41 430a 2020 2020 2069 7320 706f  _HMAC.     is po
│ │ │ │ │ +0000a7a0: 696e 7469 6e67 2074 6f2e 2020 5468 6520  inting to.  The 
│ │ │ │ │ +0000a7b0: 7265 7475 726e 2076 616c 7565 2069 7320  return value is 
│ │ │ │ │ +0000a7c0: 616e 2046 4b4f 2065 7272 6f72 2073 7461  an FKO error sta
│ │ │ │ │ +0000a7d0: 7475 732e 0a0a 202d 2d20 4675 6e63 7469  tus... -- Functi
│ │ │ │ │ +0000a7e0: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_
│ │ │ │ │ +0000a7f0: 7370 615f 656e 6372 7970 7469 6f6e 5f74  spa_encryption_t
│ │ │ │ │ +0000a800: 7970 6520 2866 6b6f 5f63 7478 5f74 2043  ype (fko_ctx_t C
│ │ │ │ │ +0000a810: 5458 2c20 7368 6f72 740a 2020 2020 2020  TX, short.      
│ │ │ │ │ +0000a820: 2020 2020 2a45 4e43 5f54 5950 4529 3b0a      *ENC_TYPE);.
│ │ │ │ │ +0000a830: 2020 2020 2053 6574 7320 7468 6520 7661       Sets the va
│ │ │ │ │ +0000a840: 6c75 6520 6f66 2074 6865 2045 4e43 5f54  lue of the ENC_T
│ │ │ │ │ +0000a850: 5950 4520 7661 7269 6162 6c65 2074 6f20  YPE variable to 
│ │ │ │ │ +0000a860: 7468 6520 656e 6372 7970 7469 6f6e 2074  the encryption t
│ │ │ │ │ +0000a870: 7970 650a 2020 2020 2076 616c 7565 2061  ype.     value a
│ │ │ │ │ +0000a880: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t
│ │ │ │ │ +0000a890: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte
│ │ │ │ │ +0000a8a0: 7874 2e20 2054 6869 7320 7661 6c75 6520  xt.  This value 
│ │ │ │ │ +0000a8b0: 6361 6e20 6265 0a20 2020 2020 6368 6563  can be.     chec
│ │ │ │ │ +0000a8c0: 6b65 6420 6167 6169 6e73 7420 7468 6520  ked against the 
│ │ │ │ │ +0000a8d0: 6c69 7374 206f 6620 7661 6c69 6420 6469  list of valid di
│ │ │ │ │ +0000a8e0: 6765 7374 5f74 7970 6573 206c 6973 7465  gest_types liste
│ │ │ │ │ +0000a8f0: 6420 696e 202a 6e6f 7465 0a20 2020 2020  d in *note.     
│ │ │ │ │ +0000a900: 456e 6372 7970 7469 6f6e 2041 6c67 6f72  Encryption Algor
│ │ │ │ │ +0000a910: 6974 686d 733a 3a20 6f66 2074 6869 7320  ithms:: of this 
│ │ │ │ │ +0000a920: 6d61 6e75 616c 2e20 2054 6865 2072 6574  manual.  The ret
│ │ │ │ │ +0000a930: 7572 6e20 7661 6c75 6520 6973 2061 6e20  urn value is an 
│ │ │ │ │ +0000a940: 464b 4f0a 2020 2020 2065 7272 6f72 2073  FKO.     error s
│ │ │ │ │ +0000a950: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func
│ │ │ │ │ +0000a960: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge
│ │ │ │ │ +0000a970: 745f 656e 636f 6465 645f 6461 7461 2028  t_encoded_data (
│ │ │ │ │ +0000a980: 666b 6f5f 6374 785f 7420 4354 582c 2063  fko_ctx_t CTX, c
│ │ │ │ │ +0000a990: 6861 7220 2a2a 454e 435f 4d53 4729 3b0a  har **ENC_MSG);.
│ │ │ │ │ +0000a9a0: 2020 2020 2041 7373 6967 6e73 2074 6865       Assigns the
│ │ │ │ │ +0000a9b0: 2070 6f69 6e74 6572 2074 6f20 7468 6520   pointer to the 
│ │ │ │ │ +0000a9c0: 7374 7269 6e67 2068 6f6c 6469 6e67 2074  string holding t
│ │ │ │ │ +0000a9d0: 6865 2074 6865 2065 6e63 6f64 6564 2053  he the encoded S
│ │ │ │ │ +0000a9e0: 5041 2064 6174 610a 2020 2020 2028 6265  PA data.     (be
│ │ │ │ │ +0000a9f0: 666f 7265 2065 6e63 7279 7074 696f 6e29  fore encryption)
│ │ │ │ │ +0000aa00: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with
│ │ │ │ │ +0000aa10: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con
│ │ │ │ │ +0000aa20: 7465 7874 2074 6f20 7468 650a 2020 2020  text to the.    
│ │ │ │ │ +0000aa30: 2061 6464 7265 7373 2045 4e43 5f4d 5347   address ENC_MSG
│ │ │ │ │ +0000aa40: 2069 7320 706f 696e 7469 6e67 2074 6f2e   is pointing to.
│ │ │ │ │ +0000aa50: 2020 5468 6973 2069 7320 696e 7465 726d    This is interm
│ │ │ │ │ +0000aa60: 6564 6961 7465 2064 6174 6120 7468 6174  ediate data that
│ │ │ │ │ +0000aa70: 0a20 2020 2020 776f 756c 6420 6e6f 7420  .     would not 
│ │ │ │ │ +0000aa80: 6e6f 726d 616c 6c79 2062 6520 6f66 2075  normally be of u
│ │ │ │ │ +0000aa90: 7365 2075 6e6c 6573 7320 6465 6275 6767  se unless debugg
│ │ │ │ │ +0000aaa0: 696e 6720 7468 6520 6c69 6272 6172 792e  ing the library.
│ │ │ │ │ +0000aab0: 2020 5468 650a 2020 2020 2072 6574 7572    The.     retur
│ │ │ │ │ +0000aac0: 6e20 7661 6c75 6520 6973 2061 6e20 464b  n value is an FK
│ │ │ │ │ +0000aad0: 4f20 6572 726f 7220 7374 6174 7573 2e0a  O error status..
│ │ │ │ │ +0000aae0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ │ +0000aaf0: 6e74 2066 6b6f 5f67 6574 5f76 6572 7369  nt fko_get_versi
│ │ │ │ │ +0000ab00: 6f6e 2028 666b 6f5f 6374 785f 7420 4354  on (fko_ctx_t CT
│ │ │ │ │ +0000ab10: 582c 2063 6861 7220 2a2a 464b 4f5f 5645  X, char **FKO_VE
│ │ │ │ │ +0000ab20: 5253 494f 4e29 3b0a 2020 2020 2041 7373  RSION);.     Ass
│ │ │ │ │ +0000ab30: 6967 6e73 2074 6865 2070 6f69 6e74 6572  igns the pointer
│ │ │ │ │ +0000ab40: 2074 6f20 7468 6520 7374 7269 6e67 2068   to the string h
│ │ │ │ │ +0000ab50: 6f6c 6469 6e67 2074 6865 2074 6865 2053  olding the the S
│ │ │ │ │ +0000ab60: 5041 2076 6572 7369 6f6e 2076 616c 7565  PA version value
│ │ │ │ │ +0000ab70: 0a20 2020 2020 6173 736f 6369 6174 6564  .     associated
│ │ │ │ │ +0000ab80: 2077 6974 6820 7468 6520 6375 7272 656e   with the curren
│ │ │ │ │ +0000ab90: 7420 636f 6e74 6578 7420 746f 2074 6865  t context to the
│ │ │ │ │ +0000aba0: 2061 6464 7265 7373 2046 4b4f 5f56 4552   address FKO_VER
│ │ │ │ │ +0000abb0: 5349 4f4e 2069 730a 2020 2020 2070 6f69  SION is.     poi
│ │ │ │ │ +0000abc0: 6e74 696e 6720 746f 2e20 2054 6869 7320  nting to.  This 
│ │ │ │ │ +0000abd0: 6973 2061 2073 7461 7469 6320 7661 6c75  is a static valu
│ │ │ │ │ +0000abe0: 6520 666f 7220 5350 4120 6461 7461 2074  e for SPA data t
│ │ │ │ │ +0000abf0: 6861 7420 6973 2062 6569 6e67 0a20 2020  hat is being.   
│ │ │ │ │ +0000ac00: 2020 6372 6561 7465 6420 696e 2061 206e    created in a n
│ │ │ │ │ +0000ac10: 6577 2063 6f6e 7465 7874 2e20 2046 6f72  ew context.  For
│ │ │ │ │ +0000ac20: 2064 6174 6120 7061 7273 6564 2066 726f   data parsed fro
│ │ │ │ │ +0000ac30: 6d20 616e 2065 7874 6572 6e61 6c20 736f  m an external so
│ │ │ │ │ +0000ac40: 7572 6365 2c0a 2020 2020 2074 6865 2076  urce,.     the v
│ │ │ │ │ +0000ac50: 6572 7369 6f6e 2073 7472 696e 6720 7769  ersion string wi
│ │ │ │ │ +0000ac60: 6c6c 2062 6520 7768 6174 6576 6572 2076  ll be whatever v
│ │ │ │ │ +0000ac70: 6572 7369 6f6e 2074 6865 2073 656e 6469  ersion the sendi
│ │ │ │ │ +0000ac80: 6e67 2063 6c69 656e 740a 2020 2020 2075  ng client.     u
│ │ │ │ │ +0000ac90: 7365 642e 2020 5468 6520 7265 7475 726e  sed.  The return
│ │ │ │ │ +0000aca0: 2076 616c 7565 2069 7320 616e 2046 4b4f   value is an FKO
│ │ │ │ │ +0000acb0: 2065 7272 6f72 2073 7461 7475 732e 0a0a   error status...
│ │ │ │ │ +0000acc0: 5f47 5047 2d73 7065 6369 6669 6320 6675  _GPG-specific fu
│ │ │ │ │ +0000acd0: 6e63 7469 6f6e 733a 5f0a 0a20 2d2d 2046  nctions:_.. -- F
│ │ │ │ │ +0000ace0: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko
│ │ │ │ │ +0000acf0: 5f67 6574 5f67 7067 5f72 6563 6970 6965  _get_gpg_recipie
│ │ │ │ │ +0000ad00: 6e74 2028 666b 6f5f 6374 785f 7420 4354  nt (fko_ctx_t CT
│ │ │ │ │ +0000ad10: 582c 2063 6861 720a 2020 2020 2020 2020  X, char.        
│ │ │ │ │ +0000ad20: 2020 2a2a 5245 4349 5049 454e 5429 3b0a    **RECIPIENT);.
│ │ │ │ │ +0000ad30: 2020 2020 2041 7373 6967 6e73 2074 6865       Assigns the
│ │ │ │ │ +0000ad40: 2070 6f69 6e74 6572 2074 6f20 7468 6520   pointer to the 
│ │ │ │ │ +0000ad50: 7374 7269 6e67 2068 6f6c 6469 6e67 2074  string holding t
│ │ │ │ │ +0000ad60: 6865 2074 6865 2047 5047 2072 6563 6970  he the GPG recip
│ │ │ │ │ +0000ad70: 6965 6e74 2049 440a 2020 2020 2061 7373  ient ID.     ass
│ │ │ │ │ +0000ad80: 6f63 6961 7465 6420 7769 7468 2074 6865  ociated with the
│ │ │ │ │ +0000ad90: 2063 7572 7265 6e74 2063 6f6e 7465 7874   current context
│ │ │ │ │ +0000ada0: 2074 6f20 7468 6520 6164 6472 6573 7320   to the address 
│ │ │ │ │ +0000adb0: 5245 4349 5049 454e 5420 6973 0a20 2020  RECIPIENT is.   
│ │ │ │ │ +0000adc0: 2020 706f 696e 7469 6e67 2074 6f2e 2020    pointing to.  
│ │ │ │ │ +0000add0: 5468 6520 7265 7475 726e 2076 616c 7565  The return value
│ │ │ │ │ +0000ade0: 2069 7320 616e 2046 4b4f 2065 7272 6f72   is an FKO error
│ │ │ │ │ +0000adf0: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu
│ │ │ │ │ +0000ae00: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_
│ │ │ │ │ +0000ae10: 6765 745f 6770 675f 7369 676e 6572 2028  get_gpg_signer (
│ │ │ │ │ +0000ae20: 666b 6f5f 6374 785f 7420 4354 582c 2063  fko_ctx_t CTX, c
│ │ │ │ │ +0000ae30: 6861 7220 2a2a 5349 474e 4552 293b 0a20  har **SIGNER);. 
│ │ │ │ │ +0000ae40: 2020 2020 4173 7369 676e 7320 7468 6520      Assigns the 
│ │ │ │ │ +0000ae50: 706f 696e 7465 7220 746f 2074 6865 2073  pointer to the s
│ │ │ │ │ +0000ae60: 7472 696e 6720 686f 6c64 696e 6720 7468  tring holding th
│ │ │ │ │ +0000ae70: 6520 7468 6520 4750 4720 7369 676e 6572  e the GPG signer
│ │ │ │ │ +0000ae80: 2049 440a 2020 2020 2061 7373 6f63 6961   ID.     associa
│ │ │ │ │ +0000ae90: 7465 6420 7769 7468 2074 6865 2063 7572  ted with the cur
│ │ │ │ │ +0000aea0: 7265 6e74 2063 6f6e 7465 7874 2074 6f20  rent context to 
│ │ │ │ │ +0000aeb0: 7468 6520 6164 6472 6573 7320 5349 474e  the address SIGN
│ │ │ │ │ +0000aec0: 4552 2069 730a 2020 2020 2070 6f69 6e74  ER is.     point
│ │ │ │ │ +0000aed0: 696e 6720 746f 2e20 2054 6865 2072 6574  ing to.  The ret
│ │ │ │ │ +0000aee0: 7572 6e20 7661 6c75 6520 6973 2061 6e20  urn value is an 
│ │ │ │ │ +0000aef0: 464b 4f20 6572 726f 7220 7374 6174 7573  FKO error status
│ │ │ │ │ +0000af00: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:
│ │ │ │ │ +0000af10: 2069 6e74 2066 6b6f 5f67 6574 5f67 7067   int fko_get_gpg
│ │ │ │ │ +0000af20: 5f68 6f6d 655f 6469 7220 2866 6b6f 5f63  _home_dir (fko_c
│ │ │ │ │ +0000af30: 7478 5f74 2043 5458 2c20 6368 6172 202a  tx_t CTX, char *
│ │ │ │ │ +0000af40: 2a47 5047 5f44 4952 293b 0a20 2020 2020  *GPG_DIR);.     
│ │ │ │ │ +0000af50: 4173 7369 676e 7320 7468 6520 706f 696e  Assigns the poin
│ │ │ │ │ +0000af60: 7465 7220 746f 2074 6865 2073 7472 696e  ter to the strin
│ │ │ │ │ +0000af70: 6720 686f 6c64 696e 6720 7468 6520 7468  g holding the th
│ │ │ │ │ +0000af80: 6520 4750 4720 686f 6d65 0a20 2020 2020  e GPG home.     
│ │ │ │ │ +0000af90: 6469 7265 6374 6f72 7920 6173 736f 6369  directory associ
│ │ │ │ │ +0000afa0: 6174 6564 2077 6974 6820 7468 6520 6375  ated with the cu
│ │ │ │ │ +0000afb0: 7272 656e 7420 636f 6e74 6578 7420 746f  rrent context to
│ │ │ │ │ +0000afc0: 2074 6865 2061 6464 7265 7373 0a20 2020   the address.   
│ │ │ │ │ +0000afd0: 2020 4750 475f 4449 5220 6973 2070 6f69    GPG_DIR is poi
│ │ │ │ │ +0000afe0: 6e74 696e 6720 746f 2e20 2054 6865 2072  nting to.  The r
│ │ │ │ │ +0000aff0: 6574 7572 6e20 7661 6c75 6520 6973 2061  eturn value is a
│ │ │ │ │ +0000b000: 6e20 464b 4f20 6572 726f 7220 7374 6174  n FKO error stat
│ │ │ │ │ +0000b010: 7573 2e0a 0a20 2d2d 2046 756e 6374 696f  us... -- Functio
│ │ │ │ │ +0000b020: 6e3a 2069 6e74 2066 6b6f 5f67 6574 5f67  n: int fko_get_g
│ │ │ │ │ +0000b030: 7067 5f73 6967 6e61 7475 7265 5f76 6572  pg_signature_ver
│ │ │ │ │ +0000b040: 6966 7920 2866 6b6f 5f63 7478 5f74 2043  ify (fko_ctx_t C
│ │ │ │ │ +0000b050: 5458 2c20 756e 7369 676e 6564 0a20 2020  TX, unsigned.   
│ │ │ │ │ +0000b060: 2020 2020 2020 2063 6861 7220 2a56 414c         char *VAL
│ │ │ │ │ +0000b070: 293b 0a20 2020 2020 5365 7473 2074 6865  );.     Sets the
│ │ │ │ │ +0000b080: 2076 616c 7565 206f 6620 7468 6520 5641   value of the VA
│ │ │ │ │ +0000b090: 4c20 7661 7269 6162 6c65 2074 6f20 7468  L variable to th
│ │ │ │ │ +0000b0a0: 6520 6375 7272 656e 740a 2020 2020 2067  e current.     g
│ │ │ │ │ +0000b0b0: 7067 5f73 6967 6e61 7475 7265 5f76 6572  pg_signature_ver
│ │ │ │ │ +0000b0c0: 6966 7920 666c 6167 2076 616c 7565 2061  ify flag value a
│ │ │ │ │ +0000b0d0: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t
│ │ │ │ │ +0000b0e0: 6865 2063 7572 7265 6e74 0a20 2020 2020  he current.     
│ │ │ │ │ +0000b0f0: 636f 6e74 6578 742e 2020 5468 6520 7265  context.  The re
│ │ │ │ │ +0000b100: 7475 726e 2076 616c 7565 2069 7320 616e  turn value is an
│ │ │ │ │ +0000b110: 2046 4b4f 2065 7272 6f72 2073 7461 7475   FKO error statu
│ │ │ │ │ +0000b120: 732e 0a0a 202d 2d20 4675 6e63 7469 6f6e  s... -- Function
│ │ │ │ │ +0000b130: 3a20 696e 7420 666b 6f5f 6765 745f 6770  : int fko_get_gp
│ │ │ │ │ +0000b140: 675f 6967 6e6f 7265 5f76 6572 6966 795f  g_ignore_verify_
│ │ │ │ │ +0000b150: 6572 726f 7220 2866 6b6f 5f63 7478 5f74  error (fko_ctx_t
│ │ │ │ │ +0000b160: 2043 5458 2c0a 2020 2020 2020 2020 2020   CTX,.          
│ │ │ │ │ +0000b170: 756e 7369 676e 6564 2063 6861 7220 2a56  unsigned char *V
│ │ │ │ │ +0000b180: 414c 293b 0a20 2020 2020 5365 7473 2074  AL);.     Sets t
│ │ │ │ │ +0000b190: 6865 2076 616c 7565 206f 6620 7468 6520  he value of the 
│ │ │ │ │ +0000b1a0: 5641 4c20 7661 7269 6162 6c65 2074 6f20  VAL variable to 
│ │ │ │ │ +0000b1b0: 7468 6520 6375 7272 656e 740a 2020 2020  the current.    
│ │ │ │ │ +0000b1c0: 2069 676e 6f72 655f 7665 7269 6679 5f65   ignore_verify_e
│ │ │ │ │ +0000b1d0: 7272 6f72 2066 6c61 6720 7661 6c75 6520  rror flag value 
│ │ │ │ │ +0000b1e0: 6173 736f 6369 6174 6564 2077 6974 6820  associated with 
│ │ │ │ │ +0000b1f0: 7468 6520 6375 7272 656e 7420 636f 6e74  the current cont
│ │ │ │ │ +0000b200: 6578 742e 0a20 2020 2020 5468 6520 7265  ext..     The re
│ │ │ │ │ +0000b210: 7475 726e 2076 616c 7565 2069 7320 616e  turn value is an
│ │ │ │ │ +0000b220: 2046 4b4f 2065 7272 6f72 2073 7461 7475   FKO error statu
│ │ │ │ │ +0000b230: 732e 0a0a 202d 2d20 4675 6e63 7469 6f6e  s... -- Function
│ │ │ │ │ +0000b240: 3a20 696e 7420 666b 6f5f 6765 745f 6770  : int fko_get_gp
│ │ │ │ │ +0000b250: 675f 7369 676e 6174 7572 655f 6964 2028  g_signature_id (
│ │ │ │ │ +0000b260: 666b 6f5f 6374 785f 7420 4354 582c 2063  fko_ctx_t CTX, c
│ │ │ │ │ +0000b270: 6861 720a 2020 2020 2020 2020 2020 2a2a  har.          **
│ │ │ │ │ +0000b280: 5349 475f 4944 293b 0a20 2020 2020 4173  SIG_ID);.     As
│ │ │ │ │ +0000b290: 7369 676e 7320 7468 6520 706f 696e 7465  signs the pointe
│ │ │ │ │ +0000b2a0: 7220 746f 2074 6865 2073 7472 696e 6720  r to the string 
│ │ │ │ │ +0000b2b0: 686f 6c64 696e 6720 7468 6520 7468 6520  holding the the 
│ │ │ │ │ +0000b2c0: 4750 4720 7369 676e 6174 7572 6520 4944  GPG signature ID
│ │ │ │ │ +0000b2d0: 0a20 2020 2020 6173 736f 6369 6174 6564  .     associated
│ │ │ │ │ +0000b2e0: 2077 6974 6820 7468 6520 6375 7272 656e   with the curren
│ │ │ │ │ +0000b2f0: 7420 636f 6e74 6578 7420 746f 2074 6865  t context to the
│ │ │ │ │ +0000b300: 2061 6464 7265 7373 2053 4947 5f49 4420   address SIG_ID 
│ │ │ │ │ +0000b310: 6973 0a20 2020 2020 706f 696e 7469 6e67  is.     pointing
│ │ │ │ │ +0000b320: 2074 6f2e 2020 5468 6520 7265 7475 726e   to.  The return
│ │ │ │ │ +0000b330: 2076 616c 7565 2069 7320 616e 2046 4b4f   value is an FKO
│ │ │ │ │ +0000b340: 2065 7272 6f72 2073 7461 7475 732e 0a0a   error status...
│ │ │ │ │ +0000b350: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ │ +0000b360: 7420 666b 6f5f 6765 745f 6770 675f 7369  t fko_get_gpg_si
│ │ │ │ │ +0000b370: 676e 6174 7572 655f 6670 7220 2866 6b6f  gnature_fpr (fko
│ │ │ │ │ +0000b380: 5f63 7478 5f74 2043 5458 2c20 6368 6172  _ctx_t CTX, char
│ │ │ │ │ +0000b390: 0a20 2020 2020 2020 2020 202a 2a53 4947  .          **SIG
│ │ │ │ │ +0000b3a0: 5f46 5052 293b 0a20 2020 2020 4173 7369  _FPR);.     Assi
│ │ │ │ │ +0000b3b0: 676e 7320 7468 6520 706f 696e 7465 7220  gns the pointer 
│ │ │ │ │ +0000b3c0: 746f 2074 6865 2073 7472 696e 6720 686f  to the string ho
│ │ │ │ │ +0000b3d0: 6c64 696e 6720 7468 6520 7468 6520 4750  lding the the GP
│ │ │ │ │ +0000b3e0: 4720 7369 676e 6174 7572 650a 2020 2020  G signature.    
│ │ │ │ │ +0000b3f0: 2066 696e 6765 7270 7269 6e74 2061 7373   fingerprint ass
│ │ │ │ │ +0000b400: 6f63 6961 7465 6420 7769 7468 2074 6865  ociated with the
│ │ │ │ │ +0000b410: 2063 7572 7265 6e74 2063 6f6e 7465 7874   current context
│ │ │ │ │ +0000b420: 2074 6f20 7468 6520 6164 6472 6573 730a   to the address.
│ │ │ │ │ +0000b430: 2020 2020 2053 4947 5f46 5052 2069 7320       SIG_FPR is 
│ │ │ │ │ +0000b440: 706f 696e 7469 6e67 2074 6f2e 2020 5468  pointing to.  Th
│ │ │ │ │ +0000b450: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i
│ │ │ │ │ +0000b460: 7320 616e 2046 4b4f 2065 7272 6f72 2073  s an FKO error s
│ │ │ │ │ +0000b470: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func
│ │ │ │ │ +0000b480: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge
│ │ │ │ │ +0000b490: 745f 6770 675f 7369 676e 6174 7572 655f  t_gpg_signature_
│ │ │ │ │ +0000b4a0: 7375 6d6d 6172 7920 2866 6b6f 5f63 7478  summary (fko_ctx
│ │ │ │ │ +0000b4b0: 5f74 2043 5458 2c20 696e 740a 2020 2020  _t CTX, int.    
│ │ │ │ │ +0000b4c0: 2020 2020 2020 2a53 4947 5f53 554d 293b        *SIG_SUM);
│ │ │ │ │ +0000b4d0: 0a20 2020 2020 5365 7473 2074 6865 2076  .     Sets the v
│ │ │ │ │ +0000b4e0: 616c 7565 206f 6620 7468 6520 5349 475f  alue of the SIG_
│ │ │ │ │ +0000b4f0: 5355 4d20 7661 7269 6162 6c65 2074 6f20  SUM variable to 
│ │ │ │ │ +0000b500: 7468 6520 4750 4720 7369 676e 6174 7572  the GPG signatur
│ │ │ │ │ +0000b510: 6520 7375 6d6d 6172 790a 2020 2020 2076  e summary.     v
│ │ │ │ │ +0000b520: 616c 7565 2061 7373 6f63 6961 7465 6420  alue associated 
│ │ │ │ │ +0000b530: 7769 7468 2074 6865 2063 7572 7265 6e74  with the current
│ │ │ │ │ +0000b540: 2063 6f6e 7465 7874 2e20 2054 6865 2072   context.  The r
│ │ │ │ │ +0000b550: 6574 7572 6e20 7661 6c75 6520 6973 2061  eturn value is a
│ │ │ │ │ +0000b560: 6e0a 2020 2020 2046 4b4f 2065 7272 6f72  n.     FKO error
│ │ │ │ │ +0000b570: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu
│ │ │ │ │ +0000b580: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_
│ │ │ │ │ +0000b590: 6765 745f 6770 675f 7369 676e 6174 7572  get_gpg_signatur
│ │ │ │ │ +0000b5a0: 655f 7374 6174 7573 2028 666b 6f5f 6374  e_status (fko_ct
│ │ │ │ │ +0000b5b0: 785f 7420 4354 582c 2069 6e74 0a20 2020  x_t CTX, int.   
│ │ │ │ │ +0000b5c0: 2020 2020 2020 202a 5349 475f 5354 4154         *SIG_STAT
│ │ │ │ │ +0000b5d0: 293b 0a20 2020 2020 5365 7473 2074 6865  );.     Sets the
│ │ │ │ │ +0000b5e0: 2076 616c 7565 206f 6620 7468 6520 5349   value of the SI
│ │ │ │ │ +0000b5f0: 475f 5354 4154 2076 6172 6961 626c 6520  G_STAT variable 
│ │ │ │ │ +0000b600: 746f 2074 6865 2047 5047 2073 6967 6e61  to the GPG signa
│ │ │ │ │ +0000b610: 7475 7265 2065 7272 6f72 0a20 2020 2020  ture error.     
│ │ │ │ │ +0000b620: 7374 6174 7573 2076 616c 7565 2061 7373  status value ass
│ │ │ │ │ +0000b630: 6f63 6961 7465 6420 7769 7468 2074 6865  ociated with the
│ │ │ │ │ +0000b640: 2063 7572 7265 6e74 2063 6f6e 7465 7874   current context
│ │ │ │ │ +0000b650: 2e20 2054 6865 2072 6574 7572 6e20 7661  .  The return va
│ │ │ │ │ +0000b660: 6c75 650a 2020 2020 2069 7320 616e 2046  lue.     is an F
│ │ │ │ │ +0000b670: 4b4f 2065 7272 6f72 2073 7461 7475 732e  KO error status.
│ │ │ │ │ +0000b680: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ │ +0000b690: 696e 7420 666b 6f5f 6765 745f 6770 675f  int fko_get_gpg_
│ │ │ │ │ +0000b6a0: 6578 6520 2866 6b6f 5f63 7478 5f74 2043  exe (fko_ctx_t C
│ │ │ │ │ +0000b6b0: 5458 2c20 6368 6172 202a 2a47 5047 5f45  TX, char **GPG_E
│ │ │ │ │ +0000b6c0: 5845 293b 0a20 2020 2020 4173 7369 676e  XE);.     Assign
│ │ │ │ │ +0000b6d0: 7320 7468 6520 706f 696e 7465 7220 746f  s the pointer to
│ │ │ │ │ +0000b6e0: 2074 6865 2073 7472 696e 6720 686f 6c64   the string hold
│ │ │ │ │ +0000b6f0: 696e 6720 7468 6520 7468 6520 4750 4720  ing the the GPG 
│ │ │ │ │ +0000b700: 6578 6563 7574 6162 6c65 0a20 2020 2020  executable.     
│ │ │ │ │ +0000b710: 7061 7468 2061 7373 6f63 6961 7465 6420  path associated 
│ │ │ │ │ +0000b720: 7769 7468 2074 6865 2063 7572 7265 6e74  with the current
│ │ │ │ │ +0000b730: 2063 6f6e 7465 7874 2074 6f20 7468 6520   context to the 
│ │ │ │ │ +0000b740: 6164 6472 6573 7320 4750 475f 4558 4520  address GPG_EXE 
│ │ │ │ │ +0000b750: 6973 0a20 2020 2020 706f 696e 7469 6e67  is.     pointing
│ │ │ │ │ +0000b760: 2074 6f2e 2020 5468 6520 7265 7475 726e   to.  The return
│ │ │ │ │ +0000b770: 2076 616c 7565 2069 7320 616e 2046 4b4f   value is an FKO
│ │ │ │ │ +0000b780: 2065 7272 6f72 2073 7461 7475 732e 0a0a   error status...
│ │ │ │ │ +0000b790: 2a4e 6f74 652a 3a20 5468 6520 6368 6172  *Note*: The char
│ │ │ │ │ +0000b7a0: 2a20 7661 6c75 6573 2072 6574 7269 6576  * values retriev
│ │ │ │ │ +0000b7b0: 6564 2062 7920 7468 6520 4750 472d 7265  ed by the GPG-re
│ │ │ │ │ +0000b7c0: 6c61 7465 6420 6675 6e63 7469 6f6e 7320  lated functions 
│ │ │ │ │ +0000b7d0: 6162 6f76 650a 7769 6c6c 2062 6520 4e55  above.will be NU
│ │ │ │ │ +0000b7e0: 4c4c 2069 6620 7468 6520 636f 6e74 6578  LL if the contex
│ │ │ │ │ +0000b7f0: 7420 7661 6c75 6520 7761 7320 6e6f 7420  t value was not 
│ │ │ │ │ +0000b800: 7072 6576 696f 7573 6c79 2073 6574 2e0a  previously set..
│ │ │ │ │ +0000b810: 0a1f 0a46 696c 653a 206c 6962 666b 6f2e  ...File: libfko.
│ │ │ │ │ +0000b820: 696e 666f 2c20 204e 6f64 653a 2055 7469  info,  Node: Uti
│ │ │ │ │ +0000b830: 6c69 7479 2046 756e 6374 696f 6e73 2c20  lity Functions, 
│ │ │ │ │ +0000b840: 204e 6578 743a 2045 7272 6f72 2048 616e   Next: Error Han
│ │ │ │ │ +0000b850: 646c 696e 672c 2020 5072 6576 3a20 5265  dling,  Prev: Re
│ │ │ │ │ +0000b860: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat
│ │ │ │ │ +0000b870: 612c 2020 5570 3a20 5573 696e 6720 6c69  a,  Up: Using li
│ │ │ │ │ +0000b880: 6266 6b6f 0a0a 332e 3620 5574 696c 6974  bfko..3.6 Utilit
│ │ │ │ │ +0000b890: 7920 4675 6e63 7469 6f6e 730a 3d3d 3d3d  y Functions.====
│ │ │ │ │  0000b8a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ │ -0000b8b0: 3d3d 3d0a 0a54 6869 7320 7365 6374 696f  ===..This sectio
│ │ │ │ │ -0000b8c0: 6e20 6465 7363 7269 6265 7320 7468 6520  n describes the 
│ │ │ │ │ -0000b8d0: 6675 6e63 7469 6f6e 7320 6e6f 7420 636f  functions not co
│ │ │ │ │ -0000b8e0: 7665 7265 6420 656c 7365 7768 6572 6520  vered elsewhere 
│ │ │ │ │ -0000b8f0: 696e 2074 6869 730a 6d61 6e75 616c 2e20  in this.manual. 
│ │ │ │ │ -0000b900: 2054 6865 7365 2061 7265 2075 7469 6c69   These are utili
│ │ │ │ │ -0000b910: 7479 2066 756e 6374 696f 6e73 2074 6861  ty functions tha
│ │ │ │ │ -0000b920: 7420 6f70 6572 6174 6520 6f6e 2074 6865  t operate on the
│ │ │ │ │ -0000b930: 2064 6174 6120 696e 2074 6865 2066 6b6f   data in the fko
│ │ │ │ │ -0000b940: 0a63 6f6e 7465 7874 2e20 2041 6c6c 2062  .context.  All b
│ │ │ │ │ -0000b950: 7574 2027 666b 6f5f 7370 615f 6461 7461  ut 'fko_spa_data
│ │ │ │ │ -0000b960: 5f66 696e 616c 2720 6172 6520 6361 6c6c  _final' are call
│ │ │ │ │ -0000b970: 6564 2062 7920 6f74 6865 7220 6675 6e63  ed by other func
│ │ │ │ │ -0000b980: 7469 6f6e 7320 616e 640a 6172 6520 6e6f  tions and.are no
│ │ │ │ │ -0000b990: 7420 6e6f 726d 616c 6c79 2065 7870 6c69  t normally expli
│ │ │ │ │ -0000b9a0: 6369 746c 7920 6361 6c6c 6564 2062 7920  citly called by 
│ │ │ │ │ -0000b9b0: 7468 6520 7573 6572 2e20 2048 6f77 6576  the user.  Howev
│ │ │ │ │ -0000b9c0: 6572 2c20 7468 6579 2063 616e 2062 652c  er, they can be,
│ │ │ │ │ -0000b9d0: 0a73 6f20 7468 6579 2061 7265 206c 6973  .so they are lis
│ │ │ │ │ -0000b9e0: 7465 6420 6865 7265 2e0a 0a20 2020 416c  ted here...   Al
│ │ │ │ │ -0000b9f0: 6c20 6f66 2074 6865 7365 2066 756e 6374  l of these funct
│ │ │ │ │ -0000ba00: 696f 6e73 2072 6574 7572 6e20 616e 2069  ions return an i
│ │ │ │ │ -0000ba10: 6e74 6567 6572 2072 6570 7265 7365 6e74  nteger represent
│ │ │ │ │ -0000ba20: 696e 6720 7468 6520 7265 7475 726e 0a73  ing the return.s
│ │ │ │ │ -0000ba30: 7461 7475 7320 6f66 2074 6865 2066 756e  tatus of the fun
│ │ │ │ │ -0000ba40: 6374 696f 6e2e 2020 5768 656e 2073 7563  ction.  When suc
│ │ │ │ │ -0000ba50: 6365 7366 756c 6c2c 2074 6865 7920 7769  cesfull, they wi
│ │ │ │ │ -0000ba60: 6c6c 2072 6574 7572 6e0a 2746 4b4f 5f53  ll return.'FKO_S
│ │ │ │ │ -0000ba70: 5543 4345 5353 272e 2020 4f74 6865 7277  UCCESS'.  Otherw
│ │ │ │ │ -0000ba80: 6973 652c 2061 6e20 6572 726f 7220 636f  ise, an error co
│ │ │ │ │ -0000ba90: 6465 2076 616c 7565 2069 7320 7265 7475  de value is retu
│ │ │ │ │ -0000baa0: 726e 6564 2e0a 0a20 2d2d 2046 756e 6374  rned... -- Funct
│ │ │ │ │ -0000bab0: 696f 6e3a 2069 6e74 2066 6b6f 5f73 7061  ion: int fko_spa
│ │ │ │ │ -0000bac0: 5f64 6174 615f 6669 6e61 6c20 2866 6b6f  _data_final (fko
│ │ │ │ │ -0000bad0: 5f63 7478 5f74 2043 5458 2c20 6368 6172  _ctx_t CTX, char
│ │ │ │ │ -0000bae0: 202a 454e 435f 4b45 592c 2069 6e74 0a20   *ENC_KEY, int. 
│ │ │ │ │ -0000baf0: 2020 2020 2020 2020 204b 454e 5f4c 454e           KEN_LEN
│ │ │ │ │ -0000bb00: 2c20 6368 6172 202a 484d 4143 5f4b 4559  , char *HMAC_KEY
│ │ │ │ │ -0000bb10: 2c20 696e 7420 484d 4143 5f4b 4559 5f4c  , int HMAC_KEY_L
│ │ │ │ │ -0000bb20: 454e 293b 0a20 2020 2020 5468 6973 2066  EN);.     This f
│ │ │ │ │ -0000bb30: 756e 6374 696f 6e20 6973 2074 6865 2066  unction is the f
│ │ │ │ │ -0000bb40: 696e 616c 2073 7465 7020 696e 2063 7265  inal step in cre
│ │ │ │ │ -0000bb50: 6174 696e 6720 6120 636f 6d70 6c65 7465  ating a complete
│ │ │ │ │ -0000bb60: 2065 6e63 7279 7074 6564 0a20 2020 2020   encrypted.     
│ │ │ │ │ -0000bb70: 5350 4120 6461 7461 2073 7472 696e 6720  SPA data string 
│ │ │ │ │ -0000bb80: 7375 6974 6162 6c65 2066 6f72 2074 7261  suitable for tra
│ │ │ │ │ -0000bb90: 6e73 6d69 7373 696f 6e20 746f 2061 6e20  nsmission to an 
│ │ │ │ │ -0000bba0: 6677 6b6e 6f70 2073 6572 7665 722e 2020  fwknop server.  
│ │ │ │ │ -0000bbb0: 4974 0a20 2020 2020 646f 6573 2072 6571  It.     does req
│ │ │ │ │ -0000bbc0: 7569 7265 2061 6c6c 206f 6620 7468 6520  uire all of the 
│ │ │ │ │ -0000bbd0: 7265 7175 6973 6974 6520 5350 4120 6461  requisite SPA da
│ │ │ │ │ -0000bbe0: 7461 2066 6965 6c64 7320 6265 2073 6574  ta fields be set
│ │ │ │ │ -0000bbf0: 2c20 6f74 6865 7277 6973 650a 2020 2020  , otherwise.    
│ │ │ │ │ -0000bc00: 2069 7420 7769 6c6c 2066 6169 6c20 7769   it will fail wi
│ │ │ │ │ -0000bc10: 7468 2061 6e20 6170 7072 6f70 7269 6174  th an appropriat
│ │ │ │ │ -0000bc20: 6520 6572 726f 7220 636f 6465 2e0a 0a20  e error code... 
│ │ │ │ │ -0000bc30: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ │ -0000bc40: 2066 6b6f 5f64 6563 7279 7074 5f73 7061   fko_decrypt_spa
│ │ │ │ │ -0000bc50: 5f64 6174 6120 2866 6b6f 5f63 7478 5f74  _data (fko_ctx_t
│ │ │ │ │ -0000bc60: 2043 5458 2c20 6368 6172 202a 4445 435f   CTX, char *DEC_
│ │ │ │ │ -0000bc70: 4b45 592c 0a20 2020 2020 2020 2020 2069  KEY,.          i
│ │ │ │ │ -0000bc80: 6e74 204b 4559 5f4c 454e 293b 0a20 2020  nt KEY_LEN);.   
│ │ │ │ │ -0000bc90: 2020 5768 656e 2067 6976 656e 2074 6865    When given the
│ │ │ │ │ -0000bca0: 2063 6f72 7265 6374 204b 4559 2028 7061   correct KEY (pa
│ │ │ │ │ -0000bcb0: 7373 776f 7264 292c 2074 6869 7320 6675  ssword), this fu
│ │ │ │ │ -0000bcc0: 6e63 7469 6f6e 2064 6563 7279 7074 732c  nction decrypts,
│ │ │ │ │ -0000bcd0: 0a20 2020 2020 6465 636f 6465 732c 2061  .     decodes, a
│ │ │ │ │ -0000bce0: 6e64 2070 6172 7365 7320 7468 6520 656e  nd parses the en
│ │ │ │ │ -0000bcf0: 6372 7970 7465 6420 5350 4120 6461 7461  crypted SPA data
│ │ │ │ │ -0000bd00: 2074 6861 7420 7761 7320 7375 7070 6c69   that was suppli
│ │ │ │ │ -0000bd10: 6564 2074 6f20 7468 650a 2020 2020 2063  ed to the.     c
│ │ │ │ │ -0000bd20: 6f6e 7465 7874 2076 6961 2074 6865 2027  ontext via the '
│ │ │ │ │ -0000bd30: 666b 6f5f 6e65 775f 7769 7468 5f64 6174  fko_new_with_dat
│ │ │ │ │ -0000bd40: 6127 2066 756e 6374 696f 6e20 7468 6174  a' function that
│ │ │ │ │ -0000bd50: 2077 6173 2061 6c73 6f20 6361 6c6c 6564   was also called
│ │ │ │ │ -0000bd60: 0a20 2020 2020 7769 7468 6f75 7420 7468  .     without th
│ │ │ │ │ -0000bd70: 6520 4b45 5920 7661 6c75 652e 2020 4f6e  e KEY value.  On
│ │ │ │ │ -0000bd80: 6365 2074 6865 2064 6174 6120 6973 2064  ce the data is d
│ │ │ │ │ -0000bd90: 6563 7279 7074 6564 2c20 7468 6973 2066  ecrypted, this f
│ │ │ │ │ -0000bda0: 756e 6374 696f 6e0a 2020 2020 2077 696c  unction.     wil
│ │ │ │ │ -0000bdb0: 6c20 616c 736f 2063 616c 6c20 2766 6b6f  l also call 'fko
│ │ │ │ │ -0000bdc0: 5f64 6563 6f64 655f 7370 615f 6461 7461  _decode_spa_data
│ │ │ │ │ -0000bdd0: 2720 746f 2064 6563 6f64 652c 2070 6172  ' to decode, par
│ │ │ │ │ -0000bde0: 7365 2c20 7661 6c69 6461 7465 2c0a 2020  se, validate,.  
│ │ │ │ │ -0000bdf0: 2020 2061 6e64 2073 746f 7265 2074 6865     and store the
│ │ │ │ │ -0000be00: 2064 6174 6120 6669 656c 6473 2069 6e20   data fields in 
│ │ │ │ │ -0000be10: 7468 6520 636f 6e74 6578 7420 666f 7220  the context for 
│ │ │ │ │ -0000be20: 6c61 7465 7220 7265 7472 6965 7661 6c2e  later retrieval.
│ │ │ │ │ -0000be30: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ │ -0000be40: 696e 7420 666b 6f5f 656e 6372 7970 745f  int fko_encrypt_
│ │ │ │ │ -0000be50: 7370 615f 6461 7461 2028 666b 6f5f 6374  spa_data (fko_ct
│ │ │ │ │ -0000be60: 785f 7420 4354 582c 2063 6861 7220 2a45  x_t CTX, char *E
│ │ │ │ │ -0000be70: 4e43 5f4b 4559 2c0a 2020 2020 2020 2020  NC_KEY,.        
│ │ │ │ │ -0000be80: 2020 696e 7420 4b45 595f 4c45 4e29 3b0a    int KEY_LEN);.
│ │ │ │ │ -0000be90: 2020 2020 2045 6e63 7279 7074 7320 7468       Encrypts th
│ │ │ │ │ -0000bea0: 6520 696e 7465 726d 6564 6961 7465 2065  e intermediate e
│ │ │ │ │ -0000beb0: 6e63 6f64 6564 2053 5041 2064 6174 6120  ncoded SPA data 
│ │ │ │ │ -0000bec0: 7374 6f72 6564 2069 6e20 7468 6520 636f  stored in the co
│ │ │ │ │ -0000bed0: 6e74 6578 742e 0a20 2020 2020 5468 6973  ntext..     This
│ │ │ │ │ -0000bee0: 2066 756e 6374 696f 6e20 7769 6c6c 2063   function will c
│ │ │ │ │ -0000bef0: 616c 6c20 2766 6b6f 5f65 6e63 6f64 6527  all 'fko_encode'
│ │ │ │ │ -0000bf00: 2069 6620 6e65 6365 7373 6172 792e 2020   if necessary.  
│ │ │ │ │ -0000bf10: 4974 2069 7320 6e6f 726d 616c 6c79 0a20  It is normally. 
│ │ │ │ │ -0000bf20: 2020 2020 6e6f 7420 6361 6c6c 6564 2064      not called d
│ │ │ │ │ -0000bf30: 6972 6563 746c 7920 6173 2069 7420 6973  irectly as it is
│ │ │ │ │ -0000bf40: 2063 616c 6c65 6420 6672 6f6d 2027 666b   called from 'fk
│ │ │ │ │ -0000bf50: 6f5f 7370 615f 6461 7461 5f66 696e 616c  o_spa_data_final
│ │ │ │ │ -0000bf60: 272e 0a0a 202d 2d20 4675 6e63 7469 6f6e  '... -- Function
│ │ │ │ │ -0000bf70: 3a20 696e 7420 666b 6f5f 6465 636f 6465  : int fko_decode
│ │ │ │ │ -0000bf80: 5f73 7061 5f64 6174 6120 2866 6b6f 5f63  _spa_data (fko_c
│ │ │ │ │ -0000bf90: 7478 5f74 2043 5458 293b 0a20 2020 2020  tx_t CTX);.     
│ │ │ │ │ -0000bfa0: 5468 6973 2066 756e 6374 696f 6e20 7065  This function pe
│ │ │ │ │ -0000bfb0: 7266 6f72 6d73 2074 6865 2064 6563 6f64  rforms the decod
│ │ │ │ │ -0000bfc0: 696e 672c 2070 6172 7369 6e67 2c20 7661  ing, parsing, va
│ │ │ │ │ -0000bfd0: 6c69 6461 7469 6f6e 206f 6620 7468 6520  lidation of the 
│ │ │ │ │ -0000bfe0: 5350 410a 2020 2020 2064 6174 6120 7468  SPA.     data th
│ │ │ │ │ -0000bff0: 6174 2077 6173 206a 7573 7420 6465 6372  at was just decr
│ │ │ │ │ -0000c000: 7970 7465 642e 2020 4974 2069 7320 6e6f  ypted.  It is no
│ │ │ │ │ -0000c010: 726d 616c 6c79 206e 6f74 2063 616c 6c65  rmally not calle
│ │ │ │ │ -0000c020: 6420 6469 7265 6374 6c79 0a20 2020 2020  d directly.     
│ │ │ │ │ -0000c030: 6173 2069 7420 6973 2063 616c 6c65 6420  as it is called 
│ │ │ │ │ -0000c040: 6672 6f6d 2027 666b 6f5f 6465 6372 7970  from 'fko_decryp
│ │ │ │ │ -0000c050: 745f 7370 615f 6461 7461 2720 2877 6869  t_spa_data' (whi
│ │ │ │ │ -0000c060: 6368 2069 7320 696e 2074 7572 6e0a 2020  ch is in turn.  
│ │ │ │ │ -0000c070: 2020 2063 616c 6c65 6420 6672 6f6d 2027     called from '
│ │ │ │ │ -0000c080: 666b 6f5f 6e65 775f 7769 7468 5f64 6174  fko_new_with_dat
│ │ │ │ │ -0000c090: 6127 2069 6620 6120 7061 7373 776f 7264  a' if a password
│ │ │ │ │ -0000c0a0: 2069 7320 7375 7070 6c69 6564 2074 6f20   is supplied to 
│ │ │ │ │ -0000c0b0: 6974 292e 0a0a 202d 2d20 4675 6e63 7469  it)... -- Functi
│ │ │ │ │ -0000c0c0: 6f6e 3a20 696e 7420 666b 6f5f 656e 636f  on: int fko_enco
│ │ │ │ │ -0000c0d0: 6465 5f73 7061 5f64 6174 6120 2866 6b6f  de_spa_data (fko
│ │ │ │ │ -0000c0e0: 5f63 7478 5f74 2043 5458 293b 0a20 2020  _ctx_t CTX);.   
│ │ │ │ │ -0000c0f0: 2020 5065 7266 6f72 6d73 2074 6865 2062    Performs the b
│ │ │ │ │ -0000c100: 6173 6536 3420 656e 636f 6469 6e67 206f  ase64 encoding o
│ │ │ │ │ -0000c110: 6620 7468 6f73 6520 5350 4120 6461 7461  f those SPA data
│ │ │ │ │ -0000c120: 2066 6965 6c64 7320 7468 6174 206e 6565   fields that nee
│ │ │ │ │ -0000c130: 6420 746f 0a20 2020 2020 6265 2065 6e63  d to.     be enc
│ │ │ │ │ -0000c140: 6f64 6564 2c20 7065 7266 6f72 6d73 2073  oded, performs s
│ │ │ │ │ -0000c150: 6f6d 6520 6461 7461 2076 616c 6964 6174  ome data validat
│ │ │ │ │ -0000c160: 696f 6e2c 2061 6e64 2063 616c 6c73 0a20  ion, and calls. 
│ │ │ │ │ -0000c170: 2020 2020 2766 6b70 5f73 6574 5f73 7061      'fkp_set_spa
│ │ │ │ │ -0000c180: 5f64 6967 6573 7427 2074 6f20 7265 636f  _digest' to reco
│ │ │ │ │ -0000c190: 6d70 7574 6520 7468 6520 5350 4120 6d65  mpute the SPA me
│ │ │ │ │ -0000c1a0: 7373 6167 6520 6469 6765 7374 2e20 2049  ssage digest.  I
│ │ │ │ │ -0000c1b0: 7420 6973 0a20 2020 2020 6e6f 726d 616c  t is.     normal
│ │ │ │ │ -0000c1c0: 6c79 206e 6f74 2063 616c 6c65 6420 6469  ly not called di
│ │ │ │ │ -0000c1d0: 7265 6374 6c79 2061 7320 6974 2069 7320  rectly as it is 
│ │ │ │ │ -0000c1e0: 6361 6c6c 6564 2066 726f 6d0a 2020 2020  called from.    
│ │ │ │ │ -0000c1f0: 2027 666b 6f5f 656e 6372 7970 745f 7370   'fko_encrypt_sp
│ │ │ │ │ -0000c200: 615f 6461 7461 2720 2877 6869 6368 2069  a_data' (which i
│ │ │ │ │ -0000c210: 7320 696e 2074 7572 6e20 6361 6c6c 6564  s in turn called
│ │ │ │ │ -0000c220: 2066 726f 6d0a 2020 2020 2027 666b 6f5f   from.     'fko_
│ │ │ │ │ -0000c230: 7370 615f 6461 7461 5f66 696e 616c 2729  spa_data_final')
│ │ │ │ │ -0000c240: 2e0a 0a5f 4750 472d 7370 6563 6966 6963  ..._GPG-specific
│ │ │ │ │ -0000c250: 2075 7469 6c69 7479 2066 756e 6374 696f   utility functio
│ │ │ │ │ -0000c260: 6e73 3a5f 0a0a 202d 2d20 4675 6e63 7469  ns:_.. -- Functi
│ │ │ │ │ -0000c270: 6f6e 3a20 696e 7420 666b 6f5f 6770 675f  on: int fko_gpg_
│ │ │ │ │ -0000c280: 7369 676e 6174 7572 655f 6964 5f6d 6174  signature_id_mat
│ │ │ │ │ -0000c290: 6368 2028 666b 6f5f 6374 785f 7420 4354  ch (fko_ctx_t CT
│ │ │ │ │ -0000c2a0: 582c 2063 6f6e 7374 2063 6861 720a 2020  X, const char.  
│ │ │ │ │ -0000c2b0: 2020 2020 2020 2020 2a49 442c 2075 6e73          *ID, uns
│ │ │ │ │ -0000c2c0: 6967 6e65 6420 6368 6172 202a 4944 5f4d  igned char *ID_M
│ │ │ │ │ -0000c2d0: 4154 4348 293b 0a20 2020 2020 5365 7473  ATCH);.     Sets
│ │ │ │ │ -0000c2e0: 2074 6865 2076 616c 7565 206f 6620 7468   the value of th
│ │ │ │ │ -0000c2f0: 6520 4944 5f4d 4154 4348 2076 6172 6961  e ID_MATCH varia
│ │ │ │ │ -0000c300: 626c 6520 746f 2074 7275 6520 2831 2920  ble to true (1) 
│ │ │ │ │ -0000c310: 6966 2074 6865 2076 616c 7565 206f 660a  if the value of.
│ │ │ │ │ -0000c320: 2020 2020 2049 4420 6d61 7463 6865 7320       ID matches 
│ │ │ │ │ -0000c330: 7468 6520 4944 206f 6620 7468 6520 4750  the ID of the GP
│ │ │ │ │ -0000c340: 4720 7369 676e 6174 7572 6520 6173 736f  G signature asso
│ │ │ │ │ -0000c350: 6369 6174 6564 2077 6974 6820 7468 6520  ciated with the 
│ │ │ │ │ -0000c360: 6375 7272 656e 740a 2020 2020 2063 6f6e  current.     con
│ │ │ │ │ -0000c370: 7465 7874 2e20 204f 7468 6572 7769 7365  text.  Otherwise
│ │ │ │ │ -0000c380: 2c20 4944 5f4d 4154 4348 2069 7320 7365  , ID_MATCH is se
│ │ │ │ │ -0000c390: 7420 746f 2066 616c 7365 2028 3029 2e20  t to false (0). 
│ │ │ │ │ -0000c3a0: 2054 6865 2072 6574 7572 6e0a 2020 2020   The return.    
│ │ │ │ │ -0000c3b0: 2076 616c 7565 2069 7320 616e 2046 4b4f   value is an FKO
│ │ │ │ │ -0000c3c0: 2065 7272 6f72 2073 7461 7475 732e 0a0a   error status...
│ │ │ │ │ -0000c3d0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ │ -0000c3e0: 7420 666b 6f5f 6770 675f 7369 676e 6174  t fko_gpg_signat
│ │ │ │ │ -0000c3f0: 7572 655f 6670 725f 6d61 7463 6820 2866  ure_fpr_match (f
│ │ │ │ │ -0000c400: 6b6f 5f63 7478 5f74 2043 5458 2c20 636f  ko_ctx_t CTX, co
│ │ │ │ │ -0000c410: 6e73 7420 6368 6172 0a20 2020 2020 2020  nst char.       
│ │ │ │ │ -0000c420: 2020 202a 4650 522c 2075 6e73 6967 6e65     *FPR, unsigne
│ │ │ │ │ -0000c430: 6420 6368 6172 202a 4650 525f 4d41 5443  d char *FPR_MATC
│ │ │ │ │ -0000c440: 4829 3b0a 2020 2020 2053 6574 7320 7468  H);.     Sets th
│ │ │ │ │ -0000c450: 6520 7661 6c75 6520 6f66 2074 6865 2046  e value of the F
│ │ │ │ │ -0000c460: 5052 5f4d 4154 4348 2076 6172 6961 626c  PR_MATCH variabl
│ │ │ │ │ -0000c470: 6520 746f 2074 7275 6520 2831 2920 6966  e to true (1) if
│ │ │ │ │ -0000c480: 2074 6865 2076 616c 7565 0a20 2020 2020   the value.     
│ │ │ │ │ -0000c490: 6f66 2046 5052 206d 6174 6368 6573 2074  of FPR matches t
│ │ │ │ │ -0000c4a0: 6865 2066 696e 6765 7270 7269 6e74 206f  he fingerprint o
│ │ │ │ │ -0000c4b0: 6620 7468 6520 4750 4720 7369 676e 6174  f the GPG signat
│ │ │ │ │ -0000c4c0: 7572 6520 6173 736f 6369 6174 6564 2077  ure associated w
│ │ │ │ │ -0000c4d0: 6974 680a 2020 2020 2074 6865 2063 7572  ith.     the cur
│ │ │ │ │ -0000c4e0: 7265 6e74 2063 6f6e 7465 7874 2e20 204f  rent context.  O
│ │ │ │ │ -0000c4f0: 7468 6572 7769 7365 2c20 4650 525f 4d41  therwise, FPR_MA
│ │ │ │ │ -0000c500: 5443 4820 6973 2073 6574 2074 6f20 6661  TCH is set to fa
│ │ │ │ │ -0000c510: 6c73 6520 2830 292e 0a20 2020 2020 5468  lse (0)..     Th
│ │ │ │ │ -0000c520: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i
│ │ │ │ │ -0000c530: 7320 616e 2046 4b4f 2065 7272 6f72 2073  s an FKO error s
│ │ │ │ │ -0000c540: 7461 7475 732e 0a0a 1f0a 4669 6c65 3a20  tatus.....File: 
│ │ │ │ │ -0000c550: 6c69 6266 6b6f 2e69 6e66 6f2c 2020 4e6f  libfko.info,  No
│ │ │ │ │ -0000c560: 6465 3a20 4572 726f 7220 4861 6e64 6c69  de: Error Handli
│ │ │ │ │ -0000c570: 6e67 2c20 2050 7265 763a 2055 7469 6c69  ng,  Prev: Utili
│ │ │ │ │ -0000c580: 7479 2046 756e 6374 696f 6e73 2c20 2055  ty Functions,  U
│ │ │ │ │ -0000c590: 703a 2055 7369 6e67 206c 6962 666b 6f0a  p: Using libfko.
│ │ │ │ │ -0000c5a0: 0a33 2e37 2045 7272 6f72 2048 616e 646c  .3.7 Error Handl
│ │ │ │ │ -0000c5b0: 696e 670a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ing.============
│ │ │ │ │ -0000c5c0: 3d3d 3d3d 3d3d 0a0a 4d6f 7374 2066 6b6f  ======..Most fko
│ │ │ │ │ -0000c5d0: 2066 756e 6374 696f 6e73 2072 6574 7572   functions retur
│ │ │ │ │ -0000c5e0: 6e20 616e 2069 6e74 6567 6572 2076 616c  n an integer val
│ │ │ │ │ -0000c5f0: 7565 2074 6861 7420 636f 7272 6573 706f  ue that correspo
│ │ │ │ │ -0000c600: 6e64 7320 746f 2065 6974 6865 720a 7375  nds to either.su
│ │ │ │ │ -0000c610: 6363 6573 7320 2830 292c 206f 7220 6f6e  ccess (0), or on
│ │ │ │ │ -0000c620: 6520 6f66 2074 6865 206e 6f6e 2d7a 6572  e of the non-zer
│ │ │ │ │ -0000c630: 6f20 7661 6c75 6573 2074 6861 7220 636f  o values thar co
│ │ │ │ │ -0000c640: 7272 6573 706f 6e64 7320 746f 2061 206e  rresponds to a n
│ │ │ │ │ -0000c650: 756d 6265 720a 6f66 2070 6f73 7369 626c  umber.of possibl
│ │ │ │ │ -0000c660: 6520 6572 726f 7273 2e20 206c 6962 666b  e errors.  libfk
│ │ │ │ │ -0000c670: 6f20 7072 6f76 6964 6573 2061 2066 756e  o provides a fun
│ │ │ │ │ -0000c680: 6374 696f 6e20 746f 2067 6574 2061 2064  ction to get a d
│ │ │ │ │ -0000c690: 6573 6372 6970 7469 7665 0a73 7472 696e  escriptive.strin
│ │ │ │ │ -0000c6a0: 6720 666f 7220 7468 6520 6769 7665 6e20  g for the given 
│ │ │ │ │ -0000c6b0: 6572 726f 7220 636f 6465 2e0a 0a20 2d2d  error code... --
│ │ │ │ │ -0000c6c0: 2046 756e 6374 696f 6e3a 2063 6f6e 7374   Function: const
│ │ │ │ │ -0000c6d0: 2063 6861 7220 2a20 666b 6f5f 6572 7273   char * fko_errs
│ │ │ │ │ -0000c6e0: 7472 2028 696e 7420 4552 525f 434f 4445  tr (int ERR_CODE
│ │ │ │ │ -0000c6f0: 290a 2020 2020 2054 6865 2066 756e 6374  ).     The funct
│ │ │ │ │ -0000c700: 696f 6e20 2766 6b6f 5f65 7272 7374 7227  ion 'fko_errstr'
│ │ │ │ │ -0000c710: 2072 6574 7572 6e73 2061 2070 6f69 6e74   returns a point
│ │ │ │ │ -0000c720: 6572 2074 6f20 6120 7374 6174 6963 616c  er to a statical
│ │ │ │ │ -0000c730: 6c79 0a20 2020 2020 616c 6c6f 6361 7465  ly.     allocate
│ │ │ │ │ -0000c740: 6420 7374 7269 6e67 2063 6f6e 7461 696e  d string contain
│ │ │ │ │ -0000c750: 696e 6720 7468 6520 6465 7363 7269 7074  ing the descript
│ │ │ │ │ -0000c760: 696f 6e20 6f66 2074 6865 2065 7272 6f72  ion of the error
│ │ │ │ │ -0000c770: 2e0a 0a54 6865 206c 6973 7420 6f66 2074  ...The list of t
│ │ │ │ │ -0000c780: 6865 2070 6f73 7369 626c 6520 6572 726f  he possible erro
│ │ │ │ │ -0000c790: 7220 636f 6465 7320 616e 6420 7468 6569  r codes and thei
│ │ │ │ │ -0000c7a0: 7220 636f 7272 6573 706f 6e64 696e 670a  r corresponding.
│ │ │ │ │ -0000c7b0: 6465 7363 7269 7074 696f 6e73 2061 7320  descriptions as 
│ │ │ │ │ -0000c7c0: 7265 7475 726e 6564 2062 7920 2766 6b6f  returned by 'fko
│ │ │ │ │ -0000c7d0: 5f65 7272 7374 7227 2066 6f6c 6c6f 7773  _errstr' follows
│ │ │ │ │ -0000c7e0: 3a0a 0a20 2d2d 2056 6172 6961 626c 653a  :.. -- Variable:
│ │ │ │ │ -0000c7f0: 2069 6e74 2065 7272 6f72 5f63 6f64 650a   int error_code.
│ │ │ │ │ -0000c800: 2020 2020 2027 464b 4f5f 5355 4343 4553       'FKO_SUCCES
│ │ │ │ │ -0000c810: 5327 0a20 2020 2020 2020 2020 2053 7563  S'.          Suc
│ │ │ │ │ -0000c820: 6365 7373 0a20 2020 2020 2746 4b4f 5f45  cess.     'FKO_E
│ │ │ │ │ -0000c830: 5252 4f52 5f43 5458 5f4e 4f54 5f49 4e49  RROR_CTX_NOT_INI
│ │ │ │ │ -0000c840: 5449 414c 495a 4544 270a 2020 2020 2020  TIALIZED'.      
│ │ │ │ │ -0000c850: 2020 2020 464b 4f20 436f 6e74 6578 7420      FKO Context 
│ │ │ │ │ -0000c860: 6973 206e 6f74 2069 6e69 7469 616c 697a  is not initializ
│ │ │ │ │ -0000c870: 6564 0a20 2020 2020 2746 4b4f 5f45 5252  ed.     'FKO_ERR
│ │ │ │ │ -0000c880: 4f52 5f4d 454d 4f52 595f 414c 4c4f 4341  OR_MEMORY_ALLOCA
│ │ │ │ │ -0000c890: 5449 4f4e 270a 2020 2020 2020 2020 2020  TION'.          
│ │ │ │ │ -0000c8a0: 556e 6162 6c65 2074 6f20 616c 6c6f 6361  Unable to alloca
│ │ │ │ │ -0000c8b0: 7465 206d 656d 6f72 790a 2020 2020 2027  te memory.     '
│ │ │ │ │ -0000c8c0: 464b 4f5f 4552 524f 525f 4649 4c45 5359  FKO_ERROR_FILESY
│ │ │ │ │ -0000c8d0: 5354 454d 5f4f 5045 5241 5449 4f4e 270a  STEM_OPERATION'.
│ │ │ │ │ -0000c8e0: 2020 2020 2020 2020 2020 5265 6164 2f77            Read/w
│ │ │ │ │ -0000c8f0: 7269 7465 2062 7974 6573 206d 6973 6d61  rite bytes misma
│ │ │ │ │ -0000c900: 7463 680a 2020 2020 2027 464b 4f5f 4552  tch.     'FKO_ER
│ │ │ │ │ -0000c910: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ -0000c920: 270a 2020 2020 2020 2020 2020 4172 6773  '.          Args
│ │ │ │ │ -0000c930: 2063 6f6e 7461 696e 2069 6e76 616c 6964   contain invalid
│ │ │ │ │ -0000c940: 2064 6174 610a 2020 2020 2027 464b 4f5f   data.     'FKO_
│ │ │ │ │ -0000c950: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ -0000c960: 5441 5f43 4c49 454e 545f 5449 4d45 4f55  TA_CLIENT_TIMEOU
│ │ │ │ │ -0000c970: 545f 4e45 4741 5449 5645 270a 2020 2020  T_NEGATIVE'.    
│ │ │ │ │ -0000c980: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ -0000c990: 7461 3a20 6e65 6761 7469 7665 2074 696d  ta: negative tim
│ │ │ │ │ -0000c9a0: 656f 7574 2076 616c 7565 0a20 2020 2020  eout value.     
│ │ │ │ │ -0000c9b0: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ -0000c9c0: 4944 5f44 4154 415f 4445 434f 4445 5f4d  ID_DATA_DECODE_M
│ │ │ │ │ -0000c9d0: 5347 4c45 4e5f 5641 4c49 4446 4149 4c27  SGLEN_VALIDFAIL'
│ │ │ │ │ -0000c9e0: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ -0000c9f0: 6964 2064 6174 613a 2069 6e76 616c 6964  id data: invalid
│ │ │ │ │ -0000ca00: 206d 6573 7361 6765 206c 656e 6774 680a   message length.
│ │ │ │ │ -0000ca10: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000ca20: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC
│ │ │ │ │ -0000ca30: 4f44 455f 4e4f 4e5f 4153 4349 4927 0a20  ODE_NON_ASCII'. 
│ │ │ │ │ -0000ca40: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ -0000ca50: 2064 6174 613a 2063 6f6e 7461 696e 7320   data: contains 
│ │ │ │ │ -0000ca60: 6e6f 6e2d 6173 6369 6920 6368 6172 6163  non-ascii charac
│ │ │ │ │ -0000ca70: 7465 7273 0a20 2020 2020 2746 4b4f 5f45  ters.     'FKO_E
│ │ │ │ │ -0000ca80: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ -0000ca90: 415f 4445 434f 4445 5f4c 545f 4d49 4e5f  A_DECODE_LT_MIN_
│ │ │ │ │ -0000caa0: 4649 454c 4453 270a 2020 2020 2020 2020  FIELDS'.        
│ │ │ │ │ -0000cab0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ -0000cac0: 696e 7375 6666 6963 6965 6e74 206e 756d  insufficient num
│ │ │ │ │ -0000cad0: 6265 7220 6f66 2064 6174 6120 6669 656c  ber of data fiel
│ │ │ │ │ -0000cae0: 6473 0a20 2020 2020 2746 4b4f 5f45 5252  ds.     'FKO_ERR
│ │ │ │ │ -0000caf0: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_
│ │ │ │ │ -0000cb00: 4445 434f 4445 5f47 545f 4d41 585f 4649  DECODE_GT_MAX_FI
│ │ │ │ │ -0000cb10: 454c 4453 270a 2020 2020 2020 2020 2020  ELDS'.          
│ │ │ │ │ -0000cb20: 496e 7661 6c69 6420 6461 7461 3a20 746f  Invalid data: to
│ │ │ │ │ -0000cb30: 6f20 6d61 6e79 2064 6174 6120 6669 656c  o many data fiel
│ │ │ │ │ -0000cb40: 6473 0a20 2020 2020 2746 4b4f 5f45 5252  ds.     'FKO_ERR
│ │ │ │ │ -0000cb50: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_
│ │ │ │ │ -0000cb60: 4445 434f 4445 5f57 524f 4e47 5f4e 554d  DECODE_WRONG_NUM
│ │ │ │ │ -0000cb70: 5f46 4945 4c44 5327 0a20 2020 2020 2020  _FIELDS'.       
│ │ │ │ │ -0000cb80: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:
│ │ │ │ │ -0000cb90: 2069 6e76 616c 6964 206e 756d 6265 7220   invalid number 
│ │ │ │ │ -0000cba0: 6f66 2066 6965 6c64 730a 2020 2020 2027  of fields.     '
│ │ │ │ │ -0000cbb0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ -0000cbc0: 445f 4441 5441 5f44 4543 4f44 455f 454e  D_DATA_DECODE_EN
│ │ │ │ │ -0000cbd0: 435f 4d53 475f 4c45 4e5f 4d54 5f54 5f53  C_MSG_LEN_MT_T_S
│ │ │ │ │ -0000cbe0: 495a 4527 0a20 2020 2020 2020 2020 2049  IZE'.          I
│ │ │ │ │ -0000cbf0: 6e76 616c 6964 2064 6174 613a 2064 6563  nvalid data: dec
│ │ │ │ │ -0000cc00: 6f64 653a 2065 6e63 6f64 6564 206d 6573  ode: encoded mes
│ │ │ │ │ -0000cc10: 7361 6765 202d 2064 6967 6573 7420 7369  sage - digest si
│ │ │ │ │ -0000cc20: 7a65 2069 7320 6e6f 740a 2020 2020 2020  ze is not.      
│ │ │ │ │ -0000cc30: 2020 2020 7661 6c69 640a 2020 2020 2027      valid.     '
│ │ │ │ │ -0000cc40: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ -0000cc50: 445f 4441 5441 5f44 4543 4f44 455f 5241  D_DATA_DECODE_RA
│ │ │ │ │ -0000cc60: 4e44 5f4d 4953 5349 4e47 270a 2020 2020  ND_MISSING'.    
│ │ │ │ │ -0000cc70: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ -0000cc80: 7461 3a20 6465 636f 6465 3a20 6d69 7373  ta: decode: miss
│ │ │ │ │ -0000cc90: 696e 6720 7261 6e64 6f6d 2064 6174 610a  ing random data.
│ │ │ │ │ -0000cca0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000ccb0: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC
│ │ │ │ │ -0000ccc0: 4f44 455f 5553 4552 4e41 4d45 5f4d 4953  ODE_USERNAME_MIS
│ │ │ │ │ -0000ccd0: 5349 4e47 270a 2020 2020 2020 2020 2020  SING'.          
│ │ │ │ │ -0000cce0: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de
│ │ │ │ │ -0000ccf0: 636f 6465 3a20 6d69 7373 696e 6720 7573  code: missing us
│ │ │ │ │ -0000cd00: 6572 6e61 6d65 0a20 2020 2020 2746 4b4f  ername.     'FKO
│ │ │ │ │ -0000cd10: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ -0000cd20: 4154 415f 4445 434f 4445 5f55 5345 524e  ATA_DECODE_USERN
│ │ │ │ │ -0000cd30: 414d 455f 544f 4f42 4947 270a 2020 2020  AME_TOOBIG'.    
│ │ │ │ │ -0000cd40: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ -0000cd50: 7461 3a20 6465 636f 6465 3a20 7573 6572  ta: decode: user
│ │ │ │ │ -0000cd60: 6e61 6d65 2074 6f20 6c61 7267 650a 2020  name to large.  
│ │ │ │ │ -0000cd70: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ -0000cd80: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD
│ │ │ │ │ -0000cd90: 455f 5553 4552 4e41 4d45 5f44 4543 4f44  E_USERNAME_DECOD
│ │ │ │ │ -0000cda0: 4546 4149 4c27 0a20 2020 2020 2020 2020  EFAIL'.         
│ │ │ │ │ -0000cdb0: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d
│ │ │ │ │ -0000cdc0: 6563 6f64 653a 2066 6169 6c65 6420 746f  ecode: failed to
│ │ │ │ │ -0000cdd0: 2064 6563 6f64 6520 7573 6572 6e61 6d65   decode username
│ │ │ │ │ -0000cde0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -0000cdf0: 5f49 4e56 414c 4944 5f44 4154 415f 4445  _INVALID_DATA_DE
│ │ │ │ │ -0000ce00: 434f 4445 5f55 5345 524e 414d 455f 5641  CODE_USERNAME_VA
│ │ │ │ │ -0000ce10: 4c49 4446 4149 4c27 0a20 2020 2020 2020  LIDFAIL'.       
│ │ │ │ │ -0000ce20: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:
│ │ │ │ │ -0000ce30: 2064 6563 6f64 653a 2069 6e76 616c 6964   decode: invalid
│ │ │ │ │ -0000ce40: 2075 7365 726e 616d 650a 2020 2020 2027   username.     '
│ │ │ │ │ -0000ce50: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ -0000ce60: 445f 4441 5441 5f44 4543 4f44 455f 5449  D_DATA_DECODE_TI
│ │ │ │ │ -0000ce70: 4d45 5354 414d 505f 4d49 5353 494e 4727  MESTAMP_MISSING'
│ │ │ │ │ -0000ce80: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ -0000ce90: 6964 2064 6174 613a 2064 6563 6f64 653a  id data: decode:
│ │ │ │ │ -0000cea0: 206d 6973 7369 6e67 2074 696d 6573 7461   missing timesta
│ │ │ │ │ -0000ceb0: 6d70 0a20 2020 2020 2746 4b4f 5f45 5252  mp.     'FKO_ERR
│ │ │ │ │ -0000cec0: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_
│ │ │ │ │ -0000ced0: 4445 434f 4445 5f54 494d 4553 5441 4d50  DECODE_TIMESTAMP
│ │ │ │ │ -0000cee0: 5f54 4f4f 4249 4727 0a20 2020 2020 2020  _TOOBIG'.       
│ │ │ │ │ -0000cef0: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:
│ │ │ │ │ -0000cf00: 2064 6563 6f64 653a 2074 696d 6573 7461   decode: timesta
│ │ │ │ │ -0000cf10: 6d70 2074 6f6f 206c 6172 6765 0a20 2020  mp too large.   
│ │ │ │ │ -0000cf20: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ -0000cf30: 414c 4944 5f44 4154 415f 4445 434f 4445  ALID_DATA_DECODE
│ │ │ │ │ -0000cf40: 5f54 494d 4553 5441 4d50 5f44 4543 4f44  _TIMESTAMP_DECOD
│ │ │ │ │ -0000cf50: 4546 4149 4c27 0a20 2020 2020 2020 2020  EFAIL'.         
│ │ │ │ │ -0000cf60: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d
│ │ │ │ │ -0000cf70: 6563 6f64 653a 2066 6169 6c65 6420 746f  ecode: failed to
│ │ │ │ │ -0000cf80: 2064 6563 6f64 6520 7469 6d65 7374 616d   decode timestam
│ │ │ │ │ -0000cf90: 700a 2020 2020 2027 464b 4f5f 4552 524f  p.     'FKO_ERRO
│ │ │ │ │ -0000cfa0: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D
│ │ │ │ │ -0000cfb0: 4543 4f44 455f 5645 5253 494f 4e5f 4d49  ECODE_VERSION_MI
│ │ │ │ │ -0000cfc0: 5353 494e 4727 0a20 2020 2020 2020 2020  SSING'.         
│ │ │ │ │ -0000cfd0: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d
│ │ │ │ │ -0000cfe0: 6563 6f64 653a 206d 6973 7369 6e67 2076  ecode: missing v
│ │ │ │ │ -0000cff0: 6572 7369 6f6e 2064 6174 610a 2020 2020  ersion data.    
│ │ │ │ │ -0000d000: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ -0000d010: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_
│ │ │ │ │ -0000d020: 5645 5253 494f 4e5f 544f 4f42 4947 270a  VERSION_TOOBIG'.
│ │ │ │ │ -0000d030: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ -0000d040: 6420 6461 7461 3a20 6465 636f 6465 3a20  d data: decode: 
│ │ │ │ │ -0000d050: 7665 7273 696f 6e20 6461 7461 2069 7320  version data is 
│ │ │ │ │ -0000d060: 746f 6f20 6c61 7267 650a 2020 2020 2027  too large.     '
│ │ │ │ │ -0000d070: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ -0000d080: 445f 4441 5441 5f44 4543 4f44 455f 4d53  D_DATA_DECODE_MS
│ │ │ │ │ -0000d090: 4754 5950 455f 4d49 5353 494e 4727 0a20  GTYPE_MISSING'. 
│ │ │ │ │ -0000d0a0: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ -0000d0b0: 2064 6174 613a 2064 6563 6f64 653a 206d   data: decode: m
│ │ │ │ │ -0000d0c0: 6973 7369 6e67 206d 6573 7361 6765 2074  issing message t
│ │ │ │ │ -0000d0d0: 7970 650a 2020 2020 2027 464b 4f5f 4552  ype.     'FKO_ER
│ │ │ │ │ -0000d0e0: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ -0000d0f0: 5f44 4543 4f44 455f 4d53 4754 5950 455f  _DECODE_MSGTYPE_
│ │ │ │ │ -0000d100: 544f 4f42 4947 270a 2020 2020 2020 2020  TOOBIG'.        
│ │ │ │ │ -0000d110: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ -0000d120: 6465 636f 6465 3a20 6d65 7373 6167 6520  decode: message 
│ │ │ │ │ -0000d130: 7479 7065 2069 7320 746f 6f20 6c61 7267  type is too larg
│ │ │ │ │ -0000d140: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO
│ │ │ │ │ -0000d150: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D
│ │ │ │ │ -0000d160: 4543 4f44 455f 4d53 4754 5950 455f 4445  ECODE_MSGTYPE_DE
│ │ │ │ │ -0000d170: 434f 4445 4641 494c 270a 2020 2020 2020  CODEFAIL'.      
│ │ │ │ │ -0000d180: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ -0000d190: 3a20 6465 636f 6465 3a20 6661 696c 6564  : decode: failed
│ │ │ │ │ -0000d1a0: 2074 6f20 6465 636f 6465 206d 6573 7361   to decode messa
│ │ │ │ │ -0000d1b0: 6765 2074 7970 650a 2020 2020 2027 464b  ge type.     'FK
│ │ │ │ │ -0000d1c0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ -0000d1d0: 4441 5441 5f44 4543 4f44 455f 4d45 5353  DATA_DECODE_MESS
│ │ │ │ │ -0000d1e0: 4147 455f 4d49 5353 494e 4727 0a20 2020  AGE_MISSING'.   
│ │ │ │ │ -0000d1f0: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d
│ │ │ │ │ -0000d200: 6174 613a 2064 6563 6f64 653a 206d 6973  ata: decode: mis
│ │ │ │ │ -0000d210: 7369 6e67 206d 6573 7361 6765 2064 6174  sing message dat
│ │ │ │ │ -0000d220: 610a 2020 2020 2027 464b 4f5f 4552 524f  a.     'FKO_ERRO
│ │ │ │ │ -0000d230: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D
│ │ │ │ │ -0000d240: 4543 4f44 455f 4d45 5353 4147 455f 544f  ECODE_MESSAGE_TO
│ │ │ │ │ -0000d250: 4f42 4947 270a 2020 2020 2020 2020 2020  OBIG'.          
│ │ │ │ │ -0000d260: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de
│ │ │ │ │ -0000d270: 636f 6465 3a20 6d65 7373 6167 6520 6461  code: message da
│ │ │ │ │ -0000d280: 7461 2069 7320 746f 6f20 6c61 7267 650a  ta is too large.
│ │ │ │ │ -0000d290: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000d2a0: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC
│ │ │ │ │ -0000d2b0: 4f44 455f 4d45 5353 4147 455f 4445 434f  ODE_MESSAGE_DECO
│ │ │ │ │ -0000d2c0: 4445 4641 494c 270a 2020 2020 2020 2020  DEFAIL'.        
│ │ │ │ │ -0000d2d0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ -0000d2e0: 6465 636f 6465 3a20 6661 696c 6564 2074  decode: failed t
│ │ │ │ │ -0000d2f0: 6f20 6465 636f 6465 206d 6573 7361 6765  o decode message
│ │ │ │ │ -0000d300: 2064 6174 610a 2020 2020 2027 464b 4f5f   data.     'FKO_
│ │ │ │ │ -0000d310: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ -0000d320: 5441 5f44 4543 4f44 455f 4d45 5353 4147  TA_DECODE_MESSAG
│ │ │ │ │ -0000d330: 455f 5641 4c49 4446 4149 4c27 0a20 2020  E_VALIDFAIL'.   
│ │ │ │ │ -0000d340: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d
│ │ │ │ │ -0000d350: 6174 613a 2064 6563 6f64 653a 2069 6e76  ata: decode: inv
│ │ │ │ │ -0000d360: 616c 6964 206d 6573 7361 6765 2064 6174  alid message dat
│ │ │ │ │ -0000d370: 610a 2020 2020 2027 464b 4f5f 4552 524f  a.     'FKO_ERRO
│ │ │ │ │ -0000d380: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D
│ │ │ │ │ -0000d390: 4543 4f44 455f 4143 4345 5353 5f56 414c  ECODE_ACCESS_VAL
│ │ │ │ │ -0000d3a0: 4944 4641 494c 270a 2020 2020 2020 2020  IDFAIL'.        
│ │ │ │ │ -0000d3b0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ -0000d3c0: 6465 636f 6465 3a20 696e 766c 6961 6420  decode: invliad 
│ │ │ │ │ -0000d3d0: 6163 6365 7373 2064 6174 610a 2020 2020  access data.    
│ │ │ │ │ -0000d3e0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ -0000d3f0: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_
│ │ │ │ │ -0000d400: 4e41 5441 4343 4553 535f 4d49 5353 494e  NATACCESS_MISSIN
│ │ │ │ │ -0000d410: 4727 0a20 2020 2020 2020 2020 2049 6e76  G'.          Inv
│ │ │ │ │ -0000d420: 616c 6964 2064 6174 613a 2064 6563 6f64  alid data: decod
│ │ │ │ │ -0000d430: 653a 206d 6973 7369 6e67 204e 4154 2061  e: missing NAT a
│ │ │ │ │ -0000d440: 6363 6573 7320 6461 7461 0a20 2020 2020  ccess data.     
│ │ │ │ │ -0000d450: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ -0000d460: 4944 5f44 4154 415f 4445 434f 4445 5f4e  ID_DATA_DECODE_N
│ │ │ │ │ -0000d470: 4154 4143 4345 5353 5f54 4f4f 4249 4727  ATACCESS_TOOBIG'
│ │ │ │ │ -0000d480: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ -0000d490: 6964 2064 6174 613a 2064 6563 6f64 653a  id data: decode:
│ │ │ │ │ -0000d4a0: 204e 4154 2061 6363 6573 7320 6461 7461   NAT access data
│ │ │ │ │ -0000d4b0: 2069 7320 746f 6f20 6c61 7267 650a 2020   is too large.  
│ │ │ │ │ -0000d4c0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ -0000d4d0: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD
│ │ │ │ │ -0000d4e0: 455f 4e41 5441 4343 4553 535f 4445 434f  E_NATACCESS_DECO
│ │ │ │ │ -0000d4f0: 4445 4641 494c 270a 2020 2020 2020 2020  DEFAIL'.        
│ │ │ │ │ -0000d500: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ -0000d510: 6465 636f 6465 3a20 6661 696c 6564 2074  decode: failed t
│ │ │ │ │ -0000d520: 6f20 6465 636f 6465 204e 4154 2061 6363  o decode NAT acc
│ │ │ │ │ -0000d530: 6573 7320 6461 7461 0a20 2020 2020 2746  ess data.     'F
│ │ │ │ │ -0000d540: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ -0000d550: 5f44 4154 415f 4445 434f 4445 5f4e 4154  _DATA_DECODE_NAT
│ │ │ │ │ -0000d560: 4143 4345 5353 5f56 414c 4944 4641 494c  ACCESS_VALIDFAIL
│ │ │ │ │ -0000d570: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva
│ │ │ │ │ -0000d580: 6c69 6420 6461 7461 3a20 6465 636f 6465  lid data: decode
│ │ │ │ │ -0000d590: 3a20 696e 7661 6c69 6420 4e41 5420 6163  : invalid NAT ac
│ │ │ │ │ -0000d5a0: 6365 7373 0a20 2020 2020 2746 4b4f 5f45  cess.     'FKO_E
│ │ │ │ │ -0000d5b0: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ -0000d5c0: 415f 4445 434f 4445 5f53 5256 4155 5448  A_DECODE_SRVAUTH
│ │ │ │ │ -0000d5d0: 5f4d 4953 5349 4e47 270a 2020 2020 2020  _MISSING'.      
│ │ │ │ │ -0000d5e0: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ -0000d5f0: 3a20 6465 636f 6465 3a20 6d69 7373 696e  : decode: missin
│ │ │ │ │ -0000d600: 6720 7365 7276 6572 2061 7574 680a 2020  g server auth.  
│ │ │ │ │ -0000d610: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ -0000d620: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD
│ │ │ │ │ -0000d630: 455f 5352 5641 5554 485f 4445 434f 4445  E_SRVAUTH_DECODE
│ │ │ │ │ -0000d640: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          
│ │ │ │ │ -0000d650: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de
│ │ │ │ │ -0000d660: 636f 6465 3a20 7365 7276 6572 2061 7574  code: server aut
│ │ │ │ │ -0000d670: 6820 6465 636f 6465 2066 6169 6c0a 2020  h decode fail.  
│ │ │ │ │ -0000d680: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ -0000d690: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD
│ │ │ │ │ -0000d6a0: 455f 5350 415f 4558 5452 415f 544f 4f42  E_SPA_EXTRA_TOOB
│ │ │ │ │ -0000d6b0: 4947 270a 2020 2020 2020 2020 2020 496e  IG'.          In
│ │ │ │ │ -0000d6c0: 7661 6c69 6420 6461 7461 3a20 6465 636f  valid data: deco
│ │ │ │ │ -0000d6d0: 6465 3a20 5350 4120 6578 7472 6120 746f  de: SPA extra to
│ │ │ │ │ -0000d6e0: 6f20 6c61 7267 650a 2020 2020 2027 464b  o large.     'FK
│ │ │ │ │ -0000d6f0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ -0000d700: 4441 5441 5f44 4543 4f44 455f 4558 5452  DATA_DECODE_EXTR
│ │ │ │ │ -0000d710: 415f 544f 4f42 4947 270a 2020 2020 2020  A_TOOBIG'.      
│ │ │ │ │ -0000d720: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ -0000d730: 3a20 6465 636f 6465 3a20 6578 7472 6120  : decode: extra 
│ │ │ │ │ -0000d740: 746f 6f20 6c61 7267 650a 2020 2020 2027  too large.     '
│ │ │ │ │ -0000d750: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ -0000d760: 445f 4441 5441 5f44 4543 4f44 455f 4558  D_DATA_DECODE_EX
│ │ │ │ │ -0000d770: 5452 415f 4445 434f 4445 4641 494c 270a  TRA_DECODEFAIL'.
│ │ │ │ │ -0000d780: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ -0000d790: 6420 6461 7461 3a20 6465 636f 6465 3a20  d data: decode: 
│ │ │ │ │ -0000d7a0: 6578 7472 6120 6465 636f 6465 2066 6169  extra decode fai
│ │ │ │ │ -0000d7b0: 6c65 640a 2020 2020 2027 464b 4f5f 4552  led.     'FKO_ER
│ │ │ │ │ -0000d7c0: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ -0000d7d0: 5f44 4543 4f44 455f 5449 4d45 4f55 545f  _DECODE_TIMEOUT_
│ │ │ │ │ -0000d7e0: 4d49 5353 494e 4727 0a20 2020 2020 2020  MISSING'.       
│ │ │ │ │ -0000d7f0: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:
│ │ │ │ │ -0000d800: 2064 6563 6f64 653a 206d 6973 7369 6e67   decode: missing
│ │ │ │ │ -0000d810: 2074 696d 656f 7574 0a20 2020 2020 2746   timeout.     'F
│ │ │ │ │ -0000d820: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ -0000d830: 5f44 4154 415f 4445 434f 4445 5f54 494d  _DATA_DECODE_TIM
│ │ │ │ │ -0000d840: 454f 5554 5f54 4f4f 4249 4727 0a20 2020  EOUT_TOOBIG'.   
│ │ │ │ │ -0000d850: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d
│ │ │ │ │ -0000d860: 6174 613a 2064 6563 6f64 6520 7469 6d65  ata: decode time
│ │ │ │ │ -0000d870: 6f75 7420 7661 6c75 6520 6973 2074 6f6f  out value is too
│ │ │ │ │ -0000d880: 206c 6172 6765 0a20 2020 2020 2746 4b4f   large.     'FKO
│ │ │ │ │ -0000d890: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ -0000d8a0: 4154 415f 4445 434f 4445 5f54 494d 454f  ATA_DECODE_TIMEO
│ │ │ │ │ -0000d8b0: 5554 5f56 414c 4944 4641 494c 270a 2020  UT_VALIDFAIL'.  
│ │ │ │ │ -0000d8c0: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ -0000d8d0: 6461 7461 3a20 6465 636f 6465 2069 6e76  data: decode inv
│ │ │ │ │ -0000d8e0: 616c 6964 2074 696d 656f 7574 0a20 2020  alid timeout.   
│ │ │ │ │ -0000d8f0: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ -0000d900: 414c 4944 5f44 4154 415f 4445 434f 4445  ALID_DATA_DECODE
│ │ │ │ │ -0000d910: 5f54 494d 454f 5554 5f44 4543 4f44 4546  _TIMEOUT_DECODEF
│ │ │ │ │ -0000d920: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I
│ │ │ │ │ -0000d930: 6e76 616c 6964 2064 6174 613a 2064 6563  nvalid data: dec
│ │ │ │ │ -0000d940: 6f64 653a 2074 696d 656f 7574 2064 6563  ode: timeout dec
│ │ │ │ │ -0000d950: 6f64 6520 6661 696c 6564 0a20 2020 2020  ode failed.     
│ │ │ │ │ -0000d960: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ -0000d970: 4944 5f44 4154 415f 454e 434f 4445 5f4d  ID_DATA_ENCODE_M
│ │ │ │ │ -0000d980: 4553 5341 4745 5f54 4f4f 4249 4727 0a20  ESSAGE_TOOBIG'. 
│ │ │ │ │ -0000d990: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ -0000d9a0: 2064 6174 613a 2065 6e63 6f64 653a 206d   data: encode: m
│ │ │ │ │ -0000d9b0: 6573 7361 6765 2069 7320 746f 6f20 6c61  essage is too la
│ │ │ │ │ -0000d9c0: 7267 650a 2020 2020 2027 464b 4f5f 4552  rge.     'FKO_ER
│ │ │ │ │ -0000d9d0: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ -0000d9e0: 5f45 4e43 4f44 455f 4d53 474c 454e 5f56  _ENCODE_MSGLEN_V
│ │ │ │ │ -0000d9f0: 414c 4944 4641 494c 270a 2020 2020 2020  ALIDFAIL'.      
│ │ │ │ │ -0000da00: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ -0000da10: 3a20 656e 636f 6465 3a20 696e 7661 6c69  : encode: invali
│ │ │ │ │ -0000da20: 6420 6d65 7373 6167 6520 6c65 6e67 7468  d message length
│ │ │ │ │ -0000da30: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -0000da40: 5f49 4e56 414c 4944 5f44 4154 415f 454e  _INVALID_DATA_EN
│ │ │ │ │ -0000da50: 434f 4445 5f44 4947 4553 545f 5641 4c49  CODE_DIGEST_VALI
│ │ │ │ │ -0000da60: 4446 4149 4c27 0a20 2020 2020 2020 2020  DFAIL'.         
│ │ │ │ │ -0000da70: 2049 6e76 616c 6964 2064 6174 613a 2065   Invalid data: e
│ │ │ │ │ -0000da80: 6e63 6f64 653a 2069 6e76 616c 6964 2064  ncode: invalid d
│ │ │ │ │ -0000da90: 6967 6573 740a 2020 2020 2027 464b 4f5f  igest.     'FKO_
│ │ │ │ │ -0000daa0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ -0000dab0: 5441 5f45 4e43 4f44 455f 4449 4745 5354  TA_ENCODE_DIGEST
│ │ │ │ │ -0000dac0: 5f54 4f4f 4249 4727 0a20 2020 2020 2020  _TOOBIG'.       
│ │ │ │ │ -0000dad0: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:
│ │ │ │ │ -0000dae0: 2065 6e63 6f64 653a 2064 6967 6573 7420   encode: digest 
│ │ │ │ │ -0000daf0: 6973 2074 6f6f 206c 6172 6765 0a20 2020  is too large.   
│ │ │ │ │ -0000db00: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ -0000db10: 414c 4944 5f44 4154 415f 454e 434f 4445  ALID_DATA_ENCODE
│ │ │ │ │ -0000db20: 5f4e 4f54 4241 5345 3634 270a 2020 2020  _NOTBASE64'.    
│ │ │ │ │ -0000db30: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ -0000db40: 7461 3a20 656e 636f 6465 6420 6461 7461  ta: encoded data
│ │ │ │ │ -0000db50: 2069 7320 6e6f 7420 4261 7365 3634 0a20   is not Base64. 
│ │ │ │ │ -0000db60: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ -0000db70: 4e56 414c 4944 5f44 4154 415f 454e 4352  NVALID_DATA_ENCR
│ │ │ │ │ -0000db80: 5950 545f 4d53 474c 454e 5f56 414c 4944  YPT_MSGLEN_VALID
│ │ │ │ │ -0000db90: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          
│ │ │ │ │ -0000dba0: 496e 7661 6c69 6420 6461 7461 3a20 656e  Invalid data: en
│ │ │ │ │ -0000dbb0: 6372 7970 743a 2069 6e76 616c 6964 206d  crypt: invalid m
│ │ │ │ │ -0000dbc0: 6573 7361 6765 206c 656e 6774 680a 2020  essage length.  
│ │ │ │ │ -0000dbd0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ -0000dbe0: 5641 4c49 445f 4441 5441 5f45 4e43 5259  VALID_DATA_ENCRY
│ │ │ │ │ -0000dbf0: 5054 5f44 4947 4553 544c 454e 5f56 414c  PT_DIGESTLEN_VAL
│ │ │ │ │ -0000dc00: 4944 4641 494c 270a 2020 2020 2020 2020  IDFAIL'.        
│ │ │ │ │ -0000dc10: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ -0000dc20: 656e 6372 7970 743a 2069 6e76 616c 6964  encrypt: invalid
│ │ │ │ │ -0000dc30: 2064 6967 6573 7420 6c65 6e67 7468 0a20   digest length. 
│ │ │ │ │ -0000dc40: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ -0000dc50: 4e56 414c 4944 5f44 4154 415f 454e 4352  NVALID_DATA_ENCR
│ │ │ │ │ -0000dc60: 5950 545f 5054 4c45 4e5f 5641 4c49 4446  YPT_PTLEN_VALIDF
│ │ │ │ │ -0000dc70: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I
│ │ │ │ │ -0000dc80: 6e76 616c 6964 2064 6174 613a 2065 6e63  nvalid data: enc
│ │ │ │ │ -0000dc90: 7279 7074 3a20 696e 7661 6c69 6420 706c  rypt: invalid pl
│ │ │ │ │ -0000dca0: 6169 6e74 6578 7420 6c65 6e67 7468 0a20  aintext length. 
│ │ │ │ │ -0000dcb0: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ -0000dcc0: 4e56 414c 4944 5f44 4154 415f 454e 4352  NVALID_DATA_ENCR
│ │ │ │ │ -0000dcd0: 5950 545f 5245 5355 4c54 5f4d 5347 4c45  YPT_RESULT_MSGLE
│ │ │ │ │ -0000dce0: 4e5f 5641 4c49 4446 4149 4c27 0a20 2020  N_VALIDFAIL'.   
│ │ │ │ │ -0000dcf0: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d
│ │ │ │ │ -0000dd00: 6174 613a 2065 6e63 7279 7074 3a20 696e  ata: encrypt: in
│ │ │ │ │ -0000dd10: 7661 6c69 6420 656e 6372 7970 7420 7265  valid encrypt re
│ │ │ │ │ -0000dd20: 7375 6c74 206d 6573 7361 6765 206c 656e  sult message len
│ │ │ │ │ -0000dd30: 6774 680a 2020 2020 2027 464b 4f5f 4552  gth.     'FKO_ER
│ │ │ │ │ -0000dd40: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ -0000dd50: 5f45 4e43 5259 5054 5f43 4950 4845 524c  _ENCRYPT_CIPHERL
│ │ │ │ │ -0000dd60: 454e 5f44 4543 4f44 4546 4149 4c27 0a20  EN_DECODEFAIL'. 
│ │ │ │ │ -0000dd70: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ -0000dd80: 2064 6174 613a 2065 6e63 7279 7074 3a20   data: encrypt: 
│ │ │ │ │ -0000dd90: 6465 636f 6465 2063 6970 6865 7220 6c65  decode cipher le
│ │ │ │ │ -0000dda0: 6e67 7468 2066 6169 6c65 640a 2020 2020  ngth failed.    
│ │ │ │ │ -0000ddb0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ -0000ddc0: 4c49 445f 4441 5441 5f45 4e43 5259 5054  LID_DATA_ENCRYPT
│ │ │ │ │ -0000ddd0: 5f43 4950 4845 524c 454e 5f56 414c 4944  _CIPHERLEN_VALID
│ │ │ │ │ -0000dde0: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          
│ │ │ │ │ -0000ddf0: 496e 7661 6c69 6420 6461 7461 3a20 656e  Invalid data: en
│ │ │ │ │ -0000de00: 6372 7970 743a 2069 6e76 616c 6964 2063  crypt: invalid c
│ │ │ │ │ -0000de10: 6970 6865 7220 6c65 6e67 7468 0a20 2020  ipher length.   
│ │ │ │ │ -0000de20: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ -0000de30: 414c 4944 5f44 4154 415f 454e 4352 5950  ALID_DATA_ENCRYP
│ │ │ │ │ -0000de40: 545f 4445 4352 5950 5445 445f 4d45 5353  T_DECRYPTED_MESS
│ │ │ │ │ -0000de50: 4147 455f 4d49 5353 494e 4727 0a20 2020  AGE_MISSING'.   
│ │ │ │ │ -0000de60: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d
│ │ │ │ │ -0000de70: 6174 613a 2065 6e63 7279 7074 3a20 6d69  ata: encrypt: mi
│ │ │ │ │ -0000de80: 7373 696e 6720 6465 6372 7970 7465 6420  ssing decrypted 
│ │ │ │ │ -0000de90: 6d65 7373 6167 650a 2020 2020 2027 464b  message.     'FK
│ │ │ │ │ -0000dea0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ -0000deb0: 4441 5441 5f45 4e43 5259 5054 5f44 4543  DATA_ENCRYPT_DEC
│ │ │ │ │ -0000dec0: 5259 5054 4544 5f4d 5347 4c45 4e5f 5641  RYPTED_MSGLEN_VA
│ │ │ │ │ -0000ded0: 4c49 4446 4149 4c27 0a20 2020 2020 2020  LIDFAIL'.       
│ │ │ │ │ -0000dee0: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:
│ │ │ │ │ -0000def0: 2065 6e63 7279 7074 3a20 696e 7661 6c69   encrypt: invali
│ │ │ │ │ -0000df00: 6420 6465 6372 7970 7465 6420 6d65 7373  d decrypted mess
│ │ │ │ │ -0000df10: 6167 6520 6c65 6e67 7468 0a20 2020 2020  age length.     
│ │ │ │ │ -0000df20: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ -0000df30: 4944 5f44 4154 415f 454e 4352 5950 545f  ID_DATA_ENCRYPT_
│ │ │ │ │ -0000df40: 5459 5045 5f56 414c 4944 4641 494c 270a  TYPE_VALIDFAIL'.
│ │ │ │ │ -0000df50: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ -0000df60: 6420 6461 7461 3a20 656e 6372 7970 743a  d data: encrypt:
│ │ │ │ │ -0000df70: 2069 6e76 616c 6964 2065 6e63 7279 7074   invalid encrypt
│ │ │ │ │ -0000df80: 696f 6e20 7479 7065 0a20 2020 2020 2746  ion type.     'F
│ │ │ │ │ -0000df90: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ -0000dfa0: 5f44 4154 415f 454e 4352 5950 545f 4d4f  _DATA_ENCRYPT_MO
│ │ │ │ │ -0000dfb0: 4445 5f56 414c 4944 4641 494c 270a 2020  DE_VALIDFAIL'.  
│ │ │ │ │ -0000dfc0: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ -0000dfd0: 6461 7461 3a20 656e 6372 7970 743a 2069  data: encrypt: i
│ │ │ │ │ -0000dfe0: 6e76 616c 6964 2065 6e63 7279 7074 696f  nvalid encryptio
│ │ │ │ │ -0000dff0: 6e20 6d6f 6465 0a20 2020 2020 2746 4b4f  n mode.     'FKO
│ │ │ │ │ -0000e000: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ -0000e010: 4154 415f 454e 4352 5950 545f 5459 5045  ATA_ENCRYPT_TYPE
│ │ │ │ │ -0000e020: 5f55 4e4b 4e4f 574e 270a 2020 2020 2020  _UNKNOWN'.      
│ │ │ │ │ -0000e030: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ -0000e040: 3a20 656e 6372 7970 743a 2075 6e6b 6e6f  : encrypt: unkno
│ │ │ │ │ -0000e050: 776e 2065 6e63 7279 7074 696f 6e20 7479  wn encryption ty
│ │ │ │ │ -0000e060: 7065 0a20 2020 2020 2746 4b4f 5f45 5252  pe.     'FKO_ERR
│ │ │ │ │ -0000e070: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_
│ │ │ │ │ -0000e080: 4655 4e43 535f 4e45 575f 454e 434d 5347  FUNCS_NEW_ENCMSG
│ │ │ │ │ -0000e090: 5f4d 4953 5349 4e47 270a 2020 2020 2020  _MISSING'.      
│ │ │ │ │ -0000e0a0: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ -0000e0b0: 3a20 6d69 7373 696e 6720 656e 636f 6465  : missing encode
│ │ │ │ │ -0000e0c0: 6420 6d65 7373 6167 650a 2020 2020 2027  d message.     '
│ │ │ │ │ -0000e0d0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ -0000e0e0: 445f 4441 5441 5f46 554e 4353 5f4e 4557  D_DATA_FUNCS_NEW
│ │ │ │ │ -0000e0f0: 5f4d 5347 4c45 4e5f 5641 4c49 4446 4149  _MSGLEN_VALIDFAI
│ │ │ │ │ -0000e100: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv
│ │ │ │ │ -0000e110: 616c 6964 2064 6174 613a 2069 6e76 616c  alid data: inval
│ │ │ │ │ -0000e120: 6964 206d 6573 7361 6765 206c 656e 6774  id message lengt
│ │ │ │ │ -0000e130: 6820 6672 6f6d 206e 6577 0a20 2020 2020  h from new.     
│ │ │ │ │ -0000e140: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ -0000e150: 4944 5f44 4154 415f 4655 4e43 535f 4745  ID_DATA_FUNCS_GE
│ │ │ │ │ -0000e160: 4e5f 4b45 594c 454e 5f56 414c 4944 4641  N_KEYLEN_VALIDFA
│ │ │ │ │ -0000e170: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In
│ │ │ │ │ -0000e180: 7661 6c69 6420 6461 7461 3a20 696e 7661  valid data: inva
│ │ │ │ │ -0000e190: 6c69 6420 6b65 7920 6c65 6e67 7468 2066  lid key length f
│ │ │ │ │ -0000e1a0: 726f 6d20 6765 6e5f 6b65 796c 656e 0a20  rom gen_keylen. 
│ │ │ │ │ -0000e1b0: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ -0000e1c0: 4e56 414c 4944 5f44 4154 415f 4655 4e43  NVALID_DATA_FUNC
│ │ │ │ │ -0000e1d0: 535f 4745 4e5f 484d 4143 4c45 4e5f 5641  S_GEN_HMACLEN_VA
│ │ │ │ │ -0000e1e0: 4c49 4446 4149 4c27 0a20 2020 2020 2020  LIDFAIL'.       
│ │ │ │ │ -0000e1f0: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:
│ │ │ │ │ -0000e200: 2067 656e 5f68 6d61 636c 656e 2066 6169   gen_hmaclen fai
│ │ │ │ │ -0000e210: 6c75 7265 0a20 2020 2020 2746 4b4f 5f45  lure.     'FKO_E
│ │ │ │ │ -0000e220: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ -0000e230: 415f 4655 4e43 535f 4745 4e5f 4b45 595f  A_FUNCS_GEN_KEY_
│ │ │ │ │ -0000e240: 454e 434f 4445 4641 494c 270a 2020 2020  ENCODEFAIL'.    
│ │ │ │ │ -0000e250: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ -0000e260: 7461 3a20 6765 6e5f 6b65 793a 2065 6e63  ta: gen_key: enc
│ │ │ │ │ -0000e270: 6f64 6520 6661 696c 7572 650a 2020 2020  ode failure.    
│ │ │ │ │ -0000e280: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ -0000e290: 4c49 445f 4441 5441 5f46 554e 4353 5f47  LID_DATA_FUNCS_G
│ │ │ │ │ -0000e2a0: 454e 5f48 4d41 435f 454e 434f 4445 4641  EN_HMAC_ENCODEFA
│ │ │ │ │ -0000e2b0: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In
│ │ │ │ │ -0000e2c0: 7661 6c69 6420 6461 7461 3a20 6765 6e5f  valid data: gen_
│ │ │ │ │ -0000e2d0: 686d 6163 3a20 656e 636f 6465 2066 6169  hmac: encode fai
│ │ │ │ │ -0000e2e0: 6c75 7265 0a20 2020 2020 2746 4b4f 5f45  lure.     'FKO_E
│ │ │ │ │ -0000e2f0: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ -0000e300: 415f 4655 4e43 535f 5345 545f 4d53 474c  A_FUNCS_SET_MSGL
│ │ │ │ │ -0000e310: 454e 5f56 414c 4944 4641 494c 270a 2020  EN_VALIDFAIL'.  
│ │ │ │ │ -0000e320: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ -0000e330: 6461 7461 3a20 7365 745f 7370 615f 6461  data: set_spa_da
│ │ │ │ │ -0000e340: 7461 3a20 696e 7661 6c69 6420 6d65 7373  ta: invalid mess
│ │ │ │ │ -0000e350: 6167 6520 6c65 6e67 7468 0a20 2020 2020  age length.     
│ │ │ │ │ -0000e360: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ -0000e370: 4944 5f44 4154 415f 484d 4143 5f4d 5347  ID_DATA_HMAC_MSG
│ │ │ │ │ -0000e380: 4c45 4e5f 5641 4c49 4446 4149 4c27 0a20  LEN_VALIDFAIL'. 
│ │ │ │ │ -0000e390: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ -0000e3a0: 2064 6174 613a 2069 6e76 616c 6964 2048   data: invalid H
│ │ │ │ │ -0000e3b0: 4d41 4320 6d73 676c 656e 0a20 2020 2020  MAC msglen.     
│ │ │ │ │ -0000e3c0: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ -0000e3d0: 4944 5f44 4154 415f 484d 4143 5f45 4e43  ID_DATA_HMAC_ENC
│ │ │ │ │ -0000e3e0: 4d53 474c 454e 5f56 414c 4944 4641 494c  MSGLEN_VALIDFAIL
│ │ │ │ │ -0000e3f0: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva
│ │ │ │ │ -0000e400: 6c69 6420 6461 7461 3a20 696e 7661 6c69  lid data: invali
│ │ │ │ │ -0000e410: 6420 6c65 6e67 7468 2066 6f72 2065 6e63  d length for enc
│ │ │ │ │ -0000e420: 7279 7074 6564 206d 6573 7361 6765 0a20  rypted message. 
│ │ │ │ │ -0000e430: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ -0000e440: 4e56 414c 4944 5f44 4154 415f 484d 4143  NVALID_DATA_HMAC
│ │ │ │ │ -0000e450: 5f43 4f4d 5041 5245 4641 494c 270a 2020  _COMPAREFAIL'.  
│ │ │ │ │ -0000e460: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ -0000e470: 6461 7461 3a20 484d 4143 2063 6f6d 7061  data: HMAC compa
│ │ │ │ │ -0000e480: 7269 736f 6e20 6661 696c 6564 0a20 2020  rison failed.   
│ │ │ │ │ -0000e490: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ -0000e4a0: 414c 4944 5f44 4154 415f 484d 4143 5f54  ALID_DATA_HMAC_T
│ │ │ │ │ -0000e4b0: 5950 455f 5641 4c49 4446 4149 4c27 0a20  YPE_VALIDFAIL'. 
│ │ │ │ │ -0000e4c0: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ -0000e4d0: 2064 6174 613a 2069 6e76 616c 6964 2048   data: invalid H
│ │ │ │ │ -0000e4e0: 4d41 4320 7479 7065 0a20 2020 2020 2746  MAC type.     'F
│ │ │ │ │ -0000e4f0: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ -0000e500: 5f44 4154 415f 484d 4143 5f4c 454e 5f56  _DATA_HMAC_LEN_V
│ │ │ │ │ -0000e510: 414c 4944 4641 494c 270a 2020 2020 2020  ALIDFAIL'.      
│ │ │ │ │ -0000e520: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ -0000e530: 3a20 696e 7661 6c69 6420 484d 4143 206c  : invalid HMAC l
│ │ │ │ │ -0000e540: 656e 6774 680a 2020 2020 2027 464b 4f5f  ength.     'FKO_
│ │ │ │ │ -0000e550: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ -0000e560: 5441 5f4d 4553 5341 4745 5f50 4f52 545f  TA_MESSAGE_PORT_
│ │ │ │ │ -0000e570: 4d49 5353 494e 4727 0a20 2020 2020 2020  MISSING'.       
│ │ │ │ │ -0000e580: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:
│ │ │ │ │ -0000e590: 206d 6973 7369 6e67 2070 6f72 740a 2020   missing port.  
│ │ │ │ │ -0000e5a0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ -0000e5b0: 5641 4c49 445f 4441 5441 5f4d 4553 5341  VALID_DATA_MESSA
│ │ │ │ │ -0000e5c0: 4745 5f54 5950 455f 5641 4c49 4446 4149  GE_TYPE_VALIDFAI
│ │ │ │ │ -0000e5d0: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv
│ │ │ │ │ -0000e5e0: 616c 6964 2064 6174 613a 2069 6e76 616c  alid data: inval
│ │ │ │ │ -0000e5f0: 6964 206d 6573 7361 6765 2074 7970 650a  id message type.
│ │ │ │ │ -0000e600: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000e610: 494e 5641 4c49 445f 4441 5441 5f4d 4553  INVALID_DATA_MES
│ │ │ │ │ -0000e620: 5341 4745 5f45 4d50 5459 270a 2020 2020  SAGE_EMPTY'.    
│ │ │ │ │ -0000e630: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ -0000e640: 7461 3a20 656d 7074 7920 6461 7461 206d  ta: empty data m
│ │ │ │ │ -0000e650: 6573 7361 6765 0a20 2020 2020 2746 4b4f  essage.     'FKO
│ │ │ │ │ -0000e660: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ -0000e670: 4154 415f 4d45 5353 4147 455f 434d 445f  ATA_MESSAGE_CMD_
│ │ │ │ │ -0000e680: 4d49 5353 494e 4727 0a20 2020 2020 2020  MISSING'.       
│ │ │ │ │ -0000e690: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:
│ │ │ │ │ -0000e6a0: 206d 6973 7369 6e67 2063 6f6d 6d61 6e64   missing command
│ │ │ │ │ -0000e6b0: 206d 6573 7361 6765 0a20 2020 2020 2746   message.     'F
│ │ │ │ │ -0000e6c0: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ -0000e6d0: 5f44 4154 415f 4d45 5353 4147 455f 4143  _DATA_MESSAGE_AC
│ │ │ │ │ -0000e6e0: 4345 5353 5f4d 4953 5349 4e47 270a 2020  CESS_MISSING'.  
│ │ │ │ │ -0000e6f0: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ -0000e700: 6461 7461 3a20 6d69 7373 696e 6720 6163  data: missing ac
│ │ │ │ │ -0000e710: 6365 7373 206d 6573 7361 6765 0a20 2020  cess message.   
│ │ │ │ │ -0000e720: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ -0000e730: 414c 4944 5f44 4154 415f 4d45 5353 4147  ALID_DATA_MESSAG
│ │ │ │ │ -0000e740: 455f 4e41 545f 4d49 5353 494e 4727 0a20  E_NAT_MISSING'. 
│ │ │ │ │ -0000e750: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ -0000e760: 2064 6174 613a 206d 6973 7369 6e67 204e   data: missing N
│ │ │ │ │ -0000e770: 4154 2064 6174 610a 2020 2020 2027 464b  AT data.     'FK
│ │ │ │ │ -0000e780: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ -0000e790: 4441 5441 5f4d 4553 5341 4745 5f50 4f52  DATA_MESSAGE_POR
│ │ │ │ │ -0000e7a0: 5450 524f 544f 5f4d 4953 5349 4e47 270a  TPROTO_MISSING'.
│ │ │ │ │ -0000e7b0: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ -0000e7c0: 6420 6461 7461 3a20 6d69 7373 696e 6720  d data: missing 
│ │ │ │ │ -0000e7d0: 7072 6f74 6f2f 706f 7274 2064 6174 610a  proto/port data.
│ │ │ │ │ -0000e7e0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000e7f0: 494e 5641 4c49 445f 4441 5441 5f4e 4154  INVALID_DATA_NAT
│ │ │ │ │ -0000e800: 5f45 4d50 5459 270a 2020 2020 2020 2020  _EMPTY'.        
│ │ │ │ │ -0000e810: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ -0000e820: 656d 7074 7920 4e41 5420 7661 6c75 650a  empty NAT value.
│ │ │ │ │ -0000e830: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000e840: 494e 5641 4c49 445f 4441 5441 5f52 414e  INVALID_DATA_RAN
│ │ │ │ │ -0000e850: 445f 4c45 4e5f 5641 4c49 4446 4149 4c27  D_LEN_VALIDFAIL'
│ │ │ │ │ -0000e860: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ -0000e870: 6964 2064 6174 613a 2069 6e76 616c 6964  id data: invalid
│ │ │ │ │ -0000e880: 2072 616e 646f 6d20 6461 7461 206c 656e   random data len
│ │ │ │ │ -0000e890: 6774 680a 2020 2020 2027 464b 4f5f 4552  gth.     'FKO_ER
│ │ │ │ │ -0000e8a0: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ -0000e8b0: 5f53 5256 4155 5448 5f4d 4953 5349 4e47  _SRVAUTH_MISSING
│ │ │ │ │ -0000e8c0: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva
│ │ │ │ │ -0000e8d0: 6c69 6420 6461 7461 3a20 7365 7276 6572  lid data: server
│ │ │ │ │ -0000e8e0: 2061 7574 6820 6d69 7373 696e 670a 2020   auth missing.  
│ │ │ │ │ -0000e8f0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ -0000e900: 5641 4c49 445f 4441 5441 5f54 494d 4553  VALID_DATA_TIMES
│ │ │ │ │ -0000e910: 5441 4d50 5f56 414c 4944 4641 494c 270a  TAMP_VALIDFAIL'.
│ │ │ │ │ -0000e920: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ -0000e930: 6420 6461 7461 3a20 696e 7661 6c69 6420  d data: invalid 
│ │ │ │ │ -0000e940: 7469 6d65 7374 616d 7020 7661 6c75 650a  timestamp value.
│ │ │ │ │ -0000e950: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000e960: 494e 5641 4c49 445f 4441 5441 5f55 5345  INVALID_DATA_USE
│ │ │ │ │ -0000e970: 525f 4d49 5353 494e 4727 0a20 2020 2020  R_MISSING'.     
│ │ │ │ │ -0000e980: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat
│ │ │ │ │ -0000e990: 613a 206d 6973 7369 6e67 2075 7365 7220  a: missing user 
│ │ │ │ │ -0000e9a0: 6461 7461 0a20 2020 2020 2746 4b4f 5f45  data.     'FKO_E
│ │ │ │ │ -0000e9b0: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ -0000e9c0: 415f 5553 4552 5f46 4952 5354 4348 4152  A_USER_FIRSTCHAR
│ │ │ │ │ -0000e9d0: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    
│ │ │ │ │ -0000e9e0: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ -0000e9f0: 7461 3a20 7573 6572 2066 6972 7374 2063  ta: user first c
│ │ │ │ │ -0000ea00: 6861 7220 6e6f 7420 7661 6c69 640a 2020  har not valid.  
│ │ │ │ │ -0000ea10: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ -0000ea20: 5641 4c49 445f 4441 5441 5f55 5345 525f  VALID_DATA_USER_
│ │ │ │ │ -0000ea30: 5245 4d43 4841 525f 5641 4c49 4446 4149  REMCHAR_VALIDFAI
│ │ │ │ │ -0000ea40: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv
│ │ │ │ │ -0000ea50: 616c 6964 2064 6174 613a 2075 7365 7220  alid data: user 
│ │ │ │ │ -0000ea60: 7265 6d63 6861 7220 6e6f 7420 7661 6c69  remchar not vali
│ │ │ │ │ -0000ea70: 640a 2020 2020 2027 464b 4f5f 4552 524f  d.     'FKO_ERRO
│ │ │ │ │ -0000ea80: 525f 494e 5641 4c49 445f 4441 5441 5f55  R_INVALID_DATA_U
│ │ │ │ │ -0000ea90: 5449 4c5f 5354 5254 4f4c 5f4c 545f 4d49  TIL_STRTOL_LT_MI
│ │ │ │ │ -0000eaa0: 4e27 0a20 2020 2020 2020 2020 2049 6e76  N'.          Inv
│ │ │ │ │ -0000eab0: 616c 6964 2064 6174 613a 2075 7469 6c20  alid data: util 
│ │ │ │ │ -0000eac0: 636f 6e76 6572 7369 6f6e 2074 6f20 6c6f  conversion to lo
│ │ │ │ │ -0000ead0: 6e67 206c 6573 7320 7468 616e 206d 696e  ng less than min
│ │ │ │ │ -0000eae0: 696d 756d 0a20 2020 2020 2746 4b4f 5f45  imum.     'FKO_E
│ │ │ │ │ -0000eaf0: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ -0000eb00: 415f 5554 494c 5f53 5452 544f 4c5f 4754  A_UTIL_STRTOL_GT
│ │ │ │ │ -0000eb10: 5f4d 4158 270a 2020 2020 2020 2020 2020  _MAX'.          
│ │ │ │ │ -0000eb20: 496e 7661 6c69 6420 6461 7461 3a20 7574  Invalid data: ut
│ │ │ │ │ -0000eb30: 696c 2063 6f6e 7665 7273 696f 6e20 746f  il conversion to
│ │ │ │ │ -0000eb40: 206c 6f6e 6720 6772 6561 7465 7220 7468   long greater th
│ │ │ │ │ -0000eb50: 616e 206d 6178 696d 756d 0a20 2020 2020  an maximum.     
│ │ │ │ │ -0000eb60: 2746 4b4f 5f45 5252 4f52 5f44 4154 415f  'FKO_ERROR_DATA_
│ │ │ │ │ -0000eb70: 544f 4f5f 4c41 5247 4527 0a20 2020 2020  TOO_LARGE'.     
│ │ │ │ │ -0000eb80: 2020 2020 2056 616c 7565 206f 7220 5369       Value or Si
│ │ │ │ │ -0000eb90: 7a65 206f 6620 7468 6520 6461 7461 2065  ze of the data e
│ │ │ │ │ -0000eba0: 7863 6565 6465 6420 7468 6520 6d61 7820  xceeded the max 
│ │ │ │ │ -0000ebb0: 616c 6c6f 7765 640a 2020 2020 2027 464b  allowed.     'FK
│ │ │ │ │ -0000ebc0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ -0000ebd0: 4b45 595f 4c45 4e27 0a20 2020 2020 2020  KEY_LEN'.       
│ │ │ │ │ -0000ebe0: 2020 2049 6e76 616c 6964 206b 6579 206c     Invalid key l
│ │ │ │ │ -0000ebf0: 656e 6774 680a 2020 2020 2027 464b 4f5f  ength.     'FKO_
│ │ │ │ │ -0000ec00: 4552 524f 525f 5553 4552 4e41 4d45 5f55  ERROR_USERNAME_U
│ │ │ │ │ -0000ec10: 4e4b 4e4f 574e 270a 2020 2020 2020 2020  NKNOWN'.        
│ │ │ │ │ -0000ec20: 2020 556e 6162 6c65 2074 6f20 6465 7465    Unable to dete
│ │ │ │ │ -0000ec30: 726d 696e 6520 7573 6572 6e61 6d65 0a20  rmine username. 
│ │ │ │ │ -0000ec40: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ -0000ec50: 4e43 4f4d 504c 4554 455f 5350 415f 4441  NCOMPLETE_SPA_DA
│ │ │ │ │ -0000ec60: 5441 270a 2020 2020 2020 2020 2020 4d69  TA'.          Mi
│ │ │ │ │ -0000ec70: 7373 696e 6720 6f72 2069 6e63 6f6d 706c  ssing or incompl
│ │ │ │ │ -0000ec80: 6574 6520 5350 4120 6461 7461 0a20 2020  ete SPA data.   
│ │ │ │ │ -0000ec90: 2020 2746 4b4f 5f45 5252 4f52 5f4d 4953    'FKO_ERROR_MIS
│ │ │ │ │ -0000eca0: 5349 4e47 5f45 4e43 4f44 4544 5f44 4154  SING_ENCODED_DAT
│ │ │ │ │ -0000ecb0: 4127 0a20 2020 2020 2020 2020 2054 6865  A'.          The
│ │ │ │ │ -0000ecc0: 7265 2069 7320 6e6f 2065 6e63 6f64 6564  re is no encoded
│ │ │ │ │ -0000ecd0: 2064 6174 6120 746f 2070 726f 6365 7373   data to process
│ │ │ │ │ -0000ece0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -0000ecf0: 5f49 4e56 414c 4944 5f44 4947 4553 545f  _INVALID_DIGEST_
│ │ │ │ │ -0000ed00: 5459 5045 270a 2020 2020 2020 2020 2020  TYPE'.          
│ │ │ │ │ -0000ed10: 496e 7661 6c69 6420 6469 6765 7374 2074  Invalid digest t
│ │ │ │ │ -0000ed20: 7970 650a 2020 2020 2027 464b 4f5f 4552  ype.     'FKO_ER
│ │ │ │ │ -0000ed30: 524f 525f 494e 5641 4c49 445f 414c 4c4f  ROR_INVALID_ALLO
│ │ │ │ │ -0000ed40: 575f 4950 270a 2020 2020 2020 2020 2020  W_IP'.          
│ │ │ │ │ -0000ed50: 496e 7661 6c69 6420 616c 6c6f 7720 4950  Invalid allow IP
│ │ │ │ │ -0000ed60: 2061 6464 7265 7373 2069 6e20 7468 6520   address in the 
│ │ │ │ │ -0000ed70: 5350 4120 6d65 7373 6167 6520 6461 7461  SPA message data
│ │ │ │ │ -0000ed80: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -0000ed90: 5f49 4e56 414c 4944 5f53 5041 5f43 4f4d  _INVALID_SPA_COM
│ │ │ │ │ -0000eda0: 4d41 4e44 5f4d 5347 270a 2020 2020 2020  MAND_MSG'.      
│ │ │ │ │ -0000edb0: 2020 2020 496e 7661 6c69 6420 5350 4120      Invalid SPA 
│ │ │ │ │ -0000edc0: 636f 6d6d 616e 6420 6d65 7373 6167 6520  command message 
│ │ │ │ │ -0000edd0: 666f 726d 6174 0a20 2020 2020 2746 4b4f  format.     'FKO
│ │ │ │ │ -0000ede0: 5f45 5252 4f52 5f49 4e56 414c 4944 5f53  _ERROR_INVALID_S
│ │ │ │ │ -0000edf0: 5041 5f41 4343 4553 535f 4d53 4727 0a20  PA_ACCESS_MSG'. 
│ │ │ │ │ -0000ee00: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ -0000ee10: 2053 5041 2061 6363 6573 7320 6d65 7373   SPA access mess
│ │ │ │ │ -0000ee20: 6167 6520 666f 726d 6174 0a20 2020 2020  age format.     
│ │ │ │ │ -0000ee30: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ -0000ee40: 4944 5f53 5041 5f4e 4154 5f41 4343 4553  ID_SPA_NAT_ACCES
│ │ │ │ │ -0000ee50: 535f 4d53 4727 0a20 2020 2020 2020 2020  S_MSG'.         
│ │ │ │ │ -0000ee60: 2049 6e76 616c 6964 2053 5041 206e 6174   Invalid SPA nat
│ │ │ │ │ -0000ee70: 5f61 6363 6573 7320 6d65 7373 6167 6520  _access message 
│ │ │ │ │ -0000ee80: 666f 726d 6174 0a20 2020 2020 2746 4b4f  format.     'FKO
│ │ │ │ │ -0000ee90: 5f45 5252 4f52 5f49 4e56 414c 4944 5f45  _ERROR_INVALID_E
│ │ │ │ │ -0000eea0: 4e43 5259 5054 494f 4e5f 5459 5045 270a  NCRYPTION_TYPE'.
│ │ │ │ │ -0000eeb0: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ -0000eec0: 6420 656e 6372 7970 7469 6f6e 2074 7970  d encryption typ
│ │ │ │ │ -0000eed0: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO
│ │ │ │ │ -0000eee0: 525f 5752 4f4e 475f 454e 4352 5950 5449  R_WRONG_ENCRYPTI
│ │ │ │ │ -0000eef0: 4f4e 5f54 5950 4527 0a20 2020 2020 2020  ON_TYPE'.       
│ │ │ │ │ -0000ef00: 2020 2057 726f 6e67 206f 7220 696e 6170     Wrong or inap
│ │ │ │ │ -0000ef10: 7072 6f70 7269 6174 6520 656e 6372 7970  propriate encryp
│ │ │ │ │ -0000ef20: 7469 6f6e 2074 7970 6520 666f 7220 7468  tion type for th
│ │ │ │ │ -0000ef30: 6973 206f 7065 7261 7469 6f6e 0a20 2020  is operation.   
│ │ │ │ │ -0000ef40: 2020 2746 4b4f 5f45 5252 4f52 5f44 4543    'FKO_ERROR_DEC
│ │ │ │ │ -0000ef50: 5259 5054 494f 4e5f 5349 5a45 270a 2020  RYPTION_SIZE'.  
│ │ │ │ │ -0000ef60: 2020 2020 2020 2020 556e 6578 7065 6374          Unexpect
│ │ │ │ │ -0000ef70: 6564 206f 7220 696e 7661 6c69 6420 7369  ed or invalid si
│ │ │ │ │ -0000ef80: 7a65 2066 6f72 2064 6563 7279 7074 6564  ze for decrypted
│ │ │ │ │ -0000ef90: 2064 6174 610a 2020 2020 2027 464b 4f5f   data.     'FKO_
│ │ │ │ │ -0000efa0: 4552 524f 525f 4445 4352 5950 5449 4f4e  ERROR_DECRYPTION
│ │ │ │ │ -0000efb0: 5f46 4149 4c55 5245 270a 2020 2020 2020  _FAILURE'.      
│ │ │ │ │ -0000efc0: 2020 2020 4465 6372 7970 7469 6f6e 2066      Decryption f
│ │ │ │ │ -0000efd0: 6169 6c65 6420 6f72 2064 6563 7279 7074  ailed or decrypt
│ │ │ │ │ -0000efe0: 6564 2064 6174 6120 6973 2069 6e76 616c  ed data is inval
│ │ │ │ │ -0000eff0: 6964 0a20 2020 2020 2746 4b4f 5f45 5252  id.     'FKO_ERR
│ │ │ │ │ -0000f000: 4f52 5f44 4947 4553 545f 5645 5249 4649  OR_DIGEST_VERIFI
│ │ │ │ │ -0000f010: 4341 5449 4f4e 5f46 4149 4c45 4427 0a20  CATION_FAILED'. 
│ │ │ │ │ -0000f020: 2020 2020 2020 2020 2054 6865 2063 6f6d           The com
│ │ │ │ │ -0000f030: 7075 7465 6420 6469 6765 7374 2064 6964  puted digest did
│ │ │ │ │ -0000f040: 206e 6f74 206d 6174 6368 2074 6865 2064   not match the d
│ │ │ │ │ -0000f050: 6967 6573 7420 696e 2074 6865 2073 7061  igest in the spa
│ │ │ │ │ -0000f060: 2064 6174 610a 2020 2020 2027 464b 4f5f   data.     'FKO_
│ │ │ │ │ -0000f070: 4552 524f 525f 494e 5641 4c49 445f 484d  ERROR_INVALID_HM
│ │ │ │ │ -0000f080: 4143 5f4b 4559 5f4c 454e 270a 2020 2020  AC_KEY_LEN'.    
│ │ │ │ │ -0000f090: 2020 2020 2020 496e 7661 6c69 6420 484d        Invalid HM
│ │ │ │ │ -0000f0a0: 4143 206b 6579 206c 656e 6774 680a 2020  AC key length.  
│ │ │ │ │ -0000f0b0: 2020 2027 464b 4f5f 4552 524f 525f 554e     'FKO_ERROR_UN
│ │ │ │ │ -0000f0c0: 5355 5050 4f52 5445 445f 484d 4143 5f4d  SUPPORTED_HMAC_M
│ │ │ │ │ -0000f0d0: 4f44 4527 0a20 2020 2020 2020 2020 2055  ODE'.          U
│ │ │ │ │ -0000f0e0: 6e73 7570 706f 7274 6564 2048 4d41 4320  nsupported HMAC 
│ │ │ │ │ -0000f0f0: 6d6f 6465 2028 6465 6661 756c 743a 2053  mode (default: S
│ │ │ │ │ -0000f100: 4841 3235 3629 0a20 2020 2020 2746 4b4f  HA256).     'FKO
│ │ │ │ │ -0000f110: 5f45 5252 4f52 5f55 4e53 5550 504f 5254  _ERROR_UNSUPPORT
│ │ │ │ │ -0000f120: 4544 5f46 4541 5455 5245 270a 2020 2020  ED_FEATURE'.    
│ │ │ │ │ -0000f130: 2020 2020 2020 556e 7375 7070 6f72 7465        Unsupporte
│ │ │ │ │ -0000f140: 6420 6f72 2075 6e69 6d70 6c65 6d65 6e74  d or unimplement
│ │ │ │ │ -0000f150: 6564 2066 6561 7475 7265 206f 7220 6675  ed feature or fu
│ │ │ │ │ -0000f160: 6e63 7469 6f6e 0a20 2020 2020 2746 4b4f  nction.     'FKO
│ │ │ │ │ -0000f170: 5f45 5252 4f52 5f5a 4552 4f5f 4f55 545f  _ERROR_ZERO_OUT_
│ │ │ │ │ -0000f180: 4441 5441 270a 2020 2020 2020 2020 2020  DATA'.          
│ │ │ │ │ -0000f190: 436f 756c 6420 6e6f 7420 7a65 726f 206f  Could not zero o
│ │ │ │ │ -0000f1a0: 7574 2073 656e 7369 7469 7665 2064 6174  ut sensitive dat
│ │ │ │ │ -0000f1b0: 610a 2020 2020 2027 464b 4f5f 4552 524f  a.     'FKO_ERRO
│ │ │ │ │ -0000f1c0: 525f 554e 4b4e 4f57 4e27 0a20 2020 2020  R_UNKNOWN'.     
│ │ │ │ │ -0000f1d0: 2020 2020 2055 6e6b 6e6f 776e 2f55 6e63       Unknown/Unc
│ │ │ │ │ -0000f1e0: 6c61 7373 6966 6965 6420 6572 726f 720a  lassified error.
│ │ │ │ │ -0000f1f0: 0a20 2020 4966 2047 5047 2073 7570 706f  .   If GPG suppo
│ │ │ │ │ -0000f200: 7274 2069 7320 6176 6169 6c61 626c 652c  rt is available,
│ │ │ │ │ -0000f210: 2074 6865 7265 2061 7265 2061 6464 6974   there are addit
│ │ │ │ │ -0000f220: 696f 6e61 6c20 706f 7373 6962 6c65 2065  ional possible e
│ │ │ │ │ -0000f230: 7272 6f72 0a63 6f6e 6469 7469 6f6e 7320  rror.conditions 
│ │ │ │ │ -0000f240: 616e 6420 6572 726f 7220 636f 6465 732e  and error codes.
│ │ │ │ │ -0000f250: 2020 5468 6520 4750 4720 7375 7070 6f72    The GPG suppor
│ │ │ │ │ -0000f260: 7420 6973 2069 6d70 6c65 6d65 6e74 6564  t is implemented
│ │ │ │ │ -0000f270: 2076 6961 2047 5047 4d45 2e0a 5468 6520   via GPGME..The 
│ │ │ │ │ -0000f280: 6c69 6266 6b6f 2065 7272 6f72 2068 616e  libfko error han
│ │ │ │ │ -0000f290: 646c 696e 6720 636f 6465 2077 7261 7073  dling code wraps
│ │ │ │ │ -0000f2a0: 206d 616e 7920 6f66 2074 6865 2047 5047   many of the GPG
│ │ │ │ │ -0000f2b0: 4d45 2065 7272 6f72 2063 6f64 6573 2074  ME error codes t
│ │ │ │ │ -0000f2c0: 6861 740a 6d61 7920 6265 2065 6e63 6f75  hat.may be encou
│ │ │ │ │ -0000f2d0: 6e74 6572 6564 2077 6869 6c65 2075 7369  ntered while usi
│ │ │ │ │ -0000f2e0: 6e67 206c 6962 666b 6f27 7320 4750 4720  ng libfko's GPG 
│ │ │ │ │ -0000f2f0: 7265 6c61 7465 6420 6675 6e63 7469 6f6e  related function
│ │ │ │ │ -0000f300: 732e 2020 5468 6573 650a 6172 653a 0a0a  s.  These.are:..
│ │ │ │ │ -0000f310: 202d 2d20 5661 7269 6162 6c65 3a20 696e   -- Variable: in
│ │ │ │ │ -0000f320: 7420 6572 726f 725f 636f 6465 2028 6770  t error_code (gp
│ │ │ │ │ -0000f330: 676d 6520 7375 7070 6f72 7420 6f6e 6c79  gme support only
│ │ │ │ │ -0000f340: 290a 2020 2020 2027 464b 4f5f 4552 524f  ).     'FKO_ERRO
│ │ │ │ │ -0000f350: 525f 4d49 5353 494e 475f 4750 475f 4b45  R_MISSING_GPG_KE
│ │ │ │ │ -0000f360: 595f 4441 5441 270a 2020 2020 2020 2020  Y_DATA'.        
│ │ │ │ │ -0000f370: 2020 4d69 7373 696e 6720 4750 4720 6b65    Missing GPG ke
│ │ │ │ │ -0000f380: 7920 6461 7461 2028 7369 676e 6572 206f  y data (signer o
│ │ │ │ │ -0000f390: 7220 7265 6369 7069 656e 7420 6e6f 7420  r recipient not 
│ │ │ │ │ -0000f3a0: 7365 7429 0a20 2020 2020 2746 4b4f 5f45  set).     'FKO_E
│ │ │ │ │ -0000f3b0: 5252 4f52 5f47 5047 4d45 5f4e 4f5f 4f50  RROR_GPGME_NO_OP
│ │ │ │ │ -0000f3c0: 454e 5047 5027 0a20 2020 2020 2020 2020  ENPGP'.         
│ │ │ │ │ -0000f3d0: 2054 6869 7320 4750 474d 4520 696d 706c   This GPGME impl
│ │ │ │ │ -0000f3e0: 656d 656e 7461 7469 6f6e 2064 6f65 7320  ementation does 
│ │ │ │ │ -0000f3f0: 6e6f 7420 7375 7070 6f72 7420 4f70 656e  not support Open
│ │ │ │ │ -0000f400: 5047 500a 2020 2020 2027 464b 4f5f 4552  PGP.     'FKO_ER
│ │ │ │ │ -0000f410: 524f 525f 4750 474d 455f 434f 4e54 4558  ROR_GPGME_CONTEX
│ │ │ │ │ -0000f420: 5427 0a20 2020 2020 2020 2020 2055 6e61  T'.          Una
│ │ │ │ │ -0000f430: 626c 6520 746f 2063 7265 6174 6520 4750  ble to create GP
│ │ │ │ │ -0000f440: 474d 4520 636f 6e74 6578 740a 2020 2020  GME context.    
│ │ │ │ │ -0000f450: 2027 464b 4f5f 4552 524f 525f 4750 474d   'FKO_ERROR_GPGM
│ │ │ │ │ -0000f460: 455f 504c 4149 4e54 4558 545f 4441 5441  E_PLAINTEXT_DATA
│ │ │ │ │ -0000f470: 5f4f 424a 270a 2020 2020 2020 2020 2020  _OBJ'.          
│ │ │ │ │ -0000f480: 4572 726f 7220 6372 6561 7469 6e67 2074  Error creating t
│ │ │ │ │ -0000f490: 6865 2070 6c61 696e 7465 7874 2064 6174  he plaintext dat
│ │ │ │ │ -0000f4a0: 6120 6f62 6a65 6374 0a20 2020 2020 2746  a object.     'F
│ │ │ │ │ -0000f4b0: 4b4f 5f45 5252 4f52 5f47 5047 4d45 5f53  KO_ERROR_GPGME_S
│ │ │ │ │ -0000f4c0: 4554 5f50 524f 544f 434f 4c27 0a20 2020  ET_PROTOCOL'.   
│ │ │ │ │ -0000f4d0: 2020 2020 2020 2055 6e61 626c 6520 746f         Unable to
│ │ │ │ │ -0000f4e0: 2073 6574 2047 5047 4d45 2074 6f20 7573   set GPGME to us
│ │ │ │ │ -0000f4f0: 6520 4f70 656e 5047 5020 7072 6f74 6f63  e OpenPGP protoc
│ │ │ │ │ -0000f500: 6f6c 0a20 2020 2020 2746 4b4f 5f45 5252  ol.     'FKO_ERR
│ │ │ │ │ -0000f510: 4f52 5f47 5047 4d45 5f43 4950 4845 525f  OR_GPGME_CIPHER_
│ │ │ │ │ -0000f520: 4441 5441 5f4f 424a 270a 2020 2020 2020  DATA_OBJ'.      
│ │ │ │ │ -0000f530: 2020 2020 4572 726f 7220 6372 6561 7469      Error creati
│ │ │ │ │ -0000f540: 6e67 2074 6865 2065 6e63 7279 7074 6564  ng the encrypted
│ │ │ │ │ -0000f550: 2064 6174 6120 6461 7461 206f 626a 6563   data data objec
│ │ │ │ │ -0000f560: 740a 2020 2020 2027 464b 4f5f 4552 524f  t.     'FKO_ERRO
│ │ │ │ │ -0000f570: 525f 4750 474d 455f 4241 445f 5041 5353  R_GPGME_BAD_PASS
│ │ │ │ │ -0000f580: 5048 5241 5345 270a 2020 2020 2020 2020  PHRASE'.        
│ │ │ │ │ -0000f590: 2020 5468 6520 4750 4720 7061 7373 7068    The GPG passph
│ │ │ │ │ -0000f5a0: 7261 7365 2077 6173 206e 6f74 2076 616c  rase was not val
│ │ │ │ │ -0000f5b0: 6964 0a20 2020 2020 2746 4b4f 5f45 5252  id.     'FKO_ERR
│ │ │ │ │ -0000f5c0: 4f52 5f47 5047 4d45 5f45 4e43 5259 5054  OR_GPGME_ENCRYPT
│ │ │ │ │ -0000f5d0: 5f53 4947 4e27 0a20 2020 2020 2020 2020  _SIGN'.         
│ │ │ │ │ -0000f5e0: 2045 7272 6f72 2064 7572 696e 6720 7468   Error during th
│ │ │ │ │ -0000f5f0: 6520 656e 6372 7970 7420 616e 6420 7369  e encrypt and si
│ │ │ │ │ -0000f600: 676e 206f 7065 7261 7469 6f6e 0a20 2020  gn operation.   
│ │ │ │ │ -0000f610: 2020 2746 4b4f 5f45 5252 4f52 5f47 5047    'FKO_ERROR_GPG
│ │ │ │ │ -0000f620: 4d45 5f43 4f4e 5445 5854 5f53 4947 4e45  ME_CONTEXT_SIGNE
│ │ │ │ │ -0000f630: 525f 4b45 5927 0a20 2020 2020 2020 2020  R_KEY'.         
│ │ │ │ │ -0000f640: 2055 6e61 626c 6520 746f 2063 7265 6174   Unable to creat
│ │ │ │ │ -0000f650: 6520 4750 474d 4520 636f 6e74 6578 7420  e GPGME context 
│ │ │ │ │ -0000f660: 666f 7220 7468 6520 7369 676e 6572 206b  for the signer k
│ │ │ │ │ -0000f670: 6579 0a20 2020 2020 2746 4b4f 5f45 5252  ey.     'FKO_ERR
│ │ │ │ │ -0000f680: 4f52 5f47 5047 4d45 5f53 4947 4e45 525f  OR_GPGME_SIGNER_
│ │ │ │ │ -0000f690: 4b45 594c 4953 545f 5354 4152 5427 0a20  KEYLIST_START'. 
│ │ │ │ │ -0000f6a0: 2020 2020 2020 2020 2045 7272 6f72 2066           Error f
│ │ │ │ │ -0000f6b0: 726f 6d20 7369 676e 6572 206b 6579 6c69  rom signer keyli
│ │ │ │ │ -0000f6c0: 7374 2073 7461 7274 206f 7065 7261 7469  st start operati
│ │ │ │ │ -0000f6d0: 6f6e 0a20 2020 2020 2746 4b4f 5f45 5252  on.     'FKO_ERR
│ │ │ │ │ -0000f6e0: 4f52 5f47 5047 4d45 5f53 4947 4e45 525f  OR_GPGME_SIGNER_
│ │ │ │ │ -0000f6f0: 4b45 595f 4e4f 545f 464f 554e 4427 0a20  KEY_NOT_FOUND'. 
│ │ │ │ │ -0000f700: 2020 2020 2020 2020 2054 6865 206b 6579           The key
│ │ │ │ │ -0000f710: 2066 6f72 2074 6865 2067 6976 656e 2073   for the given s
│ │ │ │ │ -0000f720: 6967 6e65 7220 7761 7320 6e6f 7420 666f  igner was not fo
│ │ │ │ │ -0000f730: 756e 640a 2020 2020 2027 464b 4f5f 4552  und.     'FKO_ER
│ │ │ │ │ -0000f740: 524f 525f 4750 474d 455f 5349 474e 4552  ROR_GPGME_SIGNER
│ │ │ │ │ -0000f750: 5f4b 4559 5f41 4d42 4947 554f 5553 270a  _KEY_AMBIGUOUS'.
│ │ │ │ │ -0000f760: 2020 2020 2020 2020 2020 416d 6269 6775            Ambigu
│ │ │ │ │ -0000f770: 6f75 7320 6e61 6d65 2f69 6420 666f 7220  ous name/id for 
│ │ │ │ │ -0000f780: 7468 6520 7369 676e 6572 206b 6579 2028  the signer key (
│ │ │ │ │ -0000f790: 6d75 6c74 6970 6c65 206d 6174 6368 6573  multiple matches
│ │ │ │ │ -0000f7a0: 290a 2020 2020 2027 464b 4f5f 4552 524f  ).     'FKO_ERRO
│ │ │ │ │ -0000f7b0: 525f 4750 474d 455f 4144 445f 5349 474e  R_GPGME_ADD_SIGN
│ │ │ │ │ -0000f7c0: 4552 270a 2020 2020 2020 2020 2020 4572  ER'.          Er
│ │ │ │ │ -0000f7d0: 726f 7220 6164 6469 6e67 2074 6865 2073  ror adding the s
│ │ │ │ │ -0000f7e0: 6967 6e65 7220 6b65 7920 746f 2074 6865  igner key to the
│ │ │ │ │ -0000f7f0: 2067 7067 6d65 2063 6f6e 7465 7874 0a20   gpgme context. 
│ │ │ │ │ -0000f800: 2020 2020 2746 4b4f 5f45 5252 4f52 5f47      'FKO_ERROR_G
│ │ │ │ │ -0000f810: 5047 4d45 5f43 4f4e 5445 5854 5f52 4543  PGME_CONTEXT_REC
│ │ │ │ │ -0000f820: 4950 4945 4e54 5f4b 4559 270a 2020 2020  IPIENT_KEY'.    
│ │ │ │ │ -0000f830: 2020 2020 2020 556e 6162 6c65 2074 6f20        Unable to 
│ │ │ │ │ -0000f840: 6372 6561 7465 2047 5047 4d45 2063 6f6e  create GPGME con
│ │ │ │ │ -0000f850: 7465 7874 2066 6f72 2074 6865 2072 6563  text for the rec
│ │ │ │ │ -0000f860: 6970 6965 6e74 206b 6579 0a20 2020 2020  ipient key.     
│ │ │ │ │ -0000f870: 2746 4b4f 5f45 5252 4f52 5f47 5047 4d45  'FKO_ERROR_GPGME
│ │ │ │ │ -0000f880: 5f52 4543 4950 4945 4e54 5f4b 4559 4c49  _RECIPIENT_KEYLI
│ │ │ │ │ -0000f890: 5354 5f53 5441 5254 270a 2020 2020 2020  ST_START'.      
│ │ │ │ │ -0000f8a0: 2020 2020 4572 726f 7220 6672 6f6d 2073      Error from s
│ │ │ │ │ -0000f8b0: 6967 6e65 7220 6b65 796c 6973 7420 7374  igner keylist st
│ │ │ │ │ -0000f8c0: 6172 7420 6f70 6572 6174 696f 6e0a 2020  art operation.  
│ │ │ │ │ -0000f8d0: 2020 2027 464b 4f5f 4552 524f 525f 4750     'FKO_ERROR_GP
│ │ │ │ │ -0000f8e0: 474d 455f 5245 4349 5049 454e 545f 4b45  GME_RECIPIENT_KE
│ │ │ │ │ -0000f8f0: 595f 4e4f 545f 464f 554e 4427 0a20 2020  Y_NOT_FOUND'.   
│ │ │ │ │ -0000f900: 2020 2020 2020 2054 6865 206b 6579 2066         The key f
│ │ │ │ │ -0000f910: 6f72 2074 6865 2067 6976 656e 2072 6563  or the given rec
│ │ │ │ │ -0000f920: 6970 6965 6e74 2077 6173 206e 6f74 2066  ipient was not f
│ │ │ │ │ -0000f930: 6f75 6e64 0a20 2020 2020 2746 4b4f 5f45  ound.     'FKO_E
│ │ │ │ │ -0000f940: 5252 4f52 5f47 5047 4d45 5f52 4543 4950  RROR_GPGME_RECIP
│ │ │ │ │ -0000f950: 4945 4e54 5f4b 4559 5f41 4d42 4947 554f  IENT_KEY_AMBIGUO
│ │ │ │ │ -0000f960: 5553 270a 2020 2020 2020 2020 2020 416d  US'.          Am
│ │ │ │ │ -0000f970: 6269 6775 6f75 7320 6e61 6d65 2f69 6420  biguous name/id 
│ │ │ │ │ -0000f980: 666f 7220 7468 6520 7265 6369 7069 656e  for the recipien
│ │ │ │ │ -0000f990: 7420 6b65 7920 286d 756c 7469 706c 6520  t key (multiple 
│ │ │ │ │ -0000f9a0: 6d61 7463 6865 7329 0a20 2020 2020 2746  matches).     'F
│ │ │ │ │ -0000f9b0: 4b4f 5f45 5252 4f52 5f47 5047 4d45 5f44  KO_ERROR_GPGME_D
│ │ │ │ │ -0000f9c0: 4543 5259 5054 5f46 4149 4c45 4427 0a20  ECRYPT_FAILED'. 
│ │ │ │ │ -0000f9d0: 2020 2020 2020 2020 2044 6563 7279 7074           Decrypt
│ │ │ │ │ -0000f9e0: 696f 6e20 6f70 6572 6174 696f 6e20 6661  ion operation fa
│ │ │ │ │ -0000f9f0: 696c 6564 0a20 2020 2020 2746 4b4f 5f45  iled.     'FKO_E
│ │ │ │ │ -0000fa00: 5252 4f52 5f47 5047 4d45 5f42 4144 5f47  RROR_GPGME_BAD_G
│ │ │ │ │ -0000fa10: 5047 5f45 5845 270a 2020 2020 2020 2020  PG_EXE'.        
│ │ │ │ │ -0000fa20: 2020 556e 6162 6c65 2074 6f20 7374 6174    Unable to stat
│ │ │ │ │ -0000fa30: 2074 6865 2067 6976 656e 2047 5047 2065   the given GPG e
│ │ │ │ │ -0000fa40: 7865 6375 7461 626c 650a 2020 2020 2027  xecutable.     '
│ │ │ │ │ -0000fa50: 464b 4f5f 4552 524f 525f 4750 474d 455f  FKO_ERROR_GPGME_
│ │ │ │ │ -0000fa60: 4241 445f 484f 4d45 5f44 4952 270a 2020  BAD_HOME_DIR'.  
│ │ │ │ │ -0000fa70: 2020 2020 2020 2020 556e 6162 6c65 2074          Unable t
│ │ │ │ │ -0000fa80: 6f20 7374 6174 2074 6865 2067 6976 656e  o stat the given
│ │ │ │ │ -0000fa90: 2047 5047 2068 6f6d 6520 6469 7265 6374   GPG home direct
│ │ │ │ │ -0000faa0: 6f72 790a 2020 2020 2027 464b 4f5f 4552  ory.     'FKO_ER
│ │ │ │ │ -0000fab0: 524f 525f 4750 474d 455f 5345 545f 484f  ROR_GPGME_SET_HO
│ │ │ │ │ -0000fac0: 4d45 5f44 4952 270a 2020 2020 2020 2020  ME_DIR'.        
│ │ │ │ │ -0000fad0: 2020 556e 6162 6c65 2074 6f20 7365 7420    Unable to set 
│ │ │ │ │ -0000fae0: 7468 6520 6769 7665 6e20 4750 4720 686f  the given GPG ho
│ │ │ │ │ -0000faf0: 6d65 2064 6972 6563 746f 7279 0a20 2020  me directory.   
│ │ │ │ │ -0000fb00: 2020 2746 4b4f 5f45 5252 4f52 5f47 5047    'FKO_ERROR_GPG
│ │ │ │ │ -0000fb10: 4d45 5f4e 4f5f 5349 474e 4154 5552 4527  ME_NO_SIGNATURE'
│ │ │ │ │ -0000fb20: 0a20 2020 2020 2020 2020 204d 6973 7369  .          Missi
│ │ │ │ │ -0000fb30: 6e67 2047 5047 2073 6967 6e61 7475 7265  ng GPG signature
│ │ │ │ │ -0000fb40: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -0000fb50: 5f47 5047 4d45 5f42 4144 5f53 4947 4e41  _GPGME_BAD_SIGNA
│ │ │ │ │ -0000fb60: 5455 5245 270a 2020 2020 2020 2020 2020  TURE'.          
│ │ │ │ │ -0000fb70: 4261 6420 4750 4720 7369 676e 6174 7572  Bad GPG signatur
│ │ │ │ │ -0000fb80: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO
│ │ │ │ │ -0000fb90: 525f 4750 474d 455f 5349 474e 4154 5552  R_GPGME_SIGNATUR
│ │ │ │ │ -0000fba0: 455f 5645 5249 4659 5f44 4953 4142 4c45  E_VERIFY_DISABLE
│ │ │ │ │ -0000fbb0: 4427 0a20 2020 2020 2020 2020 2054 7279  D'.          Try
│ │ │ │ │ -0000fbc0: 696e 6720 746f 2063 6865 636b 2073 6967  ing to check sig
│ │ │ │ │ -0000fbd0: 6e61 7475 7265 2077 6974 6820 7665 7269  nature with veri
│ │ │ │ │ -0000fbe0: 6669 6361 7469 6f6e 2064 6973 6162 6c65  fication disable
│ │ │ │ │ -0000fbf0: 640a 2020 2020 2027 464b 4f5f 4552 524f  d.     'FKO_ERRO
│ │ │ │ │ -0000fc00: 525f 494e 5641 4c49 445f 4441 5441 5f45  R_INVALID_DATA_E
│ │ │ │ │ -0000fc10: 4e43 5259 5054 5f47 5047 5f4d 4553 5341  NCRYPT_GPG_MESSA
│ │ │ │ │ -0000fc20: 4745 5f56 414c 4944 4641 494c 270a 2020  GE_VALIDFAIL'.  
│ │ │ │ │ -0000fc30: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ -0000fc40: 6461 7461 3a20 656e 6372 7970 743a 2069  data: encrypt: i
│ │ │ │ │ -0000fc50: 6e76 616c 6964 2047 5047 2d65 6e63 7279  nvalid GPG-encry
│ │ │ │ │ -0000fc60: 7074 206d 6573 7361 6765 0a20 2020 2020  pt message.     
│ │ │ │ │ -0000fc70: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ -0000fc80: 4944 5f44 4154 415f 454e 4352 5950 545f  ID_DATA_ENCRYPT_
│ │ │ │ │ -0000fc90: 4750 475f 4449 4745 5354 5f56 414c 4944  GPG_DIGEST_VALID
│ │ │ │ │ -0000fca0: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          
│ │ │ │ │ -0000fcb0: 496e 7661 6c69 6420 6461 7461 3a20 656e  Invalid data: en
│ │ │ │ │ -0000fcc0: 6372 7970 743a 2069 6e76 616c 6964 2047  crypt: invalid G
│ │ │ │ │ -0000fcd0: 5047 2064 6967 6573 740a 2020 2020 2027  PG digest.     '
│ │ │ │ │ -0000fce0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ -0000fcf0: 445f 4441 5441 5f45 4e43 5259 5054 5f47  D_DATA_ENCRYPT_G
│ │ │ │ │ -0000fd00: 5047 5f4d 5347 4c45 4e5f 5641 4c49 4446  PG_MSGLEN_VALIDF
│ │ │ │ │ -0000fd10: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I
│ │ │ │ │ -0000fd20: 6e76 616c 6964 2064 6174 613a 2065 6e63  nvalid data: enc
│ │ │ │ │ -0000fd30: 7279 7074 3a20 696e 7661 6c69 6420 4750  rypt: invalid GP
│ │ │ │ │ -0000fd40: 4720 6d65 7373 6167 6520 6c65 6e67 7468  G message length
│ │ │ │ │ -0000fd50: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -0000fd60: 5f49 4e56 414c 4944 5f44 4154 415f 454e  _INVALID_DATA_EN
│ │ │ │ │ -0000fd70: 4352 5950 545f 4750 475f 5245 5355 4c54  CRYPT_GPG_RESULT
│ │ │ │ │ -0000fd80: 5f4d 5347 4c45 4e5f 5641 4c49 4446 4149  _MSGLEN_VALIDFAI
│ │ │ │ │ -0000fd90: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv
│ │ │ │ │ -0000fda0: 616c 6964 2064 6174 613a 2065 6e63 7279  alid data: encry
│ │ │ │ │ -0000fdb0: 7074 3a20 696e 7661 6c69 6420 4750 4720  pt: invalid GPG 
│ │ │ │ │ -0000fdc0: 7265 7375 6c74 206d 6573 7361 6765 206c  result message l
│ │ │ │ │ -0000fdd0: 656e 6774 680a 2020 2020 2027 464b 4f5f  ength.     'FKO_
│ │ │ │ │ -0000fde0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ -0000fdf0: 5441 5f45 4e43 5259 5054 5f47 5047 5f43  TA_ENCRYPT_GPG_C
│ │ │ │ │ -0000fe00: 4950 4845 525f 4445 434f 4445 4641 494c  IPHER_DECODEFAIL
│ │ │ │ │ -0000fe10: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva
│ │ │ │ │ -0000fe20: 6c69 6420 6461 7461 3a20 656e 6372 7970  lid data: encryp
│ │ │ │ │ -0000fe30: 743a 2047 5047 2063 6970 6865 7220 6661  t: GPG cipher fa
│ │ │ │ │ -0000fe40: 696c 6564 0a20 2020 2020 2746 4b4f 5f45  iled.     'FKO_E
│ │ │ │ │ -0000fe50: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ -0000fe60: 415f 454e 4352 5950 545f 4750 475f 454e  A_ENCRYPT_GPG_EN
│ │ │ │ │ -0000fe70: 434f 4445 444d 5347 5f4e 554c 4c27 0a20  CODEDMSG_NULL'. 
│ │ │ │ │ -0000fe80: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ -0000fe90: 2064 6174 613a 2065 6e63 7279 7074 3a20   data: encrypt: 
│ │ │ │ │ -0000fea0: 4750 472d 656e 636f 6465 6420 6d65 7373  GPG-encoded mess
│ │ │ │ │ -0000feb0: 6167 6520 6973 204e 554c 4c0a 2020 2020  age is NULL.    
│ │ │ │ │ -0000fec0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ -0000fed0: 4c49 445f 4441 5441 5f45 4e43 5259 5054  LID_DATA_ENCRYPT
│ │ │ │ │ -0000fee0: 5f47 5047 5f45 4e43 4f44 4544 4d53 474c  _GPG_ENCODEDMSGL
│ │ │ │ │ -0000fef0: 454e 5f56 414c 4944 4641 494c 270a 2020  EN_VALIDFAIL'.  
│ │ │ │ │ -0000ff00: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ -0000ff10: 6461 7461 3a20 656e 6372 7970 743a 2069  data: encrypt: i
│ │ │ │ │ -0000ff20: 6e76 616c 6964 2047 5047 2d65 6e63 7279  nvalid GPG-encry
│ │ │ │ │ -0000ff30: 7074 6564 206d 6573 7361 6765 206c 656e  pted message len
│ │ │ │ │ -0000ff40: 6774 680a 0a20 2020 596f 7520 6361 6e20  gth..   You can 
│ │ │ │ │ -0000ff50: 7573 6520 7468 6520 2749 535f 4750 474d  use the 'IS_GPGM
│ │ │ │ │ -0000ff60: 455f 4552 524f 5228 6572 725f 636f 6465  E_ERROR(err_code
│ │ │ │ │ -0000ff70: 2927 206d 6163 726f 2074 6f20 6465 7465  )' macro to dete
│ │ │ │ │ -0000ff80: 726d 696e 6520 7768 6574 6865 720a 6f72  rmine whether.or
│ │ │ │ │ -0000ff90: 206e 6f74 2061 6e20 6572 726f 7220 6964   not an error id
│ │ │ │ │ -0000ffa0: 2047 5047 4d45 2072 656c 6174 6564 2e20   GPGME related. 
│ │ │ │ │ -0000ffb0: 2049 6620 7468 6520 6d61 6372 6f20 6576   If the macro ev
│ │ │ │ │ -0000ffc0: 616c 7561 7465 7320 746f 2061 2074 7275  aluates to a tru
│ │ │ │ │ -0000ffd0: 650a 7661 6c75 652c 2079 6f75 206d 6179  e.value, you may
│ │ │ │ │ -0000ffe0: 2062 6520 6162 6c65 2074 6f20 6765 7420   be able to get 
│ │ │ │ │ -0000fff0: 6164 6469 7469 6f6e 616c 2069 6e66 6f72  additional infor
│ │ │ │ │ -00010000: 6d61 7469 6f6e 2061 626f 7574 2074 6865  mation about the
│ │ │ │ │ -00010010: 2065 7272 6f72 0a75 7369 6e67 2074 6865   error.using the
│ │ │ │ │ -00010020: 2066 6f6c 6c6f 7769 6e67 2066 756e 6374   following funct
│ │ │ │ │ -00010030: 696f 6e3a 0a0a 202d 2d20 4675 6e63 7469  ion:.. -- Functi
│ │ │ │ │ -00010040: 6f6e 3a20 636f 6e73 7420 6368 6172 202a  on: const char *
│ │ │ │ │ -00010050: 2066 6b6f 5f67 7067 5f65 7272 7374 7220   fko_gpg_errstr 
│ │ │ │ │ -00010060: 2869 6e74 2045 5252 5f43 4f44 4529 0a20  (int ERR_CODE). 
│ │ │ │ │ -00010070: 2020 2020 5468 6520 6675 6e63 7469 6f6e      The function
│ │ │ │ │ -00010080: 2027 666b 6f5f 6572 7273 7472 2720 7265   'fko_errstr' re
│ │ │ │ │ -00010090: 7475 726e 7320 6120 706f 696e 7465 7220  turns a pointer 
│ │ │ │ │ -000100a0: 746f 2061 2073 7461 7469 6361 6c6c 790a  to a statically.
│ │ │ │ │ -000100b0: 2020 2020 2061 6c6c 6f63 6174 6564 2073       allocated s
│ │ │ │ │ -000100c0: 7472 696e 6720 636f 6e74 6169 6e69 6e67  tring containing
│ │ │ │ │ -000100d0: 2074 6865 2064 6573 6372 6970 7469 6f6e   the description
│ │ │ │ │ -000100e0: 206f 6620 7468 6520 4750 474d 4520 6572   of the GPGME er
│ │ │ │ │ -000100f0: 726f 722e 0a0a 2a4e 6f74 652a 3a20 466f  ror...*Note*: Fo
│ │ │ │ │ -00010100: 7220 736f 6d65 2065 7272 6f72 732c 2074  r some errors, t
│ │ │ │ │ -00010110: 6869 7320 6675 6e63 7469 6f6e 206d 6179  his function may
│ │ │ │ │ -00010120: 2072 6574 7572 6e20 616e 2065 6d70 7479   return an empty
│ │ │ │ │ -00010130: 2073 7472 696e 672e 0a0a 1f0a 4669 6c65   string.....File
│ │ │ │ │ -00010140: 3a20 6c69 6266 6b6f 2e69 6e66 6f2c 2020  : libfko.info,  
│ │ │ │ │ -00010150: 4e6f 6465 3a20 4c69 6272 6172 7920 436f  Node: Library Co
│ │ │ │ │ -00010160: 7079 696e 672c 2020 4e65 7874 3a20 436f  pying,  Next: Co
│ │ │ │ │ -00010170: 6e63 6570 7420 496e 6465 782c 2020 5072  ncept Index,  Pr
│ │ │ │ │ -00010180: 6576 3a20 5573 696e 6720 6c69 6266 6b6f  ev: Using libfko
│ │ │ │ │ -00010190: 2c20 2055 703a 2054 6f70 0a0a 4170 7065  ,  Up: Top..Appe
│ │ │ │ │ -000101a0: 6e64 6978 2041 2047 4e55 2047 454e 4552  ndix A GNU GENER
│ │ │ │ │ -000101b0: 414c 2050 5542 4c49 4320 4c49 4345 4e53  AL PUBLIC LICENS
│ │ │ │ │ -000101c0: 450a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  E.**************
│ │ │ │ │ +0000b8b0: 3d0a 0a54 6869 7320 7365 6374 696f 6e20  =..This section 
│ │ │ │ │ +0000b8c0: 6465 7363 7269 6265 7320 7468 6520 6675  describes the fu
│ │ │ │ │ +0000b8d0: 6e63 7469 6f6e 7320 6e6f 7420 636f 7665  nctions not cove
│ │ │ │ │ +0000b8e0: 7265 6420 656c 7365 7768 6572 6520 696e  red elsewhere in
│ │ │ │ │ +0000b8f0: 2074 6869 730a 6d61 6e75 616c 2e20 2054   this.manual.  T
│ │ │ │ │ +0000b900: 6865 7365 2061 7265 2075 7469 6c69 7479  hese are utility
│ │ │ │ │ +0000b910: 2066 756e 6374 696f 6e73 2074 6861 7420   functions that 
│ │ │ │ │ +0000b920: 6f70 6572 6174 6520 6f6e 2074 6865 2064  operate on the d
│ │ │ │ │ +0000b930: 6174 6120 696e 2074 6865 2066 6b6f 0a63  ata in the fko.c
│ │ │ │ │ +0000b940: 6f6e 7465 7874 2e20 2041 6c6c 2062 7574  ontext.  All but
│ │ │ │ │ +0000b950: 2027 666b 6f5f 7370 615f 6461 7461 5f66   'fko_spa_data_f
│ │ │ │ │ +0000b960: 696e 616c 2720 6172 6520 6361 6c6c 6564  inal' are called
│ │ │ │ │ +0000b970: 2062 7920 6f74 6865 7220 6675 6e63 7469   by other functi
│ │ │ │ │ +0000b980: 6f6e 7320 616e 640a 6172 6520 6e6f 7420  ons and.are not 
│ │ │ │ │ +0000b990: 6e6f 726d 616c 6c79 2065 7870 6c69 6369  normally explici
│ │ │ │ │ +0000b9a0: 746c 7920 6361 6c6c 6564 2062 7920 7468  tly called by th
│ │ │ │ │ +0000b9b0: 6520 7573 6572 2e20 2048 6f77 6576 6572  e user.  However
│ │ │ │ │ +0000b9c0: 2c20 7468 6579 2063 616e 2062 652c 0a73  , they can be,.s
│ │ │ │ │ +0000b9d0: 6f20 7468 6579 2061 7265 206c 6973 7465  o they are liste
│ │ │ │ │ +0000b9e0: 6420 6865 7265 2e0a 0a20 2020 416c 6c20  d here...   All 
│ │ │ │ │ +0000b9f0: 6f66 2074 6865 7365 2066 756e 6374 696f  of these functio
│ │ │ │ │ +0000ba00: 6e73 2072 6574 7572 6e20 616e 2069 6e74  ns return an int
│ │ │ │ │ +0000ba10: 6567 6572 2072 6570 7265 7365 6e74 696e  eger representin
│ │ │ │ │ +0000ba20: 6720 7468 6520 7265 7475 726e 0a73 7461  g the return.sta
│ │ │ │ │ +0000ba30: 7475 7320 6f66 2074 6865 2066 756e 6374  tus of the funct
│ │ │ │ │ +0000ba40: 696f 6e2e 2020 5768 656e 2073 7563 6365  ion.  When succe
│ │ │ │ │ +0000ba50: 7366 756c 6c2c 2074 6865 7920 7769 6c6c  sfull, they will
│ │ │ │ │ +0000ba60: 2072 6574 7572 6e0a 2746 4b4f 5f53 5543   return.'FKO_SUC
│ │ │ │ │ +0000ba70: 4345 5353 272e 2020 4f74 6865 7277 6973  CESS'.  Otherwis
│ │ │ │ │ +0000ba80: 652c 2061 6e20 6572 726f 7220 636f 6465  e, an error code
│ │ │ │ │ +0000ba90: 2076 616c 7565 2069 7320 7265 7475 726e   value is return
│ │ │ │ │ +0000baa0: 6564 2e0a 0a20 2d2d 2046 756e 6374 696f  ed... -- Functio
│ │ │ │ │ +0000bab0: 6e3a 2069 6e74 2066 6b6f 5f73 7061 5f64  n: int fko_spa_d
│ │ │ │ │ +0000bac0: 6174 615f 6669 6e61 6c20 2866 6b6f 5f63  ata_final (fko_c
│ │ │ │ │ +0000bad0: 7478 5f74 2043 5458 2c20 6368 6172 202a  tx_t CTX, char *
│ │ │ │ │ +0000bae0: 454e 435f 4b45 592c 2069 6e74 0a20 2020  ENC_KEY, int.   
│ │ │ │ │ +0000baf0: 2020 2020 2020 204b 454e 5f4c 454e 2c20         KEN_LEN, 
│ │ │ │ │ +0000bb00: 6368 6172 202a 484d 4143 5f4b 4559 2c20  char *HMAC_KEY, 
│ │ │ │ │ +0000bb10: 696e 7420 484d 4143 5f4b 4559 5f4c 454e  int HMAC_KEY_LEN
│ │ │ │ │ +0000bb20: 293b 0a20 2020 2020 5468 6973 2066 756e  );.     This fun
│ │ │ │ │ +0000bb30: 6374 696f 6e20 6973 2074 6865 2066 696e  ction is the fin
│ │ │ │ │ +0000bb40: 616c 2073 7465 7020 696e 2063 7265 6174  al step in creat
│ │ │ │ │ +0000bb50: 696e 6720 6120 636f 6d70 6c65 7465 2065  ing a complete e
│ │ │ │ │ +0000bb60: 6e63 7279 7074 6564 0a20 2020 2020 5350  ncrypted.     SP
│ │ │ │ │ +0000bb70: 4120 6461 7461 2073 7472 696e 6720 7375  A data string su
│ │ │ │ │ +0000bb80: 6974 6162 6c65 2066 6f72 2074 7261 6e73  itable for trans
│ │ │ │ │ +0000bb90: 6d69 7373 696f 6e20 746f 2061 6e20 6677  mission to an fw
│ │ │ │ │ +0000bba0: 6b6e 6f70 2073 6572 7665 722e 2020 4974  knop server.  It
│ │ │ │ │ +0000bbb0: 0a20 2020 2020 646f 6573 2072 6571 7569  .     does requi
│ │ │ │ │ +0000bbc0: 7265 2061 6c6c 206f 6620 7468 6520 7265  re all of the re
│ │ │ │ │ +0000bbd0: 7175 6973 6974 6520 5350 4120 6461 7461  quisite SPA data
│ │ │ │ │ +0000bbe0: 2066 6965 6c64 7320 6265 2073 6574 2c20   fields be set, 
│ │ │ │ │ +0000bbf0: 6f74 6865 7277 6973 650a 2020 2020 2069  otherwise.     i
│ │ │ │ │ +0000bc00: 7420 7769 6c6c 2066 6169 6c20 7769 7468  t will fail with
│ │ │ │ │ +0000bc10: 2061 6e20 6170 7072 6f70 7269 6174 6520   an appropriate 
│ │ │ │ │ +0000bc20: 6572 726f 7220 636f 6465 2e0a 0a20 2d2d  error code... --
│ │ │ │ │ +0000bc30: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f
│ │ │ │ │ +0000bc40: 6b6f 5f64 6563 7279 7074 5f73 7061 5f64  ko_decrypt_spa_d
│ │ │ │ │ +0000bc50: 6174 6120 2866 6b6f 5f63 7478 5f74 2043  ata (fko_ctx_t C
│ │ │ │ │ +0000bc60: 5458 2c20 6368 6172 202a 4445 435f 4b45  TX, char *DEC_KE
│ │ │ │ │ +0000bc70: 592c 0a20 2020 2020 2020 2020 2069 6e74  Y,.          int
│ │ │ │ │ +0000bc80: 204b 4559 5f4c 454e 293b 0a20 2020 2020   KEY_LEN);.     
│ │ │ │ │ +0000bc90: 5768 656e 2067 6976 656e 2074 6865 2063  When given the c
│ │ │ │ │ +0000bca0: 6f72 7265 6374 204b 4559 2028 7061 7373  orrect KEY (pass
│ │ │ │ │ +0000bcb0: 776f 7264 292c 2074 6869 7320 6675 6e63  word), this func
│ │ │ │ │ +0000bcc0: 7469 6f6e 2064 6563 7279 7074 732c 0a20  tion decrypts,. 
│ │ │ │ │ +0000bcd0: 2020 2020 6465 636f 6465 732c 2061 6e64      decodes, and
│ │ │ │ │ +0000bce0: 2070 6172 7365 7320 7468 6520 656e 6372   parses the encr
│ │ │ │ │ +0000bcf0: 7970 7465 6420 5350 4120 6461 7461 2074  ypted SPA data t
│ │ │ │ │ +0000bd00: 6861 7420 7761 7320 7375 7070 6c69 6564  hat was supplied
│ │ │ │ │ +0000bd10: 2074 6f20 7468 650a 2020 2020 2063 6f6e   to the.     con
│ │ │ │ │ +0000bd20: 7465 7874 2076 6961 2074 6865 2027 666b  text via the 'fk
│ │ │ │ │ +0000bd30: 6f5f 6e65 775f 7769 7468 5f64 6174 6127  o_new_with_data'
│ │ │ │ │ +0000bd40: 2066 756e 6374 696f 6e20 7468 6174 2077   function that w
│ │ │ │ │ +0000bd50: 6173 2061 6c73 6f20 6361 6c6c 6564 0a20  as also called. 
│ │ │ │ │ +0000bd60: 2020 2020 7769 7468 6f75 7420 7468 6520      without the 
│ │ │ │ │ +0000bd70: 4b45 5920 7661 6c75 652e 2020 4f6e 6365  KEY value.  Once
│ │ │ │ │ +0000bd80: 2074 6865 2064 6174 6120 6973 2064 6563   the data is dec
│ │ │ │ │ +0000bd90: 7279 7074 6564 2c20 7468 6973 2066 756e  rypted, this fun
│ │ │ │ │ +0000bda0: 6374 696f 6e0a 2020 2020 2077 696c 6c20  ction.     will 
│ │ │ │ │ +0000bdb0: 616c 736f 2063 616c 6c20 2766 6b6f 5f64  also call 'fko_d
│ │ │ │ │ +0000bdc0: 6563 6f64 655f 7370 615f 6461 7461 2720  ecode_spa_data' 
│ │ │ │ │ +0000bdd0: 746f 2064 6563 6f64 652c 2070 6172 7365  to decode, parse
│ │ │ │ │ +0000bde0: 2c20 7661 6c69 6461 7465 2c0a 2020 2020  , validate,.    
│ │ │ │ │ +0000bdf0: 2061 6e64 2073 746f 7265 2074 6865 2064   and store the d
│ │ │ │ │ +0000be00: 6174 6120 6669 656c 6473 2069 6e20 7468  ata fields in th
│ │ │ │ │ +0000be10: 6520 636f 6e74 6578 7420 666f 7220 6c61  e context for la
│ │ │ │ │ +0000be20: 7465 7220 7265 7472 6965 7661 6c2e 0a0a  ter retrieval...
│ │ │ │ │ +0000be30: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ │ +0000be40: 7420 666b 6f5f 656e 6372 7970 745f 7370  t fko_encrypt_sp
│ │ │ │ │ +0000be50: 615f 6461 7461 2028 666b 6f5f 6374 785f  a_data (fko_ctx_
│ │ │ │ │ +0000be60: 7420 4354 582c 2063 6861 7220 2a45 4e43  t CTX, char *ENC
│ │ │ │ │ +0000be70: 5f4b 4559 2c0a 2020 2020 2020 2020 2020  _KEY,.          
│ │ │ │ │ +0000be80: 696e 7420 4b45 595f 4c45 4e29 3b0a 2020  int KEY_LEN);.  
│ │ │ │ │ +0000be90: 2020 2045 6e63 7279 7074 7320 7468 6520     Encrypts the 
│ │ │ │ │ +0000bea0: 696e 7465 726d 6564 6961 7465 2065 6e63  intermediate enc
│ │ │ │ │ +0000beb0: 6f64 6564 2053 5041 2064 6174 6120 7374  oded SPA data st
│ │ │ │ │ +0000bec0: 6f72 6564 2069 6e20 7468 6520 636f 6e74  ored in the cont
│ │ │ │ │ +0000bed0: 6578 742e 0a20 2020 2020 5468 6973 2066  ext..     This f
│ │ │ │ │ +0000bee0: 756e 6374 696f 6e20 7769 6c6c 2063 616c  unction will cal
│ │ │ │ │ +0000bef0: 6c20 2766 6b6f 5f65 6e63 6f64 6527 2069  l 'fko_encode' i
│ │ │ │ │ +0000bf00: 6620 6e65 6365 7373 6172 792e 2020 4974  f necessary.  It
│ │ │ │ │ +0000bf10: 2069 7320 6e6f 726d 616c 6c79 0a20 2020   is normally.   
│ │ │ │ │ +0000bf20: 2020 6e6f 7420 6361 6c6c 6564 2064 6972    not called dir
│ │ │ │ │ +0000bf30: 6563 746c 7920 6173 2069 7420 6973 2063  ectly as it is c
│ │ │ │ │ +0000bf40: 616c 6c65 6420 6672 6f6d 2027 666b 6f5f  alled from 'fko_
│ │ │ │ │ +0000bf50: 7370 615f 6461 7461 5f66 696e 616c 272e  spa_data_final'.
│ │ │ │ │ +0000bf60: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ │ +0000bf70: 696e 7420 666b 6f5f 6465 636f 6465 5f73  int fko_decode_s
│ │ │ │ │ +0000bf80: 7061 5f64 6174 6120 2866 6b6f 5f63 7478  pa_data (fko_ctx
│ │ │ │ │ +0000bf90: 5f74 2043 5458 293b 0a20 2020 2020 5468  _t CTX);.     Th
│ │ │ │ │ +0000bfa0: 6973 2066 756e 6374 696f 6e20 7065 7266  is function perf
│ │ │ │ │ +0000bfb0: 6f72 6d73 2074 6865 2064 6563 6f64 696e  orms the decodin
│ │ │ │ │ +0000bfc0: 672c 2070 6172 7369 6e67 2c20 7661 6c69  g, parsing, vali
│ │ │ │ │ +0000bfd0: 6461 7469 6f6e 206f 6620 7468 6520 5350  dation of the SP
│ │ │ │ │ +0000bfe0: 410a 2020 2020 2064 6174 6120 7468 6174  A.     data that
│ │ │ │ │ +0000bff0: 2077 6173 206a 7573 7420 6465 6372 7970   was just decryp
│ │ │ │ │ +0000c000: 7465 642e 2020 4974 2069 7320 6e6f 726d  ted.  It is norm
│ │ │ │ │ +0000c010: 616c 6c79 206e 6f74 2063 616c 6c65 6420  ally not called 
│ │ │ │ │ +0000c020: 6469 7265 6374 6c79 0a20 2020 2020 6173  directly.     as
│ │ │ │ │ +0000c030: 2069 7420 6973 2063 616c 6c65 6420 6672   it is called fr
│ │ │ │ │ +0000c040: 6f6d 2027 666b 6f5f 6465 6372 7970 745f  om 'fko_decrypt_
│ │ │ │ │ +0000c050: 7370 615f 6461 7461 2720 2877 6869 6368  spa_data' (which
│ │ │ │ │ +0000c060: 2069 7320 696e 2074 7572 6e0a 2020 2020   is in turn.    
│ │ │ │ │ +0000c070: 2063 616c 6c65 6420 6672 6f6d 2027 666b   called from 'fk
│ │ │ │ │ +0000c080: 6f5f 6e65 775f 7769 7468 5f64 6174 6127  o_new_with_data'
│ │ │ │ │ +0000c090: 2069 6620 6120 7061 7373 776f 7264 2069   if a password i
│ │ │ │ │ +0000c0a0: 7320 7375 7070 6c69 6564 2074 6f20 6974  s supplied to it
│ │ │ │ │ +0000c0b0: 292e 0a0a 202d 2d20 4675 6e63 7469 6f6e  )... -- Function
│ │ │ │ │ +0000c0c0: 3a20 696e 7420 666b 6f5f 656e 636f 6465  : int fko_encode
│ │ │ │ │ +0000c0d0: 5f73 7061 5f64 6174 6120 2866 6b6f 5f63  _spa_data (fko_c
│ │ │ │ │ +0000c0e0: 7478 5f74 2043 5458 293b 0a20 2020 2020  tx_t CTX);.     
│ │ │ │ │ +0000c0f0: 5065 7266 6f72 6d73 2074 6865 2062 6173  Performs the bas
│ │ │ │ │ +0000c100: 6536 3420 656e 636f 6469 6e67 206f 6620  e64 encoding of 
│ │ │ │ │ +0000c110: 7468 6f73 6520 5350 4120 6461 7461 2066  those SPA data f
│ │ │ │ │ +0000c120: 6965 6c64 7320 7468 6174 206e 6565 6420  ields that need 
│ │ │ │ │ +0000c130: 746f 0a20 2020 2020 6265 2065 6e63 6f64  to.     be encod
│ │ │ │ │ +0000c140: 6564 2c20 7065 7266 6f72 6d73 2073 6f6d  ed, performs som
│ │ │ │ │ +0000c150: 6520 6461 7461 2076 616c 6964 6174 696f  e data validatio
│ │ │ │ │ +0000c160: 6e2c 2061 6e64 2063 616c 6c73 0a20 2020  n, and calls.   
│ │ │ │ │ +0000c170: 2020 2766 6b70 5f73 6574 5f73 7061 5f64    'fkp_set_spa_d
│ │ │ │ │ +0000c180: 6967 6573 7427 2074 6f20 7265 636f 6d70  igest' to recomp
│ │ │ │ │ +0000c190: 7574 6520 7468 6520 5350 4120 6d65 7373  ute the SPA mess
│ │ │ │ │ +0000c1a0: 6167 6520 6469 6765 7374 2e20 2049 7420  age digest.  It 
│ │ │ │ │ +0000c1b0: 6973 0a20 2020 2020 6e6f 726d 616c 6c79  is.     normally
│ │ │ │ │ +0000c1c0: 206e 6f74 2063 616c 6c65 6420 6469 7265   not called dire
│ │ │ │ │ +0000c1d0: 6374 6c79 2061 7320 6974 2069 7320 6361  ctly as it is ca
│ │ │ │ │ +0000c1e0: 6c6c 6564 2066 726f 6d0a 2020 2020 2027  lled from.     '
│ │ │ │ │ +0000c1f0: 666b 6f5f 656e 6372 7970 745f 7370 615f  fko_encrypt_spa_
│ │ │ │ │ +0000c200: 6461 7461 2720 2877 6869 6368 2069 7320  data' (which is 
│ │ │ │ │ +0000c210: 696e 2074 7572 6e20 6361 6c6c 6564 2066  in turn called f
│ │ │ │ │ +0000c220: 726f 6d0a 2020 2020 2027 666b 6f5f 7370  rom.     'fko_sp
│ │ │ │ │ +0000c230: 615f 6461 7461 5f66 696e 616c 2729 2e0a  a_data_final')..
│ │ │ │ │ +0000c240: 0a5f 4750 472d 7370 6563 6966 6963 2075  ._GPG-specific u
│ │ │ │ │ +0000c250: 7469 6c69 7479 2066 756e 6374 696f 6e73  tility functions
│ │ │ │ │ +0000c260: 3a5f 0a0a 202d 2d20 4675 6e63 7469 6f6e  :_.. -- Function
│ │ │ │ │ +0000c270: 3a20 696e 7420 666b 6f5f 6770 675f 7369  : int fko_gpg_si
│ │ │ │ │ +0000c280: 676e 6174 7572 655f 6964 5f6d 6174 6368  gnature_id_match
│ │ │ │ │ +0000c290: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,
│ │ │ │ │ +0000c2a0: 2063 6f6e 7374 2063 6861 720a 2020 2020   const char.    
│ │ │ │ │ +0000c2b0: 2020 2020 2020 2a49 442c 2075 6e73 6967        *ID, unsig
│ │ │ │ │ +0000c2c0: 6e65 6420 6368 6172 202a 4944 5f4d 4154  ned char *ID_MAT
│ │ │ │ │ +0000c2d0: 4348 293b 0a20 2020 2020 5365 7473 2074  CH);.     Sets t
│ │ │ │ │ +0000c2e0: 6865 2076 616c 7565 206f 6620 7468 6520  he value of the 
│ │ │ │ │ +0000c2f0: 4944 5f4d 4154 4348 2076 6172 6961 626c  ID_MATCH variabl
│ │ │ │ │ +0000c300: 6520 746f 2074 7275 6520 2831 2920 6966  e to true (1) if
│ │ │ │ │ +0000c310: 2074 6865 2076 616c 7565 206f 660a 2020   the value of.  
│ │ │ │ │ +0000c320: 2020 2049 4420 6d61 7463 6865 7320 7468     ID matches th
│ │ │ │ │ +0000c330: 6520 4944 206f 6620 7468 6520 4750 4720  e ID of the GPG 
│ │ │ │ │ +0000c340: 7369 676e 6174 7572 6520 6173 736f 6369  signature associ
│ │ │ │ │ +0000c350: 6174 6564 2077 6974 6820 7468 6520 6375  ated with the cu
│ │ │ │ │ +0000c360: 7272 656e 740a 2020 2020 2063 6f6e 7465  rrent.     conte
│ │ │ │ │ +0000c370: 7874 2e20 204f 7468 6572 7769 7365 2c20  xt.  Otherwise, 
│ │ │ │ │ +0000c380: 4944 5f4d 4154 4348 2069 7320 7365 7420  ID_MATCH is set 
│ │ │ │ │ +0000c390: 746f 2066 616c 7365 2028 3029 2e20 2054  to false (0).  T
│ │ │ │ │ +0000c3a0: 6865 2072 6574 7572 6e0a 2020 2020 2076  he return.     v
│ │ │ │ │ +0000c3b0: 616c 7565 2069 7320 616e 2046 4b4f 2065  alue is an FKO e
│ │ │ │ │ +0000c3c0: 7272 6f72 2073 7461 7475 732e 0a0a 202d  rror status... -
│ │ │ │ │ +0000c3d0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ │ +0000c3e0: 666b 6f5f 6770 675f 7369 676e 6174 7572  fko_gpg_signatur
│ │ │ │ │ +0000c3f0: 655f 6670 725f 6d61 7463 6820 2866 6b6f  e_fpr_match (fko
│ │ │ │ │ +0000c400: 5f63 7478 5f74 2043 5458 2c20 636f 6e73  _ctx_t CTX, cons
│ │ │ │ │ +0000c410: 7420 6368 6172 0a20 2020 2020 2020 2020  t char.         
│ │ │ │ │ +0000c420: 202a 4650 522c 2075 6e73 6967 6e65 6420   *FPR, unsigned 
│ │ │ │ │ +0000c430: 6368 6172 202a 4650 525f 4d41 5443 4829  char *FPR_MATCH)
│ │ │ │ │ +0000c440: 3b0a 2020 2020 2053 6574 7320 7468 6520  ;.     Sets the 
│ │ │ │ │ +0000c450: 7661 6c75 6520 6f66 2074 6865 2046 5052  value of the FPR
│ │ │ │ │ +0000c460: 5f4d 4154 4348 2076 6172 6961 626c 6520  _MATCH variable 
│ │ │ │ │ +0000c470: 746f 2074 7275 6520 2831 2920 6966 2074  to true (1) if t
│ │ │ │ │ +0000c480: 6865 2076 616c 7565 0a20 2020 2020 6f66  he value.     of
│ │ │ │ │ +0000c490: 2046 5052 206d 6174 6368 6573 2074 6865   FPR matches the
│ │ │ │ │ +0000c4a0: 2066 696e 6765 7270 7269 6e74 206f 6620   fingerprint of 
│ │ │ │ │ +0000c4b0: 7468 6520 4750 4720 7369 676e 6174 7572  the GPG signatur
│ │ │ │ │ +0000c4c0: 6520 6173 736f 6369 6174 6564 2077 6974  e associated wit
│ │ │ │ │ +0000c4d0: 680a 2020 2020 2074 6865 2063 7572 7265  h.     the curre
│ │ │ │ │ +0000c4e0: 6e74 2063 6f6e 7465 7874 2e20 204f 7468  nt context.  Oth
│ │ │ │ │ +0000c4f0: 6572 7769 7365 2c20 4650 525f 4d41 5443  erwise, FPR_MATC
│ │ │ │ │ +0000c500: 4820 6973 2073 6574 2074 6f20 6661 6c73  H is set to fals
│ │ │ │ │ +0000c510: 6520 2830 292e 0a20 2020 2020 5468 6520  e (0)..     The 
│ │ │ │ │ +0000c520: 7265 7475 726e 2076 616c 7565 2069 7320  return value is 
│ │ │ │ │ +0000c530: 616e 2046 4b4f 2065 7272 6f72 2073 7461  an FKO error sta
│ │ │ │ │ +0000c540: 7475 732e 0a0a 1f0a 4669 6c65 3a20 6c69  tus.....File: li
│ │ │ │ │ +0000c550: 6266 6b6f 2e69 6e66 6f2c 2020 4e6f 6465  bfko.info,  Node
│ │ │ │ │ +0000c560: 3a20 4572 726f 7220 4861 6e64 6c69 6e67  : Error Handling
│ │ │ │ │ +0000c570: 2c20 2050 7265 763a 2055 7469 6c69 7479  ,  Prev: Utility
│ │ │ │ │ +0000c580: 2046 756e 6374 696f 6e73 2c20 2055 703a   Functions,  Up:
│ │ │ │ │ +0000c590: 2055 7369 6e67 206c 6962 666b 6f0a 0a33   Using libfko..3
│ │ │ │ │ +0000c5a0: 2e37 2045 7272 6f72 2048 616e 646c 696e  .7 Error Handlin
│ │ │ │ │ +0000c5b0: 670a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  g.==============
│ │ │ │ │ +0000c5c0: 3d3d 3d3d 0a0a 4d6f 7374 2066 6b6f 2066  ====..Most fko f
│ │ │ │ │ +0000c5d0: 756e 6374 696f 6e73 2072 6574 7572 6e20  unctions return 
│ │ │ │ │ +0000c5e0: 616e 2069 6e74 6567 6572 2076 616c 7565  an integer value
│ │ │ │ │ +0000c5f0: 2074 6861 7420 636f 7272 6573 706f 6e64   that correspond
│ │ │ │ │ +0000c600: 7320 746f 2065 6974 6865 720a 7375 6363  s to either.succ
│ │ │ │ │ +0000c610: 6573 7320 2830 292c 206f 7220 6f6e 6520  ess (0), or one 
│ │ │ │ │ +0000c620: 6f66 2074 6865 206e 6f6e 2d7a 6572 6f20  of the non-zero 
│ │ │ │ │ +0000c630: 7661 6c75 6573 2074 6861 7220 636f 7272  values thar corr
│ │ │ │ │ +0000c640: 6573 706f 6e64 7320 746f 2061 206e 756d  esponds to a num
│ │ │ │ │ +0000c650: 6265 720a 6f66 2070 6f73 7369 626c 6520  ber.of possible 
│ │ │ │ │ +0000c660: 6572 726f 7273 2e20 206c 6962 666b 6f20  errors.  libfko 
│ │ │ │ │ +0000c670: 7072 6f76 6964 6573 2061 2066 756e 6374  provides a funct
│ │ │ │ │ +0000c680: 696f 6e20 746f 2067 6574 2061 2064 6573  ion to get a des
│ │ │ │ │ +0000c690: 6372 6970 7469 7665 0a73 7472 696e 6720  criptive.string 
│ │ │ │ │ +0000c6a0: 666f 7220 7468 6520 6769 7665 6e20 6572  for the given er
│ │ │ │ │ +0000c6b0: 726f 7220 636f 6465 2e0a 0a20 2d2d 2046  ror code... -- F
│ │ │ │ │ +0000c6c0: 756e 6374 696f 6e3a 2063 6f6e 7374 2063  unction: const c
│ │ │ │ │ +0000c6d0: 6861 7220 2a20 666b 6f5f 6572 7273 7472  har * fko_errstr
│ │ │ │ │ +0000c6e0: 2028 696e 7420 4552 525f 434f 4445 290a   (int ERR_CODE).
│ │ │ │ │ +0000c6f0: 2020 2020 2054 6865 2066 756e 6374 696f       The functio
│ │ │ │ │ +0000c700: 6e20 2766 6b6f 5f65 7272 7374 7227 2072  n 'fko_errstr' r
│ │ │ │ │ +0000c710: 6574 7572 6e73 2061 2070 6f69 6e74 6572  eturns a pointer
│ │ │ │ │ +0000c720: 2074 6f20 6120 7374 6174 6963 616c 6c79   to a statically
│ │ │ │ │ +0000c730: 0a20 2020 2020 616c 6c6f 6361 7465 6420  .     allocated 
│ │ │ │ │ +0000c740: 7374 7269 6e67 2063 6f6e 7461 696e 696e  string containin
│ │ │ │ │ +0000c750: 6720 7468 6520 6465 7363 7269 7074 696f  g the descriptio
│ │ │ │ │ +0000c760: 6e20 6f66 2074 6865 2065 7272 6f72 2e0a  n of the error..
│ │ │ │ │ +0000c770: 0a54 6865 206c 6973 7420 6f66 2074 6865  .The list of the
│ │ │ │ │ +0000c780: 2070 6f73 7369 626c 6520 6572 726f 7220   possible error 
│ │ │ │ │ +0000c790: 636f 6465 7320 616e 6420 7468 6569 7220  codes and their 
│ │ │ │ │ +0000c7a0: 636f 7272 6573 706f 6e64 696e 670a 6465  corresponding.de
│ │ │ │ │ +0000c7b0: 7363 7269 7074 696f 6e73 2061 7320 7265  scriptions as re
│ │ │ │ │ +0000c7c0: 7475 726e 6564 2062 7920 2766 6b6f 5f65  turned by 'fko_e
│ │ │ │ │ +0000c7d0: 7272 7374 7227 2066 6f6c 6c6f 7773 3a0a  rrstr' follows:.
│ │ │ │ │ +0000c7e0: 0a20 2d2d 2056 6172 6961 626c 653a 2069  . -- Variable: i
│ │ │ │ │ +0000c7f0: 6e74 2065 7272 6f72 5f63 6f64 650a 2020  nt error_code.  
│ │ │ │ │ +0000c800: 2020 2027 464b 4f5f 5355 4343 4553 5327     'FKO_SUCCESS'
│ │ │ │ │ +0000c810: 0a20 2020 2020 2020 2020 2053 7563 6365  .          Succe
│ │ │ │ │ +0000c820: 7373 0a20 2020 2020 2746 4b4f 5f45 5252  ss.     'FKO_ERR
│ │ │ │ │ +0000c830: 4f52 5f43 5458 5f4e 4f54 5f49 4e49 5449  OR_CTX_NOT_INITI
│ │ │ │ │ +0000c840: 414c 495a 4544 270a 2020 2020 2020 2020  ALIZED'.        
│ │ │ │ │ +0000c850: 2020 464b 4f20 436f 6e74 6578 7420 6973    FKO Context is
│ │ │ │ │ +0000c860: 206e 6f74 2069 6e69 7469 616c 697a 6564   not initialized
│ │ │ │ │ +0000c870: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ +0000c880: 5f4d 454d 4f52 595f 414c 4c4f 4341 5449  _MEMORY_ALLOCATI
│ │ │ │ │ +0000c890: 4f4e 270a 2020 2020 2020 2020 2020 556e  ON'.          Un
│ │ │ │ │ +0000c8a0: 6162 6c65 2074 6f20 616c 6c6f 6361 7465  able to allocate
│ │ │ │ │ +0000c8b0: 206d 656d 6f72 790a 2020 2020 2027 464b   memory.     'FK
│ │ │ │ │ +0000c8c0: 4f5f 4552 524f 525f 4649 4c45 5359 5354  O_ERROR_FILESYST
│ │ │ │ │ +0000c8d0: 454d 5f4f 5045 5241 5449 4f4e 270a 2020  EM_OPERATION'.  
│ │ │ │ │ +0000c8e0: 2020 2020 2020 2020 5265 6164 2f77 7269          Read/wri
│ │ │ │ │ +0000c8f0: 7465 2062 7974 6573 206d 6973 6d61 7463  te bytes mismatc
│ │ │ │ │ +0000c900: 680a 2020 2020 2027 464b 4f5f 4552 524f  h.     'FKO_ERRO
│ │ │ │ │ +0000c910: 525f 494e 5641 4c49 445f 4441 5441 270a  R_INVALID_DATA'.
│ │ │ │ │ +0000c920: 2020 2020 2020 2020 2020 4172 6773 2063            Args c
│ │ │ │ │ +0000c930: 6f6e 7461 696e 2069 6e76 616c 6964 2064  ontain invalid d
│ │ │ │ │ +0000c940: 6174 610a 2020 2020 2027 464b 4f5f 4552  ata.     'FKO_ER
│ │ │ │ │ +0000c950: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ +0000c960: 5f43 4c49 454e 545f 5449 4d45 4f55 545f  _CLIENT_TIMEOUT_
│ │ │ │ │ +0000c970: 4e45 4741 5449 5645 270a 2020 2020 2020  NEGATIVE'.      
│ │ │ │ │ +0000c980: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ +0000c990: 3a20 6e65 6761 7469 7665 2074 696d 656f  : negative timeo
│ │ │ │ │ +0000c9a0: 7574 2076 616c 7565 0a20 2020 2020 2746  ut value.     'F
│ │ │ │ │ +0000c9b0: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ +0000c9c0: 5f44 4154 415f 4445 434f 4445 5f4d 5347  _DATA_DECODE_MSG
│ │ │ │ │ +0000c9d0: 4c45 4e5f 5641 4c49 4446 4149 4c27 0a20  LEN_VALIDFAIL'. 
│ │ │ │ │ +0000c9e0: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ +0000c9f0: 2064 6174 613a 2069 6e76 616c 6964 206d   data: invalid m
│ │ │ │ │ +0000ca00: 6573 7361 6765 206c 656e 6774 680a 2020  essage length.  
│ │ │ │ │ +0000ca10: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ +0000ca20: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD
│ │ │ │ │ +0000ca30: 455f 4e4f 4e5f 4153 4349 4927 0a20 2020  E_NON_ASCII'.   
│ │ │ │ │ +0000ca40: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d
│ │ │ │ │ +0000ca50: 6174 613a 2063 6f6e 7461 696e 7320 6e6f  ata: contains no
│ │ │ │ │ +0000ca60: 6e2d 6173 6369 6920 6368 6172 6163 7465  n-ascii characte
│ │ │ │ │ +0000ca70: 7273 0a20 2020 2020 2746 4b4f 5f45 5252  rs.     'FKO_ERR
│ │ │ │ │ +0000ca80: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_
│ │ │ │ │ +0000ca90: 4445 434f 4445 5f4c 545f 4d49 4e5f 4649  DECODE_LT_MIN_FI
│ │ │ │ │ +0000caa0: 454c 4453 270a 2020 2020 2020 2020 2020  ELDS'.          
│ │ │ │ │ +0000cab0: 496e 7661 6c69 6420 6461 7461 3a20 696e  Invalid data: in
│ │ │ │ │ +0000cac0: 7375 6666 6963 6965 6e74 206e 756d 6265  sufficient numbe
│ │ │ │ │ +0000cad0: 7220 6f66 2064 6174 6120 6669 656c 6473  r of data fields
│ │ │ │ │ +0000cae0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ +0000caf0: 5f49 4e56 414c 4944 5f44 4154 415f 4445  _INVALID_DATA_DE
│ │ │ │ │ +0000cb00: 434f 4445 5f47 545f 4d41 585f 4649 454c  CODE_GT_MAX_FIEL
│ │ │ │ │ +0000cb10: 4453 270a 2020 2020 2020 2020 2020 496e  DS'.          In
│ │ │ │ │ +0000cb20: 7661 6c69 6420 6461 7461 3a20 746f 6f20  valid data: too 
│ │ │ │ │ +0000cb30: 6d61 6e79 2064 6174 6120 6669 656c 6473  many data fields
│ │ │ │ │ +0000cb40: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ +0000cb50: 5f49 4e56 414c 4944 5f44 4154 415f 4445  _INVALID_DATA_DE
│ │ │ │ │ +0000cb60: 434f 4445 5f57 524f 4e47 5f4e 554d 5f46  CODE_WRONG_NUM_F
│ │ │ │ │ +0000cb70: 4945 4c44 5327 0a20 2020 2020 2020 2020  IELDS'.         
│ │ │ │ │ +0000cb80: 2049 6e76 616c 6964 2064 6174 613a 2069   Invalid data: i
│ │ │ │ │ +0000cb90: 6e76 616c 6964 206e 756d 6265 7220 6f66  nvalid number of
│ │ │ │ │ +0000cba0: 2066 6965 6c64 730a 2020 2020 2027 464b   fields.     'FK
│ │ │ │ │ +0000cbb0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ +0000cbc0: 4441 5441 5f44 4543 4f44 455f 454e 435f  DATA_DECODE_ENC_
│ │ │ │ │ +0000cbd0: 4d53 475f 4c45 4e5f 4d54 5f54 5f53 495a  MSG_LEN_MT_T_SIZ
│ │ │ │ │ +0000cbe0: 4527 0a20 2020 2020 2020 2020 2049 6e76  E'.          Inv
│ │ │ │ │ +0000cbf0: 616c 6964 2064 6174 613a 2064 6563 6f64  alid data: decod
│ │ │ │ │ +0000cc00: 653a 2065 6e63 6f64 6564 206d 6573 7361  e: encoded messa
│ │ │ │ │ +0000cc10: 6765 202d 2064 6967 6573 7420 7369 7a65  ge - digest size
│ │ │ │ │ +0000cc20: 2069 7320 6e6f 740a 2020 2020 2020 2020   is not.        
│ │ │ │ │ +0000cc30: 2020 7661 6c69 640a 2020 2020 2027 464b    valid.     'FK
│ │ │ │ │ +0000cc40: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ +0000cc50: 4441 5441 5f44 4543 4f44 455f 5241 4e44  DATA_DECODE_RAND
│ │ │ │ │ +0000cc60: 5f4d 4953 5349 4e47 270a 2020 2020 2020  _MISSING'.      
│ │ │ │ │ +0000cc70: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ +0000cc80: 3a20 6465 636f 6465 3a20 6d69 7373 696e  : decode: missin
│ │ │ │ │ +0000cc90: 6720 7261 6e64 6f6d 2064 6174 610a 2020  g random data.  
│ │ │ │ │ +0000cca0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ +0000ccb0: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD
│ │ │ │ │ +0000ccc0: 455f 5553 4552 4e41 4d45 5f4d 4953 5349  E_USERNAME_MISSI
│ │ │ │ │ +0000ccd0: 4e47 270a 2020 2020 2020 2020 2020 496e  NG'.          In
│ │ │ │ │ +0000cce0: 7661 6c69 6420 6461 7461 3a20 6465 636f  valid data: deco
│ │ │ │ │ +0000ccf0: 6465 3a20 6d69 7373 696e 6720 7573 6572  de: missing user
│ │ │ │ │ +0000cd00: 6e61 6d65 0a20 2020 2020 2746 4b4f 5f45  name.     'FKO_E
│ │ │ │ │ +0000cd10: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ +0000cd20: 415f 4445 434f 4445 5f55 5345 524e 414d  A_DECODE_USERNAM
│ │ │ │ │ +0000cd30: 455f 544f 4f42 4947 270a 2020 2020 2020  E_TOOBIG'.      
│ │ │ │ │ +0000cd40: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ +0000cd50: 3a20 6465 636f 6465 3a20 7573 6572 6e61  : decode: userna
│ │ │ │ │ +0000cd60: 6d65 2074 6f20 6c61 7267 650a 2020 2020  me to large.    
│ │ │ │ │ +0000cd70: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ +0000cd80: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_
│ │ │ │ │ +0000cd90: 5553 4552 4e41 4d45 5f44 4543 4f44 4546  USERNAME_DECODEF
│ │ │ │ │ +0000cda0: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I
│ │ │ │ │ +0000cdb0: 6e76 616c 6964 2064 6174 613a 2064 6563  nvalid data: dec
│ │ │ │ │ +0000cdc0: 6f64 653a 2066 6169 6c65 6420 746f 2064  ode: failed to d
│ │ │ │ │ +0000cdd0: 6563 6f64 6520 7573 6572 6e61 6d65 0a20  ecode username. 
│ │ │ │ │ +0000cde0: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ +0000cdf0: 4e56 414c 4944 5f44 4154 415f 4445 434f  NVALID_DATA_DECO
│ │ │ │ │ +0000ce00: 4445 5f55 5345 524e 414d 455f 5641 4c49  DE_USERNAME_VALI
│ │ │ │ │ +0000ce10: 4446 4149 4c27 0a20 2020 2020 2020 2020  DFAIL'.         
│ │ │ │ │ +0000ce20: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d
│ │ │ │ │ +0000ce30: 6563 6f64 653a 2069 6e76 616c 6964 2075  ecode: invalid u
│ │ │ │ │ +0000ce40: 7365 726e 616d 650a 2020 2020 2027 464b  sername.     'FK
│ │ │ │ │ +0000ce50: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ +0000ce60: 4441 5441 5f44 4543 4f44 455f 5449 4d45  DATA_DECODE_TIME
│ │ │ │ │ +0000ce70: 5354 414d 505f 4d49 5353 494e 4727 0a20  STAMP_MISSING'. 
│ │ │ │ │ +0000ce80: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ +0000ce90: 2064 6174 613a 2064 6563 6f64 653a 206d   data: decode: m
│ │ │ │ │ +0000cea0: 6973 7369 6e67 2074 696d 6573 7461 6d70  issing timestamp
│ │ │ │ │ +0000ceb0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ +0000cec0: 5f49 4e56 414c 4944 5f44 4154 415f 4445  _INVALID_DATA_DE
│ │ │ │ │ +0000ced0: 434f 4445 5f54 494d 4553 5441 4d50 5f54  CODE_TIMESTAMP_T
│ │ │ │ │ +0000cee0: 4f4f 4249 4727 0a20 2020 2020 2020 2020  OOBIG'.         
│ │ │ │ │ +0000cef0: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d
│ │ │ │ │ +0000cf00: 6563 6f64 653a 2074 696d 6573 7461 6d70  ecode: timestamp
│ │ │ │ │ +0000cf10: 2074 6f6f 206c 6172 6765 0a20 2020 2020   too large.     
│ │ │ │ │ +0000cf20: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ +0000cf30: 4944 5f44 4154 415f 4445 434f 4445 5f54  ID_DATA_DECODE_T
│ │ │ │ │ +0000cf40: 494d 4553 5441 4d50 5f44 4543 4f44 4546  IMESTAMP_DECODEF
│ │ │ │ │ +0000cf50: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I
│ │ │ │ │ +0000cf60: 6e76 616c 6964 2064 6174 613a 2064 6563  nvalid data: dec
│ │ │ │ │ +0000cf70: 6f64 653a 2066 6169 6c65 6420 746f 2064  ode: failed to d
│ │ │ │ │ +0000cf80: 6563 6f64 6520 7469 6d65 7374 616d 700a  ecode timestamp.
│ │ │ │ │ +0000cf90: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ +0000cfa0: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC
│ │ │ │ │ +0000cfb0: 4f44 455f 5645 5253 494f 4e5f 4d49 5353  ODE_VERSION_MISS
│ │ │ │ │ +0000cfc0: 494e 4727 0a20 2020 2020 2020 2020 2049  ING'.          I
│ │ │ │ │ +0000cfd0: 6e76 616c 6964 2064 6174 613a 2064 6563  nvalid data: dec
│ │ │ │ │ +0000cfe0: 6f64 653a 206d 6973 7369 6e67 2076 6572  ode: missing ver
│ │ │ │ │ +0000cff0: 7369 6f6e 2064 6174 610a 2020 2020 2027  sion data.     '
│ │ │ │ │ +0000d000: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ +0000d010: 445f 4441 5441 5f44 4543 4f44 455f 5645  D_DATA_DECODE_VE
│ │ │ │ │ +0000d020: 5253 494f 4e5f 544f 4f42 4947 270a 2020  RSION_TOOBIG'.  
│ │ │ │ │ +0000d030: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ +0000d040: 6461 7461 3a20 6465 636f 6465 3a20 7665  data: decode: ve
│ │ │ │ │ +0000d050: 7273 696f 6e20 6461 7461 2069 7320 746f  rsion data is to
│ │ │ │ │ +0000d060: 6f20 6c61 7267 650a 2020 2020 2027 464b  o large.     'FK
│ │ │ │ │ +0000d070: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ +0000d080: 4441 5441 5f44 4543 4f44 455f 4d53 4754  DATA_DECODE_MSGT
│ │ │ │ │ +0000d090: 5950 455f 4d49 5353 494e 4727 0a20 2020  YPE_MISSING'.   
│ │ │ │ │ +0000d0a0: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d
│ │ │ │ │ +0000d0b0: 6174 613a 2064 6563 6f64 653a 206d 6973  ata: decode: mis
│ │ │ │ │ +0000d0c0: 7369 6e67 206d 6573 7361 6765 2074 7970  sing message typ
│ │ │ │ │ +0000d0d0: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO
│ │ │ │ │ +0000d0e0: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D
│ │ │ │ │ +0000d0f0: 4543 4f44 455f 4d53 4754 5950 455f 544f  ECODE_MSGTYPE_TO
│ │ │ │ │ +0000d100: 4f42 4947 270a 2020 2020 2020 2020 2020  OBIG'.          
│ │ │ │ │ +0000d110: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de
│ │ │ │ │ +0000d120: 636f 6465 3a20 6d65 7373 6167 6520 7479  code: message ty
│ │ │ │ │ +0000d130: 7065 2069 7320 746f 6f20 6c61 7267 650a  pe is too large.
│ │ │ │ │ +0000d140: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ +0000d150: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC
│ │ │ │ │ +0000d160: 4f44 455f 4d53 4754 5950 455f 4445 434f  ODE_MSGTYPE_DECO
│ │ │ │ │ +0000d170: 4445 4641 494c 270a 2020 2020 2020 2020  DEFAIL'.        
│ │ │ │ │ +0000d180: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ +0000d190: 6465 636f 6465 3a20 6661 696c 6564 2074  decode: failed t
│ │ │ │ │ +0000d1a0: 6f20 6465 636f 6465 206d 6573 7361 6765  o decode message
│ │ │ │ │ +0000d1b0: 2074 7970 650a 2020 2020 2027 464b 4f5f   type.     'FKO_
│ │ │ │ │ +0000d1c0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ +0000d1d0: 5441 5f44 4543 4f44 455f 4d45 5353 4147  TA_DECODE_MESSAG
│ │ │ │ │ +0000d1e0: 455f 4d49 5353 494e 4727 0a20 2020 2020  E_MISSING'.     
│ │ │ │ │ +0000d1f0: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat
│ │ │ │ │ +0000d200: 613a 2064 6563 6f64 653a 206d 6973 7369  a: decode: missi
│ │ │ │ │ +0000d210: 6e67 206d 6573 7361 6765 2064 6174 610a  ng message data.
│ │ │ │ │ +0000d220: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ +0000d230: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC
│ │ │ │ │ +0000d240: 4f44 455f 4d45 5353 4147 455f 544f 4f42  ODE_MESSAGE_TOOB
│ │ │ │ │ +0000d250: 4947 270a 2020 2020 2020 2020 2020 496e  IG'.          In
│ │ │ │ │ +0000d260: 7661 6c69 6420 6461 7461 3a20 6465 636f  valid data: deco
│ │ │ │ │ +0000d270: 6465 3a20 6d65 7373 6167 6520 6461 7461  de: message data
│ │ │ │ │ +0000d280: 2069 7320 746f 6f20 6c61 7267 650a 2020   is too large.  
│ │ │ │ │ +0000d290: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ +0000d2a0: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD
│ │ │ │ │ +0000d2b0: 455f 4d45 5353 4147 455f 4445 434f 4445  E_MESSAGE_DECODE
│ │ │ │ │ +0000d2c0: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          
│ │ │ │ │ +0000d2d0: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de
│ │ │ │ │ +0000d2e0: 636f 6465 3a20 6661 696c 6564 2074 6f20  code: failed to 
│ │ │ │ │ +0000d2f0: 6465 636f 6465 206d 6573 7361 6765 2064  decode message d
│ │ │ │ │ +0000d300: 6174 610a 2020 2020 2027 464b 4f5f 4552  ata.     'FKO_ER
│ │ │ │ │ +0000d310: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ +0000d320: 5f44 4543 4f44 455f 4d45 5353 4147 455f  _DECODE_MESSAGE_
│ │ │ │ │ +0000d330: 5641 4c49 4446 4149 4c27 0a20 2020 2020  VALIDFAIL'.     
│ │ │ │ │ +0000d340: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat
│ │ │ │ │ +0000d350: 613a 2064 6563 6f64 653a 2069 6e76 616c  a: decode: inval
│ │ │ │ │ +0000d360: 6964 206d 6573 7361 6765 2064 6174 610a  id message data.
│ │ │ │ │ +0000d370: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ +0000d380: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC
│ │ │ │ │ +0000d390: 4f44 455f 4143 4345 5353 5f56 414c 4944  ODE_ACCESS_VALID
│ │ │ │ │ +0000d3a0: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          
│ │ │ │ │ +0000d3b0: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de
│ │ │ │ │ +0000d3c0: 636f 6465 3a20 696e 766c 6961 6420 6163  code: invliad ac
│ │ │ │ │ +0000d3d0: 6365 7373 2064 6174 610a 2020 2020 2027  cess data.     '
│ │ │ │ │ +0000d3e0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ +0000d3f0: 445f 4441 5441 5f44 4543 4f44 455f 4e41  D_DATA_DECODE_NA
│ │ │ │ │ +0000d400: 5441 4343 4553 535f 4d49 5353 494e 4727  TACCESS_MISSING'
│ │ │ │ │ +0000d410: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ +0000d420: 6964 2064 6174 613a 2064 6563 6f64 653a  id data: decode:
│ │ │ │ │ +0000d430: 206d 6973 7369 6e67 204e 4154 2061 6363   missing NAT acc
│ │ │ │ │ +0000d440: 6573 7320 6461 7461 0a20 2020 2020 2746  ess data.     'F
│ │ │ │ │ +0000d450: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ +0000d460: 5f44 4154 415f 4445 434f 4445 5f4e 4154  _DATA_DECODE_NAT
│ │ │ │ │ +0000d470: 4143 4345 5353 5f54 4f4f 4249 4727 0a20  ACCESS_TOOBIG'. 
│ │ │ │ │ +0000d480: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ +0000d490: 2064 6174 613a 2064 6563 6f64 653a 204e   data: decode: N
│ │ │ │ │ +0000d4a0: 4154 2061 6363 6573 7320 6461 7461 2069  AT access data i
│ │ │ │ │ +0000d4b0: 7320 746f 6f20 6c61 7267 650a 2020 2020  s too large.    
│ │ │ │ │ +0000d4c0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ +0000d4d0: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_
│ │ │ │ │ +0000d4e0: 4e41 5441 4343 4553 535f 4445 434f 4445  NATACCESS_DECODE
│ │ │ │ │ +0000d4f0: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          
│ │ │ │ │ +0000d500: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de
│ │ │ │ │ +0000d510: 636f 6465 3a20 6661 696c 6564 2074 6f20  code: failed to 
│ │ │ │ │ +0000d520: 6465 636f 6465 204e 4154 2061 6363 6573  decode NAT acces
│ │ │ │ │ +0000d530: 7320 6461 7461 0a20 2020 2020 2746 4b4f  s data.     'FKO
│ │ │ │ │ +0000d540: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ +0000d550: 4154 415f 4445 434f 4445 5f4e 4154 4143  ATA_DECODE_NATAC
│ │ │ │ │ +0000d560: 4345 5353 5f56 414c 4944 4641 494c 270a  CESS_VALIDFAIL'.
│ │ │ │ │ +0000d570: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ +0000d580: 6420 6461 7461 3a20 6465 636f 6465 3a20  d data: decode: 
│ │ │ │ │ +0000d590: 696e 7661 6c69 6420 4e41 5420 6163 6365  invalid NAT acce
│ │ │ │ │ +0000d5a0: 7373 0a20 2020 2020 2746 4b4f 5f45 5252  ss.     'FKO_ERR
│ │ │ │ │ +0000d5b0: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_
│ │ │ │ │ +0000d5c0: 4445 434f 4445 5f53 5256 4155 5448 5f4d  DECODE_SRVAUTH_M
│ │ │ │ │ +0000d5d0: 4953 5349 4e47 270a 2020 2020 2020 2020  ISSING'.        
│ │ │ │ │ +0000d5e0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ +0000d5f0: 6465 636f 6465 3a20 6d69 7373 696e 6720  decode: missing 
│ │ │ │ │ +0000d600: 7365 7276 6572 2061 7574 680a 2020 2020  server auth.    
│ │ │ │ │ +0000d610: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ +0000d620: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_
│ │ │ │ │ +0000d630: 5352 5641 5554 485f 4445 434f 4445 4641  SRVAUTH_DECODEFA
│ │ │ │ │ +0000d640: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In
│ │ │ │ │ +0000d650: 7661 6c69 6420 6461 7461 3a20 6465 636f  valid data: deco
│ │ │ │ │ +0000d660: 6465 3a20 7365 7276 6572 2061 7574 6820  de: server auth 
│ │ │ │ │ +0000d670: 6465 636f 6465 2066 6169 6c0a 2020 2020  decode fail.    
│ │ │ │ │ +0000d680: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ +0000d690: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_
│ │ │ │ │ +0000d6a0: 5350 415f 4558 5452 415f 544f 4f42 4947  SPA_EXTRA_TOOBIG
│ │ │ │ │ +0000d6b0: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva
│ │ │ │ │ +0000d6c0: 6c69 6420 6461 7461 3a20 6465 636f 6465  lid data: decode
│ │ │ │ │ +0000d6d0: 3a20 5350 4120 6578 7472 6120 746f 6f20  : SPA extra too 
│ │ │ │ │ +0000d6e0: 6c61 7267 650a 2020 2020 2027 464b 4f5f  large.     'FKO_
│ │ │ │ │ +0000d6f0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ +0000d700: 5441 5f44 4543 4f44 455f 4558 5452 415f  TA_DECODE_EXTRA_
│ │ │ │ │ +0000d710: 544f 4f42 4947 270a 2020 2020 2020 2020  TOOBIG'.        
│ │ │ │ │ +0000d720: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ +0000d730: 6465 636f 6465 3a20 6578 7472 6120 746f  decode: extra to
│ │ │ │ │ +0000d740: 6f20 6c61 7267 650a 2020 2020 2027 464b  o large.     'FK
│ │ │ │ │ +0000d750: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ +0000d760: 4441 5441 5f44 4543 4f44 455f 4558 5452  DATA_DECODE_EXTR
│ │ │ │ │ +0000d770: 415f 4445 434f 4445 4641 494c 270a 2020  A_DECODEFAIL'.  
│ │ │ │ │ +0000d780: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ +0000d790: 6461 7461 3a20 6465 636f 6465 3a20 6578  data: decode: ex
│ │ │ │ │ +0000d7a0: 7472 6120 6465 636f 6465 2066 6169 6c65  tra decode faile
│ │ │ │ │ +0000d7b0: 640a 2020 2020 2027 464b 4f5f 4552 524f  d.     'FKO_ERRO
│ │ │ │ │ +0000d7c0: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D
│ │ │ │ │ +0000d7d0: 4543 4f44 455f 5449 4d45 4f55 545f 4d49  ECODE_TIMEOUT_MI
│ │ │ │ │ +0000d7e0: 5353 494e 4727 0a20 2020 2020 2020 2020  SSING'.         
│ │ │ │ │ +0000d7f0: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d
│ │ │ │ │ +0000d800: 6563 6f64 653a 206d 6973 7369 6e67 2074  ecode: missing t
│ │ │ │ │ +0000d810: 696d 656f 7574 0a20 2020 2020 2746 4b4f  imeout.     'FKO
│ │ │ │ │ +0000d820: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ +0000d830: 4154 415f 4445 434f 4445 5f54 494d 454f  ATA_DECODE_TIMEO
│ │ │ │ │ +0000d840: 5554 5f54 4f4f 4249 4727 0a20 2020 2020  UT_TOOBIG'.     
│ │ │ │ │ +0000d850: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat
│ │ │ │ │ +0000d860: 613a 2064 6563 6f64 6520 7469 6d65 6f75  a: decode timeou
│ │ │ │ │ +0000d870: 7420 7661 6c75 6520 6973 2074 6f6f 206c  t value is too l
│ │ │ │ │ +0000d880: 6172 6765 0a20 2020 2020 2746 4b4f 5f45  arge.     'FKO_E
│ │ │ │ │ +0000d890: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ +0000d8a0: 415f 4445 434f 4445 5f54 494d 454f 5554  A_DECODE_TIMEOUT
│ │ │ │ │ +0000d8b0: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    
│ │ │ │ │ +0000d8c0: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ +0000d8d0: 7461 3a20 6465 636f 6465 2069 6e76 616c  ta: decode inval
│ │ │ │ │ +0000d8e0: 6964 2074 696d 656f 7574 0a20 2020 2020  id timeout.     
│ │ │ │ │ +0000d8f0: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ +0000d900: 4944 5f44 4154 415f 4445 434f 4445 5f54  ID_DATA_DECODE_T
│ │ │ │ │ +0000d910: 494d 454f 5554 5f44 4543 4f44 4546 4149  IMEOUT_DECODEFAI
│ │ │ │ │ +0000d920: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv
│ │ │ │ │ +0000d930: 616c 6964 2064 6174 613a 2064 6563 6f64  alid data: decod
│ │ │ │ │ +0000d940: 653a 2074 696d 656f 7574 2064 6563 6f64  e: timeout decod
│ │ │ │ │ +0000d950: 6520 6661 696c 6564 0a20 2020 2020 2746  e failed.     'F
│ │ │ │ │ +0000d960: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ +0000d970: 5f44 4154 415f 454e 434f 4445 5f4d 4553  _DATA_ENCODE_MES
│ │ │ │ │ +0000d980: 5341 4745 5f54 4f4f 4249 4727 0a20 2020  SAGE_TOOBIG'.   
│ │ │ │ │ +0000d990: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d
│ │ │ │ │ +0000d9a0: 6174 613a 2065 6e63 6f64 653a 206d 6573  ata: encode: mes
│ │ │ │ │ +0000d9b0: 7361 6765 2069 7320 746f 6f20 6c61 7267  sage is too larg
│ │ │ │ │ +0000d9c0: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO
│ │ │ │ │ +0000d9d0: 525f 494e 5641 4c49 445f 4441 5441 5f45  R_INVALID_DATA_E
│ │ │ │ │ +0000d9e0: 4e43 4f44 455f 4d53 474c 454e 5f56 414c  NCODE_MSGLEN_VAL
│ │ │ │ │ +0000d9f0: 4944 4641 494c 270a 2020 2020 2020 2020  IDFAIL'.        
│ │ │ │ │ +0000da00: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ +0000da10: 656e 636f 6465 3a20 696e 7661 6c69 6420  encode: invalid 
│ │ │ │ │ +0000da20: 6d65 7373 6167 6520 6c65 6e67 7468 0a20  message length. 
│ │ │ │ │ +0000da30: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ +0000da40: 4e56 414c 4944 5f44 4154 415f 454e 434f  NVALID_DATA_ENCO
│ │ │ │ │ +0000da50: 4445 5f44 4947 4553 545f 5641 4c49 4446  DE_DIGEST_VALIDF
│ │ │ │ │ +0000da60: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I
│ │ │ │ │ +0000da70: 6e76 616c 6964 2064 6174 613a 2065 6e63  nvalid data: enc
│ │ │ │ │ +0000da80: 6f64 653a 2069 6e76 616c 6964 2064 6967  ode: invalid dig
│ │ │ │ │ +0000da90: 6573 740a 2020 2020 2027 464b 4f5f 4552  est.     'FKO_ER
│ │ │ │ │ +0000daa0: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ +0000dab0: 5f45 4e43 4f44 455f 4449 4745 5354 5f54  _ENCODE_DIGEST_T
│ │ │ │ │ +0000dac0: 4f4f 4249 4727 0a20 2020 2020 2020 2020  OOBIG'.         
│ │ │ │ │ +0000dad0: 2049 6e76 616c 6964 2064 6174 613a 2065   Invalid data: e
│ │ │ │ │ +0000dae0: 6e63 6f64 653a 2064 6967 6573 7420 6973  ncode: digest is
│ │ │ │ │ +0000daf0: 2074 6f6f 206c 6172 6765 0a20 2020 2020   too large.     
│ │ │ │ │ +0000db00: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ +0000db10: 4944 5f44 4154 415f 454e 434f 4445 5f4e  ID_DATA_ENCODE_N
│ │ │ │ │ +0000db20: 4f54 4241 5345 3634 270a 2020 2020 2020  OTBASE64'.      
│ │ │ │ │ +0000db30: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ +0000db40: 3a20 656e 636f 6465 6420 6461 7461 2069  : encoded data i
│ │ │ │ │ +0000db50: 7320 6e6f 7420 4261 7365 3634 0a20 2020  s not Base64.   
│ │ │ │ │ +0000db60: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ +0000db70: 414c 4944 5f44 4154 415f 454e 4352 5950  ALID_DATA_ENCRYP
│ │ │ │ │ +0000db80: 545f 4d53 474c 454e 5f56 414c 4944 4641  T_MSGLEN_VALIDFA
│ │ │ │ │ +0000db90: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In
│ │ │ │ │ +0000dba0: 7661 6c69 6420 6461 7461 3a20 656e 6372  valid data: encr
│ │ │ │ │ +0000dbb0: 7970 743a 2069 6e76 616c 6964 206d 6573  ypt: invalid mes
│ │ │ │ │ +0000dbc0: 7361 6765 206c 656e 6774 680a 2020 2020  sage length.    
│ │ │ │ │ +0000dbd0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ +0000dbe0: 4c49 445f 4441 5441 5f45 4e43 5259 5054  LID_DATA_ENCRYPT
│ │ │ │ │ +0000dbf0: 5f44 4947 4553 544c 454e 5f56 414c 4944  _DIGESTLEN_VALID
│ │ │ │ │ +0000dc00: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          
│ │ │ │ │ +0000dc10: 496e 7661 6c69 6420 6461 7461 3a20 656e  Invalid data: en
│ │ │ │ │ +0000dc20: 6372 7970 743a 2069 6e76 616c 6964 2064  crypt: invalid d
│ │ │ │ │ +0000dc30: 6967 6573 7420 6c65 6e67 7468 0a20 2020  igest length.   
│ │ │ │ │ +0000dc40: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ +0000dc50: 414c 4944 5f44 4154 415f 454e 4352 5950  ALID_DATA_ENCRYP
│ │ │ │ │ +0000dc60: 545f 5054 4c45 4e5f 5641 4c49 4446 4149  T_PTLEN_VALIDFAI
│ │ │ │ │ +0000dc70: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv
│ │ │ │ │ +0000dc80: 616c 6964 2064 6174 613a 2065 6e63 7279  alid data: encry
│ │ │ │ │ +0000dc90: 7074 3a20 696e 7661 6c69 6420 706c 6169  pt: invalid plai
│ │ │ │ │ +0000dca0: 6e74 6578 7420 6c65 6e67 7468 0a20 2020  ntext length.   
│ │ │ │ │ +0000dcb0: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ +0000dcc0: 414c 4944 5f44 4154 415f 454e 4352 5950  ALID_DATA_ENCRYP
│ │ │ │ │ +0000dcd0: 545f 5245 5355 4c54 5f4d 5347 4c45 4e5f  T_RESULT_MSGLEN_
│ │ │ │ │ +0000dce0: 5641 4c49 4446 4149 4c27 0a20 2020 2020  VALIDFAIL'.     
│ │ │ │ │ +0000dcf0: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat
│ │ │ │ │ +0000dd00: 613a 2065 6e63 7279 7074 3a20 696e 7661  a: encrypt: inva
│ │ │ │ │ +0000dd10: 6c69 6420 656e 6372 7970 7420 7265 7375  lid encrypt resu
│ │ │ │ │ +0000dd20: 6c74 206d 6573 7361 6765 206c 656e 6774  lt message lengt
│ │ │ │ │ +0000dd30: 680a 2020 2020 2027 464b 4f5f 4552 524f  h.     'FKO_ERRO
│ │ │ │ │ +0000dd40: 525f 494e 5641 4c49 445f 4441 5441 5f45  R_INVALID_DATA_E
│ │ │ │ │ +0000dd50: 4e43 5259 5054 5f43 4950 4845 524c 454e  NCRYPT_CIPHERLEN
│ │ │ │ │ +0000dd60: 5f44 4543 4f44 4546 4149 4c27 0a20 2020  _DECODEFAIL'.   
│ │ │ │ │ +0000dd70: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d
│ │ │ │ │ +0000dd80: 6174 613a 2065 6e63 7279 7074 3a20 6465  ata: encrypt: de
│ │ │ │ │ +0000dd90: 636f 6465 2063 6970 6865 7220 6c65 6e67  code cipher leng
│ │ │ │ │ +0000dda0: 7468 2066 6169 6c65 640a 2020 2020 2027  th failed.     '
│ │ │ │ │ +0000ddb0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ +0000ddc0: 445f 4441 5441 5f45 4e43 5259 5054 5f43  D_DATA_ENCRYPT_C
│ │ │ │ │ +0000ddd0: 4950 4845 524c 454e 5f56 414c 4944 4641  IPHERLEN_VALIDFA
│ │ │ │ │ +0000dde0: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In
│ │ │ │ │ +0000ddf0: 7661 6c69 6420 6461 7461 3a20 656e 6372  valid data: encr
│ │ │ │ │ +0000de00: 7970 743a 2069 6e76 616c 6964 2063 6970  ypt: invalid cip
│ │ │ │ │ +0000de10: 6865 7220 6c65 6e67 7468 0a20 2020 2020  her length.     
│ │ │ │ │ +0000de20: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ +0000de30: 4944 5f44 4154 415f 454e 4352 5950 545f  ID_DATA_ENCRYPT_
│ │ │ │ │ +0000de40: 4445 4352 5950 5445 445f 4d45 5353 4147  DECRYPTED_MESSAG
│ │ │ │ │ +0000de50: 455f 4d49 5353 494e 4727 0a20 2020 2020  E_MISSING'.     
│ │ │ │ │ +0000de60: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat
│ │ │ │ │ +0000de70: 613a 2065 6e63 7279 7074 3a20 6d69 7373  a: encrypt: miss
│ │ │ │ │ +0000de80: 696e 6720 6465 6372 7970 7465 6420 6d65  ing decrypted me
│ │ │ │ │ +0000de90: 7373 6167 650a 2020 2020 2027 464b 4f5f  ssage.     'FKO_
│ │ │ │ │ +0000dea0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ +0000deb0: 5441 5f45 4e43 5259 5054 5f44 4543 5259  TA_ENCRYPT_DECRY
│ │ │ │ │ +0000dec0: 5054 4544 5f4d 5347 4c45 4e5f 5641 4c49  PTED_MSGLEN_VALI
│ │ │ │ │ +0000ded0: 4446 4149 4c27 0a20 2020 2020 2020 2020  DFAIL'.         
│ │ │ │ │ +0000dee0: 2049 6e76 616c 6964 2064 6174 613a 2065   Invalid data: e
│ │ │ │ │ +0000def0: 6e63 7279 7074 3a20 696e 7661 6c69 6420  ncrypt: invalid 
│ │ │ │ │ +0000df00: 6465 6372 7970 7465 6420 6d65 7373 6167  decrypted messag
│ │ │ │ │ +0000df10: 6520 6c65 6e67 7468 0a20 2020 2020 2746  e length.     'F
│ │ │ │ │ +0000df20: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ +0000df30: 5f44 4154 415f 454e 4352 5950 545f 5459  _DATA_ENCRYPT_TY
│ │ │ │ │ +0000df40: 5045 5f56 414c 4944 4641 494c 270a 2020  PE_VALIDFAIL'.  
│ │ │ │ │ +0000df50: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ +0000df60: 6461 7461 3a20 656e 6372 7970 743a 2069  data: encrypt: i
│ │ │ │ │ +0000df70: 6e76 616c 6964 2065 6e63 7279 7074 696f  nvalid encryptio
│ │ │ │ │ +0000df80: 6e20 7479 7065 0a20 2020 2020 2746 4b4f  n type.     'FKO
│ │ │ │ │ +0000df90: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ +0000dfa0: 4154 415f 454e 4352 5950 545f 4d4f 4445  ATA_ENCRYPT_MODE
│ │ │ │ │ +0000dfb0: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    
│ │ │ │ │ +0000dfc0: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ +0000dfd0: 7461 3a20 656e 6372 7970 743a 2069 6e76  ta: encrypt: inv
│ │ │ │ │ +0000dfe0: 616c 6964 2065 6e63 7279 7074 696f 6e20  alid encryption 
│ │ │ │ │ +0000dff0: 6d6f 6465 0a20 2020 2020 2746 4b4f 5f45  mode.     'FKO_E
│ │ │ │ │ +0000e000: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ +0000e010: 415f 454e 4352 5950 545f 5459 5045 5f55  A_ENCRYPT_TYPE_U
│ │ │ │ │ +0000e020: 4e4b 4e4f 574e 270a 2020 2020 2020 2020  NKNOWN'.        
│ │ │ │ │ +0000e030: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ +0000e040: 656e 6372 7970 743a 2075 6e6b 6e6f 776e  encrypt: unknown
│ │ │ │ │ +0000e050: 2065 6e63 7279 7074 696f 6e20 7479 7065   encryption type
│ │ │ │ │ +0000e060: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ +0000e070: 5f49 4e56 414c 4944 5f44 4154 415f 4655  _INVALID_DATA_FU
│ │ │ │ │ +0000e080: 4e43 535f 4e45 575f 454e 434d 5347 5f4d  NCS_NEW_ENCMSG_M
│ │ │ │ │ +0000e090: 4953 5349 4e47 270a 2020 2020 2020 2020  ISSING'.        
│ │ │ │ │ +0000e0a0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ +0000e0b0: 6d69 7373 696e 6720 656e 636f 6465 6420  missing encoded 
│ │ │ │ │ +0000e0c0: 6d65 7373 6167 650a 2020 2020 2027 464b  message.     'FK
│ │ │ │ │ +0000e0d0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ +0000e0e0: 4441 5441 5f46 554e 4353 5f4e 4557 5f4d  DATA_FUNCS_NEW_M
│ │ │ │ │ +0000e0f0: 5347 4c45 4e5f 5641 4c49 4446 4149 4c27  SGLEN_VALIDFAIL'
│ │ │ │ │ +0000e100: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ +0000e110: 6964 2064 6174 613a 2069 6e76 616c 6964  id data: invalid
│ │ │ │ │ +0000e120: 206d 6573 7361 6765 206c 656e 6774 6820   message length 
│ │ │ │ │ +0000e130: 6672 6f6d 206e 6577 0a20 2020 2020 2746  from new.     'F
│ │ │ │ │ +0000e140: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ +0000e150: 5f44 4154 415f 4655 4e43 535f 4745 4e5f  _DATA_FUNCS_GEN_
│ │ │ │ │ +0000e160: 4b45 594c 454e 5f56 414c 4944 4641 494c  KEYLEN_VALIDFAIL
│ │ │ │ │ +0000e170: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva
│ │ │ │ │ +0000e180: 6c69 6420 6461 7461 3a20 696e 7661 6c69  lid data: invali
│ │ │ │ │ +0000e190: 6420 6b65 7920 6c65 6e67 7468 2066 726f  d key length fro
│ │ │ │ │ +0000e1a0: 6d20 6765 6e5f 6b65 796c 656e 0a20 2020  m gen_keylen.   
│ │ │ │ │ +0000e1b0: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ +0000e1c0: 414c 4944 5f44 4154 415f 4655 4e43 535f  ALID_DATA_FUNCS_
│ │ │ │ │ +0000e1d0: 4745 4e5f 484d 4143 4c45 4e5f 5641 4c49  GEN_HMACLEN_VALI
│ │ │ │ │ +0000e1e0: 4446 4149 4c27 0a20 2020 2020 2020 2020  DFAIL'.         
│ │ │ │ │ +0000e1f0: 2049 6e76 616c 6964 2064 6174 613a 2067   Invalid data: g
│ │ │ │ │ +0000e200: 656e 5f68 6d61 636c 656e 2066 6169 6c75  en_hmaclen failu
│ │ │ │ │ +0000e210: 7265 0a20 2020 2020 2746 4b4f 5f45 5252  re.     'FKO_ERR
│ │ │ │ │ +0000e220: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_
│ │ │ │ │ +0000e230: 4655 4e43 535f 4745 4e5f 4b45 595f 454e  FUNCS_GEN_KEY_EN
│ │ │ │ │ +0000e240: 434f 4445 4641 494c 270a 2020 2020 2020  CODEFAIL'.      
│ │ │ │ │ +0000e250: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ +0000e260: 3a20 6765 6e5f 6b65 793a 2065 6e63 6f64  : gen_key: encod
│ │ │ │ │ +0000e270: 6520 6661 696c 7572 650a 2020 2020 2027  e failure.     '
│ │ │ │ │ +0000e280: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ +0000e290: 445f 4441 5441 5f46 554e 4353 5f47 454e  D_DATA_FUNCS_GEN
│ │ │ │ │ +0000e2a0: 5f48 4d41 435f 454e 434f 4445 4641 494c  _HMAC_ENCODEFAIL
│ │ │ │ │ +0000e2b0: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva
│ │ │ │ │ +0000e2c0: 6c69 6420 6461 7461 3a20 6765 6e5f 686d  lid data: gen_hm
│ │ │ │ │ +0000e2d0: 6163 3a20 656e 636f 6465 2066 6169 6c75  ac: encode failu
│ │ │ │ │ +0000e2e0: 7265 0a20 2020 2020 2746 4b4f 5f45 5252  re.     'FKO_ERR
│ │ │ │ │ +0000e2f0: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_
│ │ │ │ │ +0000e300: 4655 4e43 535f 5345 545f 4d53 474c 454e  FUNCS_SET_MSGLEN
│ │ │ │ │ +0000e310: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    
│ │ │ │ │ +0000e320: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ +0000e330: 7461 3a20 7365 745f 7370 615f 6461 7461  ta: set_spa_data
│ │ │ │ │ +0000e340: 3a20 696e 7661 6c69 6420 6d65 7373 6167  : invalid messag
│ │ │ │ │ +0000e350: 6520 6c65 6e67 7468 0a20 2020 2020 2746  e length.     'F
│ │ │ │ │ +0000e360: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ +0000e370: 5f44 4154 415f 484d 4143 5f4d 5347 4c45  _DATA_HMAC_MSGLE
│ │ │ │ │ +0000e380: 4e5f 5641 4c49 4446 4149 4c27 0a20 2020  N_VALIDFAIL'.   
│ │ │ │ │ +0000e390: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d
│ │ │ │ │ +0000e3a0: 6174 613a 2069 6e76 616c 6964 2048 4d41  ata: invalid HMA
│ │ │ │ │ +0000e3b0: 4320 6d73 676c 656e 0a20 2020 2020 2746  C msglen.     'F
│ │ │ │ │ +0000e3c0: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ +0000e3d0: 5f44 4154 415f 484d 4143 5f45 4e43 4d53  _DATA_HMAC_ENCMS
│ │ │ │ │ +0000e3e0: 474c 454e 5f56 414c 4944 4641 494c 270a  GLEN_VALIDFAIL'.
│ │ │ │ │ +0000e3f0: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ +0000e400: 6420 6461 7461 3a20 696e 7661 6c69 6420  d data: invalid 
│ │ │ │ │ +0000e410: 6c65 6e67 7468 2066 6f72 2065 6e63 7279  length for encry
│ │ │ │ │ +0000e420: 7074 6564 206d 6573 7361 6765 0a20 2020  pted message.   
│ │ │ │ │ +0000e430: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ +0000e440: 414c 4944 5f44 4154 415f 484d 4143 5f43  ALID_DATA_HMAC_C
│ │ │ │ │ +0000e450: 4f4d 5041 5245 4641 494c 270a 2020 2020  OMPAREFAIL'.    
│ │ │ │ │ +0000e460: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ +0000e470: 7461 3a20 484d 4143 2063 6f6d 7061 7269  ta: HMAC compari
│ │ │ │ │ +0000e480: 736f 6e20 6661 696c 6564 0a20 2020 2020  son failed.     
│ │ │ │ │ +0000e490: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ +0000e4a0: 4944 5f44 4154 415f 484d 4143 5f54 5950  ID_DATA_HMAC_TYP
│ │ │ │ │ +0000e4b0: 455f 5641 4c49 4446 4149 4c27 0a20 2020  E_VALIDFAIL'.   
│ │ │ │ │ +0000e4c0: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d
│ │ │ │ │ +0000e4d0: 6174 613a 2069 6e76 616c 6964 2048 4d41  ata: invalid HMA
│ │ │ │ │ +0000e4e0: 4320 7479 7065 0a20 2020 2020 2746 4b4f  C type.     'FKO
│ │ │ │ │ +0000e4f0: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ +0000e500: 4154 415f 484d 4143 5f4c 454e 5f56 414c  ATA_HMAC_LEN_VAL
│ │ │ │ │ +0000e510: 4944 4641 494c 270a 2020 2020 2020 2020  IDFAIL'.        
│ │ │ │ │ +0000e520: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ +0000e530: 696e 7661 6c69 6420 484d 4143 206c 656e  invalid HMAC len
│ │ │ │ │ +0000e540: 6774 680a 2020 2020 2027 464b 4f5f 4552  gth.     'FKO_ER
│ │ │ │ │ +0000e550: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ +0000e560: 5f4d 4553 5341 4745 5f50 4f52 545f 4d49  _MESSAGE_PORT_MI
│ │ │ │ │ +0000e570: 5353 494e 4727 0a20 2020 2020 2020 2020  SSING'.         
│ │ │ │ │ +0000e580: 2049 6e76 616c 6964 2064 6174 613a 206d   Invalid data: m
│ │ │ │ │ +0000e590: 6973 7369 6e67 2070 6f72 740a 2020 2020  issing port.    
│ │ │ │ │ +0000e5a0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ +0000e5b0: 4c49 445f 4441 5441 5f4d 4553 5341 4745  LID_DATA_MESSAGE
│ │ │ │ │ +0000e5c0: 5f54 5950 455f 5641 4c49 4446 4149 4c27  _TYPE_VALIDFAIL'
│ │ │ │ │ +0000e5d0: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ +0000e5e0: 6964 2064 6174 613a 2069 6e76 616c 6964  id data: invalid
│ │ │ │ │ +0000e5f0: 206d 6573 7361 6765 2074 7970 650a 2020   message type.  
│ │ │ │ │ +0000e600: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ +0000e610: 5641 4c49 445f 4441 5441 5f4d 4553 5341  VALID_DATA_MESSA
│ │ │ │ │ +0000e620: 4745 5f45 4d50 5459 270a 2020 2020 2020  GE_EMPTY'.      
│ │ │ │ │ +0000e630: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ +0000e640: 3a20 656d 7074 7920 6461 7461 206d 6573  : empty data mes
│ │ │ │ │ +0000e650: 7361 6765 0a20 2020 2020 2746 4b4f 5f45  sage.     'FKO_E
│ │ │ │ │ +0000e660: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ +0000e670: 415f 4d45 5353 4147 455f 434d 445f 4d49  A_MESSAGE_CMD_MI
│ │ │ │ │ +0000e680: 5353 494e 4727 0a20 2020 2020 2020 2020  SSING'.         
│ │ │ │ │ +0000e690: 2049 6e76 616c 6964 2064 6174 613a 206d   Invalid data: m
│ │ │ │ │ +0000e6a0: 6973 7369 6e67 2063 6f6d 6d61 6e64 206d  issing command m
│ │ │ │ │ +0000e6b0: 6573 7361 6765 0a20 2020 2020 2746 4b4f  essage.     'FKO
│ │ │ │ │ +0000e6c0: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ +0000e6d0: 4154 415f 4d45 5353 4147 455f 4143 4345  ATA_MESSAGE_ACCE
│ │ │ │ │ +0000e6e0: 5353 5f4d 4953 5349 4e47 270a 2020 2020  SS_MISSING'.    
│ │ │ │ │ +0000e6f0: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ +0000e700: 7461 3a20 6d69 7373 696e 6720 6163 6365  ta: missing acce
│ │ │ │ │ +0000e710: 7373 206d 6573 7361 6765 0a20 2020 2020  ss message.     
│ │ │ │ │ +0000e720: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ +0000e730: 4944 5f44 4154 415f 4d45 5353 4147 455f  ID_DATA_MESSAGE_
│ │ │ │ │ +0000e740: 4e41 545f 4d49 5353 494e 4727 0a20 2020  NAT_MISSING'.   
│ │ │ │ │ +0000e750: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d
│ │ │ │ │ +0000e760: 6174 613a 206d 6973 7369 6e67 204e 4154  ata: missing NAT
│ │ │ │ │ +0000e770: 2064 6174 610a 2020 2020 2027 464b 4f5f   data.     'FKO_
│ │ │ │ │ +0000e780: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ +0000e790: 5441 5f4d 4553 5341 4745 5f50 4f52 5450  TA_MESSAGE_PORTP
│ │ │ │ │ +0000e7a0: 524f 544f 5f4d 4953 5349 4e47 270a 2020  ROTO_MISSING'.  
│ │ │ │ │ +0000e7b0: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ +0000e7c0: 6461 7461 3a20 6d69 7373 696e 6720 7072  data: missing pr
│ │ │ │ │ +0000e7d0: 6f74 6f2f 706f 7274 2064 6174 610a 2020  oto/port data.  
│ │ │ │ │ +0000e7e0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ +0000e7f0: 5641 4c49 445f 4441 5441 5f4e 4154 5f45  VALID_DATA_NAT_E
│ │ │ │ │ +0000e800: 4d50 5459 270a 2020 2020 2020 2020 2020  MPTY'.          
│ │ │ │ │ +0000e810: 496e 7661 6c69 6420 6461 7461 3a20 656d  Invalid data: em
│ │ │ │ │ +0000e820: 7074 7920 4e41 5420 7661 6c75 650a 2020  pty NAT value.  
│ │ │ │ │ +0000e830: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ +0000e840: 5641 4c49 445f 4441 5441 5f52 414e 445f  VALID_DATA_RAND_
│ │ │ │ │ +0000e850: 4c45 4e5f 5641 4c49 4446 4149 4c27 0a20  LEN_VALIDFAIL'. 
│ │ │ │ │ +0000e860: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ +0000e870: 2064 6174 613a 2069 6e76 616c 6964 2072   data: invalid r
│ │ │ │ │ +0000e880: 616e 646f 6d20 6461 7461 206c 656e 6774  andom data lengt
│ │ │ │ │ +0000e890: 680a 2020 2020 2027 464b 4f5f 4552 524f  h.     'FKO_ERRO
│ │ │ │ │ +0000e8a0: 525f 494e 5641 4c49 445f 4441 5441 5f53  R_INVALID_DATA_S
│ │ │ │ │ +0000e8b0: 5256 4155 5448 5f4d 4953 5349 4e47 270a  RVAUTH_MISSING'.
│ │ │ │ │ +0000e8c0: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ +0000e8d0: 6420 6461 7461 3a20 7365 7276 6572 2061  d data: server a
│ │ │ │ │ +0000e8e0: 7574 6820 6d69 7373 696e 670a 2020 2020  uth missing.    
│ │ │ │ │ +0000e8f0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ +0000e900: 4c49 445f 4441 5441 5f54 494d 4553 5441  LID_DATA_TIMESTA
│ │ │ │ │ +0000e910: 4d50 5f56 414c 4944 4641 494c 270a 2020  MP_VALIDFAIL'.  
│ │ │ │ │ +0000e920: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ +0000e930: 6461 7461 3a20 696e 7661 6c69 6420 7469  data: invalid ti
│ │ │ │ │ +0000e940: 6d65 7374 616d 7020 7661 6c75 650a 2020  mestamp value.  
│ │ │ │ │ +0000e950: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ +0000e960: 5641 4c49 445f 4441 5441 5f55 5345 525f  VALID_DATA_USER_
│ │ │ │ │ +0000e970: 4d49 5353 494e 4727 0a20 2020 2020 2020  MISSING'.       
│ │ │ │ │ +0000e980: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:
│ │ │ │ │ +0000e990: 206d 6973 7369 6e67 2075 7365 7220 6461   missing user da
│ │ │ │ │ +0000e9a0: 7461 0a20 2020 2020 2746 4b4f 5f45 5252  ta.     'FKO_ERR
│ │ │ │ │ +0000e9b0: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_
│ │ │ │ │ +0000e9c0: 5553 4552 5f46 4952 5354 4348 4152 5f56  USER_FIRSTCHAR_V
│ │ │ │ │ +0000e9d0: 414c 4944 4641 494c 270a 2020 2020 2020  ALIDFAIL'.      
│ │ │ │ │ +0000e9e0: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ +0000e9f0: 3a20 7573 6572 2066 6972 7374 2063 6861  : user first cha
│ │ │ │ │ +0000ea00: 7220 6e6f 7420 7661 6c69 640a 2020 2020  r not valid.    
│ │ │ │ │ +0000ea10: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ +0000ea20: 4c49 445f 4441 5441 5f55 5345 525f 5245  LID_DATA_USER_RE
│ │ │ │ │ +0000ea30: 4d43 4841 525f 5641 4c49 4446 4149 4c27  MCHAR_VALIDFAIL'
│ │ │ │ │ +0000ea40: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ +0000ea50: 6964 2064 6174 613a 2075 7365 7220 7265  id data: user re
│ │ │ │ │ +0000ea60: 6d63 6861 7220 6e6f 7420 7661 6c69 640a  mchar not valid.
│ │ │ │ │ +0000ea70: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ +0000ea80: 494e 5641 4c49 445f 4441 5441 5f55 5449  INVALID_DATA_UTI
│ │ │ │ │ +0000ea90: 4c5f 5354 5254 4f4c 5f4c 545f 4d49 4e27  L_STRTOL_LT_MIN'
│ │ │ │ │ +0000eaa0: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ +0000eab0: 6964 2064 6174 613a 2075 7469 6c20 636f  id data: util co
│ │ │ │ │ +0000eac0: 6e76 6572 7369 6f6e 2074 6f20 6c6f 6e67  nversion to long
│ │ │ │ │ +0000ead0: 206c 6573 7320 7468 616e 206d 696e 696d   less than minim
│ │ │ │ │ +0000eae0: 756d 0a20 2020 2020 2746 4b4f 5f45 5252  um.     'FKO_ERR
│ │ │ │ │ +0000eaf0: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_
│ │ │ │ │ +0000eb00: 5554 494c 5f53 5452 544f 4c5f 4754 5f4d  UTIL_STRTOL_GT_M
│ │ │ │ │ +0000eb10: 4158 270a 2020 2020 2020 2020 2020 496e  AX'.          In
│ │ │ │ │ +0000eb20: 7661 6c69 6420 6461 7461 3a20 7574 696c  valid data: util
│ │ │ │ │ +0000eb30: 2063 6f6e 7665 7273 696f 6e20 746f 206c   conversion to l
│ │ │ │ │ +0000eb40: 6f6e 6720 6772 6561 7465 7220 7468 616e  ong greater than
│ │ │ │ │ +0000eb50: 206d 6178 696d 756d 0a20 2020 2020 2746   maximum.     'F
│ │ │ │ │ +0000eb60: 4b4f 5f45 5252 4f52 5f44 4154 415f 544f  KO_ERROR_DATA_TO
│ │ │ │ │ +0000eb70: 4f5f 4c41 5247 4527 0a20 2020 2020 2020  O_LARGE'.       
│ │ │ │ │ +0000eb80: 2020 2056 616c 7565 206f 7220 5369 7a65     Value or Size
│ │ │ │ │ +0000eb90: 206f 6620 7468 6520 6461 7461 2065 7863   of the data exc
│ │ │ │ │ +0000eba0: 6565 6465 6420 7468 6520 6d61 7820 616c  eeded the max al
│ │ │ │ │ +0000ebb0: 6c6f 7765 640a 2020 2020 2027 464b 4f5f  lowed.     'FKO_
│ │ │ │ │ +0000ebc0: 4552 524f 525f 494e 5641 4c49 445f 4b45  ERROR_INVALID_KE
│ │ │ │ │ +0000ebd0: 595f 4c45 4e27 0a20 2020 2020 2020 2020  Y_LEN'.         
│ │ │ │ │ +0000ebe0: 2049 6e76 616c 6964 206b 6579 206c 656e   Invalid key len
│ │ │ │ │ +0000ebf0: 6774 680a 2020 2020 2027 464b 4f5f 4552  gth.     'FKO_ER
│ │ │ │ │ +0000ec00: 524f 525f 5553 4552 4e41 4d45 5f55 4e4b  ROR_USERNAME_UNK
│ │ │ │ │ +0000ec10: 4e4f 574e 270a 2020 2020 2020 2020 2020  NOWN'.          
│ │ │ │ │ +0000ec20: 556e 6162 6c65 2074 6f20 6465 7465 726d  Unable to determ
│ │ │ │ │ +0000ec30: 696e 6520 7573 6572 6e61 6d65 0a20 2020  ine username.   
│ │ │ │ │ +0000ec40: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e43    'FKO_ERROR_INC
│ │ │ │ │ +0000ec50: 4f4d 504c 4554 455f 5350 415f 4441 5441  OMPLETE_SPA_DATA
│ │ │ │ │ +0000ec60: 270a 2020 2020 2020 2020 2020 4d69 7373  '.          Miss
│ │ │ │ │ +0000ec70: 696e 6720 6f72 2069 6e63 6f6d 706c 6574  ing or incomplet
│ │ │ │ │ +0000ec80: 6520 5350 4120 6461 7461 0a20 2020 2020  e SPA data.     
│ │ │ │ │ +0000ec90: 2746 4b4f 5f45 5252 4f52 5f4d 4953 5349  'FKO_ERROR_MISSI
│ │ │ │ │ +0000eca0: 4e47 5f45 4e43 4f44 4544 5f44 4154 4127  NG_ENCODED_DATA'
│ │ │ │ │ +0000ecb0: 0a20 2020 2020 2020 2020 2054 6865 7265  .          There
│ │ │ │ │ +0000ecc0: 2069 7320 6e6f 2065 6e63 6f64 6564 2064   is no encoded d
│ │ │ │ │ +0000ecd0: 6174 6120 746f 2070 726f 6365 7373 0a20  ata to process. 
│ │ │ │ │ +0000ece0: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ +0000ecf0: 4e56 414c 4944 5f44 4947 4553 545f 5459  NVALID_DIGEST_TY
│ │ │ │ │ +0000ed00: 5045 270a 2020 2020 2020 2020 2020 496e  PE'.          In
│ │ │ │ │ +0000ed10: 7661 6c69 6420 6469 6765 7374 2074 7970  valid digest typ
│ │ │ │ │ +0000ed20: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO
│ │ │ │ │ +0000ed30: 525f 494e 5641 4c49 445f 414c 4c4f 575f  R_INVALID_ALLOW_
│ │ │ │ │ +0000ed40: 4950 270a 2020 2020 2020 2020 2020 496e  IP'.          In
│ │ │ │ │ +0000ed50: 7661 6c69 6420 616c 6c6f 7720 4950 2061  valid allow IP a
│ │ │ │ │ +0000ed60: 6464 7265 7373 2069 6e20 7468 6520 5350  ddress in the SP
│ │ │ │ │ +0000ed70: 4120 6d65 7373 6167 6520 6461 7461 0a20  A message data. 
│ │ │ │ │ +0000ed80: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ +0000ed90: 4e56 414c 4944 5f53 5041 5f43 4f4d 4d41  NVALID_SPA_COMMA
│ │ │ │ │ +0000eda0: 4e44 5f4d 5347 270a 2020 2020 2020 2020  ND_MSG'.        
│ │ │ │ │ +0000edb0: 2020 496e 7661 6c69 6420 5350 4120 636f    Invalid SPA co
│ │ │ │ │ +0000edc0: 6d6d 616e 6420 6d65 7373 6167 6520 666f  mmand message fo
│ │ │ │ │ +0000edd0: 726d 6174 0a20 2020 2020 2746 4b4f 5f45  rmat.     'FKO_E
│ │ │ │ │ +0000ede0: 5252 4f52 5f49 4e56 414c 4944 5f53 5041  RROR_INVALID_SPA
│ │ │ │ │ +0000edf0: 5f41 4343 4553 535f 4d53 4727 0a20 2020  _ACCESS_MSG'.   
│ │ │ │ │ +0000ee00: 2020 2020 2020 2049 6e76 616c 6964 2053         Invalid S
│ │ │ │ │ +0000ee10: 5041 2061 6363 6573 7320 6d65 7373 6167  PA access messag
│ │ │ │ │ +0000ee20: 6520 666f 726d 6174 0a20 2020 2020 2746  e format.     'F
│ │ │ │ │ +0000ee30: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ +0000ee40: 5f53 5041 5f4e 4154 5f41 4343 4553 535f  _SPA_NAT_ACCESS_
│ │ │ │ │ +0000ee50: 4d53 4727 0a20 2020 2020 2020 2020 2049  MSG'.          I
│ │ │ │ │ +0000ee60: 6e76 616c 6964 2053 5041 206e 6174 5f61  nvalid SPA nat_a
│ │ │ │ │ +0000ee70: 6363 6573 7320 6d65 7373 6167 6520 666f  ccess message fo
│ │ │ │ │ +0000ee80: 726d 6174 0a20 2020 2020 2746 4b4f 5f45  rmat.     'FKO_E
│ │ │ │ │ +0000ee90: 5252 4f52 5f49 4e56 414c 4944 5f45 4e43  RROR_INVALID_ENC
│ │ │ │ │ +0000eea0: 5259 5054 494f 4e5f 5459 5045 270a 2020  RYPTION_TYPE'.  
│ │ │ │ │ +0000eeb0: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ +0000eec0: 656e 6372 7970 7469 6f6e 2074 7970 650a  encryption type.
│ │ │ │ │ +0000eed0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ +0000eee0: 5752 4f4e 475f 454e 4352 5950 5449 4f4e  WRONG_ENCRYPTION
│ │ │ │ │ +0000eef0: 5f54 5950 4527 0a20 2020 2020 2020 2020  _TYPE'.         
│ │ │ │ │ +0000ef00: 2057 726f 6e67 206f 7220 696e 6170 7072   Wrong or inappr
│ │ │ │ │ +0000ef10: 6f70 7269 6174 6520 656e 6372 7970 7469  opriate encrypti
│ │ │ │ │ +0000ef20: 6f6e 2074 7970 6520 666f 7220 7468 6973  on type for this
│ │ │ │ │ +0000ef30: 206f 7065 7261 7469 6f6e 0a20 2020 2020   operation.     
│ │ │ │ │ +0000ef40: 2746 4b4f 5f45 5252 4f52 5f44 4543 5259  'FKO_ERROR_DECRY
│ │ │ │ │ +0000ef50: 5054 494f 4e5f 5349 5a45 270a 2020 2020  PTION_SIZE'.    
│ │ │ │ │ +0000ef60: 2020 2020 2020 556e 6578 7065 6374 6564        Unexpected
│ │ │ │ │ +0000ef70: 206f 7220 696e 7661 6c69 6420 7369 7a65   or invalid size
│ │ │ │ │ +0000ef80: 2066 6f72 2064 6563 7279 7074 6564 2064   for decrypted d
│ │ │ │ │ +0000ef90: 6174 610a 2020 2020 2027 464b 4f5f 4552  ata.     'FKO_ER
│ │ │ │ │ +0000efa0: 524f 525f 4445 4352 5950 5449 4f4e 5f46  ROR_DECRYPTION_F
│ │ │ │ │ +0000efb0: 4149 4c55 5245 270a 2020 2020 2020 2020  AILURE'.        
│ │ │ │ │ +0000efc0: 2020 4465 6372 7970 7469 6f6e 2066 6169    Decryption fai
│ │ │ │ │ +0000efd0: 6c65 6420 6f72 2064 6563 7279 7074 6564  led or decrypted
│ │ │ │ │ +0000efe0: 2064 6174 6120 6973 2069 6e76 616c 6964   data is invalid
│ │ │ │ │ +0000eff0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ +0000f000: 5f44 4947 4553 545f 5645 5249 4649 4341  _DIGEST_VERIFICA
│ │ │ │ │ +0000f010: 5449 4f4e 5f46 4149 4c45 4427 0a20 2020  TION_FAILED'.   
│ │ │ │ │ +0000f020: 2020 2020 2020 2054 6865 2063 6f6d 7075         The compu
│ │ │ │ │ +0000f030: 7465 6420 6469 6765 7374 2064 6964 206e  ted digest did n
│ │ │ │ │ +0000f040: 6f74 206d 6174 6368 2074 6865 2064 6967  ot match the dig
│ │ │ │ │ +0000f050: 6573 7420 696e 2074 6865 2073 7061 2064  est in the spa d
│ │ │ │ │ +0000f060: 6174 610a 2020 2020 2027 464b 4f5f 4552  ata.     'FKO_ER
│ │ │ │ │ +0000f070: 524f 525f 494e 5641 4c49 445f 484d 4143  ROR_INVALID_HMAC
│ │ │ │ │ +0000f080: 5f4b 4559 5f4c 454e 270a 2020 2020 2020  _KEY_LEN'.      
│ │ │ │ │ +0000f090: 2020 2020 496e 7661 6c69 6420 484d 4143      Invalid HMAC
│ │ │ │ │ +0000f0a0: 206b 6579 206c 656e 6774 680a 2020 2020   key length.    
│ │ │ │ │ +0000f0b0: 2027 464b 4f5f 4552 524f 525f 554e 5355   'FKO_ERROR_UNSU
│ │ │ │ │ +0000f0c0: 5050 4f52 5445 445f 484d 4143 5f4d 4f44  PPORTED_HMAC_MOD
│ │ │ │ │ +0000f0d0: 4527 0a20 2020 2020 2020 2020 2055 6e73  E'.          Uns
│ │ │ │ │ +0000f0e0: 7570 706f 7274 6564 2048 4d41 4320 6d6f  upported HMAC mo
│ │ │ │ │ +0000f0f0: 6465 2028 6465 6661 756c 743a 2053 4841  de (default: SHA
│ │ │ │ │ +0000f100: 3235 3629 0a20 2020 2020 2746 4b4f 5f45  256).     'FKO_E
│ │ │ │ │ +0000f110: 5252 4f52 5f55 4e53 5550 504f 5254 4544  RROR_UNSUPPORTED
│ │ │ │ │ +0000f120: 5f46 4541 5455 5245 270a 2020 2020 2020  _FEATURE'.      
│ │ │ │ │ +0000f130: 2020 2020 556e 7375 7070 6f72 7465 6420      Unsupported 
│ │ │ │ │ +0000f140: 6f72 2075 6e69 6d70 6c65 6d65 6e74 6564  or unimplemented
│ │ │ │ │ +0000f150: 2066 6561 7475 7265 206f 7220 6675 6e63   feature or func
│ │ │ │ │ +0000f160: 7469 6f6e 0a20 2020 2020 2746 4b4f 5f45  tion.     'FKO_E
│ │ │ │ │ +0000f170: 5252 4f52 5f5a 4552 4f5f 4f55 545f 4441  RROR_ZERO_OUT_DA
│ │ │ │ │ +0000f180: 5441 270a 2020 2020 2020 2020 2020 436f  TA'.          Co
│ │ │ │ │ +0000f190: 756c 6420 6e6f 7420 7a65 726f 206f 7574  uld not zero out
│ │ │ │ │ +0000f1a0: 2073 656e 7369 7469 7665 2064 6174 610a   sensitive data.
│ │ │ │ │ +0000f1b0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ +0000f1c0: 554e 4b4e 4f57 4e27 0a20 2020 2020 2020  UNKNOWN'.       
│ │ │ │ │ +0000f1d0: 2020 2055 6e6b 6e6f 776e 2f55 6e63 6c61     Unknown/Uncla
│ │ │ │ │ +0000f1e0: 7373 6966 6965 6420 6572 726f 720a 0a20  ssified error.. 
│ │ │ │ │ +0000f1f0: 2020 4966 2047 5047 2073 7570 706f 7274    If GPG support
│ │ │ │ │ +0000f200: 2069 7320 6176 6169 6c61 626c 652c 2074   is available, t
│ │ │ │ │ +0000f210: 6865 7265 2061 7265 2061 6464 6974 696f  here are additio
│ │ │ │ │ +0000f220: 6e61 6c20 706f 7373 6962 6c65 2065 7272  nal possible err
│ │ │ │ │ +0000f230: 6f72 0a63 6f6e 6469 7469 6f6e 7320 616e  or.conditions an
│ │ │ │ │ +0000f240: 6420 6572 726f 7220 636f 6465 732e 2020  d error codes.  
│ │ │ │ │ +0000f250: 5468 6520 4750 4720 7375 7070 6f72 7420  The GPG support 
│ │ │ │ │ +0000f260: 6973 2069 6d70 6c65 6d65 6e74 6564 2076  is implemented v
│ │ │ │ │ +0000f270: 6961 2047 5047 4d45 2e0a 5468 6520 6c69  ia GPGME..The li
│ │ │ │ │ +0000f280: 6266 6b6f 2065 7272 6f72 2068 616e 646c  bfko error handl
│ │ │ │ │ +0000f290: 696e 6720 636f 6465 2077 7261 7073 206d  ing code wraps m
│ │ │ │ │ +0000f2a0: 616e 7920 6f66 2074 6865 2047 5047 4d45  any of the GPGME
│ │ │ │ │ +0000f2b0: 2065 7272 6f72 2063 6f64 6573 2074 6861   error codes tha
│ │ │ │ │ +0000f2c0: 740a 6d61 7920 6265 2065 6e63 6f75 6e74  t.may be encount
│ │ │ │ │ +0000f2d0: 6572 6564 2077 6869 6c65 2075 7369 6e67  ered while using
│ │ │ │ │ +0000f2e0: 206c 6962 666b 6f27 7320 4750 4720 7265   libfko's GPG re
│ │ │ │ │ +0000f2f0: 6c61 7465 6420 6675 6e63 7469 6f6e 732e  lated functions.
│ │ │ │ │ +0000f300: 2020 5468 6573 650a 6172 653a 0a0a 202d    These.are:.. -
│ │ │ │ │ +0000f310: 2d20 5661 7269 6162 6c65 3a20 696e 7420  - Variable: int 
│ │ │ │ │ +0000f320: 6572 726f 725f 636f 6465 2028 6770 676d  error_code (gpgm
│ │ │ │ │ +0000f330: 6520 7375 7070 6f72 7420 6f6e 6c79 290a  e support only).
│ │ │ │ │ +0000f340: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ +0000f350: 4d49 5353 494e 475f 4750 475f 4b45 595f  MISSING_GPG_KEY_
│ │ │ │ │ +0000f360: 4441 5441 270a 2020 2020 2020 2020 2020  DATA'.          
│ │ │ │ │ +0000f370: 4d69 7373 696e 6720 4750 4720 6b65 7920  Missing GPG key 
│ │ │ │ │ +0000f380: 6461 7461 2028 7369 676e 6572 206f 7220  data (signer or 
│ │ │ │ │ +0000f390: 7265 6369 7069 656e 7420 6e6f 7420 7365  recipient not se
│ │ │ │ │ +0000f3a0: 7429 0a20 2020 2020 2746 4b4f 5f45 5252  t).     'FKO_ERR
│ │ │ │ │ +0000f3b0: 4f52 5f47 5047 4d45 5f4e 4f5f 4f50 454e  OR_GPGME_NO_OPEN
│ │ │ │ │ +0000f3c0: 5047 5027 0a20 2020 2020 2020 2020 2054  PGP'.          T
│ │ │ │ │ +0000f3d0: 6869 7320 4750 474d 4520 696d 706c 656d  his GPGME implem
│ │ │ │ │ +0000f3e0: 656e 7461 7469 6f6e 2064 6f65 7320 6e6f  entation does no
│ │ │ │ │ +0000f3f0: 7420 7375 7070 6f72 7420 4f70 656e 5047  t support OpenPG
│ │ │ │ │ +0000f400: 500a 2020 2020 2027 464b 4f5f 4552 524f  P.     'FKO_ERRO
│ │ │ │ │ +0000f410: 525f 4750 474d 455f 434f 4e54 4558 5427  R_GPGME_CONTEXT'
│ │ │ │ │ +0000f420: 0a20 2020 2020 2020 2020 2055 6e61 626c  .          Unabl
│ │ │ │ │ +0000f430: 6520 746f 2063 7265 6174 6520 4750 474d  e to create GPGM
│ │ │ │ │ +0000f440: 4520 636f 6e74 6578 740a 2020 2020 2027  E context.     '
│ │ │ │ │ +0000f450: 464b 4f5f 4552 524f 525f 4750 474d 455f  FKO_ERROR_GPGME_
│ │ │ │ │ +0000f460: 504c 4149 4e54 4558 545f 4441 5441 5f4f  PLAINTEXT_DATA_O
│ │ │ │ │ +0000f470: 424a 270a 2020 2020 2020 2020 2020 4572  BJ'.          Er
│ │ │ │ │ +0000f480: 726f 7220 6372 6561 7469 6e67 2074 6865  ror creating the
│ │ │ │ │ +0000f490: 2070 6c61 696e 7465 7874 2064 6174 6120   plaintext data 
│ │ │ │ │ +0000f4a0: 6f62 6a65 6374 0a20 2020 2020 2746 4b4f  object.     'FKO
│ │ │ │ │ +0000f4b0: 5f45 5252 4f52 5f47 5047 4d45 5f53 4554  _ERROR_GPGME_SET
│ │ │ │ │ +0000f4c0: 5f50 524f 544f 434f 4c27 0a20 2020 2020  _PROTOCOL'.     
│ │ │ │ │ +0000f4d0: 2020 2020 2055 6e61 626c 6520 746f 2073       Unable to s
│ │ │ │ │ +0000f4e0: 6574 2047 5047 4d45 2074 6f20 7573 6520  et GPGME to use 
│ │ │ │ │ +0000f4f0: 4f70 656e 5047 5020 7072 6f74 6f63 6f6c  OpenPGP protocol
│ │ │ │ │ +0000f500: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ +0000f510: 5f47 5047 4d45 5f43 4950 4845 525f 4441  _GPGME_CIPHER_DA
│ │ │ │ │ +0000f520: 5441 5f4f 424a 270a 2020 2020 2020 2020  TA_OBJ'.        
│ │ │ │ │ +0000f530: 2020 4572 726f 7220 6372 6561 7469 6e67    Error creating
│ │ │ │ │ +0000f540: 2074 6865 2065 6e63 7279 7074 6564 2064   the encrypted d
│ │ │ │ │ +0000f550: 6174 6120 6461 7461 206f 626a 6563 740a  ata data object.
│ │ │ │ │ +0000f560: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ +0000f570: 4750 474d 455f 4241 445f 5041 5353 5048  GPGME_BAD_PASSPH
│ │ │ │ │ +0000f580: 5241 5345 270a 2020 2020 2020 2020 2020  RASE'.          
│ │ │ │ │ +0000f590: 5468 6520 4750 4720 7061 7373 7068 7261  The GPG passphra
│ │ │ │ │ +0000f5a0: 7365 2077 6173 206e 6f74 2076 616c 6964  se was not valid
│ │ │ │ │ +0000f5b0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ +0000f5c0: 5f47 5047 4d45 5f45 4e43 5259 5054 5f53  _GPGME_ENCRYPT_S
│ │ │ │ │ +0000f5d0: 4947 4e27 0a20 2020 2020 2020 2020 2045  IGN'.          E
│ │ │ │ │ +0000f5e0: 7272 6f72 2064 7572 696e 6720 7468 6520  rror during the 
│ │ │ │ │ +0000f5f0: 656e 6372 7970 7420 616e 6420 7369 676e  encrypt and sign
│ │ │ │ │ +0000f600: 206f 7065 7261 7469 6f6e 0a20 2020 2020   operation.     
│ │ │ │ │ +0000f610: 2746 4b4f 5f45 5252 4f52 5f47 5047 4d45  'FKO_ERROR_GPGME
│ │ │ │ │ +0000f620: 5f43 4f4e 5445 5854 5f53 4947 4e45 525f  _CONTEXT_SIGNER_
│ │ │ │ │ +0000f630: 4b45 5927 0a20 2020 2020 2020 2020 2055  KEY'.          U
│ │ │ │ │ +0000f640: 6e61 626c 6520 746f 2063 7265 6174 6520  nable to create 
│ │ │ │ │ +0000f650: 4750 474d 4520 636f 6e74 6578 7420 666f  GPGME context fo
│ │ │ │ │ +0000f660: 7220 7468 6520 7369 676e 6572 206b 6579  r the signer key
│ │ │ │ │ +0000f670: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ +0000f680: 5f47 5047 4d45 5f53 4947 4e45 525f 4b45  _GPGME_SIGNER_KE
│ │ │ │ │ +0000f690: 594c 4953 545f 5354 4152 5427 0a20 2020  YLIST_START'.   
│ │ │ │ │ +0000f6a0: 2020 2020 2020 2045 7272 6f72 2066 726f         Error fro
│ │ │ │ │ +0000f6b0: 6d20 7369 676e 6572 206b 6579 6c69 7374  m signer keylist
│ │ │ │ │ +0000f6c0: 2073 7461 7274 206f 7065 7261 7469 6f6e   start operation
│ │ │ │ │ +0000f6d0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ +0000f6e0: 5f47 5047 4d45 5f53 4947 4e45 525f 4b45  _GPGME_SIGNER_KE
│ │ │ │ │ +0000f6f0: 595f 4e4f 545f 464f 554e 4427 0a20 2020  Y_NOT_FOUND'.   
│ │ │ │ │ +0000f700: 2020 2020 2020 2054 6865 206b 6579 2066         The key f
│ │ │ │ │ +0000f710: 6f72 2074 6865 2067 6976 656e 2073 6967  or the given sig
│ │ │ │ │ +0000f720: 6e65 7220 7761 7320 6e6f 7420 666f 756e  ner was not foun
│ │ │ │ │ +0000f730: 640a 2020 2020 2027 464b 4f5f 4552 524f  d.     'FKO_ERRO
│ │ │ │ │ +0000f740: 525f 4750 474d 455f 5349 474e 4552 5f4b  R_GPGME_SIGNER_K
│ │ │ │ │ +0000f750: 4559 5f41 4d42 4947 554f 5553 270a 2020  EY_AMBIGUOUS'.  
│ │ │ │ │ +0000f760: 2020 2020 2020 2020 416d 6269 6775 6f75          Ambiguou
│ │ │ │ │ +0000f770: 7320 6e61 6d65 2f69 6420 666f 7220 7468  s name/id for th
│ │ │ │ │ +0000f780: 6520 7369 676e 6572 206b 6579 2028 6d75  e signer key (mu
│ │ │ │ │ +0000f790: 6c74 6970 6c65 206d 6174 6368 6573 290a  ltiple matches).
│ │ │ │ │ +0000f7a0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ +0000f7b0: 4750 474d 455f 4144 445f 5349 474e 4552  GPGME_ADD_SIGNER
│ │ │ │ │ +0000f7c0: 270a 2020 2020 2020 2020 2020 4572 726f  '.          Erro
│ │ │ │ │ +0000f7d0: 7220 6164 6469 6e67 2074 6865 2073 6967  r adding the sig
│ │ │ │ │ +0000f7e0: 6e65 7220 6b65 7920 746f 2074 6865 2067  ner key to the g
│ │ │ │ │ +0000f7f0: 7067 6d65 2063 6f6e 7465 7874 0a20 2020  pgme context.   
│ │ │ │ │ +0000f800: 2020 2746 4b4f 5f45 5252 4f52 5f47 5047    'FKO_ERROR_GPG
│ │ │ │ │ +0000f810: 4d45 5f43 4f4e 5445 5854 5f52 4543 4950  ME_CONTEXT_RECIP
│ │ │ │ │ +0000f820: 4945 4e54 5f4b 4559 270a 2020 2020 2020  IENT_KEY'.      
│ │ │ │ │ +0000f830: 2020 2020 556e 6162 6c65 2074 6f20 6372      Unable to cr
│ │ │ │ │ +0000f840: 6561 7465 2047 5047 4d45 2063 6f6e 7465  eate GPGME conte
│ │ │ │ │ +0000f850: 7874 2066 6f72 2074 6865 2072 6563 6970  xt for the recip
│ │ │ │ │ +0000f860: 6965 6e74 206b 6579 0a20 2020 2020 2746  ient key.     'F
│ │ │ │ │ +0000f870: 4b4f 5f45 5252 4f52 5f47 5047 4d45 5f52  KO_ERROR_GPGME_R
│ │ │ │ │ +0000f880: 4543 4950 4945 4e54 5f4b 4559 4c49 5354  ECIPIENT_KEYLIST
│ │ │ │ │ +0000f890: 5f53 5441 5254 270a 2020 2020 2020 2020  _START'.        
│ │ │ │ │ +0000f8a0: 2020 4572 726f 7220 6672 6f6d 2073 6967    Error from sig
│ │ │ │ │ +0000f8b0: 6e65 7220 6b65 796c 6973 7420 7374 6172  ner keylist star
│ │ │ │ │ +0000f8c0: 7420 6f70 6572 6174 696f 6e0a 2020 2020  t operation.    
│ │ │ │ │ +0000f8d0: 2027 464b 4f5f 4552 524f 525f 4750 474d   'FKO_ERROR_GPGM
│ │ │ │ │ +0000f8e0: 455f 5245 4349 5049 454e 545f 4b45 595f  E_RECIPIENT_KEY_
│ │ │ │ │ +0000f8f0: 4e4f 545f 464f 554e 4427 0a20 2020 2020  NOT_FOUND'.     
│ │ │ │ │ +0000f900: 2020 2020 2054 6865 206b 6579 2066 6f72       The key for
│ │ │ │ │ +0000f910: 2074 6865 2067 6976 656e 2072 6563 6970   the given recip
│ │ │ │ │ +0000f920: 6965 6e74 2077 6173 206e 6f74 2066 6f75  ient was not fou
│ │ │ │ │ +0000f930: 6e64 0a20 2020 2020 2746 4b4f 5f45 5252  nd.     'FKO_ERR
│ │ │ │ │ +0000f940: 4f52 5f47 5047 4d45 5f52 4543 4950 4945  OR_GPGME_RECIPIE
│ │ │ │ │ +0000f950: 4e54 5f4b 4559 5f41 4d42 4947 554f 5553  NT_KEY_AMBIGUOUS
│ │ │ │ │ +0000f960: 270a 2020 2020 2020 2020 2020 416d 6269  '.          Ambi
│ │ │ │ │ +0000f970: 6775 6f75 7320 6e61 6d65 2f69 6420 666f  guous name/id fo
│ │ │ │ │ +0000f980: 7220 7468 6520 7265 6369 7069 656e 7420  r the recipient 
│ │ │ │ │ +0000f990: 6b65 7920 286d 756c 7469 706c 6520 6d61  key (multiple ma
│ │ │ │ │ +0000f9a0: 7463 6865 7329 0a20 2020 2020 2746 4b4f  tches).     'FKO
│ │ │ │ │ +0000f9b0: 5f45 5252 4f52 5f47 5047 4d45 5f44 4543  _ERROR_GPGME_DEC
│ │ │ │ │ +0000f9c0: 5259 5054 5f46 4149 4c45 4427 0a20 2020  RYPT_FAILED'.   
│ │ │ │ │ +0000f9d0: 2020 2020 2020 2044 6563 7279 7074 696f         Decryptio
│ │ │ │ │ +0000f9e0: 6e20 6f70 6572 6174 696f 6e20 6661 696c  n operation fail
│ │ │ │ │ +0000f9f0: 6564 0a20 2020 2020 2746 4b4f 5f45 5252  ed.     'FKO_ERR
│ │ │ │ │ +0000fa00: 4f52 5f47 5047 4d45 5f42 4144 5f47 5047  OR_GPGME_BAD_GPG
│ │ │ │ │ +0000fa10: 5f45 5845 270a 2020 2020 2020 2020 2020  _EXE'.          
│ │ │ │ │ +0000fa20: 556e 6162 6c65 2074 6f20 7374 6174 2074  Unable to stat t
│ │ │ │ │ +0000fa30: 6865 2067 6976 656e 2047 5047 2065 7865  he given GPG exe
│ │ │ │ │ +0000fa40: 6375 7461 626c 650a 2020 2020 2027 464b  cutable.     'FK
│ │ │ │ │ +0000fa50: 4f5f 4552 524f 525f 4750 474d 455f 4241  O_ERROR_GPGME_BA
│ │ │ │ │ +0000fa60: 445f 484f 4d45 5f44 4952 270a 2020 2020  D_HOME_DIR'.    
│ │ │ │ │ +0000fa70: 2020 2020 2020 556e 6162 6c65 2074 6f20        Unable to 
│ │ │ │ │ +0000fa80: 7374 6174 2074 6865 2067 6976 656e 2047  stat the given G
│ │ │ │ │ +0000fa90: 5047 2068 6f6d 6520 6469 7265 6374 6f72  PG home director
│ │ │ │ │ +0000faa0: 790a 2020 2020 2027 464b 4f5f 4552 524f  y.     'FKO_ERRO
│ │ │ │ │ +0000fab0: 525f 4750 474d 455f 5345 545f 484f 4d45  R_GPGME_SET_HOME
│ │ │ │ │ +0000fac0: 5f44 4952 270a 2020 2020 2020 2020 2020  _DIR'.          
│ │ │ │ │ +0000fad0: 556e 6162 6c65 2074 6f20 7365 7420 7468  Unable to set th
│ │ │ │ │ +0000fae0: 6520 6769 7665 6e20 4750 4720 686f 6d65  e given GPG home
│ │ │ │ │ +0000faf0: 2064 6972 6563 746f 7279 0a20 2020 2020   directory.     
│ │ │ │ │ +0000fb00: 2746 4b4f 5f45 5252 4f52 5f47 5047 4d45  'FKO_ERROR_GPGME
│ │ │ │ │ +0000fb10: 5f4e 4f5f 5349 474e 4154 5552 4527 0a20  _NO_SIGNATURE'. 
│ │ │ │ │ +0000fb20: 2020 2020 2020 2020 204d 6973 7369 6e67           Missing
│ │ │ │ │ +0000fb30: 2047 5047 2073 6967 6e61 7475 7265 0a20   GPG signature. 
│ │ │ │ │ +0000fb40: 2020 2020 2746 4b4f 5f45 5252 4f52 5f47      'FKO_ERROR_G
│ │ │ │ │ +0000fb50: 5047 4d45 5f42 4144 5f53 4947 4e41 5455  PGME_BAD_SIGNATU
│ │ │ │ │ +0000fb60: 5245 270a 2020 2020 2020 2020 2020 4261  RE'.          Ba
│ │ │ │ │ +0000fb70: 6420 4750 4720 7369 676e 6174 7572 650a  d GPG signature.
│ │ │ │ │ +0000fb80: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ +0000fb90: 4750 474d 455f 5349 474e 4154 5552 455f  GPGME_SIGNATURE_
│ │ │ │ │ +0000fba0: 5645 5249 4659 5f44 4953 4142 4c45 4427  VERIFY_DISABLED'
│ │ │ │ │ +0000fbb0: 0a20 2020 2020 2020 2020 2054 7279 696e  .          Tryin
│ │ │ │ │ +0000fbc0: 6720 746f 2063 6865 636b 2073 6967 6e61  g to check signa
│ │ │ │ │ +0000fbd0: 7475 7265 2077 6974 6820 7665 7269 6669  ture with verifi
│ │ │ │ │ +0000fbe0: 6361 7469 6f6e 2064 6973 6162 6c65 640a  cation disabled.
│ │ │ │ │ +0000fbf0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ +0000fc00: 494e 5641 4c49 445f 4441 5441 5f45 4e43  INVALID_DATA_ENC
│ │ │ │ │ +0000fc10: 5259 5054 5f47 5047 5f4d 4553 5341 4745  RYPT_GPG_MESSAGE
│ │ │ │ │ +0000fc20: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    
│ │ │ │ │ +0000fc30: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ +0000fc40: 7461 3a20 656e 6372 7970 743a 2069 6e76  ta: encrypt: inv
│ │ │ │ │ +0000fc50: 616c 6964 2047 5047 2d65 6e63 7279 7074  alid GPG-encrypt
│ │ │ │ │ +0000fc60: 206d 6573 7361 6765 0a20 2020 2020 2746   message.     'F
│ │ │ │ │ +0000fc70: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ +0000fc80: 5f44 4154 415f 454e 4352 5950 545f 4750  _DATA_ENCRYPT_GP
│ │ │ │ │ +0000fc90: 475f 4449 4745 5354 5f56 414c 4944 4641  G_DIGEST_VALIDFA
│ │ │ │ │ +0000fca0: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In
│ │ │ │ │ +0000fcb0: 7661 6c69 6420 6461 7461 3a20 656e 6372  valid data: encr
│ │ │ │ │ +0000fcc0: 7970 743a 2069 6e76 616c 6964 2047 5047  ypt: invalid GPG
│ │ │ │ │ +0000fcd0: 2064 6967 6573 740a 2020 2020 2027 464b   digest.     'FK
│ │ │ │ │ +0000fce0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ +0000fcf0: 4441 5441 5f45 4e43 5259 5054 5f47 5047  DATA_ENCRYPT_GPG
│ │ │ │ │ +0000fd00: 5f4d 5347 4c45 4e5f 5641 4c49 4446 4149  _MSGLEN_VALIDFAI
│ │ │ │ │ +0000fd10: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv
│ │ │ │ │ +0000fd20: 616c 6964 2064 6174 613a 2065 6e63 7279  alid data: encry
│ │ │ │ │ +0000fd30: 7074 3a20 696e 7661 6c69 6420 4750 4720  pt: invalid GPG 
│ │ │ │ │ +0000fd40: 6d65 7373 6167 6520 6c65 6e67 7468 0a20  message length. 
│ │ │ │ │ +0000fd50: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ +0000fd60: 4e56 414c 4944 5f44 4154 415f 454e 4352  NVALID_DATA_ENCR
│ │ │ │ │ +0000fd70: 5950 545f 4750 475f 5245 5355 4c54 5f4d  YPT_GPG_RESULT_M
│ │ │ │ │ +0000fd80: 5347 4c45 4e5f 5641 4c49 4446 4149 4c27  SGLEN_VALIDFAIL'
│ │ │ │ │ +0000fd90: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ +0000fda0: 6964 2064 6174 613a 2065 6e63 7279 7074  id data: encrypt
│ │ │ │ │ +0000fdb0: 3a20 696e 7661 6c69 6420 4750 4720 7265  : invalid GPG re
│ │ │ │ │ +0000fdc0: 7375 6c74 206d 6573 7361 6765 206c 656e  sult message len
│ │ │ │ │ +0000fdd0: 6774 680a 2020 2020 2027 464b 4f5f 4552  gth.     'FKO_ER
│ │ │ │ │ +0000fde0: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ +0000fdf0: 5f45 4e43 5259 5054 5f47 5047 5f43 4950  _ENCRYPT_GPG_CIP
│ │ │ │ │ +0000fe00: 4845 525f 4445 434f 4445 4641 494c 270a  HER_DECODEFAIL'.
│ │ │ │ │ +0000fe10: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ +0000fe20: 6420 6461 7461 3a20 656e 6372 7970 743a  d data: encrypt:
│ │ │ │ │ +0000fe30: 2047 5047 2063 6970 6865 7220 6661 696c   GPG cipher fail
│ │ │ │ │ +0000fe40: 6564 0a20 2020 2020 2746 4b4f 5f45 5252  ed.     'FKO_ERR
│ │ │ │ │ +0000fe50: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_
│ │ │ │ │ +0000fe60: 454e 4352 5950 545f 4750 475f 454e 434f  ENCRYPT_GPG_ENCO
│ │ │ │ │ +0000fe70: 4445 444d 5347 5f4e 554c 4c27 0a20 2020  DEDMSG_NULL'.   
│ │ │ │ │ +0000fe80: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d
│ │ │ │ │ +0000fe90: 6174 613a 2065 6e63 7279 7074 3a20 4750  ata: encrypt: GP
│ │ │ │ │ +0000fea0: 472d 656e 636f 6465 6420 6d65 7373 6167  G-encoded messag
│ │ │ │ │ +0000feb0: 6520 6973 204e 554c 4c0a 2020 2020 2027  e is NULL.     '
│ │ │ │ │ +0000fec0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ +0000fed0: 445f 4441 5441 5f45 4e43 5259 5054 5f47  D_DATA_ENCRYPT_G
│ │ │ │ │ +0000fee0: 5047 5f45 4e43 4f44 4544 4d53 474c 454e  PG_ENCODEDMSGLEN
│ │ │ │ │ +0000fef0: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    
│ │ │ │ │ +0000ff00: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ +0000ff10: 7461 3a20 656e 6372 7970 743a 2069 6e76  ta: encrypt: inv
│ │ │ │ │ +0000ff20: 616c 6964 2047 5047 2d65 6e63 7279 7074  alid GPG-encrypt
│ │ │ │ │ +0000ff30: 6564 206d 6573 7361 6765 206c 656e 6774  ed message lengt
│ │ │ │ │ +0000ff40: 680a 0a20 2020 596f 7520 6361 6e20 7573  h..   You can us
│ │ │ │ │ +0000ff50: 6520 7468 6520 2749 535f 4750 474d 455f  e the 'IS_GPGME_
│ │ │ │ │ +0000ff60: 4552 524f 5228 6572 725f 636f 6465 2927  ERROR(err_code)'
│ │ │ │ │ +0000ff70: 206d 6163 726f 2074 6f20 6465 7465 726d   macro to determ
│ │ │ │ │ +0000ff80: 696e 6520 7768 6574 6865 720a 6f72 206e  ine whether.or n
│ │ │ │ │ +0000ff90: 6f74 2061 6e20 6572 726f 7220 6964 2047  ot an error id G
│ │ │ │ │ +0000ffa0: 5047 4d45 2072 656c 6174 6564 2e20 2049  PGME related.  I
│ │ │ │ │ +0000ffb0: 6620 7468 6520 6d61 6372 6f20 6576 616c  f the macro eval
│ │ │ │ │ +0000ffc0: 7561 7465 7320 746f 2061 2074 7275 650a  uates to a true.
│ │ │ │ │ +0000ffd0: 7661 6c75 652c 2079 6f75 206d 6179 2062  value, you may b
│ │ │ │ │ +0000ffe0: 6520 6162 6c65 2074 6f20 6765 7420 6164  e able to get ad
│ │ │ │ │ +0000fff0: 6469 7469 6f6e 616c 2069 6e66 6f72 6d61  ditional informa
│ │ │ │ │ +00010000: 7469 6f6e 2061 626f 7574 2074 6865 2065  tion about the e
│ │ │ │ │ +00010010: 7272 6f72 0a75 7369 6e67 2074 6865 2066  rror.using the f
│ │ │ │ │ +00010020: 6f6c 6c6f 7769 6e67 2066 756e 6374 696f  ollowing functio
│ │ │ │ │ +00010030: 6e3a 0a0a 202d 2d20 4675 6e63 7469 6f6e  n:.. -- Function
│ │ │ │ │ +00010040: 3a20 636f 6e73 7420 6368 6172 202a 2066  : const char * f
│ │ │ │ │ +00010050: 6b6f 5f67 7067 5f65 7272 7374 7220 2869  ko_gpg_errstr (i
│ │ │ │ │ +00010060: 6e74 2045 5252 5f43 4f44 4529 0a20 2020  nt ERR_CODE).   
│ │ │ │ │ +00010070: 2020 5468 6520 6675 6e63 7469 6f6e 2027    The function '
│ │ │ │ │ +00010080: 666b 6f5f 6572 7273 7472 2720 7265 7475  fko_errstr' retu
│ │ │ │ │ +00010090: 726e 7320 6120 706f 696e 7465 7220 746f  rns a pointer to
│ │ │ │ │ +000100a0: 2061 2073 7461 7469 6361 6c6c 790a 2020   a statically.  
│ │ │ │ │ +000100b0: 2020 2061 6c6c 6f63 6174 6564 2073 7472     allocated str
│ │ │ │ │ +000100c0: 696e 6720 636f 6e74 6169 6e69 6e67 2074  ing containing t
│ │ │ │ │ +000100d0: 6865 2064 6573 6372 6970 7469 6f6e 206f  he description o
│ │ │ │ │ +000100e0: 6620 7468 6520 4750 474d 4520 6572 726f  f the GPGME erro
│ │ │ │ │ +000100f0: 722e 0a0a 2a4e 6f74 652a 3a20 466f 7220  r...*Note*: For 
│ │ │ │ │ +00010100: 736f 6d65 2065 7272 6f72 732c 2074 6869  some errors, thi
│ │ │ │ │ +00010110: 7320 6675 6e63 7469 6f6e 206d 6179 2072  s function may r
│ │ │ │ │ +00010120: 6574 7572 6e20 616e 2065 6d70 7479 2073  eturn an empty s
│ │ │ │ │ +00010130: 7472 696e 672e 0a0a 1f0a 4669 6c65 3a20  tring.....File: 
│ │ │ │ │ +00010140: 6c69 6266 6b6f 2e69 6e66 6f2c 2020 4e6f  libfko.info,  No
│ │ │ │ │ +00010150: 6465 3a20 4c69 6272 6172 7920 436f 7079  de: Library Copy
│ │ │ │ │ +00010160: 696e 672c 2020 4e65 7874 3a20 436f 6e63  ing,  Next: Conc
│ │ │ │ │ +00010170: 6570 7420 496e 6465 782c 2020 5072 6576  ept Index,  Prev
│ │ │ │ │ +00010180: 3a20 5573 696e 6720 6c69 6266 6b6f 2c20  : Using libfko, 
│ │ │ │ │ +00010190: 2055 703a 2054 6f70 0a0a 4170 7065 6e64   Up: Top..Append
│ │ │ │ │ +000101a0: 6978 2041 2047 4e55 2047 454e 4552 414c  ix A GNU GENERAL
│ │ │ │ │ +000101b0: 2050 5542 4c49 4320 4c49 4345 4e53 450a   PUBLIC LICENSE.
│ │ │ │ │ +000101c0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ****************
│ │ │ │ │  000101d0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ****************
│ │ │ │ │ -000101e0: 2a2a 2a2a 2a2a 2a0a 0a20 2020 2020 2020  *******..       
│ │ │ │ │ -000101f0: 2020 2020 2020 2056 6572 7369 6f6e 2032         Version 2
│ │ │ │ │ -00010200: 2028 6f72 2061 6e79 206c 6174 6572 2076   (or any later v
│ │ │ │ │ -00010210: 6572 7369 6f6e 292c 204a 756e 6520 3139  ersion), June 19
│ │ │ │ │ -00010220: 3931 0a0a 2020 2020 2043 6f70 7972 6967  91..     Copyrig
│ │ │ │ │ -00010230: 6874 2028 4329 2031 3938 392c 2031 3939  ht (C) 1989, 199
│ │ │ │ │ -00010240: 3120 4672 6565 2053 6f66 7477 6172 6520  1 Free Software 
│ │ │ │ │ -00010250: 466f 756e 6461 7469 6f6e 2c20 496e 632e  Foundation, Inc.
│ │ │ │ │ -00010260: 0a20 2020 2020 3531 2046 7261 6e6b 6c69  .     51 Frankli
│ │ │ │ │ -00010270: 6e20 5374 7265 6574 2c20 4669 6674 6820  n Street, Fifth 
│ │ │ │ │ -00010280: 466c 6f6f 722c 2042 6f73 746f 6e2c 204d  Floor, Boston, M
│ │ │ │ │ -00010290: 4120 2030 3231 3130 2d31 3330 312c 2055  A  02110-1301, U
│ │ │ │ │ -000102a0: 5341 0a0a 2020 2020 2045 7665 7279 6f6e  SA..     Everyon
│ │ │ │ │ -000102b0: 6520 6973 2070 6572 6d69 7474 6564 2074  e is permitted t
│ │ │ │ │ -000102c0: 6f20 636f 7079 2061 6e64 2064 6973 7472  o copy and distr
│ │ │ │ │ -000102d0: 6962 7574 6520 7665 7262 6174 696d 2063  ibute verbatim c
│ │ │ │ │ -000102e0: 6f70 6965 730a 2020 2020 206f 6620 7468  opies.     of th
│ │ │ │ │ -000102f0: 6973 206c 6963 656e 7365 2064 6f63 756d  is license docum
│ │ │ │ │ -00010300: 656e 742c 2062 7574 2063 6861 6e67 696e  ent, but changin
│ │ │ │ │ -00010310: 6720 6974 2069 7320 6e6f 7420 616c 6c6f  g it is not allo
│ │ │ │ │ -00010320: 7765 642e 0a0a 412e 3120 5072 6561 6d62  wed...A.1 Preamb
│ │ │ │ │ -00010330: 6c65 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a  le.============.
│ │ │ │ │ -00010340: 0a54 6865 206c 6963 656e 7365 7320 666f  .The licenses fo
│ │ │ │ │ -00010350: 7220 6d6f 7374 2073 6f66 7477 6172 6520  r most software 
│ │ │ │ │ -00010360: 6172 6520 6465 7369 676e 6564 2074 6f20  are designed to 
│ │ │ │ │ -00010370: 7461 6b65 2061 7761 7920 796f 7572 2066  take away your f
│ │ │ │ │ -00010380: 7265 6564 6f6d 2074 6f0a 7368 6172 6520  reedom to.share 
│ │ │ │ │ -00010390: 616e 6420 6368 616e 6765 2069 742e 2020  and change it.  
│ │ │ │ │ -000103a0: 4279 2063 6f6e 7472 6173 742c 2074 6865  By contrast, the
│ │ │ │ │ -000103b0: 2047 4e55 2047 656e 6572 616c 2050 7562   GNU General Pub
│ │ │ │ │ -000103c0: 6c69 6320 4c69 6365 6e73 6520 6973 0a69  lic License is.i
│ │ │ │ │ -000103d0: 6e74 656e 6465 6420 746f 2067 7561 7261  ntended to guara
│ │ │ │ │ -000103e0: 6e74 6565 2079 6f75 7220 6672 6565 646f  ntee your freedo
│ │ │ │ │ -000103f0: 6d20 746f 2073 6861 7265 2061 6e64 2063  m to share and c
│ │ │ │ │ -00010400: 6861 6e67 6520 6672 6565 2073 6f66 7477  hange free softw
│ │ │ │ │ -00010410: 6172 652d 2d74 6f0a 6d61 6b65 2073 7572  are--to.make sur
│ │ │ │ │ -00010420: 6520 7468 6520 736f 6674 7761 7265 2069  e the software i
│ │ │ │ │ -00010430: 7320 6672 6565 2066 6f72 2061 6c6c 2069  s free for all i
│ │ │ │ │ -00010440: 7473 2075 7365 7273 2e20 2054 6869 7320  ts users.  This 
│ │ │ │ │ -00010450: 4765 6e65 7261 6c20 5075 626c 6963 0a4c  General Public.L
│ │ │ │ │ -00010460: 6963 656e 7365 2061 7070 6c69 6573 2074  icense applies t
│ │ │ │ │ -00010470: 6f20 6d6f 7374 206f 6620 7468 6520 4672  o most of the Fr
│ │ │ │ │ -00010480: 6565 2053 6f66 7477 6172 6520 466f 756e  ee Software Foun
│ │ │ │ │ -00010490: 6461 7469 6f6e 2773 2073 6f66 7477 6172  dation's softwar
│ │ │ │ │ -000104a0: 6520 616e 640a 746f 2061 6e79 206f 7468  e and.to any oth
│ │ │ │ │ -000104b0: 6572 2070 726f 6772 616d 2077 686f 7365  er program whose
│ │ │ │ │ -000104c0: 2061 7574 686f 7273 2063 6f6d 6d69 7420   authors commit 
│ │ │ │ │ -000104d0: 746f 2075 7369 6e67 2069 742e 2020 2853  to using it.  (S
│ │ │ │ │ -000104e0: 6f6d 6520 6f74 6865 7220 4672 6565 0a53  ome other Free.S
│ │ │ │ │ -000104f0: 6f66 7477 6172 6520 466f 756e 6461 7469  oftware Foundati
│ │ │ │ │ -00010500: 6f6e 2073 6f66 7477 6172 6520 6973 2063  on software is c
│ │ │ │ │ -00010510: 6f76 6572 6564 2062 7920 7468 6520 474e  overed by the GN
│ │ │ │ │ -00010520: 5520 4c65 7373 6572 2047 656e 6572 616c  U Lesser General
│ │ │ │ │ -00010530: 2050 7562 6c69 630a 4c69 6365 6e73 6520   Public.License 
│ │ │ │ │ -00010540: 696e 7374 6561 642e 2920 2059 6f75 2063  instead.)  You c
│ │ │ │ │ -00010550: 616e 2061 7070 6c79 2069 7420 746f 2079  an apply it to y
│ │ │ │ │ -00010560: 6f75 7220 7072 6f67 7261 6d73 2c20 746f  our programs, to
│ │ │ │ │ -00010570: 6f2e 0a0a 2020 2057 6865 6e20 7765 2073  o...   When we s
│ │ │ │ │ -00010580: 7065 616b 206f 6620 6672 6565 2073 6f66  peak of free sof
│ │ │ │ │ -00010590: 7477 6172 652c 2077 6520 6172 6520 7265  tware, we are re
│ │ │ │ │ -000105a0: 6665 7272 696e 6720 746f 2066 7265 6564  ferring to freed
│ │ │ │ │ -000105b0: 6f6d 2c20 6e6f 740a 7072 6963 652e 2020  om, not.price.  
│ │ │ │ │ -000105c0: 4f75 7220 4765 6e65 7261 6c20 5075 626c  Our General Publ
│ │ │ │ │ -000105d0: 6963 204c 6963 656e 7365 7320 6172 6520  ic Licenses are 
│ │ │ │ │ -000105e0: 6465 7369 676e 6564 2074 6f20 6d61 6b65  designed to make
│ │ │ │ │ -000105f0: 2073 7572 6520 7468 6174 2079 6f75 0a68   sure that you.h
│ │ │ │ │ -00010600: 6176 6520 7468 6520 6672 6565 646f 6d20  ave the freedom 
│ │ │ │ │ -00010610: 746f 2064 6973 7472 6962 7574 6520 636f  to distribute co
│ │ │ │ │ -00010620: 7069 6573 206f 6620 6672 6565 2073 6f66  pies of free sof
│ │ │ │ │ -00010630: 7477 6172 6520 2861 6e64 2063 6861 7267  tware (and charg
│ │ │ │ │ -00010640: 6520 666f 720a 7468 6973 2073 6572 7669  e for.this servi
│ │ │ │ │ -00010650: 6365 2069 6620 796f 7520 7769 7368 292c  ce if you wish),
│ │ │ │ │ -00010660: 2074 6861 7420 796f 7520 7265 6365 6976   that you receiv
│ │ │ │ │ -00010670: 6520 736f 7572 6365 2063 6f64 6520 6f72  e source code or
│ │ │ │ │ -00010680: 2063 616e 2067 6574 2069 7420 6966 0a79   can get it if.y
│ │ │ │ │ -00010690: 6f75 2077 616e 7420 6974 2c20 7468 6174  ou want it, that
│ │ │ │ │ -000106a0: 2079 6f75 2063 616e 2063 6861 6e67 6520   you can change 
│ │ │ │ │ -000106b0: 7468 6520 736f 6674 7761 7265 206f 7220  the software or 
│ │ │ │ │ -000106c0: 7573 6520 7069 6563 6573 206f 6620 6974  use pieces of it
│ │ │ │ │ -000106d0: 2069 6e20 6e65 770a 6672 6565 2070 726f   in new.free pro
│ │ │ │ │ -000106e0: 6772 616d 733b 2061 6e64 2074 6861 7420  grams; and that 
│ │ │ │ │ -000106f0: 796f 7520 6b6e 6f77 2079 6f75 2063 616e  you know you can
│ │ │ │ │ -00010700: 2064 6f20 7468 6573 6520 7468 696e 6773   do these things
│ │ │ │ │ -00010710: 2e0a 0a20 2020 546f 2070 726f 7465 6374  ...   To protect
│ │ │ │ │ -00010720: 2079 6f75 7220 7269 6768 7473 2c20 7765   your rights, we
│ │ │ │ │ -00010730: 206e 6565 6420 746f 206d 616b 6520 7265   need to make re
│ │ │ │ │ -00010740: 7374 7269 6374 696f 6e73 2074 6861 7420  strictions that 
│ │ │ │ │ -00010750: 666f 7262 6964 0a61 6e79 6f6e 6520 746f  forbid.anyone to
│ │ │ │ │ -00010760: 2064 656e 7920 796f 7520 7468 6573 6520   deny you these 
│ │ │ │ │ -00010770: 7269 6768 7473 206f 7220 746f 2061 736b  rights or to ask
│ │ │ │ │ -00010780: 2079 6f75 2074 6f20 7375 7272 656e 6465   you to surrende
│ │ │ │ │ -00010790: 7220 7468 6520 7269 6768 7473 2e0a 5468  r the rights..Th
│ │ │ │ │ -000107a0: 6573 6520 7265 7374 7269 6374 696f 6e73  ese restrictions
│ │ │ │ │ -000107b0: 2074 7261 6e73 6c61 7465 2074 6f20 6365   translate to ce
│ │ │ │ │ -000107c0: 7274 6169 6e20 7265 7370 6f6e 7369 6269  rtain responsibi
│ │ │ │ │ -000107d0: 6c69 7469 6573 2066 6f72 2079 6f75 2069  lities for you i
│ │ │ │ │ -000107e0: 6620 796f 750a 6469 7374 7269 6275 7465  f you.distribute
│ │ │ │ │ -000107f0: 2063 6f70 6965 7320 6f66 2074 6865 2073   copies of the s
│ │ │ │ │ -00010800: 6f66 7477 6172 652c 206f 7220 6966 2079  oftware, or if y
│ │ │ │ │ -00010810: 6f75 206d 6f64 6966 7920 6974 2e0a 0a20  ou modify it... 
│ │ │ │ │ -00010820: 2020 466f 7220 6578 616d 706c 652c 2069    For example, i
│ │ │ │ │ -00010830: 6620 796f 7520 6469 7374 7269 6275 7465  f you distribute
│ │ │ │ │ -00010840: 2063 6f70 6965 7320 6f66 2073 7563 6820   copies of such 
│ │ │ │ │ -00010850: 6120 7072 6f67 7261 6d2c 2077 6865 7468  a program, wheth
│ │ │ │ │ -00010860: 6572 0a67 7261 7469 7320 6f72 2066 6f72  er.gratis or for
│ │ │ │ │ -00010870: 2061 2066 6565 2c20 796f 7520 6d75 7374   a fee, you must
│ │ │ │ │ -00010880: 2067 6976 6520 7468 6520 7265 6369 7069   give the recipi
│ │ │ │ │ -00010890: 656e 7473 2061 6c6c 2074 6865 2072 6967  ents all the rig
│ │ │ │ │ -000108a0: 6874 7320 7468 6174 0a79 6f75 2068 6176  hts that.you hav
│ │ │ │ │ -000108b0: 652e 2020 596f 7520 6d75 7374 206d 616b  e.  You must mak
│ │ │ │ │ -000108c0: 6520 7375 7265 2074 6861 7420 7468 6579  e sure that they
│ │ │ │ │ -000108d0: 2c20 746f 6f2c 2072 6563 6569 7665 206f  , too, receive o
│ │ │ │ │ -000108e0: 7220 6361 6e20 6765 7420 7468 650a 736f  r can get the.so
│ │ │ │ │ -000108f0: 7572 6365 2063 6f64 652e 2020 416e 6420  urce code.  And 
│ │ │ │ │ -00010900: 796f 7520 6d75 7374 2073 686f 7720 7468  you must show th
│ │ │ │ │ -00010910: 656d 2074 6865 7365 2074 6572 6d73 2073  em these terms s
│ │ │ │ │ -00010920: 6f20 7468 6579 206b 6e6f 7720 7468 6569  o they know thei
│ │ │ │ │ -00010930: 720a 7269 6768 7473 2e0a 0a20 2020 5765  r.rights...   We
│ │ │ │ │ -00010940: 2070 726f 7465 6374 2079 6f75 7220 7269   protect your ri
│ │ │ │ │ -00010950: 6768 7473 2077 6974 6820 7477 6f20 7374  ghts with two st
│ │ │ │ │ -00010960: 6570 733a 2028 3129 2063 6f70 7972 6967  eps: (1) copyrig
│ │ │ │ │ -00010970: 6874 2074 6865 2073 6f66 7477 6172 652c  ht the software,
│ │ │ │ │ -00010980: 0a61 6e64 2028 3229 206f 6666 6572 2079  .and (2) offer y
│ │ │ │ │ -00010990: 6f75 2074 6869 7320 6c69 6365 6e73 6520  ou this license 
│ │ │ │ │ -000109a0: 7768 6963 6820 6769 7665 7320 796f 7520  which gives you 
│ │ │ │ │ -000109b0: 6c65 6761 6c20 7065 726d 6973 7369 6f6e  legal permission
│ │ │ │ │ -000109c0: 2074 6f20 636f 7079 2c0a 6469 7374 7269   to copy,.distri
│ │ │ │ │ -000109d0: 6275 7465 2061 6e64 2f6f 7220 6d6f 6469  bute and/or modi
│ │ │ │ │ -000109e0: 6679 2074 6865 2073 6f66 7477 6172 652e  fy the software.
│ │ │ │ │ -000109f0: 0a0a 2020 2041 6c73 6f2c 2066 6f72 2065  ..   Also, for e
│ │ │ │ │ -00010a00: 6163 6820 6175 7468 6f72 2773 2070 726f  ach author's pro
│ │ │ │ │ -00010a10: 7465 6374 696f 6e20 616e 6420 6f75 7273  tection and ours
│ │ │ │ │ -00010a20: 2c20 7765 2077 616e 7420 746f 206d 616b  , we want to mak
│ │ │ │ │ -00010a30: 6520 6365 7274 6169 6e0a 7468 6174 2065  e certain.that e
│ │ │ │ │ -00010a40: 7665 7279 6f6e 6520 756e 6465 7273 7461  veryone understa
│ │ │ │ │ -00010a50: 6e64 7320 7468 6174 2074 6865 7265 2069  nds that there i
│ │ │ │ │ -00010a60: 7320 6e6f 2077 6172 7261 6e74 7920 666f  s no warranty fo
│ │ │ │ │ -00010a70: 7220 7468 6973 2066 7265 650a 736f 6674  r this free.soft
│ │ │ │ │ -00010a80: 7761 7265 2e20 2049 6620 7468 6520 736f  ware.  If the so
│ │ │ │ │ -00010a90: 6674 7761 7265 2069 7320 6d6f 6469 6669  ftware is modifi
│ │ │ │ │ -00010aa0: 6564 2062 7920 736f 6d65 6f6e 6520 656c  ed by someone el
│ │ │ │ │ -00010ab0: 7365 2061 6e64 2070 6173 7365 6420 6f6e  se and passed on
│ │ │ │ │ -00010ac0: 2c20 7765 0a77 616e 7420 6974 7320 7265  , we.want its re
│ │ │ │ │ -00010ad0: 6369 7069 656e 7473 2074 6f20 6b6e 6f77  cipients to know
│ │ │ │ │ -00010ae0: 2074 6861 7420 7768 6174 2074 6865 7920   that what they 
│ │ │ │ │ -00010af0: 6861 7665 2069 7320 6e6f 7420 7468 6520  have is not the 
│ │ │ │ │ -00010b00: 6f72 6967 696e 616c 2c20 736f 0a74 6861  original, so.tha
│ │ │ │ │ -00010b10: 7420 616e 7920 7072 6f62 6c65 6d73 2069  t any problems i
│ │ │ │ │ -00010b20: 6e74 726f 6475 6365 6420 6279 206f 7468  ntroduced by oth
│ │ │ │ │ -00010b30: 6572 7320 7769 6c6c 206e 6f74 2072 6566  ers will not ref
│ │ │ │ │ -00010b40: 6c65 6374 206f 6e20 7468 6520 6f72 6967  lect on the orig
│ │ │ │ │ -00010b50: 696e 616c 0a61 7574 686f 7273 2720 7265  inal.authors' re
│ │ │ │ │ -00010b60: 7075 7461 7469 6f6e 732e 0a0a 2020 2046  putations...   F
│ │ │ │ │ -00010b70: 696e 616c 6c79 2c20 616e 7920 6672 6565  inally, any free
│ │ │ │ │ -00010b80: 2070 726f 6772 616d 2069 7320 7468 7265   program is thre
│ │ │ │ │ -00010b90: 6174 656e 6564 2063 6f6e 7374 616e 746c  atened constantl
│ │ │ │ │ -00010ba0: 7920 6279 2073 6f66 7477 6172 650a 7061  y by software.pa
│ │ │ │ │ -00010bb0: 7465 6e74 732e 2020 5765 2077 6973 6820  tents.  We wish 
│ │ │ │ │ -00010bc0: 746f 2061 766f 6964 2074 6865 2064 616e  to avoid the dan
│ │ │ │ │ -00010bd0: 6765 7220 7468 6174 2072 6564 6973 7472  ger that redistr
│ │ │ │ │ -00010be0: 6962 7574 6f72 7320 6f66 2061 2066 7265  ibutors of a fre
│ │ │ │ │ -00010bf0: 650a 7072 6f67 7261 6d20 7769 6c6c 2069  e.program will i
│ │ │ │ │ -00010c00: 6e64 6976 6964 7561 6c6c 7920 6f62 7461  ndividually obta
│ │ │ │ │ -00010c10: 696e 2070 6174 656e 7420 6c69 6365 6e73  in patent licens
│ │ │ │ │ -00010c20: 6573 2c20 696e 2065 6666 6563 7420 6d61  es, in effect ma
│ │ │ │ │ -00010c30: 6b69 6e67 2074 6865 0a70 726f 6772 616d  king the.program
│ │ │ │ │ -00010c40: 2070 726f 7072 6965 7461 7279 2e20 2054   proprietary.  T
│ │ │ │ │ -00010c50: 6f20 7072 6576 656e 7420 7468 6973 2c20  o prevent this, 
│ │ │ │ │ -00010c60: 7765 2068 6176 6520 6d61 6465 2069 7420  we have made it 
│ │ │ │ │ -00010c70: 636c 6561 7220 7468 6174 2061 6e79 0a70  clear that any.p
│ │ │ │ │ -00010c80: 6174 656e 7420 6d75 7374 2062 6520 6c69  atent must be li
│ │ │ │ │ -00010c90: 6365 6e73 6564 2066 6f72 2065 7665 7279  censed for every
│ │ │ │ │ -00010ca0: 6f6e 6527 7320 6672 6565 2075 7365 206f  one's free use o
│ │ │ │ │ -00010cb0: 7220 6e6f 7420 6c69 6365 6e73 6564 2061  r not licensed a
│ │ │ │ │ -00010cc0: 7420 616c 6c2e 0a0a 2020 2054 6865 2070  t all...   The p
│ │ │ │ │ -00010cd0: 7265 6369 7365 2074 6572 6d73 2061 6e64  recise terms and
│ │ │ │ │ -00010ce0: 2063 6f6e 6469 7469 6f6e 7320 666f 7220   conditions for 
│ │ │ │ │ -00010cf0: 636f 7079 696e 672c 2064 6973 7472 6962  copying, distrib
│ │ │ │ │ -00010d00: 7574 696f 6e20 616e 640a 6d6f 6469 6669  ution and.modifi
│ │ │ │ │ -00010d10: 6361 7469 6f6e 2066 6f6c 6c6f 772e 0a0a  cation follow...
│ │ │ │ │ +000101e0: 2a2a 2a2a 2a0a 0a20 2020 2020 2020 2020  *****..         
│ │ │ │ │ +000101f0: 2020 2020 2056 6572 7369 6f6e 2032 2028       Version 2 (
│ │ │ │ │ +00010200: 6f72 2061 6e79 206c 6174 6572 2076 6572  or any later ver
│ │ │ │ │ +00010210: 7369 6f6e 292c 204a 756e 6520 3139 3931  sion), June 1991
│ │ │ │ │ +00010220: 0a0a 2020 2020 2043 6f70 7972 6967 6874  ..     Copyright
│ │ │ │ │ +00010230: 2028 4329 2031 3938 392c 2031 3939 3120   (C) 1989, 1991 
│ │ │ │ │ +00010240: 4672 6565 2053 6f66 7477 6172 6520 466f  Free Software Fo
│ │ │ │ │ +00010250: 756e 6461 7469 6f6e 2c20 496e 632e 0a20  undation, Inc.. 
│ │ │ │ │ +00010260: 2020 2020 3531 2046 7261 6e6b 6c69 6e20      51 Franklin 
│ │ │ │ │ +00010270: 5374 7265 6574 2c20 4669 6674 6820 466c  Street, Fifth Fl
│ │ │ │ │ +00010280: 6f6f 722c 2042 6f73 746f 6e2c 204d 4120  oor, Boston, MA 
│ │ │ │ │ +00010290: 2030 3231 3130 2d31 3330 312c 2055 5341   02110-1301, USA
│ │ │ │ │ +000102a0: 0a0a 2020 2020 2045 7665 7279 6f6e 6520  ..     Everyone 
│ │ │ │ │ +000102b0: 6973 2070 6572 6d69 7474 6564 2074 6f20  is permitted to 
│ │ │ │ │ +000102c0: 636f 7079 2061 6e64 2064 6973 7472 6962  copy and distrib
│ │ │ │ │ +000102d0: 7574 6520 7665 7262 6174 696d 2063 6f70  ute verbatim cop
│ │ │ │ │ +000102e0: 6965 730a 2020 2020 206f 6620 7468 6973  ies.     of this
│ │ │ │ │ +000102f0: 206c 6963 656e 7365 2064 6f63 756d 656e   license documen
│ │ │ │ │ +00010300: 742c 2062 7574 2063 6861 6e67 696e 6720  t, but changing 
│ │ │ │ │ +00010310: 6974 2069 7320 6e6f 7420 616c 6c6f 7765  it is not allowe
│ │ │ │ │ +00010320: 642e 0a0a 412e 3120 5072 6561 6d62 6c65  d...A.1 Preamble
│ │ │ │ │ +00010330: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54  .============..T
│ │ │ │ │ +00010340: 6865 206c 6963 656e 7365 7320 666f 7220  he licenses for 
│ │ │ │ │ +00010350: 6d6f 7374 2073 6f66 7477 6172 6520 6172  most software ar
│ │ │ │ │ +00010360: 6520 6465 7369 676e 6564 2074 6f20 7461  e designed to ta
│ │ │ │ │ +00010370: 6b65 2061 7761 7920 796f 7572 2066 7265  ke away your fre
│ │ │ │ │ +00010380: 6564 6f6d 2074 6f0a 7368 6172 6520 616e  edom to.share an
│ │ │ │ │ +00010390: 6420 6368 616e 6765 2069 742e 2020 4279  d change it.  By
│ │ │ │ │ +000103a0: 2063 6f6e 7472 6173 742c 2074 6865 2047   contrast, the G
│ │ │ │ │ +000103b0: 4e55 2047 656e 6572 616c 2050 7562 6c69  NU General Publi
│ │ │ │ │ +000103c0: 6320 4c69 6365 6e73 6520 6973 0a69 6e74  c License is.int
│ │ │ │ │ +000103d0: 656e 6465 6420 746f 2067 7561 7261 6e74  ended to guarant
│ │ │ │ │ +000103e0: 6565 2079 6f75 7220 6672 6565 646f 6d20  ee your freedom 
│ │ │ │ │ +000103f0: 746f 2073 6861 7265 2061 6e64 2063 6861  to share and cha
│ │ │ │ │ +00010400: 6e67 6520 6672 6565 2073 6f66 7477 6172  nge free softwar
│ │ │ │ │ +00010410: 652d 2d74 6f0a 6d61 6b65 2073 7572 6520  e--to.make sure 
│ │ │ │ │ +00010420: 7468 6520 736f 6674 7761 7265 2069 7320  the software is 
│ │ │ │ │ +00010430: 6672 6565 2066 6f72 2061 6c6c 2069 7473  free for all its
│ │ │ │ │ +00010440: 2075 7365 7273 2e20 2054 6869 7320 4765   users.  This Ge
│ │ │ │ │ +00010450: 6e65 7261 6c20 5075 626c 6963 0a4c 6963  neral Public.Lic
│ │ │ │ │ +00010460: 656e 7365 2061 7070 6c69 6573 2074 6f20  ense applies to 
│ │ │ │ │ +00010470: 6d6f 7374 206f 6620 7468 6520 4672 6565  most of the Free
│ │ │ │ │ +00010480: 2053 6f66 7477 6172 6520 466f 756e 6461   Software Founda
│ │ │ │ │ +00010490: 7469 6f6e 2773 2073 6f66 7477 6172 6520  tion's software 
│ │ │ │ │ +000104a0: 616e 640a 746f 2061 6e79 206f 7468 6572  and.to any other
│ │ │ │ │ +000104b0: 2070 726f 6772 616d 2077 686f 7365 2061   program whose a
│ │ │ │ │ +000104c0: 7574 686f 7273 2063 6f6d 6d69 7420 746f  uthors commit to
│ │ │ │ │ +000104d0: 2075 7369 6e67 2069 742e 2020 2853 6f6d   using it.  (Som
│ │ │ │ │ +000104e0: 6520 6f74 6865 7220 4672 6565 0a53 6f66  e other Free.Sof
│ │ │ │ │ +000104f0: 7477 6172 6520 466f 756e 6461 7469 6f6e  tware Foundation
│ │ │ │ │ +00010500: 2073 6f66 7477 6172 6520 6973 2063 6f76   software is cov
│ │ │ │ │ +00010510: 6572 6564 2062 7920 7468 6520 474e 5520  ered by the GNU 
│ │ │ │ │ +00010520: 4c65 7373 6572 2047 656e 6572 616c 2050  Lesser General P
│ │ │ │ │ +00010530: 7562 6c69 630a 4c69 6365 6e73 6520 696e  ublic.License in
│ │ │ │ │ +00010540: 7374 6561 642e 2920 2059 6f75 2063 616e  stead.)  You can
│ │ │ │ │ +00010550: 2061 7070 6c79 2069 7420 746f 2079 6f75   apply it to you
│ │ │ │ │ +00010560: 7220 7072 6f67 7261 6d73 2c20 746f 6f2e  r programs, too.
│ │ │ │ │ +00010570: 0a0a 2020 2057 6865 6e20 7765 2073 7065  ..   When we spe
│ │ │ │ │ +00010580: 616b 206f 6620 6672 6565 2073 6f66 7477  ak of free softw
│ │ │ │ │ +00010590: 6172 652c 2077 6520 6172 6520 7265 6665  are, we are refe
│ │ │ │ │ +000105a0: 7272 696e 6720 746f 2066 7265 6564 6f6d  rring to freedom
│ │ │ │ │ +000105b0: 2c20 6e6f 740a 7072 6963 652e 2020 4f75  , not.price.  Ou
│ │ │ │ │ +000105c0: 7220 4765 6e65 7261 6c20 5075 626c 6963  r General Public
│ │ │ │ │ +000105d0: 204c 6963 656e 7365 7320 6172 6520 6465   Licenses are de
│ │ │ │ │ +000105e0: 7369 676e 6564 2074 6f20 6d61 6b65 2073  signed to make s
│ │ │ │ │ +000105f0: 7572 6520 7468 6174 2079 6f75 0a68 6176  ure that you.hav
│ │ │ │ │ +00010600: 6520 7468 6520 6672 6565 646f 6d20 746f  e the freedom to
│ │ │ │ │ +00010610: 2064 6973 7472 6962 7574 6520 636f 7069   distribute copi
│ │ │ │ │ +00010620: 6573 206f 6620 6672 6565 2073 6f66 7477  es of free softw
│ │ │ │ │ +00010630: 6172 6520 2861 6e64 2063 6861 7267 6520  are (and charge 
│ │ │ │ │ +00010640: 666f 720a 7468 6973 2073 6572 7669 6365  for.this service
│ │ │ │ │ +00010650: 2069 6620 796f 7520 7769 7368 292c 2074   if you wish), t
│ │ │ │ │ +00010660: 6861 7420 796f 7520 7265 6365 6976 6520  hat you receive 
│ │ │ │ │ +00010670: 736f 7572 6365 2063 6f64 6520 6f72 2063  source code or c
│ │ │ │ │ +00010680: 616e 2067 6574 2069 7420 6966 0a79 6f75  an get it if.you
│ │ │ │ │ +00010690: 2077 616e 7420 6974 2c20 7468 6174 2079   want it, that y
│ │ │ │ │ +000106a0: 6f75 2063 616e 2063 6861 6e67 6520 7468  ou can change th
│ │ │ │ │ +000106b0: 6520 736f 6674 7761 7265 206f 7220 7573  e software or us
│ │ │ │ │ +000106c0: 6520 7069 6563 6573 206f 6620 6974 2069  e pieces of it i
│ │ │ │ │ +000106d0: 6e20 6e65 770a 6672 6565 2070 726f 6772  n new.free progr
│ │ │ │ │ +000106e0: 616d 733b 2061 6e64 2074 6861 7420 796f  ams; and that yo
│ │ │ │ │ +000106f0: 7520 6b6e 6f77 2079 6f75 2063 616e 2064  u know you can d
│ │ │ │ │ +00010700: 6f20 7468 6573 6520 7468 696e 6773 2e0a  o these things..
│ │ │ │ │ +00010710: 0a20 2020 546f 2070 726f 7465 6374 2079  .   To protect y
│ │ │ │ │ +00010720: 6f75 7220 7269 6768 7473 2c20 7765 206e  our rights, we n
│ │ │ │ │ +00010730: 6565 6420 746f 206d 616b 6520 7265 7374  eed to make rest
│ │ │ │ │ +00010740: 7269 6374 696f 6e73 2074 6861 7420 666f  rictions that fo
│ │ │ │ │ +00010750: 7262 6964 0a61 6e79 6f6e 6520 746f 2064  rbid.anyone to d
│ │ │ │ │ +00010760: 656e 7920 796f 7520 7468 6573 6520 7269  eny you these ri
│ │ │ │ │ +00010770: 6768 7473 206f 7220 746f 2061 736b 2079  ghts or to ask y
│ │ │ │ │ +00010780: 6f75 2074 6f20 7375 7272 656e 6465 7220  ou to surrender 
│ │ │ │ │ +00010790: 7468 6520 7269 6768 7473 2e0a 5468 6573  the rights..Thes
│ │ │ │ │ +000107a0: 6520 7265 7374 7269 6374 696f 6e73 2074  e restrictions t
│ │ │ │ │ +000107b0: 7261 6e73 6c61 7465 2074 6f20 6365 7274  ranslate to cert
│ │ │ │ │ +000107c0: 6169 6e20 7265 7370 6f6e 7369 6269 6c69  ain responsibili
│ │ │ │ │ +000107d0: 7469 6573 2066 6f72 2079 6f75 2069 6620  ties for you if 
│ │ │ │ │ +000107e0: 796f 750a 6469 7374 7269 6275 7465 2063  you.distribute c
│ │ │ │ │ +000107f0: 6f70 6965 7320 6f66 2074 6865 2073 6f66  opies of the sof
│ │ │ │ │ +00010800: 7477 6172 652c 206f 7220 6966 2079 6f75  tware, or if you
│ │ │ │ │ +00010810: 206d 6f64 6966 7920 6974 2e0a 0a20 2020   modify it...   
│ │ │ │ │ +00010820: 466f 7220 6578 616d 706c 652c 2069 6620  For example, if 
│ │ │ │ │ +00010830: 796f 7520 6469 7374 7269 6275 7465 2063  you distribute c
│ │ │ │ │ +00010840: 6f70 6965 7320 6f66 2073 7563 6820 6120  opies of such a 
│ │ │ │ │ +00010850: 7072 6f67 7261 6d2c 2077 6865 7468 6572  program, whether
│ │ │ │ │ +00010860: 0a67 7261 7469 7320 6f72 2066 6f72 2061  .gratis or for a
│ │ │ │ │ +00010870: 2066 6565 2c20 796f 7520 6d75 7374 2067   fee, you must g
│ │ │ │ │ +00010880: 6976 6520 7468 6520 7265 6369 7069 656e  ive the recipien
│ │ │ │ │ +00010890: 7473 2061 6c6c 2074 6865 2072 6967 6874  ts all the right
│ │ │ │ │ +000108a0: 7320 7468 6174 0a79 6f75 2068 6176 652e  s that.you have.
│ │ │ │ │ +000108b0: 2020 596f 7520 6d75 7374 206d 616b 6520    You must make 
│ │ │ │ │ +000108c0: 7375 7265 2074 6861 7420 7468 6579 2c20  sure that they, 
│ │ │ │ │ +000108d0: 746f 6f2c 2072 6563 6569 7665 206f 7220  too, receive or 
│ │ │ │ │ +000108e0: 6361 6e20 6765 7420 7468 650a 736f 7572  can get the.sour
│ │ │ │ │ +000108f0: 6365 2063 6f64 652e 2020 416e 6420 796f  ce code.  And yo
│ │ │ │ │ +00010900: 7520 6d75 7374 2073 686f 7720 7468 656d  u must show them
│ │ │ │ │ +00010910: 2074 6865 7365 2074 6572 6d73 2073 6f20   these terms so 
│ │ │ │ │ +00010920: 7468 6579 206b 6e6f 7720 7468 6569 720a  they know their.
│ │ │ │ │ +00010930: 7269 6768 7473 2e0a 0a20 2020 5765 2070  rights...   We p
│ │ │ │ │ +00010940: 726f 7465 6374 2079 6f75 7220 7269 6768  rotect your righ
│ │ │ │ │ +00010950: 7473 2077 6974 6820 7477 6f20 7374 6570  ts with two step
│ │ │ │ │ +00010960: 733a 2028 3129 2063 6f70 7972 6967 6874  s: (1) copyright
│ │ │ │ │ +00010970: 2074 6865 2073 6f66 7477 6172 652c 0a61   the software,.a
│ │ │ │ │ +00010980: 6e64 2028 3229 206f 6666 6572 2079 6f75  nd (2) offer you
│ │ │ │ │ +00010990: 2074 6869 7320 6c69 6365 6e73 6520 7768   this license wh
│ │ │ │ │ +000109a0: 6963 6820 6769 7665 7320 796f 7520 6c65  ich gives you le
│ │ │ │ │ +000109b0: 6761 6c20 7065 726d 6973 7369 6f6e 2074  gal permission t
│ │ │ │ │ +000109c0: 6f20 636f 7079 2c0a 6469 7374 7269 6275  o copy,.distribu
│ │ │ │ │ +000109d0: 7465 2061 6e64 2f6f 7220 6d6f 6469 6679  te and/or modify
│ │ │ │ │ +000109e0: 2074 6865 2073 6f66 7477 6172 652e 0a0a   the software...
│ │ │ │ │ +000109f0: 2020 2041 6c73 6f2c 2066 6f72 2065 6163     Also, for eac
│ │ │ │ │ +00010a00: 6820 6175 7468 6f72 2773 2070 726f 7465  h author's prote
│ │ │ │ │ +00010a10: 6374 696f 6e20 616e 6420 6f75 7273 2c20  ction and ours, 
│ │ │ │ │ +00010a20: 7765 2077 616e 7420 746f 206d 616b 6520  we want to make 
│ │ │ │ │ +00010a30: 6365 7274 6169 6e0a 7468 6174 2065 7665  certain.that eve
│ │ │ │ │ +00010a40: 7279 6f6e 6520 756e 6465 7273 7461 6e64  ryone understand
│ │ │ │ │ +00010a50: 7320 7468 6174 2074 6865 7265 2069 7320  s that there is 
│ │ │ │ │ +00010a60: 6e6f 2077 6172 7261 6e74 7920 666f 7220  no warranty for 
│ │ │ │ │ +00010a70: 7468 6973 2066 7265 650a 736f 6674 7761  this free.softwa
│ │ │ │ │ +00010a80: 7265 2e20 2049 6620 7468 6520 736f 6674  re.  If the soft
│ │ │ │ │ +00010a90: 7761 7265 2069 7320 6d6f 6469 6669 6564  ware is modified
│ │ │ │ │ +00010aa0: 2062 7920 736f 6d65 6f6e 6520 656c 7365   by someone else
│ │ │ │ │ +00010ab0: 2061 6e64 2070 6173 7365 6420 6f6e 2c20   and passed on, 
│ │ │ │ │ +00010ac0: 7765 0a77 616e 7420 6974 7320 7265 6369  we.want its reci
│ │ │ │ │ +00010ad0: 7069 656e 7473 2074 6f20 6b6e 6f77 2074  pients to know t
│ │ │ │ │ +00010ae0: 6861 7420 7768 6174 2074 6865 7920 6861  hat what they ha
│ │ │ │ │ +00010af0: 7665 2069 7320 6e6f 7420 7468 6520 6f72  ve is not the or
│ │ │ │ │ +00010b00: 6967 696e 616c 2c20 736f 0a74 6861 7420  iginal, so.that 
│ │ │ │ │ +00010b10: 616e 7920 7072 6f62 6c65 6d73 2069 6e74  any problems int
│ │ │ │ │ +00010b20: 726f 6475 6365 6420 6279 206f 7468 6572  roduced by other
│ │ │ │ │ +00010b30: 7320 7769 6c6c 206e 6f74 2072 6566 6c65  s will not refle
│ │ │ │ │ +00010b40: 6374 206f 6e20 7468 6520 6f72 6967 696e  ct on the origin
│ │ │ │ │ +00010b50: 616c 0a61 7574 686f 7273 2720 7265 7075  al.authors' repu
│ │ │ │ │ +00010b60: 7461 7469 6f6e 732e 0a0a 2020 2046 696e  tations...   Fin
│ │ │ │ │ +00010b70: 616c 6c79 2c20 616e 7920 6672 6565 2070  ally, any free p
│ │ │ │ │ +00010b80: 726f 6772 616d 2069 7320 7468 7265 6174  rogram is threat
│ │ │ │ │ +00010b90: 656e 6564 2063 6f6e 7374 616e 746c 7920  ened constantly 
│ │ │ │ │ +00010ba0: 6279 2073 6f66 7477 6172 650a 7061 7465  by software.pate
│ │ │ │ │ +00010bb0: 6e74 732e 2020 5765 2077 6973 6820 746f  nts.  We wish to
│ │ │ │ │ +00010bc0: 2061 766f 6964 2074 6865 2064 616e 6765   avoid the dange
│ │ │ │ │ +00010bd0: 7220 7468 6174 2072 6564 6973 7472 6962  r that redistrib
│ │ │ │ │ +00010be0: 7574 6f72 7320 6f66 2061 2066 7265 650a  utors of a free.
│ │ │ │ │ +00010bf0: 7072 6f67 7261 6d20 7769 6c6c 2069 6e64  program will ind
│ │ │ │ │ +00010c00: 6976 6964 7561 6c6c 7920 6f62 7461 696e  ividually obtain
│ │ │ │ │ +00010c10: 2070 6174 656e 7420 6c69 6365 6e73 6573   patent licenses
│ │ │ │ │ +00010c20: 2c20 696e 2065 6666 6563 7420 6d61 6b69  , in effect maki
│ │ │ │ │ +00010c30: 6e67 2074 6865 0a70 726f 6772 616d 2070  ng the.program p
│ │ │ │ │ +00010c40: 726f 7072 6965 7461 7279 2e20 2054 6f20  roprietary.  To 
│ │ │ │ │ +00010c50: 7072 6576 656e 7420 7468 6973 2c20 7765  prevent this, we
│ │ │ │ │ +00010c60: 2068 6176 6520 6d61 6465 2069 7420 636c   have made it cl
│ │ │ │ │ +00010c70: 6561 7220 7468 6174 2061 6e79 0a70 6174  ear that any.pat
│ │ │ │ │ +00010c80: 656e 7420 6d75 7374 2062 6520 6c69 6365  ent must be lice
│ │ │ │ │ +00010c90: 6e73 6564 2066 6f72 2065 7665 7279 6f6e  nsed for everyon
│ │ │ │ │ +00010ca0: 6527 7320 6672 6565 2075 7365 206f 7220  e's free use or 
│ │ │ │ │ +00010cb0: 6e6f 7420 6c69 6365 6e73 6564 2061 7420  not licensed at 
│ │ │ │ │ +00010cc0: 616c 6c2e 0a0a 2020 2054 6865 2070 7265  all...   The pre
│ │ │ │ │ +00010cd0: 6369 7365 2074 6572 6d73 2061 6e64 2063  cise terms and c
│ │ │ │ │ +00010ce0: 6f6e 6469 7469 6f6e 7320 666f 7220 636f  onditions for co
│ │ │ │ │ +00010cf0: 7079 696e 672c 2064 6973 7472 6962 7574  pying, distribut
│ │ │ │ │ +00010d00: 696f 6e20 616e 640a 6d6f 6469 6669 6361  ion and.modifica
│ │ │ │ │ +00010d10: 7469 6f6e 2066 6f6c 6c6f 772e 0a0a 2020  tion follow...  
│ │ │ │ │  00010d20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00010d30: 2020 2020 474e 5520 4745 4e45 5241 4c20      GNU GENERAL 
│ │ │ │ │ -00010d40: 5055 424c 4943 204c 4943 454e 5345 2076  PUBLIC LICENSE v
│ │ │ │ │ -00010d50: 322b 0a20 2020 2054 4552 4d53 2041 4e44  2+.    TERMS AND
│ │ │ │ │ -00010d60: 2043 4f4e 4449 5449 4f4e 5320 464f 5220   CONDITIONS FOR 
│ │ │ │ │ -00010d70: 434f 5059 494e 472c 2044 4953 5452 4942  COPYING, DISTRIB
│ │ │ │ │ -00010d80: 5554 494f 4e20 414e 4420 4d4f 4449 4649  UTION AND MODIFI
│ │ │ │ │ -00010d90: 4341 5449 4f4e 0a0a 2020 302e 2054 6869  CATION..  0. Thi
│ │ │ │ │ -00010da0: 7320 4c69 6365 6e73 6520 6170 706c 6965  s License applie
│ │ │ │ │ -00010db0: 7320 746f 2061 6e79 2070 726f 6772 616d  s to any program
│ │ │ │ │ -00010dc0: 206f 7220 6f74 6865 7220 776f 726b 2077   or other work w
│ │ │ │ │ -00010dd0: 6869 6368 2063 6f6e 7461 696e 7320 610a  hich contains a.
│ │ │ │ │ -00010de0: 2020 2020 206e 6f74 6963 6520 706c 6163       notice plac
│ │ │ │ │ -00010df0: 6564 2062 7920 7468 6520 636f 7079 7269  ed by the copyri
│ │ │ │ │ -00010e00: 6768 7420 686f 6c64 6572 2073 6179 696e  ght holder sayin
│ │ │ │ │ -00010e10: 6720 6974 206d 6179 2062 6520 6469 7374  g it may be dist
│ │ │ │ │ -00010e20: 7269 6275 7465 640a 2020 2020 2075 6e64  ributed.     und
│ │ │ │ │ -00010e30: 6572 2074 6865 2074 6572 6d73 206f 6620  er the terms of 
│ │ │ │ │ -00010e40: 7468 6973 2047 656e 6572 616c 2050 7562  this General Pub
│ │ │ │ │ -00010e50: 6c69 6320 4c69 6365 6e73 652e 2020 5468  lic License.  Th
│ │ │ │ │ -00010e60: 6520 2250 726f 6772 616d 222c 0a20 2020  e "Program",.   
│ │ │ │ │ -00010e70: 2020 6265 6c6f 772c 2072 6566 6572 7320    below, refers 
│ │ │ │ │ -00010e80: 746f 2061 6e79 2073 7563 6820 7072 6f67  to any such prog
│ │ │ │ │ -00010e90: 7261 6d20 6f72 2077 6f72 6b2c 2061 6e64  ram or work, and
│ │ │ │ │ -00010ea0: 2061 2022 776f 726b 2062 6173 6564 206f   a "work based o
│ │ │ │ │ -00010eb0: 6e20 7468 650a 2020 2020 2050 726f 6772  n the.     Progr
│ │ │ │ │ -00010ec0: 616d 2220 6d65 616e 7320 6569 7468 6572  am" means either
│ │ │ │ │ -00010ed0: 2074 6865 2050 726f 6772 616d 206f 7220   the Program or 
│ │ │ │ │ -00010ee0: 616e 7920 6465 7269 7661 7469 7665 2077  any derivative w
│ │ │ │ │ -00010ef0: 6f72 6b20 756e 6465 720a 2020 2020 2063  ork under.     c
│ │ │ │ │ -00010f00: 6f70 7972 6967 6874 206c 6177 3a20 7468  opyright law: th
│ │ │ │ │ -00010f10: 6174 2069 7320 746f 2073 6179 2c20 6120  at is to say, a 
│ │ │ │ │ -00010f20: 776f 726b 2063 6f6e 7461 696e 696e 6720  work containing 
│ │ │ │ │ -00010f30: 7468 6520 5072 6f67 7261 6d20 6f72 2061  the Program or a
│ │ │ │ │ -00010f40: 0a20 2020 2020 706f 7274 696f 6e20 6f66  .     portion of
│ │ │ │ │ -00010f50: 2069 742c 2065 6974 6865 7220 7665 7262   it, either verb
│ │ │ │ │ -00010f60: 6174 696d 206f 7220 7769 7468 206d 6f64  atim or with mod
│ │ │ │ │ -00010f70: 6966 6963 6174 696f 6e73 2061 6e64 2f6f  ifications and/o
│ │ │ │ │ -00010f80: 720a 2020 2020 2074 7261 6e73 6c61 7465  r.     translate
│ │ │ │ │ -00010f90: 6420 696e 746f 2061 6e6f 7468 6572 206c  d into another l
│ │ │ │ │ -00010fa0: 616e 6775 6167 652e 2020 2848 6572 6569  anguage.  (Herei
│ │ │ │ │ -00010fb0: 6e61 6674 6572 2c20 7472 616e 736c 6174  nafter, translat
│ │ │ │ │ -00010fc0: 696f 6e20 6973 0a20 2020 2020 696e 636c  ion is.     incl
│ │ │ │ │ -00010fd0: 7564 6564 2077 6974 686f 7574 206c 696d  uded without lim
│ │ │ │ │ -00010fe0: 6974 6174 696f 6e20 696e 2074 6865 2074  itation in the t
│ │ │ │ │ -00010ff0: 6572 6d20 226d 6f64 6966 6963 6174 696f  erm "modificatio
│ │ │ │ │ -00011000: 6e22 2e29 2020 4561 6368 0a20 2020 2020  n".)  Each.     
│ │ │ │ │ -00011010: 6c69 6365 6e73 6565 2069 7320 6164 6472  licensee is addr
│ │ │ │ │ -00011020: 6573 7365 6420 6173 2022 796f 7522 2e0a  essed as "you"..
│ │ │ │ │ -00011030: 0a20 2020 2020 4163 7469 7669 7469 6573  .     Activities
│ │ │ │ │ -00011040: 206f 7468 6572 2074 6861 6e20 636f 7079   other than copy
│ │ │ │ │ -00011050: 696e 672c 2064 6973 7472 6962 7574 696f  ing, distributio
│ │ │ │ │ -00011060: 6e20 616e 6420 6d6f 6469 6669 6361 7469  n and modificati
│ │ │ │ │ -00011070: 6f6e 2061 7265 0a20 2020 2020 6e6f 7420  on are.     not 
│ │ │ │ │ -00011080: 636f 7665 7265 6420 6279 2074 6869 7320  covered by this 
│ │ │ │ │ -00011090: 4c69 6365 6e73 653b 2074 6865 7920 6172  License; they ar
│ │ │ │ │ -000110a0: 6520 6f75 7473 6964 6520 6974 7320 7363  e outside its sc
│ │ │ │ │ -000110b0: 6f70 652e 2020 5468 6520 6163 740a 2020  ope.  The act.  
│ │ │ │ │ -000110c0: 2020 206f 6620 7275 6e6e 696e 6720 7468     of running th
│ │ │ │ │ -000110d0: 6520 5072 6f67 7261 6d20 6973 206e 6f74  e Program is not
│ │ │ │ │ -000110e0: 2072 6573 7472 6963 7465 642c 2061 6e64   restricted, and
│ │ │ │ │ -000110f0: 2074 6865 206f 7574 7075 7420 6672 6f6d   the output from
│ │ │ │ │ -00011100: 2074 6865 0a20 2020 2020 5072 6f67 7261   the.     Progra
│ │ │ │ │ -00011110: 6d20 6973 2063 6f76 6572 6564 206f 6e6c  m is covered onl
│ │ │ │ │ -00011120: 7920 6966 2069 7473 2063 6f6e 7465 6e74  y if its content
│ │ │ │ │ -00011130: 7320 636f 6e73 7469 7475 7465 2061 2077  s constitute a w
│ │ │ │ │ -00011140: 6f72 6b20 6261 7365 6420 6f6e 0a20 2020  ork based on.   
│ │ │ │ │ -00011150: 2020 7468 6520 5072 6f67 7261 6d20 2869    the Program (i
│ │ │ │ │ -00011160: 6e64 6570 656e 6465 6e74 206f 6620 6861  ndependent of ha
│ │ │ │ │ -00011170: 7669 6e67 2062 6565 6e20 6d61 6465 2062  ving been made b
│ │ │ │ │ -00011180: 7920 7275 6e6e 696e 6720 7468 650a 2020  y running the.  
│ │ │ │ │ -00011190: 2020 2050 726f 6772 616d 292e 2020 5768     Program).  Wh
│ │ │ │ │ -000111a0: 6574 6865 7220 7468 6174 2069 7320 7472  ether that is tr
│ │ │ │ │ -000111b0: 7565 2064 6570 656e 6473 206f 6e20 7768  ue depends on wh
│ │ │ │ │ -000111c0: 6174 2074 6865 2050 726f 6772 616d 2064  at the Program d
│ │ │ │ │ -000111d0: 6f65 732e 0a0a 2020 312e 2059 6f75 206d  oes...  1. You m
│ │ │ │ │ -000111e0: 6179 2063 6f70 7920 616e 6420 6469 7374  ay copy and dist
│ │ │ │ │ -000111f0: 7269 6275 7465 2076 6572 6261 7469 6d20  ribute verbatim 
│ │ │ │ │ -00011200: 636f 7069 6573 206f 6620 7468 6520 5072  copies of the Pr
│ │ │ │ │ -00011210: 6f67 7261 6d27 7320 736f 7572 6365 0a20  ogram's source. 
│ │ │ │ │ -00011220: 2020 2020 636f 6465 2061 7320 796f 7520      code as you 
│ │ │ │ │ -00011230: 7265 6365 6976 6520 6974 2c20 696e 2061  receive it, in a
│ │ │ │ │ -00011240: 6e79 206d 6564 6975 6d2c 2070 726f 7669  ny medium, provi
│ │ │ │ │ -00011250: 6465 6420 7468 6174 2079 6f75 0a20 2020  ded that you.   
│ │ │ │ │ -00011260: 2020 636f 6e73 7069 6375 6f75 736c 7920    conspicuously 
│ │ │ │ │ -00011270: 616e 6420 6170 7072 6f70 7269 6174 656c  and appropriatel
│ │ │ │ │ -00011280: 7920 7075 626c 6973 6820 6f6e 2065 6163  y publish on eac
│ │ │ │ │ -00011290: 6820 636f 7079 2061 6e20 6170 7072 6f70  h copy an approp
│ │ │ │ │ -000112a0: 7269 6174 650a 2020 2020 2063 6f70 7972  riate.     copyr
│ │ │ │ │ -000112b0: 6967 6874 206e 6f74 6963 6520 616e 6420  ight notice and 
│ │ │ │ │ -000112c0: 6469 7363 6c61 696d 6572 206f 6620 7761  disclaimer of wa
│ │ │ │ │ -000112d0: 7272 616e 7479 3b20 6b65 6570 2069 6e74  rranty; keep int
│ │ │ │ │ -000112e0: 6163 7420 616c 6c20 7468 650a 2020 2020  act all the.    
│ │ │ │ │ -000112f0: 206e 6f74 6963 6573 2074 6861 7420 7265   notices that re
│ │ │ │ │ -00011300: 6665 7220 746f 2074 6869 7320 4c69 6365  fer to this Lice
│ │ │ │ │ -00011310: 6e73 6520 616e 6420 746f 2074 6865 2061  nse and to the a
│ │ │ │ │ -00011320: 6273 656e 6365 206f 6620 616e 790a 2020  bsence of any.  
│ │ │ │ │ -00011330: 2020 2077 6172 7261 6e74 793b 2061 6e64     warranty; and
│ │ │ │ │ -00011340: 2067 6976 6520 616e 7920 6f74 6865 7220   give any other 
│ │ │ │ │ -00011350: 7265 6369 7069 656e 7473 206f 6620 7468  recipients of th
│ │ │ │ │ -00011360: 6520 5072 6f67 7261 6d20 6120 636f 7079  e Program a copy
│ │ │ │ │ -00011370: 206f 660a 2020 2020 2074 6869 7320 4c69   of.     this Li
│ │ │ │ │ -00011380: 6365 6e73 6520 616c 6f6e 6720 7769 7468  cense along with
│ │ │ │ │ -00011390: 2074 6865 2050 726f 6772 616d 2e0a 0a20   the Program... 
│ │ │ │ │ -000113a0: 2020 2020 596f 7520 6d61 7920 6368 6172      You may char
│ │ │ │ │ -000113b0: 6765 2061 2066 6565 2066 6f72 2074 6865  ge a fee for the
│ │ │ │ │ -000113c0: 2070 6879 7369 6361 6c20 6163 7420 6f66   physical act of
│ │ │ │ │ -000113d0: 2074 7261 6e73 6665 7272 696e 6720 6120   transferring a 
│ │ │ │ │ -000113e0: 636f 7079 2c0a 2020 2020 2061 6e64 2079  copy,.     and y
│ │ │ │ │ -000113f0: 6f75 206d 6179 2061 7420 796f 7572 206f  ou may at your o
│ │ │ │ │ -00011400: 7074 696f 6e20 6f66 6665 7220 7761 7272  ption offer warr
│ │ │ │ │ -00011410: 616e 7479 2070 726f 7465 6374 696f 6e20  anty protection 
│ │ │ │ │ -00011420: 696e 2065 7863 6861 6e67 650a 2020 2020  in exchange.    
│ │ │ │ │ -00011430: 2066 6f72 2061 2066 6565 2e0a 0a20 2032   for a fee...  2
│ │ │ │ │ -00011440: 2e20 596f 7520 6d61 7920 6d6f 6469 6679  . You may modify
│ │ │ │ │ -00011450: 2079 6f75 7220 636f 7079 206f 7220 636f   your copy or co
│ │ │ │ │ -00011460: 7069 6573 206f 6620 7468 6520 5072 6f67  pies of the Prog
│ │ │ │ │ -00011470: 7261 6d20 6f72 2061 6e79 2070 6f72 7469  ram or any porti
│ │ │ │ │ -00011480: 6f6e 206f 660a 2020 2020 2069 742c 2074  on of.     it, t
│ │ │ │ │ -00011490: 6875 7320 666f 726d 696e 6720 6120 776f  hus forming a wo
│ │ │ │ │ -000114a0: 726b 2062 6173 6564 206f 6e20 7468 6520  rk based on the 
│ │ │ │ │ -000114b0: 5072 6f67 7261 6d2c 2061 6e64 2063 6f70  Program, and cop
│ │ │ │ │ -000114c0: 7920 616e 640a 2020 2020 2064 6973 7472  y and.     distr
│ │ │ │ │ -000114d0: 6962 7574 6520 7375 6368 206d 6f64 6966  ibute such modif
│ │ │ │ │ -000114e0: 6963 6174 696f 6e73 206f 7220 776f 726b  ications or work
│ │ │ │ │ -000114f0: 2075 6e64 6572 2074 6865 2074 6572 6d73   under the terms
│ │ │ │ │ -00011500: 206f 6620 5365 6374 696f 6e20 310a 2020   of Section 1.  
│ │ │ │ │ -00011510: 2020 2061 626f 7665 2c20 7072 6f76 6964     above, provid
│ │ │ │ │ -00011520: 6564 2074 6861 7420 796f 7520 616c 736f  ed that you also
│ │ │ │ │ -00011530: 206d 6565 7420 616c 6c20 6f66 2074 6865   meet all of the
│ │ │ │ │ -00011540: 7365 2063 6f6e 6469 7469 6f6e 733a 0a0a  se conditions:..
│ │ │ │ │ -00011550: 2020 2020 2020 2061 2e20 596f 7520 6d75         a. You mu
│ │ │ │ │ -00011560: 7374 2063 6175 7365 2074 6865 206d 6f64  st cause the mod
│ │ │ │ │ -00011570: 6966 6965 6420 6669 6c65 7320 746f 2063  ified files to c
│ │ │ │ │ -00011580: 6172 7279 2070 726f 6d69 6e65 6e74 206e  arry prominent n
│ │ │ │ │ -00011590: 6f74 6963 6573 0a20 2020 2020 2020 2020  otices.         
│ │ │ │ │ -000115a0: 2073 7461 7469 6e67 2074 6861 7420 796f   stating that yo
│ │ │ │ │ -000115b0: 7520 6368 616e 6765 6420 7468 6520 6669  u changed the fi
│ │ │ │ │ -000115c0: 6c65 7320 616e 6420 7468 6520 6461 7465  les and the date
│ │ │ │ │ -000115d0: 206f 6620 616e 7920 6368 616e 6765 2e0a   of any change..
│ │ │ │ │ -000115e0: 0a20 2020 2020 2020 622e 2059 6f75 206d  .       b. You m
│ │ │ │ │ -000115f0: 7573 7420 6361 7573 6520 616e 7920 776f  ust cause any wo
│ │ │ │ │ -00011600: 726b 2074 6861 7420 796f 7520 6469 7374  rk that you dist
│ │ │ │ │ -00011610: 7269 6275 7465 206f 7220 7075 626c 6973  ribute or publis
│ │ │ │ │ -00011620: 682c 2074 6861 740a 2020 2020 2020 2020  h, that.        
│ │ │ │ │ -00011630: 2020 696e 2077 686f 6c65 206f 7220 696e    in whole or in
│ │ │ │ │ -00011640: 2070 6172 7420 636f 6e74 6169 6e73 206f   part contains o
│ │ │ │ │ -00011650: 7220 6973 2064 6572 6976 6564 2066 726f  r is derived fro
│ │ │ │ │ -00011660: 6d20 7468 6520 5072 6f67 7261 6d20 6f72  m the Program or
│ │ │ │ │ -00011670: 0a20 2020 2020 2020 2020 2061 6e79 2070  .          any p
│ │ │ │ │ -00011680: 6172 7420 7468 6572 656f 662c 2074 6f20  art thereof, to 
│ │ │ │ │ -00011690: 6265 206c 6963 656e 7365 6420 6173 2061  be licensed as a
│ │ │ │ │ -000116a0: 2077 686f 6c65 2061 7420 6e6f 2063 6861   whole at no cha
│ │ │ │ │ -000116b0: 7267 6520 746f 0a20 2020 2020 2020 2020  rge to.         
│ │ │ │ │ -000116c0: 2061 6c6c 2074 6869 7264 2070 6172 7469   all third parti
│ │ │ │ │ -000116d0: 6573 2075 6e64 6572 2074 6865 2074 6572  es under the ter
│ │ │ │ │ -000116e0: 6d73 206f 6620 7468 6973 204c 6963 656e  ms of this Licen
│ │ │ │ │ -000116f0: 7365 2e0a 0a20 2020 2020 2020 632e 2049  se...       c. I
│ │ │ │ │ -00011700: 6620 7468 6520 6d6f 6469 6669 6564 2070  f the modified p
│ │ │ │ │ -00011710: 726f 6772 616d 206e 6f72 6d61 6c6c 7920  rogram normally 
│ │ │ │ │ -00011720: 7265 6164 7320 636f 6d6d 616e 6473 2069  reads commands i
│ │ │ │ │ -00011730: 6e74 6572 6163 7469 7665 6c79 0a20 2020  nteractively.   
│ │ │ │ │ -00011740: 2020 2020 2020 2077 6865 6e20 7275 6e2c         when run,
│ │ │ │ │ -00011750: 2079 6f75 206d 7573 7420 6361 7573 6520   you must cause 
│ │ │ │ │ -00011760: 6974 2c20 7768 656e 2073 7461 7274 6564  it, when started
│ │ │ │ │ -00011770: 2072 756e 6e69 6e67 2066 6f72 2073 7563   running for suc
│ │ │ │ │ -00011780: 680a 2020 2020 2020 2020 2020 696e 7465  h.          inte
│ │ │ │ │ -00011790: 7261 6374 6976 6520 7573 6520 696e 2074  ractive use in t
│ │ │ │ │ -000117a0: 6865 206d 6f73 7420 6f72 6469 6e61 7279  he most ordinary
│ │ │ │ │ -000117b0: 2077 6179 2c20 746f 2070 7269 6e74 206f   way, to print o
│ │ │ │ │ -000117c0: 7220 6469 7370 6c61 790a 2020 2020 2020  r display.      
│ │ │ │ │ -000117d0: 2020 2020 616e 2061 6e6e 6f75 6e63 656d      an announcem
│ │ │ │ │ -000117e0: 656e 7420 696e 636c 7564 696e 6720 616e  ent including an
│ │ │ │ │ -000117f0: 2061 7070 726f 7072 6961 7465 2063 6f70   appropriate cop
│ │ │ │ │ -00011800: 7972 6967 6874 206e 6f74 6963 6520 616e  yright notice an
│ │ │ │ │ -00011810: 640a 2020 2020 2020 2020 2020 6120 6e6f  d.          a no
│ │ │ │ │ -00011820: 7469 6365 2074 6861 7420 7468 6572 6520  tice that there 
│ │ │ │ │ -00011830: 6973 206e 6f20 7761 7272 616e 7479 2028  is no warranty (
│ │ │ │ │ -00011840: 6f72 2065 6c73 652c 2073 6179 696e 6720  or else, saying 
│ │ │ │ │ -00011850: 7468 6174 2079 6f75 0a20 2020 2020 2020  that you.       
│ │ │ │ │ -00011860: 2020 2070 726f 7669 6465 2061 2077 6172     provide a war
│ │ │ │ │ -00011870: 7261 6e74 7929 2061 6e64 2074 6861 7420  ranty) and that 
│ │ │ │ │ -00011880: 7573 6572 7320 6d61 7920 7265 6469 7374  users may redist
│ │ │ │ │ -00011890: 7269 6275 7465 2074 6865 0a20 2020 2020  ribute the.     
│ │ │ │ │ -000118a0: 2020 2020 2070 726f 6772 616d 2075 6e64       program und
│ │ │ │ │ -000118b0: 6572 2074 6865 7365 2063 6f6e 6469 7469  er these conditi
│ │ │ │ │ -000118c0: 6f6e 732c 2061 6e64 2074 656c 6c69 6e67  ons, and telling
│ │ │ │ │ -000118d0: 2074 6865 2075 7365 7220 686f 7720 746f   the user how to
│ │ │ │ │ -000118e0: 0a20 2020 2020 2020 2020 2076 6965 7720  .          view 
│ │ │ │ │ -000118f0: 6120 636f 7079 206f 6620 7468 6973 204c  a copy of this L
│ │ │ │ │ -00011900: 6963 656e 7365 2e20 2028 4578 6365 7074  icense.  (Except
│ │ │ │ │ -00011910: 696f 6e3a 2069 6620 7468 6520 5072 6f67  ion: if the Prog
│ │ │ │ │ -00011920: 7261 6d0a 2020 2020 2020 2020 2020 6974  ram.          it
│ │ │ │ │ -00011930: 7365 6c66 2069 7320 696e 7465 7261 6374  self is interact
│ │ │ │ │ -00011940: 6976 6520 6275 7420 646f 6573 206e 6f74  ive but does not
│ │ │ │ │ -00011950: 206e 6f72 6d61 6c6c 7920 7072 696e 7420   normally print 
│ │ │ │ │ -00011960: 7375 6368 2061 6e0a 2020 2020 2020 2020  such an.        
│ │ │ │ │ -00011970: 2020 616e 6e6f 756e 6365 6d65 6e74 2c20    announcement, 
│ │ │ │ │ -00011980: 796f 7572 2077 6f72 6b20 6261 7365 6420  your work based 
│ │ │ │ │ -00011990: 6f6e 2074 6865 2050 726f 6772 616d 2069  on the Program i
│ │ │ │ │ -000119a0: 7320 6e6f 7420 7265 7175 6972 6564 0a20  s not required. 
│ │ │ │ │ -000119b0: 2020 2020 2020 2020 2074 6f20 7072 696e           to prin
│ │ │ │ │ -000119c0: 7420 616e 2061 6e6e 6f75 6e63 656d 656e  t an announcemen
│ │ │ │ │ -000119d0: 742e 290a 0a20 2020 2020 5468 6573 6520  t.)..     These 
│ │ │ │ │ -000119e0: 7265 7175 6972 656d 656e 7473 2061 7070  requirements app
│ │ │ │ │ -000119f0: 6c79 2074 6f20 7468 6520 6d6f 6469 6669  ly to the modifi
│ │ │ │ │ -00011a00: 6564 2077 6f72 6b20 6173 2061 2077 686f  ed work as a who
│ │ │ │ │ -00011a10: 6c65 2e20 2049 660a 2020 2020 2069 6465  le.  If.     ide
│ │ │ │ │ -00011a20: 6e74 6966 6961 626c 6520 7365 6374 696f  ntifiable sectio
│ │ │ │ │ -00011a30: 6e73 206f 6620 7468 6174 2077 6f72 6b20  ns of that work 
│ │ │ │ │ -00011a40: 6172 6520 6e6f 7420 6465 7269 7665 6420  are not derived 
│ │ │ │ │ -00011a50: 6672 6f6d 2074 6865 0a20 2020 2020 5072  from the.     Pr
│ │ │ │ │ -00011a60: 6f67 7261 6d2c 2061 6e64 2063 616e 2062  ogram, and can b
│ │ │ │ │ -00011a70: 6520 7265 6173 6f6e 6162 6c79 2063 6f6e  e reasonably con
│ │ │ │ │ -00011a80: 7369 6465 7265 6420 696e 6465 7065 6e64  sidered independ
│ │ │ │ │ -00011a90: 656e 7420 616e 6420 7365 7061 7261 7465  ent and separate
│ │ │ │ │ -00011aa0: 0a20 2020 2020 776f 726b 7320 696e 2074  .     works in t
│ │ │ │ │ -00011ab0: 6865 6d73 656c 7665 732c 2074 6865 6e20  hemselves, then 
│ │ │ │ │ -00011ac0: 7468 6973 204c 6963 656e 7365 2c20 616e  this License, an
│ │ │ │ │ -00011ad0: 6420 6974 7320 7465 726d 732c 2064 6f20  d its terms, do 
│ │ │ │ │ -00011ae0: 6e6f 7420 6170 706c 790a 2020 2020 2074  not apply.     t
│ │ │ │ │ -00011af0: 6f20 7468 6f73 6520 7365 6374 696f 6e73  o those sections
│ │ │ │ │ -00011b00: 2077 6865 6e20 796f 7520 6469 7374 7269   when you distri
│ │ │ │ │ -00011b10: 6275 7465 2074 6865 6d20 6173 2073 6570  bute them as sep
│ │ │ │ │ -00011b20: 6172 6174 6520 776f 726b 732e 2020 4275  arate works.  Bu
│ │ │ │ │ -00011b30: 740a 2020 2020 2077 6865 6e20 796f 7520  t.     when you 
│ │ │ │ │ -00011b40: 6469 7374 7269 6275 7465 2074 6865 2073  distribute the s
│ │ │ │ │ -00011b50: 616d 6520 7365 6374 696f 6e73 2061 7320  ame sections as 
│ │ │ │ │ -00011b60: 7061 7274 206f 6620 6120 7768 6f6c 6520  part of a whole 
│ │ │ │ │ -00011b70: 7768 6963 6820 6973 2061 0a20 2020 2020  which is a.     
│ │ │ │ │ -00011b80: 776f 726b 2062 6173 6564 206f 6e20 7468  work based on th
│ │ │ │ │ -00011b90: 6520 5072 6f67 7261 6d2c 2074 6865 2064  e Program, the d
│ │ │ │ │ -00011ba0: 6973 7472 6962 7574 696f 6e20 6f66 2074  istribution of t
│ │ │ │ │ -00011bb0: 6865 2077 686f 6c65 206d 7573 7420 6265  he whole must be
│ │ │ │ │ -00011bc0: 206f 6e0a 2020 2020 2074 6865 2074 6572   on.     the ter
│ │ │ │ │ -00011bd0: 6d73 206f 6620 7468 6973 204c 6963 656e  ms of this Licen
│ │ │ │ │ -00011be0: 7365 2c20 7768 6f73 6520 7065 726d 6973  se, whose permis
│ │ │ │ │ -00011bf0: 7369 6f6e 7320 666f 7220 6f74 6865 7220  sions for other 
│ │ │ │ │ -00011c00: 6c69 6365 6e73 6565 730a 2020 2020 2065  licensees.     e
│ │ │ │ │ -00011c10: 7874 656e 6420 746f 2074 6865 2065 6e74  xtend to the ent
│ │ │ │ │ -00011c20: 6972 6520 7768 6f6c 652c 2061 6e64 2074  ire whole, and t
│ │ │ │ │ -00011c30: 6875 7320 746f 2065 6163 6820 616e 6420  hus to each and 
│ │ │ │ │ -00011c40: 6576 6572 7920 7061 7274 0a20 2020 2020  every part.     
│ │ │ │ │ -00011c50: 7265 6761 7264 6c65 7373 206f 6620 7768  regardless of wh
│ │ │ │ │ -00011c60: 6f20 7772 6f74 6520 6974 2e0a 0a20 2020  o wrote it...   
│ │ │ │ │ -00011c70: 2020 5468 7573 2c20 6974 2069 7320 6e6f    Thus, it is no
│ │ │ │ │ -00011c80: 7420 7468 6520 696e 7465 6e74 206f 6620  t the intent of 
│ │ │ │ │ -00011c90: 7468 6973 2073 6563 7469 6f6e 2074 6f20  this section to 
│ │ │ │ │ -00011ca0: 636c 6169 6d20 7269 6768 7473 206f 720a  claim rights or.
│ │ │ │ │ -00011cb0: 2020 2020 2063 6f6e 7465 7374 2079 6f75       contest you
│ │ │ │ │ -00011cc0: 7220 7269 6768 7473 2074 6f20 776f 726b  r rights to work
│ │ │ │ │ -00011cd0: 2077 7269 7474 656e 2065 6e74 6972 656c   written entirel
│ │ │ │ │ -00011ce0: 7920 6279 2079 6f75 3b20 7261 7468 6572  y by you; rather
│ │ │ │ │ -00011cf0: 2c20 7468 650a 2020 2020 2069 6e74 656e  , the.     inten
│ │ │ │ │ -00011d00: 7420 6973 2074 6f20 6578 6572 6369 7365  t is to exercise
│ │ │ │ │ -00011d10: 2074 6865 2072 6967 6874 2074 6f20 636f   the right to co
│ │ │ │ │ -00011d20: 6e74 726f 6c20 7468 6520 6469 7374 7269  ntrol the distri
│ │ │ │ │ -00011d30: 6275 7469 6f6e 206f 660a 2020 2020 2064  bution of.     d
│ │ │ │ │ -00011d40: 6572 6976 6174 6976 6520 6f72 2063 6f6c  erivative or col
│ │ │ │ │ -00011d50: 6c65 6374 6976 6520 776f 726b 7320 6261  lective works ba
│ │ │ │ │ -00011d60: 7365 6420 6f6e 2074 6865 2050 726f 6772  sed on the Progr
│ │ │ │ │ -00011d70: 616d 2e0a 0a20 2020 2020 496e 2061 6464  am...     In add
│ │ │ │ │ -00011d80: 6974 696f 6e2c 206d 6572 6520 6167 6772  ition, mere aggr
│ │ │ │ │ -00011d90: 6567 6174 696f 6e20 6f66 2061 6e6f 7468  egation of anoth
│ │ │ │ │ -00011da0: 6572 2077 6f72 6b20 6e6f 7420 6261 7365  er work not base
│ │ │ │ │ -00011db0: 6420 6f6e 2074 6865 0a20 2020 2020 5072  d on the.     Pr
│ │ │ │ │ -00011dc0: 6f67 7261 6d20 7769 7468 2074 6865 2050  ogram with the P
│ │ │ │ │ -00011dd0: 726f 6772 616d 2028 6f72 2077 6974 6820  rogram (or with 
│ │ │ │ │ -00011de0: 6120 776f 726b 2062 6173 6564 206f 6e20  a work based on 
│ │ │ │ │ -00011df0: 7468 6520 5072 6f67 7261 6d29 206f 6e20  the Program) on 
│ │ │ │ │ -00011e00: 610a 2020 2020 2076 6f6c 756d 6520 6f66  a.     volume of
│ │ │ │ │ -00011e10: 2061 2073 746f 7261 6765 206f 7220 6469   a storage or di
│ │ │ │ │ -00011e20: 7374 7269 6275 7469 6f6e 206d 6564 6975  stribution mediu
│ │ │ │ │ -00011e30: 6d20 646f 6573 206e 6f74 2062 7269 6e67  m does not bring
│ │ │ │ │ -00011e40: 2074 6865 206f 7468 6572 0a20 2020 2020   the other.     
│ │ │ │ │ -00011e50: 776f 726b 2075 6e64 6572 2074 6865 2073  work under the s
│ │ │ │ │ -00011e60: 636f 7065 206f 6620 7468 6973 204c 6963  cope of this Lic
│ │ │ │ │ -00011e70: 656e 7365 2e0a 0a20 2033 2e20 596f 7520  ense...  3. You 
│ │ │ │ │ -00011e80: 6d61 7920 636f 7079 2061 6e64 2064 6973  may copy and dis
│ │ │ │ │ -00011e90: 7472 6962 7574 6520 7468 6520 5072 6f67  tribute the Prog
│ │ │ │ │ -00011ea0: 7261 6d20 286f 7220 6120 776f 726b 2062  ram (or a work b
│ │ │ │ │ -00011eb0: 6173 6564 206f 6e20 6974 2c0a 2020 2020  ased on it,.    
│ │ │ │ │ -00011ec0: 2075 6e64 6572 2053 6563 7469 6f6e 2032   under Section 2
│ │ │ │ │ -00011ed0: 2920 696e 206f 626a 6563 7420 636f 6465  ) in object code
│ │ │ │ │ -00011ee0: 206f 7220 6578 6563 7574 6162 6c65 2066   or executable f
│ │ │ │ │ -00011ef0: 6f72 6d20 756e 6465 7220 7468 6520 7465  orm under the te
│ │ │ │ │ -00011f00: 726d 730a 2020 2020 206f 6620 5365 6374  rms.     of Sect
│ │ │ │ │ -00011f10: 696f 6e73 2031 2061 6e64 2032 2061 626f  ions 1 and 2 abo
│ │ │ │ │ -00011f20: 7665 2070 726f 7669 6465 6420 7468 6174  ve provided that
│ │ │ │ │ -00011f30: 2079 6f75 2061 6c73 6f20 646f 206f 6e65   you also do one
│ │ │ │ │ -00011f40: 206f 6620 7468 650a 2020 2020 2066 6f6c   of the.     fol
│ │ │ │ │ -00011f50: 6c6f 7769 6e67 3a0a 0a20 2020 2020 2020  lowing:..       
│ │ │ │ │ -00011f60: 612e 2041 6363 6f6d 7061 6e79 2069 7420  a. Accompany it 
│ │ │ │ │ -00011f70: 7769 7468 2074 6865 2063 6f6d 706c 6574  with the complet
│ │ │ │ │ -00011f80: 6520 636f 7272 6573 706f 6e64 696e 6720  e corresponding 
│ │ │ │ │ -00011f90: 6d61 6368 696e 652d 7265 6164 6162 6c65  machine-readable
│ │ │ │ │ -00011fa0: 0a20 2020 2020 2020 2020 2073 6f75 7263  .          sourc
│ │ │ │ │ -00011fb0: 6520 636f 6465 2c20 7768 6963 6820 6d75  e code, which mu
│ │ │ │ │ -00011fc0: 7374 2062 6520 6469 7374 7269 6275 7465  st be distribute
│ │ │ │ │ -00011fd0: 6420 756e 6465 7220 7468 6520 7465 726d  d under the term
│ │ │ │ │ -00011fe0: 7320 6f66 0a20 2020 2020 2020 2020 2053  s of.          S
│ │ │ │ │ -00011ff0: 6563 7469 6f6e 7320 3120 616e 6420 3220  ections 1 and 2 
│ │ │ │ │ -00012000: 6162 6f76 6520 6f6e 2061 206d 6564 6975  above on a mediu
│ │ │ │ │ -00012010: 6d20 6375 7374 6f6d 6172 696c 7920 7573  m customarily us
│ │ │ │ │ -00012020: 6564 2066 6f72 0a20 2020 2020 2020 2020  ed for.         
│ │ │ │ │ -00012030: 2073 6f66 7477 6172 6520 696e 7465 7263   software interc
│ │ │ │ │ -00012040: 6861 6e67 653b 206f 722c 0a0a 2020 2020  hange; or,..    
│ │ │ │ │ -00012050: 2020 2062 2e20 4163 636f 6d70 616e 7920     b. Accompany 
│ │ │ │ │ -00012060: 6974 2077 6974 6820 6120 7772 6974 7465  it with a writte
│ │ │ │ │ -00012070: 6e20 6f66 6665 722c 2076 616c 6964 2066  n offer, valid f
│ │ │ │ │ -00012080: 6f72 2061 7420 6c65 6173 7420 7468 7265  or at least thre
│ │ │ │ │ -00012090: 650a 2020 2020 2020 2020 2020 7965 6172  e.          year
│ │ │ │ │ -000120a0: 732c 2074 6f20 6769 7665 2061 6e79 2074  s, to give any t
│ │ │ │ │ -000120b0: 6869 7264 2070 6172 7479 2c20 666f 7220  hird party, for 
│ │ │ │ │ -000120c0: 6120 6368 6172 6765 206e 6f20 6d6f 7265  a charge no more
│ │ │ │ │ -000120d0: 2074 6861 6e20 796f 7572 0a20 2020 2020   than your.     
│ │ │ │ │ -000120e0: 2020 2020 2063 6f73 7420 6f66 2070 6879       cost of phy
│ │ │ │ │ -000120f0: 7369 6361 6c6c 7920 7065 7266 6f72 6d69  sically performi
│ │ │ │ │ -00012100: 6e67 2073 6f75 7263 6520 6469 7374 7269  ng source distri
│ │ │ │ │ -00012110: 6275 7469 6f6e 2c20 6120 636f 6d70 6c65  bution, a comple
│ │ │ │ │ -00012120: 7465 0a20 2020 2020 2020 2020 206d 6163  te.          mac
│ │ │ │ │ -00012130: 6869 6e65 2d72 6561 6461 626c 6520 636f  hine-readable co
│ │ │ │ │ -00012140: 7079 206f 6620 7468 6520 636f 7272 6573  py of the corres
│ │ │ │ │ -00012150: 706f 6e64 696e 6720 736f 7572 6365 2063  ponding source c
│ │ │ │ │ -00012160: 6f64 652c 2074 6f20 6265 0a20 2020 2020  ode, to be.     
│ │ │ │ │ -00012170: 2020 2020 2064 6973 7472 6962 7574 6564       distributed
│ │ │ │ │ -00012180: 2075 6e64 6572 2074 6865 2074 6572 6d73   under the terms
│ │ │ │ │ -00012190: 206f 6620 5365 6374 696f 6e73 2031 2061   of Sections 1 a
│ │ │ │ │ -000121a0: 6e64 2032 2061 626f 7665 206f 6e20 610a  nd 2 above on a.
│ │ │ │ │ -000121b0: 2020 2020 2020 2020 2020 6d65 6469 756d            medium
│ │ │ │ │ -000121c0: 2063 7573 746f 6d61 7269 6c79 2075 7365   customarily use
│ │ │ │ │ -000121d0: 6420 666f 7220 736f 6674 7761 7265 2069  d for software i
│ │ │ │ │ -000121e0: 6e74 6572 6368 616e 6765 3b20 6f72 2c0a  nterchange; or,.
│ │ │ │ │ -000121f0: 0a20 2020 2020 2020 632e 2041 6363 6f6d  .       c. Accom
│ │ │ │ │ -00012200: 7061 6e79 2069 7420 7769 7468 2074 6865  pany it with the
│ │ │ │ │ -00012210: 2069 6e66 6f72 6d61 7469 6f6e 2079 6f75   information you
│ │ │ │ │ -00012220: 2072 6563 6569 7665 6420 6173 2074 6f20   received as to 
│ │ │ │ │ -00012230: 7468 6520 6f66 6665 720a 2020 2020 2020  the offer.      
│ │ │ │ │ -00012240: 2020 2020 746f 2064 6973 7472 6962 7574      to distribut
│ │ │ │ │ -00012250: 6520 636f 7272 6573 706f 6e64 696e 6720  e corresponding 
│ │ │ │ │ -00012260: 736f 7572 6365 2063 6f64 652e 2020 2854  source code.  (T
│ │ │ │ │ -00012270: 6869 7320 616c 7465 726e 6174 6976 6520  his alternative 
│ │ │ │ │ -00012280: 6973 0a20 2020 2020 2020 2020 2061 6c6c  is.          all
│ │ │ │ │ -00012290: 6f77 6564 206f 6e6c 7920 666f 7220 6e6f  owed only for no
│ │ │ │ │ -000122a0: 6e63 6f6d 6d65 7263 6961 6c20 6469 7374  ncommercial dist
│ │ │ │ │ -000122b0: 7269 6275 7469 6f6e 2061 6e64 206f 6e6c  ribution and onl
│ │ │ │ │ -000122c0: 7920 6966 2079 6f75 0a20 2020 2020 2020  y if you.       
│ │ │ │ │ -000122d0: 2020 2072 6563 6569 7665 6420 7468 6520     received the 
│ │ │ │ │ -000122e0: 7072 6f67 7261 6d20 696e 206f 626a 6563  program in objec
│ │ │ │ │ -000122f0: 7420 636f 6465 206f 7220 6578 6563 7574  t code or execut
│ │ │ │ │ -00012300: 6162 6c65 2066 6f72 6d20 7769 7468 0a20  able form with. 
│ │ │ │ │ -00012310: 2020 2020 2020 2020 2073 7563 6820 616e           such an
│ │ │ │ │ -00012320: 206f 6666 6572 2c20 696e 2061 6363 6f72   offer, in accor
│ │ │ │ │ -00012330: 6420 7769 7468 2053 7562 7365 6374 696f  d with Subsectio
│ │ │ │ │ -00012340: 6e20 6220 6162 6f76 652e 290a 0a20 2020  n b above.)..   
│ │ │ │ │ -00012350: 2020 5468 6520 736f 7572 6365 2063 6f64    The source cod
│ │ │ │ │ -00012360: 6520 666f 7220 6120 776f 726b 206d 6561  e for a work mea
│ │ │ │ │ -00012370: 6e73 2074 6865 2070 7265 6665 7272 6564  ns the preferred
│ │ │ │ │ -00012380: 2066 6f72 6d20 6f66 2074 6865 2077 6f72   form of the wor
│ │ │ │ │ -00012390: 6b20 666f 720a 2020 2020 206d 616b 696e  k for.     makin
│ │ │ │ │ -000123a0: 6720 6d6f 6469 6669 6361 7469 6f6e 7320  g modifications 
│ │ │ │ │ -000123b0: 746f 2069 742e 2020 466f 7220 616e 2065  to it.  For an e
│ │ │ │ │ -000123c0: 7865 6375 7461 626c 6520 776f 726b 2c20  xecutable work, 
│ │ │ │ │ -000123d0: 636f 6d70 6c65 7465 0a20 2020 2020 736f  complete.     so
│ │ │ │ │ -000123e0: 7572 6365 2063 6f64 6520 6d65 616e 7320  urce code means 
│ │ │ │ │ -000123f0: 616c 6c20 7468 6520 736f 7572 6365 2063  all the source c
│ │ │ │ │ -00012400: 6f64 6520 666f 7220 616c 6c20 6d6f 6475  ode for all modu
│ │ │ │ │ -00012410: 6c65 7320 6974 2063 6f6e 7461 696e 732c  les it contains,
│ │ │ │ │ -00012420: 0a20 2020 2020 706c 7573 2061 6e79 2061  .     plus any a
│ │ │ │ │ -00012430: 7373 6f63 6961 7465 6420 696e 7465 7266  ssociated interf
│ │ │ │ │ -00012440: 6163 6520 6465 6669 6e69 7469 6f6e 2066  ace definition f
│ │ │ │ │ -00012450: 696c 6573 2c20 706c 7573 2074 6865 2073  iles, plus the s
│ │ │ │ │ -00012460: 6372 6970 7473 0a20 2020 2020 7573 6564  cripts.     used
│ │ │ │ │ -00012470: 2074 6f20 636f 6e74 726f 6c20 636f 6d70   to control comp
│ │ │ │ │ -00012480: 696c 6174 696f 6e20 616e 6420 696e 7374  ilation and inst
│ │ │ │ │ -00012490: 616c 6c61 7469 6f6e 206f 6620 7468 6520  allation of the 
│ │ │ │ │ -000124a0: 6578 6563 7574 6162 6c65 2e0a 2020 2020  executable..    
│ │ │ │ │ -000124b0: 2048 6f77 6576 6572 2c20 6173 2061 2073   However, as a s
│ │ │ │ │ -000124c0: 7065 6369 616c 2065 7863 6570 7469 6f6e  pecial exception
│ │ │ │ │ -000124d0: 2c20 7468 6520 736f 7572 6365 2063 6f64  , the source cod
│ │ │ │ │ -000124e0: 6520 6469 7374 7269 6275 7465 6420 6e65  e distributed ne
│ │ │ │ │ -000124f0: 6564 0a20 2020 2020 6e6f 7420 696e 636c  ed.     not incl
│ │ │ │ │ -00012500: 7564 6520 616e 7974 6869 6e67 2074 6861  ude anything tha
│ │ │ │ │ -00012510: 7420 6973 206e 6f72 6d61 6c6c 7920 6469  t is normally di
│ │ │ │ │ -00012520: 7374 7269 6275 7465 6420 2869 6e20 6569  stributed (in ei
│ │ │ │ │ -00012530: 7468 6572 2073 6f75 7263 650a 2020 2020  ther source.    
│ │ │ │ │ -00012540: 206f 7220 6269 6e61 7279 2066 6f72 6d29   or binary form)
│ │ │ │ │ -00012550: 2077 6974 6820 7468 6520 6d61 6a6f 7220   with the major 
│ │ │ │ │ -00012560: 636f 6d70 6f6e 656e 7473 2028 636f 6d70  components (comp
│ │ │ │ │ -00012570: 696c 6572 2c20 6b65 726e 656c 2c20 616e  iler, kernel, an
│ │ │ │ │ -00012580: 6420 736f 0a20 2020 2020 6f6e 2920 6f66  d so.     on) of
│ │ │ │ │ -00012590: 2074 6865 206f 7065 7261 7469 6e67 2073   the operating s
│ │ │ │ │ -000125a0: 7973 7465 6d20 6f6e 2077 6869 6368 2074  ystem on which t
│ │ │ │ │ -000125b0: 6865 2065 7865 6375 7461 626c 6520 7275  he executable ru
│ │ │ │ │ -000125c0: 6e73 2c20 756e 6c65 7373 0a20 2020 2020  ns, unless.     
│ │ │ │ │ -000125d0: 7468 6174 2063 6f6d 706f 6e65 6e74 2069  that component i
│ │ │ │ │ -000125e0: 7473 656c 6620 6163 636f 6d70 616e 6965  tself accompanie
│ │ │ │ │ -000125f0: 7320 7468 6520 6578 6563 7574 6162 6c65  s the executable
│ │ │ │ │ -00012600: 2e0a 0a20 2020 2020 4966 2064 6973 7472  ...     If distr
│ │ │ │ │ -00012610: 6962 7574 696f 6e20 6f66 2065 7865 6375  ibution of execu
│ │ │ │ │ -00012620: 7461 626c 6520 6f72 206f 626a 6563 7420  table or object 
│ │ │ │ │ -00012630: 636f 6465 2069 7320 6d61 6465 2062 7920  code is made by 
│ │ │ │ │ -00012640: 6f66 6665 7269 6e67 0a20 2020 2020 6163  offering.     ac
│ │ │ │ │ -00012650: 6365 7373 2074 6f20 636f 7079 2066 726f  cess to copy fro
│ │ │ │ │ -00012660: 6d20 6120 6465 7369 676e 6174 6564 2070  m a designated p
│ │ │ │ │ -00012670: 6c61 6365 2c20 7468 656e 206f 6666 6572  lace, then offer
│ │ │ │ │ -00012680: 696e 6720 6571 7569 7661 6c65 6e74 0a20  ing equivalent. 
│ │ │ │ │ -00012690: 2020 2020 6163 6365 7373 2074 6f20 636f      access to co
│ │ │ │ │ -000126a0: 7079 2074 6865 2073 6f75 7263 6520 636f  py the source co
│ │ │ │ │ -000126b0: 6465 2066 726f 6d20 7468 6520 7361 6d65  de from the same
│ │ │ │ │ -000126c0: 2070 6c61 6365 2063 6f75 6e74 7320 6173   place counts as
│ │ │ │ │ -000126d0: 0a20 2020 2020 6469 7374 7269 6275 7469  .     distributi
│ │ │ │ │ -000126e0: 6f6e 206f 6620 7468 6520 736f 7572 6365  on of the source
│ │ │ │ │ -000126f0: 2063 6f64 652c 2065 7665 6e20 7468 6f75   code, even thou
│ │ │ │ │ -00012700: 6768 2074 6869 7264 2070 6172 7469 6573  gh third parties
│ │ │ │ │ -00012710: 2061 7265 206e 6f74 0a20 2020 2020 636f   are not.     co
│ │ │ │ │ -00012720: 6d70 656c 6c65 6420 746f 2063 6f70 7920  mpelled to copy 
│ │ │ │ │ -00012730: 7468 6520 736f 7572 6365 2061 6c6f 6e67  the source along
│ │ │ │ │ -00012740: 2077 6974 6820 7468 6520 6f62 6a65 6374   with the object
│ │ │ │ │ -00012750: 2063 6f64 652e 0a0a 2020 342e 2059 6f75   code...  4. You
│ │ │ │ │ -00012760: 206d 6179 206e 6f74 2063 6f70 792c 206d   may not copy, m
│ │ │ │ │ -00012770: 6f64 6966 792c 2073 7562 6c69 6365 6e73  odify, sublicens
│ │ │ │ │ -00012780: 652c 206f 7220 6469 7374 7269 6275 7465  e, or distribute
│ │ │ │ │ -00012790: 2074 6865 2050 726f 6772 616d 0a20 2020   the Program.   
│ │ │ │ │ -000127a0: 2020 6578 6365 7074 2061 7320 6578 7072    except as expr
│ │ │ │ │ -000127b0: 6573 736c 7920 7072 6f76 6964 6564 2075  essly provided u
│ │ │ │ │ -000127c0: 6e64 6572 2074 6869 7320 4c69 6365 6e73  nder this Licens
│ │ │ │ │ -000127d0: 652e 2020 416e 7920 6174 7465 6d70 740a  e.  Any attempt.
│ │ │ │ │ -000127e0: 2020 2020 206f 7468 6572 7769 7365 2074       otherwise t
│ │ │ │ │ -000127f0: 6f20 636f 7079 2c20 6d6f 6469 6679 2c20  o copy, modify, 
│ │ │ │ │ -00012800: 7375 626c 6963 656e 7365 206f 7220 6469  sublicense or di
│ │ │ │ │ -00012810: 7374 7269 6275 7465 2074 6865 2050 726f  stribute the Pro
│ │ │ │ │ -00012820: 6772 616d 2069 730a 2020 2020 2076 6f69  gram is.     voi
│ │ │ │ │ -00012830: 642c 2061 6e64 2077 696c 6c20 6175 746f  d, and will auto
│ │ │ │ │ -00012840: 6d61 7469 6361 6c6c 7920 7465 726d 696e  matically termin
│ │ │ │ │ -00012850: 6174 6520 796f 7572 2072 6967 6874 7320  ate your rights 
│ │ │ │ │ -00012860: 756e 6465 7220 7468 6973 0a20 2020 2020  under this.     
│ │ │ │ │ -00012870: 4c69 6365 6e73 652e 2020 486f 7765 7665  License.  Howeve
│ │ │ │ │ -00012880: 722c 2070 6172 7469 6573 2077 686f 2068  r, parties who h
│ │ │ │ │ -00012890: 6176 6520 7265 6365 6976 6564 2063 6f70  ave received cop
│ │ │ │ │ -000128a0: 6965 732c 206f 7220 7269 6768 7473 2c0a  ies, or rights,.
│ │ │ │ │ -000128b0: 2020 2020 2066 726f 6d20 796f 7520 756e       from you un
│ │ │ │ │ -000128c0: 6465 7220 7468 6973 204c 6963 656e 7365  der this License
│ │ │ │ │ -000128d0: 2077 696c 6c20 6e6f 7420 6861 7665 2074   will not have t
│ │ │ │ │ -000128e0: 6865 6972 206c 6963 656e 7365 7320 7465  heir licenses te
│ │ │ │ │ -000128f0: 726d 696e 6174 6564 0a20 2020 2020 736f  rminated.     so
│ │ │ │ │ -00012900: 206c 6f6e 6720 6173 2073 7563 6820 7061   long as such pa
│ │ │ │ │ -00012910: 7274 6965 7320 7265 6d61 696e 2069 6e20  rties remain in 
│ │ │ │ │ -00012920: 6675 6c6c 2063 6f6d 706c 6961 6e63 652e  full compliance.
│ │ │ │ │ -00012930: 0a0a 2020 352e 2059 6f75 2061 7265 206e  ..  5. You are n
│ │ │ │ │ -00012940: 6f74 2072 6571 7569 7265 6420 746f 2061  ot required to a
│ │ │ │ │ -00012950: 6363 6570 7420 7468 6973 204c 6963 656e  ccept this Licen
│ │ │ │ │ -00012960: 7365 2c20 7369 6e63 6520 796f 7520 6861  se, since you ha
│ │ │ │ │ -00012970: 7665 206e 6f74 0a20 2020 2020 7369 676e  ve not.     sign
│ │ │ │ │ -00012980: 6564 2069 742e 2020 486f 7765 7665 722c  ed it.  However,
│ │ │ │ │ -00012990: 206e 6f74 6869 6e67 2065 6c73 6520 6772   nothing else gr
│ │ │ │ │ -000129a0: 616e 7473 2079 6f75 2070 6572 6d69 7373  ants you permiss
│ │ │ │ │ -000129b0: 696f 6e20 746f 206d 6f64 6966 790a 2020  ion to modify.  
│ │ │ │ │ -000129c0: 2020 206f 7220 6469 7374 7269 6275 7465     or distribute
│ │ │ │ │ -000129d0: 2074 6865 2050 726f 6772 616d 206f 7220   the Program or 
│ │ │ │ │ -000129e0: 6974 7320 6465 7269 7661 7469 7665 2077  its derivative w
│ │ │ │ │ -000129f0: 6f72 6b73 2e20 2054 6865 7365 2061 6374  orks.  These act
│ │ │ │ │ -00012a00: 696f 6e73 0a20 2020 2020 6172 6520 7072  ions.     are pr
│ │ │ │ │ -00012a10: 6f68 6962 6974 6564 2062 7920 6c61 7720  ohibited by law 
│ │ │ │ │ -00012a20: 6966 2079 6f75 2064 6f20 6e6f 7420 6163  if you do not ac
│ │ │ │ │ -00012a30: 6365 7074 2074 6869 7320 4c69 6365 6e73  cept this Licens
│ │ │ │ │ -00012a40: 652e 0a20 2020 2020 5468 6572 6566 6f72  e..     Therefor
│ │ │ │ │ -00012a50: 652c 2062 7920 6d6f 6469 6679 696e 6720  e, by modifying 
│ │ │ │ │ -00012a60: 6f72 2064 6973 7472 6962 7574 696e 6720  or distributing 
│ │ │ │ │ -00012a70: 7468 6520 5072 6f67 7261 6d20 286f 7220  the Program (or 
│ │ │ │ │ -00012a80: 616e 7920 776f 726b 0a20 2020 2020 6261  any work.     ba
│ │ │ │ │ -00012a90: 7365 6420 6f6e 2074 6865 2050 726f 6772  sed on the Progr
│ │ │ │ │ -00012aa0: 616d 292c 2079 6f75 2069 6e64 6963 6174  am), you indicat
│ │ │ │ │ -00012ab0: 6520 796f 7572 2061 6363 6570 7461 6e63  e your acceptanc
│ │ │ │ │ -00012ac0: 6520 6f66 2074 6869 7320 4c69 6365 6e73  e of this Licens
│ │ │ │ │ -00012ad0: 650a 2020 2020 2074 6f20 646f 2073 6f2c  e.     to do so,
│ │ │ │ │ -00012ae0: 2061 6e64 2061 6c6c 2069 7473 2074 6572   and all its ter
│ │ │ │ │ -00012af0: 6d73 2061 6e64 2063 6f6e 6469 7469 6f6e  ms and condition
│ │ │ │ │ -00012b00: 7320 666f 7220 636f 7079 696e 672c 0a20  s for copying,. 
│ │ │ │ │ -00012b10: 2020 2020 6469 7374 7269 6275 7469 6e67      distributing
│ │ │ │ │ -00012b20: 206f 7220 6d6f 6469 6679 696e 6720 7468   or modifying th
│ │ │ │ │ -00012b30: 6520 5072 6f67 7261 6d20 6f72 2077 6f72  e Program or wor
│ │ │ │ │ -00012b40: 6b73 2062 6173 6564 206f 6e20 6974 2e0a  ks based on it..
│ │ │ │ │ -00012b50: 0a20 2036 2e20 4561 6368 2074 696d 6520  .  6. Each time 
│ │ │ │ │ -00012b60: 796f 7520 7265 6469 7374 7269 6275 7465  you redistribute
│ │ │ │ │ -00012b70: 2074 6865 2050 726f 6772 616d 2028 6f72   the Program (or
│ │ │ │ │ -00012b80: 2061 6e79 2077 6f72 6b20 6261 7365 6420   any work based 
│ │ │ │ │ -00012b90: 6f6e 2074 6865 0a20 2020 2020 5072 6f67  on the.     Prog
│ │ │ │ │ -00012ba0: 7261 6d29 2c20 7468 6520 7265 6369 7069  ram), the recipi
│ │ │ │ │ -00012bb0: 656e 7420 6175 746f 6d61 7469 6361 6c6c  ent automaticall
│ │ │ │ │ -00012bc0: 7920 7265 6365 6976 6573 2061 206c 6963  y receives a lic
│ │ │ │ │ -00012bd0: 656e 7365 2066 726f 6d20 7468 650a 2020  ense from the.  
│ │ │ │ │ -00012be0: 2020 206f 7269 6769 6e61 6c20 6c69 6365     original lice
│ │ │ │ │ -00012bf0: 6e73 6f72 2074 6f20 636f 7079 2c20 6469  nsor to copy, di
│ │ │ │ │ -00012c00: 7374 7269 6275 7465 206f 7220 6d6f 6469  stribute or modi
│ │ │ │ │ -00012c10: 6679 2074 6865 2050 726f 6772 616d 2073  fy the Program s
│ │ │ │ │ -00012c20: 7562 6a65 6374 0a20 2020 2020 746f 2074  ubject.     to t
│ │ │ │ │ -00012c30: 6865 7365 2074 6572 6d73 2061 6e64 2063  hese terms and c
│ │ │ │ │ -00012c40: 6f6e 6469 7469 6f6e 732e 2020 596f 7520  onditions.  You 
│ │ │ │ │ -00012c50: 6d61 7920 6e6f 7420 696d 706f 7365 2061  may not impose a
│ │ │ │ │ -00012c60: 6e79 2066 7572 7468 6572 0a20 2020 2020  ny further.     
│ │ │ │ │ -00012c70: 7265 7374 7269 6374 696f 6e73 206f 6e20  restrictions on 
│ │ │ │ │ -00012c80: 7468 6520 7265 6369 7069 656e 7473 2720  the recipients' 
│ │ │ │ │ -00012c90: 6578 6572 6369 7365 206f 6620 7468 6520  exercise of the 
│ │ │ │ │ -00012ca0: 7269 6768 7473 2067 7261 6e74 6564 0a20  rights granted. 
│ │ │ │ │ -00012cb0: 2020 2020 6865 7265 696e 2e20 2059 6f75      herein.  You
│ │ │ │ │ -00012cc0: 2061 7265 206e 6f74 2072 6573 706f 6e73   are not respons
│ │ │ │ │ -00012cd0: 6962 6c65 2066 6f72 2065 6e66 6f72 6369  ible for enforci
│ │ │ │ │ -00012ce0: 6e67 2063 6f6d 706c 6961 6e63 6520 6279  ng compliance by
│ │ │ │ │ -00012cf0: 2074 6869 7264 0a20 2020 2020 7061 7274   third.     part
│ │ │ │ │ -00012d00: 6965 7320 746f 2074 6869 7320 4c69 6365  ies to this Lice
│ │ │ │ │ -00012d10: 6e73 652e 0a0a 2020 372e 2049 662c 2061  nse...  7. If, a
│ │ │ │ │ -00012d20: 7320 6120 636f 6e73 6571 7565 6e63 6520  s a consequence 
│ │ │ │ │ -00012d30: 6f66 2061 2063 6f75 7274 206a 7564 676d  of a court judgm
│ │ │ │ │ -00012d40: 656e 7420 6f72 2061 6c6c 6567 6174 696f  ent or allegatio
│ │ │ │ │ -00012d50: 6e20 6f66 2070 6174 656e 740a 2020 2020  n of patent.    
│ │ │ │ │ -00012d60: 2069 6e66 7269 6e67 656d 656e 7420 6f72   infringement or
│ │ │ │ │ -00012d70: 2066 6f72 2061 6e79 206f 7468 6572 2072   for any other r
│ │ │ │ │ -00012d80: 6561 736f 6e20 286e 6f74 206c 696d 6974  eason (not limit
│ │ │ │ │ -00012d90: 6564 2074 6f20 7061 7465 6e74 0a20 2020  ed to patent.   
│ │ │ │ │ -00012da0: 2020 6973 7375 6573 292c 2063 6f6e 6469    issues), condi
│ │ │ │ │ -00012db0: 7469 6f6e 7320 6172 6520 696d 706f 7365  tions are impose
│ │ │ │ │ -00012dc0: 6420 6f6e 2079 6f75 2028 7768 6574 6865  d on you (whethe
│ │ │ │ │ -00012dd0: 7220 6279 2063 6f75 7274 206f 7264 6572  r by court order
│ │ │ │ │ -00012de0: 2c0a 2020 2020 2061 6772 6565 6d65 6e74  ,.     agreement
│ │ │ │ │ -00012df0: 206f 7220 6f74 6865 7277 6973 6529 2074   or otherwise) t
│ │ │ │ │ -00012e00: 6861 7420 636f 6e74 7261 6469 6374 2074  hat contradict t
│ │ │ │ │ -00012e10: 6865 2063 6f6e 6469 7469 6f6e 7320 6f66  he conditions of
│ │ │ │ │ -00012e20: 2074 6869 730a 2020 2020 204c 6963 656e   this.     Licen
│ │ │ │ │ -00012e30: 7365 2c20 7468 6579 2064 6f20 6e6f 7420  se, they do not 
│ │ │ │ │ -00012e40: 6578 6375 7365 2079 6f75 2066 726f 6d20  excuse you from 
│ │ │ │ │ -00012e50: 7468 6520 636f 6e64 6974 696f 6e73 206f  the conditions o
│ │ │ │ │ -00012e60: 6620 7468 6973 0a20 2020 2020 4c69 6365  f this.     Lice
│ │ │ │ │ -00012e70: 6e73 652e 2020 4966 2079 6f75 2063 616e  nse.  If you can
│ │ │ │ │ -00012e80: 6e6f 7420 6469 7374 7269 6275 7465 2073  not distribute s
│ │ │ │ │ -00012e90: 6f20 6173 2074 6f20 7361 7469 7366 7920  o as to satisfy 
│ │ │ │ │ -00012ea0: 7369 6d75 6c74 616e 656f 7573 6c79 0a20  simultaneously. 
│ │ │ │ │ -00012eb0: 2020 2020 796f 7572 206f 626c 6967 6174      your obligat
│ │ │ │ │ -00012ec0: 696f 6e73 2075 6e64 6572 2074 6869 7320  ions under this 
│ │ │ │ │ -00012ed0: 4c69 6365 6e73 6520 616e 6420 616e 7920  License and any 
│ │ │ │ │ -00012ee0: 6f74 6865 7220 7065 7274 696e 656e 740a  other pertinent.
│ │ │ │ │ -00012ef0: 2020 2020 206f 626c 6967 6174 696f 6e73       obligations
│ │ │ │ │ -00012f00: 2c20 7468 656e 2061 7320 6120 636f 6e73  , then as a cons
│ │ │ │ │ -00012f10: 6571 7565 6e63 6520 796f 7520 6d61 7920  equence you may 
│ │ │ │ │ -00012f20: 6e6f 7420 6469 7374 7269 6275 7465 2074  not distribute t
│ │ │ │ │ -00012f30: 6865 0a20 2020 2020 5072 6f67 7261 6d20  he.     Program 
│ │ │ │ │ -00012f40: 6174 2061 6c6c 2e20 2046 6f72 2065 7861  at all.  For exa
│ │ │ │ │ -00012f50: 6d70 6c65 2c20 6966 2061 2070 6174 656e  mple, if a paten
│ │ │ │ │ -00012f60: 7420 6c69 6365 6e73 6520 776f 756c 6420  t license would 
│ │ │ │ │ -00012f70: 6e6f 7420 7065 726d 6974 0a20 2020 2020  not permit.     
│ │ │ │ │ -00012f80: 726f 7961 6c74 792d 6672 6565 2072 6564  royalty-free red
│ │ │ │ │ -00012f90: 6973 7472 6962 7574 696f 6e20 6f66 2074  istribution of t
│ │ │ │ │ -00012fa0: 6865 2050 726f 6772 616d 2062 7920 616c  he Program by al
│ │ │ │ │ -00012fb0: 6c20 7468 6f73 6520 7768 6f20 7265 6365  l those who rece
│ │ │ │ │ -00012fc0: 6976 650a 2020 2020 2063 6f70 6965 7320  ive.     copies 
│ │ │ │ │ -00012fd0: 6469 7265 6374 6c79 206f 7220 696e 6469  directly or indi
│ │ │ │ │ -00012fe0: 7265 6374 6c79 2074 6872 6f75 6768 2079  rectly through y
│ │ │ │ │ -00012ff0: 6f75 2c20 7468 656e 2074 6865 206f 6e6c  ou, then the onl
│ │ │ │ │ -00013000: 7920 7761 7920 796f 750a 2020 2020 2063  y way you.     c
│ │ │ │ │ -00013010: 6f75 6c64 2073 6174 6973 6679 2062 6f74  ould satisfy bot
│ │ │ │ │ -00013020: 6820 6974 2061 6e64 2074 6869 7320 4c69  h it and this Li
│ │ │ │ │ -00013030: 6365 6e73 6520 776f 756c 6420 6265 2074  cense would be t
│ │ │ │ │ -00013040: 6f20 7265 6672 6169 6e20 656e 7469 7265  o refrain entire
│ │ │ │ │ -00013050: 6c79 0a20 2020 2020 6672 6f6d 2064 6973  ly.     from dis
│ │ │ │ │ -00013060: 7472 6962 7574 696f 6e20 6f66 2074 6865  tribution of the
│ │ │ │ │ -00013070: 2050 726f 6772 616d 2e0a 0a20 2020 2020   Program...     
│ │ │ │ │ -00013080: 4966 2061 6e79 2070 6f72 7469 6f6e 206f  If any portion o
│ │ │ │ │ -00013090: 6620 7468 6973 2073 6563 7469 6f6e 2069  f this section i
│ │ │ │ │ -000130a0: 7320 6865 6c64 2069 6e76 616c 6964 206f  s held invalid o
│ │ │ │ │ -000130b0: 7220 756e 656e 666f 7263 6561 626c 650a  r unenforceable.
│ │ │ │ │ -000130c0: 2020 2020 2075 6e64 6572 2061 6e79 2070       under any p
│ │ │ │ │ -000130d0: 6172 7469 6375 6c61 7220 6369 7263 756d  articular circum
│ │ │ │ │ -000130e0: 7374 616e 6365 2c20 7468 6520 6261 6c61  stance, the bala
│ │ │ │ │ -000130f0: 6e63 6520 6f66 2074 6865 2073 6563 7469  nce of the secti
│ │ │ │ │ -00013100: 6f6e 2069 730a 2020 2020 2069 6e74 656e  on is.     inten
│ │ │ │ │ -00013110: 6465 6420 746f 2061 7070 6c79 2061 6e64  ded to apply and
│ │ │ │ │ -00013120: 2074 6865 2073 6563 7469 6f6e 2061 7320   the section as 
│ │ │ │ │ -00013130: 6120 7768 6f6c 6520 6973 2069 6e74 656e  a whole is inten
│ │ │ │ │ -00013140: 6465 6420 746f 2061 7070 6c79 0a20 2020  ded to apply.   
│ │ │ │ │ -00013150: 2020 696e 206f 7468 6572 2063 6972 6375    in other circu
│ │ │ │ │ -00013160: 6d73 7461 6e63 6573 2e0a 0a20 2020 2020  mstances...     
│ │ │ │ │ -00013170: 4974 2069 7320 6e6f 7420 7468 6520 7075  It is not the pu
│ │ │ │ │ -00013180: 7270 6f73 6520 6f66 2074 6869 7320 7365  rpose of this se
│ │ │ │ │ -00013190: 6374 696f 6e20 746f 2069 6e64 7563 6520  ction to induce 
│ │ │ │ │ -000131a0: 796f 7520 746f 2069 6e66 7269 6e67 6520  you to infringe 
│ │ │ │ │ -000131b0: 616e 790a 2020 2020 2070 6174 656e 7473  any.     patents
│ │ │ │ │ -000131c0: 206f 7220 6f74 6865 7220 7072 6f70 6572   or other proper
│ │ │ │ │ -000131d0: 7479 2072 6967 6874 2063 6c61 696d 7320  ty right claims 
│ │ │ │ │ -000131e0: 6f72 2074 6f20 636f 6e74 6573 7420 7661  or to contest va
│ │ │ │ │ -000131f0: 6c69 6469 7479 206f 660a 2020 2020 2061  lidity of.     a
│ │ │ │ │ -00013200: 6e79 2073 7563 6820 636c 6169 6d73 3b20  ny such claims; 
│ │ │ │ │ -00013210: 7468 6973 2073 6563 7469 6f6e 2068 6173  this section has
│ │ │ │ │ -00013220: 2074 6865 2073 6f6c 6520 7075 7270 6f73   the sole purpos
│ │ │ │ │ -00013230: 6520 6f66 2070 726f 7465 6374 696e 670a  e of protecting.
│ │ │ │ │ -00013240: 2020 2020 2074 6865 2069 6e74 6567 7269       the integri
│ │ │ │ │ -00013250: 7479 206f 6620 7468 6520 6672 6565 2073  ty of the free s
│ │ │ │ │ -00013260: 6f66 7477 6172 6520 6469 7374 7269 6275  oftware distribu
│ │ │ │ │ -00013270: 7469 6f6e 2073 7973 7465 6d2c 2077 6869  tion system, whi
│ │ │ │ │ -00013280: 6368 2069 730a 2020 2020 2069 6d70 6c65  ch is.     imple
│ │ │ │ │ -00013290: 6d65 6e74 6564 2062 7920 7075 626c 6963  mented by public
│ │ │ │ │ -000132a0: 206c 6963 656e 7365 2070 7261 6374 6963   license practic
│ │ │ │ │ -000132b0: 6573 2e20 204d 616e 7920 7065 6f70 6c65  es.  Many people
│ │ │ │ │ -000132c0: 2068 6176 6520 6d61 6465 0a20 2020 2020   have made.     
│ │ │ │ │ -000132d0: 6765 6e65 726f 7573 2063 6f6e 7472 6962  generous contrib
│ │ │ │ │ -000132e0: 7574 696f 6e73 2074 6f20 7468 6520 7769  utions to the wi
│ │ │ │ │ -000132f0: 6465 2072 616e 6765 206f 6620 736f 6674  de range of soft
│ │ │ │ │ -00013300: 7761 7265 2064 6973 7472 6962 7574 6564  ware distributed
│ │ │ │ │ -00013310: 0a20 2020 2020 7468 726f 7567 6820 7468  .     through th
│ │ │ │ │ -00013320: 6174 2073 7973 7465 6d20 696e 2072 656c  at system in rel
│ │ │ │ │ -00013330: 6961 6e63 6520 6f6e 2063 6f6e 7369 7374  iance on consist
│ │ │ │ │ -00013340: 656e 7420 6170 706c 6963 6174 696f 6e20  ent application 
│ │ │ │ │ -00013350: 6f66 2074 6861 740a 2020 2020 2073 7973  of that.     sys
│ │ │ │ │ -00013360: 7465 6d3b 2069 7420 6973 2075 7020 746f  tem; it is up to
│ │ │ │ │ -00013370: 2074 6865 2061 7574 686f 722f 646f 6e6f   the author/dono
│ │ │ │ │ -00013380: 7220 746f 2064 6563 6964 6520 6966 2068  r to decide if h
│ │ │ │ │ -00013390: 6520 6f72 2073 6865 2069 730a 2020 2020  e or she is.    
│ │ │ │ │ -000133a0: 2077 696c 6c69 6e67 2074 6f20 6469 7374   willing to dist
│ │ │ │ │ -000133b0: 7269 6275 7465 2073 6f66 7477 6172 6520  ribute software 
│ │ │ │ │ -000133c0: 7468 726f 7567 6820 616e 7920 6f74 6865  through any othe
│ │ │ │ │ -000133d0: 7220 7379 7374 656d 2061 6e64 2061 0a20  r system and a. 
│ │ │ │ │ -000133e0: 2020 2020 6c69 6365 6e73 6565 2063 616e      licensee can
│ │ │ │ │ -000133f0: 6e6f 7420 696d 706f 7365 2074 6861 7420  not impose that 
│ │ │ │ │ -00013400: 6368 6f69 6365 2e0a 0a20 2020 2020 5468  choice...     Th
│ │ │ │ │ -00013410: 6973 2073 6563 7469 6f6e 2069 7320 696e  is section is in
│ │ │ │ │ -00013420: 7465 6e64 6564 2074 6f20 6d61 6b65 2074  tended to make t
│ │ │ │ │ -00013430: 686f 726f 7567 686c 7920 636c 6561 7220  horoughly clear 
│ │ │ │ │ -00013440: 7768 6174 2069 7320 6265 6c69 6576 6564  what is believed
│ │ │ │ │ -00013450: 0a20 2020 2020 746f 2062 6520 6120 636f  .     to be a co
│ │ │ │ │ -00013460: 6e73 6571 7565 6e63 6520 6f66 2074 6865  nsequence of the
│ │ │ │ │ -00013470: 2072 6573 7420 6f66 2074 6869 7320 4c69   rest of this Li
│ │ │ │ │ -00013480: 6365 6e73 652e 0a0a 2020 382e 2049 6620  cense...  8. If 
│ │ │ │ │ -00013490: 7468 6520 6469 7374 7269 6275 7469 6f6e  the distribution
│ │ │ │ │ -000134a0: 2061 6e64 2f6f 7220 7573 6520 6f66 2074   and/or use of t
│ │ │ │ │ -000134b0: 6865 2050 726f 6772 616d 2069 7320 7265  he Program is re
│ │ │ │ │ -000134c0: 7374 7269 6374 6564 2069 6e0a 2020 2020  stricted in.    
│ │ │ │ │ -000134d0: 2063 6572 7461 696e 2063 6f75 6e74 7269   certain countri
│ │ │ │ │ -000134e0: 6573 2065 6974 6865 7220 6279 2070 6174  es either by pat
│ │ │ │ │ -000134f0: 656e 7473 206f 7220 6279 2063 6f70 7972  ents or by copyr
│ │ │ │ │ -00013500: 6967 6874 6564 2069 6e74 6572 6661 6365  ighted interface
│ │ │ │ │ -00013510: 732c 0a20 2020 2020 7468 6520 6f72 6967  s,.     the orig
│ │ │ │ │ -00013520: 696e 616c 2063 6f70 7972 6967 6874 2068  inal copyright h
│ │ │ │ │ -00013530: 6f6c 6465 7220 7768 6f20 706c 6163 6573  older who places
│ │ │ │ │ -00013540: 2074 6865 2050 726f 6772 616d 2075 6e64   the Program und
│ │ │ │ │ -00013550: 6572 2074 6869 730a 2020 2020 204c 6963  er this.     Lic
│ │ │ │ │ -00013560: 656e 7365 206d 6179 2061 6464 2061 6e20  ense may add an 
│ │ │ │ │ -00013570: 6578 706c 6963 6974 2067 656f 6772 6170  explicit geograp
│ │ │ │ │ -00013580: 6869 6361 6c20 6469 7374 7269 6275 7469  hical distributi
│ │ │ │ │ -00013590: 6f6e 206c 696d 6974 6174 696f 6e0a 2020  on limitation.  
│ │ │ │ │ -000135a0: 2020 2065 7863 6c75 6469 6e67 2074 686f     excluding tho
│ │ │ │ │ -000135b0: 7365 2063 6f75 6e74 7269 6573 2c20 736f  se countries, so
│ │ │ │ │ -000135c0: 2074 6861 7420 6469 7374 7269 6275 7469   that distributi
│ │ │ │ │ -000135d0: 6f6e 2069 7320 7065 726d 6974 7465 6420  on is permitted 
│ │ │ │ │ -000135e0: 6f6e 6c79 0a20 2020 2020 696e 206f 7220  only.     in or 
│ │ │ │ │ -000135f0: 616d 6f6e 6720 636f 756e 7472 6965 7320  among countries 
│ │ │ │ │ -00013600: 6e6f 7420 7468 7573 2065 7863 6c75 6465  not thus exclude
│ │ │ │ │ -00013610: 642e 2020 496e 2073 7563 6820 6361 7365  d.  In such case
│ │ │ │ │ -00013620: 2c20 7468 6973 0a20 2020 2020 4c69 6365  , this.     Lice
│ │ │ │ │ -00013630: 6e73 6520 696e 636f 7270 6f72 6174 6573  nse incorporates
│ │ │ │ │ -00013640: 2074 6865 206c 696d 6974 6174 696f 6e20   the limitation 
│ │ │ │ │ -00013650: 6173 2069 6620 7772 6974 7465 6e20 696e  as if written in
│ │ │ │ │ -00013660: 2074 6865 2062 6f64 7920 6f66 0a20 2020   the body of.   
│ │ │ │ │ -00013670: 2020 7468 6973 204c 6963 656e 7365 2e0a    this License..
│ │ │ │ │ -00013680: 0a20 2039 2e20 5468 6520 4672 6565 2053  .  9. The Free S
│ │ │ │ │ -00013690: 6f66 7477 6172 6520 466f 756e 6461 7469  oftware Foundati
│ │ │ │ │ -000136a0: 6f6e 206d 6179 2070 7562 6c69 7368 2072  on may publish r
│ │ │ │ │ -000136b0: 6576 6973 6564 2061 6e64 2f6f 7220 6e65  evised and/or ne
│ │ │ │ │ -000136c0: 770a 2020 2020 2076 6572 7369 6f6e 7320  w.     versions 
│ │ │ │ │ -000136d0: 6f66 2074 6865 2047 656e 6572 616c 2050  of the General P
│ │ │ │ │ -000136e0: 7562 6c69 6320 4c69 6365 6e73 6520 6672  ublic License fr
│ │ │ │ │ -000136f0: 6f6d 2074 696d 6520 746f 2074 696d 652e  om time to time.
│ │ │ │ │ -00013700: 2020 5375 6368 206e 6577 0a20 2020 2020    Such new.     
│ │ │ │ │ -00013710: 7665 7273 696f 6e73 2077 696c 6c20 6265  versions will be
│ │ │ │ │ -00013720: 2073 696d 696c 6172 2069 6e20 7370 6972   similar in spir
│ │ │ │ │ -00013730: 6974 2074 6f20 7468 6520 7072 6573 656e  it to the presen
│ │ │ │ │ -00013740: 7420 7665 7273 696f 6e2c 2062 7574 206d  t version, but m
│ │ │ │ │ -00013750: 6179 0a20 2020 2020 6469 6666 6572 2069  ay.     differ i
│ │ │ │ │ -00013760: 6e20 6465 7461 696c 2074 6f20 6164 6472  n detail to addr
│ │ │ │ │ -00013770: 6573 7320 6e65 7720 7072 6f62 6c65 6d73  ess new problems
│ │ │ │ │ -00013780: 206f 7220 636f 6e63 6572 6e73 2e0a 0a20   or concerns... 
│ │ │ │ │ -00013790: 2020 2020 4561 6368 2076 6572 7369 6f6e      Each version
│ │ │ │ │ -000137a0: 2069 7320 6769 7665 6e20 6120 6469 7374   is given a dist
│ │ │ │ │ -000137b0: 696e 6775 6973 6869 6e67 2076 6572 7369  inguishing versi
│ │ │ │ │ -000137c0: 6f6e 206e 756d 6265 722e 2020 4966 2074  on number.  If t
│ │ │ │ │ -000137d0: 6865 0a20 2020 2020 5072 6f67 7261 6d20  he.     Program 
│ │ │ │ │ -000137e0: 7370 6563 6966 6965 7320 6120 7665 7273  specifies a vers
│ │ │ │ │ -000137f0: 696f 6e20 6e75 6d62 6572 206f 6620 7468  ion number of th
│ │ │ │ │ -00013800: 6973 204c 6963 656e 7365 2077 6869 6368  is License which
│ │ │ │ │ -00013810: 2061 7070 6c69 6573 2074 6f0a 2020 2020   applies to.    
│ │ │ │ │ -00013820: 2069 7420 616e 6420 2261 6e79 206c 6174   it and "any lat
│ │ │ │ │ -00013830: 6572 2076 6572 7369 6f6e 222c 2079 6f75  er version", you
│ │ │ │ │ -00013840: 2068 6176 6520 7468 6520 6f70 7469 6f6e   have the option
│ │ │ │ │ -00013850: 206f 6620 666f 6c6c 6f77 696e 6720 7468   of following th
│ │ │ │ │ -00013860: 650a 2020 2020 2074 6572 6d73 2061 6e64  e.     terms and
│ │ │ │ │ -00013870: 2063 6f6e 6469 7469 6f6e 7320 6569 7468   conditions eith
│ │ │ │ │ -00013880: 6572 206f 6620 7468 6174 2076 6572 7369  er of that versi
│ │ │ │ │ -00013890: 6f6e 206f 7220 6f66 2061 6e79 206c 6174  on or of any lat
│ │ │ │ │ -000138a0: 6572 2076 6572 7369 6f6e 0a20 2020 2020  er version.     
│ │ │ │ │ -000138b0: 7075 626c 6973 6865 6420 6279 2074 6865  published by the
│ │ │ │ │ -000138c0: 2046 7265 6520 536f 6674 7761 7265 2046   Free Software F
│ │ │ │ │ -000138d0: 6f75 6e64 6174 696f 6e2e 2020 4966 2074  oundation.  If t
│ │ │ │ │ -000138e0: 6865 2050 726f 6772 616d 2064 6f65 7320  he Program does 
│ │ │ │ │ -000138f0: 6e6f 740a 2020 2020 2073 7065 6369 6679  not.     specify
│ │ │ │ │ -00013900: 2061 2076 6572 7369 6f6e 206e 756d 6265   a version numbe
│ │ │ │ │ -00013910: 7220 6f66 2074 6869 7320 4c69 6365 6e73  r of this Licens
│ │ │ │ │ -00013920: 652c 2079 6f75 206d 6179 2063 686f 6f73  e, you may choos
│ │ │ │ │ -00013930: 6520 616e 790a 2020 2020 2076 6572 7369  e any.     versi
│ │ │ │ │ -00013940: 6f6e 2065 7665 7220 7075 626c 6973 6865  on ever publishe
│ │ │ │ │ -00013950: 6420 6279 2074 6865 2046 7265 6520 536f  d by the Free So
│ │ │ │ │ -00013960: 6674 7761 7265 2046 6f75 6e64 6174 696f  ftware Foundatio
│ │ │ │ │ -00013970: 6e2e 0a0a 2020 3130 2e20 4966 2079 6f75  n...  10. If you
│ │ │ │ │ -00013980: 2077 6973 6820 746f 2069 6e63 6f72 706f   wish to incorpo
│ │ │ │ │ -00013990: 7261 7465 2070 6172 7473 206f 6620 7468  rate parts of th
│ │ │ │ │ -000139a0: 6520 5072 6f67 7261 6d20 696e 746f 206f  e Program into o
│ │ │ │ │ -000139b0: 7468 6572 2066 7265 650a 2020 2020 2070  ther free.     p
│ │ │ │ │ -000139c0: 726f 6772 616d 7320 7768 6f73 6520 6469  rograms whose di
│ │ │ │ │ -000139d0: 7374 7269 6275 7469 6f6e 2063 6f6e 6469  stribution condi
│ │ │ │ │ -000139e0: 7469 6f6e 7320 6172 6520 6469 6666 6572  tions are differ
│ │ │ │ │ -000139f0: 656e 742c 2077 7269 7465 2074 6f20 7468  ent, write to th
│ │ │ │ │ -00013a00: 650a 2020 2020 2061 7574 686f 7220 746f  e.     author to
│ │ │ │ │ -00013a10: 2061 736b 2066 6f72 2070 6572 6d69 7373   ask for permiss
│ │ │ │ │ -00013a20: 696f 6e2e 2020 466f 7220 736f 6674 7761  ion.  For softwa
│ │ │ │ │ -00013a30: 7265 2077 6869 6368 2069 7320 636f 7079  re which is copy
│ │ │ │ │ -00013a40: 7269 6768 7465 6420 6279 0a20 2020 2020  righted by.     
│ │ │ │ │ -00013a50: 7468 6520 4672 6565 2053 6f66 7477 6172  the Free Softwar
│ │ │ │ │ -00013a60: 6520 466f 756e 6461 7469 6f6e 2c20 7772  e Foundation, wr
│ │ │ │ │ -00013a70: 6974 6520 746f 2074 6865 2046 7265 6520  ite to the Free 
│ │ │ │ │ -00013a80: 536f 6674 7761 7265 0a20 2020 2020 466f  Software.     Fo
│ │ │ │ │ -00013a90: 756e 6461 7469 6f6e 3b20 7765 2073 6f6d  undation; we som
│ │ │ │ │ -00013aa0: 6574 696d 6573 206d 616b 6520 6578 6365  etimes make exce
│ │ │ │ │ -00013ab0: 7074 696f 6e73 2066 6f72 2074 6869 732e  ptions for this.
│ │ │ │ │ -00013ac0: 2020 4f75 7220 6465 6369 7369 6f6e 0a20    Our decision. 
│ │ │ │ │ -00013ad0: 2020 2020 7769 6c6c 2062 6520 6775 6964      will be guid
│ │ │ │ │ -00013ae0: 6564 2062 7920 7468 6520 7477 6f20 676f  ed by the two go
│ │ │ │ │ -00013af0: 616c 7320 6f66 2070 7265 7365 7276 696e  als of preservin
│ │ │ │ │ -00013b00: 6720 7468 6520 6672 6565 2073 7461 7475  g the free statu
│ │ │ │ │ -00013b10: 7320 6f66 0a20 2020 2020 616c 6c20 6465  s of.     all de
│ │ │ │ │ -00013b20: 7269 7661 7469 7665 7320 6f66 206f 7572  rivatives of our
│ │ │ │ │ -00013b30: 2066 7265 6520 736f 6674 7761 7265 2061   free software a
│ │ │ │ │ -00013b40: 6e64 206f 6620 7072 6f6d 6f74 696e 6720  nd of promoting 
│ │ │ │ │ -00013b50: 7468 6520 7368 6172 696e 670a 2020 2020  the sharing.    
│ │ │ │ │ -00013b60: 2061 6e64 2072 6575 7365 206f 6620 736f   and reuse of so
│ │ │ │ │ -00013b70: 6674 7761 7265 2067 656e 6572 616c 6c79  ftware generally
│ │ │ │ │ -00013b80: 2e0a 0a20 2020 2020 2020 2020 2020 2020  ...             
│ │ │ │ │ -00013b90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00013ba0: 204e 4f20 5741 5252 414e 5459 0a0a 2020   NO WARRANTY..  
│ │ │ │ │ -00013bb0: 312e 2042 4543 4155 5345 2054 4845 2050  1. BECAUSE THE P
│ │ │ │ │ -00013bc0: 524f 4752 414d 2049 5320 4c49 4345 4e53  ROGRAM IS LICENS
│ │ │ │ │ -00013bd0: 4544 2046 5245 4520 4f46 2043 4841 5247  ED FREE OF CHARG
│ │ │ │ │ -00013be0: 452c 2054 4845 5245 2049 5320 4e4f 0a20  E, THERE IS NO. 
│ │ │ │ │ -00013bf0: 2020 2020 5741 5252 414e 5459 2046 4f52      WARRANTY FOR
│ │ │ │ │ -00013c00: 2054 4845 2050 524f 4752 414d 2c20 544f   THE PROGRAM, TO
│ │ │ │ │ -00013c10: 2054 4845 2045 5854 454e 5420 5045 524d   THE EXTENT PERM
│ │ │ │ │ -00013c20: 4954 5445 4420 4259 2041 5050 4c49 4341  ITTED BY APPLICA
│ │ │ │ │ -00013c30: 424c 450a 2020 2020 204c 4157 2e20 4558  BLE.     LAW. EX
│ │ │ │ │ -00013c40: 4345 5054 2057 4845 4e20 4f54 4845 5257  CEPT WHEN OTHERW
│ │ │ │ │ -00013c50: 4953 4520 5354 4154 4544 2049 4e20 5752  ISE STATED IN WR
│ │ │ │ │ -00013c60: 4954 494e 4720 5448 4520 434f 5059 5249  ITING THE COPYRI
│ │ │ │ │ -00013c70: 4748 5420 484f 4c44 4552 530a 2020 2020  GHT HOLDERS.    
│ │ │ │ │ -00013c80: 2041 4e44 2f4f 5220 4f54 4845 5220 5041   AND/OR OTHER PA
│ │ │ │ │ -00013c90: 5254 4945 5320 5052 4f56 4944 4520 5448  RTIES PROVIDE TH
│ │ │ │ │ -00013ca0: 4520 5052 4f47 5241 4d20 2241 5320 4953  E PROGRAM "AS IS
│ │ │ │ │ -00013cb0: 2220 5749 5448 4f55 5420 5741 5252 414e  " WITHOUT WARRAN
│ │ │ │ │ -00013cc0: 5459 0a20 2020 2020 4f46 2041 4e59 204b  TY.     OF ANY K
│ │ │ │ │ -00013cd0: 494e 442c 2045 4954 4845 5220 4558 5052  IND, EITHER EXPR
│ │ │ │ │ -00013ce0: 4553 5345 4420 4f52 2049 4d50 4c49 4544  ESSED OR IMPLIED
│ │ │ │ │ -00013cf0: 2c20 494e 434c 5544 494e 472c 2042 5554  , INCLUDING, BUT
│ │ │ │ │ -00013d00: 204e 4f54 0a20 2020 2020 4c49 4d49 5445   NOT.     LIMITE
│ │ │ │ │ -00013d10: 4420 544f 2c20 5448 4520 494d 504c 4945  D TO, THE IMPLIE
│ │ │ │ │ -00013d20: 4420 5741 5252 414e 5449 4553 204f 4620  D WARRANTIES OF 
│ │ │ │ │ -00013d30: 4d45 5243 4841 4e54 4142 494c 4954 5920  MERCHANTABILITY 
│ │ │ │ │ -00013d40: 414e 4420 4649 544e 4553 530a 2020 2020  AND FITNESS.    
│ │ │ │ │ -00013d50: 2046 4f52 2041 2050 4152 5449 4355 4c41   FOR A PARTICULA
│ │ │ │ │ -00013d60: 5220 5055 5250 4f53 452e 2054 4845 2045  R PURPOSE. THE E
│ │ │ │ │ -00013d70: 4e54 4952 4520 5249 534b 2041 5320 544f  NTIRE RISK AS TO
│ │ │ │ │ -00013d80: 2054 4845 2051 5541 4c49 5459 2041 4e44   THE QUALITY AND
│ │ │ │ │ -00013d90: 0a20 2020 2020 5045 5246 4f52 4d41 4e43  .     PERFORMANC
│ │ │ │ │ -00013da0: 4520 4f46 2054 4845 2050 524f 4752 414d  E OF THE PROGRAM
│ │ │ │ │ -00013db0: 2049 5320 5749 5448 2059 4f55 2e20 5348   IS WITH YOU. SH
│ │ │ │ │ -00013dc0: 4f55 4c44 2054 4845 2050 524f 4752 414d  OULD THE PROGRAM
│ │ │ │ │ -00013dd0: 2050 524f 5645 0a20 2020 2020 4445 4645   PROVE.     DEFE
│ │ │ │ │ -00013de0: 4354 4956 452c 2059 4f55 2041 5353 554d  CTIVE, YOU ASSUM
│ │ │ │ │ -00013df0: 4520 5448 4520 434f 5354 204f 4620 414c  E THE COST OF AL
│ │ │ │ │ -00013e00: 4c20 4e45 4345 5353 4152 5920 5345 5256  L NECESSARY SERV
│ │ │ │ │ -00013e10: 4943 494e 472c 2052 4550 4149 520a 2020  ICING, REPAIR.  
│ │ │ │ │ -00013e20: 2020 204f 5220 434f 5252 4543 5449 4f4e     OR CORRECTION
│ │ │ │ │ -00013e30: 2e0a 0a20 2032 2e20 494e 204e 4f20 4556  ...  2. IN NO EV
│ │ │ │ │ -00013e40: 454e 5420 554e 4c45 5353 2052 4551 5549  ENT UNLESS REQUI
│ │ │ │ │ -00013e50: 5245 4420 4259 2041 5050 4c49 4341 424c  RED BY APPLICABL
│ │ │ │ │ -00013e60: 4520 4c41 5720 4f52 2041 4752 4545 4420  E LAW OR AGREED 
│ │ │ │ │ -00013e70: 544f 2049 4e0a 2020 2020 2057 5249 5449  TO IN.     WRITI
│ │ │ │ │ -00013e80: 4e47 2057 494c 4c20 414e 5920 434f 5059  NG WILL ANY COPY
│ │ │ │ │ -00013e90: 5249 4748 5420 484f 4c44 4552 2c20 4f52  RIGHT HOLDER, OR
│ │ │ │ │ -00013ea0: 2041 4e59 204f 5448 4552 2050 4152 5459   ANY OTHER PARTY
│ │ │ │ │ -00013eb0: 2057 484f 204d 4159 0a20 2020 2020 4d4f   WHO MAY.     MO
│ │ │ │ │ -00013ec0: 4449 4659 2041 4e44 2f4f 5220 5245 4449  DIFY AND/OR REDI
│ │ │ │ │ -00013ed0: 5354 5249 4255 5445 2054 4845 2050 524f  STRIBUTE THE PRO
│ │ │ │ │ -00013ee0: 4752 414d 2041 5320 5045 524d 4954 5445  GRAM AS PERMITTE
│ │ │ │ │ -00013ef0: 4420 4142 4f56 452c 2042 450a 2020 2020  D ABOVE, BE.    
│ │ │ │ │ -00013f00: 204c 4941 424c 4520 544f 2059 4f55 2046   LIABLE TO YOU F
│ │ │ │ │ -00013f10: 4f52 2044 414d 4147 4553 2c20 494e 434c  OR DAMAGES, INCL
│ │ │ │ │ -00013f20: 5544 494e 4720 414e 5920 4745 4e45 5241  UDING ANY GENERA
│ │ │ │ │ -00013f30: 4c2c 2053 5045 4349 414c 2c0a 2020 2020  L, SPECIAL,.    
│ │ │ │ │ -00013f40: 2049 4e43 4944 454e 5441 4c20 4f52 2043   INCIDENTAL OR C
│ │ │ │ │ -00013f50: 4f4e 5345 5155 454e 5449 414c 2044 414d  ONSEQUENTIAL DAM
│ │ │ │ │ -00013f60: 4147 4553 2041 5249 5349 4e47 204f 5554  AGES ARISING OUT
│ │ │ │ │ -00013f70: 204f 4620 5448 4520 5553 4520 4f52 0a20   OF THE USE OR. 
│ │ │ │ │ -00013f80: 2020 2020 494e 4142 494c 4954 5920 544f      INABILITY TO
│ │ │ │ │ -00013f90: 2055 5345 2054 4845 2050 524f 4752 414d   USE THE PROGRAM
│ │ │ │ │ -00013fa0: 2028 494e 434c 5544 494e 4720 4255 5420   (INCLUDING BUT 
│ │ │ │ │ -00013fb0: 4e4f 5420 4c49 4d49 5445 4420 544f 204c  NOT LIMITED TO L
│ │ │ │ │ -00013fc0: 4f53 5320 4f46 0a20 2020 2020 4441 5441  OSS OF.     DATA
│ │ │ │ │ -00013fd0: 204f 5220 4441 5441 2042 4549 4e47 2052   OR DATA BEING R
│ │ │ │ │ -00013fe0: 454e 4445 5245 4420 494e 4143 4355 5241  ENDERED INACCURA
│ │ │ │ │ -00013ff0: 5445 204f 5220 4c4f 5353 4553 2053 5553  TE OR LOSSES SUS
│ │ │ │ │ -00014000: 5441 494e 4544 2042 5920 594f 550a 2020  TAINED BY YOU.  
│ │ │ │ │ -00014010: 2020 204f 5220 5448 4952 4420 5041 5254     OR THIRD PART
│ │ │ │ │ -00014020: 4945 5320 4f52 2041 2046 4149 4c55 5245  IES OR A FAILURE
│ │ │ │ │ -00014030: 204f 4620 5448 4520 5052 4f47 5241 4d20   OF THE PROGRAM 
│ │ │ │ │ -00014040: 544f 204f 5045 5241 5445 2057 4954 4820  TO OPERATE WITH 
│ │ │ │ │ -00014050: 414e 590a 2020 2020 204f 5448 4552 2050  ANY.     OTHER P
│ │ │ │ │ -00014060: 524f 4752 414d 5329 2c20 4556 454e 2049  ROGRAMS), EVEN I
│ │ │ │ │ -00014070: 4620 5355 4348 2048 4f4c 4445 5220 4f52  F SUCH HOLDER OR
│ │ │ │ │ -00014080: 204f 5448 4552 2050 4152 5459 2048 4153   OTHER PARTY HAS
│ │ │ │ │ -00014090: 2042 4545 4e0a 2020 2020 2041 4456 4953   BEEN.     ADVIS
│ │ │ │ │ -000140a0: 4544 204f 4620 5448 4520 504f 5353 4942  ED OF THE POSSIB
│ │ │ │ │ -000140b0: 494c 4954 5920 4f46 2053 5543 4820 4441  ILITY OF SUCH DA
│ │ │ │ │ -000140c0: 4d41 4745 532e 0a0a 2020 2020 2020 2020  MAGES...        
│ │ │ │ │ -000140d0: 2020 2020 2020 2020 2020 2020 2020 454e                EN
│ │ │ │ │ -000140e0: 4420 4f46 2054 4552 4d53 2041 4e44 2043  D OF TERMS AND C
│ │ │ │ │ -000140f0: 4f4e 4449 5449 4f4e 530a 0a41 2e32 2041  ONDITIONS..A.2 A
│ │ │ │ │ -00014100: 7070 656e 6469 783a 2048 6f77 2074 6f20  ppendix: How to 
│ │ │ │ │ -00014110: 4170 706c 7920 5468 6573 6520 5465 726d  Apply These Term
│ │ │ │ │ -00014120: 7320 746f 2059 6f75 7220 4e65 7720 5072  s to Your New Pr
│ │ │ │ │ -00014130: 6f67 7261 6d73 0a3d 3d3d 3d3d 3d3d 3d3d  ograms.=========
│ │ │ │ │ +00010d30: 2020 474e 5520 4745 4e45 5241 4c20 5055    GNU GENERAL PU
│ │ │ │ │ +00010d40: 424c 4943 204c 4943 454e 5345 2076 322b  BLIC LICENSE v2+
│ │ │ │ │ +00010d50: 0a20 2020 2054 4552 4d53 2041 4e44 2043  .    TERMS AND C
│ │ │ │ │ +00010d60: 4f4e 4449 5449 4f4e 5320 464f 5220 434f  ONDITIONS FOR CO
│ │ │ │ │ +00010d70: 5059 494e 472c 2044 4953 5452 4942 5554  PYING, DISTRIBUT
│ │ │ │ │ +00010d80: 494f 4e20 414e 4420 4d4f 4449 4649 4341  ION AND MODIFICA
│ │ │ │ │ +00010d90: 5449 4f4e 0a0a 2020 302e 2054 6869 7320  TION..  0. This 
│ │ │ │ │ +00010da0: 4c69 6365 6e73 6520 6170 706c 6965 7320  License applies 
│ │ │ │ │ +00010db0: 746f 2061 6e79 2070 726f 6772 616d 206f  to any program o
│ │ │ │ │ +00010dc0: 7220 6f74 6865 7220 776f 726b 2077 6869  r other work whi
│ │ │ │ │ +00010dd0: 6368 2063 6f6e 7461 696e 7320 610a 2020  ch contains a.  
│ │ │ │ │ +00010de0: 2020 206e 6f74 6963 6520 706c 6163 6564     notice placed
│ │ │ │ │ +00010df0: 2062 7920 7468 6520 636f 7079 7269 6768   by the copyrigh
│ │ │ │ │ +00010e00: 7420 686f 6c64 6572 2073 6179 696e 6720  t holder saying 
│ │ │ │ │ +00010e10: 6974 206d 6179 2062 6520 6469 7374 7269  it may be distri
│ │ │ │ │ +00010e20: 6275 7465 640a 2020 2020 2075 6e64 6572  buted.     under
│ │ │ │ │ +00010e30: 2074 6865 2074 6572 6d73 206f 6620 7468   the terms of th
│ │ │ │ │ +00010e40: 6973 2047 656e 6572 616c 2050 7562 6c69  is General Publi
│ │ │ │ │ +00010e50: 6320 4c69 6365 6e73 652e 2020 5468 6520  c License.  The 
│ │ │ │ │ +00010e60: 2250 726f 6772 616d 222c 0a20 2020 2020  "Program",.     
│ │ │ │ │ +00010e70: 6265 6c6f 772c 2072 6566 6572 7320 746f  below, refers to
│ │ │ │ │ +00010e80: 2061 6e79 2073 7563 6820 7072 6f67 7261   any such progra
│ │ │ │ │ +00010e90: 6d20 6f72 2077 6f72 6b2c 2061 6e64 2061  m or work, and a
│ │ │ │ │ +00010ea0: 2022 776f 726b 2062 6173 6564 206f 6e20   "work based on 
│ │ │ │ │ +00010eb0: 7468 650a 2020 2020 2050 726f 6772 616d  the.     Program
│ │ │ │ │ +00010ec0: 2220 6d65 616e 7320 6569 7468 6572 2074  " means either t
│ │ │ │ │ +00010ed0: 6865 2050 726f 6772 616d 206f 7220 616e  he Program or an
│ │ │ │ │ +00010ee0: 7920 6465 7269 7661 7469 7665 2077 6f72  y derivative wor
│ │ │ │ │ +00010ef0: 6b20 756e 6465 720a 2020 2020 2063 6f70  k under.     cop
│ │ │ │ │ +00010f00: 7972 6967 6874 206c 6177 3a20 7468 6174  yright law: that
│ │ │ │ │ +00010f10: 2069 7320 746f 2073 6179 2c20 6120 776f   is to say, a wo
│ │ │ │ │ +00010f20: 726b 2063 6f6e 7461 696e 696e 6720 7468  rk containing th
│ │ │ │ │ +00010f30: 6520 5072 6f67 7261 6d20 6f72 2061 0a20  e Program or a. 
│ │ │ │ │ +00010f40: 2020 2020 706f 7274 696f 6e20 6f66 2069      portion of i
│ │ │ │ │ +00010f50: 742c 2065 6974 6865 7220 7665 7262 6174  t, either verbat
│ │ │ │ │ +00010f60: 696d 206f 7220 7769 7468 206d 6f64 6966  im or with modif
│ │ │ │ │ +00010f70: 6963 6174 696f 6e73 2061 6e64 2f6f 720a  ications and/or.
│ │ │ │ │ +00010f80: 2020 2020 2074 7261 6e73 6c61 7465 6420       translated 
│ │ │ │ │ +00010f90: 696e 746f 2061 6e6f 7468 6572 206c 616e  into another lan
│ │ │ │ │ +00010fa0: 6775 6167 652e 2020 2848 6572 6569 6e61  guage.  (Hereina
│ │ │ │ │ +00010fb0: 6674 6572 2c20 7472 616e 736c 6174 696f  fter, translatio
│ │ │ │ │ +00010fc0: 6e20 6973 0a20 2020 2020 696e 636c 7564  n is.     includ
│ │ │ │ │ +00010fd0: 6564 2077 6974 686f 7574 206c 696d 6974  ed without limit
│ │ │ │ │ +00010fe0: 6174 696f 6e20 696e 2074 6865 2074 6572  ation in the ter
│ │ │ │ │ +00010ff0: 6d20 226d 6f64 6966 6963 6174 696f 6e22  m "modification"
│ │ │ │ │ +00011000: 2e29 2020 4561 6368 0a20 2020 2020 6c69  .)  Each.     li
│ │ │ │ │ +00011010: 6365 6e73 6565 2069 7320 6164 6472 6573  censee is addres
│ │ │ │ │ +00011020: 7365 6420 6173 2022 796f 7522 2e0a 0a20  sed as "you"... 
│ │ │ │ │ +00011030: 2020 2020 4163 7469 7669 7469 6573 206f      Activities o
│ │ │ │ │ +00011040: 7468 6572 2074 6861 6e20 636f 7079 696e  ther than copyin
│ │ │ │ │ +00011050: 672c 2064 6973 7472 6962 7574 696f 6e20  g, distribution 
│ │ │ │ │ +00011060: 616e 6420 6d6f 6469 6669 6361 7469 6f6e  and modification
│ │ │ │ │ +00011070: 2061 7265 0a20 2020 2020 6e6f 7420 636f   are.     not co
│ │ │ │ │ +00011080: 7665 7265 6420 6279 2074 6869 7320 4c69  vered by this Li
│ │ │ │ │ +00011090: 6365 6e73 653b 2074 6865 7920 6172 6520  cense; they are 
│ │ │ │ │ +000110a0: 6f75 7473 6964 6520 6974 7320 7363 6f70  outside its scop
│ │ │ │ │ +000110b0: 652e 2020 5468 6520 6163 740a 2020 2020  e.  The act.    
│ │ │ │ │ +000110c0: 206f 6620 7275 6e6e 696e 6720 7468 6520   of running the 
│ │ │ │ │ +000110d0: 5072 6f67 7261 6d20 6973 206e 6f74 2072  Program is not r
│ │ │ │ │ +000110e0: 6573 7472 6963 7465 642c 2061 6e64 2074  estricted, and t
│ │ │ │ │ +000110f0: 6865 206f 7574 7075 7420 6672 6f6d 2074  he output from t
│ │ │ │ │ +00011100: 6865 0a20 2020 2020 5072 6f67 7261 6d20  he.     Program 
│ │ │ │ │ +00011110: 6973 2063 6f76 6572 6564 206f 6e6c 7920  is covered only 
│ │ │ │ │ +00011120: 6966 2069 7473 2063 6f6e 7465 6e74 7320  if its contents 
│ │ │ │ │ +00011130: 636f 6e73 7469 7475 7465 2061 2077 6f72  constitute a wor
│ │ │ │ │ +00011140: 6b20 6261 7365 6420 6f6e 0a20 2020 2020  k based on.     
│ │ │ │ │ +00011150: 7468 6520 5072 6f67 7261 6d20 2869 6e64  the Program (ind
│ │ │ │ │ +00011160: 6570 656e 6465 6e74 206f 6620 6861 7669  ependent of havi
│ │ │ │ │ +00011170: 6e67 2062 6565 6e20 6d61 6465 2062 7920  ng been made by 
│ │ │ │ │ +00011180: 7275 6e6e 696e 6720 7468 650a 2020 2020  running the.    
│ │ │ │ │ +00011190: 2050 726f 6772 616d 292e 2020 5768 6574   Program).  Whet
│ │ │ │ │ +000111a0: 6865 7220 7468 6174 2069 7320 7472 7565  her that is true
│ │ │ │ │ +000111b0: 2064 6570 656e 6473 206f 6e20 7768 6174   depends on what
│ │ │ │ │ +000111c0: 2074 6865 2050 726f 6772 616d 2064 6f65   the Program doe
│ │ │ │ │ +000111d0: 732e 0a0a 2020 312e 2059 6f75 206d 6179  s...  1. You may
│ │ │ │ │ +000111e0: 2063 6f70 7920 616e 6420 6469 7374 7269   copy and distri
│ │ │ │ │ +000111f0: 6275 7465 2076 6572 6261 7469 6d20 636f  bute verbatim co
│ │ │ │ │ +00011200: 7069 6573 206f 6620 7468 6520 5072 6f67  pies of the Prog
│ │ │ │ │ +00011210: 7261 6d27 7320 736f 7572 6365 0a20 2020  ram's source.   
│ │ │ │ │ +00011220: 2020 636f 6465 2061 7320 796f 7520 7265    code as you re
│ │ │ │ │ +00011230: 6365 6976 6520 6974 2c20 696e 2061 6e79  ceive it, in any
│ │ │ │ │ +00011240: 206d 6564 6975 6d2c 2070 726f 7669 6465   medium, provide
│ │ │ │ │ +00011250: 6420 7468 6174 2079 6f75 0a20 2020 2020  d that you.     
│ │ │ │ │ +00011260: 636f 6e73 7069 6375 6f75 736c 7920 616e  conspicuously an
│ │ │ │ │ +00011270: 6420 6170 7072 6f70 7269 6174 656c 7920  d appropriately 
│ │ │ │ │ +00011280: 7075 626c 6973 6820 6f6e 2065 6163 6820  publish on each 
│ │ │ │ │ +00011290: 636f 7079 2061 6e20 6170 7072 6f70 7269  copy an appropri
│ │ │ │ │ +000112a0: 6174 650a 2020 2020 2063 6f70 7972 6967  ate.     copyrig
│ │ │ │ │ +000112b0: 6874 206e 6f74 6963 6520 616e 6420 6469  ht notice and di
│ │ │ │ │ +000112c0: 7363 6c61 696d 6572 206f 6620 7761 7272  sclaimer of warr
│ │ │ │ │ +000112d0: 616e 7479 3b20 6b65 6570 2069 6e74 6163  anty; keep intac
│ │ │ │ │ +000112e0: 7420 616c 6c20 7468 650a 2020 2020 206e  t all the.     n
│ │ │ │ │ +000112f0: 6f74 6963 6573 2074 6861 7420 7265 6665  otices that refe
│ │ │ │ │ +00011300: 7220 746f 2074 6869 7320 4c69 6365 6e73  r to this Licens
│ │ │ │ │ +00011310: 6520 616e 6420 746f 2074 6865 2061 6273  e and to the abs
│ │ │ │ │ +00011320: 656e 6365 206f 6620 616e 790a 2020 2020  ence of any.    
│ │ │ │ │ +00011330: 2077 6172 7261 6e74 793b 2061 6e64 2067   warranty; and g
│ │ │ │ │ +00011340: 6976 6520 616e 7920 6f74 6865 7220 7265  ive any other re
│ │ │ │ │ +00011350: 6369 7069 656e 7473 206f 6620 7468 6520  cipients of the 
│ │ │ │ │ +00011360: 5072 6f67 7261 6d20 6120 636f 7079 206f  Program a copy o
│ │ │ │ │ +00011370: 660a 2020 2020 2074 6869 7320 4c69 6365  f.     this Lice
│ │ │ │ │ +00011380: 6e73 6520 616c 6f6e 6720 7769 7468 2074  nse along with t
│ │ │ │ │ +00011390: 6865 2050 726f 6772 616d 2e0a 0a20 2020  he Program...   
│ │ │ │ │ +000113a0: 2020 596f 7520 6d61 7920 6368 6172 6765    You may charge
│ │ │ │ │ +000113b0: 2061 2066 6565 2066 6f72 2074 6865 2070   a fee for the p
│ │ │ │ │ +000113c0: 6879 7369 6361 6c20 6163 7420 6f66 2074  hysical act of t
│ │ │ │ │ +000113d0: 7261 6e73 6665 7272 696e 6720 6120 636f  ransferring a co
│ │ │ │ │ +000113e0: 7079 2c0a 2020 2020 2061 6e64 2079 6f75  py,.     and you
│ │ │ │ │ +000113f0: 206d 6179 2061 7420 796f 7572 206f 7074   may at your opt
│ │ │ │ │ +00011400: 696f 6e20 6f66 6665 7220 7761 7272 616e  ion offer warran
│ │ │ │ │ +00011410: 7479 2070 726f 7465 6374 696f 6e20 696e  ty protection in
│ │ │ │ │ +00011420: 2065 7863 6861 6e67 650a 2020 2020 2066   exchange.     f
│ │ │ │ │ +00011430: 6f72 2061 2066 6565 2e0a 0a20 2032 2e20  or a fee...  2. 
│ │ │ │ │ +00011440: 596f 7520 6d61 7920 6d6f 6469 6679 2079  You may modify y
│ │ │ │ │ +00011450: 6f75 7220 636f 7079 206f 7220 636f 7069  our copy or copi
│ │ │ │ │ +00011460: 6573 206f 6620 7468 6520 5072 6f67 7261  es of the Progra
│ │ │ │ │ +00011470: 6d20 6f72 2061 6e79 2070 6f72 7469 6f6e  m or any portion
│ │ │ │ │ +00011480: 206f 660a 2020 2020 2069 742c 2074 6875   of.     it, thu
│ │ │ │ │ +00011490: 7320 666f 726d 696e 6720 6120 776f 726b  s forming a work
│ │ │ │ │ +000114a0: 2062 6173 6564 206f 6e20 7468 6520 5072   based on the Pr
│ │ │ │ │ +000114b0: 6f67 7261 6d2c 2061 6e64 2063 6f70 7920  ogram, and copy 
│ │ │ │ │ +000114c0: 616e 640a 2020 2020 2064 6973 7472 6962  and.     distrib
│ │ │ │ │ +000114d0: 7574 6520 7375 6368 206d 6f64 6966 6963  ute such modific
│ │ │ │ │ +000114e0: 6174 696f 6e73 206f 7220 776f 726b 2075  ations or work u
│ │ │ │ │ +000114f0: 6e64 6572 2074 6865 2074 6572 6d73 206f  nder the terms o
│ │ │ │ │ +00011500: 6620 5365 6374 696f 6e20 310a 2020 2020  f Section 1.    
│ │ │ │ │ +00011510: 2061 626f 7665 2c20 7072 6f76 6964 6564   above, provided
│ │ │ │ │ +00011520: 2074 6861 7420 796f 7520 616c 736f 206d   that you also m
│ │ │ │ │ +00011530: 6565 7420 616c 6c20 6f66 2074 6865 7365  eet all of these
│ │ │ │ │ +00011540: 2063 6f6e 6469 7469 6f6e 733a 0a0a 2020   conditions:..  
│ │ │ │ │ +00011550: 2020 2020 2061 2e20 596f 7520 6d75 7374       a. You must
│ │ │ │ │ +00011560: 2063 6175 7365 2074 6865 206d 6f64 6966   cause the modif
│ │ │ │ │ +00011570: 6965 6420 6669 6c65 7320 746f 2063 6172  ied files to car
│ │ │ │ │ +00011580: 7279 2070 726f 6d69 6e65 6e74 206e 6f74  ry prominent not
│ │ │ │ │ +00011590: 6963 6573 0a20 2020 2020 2020 2020 2073  ices.          s
│ │ │ │ │ +000115a0: 7461 7469 6e67 2074 6861 7420 796f 7520  tating that you 
│ │ │ │ │ +000115b0: 6368 616e 6765 6420 7468 6520 6669 6c65  changed the file
│ │ │ │ │ +000115c0: 7320 616e 6420 7468 6520 6461 7465 206f  s and the date o
│ │ │ │ │ +000115d0: 6620 616e 7920 6368 616e 6765 2e0a 0a20  f any change... 
│ │ │ │ │ +000115e0: 2020 2020 2020 622e 2059 6f75 206d 7573        b. You mus
│ │ │ │ │ +000115f0: 7420 6361 7573 6520 616e 7920 776f 726b  t cause any work
│ │ │ │ │ +00011600: 2074 6861 7420 796f 7520 6469 7374 7269   that you distri
│ │ │ │ │ +00011610: 6275 7465 206f 7220 7075 626c 6973 682c  bute or publish,
│ │ │ │ │ +00011620: 2074 6861 740a 2020 2020 2020 2020 2020   that.          
│ │ │ │ │ +00011630: 696e 2077 686f 6c65 206f 7220 696e 2070  in whole or in p
│ │ │ │ │ +00011640: 6172 7420 636f 6e74 6169 6e73 206f 7220  art contains or 
│ │ │ │ │ +00011650: 6973 2064 6572 6976 6564 2066 726f 6d20  is derived from 
│ │ │ │ │ +00011660: 7468 6520 5072 6f67 7261 6d20 6f72 0a20  the Program or. 
│ │ │ │ │ +00011670: 2020 2020 2020 2020 2061 6e79 2070 6172           any par
│ │ │ │ │ +00011680: 7420 7468 6572 656f 662c 2074 6f20 6265  t thereof, to be
│ │ │ │ │ +00011690: 206c 6963 656e 7365 6420 6173 2061 2077   licensed as a w
│ │ │ │ │ +000116a0: 686f 6c65 2061 7420 6e6f 2063 6861 7267  hole at no charg
│ │ │ │ │ +000116b0: 6520 746f 0a20 2020 2020 2020 2020 2061  e to.          a
│ │ │ │ │ +000116c0: 6c6c 2074 6869 7264 2070 6172 7469 6573  ll third parties
│ │ │ │ │ +000116d0: 2075 6e64 6572 2074 6865 2074 6572 6d73   under the terms
│ │ │ │ │ +000116e0: 206f 6620 7468 6973 204c 6963 656e 7365   of this License
│ │ │ │ │ +000116f0: 2e0a 0a20 2020 2020 2020 632e 2049 6620  ...       c. If 
│ │ │ │ │ +00011700: 7468 6520 6d6f 6469 6669 6564 2070 726f  the modified pro
│ │ │ │ │ +00011710: 6772 616d 206e 6f72 6d61 6c6c 7920 7265  gram normally re
│ │ │ │ │ +00011720: 6164 7320 636f 6d6d 616e 6473 2069 6e74  ads commands int
│ │ │ │ │ +00011730: 6572 6163 7469 7665 6c79 0a20 2020 2020  eractively.     
│ │ │ │ │ +00011740: 2020 2020 2077 6865 6e20 7275 6e2c 2079       when run, y
│ │ │ │ │ +00011750: 6f75 206d 7573 7420 6361 7573 6520 6974  ou must cause it
│ │ │ │ │ +00011760: 2c20 7768 656e 2073 7461 7274 6564 2072  , when started r
│ │ │ │ │ +00011770: 756e 6e69 6e67 2066 6f72 2073 7563 680a  unning for such.
│ │ │ │ │ +00011780: 2020 2020 2020 2020 2020 696e 7465 7261            intera
│ │ │ │ │ +00011790: 6374 6976 6520 7573 6520 696e 2074 6865  ctive use in the
│ │ │ │ │ +000117a0: 206d 6f73 7420 6f72 6469 6e61 7279 2077   most ordinary w
│ │ │ │ │ +000117b0: 6179 2c20 746f 2070 7269 6e74 206f 7220  ay, to print or 
│ │ │ │ │ +000117c0: 6469 7370 6c61 790a 2020 2020 2020 2020  display.        
│ │ │ │ │ +000117d0: 2020 616e 2061 6e6e 6f75 6e63 656d 656e    an announcemen
│ │ │ │ │ +000117e0: 7420 696e 636c 7564 696e 6720 616e 2061  t including an a
│ │ │ │ │ +000117f0: 7070 726f 7072 6961 7465 2063 6f70 7972  ppropriate copyr
│ │ │ │ │ +00011800: 6967 6874 206e 6f74 6963 6520 616e 640a  ight notice and.
│ │ │ │ │ +00011810: 2020 2020 2020 2020 2020 6120 6e6f 7469            a noti
│ │ │ │ │ +00011820: 6365 2074 6861 7420 7468 6572 6520 6973  ce that there is
│ │ │ │ │ +00011830: 206e 6f20 7761 7272 616e 7479 2028 6f72   no warranty (or
│ │ │ │ │ +00011840: 2065 6c73 652c 2073 6179 696e 6720 7468   else, saying th
│ │ │ │ │ +00011850: 6174 2079 6f75 0a20 2020 2020 2020 2020  at you.         
│ │ │ │ │ +00011860: 2070 726f 7669 6465 2061 2077 6172 7261   provide a warra
│ │ │ │ │ +00011870: 6e74 7929 2061 6e64 2074 6861 7420 7573  nty) and that us
│ │ │ │ │ +00011880: 6572 7320 6d61 7920 7265 6469 7374 7269  ers may redistri
│ │ │ │ │ +00011890: 6275 7465 2074 6865 0a20 2020 2020 2020  bute the.       
│ │ │ │ │ +000118a0: 2020 2070 726f 6772 616d 2075 6e64 6572     program under
│ │ │ │ │ +000118b0: 2074 6865 7365 2063 6f6e 6469 7469 6f6e   these condition
│ │ │ │ │ +000118c0: 732c 2061 6e64 2074 656c 6c69 6e67 2074  s, and telling t
│ │ │ │ │ +000118d0: 6865 2075 7365 7220 686f 7720 746f 0a20  he user how to. 
│ │ │ │ │ +000118e0: 2020 2020 2020 2020 2076 6965 7720 6120           view a 
│ │ │ │ │ +000118f0: 636f 7079 206f 6620 7468 6973 204c 6963  copy of this Lic
│ │ │ │ │ +00011900: 656e 7365 2e20 2028 4578 6365 7074 696f  ense.  (Exceptio
│ │ │ │ │ +00011910: 6e3a 2069 6620 7468 6520 5072 6f67 7261  n: if the Progra
│ │ │ │ │ +00011920: 6d0a 2020 2020 2020 2020 2020 6974 7365  m.          itse
│ │ │ │ │ +00011930: 6c66 2069 7320 696e 7465 7261 6374 6976  lf is interactiv
│ │ │ │ │ +00011940: 6520 6275 7420 646f 6573 206e 6f74 206e  e but does not n
│ │ │ │ │ +00011950: 6f72 6d61 6c6c 7920 7072 696e 7420 7375  ormally print su
│ │ │ │ │ +00011960: 6368 2061 6e0a 2020 2020 2020 2020 2020  ch an.          
│ │ │ │ │ +00011970: 616e 6e6f 756e 6365 6d65 6e74 2c20 796f  announcement, yo
│ │ │ │ │ +00011980: 7572 2077 6f72 6b20 6261 7365 6420 6f6e  ur work based on
│ │ │ │ │ +00011990: 2074 6865 2050 726f 6772 616d 2069 7320   the Program is 
│ │ │ │ │ +000119a0: 6e6f 7420 7265 7175 6972 6564 0a20 2020  not required.   
│ │ │ │ │ +000119b0: 2020 2020 2020 2074 6f20 7072 696e 7420         to print 
│ │ │ │ │ +000119c0: 616e 2061 6e6e 6f75 6e63 656d 656e 742e  an announcement.
│ │ │ │ │ +000119d0: 290a 0a20 2020 2020 5468 6573 6520 7265  )..     These re
│ │ │ │ │ +000119e0: 7175 6972 656d 656e 7473 2061 7070 6c79  quirements apply
│ │ │ │ │ +000119f0: 2074 6f20 7468 6520 6d6f 6469 6669 6564   to the modified
│ │ │ │ │ +00011a00: 2077 6f72 6b20 6173 2061 2077 686f 6c65   work as a whole
│ │ │ │ │ +00011a10: 2e20 2049 660a 2020 2020 2069 6465 6e74  .  If.     ident
│ │ │ │ │ +00011a20: 6966 6961 626c 6520 7365 6374 696f 6e73  ifiable sections
│ │ │ │ │ +00011a30: 206f 6620 7468 6174 2077 6f72 6b20 6172   of that work ar
│ │ │ │ │ +00011a40: 6520 6e6f 7420 6465 7269 7665 6420 6672  e not derived fr
│ │ │ │ │ +00011a50: 6f6d 2074 6865 0a20 2020 2020 5072 6f67  om the.     Prog
│ │ │ │ │ +00011a60: 7261 6d2c 2061 6e64 2063 616e 2062 6520  ram, and can be 
│ │ │ │ │ +00011a70: 7265 6173 6f6e 6162 6c79 2063 6f6e 7369  reasonably consi
│ │ │ │ │ +00011a80: 6465 7265 6420 696e 6465 7065 6e64 656e  dered independen
│ │ │ │ │ +00011a90: 7420 616e 6420 7365 7061 7261 7465 0a20  t and separate. 
│ │ │ │ │ +00011aa0: 2020 2020 776f 726b 7320 696e 2074 6865      works in the
│ │ │ │ │ +00011ab0: 6d73 656c 7665 732c 2074 6865 6e20 7468  mselves, then th
│ │ │ │ │ +00011ac0: 6973 204c 6963 656e 7365 2c20 616e 6420  is License, and 
│ │ │ │ │ +00011ad0: 6974 7320 7465 726d 732c 2064 6f20 6e6f  its terms, do no
│ │ │ │ │ +00011ae0: 7420 6170 706c 790a 2020 2020 2074 6f20  t apply.     to 
│ │ │ │ │ +00011af0: 7468 6f73 6520 7365 6374 696f 6e73 2077  those sections w
│ │ │ │ │ +00011b00: 6865 6e20 796f 7520 6469 7374 7269 6275  hen you distribu
│ │ │ │ │ +00011b10: 7465 2074 6865 6d20 6173 2073 6570 6172  te them as separ
│ │ │ │ │ +00011b20: 6174 6520 776f 726b 732e 2020 4275 740a  ate works.  But.
│ │ │ │ │ +00011b30: 2020 2020 2077 6865 6e20 796f 7520 6469       when you di
│ │ │ │ │ +00011b40: 7374 7269 6275 7465 2074 6865 2073 616d  stribute the sam
│ │ │ │ │ +00011b50: 6520 7365 6374 696f 6e73 2061 7320 7061  e sections as pa
│ │ │ │ │ +00011b60: 7274 206f 6620 6120 7768 6f6c 6520 7768  rt of a whole wh
│ │ │ │ │ +00011b70: 6963 6820 6973 2061 0a20 2020 2020 776f  ich is a.     wo
│ │ │ │ │ +00011b80: 726b 2062 6173 6564 206f 6e20 7468 6520  rk based on the 
│ │ │ │ │ +00011b90: 5072 6f67 7261 6d2c 2074 6865 2064 6973  Program, the dis
│ │ │ │ │ +00011ba0: 7472 6962 7574 696f 6e20 6f66 2074 6865  tribution of the
│ │ │ │ │ +00011bb0: 2077 686f 6c65 206d 7573 7420 6265 206f   whole must be o
│ │ │ │ │ +00011bc0: 6e0a 2020 2020 2074 6865 2074 6572 6d73  n.     the terms
│ │ │ │ │ +00011bd0: 206f 6620 7468 6973 204c 6963 656e 7365   of this License
│ │ │ │ │ +00011be0: 2c20 7768 6f73 6520 7065 726d 6973 7369  , whose permissi
│ │ │ │ │ +00011bf0: 6f6e 7320 666f 7220 6f74 6865 7220 6c69  ons for other li
│ │ │ │ │ +00011c00: 6365 6e73 6565 730a 2020 2020 2065 7874  censees.     ext
│ │ │ │ │ +00011c10: 656e 6420 746f 2074 6865 2065 6e74 6972  end to the entir
│ │ │ │ │ +00011c20: 6520 7768 6f6c 652c 2061 6e64 2074 6875  e whole, and thu
│ │ │ │ │ +00011c30: 7320 746f 2065 6163 6820 616e 6420 6576  s to each and ev
│ │ │ │ │ +00011c40: 6572 7920 7061 7274 0a20 2020 2020 7265  ery part.     re
│ │ │ │ │ +00011c50: 6761 7264 6c65 7373 206f 6620 7768 6f20  gardless of who 
│ │ │ │ │ +00011c60: 7772 6f74 6520 6974 2e0a 0a20 2020 2020  wrote it...     
│ │ │ │ │ +00011c70: 5468 7573 2c20 6974 2069 7320 6e6f 7420  Thus, it is not 
│ │ │ │ │ +00011c80: 7468 6520 696e 7465 6e74 206f 6620 7468  the intent of th
│ │ │ │ │ +00011c90: 6973 2073 6563 7469 6f6e 2074 6f20 636c  is section to cl
│ │ │ │ │ +00011ca0: 6169 6d20 7269 6768 7473 206f 720a 2020  aim rights or.  
│ │ │ │ │ +00011cb0: 2020 2063 6f6e 7465 7374 2079 6f75 7220     contest your 
│ │ │ │ │ +00011cc0: 7269 6768 7473 2074 6f20 776f 726b 2077  rights to work w
│ │ │ │ │ +00011cd0: 7269 7474 656e 2065 6e74 6972 656c 7920  ritten entirely 
│ │ │ │ │ +00011ce0: 6279 2079 6f75 3b20 7261 7468 6572 2c20  by you; rather, 
│ │ │ │ │ +00011cf0: 7468 650a 2020 2020 2069 6e74 656e 7420  the.     intent 
│ │ │ │ │ +00011d00: 6973 2074 6f20 6578 6572 6369 7365 2074  is to exercise t
│ │ │ │ │ +00011d10: 6865 2072 6967 6874 2074 6f20 636f 6e74  he right to cont
│ │ │ │ │ +00011d20: 726f 6c20 7468 6520 6469 7374 7269 6275  rol the distribu
│ │ │ │ │ +00011d30: 7469 6f6e 206f 660a 2020 2020 2064 6572  tion of.     der
│ │ │ │ │ +00011d40: 6976 6174 6976 6520 6f72 2063 6f6c 6c65  ivative or colle
│ │ │ │ │ +00011d50: 6374 6976 6520 776f 726b 7320 6261 7365  ctive works base
│ │ │ │ │ +00011d60: 6420 6f6e 2074 6865 2050 726f 6772 616d  d on the Program
│ │ │ │ │ +00011d70: 2e0a 0a20 2020 2020 496e 2061 6464 6974  ...     In addit
│ │ │ │ │ +00011d80: 696f 6e2c 206d 6572 6520 6167 6772 6567  ion, mere aggreg
│ │ │ │ │ +00011d90: 6174 696f 6e20 6f66 2061 6e6f 7468 6572  ation of another
│ │ │ │ │ +00011da0: 2077 6f72 6b20 6e6f 7420 6261 7365 6420   work not based 
│ │ │ │ │ +00011db0: 6f6e 2074 6865 0a20 2020 2020 5072 6f67  on the.     Prog
│ │ │ │ │ +00011dc0: 7261 6d20 7769 7468 2074 6865 2050 726f  ram with the Pro
│ │ │ │ │ +00011dd0: 6772 616d 2028 6f72 2077 6974 6820 6120  gram (or with a 
│ │ │ │ │ +00011de0: 776f 726b 2062 6173 6564 206f 6e20 7468  work based on th
│ │ │ │ │ +00011df0: 6520 5072 6f67 7261 6d29 206f 6e20 610a  e Program) on a.
│ │ │ │ │ +00011e00: 2020 2020 2076 6f6c 756d 6520 6f66 2061       volume of a
│ │ │ │ │ +00011e10: 2073 746f 7261 6765 206f 7220 6469 7374   storage or dist
│ │ │ │ │ +00011e20: 7269 6275 7469 6f6e 206d 6564 6975 6d20  ribution medium 
│ │ │ │ │ +00011e30: 646f 6573 206e 6f74 2062 7269 6e67 2074  does not bring t
│ │ │ │ │ +00011e40: 6865 206f 7468 6572 0a20 2020 2020 776f  he other.     wo
│ │ │ │ │ +00011e50: 726b 2075 6e64 6572 2074 6865 2073 636f  rk under the sco
│ │ │ │ │ +00011e60: 7065 206f 6620 7468 6973 204c 6963 656e  pe of this Licen
│ │ │ │ │ +00011e70: 7365 2e0a 0a20 2033 2e20 596f 7520 6d61  se...  3. You ma
│ │ │ │ │ +00011e80: 7920 636f 7079 2061 6e64 2064 6973 7472  y copy and distr
│ │ │ │ │ +00011e90: 6962 7574 6520 7468 6520 5072 6f67 7261  ibute the Progra
│ │ │ │ │ +00011ea0: 6d20 286f 7220 6120 776f 726b 2062 6173  m (or a work bas
│ │ │ │ │ +00011eb0: 6564 206f 6e20 6974 2c0a 2020 2020 2075  ed on it,.     u
│ │ │ │ │ +00011ec0: 6e64 6572 2053 6563 7469 6f6e 2032 2920  nder Section 2) 
│ │ │ │ │ +00011ed0: 696e 206f 626a 6563 7420 636f 6465 206f  in object code o
│ │ │ │ │ +00011ee0: 7220 6578 6563 7574 6162 6c65 2066 6f72  r executable for
│ │ │ │ │ +00011ef0: 6d20 756e 6465 7220 7468 6520 7465 726d  m under the term
│ │ │ │ │ +00011f00: 730a 2020 2020 206f 6620 5365 6374 696f  s.     of Sectio
│ │ │ │ │ +00011f10: 6e73 2031 2061 6e64 2032 2061 626f 7665  ns 1 and 2 above
│ │ │ │ │ +00011f20: 2070 726f 7669 6465 6420 7468 6174 2079   provided that y
│ │ │ │ │ +00011f30: 6f75 2061 6c73 6f20 646f 206f 6e65 206f  ou also do one o
│ │ │ │ │ +00011f40: 6620 7468 650a 2020 2020 2066 6f6c 6c6f  f the.     follo
│ │ │ │ │ +00011f50: 7769 6e67 3a0a 0a20 2020 2020 2020 612e  wing:..       a.
│ │ │ │ │ +00011f60: 2041 6363 6f6d 7061 6e79 2069 7420 7769   Accompany it wi
│ │ │ │ │ +00011f70: 7468 2074 6865 2063 6f6d 706c 6574 6520  th the complete 
│ │ │ │ │ +00011f80: 636f 7272 6573 706f 6e64 696e 6720 6d61  corresponding ma
│ │ │ │ │ +00011f90: 6368 696e 652d 7265 6164 6162 6c65 0a20  chine-readable. 
│ │ │ │ │ +00011fa0: 2020 2020 2020 2020 2073 6f75 7263 6520           source 
│ │ │ │ │ +00011fb0: 636f 6465 2c20 7768 6963 6820 6d75 7374  code, which must
│ │ │ │ │ +00011fc0: 2062 6520 6469 7374 7269 6275 7465 6420   be distributed 
│ │ │ │ │ +00011fd0: 756e 6465 7220 7468 6520 7465 726d 7320  under the terms 
│ │ │ │ │ +00011fe0: 6f66 0a20 2020 2020 2020 2020 2053 6563  of.          Sec
│ │ │ │ │ +00011ff0: 7469 6f6e 7320 3120 616e 6420 3220 6162  tions 1 and 2 ab
│ │ │ │ │ +00012000: 6f76 6520 6f6e 2061 206d 6564 6975 6d20  ove on a medium 
│ │ │ │ │ +00012010: 6375 7374 6f6d 6172 696c 7920 7573 6564  customarily used
│ │ │ │ │ +00012020: 2066 6f72 0a20 2020 2020 2020 2020 2073   for.          s
│ │ │ │ │ +00012030: 6f66 7477 6172 6520 696e 7465 7263 6861  oftware intercha
│ │ │ │ │ +00012040: 6e67 653b 206f 722c 0a0a 2020 2020 2020  nge; or,..      
│ │ │ │ │ +00012050: 2062 2e20 4163 636f 6d70 616e 7920 6974   b. Accompany it
│ │ │ │ │ +00012060: 2077 6974 6820 6120 7772 6974 7465 6e20   with a written 
│ │ │ │ │ +00012070: 6f66 6665 722c 2076 616c 6964 2066 6f72  offer, valid for
│ │ │ │ │ +00012080: 2061 7420 6c65 6173 7420 7468 7265 650a   at least three.
│ │ │ │ │ +00012090: 2020 2020 2020 2020 2020 7965 6172 732c            years,
│ │ │ │ │ +000120a0: 2074 6f20 6769 7665 2061 6e79 2074 6869   to give any thi
│ │ │ │ │ +000120b0: 7264 2070 6172 7479 2c20 666f 7220 6120  rd party, for a 
│ │ │ │ │ +000120c0: 6368 6172 6765 206e 6f20 6d6f 7265 2074  charge no more t
│ │ │ │ │ +000120d0: 6861 6e20 796f 7572 0a20 2020 2020 2020  han your.       
│ │ │ │ │ +000120e0: 2020 2063 6f73 7420 6f66 2070 6879 7369     cost of physi
│ │ │ │ │ +000120f0: 6361 6c6c 7920 7065 7266 6f72 6d69 6e67  cally performing
│ │ │ │ │ +00012100: 2073 6f75 7263 6520 6469 7374 7269 6275   source distribu
│ │ │ │ │ +00012110: 7469 6f6e 2c20 6120 636f 6d70 6c65 7465  tion, a complete
│ │ │ │ │ +00012120: 0a20 2020 2020 2020 2020 206d 6163 6869  .          machi
│ │ │ │ │ +00012130: 6e65 2d72 6561 6461 626c 6520 636f 7079  ne-readable copy
│ │ │ │ │ +00012140: 206f 6620 7468 6520 636f 7272 6573 706f   of the correspo
│ │ │ │ │ +00012150: 6e64 696e 6720 736f 7572 6365 2063 6f64  nding source cod
│ │ │ │ │ +00012160: 652c 2074 6f20 6265 0a20 2020 2020 2020  e, to be.       
│ │ │ │ │ +00012170: 2020 2064 6973 7472 6962 7574 6564 2075     distributed u
│ │ │ │ │ +00012180: 6e64 6572 2074 6865 2074 6572 6d73 206f  nder the terms o
│ │ │ │ │ +00012190: 6620 5365 6374 696f 6e73 2031 2061 6e64  f Sections 1 and
│ │ │ │ │ +000121a0: 2032 2061 626f 7665 206f 6e20 610a 2020   2 above on a.  
│ │ │ │ │ +000121b0: 2020 2020 2020 2020 6d65 6469 756d 2063          medium c
│ │ │ │ │ +000121c0: 7573 746f 6d61 7269 6c79 2075 7365 6420  ustomarily used 
│ │ │ │ │ +000121d0: 666f 7220 736f 6674 7761 7265 2069 6e74  for software int
│ │ │ │ │ +000121e0: 6572 6368 616e 6765 3b20 6f72 2c0a 0a20  erchange; or,.. 
│ │ │ │ │ +000121f0: 2020 2020 2020 632e 2041 6363 6f6d 7061        c. Accompa
│ │ │ │ │ +00012200: 6e79 2069 7420 7769 7468 2074 6865 2069  ny it with the i
│ │ │ │ │ +00012210: 6e66 6f72 6d61 7469 6f6e 2079 6f75 2072  nformation you r
│ │ │ │ │ +00012220: 6563 6569 7665 6420 6173 2074 6f20 7468  eceived as to th
│ │ │ │ │ +00012230: 6520 6f66 6665 720a 2020 2020 2020 2020  e offer.        
│ │ │ │ │ +00012240: 2020 746f 2064 6973 7472 6962 7574 6520    to distribute 
│ │ │ │ │ +00012250: 636f 7272 6573 706f 6e64 696e 6720 736f  corresponding so
│ │ │ │ │ +00012260: 7572 6365 2063 6f64 652e 2020 2854 6869  urce code.  (Thi
│ │ │ │ │ +00012270: 7320 616c 7465 726e 6174 6976 6520 6973  s alternative is
│ │ │ │ │ +00012280: 0a20 2020 2020 2020 2020 2061 6c6c 6f77  .          allow
│ │ │ │ │ +00012290: 6564 206f 6e6c 7920 666f 7220 6e6f 6e63  ed only for nonc
│ │ │ │ │ +000122a0: 6f6d 6d65 7263 6961 6c20 6469 7374 7269  ommercial distri
│ │ │ │ │ +000122b0: 6275 7469 6f6e 2061 6e64 206f 6e6c 7920  bution and only 
│ │ │ │ │ +000122c0: 6966 2079 6f75 0a20 2020 2020 2020 2020  if you.         
│ │ │ │ │ +000122d0: 2072 6563 6569 7665 6420 7468 6520 7072   received the pr
│ │ │ │ │ +000122e0: 6f67 7261 6d20 696e 206f 626a 6563 7420  ogram in object 
│ │ │ │ │ +000122f0: 636f 6465 206f 7220 6578 6563 7574 6162  code or executab
│ │ │ │ │ +00012300: 6c65 2066 6f72 6d20 7769 7468 0a20 2020  le form with.   
│ │ │ │ │ +00012310: 2020 2020 2020 2073 7563 6820 616e 206f         such an o
│ │ │ │ │ +00012320: 6666 6572 2c20 696e 2061 6363 6f72 6420  ffer, in accord 
│ │ │ │ │ +00012330: 7769 7468 2053 7562 7365 6374 696f 6e20  with Subsection 
│ │ │ │ │ +00012340: 6220 6162 6f76 652e 290a 0a20 2020 2020  b above.)..     
│ │ │ │ │ +00012350: 5468 6520 736f 7572 6365 2063 6f64 6520  The source code 
│ │ │ │ │ +00012360: 666f 7220 6120 776f 726b 206d 6561 6e73  for a work means
│ │ │ │ │ +00012370: 2074 6865 2070 7265 6665 7272 6564 2066   the preferred f
│ │ │ │ │ +00012380: 6f72 6d20 6f66 2074 6865 2077 6f72 6b20  orm of the work 
│ │ │ │ │ +00012390: 666f 720a 2020 2020 206d 616b 696e 6720  for.     making 
│ │ │ │ │ +000123a0: 6d6f 6469 6669 6361 7469 6f6e 7320 746f  modifications to
│ │ │ │ │ +000123b0: 2069 742e 2020 466f 7220 616e 2065 7865   it.  For an exe
│ │ │ │ │ +000123c0: 6375 7461 626c 6520 776f 726b 2c20 636f  cutable work, co
│ │ │ │ │ +000123d0: 6d70 6c65 7465 0a20 2020 2020 736f 7572  mplete.     sour
│ │ │ │ │ +000123e0: 6365 2063 6f64 6520 6d65 616e 7320 616c  ce code means al
│ │ │ │ │ +000123f0: 6c20 7468 6520 736f 7572 6365 2063 6f64  l the source cod
│ │ │ │ │ +00012400: 6520 666f 7220 616c 6c20 6d6f 6475 6c65  e for all module
│ │ │ │ │ +00012410: 7320 6974 2063 6f6e 7461 696e 732c 0a20  s it contains,. 
│ │ │ │ │ +00012420: 2020 2020 706c 7573 2061 6e79 2061 7373      plus any ass
│ │ │ │ │ +00012430: 6f63 6961 7465 6420 696e 7465 7266 6163  ociated interfac
│ │ │ │ │ +00012440: 6520 6465 6669 6e69 7469 6f6e 2066 696c  e definition fil
│ │ │ │ │ +00012450: 6573 2c20 706c 7573 2074 6865 2073 6372  es, plus the scr
│ │ │ │ │ +00012460: 6970 7473 0a20 2020 2020 7573 6564 2074  ipts.     used t
│ │ │ │ │ +00012470: 6f20 636f 6e74 726f 6c20 636f 6d70 696c  o control compil
│ │ │ │ │ +00012480: 6174 696f 6e20 616e 6420 696e 7374 616c  ation and instal
│ │ │ │ │ +00012490: 6c61 7469 6f6e 206f 6620 7468 6520 6578  lation of the ex
│ │ │ │ │ +000124a0: 6563 7574 6162 6c65 2e0a 2020 2020 2048  ecutable..     H
│ │ │ │ │ +000124b0: 6f77 6576 6572 2c20 6173 2061 2073 7065  owever, as a spe
│ │ │ │ │ +000124c0: 6369 616c 2065 7863 6570 7469 6f6e 2c20  cial exception, 
│ │ │ │ │ +000124d0: 7468 6520 736f 7572 6365 2063 6f64 6520  the source code 
│ │ │ │ │ +000124e0: 6469 7374 7269 6275 7465 6420 6e65 6564  distributed need
│ │ │ │ │ +000124f0: 0a20 2020 2020 6e6f 7420 696e 636c 7564  .     not includ
│ │ │ │ │ +00012500: 6520 616e 7974 6869 6e67 2074 6861 7420  e anything that 
│ │ │ │ │ +00012510: 6973 206e 6f72 6d61 6c6c 7920 6469 7374  is normally dist
│ │ │ │ │ +00012520: 7269 6275 7465 6420 2869 6e20 6569 7468  ributed (in eith
│ │ │ │ │ +00012530: 6572 2073 6f75 7263 650a 2020 2020 206f  er source.     o
│ │ │ │ │ +00012540: 7220 6269 6e61 7279 2066 6f72 6d29 2077  r binary form) w
│ │ │ │ │ +00012550: 6974 6820 7468 6520 6d61 6a6f 7220 636f  ith the major co
│ │ │ │ │ +00012560: 6d70 6f6e 656e 7473 2028 636f 6d70 696c  mponents (compil
│ │ │ │ │ +00012570: 6572 2c20 6b65 726e 656c 2c20 616e 6420  er, kernel, and 
│ │ │ │ │ +00012580: 736f 0a20 2020 2020 6f6e 2920 6f66 2074  so.     on) of t
│ │ │ │ │ +00012590: 6865 206f 7065 7261 7469 6e67 2073 7973  he operating sys
│ │ │ │ │ +000125a0: 7465 6d20 6f6e 2077 6869 6368 2074 6865  tem on which the
│ │ │ │ │ +000125b0: 2065 7865 6375 7461 626c 6520 7275 6e73   executable runs
│ │ │ │ │ +000125c0: 2c20 756e 6c65 7373 0a20 2020 2020 7468  , unless.     th
│ │ │ │ │ +000125d0: 6174 2063 6f6d 706f 6e65 6e74 2069 7473  at component its
│ │ │ │ │ +000125e0: 656c 6620 6163 636f 6d70 616e 6965 7320  elf accompanies 
│ │ │ │ │ +000125f0: 7468 6520 6578 6563 7574 6162 6c65 2e0a  the executable..
│ │ │ │ │ +00012600: 0a20 2020 2020 4966 2064 6973 7472 6962  .     If distrib
│ │ │ │ │ +00012610: 7574 696f 6e20 6f66 2065 7865 6375 7461  ution of executa
│ │ │ │ │ +00012620: 626c 6520 6f72 206f 626a 6563 7420 636f  ble or object co
│ │ │ │ │ +00012630: 6465 2069 7320 6d61 6465 2062 7920 6f66  de is made by of
│ │ │ │ │ +00012640: 6665 7269 6e67 0a20 2020 2020 6163 6365  fering.     acce
│ │ │ │ │ +00012650: 7373 2074 6f20 636f 7079 2066 726f 6d20  ss to copy from 
│ │ │ │ │ +00012660: 6120 6465 7369 676e 6174 6564 2070 6c61  a designated pla
│ │ │ │ │ +00012670: 6365 2c20 7468 656e 206f 6666 6572 696e  ce, then offerin
│ │ │ │ │ +00012680: 6720 6571 7569 7661 6c65 6e74 0a20 2020  g equivalent.   
│ │ │ │ │ +00012690: 2020 6163 6365 7373 2074 6f20 636f 7079    access to copy
│ │ │ │ │ +000126a0: 2074 6865 2073 6f75 7263 6520 636f 6465   the source code
│ │ │ │ │ +000126b0: 2066 726f 6d20 7468 6520 7361 6d65 2070   from the same p
│ │ │ │ │ +000126c0: 6c61 6365 2063 6f75 6e74 7320 6173 0a20  lace counts as. 
│ │ │ │ │ +000126d0: 2020 2020 6469 7374 7269 6275 7469 6f6e      distribution
│ │ │ │ │ +000126e0: 206f 6620 7468 6520 736f 7572 6365 2063   of the source c
│ │ │ │ │ +000126f0: 6f64 652c 2065 7665 6e20 7468 6f75 6768  ode, even though
│ │ │ │ │ +00012700: 2074 6869 7264 2070 6172 7469 6573 2061   third parties a
│ │ │ │ │ +00012710: 7265 206e 6f74 0a20 2020 2020 636f 6d70  re not.     comp
│ │ │ │ │ +00012720: 656c 6c65 6420 746f 2063 6f70 7920 7468  elled to copy th
│ │ │ │ │ +00012730: 6520 736f 7572 6365 2061 6c6f 6e67 2077  e source along w
│ │ │ │ │ +00012740: 6974 6820 7468 6520 6f62 6a65 6374 2063  ith the object c
│ │ │ │ │ +00012750: 6f64 652e 0a0a 2020 342e 2059 6f75 206d  ode...  4. You m
│ │ │ │ │ +00012760: 6179 206e 6f74 2063 6f70 792c 206d 6f64  ay not copy, mod
│ │ │ │ │ +00012770: 6966 792c 2073 7562 6c69 6365 6e73 652c  ify, sublicense,
│ │ │ │ │ +00012780: 206f 7220 6469 7374 7269 6275 7465 2074   or distribute t
│ │ │ │ │ +00012790: 6865 2050 726f 6772 616d 0a20 2020 2020  he Program.     
│ │ │ │ │ +000127a0: 6578 6365 7074 2061 7320 6578 7072 6573  except as expres
│ │ │ │ │ +000127b0: 736c 7920 7072 6f76 6964 6564 2075 6e64  sly provided und
│ │ │ │ │ +000127c0: 6572 2074 6869 7320 4c69 6365 6e73 652e  er this License.
│ │ │ │ │ +000127d0: 2020 416e 7920 6174 7465 6d70 740a 2020    Any attempt.  
│ │ │ │ │ +000127e0: 2020 206f 7468 6572 7769 7365 2074 6f20     otherwise to 
│ │ │ │ │ +000127f0: 636f 7079 2c20 6d6f 6469 6679 2c20 7375  copy, modify, su
│ │ │ │ │ +00012800: 626c 6963 656e 7365 206f 7220 6469 7374  blicense or dist
│ │ │ │ │ +00012810: 7269 6275 7465 2074 6865 2050 726f 6772  ribute the Progr
│ │ │ │ │ +00012820: 616d 2069 730a 2020 2020 2076 6f69 642c  am is.     void,
│ │ │ │ │ +00012830: 2061 6e64 2077 696c 6c20 6175 746f 6d61   and will automa
│ │ │ │ │ +00012840: 7469 6361 6c6c 7920 7465 726d 696e 6174  tically terminat
│ │ │ │ │ +00012850: 6520 796f 7572 2072 6967 6874 7320 756e  e your rights un
│ │ │ │ │ +00012860: 6465 7220 7468 6973 0a20 2020 2020 4c69  der this.     Li
│ │ │ │ │ +00012870: 6365 6e73 652e 2020 486f 7765 7665 722c  cense.  However,
│ │ │ │ │ +00012880: 2070 6172 7469 6573 2077 686f 2068 6176   parties who hav
│ │ │ │ │ +00012890: 6520 7265 6365 6976 6564 2063 6f70 6965  e received copie
│ │ │ │ │ +000128a0: 732c 206f 7220 7269 6768 7473 2c0a 2020  s, or rights,.  
│ │ │ │ │ +000128b0: 2020 2066 726f 6d20 796f 7520 756e 6465     from you unde
│ │ │ │ │ +000128c0: 7220 7468 6973 204c 6963 656e 7365 2077  r this License w
│ │ │ │ │ +000128d0: 696c 6c20 6e6f 7420 6861 7665 2074 6865  ill not have the
│ │ │ │ │ +000128e0: 6972 206c 6963 656e 7365 7320 7465 726d  ir licenses term
│ │ │ │ │ +000128f0: 696e 6174 6564 0a20 2020 2020 736f 206c  inated.     so l
│ │ │ │ │ +00012900: 6f6e 6720 6173 2073 7563 6820 7061 7274  ong as such part
│ │ │ │ │ +00012910: 6965 7320 7265 6d61 696e 2069 6e20 6675  ies remain in fu
│ │ │ │ │ +00012920: 6c6c 2063 6f6d 706c 6961 6e63 652e 0a0a  ll compliance...
│ │ │ │ │ +00012930: 2020 352e 2059 6f75 2061 7265 206e 6f74    5. You are not
│ │ │ │ │ +00012940: 2072 6571 7569 7265 6420 746f 2061 6363   required to acc
│ │ │ │ │ +00012950: 6570 7420 7468 6973 204c 6963 656e 7365  ept this License
│ │ │ │ │ +00012960: 2c20 7369 6e63 6520 796f 7520 6861 7665  , since you have
│ │ │ │ │ +00012970: 206e 6f74 0a20 2020 2020 7369 676e 6564   not.     signed
│ │ │ │ │ +00012980: 2069 742e 2020 486f 7765 7665 722c 206e   it.  However, n
│ │ │ │ │ +00012990: 6f74 6869 6e67 2065 6c73 6520 6772 616e  othing else gran
│ │ │ │ │ +000129a0: 7473 2079 6f75 2070 6572 6d69 7373 696f  ts you permissio
│ │ │ │ │ +000129b0: 6e20 746f 206d 6f64 6966 790a 2020 2020  n to modify.    
│ │ │ │ │ +000129c0: 206f 7220 6469 7374 7269 6275 7465 2074   or distribute t
│ │ │ │ │ +000129d0: 6865 2050 726f 6772 616d 206f 7220 6974  he Program or it
│ │ │ │ │ +000129e0: 7320 6465 7269 7661 7469 7665 2077 6f72  s derivative wor
│ │ │ │ │ +000129f0: 6b73 2e20 2054 6865 7365 2061 6374 696f  ks.  These actio
│ │ │ │ │ +00012a00: 6e73 0a20 2020 2020 6172 6520 7072 6f68  ns.     are proh
│ │ │ │ │ +00012a10: 6962 6974 6564 2062 7920 6c61 7720 6966  ibited by law if
│ │ │ │ │ +00012a20: 2079 6f75 2064 6f20 6e6f 7420 6163 6365   you do not acce
│ │ │ │ │ +00012a30: 7074 2074 6869 7320 4c69 6365 6e73 652e  pt this License.
│ │ │ │ │ +00012a40: 0a20 2020 2020 5468 6572 6566 6f72 652c  .     Therefore,
│ │ │ │ │ +00012a50: 2062 7920 6d6f 6469 6679 696e 6720 6f72   by modifying or
│ │ │ │ │ +00012a60: 2064 6973 7472 6962 7574 696e 6720 7468   distributing th
│ │ │ │ │ +00012a70: 6520 5072 6f67 7261 6d20 286f 7220 616e  e Program (or an
│ │ │ │ │ +00012a80: 7920 776f 726b 0a20 2020 2020 6261 7365  y work.     base
│ │ │ │ │ +00012a90: 6420 6f6e 2074 6865 2050 726f 6772 616d  d on the Program
│ │ │ │ │ +00012aa0: 292c 2079 6f75 2069 6e64 6963 6174 6520  ), you indicate 
│ │ │ │ │ +00012ab0: 796f 7572 2061 6363 6570 7461 6e63 6520  your acceptance 
│ │ │ │ │ +00012ac0: 6f66 2074 6869 7320 4c69 6365 6e73 650a  of this License.
│ │ │ │ │ +00012ad0: 2020 2020 2074 6f20 646f 2073 6f2c 2061       to do so, a
│ │ │ │ │ +00012ae0: 6e64 2061 6c6c 2069 7473 2074 6572 6d73  nd all its terms
│ │ │ │ │ +00012af0: 2061 6e64 2063 6f6e 6469 7469 6f6e 7320   and conditions 
│ │ │ │ │ +00012b00: 666f 7220 636f 7079 696e 672c 0a20 2020  for copying,.   
│ │ │ │ │ +00012b10: 2020 6469 7374 7269 6275 7469 6e67 206f    distributing o
│ │ │ │ │ +00012b20: 7220 6d6f 6469 6679 696e 6720 7468 6520  r modifying the 
│ │ │ │ │ +00012b30: 5072 6f67 7261 6d20 6f72 2077 6f72 6b73  Program or works
│ │ │ │ │ +00012b40: 2062 6173 6564 206f 6e20 6974 2e0a 0a20   based on it... 
│ │ │ │ │ +00012b50: 2036 2e20 4561 6368 2074 696d 6520 796f   6. Each time yo
│ │ │ │ │ +00012b60: 7520 7265 6469 7374 7269 6275 7465 2074  u redistribute t
│ │ │ │ │ +00012b70: 6865 2050 726f 6772 616d 2028 6f72 2061  he Program (or a
│ │ │ │ │ +00012b80: 6e79 2077 6f72 6b20 6261 7365 6420 6f6e  ny work based on
│ │ │ │ │ +00012b90: 2074 6865 0a20 2020 2020 5072 6f67 7261   the.     Progra
│ │ │ │ │ +00012ba0: 6d29 2c20 7468 6520 7265 6369 7069 656e  m), the recipien
│ │ │ │ │ +00012bb0: 7420 6175 746f 6d61 7469 6361 6c6c 7920  t automatically 
│ │ │ │ │ +00012bc0: 7265 6365 6976 6573 2061 206c 6963 656e  receives a licen
│ │ │ │ │ +00012bd0: 7365 2066 726f 6d20 7468 650a 2020 2020  se from the.    
│ │ │ │ │ +00012be0: 206f 7269 6769 6e61 6c20 6c69 6365 6e73   original licens
│ │ │ │ │ +00012bf0: 6f72 2074 6f20 636f 7079 2c20 6469 7374  or to copy, dist
│ │ │ │ │ +00012c00: 7269 6275 7465 206f 7220 6d6f 6469 6679  ribute or modify
│ │ │ │ │ +00012c10: 2074 6865 2050 726f 6772 616d 2073 7562   the Program sub
│ │ │ │ │ +00012c20: 6a65 6374 0a20 2020 2020 746f 2074 6865  ject.     to the
│ │ │ │ │ +00012c30: 7365 2074 6572 6d73 2061 6e64 2063 6f6e  se terms and con
│ │ │ │ │ +00012c40: 6469 7469 6f6e 732e 2020 596f 7520 6d61  ditions.  You ma
│ │ │ │ │ +00012c50: 7920 6e6f 7420 696d 706f 7365 2061 6e79  y not impose any
│ │ │ │ │ +00012c60: 2066 7572 7468 6572 0a20 2020 2020 7265   further.     re
│ │ │ │ │ +00012c70: 7374 7269 6374 696f 6e73 206f 6e20 7468  strictions on th
│ │ │ │ │ +00012c80: 6520 7265 6369 7069 656e 7473 2720 6578  e recipients' ex
│ │ │ │ │ +00012c90: 6572 6369 7365 206f 6620 7468 6520 7269  ercise of the ri
│ │ │ │ │ +00012ca0: 6768 7473 2067 7261 6e74 6564 0a20 2020  ghts granted.   
│ │ │ │ │ +00012cb0: 2020 6865 7265 696e 2e20 2059 6f75 2061    herein.  You a
│ │ │ │ │ +00012cc0: 7265 206e 6f74 2072 6573 706f 6e73 6962  re not responsib
│ │ │ │ │ +00012cd0: 6c65 2066 6f72 2065 6e66 6f72 6369 6e67  le for enforcing
│ │ │ │ │ +00012ce0: 2063 6f6d 706c 6961 6e63 6520 6279 2074   compliance by t
│ │ │ │ │ +00012cf0: 6869 7264 0a20 2020 2020 7061 7274 6965  hird.     partie
│ │ │ │ │ +00012d00: 7320 746f 2074 6869 7320 4c69 6365 6e73  s to this Licens
│ │ │ │ │ +00012d10: 652e 0a0a 2020 372e 2049 662c 2061 7320  e...  7. If, as 
│ │ │ │ │ +00012d20: 6120 636f 6e73 6571 7565 6e63 6520 6f66  a consequence of
│ │ │ │ │ +00012d30: 2061 2063 6f75 7274 206a 7564 676d 656e   a court judgmen
│ │ │ │ │ +00012d40: 7420 6f72 2061 6c6c 6567 6174 696f 6e20  t or allegation 
│ │ │ │ │ +00012d50: 6f66 2070 6174 656e 740a 2020 2020 2069  of patent.     i
│ │ │ │ │ +00012d60: 6e66 7269 6e67 656d 656e 7420 6f72 2066  nfringement or f
│ │ │ │ │ +00012d70: 6f72 2061 6e79 206f 7468 6572 2072 6561  or any other rea
│ │ │ │ │ +00012d80: 736f 6e20 286e 6f74 206c 696d 6974 6564  son (not limited
│ │ │ │ │ +00012d90: 2074 6f20 7061 7465 6e74 0a20 2020 2020   to patent.     
│ │ │ │ │ +00012da0: 6973 7375 6573 292c 2063 6f6e 6469 7469  issues), conditi
│ │ │ │ │ +00012db0: 6f6e 7320 6172 6520 696d 706f 7365 6420  ons are imposed 
│ │ │ │ │ +00012dc0: 6f6e 2079 6f75 2028 7768 6574 6865 7220  on you (whether 
│ │ │ │ │ +00012dd0: 6279 2063 6f75 7274 206f 7264 6572 2c0a  by court order,.
│ │ │ │ │ +00012de0: 2020 2020 2061 6772 6565 6d65 6e74 206f       agreement o
│ │ │ │ │ +00012df0: 7220 6f74 6865 7277 6973 6529 2074 6861  r otherwise) tha
│ │ │ │ │ +00012e00: 7420 636f 6e74 7261 6469 6374 2074 6865  t contradict the
│ │ │ │ │ +00012e10: 2063 6f6e 6469 7469 6f6e 7320 6f66 2074   conditions of t
│ │ │ │ │ +00012e20: 6869 730a 2020 2020 204c 6963 656e 7365  his.     License
│ │ │ │ │ +00012e30: 2c20 7468 6579 2064 6f20 6e6f 7420 6578  , they do not ex
│ │ │ │ │ +00012e40: 6375 7365 2079 6f75 2066 726f 6d20 7468  cuse you from th
│ │ │ │ │ +00012e50: 6520 636f 6e64 6974 696f 6e73 206f 6620  e conditions of 
│ │ │ │ │ +00012e60: 7468 6973 0a20 2020 2020 4c69 6365 6e73  this.     Licens
│ │ │ │ │ +00012e70: 652e 2020 4966 2079 6f75 2063 616e 6e6f  e.  If you canno
│ │ │ │ │ +00012e80: 7420 6469 7374 7269 6275 7465 2073 6f20  t distribute so 
│ │ │ │ │ +00012e90: 6173 2074 6f20 7361 7469 7366 7920 7369  as to satisfy si
│ │ │ │ │ +00012ea0: 6d75 6c74 616e 656f 7573 6c79 0a20 2020  multaneously.   
│ │ │ │ │ +00012eb0: 2020 796f 7572 206f 626c 6967 6174 696f    your obligatio
│ │ │ │ │ +00012ec0: 6e73 2075 6e64 6572 2074 6869 7320 4c69  ns under this Li
│ │ │ │ │ +00012ed0: 6365 6e73 6520 616e 6420 616e 7920 6f74  cense and any ot
│ │ │ │ │ +00012ee0: 6865 7220 7065 7274 696e 656e 740a 2020  her pertinent.  
│ │ │ │ │ +00012ef0: 2020 206f 626c 6967 6174 696f 6e73 2c20     obligations, 
│ │ │ │ │ +00012f00: 7468 656e 2061 7320 6120 636f 6e73 6571  then as a conseq
│ │ │ │ │ +00012f10: 7565 6e63 6520 796f 7520 6d61 7920 6e6f  uence you may no
│ │ │ │ │ +00012f20: 7420 6469 7374 7269 6275 7465 2074 6865  t distribute the
│ │ │ │ │ +00012f30: 0a20 2020 2020 5072 6f67 7261 6d20 6174  .     Program at
│ │ │ │ │ +00012f40: 2061 6c6c 2e20 2046 6f72 2065 7861 6d70   all.  For examp
│ │ │ │ │ +00012f50: 6c65 2c20 6966 2061 2070 6174 656e 7420  le, if a patent 
│ │ │ │ │ +00012f60: 6c69 6365 6e73 6520 776f 756c 6420 6e6f  license would no
│ │ │ │ │ +00012f70: 7420 7065 726d 6974 0a20 2020 2020 726f  t permit.     ro
│ │ │ │ │ +00012f80: 7961 6c74 792d 6672 6565 2072 6564 6973  yalty-free redis
│ │ │ │ │ +00012f90: 7472 6962 7574 696f 6e20 6f66 2074 6865  tribution of the
│ │ │ │ │ +00012fa0: 2050 726f 6772 616d 2062 7920 616c 6c20   Program by all 
│ │ │ │ │ +00012fb0: 7468 6f73 6520 7768 6f20 7265 6365 6976  those who receiv
│ │ │ │ │ +00012fc0: 650a 2020 2020 2063 6f70 6965 7320 6469  e.     copies di
│ │ │ │ │ +00012fd0: 7265 6374 6c79 206f 7220 696e 6469 7265  rectly or indire
│ │ │ │ │ +00012fe0: 6374 6c79 2074 6872 6f75 6768 2079 6f75  ctly through you
│ │ │ │ │ +00012ff0: 2c20 7468 656e 2074 6865 206f 6e6c 7920  , then the only 
│ │ │ │ │ +00013000: 7761 7920 796f 750a 2020 2020 2063 6f75  way you.     cou
│ │ │ │ │ +00013010: 6c64 2073 6174 6973 6679 2062 6f74 6820  ld satisfy both 
│ │ │ │ │ +00013020: 6974 2061 6e64 2074 6869 7320 4c69 6365  it and this Lice
│ │ │ │ │ +00013030: 6e73 6520 776f 756c 6420 6265 2074 6f20  nse would be to 
│ │ │ │ │ +00013040: 7265 6672 6169 6e20 656e 7469 7265 6c79  refrain entirely
│ │ │ │ │ +00013050: 0a20 2020 2020 6672 6f6d 2064 6973 7472  .     from distr
│ │ │ │ │ +00013060: 6962 7574 696f 6e20 6f66 2074 6865 2050  ibution of the P
│ │ │ │ │ +00013070: 726f 6772 616d 2e0a 0a20 2020 2020 4966  rogram...     If
│ │ │ │ │ +00013080: 2061 6e79 2070 6f72 7469 6f6e 206f 6620   any portion of 
│ │ │ │ │ +00013090: 7468 6973 2073 6563 7469 6f6e 2069 7320  this section is 
│ │ │ │ │ +000130a0: 6865 6c64 2069 6e76 616c 6964 206f 7220  held invalid or 
│ │ │ │ │ +000130b0: 756e 656e 666f 7263 6561 626c 650a 2020  unenforceable.  
│ │ │ │ │ +000130c0: 2020 2075 6e64 6572 2061 6e79 2070 6172     under any par
│ │ │ │ │ +000130d0: 7469 6375 6c61 7220 6369 7263 756d 7374  ticular circumst
│ │ │ │ │ +000130e0: 616e 6365 2c20 7468 6520 6261 6c61 6e63  ance, the balanc
│ │ │ │ │ +000130f0: 6520 6f66 2074 6865 2073 6563 7469 6f6e  e of the section
│ │ │ │ │ +00013100: 2069 730a 2020 2020 2069 6e74 656e 6465   is.     intende
│ │ │ │ │ +00013110: 6420 746f 2061 7070 6c79 2061 6e64 2074  d to apply and t
│ │ │ │ │ +00013120: 6865 2073 6563 7469 6f6e 2061 7320 6120  he section as a 
│ │ │ │ │ +00013130: 7768 6f6c 6520 6973 2069 6e74 656e 6465  whole is intende
│ │ │ │ │ +00013140: 6420 746f 2061 7070 6c79 0a20 2020 2020  d to apply.     
│ │ │ │ │ +00013150: 696e 206f 7468 6572 2063 6972 6375 6d73  in other circums
│ │ │ │ │ +00013160: 7461 6e63 6573 2e0a 0a20 2020 2020 4974  tances...     It
│ │ │ │ │ +00013170: 2069 7320 6e6f 7420 7468 6520 7075 7270   is not the purp
│ │ │ │ │ +00013180: 6f73 6520 6f66 2074 6869 7320 7365 6374  ose of this sect
│ │ │ │ │ +00013190: 696f 6e20 746f 2069 6e64 7563 6520 796f  ion to induce yo
│ │ │ │ │ +000131a0: 7520 746f 2069 6e66 7269 6e67 6520 616e  u to infringe an
│ │ │ │ │ +000131b0: 790a 2020 2020 2070 6174 656e 7473 206f  y.     patents o
│ │ │ │ │ +000131c0: 7220 6f74 6865 7220 7072 6f70 6572 7479  r other property
│ │ │ │ │ +000131d0: 2072 6967 6874 2063 6c61 696d 7320 6f72   right claims or
│ │ │ │ │ +000131e0: 2074 6f20 636f 6e74 6573 7420 7661 6c69   to contest vali
│ │ │ │ │ +000131f0: 6469 7479 206f 660a 2020 2020 2061 6e79  dity of.     any
│ │ │ │ │ +00013200: 2073 7563 6820 636c 6169 6d73 3b20 7468   such claims; th
│ │ │ │ │ +00013210: 6973 2073 6563 7469 6f6e 2068 6173 2074  is section has t
│ │ │ │ │ +00013220: 6865 2073 6f6c 6520 7075 7270 6f73 6520  he sole purpose 
│ │ │ │ │ +00013230: 6f66 2070 726f 7465 6374 696e 670a 2020  of protecting.  
│ │ │ │ │ +00013240: 2020 2074 6865 2069 6e74 6567 7269 7479     the integrity
│ │ │ │ │ +00013250: 206f 6620 7468 6520 6672 6565 2073 6f66   of the free sof
│ │ │ │ │ +00013260: 7477 6172 6520 6469 7374 7269 6275 7469  tware distributi
│ │ │ │ │ +00013270: 6f6e 2073 7973 7465 6d2c 2077 6869 6368  on system, which
│ │ │ │ │ +00013280: 2069 730a 2020 2020 2069 6d70 6c65 6d65   is.     impleme
│ │ │ │ │ +00013290: 6e74 6564 2062 7920 7075 626c 6963 206c  nted by public l
│ │ │ │ │ +000132a0: 6963 656e 7365 2070 7261 6374 6963 6573  icense practices
│ │ │ │ │ +000132b0: 2e20 204d 616e 7920 7065 6f70 6c65 2068  .  Many people h
│ │ │ │ │ +000132c0: 6176 6520 6d61 6465 0a20 2020 2020 6765  ave made.     ge
│ │ │ │ │ +000132d0: 6e65 726f 7573 2063 6f6e 7472 6962 7574  nerous contribut
│ │ │ │ │ +000132e0: 696f 6e73 2074 6f20 7468 6520 7769 6465  ions to the wide
│ │ │ │ │ +000132f0: 2072 616e 6765 206f 6620 736f 6674 7761   range of softwa
│ │ │ │ │ +00013300: 7265 2064 6973 7472 6962 7574 6564 0a20  re distributed. 
│ │ │ │ │ +00013310: 2020 2020 7468 726f 7567 6820 7468 6174      through that
│ │ │ │ │ +00013320: 2073 7973 7465 6d20 696e 2072 656c 6961   system in relia
│ │ │ │ │ +00013330: 6e63 6520 6f6e 2063 6f6e 7369 7374 656e  nce on consisten
│ │ │ │ │ +00013340: 7420 6170 706c 6963 6174 696f 6e20 6f66  t application of
│ │ │ │ │ +00013350: 2074 6861 740a 2020 2020 2073 7973 7465   that.     syste
│ │ │ │ │ +00013360: 6d3b 2069 7420 6973 2075 7020 746f 2074  m; it is up to t
│ │ │ │ │ +00013370: 6865 2061 7574 686f 722f 646f 6e6f 7220  he author/donor 
│ │ │ │ │ +00013380: 746f 2064 6563 6964 6520 6966 2068 6520  to decide if he 
│ │ │ │ │ +00013390: 6f72 2073 6865 2069 730a 2020 2020 2077  or she is.     w
│ │ │ │ │ +000133a0: 696c 6c69 6e67 2074 6f20 6469 7374 7269  illing to distri
│ │ │ │ │ +000133b0: 6275 7465 2073 6f66 7477 6172 6520 7468  bute software th
│ │ │ │ │ +000133c0: 726f 7567 6820 616e 7920 6f74 6865 7220  rough any other 
│ │ │ │ │ +000133d0: 7379 7374 656d 2061 6e64 2061 0a20 2020  system and a.   
│ │ │ │ │ +000133e0: 2020 6c69 6365 6e73 6565 2063 616e 6e6f    licensee canno
│ │ │ │ │ +000133f0: 7420 696d 706f 7365 2074 6861 7420 6368  t impose that ch
│ │ │ │ │ +00013400: 6f69 6365 2e0a 0a20 2020 2020 5468 6973  oice...     This
│ │ │ │ │ +00013410: 2073 6563 7469 6f6e 2069 7320 696e 7465   section is inte
│ │ │ │ │ +00013420: 6e64 6564 2074 6f20 6d61 6b65 2074 686f  nded to make tho
│ │ │ │ │ +00013430: 726f 7567 686c 7920 636c 6561 7220 7768  roughly clear wh
│ │ │ │ │ +00013440: 6174 2069 7320 6265 6c69 6576 6564 0a20  at is believed. 
│ │ │ │ │ +00013450: 2020 2020 746f 2062 6520 6120 636f 6e73      to be a cons
│ │ │ │ │ +00013460: 6571 7565 6e63 6520 6f66 2074 6865 2072  equence of the r
│ │ │ │ │ +00013470: 6573 7420 6f66 2074 6869 7320 4c69 6365  est of this Lice
│ │ │ │ │ +00013480: 6e73 652e 0a0a 2020 382e 2049 6620 7468  nse...  8. If th
│ │ │ │ │ +00013490: 6520 6469 7374 7269 6275 7469 6f6e 2061  e distribution a
│ │ │ │ │ +000134a0: 6e64 2f6f 7220 7573 6520 6f66 2074 6865  nd/or use of the
│ │ │ │ │ +000134b0: 2050 726f 6772 616d 2069 7320 7265 7374   Program is rest
│ │ │ │ │ +000134c0: 7269 6374 6564 2069 6e0a 2020 2020 2063  ricted in.     c
│ │ │ │ │ +000134d0: 6572 7461 696e 2063 6f75 6e74 7269 6573  ertain countries
│ │ │ │ │ +000134e0: 2065 6974 6865 7220 6279 2070 6174 656e   either by paten
│ │ │ │ │ +000134f0: 7473 206f 7220 6279 2063 6f70 7972 6967  ts or by copyrig
│ │ │ │ │ +00013500: 6874 6564 2069 6e74 6572 6661 6365 732c  hted interfaces,
│ │ │ │ │ +00013510: 0a20 2020 2020 7468 6520 6f72 6967 696e  .     the origin
│ │ │ │ │ +00013520: 616c 2063 6f70 7972 6967 6874 2068 6f6c  al copyright hol
│ │ │ │ │ +00013530: 6465 7220 7768 6f20 706c 6163 6573 2074  der who places t
│ │ │ │ │ +00013540: 6865 2050 726f 6772 616d 2075 6e64 6572  he Program under
│ │ │ │ │ +00013550: 2074 6869 730a 2020 2020 204c 6963 656e   this.     Licen
│ │ │ │ │ +00013560: 7365 206d 6179 2061 6464 2061 6e20 6578  se may add an ex
│ │ │ │ │ +00013570: 706c 6963 6974 2067 656f 6772 6170 6869  plicit geographi
│ │ │ │ │ +00013580: 6361 6c20 6469 7374 7269 6275 7469 6f6e  cal distribution
│ │ │ │ │ +00013590: 206c 696d 6974 6174 696f 6e0a 2020 2020   limitation.    
│ │ │ │ │ +000135a0: 2065 7863 6c75 6469 6e67 2074 686f 7365   excluding those
│ │ │ │ │ +000135b0: 2063 6f75 6e74 7269 6573 2c20 736f 2074   countries, so t
│ │ │ │ │ +000135c0: 6861 7420 6469 7374 7269 6275 7469 6f6e  hat distribution
│ │ │ │ │ +000135d0: 2069 7320 7065 726d 6974 7465 6420 6f6e   is permitted on
│ │ │ │ │ +000135e0: 6c79 0a20 2020 2020 696e 206f 7220 616d  ly.     in or am
│ │ │ │ │ +000135f0: 6f6e 6720 636f 756e 7472 6965 7320 6e6f  ong countries no
│ │ │ │ │ +00013600: 7420 7468 7573 2065 7863 6c75 6465 642e  t thus excluded.
│ │ │ │ │ +00013610: 2020 496e 2073 7563 6820 6361 7365 2c20    In such case, 
│ │ │ │ │ +00013620: 7468 6973 0a20 2020 2020 4c69 6365 6e73  this.     Licens
│ │ │ │ │ +00013630: 6520 696e 636f 7270 6f72 6174 6573 2074  e incorporates t
│ │ │ │ │ +00013640: 6865 206c 696d 6974 6174 696f 6e20 6173  he limitation as
│ │ │ │ │ +00013650: 2069 6620 7772 6974 7465 6e20 696e 2074   if written in t
│ │ │ │ │ +00013660: 6865 2062 6f64 7920 6f66 0a20 2020 2020  he body of.     
│ │ │ │ │ +00013670: 7468 6973 204c 6963 656e 7365 2e0a 0a20  this License... 
│ │ │ │ │ +00013680: 2039 2e20 5468 6520 4672 6565 2053 6f66   9. The Free Sof
│ │ │ │ │ +00013690: 7477 6172 6520 466f 756e 6461 7469 6f6e  tware Foundation
│ │ │ │ │ +000136a0: 206d 6179 2070 7562 6c69 7368 2072 6576   may publish rev
│ │ │ │ │ +000136b0: 6973 6564 2061 6e64 2f6f 7220 6e65 770a  ised and/or new.
│ │ │ │ │ +000136c0: 2020 2020 2076 6572 7369 6f6e 7320 6f66       versions of
│ │ │ │ │ +000136d0: 2074 6865 2047 656e 6572 616c 2050 7562   the General Pub
│ │ │ │ │ +000136e0: 6c69 6320 4c69 6365 6e73 6520 6672 6f6d  lic License from
│ │ │ │ │ +000136f0: 2074 696d 6520 746f 2074 696d 652e 2020   time to time.  
│ │ │ │ │ +00013700: 5375 6368 206e 6577 0a20 2020 2020 7665  Such new.     ve
│ │ │ │ │ +00013710: 7273 696f 6e73 2077 696c 6c20 6265 2073  rsions will be s
│ │ │ │ │ +00013720: 696d 696c 6172 2069 6e20 7370 6972 6974  imilar in spirit
│ │ │ │ │ +00013730: 2074 6f20 7468 6520 7072 6573 656e 7420   to the present 
│ │ │ │ │ +00013740: 7665 7273 696f 6e2c 2062 7574 206d 6179  version, but may
│ │ │ │ │ +00013750: 0a20 2020 2020 6469 6666 6572 2069 6e20  .     differ in 
│ │ │ │ │ +00013760: 6465 7461 696c 2074 6f20 6164 6472 6573  detail to addres
│ │ │ │ │ +00013770: 7320 6e65 7720 7072 6f62 6c65 6d73 206f  s new problems o
│ │ │ │ │ +00013780: 7220 636f 6e63 6572 6e73 2e0a 0a20 2020  r concerns...   
│ │ │ │ │ +00013790: 2020 4561 6368 2076 6572 7369 6f6e 2069    Each version i
│ │ │ │ │ +000137a0: 7320 6769 7665 6e20 6120 6469 7374 696e  s given a distin
│ │ │ │ │ +000137b0: 6775 6973 6869 6e67 2076 6572 7369 6f6e  guishing version
│ │ │ │ │ +000137c0: 206e 756d 6265 722e 2020 4966 2074 6865   number.  If the
│ │ │ │ │ +000137d0: 0a20 2020 2020 5072 6f67 7261 6d20 7370  .     Program sp
│ │ │ │ │ +000137e0: 6563 6966 6965 7320 6120 7665 7273 696f  ecifies a versio
│ │ │ │ │ +000137f0: 6e20 6e75 6d62 6572 206f 6620 7468 6973  n number of this
│ │ │ │ │ +00013800: 204c 6963 656e 7365 2077 6869 6368 2061   License which a
│ │ │ │ │ +00013810: 7070 6c69 6573 2074 6f0a 2020 2020 2069  pplies to.     i
│ │ │ │ │ +00013820: 7420 616e 6420 2261 6e79 206c 6174 6572  t and "any later
│ │ │ │ │ +00013830: 2076 6572 7369 6f6e 222c 2079 6f75 2068   version", you h
│ │ │ │ │ +00013840: 6176 6520 7468 6520 6f70 7469 6f6e 206f  ave the option o
│ │ │ │ │ +00013850: 6620 666f 6c6c 6f77 696e 6720 7468 650a  f following the.
│ │ │ │ │ +00013860: 2020 2020 2074 6572 6d73 2061 6e64 2063       terms and c
│ │ │ │ │ +00013870: 6f6e 6469 7469 6f6e 7320 6569 7468 6572  onditions either
│ │ │ │ │ +00013880: 206f 6620 7468 6174 2076 6572 7369 6f6e   of that version
│ │ │ │ │ +00013890: 206f 7220 6f66 2061 6e79 206c 6174 6572   or of any later
│ │ │ │ │ +000138a0: 2076 6572 7369 6f6e 0a20 2020 2020 7075   version.     pu
│ │ │ │ │ +000138b0: 626c 6973 6865 6420 6279 2074 6865 2046  blished by the F
│ │ │ │ │ +000138c0: 7265 6520 536f 6674 7761 7265 2046 6f75  ree Software Fou
│ │ │ │ │ +000138d0: 6e64 6174 696f 6e2e 2020 4966 2074 6865  ndation.  If the
│ │ │ │ │ +000138e0: 2050 726f 6772 616d 2064 6f65 7320 6e6f   Program does no
│ │ │ │ │ +000138f0: 740a 2020 2020 2073 7065 6369 6679 2061  t.     specify a
│ │ │ │ │ +00013900: 2076 6572 7369 6f6e 206e 756d 6265 7220   version number 
│ │ │ │ │ +00013910: 6f66 2074 6869 7320 4c69 6365 6e73 652c  of this License,
│ │ │ │ │ +00013920: 2079 6f75 206d 6179 2063 686f 6f73 6520   you may choose 
│ │ │ │ │ +00013930: 616e 790a 2020 2020 2076 6572 7369 6f6e  any.     version
│ │ │ │ │ +00013940: 2065 7665 7220 7075 626c 6973 6865 6420   ever published 
│ │ │ │ │ +00013950: 6279 2074 6865 2046 7265 6520 536f 6674  by the Free Soft
│ │ │ │ │ +00013960: 7761 7265 2046 6f75 6e64 6174 696f 6e2e  ware Foundation.
│ │ │ │ │ +00013970: 0a0a 2020 3130 2e20 4966 2079 6f75 2077  ..  10. If you w
│ │ │ │ │ +00013980: 6973 6820 746f 2069 6e63 6f72 706f 7261  ish to incorpora
│ │ │ │ │ +00013990: 7465 2070 6172 7473 206f 6620 7468 6520  te parts of the 
│ │ │ │ │ +000139a0: 5072 6f67 7261 6d20 696e 746f 206f 7468  Program into oth
│ │ │ │ │ +000139b0: 6572 2066 7265 650a 2020 2020 2070 726f  er free.     pro
│ │ │ │ │ +000139c0: 6772 616d 7320 7768 6f73 6520 6469 7374  grams whose dist
│ │ │ │ │ +000139d0: 7269 6275 7469 6f6e 2063 6f6e 6469 7469  ribution conditi
│ │ │ │ │ +000139e0: 6f6e 7320 6172 6520 6469 6666 6572 656e  ons are differen
│ │ │ │ │ +000139f0: 742c 2077 7269 7465 2074 6f20 7468 650a  t, write to the.
│ │ │ │ │ +00013a00: 2020 2020 2061 7574 686f 7220 746f 2061       author to a
│ │ │ │ │ +00013a10: 736b 2066 6f72 2070 6572 6d69 7373 696f  sk for permissio
│ │ │ │ │ +00013a20: 6e2e 2020 466f 7220 736f 6674 7761 7265  n.  For software
│ │ │ │ │ +00013a30: 2077 6869 6368 2069 7320 636f 7079 7269   which is copyri
│ │ │ │ │ +00013a40: 6768 7465 6420 6279 0a20 2020 2020 7468  ghted by.     th
│ │ │ │ │ +00013a50: 6520 4672 6565 2053 6f66 7477 6172 6520  e Free Software 
│ │ │ │ │ +00013a60: 466f 756e 6461 7469 6f6e 2c20 7772 6974  Foundation, writ
│ │ │ │ │ +00013a70: 6520 746f 2074 6865 2046 7265 6520 536f  e to the Free So
│ │ │ │ │ +00013a80: 6674 7761 7265 0a20 2020 2020 466f 756e  ftware.     Foun
│ │ │ │ │ +00013a90: 6461 7469 6f6e 3b20 7765 2073 6f6d 6574  dation; we somet
│ │ │ │ │ +00013aa0: 696d 6573 206d 616b 6520 6578 6365 7074  imes make except
│ │ │ │ │ +00013ab0: 696f 6e73 2066 6f72 2074 6869 732e 2020  ions for this.  
│ │ │ │ │ +00013ac0: 4f75 7220 6465 6369 7369 6f6e 0a20 2020  Our decision.   
│ │ │ │ │ +00013ad0: 2020 7769 6c6c 2062 6520 6775 6964 6564    will be guided
│ │ │ │ │ +00013ae0: 2062 7920 7468 6520 7477 6f20 676f 616c   by the two goal
│ │ │ │ │ +00013af0: 7320 6f66 2070 7265 7365 7276 696e 6720  s of preserving 
│ │ │ │ │ +00013b00: 7468 6520 6672 6565 2073 7461 7475 7320  the free status 
│ │ │ │ │ +00013b10: 6f66 0a20 2020 2020 616c 6c20 6465 7269  of.     all deri
│ │ │ │ │ +00013b20: 7661 7469 7665 7320 6f66 206f 7572 2066  vatives of our f
│ │ │ │ │ +00013b30: 7265 6520 736f 6674 7761 7265 2061 6e64  ree software and
│ │ │ │ │ +00013b40: 206f 6620 7072 6f6d 6f74 696e 6720 7468   of promoting th
│ │ │ │ │ +00013b50: 6520 7368 6172 696e 670a 2020 2020 2061  e sharing.     a
│ │ │ │ │ +00013b60: 6e64 2072 6575 7365 206f 6620 736f 6674  nd reuse of soft
│ │ │ │ │ +00013b70: 7761 7265 2067 656e 6572 616c 6c79 2e0a  ware generally..
│ │ │ │ │ +00013b80: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ │ +00013b90: 2020 2020 2020 2020 2020 2020 2020 204e                 N
│ │ │ │ │ +00013ba0: 4f20 5741 5252 414e 5459 0a0a 2020 312e  O WARRANTY..  1.
│ │ │ │ │ +00013bb0: 2042 4543 4155 5345 2054 4845 2050 524f   BECAUSE THE PRO
│ │ │ │ │ +00013bc0: 4752 414d 2049 5320 4c49 4345 4e53 4544  GRAM IS LICENSED
│ │ │ │ │ +00013bd0: 2046 5245 4520 4f46 2043 4841 5247 452c   FREE OF CHARGE,
│ │ │ │ │ +00013be0: 2054 4845 5245 2049 5320 4e4f 0a20 2020   THERE IS NO.   
│ │ │ │ │ +00013bf0: 2020 5741 5252 414e 5459 2046 4f52 2054    WARRANTY FOR T
│ │ │ │ │ +00013c00: 4845 2050 524f 4752 414d 2c20 544f 2054  HE PROGRAM, TO T
│ │ │ │ │ +00013c10: 4845 2045 5854 454e 5420 5045 524d 4954  HE EXTENT PERMIT
│ │ │ │ │ +00013c20: 5445 4420 4259 2041 5050 4c49 4341 424c  TED BY APPLICABL
│ │ │ │ │ +00013c30: 450a 2020 2020 204c 4157 2e20 4558 4345  E.     LAW. EXCE
│ │ │ │ │ +00013c40: 5054 2057 4845 4e20 4f54 4845 5257 4953  PT WHEN OTHERWIS
│ │ │ │ │ +00013c50: 4520 5354 4154 4544 2049 4e20 5752 4954  E STATED IN WRIT
│ │ │ │ │ +00013c60: 494e 4720 5448 4520 434f 5059 5249 4748  ING THE COPYRIGH
│ │ │ │ │ +00013c70: 5420 484f 4c44 4552 530a 2020 2020 2041  T HOLDERS.     A
│ │ │ │ │ +00013c80: 4e44 2f4f 5220 4f54 4845 5220 5041 5254  ND/OR OTHER PART
│ │ │ │ │ +00013c90: 4945 5320 5052 4f56 4944 4520 5448 4520  IES PROVIDE THE 
│ │ │ │ │ +00013ca0: 5052 4f47 5241 4d20 2241 5320 4953 2220  PROGRAM "AS IS" 
│ │ │ │ │ +00013cb0: 5749 5448 4f55 5420 5741 5252 414e 5459  WITHOUT WARRANTY
│ │ │ │ │ +00013cc0: 0a20 2020 2020 4f46 2041 4e59 204b 494e  .     OF ANY KIN
│ │ │ │ │ +00013cd0: 442c 2045 4954 4845 5220 4558 5052 4553  D, EITHER EXPRES
│ │ │ │ │ +00013ce0: 5345 4420 4f52 2049 4d50 4c49 4544 2c20  SED OR IMPLIED, 
│ │ │ │ │ +00013cf0: 494e 434c 5544 494e 472c 2042 5554 204e  INCLUDING, BUT N
│ │ │ │ │ +00013d00: 4f54 0a20 2020 2020 4c49 4d49 5445 4420  OT.     LIMITED 
│ │ │ │ │ +00013d10: 544f 2c20 5448 4520 494d 504c 4945 4420  TO, THE IMPLIED 
│ │ │ │ │ +00013d20: 5741 5252 414e 5449 4553 204f 4620 4d45  WARRANTIES OF ME
│ │ │ │ │ +00013d30: 5243 4841 4e54 4142 494c 4954 5920 414e  RCHANTABILITY AN
│ │ │ │ │ +00013d40: 4420 4649 544e 4553 530a 2020 2020 2046  D FITNESS.     F
│ │ │ │ │ +00013d50: 4f52 2041 2050 4152 5449 4355 4c41 5220  OR A PARTICULAR 
│ │ │ │ │ +00013d60: 5055 5250 4f53 452e 2054 4845 2045 4e54  PURPOSE. THE ENT
│ │ │ │ │ +00013d70: 4952 4520 5249 534b 2041 5320 544f 2054  IRE RISK AS TO T
│ │ │ │ │ +00013d80: 4845 2051 5541 4c49 5459 2041 4e44 0a20  HE QUALITY AND. 
│ │ │ │ │ +00013d90: 2020 2020 5045 5246 4f52 4d41 4e43 4520      PERFORMANCE 
│ │ │ │ │ +00013da0: 4f46 2054 4845 2050 524f 4752 414d 2049  OF THE PROGRAM I
│ │ │ │ │ +00013db0: 5320 5749 5448 2059 4f55 2e20 5348 4f55  S WITH YOU. SHOU
│ │ │ │ │ +00013dc0: 4c44 2054 4845 2050 524f 4752 414d 2050  LD THE PROGRAM P
│ │ │ │ │ +00013dd0: 524f 5645 0a20 2020 2020 4445 4645 4354  ROVE.     DEFECT
│ │ │ │ │ +00013de0: 4956 452c 2059 4f55 2041 5353 554d 4520  IVE, YOU ASSUME 
│ │ │ │ │ +00013df0: 5448 4520 434f 5354 204f 4620 414c 4c20  THE COST OF ALL 
│ │ │ │ │ +00013e00: 4e45 4345 5353 4152 5920 5345 5256 4943  NECESSARY SERVIC
│ │ │ │ │ +00013e10: 494e 472c 2052 4550 4149 520a 2020 2020  ING, REPAIR.    
│ │ │ │ │ +00013e20: 204f 5220 434f 5252 4543 5449 4f4e 2e0a   OR CORRECTION..
│ │ │ │ │ +00013e30: 0a20 2032 2e20 494e 204e 4f20 4556 454e  .  2. IN NO EVEN
│ │ │ │ │ +00013e40: 5420 554e 4c45 5353 2052 4551 5549 5245  T UNLESS REQUIRE
│ │ │ │ │ +00013e50: 4420 4259 2041 5050 4c49 4341 424c 4520  D BY APPLICABLE 
│ │ │ │ │ +00013e60: 4c41 5720 4f52 2041 4752 4545 4420 544f  LAW OR AGREED TO
│ │ │ │ │ +00013e70: 2049 4e0a 2020 2020 2057 5249 5449 4e47   IN.     WRITING
│ │ │ │ │ +00013e80: 2057 494c 4c20 414e 5920 434f 5059 5249   WILL ANY COPYRI
│ │ │ │ │ +00013e90: 4748 5420 484f 4c44 4552 2c20 4f52 2041  GHT HOLDER, OR A
│ │ │ │ │ +00013ea0: 4e59 204f 5448 4552 2050 4152 5459 2057  NY OTHER PARTY W
│ │ │ │ │ +00013eb0: 484f 204d 4159 0a20 2020 2020 4d4f 4449  HO MAY.     MODI
│ │ │ │ │ +00013ec0: 4659 2041 4e44 2f4f 5220 5245 4449 5354  FY AND/OR REDIST
│ │ │ │ │ +00013ed0: 5249 4255 5445 2054 4845 2050 524f 4752  RIBUTE THE PROGR
│ │ │ │ │ +00013ee0: 414d 2041 5320 5045 524d 4954 5445 4420  AM AS PERMITTED 
│ │ │ │ │ +00013ef0: 4142 4f56 452c 2042 450a 2020 2020 204c  ABOVE, BE.     L
│ │ │ │ │ +00013f00: 4941 424c 4520 544f 2059 4f55 2046 4f52  IABLE TO YOU FOR
│ │ │ │ │ +00013f10: 2044 414d 4147 4553 2c20 494e 434c 5544   DAMAGES, INCLUD
│ │ │ │ │ +00013f20: 494e 4720 414e 5920 4745 4e45 5241 4c2c  ING ANY GENERAL,
│ │ │ │ │ +00013f30: 2053 5045 4349 414c 2c0a 2020 2020 2049   SPECIAL,.     I
│ │ │ │ │ +00013f40: 4e43 4944 454e 5441 4c20 4f52 2043 4f4e  NCIDENTAL OR CON
│ │ │ │ │ +00013f50: 5345 5155 454e 5449 414c 2044 414d 4147  SEQUENTIAL DAMAG
│ │ │ │ │ +00013f60: 4553 2041 5249 5349 4e47 204f 5554 204f  ES ARISING OUT O
│ │ │ │ │ +00013f70: 4620 5448 4520 5553 4520 4f52 0a20 2020  F THE USE OR.   
│ │ │ │ │ +00013f80: 2020 494e 4142 494c 4954 5920 544f 2055    INABILITY TO U
│ │ │ │ │ +00013f90: 5345 2054 4845 2050 524f 4752 414d 2028  SE THE PROGRAM (
│ │ │ │ │ +00013fa0: 494e 434c 5544 494e 4720 4255 5420 4e4f  INCLUDING BUT NO
│ │ │ │ │ +00013fb0: 5420 4c49 4d49 5445 4420 544f 204c 4f53  T LIMITED TO LOS
│ │ │ │ │ +00013fc0: 5320 4f46 0a20 2020 2020 4441 5441 204f  S OF.     DATA O
│ │ │ │ │ +00013fd0: 5220 4441 5441 2042 4549 4e47 2052 454e  R DATA BEING REN
│ │ │ │ │ +00013fe0: 4445 5245 4420 494e 4143 4355 5241 5445  DERED INACCURATE
│ │ │ │ │ +00013ff0: 204f 5220 4c4f 5353 4553 2053 5553 5441   OR LOSSES SUSTA
│ │ │ │ │ +00014000: 494e 4544 2042 5920 594f 550a 2020 2020  INED BY YOU.    
│ │ │ │ │ +00014010: 204f 5220 5448 4952 4420 5041 5254 4945   OR THIRD PARTIE
│ │ │ │ │ +00014020: 5320 4f52 2041 2046 4149 4c55 5245 204f  S OR A FAILURE O
│ │ │ │ │ +00014030: 4620 5448 4520 5052 4f47 5241 4d20 544f  F THE PROGRAM TO
│ │ │ │ │ +00014040: 204f 5045 5241 5445 2057 4954 4820 414e   OPERATE WITH AN
│ │ │ │ │ +00014050: 590a 2020 2020 204f 5448 4552 2050 524f  Y.     OTHER PRO
│ │ │ │ │ +00014060: 4752 414d 5329 2c20 4556 454e 2049 4620  GRAMS), EVEN IF 
│ │ │ │ │ +00014070: 5355 4348 2048 4f4c 4445 5220 4f52 204f  SUCH HOLDER OR O
│ │ │ │ │ +00014080: 5448 4552 2050 4152 5459 2048 4153 2042  THER PARTY HAS B
│ │ │ │ │ +00014090: 4545 4e0a 2020 2020 2041 4456 4953 4544  EEN.     ADVISED
│ │ │ │ │ +000140a0: 204f 4620 5448 4520 504f 5353 4942 494c   OF THE POSSIBIL
│ │ │ │ │ +000140b0: 4954 5920 4f46 2053 5543 4820 4441 4d41  ITY OF SUCH DAMA
│ │ │ │ │ +000140c0: 4745 532e 0a0a 2020 2020 2020 2020 2020  GES...          
│ │ │ │ │ +000140d0: 2020 2020 2020 2020 2020 2020 454e 4420              END 
│ │ │ │ │ +000140e0: 4f46 2054 4552 4d53 2041 4e44 2043 4f4e  OF TERMS AND CON
│ │ │ │ │ +000140f0: 4449 5449 4f4e 530a 0a41 2e32 2041 7070  DITIONS..A.2 App
│ │ │ │ │ +00014100: 656e 6469 783a 2048 6f77 2074 6f20 4170  endix: How to Ap
│ │ │ │ │ +00014110: 706c 7920 5468 6573 6520 5465 726d 7320  ply These Terms 
│ │ │ │ │ +00014120: 746f 2059 6f75 7220 4e65 7720 5072 6f67  to Your New Prog
│ │ │ │ │ +00014130: 7261 6d73 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d  rams.===========
│ │ │ │ │  00014140: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ │  00014150: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ │  00014160: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ │ -00014170: 3d3d 0a0a 4966 2079 6f75 2064 6576 656c  ==..If you devel
│ │ │ │ │ -00014180: 6f70 2061 206e 6577 2070 726f 6772 616d  op a new program
│ │ │ │ │ -00014190: 2c20 616e 6420 796f 7520 7761 6e74 2069  , and you want i
│ │ │ │ │ -000141a0: 7420 746f 2062 6520 6f66 2074 6865 2067  t to be of the g
│ │ │ │ │ -000141b0: 7265 6174 6573 740a 706f 7373 6962 6c65  reatest.possible
│ │ │ │ │ -000141c0: 2075 7365 2074 6f20 7468 6520 7075 626c   use to the publ
│ │ │ │ │ -000141d0: 6963 2c20 7468 6520 6265 7374 2077 6179  ic, the best way
│ │ │ │ │ -000141e0: 2074 6f20 6163 6869 6576 6520 7468 6973   to achieve this
│ │ │ │ │ -000141f0: 2069 7320 746f 206d 616b 6520 6974 0a66   is to make it.f
│ │ │ │ │ -00014200: 7265 6520 736f 6674 7761 7265 2077 6869  ree software whi
│ │ │ │ │ -00014210: 6368 2065 7665 7279 6f6e 6520 6361 6e20  ch everyone can 
│ │ │ │ │ -00014220: 7265 6469 7374 7269 6275 7465 2061 6e64  redistribute and
│ │ │ │ │ -00014230: 2063 6861 6e67 6520 756e 6465 7220 7468   change under th
│ │ │ │ │ -00014240: 6573 650a 7465 726d 732e 0a0a 2020 2054  ese.terms...   T
│ │ │ │ │ -00014250: 6f20 646f 2073 6f2c 2061 7474 6163 6820  o do so, attach 
│ │ │ │ │ -00014260: 7468 6520 666f 6c6c 6f77 696e 6720 6e6f  the following no
│ │ │ │ │ -00014270: 7469 6365 7320 746f 2074 6865 2070 726f  tices to the pro
│ │ │ │ │ -00014280: 6772 616d 2e20 2049 7420 6973 2073 6166  gram.  It is saf
│ │ │ │ │ -00014290: 6573 740a 746f 2061 7474 6163 6820 7468  est.to attach th
│ │ │ │ │ -000142a0: 656d 2074 6f20 7468 6520 7374 6172 7420  em to the start 
│ │ │ │ │ -000142b0: 6f66 2065 6163 6820 736f 7572 6365 2066  of each source f
│ │ │ │ │ -000142c0: 696c 6520 746f 206d 6f73 7420 6566 6665  ile to most effe
│ │ │ │ │ -000142d0: 6374 6976 656c 790a 636f 6e76 6579 2074  ctively.convey t
│ │ │ │ │ -000142e0: 6865 2065 7863 6c75 7369 6f6e 206f 6620  he exclusion of 
│ │ │ │ │ -000142f0: 7761 7272 616e 7479 3b20 616e 6420 6561  warranty; and ea
│ │ │ │ │ -00014300: 6368 2066 696c 6520 7368 6f75 6c64 2068  ch file should h
│ │ │ │ │ -00014310: 6176 6520 6174 206c 6561 7374 2074 6865  ave at least the
│ │ │ │ │ -00014320: 0a22 636f 7079 7269 6768 7422 206c 696e  ."copyright" lin
│ │ │ │ │ -00014330: 6520 616e 6420 6120 706f 696e 7465 7220  e and a pointer 
│ │ │ │ │ -00014340: 746f 2077 6865 7265 2074 6865 2066 756c  to where the ful
│ │ │ │ │ -00014350: 6c20 6e6f 7469 6365 2069 7320 666f 756e  l notice is foun
│ │ │ │ │ -00014360: 642e 0a0a 2020 2020 204f 4e45 204c 494e  d...     ONE LIN
│ │ │ │ │ -00014370: 4520 544f 2047 4956 4520 5448 4520 5052  E TO GIVE THE PR
│ │ │ │ │ -00014380: 4f47 5241 4d27 5320 4e41 4d45 2041 4e44  OGRAM'S NAME AND
│ │ │ │ │ -00014390: 2041 2042 5249 4546 2049 4445 4120 4f46   A BRIEF IDEA OF
│ │ │ │ │ -000143a0: 2057 4841 5420 4954 2044 4f45 532e 0a20   WHAT IT DOES.. 
│ │ │ │ │ -000143b0: 2020 2020 436f 7079 7269 6768 7420 2843      Copyright (C
│ │ │ │ │ -000143c0: 2920 5959 5959 2020 4e41 4d45 204f 4620  ) YYYY  NAME OF 
│ │ │ │ │ -000143d0: 4155 5448 4f52 0a0a 2020 2020 2054 6869  AUTHOR..     Thi
│ │ │ │ │ -000143e0: 7320 7072 6f67 7261 6d20 6973 2066 7265  s program is fre
│ │ │ │ │ -000143f0: 6520 736f 6674 7761 7265 3b20 796f 7520  e software; you 
│ │ │ │ │ -00014400: 6361 6e20 7265 6469 7374 7269 6275 7465  can redistribute
│ │ │ │ │ -00014410: 2069 7420 616e 642f 6f72 206d 6f64 6966   it and/or modif
│ │ │ │ │ -00014420: 790a 2020 2020 2069 7420 756e 6465 7220  y.     it under 
│ │ │ │ │ -00014430: 7468 6520 7465 726d 7320 6f66 2074 6865  the terms of the
│ │ │ │ │ -00014440: 2047 4e55 2047 656e 6572 616c 2050 7562   GNU General Pub
│ │ │ │ │ -00014450: 6c69 6320 4c69 6365 6e73 6520 6173 2070  lic License as p
│ │ │ │ │ -00014460: 7562 6c69 7368 6564 2062 790a 2020 2020  ublished by.    
│ │ │ │ │ -00014470: 2074 6865 2046 7265 6520 536f 6674 7761   the Free Softwa
│ │ │ │ │ -00014480: 7265 2046 6f75 6e64 6174 696f 6e3b 2065  re Foundation; e
│ │ │ │ │ -00014490: 6974 6865 7220 7665 7273 696f 6e20 3220  ither version 2 
│ │ │ │ │ -000144a0: 6f66 2074 6865 204c 6963 656e 7365 2c20  of the License, 
│ │ │ │ │ -000144b0: 6f72 0a20 2020 2020 2861 7420 796f 7572  or.     (at your
│ │ │ │ │ -000144c0: 206f 7074 696f 6e29 2061 6e79 206c 6174   option) any lat
│ │ │ │ │ -000144d0: 6572 2076 6572 7369 6f6e 2e0a 0a20 2020  er version...   
│ │ │ │ │ -000144e0: 2020 5468 6973 2070 726f 6772 616d 2069    This program i
│ │ │ │ │ -000144f0: 7320 6469 7374 7269 6275 7465 6420 696e  s distributed in
│ │ │ │ │ -00014500: 2074 6865 2068 6f70 6520 7468 6174 2069   the hope that i
│ │ │ │ │ -00014510: 7420 7769 6c6c 2062 6520 7573 6566 756c  t will be useful
│ │ │ │ │ -00014520: 2c0a 2020 2020 2062 7574 2057 4954 484f  ,.     but WITHO
│ │ │ │ │ -00014530: 5554 2041 4e59 2057 4152 5241 4e54 593b  UT ANY WARRANTY;
│ │ │ │ │ -00014540: 2077 6974 686f 7574 2065 7665 6e20 7468   without even th
│ │ │ │ │ -00014550: 6520 696d 706c 6965 6420 7761 7272 616e  e implied warran
│ │ │ │ │ -00014560: 7479 206f 660a 2020 2020 204d 4552 4348  ty of.     MERCH
│ │ │ │ │ -00014570: 414e 5441 4249 4c49 5459 206f 7220 4649  ANTABILITY or FI
│ │ │ │ │ -00014580: 544e 4553 5320 464f 5220 4120 5041 5254  TNESS FOR A PART
│ │ │ │ │ -00014590: 4943 554c 4152 2050 5552 504f 5345 2e20  ICULAR PURPOSE. 
│ │ │ │ │ -000145a0: 2053 6565 2074 6865 0a20 2020 2020 474e   See the.     GN
│ │ │ │ │ -000145b0: 5520 4765 6e65 7261 6c20 5075 626c 6963  U General Public
│ │ │ │ │ -000145c0: 204c 6963 656e 7365 2066 6f72 206d 6f72   License for mor
│ │ │ │ │ -000145d0: 6520 6465 7461 696c 732e 0a0a 2020 2020  e details...    
│ │ │ │ │ -000145e0: 2059 6f75 2073 686f 756c 6420 6861 7665   You should have
│ │ │ │ │ -000145f0: 2072 6563 6569 7665 6420 6120 636f 7079   received a copy
│ │ │ │ │ -00014600: 206f 6620 7468 6520 474e 5520 4765 6e65   of the GNU Gene
│ │ │ │ │ -00014610: 7261 6c20 5075 626c 6963 204c 6963 656e  ral Public Licen
│ │ │ │ │ -00014620: 7365 0a20 2020 2020 616c 6f6e 6720 7769  se.     along wi
│ │ │ │ │ -00014630: 7468 2074 6869 7320 7072 6f67 7261 6d3b  th this program;
│ │ │ │ │ -00014640: 2069 6620 6e6f 742c 2077 7269 7465 2074   if not, write t
│ │ │ │ │ -00014650: 6f20 7468 6520 4672 6565 2053 6f66 7477  o the Free Softw
│ │ │ │ │ -00014660: 6172 650a 2020 2020 2046 6f75 6e64 6174  are.     Foundat
│ │ │ │ │ -00014670: 696f 6e2c 2049 6e63 2e2c 2035 3120 4672  ion, Inc., 51 Fr
│ │ │ │ │ -00014680: 616e 6b6c 696e 2053 7472 6565 742c 2046  anklin Street, F
│ │ │ │ │ -00014690: 6966 7468 2046 6c6f 6f72 2c20 426f 7374  ifth Floor, Bost
│ │ │ │ │ -000146a0: 6f6e 2c20 4d41 2020 3032 3131 302d 3133  on, MA  02110-13
│ │ │ │ │ -000146b0: 3031 2c20 5553 412e 0a0a 2020 2041 6c73  01, USA...   Als
│ │ │ │ │ -000146c0: 6f20 6164 6420 696e 666f 726d 6174 696f  o add informatio
│ │ │ │ │ -000146d0: 6e20 6f6e 2068 6f77 2074 6f20 636f 6e74  n on how to cont
│ │ │ │ │ -000146e0: 6163 7420 796f 7520 6279 2065 6c65 6374  act you by elect
│ │ │ │ │ -000146f0: 726f 6e69 6320 616e 6420 7061 7065 720a  ronic and paper.
│ │ │ │ │ -00014700: 6d61 696c 2e0a 0a20 2020 4966 2074 6865  mail...   If the
│ │ │ │ │ -00014710: 2070 726f 6772 616d 2069 7320 696e 7465   program is inte
│ │ │ │ │ -00014720: 7261 6374 6976 652c 206d 616b 6520 6974  ractive, make it
│ │ │ │ │ -00014730: 206f 7574 7075 7420 6120 7368 6f72 7420   output a short 
│ │ │ │ │ -00014740: 6e6f 7469 6365 206c 696b 650a 7468 6973  notice like.this
│ │ │ │ │ -00014750: 2077 6865 6e20 6974 2073 7461 7274 7320   when it starts 
│ │ │ │ │ -00014760: 696e 2061 6e20 696e 7465 7261 6374 6976  in an interactiv
│ │ │ │ │ -00014770: 6520 6d6f 6465 3a0a 0a20 2020 2020 476e  e mode:..     Gn
│ │ │ │ │ -00014780: 6f6d 6f76 6973 696f 6e20 7665 7273 696f  omovision versio
│ │ │ │ │ -00014790: 6e20 3639 2c20 436f 7079 7269 6768 7420  n 69, Copyright 
│ │ │ │ │ -000147a0: 2843 2920 5945 4152 204e 414d 4520 4f46  (C) YEAR NAME OF
│ │ │ │ │ -000147b0: 2041 5554 484f 520a 2020 2020 2047 6e6f   AUTHOR.     Gno
│ │ │ │ │ -000147c0: 6d6f 7669 7369 6f6e 2063 6f6d 6573 2077  movision comes w
│ │ │ │ │ -000147d0: 6974 6820 4142 534f 4c55 5445 4c59 204e  ith ABSOLUTELY N
│ │ │ │ │ -000147e0: 4f20 5741 5252 414e 5459 3b20 666f 7220  O WARRANTY; for 
│ │ │ │ │ -000147f0: 6465 7461 696c 7320 7479 7065 2060 7368  details type `sh
│ │ │ │ │ -00014800: 6f77 2077 272e 0a20 2020 2020 5468 6973  ow w'..     This
│ │ │ │ │ -00014810: 2069 7320 6672 6565 2073 6f66 7477 6172   is free softwar
│ │ │ │ │ -00014820: 652c 2061 6e64 2079 6f75 2061 7265 2077  e, and you are w
│ │ │ │ │ -00014830: 656c 636f 6d65 2074 6f20 7265 6469 7374  elcome to redist
│ │ │ │ │ -00014840: 7269 6275 7465 2069 740a 2020 2020 2075  ribute it.     u
│ │ │ │ │ -00014850: 6e64 6572 2063 6572 7461 696e 2063 6f6e  nder certain con
│ │ │ │ │ -00014860: 6469 7469 6f6e 733b 2074 7970 6520 6073  ditions; type `s
│ │ │ │ │ -00014870: 686f 7720 6327 2066 6f72 2064 6574 6169  how c' for detai
│ │ │ │ │ -00014880: 6c73 2e0a 0a20 2020 5468 6520 6879 706f  ls...   The hypo
│ │ │ │ │ -00014890: 7468 6574 6963 616c 2063 6f6d 6d61 6e64  thetical command
│ │ │ │ │ -000148a0: 7320 2773 686f 7720 7727 2061 6e64 2027  s 'show w' and '
│ │ │ │ │ -000148b0: 7368 6f77 2063 2720 7368 6f75 6c64 2073  show c' should s
│ │ │ │ │ -000148c0: 686f 7720 7468 650a 6170 7072 6f70 7269  how the.appropri
│ │ │ │ │ -000148d0: 6174 6520 7061 7274 7320 6f66 2074 6865  ate parts of the
│ │ │ │ │ -000148e0: 2047 656e 6572 616c 2050 7562 6c69 6320   General Public 
│ │ │ │ │ -000148f0: 4c69 6365 6e73 652e 2020 4f66 2063 6f75  License.  Of cou
│ │ │ │ │ -00014900: 7273 652c 2074 6865 0a63 6f6d 6d61 6e64  rse, the.command
│ │ │ │ │ -00014910: 7320 796f 7520 7573 6520 6d61 7920 6265  s you use may be
│ │ │ │ │ -00014920: 2063 616c 6c65 6420 736f 6d65 7468 696e   called somethin
│ │ │ │ │ -00014930: 6720 6f74 6865 7220 7468 616e 2027 7368  g other than 'sh
│ │ │ │ │ -00014940: 6f77 2077 2720 616e 6420 2773 686f 770a  ow w' and 'show.
│ │ │ │ │ -00014950: 6327 3b20 7468 6579 2063 6f75 6c64 2065  c'; they could e
│ │ │ │ │ -00014960: 7665 6e20 6265 206d 6f75 7365 2d63 6c69  ven be mouse-cli
│ │ │ │ │ -00014970: 636b 7320 6f72 206d 656e 7520 6974 656d  cks or menu item
│ │ │ │ │ -00014980: 732d 2d77 6861 7465 7665 7220 7375 6974  s--whatever suit
│ │ │ │ │ -00014990: 7320 796f 7572 0a70 726f 6772 616d 2e0a  s your.program..
│ │ │ │ │ -000149a0: 0a20 2020 596f 7520 7368 6f75 6c64 2061  .   You should a
│ │ │ │ │ -000149b0: 6c73 6f20 6765 7420 796f 7572 2065 6d70  lso get your emp
│ │ │ │ │ -000149c0: 6c6f 7965 7220 2869 6620 796f 7520 776f  loyer (if you wo
│ │ │ │ │ -000149d0: 726b 2061 7320 6120 7072 6f67 7261 6d6d  rk as a programm
│ │ │ │ │ -000149e0: 6572 2920 6f72 0a79 6f75 7220 7363 686f  er) or.your scho
│ │ │ │ │ -000149f0: 6f6c 2c20 6966 2061 6e79 2c20 746f 2073  ol, if any, to s
│ │ │ │ │ -00014a00: 6967 6e20 6120 2263 6f70 7972 6967 6874  ign a "copyright
│ │ │ │ │ -00014a10: 2064 6973 636c 6169 6d65 7222 2066 6f72   disclaimer" for
│ │ │ │ │ -00014a20: 2074 6865 2070 726f 6772 616d 2c0a 6966   the program,.if
│ │ │ │ │ -00014a30: 206e 6563 6573 7361 7279 2e20 2048 6572   necessary.  Her
│ │ │ │ │ -00014a40: 6520 6973 2061 2073 616d 706c 653b 2061  e is a sample; a
│ │ │ │ │ -00014a50: 6c74 6572 2074 6865 206e 616d 6573 3a0a  lter the names:.
│ │ │ │ │ -00014a60: 0a20 2020 2020 596f 796f 6479 6e65 2c20  .     Yoyodyne, 
│ │ │ │ │ -00014a70: 496e 632e 2c20 6865 7265 6279 2064 6973  Inc., hereby dis
│ │ │ │ │ -00014a80: 636c 6169 6d73 2061 6c6c 2063 6f70 7972  claims all copyr
│ │ │ │ │ -00014a90: 6967 6874 2069 6e74 6572 6573 7420 696e  ight interest in
│ │ │ │ │ -00014aa0: 2074 6865 2070 726f 6772 616d 0a20 2020   the program.   
│ │ │ │ │ -00014ab0: 2020 6047 6e6f 6d6f 7669 7369 6f6e 2720    `Gnomovision' 
│ │ │ │ │ -00014ac0: 2877 6869 6368 206d 616b 6573 2070 6173  (which makes pas
│ │ │ │ │ -00014ad0: 7365 7320 6174 2063 6f6d 7069 6c65 7273  ses at compilers
│ │ │ │ │ -00014ae0: 2920 7772 6974 7465 6e20 6279 204a 616d  ) written by Jam
│ │ │ │ │ -00014af0: 6573 2048 6163 6b65 722e 0a0a 2020 2020  es Hacker...    
│ │ │ │ │ -00014b00: 2053 4947 4e41 5455 5245 204f 4620 5459   SIGNATURE OF TY
│ │ │ │ │ -00014b10: 2043 4f4f 4e2c 2031 2041 7072 696c 2031   COON, 1 April 1
│ │ │ │ │ -00014b20: 3938 390a 2020 2020 2054 7920 436f 6f6e  989.     Ty Coon
│ │ │ │ │ -00014b30: 2c20 5072 6573 6964 656e 7420 6f66 2056  , President of V
│ │ │ │ │ -00014b40: 6963 650a 0a20 2020 5468 6973 2047 656e  ice..   This Gen
│ │ │ │ │ -00014b50: 6572 616c 2050 7562 6c69 6320 4c69 6365  eral Public Lice
│ │ │ │ │ -00014b60: 6e73 6520 646f 6573 206e 6f74 2070 6572  nse does not per
│ │ │ │ │ -00014b70: 6d69 7420 696e 636f 7270 6f72 6174 696e  mit incorporatin
│ │ │ │ │ -00014b80: 6720 796f 7572 0a70 726f 6772 616d 2069  g your.program i
│ │ │ │ │ -00014b90: 6e74 6f20 7072 6f70 7269 6574 6172 7920  nto proprietary 
│ │ │ │ │ -00014ba0: 7072 6f67 7261 6d73 2e20 2049 6620 796f  programs.  If yo
│ │ │ │ │ -00014bb0: 7572 2070 726f 6772 616d 2069 7320 6120  ur program is a 
│ │ │ │ │ -00014bc0: 7375 6272 6f75 7469 6e65 0a6c 6962 7261  subroutine.libra
│ │ │ │ │ -00014bd0: 7279 2c20 796f 7520 6d61 7920 636f 6e73  ry, you may cons
│ │ │ │ │ -00014be0: 6964 6572 2069 7420 6d6f 7265 2075 7365  ider it more use
│ │ │ │ │ -00014bf0: 6675 6c20 746f 2070 6572 6d69 7420 6c69  ful to permit li
│ │ │ │ │ -00014c00: 6e6b 696e 6720 7072 6f70 7269 6574 6172  nking proprietar
│ │ │ │ │ -00014c10: 790a 6170 706c 6963 6174 696f 6e73 2077  y.applications w
│ │ │ │ │ -00014c20: 6974 6820 7468 6520 6c69 6272 6172 792e  ith the library.
│ │ │ │ │ -00014c30: 2020 4966 2074 6869 7320 6973 2077 6861    If this is wha
│ │ │ │ │ -00014c40: 7420 796f 7520 7761 6e74 2074 6f20 646f  t you want to do
│ │ │ │ │ -00014c50: 2c20 7573 6520 7468 650a 474e 5520 4c65  , use the.GNU Le
│ │ │ │ │ -00014c60: 7373 6572 2047 656e 6572 616c 2050 7562  sser General Pub
│ │ │ │ │ -00014c70: 6c69 6320 4c69 6365 6e73 6520 696e 7374  lic License inst
│ │ │ │ │ -00014c80: 6561 6420 6f66 2074 6869 7320 4c69 6365  ead of this Lice
│ │ │ │ │ -00014c90: 6e73 652e 0a0a 1f0a 4669 6c65 3a20 6c69  nse.....File: li
│ │ │ │ │ -00014ca0: 6266 6b6f 2e69 6e66 6f2c 2020 4e6f 6465  bfko.info,  Node
│ │ │ │ │ -00014cb0: 3a20 436f 6e63 6570 7420 496e 6465 782c  : Concept Index,
│ │ │ │ │ -00014cc0: 2020 4e65 7874 3a20 4675 6e63 7469 6f6e    Next: Function
│ │ │ │ │ -00014cd0: 2061 6e64 2044 6174 6120 496e 6465 782c   and Data Index,
│ │ │ │ │ -00014ce0: 2020 5072 6576 3a20 4c69 6272 6172 7920    Prev: Library 
│ │ │ │ │ -00014cf0: 436f 7079 696e 672c 2020 5570 3a20 546f  Copying,  Up: To
│ │ │ │ │ -00014d00: 700a 0a43 6f6e 6365 7074 2049 6e64 6578  p..Concept Index
│ │ │ │ │ -00014d10: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a  .*************..
│ │ │ │ │ -00014d20: 0008 5b69 6e64 6578 0008 5d0a 2a20 4d65  ..[index..].* Me
│ │ │ │ │ -00014d30: 6e75 3a0a 0a2a 2063 6f6d 7069 6c69 6e67  nu:..* compiling
│ │ │ │ │ -00014d40: 2c20 7769 7468 206c 6962 666b 6f3a 2020  , with libfko:  
│ │ │ │ │ -00014d50: 2020 2020 2020 2020 2020 2020 2020 436f                Co
│ │ │ │ │ -00014d60: 6d70 696c 696e 6720 7769 7468 206c 6962  mpiling with lib
│ │ │ │ │ -00014d70: 666b 6f2e 0a20 2020 2020 2020 2020 2020  fko..           
│ │ │ │ │ +00014170: 0a0a 4966 2079 6f75 2064 6576 656c 6f70  ..If you develop
│ │ │ │ │ +00014180: 2061 206e 6577 2070 726f 6772 616d 2c20   a new program, 
│ │ │ │ │ +00014190: 616e 6420 796f 7520 7761 6e74 2069 7420  and you want it 
│ │ │ │ │ +000141a0: 746f 2062 6520 6f66 2074 6865 2067 7265  to be of the gre
│ │ │ │ │ +000141b0: 6174 6573 740a 706f 7373 6962 6c65 2075  atest.possible u
│ │ │ │ │ +000141c0: 7365 2074 6f20 7468 6520 7075 626c 6963  se to the public
│ │ │ │ │ +000141d0: 2c20 7468 6520 6265 7374 2077 6179 2074  , the best way t
│ │ │ │ │ +000141e0: 6f20 6163 6869 6576 6520 7468 6973 2069  o achieve this i
│ │ │ │ │ +000141f0: 7320 746f 206d 616b 6520 6974 0a66 7265  s to make it.fre
│ │ │ │ │ +00014200: 6520 736f 6674 7761 7265 2077 6869 6368  e software which
│ │ │ │ │ +00014210: 2065 7665 7279 6f6e 6520 6361 6e20 7265   everyone can re
│ │ │ │ │ +00014220: 6469 7374 7269 6275 7465 2061 6e64 2063  distribute and c
│ │ │ │ │ +00014230: 6861 6e67 6520 756e 6465 7220 7468 6573  hange under thes
│ │ │ │ │ +00014240: 650a 7465 726d 732e 0a0a 2020 2054 6f20  e.terms...   To 
│ │ │ │ │ +00014250: 646f 2073 6f2c 2061 7474 6163 6820 7468  do so, attach th
│ │ │ │ │ +00014260: 6520 666f 6c6c 6f77 696e 6720 6e6f 7469  e following noti
│ │ │ │ │ +00014270: 6365 7320 746f 2074 6865 2070 726f 6772  ces to the progr
│ │ │ │ │ +00014280: 616d 2e20 2049 7420 6973 2073 6166 6573  am.  It is safes
│ │ │ │ │ +00014290: 740a 746f 2061 7474 6163 6820 7468 656d  t.to attach them
│ │ │ │ │ +000142a0: 2074 6f20 7468 6520 7374 6172 7420 6f66   to the start of
│ │ │ │ │ +000142b0: 2065 6163 6820 736f 7572 6365 2066 696c   each source fil
│ │ │ │ │ +000142c0: 6520 746f 206d 6f73 7420 6566 6665 6374  e to most effect
│ │ │ │ │ +000142d0: 6976 656c 790a 636f 6e76 6579 2074 6865  ively.convey the
│ │ │ │ │ +000142e0: 2065 7863 6c75 7369 6f6e 206f 6620 7761   exclusion of wa
│ │ │ │ │ +000142f0: 7272 616e 7479 3b20 616e 6420 6561 6368  rranty; and each
│ │ │ │ │ +00014300: 2066 696c 6520 7368 6f75 6c64 2068 6176   file should hav
│ │ │ │ │ +00014310: 6520 6174 206c 6561 7374 2074 6865 0a22  e at least the."
│ │ │ │ │ +00014320: 636f 7079 7269 6768 7422 206c 696e 6520  copyright" line 
│ │ │ │ │ +00014330: 616e 6420 6120 706f 696e 7465 7220 746f  and a pointer to
│ │ │ │ │ +00014340: 2077 6865 7265 2074 6865 2066 756c 6c20   where the full 
│ │ │ │ │ +00014350: 6e6f 7469 6365 2069 7320 666f 756e 642e  notice is found.
│ │ │ │ │ +00014360: 0a0a 2020 2020 204f 4e45 204c 494e 4520  ..     ONE LINE 
│ │ │ │ │ +00014370: 544f 2047 4956 4520 5448 4520 5052 4f47  TO GIVE THE PROG
│ │ │ │ │ +00014380: 5241 4d27 5320 4e41 4d45 2041 4e44 2041  RAM'S NAME AND A
│ │ │ │ │ +00014390: 2042 5249 4546 2049 4445 4120 4f46 2057   BRIEF IDEA OF W
│ │ │ │ │ +000143a0: 4841 5420 4954 2044 4f45 532e 0a20 2020  HAT IT DOES..   
│ │ │ │ │ +000143b0: 2020 436f 7079 7269 6768 7420 2843 2920    Copyright (C) 
│ │ │ │ │ +000143c0: 5959 5959 2020 4e41 4d45 204f 4620 4155  YYYY  NAME OF AU
│ │ │ │ │ +000143d0: 5448 4f52 0a0a 2020 2020 2054 6869 7320  THOR..     This 
│ │ │ │ │ +000143e0: 7072 6f67 7261 6d20 6973 2066 7265 6520  program is free 
│ │ │ │ │ +000143f0: 736f 6674 7761 7265 3b20 796f 7520 6361  software; you ca
│ │ │ │ │ +00014400: 6e20 7265 6469 7374 7269 6275 7465 2069  n redistribute i
│ │ │ │ │ +00014410: 7420 616e 642f 6f72 206d 6f64 6966 790a  t and/or modify.
│ │ │ │ │ +00014420: 2020 2020 2069 7420 756e 6465 7220 7468       it under th
│ │ │ │ │ +00014430: 6520 7465 726d 7320 6f66 2074 6865 2047  e terms of the G
│ │ │ │ │ +00014440: 4e55 2047 656e 6572 616c 2050 7562 6c69  NU General Publi
│ │ │ │ │ +00014450: 6320 4c69 6365 6e73 6520 6173 2070 7562  c License as pub
│ │ │ │ │ +00014460: 6c69 7368 6564 2062 790a 2020 2020 2074  lished by.     t
│ │ │ │ │ +00014470: 6865 2046 7265 6520 536f 6674 7761 7265  he Free Software
│ │ │ │ │ +00014480: 2046 6f75 6e64 6174 696f 6e3b 2065 6974   Foundation; eit
│ │ │ │ │ +00014490: 6865 7220 7665 7273 696f 6e20 3220 6f66  her version 2 of
│ │ │ │ │ +000144a0: 2074 6865 204c 6963 656e 7365 2c20 6f72   the License, or
│ │ │ │ │ +000144b0: 0a20 2020 2020 2861 7420 796f 7572 206f  .     (at your o
│ │ │ │ │ +000144c0: 7074 696f 6e29 2061 6e79 206c 6174 6572  ption) any later
│ │ │ │ │ +000144d0: 2076 6572 7369 6f6e 2e0a 0a20 2020 2020   version...     
│ │ │ │ │ +000144e0: 5468 6973 2070 726f 6772 616d 2069 7320  This program is 
│ │ │ │ │ +000144f0: 6469 7374 7269 6275 7465 6420 696e 2074  distributed in t
│ │ │ │ │ +00014500: 6865 2068 6f70 6520 7468 6174 2069 7420  he hope that it 
│ │ │ │ │ +00014510: 7769 6c6c 2062 6520 7573 6566 756c 2c0a  will be useful,.
│ │ │ │ │ +00014520: 2020 2020 2062 7574 2057 4954 484f 5554       but WITHOUT
│ │ │ │ │ +00014530: 2041 4e59 2057 4152 5241 4e54 593b 2077   ANY WARRANTY; w
│ │ │ │ │ +00014540: 6974 686f 7574 2065 7665 6e20 7468 6520  ithout even the 
│ │ │ │ │ +00014550: 696d 706c 6965 6420 7761 7272 616e 7479  implied warranty
│ │ │ │ │ +00014560: 206f 660a 2020 2020 204d 4552 4348 414e   of.     MERCHAN
│ │ │ │ │ +00014570: 5441 4249 4c49 5459 206f 7220 4649 544e  TABILITY or FITN
│ │ │ │ │ +00014580: 4553 5320 464f 5220 4120 5041 5254 4943  ESS FOR A PARTIC
│ │ │ │ │ +00014590: 554c 4152 2050 5552 504f 5345 2e20 2053  ULAR PURPOSE.  S
│ │ │ │ │ +000145a0: 6565 2074 6865 0a20 2020 2020 474e 5520  ee the.     GNU 
│ │ │ │ │ +000145b0: 4765 6e65 7261 6c20 5075 626c 6963 204c  General Public L
│ │ │ │ │ +000145c0: 6963 656e 7365 2066 6f72 206d 6f72 6520  icense for more 
│ │ │ │ │ +000145d0: 6465 7461 696c 732e 0a0a 2020 2020 2059  details...     Y
│ │ │ │ │ +000145e0: 6f75 2073 686f 756c 6420 6861 7665 2072  ou should have r
│ │ │ │ │ +000145f0: 6563 6569 7665 6420 6120 636f 7079 206f  eceived a copy o
│ │ │ │ │ +00014600: 6620 7468 6520 474e 5520 4765 6e65 7261  f the GNU Genera
│ │ │ │ │ +00014610: 6c20 5075 626c 6963 204c 6963 656e 7365  l Public License
│ │ │ │ │ +00014620: 0a20 2020 2020 616c 6f6e 6720 7769 7468  .     along with
│ │ │ │ │ +00014630: 2074 6869 7320 7072 6f67 7261 6d3b 2069   this program; i
│ │ │ │ │ +00014640: 6620 6e6f 742c 2077 7269 7465 2074 6f20  f not, write to 
│ │ │ │ │ +00014650: 7468 6520 4672 6565 2053 6f66 7477 6172  the Free Softwar
│ │ │ │ │ +00014660: 650a 2020 2020 2046 6f75 6e64 6174 696f  e.     Foundatio
│ │ │ │ │ +00014670: 6e2c 2049 6e63 2e2c 2035 3120 4672 616e  n, Inc., 51 Fran
│ │ │ │ │ +00014680: 6b6c 696e 2053 7472 6565 742c 2046 6966  klin Street, Fif
│ │ │ │ │ +00014690: 7468 2046 6c6f 6f72 2c20 426f 7374 6f6e  th Floor, Boston
│ │ │ │ │ +000146a0: 2c20 4d41 2020 3032 3131 302d 3133 3031  , MA  02110-1301
│ │ │ │ │ +000146b0: 2c20 5553 412e 0a0a 2020 2041 6c73 6f20  , USA...   Also 
│ │ │ │ │ +000146c0: 6164 6420 696e 666f 726d 6174 696f 6e20  add information 
│ │ │ │ │ +000146d0: 6f6e 2068 6f77 2074 6f20 636f 6e74 6163  on how to contac
│ │ │ │ │ +000146e0: 7420 796f 7520 6279 2065 6c65 6374 726f  t you by electro
│ │ │ │ │ +000146f0: 6e69 6320 616e 6420 7061 7065 720a 6d61  nic and paper.ma
│ │ │ │ │ +00014700: 696c 2e0a 0a20 2020 4966 2074 6865 2070  il...   If the p
│ │ │ │ │ +00014710: 726f 6772 616d 2069 7320 696e 7465 7261  rogram is intera
│ │ │ │ │ +00014720: 6374 6976 652c 206d 616b 6520 6974 206f  ctive, make it o
│ │ │ │ │ +00014730: 7574 7075 7420 6120 7368 6f72 7420 6e6f  utput a short no
│ │ │ │ │ +00014740: 7469 6365 206c 696b 650a 7468 6973 2077  tice like.this w
│ │ │ │ │ +00014750: 6865 6e20 6974 2073 7461 7274 7320 696e  hen it starts in
│ │ │ │ │ +00014760: 2061 6e20 696e 7465 7261 6374 6976 6520   an interactive 
│ │ │ │ │ +00014770: 6d6f 6465 3a0a 0a20 2020 2020 476e 6f6d  mode:..     Gnom
│ │ │ │ │ +00014780: 6f76 6973 696f 6e20 7665 7273 696f 6e20  ovision version 
│ │ │ │ │ +00014790: 3639 2c20 436f 7079 7269 6768 7420 2843  69, Copyright (C
│ │ │ │ │ +000147a0: 2920 5945 4152 204e 414d 4520 4f46 2041  ) YEAR NAME OF A
│ │ │ │ │ +000147b0: 5554 484f 520a 2020 2020 2047 6e6f 6d6f  UTHOR.     Gnomo
│ │ │ │ │ +000147c0: 7669 7369 6f6e 2063 6f6d 6573 2077 6974  vision comes wit
│ │ │ │ │ +000147d0: 6820 4142 534f 4c55 5445 4c59 204e 4f20  h ABSOLUTELY NO 
│ │ │ │ │ +000147e0: 5741 5252 414e 5459 3b20 666f 7220 6465  WARRANTY; for de
│ │ │ │ │ +000147f0: 7461 696c 7320 7479 7065 2060 7368 6f77  tails type `show
│ │ │ │ │ +00014800: 2077 272e 0a20 2020 2020 5468 6973 2069   w'..     This i
│ │ │ │ │ +00014810: 7320 6672 6565 2073 6f66 7477 6172 652c  s free software,
│ │ │ │ │ +00014820: 2061 6e64 2079 6f75 2061 7265 2077 656c   and you are wel
│ │ │ │ │ +00014830: 636f 6d65 2074 6f20 7265 6469 7374 7269  come to redistri
│ │ │ │ │ +00014840: 6275 7465 2069 740a 2020 2020 2075 6e64  bute it.     und
│ │ │ │ │ +00014850: 6572 2063 6572 7461 696e 2063 6f6e 6469  er certain condi
│ │ │ │ │ +00014860: 7469 6f6e 733b 2074 7970 6520 6073 686f  tions; type `sho
│ │ │ │ │ +00014870: 7720 6327 2066 6f72 2064 6574 6169 6c73  w c' for details
│ │ │ │ │ +00014880: 2e0a 0a20 2020 5468 6520 6879 706f 7468  ...   The hypoth
│ │ │ │ │ +00014890: 6574 6963 616c 2063 6f6d 6d61 6e64 7320  etical commands 
│ │ │ │ │ +000148a0: 2773 686f 7720 7727 2061 6e64 2027 7368  'show w' and 'sh
│ │ │ │ │ +000148b0: 6f77 2063 2720 7368 6f75 6c64 2073 686f  ow c' should sho
│ │ │ │ │ +000148c0: 7720 7468 650a 6170 7072 6f70 7269 6174  w the.appropriat
│ │ │ │ │ +000148d0: 6520 7061 7274 7320 6f66 2074 6865 2047  e parts of the G
│ │ │ │ │ +000148e0: 656e 6572 616c 2050 7562 6c69 6320 4c69  eneral Public Li
│ │ │ │ │ +000148f0: 6365 6e73 652e 2020 4f66 2063 6f75 7273  cense.  Of cours
│ │ │ │ │ +00014900: 652c 2074 6865 0a63 6f6d 6d61 6e64 7320  e, the.commands 
│ │ │ │ │ +00014910: 796f 7520 7573 6520 6d61 7920 6265 2063  you use may be c
│ │ │ │ │ +00014920: 616c 6c65 6420 736f 6d65 7468 696e 6720  alled something 
│ │ │ │ │ +00014930: 6f74 6865 7220 7468 616e 2027 7368 6f77  other than 'show
│ │ │ │ │ +00014940: 2077 2720 616e 6420 2773 686f 770a 6327   w' and 'show.c'
│ │ │ │ │ +00014950: 3b20 7468 6579 2063 6f75 6c64 2065 7665  ; they could eve
│ │ │ │ │ +00014960: 6e20 6265 206d 6f75 7365 2d63 6c69 636b  n be mouse-click
│ │ │ │ │ +00014970: 7320 6f72 206d 656e 7520 6974 656d 732d  s or menu items-
│ │ │ │ │ +00014980: 2d77 6861 7465 7665 7220 7375 6974 7320  -whatever suits 
│ │ │ │ │ +00014990: 796f 7572 0a70 726f 6772 616d 2e0a 0a20  your.program... 
│ │ │ │ │ +000149a0: 2020 596f 7520 7368 6f75 6c64 2061 6c73    You should als
│ │ │ │ │ +000149b0: 6f20 6765 7420 796f 7572 2065 6d70 6c6f  o get your emplo
│ │ │ │ │ +000149c0: 7965 7220 2869 6620 796f 7520 776f 726b  yer (if you work
│ │ │ │ │ +000149d0: 2061 7320 6120 7072 6f67 7261 6d6d 6572   as a programmer
│ │ │ │ │ +000149e0: 2920 6f72 0a79 6f75 7220 7363 686f 6f6c  ) or.your school
│ │ │ │ │ +000149f0: 2c20 6966 2061 6e79 2c20 746f 2073 6967  , if any, to sig
│ │ │ │ │ +00014a00: 6e20 6120 2263 6f70 7972 6967 6874 2064  n a "copyright d
│ │ │ │ │ +00014a10: 6973 636c 6169 6d65 7222 2066 6f72 2074  isclaimer" for t
│ │ │ │ │ +00014a20: 6865 2070 726f 6772 616d 2c0a 6966 206e  he program,.if n
│ │ │ │ │ +00014a30: 6563 6573 7361 7279 2e20 2048 6572 6520  ecessary.  Here 
│ │ │ │ │ +00014a40: 6973 2061 2073 616d 706c 653b 2061 6c74  is a sample; alt
│ │ │ │ │ +00014a50: 6572 2074 6865 206e 616d 6573 3a0a 0a20  er the names:.. 
│ │ │ │ │ +00014a60: 2020 2020 596f 796f 6479 6e65 2c20 496e      Yoyodyne, In
│ │ │ │ │ +00014a70: 632e 2c20 6865 7265 6279 2064 6973 636c  c., hereby discl
│ │ │ │ │ +00014a80: 6169 6d73 2061 6c6c 2063 6f70 7972 6967  aims all copyrig
│ │ │ │ │ +00014a90: 6874 2069 6e74 6572 6573 7420 696e 2074  ht interest in t
│ │ │ │ │ +00014aa0: 6865 2070 726f 6772 616d 0a20 2020 2020  he program.     
│ │ │ │ │ +00014ab0: 6047 6e6f 6d6f 7669 7369 6f6e 2720 2877  `Gnomovision' (w
│ │ │ │ │ +00014ac0: 6869 6368 206d 616b 6573 2070 6173 7365  hich makes passe
│ │ │ │ │ +00014ad0: 7320 6174 2063 6f6d 7069 6c65 7273 2920  s at compilers) 
│ │ │ │ │ +00014ae0: 7772 6974 7465 6e20 6279 204a 616d 6573  written by James
│ │ │ │ │ +00014af0: 2048 6163 6b65 722e 0a0a 2020 2020 2053   Hacker...     S
│ │ │ │ │ +00014b00: 4947 4e41 5455 5245 204f 4620 5459 2043  IGNATURE OF TY C
│ │ │ │ │ +00014b10: 4f4f 4e2c 2031 2041 7072 696c 2031 3938  OON, 1 April 198
│ │ │ │ │ +00014b20: 390a 2020 2020 2054 7920 436f 6f6e 2c20  9.     Ty Coon, 
│ │ │ │ │ +00014b30: 5072 6573 6964 656e 7420 6f66 2056 6963  President of Vic
│ │ │ │ │ +00014b40: 650a 0a20 2020 5468 6973 2047 656e 6572  e..   This Gener
│ │ │ │ │ +00014b50: 616c 2050 7562 6c69 6320 4c69 6365 6e73  al Public Licens
│ │ │ │ │ +00014b60: 6520 646f 6573 206e 6f74 2070 6572 6d69  e does not permi
│ │ │ │ │ +00014b70: 7420 696e 636f 7270 6f72 6174 696e 6720  t incorporating 
│ │ │ │ │ +00014b80: 796f 7572 0a70 726f 6772 616d 2069 6e74  your.program int
│ │ │ │ │ +00014b90: 6f20 7072 6f70 7269 6574 6172 7920 7072  o proprietary pr
│ │ │ │ │ +00014ba0: 6f67 7261 6d73 2e20 2049 6620 796f 7572  ograms.  If your
│ │ │ │ │ +00014bb0: 2070 726f 6772 616d 2069 7320 6120 7375   program is a su
│ │ │ │ │ +00014bc0: 6272 6f75 7469 6e65 0a6c 6962 7261 7279  broutine.library
│ │ │ │ │ +00014bd0: 2c20 796f 7520 6d61 7920 636f 6e73 6964  , you may consid
│ │ │ │ │ +00014be0: 6572 2069 7420 6d6f 7265 2075 7365 6675  er it more usefu
│ │ │ │ │ +00014bf0: 6c20 746f 2070 6572 6d69 7420 6c69 6e6b  l to permit link
│ │ │ │ │ +00014c00: 696e 6720 7072 6f70 7269 6574 6172 790a  ing proprietary.
│ │ │ │ │ +00014c10: 6170 706c 6963 6174 696f 6e73 2077 6974  applications wit
│ │ │ │ │ +00014c20: 6820 7468 6520 6c69 6272 6172 792e 2020  h the library.  
│ │ │ │ │ +00014c30: 4966 2074 6869 7320 6973 2077 6861 7420  If this is what 
│ │ │ │ │ +00014c40: 796f 7520 7761 6e74 2074 6f20 646f 2c20  you want to do, 
│ │ │ │ │ +00014c50: 7573 6520 7468 650a 474e 5520 4c65 7373  use the.GNU Less
│ │ │ │ │ +00014c60: 6572 2047 656e 6572 616c 2050 7562 6c69  er General Publi
│ │ │ │ │ +00014c70: 6320 4c69 6365 6e73 6520 696e 7374 6561  c License instea
│ │ │ │ │ +00014c80: 6420 6f66 2074 6869 7320 4c69 6365 6e73  d of this Licens
│ │ │ │ │ +00014c90: 652e 0a0a 1f0a 4669 6c65 3a20 6c69 6266  e.....File: libf
│ │ │ │ │ +00014ca0: 6b6f 2e69 6e66 6f2c 2020 4e6f 6465 3a20  ko.info,  Node: 
│ │ │ │ │ +00014cb0: 436f 6e63 6570 7420 496e 6465 782c 2020  Concept Index,  
│ │ │ │ │ +00014cc0: 4e65 7874 3a20 4675 6e63 7469 6f6e 2061  Next: Function a
│ │ │ │ │ +00014cd0: 6e64 2044 6174 6120 496e 6465 782c 2020  nd Data Index,  
│ │ │ │ │ +00014ce0: 5072 6576 3a20 4c69 6272 6172 7920 436f  Prev: Library Co
│ │ │ │ │ +00014cf0: 7079 696e 672c 2020 5570 3a20 546f 700a  pying,  Up: Top.
│ │ │ │ │ +00014d00: 0a43 6f6e 6365 7074 2049 6e64 6578 0a2a  .Concept Index.*
│ │ │ │ │ +00014d10: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 0008  ************....
│ │ │ │ │ +00014d20: 5b69 6e64 6578 0008 5d0a 2a20 4d65 6e75  [index..].* Menu
│ │ │ │ │ +00014d30: 3a0a 0a2a 2063 6f6d 7069 6c69 6e67 2c20  :..* compiling, 
│ │ │ │ │ +00014d40: 7769 7468 206c 6962 666b 6f3a 2020 2020  with libfko:    
│ │ │ │ │ +00014d50: 2020 2020 2020 2020 2020 2020 436f 6d70              Comp
│ │ │ │ │ +00014d60: 696c 696e 6720 7769 7468 206c 6962 666b  iling with libfk
│ │ │ │ │ +00014d70: 6f2e 0a20 2020 2020 2020 2020 2020 2020  o..             
│ │ │ │ │  00014d80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  00014d90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  00014da0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00014db0: 2020 2028 6c69 6e65 2020 2036 290a 2a20     (line   6).* 
│ │ │ │ │ -00014dc0: 636f 6e74 6578 742c 2063 7265 6174 696f  context, creatio
│ │ │ │ │ -00014dd0: 6e3a 2020 2020 2020 2020 2020 2020 2020  n:              
│ │ │ │ │ -00014de0: 2020 2020 2020 2043 7265 6174 696e 6720         Creating 
│ │ │ │ │ -00014df0: 436f 6e74 6578 7473 2e20 2020 286c 696e  Contexts.   (lin
│ │ │ │ │ -00014e00: 6520 2020 3629 0a2a 2063 6f6e 7465 7874  e   6).* context
│ │ │ │ │ -00014e10: 2c20 6465 7374 7275 6374 696f 6e3a 2020  , destruction:  
│ │ │ │ │ -00014e20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00014e30: 4465 7374 726f 7969 6e67 2043 6f6e 7465  Destroying Conte
│ │ │ │ │ -00014e40: 7874 732e 2028 6c69 6e65 2020 2036 290a  xts. (line   6).
│ │ │ │ │ -00014e50: 2a20 6465 6661 756c 7420 656e 6372 7970  * default encryp
│ │ │ │ │ -00014e60: 7469 6f6e 3a20 2020 2020 2020 2020 2020  tion:           
│ │ │ │ │ -00014e70: 2020 2020 2020 2020 2045 6e63 7279 7074           Encrypt
│ │ │ │ │ -00014e80: 696f 6e20 416c 676f 7269 7468 6d73 2e0a  ion Algorithms..
│ │ │ │ │ +00014db0: 2028 6c69 6e65 2020 2036 290a 2a20 636f   (line   6).* co
│ │ │ │ │ +00014dc0: 6e74 6578 742c 2063 7265 6174 696f 6e3a  ntext, creation:
│ │ │ │ │ +00014dd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ +00014de0: 2020 2020 2043 7265 6174 696e 6720 436f       Creating Co
│ │ │ │ │ +00014df0: 6e74 6578 7473 2e20 2020 286c 696e 6520  ntexts.   (line 
│ │ │ │ │ +00014e00: 2020 3629 0a2a 2063 6f6e 7465 7874 2c20    6).* context, 
│ │ │ │ │ +00014e10: 6465 7374 7275 6374 696f 6e3a 2020 2020  destruction:    
│ │ │ │ │ +00014e20: 2020 2020 2020 2020 2020 2020 2020 4465                De
│ │ │ │ │ +00014e30: 7374 726f 7969 6e67 2043 6f6e 7465 7874  stroying Context
│ │ │ │ │ +00014e40: 732e 2028 6c69 6e65 2020 2036 290a 2a20  s. (line   6).* 
│ │ │ │ │ +00014e50: 6465 6661 756c 7420 656e 6372 7970 7469  default encrypti
│ │ │ │ │ +00014e60: 6f6e 3a20 2020 2020 2020 2020 2020 2020  on:             
│ │ │ │ │ +00014e70: 2020 2020 2020 2045 6e63 7279 7074 696f         Encryptio
│ │ │ │ │ +00014e80: 6e20 416c 676f 7269 7468 6d73 2e0a 2020  n Algorithms..  
│ │ │ │ │  00014e90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  00014ea0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  00014eb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00014ec0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ │ -00014ed0: 696e 6520 2020 3629 0a2a 2064 6566 6175  ine   6).* defau
│ │ │ │ │ -00014ee0: 6c74 206d 6573 7361 6765 2064 6967 6573  lt message diges
│ │ │ │ │ -00014ef0: 743a 2020 2020 2020 2020 2020 2020 2020  t:              
│ │ │ │ │ -00014f00: 2020 4469 6765 7374 732e 2020 2020 2020    Digests.      
│ │ │ │ │ -00014f10: 2020 2020 2020 2028 6c69 6e65 2020 2036         (line   6
│ │ │ │ │ -00014f20: 290a 2a20 6465 6661 756c 7420 6d65 7373  ).* default mess
│ │ │ │ │ -00014f30: 6167 6520 6469 6765 7374 203c 313e 3a20  age digest <1>: 
│ │ │ │ │ -00014f40: 2020 2020 2020 2020 2020 2048 4d41 4320             HMAC 
│ │ │ │ │ -00014f50: 4469 6765 7374 732e 2020 2020 2020 2020  Digests.        
│ │ │ │ │ -00014f60: 286c 696e 6520 2020 3629 0a2a 2064 6967  (line   6).* dig
│ │ │ │ │ -00014f70: 6573 7420 7479 7065 733a 2020 2020 2020  est types:      
│ │ │ │ │ +00014ec0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ │ +00014ed0: 6520 2020 3629 0a2a 2064 6566 6175 6c74  e   6).* default
│ │ │ │ │ +00014ee0: 206d 6573 7361 6765 2064 6967 6573 743a   message digest:
│ │ │ │ │ +00014ef0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ +00014f00: 4469 6765 7374 732e 2020 2020 2020 2020  Digests.        
│ │ │ │ │ +00014f10: 2020 2020 2028 6c69 6e65 2020 2036 290a       (line   6).
│ │ │ │ │ +00014f20: 2a20 6465 6661 756c 7420 6d65 7373 6167  * default messag
│ │ │ │ │ +00014f30: 6520 6469 6765 7374 203c 313e 3a20 2020  e digest <1>:   
│ │ │ │ │ +00014f40: 2020 2020 2020 2020 2048 4d41 4320 4469           HMAC Di
│ │ │ │ │ +00014f50: 6765 7374 732e 2020 2020 2020 2020 286c  gests.        (l
│ │ │ │ │ +00014f60: 696e 6520 2020 3629 0a2a 2064 6967 6573  ine   6).* diges
│ │ │ │ │ +00014f70: 7420 7479 7065 733a 2020 2020 2020 2020  t types:        
│ │ │ │ │  00014f80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00014f90: 2020 2020 4469 6765 7374 732e 2020 2020      Digests.    
│ │ │ │ │ -00014fa0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ │ -00014fb0: 2036 290a 2a20 656e 6372 7970 7469 6f6e   6).* encryption
│ │ │ │ │ -00014fc0: 2074 7970 6573 3a20 2020 2020 2020 2020   types:         
│ │ │ │ │ -00014fd0: 2020 2020 2020 2020 2020 2020 2045 6e63               Enc
│ │ │ │ │ -00014fe0: 7279 7074 696f 6e20 416c 676f 7269 7468  ryption Algorith
│ │ │ │ │ -00014ff0: 6d73 2e0a 2020 2020 2020 2020 2020 2020  ms..            
│ │ │ │ │ +00014f90: 2020 4469 6765 7374 732e 2020 2020 2020    Digests.      
│ │ │ │ │ +00014fa0: 2020 2020 2020 2028 6c69 6e65 2020 2036         (line   6
│ │ │ │ │ +00014fb0: 290a 2a20 656e 6372 7970 7469 6f6e 2074  ).* encryption t
│ │ │ │ │ +00014fc0: 7970 6573 3a20 2020 2020 2020 2020 2020  ypes:           
│ │ │ │ │ +00014fd0: 2020 2020 2020 2020 2020 2045 6e63 7279             Encry
│ │ │ │ │ +00014fe0: 7074 696f 6e20 416c 676f 7269 7468 6d73  ption Algorithms
│ │ │ │ │ +00014ff0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ │  00015000: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  00015010: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  00015020: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015030: 2020 286c 696e 6520 2020 3629 0a2a 2065    (line   6).* e
│ │ │ │ │ -00015040: 7272 6f72 2063 6f64 6573 3a20 2020 2020  rror codes:     
│ │ │ │ │ +00015030: 286c 696e 6520 2020 3629 0a2a 2065 7272  (line   6).* err
│ │ │ │ │ +00015040: 6f72 2063 6f64 6573 3a20 2020 2020 2020  or codes:       
│ │ │ │ │  00015050: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015060: 2020 2020 2020 4572 726f 7220 4861 6e64        Error Hand
│ │ │ │ │ -00015070: 6c69 6e67 2e20 2020 2020 2028 6c69 6e65  ling.      (line
│ │ │ │ │ -00015080: 2020 2036 290a 2a20 6572 726f 7220 636f     6).* error co
│ │ │ │ │ -00015090: 6465 732c 2067 7067 6d65 2072 656c 6174  des, gpgme relat
│ │ │ │ │ -000150a0: 6564 3a20 2020 2020 2020 2020 2020 2045  ed:            E
│ │ │ │ │ -000150b0: 7272 6f72 2048 616e 646c 696e 672e 2020  rror Handling.  
│ │ │ │ │ -000150c0: 2020 2020 286c 696e 6520 3234 3129 0a2a      (line 241).*
│ │ │ │ │ -000150d0: 2065 7272 6f72 2068 616e 646c 696e 673a   error handling:
│ │ │ │ │ +00015060: 2020 2020 4572 726f 7220 4861 6e64 6c69      Error Handli
│ │ │ │ │ +00015070: 6e67 2e20 2020 2020 2028 6c69 6e65 2020  ng.      (line  
│ │ │ │ │ +00015080: 2036 290a 2a20 6572 726f 7220 636f 6465   6).* error code
│ │ │ │ │ +00015090: 732c 2067 7067 6d65 2072 656c 6174 6564  s, gpgme related
│ │ │ │ │ +000150a0: 3a20 2020 2020 2020 2020 2020 2045 7272  :            Err
│ │ │ │ │ +000150b0: 6f72 2048 616e 646c 696e 672e 2020 2020  or Handling.    
│ │ │ │ │ +000150c0: 2020 286c 696e 6520 3234 3129 0a2a 2065    (line 241).* e
│ │ │ │ │ +000150d0: 7272 6f72 2068 616e 646c 696e 673a 2020  rror handling:  
│ │ │ │ │  000150e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000150f0: 2020 2020 2020 2020 4572 726f 7220 4861          Error Ha
│ │ │ │ │ -00015100: 6e64 6c69 6e67 2e20 2020 2020 2028 6c69  ndling.      (li
│ │ │ │ │ -00015110: 6e65 2020 2036 290a 2a20 6572 726f 7220  ne   6).* error 
│ │ │ │ │ -00015120: 7374 7269 6e67 733a 2020 2020 2020 2020  strings:        
│ │ │ │ │ -00015130: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015140: 2045 7272 6f72 2048 616e 646c 696e 672e   Error Handling.
│ │ │ │ │ -00015150: 2020 2020 2020 286c 696e 6520 2020 3629        (line   6)
│ │ │ │ │ -00015160: 0a2a 2046 6972 6577 616c 6c20 4b6e 6f63  .* Firewall Knoc
│ │ │ │ │ -00015170: 6b20 4f70 6572 6174 6f72 2c20 696e 7472  k Operator, intr
│ │ │ │ │ -00015180: 6f3a 2020 2020 2020 2020 496e 7472 6f64  o:        Introd
│ │ │ │ │ -00015190: 7563 7469 6f6e 2e20 2020 2020 2020 2028  uction.        (
│ │ │ │ │ -000151a0: 6c69 6e65 2020 2036 290a 2a20 666b 6f2e  line   6).* fko.
│ │ │ │ │ -000151b0: 683a 2020 2020 2020 2020 2020 2020 2020  h:              
│ │ │ │ │ +000150f0: 2020 2020 2020 4572 726f 7220 4861 6e64        Error Hand
│ │ │ │ │ +00015100: 6c69 6e67 2e20 2020 2020 2028 6c69 6e65  ling.      (line
│ │ │ │ │ +00015110: 2020 2036 290a 2a20 6572 726f 7220 7374     6).* error st
│ │ │ │ │ +00015120: 7269 6e67 733a 2020 2020 2020 2020 2020  rings:          
│ │ │ │ │ +00015130: 2020 2020 2020 2020 2020 2020 2020 2045                 E
│ │ │ │ │ +00015140: 7272 6f72 2048 616e 646c 696e 672e 2020  rror Handling.  
│ │ │ │ │ +00015150: 2020 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*
│ │ │ │ │ +00015160: 2046 6972 6577 616c 6c20 4b6e 6f63 6b20   Firewall Knock 
│ │ │ │ │ +00015170: 4f70 6572 6174 6f72 2c20 696e 7472 6f3a  Operator, intro:
│ │ │ │ │ +00015180: 2020 2020 2020 2020 496e 7472 6f64 7563          Introduc
│ │ │ │ │ +00015190: 7469 6f6e 2e20 2020 2020 2020 2028 6c69  tion.        (li
│ │ │ │ │ +000151a0: 6e65 2020 2036 290a 2a20 666b 6f2e 683a  ne   6).* fko.h:
│ │ │ │ │ +000151b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  000151c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000151d0: 2020 206c 6962 666b 6f20 4865 6164 6572     libfko Header
│ │ │ │ │ -000151e0: 2e20 2020 2020 2020 286c 696e 6520 2020  .       (line   
│ │ │ │ │ -000151f0: 3629 0a2a 2066 776b 6e6f 703a 2020 2020  6).* fwknop:    
│ │ │ │ │ +000151d0: 206c 6962 666b 6f20 4865 6164 6572 2e20   libfko Header. 
│ │ │ │ │ +000151e0: 2020 2020 2020 286c 696e 6520 2020 3629        (line   6)
│ │ │ │ │ +000151f0: 0a2a 2066 776b 6e6f 703a 2020 2020 2020  .* fwknop:      
│ │ │ │ │  00015200: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015210: 2020 2020 2020 2020 2020 2020 496e 7472              Intr
│ │ │ │ │ -00015220: 6f64 7563 7469 6f6e 2e20 2020 2020 2020  oduction.       
│ │ │ │ │ -00015230: 2028 6c69 6e65 2020 2036 290a 2a20 6770   (line   6).* gp
│ │ │ │ │ -00015240: 672d 7370 6563 6966 6963 2066 756e 6374  g-specific funct
│ │ │ │ │ -00015250: 696f 6e73 3a20 2020 2020 2020 2020 2020  ions:           
│ │ │ │ │ -00015260: 2020 2020 2053 6574 7469 6e67 2053 5041       Setting SPA
│ │ │ │ │ -00015270: 2044 6174 612e 2020 2020 286c 696e 6520   Data.    (line 
│ │ │ │ │ -00015280: 3131 3229 0a2a 2067 7067 2d73 7065 6369  112).* gpg-speci
│ │ │ │ │ -00015290: 6669 6320 6675 6e63 7469 6f6e 7320 3c31  fic functions <1
│ │ │ │ │ -000152a0: 3e3a 2020 2020 2020 2020 2020 2020 5265  >:            Re
│ │ │ │ │ -000152b0: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat
│ │ │ │ │ -000152c0: 612e 2028 6c69 6e65 2031 3238 290a 2a20  a. (line 128).* 
│ │ │ │ │ -000152d0: 6770 672d 7370 6563 6966 6963 2066 756e  gpg-specific fun
│ │ │ │ │ -000152e0: 6374 696f 6e73 203c 323e 3a20 2020 2020  ctions <2>:     
│ │ │ │ │ -000152f0: 2020 2020 2020 2055 7469 6c69 7479 2046         Utility F
│ │ │ │ │ -00015300: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ │ -00015310: 6520 2035 3229 0a2a 2067 7067 2d73 7065  e  52).* gpg-spe
│ │ │ │ │ -00015320: 6369 6669 6320 6675 6e63 7469 6f6e 7320  cific functions 
│ │ │ │ │ -00015330: 3c33 3e3a 2020 2020 2020 2020 2020 2020  <3>:            
│ │ │ │ │ -00015340: 4572 726f 7220 4861 6e64 6c69 6e67 2e20  Error Handling. 
│ │ │ │ │ -00015350: 2020 2020 2028 6c69 6e65 2033 3130 290a       (line 310).
│ │ │ │ │ -00015360: 2a20 4750 4c76 322b 2c20 4765 6e65 7261  * GPLv2+, Genera
│ │ │ │ │ -00015370: 6c20 5075 626c 6963 204c 6963 656e 7365  l Public License
│ │ │ │ │ -00015380: 3a20 2020 2020 2020 204c 6962 7261 7279  :        Library
│ │ │ │ │ -00015390: 2043 6f70 7969 6e67 2e20 2020 2020 286c   Copying.     (l
│ │ │ │ │ -000153a0: 696e 6520 2020 3629 0a2a 2068 6561 6465  ine   6).* heade
│ │ │ │ │ -000153b0: 7220 6669 6c65 3a20 2020 2020 2020 2020  r file:         
│ │ │ │ │ +00015210: 2020 2020 2020 2020 2020 496e 7472 6f64            Introd
│ │ │ │ │ +00015220: 7563 7469 6f6e 2e20 2020 2020 2020 2028  uction.        (
│ │ │ │ │ +00015230: 6c69 6e65 2020 2036 290a 2a20 6770 672d  line   6).* gpg-
│ │ │ │ │ +00015240: 7370 6563 6966 6963 2066 756e 6374 696f  specific functio
│ │ │ │ │ +00015250: 6e73 3a20 2020 2020 2020 2020 2020 2020  ns:             
│ │ │ │ │ +00015260: 2020 2053 6574 7469 6e67 2053 5041 2044     Setting SPA D
│ │ │ │ │ +00015270: 6174 612e 2020 2020 286c 696e 6520 3131  ata.    (line 11
│ │ │ │ │ +00015280: 3229 0a2a 2067 7067 2d73 7065 6369 6669  2).* gpg-specifi
│ │ │ │ │ +00015290: 6320 6675 6e63 7469 6f6e 7320 3c31 3e3a  c functions <1>:
│ │ │ │ │ +000152a0: 2020 2020 2020 2020 2020 2020 5265 7472              Retr
│ │ │ │ │ +000152b0: 6965 7669 6e67 2053 5041 2044 6174 612e  ieving SPA Data.
│ │ │ │ │ +000152c0: 2028 6c69 6e65 2031 3238 290a 2a20 6770   (line 128).* gp
│ │ │ │ │ +000152d0: 672d 7370 6563 6966 6963 2066 756e 6374  g-specific funct
│ │ │ │ │ +000152e0: 696f 6e73 203c 323e 3a20 2020 2020 2020  ions <2>:       
│ │ │ │ │ +000152f0: 2020 2020 2055 7469 6c69 7479 2046 756e       Utility Fun
│ │ │ │ │ +00015300: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ │ +00015310: 2035 3229 0a2a 2067 7067 2d73 7065 6369   52).* gpg-speci
│ │ │ │ │ +00015320: 6669 6320 6675 6e63 7469 6f6e 7320 3c33  fic functions <3
│ │ │ │ │ +00015330: 3e3a 2020 2020 2020 2020 2020 2020 4572  >:            Er
│ │ │ │ │ +00015340: 726f 7220 4861 6e64 6c69 6e67 2e20 2020  ror Handling.   
│ │ │ │ │ +00015350: 2020 2028 6c69 6e65 2033 3130 290a 2a20     (line 310).* 
│ │ │ │ │ +00015360: 4750 4c76 322b 2c20 4765 6e65 7261 6c20  GPLv2+, General 
│ │ │ │ │ +00015370: 5075 626c 6963 204c 6963 656e 7365 3a20  Public License: 
│ │ │ │ │ +00015380: 2020 2020 2020 204c 6962 7261 7279 2043         Library C
│ │ │ │ │ +00015390: 6f70 7969 6e67 2e20 2020 2020 286c 696e  opying.     (lin
│ │ │ │ │ +000153a0: 6520 2020 3629 0a2a 2068 6561 6465 7220  e   6).* header 
│ │ │ │ │ +000153b0: 6669 6c65 3a20 2020 2020 2020 2020 2020  file:           
│ │ │ │ │  000153c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000153d0: 2020 6c69 6266 6b6f 2048 6561 6465 722e    libfko Header.
│ │ │ │ │ -000153e0: 2020 2020 2020 2028 6c69 6e65 2020 2036         (line   6
│ │ │ │ │ -000153f0: 290a 2a20 484d 4143 2064 6967 6573 7420  ).* HMAC digest 
│ │ │ │ │ -00015400: 7479 7065 733a 2020 2020 2020 2020 2020  types:          
│ │ │ │ │ -00015410: 2020 2020 2020 2020 2020 2048 4d41 4320             HMAC 
│ │ │ │ │ -00015420: 4469 6765 7374 732e 2020 2020 2020 2020  Digests.        
│ │ │ │ │ -00015430: 286c 696e 6520 2020 3629 0a2a 2069 6e63  (line   6).* inc
│ │ │ │ │ -00015440: 6c75 6465 2066 696c 653a 2020 2020 2020  lude file:      
│ │ │ │ │ +000153d0: 6c69 6266 6b6f 2048 6561 6465 722e 2020  libfko Header.  
│ │ │ │ │ +000153e0: 2020 2020 2028 6c69 6e65 2020 2036 290a       (line   6).
│ │ │ │ │ +000153f0: 2a20 484d 4143 2064 6967 6573 7420 7479  * HMAC digest ty
│ │ │ │ │ +00015400: 7065 733a 2020 2020 2020 2020 2020 2020  pes:            
│ │ │ │ │ +00015410: 2020 2020 2020 2020 2048 4d41 4320 4469           HMAC Di
│ │ │ │ │ +00015420: 6765 7374 732e 2020 2020 2020 2020 286c  gests.        (l
│ │ │ │ │ +00015430: 696e 6520 2020 3629 0a2a 2069 6e63 6c75  ine   6).* inclu
│ │ │ │ │ +00015440: 6465 2066 696c 653a 2020 2020 2020 2020  de file:        
│ │ │ │ │  00015450: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015460: 2020 2020 6c69 6266 6b6f 2048 6561 6465      libfko Heade
│ │ │ │ │ -00015470: 722e 2020 2020 2020 2028 6c69 6e65 2020  r.       (line  
│ │ │ │ │ -00015480: 2036 290a 2a20 6c69 6e6b 696e 672c 2077   6).* linking, w
│ │ │ │ │ -00015490: 6974 6820 6c69 6266 6b6f 3a20 2020 2020  ith libfko:     
│ │ │ │ │ -000154a0: 2020 2020 2020 2020 2020 2020 2043 6f6d               Com
│ │ │ │ │ -000154b0: 7069 6c69 6e67 2077 6974 6820 6c69 6266  piling with libf
│ │ │ │ │ -000154c0: 6b6f 2e0a 2020 2020 2020 2020 2020 2020  ko..            
│ │ │ │ │ +00015460: 2020 6c69 6266 6b6f 2048 6561 6465 722e    libfko Header.
│ │ │ │ │ +00015470: 2020 2020 2020 2028 6c69 6e65 2020 2036         (line   6
│ │ │ │ │ +00015480: 290a 2a20 6c69 6e6b 696e 672c 2077 6974  ).* linking, wit
│ │ │ │ │ +00015490: 6820 6c69 6266 6b6f 3a20 2020 2020 2020  h libfko:       
│ │ │ │ │ +000154a0: 2020 2020 2020 2020 2020 2043 6f6d 7069             Compi
│ │ │ │ │ +000154b0: 6c69 6e67 2077 6974 6820 6c69 6266 6b6f  ling with libfko
│ │ │ │ │ +000154c0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ │  000154d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  000154e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  000154f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015500: 2020 286c 696e 6520 2020 3629 0a2a 206d    (line   6).* m
│ │ │ │ │ -00015510: 6573 7361 6765 2064 6967 6573 7420 7479  essage digest ty
│ │ │ │ │ -00015520: 7065 733a 2020 2020 2020 2020 2020 2020  pes:            
│ │ │ │ │ -00015530: 2020 2020 2020 4469 6765 7374 732e 2020        Digests.  
│ │ │ │ │ -00015540: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ │ -00015550: 2020 2036 290a 2a20 6d65 7373 6167 6520     6).* message 
│ │ │ │ │ -00015560: 6469 6765 7374 2074 7970 6573 203c 313e  digest types <1>
│ │ │ │ │ -00015570: 3a20 2020 2020 2020 2020 2020 2020 2048  :              H
│ │ │ │ │ -00015580: 4d41 4320 4469 6765 7374 732e 2020 2020  MAC Digests.    
│ │ │ │ │ -00015590: 2020 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*
│ │ │ │ │ -000155a0: 206d 6573 7361 6765 2074 7970 6573 3a20   message types: 
│ │ │ │ │ +00015500: 286c 696e 6520 2020 3629 0a2a 206d 6573  (line   6).* mes
│ │ │ │ │ +00015510: 7361 6765 2064 6967 6573 7420 7479 7065  sage digest type
│ │ │ │ │ +00015520: 733a 2020 2020 2020 2020 2020 2020 2020  s:              
│ │ │ │ │ +00015530: 2020 2020 4469 6765 7374 732e 2020 2020      Digests.    
│ │ │ │ │ +00015540: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ │ +00015550: 2036 290a 2a20 6d65 7373 6167 6520 6469   6).* message di
│ │ │ │ │ +00015560: 6765 7374 2074 7970 6573 203c 313e 3a20  gest types <1>: 
│ │ │ │ │ +00015570: 2020 2020 2020 2020 2020 2020 2048 4d41               HMA
│ │ │ │ │ +00015580: 4320 4469 6765 7374 732e 2020 2020 2020  C Digests.      
│ │ │ │ │ +00015590: 2020 286c 696e 6520 2020 3629 0a2a 206d    (line   6).* m
│ │ │ │ │ +000155a0: 6573 7361 6765 2074 7970 6573 3a20 2020  essage types:   
│ │ │ │ │  000155b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000155c0: 2020 2020 2020 2020 5350 4120 4d65 7373          SPA Mess
│ │ │ │ │ -000155d0: 6167 6573 2e20 2020 2020 2020 2028 6c69  ages.        (li
│ │ │ │ │ -000155e0: 6e65 2020 2036 290a 2a20 5369 6e67 6c65  ne   6).* Single
│ │ │ │ │ -000155f0: 2050 6163 6b65 7420 4175 7468 6f72 697a   Packet Authoriz
│ │ │ │ │ -00015600: 6174 696f 6e2c 2069 6e74 726f 3a20 2020  ation, intro:   
│ │ │ │ │ -00015610: 2049 6e74 726f 6475 6374 696f 6e2e 2020   Introduction.  
│ │ │ │ │ -00015620: 2020 2020 2020 286c 696e 6520 2020 3629        (line   6)
│ │ │ │ │ -00015630: 0a2a 2073 7061 2064 6174 612c 2072 6574  .* spa data, ret
│ │ │ │ │ -00015640: 7269 6576 696e 6720 7661 6c75 6573 3a20  rieving values: 
│ │ │ │ │ -00015650: 2020 2020 2020 2020 2020 5265 7472 6965            Retrie
│ │ │ │ │ -00015660: 7669 6e67 2053 5041 2044 6174 612e 2028  ving SPA Data. (
│ │ │ │ │ -00015670: 6c69 6e65 2020 2036 290a 2a20 7370 6120  line   6).* spa 
│ │ │ │ │ -00015680: 6461 7461 2c20 7365 7474 696e 6720 7661  data, setting va
│ │ │ │ │ -00015690: 6c75 6573 3a20 2020 2020 2020 2020 2020  lues:           
│ │ │ │ │ -000156a0: 2020 2053 6574 7469 6e67 2053 5041 2044     Setting SPA D
│ │ │ │ │ -000156b0: 6174 612e 2020 2020 286c 696e 6520 2020  ata.    (line   
│ │ │ │ │ -000156c0: 3629 0a2a 2073 7061 2064 6174 612c 2075  6).* spa data, u
│ │ │ │ │ -000156d0: 7469 6c69 7479 2066 756e 6374 696f 6e73  tility functions
│ │ │ │ │ -000156e0: 3a20 2020 2020 2020 2020 2020 5574 696c  :           Util
│ │ │ │ │ -000156f0: 6974 7920 4675 6e63 7469 6f6e 732e 2020  ity Functions.  
│ │ │ │ │ -00015700: 2028 6c69 6e65 2020 2036 290a 2a20 7370   (line   6).* sp
│ │ │ │ │ -00015710: 612c 2064 6174 6120 6372 6561 7469 6f6e  a, data creation
│ │ │ │ │ -00015720: 2063 6f64 6520 7361 6d70 6c65 3a20 2020   code sample:   
│ │ │ │ │ -00015730: 2020 2020 2043 7265 6174 696e 6720 6120       Creating a 
│ │ │ │ │ -00015740: 5350 4120 4d65 7373 6167 652e 0a20 2020  SPA Message..   
│ │ │ │ │ +000155c0: 2020 2020 2020 5350 4120 4d65 7373 6167        SPA Messag
│ │ │ │ │ +000155d0: 6573 2e20 2020 2020 2020 2028 6c69 6e65  es.        (line
│ │ │ │ │ +000155e0: 2020 2036 290a 2a20 5369 6e67 6c65 2050     6).* Single P
│ │ │ │ │ +000155f0: 6163 6b65 7420 4175 7468 6f72 697a 6174  acket Authorizat
│ │ │ │ │ +00015600: 696f 6e2c 2069 6e74 726f 3a20 2020 2049  ion, intro:    I
│ │ │ │ │ +00015610: 6e74 726f 6475 6374 696f 6e2e 2020 2020  ntroduction.    
│ │ │ │ │ +00015620: 2020 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*
│ │ │ │ │ +00015630: 2073 7061 2064 6174 612c 2072 6574 7269   spa data, retri
│ │ │ │ │ +00015640: 6576 696e 6720 7661 6c75 6573 3a20 2020  eving values:   
│ │ │ │ │ +00015650: 2020 2020 2020 2020 5265 7472 6965 7669          Retrievi
│ │ │ │ │ +00015660: 6e67 2053 5041 2044 6174 612e 2028 6c69  ng SPA Data. (li
│ │ │ │ │ +00015670: 6e65 2020 2036 290a 2a20 7370 6120 6461  ne   6).* spa da
│ │ │ │ │ +00015680: 7461 2c20 7365 7474 696e 6720 7661 6c75  ta, setting valu
│ │ │ │ │ +00015690: 6573 3a20 2020 2020 2020 2020 2020 2020  es:             
│ │ │ │ │ +000156a0: 2053 6574 7469 6e67 2053 5041 2044 6174   Setting SPA Dat
│ │ │ │ │ +000156b0: 612e 2020 2020 286c 696e 6520 2020 3629  a.    (line   6)
│ │ │ │ │ +000156c0: 0a2a 2073 7061 2064 6174 612c 2075 7469  .* spa data, uti
│ │ │ │ │ +000156d0: 6c69 7479 2066 756e 6374 696f 6e73 3a20  lity functions: 
│ │ │ │ │ +000156e0: 2020 2020 2020 2020 2020 5574 696c 6974            Utilit
│ │ │ │ │ +000156f0: 7920 4675 6e63 7469 6f6e 732e 2020 2028  y Functions.   (
│ │ │ │ │ +00015700: 6c69 6e65 2020 2036 290a 2a20 7370 612c  line   6).* spa,
│ │ │ │ │ +00015710: 2064 6174 6120 6372 6561 7469 6f6e 2063   data creation c
│ │ │ │ │ +00015720: 6f64 6520 7361 6d70 6c65 3a20 2020 2020  ode sample:     
│ │ │ │ │ +00015730: 2020 2043 7265 6174 696e 6720 6120 5350     Creating a SP
│ │ │ │ │ +00015740: 4120 4d65 7373 6167 652e 0a20 2020 2020  A Message..     
│ │ │ │ │  00015750: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  00015760: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  00015770: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015780: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ │ -00015790: 2020 2036 290a 2a20 5350 412c 2064 6174     6).* SPA, dat
│ │ │ │ │ -000157a0: 6120 666f 726d 6174 3a20 2020 2020 2020  a format:       
│ │ │ │ │ -000157b0: 2020 2020 2020 2020 2020 2020 2020 2053                 S
│ │ │ │ │ -000157c0: 5041 2044 6174 6120 466f 726d 6174 2e20  PA Data Format. 
│ │ │ │ │ -000157d0: 2020 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*
│ │ │ │ │ -000157e0: 2053 5041 2c20 696e 7472 6f3a 2020 2020   SPA, intro:    
│ │ │ │ │ +00015780: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ │ +00015790: 2036 290a 2a20 5350 412c 2064 6174 6120   6).* SPA, data 
│ │ │ │ │ +000157a0: 666f 726d 6174 3a20 2020 2020 2020 2020  format:         
│ │ │ │ │ +000157b0: 2020 2020 2020 2020 2020 2020 2053 5041               SPA
│ │ │ │ │ +000157c0: 2044 6174 6120 466f 726d 6174 2e20 2020   Data Format.   
│ │ │ │ │ +000157d0: 2020 286c 696e 6520 2020 3629 0a2a 2053    (line   6).* S
│ │ │ │ │ +000157e0: 5041 2c20 696e 7472 6f3a 2020 2020 2020  PA, intro:      
│ │ │ │ │  000157f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015800: 2020 2020 2020 2020 496e 7472 6f64 7563          Introduc
│ │ │ │ │ -00015810: 7469 6f6e 2e20 2020 2020 2020 2028 6c69  tion.        (li
│ │ │ │ │ -00015820: 6e65 2020 2036 290a 2a20 7370 612c 206d  ne   6).* spa, m
│ │ │ │ │ -00015830: 6573 7361 6765 2064 6174 6120 6372 6561  essage data crea
│ │ │ │ │ -00015840: 7469 6f6e 3a20 2020 2020 2020 2020 2020  tion:           
│ │ │ │ │ -00015850: 2043 7265 6174 696e 6720 6120 5350 4120   Creating a SPA 
│ │ │ │ │ -00015860: 4d65 7373 6167 652e 0a20 2020 2020 2020  Message..       
│ │ │ │ │ +00015800: 2020 2020 2020 496e 7472 6f64 7563 7469        Introducti
│ │ │ │ │ +00015810: 6f6e 2e20 2020 2020 2020 2028 6c69 6e65  on.        (line
│ │ │ │ │ +00015820: 2020 2036 290a 2a20 7370 612c 206d 6573     6).* spa, mes
│ │ │ │ │ +00015830: 7361 6765 2064 6174 6120 6372 6561 7469  sage data creati
│ │ │ │ │ +00015840: 6f6e 3a20 2020 2020 2020 2020 2020 2043  on:            C
│ │ │ │ │ +00015850: 7265 6174 696e 6720 6120 5350 4120 4d65  reating a SPA Me
│ │ │ │ │ +00015860: 7373 6167 652e 0a20 2020 2020 2020 2020  ssage..         
│ │ │ │ │  00015870: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  00015880: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  00015890: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000158a0: 2020 2020 2020 2028 6c69 6e65 2020 2036         (line   6
│ │ │ │ │ -000158b0: 290a 2a20 7370 612c 206d 6573 7361 6765  ).* spa, message
│ │ │ │ │ -000158c0: 2074 7970 6573 3a20 2020 2020 2020 2020   types:         
│ │ │ │ │ -000158d0: 2020 2020 2020 2020 2020 2053 5041 204d             SPA M
│ │ │ │ │ -000158e0: 6573 7361 6765 732e 2020 2020 2020 2020  essages.        
│ │ │ │ │ -000158f0: 286c 696e 6520 2020 3629 0a2a 2075 7469  (line   6).* uti
│ │ │ │ │ -00015900: 6c69 7479 2066 756e 6374 696f 6e73 3a20  lity functions: 
│ │ │ │ │ +000158a0: 2020 2020 2028 6c69 6e65 2020 2036 290a       (line   6).
│ │ │ │ │ +000158b0: 2a20 7370 612c 206d 6573 7361 6765 2074  * spa, message t
│ │ │ │ │ +000158c0: 7970 6573 3a20 2020 2020 2020 2020 2020  ypes:           
│ │ │ │ │ +000158d0: 2020 2020 2020 2020 2053 5041 204d 6573           SPA Mes
│ │ │ │ │ +000158e0: 7361 6765 732e 2020 2020 2020 2020 286c  sages.        (l
│ │ │ │ │ +000158f0: 696e 6520 2020 3629 0a2a 2075 7469 6c69  ine   6).* utili
│ │ │ │ │ +00015900: 7479 2066 756e 6374 696f 6e73 3a20 2020  ty functions:   
│ │ │ │ │  00015910: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015920: 2020 2020 5574 696c 6974 7920 4675 6e63      Utility Func
│ │ │ │ │ -00015930: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  
│ │ │ │ │ -00015940: 2036 290a 0a1f 0a46 696c 653a 206c 6962   6)....File: lib
│ │ │ │ │ -00015950: 666b 6f2e 696e 666f 2c20 204e 6f64 653a  fko.info,  Node:
│ │ │ │ │ -00015960: 2046 756e 6374 696f 6e20 616e 6420 4461   Function and Da
│ │ │ │ │ -00015970: 7461 2049 6e64 6578 2c20 2050 7265 763a  ta Index,  Prev:
│ │ │ │ │ -00015980: 2043 6f6e 6365 7074 2049 6e64 6578 2c20   Concept Index, 
│ │ │ │ │ -00015990: 2055 703a 2054 6f70 0a0a 4675 6e63 7469   Up: Top..Functi
│ │ │ │ │ -000159a0: 6f6e 2061 6e64 2044 6174 6120 496e 6465  on and Data Inde
│ │ │ │ │ -000159b0: 780a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  x.**************
│ │ │ │ │ -000159c0: 2a2a 2a2a 2a2a 2a2a 2a0a 0a00 085b 696e  *********....[in
│ │ │ │ │ -000159d0: 6465 7800 085d 0a2a 204d 656e 753a 0a0a  dex..].* Menu:..
│ │ │ │ │ -000159e0: 2a20 6572 726f 725f 636f 6465 3a20 2020  * error_code:   
│ │ │ │ │ +00015920: 2020 5574 696c 6974 7920 4675 6e63 7469    Utility Functi
│ │ │ │ │ +00015930: 6f6e 732e 2020 2028 6c69 6e65 2020 2036  ons.   (line   6
│ │ │ │ │ +00015940: 290a 0a1f 0a46 696c 653a 206c 6962 666b  )....File: libfk
│ │ │ │ │ +00015950: 6f2e 696e 666f 2c20 204e 6f64 653a 2046  o.info,  Node: F
│ │ │ │ │ +00015960: 756e 6374 696f 6e20 616e 6420 4461 7461  unction and Data
│ │ │ │ │ +00015970: 2049 6e64 6578 2c20 2050 7265 763a 2043   Index,  Prev: C
│ │ │ │ │ +00015980: 6f6e 6365 7074 2049 6e64 6578 2c20 2055  oncept Index,  U
│ │ │ │ │ +00015990: 703a 2054 6f70 0a0a 4675 6e63 7469 6f6e  p: Top..Function
│ │ │ │ │ +000159a0: 2061 6e64 2044 6174 6120 496e 6465 780a   and Data Index.
│ │ │ │ │ +000159b0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ****************
│ │ │ │ │ +000159c0: 2a2a 2a2a 2a2a 2a0a 0a00 085b 696e 6465  *******....[inde
│ │ │ │ │ +000159d0: 7800 085d 0a2a 204d 656e 753a 0a0a 2a20  x..].* Menu:..* 
│ │ │ │ │ +000159e0: 6572 726f 725f 636f 6465 3a20 2020 2020  error_code:     
│ │ │ │ │  000159f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015a00: 2020 2020 2020 2020 2045 7272 6f72 2048           Error H
│ │ │ │ │ -00015a10: 616e 646c 696e 672e 2020 2020 2020 286c  andling.      (l
│ │ │ │ │ -00015a20: 696e 6520 2031 3829 0a2a 2065 7272 6f72  ine  18).* error
│ │ │ │ │ -00015a30: 5f63 6f64 6520 3c31 3e3a 2020 2020 2020  _code <1>:      
│ │ │ │ │ +00015a00: 2020 2020 2020 2045 7272 6f72 2048 616e         Error Han
│ │ │ │ │ +00015a10: 646c 696e 672e 2020 2020 2020 286c 696e  dling.      (lin
│ │ │ │ │ +00015a20: 6520 2031 3829 0a2a 2065 7272 6f72 5f63  e  18).* error_c
│ │ │ │ │ +00015a30: 6f64 6520 3c31 3e3a 2020 2020 2020 2020  ode <1>:        
│ │ │ │ │  00015a40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015a50: 2020 4572 726f 7220 4861 6e64 6c69 6e67    Error Handling
│ │ │ │ │ -00015a60: 2e20 2020 2020 2028 6c69 6e65 2032 3431  .      (line 241
│ │ │ │ │ -00015a70: 290a 2a20 666b 6f5f 6465 636f 6465 5f73  ).* fko_decode_s
│ │ │ │ │ -00015a80: 7061 5f64 6174 613a 2020 2020 2020 2020  pa_data:        
│ │ │ │ │ -00015a90: 2020 2020 2020 2020 2020 2055 7469 6c69             Utili
│ │ │ │ │ -00015aa0: 7479 2046 756e 6374 696f 6e73 2e20 2020  ty Functions.   
│ │ │ │ │ -00015ab0: 286c 696e 6520 2033 3829 0a2a 2066 6b6f  (line  38).* fko
│ │ │ │ │ -00015ac0: 5f64 6563 7279 7074 5f73 7061 5f64 6174  _decrypt_spa_dat
│ │ │ │ │ -00015ad0: 613a 2020 2020 2020 2020 2020 2020 2020  a:              
│ │ │ │ │ -00015ae0: 2020 2020 5574 696c 6974 7920 4675 6e63      Utility Func
│ │ │ │ │ -00015af0: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  
│ │ │ │ │ -00015b00: 3233 290a 2a20 666b 6f5f 6465 7374 726f  23).* fko_destro
│ │ │ │ │ -00015b10: 793a 2020 2020 2020 2020 2020 2020 2020  y:              
│ │ │ │ │ -00015b20: 2020 2020 2020 2020 2020 2020 2044 6573               Des
│ │ │ │ │ -00015b30: 7472 6f79 696e 6720 436f 6e74 6578 7473  troying Contexts
│ │ │ │ │ -00015b40: 2e20 286c 696e 6520 2031 3129 0a2a 2066  . (line  11).* f
│ │ │ │ │ -00015b50: 6b6f 5f64 6967 6573 745f 7479 7065 5f74  ko_digest_type_t
│ │ │ │ │ -00015b60: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ │ -00015b70: 2020 2020 2020 4469 6765 7374 732e 2020        Digests.  
│ │ │ │ │ -00015b80: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ │ -00015b90: 2020 3137 290a 2a20 666b 6f5f 6469 6765    17).* fko_dige
│ │ │ │ │ -00015ba0: 7374 5f74 7970 655f 7420 3c31 3e3a 2020  st_type_t <1>:  
│ │ │ │ │ -00015bb0: 2020 2020 2020 2020 2020 2020 2020 2048                 H
│ │ │ │ │ -00015bc0: 4d41 4320 4469 6765 7374 732e 2020 2020  MAC Digests.    
│ │ │ │ │ -00015bd0: 2020 2020 286c 696e 6520 2031 3429 0a2a      (line  14).*
│ │ │ │ │ -00015be0: 2066 6b6f 5f65 6e63 6f64 655f 7370 615f   fko_encode_spa_
│ │ │ │ │ -00015bf0: 6461 7461 3a20 2020 2020 2020 2020 2020  data:           
│ │ │ │ │ -00015c00: 2020 2020 2020 2020 5574 696c 6974 7920          Utility 
│ │ │ │ │ -00015c10: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ │ -00015c20: 6e65 2020 3434 290a 2a20 666b 6f5f 656e  ne  44).* fko_en
│ │ │ │ │ -00015c30: 6372 7970 7469 6f6e 5f74 7970 655f 743a  cryption_type_t:
│ │ │ │ │ -00015c40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015c50: 2045 6e63 7279 7074 696f 6e20 416c 676f   Encryption Algo
│ │ │ │ │ -00015c60: 7269 7468 6d73 2e0a 2020 2020 2020 2020  rithms..        
│ │ │ │ │ +00015a50: 4572 726f 7220 4861 6e64 6c69 6e67 2e20  Error Handling. 
│ │ │ │ │ +00015a60: 2020 2020 2028 6c69 6e65 2032 3431 290a       (line 241).
│ │ │ │ │ +00015a70: 2a20 666b 6f5f 6465 636f 6465 5f73 7061  * fko_decode_spa
│ │ │ │ │ +00015a80: 5f64 6174 613a 2020 2020 2020 2020 2020  _data:          
│ │ │ │ │ +00015a90: 2020 2020 2020 2020 2055 7469 6c69 7479           Utility
│ │ │ │ │ +00015aa0: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ │ +00015ab0: 696e 6520 2033 3829 0a2a 2066 6b6f 5f64  ine  38).* fko_d
│ │ │ │ │ +00015ac0: 6563 7279 7074 5f73 7061 5f64 6174 613a  ecrypt_spa_data:
│ │ │ │ │ +00015ad0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ +00015ae0: 2020 5574 696c 6974 7920 4675 6e63 7469    Utility Functi
│ │ │ │ │ +00015af0: 6f6e 732e 2020 2028 6c69 6e65 2020 3233  ons.   (line  23
│ │ │ │ │ +00015b00: 290a 2a20 666b 6f5f 6465 7374 726f 793a  ).* fko_destroy:
│ │ │ │ │ +00015b10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ +00015b20: 2020 2020 2020 2020 2020 2044 6573 7472             Destr
│ │ │ │ │ +00015b30: 6f79 696e 6720 436f 6e74 6578 7473 2e20  oying Contexts. 
│ │ │ │ │ +00015b40: 286c 696e 6520 2031 3129 0a2a 2066 6b6f  (line  11).* fko
│ │ │ │ │ +00015b50: 5f64 6967 6573 745f 7479 7065 5f74 3a20  _digest_type_t: 
│ │ │ │ │ +00015b60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ +00015b70: 2020 2020 4469 6765 7374 732e 2020 2020      Digests.    
│ │ │ │ │ +00015b80: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ │ +00015b90: 3137 290a 2a20 666b 6f5f 6469 6765 7374  17).* fko_digest
│ │ │ │ │ +00015ba0: 5f74 7970 655f 7420 3c31 3e3a 2020 2020  _type_t <1>:    
│ │ │ │ │ +00015bb0: 2020 2020 2020 2020 2020 2020 2048 4d41               HMA
│ │ │ │ │ +00015bc0: 4320 4469 6765 7374 732e 2020 2020 2020  C Digests.      
│ │ │ │ │ +00015bd0: 2020 286c 696e 6520 2031 3429 0a2a 2066    (line  14).* f
│ │ │ │ │ +00015be0: 6b6f 5f65 6e63 6f64 655f 7370 615f 6461  ko_encode_spa_da
│ │ │ │ │ +00015bf0: 7461 3a20 2020 2020 2020 2020 2020 2020  ta:             
│ │ │ │ │ +00015c00: 2020 2020 2020 5574 696c 6974 7920 4675        Utility Fu
│ │ │ │ │ +00015c10: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ │ +00015c20: 2020 3434 290a 2a20 666b 6f5f 656e 6372    44).* fko_encr
│ │ │ │ │ +00015c30: 7970 7469 6f6e 5f74 7970 655f 743a 2020  yption_type_t:  
│ │ │ │ │ +00015c40: 2020 2020 2020 2020 2020 2020 2020 2045                 E
│ │ │ │ │ +00015c50: 6e63 7279 7074 696f 6e20 416c 676f 7269  ncryption Algori
│ │ │ │ │ +00015c60: 7468 6d73 2e0a 2020 2020 2020 2020 2020  thms..          
│ │ │ │ │  00015c70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  00015c80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  00015c90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015ca0: 2020 2020 2020 286c 696e 6520 2031 3029        (line  10)
│ │ │ │ │ -00015cb0: 0a2a 2066 6b6f 5f65 6e63 7279 7074 5f73  .* fko_encrypt_s
│ │ │ │ │ -00015cc0: 7061 5f64 6174 613a 2020 2020 2020 2020  pa_data:        
│ │ │ │ │ -00015cd0: 2020 2020 2020 2020 2020 5574 696c 6974            Utilit
│ │ │ │ │ -00015ce0: 7920 4675 6e63 7469 6f6e 732e 2020 2028  y Functions.   (
│ │ │ │ │ -00015cf0: 6c69 6e65 2020 3332 290a 2a20 666b 6f5f  line  32).* fko_
│ │ │ │ │ -00015d00: 6572 7273 7472 3a20 2020 2020 2020 2020  errstr:         
│ │ │ │ │ +00015ca0: 2020 2020 286c 696e 6520 2031 3029 0a2a      (line  10).*
│ │ │ │ │ +00015cb0: 2066 6b6f 5f65 6e63 7279 7074 5f73 7061   fko_encrypt_spa
│ │ │ │ │ +00015cc0: 5f64 6174 613a 2020 2020 2020 2020 2020  _data:          
│ │ │ │ │ +00015cd0: 2020 2020 2020 2020 5574 696c 6974 7920          Utility 
│ │ │ │ │ +00015ce0: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ │ +00015cf0: 6e65 2020 3332 290a 2a20 666b 6f5f 6572  ne  32).* fko_er
│ │ │ │ │ +00015d00: 7273 7472 3a20 2020 2020 2020 2020 2020  rstr:           
│ │ │ │ │  00015d10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015d20: 2020 2045 7272 6f72 2048 616e 646c 696e     Error Handlin
│ │ │ │ │ -00015d30: 672e 2020 2020 2020 286c 696e 6520 2031  g.      (line  1
│ │ │ │ │ -00015d40: 3129 0a2a 2066 6b6f 5f67 6574 5f65 6e63  1).* fko_get_enc
│ │ │ │ │ -00015d50: 6f64 6564 5f64 6174 613a 2020 2020 2020  oded_data:      
│ │ │ │ │ -00015d60: 2020 2020 2020 2020 2020 2020 5265 7472              Retr
│ │ │ │ │ -00015d70: 6965 7669 6e67 2053 5041 2044 6174 612e  ieving SPA Data.
│ │ │ │ │ -00015d80: 2028 6c69 6e65 2031 3133 290a 2a20 666b   (line 113).* fk
│ │ │ │ │ -00015d90: 6f5f 6765 745f 6770 675f 6578 653a 2020  o_get_gpg_exe:  
│ │ │ │ │ +00015d20: 2045 7272 6f72 2048 616e 646c 696e 672e   Error Handling.
│ │ │ │ │ +00015d30: 2020 2020 2020 286c 696e 6520 2031 3129        (line  11)
│ │ │ │ │ +00015d40: 0a2a 2066 6b6f 5f67 6574 5f65 6e63 6f64  .* fko_get_encod
│ │ │ │ │ +00015d50: 6564 5f64 6174 613a 2020 2020 2020 2020  ed_data:        
│ │ │ │ │ +00015d60: 2020 2020 2020 2020 2020 5265 7472 6965            Retrie
│ │ │ │ │ +00015d70: 7669 6e67 2053 5041 2044 6174 612e 2028  ving SPA Data. (
│ │ │ │ │ +00015d80: 6c69 6e65 2031 3133 290a 2a20 666b 6f5f  line 113).* fko_
│ │ │ │ │ +00015d90: 6765 745f 6770 675f 6578 653a 2020 2020  get_gpg_exe:    
│ │ │ │ │  00015da0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015db0: 2020 2020 2052 6574 7269 6576 696e 6720       Retrieving 
│ │ │ │ │ -00015dc0: 5350 4120 4461 7461 2e20 286c 696e 6520  SPA Data. (line 
│ │ │ │ │ -00015dd0: 3138 3229 0a2a 2066 6b6f 5f67 6574 5f67  182).* fko_get_g
│ │ │ │ │ -00015de0: 7067 5f68 6f6d 655f 6469 723a 2020 2020  pg_home_dir:    
│ │ │ │ │ -00015df0: 2020 2020 2020 2020 2020 2020 2020 5265                Re
│ │ │ │ │ -00015e00: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat
│ │ │ │ │ -00015e10: 612e 2028 6c69 6e65 2031 3431 290a 2a20  a. (line 141).* 
│ │ │ │ │ -00015e20: 666b 6f5f 6765 745f 6770 675f 6967 6e6f  fko_get_gpg_igno
│ │ │ │ │ -00015e30: 7265 5f76 6572 6966 795f 6572 726f 723a  re_verify_error:
│ │ │ │ │ -00015e40: 2020 2020 2020 2052 6574 7269 6576 696e         Retrievin
│ │ │ │ │ -00015e50: 6720 5350 4120 4461 7461 2e20 286c 696e  g SPA Data. (lin
│ │ │ │ │ -00015e60: 6520 3135 3229 0a2a 2066 6b6f 5f67 6574  e 152).* fko_get
│ │ │ │ │ -00015e70: 5f67 7067 5f72 6563 6970 6965 6e74 3a20  _gpg_recipient: 
│ │ │ │ │ -00015e80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015e90: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D
│ │ │ │ │ -00015ea0: 6174 612e 2028 6c69 6e65 2031 3330 290a  ata. (line 130).
│ │ │ │ │ -00015eb0: 2a20 666b 6f5f 6765 745f 6770 675f 7369  * fko_get_gpg_si
│ │ │ │ │ -00015ec0: 676e 6174 7572 655f 6670 723a 2020 2020  gnature_fpr:    
│ │ │ │ │ -00015ed0: 2020 2020 2020 2020 2052 6574 7269 6576           Retriev
│ │ │ │ │ -00015ee0: 696e 6720 5350 4120 4461 7461 2e20 286c  ing SPA Data. (l
│ │ │ │ │ -00015ef0: 696e 6520 3136 3429 0a2a 2066 6b6f 5f67  ine 164).* fko_g
│ │ │ │ │ -00015f00: 6574 5f67 7067 5f73 6967 6e61 7475 7265  et_gpg_signature
│ │ │ │ │ -00015f10: 5f69 643a 2020 2020 2020 2020 2020 2020  _id:            
│ │ │ │ │ -00015f20: 2020 5265 7472 6965 7669 6e67 2053 5041    Retrieving SPA
│ │ │ │ │ -00015f30: 2044 6174 612e 2028 6c69 6e65 2031 3538   Data. (line 158
│ │ │ │ │ -00015f40: 290a 2a20 666b 6f5f 6765 745f 6770 675f  ).* fko_get_gpg_
│ │ │ │ │ -00015f50: 7369 676e 6174 7572 655f 7374 6174 7573  signature_status
│ │ │ │ │ -00015f60: 3a20 2020 2020 2020 2020 2052 6574 7269  :          Retri
│ │ │ │ │ -00015f70: 6576 696e 6720 5350 4120 4461 7461 2e20  eving SPA Data. 
│ │ │ │ │ -00015f80: 286c 696e 6520 3137 3629 0a2a 2066 6b6f  (line 176).* fko
│ │ │ │ │ -00015f90: 5f67 6574 5f67 7067 5f73 6967 6e61 7475  _get_gpg_signatu
│ │ │ │ │ -00015fa0: 7265 5f73 756d 6d61 7279 3a20 2020 2020  re_summary:     
│ │ │ │ │ -00015fb0: 2020 2020 5265 7472 6965 7669 6e67 2053      Retrieving S
│ │ │ │ │ -00015fc0: 5041 2044 6174 612e 2028 6c69 6e65 2031  PA Data. (line 1
│ │ │ │ │ -00015fd0: 3730 290a 2a20 666b 6f5f 6765 745f 6770  70).* fko_get_gp
│ │ │ │ │ -00015fe0: 675f 7369 676e 6174 7572 655f 7665 7269  g_signature_veri
│ │ │ │ │ -00015ff0: 6679 3a20 2020 2020 2020 2020 2052 6574  fy:          Ret
│ │ │ │ │ -00016000: 7269 6576 696e 6720 5350 4120 4461 7461  rieving SPA Data
│ │ │ │ │ -00016010: 2e20 286c 696e 6520 3134 3629 0a2a 2066  . (line 146).* f
│ │ │ │ │ -00016020: 6b6f 5f67 6574 5f67 7067 5f73 6967 6e65  ko_get_gpg_signe
│ │ │ │ │ -00016030: 723a 2020 2020 2020 2020 2020 2020 2020  r:              
│ │ │ │ │ -00016040: 2020 2020 2020 5265 7472 6965 7669 6e67        Retrieving
│ │ │ │ │ -00016050: 2053 5041 2044 6174 612e 2028 6c69 6e65   SPA Data. (line
│ │ │ │ │ -00016060: 2031 3336 290a 2a20 666b 6f5f 6765 745f   136).* fko_get_
│ │ │ │ │ -00016070: 7261 6e64 5f76 616c 7565 3a20 2020 2020  rand_value:     
│ │ │ │ │ -00016080: 2020 2020 2020 2020 2020 2020 2020 2052                 R
│ │ │ │ │ -00016090: 6574 7269 6576 696e 6720 5350 4120 4461  etrieving SPA Da
│ │ │ │ │ -000160a0: 7461 2e20 286c 696e 6520 2031 3829 0a2a  ta. (line  18).*
│ │ │ │ │ -000160b0: 2066 6b6f 5f67 6574 5f73 7061 5f63 6c69   fko_get_spa_cli
│ │ │ │ │ -000160c0: 656e 745f 7469 6d65 6f75 743a 2020 2020  ent_timeout:    
│ │ │ │ │ -000160d0: 2020 2020 2020 2020 5265 7472 6965 7669          Retrievi
│ │ │ │ │ -000160e0: 6e67 2053 5041 2044 6174 612e 2028 6c69  ng SPA Data. (li
│ │ │ │ │ -000160f0: 6e65 2020 3735 290a 2a20 666b 6f5f 6765  ne  75).* fko_ge
│ │ │ │ │ -00016100: 745f 7370 615f 6461 7461 3a20 2020 2020  t_spa_data:     
│ │ │ │ │ -00016110: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00016120: 2052 6574 7269 6576 696e 6720 5350 4120   Retrieving SPA 
│ │ │ │ │ -00016130: 4461 7461 2e20 286c 696e 6520 2031 3229  Data. (line  12)
│ │ │ │ │ -00016140: 0a2a 2066 6b6f 5f67 6574 5f73 7061 5f64  .* fko_get_spa_d
│ │ │ │ │ -00016150: 6967 6573 743a 2020 2020 2020 2020 2020  igest:          
│ │ │ │ │ -00016160: 2020 2020 2020 2020 2020 5265 7472 6965            Retrie
│ │ │ │ │ -00016170: 7669 6e67 2053 5041 2044 6174 612e 2028  ving SPA Data. (
│ │ │ │ │ -00016180: 6c69 6e65 2020 3935 290a 2a20 666b 6f5f  line  95).* fko_
│ │ │ │ │ -00016190: 6765 745f 7370 615f 6469 6765 7374 5f74  get_spa_digest_t
│ │ │ │ │ -000161a0: 7970 653a 2020 2020 2020 2020 2020 2020  ype:            
│ │ │ │ │ -000161b0: 2020 2052 6574 7269 6576 696e 6720 5350     Retrieving SP
│ │ │ │ │ -000161c0: 4120 4461 7461 2e20 286c 696e 6520 2038  A Data. (line  8
│ │ │ │ │ -000161d0: 3129 0a2a 2066 6b6f 5f67 6574 5f73 7061  1).* fko_get_spa
│ │ │ │ │ -000161e0: 5f65 6e63 7279 7074 696f 6e5f 7479 7065  _encryption_type
│ │ │ │ │ -000161f0: 3a20 2020 2020 2020 2020 2020 5265 7472  :           Retr
│ │ │ │ │ -00016200: 6965 7669 6e67 2053 5041 2044 6174 612e  ieving SPA Data.
│ │ │ │ │ -00016210: 2028 6c69 6e65 2031 3035 290a 2a20 666b   (line 105).* fk
│ │ │ │ │ -00016220: 6f5f 6765 745f 7370 615f 686d 6163 3a20  o_get_spa_hmac: 
│ │ │ │ │ +00015db0: 2020 2052 6574 7269 6576 696e 6720 5350     Retrieving SP
│ │ │ │ │ +00015dc0: 4120 4461 7461 2e20 286c 696e 6520 3138  A Data. (line 18
│ │ │ │ │ +00015dd0: 3229 0a2a 2066 6b6f 5f67 6574 5f67 7067  2).* fko_get_gpg
│ │ │ │ │ +00015de0: 5f68 6f6d 655f 6469 723a 2020 2020 2020  _home_dir:      
│ │ │ │ │ +00015df0: 2020 2020 2020 2020 2020 2020 5265 7472              Retr
│ │ │ │ │ +00015e00: 6965 7669 6e67 2053 5041 2044 6174 612e  ieving SPA Data.
│ │ │ │ │ +00015e10: 2028 6c69 6e65 2031 3431 290a 2a20 666b   (line 141).* fk
│ │ │ │ │ +00015e20: 6f5f 6765 745f 6770 675f 6967 6e6f 7265  o_get_gpg_ignore
│ │ │ │ │ +00015e30: 5f76 6572 6966 795f 6572 726f 723a 2020  _verify_error:  
│ │ │ │ │ +00015e40: 2020 2020 2052 6574 7269 6576 696e 6720       Retrieving 
│ │ │ │ │ +00015e50: 5350 4120 4461 7461 2e20 286c 696e 6520  SPA Data. (line 
│ │ │ │ │ +00015e60: 3135 3229 0a2a 2066 6b6f 5f67 6574 5f67  152).* fko_get_g
│ │ │ │ │ +00015e70: 7067 5f72 6563 6970 6965 6e74 3a20 2020  pg_recipient:   
│ │ │ │ │ +00015e80: 2020 2020 2020 2020 2020 2020 2020 5265                Re
│ │ │ │ │ +00015e90: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat
│ │ │ │ │ +00015ea0: 612e 2028 6c69 6e65 2031 3330 290a 2a20  a. (line 130).* 
│ │ │ │ │ +00015eb0: 666b 6f5f 6765 745f 6770 675f 7369 676e  fko_get_gpg_sign
│ │ │ │ │ +00015ec0: 6174 7572 655f 6670 723a 2020 2020 2020  ature_fpr:      
│ │ │ │ │ +00015ed0: 2020 2020 2020 2052 6574 7269 6576 696e         Retrievin
│ │ │ │ │ +00015ee0: 6720 5350 4120 4461 7461 2e20 286c 696e  g SPA Data. (lin
│ │ │ │ │ +00015ef0: 6520 3136 3429 0a2a 2066 6b6f 5f67 6574  e 164).* fko_get
│ │ │ │ │ +00015f00: 5f67 7067 5f73 6967 6e61 7475 7265 5f69  _gpg_signature_i
│ │ │ │ │ +00015f10: 643a 2020 2020 2020 2020 2020 2020 2020  d:              
│ │ │ │ │ +00015f20: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D
│ │ │ │ │ +00015f30: 6174 612e 2028 6c69 6e65 2031 3538 290a  ata. (line 158).
│ │ │ │ │ +00015f40: 2a20 666b 6f5f 6765 745f 6770 675f 7369  * fko_get_gpg_si
│ │ │ │ │ +00015f50: 676e 6174 7572 655f 7374 6174 7573 3a20  gnature_status: 
│ │ │ │ │ +00015f60: 2020 2020 2020 2020 2052 6574 7269 6576           Retriev
│ │ │ │ │ +00015f70: 696e 6720 5350 4120 4461 7461 2e20 286c  ing SPA Data. (l
│ │ │ │ │ +00015f80: 696e 6520 3137 3629 0a2a 2066 6b6f 5f67  ine 176).* fko_g
│ │ │ │ │ +00015f90: 6574 5f67 7067 5f73 6967 6e61 7475 7265  et_gpg_signature
│ │ │ │ │ +00015fa0: 5f73 756d 6d61 7279 3a20 2020 2020 2020  _summary:       
│ │ │ │ │ +00015fb0: 2020 5265 7472 6965 7669 6e67 2053 5041    Retrieving SPA
│ │ │ │ │ +00015fc0: 2044 6174 612e 2028 6c69 6e65 2031 3730   Data. (line 170
│ │ │ │ │ +00015fd0: 290a 2a20 666b 6f5f 6765 745f 6770 675f  ).* fko_get_gpg_
│ │ │ │ │ +00015fe0: 7369 676e 6174 7572 655f 7665 7269 6679  signature_verify
│ │ │ │ │ +00015ff0: 3a20 2020 2020 2020 2020 2052 6574 7269  :          Retri
│ │ │ │ │ +00016000: 6576 696e 6720 5350 4120 4461 7461 2e20  eving SPA Data. 
│ │ │ │ │ +00016010: 286c 696e 6520 3134 3629 0a2a 2066 6b6f  (line 146).* fko
│ │ │ │ │ +00016020: 5f67 6574 5f67 7067 5f73 6967 6e65 723a  _get_gpg_signer:
│ │ │ │ │ +00016030: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ +00016040: 2020 2020 5265 7472 6965 7669 6e67 2053      Retrieving S
│ │ │ │ │ +00016050: 5041 2044 6174 612e 2028 6c69 6e65 2031  PA Data. (line 1
│ │ │ │ │ +00016060: 3336 290a 2a20 666b 6f5f 6765 745f 7261  36).* fko_get_ra
│ │ │ │ │ +00016070: 6e64 5f76 616c 7565 3a20 2020 2020 2020  nd_value:       
│ │ │ │ │ +00016080: 2020 2020 2020 2020 2020 2020 2052 6574               Ret
│ │ │ │ │ +00016090: 7269 6576 696e 6720 5350 4120 4461 7461  rieving SPA Data
│ │ │ │ │ +000160a0: 2e20 286c 696e 6520 2031 3829 0a2a 2066  . (line  18).* f
│ │ │ │ │ +000160b0: 6b6f 5f67 6574 5f73 7061 5f63 6c69 656e  ko_get_spa_clien
│ │ │ │ │ +000160c0: 745f 7469 6d65 6f75 743a 2020 2020 2020  t_timeout:      
│ │ │ │ │ +000160d0: 2020 2020 2020 5265 7472 6965 7669 6e67        Retrieving
│ │ │ │ │ +000160e0: 2053 5041 2044 6174 612e 2028 6c69 6e65   SPA Data. (line
│ │ │ │ │ +000160f0: 2020 3735 290a 2a20 666b 6f5f 6765 745f    75).* fko_get_
│ │ │ │ │ +00016100: 7370 615f 6461 7461 3a20 2020 2020 2020  spa_data:       
│ │ │ │ │ +00016110: 2020 2020 2020 2020 2020 2020 2020 2052                 R
│ │ │ │ │ +00016120: 6574 7269 6576 696e 6720 5350 4120 4461  etrieving SPA Da
│ │ │ │ │ +00016130: 7461 2e20 286c 696e 6520 2031 3229 0a2a  ta. (line  12).*
│ │ │ │ │ +00016140: 2066 6b6f 5f67 6574 5f73 7061 5f64 6967   fko_get_spa_dig
│ │ │ │ │ +00016150: 6573 743a 2020 2020 2020 2020 2020 2020  est:            
│ │ │ │ │ +00016160: 2020 2020 2020 2020 5265 7472 6965 7669          Retrievi
│ │ │ │ │ +00016170: 6e67 2053 5041 2044 6174 612e 2028 6c69  ng SPA Data. (li
│ │ │ │ │ +00016180: 6e65 2020 3935 290a 2a20 666b 6f5f 6765  ne  95).* fko_ge
│ │ │ │ │ +00016190: 745f 7370 615f 6469 6765 7374 5f74 7970  t_spa_digest_typ
│ │ │ │ │ +000161a0: 653a 2020 2020 2020 2020 2020 2020 2020  e:              
│ │ │ │ │ +000161b0: 2052 6574 7269 6576 696e 6720 5350 4120   Retrieving SPA 
│ │ │ │ │ +000161c0: 4461 7461 2e20 286c 696e 6520 2038 3129  Data. (line  81)
│ │ │ │ │ +000161d0: 0a2a 2066 6b6f 5f67 6574 5f73 7061 5f65  .* fko_get_spa_e
│ │ │ │ │ +000161e0: 6e63 7279 7074 696f 6e5f 7479 7065 3a20  ncryption_type: 
│ │ │ │ │ +000161f0: 2020 2020 2020 2020 2020 5265 7472 6965            Retrie
│ │ │ │ │ +00016200: 7669 6e67 2053 5041 2044 6174 612e 2028  ving SPA Data. (
│ │ │ │ │ +00016210: 6c69 6e65 2031 3035 290a 2a20 666b 6f5f  line 105).* fko_
│ │ │ │ │ +00016220: 6765 745f 7370 615f 686d 6163 3a20 2020  get_spa_hmac:   
│ │ │ │ │  00016230: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00016240: 2020 2020 2052 6574 7269 6576 696e 6720       Retrieving 
│ │ │ │ │ -00016250: 5350 4120 4461 7461 2e20 286c 696e 6520  SPA Data. (line 
│ │ │ │ │ -00016260: 3130 3029 0a2a 2066 6b6f 5f67 6574 5f73  100).* fko_get_s
│ │ │ │ │ -00016270: 7061 5f68 6d61 635f 7479 7065 3a20 2020  pa_hmac_type:   
│ │ │ │ │ -00016280: 2020 2020 2020 2020 2020 2020 2020 5265                Re
│ │ │ │ │ -00016290: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat
│ │ │ │ │ -000162a0: 612e 2028 6c69 6e65 2020 3838 290a 2a20  a. (line  88).* 
│ │ │ │ │ -000162b0: 666b 6f5f 6765 745f 7370 615f 6d65 7373  fko_get_spa_mess
│ │ │ │ │ -000162c0: 6167 653a 2020 2020 2020 2020 2020 2020  age:            
│ │ │ │ │ -000162d0: 2020 2020 2020 2052 6574 7269 6576 696e         Retrievin
│ │ │ │ │ -000162e0: 6720 5350 4120 4461 7461 2e20 286c 696e  g SPA Data. (lin
│ │ │ │ │ -000162f0: 6520 2035 3629 0a2a 2066 6b6f 5f67 6574  e  56).* fko_get
│ │ │ │ │ -00016300: 5f73 7061 5f6d 6573 7361 6765 5f74 7970  _spa_message_typ
│ │ │ │ │ -00016310: 653a 2020 2020 2020 2020 2020 2020 2020  e:              
│ │ │ │ │ -00016320: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D
│ │ │ │ │ -00016330: 6174 612e 2028 6c69 6e65 2020 3334 290a  ata. (line  34).
│ │ │ │ │ -00016340: 2a20 666b 6f5f 6765 745f 7370 615f 6e61  * fko_get_spa_na
│ │ │ │ │ -00016350: 745f 6163 6365 7373 3a20 2020 2020 2020  t_access:       
│ │ │ │ │ -00016360: 2020 2020 2020 2020 2052 6574 7269 6576           Retriev
│ │ │ │ │ -00016370: 696e 6720 5350 4120 4461 7461 2e20 286c  ing SPA Data. (l
│ │ │ │ │ -00016380: 696e 6520 2036 3129 0a2a 2066 6b6f 5f67  ine  61).* fko_g
│ │ │ │ │ -00016390: 6574 5f73 7061 5f73 6572 7665 725f 6175  et_spa_server_au
│ │ │ │ │ -000163a0: 7468 3a20 2020 2020 2020 2020 2020 2020  th:             
│ │ │ │ │ -000163b0: 2020 5265 7472 6965 7669 6e67 2053 5041    Retrieving SPA
│ │ │ │ │ -000163c0: 2044 6174 612e 2028 6c69 6e65 2020 3638   Data. (line  68
│ │ │ │ │ -000163d0: 290a 2a20 666b 6f5f 6765 745f 7469 6d65  ).* fko_get_time
│ │ │ │ │ -000163e0: 7374 616d 703a 2020 2020 2020 2020 2020  stamp:          
│ │ │ │ │ -000163f0: 2020 2020 2020 2020 2020 2052 6574 7269             Retri
│ │ │ │ │ -00016400: 6576 696e 6720 5350 4120 4461 7461 2e20  eving SPA Data. 
│ │ │ │ │ -00016410: 286c 696e 6520 2032 3929 0a2a 2066 6b6f  (line  29).* fko
│ │ │ │ │ -00016420: 5f67 6574 5f75 7365 726e 616d 653a 2020  _get_username:  
│ │ │ │ │ +00016240: 2020 2052 6574 7269 6576 696e 6720 5350     Retrieving SP
│ │ │ │ │ +00016250: 4120 4461 7461 2e20 286c 696e 6520 3130  A Data. (line 10
│ │ │ │ │ +00016260: 3029 0a2a 2066 6b6f 5f67 6574 5f73 7061  0).* fko_get_spa
│ │ │ │ │ +00016270: 5f68 6d61 635f 7479 7065 3a20 2020 2020  _hmac_type:     
│ │ │ │ │ +00016280: 2020 2020 2020 2020 2020 2020 5265 7472              Retr
│ │ │ │ │ +00016290: 6965 7669 6e67 2053 5041 2044 6174 612e  ieving SPA Data.
│ │ │ │ │ +000162a0: 2028 6c69 6e65 2020 3838 290a 2a20 666b   (line  88).* fk
│ │ │ │ │ +000162b0: 6f5f 6765 745f 7370 615f 6d65 7373 6167  o_get_spa_messag
│ │ │ │ │ +000162c0: 653a 2020 2020 2020 2020 2020 2020 2020  e:              
│ │ │ │ │ +000162d0: 2020 2020 2052 6574 7269 6576 696e 6720       Retrieving 
│ │ │ │ │ +000162e0: 5350 4120 4461 7461 2e20 286c 696e 6520  SPA Data. (line 
│ │ │ │ │ +000162f0: 2035 3629 0a2a 2066 6b6f 5f67 6574 5f73   56).* fko_get_s
│ │ │ │ │ +00016300: 7061 5f6d 6573 7361 6765 5f74 7970 653a  pa_message_type:
│ │ │ │ │ +00016310: 2020 2020 2020 2020 2020 2020 2020 5265                Re
│ │ │ │ │ +00016320: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat
│ │ │ │ │ +00016330: 612e 2028 6c69 6e65 2020 3334 290a 2a20  a. (line  34).* 
│ │ │ │ │ +00016340: 666b 6f5f 6765 745f 7370 615f 6e61 745f  fko_get_spa_nat_
│ │ │ │ │ +00016350: 6163 6365 7373 3a20 2020 2020 2020 2020  access:         
│ │ │ │ │ +00016360: 2020 2020 2020 2052 6574 7269 6576 696e         Retrievin
│ │ │ │ │ +00016370: 6720 5350 4120 4461 7461 2e20 286c 696e  g SPA Data. (lin
│ │ │ │ │ +00016380: 6520 2036 3129 0a2a 2066 6b6f 5f67 6574  e  61).* fko_get
│ │ │ │ │ +00016390: 5f73 7061 5f73 6572 7665 725f 6175 7468  _spa_server_auth
│ │ │ │ │ +000163a0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ │ +000163b0: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D
│ │ │ │ │ +000163c0: 6174 612e 2028 6c69 6e65 2020 3638 290a  ata. (line  68).
│ │ │ │ │ +000163d0: 2a20 666b 6f5f 6765 745f 7469 6d65 7374  * fko_get_timest
│ │ │ │ │ +000163e0: 616d 703a 2020 2020 2020 2020 2020 2020  amp:            
│ │ │ │ │ +000163f0: 2020 2020 2020 2020 2052 6574 7269 6576           Retriev
│ │ │ │ │ +00016400: 696e 6720 5350 4120 4461 7461 2e20 286c  ing SPA Data. (l
│ │ │ │ │ +00016410: 696e 6520 2032 3929 0a2a 2066 6b6f 5f67  ine  29).* fko_g
│ │ │ │ │ +00016420: 6574 5f75 7365 726e 616d 653a 2020 2020  et_username:    
│ │ │ │ │  00016430: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00016440: 2020 2020 5265 7472 6965 7669 6e67 2053      Retrieving S
│ │ │ │ │ -00016450: 5041 2044 6174 612e 2028 6c69 6e65 2020  PA Data. (line  
│ │ │ │ │ -00016460: 3234 290a 2a20 666b 6f5f 6765 745f 7665  24).* fko_get_ve
│ │ │ │ │ -00016470: 7273 696f 6e3a 2020 2020 2020 2020 2020  rsion:          
│ │ │ │ │ -00016480: 2020 2020 2020 2020 2020 2020 2052 6574               Ret
│ │ │ │ │ -00016490: 7269 6576 696e 6720 5350 4120 4461 7461  rieving SPA Data
│ │ │ │ │ -000164a0: 2e20 286c 696e 6520 3132 3029 0a2a 2066  . (line 120).* f
│ │ │ │ │ -000164b0: 6b6f 5f67 7067 5f65 7272 7374 723a 2020  ko_gpg_errstr:  
│ │ │ │ │ +00016440: 2020 5265 7472 6965 7669 6e67 2053 5041    Retrieving SPA
│ │ │ │ │ +00016450: 2044 6174 612e 2028 6c69 6e65 2020 3234   Data. (line  24
│ │ │ │ │ +00016460: 290a 2a20 666b 6f5f 6765 745f 7665 7273  ).* fko_get_vers
│ │ │ │ │ +00016470: 696f 6e3a 2020 2020 2020 2020 2020 2020  ion:            
│ │ │ │ │ +00016480: 2020 2020 2020 2020 2020 2052 6574 7269             Retri
│ │ │ │ │ +00016490: 6576 696e 6720 5350 4120 4461 7461 2e20  eving SPA Data. 
│ │ │ │ │ +000164a0: 286c 696e 6520 3132 3029 0a2a 2066 6b6f  (line 120).* fko
│ │ │ │ │ +000164b0: 5f67 7067 5f65 7272 7374 723a 2020 2020  _gpg_errstr:    
│ │ │ │ │  000164c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000164d0: 2020 2020 2020 4572 726f 7220 4861 6e64        Error Hand
│ │ │ │ │ -000164e0: 6c69 6e67 2e20 2020 2020 2028 6c69 6e65  ling.      (line
│ │ │ │ │ -000164f0: 2033 3130 290a 2a20 666b 6f5f 6770 675f   310).* fko_gpg_
│ │ │ │ │ -00016500: 7369 676e 6174 7572 655f 6670 725f 6d61  signature_fpr_ma
│ │ │ │ │ -00016510: 7463 683a 2020 2020 2020 2020 2020 2055  tch:           U
│ │ │ │ │ -00016520: 7469 6c69 7479 2046 756e 6374 696f 6e73  tility Functions
│ │ │ │ │ -00016530: 2e20 2020 286c 696e 6520 2036 3129 0a2a  .   (line  61).*
│ │ │ │ │ -00016540: 2066 6b6f 5f67 7067 5f73 6967 6e61 7475   fko_gpg_signatu
│ │ │ │ │ -00016550: 7265 5f69 645f 6d61 7463 683a 2020 2020  re_id_match:    
│ │ │ │ │ -00016560: 2020 2020 2020 2020 5574 696c 6974 7920          Utility 
│ │ │ │ │ -00016570: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ │ -00016580: 6e65 2020 3534 290a 2a20 666b 6f5f 6d65  ne  54).* fko_me
│ │ │ │ │ -00016590: 7373 6167 655f 7479 7065 5f74 3a20 2020  ssage_type_t:   
│ │ │ │ │ -000165a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000165b0: 2053 5041 204d 6573 7361 6765 732e 2020   SPA Messages.  
│ │ │ │ │ -000165c0: 2020 2020 2020 286c 696e 6520 2031 3129        (line  11)
│ │ │ │ │ -000165d0: 0a2a 2066 6b6f 5f6e 6577 3a20 2020 2020  .* fko_new:     
│ │ │ │ │ +000164d0: 2020 2020 4572 726f 7220 4861 6e64 6c69      Error Handli
│ │ │ │ │ +000164e0: 6e67 2e20 2020 2020 2028 6c69 6e65 2033  ng.      (line 3
│ │ │ │ │ +000164f0: 3130 290a 2a20 666b 6f5f 6770 675f 7369  10).* fko_gpg_si
│ │ │ │ │ +00016500: 676e 6174 7572 655f 6670 725f 6d61 7463  gnature_fpr_matc
│ │ │ │ │ +00016510: 683a 2020 2020 2020 2020 2020 2055 7469  h:           Uti
│ │ │ │ │ +00016520: 6c69 7479 2046 756e 6374 696f 6e73 2e20  lity Functions. 
│ │ │ │ │ +00016530: 2020 286c 696e 6520 2036 3129 0a2a 2066    (line  61).* f
│ │ │ │ │ +00016540: 6b6f 5f67 7067 5f73 6967 6e61 7475 7265  ko_gpg_signature
│ │ │ │ │ +00016550: 5f69 645f 6d61 7463 683a 2020 2020 2020  _id_match:      
│ │ │ │ │ +00016560: 2020 2020 2020 5574 696c 6974 7920 4675        Utility Fu
│ │ │ │ │ +00016570: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ │ +00016580: 2020 3534 290a 2a20 666b 6f5f 6d65 7373    54).* fko_mess
│ │ │ │ │ +00016590: 6167 655f 7479 7065 5f74 3a20 2020 2020  age_type_t:     
│ │ │ │ │ +000165a0: 2020 2020 2020 2020 2020 2020 2020 2053                 S
│ │ │ │ │ +000165b0: 5041 204d 6573 7361 6765 732e 2020 2020  PA Messages.    
│ │ │ │ │ +000165c0: 2020 2020 286c 696e 6520 2031 3129 0a2a      (line  11).*
│ │ │ │ │ +000165d0: 2066 6b6f 5f6e 6577 3a20 2020 2020 2020   fko_new:       
│ │ │ │ │  000165e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000165f0: 2020 2020 2020 2020 2020 4372 6561 7469            Creati
│ │ │ │ │ -00016600: 6e67 2043 6f6e 7465 7874 732e 2020 2028  ng Contexts.   (
│ │ │ │ │ -00016610: 6c69 6e65 2020 3135 290a 2a20 666b 6f5f  line  15).* fko_
│ │ │ │ │ -00016620: 6e65 775f 7769 7468 5f64 6174 613a 2020  new_with_data:  
│ │ │ │ │ +000165f0: 2020 2020 2020 2020 4372 6561 7469 6e67          Creating
│ │ │ │ │ +00016600: 2043 6f6e 7465 7874 732e 2020 2028 6c69   Contexts.   (li
│ │ │ │ │ +00016610: 6e65 2020 3135 290a 2a20 666b 6f5f 6e65  ne  15).* fko_ne
│ │ │ │ │ +00016620: 775f 7769 7468 5f64 6174 613a 2020 2020  w_with_data:    
│ │ │ │ │  00016630: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00016640: 2020 2043 7265 6174 696e 6720 436f 6e74     Creating Cont
│ │ │ │ │ -00016650: 6578 7473 2e20 2020 286c 696e 6520 2033  exts.   (line  3
│ │ │ │ │ -00016660: 3829 0a2a 2066 6b6f 5f73 6574 5f67 7067  8).* fko_set_gpg
│ │ │ │ │ -00016670: 5f65 7865 3a20 2020 2020 2020 2020 2020  _exe:           
│ │ │ │ │ -00016680: 2020 2020 2020 2020 2020 2020 5365 7474              Sett
│ │ │ │ │ -00016690: 696e 6720 5350 4120 4461 7461 2e20 2020  ing SPA Data.   
│ │ │ │ │ -000166a0: 2028 6c69 6e65 2031 3436 290a 2a20 666b   (line 146).* fk
│ │ │ │ │ -000166b0: 6f5f 7365 745f 6770 675f 686f 6d65 5f64  o_set_gpg_home_d
│ │ │ │ │ -000166c0: 6972 3a20 2020 2020 2020 2020 2020 2020  ir:             
│ │ │ │ │ -000166d0: 2020 2020 2053 6574 7469 6e67 2053 5041       Setting SPA
│ │ │ │ │ -000166e0: 2044 6174 612e 2020 2020 286c 696e 6520   Data.    (line 
│ │ │ │ │ -000166f0: 3132 3629 0a2a 2066 6b6f 5f73 6574 5f67  126).* fko_set_g
│ │ │ │ │ -00016700: 7067 5f69 676e 6f72 655f 7665 7269 6679  pg_ignore_verify
│ │ │ │ │ -00016710: 5f65 7272 6f72 3a20 2020 2020 2020 5365  _error:       Se
│ │ │ │ │ -00016720: 7474 696e 6720 5350 4120 4461 7461 2e20  tting SPA Data. 
│ │ │ │ │ -00016730: 2020 2028 6c69 6e65 2031 3339 290a 2a20     (line 139).* 
│ │ │ │ │ -00016740: 666b 6f5f 7365 745f 6770 675f 7265 6369  fko_set_gpg_reci
│ │ │ │ │ -00016750: 7069 656e 743a 2020 2020 2020 2020 2020  pient:          
│ │ │ │ │ -00016760: 2020 2020 2020 2053 6574 7469 6e67 2053         Setting S
│ │ │ │ │ -00016770: 5041 2044 6174 612e 2020 2020 286c 696e  PA Data.    (lin
│ │ │ │ │ -00016780: 6520 3131 3429 0a2a 2066 6b6f 5f73 6574  e 114).* fko_set
│ │ │ │ │ -00016790: 5f67 7067 5f73 6967 6e61 7475 7265 5f76  _gpg_signature_v
│ │ │ │ │ -000167a0: 6572 6966 793a 2020 2020 2020 2020 2020  erify:          
│ │ │ │ │ -000167b0: 5365 7474 696e 6720 5350 4120 4461 7461  Setting SPA Data
│ │ │ │ │ -000167c0: 2e20 2020 2028 6c69 6e65 2031 3331 290a  .    (line 131).
│ │ │ │ │ -000167d0: 2a20 666b 6f5f 7365 745f 6770 675f 7369  * fko_set_gpg_si
│ │ │ │ │ -000167e0: 676e 6572 3a20 2020 2020 2020 2020 2020  gner:           
│ │ │ │ │ -000167f0: 2020 2020 2020 2020 2053 6574 7469 6e67           Setting
│ │ │ │ │ -00016800: 2053 5041 2044 6174 612e 2020 2020 286c   SPA Data.    (l
│ │ │ │ │ -00016810: 696e 6520 3132 3129 0a2a 2066 6b6f 5f73  ine 121).* fko_s
│ │ │ │ │ -00016820: 6574 5f72 616e 645f 7661 6c75 653a 2020  et_rand_value:  
│ │ │ │ │ +00016640: 2043 7265 6174 696e 6720 436f 6e74 6578   Creating Contex
│ │ │ │ │ +00016650: 7473 2e20 2020 286c 696e 6520 2033 3829  ts.   (line  38)
│ │ │ │ │ +00016660: 0a2a 2066 6b6f 5f73 6574 5f67 7067 5f65  .* fko_set_gpg_e
│ │ │ │ │ +00016670: 7865 3a20 2020 2020 2020 2020 2020 2020  xe:             
│ │ │ │ │ +00016680: 2020 2020 2020 2020 2020 5365 7474 696e            Settin
│ │ │ │ │ +00016690: 6720 5350 4120 4461 7461 2e20 2020 2028  g SPA Data.    (
│ │ │ │ │ +000166a0: 6c69 6e65 2031 3436 290a 2a20 666b 6f5f  line 146).* fko_
│ │ │ │ │ +000166b0: 7365 745f 6770 675f 686f 6d65 5f64 6972  set_gpg_home_dir
│ │ │ │ │ +000166c0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ │ +000166d0: 2020 2053 6574 7469 6e67 2053 5041 2044     Setting SPA D
│ │ │ │ │ +000166e0: 6174 612e 2020 2020 286c 696e 6520 3132  ata.    (line 12
│ │ │ │ │ +000166f0: 3629 0a2a 2066 6b6f 5f73 6574 5f67 7067  6).* fko_set_gpg
│ │ │ │ │ +00016700: 5f69 676e 6f72 655f 7665 7269 6679 5f65  _ignore_verify_e
│ │ │ │ │ +00016710: 7272 6f72 3a20 2020 2020 2020 5365 7474  rror:       Sett
│ │ │ │ │ +00016720: 696e 6720 5350 4120 4461 7461 2e20 2020  ing SPA Data.   
│ │ │ │ │ +00016730: 2028 6c69 6e65 2031 3339 290a 2a20 666b   (line 139).* fk
│ │ │ │ │ +00016740: 6f5f 7365 745f 6770 675f 7265 6369 7069  o_set_gpg_recipi
│ │ │ │ │ +00016750: 656e 743a 2020 2020 2020 2020 2020 2020  ent:            
│ │ │ │ │ +00016760: 2020 2020 2053 6574 7469 6e67 2053 5041       Setting SPA
│ │ │ │ │ +00016770: 2044 6174 612e 2020 2020 286c 696e 6520   Data.    (line 
│ │ │ │ │ +00016780: 3131 3429 0a2a 2066 6b6f 5f73 6574 5f67  114).* fko_set_g
│ │ │ │ │ +00016790: 7067 5f73 6967 6e61 7475 7265 5f76 6572  pg_signature_ver
│ │ │ │ │ +000167a0: 6966 793a 2020 2020 2020 2020 2020 5365  ify:          Se
│ │ │ │ │ +000167b0: 7474 696e 6720 5350 4120 4461 7461 2e20  tting SPA Data. 
│ │ │ │ │ +000167c0: 2020 2028 6c69 6e65 2031 3331 290a 2a20     (line 131).* 
│ │ │ │ │ +000167d0: 666b 6f5f 7365 745f 6770 675f 7369 676e  fko_set_gpg_sign
│ │ │ │ │ +000167e0: 6572 3a20 2020 2020 2020 2020 2020 2020  er:             
│ │ │ │ │ +000167f0: 2020 2020 2020 2053 6574 7469 6e67 2053         Setting S
│ │ │ │ │ +00016800: 5041 2044 6174 612e 2020 2020 286c 696e  PA Data.    (lin
│ │ │ │ │ +00016810: 6520 3132 3129 0a2a 2066 6b6f 5f73 6574  e 121).* fko_set
│ │ │ │ │ +00016820: 5f72 616e 645f 7661 6c75 653a 2020 2020  _rand_value:    
│ │ │ │ │  00016830: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00016840: 2020 5365 7474 696e 6720 5350 4120 4461    Setting SPA Da
│ │ │ │ │ -00016850: 7461 2e20 2020 2028 6c69 6e65 2020 3334  ta.    (line  34
│ │ │ │ │ -00016860: 290a 2a20 666b 6f5f 7365 745f 7370 615f  ).* fko_set_spa_
│ │ │ │ │ -00016870: 636c 6965 6e74 5f74 696d 656f 7574 3a20  client_timeout: 
│ │ │ │ │ -00016880: 2020 2020 2020 2020 2020 2053 6574 7469             Setti
│ │ │ │ │ -00016890: 6e67 2053 5041 2044 6174 612e 2020 2020  ng SPA Data.    
│ │ │ │ │ -000168a0: 286c 696e 6520 2038 3029 0a2a 2066 6b6f  (line  80).* fko
│ │ │ │ │ -000168b0: 5f73 6574 5f73 7061 5f64 6174 613a 2020  _set_spa_data:  
│ │ │ │ │ +00016840: 5365 7474 696e 6720 5350 4120 4461 7461  Setting SPA Data
│ │ │ │ │ +00016850: 2e20 2020 2028 6c69 6e65 2020 3334 290a  .    (line  34).
│ │ │ │ │ +00016860: 2a20 666b 6f5f 7365 745f 7370 615f 636c  * fko_set_spa_cl
│ │ │ │ │ +00016870: 6965 6e74 5f74 696d 656f 7574 3a20 2020  ient_timeout:   
│ │ │ │ │ +00016880: 2020 2020 2020 2020 2053 6574 7469 6e67           Setting
│ │ │ │ │ +00016890: 2053 5041 2044 6174 612e 2020 2020 286c   SPA Data.    (l
│ │ │ │ │ +000168a0: 696e 6520 2038 3029 0a2a 2066 6b6f 5f73  ine  80).* fko_s
│ │ │ │ │ +000168b0: 6574 5f73 7061 5f64 6174 613a 2020 2020  et_spa_data:    
│ │ │ │ │  000168c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000168d0: 2020 2020 5365 7474 696e 6720 5350 4120      Setting SPA 
│ │ │ │ │ -000168e0: 4461 7461 2e20 2020 2028 6c69 6e65 2031  Data.    (line 1
│ │ │ │ │ -000168f0: 3035 290a 2a20 666b 6f5f 7365 745f 7370  05).* fko_set_sp
│ │ │ │ │ -00016900: 615f 6469 6765 7374 3a20 2020 2020 2020  a_digest:       
│ │ │ │ │ -00016910: 2020 2020 2020 2020 2020 2020 2053 6574               Set
│ │ │ │ │ -00016920: 7469 6e67 2053 5041 2044 6174 612e 2020  ting SPA Data.  
│ │ │ │ │ -00016930: 2020 286c 696e 6520 2038 3929 0a2a 2066    (line  89).* f
│ │ │ │ │ -00016940: 6b6f 5f73 6574 5f73 7061 5f64 6967 6573  ko_set_spa_diges
│ │ │ │ │ -00016950: 745f 7479 7065 3a20 2020 2020 2020 2020  t_type:         
│ │ │ │ │ -00016960: 2020 2020 2020 5365 7474 696e 6720 5350        Setting SP
│ │ │ │ │ -00016970: 4120 4461 7461 2e20 2020 2028 6c69 6e65  A Data.    (line
│ │ │ │ │ -00016980: 2020 3131 290a 2a20 666b 6f5f 7365 745f    11).* fko_set_
│ │ │ │ │ -00016990: 7370 615f 656e 6372 7970 7469 6f6e 5f74  spa_encryption_t
│ │ │ │ │ -000169a0: 7970 653a 2020 2020 2020 2020 2020 2053  ype:           S
│ │ │ │ │ -000169b0: 6574 7469 6e67 2053 5041 2044 6174 612e  etting SPA Data.
│ │ │ │ │ -000169c0: 2020 2020 286c 696e 6520 2032 3729 0a2a      (line  27).*
│ │ │ │ │ -000169d0: 2066 6b6f 5f73 6574 5f73 7061 5f68 6d61   fko_set_spa_hma
│ │ │ │ │ -000169e0: 633a 2020 2020 2020 2020 2020 2020 2020  c:              
│ │ │ │ │ -000169f0: 2020 2020 2020 2020 5365 7474 696e 6720          Setting 
│ │ │ │ │ -00016a00: 5350 4120 4461 7461 2e20 2020 2028 6c69  SPA Data.    (li
│ │ │ │ │ -00016a10: 6e65 2020 3937 290a 2a20 666b 6f5f 7365  ne  97).* fko_se
│ │ │ │ │ -00016a20: 745f 7370 615f 686d 6163 5f74 7970 653a  t_spa_hmac_type:
│ │ │ │ │ -00016a30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00016a40: 2053 6574 7469 6e67 2053 5041 2044 6174   Setting SPA Dat
│ │ │ │ │ -00016a50: 612e 2020 2020 286c 696e 6520 2031 3929  a.    (line  19)
│ │ │ │ │ -00016a60: 0a2a 2066 6b6f 5f73 6574 5f73 7061 5f6d  .* fko_set_spa_m
│ │ │ │ │ -00016a70: 6573 7361 6765 3a20 2020 2020 2020 2020  essage:         
│ │ │ │ │ -00016a80: 2020 2020 2020 2020 2020 5365 7474 696e            Settin
│ │ │ │ │ -00016a90: 6720 5350 4120 4461 7461 2e20 2020 2028  g SPA Data.    (
│ │ │ │ │ -00016aa0: 6c69 6e65 2020 3633 290a 2a20 666b 6f5f  line  63).* fko_
│ │ │ │ │ -00016ab0: 7365 745f 7370 615f 6d65 7373 6167 655f  set_spa_message_
│ │ │ │ │ -00016ac0: 7479 7065 3a20 2020 2020 2020 2020 2020  type:           
│ │ │ │ │ -00016ad0: 2020 2053 6574 7469 6e67 2053 5041 2044     Setting SPA D
│ │ │ │ │ -00016ae0: 6174 612e 2020 2020 286c 696e 6520 2035  ata.    (line  5
│ │ │ │ │ -00016af0: 3629 0a2a 2066 6b6f 5f73 6574 5f73 7061  6).* fko_set_spa
│ │ │ │ │ -00016b00: 5f6e 6174 5f61 6363 6573 733a 2020 2020  _nat_access:    
│ │ │ │ │ -00016b10: 2020 2020 2020 2020 2020 2020 5365 7474              Sett
│ │ │ │ │ -00016b20: 696e 6720 5350 4120 4461 7461 2e20 2020  ing SPA Data.   
│ │ │ │ │ -00016b30: 2028 6c69 6e65 2020 3639 290a 2a20 666b   (line  69).* fk
│ │ │ │ │ -00016b40: 6f5f 7365 745f 7370 615f 7365 7276 6572  o_set_spa_server
│ │ │ │ │ -00016b50: 5f61 7574 683a 2020 2020 2020 2020 2020  _auth:          
│ │ │ │ │ -00016b60: 2020 2020 2053 6574 7469 6e67 2053 5041       Setting SPA
│ │ │ │ │ -00016b70: 2044 6174 612e 2020 2020 286c 696e 6520   Data.    (line 
│ │ │ │ │ -00016b80: 2037 3529 0a2a 2066 6b6f 5f73 6574 5f74   75).* fko_set_t
│ │ │ │ │ -00016b90: 696d 6573 7461 6d70 3a20 2020 2020 2020  imestamp:       
│ │ │ │ │ -00016ba0: 2020 2020 2020 2020 2020 2020 2020 5365                Se
│ │ │ │ │ -00016bb0: 7474 696e 6720 5350 4120 4461 7461 2e20  tting SPA Data. 
│ │ │ │ │ -00016bc0: 2020 2028 6c69 6e65 2020 3532 290a 2a20     (line  52).* 
│ │ │ │ │ -00016bd0: 666b 6f5f 7365 745f 7573 6572 6e61 6d65  fko_set_username
│ │ │ │ │ -00016be0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ │ -00016bf0: 2020 2020 2020 2053 6574 7469 6e67 2053         Setting S
│ │ │ │ │ -00016c00: 5041 2044 6174 612e 2020 2020 286c 696e  PA Data.    (lin
│ │ │ │ │ -00016c10: 6520 2034 3229 0a2a 2066 6b6f 5f73 7061  e  42).* fko_spa
│ │ │ │ │ -00016c20: 5f64 6174 615f 6669 6e61 6c3a 2020 2020  _data_final:    
│ │ │ │ │ -00016c30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00016c40: 5574 696c 6974 7920 4675 6e63 7469 6f6e  Utility Function
│ │ │ │ │ -00016c50: 732e 2020 2028 6c69 6e65 2020 3136 290a  s.   (line  16).
│ │ │ │ │ -00016c60: 2a20 7370 615f 6d65 7373 6167 655f 6669  * spa_message_fi
│ │ │ │ │ -00016c70: 656c 6473 3a20 2020 2020 2020 2020 2020  elds:           
│ │ │ │ │ -00016c80: 2020 2020 2020 2020 2053 5041 2044 6174           SPA Dat
│ │ │ │ │ -00016c90: 6120 466f 726d 6174 2e20 2020 2020 286c  a Format.     (l
│ │ │ │ │ -00016ca0: 696e 6520 2031 3229 0a0a 0a1f 0a54 6167  ine  12).....Tag
│ │ │ │ │ -00016cb0: 2054 6162 6c65 3a0a 4e6f 6465 3a20 546f   Table:.Node: To
│ │ │ │ │ -00016cc0: 707f 3131 3139 0a4e 6f64 653a 2049 6e74  p.1119.Node: Int
│ │ │ │ │ -00016cd0: 726f 6475 6374 696f 6e7f 3433 3137 0a4e  roduction.4317.N
│ │ │ │ │ -00016ce0: 6f64 653a 2047 6574 7469 6e67 2053 7461  ode: Getting Sta
│ │ │ │ │ -00016cf0: 7274 6564 7f36 3032 370a 4e6f 6465 3a20  rted.6027.Node: 
│ │ │ │ │ -00016d00: 4665 6174 7572 6573 7f36 3632 330a 4e6f  Features.6623.No
│ │ │ │ │ -00016d10: 6465 3a20 4f76 6572 7669 6577 7f37 3638  de: Overview.768
│ │ │ │ │ -00016d20: 310a 4e6f 6465 3a20 5350 4120 4461 7461  1.Node: SPA Data
│ │ │ │ │ -00016d30: 2046 6f72 6d61 747f 3837 3430 0a4e 6f64   Format.8740.Nod
│ │ │ │ │ -00016d40: 653a 2050 7265 7061 7261 7469 6f6e 7f31  e: Preparation.1
│ │ │ │ │ -00016d50: 3133 3736 0a4e 6f64 653a 206c 6962 666b  1376.Node: libfk
│ │ │ │ │ -00016d60: 6f20 4865 6164 6572 7f31 3139 3336 0a4e  o Header.11936.N
│ │ │ │ │ -00016d70: 6f64 653a 2043 6f6d 7069 6c69 6e67 2077  ode: Compiling w
│ │ │ │ │ -00016d80: 6974 6820 6c69 6266 6b6f 7f31 3234 3739  ith libfko.12479
│ │ │ │ │ -00016d90: 0a4e 6f64 653a 2053 5041 2050 6172 616d  .Node: SPA Param
│ │ │ │ │ -00016da0: 6574 6572 2054 7970 6573 7f31 3335 3634  eter Types.13564
│ │ │ │ │ -00016db0: 0a4e 6f64 653a 2044 6967 6573 7473 7f31  .Node: Digests.1
│ │ │ │ │ -00016dc0: 3430 3736 0a4e 6f64 653a 2053 5041 204d  4076.Node: SPA M
│ │ │ │ │ -00016dd0: 6573 7361 6765 737f 3135 3133 390a 4e6f  essages.15139.No
│ │ │ │ │ -00016de0: 6465 3a20 456e 6372 7970 7469 6f6e 2041  de: Encryption A
│ │ │ │ │ -00016df0: 6c67 6f72 6974 686d 737f 3137 3235 390a  lgorithms.17259.
│ │ │ │ │ -00016e00: 4e6f 6465 3a20 484d 4143 2044 6967 6573  Node: HMAC Diges
│ │ │ │ │ -00016e10: 7473 7f31 3833 3937 0a4e 6f64 653a 2055  ts.18397.Node: U
│ │ │ │ │ -00016e20: 7369 6e67 206c 6962 666b 6f7f 3139 3239  sing libfko.1929
│ │ │ │ │ -00016e30: 380a 4e6f 6465 3a20 4372 6561 7469 6e67  8.Node: Creating
│ │ │ │ │ -00016e40: 2043 6f6e 7465 7874 737f 3230 3133 370a   Contexts.20137.
│ │ │ │ │ -00016e50: 4e6f 6465 3a20 4465 7374 726f 7969 6e67  Node: Destroying
│ │ │ │ │ -00016e60: 2043 6f6e 7465 7874 737f 3235 3132 340a   Contexts.25124.
│ │ │ │ │ -00016e70: 4e6f 6465 3a20 4372 6561 7469 6e67 2061  Node: Creating a
│ │ │ │ │ -00016e80: 2053 5041 204d 6573 7361 6765 7f32 3537   SPA Message.257
│ │ │ │ │ -00016e90: 3435 0a4e 6f64 653a 2053 6574 7469 6e67  45.Node: Setting
│ │ │ │ │ -00016ea0: 2053 5041 2044 6174 617f 3330 3537 390a   SPA Data.30579.
│ │ │ │ │ -00016eb0: 4e6f 6465 3a20 5265 7472 6965 7669 6e67  Node: Retrieving
│ │ │ │ │ -00016ec0: 2053 5041 2044 6174 617f 3338 3134 300a   SPA Data.38140.
│ │ │ │ │ -00016ed0: 4e6f 6465 3a20 5574 696c 6974 7920 4675  Node: Utility Fu
│ │ │ │ │ -00016ee0: 6e63 7469 6f6e 737f 3437 3132 330a 4e6f  nctions.47123.No
│ │ │ │ │ -00016ef0: 6465 3a20 4572 726f 7220 4861 6e64 6c69  de: Error Handli
│ │ │ │ │ -00016f00: 6e67 7f35 3035 3034 0a4e 6f64 653a 204c  ng.50504.Node: L
│ │ │ │ │ -00016f10: 6962 7261 7279 2043 6f70 7969 6e67 7f36  ibrary Copying.6
│ │ │ │ │ -00016f20: 3538 3530 0a4e 6f64 653a 2043 6f6e 6365  5850.Node: Conce
│ │ │ │ │ -00016f30: 7074 2049 6e64 6578 7f38 3531 3432 0a4e  pt Index.85142.N
│ │ │ │ │ -00016f40: 6f64 653a 2046 756e 6374 696f 6e20 616e  ode: Function an
│ │ │ │ │ -00016f50: 6420 4461 7461 2049 6e64 6578 7f38 3833  d Data Index.883
│ │ │ │ │ -00016f60: 3839 0a1f 0a45 6e64 2054 6167 2054 6162  89...End Tag Tab
│ │ │ │ │ -00016f70: 6c65 0a0a 1f0a 4c6f 6361 6c20 5661 7269  le....Local Vari
│ │ │ │ │ -00016f80: 6162 6c65 733a 0a63 6f64 696e 673a 2075  ables:.coding: u
│ │ │ │ │ -00016f90: 7466 2d38 0a45 6e64 3a0a                 tf-8.End:.
│ │ │ │ │ +000168d0: 2020 5365 7474 696e 6720 5350 4120 4461    Setting SPA Da
│ │ │ │ │ +000168e0: 7461 2e20 2020 2028 6c69 6e65 2031 3035  ta.    (line 105
│ │ │ │ │ +000168f0: 290a 2a20 666b 6f5f 7365 745f 7370 615f  ).* fko_set_spa_
│ │ │ │ │ +00016900: 6469 6765 7374 3a20 2020 2020 2020 2020  digest:         
│ │ │ │ │ +00016910: 2020 2020 2020 2020 2020 2053 6574 7469             Setti
│ │ │ │ │ +00016920: 6e67 2053 5041 2044 6174 612e 2020 2020  ng SPA Data.    
│ │ │ │ │ +00016930: 286c 696e 6520 2038 3929 0a2a 2066 6b6f  (line  89).* fko
│ │ │ │ │ +00016940: 5f73 6574 5f73 7061 5f64 6967 6573 745f  _set_spa_digest_
│ │ │ │ │ +00016950: 7479 7065 3a20 2020 2020 2020 2020 2020  type:           
│ │ │ │ │ +00016960: 2020 2020 5365 7474 696e 6720 5350 4120      Setting SPA 
│ │ │ │ │ +00016970: 4461 7461 2e20 2020 2028 6c69 6e65 2020  Data.    (line  
│ │ │ │ │ +00016980: 3131 290a 2a20 666b 6f5f 7365 745f 7370  11).* fko_set_sp
│ │ │ │ │ +00016990: 615f 656e 6372 7970 7469 6f6e 5f74 7970  a_encryption_typ
│ │ │ │ │ +000169a0: 653a 2020 2020 2020 2020 2020 2053 6574  e:           Set
│ │ │ │ │ +000169b0: 7469 6e67 2053 5041 2044 6174 612e 2020  ting SPA Data.  
│ │ │ │ │ +000169c0: 2020 286c 696e 6520 2032 3729 0a2a 2066    (line  27).* f
│ │ │ │ │ +000169d0: 6b6f 5f73 6574 5f73 7061 5f68 6d61 633a  ko_set_spa_hmac:
│ │ │ │ │ +000169e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ +000169f0: 2020 2020 2020 5365 7474 696e 6720 5350        Setting SP
│ │ │ │ │ +00016a00: 4120 4461 7461 2e20 2020 2028 6c69 6e65  A Data.    (line
│ │ │ │ │ +00016a10: 2020 3937 290a 2a20 666b 6f5f 7365 745f    97).* fko_set_
│ │ │ │ │ +00016a20: 7370 615f 686d 6163 5f74 7970 653a 2020  spa_hmac_type:  
│ │ │ │ │ +00016a30: 2020 2020 2020 2020 2020 2020 2020 2053                 S
│ │ │ │ │ +00016a40: 6574 7469 6e67 2053 5041 2044 6174 612e  etting SPA Data.
│ │ │ │ │ +00016a50: 2020 2020 286c 696e 6520 2031 3929 0a2a      (line  19).*
│ │ │ │ │ +00016a60: 2066 6b6f 5f73 6574 5f73 7061 5f6d 6573   fko_set_spa_mes
│ │ │ │ │ +00016a70: 7361 6765 3a20 2020 2020 2020 2020 2020  sage:           
│ │ │ │ │ +00016a80: 2020 2020 2020 2020 5365 7474 696e 6720          Setting 
│ │ │ │ │ +00016a90: 5350 4120 4461 7461 2e20 2020 2028 6c69  SPA Data.    (li
│ │ │ │ │ +00016aa0: 6e65 2020 3633 290a 2a20 666b 6f5f 7365  ne  63).* fko_se
│ │ │ │ │ +00016ab0: 745f 7370 615f 6d65 7373 6167 655f 7479  t_spa_message_ty
│ │ │ │ │ +00016ac0: 7065 3a20 2020 2020 2020 2020 2020 2020  pe:             
│ │ │ │ │ +00016ad0: 2053 6574 7469 6e67 2053 5041 2044 6174   Setting SPA Dat
│ │ │ │ │ +00016ae0: 612e 2020 2020 286c 696e 6520 2035 3629  a.    (line  56)
│ │ │ │ │ +00016af0: 0a2a 2066 6b6f 5f73 6574 5f73 7061 5f6e  .* fko_set_spa_n
│ │ │ │ │ +00016b00: 6174 5f61 6363 6573 733a 2020 2020 2020  at_access:      
│ │ │ │ │ +00016b10: 2020 2020 2020 2020 2020 5365 7474 696e            Settin
│ │ │ │ │ +00016b20: 6720 5350 4120 4461 7461 2e20 2020 2028  g SPA Data.    (
│ │ │ │ │ +00016b30: 6c69 6e65 2020 3639 290a 2a20 666b 6f5f  line  69).* fko_
│ │ │ │ │ +00016b40: 7365 745f 7370 615f 7365 7276 6572 5f61  set_spa_server_a
│ │ │ │ │ +00016b50: 7574 683a 2020 2020 2020 2020 2020 2020  uth:            
│ │ │ │ │ +00016b60: 2020 2053 6574 7469 6e67 2053 5041 2044     Setting SPA D
│ │ │ │ │ +00016b70: 6174 612e 2020 2020 286c 696e 6520 2037  ata.    (line  7
│ │ │ │ │ +00016b80: 3529 0a2a 2066 6b6f 5f73 6574 5f74 696d  5).* fko_set_tim
│ │ │ │ │ +00016b90: 6573 7461 6d70 3a20 2020 2020 2020 2020  estamp:         
│ │ │ │ │ +00016ba0: 2020 2020 2020 2020 2020 2020 5365 7474              Sett
│ │ │ │ │ +00016bb0: 696e 6720 5350 4120 4461 7461 2e20 2020  ing SPA Data.   
│ │ │ │ │ +00016bc0: 2028 6c69 6e65 2020 3532 290a 2a20 666b   (line  52).* fk
│ │ │ │ │ +00016bd0: 6f5f 7365 745f 7573 6572 6e61 6d65 3a20  o_set_username: 
│ │ │ │ │ +00016be0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ +00016bf0: 2020 2020 2053 6574 7469 6e67 2053 5041       Setting SPA
│ │ │ │ │ +00016c00: 2044 6174 612e 2020 2020 286c 696e 6520   Data.    (line 
│ │ │ │ │ +00016c10: 2034 3229 0a2a 2066 6b6f 5f73 7061 5f64   42).* fko_spa_d
│ │ │ │ │ +00016c20: 6174 615f 6669 6e61 6c3a 2020 2020 2020  ata_final:      
│ │ │ │ │ +00016c30: 2020 2020 2020 2020 2020 2020 2020 5574                Ut
│ │ │ │ │ +00016c40: 696c 6974 7920 4675 6e63 7469 6f6e 732e  ility Functions.
│ │ │ │ │ +00016c50: 2020 2028 6c69 6e65 2020 3136 290a 2a20     (line  16).* 
│ │ │ │ │ +00016c60: 7370 615f 6d65 7373 6167 655f 6669 656c  spa_message_fiel
│ │ │ │ │ +00016c70: 6473 3a20 2020 2020 2020 2020 2020 2020  ds:             
│ │ │ │ │ +00016c80: 2020 2020 2020 2053 5041 2044 6174 6120         SPA Data 
│ │ │ │ │ +00016c90: 466f 726d 6174 2e20 2020 2020 286c 696e  Format.     (lin
│ │ │ │ │ +00016ca0: 6520 2031 3229 0a0a 0a1f 0a54 6167 2054  e  12).....Tag T
│ │ │ │ │ +00016cb0: 6162 6c65 3a0a 4e6f 6465 3a20 546f 707f  able:.Node: Top.
│ │ │ │ │ +00016cc0: 3131 3138 0a4e 6f64 653a 2049 6e74 726f  1118.Node: Intro
│ │ │ │ │ +00016cd0: 6475 6374 696f 6e7f 3433 3135 0a4e 6f64  duction.4315.Nod
│ │ │ │ │ +00016ce0: 653a 2047 6574 7469 6e67 2053 7461 7274  e: Getting Start
│ │ │ │ │ +00016cf0: 6564 7f36 3032 350a 4e6f 6465 3a20 4665  ed.6025.Node: Fe
│ │ │ │ │ +00016d00: 6174 7572 6573 7f36 3632 310a 4e6f 6465  atures.6621.Node
│ │ │ │ │ +00016d10: 3a20 4f76 6572 7669 6577 7f37 3637 390a  : Overview.7679.
│ │ │ │ │ +00016d20: 4e6f 6465 3a20 5350 4120 4461 7461 2046  Node: SPA Data F
│ │ │ │ │ +00016d30: 6f72 6d61 747f 3837 3338 0a4e 6f64 653a  ormat.8738.Node:
│ │ │ │ │ +00016d40: 2050 7265 7061 7261 7469 6f6e 7f31 3133   Preparation.113
│ │ │ │ │ +00016d50: 3734 0a4e 6f64 653a 206c 6962 666b 6f20  74.Node: libfko 
│ │ │ │ │ +00016d60: 4865 6164 6572 7f31 3139 3334 0a4e 6f64  Header.11934.Nod
│ │ │ │ │ +00016d70: 653a 2043 6f6d 7069 6c69 6e67 2077 6974  e: Compiling wit
│ │ │ │ │ +00016d80: 6820 6c69 6266 6b6f 7f31 3234 3737 0a4e  h libfko.12477.N
│ │ │ │ │ +00016d90: 6f64 653a 2053 5041 2050 6172 616d 6574  ode: SPA Paramet
│ │ │ │ │ +00016da0: 6572 2054 7970 6573 7f31 3335 3632 0a4e  er Types.13562.N
│ │ │ │ │ +00016db0: 6f64 653a 2044 6967 6573 7473 7f31 3430  ode: Digests.140
│ │ │ │ │ +00016dc0: 3734 0a4e 6f64 653a 2053 5041 204d 6573  74.Node: SPA Mes
│ │ │ │ │ +00016dd0: 7361 6765 737f 3135 3133 370a 4e6f 6465  sages.15137.Node
│ │ │ │ │ +00016de0: 3a20 456e 6372 7970 7469 6f6e 2041 6c67  : Encryption Alg
│ │ │ │ │ +00016df0: 6f72 6974 686d 737f 3137 3235 370a 4e6f  orithms.17257.No
│ │ │ │ │ +00016e00: 6465 3a20 484d 4143 2044 6967 6573 7473  de: HMAC Digests
│ │ │ │ │ +00016e10: 7f31 3833 3935 0a4e 6f64 653a 2055 7369  .18395.Node: Usi
│ │ │ │ │ +00016e20: 6e67 206c 6962 666b 6f7f 3139 3239 360a  ng libfko.19296.
│ │ │ │ │ +00016e30: 4e6f 6465 3a20 4372 6561 7469 6e67 2043  Node: Creating C
│ │ │ │ │ +00016e40: 6f6e 7465 7874 737f 3230 3133 350a 4e6f  ontexts.20135.No
│ │ │ │ │ +00016e50: 6465 3a20 4465 7374 726f 7969 6e67 2043  de: Destroying C
│ │ │ │ │ +00016e60: 6f6e 7465 7874 737f 3235 3132 320a 4e6f  ontexts.25122.No
│ │ │ │ │ +00016e70: 6465 3a20 4372 6561 7469 6e67 2061 2053  de: Creating a S
│ │ │ │ │ +00016e80: 5041 204d 6573 7361 6765 7f32 3537 3433  PA Message.25743
│ │ │ │ │ +00016e90: 0a4e 6f64 653a 2053 6574 7469 6e67 2053  .Node: Setting S
│ │ │ │ │ +00016ea0: 5041 2044 6174 617f 3330 3537 370a 4e6f  PA Data.30577.No
│ │ │ │ │ +00016eb0: 6465 3a20 5265 7472 6965 7669 6e67 2053  de: Retrieving S
│ │ │ │ │ +00016ec0: 5041 2044 6174 617f 3338 3133 380a 4e6f  PA Data.38138.No
│ │ │ │ │ +00016ed0: 6465 3a20 5574 696c 6974 7920 4675 6e63  de: Utility Func
│ │ │ │ │ +00016ee0: 7469 6f6e 737f 3437 3132 310a 4e6f 6465  tions.47121.Node
│ │ │ │ │ +00016ef0: 3a20 4572 726f 7220 4861 6e64 6c69 6e67  : Error Handling
│ │ │ │ │ +00016f00: 7f35 3035 3032 0a4e 6f64 653a 204c 6962  .50502.Node: Lib
│ │ │ │ │ +00016f10: 7261 7279 2043 6f70 7969 6e67 7f36 3538  rary Copying.658
│ │ │ │ │ +00016f20: 3438 0a4e 6f64 653a 2043 6f6e 6365 7074  48.Node: Concept
│ │ │ │ │ +00016f30: 2049 6e64 6578 7f38 3531 3430 0a4e 6f64   Index.85140.Nod
│ │ │ │ │ +00016f40: 653a 2046 756e 6374 696f 6e20 616e 6420  e: Function and 
│ │ │ │ │ +00016f50: 4461 7461 2049 6e64 6578 7f38 3833 3837  Data Index.88387
│ │ │ │ │ +00016f60: 0a1f 0a45 6e64 2054 6167 2054 6162 6c65  ...End Tag Table
│ │ │ │ │ +00016f70: 0a0a 1f0a 4c6f 6361 6c20 5661 7269 6162  ....Local Variab
│ │ │ │ │ +00016f80: 6c65 733a 0a63 6f64 696e 673a 2075 7466  les:.coding: utf
│ │ │ │ │ +00016f90: 2d38 0a45 6e64 3a0a                      -8.End:.