--- /srv/reproducible-results/rbuild-debian/r-b-build.JqbNhicv/b1/fwknop_2.6.10-16_i386.changes
+++ /srv/reproducible-results/rbuild-debian/r-b-build.JqbNhicv/b2/fwknop_2.6.10-16_i386.changes
├── Files
│ @@ -1,12 +1,12 @@
│  
│   8ed6a3bb75179a6688e7936b452d7b26 23260 admin optional fwknop-apparmor-profile_2.6.10-16_all.deb
│   06b7e2cfa2f94b3f8ff1fd5e587aa25f 75320 debug optional fwknop-client-dbgsym_2.6.10-16_i386.deb
│   3b4cf461431826e73068af4d0a367ffe 73248 admin optional fwknop-client_2.6.10-16_i386.deb
│   9031c660260d3b0f2d13c8e708bb6f36 116160 debug optional fwknop-server-dbgsym_2.6.10-16_i386.deb
│   7182e7b901055b121bfb9de5778f67f4 106828 admin optional fwknop-server_2.6.10-16_i386.deb
│ - 1a2bb128899bac60239c379399609839 49412 doc optional libfko-doc_2.6.10-16_all.deb
│ + 13e42f7ae17f81ec9029cf0644e15913 49400 doc optional libfko-doc_2.6.10-16_all.deb
│   c0b0faa5c3437cbab60ef84ed37acf56 59300 debug optional libfko-perl-dbgsym_2.6.10-16_i386.deb
│   e79a11b1a245cad0f360af8ff7f717e0 49808 perl optional libfko-perl_2.6.10-16_i386.deb
│   10fba27bd4e250da202dcd1f89c0f982 94160 debug optional libfko3-dbgsym_2.6.10-16_i386.deb
│ - 9764921f3ac17e696da6cefc1dd79617 97572 libdevel optional libfko3-dev_2.6.10-16_i386.deb
│ + 87630f472831448e1bb467df73ff4ab1 97580 libdevel optional libfko3-dev_2.6.10-16_i386.deb
│   3abcee37d6199b50e58c0d68f2c0d4ed 64424 libs optional libfko3_2.6.10-16_i386.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     1744 2023-04-11 03:52:01.000000 control.tar.xz
│ │ --rw-r--r--   0        0        0    47476 2023-04-11 03:52:01.000000 data.tar.xz
│ │ +-rw-r--r--   0        0        0     1740 2023-04-11 03:52:01.000000 control.tar.xz
│ │ +-rw-r--r--   0        0        0    47468 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)     4546 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)    14795 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)     8990 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)     8947 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)     4102 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)     4653 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Digests.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     4849 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Encryption-Algorithms.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    24840 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Error-Handling.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     4377 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Features.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    20451 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Function-and-Data-Index.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     3593 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Getting-Started.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     4550 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/HMAC-Digests.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     5235 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Introduction.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    22664 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Library-Copying.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     4204 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Overview.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     3570 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Preparation.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    20031 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Retrieving-SPA-Data.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     6886 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/SPA-Data-Format.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     6031 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/SPA-Messages.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     3484 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/SPA-Parameter-Types.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    17274 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Setting-SPA-Data.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     4016 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Using-libfko.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     9250 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/Utility-Functions.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     7166 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/index.html
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     3818 2023-04-11 03:52:01.000000 ./usr/share/doc/libfko-doc/libfko.html/libfko-Header.html
│ │ │ │ +-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
│ │ │ │  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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ │ +2.6.10, last updated 18 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 20 February 2025).
│ │ │ │ +(version 2.6.10, last updated 18 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_i386.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     1140 2023-04-11 03:52:01.000000 control.tar.xz
│ │ --rw-r--r--   0        0        0    96240 2023-04-11 03:52:01.000000 data.tar.xz
│ │ +-rw-r--r--   0        0        0    96248 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)    23954 2023-04-11 03:52:01.000000 ./usr/share/info/libfko.info.gz
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    23961 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/i386-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 2032 3020 4665 6272 7561  pdated 20 Februa
│ │ │ │ │ -000000b0: 7279 2032 3032 3529 2e0a 0a20 2020 436f  ry 2025)...   Co
│ │ │ │ │ -000000c0: 7079 7269 6768 7420 2843 2920 3230 3039  pyright (C) 2009
│ │ │ │ │ -000000d0: 2d32 3031 3320 4461 6d69 656e 2053 7475  -2013 Damien Stu
│ │ │ │ │ -000000e0: 6172 742e 0a0a 2020 2020 2054 6865 206c  art...     The l
│ │ │ │ │ -000000f0: 6962 666b 6f20 6d61 6e75 616c 2069 7320  ibfko manual is 
│ │ │ │ │ -00000100: 6672 6565 3b20 796f 7520 6361 6e20 7265  free; you can re
│ │ │ │ │ -00000110: 6469 7374 7269 6275 7465 2069 7420 616e  distribute it an
│ │ │ │ │ -00000120: 642f 6f72 206d 6f64 6966 7920 6974 0a20  d/or modify it. 
│ │ │ │ │ -00000130: 2020 2020 756e 6465 7220 7468 6520 7465      under the te
│ │ │ │ │ -00000140: 726d 7320 6f66 2074 6865 2047 4e55 2047  rms of the GNU G
│ │ │ │ │ -00000150: 656e 6572 616c 2050 7562 6c69 6320 4c69  eneral Public Li
│ │ │ │ │ -00000160: 6365 6e73 6520 6173 2070 7562 6c69 7368  cense as publish
│ │ │ │ │ -00000170: 6564 2062 790a 2020 2020 2074 6865 2046  ed by.     the F
│ │ │ │ │ -00000180: 7265 6520 536f 6674 7761 7265 2046 6f75  ree Software Fou
│ │ │ │ │ -00000190: 6e64 6174 696f 6e3b 2065 6974 6865 7220  ndation; either 
│ │ │ │ │ -000001a0: 7665 7273 696f 6e20 3220 6f66 2074 6865  version 2 of the
│ │ │ │ │ -000001b0: 204c 6963 656e 7365 2c20 6f72 0a20 2020   License, or.   
│ │ │ │ │ -000001c0: 2020 2861 7420 796f 7572 206f 7074 696f    (at your optio
│ │ │ │ │ -000001d0: 6e29 2061 6e79 206c 6174 6572 2076 6572  n) any later ver
│ │ │ │ │ -000001e0: 7369 6f6e 2e0a 0a20 2020 2020 5468 6520  sion...     The 
│ │ │ │ │ -000001f0: 6c69 6266 6b6f 206d 616e 7561 6c20 6973  libfko manual is
│ │ │ │ │ -00000200: 2064 6973 7472 6962 7574 6564 2069 6e20   distributed in 
│ │ │ │ │ -00000210: 7468 6520 686f 7065 2074 6861 7420 6974  the hope that it
│ │ │ │ │ -00000220: 2077 696c 6c20 6265 0a20 2020 2020 7573   will be.     us
│ │ │ │ │ -00000230: 6566 756c 2c20 6275 7420 5749 5448 4f55  eful, but WITHOU
│ │ │ │ │ -00000240: 5420 414e 5920 5741 5252 414e 5459 3b20  T ANY WARRANTY; 
│ │ │ │ │ -00000250: 7769 7468 6f75 7420 6576 656e 2074 6865  without even the
│ │ │ │ │ -00000260: 2069 6d70 6c69 6564 2077 6172 7261 6e74   implied warrant
│ │ │ │ │ -00000270: 790a 2020 2020 206f 6620 4d45 5243 4841  y.     of MERCHA
│ │ │ │ │ -00000280: 4e54 4142 494c 4954 5920 6f72 2046 4954  NTABILITY or FIT
│ │ │ │ │ -00000290: 4e45 5353 2046 4f52 2041 2050 4152 5449  NESS FOR A PARTI
│ │ │ │ │ -000002a0: 4355 4c41 5220 5055 5250 4f53 452e 2053  CULAR PURPOSE. S
│ │ │ │ │ -000002b0: 6565 2074 6865 2047 4e55 0a20 2020 2020  ee the GNU.     
│ │ │ │ │ -000002c0: 4765 6e65 7261 6c20 5075 626c 6963 204c  General Public L
│ │ │ │ │ -000002d0: 6963 656e 7365 2066 6f72 206d 6f72 6520  icense for more 
│ │ │ │ │ -000002e0: 6465 7461 696c 732e 0a0a 2020 2020 2059  details...     Y
│ │ │ │ │ -000002f0: 6f75 2073 686f 756c 6420 6861 7665 2072  ou should have r
│ │ │ │ │ -00000300: 6563 6569 7665 6420 6120 636f 7079 206f  eceived a copy o
│ │ │ │ │ -00000310: 6620 7468 6520 474e 5520 4765 6e65 7261  f the GNU Genera
│ │ │ │ │ -00000320: 6c20 5075 626c 6963 204c 6963 656e 7365  l Public License
│ │ │ │ │ -00000330: 0a20 2020 2020 616c 6f6e 6720 7769 7468  .     along with
│ │ │ │ │ -00000340: 2074 6869 7320 6d61 6e75 616c 3b20 6966   this manual; if
│ │ │ │ │ -00000350: 206e 6f74 2c20 7772 6974 6520 746f 2074   not, write to t
│ │ │ │ │ -00000360: 6865 2046 7265 6520 536f 6674 7761 7265  he Free Software
│ │ │ │ │ -00000370: 0a20 2020 2020 466f 756e 6461 7469 6f6e  .     Foundation
│ │ │ │ │ -00000380: 2c20 496e 632e 2c20 3531 2046 7261 6e6b  , Inc., 51 Frank
│ │ │ │ │ -00000390: 6c69 6e20 5374 7265 6574 2c20 4669 6674  lin Street, Fift
│ │ │ │ │ -000003a0: 6820 466c 6f6f 722c 2042 6f73 746f 6e2c  h Floor, Boston,
│ │ │ │ │ -000003b0: 204d 410a 2020 2020 2030 3231 3130 2d31   MA.     02110-1
│ │ │ │ │ -000003c0: 3330 3120 5553 410a 494e 464f 2d44 4952  301 USA.INFO-DIR
│ │ │ │ │ -000003d0: 2d53 4543 5449 4f4e 204e 6574 776f 726b  -SECTION Network
│ │ │ │ │ -000003e0: 2053 6563 7572 6974 790a 5354 4152 542d   Security.START-
│ │ │ │ │ -000003f0: 494e 464f 2d44 4952 2d45 4e54 5259 0a2a  INFO-DIR-ENTRY.*
│ │ │ │ │ -00000400: 206c 6962 666b 6f3a 2028 6c69 6266 6b6f   libfko: (libfko
│ │ │ │ │ -00000410: 292e 2020 2020 5468 6520 4669 7265 5761  ).    The FireWa
│ │ │ │ │ -00000420: 6c6c 204b 4e6f 636b 204f 5065 7261 746f  ll KNock OPerato
│ │ │ │ │ -00000430: 7220 2866 776b 6e6f 7029 204c 6962 7261  r (fwknop) Libra
│ │ │ │ │ -00000440: 7279 202d 206c 6962 666b 6f0a 454e 442d  ry - libfko.END-
│ │ │ │ │ -00000450: 494e 464f 2d44 4952 2d45 4e54 5259 0a0a  INFO-DIR-ENTRY..
│ │ │ │ │ -00000460: 1f0a 4669 6c65 3a20 6c69 6266 6b6f 2e69  ..File: libfko.i
│ │ │ │ │ -00000470: 6e66 6f2c 2020 4e6f 6465 3a20 546f 702c  nfo,  Node: Top,
│ │ │ │ │ -00000480: 2020 4e65 7874 3a20 496e 7472 6f64 7563    Next: Introduc
│ │ │ │ │ -00000490: 7469 6f6e 2c20 2055 703a 2028 6469 7229  tion,  Up: (dir)
│ │ │ │ │ -000004a0: 0a0a 4d61 696e 204d 656e 750a 2a2a 2a2a  ..Main Menu.****
│ │ │ │ │ -000004b0: 2a2a 2a2a 2a0a 0a54 6869 7320 6d61 6e75  *****..This manu
│ │ │ │ │ -000004c0: 616c 2069 7320 666f 7220 7468 6520 4669  al is for the Fi
│ │ │ │ │ -000004d0: 7265 7761 6c6c 204b 6e6f 636b 204f 7065  rewall Knock Ope
│ │ │ │ │ -000004e0: 7261 746f 7220 6c69 6272 6172 792c 206c  rator library, l
│ │ │ │ │ -000004f0: 6962 666b 6f2e 0a28 7665 7273 696f 6e20  ibfko..(version 
│ │ │ │ │ -00000500: 322e 362e 3130 2c20 6c61 7374 2075 7064  2.6.10, last upd
│ │ │ │ │ -00000510: 6174 6564 2032 3020 4665 6272 7561 7279  ated 20 February
│ │ │ │ │ -00000520: 2032 3032 3529 2e0a 0a20 2020 436f 7079   2025)...   Copy
│ │ │ │ │ -00000530: 7269 6768 7420 2843 2920 3230 3039 2d32  right (C) 2009-2
│ │ │ │ │ -00000540: 3031 3320 4461 6d69 656e 2053 7475 6172  013 Damien Stuar
│ │ │ │ │ -00000550: 742e 0a0a 2020 2020 2054 6865 206c 6962  t...     The lib
│ │ │ │ │ -00000560: 666b 6f20 6d61 6e75 616c 2069 7320 6672  fko manual is fr
│ │ │ │ │ -00000570: 6565 3b20 796f 7520 6361 6e20 7265 6469  ee; you can redi
│ │ │ │ │ -00000580: 7374 7269 6275 7465 2069 7420 616e 642f  stribute it and/
│ │ │ │ │ -00000590: 6f72 206d 6f64 6966 7920 6974 0a20 2020  or modify it.   
│ │ │ │ │ -000005a0: 2020 756e 6465 7220 7468 6520 7465 726d    under the term
│ │ │ │ │ -000005b0: 7320 6f66 2074 6865 2047 4e55 2047 656e  s of the GNU Gen
│ │ │ │ │ -000005c0: 6572 616c 2050 7562 6c69 6320 4c69 6365  eral Public Lice
│ │ │ │ │ -000005d0: 6e73 6520 6173 2070 7562 6c69 7368 6564  nse as published
│ │ │ │ │ -000005e0: 2062 790a 2020 2020 2074 6865 2046 7265   by.     the Fre
│ │ │ │ │ -000005f0: 6520 536f 6674 7761 7265 2046 6f75 6e64  e Software Found
│ │ │ │ │ -00000600: 6174 696f 6e3b 2065 6974 6865 7220 7665  ation; either ve
│ │ │ │ │ -00000610: 7273 696f 6e20 3220 6f66 2074 6865 204c  rsion 2 of the L
│ │ │ │ │ -00000620: 6963 656e 7365 2c20 6f72 0a20 2020 2020  icense, or.     
│ │ │ │ │ -00000630: 2861 7420 796f 7572 206f 7074 696f 6e29  (at your option)
│ │ │ │ │ -00000640: 2061 6e79 206c 6174 6572 2076 6572 7369   any later versi
│ │ │ │ │ -00000650: 6f6e 2e0a 0a20 2020 2020 5468 6520 6c69  on...     The li
│ │ │ │ │ -00000660: 6266 6b6f 206d 616e 7561 6c20 6973 2064  bfko manual is d
│ │ │ │ │ -00000670: 6973 7472 6962 7574 6564 2069 6e20 7468  istributed in th
│ │ │ │ │ -00000680: 6520 686f 7065 2074 6861 7420 6974 2077  e hope that it w
│ │ │ │ │ -00000690: 696c 6c20 6265 0a20 2020 2020 7573 6566  ill be.     usef
│ │ │ │ │ -000006a0: 756c 2c20 6275 7420 5749 5448 4f55 5420  ul, but WITHOUT 
│ │ │ │ │ -000006b0: 414e 5920 5741 5252 414e 5459 3b20 7769  ANY WARRANTY; wi
│ │ │ │ │ -000006c0: 7468 6f75 7420 6576 656e 2074 6865 2069  thout even the i
│ │ │ │ │ -000006d0: 6d70 6c69 6564 2077 6172 7261 6e74 790a  mplied warranty.
│ │ │ │ │ -000006e0: 2020 2020 206f 6620 4d45 5243 4841 4e54       of MERCHANT
│ │ │ │ │ -000006f0: 4142 494c 4954 5920 6f72 2046 4954 4e45  ABILITY or FITNE
│ │ │ │ │ -00000700: 5353 2046 4f52 2041 2050 4152 5449 4355  SS FOR A PARTICU
│ │ │ │ │ -00000710: 4c41 5220 5055 5250 4f53 452e 2053 6565  LAR PURPOSE. See
│ │ │ │ │ -00000720: 2074 6865 2047 4e55 0a20 2020 2020 4765   the GNU.     Ge
│ │ │ │ │ -00000730: 6e65 7261 6c20 5075 626c 6963 204c 6963  neral Public Lic
│ │ │ │ │ -00000740: 656e 7365 2066 6f72 206d 6f72 6520 6465  ense for more de
│ │ │ │ │ -00000750: 7461 696c 732e 0a0a 2020 2020 2059 6f75  tails...     You
│ │ │ │ │ -00000760: 2073 686f 756c 6420 6861 7665 2072 6563   should have rec
│ │ │ │ │ -00000770: 6569 7665 6420 6120 636f 7079 206f 6620  eived a copy of 
│ │ │ │ │ -00000780: 7468 6520 474e 5520 4765 6e65 7261 6c20  the GNU General 
│ │ │ │ │ -00000790: 5075 626c 6963 204c 6963 656e 7365 0a20  Public License. 
│ │ │ │ │ -000007a0: 2020 2020 616c 6f6e 6720 7769 7468 2074      along with t
│ │ │ │ │ -000007b0: 6869 7320 6d61 6e75 616c 3b20 6966 206e  his manual; if n
│ │ │ │ │ -000007c0: 6f74 2c20 7772 6974 6520 746f 2074 6865  ot, write to the
│ │ │ │ │ -000007d0: 2046 7265 6520 536f 6674 7761 7265 0a20   Free Software. 
│ │ │ │ │ -000007e0: 2020 2020 466f 756e 6461 7469 6f6e 2c20      Foundation, 
│ │ │ │ │ -000007f0: 496e 632e 2c20 3531 2046 7261 6e6b 6c69  Inc., 51 Frankli
│ │ │ │ │ -00000800: 6e20 5374 7265 6574 2c20 4669 6674 6820  n Street, Fifth 
│ │ │ │ │ -00000810: 466c 6f6f 722c 2042 6f73 746f 6e2c 204d  Floor, Boston, M
│ │ │ │ │ -00000820: 410a 2020 2020 2030 3231 3130 2d31 3330  A.     02110-130
│ │ │ │ │ -00000830: 3120 5553 410a 0a2a 204d 656e 753a 0a0a  1 USA..* Menu:..
│ │ │ │ │ -00000840: 2a20 496e 7472 6f64 7563 7469 6f6e 3a3a  * Introduction::
│ │ │ │ │ +000000a0: 7064 6174 6564 2031 3820 4a61 6e75 6172  pdated 18 Januar
│ │ │ │ │ +000000b0: 7920 3230 3234 292e 0a0a 2020 2043 6f70  y 2024)...   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 3138 204a 616e 7561 7279 2032  ted 18 January 2
│ │ │ │ │ +00000520: 3032 3429 2e0a 0a20 2020 436f 7079 7269  024)...   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: 2020 486f 7720 746f 2075 7365 2074 6869    How to use thi
│ │ │ │ │ -00000870: 7320 6d61 6e75 616c 0a2a 2050 7265 7061  s manual.* Prepa
│ │ │ │ │ -00000880: 7261 7469 6f6e 3a3a 2020 2020 2020 2020  ration::        
│ │ │ │ │ -00000890: 2020 2020 2020 2020 2020 2057 6861 7420             What 
│ │ │ │ │ -000008a0: 796f 7520 7368 6f75 6c64 2064 6f20 6265  you should do be
│ │ │ │ │ -000008b0: 666f 7265 2075 7369 6e67 2074 6865 206c  fore using the l
│ │ │ │ │ -000008c0: 6962 7261 7279 0a2a 2055 7369 6e67 206c  ibrary.* Using l
│ │ │ │ │ -000008d0: 6962 666b 6f3a 3a20 2020 2020 2020 2020  ibfko::         
│ │ │ │ │ -000008e0: 2020 2020 2020 2020 2048 6f77 2074 6f20           How to 
│ │ │ │ │ -000008f0: 7573 6520 6c69 6266 6b6f 2069 6e20 796f  use libfko in yo
│ │ │ │ │ -00000900: 7572 2070 726f 6772 616d 0a0a 4170 7065  ur program..Appe
│ │ │ │ │ -00000910: 6e64 6963 6573 0a0a 2a20 4c69 6272 6172  ndices..* Librar
│ │ │ │ │ -00000920: 7920 436f 7079 696e 673a 3a20 2020 2020  y Copying::     
│ │ │ │ │ -00000930: 2020 2020 2020 2020 2020 5468 6520 474e            The GN
│ │ │ │ │ -00000940: 5520 4765 6e65 7261 6c20 5075 626c 6963  U General Public
│ │ │ │ │ -00000950: 204c 6963 656e 7365 2073 6179 730a 2020   License says.  
│ │ │ │ │ +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.    
│ │ │ │ │  00000960: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000970: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000980: 686f 7720 796f 7520 6361 6e20 636f 7079  how you can copy
│ │ │ │ │ -00000990: 2061 6e64 2073 6861 7265 0a49 6e64 6963   and share.Indic
│ │ │ │ │ -000009a0: 6573 0a0a 2a20 436f 6e63 6570 7420 496e  es..* Concept In
│ │ │ │ │ -000009b0: 6465 783a 3a20 2020 2020 2020 2020 2020  dex::           
│ │ │ │ │ -000009c0: 2020 2020 2020 496e 6465 7820 6f66 2063        Index of c
│ │ │ │ │ -000009d0: 6f6e 6365 7074 7320 616e 6420 7072 6f67  oncepts and prog
│ │ │ │ │ -000009e0: 7261 6d73 0a2a 2046 756e 6374 696f 6e20  rams.* Function 
│ │ │ │ │ -000009f0: 616e 6420 4461 7461 2049 6e64 6578 3a3a  and Data Index::
│ │ │ │ │ -00000a00: 2020 2020 2020 2049 6e64 6578 206f 6620         Index of 
│ │ │ │ │ -00000a10: 6675 6e63 7469 6f6e 732c 2076 6172 6961  functions, varia
│ │ │ │ │ -00000a20: 626c 6573 2061 6e64 2064 6174 6120 7479  bles and data ty
│ │ │ │ │ -00000a30: 7065 730a 0a20 2d2d 2054 6865 2044 6574  pes.. -- The Det
│ │ │ │ │ -00000a40: 6169 6c65 6420 4e6f 6465 204c 6973 7469  ailed Node Listi
│ │ │ │ │ -00000a50: 6e67 202d 2d0a 0a49 6e74 726f 6475 6374  ng --..Introduct
│ │ │ │ │ -00000a60: 696f 6e0a 0a2a 2047 6574 7469 6e67 2053  ion..* Getting S
│ │ │ │ │ -00000a70: 7461 7274 6564 3a3a 2020 2020 2020 2020  tarted::        
│ │ │ │ │ -00000a80: 2020 2020 2020 2050 7572 706f 7365 206f         Purpose o
│ │ │ │ │ -00000a90: 6620 7468 6520 6d61 6e75 616c 2c20 616e  f the manual, an
│ │ │ │ │ -00000aa0: 6420 686f 7720 746f 2075 7365 2069 740a  d how to use it.
│ │ │ │ │ -00000ab0: 2a20 4665 6174 7572 6573 3a3a 2020 2020  * Features::    
│ │ │ │ │ +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: 2020 5265 6173 6f6e 7320 746f 2069 6e73    Reasons to ins
│ │ │ │ │ -00000ae0: 7461 6c6c 2061 6e64 2075 7365 206c 6962  tall and use lib
│ │ │ │ │ -00000af0: 666b 6f0a 2a20 4f76 6572 7669 6577 3a3a  fko.* Overview::
│ │ │ │ │ +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::  
│ │ │ │ │  00000b00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000b10: 2020 2020 2020 4261 7369 6320 6f76 6572        Basic over
│ │ │ │ │ -00000b20: 7669 6577 206f 6620 5350 4120 616e 640a  view of SPA and.
│ │ │ │ │ +00000b10: 2020 2020 4261 7369 6320 6f76 6572 7669      Basic overvi
│ │ │ │ │ +00000b20: 6577 206f 6620 5350 4120 616e 640a 2020  ew of SPA and.  
│ │ │ │ │  00000b30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  00000b40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000b50: 2020 6172 6368 6974 6563 7475 7265 206f    architecture o
│ │ │ │ │ -00000b60: 6620 7468 6520 6c69 6266 6b6f 206c 6962  f the libfko lib
│ │ │ │ │ -00000b70: 7261 7279 0a0a 4f76 6572 7669 6577 0a0a  rary..Overview..
│ │ │ │ │ -00000b80: 2a20 5350 4120 4461 7461 2046 6f72 6d61  * SPA Data Forma
│ │ │ │ │ -00000b90: 743a 3a20 2020 2020 2020 2020 2020 2020  t::             
│ │ │ │ │ -00000ba0: 2020 4465 7363 7269 7074 696f 6e20 6f66    Description of
│ │ │ │ │ -00000bb0: 2074 6865 2053 5041 2064 6174 610a 2020   the SPA data.  
│ │ │ │ │ +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.    
│ │ │ │ │  00000bc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000bd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000be0: 666f 726d 6174 2e0a 0a50 7265 7061 7261  format...Prepara
│ │ │ │ │ -00000bf0: 7469 6f6e 0a0a 2a20 6c69 6266 6b6f 2048  tion..* libfko H
│ │ │ │ │ -00000c00: 6561 6465 723a 3a20 2020 2020 2020 2020  eader::         
│ │ │ │ │ -00000c10: 2020 2020 2020 2020 5768 6174 2068 6561          What hea
│ │ │ │ │ -00000c20: 6465 7220 6669 6c65 2079 6f75 206e 6565  der file you nee
│ │ │ │ │ -00000c30: 6420 746f 2069 6e63 6c75 6465 0a2a 2043  d to include.* C
│ │ │ │ │ -00000c40: 6f6d 7069 6c69 6e67 2077 6974 6820 6c69  ompiling with li
│ │ │ │ │ -00000c50: 6266 6b6f 3a3a 2020 2020 2020 2020 2057  bfko::         W
│ │ │ │ │ -00000c60: 6861 7420 796f 7520 6e65 6564 2074 6f20  hat you need to 
│ │ │ │ │ -00000c70: 636f 6d70 696c 6520 616e 6420 6c69 6e6b  compile and link
│ │ │ │ │ -00000c80: 2079 6f75 720a 2020 2020 2020 2020 2020   your.          
│ │ │ │ │ +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.            
│ │ │ │ │  00000c90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000ca0: 2020 2020 2020 2020 7072 6f67 7261 6d20          program 
│ │ │ │ │ -00000cb0: 7769 7468 206c 6962 666b 6f0a 2a20 5350  with libfko.* SP
│ │ │ │ │ -00000cc0: 4120 5061 7261 6d65 7465 7220 5479 7065  A Parameter Type
│ │ │ │ │ -00000cd0: 733a 3a20 2020 2020 2020 2020 2020 5468  s::           Th
│ │ │ │ │ -00000ce0: 6520 6176 6169 6c61 626c 6520 6469 6765  e available dige
│ │ │ │ │ -00000cf0: 7374 732c 206d 6573 7361 6765 2074 7970  sts, message typ
│ │ │ │ │ -00000d00: 6573 2061 6e64 0a20 2020 2020 2020 2020  es and.         
│ │ │ │ │ +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.           
│ │ │ │ │  00000d10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000d20: 2020 2020 2020 2020 206d 6f64 6573 206f           modes o
│ │ │ │ │ -00000d30: 6620 656e 6372 7970 7469 6f6e 2066 6f72  f encryption for
│ │ │ │ │ -00000d40: 2053 5041 2064 6174 610a 5573 696e 6720   SPA data.Using 
│ │ │ │ │ -00000d50: 6c69 6266 6b6f 0a0a 2a20 4372 6561 7469  libfko..* Creati
│ │ │ │ │ -00000d60: 6e67 2043 6f6e 7465 7874 733a 3a20 2020  ng Contexts::   
│ │ │ │ │ -00000d70: 2020 2020 2020 2020 2020 4372 6561 7469            Creati
│ │ │ │ │ -00000d80: 6e67 2061 206e 6577 2066 6b6f 2063 6f6e  ng a new fko con
│ │ │ │ │ -00000d90: 7465 7874 0a2a 2044 6573 7472 6f79 696e  text.* Destroyin
│ │ │ │ │ -00000da0: 6720 436f 6e74 6578 7473 3a3a 2020 2020  g Contexts::    
│ │ │ │ │ -00000db0: 2020 2020 2020 2052 656c 6561 7369 6e67         Releasing
│ │ │ │ │ -00000dc0: 2061 6e20 666b 6f20 636f 6e74 6578 740a   an fko context.
│ │ │ │ │ -00000dd0: 2a20 4372 6561 7469 6e67 2061 2053 5041  * Creating a SPA
│ │ │ │ │ -00000de0: 204d 6573 7361 6765 3a3a 2020 2020 2020   Message::      
│ │ │ │ │ -00000df0: 2020 5768 6174 2069 7420 7461 6b65 7320    What it takes 
│ │ │ │ │ -00000e00: 746f 2063 7265 6174 6520 6120 5350 410a  to create a SPA.
│ │ │ │ │ +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.  
│ │ │ │ │  00000e10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │  00000e20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000e30: 2020 6d65 7373 6167 650a 2a20 5365 7474    message.* Sett
│ │ │ │ │ -00000e40: 696e 6720 5350 4120 4461 7461 3a3a 2020  ing SPA Data::  
│ │ │ │ │ -00000e50: 2020 2020 2020 2020 2020 2020 5365 7474              Sett
│ │ │ │ │ -00000e60: 696e 6720 5350 4120 6461 7461 0a2a 2052  ing SPA data.* R
│ │ │ │ │ -00000e70: 6574 7269 6576 696e 6720 5350 4120 4461  etrieving SPA Da
│ │ │ │ │ -00000e80: 7461 3a3a 2020 2020 2020 2020 2020 2052  ta::           R
│ │ │ │ │ -00000e90: 6574 7269 6576 696e 6720 5350 4120 6461  etrieving SPA da
│ │ │ │ │ -00000ea0: 7461 0a2a 2055 7469 6c69 7479 2046 756e  ta.* Utility Fun
│ │ │ │ │ -00000eb0: 6374 696f 6e73 3a3a 2020 2020 2020 2020  ctions::        
│ │ │ │ │ -00000ec0: 2020 2020 204f 7468 6572 2075 7469 6c69       Other utili
│ │ │ │ │ -00000ed0: 7479 2c20 6d69 7363 656c 6c61 6e65 6f75  ty, miscellaneou
│ │ │ │ │ -00000ee0: 732c 2061 6e64 2073 656c 646f 6d0a 2020  s, and seldom.  
│ │ │ │ │ +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.    
│ │ │ │ │  00000ef0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000f00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00000f10: 7573 6564 2066 756e 6374 696f 6e73 0a2a  used functions.*
│ │ │ │ │ -00000f20: 2045 7272 6f72 2048 616e 646c 696e 673a   Error Handling:
│ │ │ │ │ -00000f30: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ │ -00000f40: 2050 6f73 7369 626c 6520 6572 726f 7273   Possible errors
│ │ │ │ │ -00000f50: 2061 6e64 2074 6865 6972 206d 6561 6e69   and their meani
│ │ │ │ │ -00000f60: 6e67 0a0a 5350 4120 5061 7261 6d65 7465  ng..SPA Paramete
│ │ │ │ │ -00000f70: 7220 5479 7065 730a 0a2a 2044 6967 6573  r Types..* Diges
│ │ │ │ │ -00000f80: 7473 3a3a 2020 2020 2020 2020 2020 2020  ts::            
│ │ │ │ │ -00000f90: 2020 2020 2020 2020 2020 2054 6865 206d             The m
│ │ │ │ │ -00000fa0: 6573 7361 6765 2064 6967 6573 7420 6861  essage digest ha
│ │ │ │ │ -00000fb0: 7368 6573 2073 7570 706f 7274 6564 2062  shes supported b
│ │ │ │ │ -00000fc0: 7920 6c69 6266 6b6f 0a2a 2053 5041 204d  y libfko.* SPA M
│ │ │ │ │ -00000fd0: 6573 7361 6765 733a 3a20 2020 2020 2020  essages::       
│ │ │ │ │ -00000fe0: 2020 2020 2020 2020 2020 2054 6865 2066             The f
│ │ │ │ │ -00000ff0: 6b6f 2053 5041 206d 6573 7361 6765 2074  ko SPA message t
│ │ │ │ │ -00001000: 7970 6573 0a20 2020 2020 2020 2020 2020  ypes.           
│ │ │ │ │ +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.             
│ │ │ │ │  00001010: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00001020: 2020 2020 2020 2073 7570 706f 7274 6564         supported
│ │ │ │ │ -00001030: 2062 7920 6c69 6266 6b6f 2028 616e 6420   by libfko (and 
│ │ │ │ │ -00001040: 6677 6b6e 6f70 290a 2a20 456e 6372 7970  fwknop).* Encryp
│ │ │ │ │ -00001050: 7469 6f6e 2041 6c67 6f72 6974 686d 733a  tion Algorithms:
│ │ │ │ │ -00001060: 3a20 2020 2020 2020 2020 456e 6372 7970  :         Encryp
│ │ │ │ │ -00001070: 7469 6f6e 2073 6368 656d 6573 2073 7570  tion schemes sup
│ │ │ │ │ -00001080: 706f 7274 6564 2062 7920 6c69 6266 6b6f  ported by libfko
│ │ │ │ │ -00001090: 0a2a 2048 4d41 4320 4469 6765 7374 733a  .* HMAC Digests:
│ │ │ │ │ -000010a0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ │ -000010b0: 2020 2044 6967 6573 7473 2074 6861 7420     Digests that 
│ │ │ │ │ -000010c0: 6361 6e20 6265 2075 7365 6420 746f 2062  can be used to b
│ │ │ │ │ -000010d0: 7569 6c64 2061 6e20 484d 4143 0a0a 0a1f  uild an HMAC....
│ │ │ │ │ -000010e0: 0a46 696c 653a 206c 6962 666b 6f2e 696e  .File: libfko.in
│ │ │ │ │ -000010f0: 666f 2c20 204e 6f64 653a 2049 6e74 726f  fo,  Node: Intro
│ │ │ │ │ -00001100: 6475 6374 696f 6e2c 2020 4e65 7874 3a20  duction,  Next: 
│ │ │ │ │ -00001110: 5072 6570 6172 6174 696f 6e2c 2020 5072  Preparation,  Pr
│ │ │ │ │ -00001120: 6576 3a20 546f 702c 2020 5570 3a20 546f  ev: Top,  Up: To
│ │ │ │ │ -00001130: 700a 0a31 2049 6e74 726f 6475 6374 696f  p..1 Introductio
│ │ │ │ │ -00001140: 6e0a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  n.**************
│ │ │ │ │ -00001150: 0a0a 5468 6520 2246 6972 6577 616c 6c20  ..The "Firewall 
│ │ │ │ │ -00001160: 4b6e 6f63 6b20 4f70 6572 6174 6f72 204c  Knock Operator L
│ │ │ │ │ -00001170: 6962 7261 7279 2220 286c 6962 666b 6f29  ibrary" (libfko)
│ │ │ │ │ -00001180: 2069 7320 6120 4320 6c61 6e67 7561 6765   is a C language
│ │ │ │ │ -00001190: 206c 6962 7261 7279 0a74 6861 7420 696d   library.that im
│ │ │ │ │ -000011a0: 706c 656d 656e 7473 2074 6865 2066 756e  plements the fun
│ │ │ │ │ -000011b0: 6374 696f 6e73 206e 6565 6465 6420 746f  ctions needed to
│ │ │ │ │ -000011c0: 2063 7265 6174 6520 616e 642f 6f72 2070   create and/or p
│ │ │ │ │ -000011d0: 6172 7365 2022 5369 6e67 6c65 0a50 6163  arse "Single.Pac
│ │ │ │ │ -000011e0: 6b65 7420 4175 7468 6f72 697a 6174 696f  ket Authorizatio
│ │ │ │ │ -000011f0: 6e22 2028 5350 4129 2064 6174 612e 2020  n" (SPA) data.  
│ │ │ │ │ -00001200: 4974 2069 7320 6465 7369 676e 6564 2074  It is designed t
│ │ │ │ │ -00001210: 6f20 6162 7374 7261 6374 2074 6865 0a64  o abstract the.d
│ │ │ │ │ -00001220: 6574 6169 6c73 206f 6620 656e 636f 6469  etails of encodi
│ │ │ │ │ -00001230: 6e67 2c20 656e 6372 7970 7469 6f6e 2c20  ng, encryption, 
│ │ │ │ │ -00001240: 6465 636f 6469 6e67 2c20 7061 7273 696e  decoding, parsin
│ │ │ │ │ -00001250: 672c 2061 6e64 2076 6572 6966 7969 6e67  g, and verifying
│ │ │ │ │ -00001260: 2053 5041 0a6d 6573 7361 6765 7320 7375   SPA.messages su
│ │ │ │ │ -00001270: 6368 2061 7320 7468 6f73 6520 7573 6564  ch as those used
│ │ │ │ │ -00001280: 2062 7920 4d69 6368 6165 6c20 5261 7368   by Michael Rash
│ │ │ │ │ -00001290: 2773 2022 4669 7265 7761 6c6c 204b 6e6f  's "Firewall Kno
│ │ │ │ │ -000012a0: 636b 204f 7065 7261 746f 7222 0a28 6677  ck Operator".(fw
│ │ │ │ │ -000012b0: 6b6e 6f70 292e 0a0a 2020 2022 6677 6b6e  knop)...   "fwkn
│ │ │ │ │ -000012c0: 6f70 2220 696d 706c 656d 656e 7473 2061  op" implements a
│ │ │ │ │ -000012d0: 6e20 6175 7468 6f72 697a 6174 696f 6e20  n authorization 
│ │ │ │ │ -000012e0: 7363 6865 6d65 206b 6e6f 776e 2061 7320  scheme known as 
│ │ │ │ │ -000012f0: 5369 6e67 6c65 2050 6163 6b65 740a 4175  Single Packet.Au
│ │ │ │ │ -00001300: 7468 6f72 697a 6174 696f 6e20 2853 5041  thorization (SPA
│ │ │ │ │ -00001310: 2920 666f 7220 7374 726f 6e67 2073 6572  ) for strong ser
│ │ │ │ │ -00001320: 7669 6365 2070 726f 7465 6374 696f 6e2e  vice protection.
│ │ │ │ │ -00001330: 2020 5350 4120 7265 7175 6972 6573 206f    SPA requires o
│ │ │ │ │ -00001340: 6e6c 7920 610a 7369 6e67 6c65 2070 6163  nly a.single pac
│ │ │ │ │ -00001350: 6b65 7420 7768 6963 6820 6973 2065 6e63  ket which is enc
│ │ │ │ │ -00001360: 7279 7074 6564 2c20 6e6f 6e2d 7265 706c  rypted, non-repl
│ │ │ │ │ -00001370: 6179 6162 6c65 2c20 616e 6420 6175 7468  ayable, and auth
│ │ │ │ │ -00001380: 656e 7469 6361 7465 6420 7669 610a 616e  enticated via.an
│ │ │ │ │ -00001390: 2048 4d41 4320 696e 206f 7264 6572 2074   HMAC in order t
│ │ │ │ │ -000013a0: 6f20 636f 6d6d 756e 6963 6174 6520 6465  o communicate de
│ │ │ │ │ -000013b0: 7369 7265 6420 6163 6365 7373 2074 6f20  sired access to 
│ │ │ │ │ -000013c0: 6120 7365 7276 6963 6520 7468 6174 2069  a service that i
│ │ │ │ │ -000013d0: 730a 6869 6464 656e 2062 6568 696e 6420  s.hidden behind 
│ │ │ │ │ -000013e0: 6120 6669 7265 7761 6c6c 2069 6e20 6120  a firewall in a 
│ │ │ │ │ -000013f0: 6465 6661 756c 742d 6472 6f70 2066 696c  default-drop fil
│ │ │ │ │ -00001400: 7465 7269 6e67 2073 7461 6e63 652e 2020  tering stance.  
│ │ │ │ │ -00001410: 5468 6520 6d61 696e 0a61 7070 6c69 6361  The main.applica
│ │ │ │ │ -00001420: 7469 6f6e 206f 6620 5350 4120 6973 2074  tion of SPA is t
│ │ │ │ │ -00001430: 6f20 7573 6520 6120 6669 7265 7761 6c6c  o use a firewall
│ │ │ │ │ -00001440: 2074 6f20 6472 6f70 2061 6c6c 2061 7474   to drop all att
│ │ │ │ │ -00001450: 656d 7074 7320 746f 2063 6f6e 6e65 6374  empts to connect
│ │ │ │ │ -00001460: 0a74 6f20 7365 7276 6963 6573 2073 7563  .to services suc
│ │ │ │ │ -00001470: 6820 6173 2027 5353 4827 2069 6e20 6f72  h as 'SSH' in or
│ │ │ │ │ -00001480: 6465 7220 746f 206d 616b 6520 7468 6520  der to make the 
│ │ │ │ │ -00001490: 6578 706c 6f69 7461 7469 6f6e 206f 660a  exploitation of.
│ │ │ │ │ -000014a0: 7675 6c6e 6572 6162 696c 6974 6965 7320  vulnerabilities 
│ │ │ │ │ -000014b0: 2862 6f74 6820 302d 6461 7920 616e 6420  (both 0-day and 
│ │ │ │ │ -000014c0: 756e 7061 7463 6865 6420 636f 6465 2920  unpatched code) 
│ │ │ │ │ -000014d0: 6d6f 7265 2064 6966 6669 6375 6c74 2e20  more difficult. 
│ │ │ │ │ -000014e0: 2041 6e79 0a73 6572 7669 6365 2074 6861   Any.service tha
│ │ │ │ │ -000014f0: 7420 6973 2070 726f 7465 6374 6564 2062  t is protected b
│ │ │ │ │ -00001500: 7920 5350 4120 6e61 7475 7261 6c6c 7920  y SPA naturally 
│ │ │ │ │ -00001510: 6361 6e6e 6f74 2062 6520 7363 616e 6e65  cannot be scanne
│ │ │ │ │ -00001520: 6420 666f 7220 7769 7468 0a27 4e6d 6170  d for with.'Nmap
│ │ │ │ │ -00001530: 272e 2020 5468 6520 6677 6b6e 6f70 2070  '.  The fwknop p
│ │ │ │ │ -00001540: 726f 6a65 6374 2073 7570 706f 7274 7320  roject supports 
│ │ │ │ │ -00001550: 7468 7265 6520 6469 6666 6572 656e 7420  three different 
│ │ │ │ │ -00001560: 6669 7265 7761 6c6c 733a 0a27 6970 7461  firewalls:.'ipta
│ │ │ │ │ -00001570: 626c 6573 2720 6f6e 204c 696e 7578 2073  bles' on Linux s
│ │ │ │ │ -00001580: 7973 7465 6d73 2c20 2770 6627 206f 6e20  ystems, 'pf' on 
│ │ │ │ │ -00001590: 4f70 656e 4253 442c 2061 6e64 2027 6970  OpenBSD, and 'ip
│ │ │ │ │ -000015a0: 6677 2720 6f6e 2046 7265 6542 5344 2061  fw' on FreeBSD a
│ │ │ │ │ -000015b0: 6e64 0a4d 6163 204f 5320 582e 0a0a 2020  nd.Mac OS X...  
│ │ │ │ │ -000015c0: 206c 6962 666b 6f20 6973 206e 6f74 2061   libfko is not a
│ │ │ │ │ -000015d0: 6e20 696d 706c 656d 656e 7461 7469 6f6e  n implementation
│ │ │ │ │ -000015e0: 206f 6620 616e 2066 776b 6e6f 7020 636c   of an fwknop cl
│ │ │ │ │ -000015f0: 6965 6e74 206f 7220 7365 7276 6572 2e20  ient or server. 
│ │ │ │ │ -00001600: 2049 740a 7369 6d70 6c79 2070 726f 7669   It.simply provi
│ │ │ │ │ -00001610: 6465 7320 7468 6520 6675 6e63 7469 6f6e  des the function
│ │ │ │ │ -00001620: 7320 666f 7220 6d61 6e61 6769 6e67 2074  s for managing t
│ │ │ │ │ -00001630: 6865 2053 5041 2064 6174 6120 7573 6564  he SPA data used
│ │ │ │ │ -00001640: 2062 7920 7468 6f73 650a 7072 6f67 7261   by those.progra
│ │ │ │ │ -00001650: 6d73 2e0a 0a0a 466f 7220 6d6f 7265 2069  ms....For more i
│ │ │ │ │ -00001660: 6e66 6f72 6d61 7469 6f6e 206f 6e20 6677  nformation on fw
│ │ │ │ │ -00001670: 6b6e 6f70 2061 6e64 2053 5041 2c20 676f  knop and SPA, go
│ │ │ │ │ -00001680: 2074 6f0a 3c68 7474 703a 2f2f 7777 772e   to.<http://www.
│ │ │ │ │ -00001690: 6369 7068 6572 6479 6e65 2e6f 7267 2f66  cipherdyne.org/f
│ │ │ │ │ -000016a0: 776b 6e6f 703e 2e0a 0a2a 204d 656e 753a  wknop>...* Menu:
│ │ │ │ │ -000016b0: 0a0a 2a20 4765 7474 696e 6720 5374 6172  ..* Getting Star
│ │ │ │ │ -000016c0: 7465 643a 3a20 2020 2020 2020 2020 2020  ted::           
│ │ │ │ │ -000016d0: 2020 2020 5075 7270 6f73 6520 6f66 2074      Purpose of t
│ │ │ │ │ -000016e0: 6865 206d 616e 7561 6c2c 2061 6e64 2068  he manual, and h
│ │ │ │ │ -000016f0: 6f77 2074 6f20 7573 6520 6974 0a2a 2046  ow to use it.* F
│ │ │ │ │ -00001700: 6561 7475 7265 733a 3a20 2020 2020 2020  eatures::       
│ │ │ │ │ -00001710: 2020 2020 2020 2020 2020 2020 2020 2052                 R
│ │ │ │ │ -00001720: 6561 736f 6e73 2074 6f20 696e 7374 616c  easons to instal
│ │ │ │ │ -00001730: 6c20 616e 6420 7573 6520 6c69 6266 6b6f  l and use libfko
│ │ │ │ │ -00001740: 0a2a 204f 7665 7276 6965 773a 3a20 2020  .* Overview::   
│ │ │ │ │ +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: 2020 2042 6173 6963 2061 7263 6869 7465     Basic archite
│ │ │ │ │ -00001770: 6374 7572 6520 6f66 2074 6865 206c 6962  cture of the lib
│ │ │ │ │ -00001780: 666b 6f20 6c69 6272 6172 790a 0a1f 0a46  fko library....F
│ │ │ │ │ -00001790: 696c 653a 206c 6962 666b 6f2e 696e 666f  ile: libfko.info
│ │ │ │ │ -000017a0: 2c20 204e 6f64 653a 2047 6574 7469 6e67  ,  Node: Getting
│ │ │ │ │ -000017b0: 2053 7461 7274 6564 2c20 204e 6578 743a   Started,  Next:
│ │ │ │ │ -000017c0: 2046 6561 7475 7265 732c 2020 5570 3a20   Features,  Up: 
│ │ │ │ │ -000017d0: 496e 7472 6f64 7563 7469 6f6e 0a0a 312e  Introduction..1.
│ │ │ │ │ -000017e0: 3120 4765 7474 696e 6720 5374 6172 7465  1 Getting Starte
│ │ │ │ │ -000017f0: 640a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  d.==============
│ │ │ │ │ -00001800: 3d3d 3d3d 3d0a 0a54 6869 7320 6d61 6e75  =====..This manu
│ │ │ │ │ -00001810: 616c 2064 6f63 756d 656e 7473 2074 6865  al documents the
│ │ │ │ │ -00001820: 2022 4669 7265 7761 6c6c 204b 6e6f 636b   "Firewall Knock
│ │ │ │ │ -00001830: 204f 7065 7261 746f 7222 206c 6962 7261   Operator" libra
│ │ │ │ │ -00001840: 7279 2070 726f 6772 616d 6d69 6e67 0a69  ry programming.i
│ │ │ │ │ -00001850: 6e74 6572 6661 6365 2e20 2041 6c6c 2066  nterface.  All f
│ │ │ │ │ -00001860: 756e 6374 696f 6e73 2061 6e64 2064 6174  unctions and dat
│ │ │ │ │ -00001870: 6120 7479 7065 7320 7072 6f76 6964 6564  a types provided
│ │ │ │ │ -00001880: 2062 7920 7468 6520 6c69 6272 6172 7920   by the library 
│ │ │ │ │ -00001890: 6172 650a 6578 706c 6169 6e65 642e 0a0a  are.explained...
│ │ │ │ │ -000018a0: 2020 2054 6869 7320 6d61 6e75 616c 2063     This manual c
│ │ │ │ │ -000018b0: 616e 2062 6520 7573 6564 2069 6e20 6120  an be used in a 
│ │ │ │ │ -000018c0: 636f 7570 6c65 206f 6620 7761 7973 2e20  couple of ways. 
│ │ │ │ │ -000018d0: 2049 6620 7265 6164 2066 726f 6d20 7468   If read from th
│ │ │ │ │ -000018e0: 650a 6265 6769 6e6e 696e 6720 746f 2074  e.beginning to t
│ │ │ │ │ -000018f0: 6865 2065 6e64 2c20 6974 2073 686f 756c  he end, it shoul
│ │ │ │ │ -00001900: 6420 6769 7665 2061 2067 6f6f 6420 696e  d give a good in
│ │ │ │ │ -00001910: 7472 6f64 7563 7469 6f6e 2069 6e74 6f20  troduction into 
│ │ │ │ │ -00001920: 7468 650a 6c69 6272 6172 7920 616e 6420  the.library and 
│ │ │ │ │ -00001930: 686f 7720 6974 2063 616e 2062 6520 7573  how it can be us
│ │ │ │ │ -00001940: 6564 2069 6e20 616e 2061 7070 6c69 6361  ed in an applica
│ │ │ │ │ -00001950: 7469 6f6e 2e20 204c 6174 6572 206f 6e2c  tion.  Later on,
│ │ │ │ │ -00001960: 2074 6865 206d 616e 7561 6c0a 6361 6e20   the manual.can 
│ │ │ │ │ -00001970: 6265 2075 7365 6420 6173 2061 2072 6566  be used as a ref
│ │ │ │ │ -00001980: 6572 656e 6365 206d 616e 7561 6c20 746f  erence manual to
│ │ │ │ │ -00001990: 2067 6574 206a 7573 7420 7468 6520 696e   get just the in
│ │ │ │ │ -000019a0: 666f 726d 6174 696f 6e20 6e65 6564 6564  formation needed
│ │ │ │ │ -000019b0: 0a61 626f 7574 2061 6e79 2070 6172 7469  .about any parti
│ │ │ │ │ -000019c0: 6375 6c61 7220 696e 7465 7266 6163 6520  cular interface 
│ │ │ │ │ -000019d0: 6f66 2074 6865 206c 6962 7261 7279 2e0a  of the library..
│ │ │ │ │ -000019e0: 0a1f 0a46 696c 653a 206c 6962 666b 6f2e  ...File: libfko.
│ │ │ │ │ -000019f0: 696e 666f 2c20 204e 6f64 653a 2046 6561  info,  Node: Fea
│ │ │ │ │ -00001a00: 7475 7265 732c 2020 4e65 7874 3a20 4f76  tures,  Next: Ov
│ │ │ │ │ -00001a10: 6572 7669 6577 2c20 2050 7265 763a 2047  erview,  Prev: G
│ │ │ │ │ -00001a20: 6574 7469 6e67 2053 7461 7274 6564 2c20  etting Started, 
│ │ │ │ │ -00001a30: 2055 703a 2049 6e74 726f 6475 6374 696f   Up: Introductio
│ │ │ │ │ -00001a40: 6e0a 0a31 2e32 2046 6561 7475 7265 730a  n..1.2 Features.
│ │ │ │ │ -00001a50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468  ============..Th
│ │ │ │ │ -00001a60: 6520 7072 696d 6172 7920 6164 7661 6e74  e primary advant
│ │ │ │ │ -00001a70: 6167 6520 6f66 2075 7369 6e67 206c 6962  age of using lib
│ │ │ │ │ -00001a80: 666b 6f20 6973 2069 7420 7072 6f76 6964  fko is it provid
│ │ │ │ │ -00001a90: 6573 2061 2073 696e 676c 6520 4150 4920  es a single API 
│ │ │ │ │ -00001aa0: 666f 720a 6569 7468 6572 2063 7265 6174  for.either creat
│ │ │ │ │ -00001ab0: 696e 6720 6f72 2070 6172 7369 6e67 2053  ing or parsing S
│ │ │ │ │ -00001ac0: 5041 2064 6174 612e 2020 4164 6469 7469  PA data.  Additi
│ │ │ │ │ -00001ad0: 6f6e 616c 2061 6476 616e 7461 6765 7320  onal advantages 
│ │ │ │ │ -00001ae0: 696e 636c 7564 653a 0a0a 4974 2773 2066  include:..It's f
│ │ │ │ │ -00001af0: 7265 6520 736f 6674 7761 7265 0a20 2020  ree software.   
│ │ │ │ │ -00001b00: 2020 416e 7962 6f64 7920 6361 6e20 7573    Anybody can us
│ │ │ │ │ -00001b10: 652c 206d 6f64 6966 792c 2061 6e64 2072  e, modify, and r
│ │ │ │ │ -00001b20: 6564 6973 7472 6962 7574 6520 6974 2075  edistribute it u
│ │ │ │ │ -00001b30: 6e64 6572 2074 6865 2074 6572 6d73 206f  nder the terms o
│ │ │ │ │ -00001b40: 6620 7468 650a 2020 2020 2047 4e55 2047  f the.     GNU G
│ │ │ │ │ -00001b50: 656e 6572 616c 2050 7562 6c69 6320 4c69  eneral Public Li
│ │ │ │ │ -00001b60: 6365 6e73 6520 7632 206f 7220 616e 7920  cense v2 or any 
│ │ │ │ │ -00001b70: 6c61 7465 7220 7665 7273 696f 6e20 282a  later version (*
│ │ │ │ │ -00001b80: 6e6f 7465 204c 6962 7261 7279 0a20 2020  note Library.   
│ │ │ │ │ -00001b90: 2020 436f 7079 696e 673a 3a29 2e0a 0a49    Copying::)...I
│ │ │ │ │ -00001ba0: 7427 7320 6c69 6768 7477 6569 6768 740a  t's lightweight.
│ │ │ │ │ -00001bb0: 2020 2020 2054 6865 2050 6572 6c2d 6261       The Perl-ba
│ │ │ │ │ -00001bc0: 7365 6420 696d 706c 656d 656e 7461 7469  sed implementati
│ │ │ │ │ -00001bd0: 6f6e 2072 6571 7569 7265 7320 7365 7665  on requires seve
│ │ │ │ │ -00001be0: 7261 6c20 6164 6469 7469 6f6e 616c 2050  ral additional P
│ │ │ │ │ -00001bf0: 6572 6c0a 2020 2020 206d 6f64 756c 6573  erl.     modules
│ │ │ │ │ -00001c00: 2061 6e64 2068 6173 2061 2072 656c 6174   and has a relat
│ │ │ │ │ -00001c10: 6976 656c 7920 6c61 7267 6520 666f 6f74  ively large foot
│ │ │ │ │ -00001c20: 7072 696e 7420 696e 206d 656d 6f72 792e  print in memory.
│ │ │ │ │ -00001c30: 2020 5468 6973 0a20 2020 2020 432d 6261    This.     C-ba
│ │ │ │ │ -00001c40: 7365 6420 6c69 6272 6172 7920 656c 696d  sed library elim
│ │ │ │ │ -00001c50: 696e 6174 6573 2074 686f 7365 2064 6570  inates those dep
│ │ │ │ │ -00001c60: 656e 6465 6e63 6965 7320 616e 6420 6861  endencies and ha
│ │ │ │ │ -00001c70: 7320 6120 6d75 6368 0a20 2020 2020 736d  s a much.     sm
│ │ │ │ │ -00001c80: 616c 6c65 7220 666f 6f74 7072 696e 742e  aller footprint.
│ │ │ │ │ -00001c90: 2020 5573 696e 6720 7468 6973 206c 6962    Using this lib
│ │ │ │ │ -00001ca0: 7261 7279 2061 6c6c 6f77 7320 5350 4120  rary allows SPA 
│ │ │ │ │ -00001cb0: 746f 2065 6173 696c 790a 2020 2020 2066  to easily.     f
│ │ │ │ │ -00001cc0: 756e 6374 696f 6e20 6f6e 2065 6d62 6564  unction on embed
│ │ │ │ │ -00001cd0: 6465 6420 6f70 6572 6174 696e 6720 7379  ded operating sy
│ │ │ │ │ -00001ce0: 7374 656d 7320 7375 6368 2061 7320 4f70  stems such as Op
│ │ │ │ │ -00001cf0: 656e 5752 542e 0a0a 4974 2773 2065 6173  enWRT...It's eas
│ │ │ │ │ -00001d00: 790a 2020 2020 206c 6962 666b 6f20 6869  y.     libfko hi
│ │ │ │ │ -00001d10: 6465 7320 6d61 6e79 206f 6620 7468 6520  des many of the 
│ │ │ │ │ -00001d20: 676f 7279 2064 6574 6169 6c73 206f 6620  gory details of 
│ │ │ │ │ -00001d30: 6677 6b6e 6f70 2773 2053 5041 206d 6573  fwknop's SPA mes
│ │ │ │ │ -00001d40: 7361 6765 2064 6174 610a 2020 2020 2066  sage data.     f
│ │ │ │ │ -00001d50: 6f72 6d61 742c 2065 6e63 6f64 696e 672c  ormat, encoding,
│ │ │ │ │ -00001d60: 2064 6563 6f64 696e 672c 2065 6e63 7279   decoding, encry
│ │ │ │ │ -00001d70: 7074 696e 672c 2064 6563 7279 7074 696e  pting, decryptin
│ │ │ │ │ -00001d80: 672c 2061 7574 6865 6e74 6963 6174 696e  g, authenticatin
│ │ │ │ │ -00001d90: 672c 0a20 2020 2020 616e 6420 7061 7273  g,.     and pars
│ │ │ │ │ -00001da0: 696e 672e 2020 496e 206d 6f73 7420 6361  ing.  In most ca
│ │ │ │ │ -00001db0: 7365 732c 206f 6e6c 7920 6120 6665 7720  ses, only a few 
│ │ │ │ │ -00001dc0: 6675 6e63 7469 6f6e 2063 616c 6c73 2077  function calls w
│ │ │ │ │ -00001dd0: 696c 6c20 6265 0a20 2020 2020 6e65 6564  ill be.     need
│ │ │ │ │ -00001de0: 6564 2063 7265 6174 6520 6f72 2070 6172  ed create or par
│ │ │ │ │ -00001df0: 7365 2061 2053 5041 206d 6573 7361 6765  se a SPA message
│ │ │ │ │ -00001e00: 2e0a 0a1f 0a46 696c 653a 206c 6962 666b  .....File: libfk
│ │ │ │ │ -00001e10: 6f2e 696e 666f 2c20 204e 6f64 653a 204f  o.info,  Node: O
│ │ │ │ │ -00001e20: 7665 7276 6965 772c 2020 5072 6576 3a20  verview,  Prev: 
│ │ │ │ │ -00001e30: 4665 6174 7572 6573 2c20 2055 703a 2049  Features,  Up: I
│ │ │ │ │ -00001e40: 6e74 726f 6475 6374 696f 6e0a 0a31 2e33  ntroduction..1.3
│ │ │ │ │ -00001e50: 204f 7665 7276 6965 770a 3d3d 3d3d 3d3d   Overview.======
│ │ │ │ │ -00001e60: 3d3d 3d3d 3d3d 0a0a 2a20 4d65 6e75 3a0a  ======..* Menu:.
│ │ │ │ │ -00001e70: 0a2a 2053 5041 2044 6174 6120 466f 726d  .* SPA Data Form
│ │ │ │ │ -00001e80: 6174 3a3a 2020 2020 2020 2020 2020 2020  at::            
│ │ │ │ │ -00001e90: 2020 2044 6573 6372 6970 7469 6f6e 206f     Description o
│ │ │ │ │ -00001ea0: 6620 7468 6520 5350 4120 6461 7461 0a20  f the SPA data. 
│ │ │ │ │ +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.
│ │ │ │ │ +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.   
│ │ │ │ │  00001eb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00001ec0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00001ed0: 2066 6f72 6d61 742e 0a0a 6c69 6266 6b6f   format...libfko
│ │ │ │ │ -00001ee0: 2066 756e 6374 696f 6e61 6c69 7479 2063   functionality c
│ │ │ │ │ -00001ef0: 616e 2062 6520 6469 7669 6465 6420 696e  an be divided in
│ │ │ │ │ -00001f00: 746f 2074 776f 2072 6f6c 6573 2e20 204f  to two roles.  O
│ │ │ │ │ -00001f10: 6e65 2069 7320 7468 6520 6372 6561 7469  ne is the creati
│ │ │ │ │ -00001f20: 6f6e 0a6f 6620 616e 2065 6e63 7279 7074  on.of an encrypt
│ │ │ │ │ -00001f30: 6564 2053 5041 206d 6573 7361 6765 2074  ed SPA message t
│ │ │ │ │ -00001f40: 6f67 6574 6865 7220 7769 7468 2061 6e20  ogether with an 
│ │ │ │ │ -00001f50: 484d 4143 2066 6f72 2061 7574 6865 6e74  HMAC for authent
│ │ │ │ │ -00001f60: 6963 6174 696f 6e2e 0a54 6865 206f 7468  ication..The oth
│ │ │ │ │ -00001f70: 6572 2069 7320 7468 6520 7461 6b69 6e67  er is the taking
│ │ │ │ │ -00001f80: 2061 6e20 656e 6372 7970 7465 6420 5350   an encrypted SP
│ │ │ │ │ -00001f90: 4120 6d65 7373 6167 6520 746f 2061 7574  A message to aut
│ │ │ │ │ -00001fa0: 6865 6e74 6963 6174 652c 0a64 6563 6f64  henticate,.decod
│ │ │ │ │ -00001fb0: 652c 2070 6172 7365 2c20 616e 6420 6578  e, parse, and ex
│ │ │ │ │ -00001fc0: 7472 6163 7420 7468 6520 6f72 6967 696e  tract the origin
│ │ │ │ │ -00001fd0: 616c 2064 6174 612e 0a0a 2020 2054 6865  al data...   The
│ │ │ │ │ -00001fe0: 2061 6374 7561 6c20 5350 4120 6461 7461   actual SPA data
│ │ │ │ │ -00001ff0: 2068 616e 646c 696e 6720 616e 6420 6f70   handling and op
│ │ │ │ │ -00002000: 6572 6174 696f 6e73 2061 7265 2073 6574  erations are set
│ │ │ │ │ -00002010: 2077 6974 6869 6e20 6120 636f 6e74 6578   within a contex
│ │ │ │ │ -00002020: 742e 0a54 6865 2063 6f6e 7465 7874 2072  t..The context r
│ │ │ │ │ -00002030: 6570 7265 7365 6e74 7320 6120 7369 6e67  epresents a sing
│ │ │ │ │ -00002040: 6c65 2053 5041 206d 6573 7361 6765 2061  le SPA message a
│ │ │ │ │ -00002050: 6e64 2070 726f 7669 6465 7320 636f 6e66  nd provides conf
│ │ │ │ │ -00002060: 6967 7572 6174 696f 6e0a 7061 7261 6d65  iguration.parame
│ │ │ │ │ -00002070: 7465 7273 2061 6e64 2064 6174 6120 7365  ters and data se
│ │ │ │ │ -00002080: 7474 696e 6773 2066 6f72 2064 6566 696e  ttings for defin
│ │ │ │ │ -00002090: 696e 6720 7468 6174 206d 6573 7361 6765  ing that message
│ │ │ │ │ -000020a0: 2e20 2041 6c6c 206f 7065 7261 7469 6f6e  .  All operation
│ │ │ │ │ -000020b0: 730a 6f6e 2074 6865 2064 6174 6120 6f63  s.on the data oc
│ │ │ │ │ -000020c0: 6375 7220 7769 7468 696e 2074 6861 7420  cur within that 
│ │ │ │ │ -000020d0: 636f 6e74 6578 742e 0a0a 2020 2053 6f6d  context...   Som
│ │ │ │ │ -000020e0: 6520 6f70 6572 6174 696f 6e73 206f 6e20  e operations on 
│ │ │ │ │ -000020f0: 7468 6520 636f 6e74 6578 7420 6d75 7374  the context must
│ │ │ │ │ -00002100: 206f 6363 7572 2062 6566 6f72 6520 6f74   occur before ot
│ │ │ │ │ -00002110: 6865 7273 2e20 2044 6574 6169 6c73 206f  hers.  Details o
│ │ │ │ │ -00002120: 660a 7468 6573 6520 6465 7065 6e64 656e  f.these dependen
│ │ │ │ │ -00002130: 6369 6573 2061 7265 2063 6f76 6572 6564  cies are covered
│ │ │ │ │ -00002140: 2069 6e20 2a6e 6f74 6520 4372 6561 7469   in *note Creati
│ │ │ │ │ -00002150: 6e67 2061 2053 5041 204d 6573 7361 6765  ng a SPA Message
│ │ │ │ │ -00002160: 3a3a 2e0a 0a57 6974 6820 6c69 6266 6b6f  ::...With libfko
│ │ │ │ │ -00002170: 2c20 776f 726b 696e 6720 7769 7468 2053  , working with S
│ │ │ │ │ -00002180: 5041 206d 6573 7361 6765 2064 6174 6120  PA message data 
│ │ │ │ │ -00002190: 6261 7369 6361 6c6c 7920 636f 6e73 6973  basically consis
│ │ │ │ │ -000021a0: 7473 206f 6620 7468 650a 666f 6c6c 6f77  ts of the.follow
│ │ │ │ │ -000021b0: 696e 6720 7374 6570 7320 696e 206f 7264  ing steps in ord
│ │ │ │ │ -000021c0: 6572 3a0a 0a20 2020 2a20 4372 6561 7465  er:..   * Create
│ │ │ │ │ -000021d0: 2061 206e 6577 2063 6f6e 7465 7874 0a20   a new context. 
│ │ │ │ │ -000021e0: 2020 2a20 576f 726b 2077 6974 6820 2867    * Work with (g
│ │ │ │ │ -000021f0: 6574 2f73 6574 2920 7468 6520 5350 4120  et/set) the SPA 
│ │ │ │ │ -00002200: 6461 7461 2066 6965 6c64 730a 2020 202a  data fields.   *
│ │ │ │ │ -00002210: 2044 6573 7472 6f79 2074 6865 2063 6f6e   Destroy the con
│ │ │ │ │ -00002220: 7465 7874 0a0a 1f0a 4669 6c65 3a20 6c69  text....File: li
│ │ │ │ │ -00002230: 6266 6b6f 2e69 6e66 6f2c 2020 4e6f 6465  bfko.info,  Node
│ │ │ │ │ -00002240: 3a20 5350 4120 4461 7461 2046 6f72 6d61  : SPA Data Forma
│ │ │ │ │ -00002250: 742c 2020 5570 3a20 4f76 6572 7669 6577  t,  Up: Overview
│ │ │ │ │ -00002260: 0a0a 312e 332e 3120 5350 4120 4461 7461  ..1.3.1 SPA Data
│ │ │ │ │ -00002270: 2046 6f72 6d61 740a 2d2d 2d2d 2d2d 2d2d   Format.--------
│ │ │ │ │ -00002280: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54  -------------..T
│ │ │ │ │ -00002290: 6865 2066 6f72 6d61 7420 6f66 2074 6865  he format of the
│ │ │ │ │ -000022a0: 2053 5041 206d 6573 7361 6765 2064 6174   SPA message dat
│ │ │ │ │ -000022b0: 6120 7573 6564 2062 7920 6677 6b6e 6f70  a used by fwknop
│ │ │ │ │ -000022c0: 2028 6265 666f 7265 2065 6e63 7279 7074   (before encrypt
│ │ │ │ │ -000022d0: 696f 6e20 616e 640a 6265 666f 7265 2061  ion and.before a
│ │ │ │ │ -000022e0: 6e20 484d 4143 2069 7320 6170 706c 6965  n HMAC is applie
│ │ │ │ │ -000022f0: 6429 2069 7320 6120 636f 6c6f 6e2d 6465  d) is a colon-de
│ │ │ │ │ -00002300: 6c69 6d69 7465 6420 7374 7269 6e67 2063  limited string c
│ │ │ │ │ -00002310: 6f6e 7461 696e 696e 6720 7468 650a 696e  ontaining the.in
│ │ │ │ │ -00002320: 6469 7669 6475 616c 2053 5041 2064 6174  dividual SPA dat
│ │ │ │ │ -00002330: 6120 6669 656c 6473 2e20 2053 6f6d 6520  a fields.  Some 
│ │ │ │ │ -00002340: 6f66 2074 6865 7365 2066 6965 6c64 7320  of these fields 
│ │ │ │ │ -00002350: 6172 6520 6261 7365 3634 2d65 6e63 6f64  are base64-encod
│ │ │ │ │ -00002360: 6564 2069 6e0a 7468 6520 6669 6e61 6c20  ed in.the final 
│ │ │ │ │ -00002370: 656e 636f 6469 6e67 2070 726f 6365 7373  encoding process
│ │ │ │ │ -00002380: 2061 7320 6469 6374 6174 6564 2062 7920   as dictated by 
│ │ │ │ │ -00002390: 7468 6520 6375 7272 656e 7420 6677 6b6e  the current fwkn
│ │ │ │ │ -000023a0: 6f70 0a69 6d70 6c65 6d65 6e74 6174 696f  op.implementatio
│ │ │ │ │ -000023b0: 6e2e 0a0a 202d 2d20 5661 7269 6162 6c65  n... -- Variable
│ │ │ │ │ -000023c0: 3a20 6461 7461 2073 7061 5f6d 6573 7361  : data spa_messa
│ │ │ │ │ -000023d0: 6765 5f66 6965 6c64 730a 2020 2020 2055  ge_fields.     U
│ │ │ │ │ -000023e0: 7369 6e67 2074 6865 206c 6962 666b 6f20  sing the libfko 
│ │ │ │ │ -000023f0: 6e61 6d65 7320 666f 7220 7468 6520 6461  names for the da
│ │ │ │ │ -00002400: 7461 2066 6965 6c64 732c 2074 6865 206c  ta fields, the l
│ │ │ │ │ -00002410: 6973 7420 6f66 2074 6865 7365 0a20 2020  ist of these.   
│ │ │ │ │ -00002420: 2020 6669 656c 6473 2028 696e 206f 7264    fields (in ord
│ │ │ │ │ -00002430: 6572 2920 666f 6c6c 6f77 733a 0a20 2020  er) follows:.   
│ │ │ │ │ -00002440: 2020 272a 7261 6e64 5f76 616c 7565 2a20    '*rand_value* 
│ │ │ │ │ -00002450: 2d20 5f44 6566 6175 6c74 3a20 5261 6e64  - _Default: Rand
│ │ │ │ │ -00002460: 6f6d 2028 6372 6561 7465 6420 7570 6f6e  om (created upon
│ │ │ │ │ -00002470: 2063 6f6e 7465 7874 2063 7265 6174 696f   context creatio
│ │ │ │ │ -00002480: 6e29 5f27 0a20 2020 2020 2020 2020 2041  n)_'.          A
│ │ │ │ │ -00002490: 2031 362d 6279 7465 2072 616e 646f 6d20   16-byte random 
│ │ │ │ │ -000024a0: 6e75 6d65 7269 6320 7374 7269 6e67 2e0a  numeric string..
│ │ │ │ │ -000024b0: 2020 2020 2027 2a75 7365 726e 616d 652a       '*username*
│ │ │ │ │ -000024c0: 202d 205f 4465 6661 756c 743a 2043 7572   - _Default: Cur
│ │ │ │ │ -000024d0: 7265 6e74 206c 6f67 696e 2075 7365 7220  rent login user 
│ │ │ │ │ -000024e0: 6f72 2056 616c 7565 206f 6620 5350 4f4f  or Value of SPOO
│ │ │ │ │ -000024f0: 465f 5553 4552 2065 6e76 2076 6172 5f27  F_USER env var_'
│ │ │ │ │ -00002500: 0a20 2020 2020 2020 2020 2054 6865 2062  .          The b
│ │ │ │ │ -00002510: 6173 6536 342d 656e 636f 6465 6420 7573  ase64-encoded us
│ │ │ │ │ -00002520: 6572 6e61 6d65 2061 7373 6f63 6961 7465  ername associate
│ │ │ │ │ -00002530: 6420 7769 7468 2074 6869 7320 5350 4120  d with this SPA 
│ │ │ │ │ -00002540: 6461 7461 2e0a 2020 2020 2027 2a74 696d  data..     '*tim
│ │ │ │ │ -00002550: 6573 7461 6d70 2a20 2d20 5f44 6566 6175  estamp* - _Defau
│ │ │ │ │ -00002560: 6c74 3a20 5468 6520 556e 6978 2074 696d  lt: The Unix tim
│ │ │ │ │ -00002570: 6520 6174 2063 7265 6174 696f 6e5f 270a  e at creation_'.
│ │ │ │ │ -00002580: 2020 2020 2020 2020 2020 5468 6520 556e            The Un
│ │ │ │ │ -00002590: 6978 2074 696d 6573 7461 6d70 2076 616c  ix timestamp val
│ │ │ │ │ -000025a0: 7565 2e0a 2020 2020 2027 2a76 6572 7369  ue..     '*versi
│ │ │ │ │ -000025b0: 6f6e 2a20 2d20 5f44 6566 6175 6c74 3a20  on* - _Default: 
│ │ │ │ │ -000025c0: 7468 6520 6375 7272 656e 7420 6677 6b6e  the current fwkn
│ │ │ │ │ -000025d0: 6f70 2076 6572 7369 6f6e 5f27 0a20 2020  op version_'.   
│ │ │ │ │ -000025e0: 2020 2020 2020 2054 6865 2063 7572 7265         The curre
│ │ │ │ │ -000025f0: 6e74 2066 776b 6e6f 7020 7665 7273 696f  nt fwknop versio
│ │ │ │ │ -00002600: 6e20 7468 6174 2073 7570 706f 7274 7320  n that supports 
│ │ │ │ │ -00002610: 7468 6973 2066 6f72 6d61 742e 2020 5468  this format.  Th
│ │ │ │ │ -00002620: 6973 0a20 2020 2020 2020 2020 2066 6965  is.          fie
│ │ │ │ │ -00002630: 6c64 2069 7320 6e6f 7420 7573 6572 2073  ld is not user s
│ │ │ │ │ -00002640: 6574 7461 626c 652e 0a20 2020 2020 272a  ettable..     '*
│ │ │ │ │ -00002650: 7370 615f 6d65 7373 6167 655f 7479 7065  spa_message_type
│ │ │ │ │ -00002660: 2a20 2d20 5f44 6566 6175 6c74 3a20 5350  * - _Default: SP
│ │ │ │ │ -00002670: 4120 6163 6365 7373 206d 6573 7361 6765  A access message
│ │ │ │ │ -00002680: 2028 464b 4f5f 4143 4345 5353 5f4d 5347   (FKO_ACCESS_MSG
│ │ │ │ │ -00002690: 295f 270a 2020 2020 2020 2020 2020 5468  )_'.          Th
│ │ │ │ │ -000026a0: 6520 5350 4120 6d65 7373 6167 6520 7479  e SPA message ty
│ │ │ │ │ -000026b0: 7065 2076 616c 7565 2066 6f72 2074 6869  pe value for thi
│ │ │ │ │ -000026c0: 7320 6d65 7373 6167 652e 0a20 2020 2020  s message..     
│ │ │ │ │ -000026d0: 272a 7370 615f 6d65 7373 6167 652a 270a  '*spa_message*'.
│ │ │ │ │ -000026e0: 2020 2020 2020 2020 2020 5468 6520 6261            The ba
│ │ │ │ │ -000026f0: 7365 3634 2d65 6e63 6f64 6564 2053 5041  se64-encoded SPA
│ │ │ │ │ -00002700: 206d 6573 7361 6765 2069 7473 656c 6620   message itself 
│ │ │ │ │ -00002710: 2861 6e20 6163 6365 7373 2072 6571 7565  (an access reque
│ │ │ │ │ -00002720: 7374 206f 720a 2020 2020 2020 2020 2020  st or.          
│ │ │ │ │ -00002730: 636f 6d6d 616e 6420 7374 7269 6e67 292e  command string).
│ │ │ │ │ -00002740: 0a20 2020 2020 272a 7370 615f 6e61 745f  .     '*spa_nat_
│ │ │ │ │ -00002750: 6163 6365 7373 2a27 0a20 2020 2020 2020  access*'.       
│ │ │ │ │ -00002760: 2020 2041 6e20 6f70 7469 6f6e 616c 2062     An optional b
│ │ │ │ │ -00002770: 6173 6536 342d 656e 636f 6465 6420 7265  ase64-encoded re
│ │ │ │ │ -00002780: 7175 6573 7420 666f 7220 4e41 5420 6163  quest for NAT ac
│ │ │ │ │ -00002790: 6365 7373 2e0a 2020 2020 2027 2a73 7061  cess..     '*spa
│ │ │ │ │ -000027a0: 5f73 6572 7665 725f 6175 7468 2a27 0a20  _server_auth*'. 
│ │ │ │ │ -000027b0: 2020 2020 2020 2020 2041 6e20 6f70 7469           An opti
│ │ │ │ │ -000027c0: 6f6e 616c 2062 6173 6536 342d 656e 636f  onal base64-enco
│ │ │ │ │ -000027d0: 6465 6420 7374 7269 6e67 2074 6861 7420  ded string that 
│ │ │ │ │ -000027e0: 6361 6e20 6265 2075 7365 6420 6173 2061  can be used as a
│ │ │ │ │ -000027f0: 6e0a 2020 2020 2020 2020 2020 6164 6469  n.          addi
│ │ │ │ │ -00002800: 7469 6f6e 616c 2061 7574 6865 6e74 6963  tional authentic
│ │ │ │ │ -00002810: 6174 696f 6e20 6d65 6368 616e 6973 6d20  ation mechanism 
│ │ │ │ │ -00002820: 6174 2074 6865 2066 776b 6e6f 7020 7365  at the fwknop se
│ │ │ │ │ -00002830: 7276 6572 2e0a 2020 2020 2027 2a73 7061  rver..     '*spa
│ │ │ │ │ -00002840: 5f63 6c69 656e 745f 7469 6d65 6f75 742a  _client_timeout*
│ │ │ │ │ -00002850: 270a 2020 2020 2020 2020 2020 416e 206f  '.          An o
│ │ │ │ │ -00002860: 7074 696f 6e61 6c20 636c 6965 6e74 2074  ptional client t
│ │ │ │ │ -00002870: 696d 656f 7574 2076 616c 7565 2074 6861  imeout value tha
│ │ │ │ │ -00002880: 7420 6361 6e20 6265 2073 7570 706c 6965  t can be supplie
│ │ │ │ │ -00002890: 6420 746f 2074 6865 0a20 2020 2020 2020  d to the.       
│ │ │ │ │ -000028a0: 2020 2066 776b 6e6f 7020 7365 7276 6572     fwknop server
│ │ │ │ │ -000028b0: 2e0a 2020 2020 2027 2a73 7061 5f64 6967  ..     '*spa_dig
│ │ │ │ │ -000028c0: 6573 742a 202d 205f 436f 6d70 7574 6564  est* - _Computed
│ │ │ │ │ -000028d0: 2076 616c 7565 5f27 0a20 2020 2020 2020   value_'.       
│ │ │ │ │ -000028e0: 2020 2054 6865 2064 6967 6573 7420 6f66     The digest of
│ │ │ │ │ -000028f0: 2074 6865 2070 7265 7669 6f75 7320 6669   the previous fi
│ │ │ │ │ -00002900: 656c 6473 2028 696e 636c 7564 696e 6720  elds (including 
│ │ │ │ │ -00002910: 7468 6520 6465 6c69 6d69 7465 7273 292e  the delimiters).
│ │ │ │ │ -00002920: 0a0a 2020 2057 6974 6820 616c 6c20 6669  ..   With all fi
│ │ │ │ │ -00002930: 656c 6473 2064 6566 696e 6564 2c20 6120  elds defined, a 
│ │ │ │ │ -00002940: 636f 6d70 6c65 7465 2028 756e 656e 636f  complete (unenco
│ │ │ │ │ -00002950: 6465 6429 2053 5041 206d 6573 7361 6765  ded) SPA message
│ │ │ │ │ -00002960: 2077 6f75 6c64 0a6c 6f6f 6b20 736f 6d65   would.look some
│ │ │ │ │ -00002970: 7468 696e 6720 6c69 6b65 2074 6865 2066  thing like the f
│ │ │ │ │ -00002980: 6f6c 6c6f 7769 6e67 2065 7861 6d70 6c65  ollowing example
│ │ │ │ │ -00002990: 2028 4e6f 7465 3a20 5468 6520 6c69 6e65   (Note: The line
│ │ │ │ │ -000029a0: 2069 7320 6272 6f6b 656e 2066 6f72 0a72   is broken for.r
│ │ │ │ │ -000029b0: 6561 6461 6269 6c69 7479 2061 6e64 2074  eadability and t
│ │ │ │ │ -000029c0: 6865 2075 7365 726e 616d 652c 206d 6573  he username, mes
│ │ │ │ │ -000029d0: 7361 6765 2c20 6e61 745f 6163 6365 7373  sage, nat_access
│ │ │ │ │ -000029e0: 2c20 616e 6420 7365 7276 6572 5f61 7574  , and server_aut
│ │ │ │ │ -000029f0: 680a 6669 656c 6473 2061 7265 206e 6f74  h.fields are not
│ │ │ │ │ -00002a00: 2062 6173 6536 342d 656e 636f 6465 6429   base64-encoded)
│ │ │ │ │ -00002a10: 3a0a 0a0a 2020 2020 2038 3330 3735 3430  :...     8307540
│ │ │ │ │ -00002a20: 3938 3231 3736 3533 393a 6a75 7365 723a  982176539:juser:
│ │ │ │ │ -00002a30: 3132 3330 3636 3531 3732 3a32 2e35 3a31  1230665172:2.5:1
│ │ │ │ │ -00002a40: 3a31 2e31 2e31 2e31 2c74 6370 2f32 323a  :1.1.1.1,tcp/22:
│ │ │ │ │ -00002a50: 3139 322e 3136 382e 312e 322c 3232 3a0a  192.168.1.2,22:.
│ │ │ │ │ -00002a60: 2020 2020 2063 7279 7074 2c6d 7970 773a       crypt,mypw:
│ │ │ │ │ -00002a70: 3132 303a 7873 776a 3856 307a 4d52 372f  120:xswj8V0zMR7/
│ │ │ │ │ -00002a80: 374d 5639 7051 5261 7253 4b57 4731 6c39  7MV9pQRarSKWG1l9
│ │ │ │ │ -00002a90: 5a66 6a76 2b6b 6258 614b 724a 2b52 410a  Zfjv+kbXaKrJ+RA.
│ │ │ │ │ -00002aa0: 0a20 2020 466f 7220 6d6f 7374 206f 6620  .   For most of 
│ │ │ │ │ -00002ab0: 7468 6520 6669 656c 6473 2c20 796f 7520  the fields, you 
│ │ │ │ │ -00002ac0: 6e65 6564 206e 6f74 2062 6520 746f 6f20  need not be too 
│ │ │ │ │ -00002ad0: 636f 6e63 6572 6e65 6420 6162 6f75 7420  concerned about 
│ │ │ │ │ -00002ae0: 7468 650a 666f 726d 6174 2061 7320 6c69  the.format as li
│ │ │ │ │ -00002af0: 6266 6b6f 2068 616e 646c 6573 2074 6861  bfko handles tha
│ │ │ │ │ -00002b00: 742e 2020 5468 6520 6578 6365 7074 696f  t.  The exceptio
│ │ │ │ │ -00002b10: 6e73 2061 7265 2074 6865 2027 7370 615f  ns are the 'spa_
│ │ │ │ │ -00002b20: 6d65 7373 6167 6527 2c0a 2773 7061 5f6e  message',.'spa_n
│ │ │ │ │ -00002b30: 6174 5f61 6363 6573 7327 2c20 616e 6420  at_access', and 
│ │ │ │ │ -00002b40: 2773 7061 5f73 6572 7665 725f 6175 7468  'spa_server_auth
│ │ │ │ │ -00002b50: 272e 2020 5468 6520 666f 726d 6174 7320  '.  The formats 
│ │ │ │ │ -00002b60: 666f 7220 7468 6573 6520 6172 6520 6e6f  for these are no
│ │ │ │ │ -00002b70: 740a 6861 6e64 6c65 6420 6279 206c 6962  t.handled by lib
│ │ │ │ │ -00002b80: 666b 6f20 6475 7269 6e67 2063 7265 6174  fko during creat
│ │ │ │ │ -00002b90: 696f 6e2e 2020 486f 7765 7665 722c 2074  ion.  However, t
│ │ │ │ │ -00002ba0: 6865 7920 6172 6520 6368 6563 6b65 6420  hey are checked 
│ │ │ │ │ -00002bb0: 666f 7220 666f 726d 6174 0a76 616c 6964  for format.valid
│ │ │ │ │ -00002bc0: 6974 7920 6475 7269 6e67 2074 6865 2065  ity during the e
│ │ │ │ │ -00002bd0: 6e64 636f 6469 6e67 2061 6e64 2064 6563  ndcoding and dec
│ │ │ │ │ -00002be0: 6f64 696e 6720 2877 6865 6e20 7061 7273  oding (when pars
│ │ │ │ │ -00002bf0: 696e 6720 696e 636f 6d69 6e67 2920 5350  ing incoming) SP
│ │ │ │ │ -00002c00: 410a 6461 7461 2e20 204d 6f72 6520 696e  A.data.  More in
│ │ │ │ │ -00002c10: 666f 726d 6174 696f 6e20 6f6e 2074 6865  formation on the
│ │ │ │ │ -00002c20: 2073 7065 6369 6669 6373 206f 6620 7468   specifics of th
│ │ │ │ │ -00002c30: 6520 666f 726d 6174 7320 666f 7220 7468  e formats for th
│ │ │ │ │ -00002c40: 6573 6520 6669 656c 6473 0a63 616e 2062  ese fields.can b
│ │ │ │ │ -00002c50: 6520 666f 756e 6420 696e 202a 6e6f 7465  e found in *note
│ │ │ │ │ -00002c60: 2053 5041 204d 6573 7361 6765 733a 3a2e   SPA Messages::.
│ │ │ │ │ -00002c70: 0a0a 1f0a 4669 6c65 3a20 6c69 6266 6b6f  ....File: libfko
│ │ │ │ │ -00002c80: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5072  .info,  Node: Pr
│ │ │ │ │ -00002c90: 6570 6172 6174 696f 6e2c 2020 4e65 7874  eparation,  Next
│ │ │ │ │ -00002ca0: 3a20 5573 696e 6720 6c69 6266 6b6f 2c20  : Using libfko, 
│ │ │ │ │ -00002cb0: 2050 7265 763a 2049 6e74 726f 6475 6374   Prev: Introduct
│ │ │ │ │ -00002cc0: 696f 6e2c 2020 5570 3a20 546f 700a 0a32  ion,  Up: Top..2
│ │ │ │ │ -00002cd0: 2050 7265 7061 7261 7469 6f6e 0a2a 2a2a   Preparation.***
│ │ │ │ │ -00002ce0: 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 5468 6973  **********..This
│ │ │ │ │ -00002cf0: 2063 6861 7074 6572 2070 726f 7669 6465   chapter provide
│ │ │ │ │ -00002d00: 7320 696e 666f 726d 6174 696f 6e20 6e65  s information ne
│ │ │ │ │ -00002d10: 6564 6564 2074 6f20 7072 6570 6172 6520  eded to prepare 
│ │ │ │ │ -00002d20: 666f 7220 7573 696e 6720 6c69 6266 6b6f  for using libfko
│ │ │ │ │ -00002d30: 2069 6e0a 796f 7572 2070 726f 6772 616d   in.your program
│ │ │ │ │ -00002d40: 732e 0a0a 2a20 4d65 6e75 3a0a 0a2a 206c  s...* Menu:..* l
│ │ │ │ │ -00002d50: 6962 666b 6f20 4865 6164 6572 3a3a 2020  ibfko Header::  
│ │ │ │ │ -00002d60: 2020 2020 2020 2020 2020 2020 2020 2057                 W
│ │ │ │ │ -00002d70: 6861 7420 6865 6164 6572 2066 696c 6520  hat header file 
│ │ │ │ │ -00002d80: 796f 7520 6e65 6564 2074 6f20 696e 636c  you need to incl
│ │ │ │ │ -00002d90: 7564 650a 2a20 436f 6d70 696c 696e 6720  ude.* Compiling 
│ │ │ │ │ -00002da0: 7769 7468 206c 6962 666b 6f3a 3a20 2020  with libfko::   
│ │ │ │ │ -00002db0: 2020 2020 2020 5768 6174 2079 6f75 206e        What you n
│ │ │ │ │ -00002dc0: 6565 6420 746f 2063 6f6d 7069 6c65 2061  eed to compile a
│ │ │ │ │ -00002dd0: 6e64 206c 696e 6b20 796f 7572 0a20 2020  nd link your.   
│ │ │ │ │ +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.     
│ │ │ │ │  00002de0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00002df0: 2020 2020 2020 2020 2020 2020 2020 2070                 p
│ │ │ │ │ -00002e00: 726f 6772 616d 2077 6974 6820 6c69 6266  rogram with libf
│ │ │ │ │ -00002e10: 6b6f 0a2a 2053 5041 2050 6172 616d 6574  ko.* SPA Paramet
│ │ │ │ │ -00002e20: 6572 2054 7970 6573 3a3a 2020 2020 2020  er Types::      
│ │ │ │ │ -00002e30: 2020 2020 2054 6865 2061 7661 696c 6162       The availab
│ │ │ │ │ -00002e40: 6c65 2064 6967 6573 7473 2c20 6d65 7373  le digests, mess
│ │ │ │ │ -00002e50: 6167 6520 7479 7065 7320 616e 640a 2020  age types and.  
│ │ │ │ │ +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.    
│ │ │ │ │  00002e60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00002e70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00002e80: 6d6f 6465 7320 6f66 2065 6e63 7279 7074  modes of encrypt
│ │ │ │ │ -00002e90: 696f 6e20 666f 7220 5350 4120 6461 7461  ion for SPA data
│ │ │ │ │ -00002ea0: 0a0a 1f0a 4669 6c65 3a20 6c69 6266 6b6f  ....File: libfko
│ │ │ │ │ -00002eb0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6c69  .info,  Node: li
│ │ │ │ │ -00002ec0: 6266 6b6f 2048 6561 6465 722c 2020 4e65  bfko Header,  Ne
│ │ │ │ │ -00002ed0: 7874 3a20 436f 6d70 696c 696e 6720 7769  xt: Compiling wi
│ │ │ │ │ -00002ee0: 7468 206c 6962 666b 6f2c 2020 5570 3a20  th libfko,  Up: 
│ │ │ │ │ -00002ef0: 5072 6570 6172 6174 696f 6e0a 0a32 2e31  Preparation..2.1
│ │ │ │ │ -00002f00: 206c 6962 666b 6f20 4865 6164 6572 0a3d   libfko Header.=
│ │ │ │ │ -00002f10: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ │ -00002f20: 0a0a 416c 6c20 696e 7465 7266 6163 6573  ..All interfaces
│ │ │ │ │ -00002f30: 2028 6461 7461 2074 7970 6573 2061 6e64   (data types and
│ │ │ │ │ -00002f40: 2066 756e 6374 696f 6e73 2920 6f66 2074   functions) of t
│ │ │ │ │ -00002f50: 6865 206c 6962 7261 7279 2061 7265 2064  he library are d
│ │ │ │ │ -00002f60: 6566 696e 6564 2069 6e0a 7468 6520 6865  efined in.the he
│ │ │ │ │ -00002f70: 6164 6572 2066 696c 6520 2766 6b6f 2e68  ader file 'fko.h
│ │ │ │ │ -00002f80: 272e 2020 596f 7520 6d75 7374 2069 6e63  '.  You must inc
│ │ │ │ │ -00002f90: 6c75 6465 2074 6869 7320 696e 2061 6c6c  lude this in all
│ │ │ │ │ -00002fa0: 2070 726f 6772 616d 7320 7573 696e 670a   programs using.
│ │ │ │ │ -00002fb0: 7468 6520 6c69 6272 6172 792c 2065 6974  the library, eit
│ │ │ │ │ -00002fc0: 6865 7220 6469 7265 6374 6c79 206f 7220  her directly or 
│ │ │ │ │ -00002fd0: 7468 726f 7567 6820 736f 6d65 206f 7468  through some oth
│ │ │ │ │ -00002fe0: 6572 2068 6561 6465 7220 6669 6c65 2c20  er header file, 
│ │ │ │ │ -00002ff0: 6c69 6b65 0a74 6869 733a 0a0a 2020 2020  like.this:..    
│ │ │ │ │ -00003000: 2023 696e 636c 7564 6520 3c66 6b6f 2e68   #include <fko.h
│ │ │ │ │ -00003010: 3e0a 0a20 2020 5468 6520 6e61 6d65 2073  >..   The name s
│ │ │ │ │ -00003020: 7061 6365 206f 6620 464b 4f20 6973 2027  pace of FKO is '
│ │ │ │ │ -00003030: 666b 6f5f 2a27 2066 6f72 2066 756e 6374  fko_*' for funct
│ │ │ │ │ -00003040: 696f 6e20 6e61 6d65 7320 616e 6420 6461  ion names and da
│ │ │ │ │ -00003050: 7461 2074 7970 6573 0a61 6e64 2027 464b  ta types.and 'FK
│ │ │ │ │ -00003060: 4f5f 2a27 2066 6f72 206f 7468 6572 2073  O_*' for other s
│ │ │ │ │ -00003070: 796d 626f 6c73 2e20 204f 7468 6572 2073  ymbols.  Other s
│ │ │ │ │ -00003080: 796d 626f 6c73 2069 6e74 6572 6e61 6c20  ymbols internal 
│ │ │ │ │ -00003090: 746f 2046 4b4f 206d 6179 2074 616b 650a  to FKO may take.
│ │ │ │ │ -000030a0: 7468 6520 666f 726d 2027 5f66 6b6f 5f2a  the form '_fko_*
│ │ │ │ │ -000030b0: 2720 616e 6420 275f 464b 4f5f 2a27 2e0a  ' and '_FKO_*'..
│ │ │ │ │ -000030c0: 0a1f 0a46 696c 653a 206c 6962 666b 6f2e  ...File: libfko.
│ │ │ │ │ -000030d0: 696e 666f 2c20 204e 6f64 653a 2043 6f6d  info,  Node: Com
│ │ │ │ │ -000030e0: 7069 6c69 6e67 2077 6974 6820 6c69 6266  piling with libf
│ │ │ │ │ -000030f0: 6b6f 2c20 204e 6578 743a 2053 5041 2050  ko,  Next: SPA P
│ │ │ │ │ -00003100: 6172 616d 6574 6572 2054 7970 6573 2c20  arameter Types, 
│ │ │ │ │ -00003110: 2050 7265 763a 206c 6962 666b 6f20 4865   Prev: libfko He
│ │ │ │ │ -00003120: 6164 6572 2c20 2055 703a 2050 7265 7061  ader,  Up: Prepa
│ │ │ │ │ -00003130: 7261 7469 6f6e 0a0a 322e 3220 436f 6d70  ration..2.2 Comp
│ │ │ │ │ -00003140: 696c 696e 6720 7769 7468 206c 6962 666b  iling with libfk
│ │ │ │ │ -00003150: 6f0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  o.==============
│ │ │ │ │ -00003160: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 6620  ===========..If 
│ │ │ │ │ -00003170: 796f 7520 7761 6e74 2074 6f20 636f 6d70  you want to comp
│ │ │ │ │ -00003180: 696c 6520 6120 736f 7572 6365 2066 696c  ile a source fil
│ │ │ │ │ -00003190: 6520 696e 636c 7564 696e 6720 7468 6520  e including the 
│ │ │ │ │ -000031a0: 2766 6b6f 2e68 2720 6865 6164 6572 2066  'fko.h' header f
│ │ │ │ │ -000031b0: 696c 652c 0a79 6f75 206d 7573 7420 6d61  ile,.you must ma
│ │ │ │ │ -000031c0: 6b65 2073 7572 6520 7468 6174 2074 6865  ke sure that the
│ │ │ │ │ -000031d0: 2063 6f6d 7069 6c65 7220 6361 6e20 6669   compiler can fi
│ │ │ │ │ -000031e0: 6e64 2069 7420 696e 2074 6865 2064 6972  nd it in the dir
│ │ │ │ │ -000031f0: 6563 746f 7279 0a68 6965 7261 7263 6879  ectory.hierarchy
│ │ │ │ │ -00003200: 2e20 2054 6869 7320 6973 2061 6363 6f6d  .  This is accom
│ │ │ │ │ -00003210: 706c 6973 6865 6420 6279 2061 6464 696e  plished by addin
│ │ │ │ │ -00003220: 6720 7468 6520 7061 7468 2074 6f20 7468  g the path to th
│ │ │ │ │ -00003230: 6520 6469 7265 6374 6f72 7920 696e 0a77  e directory in.w
│ │ │ │ │ -00003240: 6869 6368 2074 6865 2068 6561 6465 7220  hich the header 
│ │ │ │ │ -00003250: 6669 6c65 2069 7320 6c6f 6361 7465 6420  file is located 
│ │ │ │ │ -00003260: 746f 2074 6865 2063 6f6d 7069 6c65 7273  to the compilers
│ │ │ │ │ -00003270: 2069 6e63 6c75 6465 2066 696c 6520 7365   include file se
│ │ │ │ │ -00003280: 6172 6368 0a70 6174 6820 2876 6961 2074  arch.path (via t
│ │ │ │ │ -00003290: 6865 2027 2d49 2720 6f70 7469 6f6e 292e  he '-I' option).
│ │ │ │ │ -000032a0: 0a0a 2020 2046 6f72 2065 7861 6d70 6c65  ..   For example
│ │ │ │ │ -000032b0: 2c20 6966 2079 6f75 2069 6e73 7461 6c6c  , if you install
│ │ │ │ │ -000032c0: 6564 206c 6962 666b 6f20 696e 2027 2f6f  ed libfko in '/o
│ │ │ │ │ -000032d0: 7074 2f66 6b6f 272c 2079 6f75 206d 6179  pt/fko', you may
│ │ │ │ │ -000032e0: 2077 616e 7420 746f 0a61 6464 2027 2d49   want to.add '-I
│ │ │ │ │ -000032f0: 2f6f 7074 2f66 6b6f 2f69 6e63 6c75 6465  /opt/fko/include
│ │ │ │ │ -00003300: 2720 746f 2027 4346 4c41 4753 272c 206f  ' to 'CFLAGS', o
│ │ │ │ │ -00003310: 7220 6469 7265 6374 6c79 206f 6e20 7468  r directly on th
│ │ │ │ │ -00003320: 6520 636f 6d6d 616e 642d 6c69 6e65 3a0a  e command-line:.
│ │ │ │ │ -00003330: 0a20 2020 2020 6763 6320 2d63 2066 6f6f  .     gcc -c foo
│ │ │ │ │ -00003340: 2e63 202d 492f 6f70 742f 666b 6f2f 696e  .c -I/opt/fko/in
│ │ │ │ │ -00003350: 636c 7564 6520 2e2e 2e0a 0a20 2020 5468  clude .....   Th
│ │ │ │ │ -00003360: 6520 7361 6d65 2069 7320 7472 7565 2077  e same is true w
│ │ │ │ │ -00003370: 6865 6e20 6c69 6e6b 696e 6720 6120 7072  hen linking a pr
│ │ │ │ │ -00003380: 6f67 7261 6d20 7769 7468 2074 6865 206c  ogram with the l
│ │ │ │ │ -00003390: 6962 7261 7279 2e20 2049 6e20 7468 6973  ibrary.  In this
│ │ │ │ │ -000033a0: 0a63 6173 652c 2074 6865 206c 696e 6b65  .case, the linke
│ │ │ │ │ -000033b0: 7220 6861 7320 746f 2066 696e 6420 7468  r has to find th
│ │ │ │ │ -000033c0: 6520 6c69 6272 6172 7920 6669 6c65 732e  e library files.
│ │ │ │ │ -000033d0: 2020 466f 7220 7468 6973 2074 6f20 776f    For this to wo
│ │ │ │ │ -000033e0: 726b 2c20 7468 650a 7061 7468 2074 6f20  rk, the.path to 
│ │ │ │ │ -000033f0: 7468 6520 6c69 6272 6172 7920 6669 6c65  the library file
│ │ │ │ │ -00003400: 7320 6861 7320 746f 2062 6520 6164 6465  s has to be adde
│ │ │ │ │ -00003410: 6420 746f 2074 6865 206c 6962 7261 7279  d to the library
│ │ │ │ │ -00003420: 2073 6561 7263 6820 7061 7468 0a28 7669   search path.(vi
│ │ │ │ │ -00003430: 6120 7468 6520 272d 4c27 206f 7074 696f  a the '-L' optio
│ │ │ │ │ -00003440: 6e29 2e0a 0a20 2020 436f 6e74 696e 7569  n)...   Continui
│ │ │ │ │ -00003450: 6e67 2077 6974 6820 7468 6520 6578 616d  ng with the exam
│ │ │ │ │ -00003460: 706c 6520 6162 6f76 6520 796f 7520 6d61  ple above you ma
│ │ │ │ │ -00003470: 7920 7761 6e74 2074 6f20 6164 640a 272d  y want to add.'-
│ │ │ │ │ -00003480: 4c2f 6f70 742f 666b 6f2f 6c69 6227 2074  L/opt/fko/lib' t
│ │ │ │ │ -00003490: 6f20 274c 4446 4c41 4753 272c 206f 7220  o 'LDFLAGS', or 
│ │ │ │ │ -000034a0: 6469 7265 6374 6c79 206f 6e20 7468 6520  directly on the 
│ │ │ │ │ -000034b0: 636f 6d6d 616e 642d 6c69 6e65 3a0a 0a20  command-line:.. 
│ │ │ │ │ -000034c0: 2020 2020 6763 6320 2d6f 2066 6f6f 2066      gcc -o foo f
│ │ │ │ │ -000034d0: 6f6f 2e63 202d 492f 6f70 742f 666b 6f2f  oo.c -I/opt/fko/
│ │ │ │ │ -000034e0: 696e 636c 7564 6520 2d4c 2f6f 7074 2f66  include -L/opt/f
│ │ │ │ │ -000034f0: 6b6f 2f6c 6962 202d 6c66 6b6f 0a0a 1f0a  ko/lib -lfko....
│ │ │ │ │ -00003500: 4669 6c65 3a20 6c69 6266 6b6f 2e69 6e66  File: libfko.inf
│ │ │ │ │ -00003510: 6f2c 2020 4e6f 6465 3a20 5350 4120 5061  o,  Node: SPA Pa
│ │ │ │ │ -00003520: 7261 6d65 7465 7220 5479 7065 732c 2020  rameter Types,  
│ │ │ │ │ -00003530: 5072 6576 3a20 436f 6d70 696c 696e 6720  Prev: Compiling 
│ │ │ │ │ -00003540: 7769 7468 206c 6962 666b 6f2c 2020 5570  with libfko,  Up
│ │ │ │ │ -00003550: 3a20 5072 6570 6172 6174 696f 6e0a 0a32  : Preparation..2
│ │ │ │ │ -00003560: 2e33 2053 5041 2050 6172 616d 6574 6572  .3 SPA Parameter
│ │ │ │ │ -00003570: 2054 7970 6573 0a3d 3d3d 3d3d 3d3d 3d3d   Types.=========
│ │ │ │ │ -00003580: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a  ==============..
│ │ │ │ │ -00003590: 2a20 4d65 6e75 3a0a 0a2a 2044 6967 6573  * Menu:..* Diges
│ │ │ │ │ -000035a0: 7473 3a3a 2020 2020 2020 2020 2020 2020  ts::            
│ │ │ │ │ -000035b0: 2020 2020 2020 2020 2020 2054 6865 206d             The m
│ │ │ │ │ -000035c0: 6573 7361 6765 2064 6967 6573 7420 6861  essage digest ha
│ │ │ │ │ -000035d0: 7368 6573 2073 7570 706f 7274 6564 2062  shes supported b
│ │ │ │ │ -000035e0: 7920 6c69 6266 6b6f 0a2a 2053 5041 204d  y libfko.* SPA M
│ │ │ │ │ -000035f0: 6573 7361 6765 733a 3a20 2020 2020 2020  essages::       
│ │ │ │ │ -00003600: 2020 2020 2020 2020 2020 2054 6865 2066             The f
│ │ │ │ │ -00003610: 6b6f 2053 5041 206d 6573 7361 6765 2074  ko SPA message t
│ │ │ │ │ -00003620: 7970 6573 0a20 2020 2020 2020 2020 2020  ypes.           
│ │ │ │ │ +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.
│ │ │ │ │ +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.             
│ │ │ │ │  00003630: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00003640: 2020 2020 2020 2073 7570 706f 7274 6564         supported
│ │ │ │ │ -00003650: 2062 7920 6c69 6266 6b6f 2028 616e 6420   by libfko (and 
│ │ │ │ │ -00003660: 6677 6b6e 6f70 290a 2a20 456e 6372 7970  fwknop).* Encryp
│ │ │ │ │ -00003670: 7469 6f6e 2041 6c67 6f72 6974 686d 733a  tion Algorithms:
│ │ │ │ │ -00003680: 3a20 2020 2020 2020 2020 456e 6372 7970  :         Encryp
│ │ │ │ │ -00003690: 7469 6f6e 2073 6368 656d 6573 2073 7570  tion schemes sup
│ │ │ │ │ -000036a0: 706f 7274 6564 2062 7920 6c69 6266 6b6f  ported by libfko
│ │ │ │ │ -000036b0: 0a2a 2048 4d41 4320 4469 6765 7374 733a  .* HMAC Digests:
│ │ │ │ │ -000036c0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ │ -000036d0: 2020 2044 6967 6573 7473 2074 6861 7420     Digests that 
│ │ │ │ │ -000036e0: 6361 6e20 6265 2075 7365 6420 746f 2062  can be used to b
│ │ │ │ │ -000036f0: 7569 6c64 2061 6e20 484d 4143 0a0a 1f0a  uild an HMAC....
│ │ │ │ │ -00003700: 4669 6c65 3a20 6c69 6266 6b6f 2e69 6e66  File: libfko.inf
│ │ │ │ │ -00003710: 6f2c 2020 4e6f 6465 3a20 4469 6765 7374  o,  Node: Digest
│ │ │ │ │ -00003720: 732c 2020 4e65 7874 3a20 5350 4120 4d65  s,  Next: SPA Me
│ │ │ │ │ -00003730: 7373 6167 6573 2c20 2055 703a 2053 5041  ssages,  Up: SPA
│ │ │ │ │ -00003740: 2050 6172 616d 6574 6572 2054 7970 6573   Parameter Types
│ │ │ │ │ -00003750: 0a0a 322e 332e 3120 4469 6765 7374 730a  ..2.3.1 Digests.
│ │ │ │ │ -00003760: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54  -------------..T
│ │ │ │ │ -00003770: 6865 2066 776b 6e6f 7020 7379 7374 656d  he fwknop system
│ │ │ │ │ -00003780: 2065 6d70 6c6f 7973 2061 206d 6573 7361   employs a messa
│ │ │ │ │ -00003790: 6765 2064 6967 6573 7420 6861 7368 206f  ge digest hash o
│ │ │ │ │ -000037a0: 6620 7468 6520 5350 4120 6461 7461 2061  f the SPA data a
│ │ │ │ │ -000037b0: 7320 6f6e 650a 6f66 2074 6865 2064 6174  s one.of the dat
│ │ │ │ │ -000037c0: 6120 6669 656c 6473 2074 6f20 6163 7420  a fields to act 
│ │ │ │ │ -000037d0: 6120 7369 676e 6174 7572 6520 7768 6963  a signature whic
│ │ │ │ │ -000037e0: 6820 6361 6e20 6265 2075 7365 6420 6174  h can be used at
│ │ │ │ │ -000037f0: 2074 6865 2072 6563 6569 7669 6e67 0a65   the receiving.e
│ │ │ │ │ -00003800: 6e64 2074 6f20 7665 7269 6679 2074 6865  nd to verify the
│ │ │ │ │ -00003810: 2064 6174 6120 6973 2076 616c 6964 2028   data is valid (
│ │ │ │ │ -00003820: 616c 7468 6f75 6768 2074 6869 7320 6665  although this fe
│ │ │ │ │ -00003830: 6174 7572 6520 6861 7320 6265 656e 0a73  ature has been.s
│ │ │ │ │ -00003840: 7570 6572 6365 6465 6420 6279 2074 6865  uperceded by the
│ │ │ │ │ -00003850: 2075 7361 6765 206f 6620 616e 2048 4d41   usage of an HMA
│ │ │ │ │ -00003860: 4320 666f 7220 7072 6f70 6572 206d 6573  C for proper mes
│ │ │ │ │ -00003870: 7361 6765 2061 7574 6865 6e74 6963 6174  sage authenticat
│ │ │ │ │ -00003880: 696f 6e20 616e 640a 7665 7269 6669 6361  ion and.verifica
│ │ │ │ │ -00003890: 7469 6f6e 206f 6620 696e 7465 6772 6974  tion of integrit
│ │ │ │ │ -000038a0: 7929 2e20 2054 6865 2072 6573 756c 7469  y).  The resulti
│ │ │ │ │ -000038b0: 6e67 2064 6967 6573 7420 6973 2062 6173  ng digest is bas
│ │ │ │ │ -000038c0: 6536 342d 656e 636f 6465 640a 6265 666f  e64-encoded.befo
│ │ │ │ │ -000038d0: 7265 2069 7420 6973 2061 6464 6564 2074  re it is added t
│ │ │ │ │ -000038e0: 6f20 7468 6520 5350 4120 6461 7461 2e0a  o the SPA data..
│ │ │ │ │ -000038f0: 0a20 2020 4375 7272 656e 746c 792c 206c  .   Currently, l
│ │ │ │ │ -00003900: 6962 666b 6f20 7375 7070 6f72 7473 2074  ibfko supports t
│ │ │ │ │ -00003910: 6865 2073 616d 6520 6d65 7373 6167 6520  he same message 
│ │ │ │ │ -00003920: 6469 6765 7374 7320 6173 2074 6865 206c  digests as the l
│ │ │ │ │ -00003930: 6567 6163 790a 6677 6b6e 6f70 2070 6c75  egacy.fwknop plu
│ │ │ │ │ -00003940: 7320 7477 6f20 6f74 6865 7273 2028 5348  s two others (SH
│ │ │ │ │ -00003950: 4133 3834 2061 6e64 2053 4841 3531 3229  A384 and SHA512)
│ │ │ │ │ -00003960: 2e20 2054 6865 7365 2061 7265 2028 696e  .  These are (in
│ │ │ │ │ -00003970: 206f 7264 6572 206f 660a 7374 7265 6e67   order of.streng
│ │ │ │ │ -00003980: 7468 293a 0a0a 202d 2d20 5661 7269 6162  th):.. -- Variab
│ │ │ │ │ -00003990: 6c65 3a20 696e 7420 666b 6f5f 6469 6765  le: int fko_dige
│ │ │ │ │ -000039a0: 7374 5f74 7970 655f 740a 2020 2020 2027  st_type_t.     '
│ │ │ │ │ -000039b0: 464b 4f5f 4449 4745 5354 5f4d 4435 270a  FKO_DIGEST_MD5'.
│ │ │ │ │ -000039c0: 2020 2020 2027 464b 4f5f 4449 4745 5354       'FKO_DIGEST
│ │ │ │ │ -000039d0: 5f53 4841 3127 0a20 2020 2020 2746 4b4f  _SHA1'.     'FKO
│ │ │ │ │ -000039e0: 5f44 4947 4553 545f 5348 4132 3536 2028  _DIGEST_SHA256 (
│ │ │ │ │ -000039f0: 6c69 6266 6b6f 2064 6566 6175 6c74 2927  libfko default)'
│ │ │ │ │ -00003a00: 0a20 2020 2020 2746 4b4f 5f44 4947 4553  .     'FKO_DIGES
│ │ │ │ │ -00003a10: 545f 5348 4133 3834 270a 2020 2020 2027  T_SHA384'.     '
│ │ │ │ │ -00003a20: 464b 4f5f 4449 4745 5354 5f53 4841 3531  FKO_DIGEST_SHA51
│ │ │ │ │ -00003a30: 3227 0a0a 2020 2041 7320 696e 6469 6361  2'..   As indica
│ │ │ │ │ -00003a40: 7465 6420 696e 2074 6865 206c 6973 7420  ted in the list 
│ │ │ │ │ -00003a50: 6162 6f76 652c 2053 4841 3235 3620 6973  above, SHA256 is
│ │ │ │ │ -00003a60: 2074 6865 2064 6566 6175 6c74 2e20 2054   the default.  T
│ │ │ │ │ -00003a70: 6869 7320 6d65 616e 730a 7468 6520 6469  his means.the di
│ │ │ │ │ -00003a80: 6765 7374 2074 7970 6520 646f 6573 206e  gest type does n
│ │ │ │ │ -00003a90: 6f74 206e 6565 6420 746f 2062 6520 6578  ot need to be ex
│ │ │ │ │ -00003aa0: 706c 6963 6974 6c79 2073 6574 2075 6e6c  plicitly set unl
│ │ │ │ │ -00003ab0: 6573 7320 796f 7520 7769 7368 2074 6f0a  ess you wish to.
│ │ │ │ │ -00003ac0: 7573 6520 6f6e 6520 6f66 2074 6865 206f  use one of the o
│ │ │ │ │ -00003ad0: 7468 6572 2076 616c 7565 732e 2020 5468  ther values.  Th
│ │ │ │ │ -00003ae0: 6973 2061 7070 6c69 6573 2074 6f20 616c  is applies to al
│ │ │ │ │ -00003af0: 6c20 6c69 6266 6b6f 2053 5041 2064 6174  l libfko SPA dat
│ │ │ │ │ -00003b00: 6120 6669 656c 6473 0a74 6861 7420 6861  a fields.that ha
│ │ │ │ │ -00003b10: 7665 2061 2064 6566 6175 6c74 2076 616c  ve a default val
│ │ │ │ │ -00003b20: 7565 2e0a 0a1f 0a46 696c 653a 206c 6962  ue.....File: lib
│ │ │ │ │ -00003b30: 666b 6f2e 696e 666f 2c20 204e 6f64 653a  fko.info,  Node:
│ │ │ │ │ -00003b40: 2053 5041 204d 6573 7361 6765 732c 2020   SPA Messages,  
│ │ │ │ │ -00003b50: 4e65 7874 3a20 456e 6372 7970 7469 6f6e  Next: Encryption
│ │ │ │ │ -00003b60: 2041 6c67 6f72 6974 686d 732c 2020 5072   Algorithms,  Pr
│ │ │ │ │ -00003b70: 6576 3a20 4469 6765 7374 732c 2020 5570  ev: Digests,  Up
│ │ │ │ │ -00003b80: 3a20 5350 4120 5061 7261 6d65 7465 7220  : SPA Parameter 
│ │ │ │ │ -00003b90: 5479 7065 730a 0a32 2e33 2e32 2053 5041  Types..2.3.2 SPA
│ │ │ │ │ -00003ba0: 204d 6573 7361 6765 730a 2d2d 2d2d 2d2d   Messages.------
│ │ │ │ │ -00003bb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468  ------------..Th
│ │ │ │ │ -00003bc0: 6520 6677 6b6e 6f70 2073 7973 7465 6d20  e fwknop system 
│ │ │ │ │ -00003bd0: 2861 6e64 2073 7562 7365 7175 656e 746c  (and subsequentl
│ │ │ │ │ -00003be0: 7920 6c69 6266 6b6f 292c 2073 7570 706f  y libfko), suppo
│ │ │ │ │ -00003bf0: 7274 2061 2073 7065 6369 6669 6320 7365  rt a specific se
│ │ │ │ │ -00003c00: 7420 6f66 0a6d 6573 7361 6765 2074 7970  t of.message typ
│ │ │ │ │ -00003c10: 6573 2e20 2054 6865 206d 6573 7361 6765  es.  The message
│ │ │ │ │ -00003c20: 2074 7970 6520 7661 6c75 6520 6973 2075   type value is u
│ │ │ │ │ -00003c30: 7365 6420 6279 2066 776b 6e6f 7020 746f  sed by fwknop to
│ │ │ │ │ -00003c40: 2068 656c 700a 6465 7465 726d 696e 6520   help.determine 
│ │ │ │ │ -00003c50: 7468 6520 636f 7272 6563 7420 6d65 7373  the correct mess
│ │ │ │ │ -00003c60: 6167 6520 666f 726d 6174 2061 6e64 2063  age format and c
│ │ │ │ │ -00003c70: 6f6e 7465 6e74 2e20 2054 6865 7365 206d  ontent.  These m
│ │ │ │ │ -00003c80: 6573 7361 6765 2074 7970 6573 0a61 7265  essage types.are
│ │ │ │ │ -00003c90: 3a0a 0a20 2d2d 2056 6172 6961 626c 653a  :.. -- Variable:
│ │ │ │ │ -00003ca0: 2069 6e74 2066 6b6f 5f6d 6573 7361 6765   int fko_message
│ │ │ │ │ -00003cb0: 5f74 7970 655f 740a 2020 2020 2027 464b  _type_t.     'FK
│ │ │ │ │ -00003cc0: 4f5f 434f 4d4d 414e 445f 4d53 4727 0a20  O_COMMAND_MSG'. 
│ │ │ │ │ -00003cd0: 2020 2020 2020 2020 2041 2072 6571 7565           A reque
│ │ │ │ │ -00003ce0: 7374 2074 6f20 6861 7665 2074 6865 2066  st to have the f
│ │ │ │ │ -00003cf0: 776b 6e6f 7020 7365 7276 6572 2065 7865  wknop server exe
│ │ │ │ │ -00003d00: 6375 7465 2074 6865 2067 6976 656e 2063  cute the given c
│ │ │ │ │ -00003d10: 6f6d 6d61 6e64 2e0a 2020 2020 2020 2020  ommand..        
│ │ │ │ │ -00003d20: 2020 5468 6520 666f 726d 6174 2066 6f72    The format for
│ │ │ │ │ -00003d30: 2074 6869 7320 7479 7065 2069 733a 2027   this type is: '
│ │ │ │ │ -00003d40: 3c69 7020 6f66 2072 6571 7565 7374 6f72  <ip of requestor
│ │ │ │ │ -00003d50: 3e2c 3c63 6f6d 6d61 6e64 0a20 2020 2020  >,<command.     
│ │ │ │ │ -00003d60: 2020 2020 2074 6578 743e 272e 0a20 2020       text>'..   
│ │ │ │ │ -00003d70: 2020 2020 2020 2020 2020 2020 2231 3932              "192
│ │ │ │ │ -00003d80: 2e31 3638 2e31 2e32 2c75 6e61 6d65 202d  .168.1.2,uname -
│ │ │ │ │ -00003d90: 6122 0a0a 2020 2020 2027 464b 4f5f 4143  a"..     'FKO_AC
│ │ │ │ │ -00003da0: 4345 5353 5f4d 5347 270a 2020 2020 2020  CESS_MSG'.      
│ │ │ │ │ -00003db0: 2020 2020 4120 6261 7369 6320 6163 6365      A basic acce
│ │ │ │ │ -00003dc0: 7373 2072 6571 7565 7374 2e20 2054 6869  ss request.  Thi
│ │ │ │ │ -00003dd0: 7320 6973 2074 6865 206d 6f73 7420 636f  s is the most co
│ │ │ │ │ -00003de0: 6d6d 6f6e 2074 7970 6520 696e 2075 7365  mmon type in use
│ │ │ │ │ -00003df0: 2e0a 2020 2020 2020 2020 2020 5468 6520  ..          The 
│ │ │ │ │ -00003e00: 666f 726d 6174 2066 6f72 2074 6869 7320  format for this 
│ │ │ │ │ -00003e10: 7479 7065 2069 733a 2027 3c69 7020 6f66  type is: '<ip of
│ │ │ │ │ -00003e20: 0a20 2020 2020 2020 2020 2072 6571 7565  .          reque
│ │ │ │ │ -00003e30: 7374 6f72 3e2c 3c70 726f 746f 636f 6c3e  stor>,<protocol>
│ │ │ │ │ -00003e40: 2f3c 706f 7274 3e27 2e20 204e 6f74 6520  /<port>'.  Note 
│ │ │ │ │ -00003e50: 7468 6174 206d 756c 7469 706c 650a 2020  that multiple.  
│ │ │ │ │ -00003e60: 2020 2020 2020 2020 7072 6f74 6f63 6f6c          protocol
│ │ │ │ │ -00003e70: 2f70 6f72 7420 656e 7472 6965 7320 6172  /port entries ar
│ │ │ │ │ -00003e80: 6520 616c 6c6f 7765 642e 0a20 2020 2020  e allowed..     
│ │ │ │ │ -00003e90: 2020 2020 2020 2020 2020 2231 3932 2e31            "192.1
│ │ │ │ │ -00003ea0: 3638 2e31 2e32 2c74 6370 2f32 3222 0a20  68.1.2,tcp/22". 
│ │ │ │ │ -00003eb0: 2020 2020 2020 2020 2020 2020 2020 2231                "1
│ │ │ │ │ -00003ec0: 3932 2e31 3638 2e31 2e32 2c74 6370 2f32  92.168.1.2,tcp/2
│ │ │ │ │ -00003ed0: 322c 7564 702f 3530 3035 220a 0a20 2020  2,udp/5005"..   
│ │ │ │ │ -00003ee0: 2020 2746 4b4f 5f4e 4154 5f41 4343 4553    'FKO_NAT_ACCES
│ │ │ │ │ -00003ef0: 535f 4d53 4727 0a20 2020 2020 2020 2020  S_MSG'.         
│ │ │ │ │ -00003f00: 2041 6e20 6163 6365 7373 2072 6571 7565   An access reque
│ │ │ │ │ -00003f10: 7374 2074 6861 7420 616c 736f 2070 726f  st that also pro
│ │ │ │ │ -00003f20: 7669 6465 2069 6e66 6f72 6d61 7469 6f6e  vide information
│ │ │ │ │ -00003f30: 2066 6f72 2074 6865 2066 776b 6e6f 700a   for the fwknop.
│ │ │ │ │ -00003f40: 2020 2020 2020 2020 2020 7365 7276 6572            server
│ │ │ │ │ -00003f50: 2074 6f20 6372 6561 7465 2061 204e 6574   to create a Net
│ │ │ │ │ -00003f60: 776f 726b 2041 6464 7265 7373 2054 7261  work Address Tra
│ │ │ │ │ -00003f70: 6e73 6c61 7469 6f6e 2028 4e41 5420 746f  nslation (NAT to
│ │ │ │ │ -00003f80: 2061 6e0a 2020 2020 2020 2020 2020 696e   an.          in
│ │ │ │ │ -00003f90: 7465 726e 616c 2061 6464 7265 7373 2e20  ternal address. 
│ │ │ │ │ -00003fa0: 2054 6865 2066 6f72 6d61 7420 666f 7220   The format for 
│ │ │ │ │ -00003fb0: 7468 6973 2073 7472 696e 6720 6973 3a20  this string is: 
│ │ │ │ │ -00003fc0: 273c 696e 7465 726e 616c 0a20 2020 2020  '<internal.     
│ │ │ │ │ -00003fd0: 2020 2020 2069 703e 2c3c 6578 7420 6e61       ip>,<ext na
│ │ │ │ │ -00003fe0: 7420 706f 7274 3e27 2e0a 2020 2020 2020  t port>'..      
│ │ │ │ │ -00003ff0: 2020 2020 2020 2020 2022 3130 2e31 302e           "10.10.
│ │ │ │ │ -00004000: 312e 322c 3939 3232 220a 0a20 2020 2020  1.2,9922"..     
│ │ │ │ │ -00004010: 2746 4b4f 5f43 4c49 454e 545f 5449 4d45  'FKO_CLIENT_TIME
│ │ │ │ │ -00004020: 4f55 545f 4143 4345 5353 5f4d 5347 270a  OUT_ACCESS_MSG'.
│ │ │ │ │ -00004030: 2020 2020 2020 2020 2020 5468 6973 2069            This i
│ │ │ │ │ -00004040: 7320 616e 2046 4b4f 5f41 4343 4553 535f  s an FKO_ACCESS_
│ │ │ │ │ -00004050: 5245 5155 4553 5420 7769 7468 2061 2074  REQUEST with a t
│ │ │ │ │ -00004060: 696d 656f 7574 2070 6172 616d 6574 6572  imeout parameter
│ │ │ │ │ -00004070: 2066 6f72 2074 6865 0a20 2020 2020 2020   for the.       
│ │ │ │ │ -00004080: 2020 2066 776b 6e6f 7020 7365 7276 6572     fwknop server
│ │ │ │ │ -00004090: 2e20 2054 6865 2074 696d 656f 7574 2076  .  The timeout v
│ │ │ │ │ -000040a0: 616c 7565 2069 7320 7072 6f76 6964 6564  alue is provided
│ │ │ │ │ -000040b0: 2076 6961 2074 6865 0a20 2020 2020 2020   via the.       
│ │ │ │ │ -000040c0: 2020 2027 636c 6965 6e74 5f74 696d 656f     'client_timeo
│ │ │ │ │ -000040d0: 7574 2720 6461 7461 2066 6965 6c64 2e0a  ut' data field..
│ │ │ │ │ -000040e0: 0a20 2020 2020 2746 4b4f 5f43 4c49 454e  .     'FKO_CLIEN
│ │ │ │ │ -000040f0: 545f 5449 4d45 4f55 545f 4e41 545f 4143  T_TIMEOUT_NAT_AC
│ │ │ │ │ -00004100: 4345 5353 5f4d 5347 270a 2020 2020 2020  CESS_MSG'.      
│ │ │ │ │ -00004110: 2020 2020 5468 6973 2069 7320 616e 2046      This is an F
│ │ │ │ │ -00004120: 4b4f 5f4e 4154 5f41 4343 4553 535f 5245  KO_NAT_ACCESS_RE
│ │ │ │ │ -00004130: 5155 4553 5420 7769 7468 2061 2074 696d  QUEST with a tim
│ │ │ │ │ -00004140: 656f 7574 2070 6172 616d 6574 6572 2066  eout parameter f
│ │ │ │ │ -00004150: 6f72 0a20 2020 2020 2020 2020 2074 6865  or.          the
│ │ │ │ │ -00004160: 2066 776b 6e6f 7020 7365 7276 6572 2e20   fwknop server. 
│ │ │ │ │ -00004170: 2054 6865 2074 696d 656f 7574 2076 616c   The timeout val
│ │ │ │ │ -00004180: 7565 2069 7320 7072 6f76 6964 6564 2076  ue is provided v
│ │ │ │ │ -00004190: 6961 2074 6865 0a20 2020 2020 2020 2020  ia the.         
│ │ │ │ │ -000041a0: 2027 636c 6965 6e74 5f74 696d 656f 7574   'client_timeout
│ │ │ │ │ -000041b0: 2720 6461 7461 2066 6965 6c64 2e0a 0a20  ' data field... 
│ │ │ │ │ -000041c0: 2020 2020 2746 4b4f 5f4c 4f43 414c 5f4e      'FKO_LOCAL_N
│ │ │ │ │ -000041d0: 4154 5f41 4343 4553 535f 4d53 4727 0a20  AT_ACCESS_MSG'. 
│ │ │ │ │ -000041e0: 2020 2020 2020 2020 2054 6869 7320 6973           This is
│ │ │ │ │ -000041f0: 2073 696d 696c 6172 2074 6f20 7468 6520   similar to the 
│ │ │ │ │ -00004200: 464b 4f5f 4e41 545f 4143 4345 5353 2072  FKO_NAT_ACCESS r
│ │ │ │ │ -00004210: 6571 7565 7374 2065 7863 6570 7420 7468  equest except th
│ │ │ │ │ -00004220: 6520 4e41 540a 2020 2020 2020 2020 2020  e NAT.          
│ │ │ │ │ -00004230: 6973 2074 6f20 7468 6520 6c6f 6361 6c20  is to the local 
│ │ │ │ │ -00004240: 746f 2074 6865 2073 6572 7665 7220 2869  to the server (i
│ │ │ │ │ -00004250: 2e65 2e20 2061 2073 6572 7669 6365 206c  .e.  a service l
│ │ │ │ │ -00004260: 6973 7465 6e69 6e67 206f 6e0a 2020 2020  istening on.    
│ │ │ │ │ -00004270: 2020 2020 2020 3132 372e 302e 302e 3129        127.0.0.1)
│ │ │ │ │ -00004280: 2e0a 0a20 2020 2020 2746 4b4f 5f43 4c49  ...     'FKO_CLI
│ │ │ │ │ -00004290: 454e 545f 5449 4d45 4f55 545f 4c4f 4341  ENT_TIMEOUT_LOCA
│ │ │ │ │ -000042a0: 4c5f 4e41 545f 4143 4345 5353 5f4d 5347  L_NAT_ACCESS_MSG
│ │ │ │ │ -000042b0: 270a 2020 2020 2020 2020 2020 5468 6973  '.          This
│ │ │ │ │ -000042c0: 2069 7320 616e 2046 4b4f 5f4c 4f43 414c   is an FKO_LOCAL
│ │ │ │ │ -000042d0: 5f4e 4154 5f41 4343 4553 535f 5245 5155  _NAT_ACCESS_REQU
│ │ │ │ │ -000042e0: 4553 5420 7769 7468 2061 2074 696d 656f  EST with a timeo
│ │ │ │ │ -000042f0: 7574 0a20 2020 2020 2020 2020 2070 6172  ut.          par
│ │ │ │ │ -00004300: 616d 6574 6572 2066 6f72 2074 6865 2066  ameter for the f
│ │ │ │ │ -00004310: 776b 6e6f 7020 7365 7276 6572 2e20 2054  wknop server.  T
│ │ │ │ │ -00004320: 6865 2074 696d 656f 7574 2076 616c 7565  he timeout value
│ │ │ │ │ -00004330: 2069 730a 2020 2020 2020 2020 2020 7072   is.          pr
│ │ │ │ │ -00004340: 6f76 6964 6564 2076 6961 2074 6865 2027  ovided via the '
│ │ │ │ │ -00004350: 636c 6965 6e74 5f74 696d 656f 7574 2720  client_timeout' 
│ │ │ │ │ -00004360: 6461 7461 2066 6965 6c64 2e0a 0a1f 0a46  data field.....F
│ │ │ │ │ -00004370: 696c 653a 206c 6962 666b 6f2e 696e 666f  ile: libfko.info
│ │ │ │ │ -00004380: 2c20 204e 6f64 653a 2045 6e63 7279 7074  ,  Node: Encrypt
│ │ │ │ │ -00004390: 696f 6e20 416c 676f 7269 7468 6d73 2c20  ion Algorithms, 
│ │ │ │ │ -000043a0: 204e 6578 743a 2048 4d41 4320 4469 6765   Next: HMAC Dige
│ │ │ │ │ -000043b0: 7374 732c 2020 5072 6576 3a20 5350 4120  sts,  Prev: SPA 
│ │ │ │ │ -000043c0: 4d65 7373 6167 6573 2c20 2055 703a 2053  Messages,  Up: S
│ │ │ │ │ -000043d0: 5041 2050 6172 616d 6574 6572 2054 7970  PA Parameter Typ
│ │ │ │ │ -000043e0: 6573 0a0a 322e 332e 3320 456e 6372 7970  es..2.3.3 Encryp
│ │ │ │ │ -000043f0: 7469 6f6e 2041 6c67 6f72 6974 686d 730a  tion Algorithms.
│ │ │ │ │ +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.--
│ │ │ │ │  00004400: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ │ -00004410: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a4f 6e65  -----------..One
│ │ │ │ │ -00004420: 206f 6620 7468 6520 6669 6e61 6c20 7374   of the final st
│ │ │ │ │ -00004430: 6570 7320 2862 6566 6f72 6520 7468 6520  eps (before the 
│ │ │ │ │ -00004440: 484d 4143 2069 7320 6361 6c63 756c 6174  HMAC is calculat
│ │ │ │ │ -00004450: 6564 2061 6e64 2061 7070 6c69 6564 2920  ed and applied) 
│ │ │ │ │ -00004460: 696e 0a63 7265 6174 696e 6720 616e 2066  in.creating an f
│ │ │ │ │ -00004470: 776b 6e6f 7020 5350 4120 6d65 7373 6167  wknop SPA messag
│ │ │ │ │ -00004480: 6520 6973 2065 6e63 7279 7074 696e 6720  e is encrypting 
│ │ │ │ │ -00004490: 7468 6520 656e 7469 7265 206d 6573 7361  the entire messa
│ │ │ │ │ -000044a0: 6765 2e0a 4375 7272 656e 746c 792c 2066  ge..Currently, f
│ │ │ │ │ -000044b0: 776b 6e6f 7020 7375 7070 6f72 7473 2074  wknop supports t
│ │ │ │ │ -000044c0: 776f 206d 6574 686f 6473 206f 6620 656e  wo methods of en
│ │ │ │ │ -000044d0: 6372 7970 7469 6f6e 3a0a 0a20 2d2d 2056  cryption:.. -- V
│ │ │ │ │ -000044e0: 6172 6961 626c 653a 2069 6e74 2066 6b6f  ariable: int fko
│ │ │ │ │ -000044f0: 5f65 6e63 7279 7074 696f 6e5f 7479 7065  _encryption_type
│ │ │ │ │ -00004500: 5f74 0a20 2020 2020 2746 4b4f 5f45 4e43  _t.     'FKO_ENC
│ │ │ │ │ -00004510: 5259 5054 494f 4e5f 5249 4a4e 4441 454c  RYPTION_RIJNDAEL
│ │ │ │ │ -00004520: 2028 6465 6661 756c 7429 270a 2020 2020   (default)'.    
│ │ │ │ │ -00004530: 2027 464b 4f5f 454e 4352 5950 5449 4f4e   'FKO_ENCRYPTION
│ │ │ │ │ -00004540: 5f47 5047 270a 0a20 2020 4173 2069 6e64  _GPG'..   As ind
│ │ │ │ │ -00004550: 6963 6174 6564 2c20 6c69 6266 6b6f 2075  icated, libfko u
│ │ │ │ │ -00004560: 7365 7320 5269 6a6e 6461 656c 2065 6e63  ses Rijndael enc
│ │ │ │ │ -00004570: 7279 7074 696f 6e20 6279 2064 6566 6175  ryption by defau
│ │ │ │ │ -00004580: 6c74 2e20 2052 696a 6e64 6165 6c0a 656e  lt.  Rijndael.en
│ │ │ │ │ -00004590: 6372 7970 7469 6f6e 2069 7320 7375 6666  cryption is suff
│ │ │ │ │ -000045a0: 6963 6965 6e74 2066 6f72 206d 6f73 7420  icient for most 
│ │ │ │ │ -000045b0: 7573 6572 7320 616e 6420 7072 6f64 7563  users and produc
│ │ │ │ │ -000045c0: 6573 2061 206d 7563 6820 736d 616c 6c65  es a much smalle
│ │ │ │ │ -000045d0: 7220 6461 7461 0a70 6163 6b65 7420 7468  r data.packet th
│ │ │ │ │ -000045e0: 616e 2047 5047 2028 6265 7477 6565 6e20  an GPG (between 
│ │ │ │ │ -000045f0: 3134 3020 6279 7465 7320 7769 7468 204d  140 bytes with M
│ │ │ │ │ -00004600: 4435 2064 6967 6573 7420 746f 2061 726f  D5 digest to aro
│ │ │ │ │ -00004610: 756e 6420 3232 3520 6279 7465 730a 6f72  und 225 bytes.or
│ │ │ │ │ -00004620: 2073 6f20 7769 7468 2053 4841 3531 322c   so with SHA512,
│ │ │ │ │ -00004630: 2063 6f6d 7061 7265 6420 746f 2061 726f   compared to aro
│ │ │ │ │ -00004640: 756e 6420 3131 3030 2066 6f72 2073 6967  und 1100 for sig
│ │ │ │ │ -00004650: 6e65 6420 4750 4729 2e20 2057 6865 6e0a  ned GPG).  When.
│ │ │ │ │ -00004660: 5269 6a6e 6461 656c 2069 7320 7573 6564  Rijndael is used
│ │ │ │ │ -00004670: 2c20 7468 6520 656e 6372 7970 7469 6f6e  , the encryption
│ │ │ │ │ -00004680: 206b 6579 2069 7473 656c 6620 6973 2064   key itself is d
│ │ │ │ │ -00004690: 6572 6976 6564 2066 726f 6d20 7468 6520  erived from the 
│ │ │ │ │ -000046a0: 7375 7070 6c69 6564 0a70 6173 7370 6872  supplied.passphr
│ │ │ │ │ -000046b0: 6173 6520 7669 6120 7468 6520 5042 4b44  ase via the PBKD
│ │ │ │ │ -000046c0: 4631 2061 6c67 6f72 6974 686d 2c20 616e  F1 algorithm, an
│ │ │ │ │ -000046d0: 6420 4342 4320 6d6f 6465 2069 7320 7365  d CBC mode is se
│ │ │ │ │ -000046e0: 742e 0a0a 2020 2048 6f77 6576 6572 2c20  t...   However, 
│ │ │ │ │ -000046f0: 736f 6d65 206d 6179 2070 7265 6665 7220  some may prefer 
│ │ │ │ │ -00004700: 7468 6520 6869 6768 6572 206c 6576 656c  the higher level
│ │ │ │ │ -00004710: 206f 6620 7365 6375 7269 7479 2070 726f   of security pro
│ │ │ │ │ -00004720: 7669 6465 6420 6279 0a47 5047 2e20 2057  vided by.GPG.  W
│ │ │ │ │ -00004730: 6865 6e20 7365 6c65 6374 6564 2c20 6164  hen selected, ad
│ │ │ │ │ -00004740: 6469 7469 6f6e 616c 2070 6172 616d 6574  ditional paramet
│ │ │ │ │ -00004750: 6572 7320 7375 6368 2061 7320 5f72 6563  ers such as _rec
│ │ │ │ │ -00004760: 6970 6965 6e74 5f20 616e 640a 5f73 6967  ipient_ and._sig
│ │ │ │ │ -00004770: 6e65 725f 206d 6179 2062 6520 7365 7420  ner_ may be set 
│ │ │ │ │ -00004780: 6173 2077 656c 6c2e 2020 5365 6520 2a6e  as well.  See *n
│ │ │ │ │ -00004790: 6f74 6520 5365 7474 696e 6720 5350 4120  ote Setting SPA 
│ │ │ │ │ -000047a0: 4461 7461 3a3a 2066 6f72 2064 6574 6169  Data:: for detai
│ │ │ │ │ -000047b0: 6c20 6f6e 0a73 6574 7469 6e67 2074 6865  l on.setting the
│ │ │ │ │ -000047c0: 7365 2061 6e64 206f 7468 6572 2053 5041  se and other SPA
│ │ │ │ │ -000047d0: 2064 6174 6120 6669 656c 6473 2e0a 0a1f   data fields....
│ │ │ │ │ -000047e0: 0a46 696c 653a 206c 6962 666b 6f2e 696e  .File: libfko.in
│ │ │ │ │ -000047f0: 666f 2c20 204e 6f64 653a 2048 4d41 4320  fo,  Node: HMAC 
│ │ │ │ │ -00004800: 4469 6765 7374 732c 2020 5072 6576 3a20  Digests,  Prev: 
│ │ │ │ │ -00004810: 456e 6372 7970 7469 6f6e 2041 6c67 6f72  Encryption Algor
│ │ │ │ │ -00004820: 6974 686d 732c 2020 5570 3a20 5350 4120  ithms,  Up: SPA 
│ │ │ │ │ -00004830: 5061 7261 6d65 7465 7220 5479 7065 730a  Parameter Types.
│ │ │ │ │ -00004840: 0a32 2e33 2e34 2048 4d41 4320 4469 6765  .2.3.4 HMAC Dige
│ │ │ │ │ -00004850: 7374 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  sts.------------
│ │ │ │ │ -00004860: 2d2d 2d2d 2d2d 0a0a 5468 6520 6677 6b6e  ------..The fwkn
│ │ │ │ │ -00004870: 6f70 2070 726f 6a65 6374 2065 6d70 6c6f  op project emplo
│ │ │ │ │ -00004880: 7973 2061 6e20 484d 4143 2069 6e20 7468  ys an HMAC in th
│ │ │ │ │ -00004890: 6520 656e 6372 7970 742d 7468 656e 2d61  e encrypt-then-a
│ │ │ │ │ -000048a0: 7574 6865 6e74 6963 6174 650a 6d6f 6465  uthenticate.mode
│ │ │ │ │ -000048b0: 6c20 666f 7220 7374 726f 6e67 2053 5041  l for strong SPA
│ │ │ │ │ -000048c0: 206d 6573 7361 6765 2061 7574 6865 6e74   message authent
│ │ │ │ │ -000048d0: 6963 6174 696f 6e2e 2020 5468 6520 484d  ication.  The HM
│ │ │ │ │ -000048e0: 4143 2069 7473 656c 6620 6973 2064 6572  AC itself is der
│ │ │ │ │ -000048f0: 6976 6564 0a66 726f 6d20 6120 6469 6765  ived.from a dige
│ │ │ │ │ -00004900: 7374 206f 6620 7468 6520 656e 6372 7970  st of the encryp
│ │ │ │ │ -00004910: 7465 6420 5350 4120 6d65 7373 6167 6520  ted SPA message 
│ │ │ │ │ -00004920: 616c 6f6e 6720 7769 7468 2061 2064 6564  along with a ded
│ │ │ │ │ -00004930: 6963 6174 6564 2048 4d41 430a 6b65 792e  icated HMAC.key.
│ │ │ │ │ -00004940: 0a0a 2020 2043 7572 7265 6e74 6c79 2c20  ..   Currently, 
│ │ │ │ │ -00004950: 6c69 6266 6b6f 2073 7570 706f 7274 7320  libfko supports 
│ │ │ │ │ -00004960: 7468 6520 7361 6d65 206d 6573 7361 6765  the same message
│ │ │ │ │ -00004970: 2064 6967 6573 7473 2061 7320 6d65 6e74   digests as ment
│ │ │ │ │ -00004980: 696f 6e65 6420 696e 0a74 6865 2044 6967  ioned in.the Dig
│ │ │ │ │ -00004990: 6573 7420 7365 6374 696f 6e20 6162 6f76  est section abov
│ │ │ │ │ -000049a0: 652c 2061 6e64 2074 6865 7365 2061 7265  e, and these are
│ │ │ │ │ -000049b0: 2028 696e 206f 7264 6572 206f 6620 7374   (in order of st
│ │ │ │ │ -000049c0: 7265 6e67 7468 293a 0a0a 202d 2d20 5661  rength):.. -- Va
│ │ │ │ │ -000049d0: 7269 6162 6c65 3a20 696e 7420 666b 6f5f  riable: int fko_
│ │ │ │ │ -000049e0: 6469 6765 7374 5f74 7970 655f 740a 2020  digest_type_t.  
│ │ │ │ │ -000049f0: 2020 2027 464b 4f5f 484d 4143 5f4d 4435     'FKO_HMAC_MD5
│ │ │ │ │ -00004a00: 270a 2020 2020 2027 464b 4f5f 484d 4143  '.     'FKO_HMAC
│ │ │ │ │ -00004a10: 5f53 4841 3127 0a20 2020 2020 2746 4b4f  _SHA1'.     'FKO
│ │ │ │ │ -00004a20: 5f48 4d41 435f 5348 4132 3536 2028 6c69  _HMAC_SHA256 (li
│ │ │ │ │ -00004a30: 6266 6b6f 2064 6566 6175 6c74 2927 0a20  bfko default)'. 
│ │ │ │ │ -00004a40: 2020 2020 2746 4b4f 5f48 4d41 435f 5348      'FKO_HMAC_SH
│ │ │ │ │ -00004a50: 4133 3834 270a 2020 2020 2027 464b 4f5f  A384'.     'FKO_
│ │ │ │ │ -00004a60: 484d 4143 5f53 4841 3531 3227 0a0a 2020  HMAC_SHA512'..  
│ │ │ │ │ -00004a70: 2041 7320 696e 6469 6361 7465 6420 696e   As indicated in
│ │ │ │ │ -00004a80: 2074 6865 206c 6973 7420 6162 6f76 652c   the list above,
│ │ │ │ │ -00004a90: 2053 4841 3235 3620 6973 2074 6865 2064   SHA256 is the d
│ │ │ │ │ -00004aa0: 6566 6175 6c74 2e20 2054 6869 7320 6d65  efault.  This me
│ │ │ │ │ -00004ab0: 616e 730a 7468 6520 484d 4143 2064 6967  ans.the HMAC dig
│ │ │ │ │ -00004ac0: 6573 7420 7479 7065 2064 6f65 7320 6e6f  est type does no
│ │ │ │ │ -00004ad0: 7420 6e65 6564 2074 6f20 6265 2065 7870  t need to be exp
│ │ │ │ │ -00004ae0: 6c69 6369 746c 7920 7365 7420 756e 6c65  licitly set unle
│ │ │ │ │ -00004af0: 7373 2079 6f75 2077 6973 680a 746f 2075  ss you wish.to u
│ │ │ │ │ -00004b00: 7365 206f 6e65 206f 6620 7468 6520 6f74  se one of the ot
│ │ │ │ │ -00004b10: 6865 7220 7661 6c75 6573 2e20 2054 6869  her values.  Thi
│ │ │ │ │ -00004b20: 7320 6170 706c 6965 7320 746f 2061 6c6c  s applies to all
│ │ │ │ │ -00004b30: 206c 6962 666b 6f20 5350 4120 6461 7461   libfko SPA data
│ │ │ │ │ -00004b40: 0a66 6965 6c64 7320 7468 6174 2068 6176  .fields that hav
│ │ │ │ │ -00004b50: 6520 6120 6465 6661 756c 7420 7661 6c75  e a default valu
│ │ │ │ │ -00004b60: 652e 0a0a 1f0a 4669 6c65 3a20 6c69 6266  e.....File: libf
│ │ │ │ │ -00004b70: 6b6f 2e69 6e66 6f2c 2020 4e6f 6465 3a20  ko.info,  Node: 
│ │ │ │ │ -00004b80: 5573 696e 6720 6c69 6266 6b6f 2c20 204e  Using libfko,  N
│ │ │ │ │ -00004b90: 6578 743a 204c 6962 7261 7279 2043 6f70  ext: Library Cop
│ │ │ │ │ -00004ba0: 7969 6e67 2c20 2050 7265 763a 2050 7265  ying,  Prev: Pre
│ │ │ │ │ -00004bb0: 7061 7261 7469 6f6e 2c20 2055 703a 2054  paration,  Up: T
│ │ │ │ │ -00004bc0: 6f70 0a0a 3320 5573 696e 6720 6c69 6266  op..3 Using libf
│ │ │ │ │ -00004bd0: 6b6f 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ko.*************
│ │ │ │ │ -00004be0: 2a0a 0a54 6869 7320 6368 6170 7465 7220  *..This chapter 
│ │ │ │ │ -00004bf0: 7072 6f76 6964 6573 2074 6865 2022 686f  provides the "ho
│ │ │ │ │ -00004c00: 7774 6f22 2066 6f72 2075 7369 6e67 206c  wto" for using l
│ │ │ │ │ -00004c10: 6962 666b 6f2c 2069 6e63 6c75 6469 6e67  ibfko, including
│ │ │ │ │ -00004c20: 2072 6571 7569 7265 640a 6675 6e63 7469   required.functi
│ │ │ │ │ -00004c30: 6f6e 7320 616e 6420 7061 7261 6d65 7465  ons and paramete
│ │ │ │ │ -00004c40: 7220 6368 6f69 6365 732e 2020 496e 2073  r choices.  In s
│ │ │ │ │ -00004c50: 6f6d 6520 7365 6374 696f 6e73 2c20 636f  ome sections, co
│ │ │ │ │ -00004c60: 6465 2073 616d 706c 6573 2061 7265 0a70  de samples are.p
│ │ │ │ │ -00004c70: 726f 7669 6465 6420 746f 2066 7572 7468  rovided to furth
│ │ │ │ │ -00004c80: 6572 2069 6c6c 7573 7472 6174 6520 7573  er illustrate us
│ │ │ │ │ -00004c90: 6167 652e 0a0a 2a20 4d65 6e75 3a0a 0a2a  age...* Menu:..*
│ │ │ │ │ -00004ca0: 2043 7265 6174 696e 6720 436f 6e74 6578   Creating Contex
│ │ │ │ │ -00004cb0: 7473 3a3a 2020 2020 2020 2020 2020 2020  ts::            
│ │ │ │ │ -00004cc0: 2043 7265 6174 696e 6720 6120 6e65 7720   Creating a new 
│ │ │ │ │ -00004cd0: 666b 6f20 636f 6e74 6578 740a 2a20 4465  fko context.* De
│ │ │ │ │ -00004ce0: 7374 726f 7969 6e67 2043 6f6e 7465 7874  stroying Context
│ │ │ │ │ -00004cf0: 733a 3a20 2020 2020 2020 2020 2020 5265  s::           Re
│ │ │ │ │ -00004d00: 6c65 6173 696e 6720 616e 2066 6b6f 2063  leasing an fko c
│ │ │ │ │ -00004d10: 6f6e 7465 7874 0a2a 2043 7265 6174 696e  ontext.* Creatin
│ │ │ │ │ -00004d20: 6720 6120 5350 4120 4d65 7373 6167 653a  g a SPA Message:
│ │ │ │ │ -00004d30: 3a20 2020 2020 2020 2057 6861 7420 6974  :        What it
│ │ │ │ │ -00004d40: 2074 616b 6573 2074 6f20 6372 6561 7465   takes to create
│ │ │ │ │ -00004d50: 2061 2053 5041 0a20 2020 2020 2020 2020   a SPA.         
│ │ │ │ │ +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.           
│ │ │ │ │  00004d60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00004d70: 2020 2020 2020 2020 206d 6573 7361 6765           message
│ │ │ │ │ -00004d80: 0a2a 2053 6574 7469 6e67 2053 5041 2044  .* Setting SPA D
│ │ │ │ │ -00004d90: 6174 613a 3a20 2020 2020 2020 2020 2020  ata::           
│ │ │ │ │ -00004da0: 2020 2053 6574 7469 6e67 2053 5041 2064     Setting SPA d
│ │ │ │ │ -00004db0: 6174 610a 2a20 5265 7472 6965 7669 6e67  ata.* Retrieving
│ │ │ │ │ -00004dc0: 2053 5041 2044 6174 613a 3a20 2020 2020   SPA Data::     
│ │ │ │ │ -00004dd0: 2020 2020 2020 5265 7472 6965 7669 6e67        Retrieving
│ │ │ │ │ -00004de0: 2053 5041 2064 6174 610a 2a20 5574 696c   SPA data.* Util
│ │ │ │ │ -00004df0: 6974 7920 4675 6e63 7469 6f6e 733a 3a20  ity Functions:: 
│ │ │ │ │ -00004e00: 2020 2020 2020 2020 2020 2020 4f74 6865              Othe
│ │ │ │ │ -00004e10: 7220 7574 696c 6974 792c 206d 6973 6365  r utility, misce
│ │ │ │ │ -00004e20: 6c6c 616e 656f 7573 2c20 616e 6420 7365  llaneous, and se
│ │ │ │ │ -00004e30: 6c64 6f6d 0a20 2020 2020 2020 2020 2020  ldom.           
│ │ │ │ │ +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.             
│ │ │ │ │  00004e40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00004e50: 2020 2020 2020 2075 7365 6420 6675 6e63         used func
│ │ │ │ │ -00004e60: 7469 6f6e 730a 2a20 4572 726f 7220 4861  tions.* Error Ha
│ │ │ │ │ -00004e70: 6e64 6c69 6e67 3a3a 2020 2020 2020 2020  ndling::        
│ │ │ │ │ -00004e80: 2020 2020 2020 2020 506f 7373 6962 6c65          Possible
│ │ │ │ │ -00004e90: 2065 7272 6f72 7320 616e 6420 7468 6569   errors and thei
│ │ │ │ │ -00004ea0: 7220 6d65 616e 696e 670a 0a1f 0a46 696c  r meaning....Fil
│ │ │ │ │ -00004eb0: 653a 206c 6962 666b 6f2e 696e 666f 2c20  e: libfko.info, 
│ │ │ │ │ -00004ec0: 204e 6f64 653a 2043 7265 6174 696e 6720   Node: Creating 
│ │ │ │ │ -00004ed0: 436f 6e74 6578 7473 2c20 204e 6578 743a  Contexts,  Next:
│ │ │ │ │ -00004ee0: 2044 6573 7472 6f79 696e 6720 436f 6e74   Destroying Cont
│ │ │ │ │ -00004ef0: 6578 7473 2c20 2055 703a 2055 7369 6e67  exts,  Up: Using
│ │ │ │ │ -00004f00: 206c 6962 666b 6f0a 0a33 2e31 2043 7265   libfko..3.1 Cre
│ │ │ │ │ -00004f10: 6174 696e 6720 436f 6e74 6578 7473 0a3d  ating Contexts.=
│ │ │ │ │ +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.===
│ │ │ │ │  00004f20: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ │ -00004f30: 3d3d 3d3d 0a0a 4265 666f 7265 2064 6f69  ====..Before doi
│ │ │ │ │ -00004f40: 6e67 2061 6e79 7468 696e 6720 7769 7468  ng anything with
│ │ │ │ │ -00004f50: 206c 6962 666b 6f2c 2079 6f75 206e 6565   libfko, you nee
│ │ │ │ │ -00004f60: 6420 746f 2063 7265 6174 6520 6120 636f  d to create a co
│ │ │ │ │ -00004f70: 6e74 6578 742e 2020 410a 636f 6e74 6578  ntext.  A.contex
│ │ │ │ │ -00004f80: 7420 6973 2063 7265 6174 6564 2066 6f72  t is created for
│ │ │ │ │ -00004f90: 206f 6e65 206f 6620 7477 6f20 7265 6173   one of two reas
│ │ │ │ │ -00004fa0: 6f6e 732e 2020 4f6e 6520 6973 2066 6f72  ons.  One is for
│ │ │ │ │ -00004fb0: 2074 6865 2070 7572 706f 7365 206f 660a   the purpose of.
│ │ │ │ │ -00004fc0: 6275 696c 6469 6e67 2061 206e 6577 2066  building a new f
│ │ │ │ │ -00004fd0: 6b6f 2053 5041 206d 6573 7361 6765 2066  ko SPA message f
│ │ │ │ │ -00004fe0: 726f 6d20 7363 7261 7463 6820 2874 7970  rom scratch (typ
│ │ │ │ │ -00004ff0: 6963 616c 6c79 2074 6f20 6265 2070 6163  ically to be pac
│ │ │ │ │ -00005000: 6b61 6765 640a 616e 6420 7365 6e74 2074  kaged.and sent t
│ │ │ │ │ -00005010: 6f20 616e 2066 776b 6e6f 7020 7365 7276  o an fwknop serv
│ │ │ │ │ -00005020: 6572 2073 6f6d 6577 6865 7265 292e 2020  er somewhere).  
│ │ │ │ │ -00005030: 5468 6520 6f74 6865 7220 776f 756c 6420  The other would 
│ │ │ │ │ -00005040: 6265 2061 2063 6f6e 7465 7874 0a66 6f72  be a context.for
│ │ │ │ │ -00005050: 2074 616b 696e 6720 616e 2065 7869 7374   taking an exist
│ │ │ │ │ -00005060: 696e 6720 5350 4120 6d65 7373 6167 6520  ing SPA message 
│ │ │ │ │ -00005070: 666f 7220 6465 636f 6469 6e67 2c20 7061  for decoding, pa
│ │ │ │ │ -00005080: 7273 696e 672c 2061 6e64 2064 6174 610a  rsing, and data.
│ │ │ │ │ -00005090: 6578 7472 6163 7469 6f6e 2e0a 0a46 6f72  extraction...For
│ │ │ │ │ -000050a0: 2062 7569 6c64 696e 6720 6120 6e65 7720   building a new 
│ │ │ │ │ -000050b0: 666b 6f20 5350 4120 6d65 7373 6167 652c  fko SPA message,
│ │ │ │ │ -000050c0: 2079 6f75 2077 696c 6c20 7573 6520 7468   you will use th
│ │ │ │ │ -000050d0: 6520 2766 6b6f 5f6e 6577 2720 6675 6e63  e 'fko_new' func
│ │ │ │ │ -000050e0: 7469 6f6e 3a0a 0a20 2d2d 2046 756e 6374  tion:.. -- Funct
│ │ │ │ │ -000050f0: 696f 6e3a 2069 6e74 2066 6b6f 5f6e 6577  ion: int fko_new
│ │ │ │ │ -00005100: 2028 666b 6f5f 6374 785f 7420 2a43 5458   (fko_ctx_t *CTX
│ │ │ │ │ -00005110: 290a 2020 2020 2054 6865 2066 756e 6374  ).     The funct
│ │ │ │ │ -00005120: 696f 6e20 2766 6b6f 5f6e 6577 2720 7365  ion 'fko_new' se
│ │ │ │ │ -00005130: 7473 2075 7020 616e 6420 696e 6974 6961  ts up and initia
│ │ │ │ │ -00005140: 6c69 7a65 7320 6120 6e65 7720 2766 6b6f  lizes a new 'fko
│ │ │ │ │ -00005150: 5f63 7478 5f74 270a 2020 2020 206f 626a  _ctx_t'.     obj
│ │ │ │ │ -00005160: 6563 742c 2070 7265 2d70 6f70 756c 6174  ect, pre-populat
│ │ │ │ │ -00005170: 6573 2064 6566 6175 6c74 2076 616c 7565  es default value
│ │ │ │ │ -00005180: 7320 616e 6420 7265 7475 726e 7320 6120  s and returns a 
│ │ │ │ │ -00005190: 6861 6e64 6c65 2066 6f72 2069 7420 696e  handle for it in
│ │ │ │ │ -000051a0: 0a20 2020 2020 4354 582e 2020 5468 6520  .     CTX.  The 
│ │ │ │ │ -000051b0: 6675 6e63 7469 6f6e 2072 6574 7572 6e73  function returns
│ │ │ │ │ -000051c0: 2074 6865 2065 7272 6f72 2063 6f64 6520   the error code 
│ │ │ │ │ -000051d0: 2746 4b4f 5f53 5543 4345 5353 2720 6966  'FKO_SUCCESS' if
│ │ │ │ │ -000051e0: 2074 6865 0a20 2020 2020 636f 6e74 6578   the.     contex
│ │ │ │ │ -000051f0: 7420 7761 7320 7375 6363 6573 7366 756c  t was successful
│ │ │ │ │ -00005200: 6c79 2063 7265 6174 6564 2e20 204f 7468  ly created.  Oth
│ │ │ │ │ -00005210: 6572 7769 7365 2061 6e20 616e 6f74 6865  erwise an anothe
│ │ │ │ │ -00005220: 7220 6572 726f 7220 636f 6465 0a20 2020  r error code.   
│ │ │ │ │ -00005230: 2020 7769 6c6c 2062 6520 7265 7475 726e    will be return
│ │ │ │ │ -00005240: 6564 2028 2a6e 6f74 6520 4572 726f 7220  ed (*note Error 
│ │ │ │ │ -00005250: 4861 6e64 6c69 6e67 3a3a 2066 6f72 2064  Handling:: for d
│ │ │ │ │ -00005260: 6574 6169 6c73 206f 6e20 7468 6520 7661  etails on the va
│ │ │ │ │ -00005270: 7269 6f75 730a 2020 2020 2065 7272 6f72  rious.     error
│ │ │ │ │ -00005280: 2063 6f64 6573 2061 6e64 2074 6865 6972   codes and their
│ │ │ │ │ -00005290: 206d 6561 6e69 6e67 7329 2e0a 0a20 2020   meanings)...   
│ │ │ │ │ -000052a0: 2020 666b 6f5f 6374 785f 7420 2020 6374    fko_ctx_t   ct
│ │ │ │ │ -000052b0: 783b 0a20 2020 2020 696e 7420 2020 2020  x;.     int     
│ │ │ │ │ -000052c0: 2020 2020 7263 3b0a 0a20 2020 2020 7263      rc;..     rc
│ │ │ │ │ -000052d0: 203d 2066 6b6f 5f6e 6577 2826 6374 7829   = fko_new(&ctx)
│ │ │ │ │ -000052e0: 3b0a 0a20 2020 2020 6966 2872 6320 213d  ;..     if(rc !=
│ │ │ │ │ -000052f0: 2046 4b4f 5f53 5543 4345 5353 290a 2020   FKO_SUCCESS).  
│ │ │ │ │ -00005300: 2020 207b 0a20 2020 2020 2020 2020 6670     {.         fp
│ │ │ │ │ -00005310: 7269 6e74 6628 7374 6465 7272 2c20 2245  rintf(stderr, "E
│ │ │ │ │ -00005320: 7272 6f72 2025 6920 6672 6f6d 2066 6b6f  rror %i from fko
│ │ │ │ │ -00005330: 5f6e 6577 3a20 2573 5c6e 222c 0a20 2020  _new: %s\n",.   
│ │ │ │ │ -00005340: 2020 2020 2020 2020 2020 7263 2c20 666b            rc, fk
│ │ │ │ │ -00005350: 6f5f 6572 7273 7472 2872 6329 293b 0a20  o_errstr(rc));. 
│ │ │ │ │ -00005360: 2020 2020 2020 2020 6578 6974 2831 293b          exit(1);
│ │ │ │ │ -00005370: 0a20 2020 2020 7d0a 0a46 6f72 2061 2063  .     }..For a c
│ │ │ │ │ -00005380: 6f6e 7465 7874 2074 6861 7420 7769 6c6c  ontext that will
│ │ │ │ │ -00005390: 2062 6520 7573 6564 2066 6f72 2072 6563   be used for rec
│ │ │ │ │ -000053a0: 6569 7669 6e67 2061 6e64 2070 6172 7369  eiving and parsi
│ │ │ │ │ -000053b0: 6e67 2061 6e20 6578 6973 7469 6e67 0a53  ng an existing.S
│ │ │ │ │ -000053c0: 5041 206d 6573 7361 6765 2c20 796f 7520  PA message, you 
│ │ │ │ │ -000053d0: 7769 6c6c 2075 7365 2074 6865 2027 666b  will use the 'fk
│ │ │ │ │ -000053e0: 6f5f 6e65 775f 7769 7468 5f64 6174 6127  o_new_with_data'
│ │ │ │ │ -000053f0: 2066 756e 6374 696f 6e3a 0a0a 202d 2d20   function:.. -- 
│ │ │ │ │ -00005400: 4675 6e63 7469 6f6e 3a20 696e 7420 666b  Function: int fk
│ │ │ │ │ -00005410: 6f5f 6e65 775f 7769 7468 5f64 6174 6120  o_new_with_data 
│ │ │ │ │ -00005420: 2866 6b6f 5f63 7478 5f74 202a 4354 582c  (fko_ctx_t *CTX,
│ │ │ │ │ -00005430: 2063 6f6e 7374 2063 6861 7220 2a44 4154   const char *DAT
│ │ │ │ │ -00005440: 412c 0a20 2020 2020 2020 2020 2063 6f6e  A,.          con
│ │ │ │ │ -00005450: 7374 2063 6861 7220 2a4b 4559 2c20 636f  st char *KEY, co
│ │ │ │ │ -00005460: 6e73 7420 6368 6172 204b 4559 5f4c 454e  nst char KEY_LEN
│ │ │ │ │ -00005470: 2c20 696e 7420 454e 4352 5950 5449 4f4e  , int ENCRYPTION
│ │ │ │ │ -00005480: 5f4d 4f44 452c 0a20 2020 2020 2020 2020  _MODE,.         
│ │ │ │ │ -00005490: 2063 6f6e 7374 2063 6861 7220 484d 4143   const char HMAC
│ │ │ │ │ -000054a0: 5f4b 4559 2c20 636f 6e73 7420 696e 7420  _KEY, const int 
│ │ │ │ │ -000054b0: 484d 4143 5f54 5950 4529 0a0a 2020 2020  HMAC_TYPE)..    
│ │ │ │ │ -000054c0: 2054 6865 2066 756e 6374 696f 6e20 2766   The function 'f
│ │ │ │ │ -000054d0: 6b6f 5f6e 6577 5f77 6974 685f 6461 7461  ko_new_with_data
│ │ │ │ │ -000054e0: 2720 7365 7473 2075 7020 616e 6420 696e  ' sets up and in
│ │ │ │ │ -000054f0: 6974 6961 6c69 7a65 7320 6120 6e65 770a  itializes a new.
│ │ │ │ │ -00005500: 2020 2020 2027 666b 6f5f 6374 785f 7427       'fko_ctx_t'
│ │ │ │ │ -00005510: 2063 6f6e 7465 7874 2c20 6275 7420 696e   context, but in
│ │ │ │ │ -00005520: 7374 6561 6420 6f66 2069 6e69 7469 616c  stead of initial
│ │ │ │ │ -00005530: 697a 696e 6720 6465 6661 756c 7420 7661  izing default va
│ │ │ │ │ -00005540: 6c75 6573 2c20 6974 0a20 2020 2020 7374  lues, it.     st
│ │ │ │ │ -00005550: 6f72 6573 2074 6865 2065 6e63 7279 7074  ores the encrypt
│ │ │ │ │ -00005560: 6564 206d 6573 7361 6765 2064 6174 6120  ed message data 
│ │ │ │ │ -00005570: 616e 6420 6d61 6b65 7320 6974 2072 6561  and makes it rea
│ │ │ │ │ -00005580: 6479 2066 6f72 2070 6172 7369 6e67 2e0a  dy for parsing..
│ │ │ │ │ -00005590: 2020 2020 2054 6869 7320 6361 6e20 6265       This can be
│ │ │ │ │ -000055a0: 2064 6f6e 6520 696e 206f 6e65 206f 6620   done in one of 
│ │ │ │ │ -000055b0: 7477 6f20 7761 7973 2e20 204f 6e65 2069  two ways.  One i
│ │ │ │ │ -000055c0: 7320 746f 2070 6173 7320 274e 554c 4c27  s to pass 'NULL'
│ │ │ │ │ -000055d0: 2066 6f72 2074 6865 0a20 2020 2020 7468   for the.     th
│ │ │ │ │ -000055e0: 6972 6420 6172 6775 6d65 6e74 2e20 2054  ird argument.  T
│ │ │ │ │ -000055f0: 6865 2063 6f6e 7465 7874 2077 696c 6c20  he context will 
│ │ │ │ │ -00005600: 6265 2063 7265 6174 6564 2061 6e64 2074  be created and t
│ │ │ │ │ -00005610: 6865 2064 6174 6120 7769 6c6c 2062 650a  he data will be.
│ │ │ │ │ -00005620: 2020 2020 2073 746f 7265 642c 2062 7574       stored, but
│ │ │ │ │ -00005630: 206e 6f20 6465 6372 7970 7469 6f6e 206f   no decryption o
│ │ │ │ │ -00005640: 7220 6465 636f 6469 6e67 2074 616b 6573  r decoding takes
│ │ │ │ │ -00005650: 2070 6c61 6365 2e20 2049 6e20 7468 6973   place.  In this
│ │ │ │ │ -00005660: 2063 6173 652c 0a20 2020 2020 796f 7520   case,.     you 
│ │ │ │ │ -00005670: 7769 6c6c 206e 6565 6420 746f 2063 616c  will need to cal
│ │ │ │ │ -00005680: 6c20 2766 6b6f 5f64 6563 7279 7074 5f73  l 'fko_decrypt_s
│ │ │ │ │ -00005690: 7061 5f64 6174 6127 2061 7420 6120 6c61  pa_data' at a la
│ │ │ │ │ -000056a0: 7465 7220 7469 6d65 2e20 2054 6865 0a20  ter time.  The. 
│ │ │ │ │ -000056b0: 2020 2020 6f74 6865 7220 7761 7920 746f      other way to
│ │ │ │ │ -000056c0: 2064 6f20 6974 2069 7320 746f 2073 7570   do it is to sup
│ │ │ │ │ -000056d0: 706c 7920 7468 6520 4b45 5920 7661 6c75  ply the KEY valu
│ │ │ │ │ -000056e0: 6520 2864 6563 7279 7074 696f 6e0a 2020  e (decryption.  
│ │ │ │ │ -000056f0: 2020 2070 6173 7370 6872 6173 6529 2061     passphrase) a
│ │ │ │ │ -00005700: 6e64 2061 7373 6f63 6174 6564 206c 656e  nd assocated len
│ │ │ │ │ -00005710: 6774 682e 2020 496e 2074 6869 7320 6361  gth.  In this ca
│ │ │ │ │ -00005720: 7365 2c20 7468 6520 636f 6e74 6578 7420  se, the context 
│ │ │ │ │ -00005730: 6973 0a20 2020 2020 6372 6561 7465 642c  is.     created,
│ │ │ │ │ -00005740: 2074 6865 2053 5041 2064 6174 6120 6973   the SPA data is
│ │ │ │ │ -00005750: 2064 6563 7279 7074 6564 2c20 6465 636f   decrypted, deco
│ │ │ │ │ -00005760: 6465 642c 2070 6172 7365 642c 2061 6e64  ded, parsed, and
│ │ │ │ │ -00005770: 2073 746f 7265 6420 696e 0a20 2020 2020   stored in.     
│ │ │ │ │ -00005780: 7468 6520 636f 6e74 6578 7420 7265 6164  the context read
│ │ │ │ │ -00005790: 7920 666f 7220 7265 7472 6965 7661 6c2e  y for retrieval.
│ │ │ │ │ -000057a0: 2020 4966 2061 6e20 484d 4143 2069 7320    If an HMAC is 
│ │ │ │ │ -000057b0: 616c 736f 2064 6573 6972 6564 206f 720a  also desired or.
│ │ │ │ │ -000057c0: 2020 2020 2072 6571 7569 7265 642c 2074       required, t
│ │ │ │ │ -000057d0: 6865 6e20 7468 6520 484d 4143 5f4b 4559  hen the HMAC_KEY
│ │ │ │ │ -000057e0: 2061 6e64 2061 7373 6f63 6961 7465 6420   and associated 
│ │ │ │ │ -000057f0: 6c65 6e67 7468 2063 616e 2062 6520 7061  length can be pa
│ │ │ │ │ -00005800: 7373 6564 2069 6e2e 0a20 2020 2020 5468  ssed in..     Th
│ │ │ │ │ -00005810: 6973 2077 696c 6c20 6361 7573 6520 6c69  is will cause li
│ │ │ │ │ -00005820: 6266 6b6f 2074 6f20 6175 7468 656e 7469  bfko to authenti
│ │ │ │ │ -00005830: 6361 7465 2074 6865 2053 5041 2064 6174  cate the SPA dat
│ │ │ │ │ -00005840: 6120 6265 666f 7265 0a20 2020 2020 6465  a before.     de
│ │ │ │ │ -00005850: 6372 7970 7469 6f6e 2069 7320 6174 7465  cryption is atte
│ │ │ │ │ -00005860: 6d70 7465 642c 2061 6e64 2074 6869 7320  mpted, and this 
│ │ │ │ │ -00005870: 6973 2073 7472 6f6e 676c 7920 7265 636f  is strongly reco
│ │ │ │ │ -00005880: 6d6d 656e 6465 6420 746f 2064 6f2e 0a0a  mmended to do...
│ │ │ │ │ -00005890: 2020 2020 2054 6865 2027 666b 6f5f 6e65       The 'fko_ne
│ │ │ │ │ -000058a0: 775f 7769 7468 5f64 6174 6127 2066 756e  w_with_data' fun
│ │ │ │ │ -000058b0: 6374 696f 6e20 7265 7475 726e 7320 7468  ction returns th
│ │ │ │ │ -000058c0: 6520 6572 726f 7220 636f 6465 0a20 2020  e error code.   
│ │ │ │ │ -000058d0: 2020 2746 4b4f 5f53 5543 4345 5353 2720    'FKO_SUCCESS' 
│ │ │ │ │ -000058e0: 6966 2074 6865 2063 6f6e 7465 7874 2077  if the context w
│ │ │ │ │ -000058f0: 6173 2073 7563 6365 7373 6675 6c6c 7920  as successfully 
│ │ │ │ │ -00005900: 6372 6561 7465 642e 2020 4966 2061 6e79  created.  If any
│ │ │ │ │ -00005910: 206f 660a 2020 2020 2074 6865 2069 6e74   of.     the int
│ │ │ │ │ -00005920: 6572 6d65 6469 6174 6520 7374 6570 7320  ermediate steps 
│ │ │ │ │ -00005930: 696e 2070 6172 7369 6e67 2074 6865 2064  in parsing the d
│ │ │ │ │ -00005940: 6174 612c 2076 616c 6964 6174 696e 6720  ata, validating 
│ │ │ │ │ -00005950: 7468 6520 5350 410a 2020 2020 206d 6573  the SPA.     mes
│ │ │ │ │ -00005960: 7361 6765 2064 6967 6573 742c 206f 7220  sage digest, or 
│ │ │ │ │ -00005970: 616e 7920 6f74 6865 7220 696e 7465 726e  any other intern
│ │ │ │ │ -00005980: 616c 2061 6374 696f 6e20 6661 696c 732c  al action fails,
│ │ │ │ │ -00005990: 2074 6865 6e20 7468 650a 2020 2020 2061   then the.     a
│ │ │ │ │ -000059a0: 7070 726f 7072 6961 7465 2065 7272 6f72  ppropriate error
│ │ │ │ │ -000059b0: 2063 6f64 6520 6973 2072 6574 7572 6e65   code is returne
│ │ │ │ │ -000059c0: 642e 0a0a 5468 6520 6d6f 7374 2063 6f6d  d...The most com
│ │ │ │ │ -000059d0: 6d6f 6e20 2873 696d 706c 6529 2063 6173  mon (simple) cas
│ │ │ │ │ -000059e0: 652e 2e2e 0a0a 2020 2020 2066 6b6f 5f63  e.....     fko_c
│ │ │ │ │ -000059f0: 7478 5f74 2020 2063 7478 3b0a 2020 2020  tx_t   ctx;.    
│ │ │ │ │ -00005a00: 2063 6861 7220 2020 2020 2020 2a73 7061   char       *spa
│ │ │ │ │ -00005a10: 5f64 6174 613b 0a20 2020 2020 6368 6172  _data;.     char
│ │ │ │ │ -00005a20: 2020 2020 2020 202a 6b65 793b 0a20 2020         *key;.   
│ │ │ │ │ -00005a30: 2020 696e 7420 2020 2020 2020 2020 6b65    int         ke
│ │ │ │ │ -00005a40: 795f 6c65 6e3b 0a20 2020 2020 6368 6172  y_len;.     char
│ │ │ │ │ -00005a50: 2020 2020 2020 202a 686d 6163 5f6b 6579         *hmac_key
│ │ │ │ │ -00005a60: 3b0a 2020 2020 2069 6e74 2020 2020 2020  ;.     int      
│ │ │ │ │ -00005a70: 2020 2068 6d61 635f 6b65 795f 6c65 6e3b     hmac_key_len;
│ │ │ │ │ -00005a80: 0a20 2020 2020 696e 7420 2020 2020 2020  .     int       
│ │ │ │ │ -00005a90: 2020 686d 6163 5f74 7970 6520 3d20 464b    hmac_type = FK
│ │ │ │ │ -00005aa0: 4f5f 484d 4143 5f53 4841 3235 363b 0a20  O_HMAC_SHA256;. 
│ │ │ │ │ -00005ab0: 2020 2020 696e 7420 2020 2020 2020 2020      int         
│ │ │ │ │ -00005ac0: 656e 635f 6d6f 6465 2020 3d20 464b 4f5f  enc_mode  = FKO_
│ │ │ │ │ -00005ad0: 454e 435f 4d4f 4445 5f43 4243 3b0a 2020  ENC_MODE_CBC;.  
│ │ │ │ │ -00005ae0: 2020 2069 6e74 2072 633b 0a0a 2020 2020     int rc;..    
│ │ │ │ │ -00005af0: 202f 2a20 4173 7375 6d65 2077 6520 6361   /* Assume we ca
│ │ │ │ │ -00005b00: 6c6c 6564 2063 6f64 6520 7468 6174 2072  lled code that r
│ │ │ │ │ -00005b10: 6574 7269 6576 6573 2074 6865 2064 6174  etrieves the dat
│ │ │ │ │ -00005b20: 6120 616e 6420 6b65 790a 2020 2020 202a  a and key.     *
│ │ │ │ │ -00005b30: 2f0a 0a20 2020 2020 7263 203d 2066 6b6f  /..     rc = fko
│ │ │ │ │ -00005b40: 5f6e 6577 5f77 6974 685f 6461 7461 2826  _new_with_data(&
│ │ │ │ │ -00005b50: 6374 782c 2073 7061 5f64 6174 612c 206b  ctx, spa_data, k
│ │ │ │ │ -00005b60: 6579 2c20 6b65 795f 6c65 6e2c 205c 5c0a  ey, key_len, \\.
│ │ │ │ │ -00005b70: 2020 2020 2020 2020 2065 6e63 5f6d 6f64           enc_mod
│ │ │ │ │ -00005b80: 652c 2068 6d61 635f 6b65 792c 2068 6d61  e, hmac_key, hma
│ │ │ │ │ -00005b90: 635f 6b65 795f 6c65 6e2c 2068 6d61 635f  c_key_len, hmac_
│ │ │ │ │ -00005ba0: 7479 7065 293b 0a0a 2020 2020 2069 6628  type);..     if(
│ │ │ │ │ -00005bb0: 7263 2021 3d20 464b 4f5f 5355 4343 4553  rc != FKO_SUCCES
│ │ │ │ │ -00005bc0: 5329 0a20 2020 2020 7b0a 2020 2020 2020  S).     {.      
│ │ │ │ │ -00005bd0: 2020 2066 7072 696e 7466 2873 7464 6572     fprintf(stder
│ │ │ │ │ -00005be0: 722c 2022 4572 726f 7220 2569 2066 726f  r, "Error %i fro
│ │ │ │ │ -00005bf0: 6d20 666b 6f5f 6e65 775f 7769 7468 5f64  m fko_new_with_d
│ │ │ │ │ -00005c00: 6174 613a 2025 735c 6e22 2c0a 2020 2020  ata: %s\n",.    
│ │ │ │ │ -00005c10: 2020 2020 2020 2020 2072 632c 2066 6b6f           rc, fko
│ │ │ │ │ -00005c20: 6572 7273 7472 2872 6329 293b 0a20 2020  errstr(rc));.   
│ │ │ │ │ -00005c30: 2020 2020 2020 6578 6974 2831 293b 0a20        exit(1);. 
│ │ │ │ │ -00005c40: 2020 2020 7d0a 0a4f 722c 2070 6572 6861      }..Or, perha
│ │ │ │ │ -00005c50: 7073 2079 6f75 206e 6565 6420 746f 2064  ps you need to d
│ │ │ │ │ -00005c60: 6566 6572 2064 6563 7279 7074 696f 6e20  efer decryption 
│ │ │ │ │ -00005c70: 616e 6420 7061 7273 696e 6720 746f 2061  and parsing to a
│ │ │ │ │ -00005c80: 206c 6174 6572 2070 6f69 6e74 2069 6e0a   later point in.
│ │ │ │ │ -00005c90: 7468 6520 7072 6f67 7261 6d2e 2020 5765  the program.  We
│ │ │ │ │ -00005ca0: 2063 6f75 6c64 2075 7365 2066 6b6f 5f6e   could use fko_n
│ │ │ │ │ -00005cb0: 6577 5f77 6974 685f 6461 7461 2829 2c20  ew_with_data(), 
│ │ │ │ │ -00005cc0: 7061 7373 696e 6720 4e55 4c4c 2066 6f72  passing NULL for
│ │ │ │ │ -00005cd0: 2074 6865 0a64 6563 7279 7074 696f 6e20   the.decryption 
│ │ │ │ │ -00005ce0: 6b65 7920 616e 6420 484d 4143 206b 6579  key and HMAC key
│ │ │ │ │ -00005cf0: 732c 206f 7220 7765 2063 6f75 6c64 2075  s, or we could u
│ │ │ │ │ -00005d00: 7365 2066 6b6f 5f6e 6577 2829 2074 6f20  se fko_new() to 
│ │ │ │ │ -00005d10: 6372 6561 7465 2061 6e0a 656d 7074 7920  create an.empty 
│ │ │ │ │ -00005d20: 636f 6e74 6578 742c 2074 6865 6e20 7573  context, then us
│ │ │ │ │ -00005d30: 6520 666b 6f5f 7365 745f 7370 615f 6461  e fko_set_spa_da
│ │ │ │ │ -00005d40: 7461 2829 2074 6f20 6164 6420 7468 6520  ta() to add the 
│ │ │ │ │ -00005d50: 656e 6379 7074 6564 2064 6174 6120 2873  encypted data (s
│ │ │ │ │ -00005d60: 6565 0a63 6f6d 6d65 6e74 7320 696e 2074  ee.comments in t
│ │ │ │ │ -00005d70: 6865 2063 6f64 6520 7361 6d70 6c65 7329  he code samples)
│ │ │ │ │ -00005d80: 2e0a 0a20 2020 2020 666b 6f5f 6374 785f  ...     fko_ctx_
│ │ │ │ │ -00005d90: 7420 2020 6374 783b 0a20 2020 2020 6368  t   ctx;.     ch
│ │ │ │ │ -00005da0: 6172 2020 2020 2020 202a 7370 615f 6461  ar       *spa_da
│ │ │ │ │ -00005db0: 7461 3b0a 2020 2020 2063 6861 7220 2020  ta;.     char   
│ │ │ │ │ -00005dc0: 2020 2020 2a6b 6579 3b0a 2020 2020 2069      *key;.     i
│ │ │ │ │ -00005dd0: 6e74 2072 633b 0a0a 2020 2020 202f 2a20  nt rc;..     /* 
│ │ │ │ │ -00005de0: 4173 7375 6d65 2077 6520 6361 6c6c 6564  Assume we called
│ │ │ │ │ -00005df0: 2063 6f64 6520 7468 6174 2072 6574 7269   code that retri
│ │ │ │ │ -00005e00: 6576 6573 2074 6865 2064 6174 6120 616e  eves the data an
│ │ │ │ │ -00005e10: 6420 6b65 790a 2020 2020 202a 2f0a 0a20  d key.     */.. 
│ │ │ │ │ -00005e20: 2020 2020 7263 203d 2066 6b6f 5f6e 6577      rc = fko_new
│ │ │ │ │ -00005e30: 5f77 6974 685f 6461 7461 2826 6374 782c  _with_data(&ctx,
│ │ │ │ │ -00005e40: 2073 7061 5f64 6174 612c 204e 554c 4c2c   spa_data, NULL,
│ │ │ │ │ -00005e50: 2030 2c0a 2020 2020 2020 2020 2020 2020   0,.            
│ │ │ │ │ -00005e60: 2046 4b4f 5f45 4e43 5f4d 4f44 455f 4342   FKO_ENC_MODE_CB
│ │ │ │ │ -00005e70: 432c 204e 554c 4c2c 2030 2c20 464b 4f5f  C, NULL, 0, FKO_
│ │ │ │ │ -00005e80: 484d 4143 5f53 4841 3235 3629 3b0a 0a20  HMAC_SHA256);.. 
│ │ │ │ │ -00005e90: 2020 2020 6966 2872 6320 213d 2046 4b4f      if(rc != FKO
│ │ │ │ │ -00005ea0: 5f53 5543 4345 5353 290a 2020 2020 207b  _SUCCESS).     {
│ │ │ │ │ -00005eb0: 0a20 2020 2020 2020 2020 6670 7269 6e74  .         fprint
│ │ │ │ │ -00005ec0: 6628 7374 6465 7272 2c20 2245 7272 6f72  f(stderr, "Error
│ │ │ │ │ -00005ed0: 2066 726f 6d20 666b 6f5f 6e65 775f 7769   from fko_new_wi
│ │ │ │ │ -00005ee0: 7468 5f64 6174 613a 2025 735c 6e22 2c0a  th_data: %s\n",.
│ │ │ │ │ -00005ef0: 2020 2020 2020 2020 2020 2020 2066 6b6f               fko
│ │ │ │ │ -00005f00: 5f65 7272 7374 7228 7263 2929 3b0a 2020  _errstr(rc));.  
│ │ │ │ │ -00005f10: 2020 2020 2020 2065 7869 7428 3129 3b0a         exit(1);.
│ │ │ │ │ -00005f20: 2020 2020 207d 0a0a 2020 2020 202f 2a20       }..     /* 
│ │ │ │ │ -00005f30: 5765 2063 6f75 6c64 2061 6c73 6f20 6a75  We could also ju
│ │ │ │ │ -00005f40: 7374 2063 7265 6174 6520 616e 6420 656d  st create and em
│ │ │ │ │ -00005f50: 7074 7920 636f 6e74 6578 7420 616e 6420  pty context and 
│ │ │ │ │ -00005f60: 6164 6420 7468 650a 2020 2020 2020 2a20  add the.      * 
│ │ │ │ │ -00005f70: 656e 6372 7970 7465 6420 6461 7461 2061  encrypted data a
│ │ │ │ │ -00005f80: 7320 666f 6c6c 6f77 733a 0a20 2020 2020  s follows:.     
│ │ │ │ │ -00005f90: 202a 0a20 2020 2020 202a 2072 6320 3d20   *.      * rc = 
│ │ │ │ │ -00005fa0: 666b 6f5f 6e65 7728 2663 7478 293b 0a20  fko_new(&ctx);. 
│ │ │ │ │ -00005fb0: 2020 2020 202a 202e 2e2e 2063 6865 636b       * ... check
│ │ │ │ │ -00005fc0: 2072 6320 2e2e 2e0a 2020 2020 2020 2a20   rc ....      * 
│ │ │ │ │ -00005fd0: 7263 203d 2066 6b6f 5f73 6574 5f73 7061  rc = fko_set_spa
│ │ │ │ │ -00005fe0: 5f64 6174 6128 6374 782c 2073 7061 5f64  _data(ctx, spa_d
│ │ │ │ │ -00005ff0: 6174 6129 3b0a 2020 2020 2020 2a20 2e2e  ata);.      * ..
│ │ │ │ │ -00006000: 2e0a 2020 2020 202a 2f0a 0a20 2020 2020  ..     */..     
│ │ │ │ │ -00006010: 2f2a 2041 7373 756d 6520 7765 2063 616c  /* Assume we cal
│ │ │ │ │ -00006020: 6c65 6420 6f74 6865 7220 636f 6465 2061  led other code a
│ │ │ │ │ -00006030: 6e64 2066 756e 6374 696f 6e73 2e2e 2e20  nd functions... 
│ │ │ │ │ -00006040: 202a 2f0a 0a20 2020 2020 2f2a 2056 6572   */..     /* Ver
│ │ │ │ │ -00006050: 6966 7920 484d 4143 0a20 2020 2020 2a2f  ify HMAC.     */
│ │ │ │ │ -00006060: 0a20 2020 2020 7263 203d 2066 6b6f 5f76  .     rc = fko_v
│ │ │ │ │ -00006070: 6572 6966 795f 686d 6163 2863 7478 2c20  erify_hmac(ctx, 
│ │ │ │ │ -00006080: 686d 6163 5f6b 6579 2c20 686d 6163 5f6b  hmac_key, hmac_k
│ │ │ │ │ -00006090: 6579 5f6c 656e 293b 0a20 2020 2020 6966  ey_len);.     if
│ │ │ │ │ -000060a0: 2872 6320 213d 2046 4b4f 5f53 5543 4345  (rc != FKO_SUCCE
│ │ │ │ │ -000060b0: 5353 290a 2020 2020 207b 0a20 2020 2020  SS).     {.     
│ │ │ │ │ -000060c0: 2020 2020 6670 7269 6e74 6628 7374 6465      fprintf(stde
│ │ │ │ │ -000060d0: 7272 2c20 2245 7272 6f72 2066 726f 6d20  rr, "Error from 
│ │ │ │ │ -000060e0: 666b 6f5f 7665 7269 6679 5f68 6d61 633a  fko_verify_hmac:
│ │ │ │ │ -000060f0: 2025 735c 6e22 2c0a 2020 2020 2020 2020   %s\n",.        
│ │ │ │ │ -00006100: 2020 2020 2066 6b6f 5f65 7272 7374 7228       fko_errstr(
│ │ │ │ │ -00006110: 7263 2929 3b0a 2020 2020 2020 2020 2065  rc));.         e
│ │ │ │ │ -00006120: 7869 7428 3129 3b0a 2020 2020 207d 0a0a  xit(1);.     }..
│ │ │ │ │ -00006130: 2020 2020 202f 2a20 4465 6372 7970 7420       /* Decrypt 
│ │ │ │ │ -00006140: 616e 6420 6465 636f 6465 2e2e 2e0a 2020  and decode....  
│ │ │ │ │ -00006150: 2020 202a 2f0a 2020 2020 2072 6320 3d20     */.     rc = 
│ │ │ │ │ -00006160: 666b 6f5f 6465 6372 7970 745f 7370 615f  fko_decrypt_spa_
│ │ │ │ │ -00006170: 6461 7461 2863 7478 2c20 6b65 792c 206b  data(ctx, key, k
│ │ │ │ │ -00006180: 6579 5f6c 656e 293b 0a0a 2020 2020 2069  ey_len);..     i
│ │ │ │ │ -00006190: 6628 7263 2021 3d20 464b 4f5f 5355 4343  f(rc != FKO_SUCC
│ │ │ │ │ -000061a0: 4553 5329 0a20 2020 2020 7b0a 2020 2020  ESS).     {.    
│ │ │ │ │ -000061b0: 2020 2020 2066 7072 696e 7466 2873 7464       fprintf(std
│ │ │ │ │ -000061c0: 6572 722c 2022 4572 726f 7220 6672 6f6d  err, "Error from
│ │ │ │ │ -000061d0: 2066 6b6f 5f64 6563 7279 7074 5f73 7061   fko_decrypt_spa
│ │ │ │ │ -000061e0: 5f64 6174 613a 2025 735c 6e22 2c0a 2020  _data: %s\n",.  
│ │ │ │ │ -000061f0: 2020 2020 2020 2020 2020 2066 6b6f 5f65             fko_e
│ │ │ │ │ -00006200: 7272 7374 7228 7263 2929 3b0a 2020 2020  rrstr(rc));.    
│ │ │ │ │ -00006210: 2020 2020 2065 7869 7428 3129 3b0a 2020       exit(1);.  
│ │ │ │ │ -00006220: 2020 207d 0a0a 1f0a 4669 6c65 3a20 6c69     }....File: li
│ │ │ │ │ -00006230: 6266 6b6f 2e69 6e66 6f2c 2020 4e6f 6465  bfko.info,  Node
│ │ │ │ │ -00006240: 3a20 4465 7374 726f 7969 6e67 2043 6f6e  : Destroying Con
│ │ │ │ │ -00006250: 7465 7874 732c 2020 4e65 7874 3a20 4372  texts,  Next: Cr
│ │ │ │ │ -00006260: 6561 7469 6e67 2061 2053 5041 204d 6573  eating a SPA Mes
│ │ │ │ │ -00006270: 7361 6765 2c20 2050 7265 763a 2043 7265  sage,  Prev: Cre
│ │ │ │ │ -00006280: 6174 696e 6720 436f 6e74 6578 7473 2c20  ating Contexts, 
│ │ │ │ │ -00006290: 2055 703a 2055 7369 6e67 206c 6962 666b   Up: Using libfk
│ │ │ │ │ -000062a0: 6f0a 0a33 2e32 2044 6573 7472 6f79 696e  o..3.2 Destroyin
│ │ │ │ │ -000062b0: 6720 436f 6e74 6578 7473 0a3d 3d3d 3d3d  g Contexts.=====
│ │ │ │ │ +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: 3d3d 0a0a 5768 656e 2079 6f75 2061 7265  ==..When you are
│ │ │ │ │ -000062e0: 2064 6f6e 6520 7769 7468 2074 6865 2063   done with the c
│ │ │ │ │ -000062f0: 6f6e 7465 7874 2c20 796f 7520 6d75 7374  ontext, you must
│ │ │ │ │ -00006300: 2064 6573 7472 6f79 2069 7420 696e 206f   destroy it in o
│ │ │ │ │ -00006310: 7264 6572 2074 6f20 6672 6565 0a75 7020  rder to free.up 
│ │ │ │ │ -00006320: 7468 6520 6d65 6d6f 7279 2061 6e64 2072  the memory and r
│ │ │ │ │ -00006330: 6573 6f75 7263 6573 2069 7420 7761 7320  esources it was 
│ │ │ │ │ -00006340: 7573 696e 672e 2020 5468 6973 2069 7320  using.  This is 
│ │ │ │ │ -00006350: 6573 7065 6369 616c 6c79 2069 6d70 6f72  especially impor
│ │ │ │ │ -00006360: 7461 6e74 0a69 6e20 7072 6f67 7261 6d73  tant.in programs
│ │ │ │ │ -00006370: 2074 6861 7420 7072 6f63 6573 7320 5350   that process SP
│ │ │ │ │ -00006380: 4120 6461 7461 2072 6570 6561 7465 646c  A data repeatedl
│ │ │ │ │ -00006390: 7920 2869 2e65 2e20 2069 6e20 6120 6c6f  y (i.e.  in a lo
│ │ │ │ │ -000063a0: 6f70 292e 2020 4661 696c 7572 650a 746f  op).  Failure.to
│ │ │ │ │ -000063b0: 2064 6573 7472 6f79 2074 6865 2063 6f6e   destroy the con
│ │ │ │ │ -000063c0: 7465 7874 2063 616e 2063 6175 7365 206d  text can cause m
│ │ │ │ │ -000063d0: 656d 6f72 7920 6c65 616b 7320 696e 2079  emory leaks in y
│ │ │ │ │ -000063e0: 6f75 7220 7072 6f67 7261 6d2e 0a0a 202d  our program... -
│ │ │ │ │ -000063f0: 2d20 4675 6e63 7469 6f6e 3a20 766f 6964  - Function: void
│ │ │ │ │ -00006400: 2066 6b6f 5f64 6573 7472 6f79 2028 666b   fko_destroy (fk
│ │ │ │ │ -00006410: 6f5f 6374 785f 7420 4354 5829 0a20 2020  o_ctx_t CTX).   
│ │ │ │ │ -00006420: 2020 5468 6520 6675 6e63 7469 6f6e 2027    The function '
│ │ │ │ │ -00006430: 666b 6f5f 6465 7374 726f 7927 2064 6573  fko_destroy' des
│ │ │ │ │ -00006440: 7472 6f79 7320 7468 6520 636f 6e74 6578  troys the contex
│ │ │ │ │ -00006450: 7420 7769 7468 2074 6865 2068 616e 646c  t with the handl
│ │ │ │ │ -00006460: 6520 4354 580a 2020 2020 2061 6e64 2072  e CTX.     and r
│ │ │ │ │ -00006470: 656c 6561 7365 7320 616c 6c20 6173 736f  eleases all asso
│ │ │ │ │ -00006480: 6369 6174 6564 2072 6573 6f75 7263 6573  ciated resources
│ │ │ │ │ -00006490: 2e0a 0a1f 0a46 696c 653a 206c 6962 666b  .....File: libfk
│ │ │ │ │ -000064a0: 6f2e 696e 666f 2c20 204e 6f64 653a 2043  o.info,  Node: C
│ │ │ │ │ -000064b0: 7265 6174 696e 6720 6120 5350 4120 4d65  reating a SPA Me
│ │ │ │ │ -000064c0: 7373 6167 652c 2020 4e65 7874 3a20 5365  ssage,  Next: Se
│ │ │ │ │ -000064d0: 7474 696e 6720 5350 4120 4461 7461 2c20  tting SPA Data, 
│ │ │ │ │ -000064e0: 2050 7265 763a 2044 6573 7472 6f79 696e   Prev: Destroyin
│ │ │ │ │ -000064f0: 6720 436f 6e74 6578 7473 2c20 2055 703a  g Contexts,  Up:
│ │ │ │ │ -00006500: 2055 7369 6e67 206c 6962 666b 6f0a 0a33   Using libfko..3
│ │ │ │ │ -00006510: 2e33 2043 7265 6174 696e 6720 6120 5350  .3 Creating a SP
│ │ │ │ │ -00006520: 4120 4d65 7373 6167 650a 3d3d 3d3d 3d3d  A Message.======
│ │ │ │ │ +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.========
│ │ │ │ │  00006530: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ │ -00006540: 3d3d 3d3d 0a0a 5468 6973 2073 6563 7469  ====..This secti
│ │ │ │ │ -00006550: 6f6e 2064 6573 6372 6962 6573 2074 6865  on describes the
│ │ │ │ │ -00006560: 2070 726f 6365 7373 2066 6f72 2063 7265   process for cre
│ │ │ │ │ -00006570: 6174 696e 6720 6120 6e65 7720 666b 6f20  ating a new fko 
│ │ │ │ │ -00006580: 5350 4120 6d65 7373 6167 652e 0a41 6674  SPA message..Aft
│ │ │ │ │ -00006590: 6572 2063 7265 6174 696e 6720 6120 636f  er creating a co
│ │ │ │ │ -000065a0: 6e74 6578 742c 2074 6865 7265 2061 7265  ntext, there are
│ │ │ │ │ -000065b0: 2073 7469 6c6c 2073 6f6d 6520 7265 7175   still some requ
│ │ │ │ │ -000065c0: 6973 6974 6520 5350 4120 6461 7461 2066  isite SPA data f
│ │ │ │ │ -000065d0: 6965 6c64 730a 616e 6420 5350 4120 7061  ields.and SPA pa
│ │ │ │ │ -000065e0: 7261 6d65 7465 7273 2074 6861 7420 6e65  rameters that ne
│ │ │ │ │ -000065f0: 6564 2074 6f20 6265 2073 6574 2062 6566  ed to be set bef
│ │ │ │ │ -00006600: 6f72 6520 7468 6520 6669 6e61 6c20 656e  ore the final en
│ │ │ │ │ -00006610: 6372 7970 7465 640a 6d65 7373 6167 6520  crypted.message 
│ │ │ │ │ -00006620: 6973 2072 6561 6479 2e0a 0a20 2020 5468  is ready...   Th
│ │ │ │ │ -00006630: 6520 666f 6c6c 6f77 696e 6720 6c69 7374  e following list
│ │ │ │ │ -00006640: 2063 6f6e 7461 696e 7320 7468 6520 6d69   contains the mi
│ │ │ │ │ -00006650: 6e69 6d75 6d20 7265 7175 6972 6564 2066  nimum required f
│ │ │ │ │ -00006660: 6965 6c64 7320 666f 7220 610a 636f 6d70  ields for a.comp
│ │ │ │ │ -00006670: 6c65 7465 2066 6b6f 2053 5041 206d 6573  lete fko SPA mes
│ │ │ │ │ -00006680: 7361 6765 2e20 2059 6f75 2073 686f 756c  sage.  You shoul
│ │ │ │ │ -00006690: 6420 616c 736f 2074 616b 6520 6e6f 7465  d also take note
│ │ │ │ │ -000066a0: 206f 6620 7468 6520 6f72 6465 7220 6f66   of the order of
│ │ │ │ │ -000066b0: 0a74 6865 7365 2070 6172 616d 6574 6572  .these parameter
│ │ │ │ │ -000066c0: 7320 6173 2077 656c 6c2e 2020 5365 7474  s as well.  Sett
│ │ │ │ │ -000066d0: 696e 6720 7468 6520 2274 7970 6522 2070  ing the "type" p
│ │ │ │ │ -000066e0: 6172 616d 6574 6572 7320 6669 7273 7420  arameters first 
│ │ │ │ │ -000066f0: 6973 0a72 6563 6f6d 6d65 6e64 6564 2028  is.recommended (
│ │ │ │ │ -00006700: 6966 2079 6f75 2077 616e 7420 6120 7479  if you want a ty
│ │ │ │ │ -00006710: 7065 206f 7468 6572 2074 6861 6e20 7468  pe other than th
│ │ │ │ │ -00006720: 6520 6465 6661 756c 7429 2e0a 0a20 2020  e default)...   
│ │ │ │ │ -00006730: 2a20 6469 6765 7374 5f74 7970 6520 2d20  * digest_type - 
│ │ │ │ │ -00006740: 5f28 6465 6661 756c 7420 6d61 7920 7375  _(default may su
│ │ │ │ │ -00006750: 6666 6963 6529 5f0a 2020 202a 206d 6573  ffice)_.   * mes
│ │ │ │ │ -00006760: 7361 6765 5f74 7970 6520 2d20 5f28 6465  sage_type - _(de
│ │ │ │ │ -00006770: 6661 756c 7420 6d61 7920 7375 6666 6963  fault may suffic
│ │ │ │ │ -00006780: 6529 5f0a 2020 202a 2065 6e63 7279 7074  e)_.   * encrypt
│ │ │ │ │ -00006790: 696f 6e5f 7479 7065 202d 205f 2864 6566  ion_type - _(def
│ │ │ │ │ -000067a0: 6175 6c74 206d 6179 2073 7566 6669 6365  ault may suffice
│ │ │ │ │ -000067b0: 295f 0a20 2020 2a20 7261 6e64 5f76 616c  )_.   * rand_val
│ │ │ │ │ -000067c0: 202d 205f 2864 6566 6175 6c74 2073 686f   - _(default sho
│ │ │ │ │ -000067d0: 756c 6420 7375 6666 6963 6529 5f0a 2020  uld suffice)_.  
│ │ │ │ │ -000067e0: 202a 2074 696d 655f 7374 616d 7020 2d20   * time_stamp - 
│ │ │ │ │ -000067f0: 5f28 6465 6661 756c 7420 7368 6f75 6c64  _(default should
│ │ │ │ │ -00006800: 2073 7566 6669 6365 295f 0a20 2020 2a20   suffice)_.   * 
│ │ │ │ │ -00006810: 7573 6572 6e61 6d65 202d 205f 2864 6566  username - _(def
│ │ │ │ │ -00006820: 6175 6c74 206d 6179 2073 7566 6669 6365  ault may suffice
│ │ │ │ │ -00006830: 295f 0a20 2020 2a20 7370 615f 6d65 7373  )_.   * spa_mess
│ │ │ │ │ -00006840: 6167 6520 2d20 5f28 6d75 7374 2062 6520  age - _(must be 
│ │ │ │ │ -00006850: 6578 706c 6963 6974 6c79 2073 6574 295f  explicitly set)_
│ │ │ │ │ -00006860: 0a0a 5f49 6620 7573 696e 6720 6770 6720  .._If using gpg 
│ │ │ │ │ -00006870: 656e 6372 7970 7469 6f6e 3a5f 0a0a 2020  encryption:_..  
│ │ │ │ │ -00006880: 202a 2067 7067 5f72 6563 6970 6965 6e74   * gpg_recipient
│ │ │ │ │ -00006890: 202d 205f 286d 7573 7420 6265 2065 7870   - _(must be exp
│ │ │ │ │ -000068a0: 6c69 6369 746c 7920 7365 7429 5f0a 2020  licitly set)_.  
│ │ │ │ │ -000068b0: 202a 2067 7067 5f73 6967 6e65 7220 2d20   * gpg_signer - 
│ │ │ │ │ -000068c0: 5f28 6f70 7469 6f6e 616c 2c20 6275 7420  _(optional, but 
│ │ │ │ │ -000068d0: 7265 636f 6d6d 656e 6465 6420 2d20 6d75  recommended - mu
│ │ │ │ │ -000068e0: 7374 2062 6520 6578 706c 6963 6974 6c79  st be explicitly
│ │ │ │ │ -000068f0: 2073 6574 0a20 2020 2020 6966 2075 7365   set.     if use
│ │ │ │ │ -00006900: 6429 5f0a 2020 202a 2067 7067 5f68 6f6d  d)_.   * gpg_hom
│ │ │ │ │ -00006910: 655f 6469 7220 2d20 5f28 6465 6661 756c  e_dir - _(defaul
│ │ │ │ │ -00006920: 7420 6d61 7920 7375 6666 6963 6520 2d20  t may suffice - 
│ │ │ │ │ -00006930: 7479 7069 6361 6c6c 7920 2448 4f4d 452f  typically $HOME/
│ │ │ │ │ -00006940: 2e67 6e75 7067 295f 0a0a 2020 2057 6865  .gnupg)_..   Whe
│ │ │ │ │ -00006950: 6e20 6120 636f 6e74 6578 7420 6973 2069  n a context is i
│ │ │ │ │ -00006960: 6e69 7469 616c 697a 6564 2c20 736f 6d65  nitialized, some
│ │ │ │ │ -00006970: 206f 6620 7468 6520 5350 4120 6461 7461   of the SPA data
│ │ │ │ │ -00006980: 2066 6965 6c64 7320 6172 650a 7072 652d   fields are.pre-
│ │ │ │ │ -00006990: 7365 7420 7769 7468 2064 6566 6175 6c74  set with default
│ │ │ │ │ -000069a0: 2076 616c 7565 7320 282a 6e6f 7465 2053   values (*note S
│ │ │ │ │ -000069b0: 5041 2044 6174 6120 466f 726d 6174 3a3a  PA Data Format::
│ │ │ │ │ -000069c0: 292e 2020 466f 7220 6669 656c 6473 2073  ).  For fields s
│ │ │ │ │ -000069d0: 7563 680a 6173 2027 7261 6e64 5f76 616c  uch.as 'rand_val
│ │ │ │ │ -000069e0: 272c 2027 7573 6572 6e61 6d65 272c 2027  ', 'username', '
│ │ │ │ │ -000069f0: 7469 6d65 7374 616d 7027 2c20 276d 6573  timestamp', 'mes
│ │ │ │ │ -00006a00: 7361 6765 5f74 7970 6527 2c20 616e 640a  sage_type', and.
│ │ │ │ │ -00006a10: 2764 6967 6573 745f 7479 7065 272c 2074  'digest_type', t
│ │ │ │ │ -00006a20: 6865 7365 2064 6566 6175 6c74 7320 6d61  hese defaults ma
│ │ │ │ │ -00006a30: 7920 6265 2073 7566 6669 6369 656e 742e  y be sufficient.
│ │ │ │ │ -00006a40: 0a0a 2020 2054 6865 2066 756e 6374 696f  ..   The functio
│ │ │ │ │ -00006a50: 6e73 2075 7365 6420 746f 2073 6574 2074  ns used to set t
│ │ │ │ │ -00006a60: 6865 2076 6172 696f 7573 2053 5041 2064  he various SPA d
│ │ │ │ │ -00006a70: 6174 6120 6669 656c 6473 2061 6e64 2070  ata fields and p
│ │ │ │ │ -00006a80: 6172 616d 6574 6572 730a 6172 6520 6465  arameters.are de
│ │ │ │ │ -00006a90: 7363 7269 6265 6420 696e 2064 6574 6169  scribed in detai
│ │ │ │ │ -00006aa0: 6c20 696e 202a 6e6f 7465 2053 6574 7469  l in *note Setti
│ │ │ │ │ -00006ab0: 6e67 2053 5041 2044 6174 613a 3a2e 0a0a  ng SPA Data::...
│ │ │ │ │ -00006ac0: 2a4e 6f74 652a 3a20 4174 7465 6d70 7473  *Note*: Attempts
│ │ │ │ │ -00006ad0: 2074 6f20 6361 6c6c 2061 6e79 2022 2766   to call any "'f
│ │ │ │ │ -00006ae0: 6b6f 5f27 2220 6675 6e63 7469 6f6e 206f  ko_'" function o
│ │ │ │ │ -00006af0: 6e20 6120 636f 6e74 6578 7420 7468 6174  n a context that
│ │ │ │ │ -00006b00: 2068 6173 206e 6f74 0a62 6565 6e20 696e   has not.been in
│ │ │ │ │ -00006b10: 6974 6961 6c69 7a65 6420 6361 6e20 6861  itialized can ha
│ │ │ │ │ -00006b20: 7665 2075 6e64 6566 696e 6564 2063 6f6e  ve undefined con
│ │ │ │ │ -00006b30: 7365 7175 656e 6365 732e 2020 4c69 6266  sequences.  Libf
│ │ │ │ │ -00006b40: 6b6f 2077 696c 6c20 6174 7465 6d70 740a  ko will attempt.
│ │ │ │ │ -00006b50: 746f 2072 6563 6f76 6572 2c20 616e 6420  to recover, and 
│ │ │ │ │ -00006b60: 6966 2073 7563 6365 7373 6675 6c2c 2077  if successful, w
│ │ │ │ │ -00006b70: 696c 6c20 7265 7475 726e 2061 2073 7461  ill return a sta
│ │ │ │ │ -00006b80: 7475 7320 6f66 0a27 464b 4f5f 4552 524f  tus of.'FKO_ERRO
│ │ │ │ │ -00006b90: 525f 4354 585f 4e4f 545f 494e 4954 4941  R_CTX_NOT_INITIA
│ │ │ │ │ -00006ba0: 4c49 5a45 4427 2e0a 0a20 2020 4120 636f  LIZED'...   A co
│ │ │ │ │ -00006bb0: 6d6d 6f6e 2053 5041 206d 6573 7361 6765  mmon SPA message
│ │ │ │ │ -00006bc0: 2069 7320 6120 7369 6d70 6c65 2061 6363   is a simple acc
│ │ │ │ │ -00006bd0: 6573 7320 7265 7175 6573 742e 2020 5468  ess request.  Th
│ │ │ │ │ -00006be0: 6973 2072 6571 7565 7374 2061 736b 730a  is request asks.
│ │ │ │ │ -00006bf0: 7468 6520 6677 6b6e 6f70 2073 6572 7665  the fwknop serve
│ │ │ │ │ -00006c00: 7220 746f 2063 7265 6174 6520 6120 7465  r to create a te
│ │ │ │ │ -00006c10: 6d70 6f72 6172 7920 6669 7265 7761 6c6c  mporary firewall
│ │ │ │ │ -00006c20: 2072 756c 6520 746f 2061 6c6c 6f77 2061   rule to allow a
│ │ │ │ │ -00006c30: 0a70 6172 7469 6375 6c61 7220 4950 2061  .particular IP a
│ │ │ │ │ -00006c40: 6464 7265 7373 2061 6363 6573 7320 746f  ddress access to
│ │ │ │ │ -00006c50: 2061 2070 6172 7469 6375 6c61 7220 706f   a particular po
│ │ │ │ │ -00006c60: 7274 206f 6e20 7468 6520 6677 6b6e 6f70  rt on the fwknop
│ │ │ │ │ -00006c70: 2073 6572 7665 722e 0a41 7373 756d 696e   server..Assumin
│ │ │ │ │ -00006c80: 6720 7468 6520 6465 6661 756c 7473 2061  g the defaults a
│ │ │ │ │ -00006c90: 7265 2066 696e 6520 666f 7220 7468 6973  re fine for this
│ │ │ │ │ -00006ca0: 2c20 616c 6c20 7765 206e 6565 6420 746f  , all we need to
│ │ │ │ │ -00006cb0: 2064 6f20 6973 2063 7265 6174 6520 7468   do is create th
│ │ │ │ │ -00006cc0: 650a 636f 6e74 6578 742c 2073 6574 2074  e.context, set t
│ │ │ │ │ -00006cd0: 6865 206d 6573 7361 6765 2064 6174 6120  he message data 
│ │ │ │ │ -00006ce0: 6669 656c 642c 2063 616c 6c20 7468 6520  field, call the 
│ │ │ │ │ -00006cf0: 2766 6b6f 5f73 7061 5f64 6174 615f 6669  'fko_spa_data_fi
│ │ │ │ │ -00006d00: 6e61 6c27 0a66 756e 6374 696f 6e20 746f  nal'.function to
│ │ │ │ │ -00006d10: 2065 6e63 6f64 6520 616e 6420 656e 6372   encode and encr
│ │ │ │ │ -00006d20: 7970 742c 2070 726f 6365 7373 2074 6865  ypt, process the
│ │ │ │ │ -00006d30: 206d 6573 7361 6765 2c20 7468 656e 2064   message, then d
│ │ │ │ │ -00006d40: 6573 7472 6f79 2074 6865 0a63 6f6e 7465  estroy the.conte
│ │ │ │ │ -00006d50: 7874 2e20 2042 656c 6f77 2c20 7765 2068  xt.  Below, we h
│ │ │ │ │ -00006d60: 6176 6520 6120 636f 6e74 7269 7665 6420  ave a contrived 
│ │ │ │ │ -00006d70: 6269 7420 6f66 2063 6f64 6520 6465 6d6f  bit of code demo
│ │ │ │ │ -00006d80: 6e73 7472 6174 696e 6720 7468 6973 3a0a  nstrating this:.
│ │ │ │ │ -00006d90: 0a20 2020 2020 696e 740a 2020 2020 206d  .     int.     m
│ │ │ │ │ -00006da0: 6169 6e28 696e 7420 6172 6763 2c20 6368  ain(int argc, ch
│ │ │ │ │ -00006db0: 6172 202a 2a61 7267 7629 0a20 2020 2020  ar **argv).     
│ │ │ │ │ -00006dc0: 7b0a 2020 2020 2020 2020 2066 6b6f 5f63  {.         fko_c
│ │ │ │ │ -00006dd0: 7478 5f74 2020 2063 7478 3b20 2020 2020  tx_t   ctx;     
│ │ │ │ │ -00006de0: 2020 2020 2020 2f2a 2046 4b4f 2043 6f6e        /* FKO Con
│ │ │ │ │ -00006df0: 7465 7874 202a 2f0a 2020 2020 2020 2020  text */.        
│ │ │ │ │ -00006e00: 2063 6861 7220 2020 2020 2020 2a6b 6579   char       *key
│ │ │ │ │ -00006e10: 3b20 2020 2020 2020 2020 2020 2f2a 2045  ;           /* E
│ │ │ │ │ -00006e20: 6e63 7279 7074 696f 6e20 7061 7373 7068  ncryption passph
│ │ │ │ │ -00006e30: 7261 7365 202a 2f0a 2020 2020 2020 2020  rase */.        
│ │ │ │ │ -00006e40: 2063 6861 7220 2020 2020 2020 2a68 6d61   char       *hma
│ │ │ │ │ -00006e50: 635f 6b65 793b 2020 2020 2020 2f2a 2048  c_key;      /* H
│ │ │ │ │ -00006e60: 4d41 4320 6b65 7920 2a2f 0a20 2020 2020  MAC key */.     
│ │ │ │ │ -00006e70: 2020 2020 6368 6172 2020 2020 2020 202a      char       *
│ │ │ │ │ -00006e80: 6669 6e61 6c5f 7370 613b 2020 2020 202f  final_spa;     /
│ │ │ │ │ -00006e90: 2a20 4669 6e61 6c20 656e 6372 7970 7465  * Final encrypte
│ │ │ │ │ -00006ea0: 6420 5350 4120 6461 7461 202a 2f0a 2020  d SPA data */.  
│ │ │ │ │ -00006eb0: 2020 2020 2020 2069 6e74 2020 2020 2020         int      
│ │ │ │ │ -00006ec0: 2020 206b 6579 5f6c 656e 3b20 2020 2020     key_len;     
│ │ │ │ │ -00006ed0: 2020 2f2a 204c 656e 6774 6820 6f66 2065    /* Length of e
│ │ │ │ │ -00006ee0: 6e63 7279 7074 696f 6e20 6b65 7920 2a2f  ncryption key */
│ │ │ │ │ -00006ef0: 0a20 2020 2020 2020 2020 696e 7420 2020  .         int   
│ │ │ │ │ -00006f00: 2020 2020 2020 686d 6163 5f6b 6579 5f6c        hmac_key_l
│ │ │ │ │ -00006f10: 656e 3b20 202f 2a20 4c65 6e67 7468 206f  en;  /* Length o
│ │ │ │ │ -00006f20: 6620 484d 4143 206b 6579 202a 2f0a 2020  f HMAC key */.  
│ │ │ │ │ -00006f30: 2020 2020 2020 2069 6e74 2020 2020 2020         int      
│ │ │ │ │ -00006f40: 2020 2072 633b 2020 2020 2020 2020 2020     rc;          
│ │ │ │ │ -00006f50: 2020 2f2a 2052 6573 756c 7420 636f 6465    /* Result code
│ │ │ │ │ -00006f60: 202a 2f0a 2020 2020 2020 2020 2069 6e74   */.         int
│ │ │ │ │ -00006f70: 2020 2020 2020 2020 2068 6d61 635f 7479           hmac_ty
│ │ │ │ │ -00006f80: 7065 203d 2046 4b4f 5f48 4d41 435f 5348  pe = FKO_HMAC_SH
│ │ │ │ │ -00006f90: 4132 3536 3b20 2020 2f2a 2044 6566 6175  A256;   /* Defau
│ │ │ │ │ -00006fa0: 6c74 2048 4d41 4320 6469 6765 7374 202a  lt HMAC digest *
│ │ │ │ │ -00006fb0: 2f0a 2020 2020 2020 2020 2069 6e74 2020  /.         int  
│ │ │ │ │ -00006fc0: 2020 2020 2020 2065 6e63 5f6d 6f64 6520         enc_mode 
│ │ │ │ │ -00006fd0: 203d 2046 4b4f 5f45 4e43 5f4d 4f44 455f   = FKO_ENC_MODE_
│ │ │ │ │ -00006fe0: 4153 594d 4d45 5452 4943 3b20 202f 2a20  ASYMMETRIC;  /* 
│ │ │ │ │ -00006ff0: 5573 6520 4750 4720 2a2f 0a0a 2020 2020  Use GPG */..    
│ │ │ │ │ -00007000: 2020 2020 202f 2a20 2041 7373 756d 6520       /*  Assume 
│ │ │ │ │ -00007010: 7765 2070 726f 6365 7373 6564 2074 6865  we processed the
│ │ │ │ │ -00007020: 2063 6f6d 6d61 6e64 206c 696e 650a 2020   command line.  
│ │ │ │ │ -00007030: 2020 2020 2020 2020 2a20 2061 6e64 2072          *  and r
│ │ │ │ │ -00007040: 6574 7269 6576 6564 2074 6865 2070 6173  etrieved the pas
│ │ │ │ │ -00007050: 7377 6f72 6420 616e 6420 7468 6520 484d  sword and the HM
│ │ │ │ │ -00007060: 4143 206b 6579 2061 6e64 0a20 2020 2020  AC key and.     
│ │ │ │ │ -00007070: 2020 2020 2a20 2020 7365 7420 7468 6569      *   set thei
│ │ │ │ │ -00007080: 7220 6173 736f 6369 6174 6564 206c 656e  r associated len
│ │ │ │ │ -00007090: 6774 6873 2e0a 2020 2020 2020 2020 202a  gths..         *
│ │ │ │ │ -000070a0: 2f0a 0a20 2020 2020 2020 2020 2f2a 2043  /..         /* C
│ │ │ │ │ -000070b0: 7265 6174 6520 7468 6520 636f 6e74 6578  reate the contex
│ │ │ │ │ -000070c0: 7420 2a2f 0a20 2020 2020 2020 2020 7263  t */.         rc
│ │ │ │ │ -000070d0: 203d 2066 6b6f 5f6e 6577 2826 6374 7829   = fko_new(&ctx)
│ │ │ │ │ -000070e0: 3b0a 2020 2020 2020 2020 2069 6628 7263  ;.         if(rc
│ │ │ │ │ -000070f0: 2021 3d20 464b 4f5f 5355 4343 4553 5329   != FKO_SUCCESS)
│ │ │ │ │ -00007100: 0a20 2020 2020 2020 2020 7b0a 2020 2020  .         {.    
│ │ │ │ │ -00007110: 2020 2020 2020 2020 2066 7072 696e 7466           fprintf
│ │ │ │ │ -00007120: 2873 7464 6572 722c 2022 4572 726f 7220  (stderr, "Error 
│ │ │ │ │ -00007130: 6372 6561 7469 6e67 2063 6f6e 7465 7874  creating context
│ │ │ │ │ -00007140: 3a20 2573 5c6e 222c 2066 6b6f 5f65 7272  : %s\n", fko_err
│ │ │ │ │ -00007150: 7374 7228 7263 2929 3b0a 2020 2020 2020  str(rc));.      
│ │ │ │ │ -00007160: 2020 2020 2020 2065 7869 7428 3129 3b0a         exit(1);.
│ │ │ │ │ -00007170: 2020 2020 2020 2020 207d 0a0a 2020 2020           }..    
│ │ │ │ │ -00007180: 2020 2020 202f 2a20 5365 7420 7468 6520       /* Set the 
│ │ │ │ │ -00007190: 5350 4120 6d65 7373 6167 6520 6669 656c  SPA message fiel
│ │ │ │ │ -000071a0: 6420 2d20 6173 6b69 6e67 2074 6f20 6f70  d - asking to op
│ │ │ │ │ -000071b0: 656e 2074 6370 2070 6f72 7420 3232 0a20  en tcp port 22. 
│ │ │ │ │ -000071c0: 2020 2020 2020 2020 202a 2066 6f72 2074           * for t
│ │ │ │ │ -000071d0: 6865 2073 7973 7465 6d20 6174 2031 3932  he system at 192
│ │ │ │ │ -000071e0: 2e31 3638 2e30 2e33 330a 2020 2020 2020  .168.0.33.      
│ │ │ │ │ -000071f0: 2020 202a 2f0a 2020 2020 2020 2020 2072     */.         r
│ │ │ │ │ -00007200: 6320 3d20 666b 6f5f 7365 745f 7370 615f  c = fko_set_spa_
│ │ │ │ │ -00007210: 6d65 7373 6167 6528 6374 782c 2022 3139  message(ctx, "19
│ │ │ │ │ -00007220: 322e 3136 382e 302e 3333 2c74 6370 2f32  2.168.0.33,tcp/2
│ │ │ │ │ -00007230: 3222 293b 0a20 2020 2020 2020 2020 6966  2");.         if
│ │ │ │ │ -00007240: 2872 6320 213d 2046 4b4f 5f53 5543 4345  (rc != FKO_SUCCE
│ │ │ │ │ -00007250: 5353 290a 2020 2020 2020 2020 207b 0a20  SS).         {. 
│ │ │ │ │ -00007260: 2020 2020 2020 2020 2020 2020 6670 7269              fpri
│ │ │ │ │ -00007270: 6e74 6628 7374 6465 7272 2c20 2253 6574  ntf(stderr, "Set
│ │ │ │ │ -00007280: 2053 5041 206d 6573 7361 6765 2066 6169   SPA message fai
│ │ │ │ │ -00007290: 6c65 643a 2025 735c 6e22 2c20 666b 6f5f  led: %s\n", fko_
│ │ │ │ │ -000072a0: 6572 7273 7472 2872 6329 293b 0a20 2020  errstr(rc));.   
│ │ │ │ │ -000072b0: 2020 2020 2020 2020 2020 6578 6974 2831            exit(1
│ │ │ │ │ -000072c0: 293b 0a20 2020 2020 2020 2020 7d0a 0a20  );.         }.. 
│ │ │ │ │ -000072d0: 2020 2020 2020 2020 2f2a 204c 6574 2075          /* Let u
│ │ │ │ │ -000072e0: 7320 6173 7375 6d65 2077 6520 6172 6520  s assume we are 
│ │ │ │ │ -000072f0: 7573 696e 6720 4750 4720 656e 6372 7970  using GPG encryp
│ │ │ │ │ -00007300: 7469 6f6e 2e20 2053 6f20 7765 206e 6565  tion.  So we nee
│ │ │ │ │ -00007310: 6420 746f 0a20 2020 2020 2020 2020 202a  d to.          *
│ │ │ │ │ -00007320: 2073 6574 2074 6865 2065 6e63 7279 7074   set the encrypt
│ │ │ │ │ -00007330: 696f 6e20 7479 7065 2061 6e64 2073 6574  ion type and set
│ │ │ │ │ -00007340: 2074 6865 2072 6571 7569 7265 6420 4750   the required GP
│ │ │ │ │ -00007350: 4720 7061 7261 6d65 7465 7273 0a20 2020  G parameters.   
│ │ │ │ │ -00007360: 2020 2020 2020 202a 2028 7765 2063 616e         * (we can
│ │ │ │ │ -00007370: 2073 6b69 7020 6368 6563 6b69 6e67 2072   skip checking r
│ │ │ │ │ -00007380: 6574 7572 6e20 7661 6c75 6573 2066 6f72  eturn values for
│ │ │ │ │ -00007390: 2062 7265 7669 7479 292e 0a20 2020 2020   brevity)..     
│ │ │ │ │ -000073a0: 2020 2020 2a2f 0a20 2020 2020 2020 2020      */.         
│ │ │ │ │ -000073b0: 7263 203d 2066 6b6f 5f73 6574 5f73 7061  rc = fko_set_spa
│ │ │ │ │ -000073c0: 5f65 6e63 7279 7074 696f 6e5f 7479 7065  _encryption_type
│ │ │ │ │ -000073d0: 2863 7478 2c20 464b 4f5f 454e 4352 5950  (ctx, FKO_ENCRYP
│ │ │ │ │ -000073e0: 5449 4f4e 5f47 5047 293b 0a0a 2020 2020  TION_GPG);..    
│ │ │ │ │ -000073f0: 2020 2020 202f 2a20 4b65 7920 666f 7220       /* Key for 
│ │ │ │ │ -00007400: 7468 6520 7265 6369 7069 656e 7420 2a2f  the recipient */
│ │ │ │ │ -00007410: 0a20 2020 2020 2020 2020 7263 203d 2066  .         rc = f
│ │ │ │ │ -00007420: 6b6f 5f73 6574 5f67 7067 5f72 6563 6970  ko_set_gpg_recip
│ │ │ │ │ -00007430: 6965 6e74 2863 7478 2c20 2272 6563 6970  ient(ctx, "recip
│ │ │ │ │ -00007440: 4073 6f6d 652e 7768 6572 6522 293b 0a0a  @some.where");..
│ │ │ │ │ -00007450: 2020 2020 2020 2020 202f 2a20 4b65 7920           /* Key 
│ │ │ │ │ -00007460: 666f 7220 7468 6520 7369 676e 6572 2028  for the signer (
│ │ │ │ │ -00007470: 6966 2079 6f75 2077 616e 7420 746f 2073  if you want to s
│ │ │ │ │ -00007480: 6967 6e20 6974 2920 2a2f 0a20 2020 2020  ign it) */.     
│ │ │ │ │ -00007490: 2020 2020 7263 203d 2066 6b6f 5f73 6574      rc = fko_set
│ │ │ │ │ -000074a0: 5f67 7067 5f73 6967 6e65 7228 6374 782c  _gpg_signer(ctx,
│ │ │ │ │ -000074b0: 2022 6d65 4072 6967 6874 2e68 6572 6522   "me@right.here"
│ │ │ │ │ -000074c0: 293b 0a0a 2020 2020 2020 2020 202f 2a20  );..         /* 
│ │ │ │ │ -000074d0: 4669 6e61 6c69 7a65 2074 6865 2053 5041  Finalize the SPA
│ │ │ │ │ -000074e0: 2064 6174 6120 2a2f 0a20 2020 2020 2020   data */.       
│ │ │ │ │ -000074f0: 2020 7263 203d 2066 6b6f 5f73 7061 5f64    rc = fko_spa_d
│ │ │ │ │ -00007500: 6174 615f 6669 6e61 6c28 6374 782c 206b  ata_final(ctx, k
│ │ │ │ │ -00007510: 6579 2c20 6b65 795f 6c65 6e2c 2065 6e63  ey, key_len, enc
│ │ │ │ │ -00007520: 5f6d 6f64 652c 0a20 2020 2020 2020 2020  _mode,.         
│ │ │ │ │ -00007530: 2020 2020 2020 2020 686d 6163 5f6b 6579          hmac_key
│ │ │ │ │ -00007540: 2c20 686d 6163 5f6b 6579 5f6c 656e 2c20  , hmac_key_len, 
│ │ │ │ │ -00007550: 686d 6163 5f74 7970 6529 3b0a 2020 2020  hmac_type);.    
│ │ │ │ │ -00007560: 2020 2020 2069 6628 7263 2021 3d20 464b       if(rc != FK
│ │ │ │ │ -00007570: 4f5f 5355 4343 4553 5329 0a20 2020 2020  O_SUCCESS).     
│ │ │ │ │ -00007580: 2020 2020 7b0a 2020 2020 2020 2020 2020      {.          
│ │ │ │ │ -00007590: 2020 2066 7072 696e 7466 2873 7464 6572     fprintf(stder
│ │ │ │ │ -000075a0: 722c 2022 4572 726f 7220 656e 636f 6469  r, "Error encodi
│ │ │ │ │ -000075b0: 6e67 2053 5041 2064 6174 613a 2025 735c  ng SPA data: %s\
│ │ │ │ │ -000075c0: 6e22 2c0a 2020 2020 2020 2020 2020 2020  n",.            
│ │ │ │ │ -000075d0: 2020 2020 2066 6b6f 5f65 7272 7374 7228       fko_errstr(
│ │ │ │ │ -000075e0: 7263 2929 3b0a 2020 2020 2020 2020 2020  rc));.          
│ │ │ │ │ -000075f0: 2020 2065 7869 7428 3129 3b0a 2020 2020     exit(1);.    
│ │ │ │ │ -00007600: 2020 2020 207d 0a0a 2020 2020 2020 2020       }..        
│ │ │ │ │ -00007610: 202f 2a20 5461 6b65 2074 6865 2066 696e   /* Take the fin
│ │ │ │ │ -00007620: 616c 206d 6573 7361 6765 2061 6e64 2064  al message and d
│ │ │ │ │ -00007630: 6f20 736f 6d65 7468 696e 6720 7769 7468  o something with
│ │ │ │ │ -00007640: 2069 7420 2a2f 0a20 2020 2020 2020 2020   it */.         
│ │ │ │ │ -00007650: 7263 203d 2066 6b6f 5f67 6574 5f73 7061  rc = fko_get_spa
│ │ │ │ │ -00007660: 5f64 6174 6128 6374 782c 2026 6669 6e61  _data(ctx, &fina
│ │ │ │ │ -00007670: 6c5f 7370 6129 3b0a 0a20 2020 2020 2020  l_spa);..       
│ │ │ │ │ -00007680: 2020 2f2a 2041 7373 756d 6520 7468 6973    /* Assume this
│ │ │ │ │ -00007690: 2066 756e 6374 696f 6e20 7061 636b 7320   function packs 
│ │ │ │ │ -000076a0: 7468 6520 7370 6120 6461 7461 2069 6e74  the spa data int
│ │ │ │ │ -000076b0: 6f20 6120 5544 500a 2020 2020 2020 2020  o a UDP.        
│ │ │ │ │ -000076c0: 2020 2a20 7061 636b 6574 2061 6e64 2073    * packet and s
│ │ │ │ │ -000076d0: 656e 6473 2069 7420 746f 2074 6865 2073  ends it to the s
│ │ │ │ │ -000076e0: 6572 7665 722e 0a20 2020 2020 2020 2020  erver..         
│ │ │ │ │ -000076f0: 2a2f 0a20 2020 2020 2020 2020 7365 6e64  */.         send
│ │ │ │ │ -00007700: 5f73 7061 5f6d 6573 7361 6765 2866 696e  _spa_message(fin
│ │ │ │ │ -00007710: 616c 5f73 7061 293b 0a0a 2020 2020 2020  al_spa);..      
│ │ │ │ │ -00007720: 2020 202f 2a20 446f 6e65 2077 6974 6820     /* Done with 
│ │ │ │ │ -00007730: 7468 6520 636f 6e74 6578 7420 2a2f 0a20  the context */. 
│ │ │ │ │ -00007740: 2020 2020 2020 2020 666b 6f5f 6465 7374          fko_dest
│ │ │ │ │ -00007750: 726f 7928 6374 7829 3b0a 0a20 2020 2020  roy(ctx);..     
│ │ │ │ │ -00007760: 2020 2020 6578 6974 2830 293b 0a20 2020      exit(0);.   
│ │ │ │ │ -00007770: 2020 7d0a 0a1f 0a46 696c 653a 206c 6962    }....File: lib
│ │ │ │ │ -00007780: 666b 6f2e 696e 666f 2c20 204e 6f64 653a  fko.info,  Node:
│ │ │ │ │ -00007790: 2053 6574 7469 6e67 2053 5041 2044 6174   Setting SPA Dat
│ │ │ │ │ -000077a0: 612c 2020 4e65 7874 3a20 5265 7472 6965  a,  Next: Retrie
│ │ │ │ │ -000077b0: 7669 6e67 2053 5041 2044 6174 612c 2020  ving SPA Data,  
│ │ │ │ │ -000077c0: 5072 6576 3a20 4372 6561 7469 6e67 2061  Prev: Creating a
│ │ │ │ │ -000077d0: 2053 5041 204d 6573 7361 6765 2c20 2055   SPA Message,  U
│ │ │ │ │ -000077e0: 703a 2055 7369 6e67 206c 6962 666b 6f0a  p: Using libfko.
│ │ │ │ │ -000077f0: 0a33 2e34 2053 6574 7469 6e67 2053 5041  .3.4 Setting SPA
│ │ │ │ │ -00007800: 2044 6174 610a 3d3d 3d3d 3d3d 3d3d 3d3d   Data.==========
│ │ │ │ │ -00007810: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6973  ==========..This
│ │ │ │ │ -00007820: 2073 6563 7469 6f6e 2064 6573 6372 6962   section describ
│ │ │ │ │ -00007830: 6573 2074 6865 2066 756e 6374 696f 6e73  es the functions
│ │ │ │ │ -00007840: 2075 7365 6420 666f 7220 7365 7474 696e   used for settin
│ │ │ │ │ -00007850: 6720 7468 6520 7661 7269 6f75 7320 5350  g the various SP
│ │ │ │ │ -00007860: 410a 6461 7461 2066 6965 6c64 7320 616e  A.data fields an
│ │ │ │ │ -00007870: 6420 7061 7261 6d65 7465 7273 2e20 2041  d parameters.  A
│ │ │ │ │ -00007880: 6c6c 206f 6620 7468 6573 6520 6675 6e63  ll of these func
│ │ │ │ │ -00007890: 7469 6f6e 7320 7265 7475 726e 2061 6e20  tions return an 
│ │ │ │ │ -000078a0: 696e 7465 6765 720a 7265 7072 6573 656e  integer.represen
│ │ │ │ │ -000078b0: 7469 6e67 2074 6865 2072 6574 7572 6e20  ting the return 
│ │ │ │ │ -000078c0: 7374 6174 7573 206f 6620 7468 6520 6675  status of the fu
│ │ │ │ │ -000078d0: 6e63 7469 6f6e 2e20 2057 6865 6e20 7375  nction.  When su
│ │ │ │ │ -000078e0: 6363 6573 6675 6c6c 2c20 7468 6579 0a77  ccesfull, they.w
│ │ │ │ │ -000078f0: 696c 6c20 7265 7475 726e 2027 464b 4f5f  ill return 'FKO_
│ │ │ │ │ -00007900: 5355 4343 4553 5327 2e20 204f 7468 6572  SUCCESS'.  Other
│ │ │ │ │ -00007910: 7769 7365 2c20 616e 2065 7272 6f72 2063  wise, an error c
│ │ │ │ │ -00007920: 6f64 6520 7661 6c75 6520 6973 2072 6574  ode value is ret
│ │ │ │ │ -00007930: 7572 6e65 642e 0a0a 202d 2d20 4675 6e63  urned... -- Func
│ │ │ │ │ -00007940: 7469 6f6e 3a20 696e 7420 666b 6f5f 7365  tion: int fko_se
│ │ │ │ │ -00007950: 745f 7370 615f 6469 6765 7374 5f74 7970  t_spa_digest_typ
│ │ │ │ │ -00007960: 6520 2866 6b6f 5f63 7478 5f74 2043 5458  e (fko_ctx_t CTX
│ │ │ │ │ -00007970: 2c20 7368 6f72 740a 2020 2020 2020 2020  , short.        
│ │ │ │ │ -00007980: 2020 4449 4745 5354 5f54 5950 4529 3b0a    DIGEST_TYPE);.
│ │ │ │ │ -00007990: 2020 2020 2053 6574 2074 6865 206d 6573       Set the mes
│ │ │ │ │ -000079a0: 7361 6765 2064 6967 6573 7420 7479 7065  sage digest type
│ │ │ │ │ -000079b0: 2e20 2056 616c 6964 2076 616c 7565 7320  .  Valid values 
│ │ │ │ │ -000079c0: 6361 6e20 6265 2066 6f75 6e64 2069 6e20  can be found in 
│ │ │ │ │ -000079d0: 2a6e 6f74 650a 2020 2020 2044 6967 6573  *note.     Diges
│ │ │ │ │ -000079e0: 7473 3a3a 206f 6620 7468 6973 206d 616e  ts:: of this man
│ │ │ │ │ -000079f0: 7561 6c2e 2020 4966 2061 2076 616c 7565  ual.  If a value
│ │ │ │ │ -00007a00: 206f 7468 6572 2074 6861 6e20 7468 6520   other than the 
│ │ │ │ │ -00007a10: 7468 6f73 6520 7468 6174 2061 7265 0a20  those that are. 
│ │ │ │ │ -00007a20: 2020 2020 7375 7070 6f72 7465 6420 6973      supported is
│ │ │ │ │ -00007a30: 2067 6976 656e 2c20 7468 6520 6675 6e63   given, the func
│ │ │ │ │ -00007a40: 7469 6f6e 2077 696c 6c20 7265 7475 726e  tion will return
│ │ │ │ │ -00007a50: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -00007a60: 5f49 4e56 414c 4944 5f44 4154 4127 2e20  _INVALID_DATA'. 
│ │ │ │ │ -00007a70: 2046 6f72 2065 7861 6d70 6c65 3a0a 2020   For example:.  
│ │ │ │ │ -00007a80: 2020 2020 2020 2020 2020 2020 7263 203d              rc =
│ │ │ │ │ -00007a90: 2066 6b6f 5f73 6574 5f64 6967 6573 745f   fko_set_digest_
│ │ │ │ │ -00007aa0: 7479 7065 2863 7478 2c20 464b 4f5f 4449  type(ctx, FKO_DI
│ │ │ │ │ -00007ab0: 4745 5354 5f53 4841 3129 3b0a 0a20 2d2d  GEST_SHA1);.. --
│ │ │ │ │ -00007ac0: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f
│ │ │ │ │ -00007ad0: 6b6f 5f73 6574 5f73 7061 5f68 6d61 635f  ko_set_spa_hmac_
│ │ │ │ │ -00007ae0: 7479 7065 2028 666b 6f5f 6374 785f 7420  type (fko_ctx_t 
│ │ │ │ │ -00007af0: 4354 582c 2073 686f 7274 0a20 2020 2020  CTX, short.     
│ │ │ │ │ -00007b00: 2020 2020 2048 4d41 435f 5459 5045 293b       HMAC_TYPE);
│ │ │ │ │ -00007b10: 0a20 2020 2020 5365 7420 7468 6520 6d65  .     Set the me
│ │ │ │ │ -00007b20: 7373 6167 6520 686d 6163 2074 7970 652e  ssage hmac type.
│ │ │ │ │ -00007b30: 2020 5661 6c69 6420 7661 6c75 6573 2063    Valid values c
│ │ │ │ │ -00007b40: 616e 2062 6520 666f 756e 6420 696e 202a  an be found in *
│ │ │ │ │ -00007b50: 6e6f 7465 2048 4d41 430a 2020 2020 2044  note HMAC.     D
│ │ │ │ │ -00007b60: 6967 6573 7473 3a3a 206f 6620 7468 6973  igests:: of this
│ │ │ │ │ -00007b70: 206d 616e 7561 6c2e 2020 4966 2061 2076   manual.  If a v
│ │ │ │ │ -00007b80: 616c 7565 206f 7468 6572 2074 6861 6e20  alue other than 
│ │ │ │ │ -00007b90: 7468 6520 7468 6f73 6520 7468 6174 2061  the those that a
│ │ │ │ │ -00007ba0: 7265 0a20 2020 2020 7375 7070 6f72 7465  re.     supporte
│ │ │ │ │ -00007bb0: 6420 6973 2067 6976 656e 2c20 7468 6520  d is given, the 
│ │ │ │ │ -00007bc0: 6675 6e63 7469 6f6e 2077 696c 6c20 7265  function will re
│ │ │ │ │ -00007bd0: 7475 726e 0a20 2020 2020 2746 4b4f 5f45  turn.     'FKO_E
│ │ │ │ │ -00007be0: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ -00007bf0: 4127 2e20 2046 6f72 2065 7861 6d70 6c65  A'.  For example
│ │ │ │ │ -00007c00: 3a0a 2020 2020 2020 2020 2020 2020 2020  :.              
│ │ │ │ │ -00007c10: 7263 203d 2066 6b6f 5f73 6574 5f68 6d61  rc = fko_set_hma
│ │ │ │ │ -00007c20: 635f 7479 7065 2863 7478 2c20 464b 4f5f  c_type(ctx, FKO_
│ │ │ │ │ -00007c30: 484d 4143 5f53 4841 3235 3629 3b0a 0a20  HMAC_SHA256);.. 
│ │ │ │ │ -00007c40: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ │ -00007c50: 2066 6b6f 5f73 6574 5f73 7061 5f65 6e63   fko_set_spa_enc
│ │ │ │ │ -00007c60: 7279 7074 696f 6e5f 7479 7065 2028 666b  ryption_type (fk
│ │ │ │ │ -00007c70: 6f5f 6374 785f 7420 4354 582c 2073 686f  o_ctx_t CTX, sho
│ │ │ │ │ -00007c80: 7274 0a20 2020 2020 2020 2020 2045 4e43  rt.          ENC
│ │ │ │ │ -00007c90: 5259 5054 5f54 5950 4529 3b0a 2020 2020  RYPT_TYPE);.    
│ │ │ │ │ -00007ca0: 2053 6574 2074 6865 2065 6e63 7279 7469   Set the encryti
│ │ │ │ │ -00007cb0: 6f6e 2061 6c67 6f72 6974 686d 2074 6f20  on algorithm to 
│ │ │ │ │ -00007cc0: 7573 6520 7768 656e 2065 6372 7970 7469  use when ecrypti
│ │ │ │ │ -00007cd0: 6e67 2074 6865 2066 696e 616c 2053 5041  ng the final SPA
│ │ │ │ │ -00007ce0: 0a20 2020 2020 6461 7461 2e20 2056 616c  .     data.  Val
│ │ │ │ │ -00007cf0: 6964 2076 616c 7565 7320 6361 6e20 6265  id values can be
│ │ │ │ │ -00007d00: 2066 6f75 6e64 2069 6e20 2a6e 6f74 6520   found in *note 
│ │ │ │ │ -00007d10: 456e 6372 7970 7469 6f6e 2041 6c67 6f72  Encryption Algor
│ │ │ │ │ -00007d20: 6974 686d 733a 3a0a 2020 2020 206f 6620  ithms::.     of 
│ │ │ │ │ -00007d30: 7468 6973 206d 616e 7561 6c2e 2020 466f  this manual.  Fo
│ │ │ │ │ -00007d40: 7220 6578 616d 706c 653a 0a20 2020 2020  r example:.     
│ │ │ │ │ -00007d50: 2020 2020 2020 2020 2072 6320 3d20 666b           rc = fk
│ │ │ │ │ -00007d60: 6f5f 7365 745f 656e 6372 7970 7469 6f6e  o_set_encryption
│ │ │ │ │ -00007d70: 5f74 7970 6528 6374 782c 2046 4b4f 5f45  _type(ctx, FKO_E
│ │ │ │ │ -00007d80: 4e43 5259 5054 494f 4e5f 5249 4a4e 4441  NCRYPTION_RIJNDA
│ │ │ │ │ -00007d90: 454c 293b 0a0a 202d 2d20 4675 6e63 7469  EL);.. -- Functi
│ │ │ │ │ -00007da0: 6f6e 3a20 696e 7420 666b 6f5f 7365 745f  on: int fko_set_
│ │ │ │ │ -00007db0: 7261 6e64 5f76 616c 7565 2028 666b 6f5f  rand_value (fko_
│ │ │ │ │ -00007dc0: 6374 785f 7420 4354 582c 2063 6f6e 7374  ctx_t CTX, const
│ │ │ │ │ -00007dd0: 2063 6861 7220 2a56 414c 293b 0a20 2020   char *VAL);.   
│ │ │ │ │ -00007de0: 2020 5365 7420 7468 6520 7261 6e64 6f6d    Set the random
│ │ │ │ │ -00007df0: 2076 616c 7565 2070 6f72 7469 6f6e 206f   value portion o
│ │ │ │ │ -00007e00: 6620 7468 6520 7370 6120 6461 7461 2074  f the spa data t
│ │ │ │ │ -00007e10: 6f20 7468 6520 6769 7665 6e20 7661 6c75  o the given valu
│ │ │ │ │ -00007e20: 650a 2020 2020 2028 5641 4c29 2e20 2054  e.     (VAL).  T
│ │ │ │ │ -00007e30: 6865 2067 6976 656e 2076 616c 7565 206d  he given value m
│ │ │ │ │ -00007e40: 7573 7420 6265 2061 2070 6f69 6e74 6572  ust be a pointer
│ │ │ │ │ -00007e50: 2074 6f20 6120 3136 2d63 6861 7261 6374   to a 16-charact
│ │ │ │ │ -00007e60: 6572 2064 6563 696d 616c 0a20 2020 2020  er decimal.     
│ │ │ │ │ -00007e70: 6e75 6d65 7269 6320 7374 7269 6e67 206f  numeric string o
│ │ │ │ │ -00007e80: 7220 4e55 4c4c 2e20 4966 2074 6865 2076  r NULL. If the v
│ │ │ │ │ -00007e90: 616c 7565 2069 7320 4e55 4c4c 2c20 7468  alue is NULL, th
│ │ │ │ │ -00007ea0: 6520 6675 6e63 7469 6f6e 2067 656e 6572  e function gener
│ │ │ │ │ -00007eb0: 6174 650a 2020 2020 2061 206e 6577 2072  ate.     a new r
│ │ │ │ │ -00007ec0: 616e 646f 6d20 7661 6c75 652e 2020 4966  andom value.  If
│ │ │ │ │ -00007ed0: 2061 2073 7472 696e 6720 7661 6c75 6520   a string value 
│ │ │ │ │ -00007ee0: 6973 2070 726f 7669 6465 642c 2069 7420  is provided, it 
│ │ │ │ │ -00007ef0: 6d75 7374 2062 6520 610a 2020 2020 2031  must be a.     1
│ │ │ │ │ -00007f00: 362d 6368 6172 6163 7465 7220 6465 6369  6-character deci
│ │ │ │ │ -00007f10: 6d61 6c20 7374 7269 6e67 2e20 204f 7468  mal string.  Oth
│ │ │ │ │ -00007f20: 6572 7769 7365 2c20 7468 6520 6675 6e63  erwise, the func
│ │ │ │ │ -00007f30: 7469 6f6e 2077 696c 6c20 7265 7475 726e  tion will return
│ │ │ │ │ -00007f40: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -00007f50: 5f49 4e56 414c 4944 5f44 4154 4127 2e0a  _INVALID_DATA'..
│ │ │ │ │ -00007f60: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ │ -00007f70: 6e74 2066 6b6f 5f73 6574 5f75 7365 726e  nt fko_set_usern
│ │ │ │ │ -00007f80: 616d 6520 2866 6b6f 5f63 7478 5f74 2043  ame (fko_ctx_t C
│ │ │ │ │ -00007f90: 5458 2c20 636f 6e73 7420 6368 6172 0a20  TX, const char. 
│ │ │ │ │ -00007fa0: 2020 2020 2020 2020 202a 5553 4552 4e41           *USERNA
│ │ │ │ │ -00007fb0: 4d45 293b 0a20 2020 2020 5365 7420 7468  ME);.     Set th
│ │ │ │ │ -00007fc0: 6520 7573 6572 6e61 6d65 2066 6965 6c64  e username field
│ │ │ │ │ -00007fd0: 206f 6620 7468 6520 5350 4120 6461 7461   of the SPA data
│ │ │ │ │ -00007fe0: 2e20 2049 6620 5553 4552 4e41 4d45 2069  .  If USERNAME i
│ │ │ │ │ -00007ff0: 7320 4e55 4c4c 2c0a 2020 2020 206c 6962  s NULL,.     lib
│ │ │ │ │ -00008000: 666b 6f20 7769 6c6c 2066 6972 7374 206c  fko will first l
│ │ │ │ │ -00008010: 6f6f 6b20 666f 7220 7468 6520 656e 7669  ook for the envi
│ │ │ │ │ -00008020: 726f 6e6d 656e 7420 7661 7269 6162 6c65  ronment variable
│ │ │ │ │ -00008030: 2027 5350 4f4f 465f 5553 4552 270a 2020   'SPOOF_USER'.  
│ │ │ │ │ -00008040: 2020 2061 6e64 2075 7365 2069 7473 2076     and use its v
│ │ │ │ │ -00008050: 616c 7565 2069 6620 666f 756e 642e 2020  alue if found.  
│ │ │ │ │ -00008060: 4f74 6865 7277 6973 652c 2069 7420 7769  Otherwise, it wi
│ │ │ │ │ -00008070: 6c6c 2074 7279 2074 6f20 6465 7465 726d  ll try to determ
│ │ │ │ │ -00008080: 696e 650a 2020 2020 2074 6865 2075 7365  ine.     the use
│ │ │ │ │ -00008090: 726e 616d 6520 6974 7365 6c66 2075 7369  rname itself usi
│ │ │ │ │ -000080a0: 6e67 2076 6172 696f 7573 206d 6574 686f  ng various metho
│ │ │ │ │ -000080b0: 6473 2073 7461 7274 696e 6720 7769 7468  ds starting with
│ │ │ │ │ -000080c0: 2027 6375 7365 7227 206f 720a 2020 2020   'cuser' or.    
│ │ │ │ │ -000080d0: 2027 6765 746c 6f67 696e 272c 2074 6865   'getlogin', the
│ │ │ │ │ -000080e0: 6e20 6661 6c6c 6261 636b 2074 6f20 7468  n fallback to th
│ │ │ │ │ -000080f0: 6520 656e 7669 726f 6e6d 656e 7420 7661  e environment va
│ │ │ │ │ -00008100: 7269 6162 6c65 7320 274c 4f47 4e41 4d45  riables 'LOGNAME
│ │ │ │ │ -00008110: 2720 6f72 0a20 2020 2020 2755 5345 5227  ' or.     'USER'
│ │ │ │ │ -00008120: 2e20 2049 6620 6e6f 6e65 206f 6620 7468  .  If none of th
│ │ │ │ │ -00008130: 6f73 6520 776f 726b 2c20 7468 6520 6675  ose work, the fu
│ │ │ │ │ -00008140: 6e63 7469 6f6e 2077 696c 6c20 7265 7475  nction will retu
│ │ │ │ │ -00008150: 726e 0a20 2020 2020 2746 4b4f 5f45 5252  rn.     'FKO_ERR
│ │ │ │ │ -00008160: 4f52 5f55 5345 524e 414d 455f 554e 4b4e  OR_USERNAME_UNKN
│ │ │ │ │ -00008170: 4f57 4e27 2e0a 0a20 2d2d 2046 756e 6374  OWN'... -- Funct
│ │ │ │ │ -00008180: 696f 6e3a 2069 6e74 2066 6b6f 5f73 6574  ion: int fko_set
│ │ │ │ │ -00008190: 5f74 696d 6573 7461 6d70 2028 666b 6f5f  _timestamp (fko_
│ │ │ │ │ -000081a0: 6374 785f 7420 4354 582c 2069 6e74 204f  ctx_t CTX, int O
│ │ │ │ │ -000081b0: 4646 5345 5429 3b0a 2020 2020 2053 6574  FFSET);.     Set
│ │ │ │ │ -000081c0: 7320 7468 6520 7469 6d65 7374 616d 7020  s the timestamp 
│ │ │ │ │ -000081d0: 7661 6c75 6520 6f66 2074 6865 2053 5041  value of the SPA
│ │ │ │ │ -000081e0: 2064 6174 6120 746f 2074 6865 2063 7572   data to the cur
│ │ │ │ │ -000081f0: 7265 6e74 2074 696d 6520 706c 7573 0a20  rent time plus. 
│ │ │ │ │ -00008200: 2020 2020 7468 6520 6f66 6673 6574 2076      the offset v
│ │ │ │ │ -00008210: 616c 7565 2e0a 0a20 2d2d 2046 756e 6374  alue... -- Funct
│ │ │ │ │ -00008220: 696f 6e3a 2069 6e74 2066 6b6f 5f73 6574  ion: int fko_set
│ │ │ │ │ -00008230: 5f73 7061 5f6d 6573 7361 6765 5f74 7970  _spa_message_typ
│ │ │ │ │ -00008240: 6520 2866 6b6f 5f63 7478 5f74 2043 5458  e (fko_ctx_t CTX
│ │ │ │ │ -00008250: 2c20 7368 6f72 740a 2020 2020 2020 2020  , short.        
│ │ │ │ │ -00008260: 2020 4d53 475f 5459 5045 293b 0a20 2020    MSG_TYPE);.   
│ │ │ │ │ -00008270: 2020 5365 7473 2074 6865 206d 6573 7361    Sets the messa
│ │ │ │ │ -00008280: 6765 2074 7970 6520 666f 7220 7468 6520  ge type for the 
│ │ │ │ │ -00008290: 5350 4120 6461 7461 2e20 2054 6865 2063  SPA data.  The c
│ │ │ │ │ -000082a0: 686f 6963 6573 2066 6f72 2074 6865 0a20  hoices for the. 
│ │ │ │ │ -000082b0: 2020 2020 2773 7061 5f6d 6573 7361 6765      'spa_message
│ │ │ │ │ -000082c0: 5f74 7970 6527 2061 7265 206c 6973 7465  _type' are liste
│ │ │ │ │ -000082d0: 6420 696e 202a 6e6f 7465 2053 5041 204d  d in *note SPA M
│ │ │ │ │ -000082e0: 6573 7361 6765 733a 3a2e 2020 466f 720a  essages::.  For.
│ │ │ │ │ -000082f0: 2020 2020 2065 7861 6d70 6c65 3a0a 2020       example:.  
│ │ │ │ │ -00008300: 2020 2020 2020 2020 2020 2020 7263 203d              rc =
│ │ │ │ │ -00008310: 2066 6b6f 5f73 6574 5f73 7061 5f6d 6573   fko_set_spa_mes
│ │ │ │ │ -00008320: 7361 6765 5f74 7970 6528 6374 782c 2046  sage_type(ctx, F
│ │ │ │ │ -00008330: 4b4f 5f41 4343 4553 535f 4d53 4729 3b0a  KO_ACCESS_MSG);.
│ │ │ │ │ -00008340: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ │ -00008350: 6e74 2066 6b6f 5f73 6574 5f73 7061 5f6d  nt fko_set_spa_m
│ │ │ │ │ -00008360: 6573 7361 6765 2028 666b 6f5f 6374 785f  essage (fko_ctx_
│ │ │ │ │ -00008370: 7420 4354 582c 2063 6f6e 7374 2063 6861  t CTX, const cha
│ │ │ │ │ -00008380: 720a 2020 2020 2020 2020 2020 2a4d 5347  r.          *MSG
│ │ │ │ │ -00008390: 5f53 5452 494e 4729 3b0a 2020 2020 2053  _STRING);.     S
│ │ │ │ │ -000083a0: 6574 2074 6865 2053 5041 206d 6573 7361  et the SPA messa
│ │ │ │ │ -000083b0: 6765 2073 7472 696e 6720 746f 2074 6865  ge string to the
│ │ │ │ │ -000083c0: 2067 6976 656e 2076 616c 7565 2e20 2049   given value.  I
│ │ │ │ │ -000083d0: 6620 7468 6973 2073 7472 696e 6720 646f  f this string do
│ │ │ │ │ -000083e0: 6573 0a20 2020 2020 6e6f 7420 636f 6e66  es.     not conf
│ │ │ │ │ -000083f0: 6f72 6d20 746f 2074 6865 2072 6571 7569  orm to the requi
│ │ │ │ │ -00008400: 7265 6420 2773 7061 5f6e 6174 5f61 6363  red 'spa_nat_acc
│ │ │ │ │ -00008410: 6573 7327 2066 6f72 6d61 742c 2074 6865  ess' format, the
│ │ │ │ │ -00008420: 2066 756e 6374 696f 6e0a 2020 2020 2077   function.     w
│ │ │ │ │ -00008430: 696c 6c20 7265 7475 726e 2027 464b 4f5f  ill return 'FKO_
│ │ │ │ │ -00008440: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ -00008450: 5441 272e 0a0a 202d 2d20 4675 6e63 7469  TA'... -- Functi
│ │ │ │ │ -00008460: 6f6e 3a20 696e 7420 666b 6f5f 7365 745f  on: int fko_set_
│ │ │ │ │ -00008470: 7370 615f 6e61 745f 6163 6365 7373 2028  spa_nat_access (
│ │ │ │ │ -00008480: 666b 6f5f 6374 785f 7420 4354 582c 2063  fko_ctx_t CTX, c
│ │ │ │ │ -00008490: 6f6e 7374 2063 6861 720a 2020 2020 2020  onst char.      
│ │ │ │ │ -000084a0: 2020 2020 2a4e 4154 5f41 4343 4553 5329      *NAT_ACCESS)
│ │ │ │ │ -000084b0: 3b0a 2020 2020 2053 6574 2074 6865 206f  ;.     Set the o
│ │ │ │ │ -000084c0: 7074 696f 6e61 6c20 5350 4120 6e61 7420  ptional SPA nat 
│ │ │ │ │ -000084d0: 6163 6365 7373 2073 7472 696e 6720 746f  access string to
│ │ │ │ │ -000084e0: 2074 6865 2067 6976 656e 2076 616c 7565   the given value
│ │ │ │ │ -000084f0: 2e20 2049 6620 7468 6973 0a20 2020 2020  .  If this.     
│ │ │ │ │ -00008500: 7374 7269 6e67 2064 6f65 7320 6e6f 7420  string does not 
│ │ │ │ │ -00008510: 636f 6e66 6f72 6d20 746f 2074 6865 2072  conform to the r
│ │ │ │ │ -00008520: 6571 7569 7265 6420 2773 7061 5f6e 6174  equired 'spa_nat
│ │ │ │ │ -00008530: 5f61 6363 6573 7327 2066 6f72 6d61 742c  _access' format,
│ │ │ │ │ -00008540: 0a20 2020 2020 7468 6520 6675 6e63 7469  .     the functi
│ │ │ │ │ -00008550: 6f6e 2077 696c 6c20 7265 7475 726e 2027  on will return '
│ │ │ │ │ -00008560: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ -00008570: 445f 4441 5441 272e 0a0a 202d 2d20 4675  D_DATA'... -- Fu
│ │ │ │ │ -00008580: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_
│ │ │ │ │ -00008590: 7365 745f 7370 615f 7365 7276 6572 5f61  set_spa_server_a
│ │ │ │ │ -000085a0: 7574 6820 2866 6b6f 5f63 7478 5f74 2043  uth (fko_ctx_t C
│ │ │ │ │ -000085b0: 5458 2c20 636f 6e73 7420 6368 6172 0a20  TX, const char. 
│ │ │ │ │ -000085c0: 2020 2020 2020 2020 202a 5345 5256 4552           *SERVER
│ │ │ │ │ -000085d0: 5f41 5554 4829 3b0a 2020 2020 2053 6574  _AUTH);.     Set
│ │ │ │ │ -000085e0: 2074 6865 206f 7074 696f 6e61 6c20 2876   the optional (v
│ │ │ │ │ -000085f0: 6572 7920 7365 6c64 6f6d 2075 7365 6429  ery seldom used)
│ │ │ │ │ -00008600: 2053 5041 2073 6572 7665 7220 6175 7468   SPA server auth
│ │ │ │ │ -00008610: 2066 6561 7475 7265 2074 6f20 7468 650a   feature to the.
│ │ │ │ │ -00008620: 2020 2020 2067 6976 656e 2076 616c 7565       given value
│ │ │ │ │ -00008630: 2e20 2054 6869 7320 7061 7261 6d65 7465  .  This paramete
│ │ │ │ │ -00008640: 7220 6d61 7920 6265 636f 6d65 2064 6570  r may become dep
│ │ │ │ │ -00008650: 7265 6361 7465 642e 0a0a 202d 2d20 4675  recated... -- Fu
│ │ │ │ │ -00008660: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_
│ │ │ │ │ -00008670: 7365 745f 7370 615f 636c 6965 6e74 5f74  set_spa_client_t
│ │ │ │ │ -00008680: 696d 656f 7574 2028 666b 6f5f 6374 785f  imeout (fko_ctx_
│ │ │ │ │ -00008690: 7420 4354 582c 2069 6e74 0a20 2020 2020  t CTX, int.     
│ │ │ │ │ -000086a0: 2020 2020 2054 494d 454f 5554 293b 0a20       TIMEOUT);. 
│ │ │ │ │ -000086b0: 2020 2020 5365 7473 2074 6865 2053 5041      Sets the SPA
│ │ │ │ │ -000086c0: 2063 6c69 656e 7420 7469 6d65 6f75 7420   client timeout 
│ │ │ │ │ -000086d0: 7661 6c75 652e 2020 4966 2074 6865 2074  value.  If the t
│ │ │ │ │ -000086e0: 696d 656f 7574 2069 7320 7365 7420 746f  imeout is set to
│ │ │ │ │ -000086f0: 2061 0a20 2020 2020 7661 6c75 6520 6772   a.     value gr
│ │ │ │ │ -00008700: 6561 7465 7220 7468 616e 2030 2c20 6974  eater than 0, it
│ │ │ │ │ -00008710: 2069 7320 6173 7375 6d65 6420 7468 6520   is assumed the 
│ │ │ │ │ -00008720: 2773 7061 5f6d 6573 7361 6765 5f74 7970  'spa_message_typ
│ │ │ │ │ -00008730: 6527 2073 6574 7469 6e67 0a20 2020 2020  e' setting.     
│ │ │ │ │ -00008740: 7368 6f75 6c64 2062 6520 6f6e 6520 6f66  should be one of
│ │ │ │ │ -00008750: 2074 6865 2022 5449 4d45 4f55 5422 2076   the "TIMEOUT" v
│ │ │ │ │ -00008760: 6172 6961 6e74 732e 2020 5468 6973 2066  ariants.  This f
│ │ │ │ │ -00008770: 756e 6374 696f 6e20 7769 6c6c 2063 6861  unction will cha
│ │ │ │ │ -00008780: 6e67 650a 2020 2020 2074 6865 2027 6d65  nge.     the 'me
│ │ │ │ │ -00008790: 7373 6167 655f 7479 7065 2720 746f 2074  ssage_type' to t
│ │ │ │ │ -000087a0: 6865 2061 7070 726f 7072 6961 7465 2073  he appropriate s
│ │ │ │ │ -000087b0: 6574 7469 6e67 2069 6620 6e65 6365 7373  etting if necess
│ │ │ │ │ -000087c0: 6172 792e 0a20 2020 2020 486f 7765 7665  ary..     Howeve
│ │ │ │ │ -000087d0: 722c 2069 7420 6973 2072 6563 6f6d 6d65  r, it is recomme
│ │ │ │ │ -000087e0: 6e64 6564 2079 6f75 2073 6574 2074 6865  nded you set the
│ │ │ │ │ -000087f0: 2063 6f72 7265 6374 2027 6d65 7373 6167   correct 'messag
│ │ │ │ │ -00008800: 655f 7479 7065 2720 6168 6561 640a 2020  e_type' ahead.  
│ │ │ │ │ -00008810: 2020 206f 6620 7469 6d65 2e0a 0a20 2d2d     of time... --
│ │ │ │ │ -00008820: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f
│ │ │ │ │ -00008830: 6b6f 5f73 6574 5f73 7061 5f64 6967 6573  ko_set_spa_diges
│ │ │ │ │ -00008840: 7420 2866 6b6f 5f63 7478 5f74 2043 5458  t (fko_ctx_t CTX
│ │ │ │ │ -00008850: 293b 0a20 2020 2020 496e 6974 6961 7465  );.     Initiate
│ │ │ │ │ -00008860: 7320 6120 6361 6c63 756c 6174 696f 6e20  s a calculation 
│ │ │ │ │ -00008870: 286f 7220 7265 6361 6c63 756c 6174 696f  (or recalculatio
│ │ │ │ │ -00008880: 6e29 206f 6620 7468 6520 6d65 7373 6167  n) of the messag
│ │ │ │ │ -00008890: 6520 6469 6765 7374 0a20 2020 2020 6861  e digest.     ha
│ │ │ │ │ -000088a0: 7368 2066 6f72 2074 6865 2063 7572 7265  sh for the curre
│ │ │ │ │ -000088b0: 6e74 2053 5041 2064 6174 612e 2020 4966  nt SPA data.  If
│ │ │ │ │ -000088c0: 2074 6865 2072 6571 7569 7265 6420 6461   the required da
│ │ │ │ │ -000088d0: 7461 2066 6965 6c64 7320 6172 6520 6e6f  ta fields are no
│ │ │ │ │ -000088e0: 740a 2020 2020 2073 6574 2074 6869 7320  t.     set this 
│ │ │ │ │ -000088f0: 6675 6e63 7469 6f6e 2077 696c 6c20 7265  function will re
│ │ │ │ │ -00008900: 7475 726e 2027 464b 4f5f 4552 524f 525f  turn 'FKO_ERROR_
│ │ │ │ │ -00008910: 4d49 5353 494e 475f 454e 434f 4445 445f  MISSING_ENCODED_
│ │ │ │ │ -00008920: 4441 5441 272e 0a20 2020 2020 2a4e 6f74  DATA'..     *Not
│ │ │ │ │ -00008930: 652a 3a20 4974 2073 686f 756c 6420 6e6f  e*: It should no
│ │ │ │ │ -00008940: 7420 6265 206e 6563 6573 7361 7279 2074  t be necessary t
│ │ │ │ │ -00008950: 6f20 6361 6c6c 2074 6869 7320 6675 6e63  o call this func
│ │ │ │ │ -00008960: 7469 6f6e 2064 6972 6563 746c 790a 2020  tion directly.  
│ │ │ │ │ -00008970: 2020 2061 7320 6974 2077 696c 6c20 6265     as it will be
│ │ │ │ │ -00008980: 2063 616c 6c65 6420 6175 746f 6d61 7469   called automati
│ │ │ │ │ -00008990: 6361 6c6c 7920 6279 206f 7468 6572 2066  cally by other f
│ │ │ │ │ -000089a0: 756e 6374 696f 6e73 2064 7572 696e 6720  unctions during 
│ │ │ │ │ -000089b0: 6e6f 726d 616c 0a20 2020 2020 7072 6f63  normal.     proc
│ │ │ │ │ -000089c0: 6573 7369 6e67 2028 6d6f 7374 206e 6f74  essing (most not
│ │ │ │ │ -000089d0: 6162 6c79 2027 666b 6f5f 7370 615f 6461  ably 'fko_spa_da
│ │ │ │ │ -000089e0: 7461 5f66 696e 616c 2729 2e0a 0a20 2d2d  ta_final')... --
│ │ │ │ │ -000089f0: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f
│ │ │ │ │ -00008a00: 6b6f 5f73 6574 5f73 7061 5f68 6d61 6320  ko_set_spa_hmac 
│ │ │ │ │ -00008a10: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, 
│ │ │ │ │ -00008a20: 636f 6e73 7420 6368 6172 202a 484d 4143  const char *HMAC
│ │ │ │ │ -00008a30: 5f4b 4559 2c0a 2020 2020 2020 2020 2020  _KEY,.          
│ │ │ │ │ -00008a40: 636f 6e73 7420 696e 7420 484d 4143 5f4b  const int HMAC_K
│ │ │ │ │ -00008a50: 4559 5f4c 454e 293b 0a20 2020 2020 496e  EY_LEN);.     In
│ │ │ │ │ -00008a60: 6974 6961 7465 7320 6120 6361 6c63 756c  itiates a calcul
│ │ │ │ │ -00008a70: 6174 696f 6e20 286f 7220 7265 6361 6c63  ation (or recalc
│ │ │ │ │ -00008a80: 756c 6174 696f 6e29 206f 6620 7468 6520  ulation) of the 
│ │ │ │ │ -00008a90: 6d65 7373 6167 6520 484d 4143 2066 6f72  message HMAC for
│ │ │ │ │ -00008aa0: 0a20 2020 2020 7468 6520 6375 7272 656e  .     the curren
│ │ │ │ │ -00008ab0: 7420 5350 4120 6461 7461 2e20 202a 4e6f  t SPA data.  *No
│ │ │ │ │ -00008ac0: 7465 2a3a 2049 7420 7368 6f75 6c64 206e  te*: It should n
│ │ │ │ │ -00008ad0: 6f74 2062 6520 6e65 6365 7373 6172 7920  ot be necessary 
│ │ │ │ │ -00008ae0: 746f 2063 616c 6c0a 2020 2020 2074 6869  to call.     thi
│ │ │ │ │ -00008af0: 7320 6675 6e63 7469 6f6e 2064 6972 6563  s function direc
│ │ │ │ │ -00008b00: 746c 7920 6173 2069 7420 7769 6c6c 2062  tly as it will b
│ │ │ │ │ -00008b10: 6520 6361 6c6c 6564 2061 7574 6f6d 6174  e called automat
│ │ │ │ │ -00008b20: 6963 616c 6c79 2062 7920 6f74 6865 720a  ically by other.
│ │ │ │ │ -00008b30: 2020 2020 2066 756e 6374 696f 6e73 2064       functions d
│ │ │ │ │ -00008b40: 7572 696e 6720 6e6f 726d 616c 2070 726f  uring normal pro
│ │ │ │ │ -00008b50: 6365 7373 696e 6720 286d 6f73 7420 6e6f  cessing (most no
│ │ │ │ │ -00008b60: 7461 626c 790a 2020 2020 2027 666b 6f5f  tably.     'fko_
│ │ │ │ │ -00008b70: 7370 615f 6461 7461 5f66 696e 616c 2729  spa_data_final')
│ │ │ │ │ -00008b80: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:
│ │ │ │ │ -00008b90: 2069 6e74 2066 6b6f 5f73 6574 5f73 7061   int fko_set_spa
│ │ │ │ │ -00008ba0: 5f64 6174 6120 2866 6b6f 5f63 7478 5f74  _data (fko_ctx_t
│ │ │ │ │ -00008bb0: 2043 5458 2c20 6368 6172 202a 454e 435f   CTX, char *ENC_
│ │ │ │ │ -00008bc0: 4441 5441 293b 0a20 2020 2020 5468 6973  DATA);.     This
│ │ │ │ │ -00008bd0: 2066 756e 6374 696f 6e20 6973 2075 7365   function is use
│ │ │ │ │ -00008be0: 6420 746f 2070 6c61 6365 2065 6e63 7279  d to place encry
│ │ │ │ │ -00008bf0: 7074 6564 2053 5041 2064 6174 6120 696e  pted SPA data in
│ │ │ │ │ -00008c00: 746f 2061 206e 6577 6c79 0a20 2020 2020  to a newly.     
│ │ │ │ │ -00008c10: 6372 6561 7465 6420 656d 7074 7920 636f  created empty co
│ │ │ │ │ -00008c20: 6e74 6578 7420 2869 2e65 2e20 2077 6974  ntext (i.e.  wit
│ │ │ │ │ -00008c30: 6820 2766 6b6f 5f6e 6577 2729 2e20 2049  h 'fko_new').  I
│ │ │ │ │ -00008c40: 6e20 6d6f 7374 2063 6173 6573 2c20 796f  n most cases, yo
│ │ │ │ │ -00008c50: 750a 2020 2020 2077 6f75 6c64 2075 7365  u.     would use
│ │ │ │ │ -00008c60: 2027 666b 6f5f 6e65 775f 7769 7468 5f64   'fko_new_with_d
│ │ │ │ │ -00008c70: 6174 6127 2073 6f20 796f 7520 776f 756c  ata' so you woul
│ │ │ │ │ -00008c80: 646e 2774 2068 6176 6520 746f 2074 616b  dn't have to tak
│ │ │ │ │ -00008c90: 6520 7468 650a 2020 2020 2065 7874 7261  e the.     extra
│ │ │ │ │ -00008ca0: 2073 7465 7020 746f 2075 7365 2074 6869   step to use thi
│ │ │ │ │ -00008cb0: 7320 6675 6e63 7469 6f6e 2e20 2048 6f77  s function.  How
│ │ │ │ │ -00008cc0: 6576 6572 2c20 736f 6d65 206d 6179 2066  ever, some may f
│ │ │ │ │ -00008cd0: 696e 6420 6120 7265 6173 6f6e 0a20 2020  ind a reason.   
│ │ │ │ │ -00008ce0: 2020 746f 2064 6f20 6974 2069 6e20 7468    to do it in th
│ │ │ │ │ -00008cf0: 6973 2077 6179 2e0a 0a5f 4750 472d 7370  is way..._GPG-sp
│ │ │ │ │ -00008d00: 6563 6966 6963 2066 756e 6374 696f 6e73  ecific functions
│ │ │ │ │ -00008d10: 3a5f 0a0a 202d 2d20 4675 6e63 7469 6f6e  :_.. -- Function
│ │ │ │ │ -00008d20: 3a20 696e 7420 666b 6f5f 7365 745f 6770  : int fko_set_gp
│ │ │ │ │ -00008d30: 675f 7265 6369 7069 656e 7420 2866 6b6f  g_recipient (fko
│ │ │ │ │ -00008d40: 5f63 7478 5f74 2043 5458 2c20 636f 6e73  _ctx_t CTX, cons
│ │ │ │ │ -00008d50: 7420 6368 6172 0a20 2020 2020 2020 2020  t char.         
│ │ │ │ │ -00008d60: 2052 4543 4950 4945 4e54 293b 0a20 2020   RECIPIENT);.   
│ │ │ │ │ -00008d70: 2020 5365 7473 2074 6865 2047 5047 206b    Sets the GPG k
│ │ │ │ │ -00008d80: 6579 2066 6f72 2074 6865 2072 6563 6970  ey for the recip
│ │ │ │ │ -00008d90: 6965 6e74 2e20 2054 6869 7320 776f 756c  ient.  This woul
│ │ │ │ │ -00008da0: 6420 6265 2074 6865 2072 6563 6970 6965  d be the recipie
│ │ │ │ │ -00008db0: 6e74 2773 0a20 2020 2020 7075 626c 6963  nt's.     public
│ │ │ │ │ -00008dc0: 206b 6579 2075 7365 6420 746f 2065 6e63   key used to enc
│ │ │ │ │ -00008dd0: 7972 7074 2074 6865 2053 5041 2064 6174  yrpt the SPA dat
│ │ │ │ │ -00008de0: 612e 2020 596f 7520 6361 6e20 7573 6520  a.  You can use 
│ │ │ │ │ -00008df0: 7468 6520 7573 6572 206e 616d 650a 2020  the user name.  
│ │ │ │ │ -00008e00: 2020 2028 2272 6563 6970 4074 6865 2e64     ("recip@the.d
│ │ │ │ │ -00008e10: 6573 742e 636f 6d22 2920 6f72 2074 6865  est.com") or the
│ │ │ │ │ -00008e20: 206b 6579 2049 4420 2822 3545 5858 5858   key ID ("5EXXXX
│ │ │ │ │ -00008e30: 4343 2229 2e20 4174 2070 7265 7365 6e74  CC"). At present
│ │ │ │ │ -00008e40: 2c0a 2020 2020 206d 756c 7469 706c 6520  ,.     multiple 
│ │ │ │ │ -00008e50: 7265 6369 7069 656e 7473 2061 7265 206e  recipients are n
│ │ │ │ │ -00008e60: 6f74 2073 7570 706f 7274 6564 2e0a 0a20  ot supported... 
│ │ │ │ │ -00008e70: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ │ -00008e80: 2066 6b6f 5f73 6574 5f67 7067 5f73 6967   fko_set_gpg_sig
│ │ │ │ │ -00008e90: 6e65 7220 2866 6b6f 5f63 7478 5f74 2043  ner (fko_ctx_t C
│ │ │ │ │ -00008ea0: 5458 2c20 636f 6e73 7420 6368 6172 2053  TX, const char S
│ │ │ │ │ -00008eb0: 4947 4e45 5229 3b0a 2020 2020 2053 6574  IGNER);.     Set
│ │ │ │ │ -00008ec0: 7320 7468 6520 4750 4720 6b65 7920 666f  s the GPG key fo
│ │ │ │ │ -00008ed0: 7220 7369 676e 696e 6720 7468 6520 6461  r signing the da
│ │ │ │ │ -00008ee0: 7461 2e20 2054 6869 7320 776f 756c 6420  ta.  This would 
│ │ │ │ │ -00008ef0: 6265 2074 6865 2073 656e 6465 7227 730a  be the sender's.
│ │ │ │ │ -00008f00: 2020 2020 206b 6579 2075 7365 6420 746f       key used to
│ │ │ │ │ -00008f10: 2073 6967 6e20 7468 6520 5350 4120 6461   sign the SPA da
│ │ │ │ │ -00008f20: 7461 2e20 2059 6f75 2063 616e 2075 7365  ta.  You can use
│ │ │ │ │ -00008f30: 2074 6865 2075 7365 7220 6e61 6d65 206f   the user name o
│ │ │ │ │ -00008f40: 7220 6b65 790a 2020 2020 2049 442e 0a0a  r key.     ID...
│ │ │ │ │ -00008f50: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ │ -00008f60: 7420 666b 6f5f 7365 745f 6770 675f 686f  t fko_set_gpg_ho
│ │ │ │ │ -00008f70: 6d65 5f64 6972 2028 666b 6f5f 6374 785f  me_dir (fko_ctx_
│ │ │ │ │ -00008f80: 7420 4354 582c 2063 6f6e 7374 2063 6861  t CTX, const cha
│ │ │ │ │ -00008f90: 720a 2020 2020 2020 2020 2020 484f 4d45  r.          HOME
│ │ │ │ │ -00008fa0: 5f44 4952 293b 0a20 2020 2020 5365 7473  _DIR);.     Sets
│ │ │ │ │ -00008fb0: 2074 6865 2047 5047 2068 6f6d 6520 6469   the GPG home di
│ │ │ │ │ -00008fc0: 7265 6374 6f72 7920 666f 7220 7468 6520  rectory for the 
│ │ │ │ │ -00008fd0: 6375 7272 656e 7420 6770 676d 6520 636f  current gpgme co
│ │ │ │ │ -00008fe0: 6e74 6578 742e 2020 5468 6973 0a20 2020  ntext.  This.   
│ │ │ │ │ -00008ff0: 2020 616c 6c6f 7773 2066 6f72 2075 7369    allows for usi
│ │ │ │ │ -00009000: 6e67 2061 6c74 6572 6e61 7465 206b 6579  ng alternate key
│ │ │ │ │ -00009010: 7269 6e67 732c 2067 7067 2063 6f6e 6669  rings, gpg confi
│ │ │ │ │ -00009020: 6775 7261 7469 6f6e 732c 2065 7463 2e0a  gurations, etc..
│ │ │ │ │ -00009030: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ │ -00009040: 6e74 2066 6b6f 5f73 6574 5f67 7067 5f73  nt fko_set_gpg_s
│ │ │ │ │ -00009050: 6967 6e61 7475 7265 5f76 6572 6966 7920  ignature_verify 
│ │ │ │ │ -00009060: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, 
│ │ │ │ │ -00009070: 756e 7369 676e 6564 0a20 2020 2020 2020  unsigned.       
│ │ │ │ │ -00009080: 2020 2063 6861 7220 5645 5249 4659 293b     char VERIFY);
│ │ │ │ │ -00009090: 0a20 2020 2020 5365 7473 2074 6865 2076  .     Sets the v
│ │ │ │ │ -000090a0: 6572 6966 7920 4750 4720 7369 676e 6174  erify GPG signat
│ │ │ │ │ -000090b0: 7572 6520 666c 6167 2e20 2057 6865 6e20  ure flag.  When 
│ │ │ │ │ -000090c0: 7365 7420 746f 2061 2074 7275 6520 7661  set to a true va
│ │ │ │ │ -000090d0: 6c75 652c 2074 6865 0a20 2020 2020 4750  lue, the.     GP
│ │ │ │ │ -000090e0: 4720 7369 676e 6174 7572 6520 6973 2065  G signature is e
│ │ │ │ │ -000090f0: 7874 7261 6374 6564 2061 6e64 2063 6865  xtracted and che
│ │ │ │ │ -00009100: 636b 6564 2066 6f72 2076 616c 6964 6974  cked for validit
│ │ │ │ │ -00009110: 7920 6475 7269 6e67 2074 6865 0a20 2020  y during the.   
│ │ │ │ │ -00009120: 2020 6465 6372 7970 7469 6f6e 2f64 6563    decryption/dec
│ │ │ │ │ -00009130: 6f64 696e 6720 7068 6173 652e 2020 5768  oding phase.  Wh
│ │ │ │ │ -00009140: 656e 2073 6574 2074 6f20 6661 6c73 652c  en set to false,
│ │ │ │ │ -00009150: 206e 6f20 6174 7465 6d70 7420 6973 206d   no attempt is m
│ │ │ │ │ -00009160: 6164 650a 2020 2020 2074 6f20 6163 6365  ade.     to acce
│ │ │ │ │ -00009170: 7373 206f 7220 6368 6563 6b20 7468 6520  ss or check the 
│ │ │ │ │ -00009180: 7369 676e 6174 7572 652e 2020 5468 6973  signature.  This
│ │ │ │ │ -00009190: 2066 6c61 6720 6973 2073 6574 2074 6f20   flag is set to 
│ │ │ │ │ -000091a0: 7472 7565 2062 790a 2020 2020 2064 6566  true by.     def
│ │ │ │ │ -000091b0: 6175 6c74 2e0a 0a20 2d2d 2046 756e 6374  ault... -- Funct
│ │ │ │ │ -000091c0: 696f 6e3a 2069 6e74 2066 6b6f 5f73 6574  ion: int fko_set
│ │ │ │ │ -000091d0: 5f67 7067 5f69 676e 6f72 655f 7665 7269  _gpg_ignore_veri
│ │ │ │ │ -000091e0: 6679 5f65 7272 6f72 2028 666b 6f5f 6374  fy_error (fko_ct
│ │ │ │ │ -000091f0: 785f 7420 4354 582c 0a20 2020 2020 2020  x_t CTX,.       
│ │ │ │ │ -00009200: 2020 2075 6e73 6967 6e65 6420 6368 6172     unsigned char
│ │ │ │ │ -00009210: 2049 474e 4f52 4529 3b0a 2020 2020 2053   IGNORE);.     S
│ │ │ │ │ -00009220: 6574 7320 7468 6520 6967 6e6f 7265 2073  ets the ignore s
│ │ │ │ │ -00009230: 6967 6e61 7475 7265 2076 6572 6966 7920  ignature verify 
│ │ │ │ │ -00009240: 6572 726f 7220 666c 6167 2e20 2057 6865  error flag.  Whe
│ │ │ │ │ -00009250: 6e20 7365 7420 746f 2061 2074 7275 650a  n set to a true.
│ │ │ │ │ -00009260: 2020 2020 2076 616c 7565 2e20 2041 6e79       value.  Any
│ │ │ │ │ -00009270: 2073 6967 6e61 7475 7265 2076 6572 6966   signature verif
│ │ │ │ │ -00009280: 6963 6174 696f 6e20 6572 726f 7273 2061  ication errors a
│ │ │ │ │ -00009290: 7265 2069 676e 6f72 6564 2028 6275 7420  re ignored (but 
│ │ │ │ │ -000092a0: 7374 696c 6c0a 2020 2020 2063 6170 7475  still.     captu
│ │ │ │ │ -000092b0: 7265 6429 2061 6e64 2074 6865 2064 6563  red) and the dec
│ │ │ │ │ -000092c0: 6f64 696e 6720 7072 6f63 6573 7320 7769  oding process wi
│ │ │ │ │ -000092d0: 6c6c 2063 6f6e 7469 6e75 652e 2020 5468  ll continue.  Th
│ │ │ │ │ -000092e0: 6520 6465 6661 756c 740a 2020 2020 2076  e default.     v
│ │ │ │ │ -000092f0: 616c 7565 206f 6620 7468 6973 2066 6c61  alue of this fla
│ │ │ │ │ -00009300: 6720 6973 2066 616c 7365 2e0a 0a20 2d2d  g is false... --
│ │ │ │ │ -00009310: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f
│ │ │ │ │ -00009320: 6b6f 5f73 6574 5f67 7067 5f65 7865 2028  ko_set_gpg_exe (
│ │ │ │ │ -00009330: 666b 6f5f 6374 785f 7420 4354 582c 2063  fko_ctx_t CTX, c
│ │ │ │ │ -00009340: 6f6e 7374 2063 6861 7220 4750 475f 4558  onst char GPG_EX
│ │ │ │ │ -00009350: 4529 3b0a 2020 2020 2053 6574 7320 7468  E);.     Sets th
│ │ │ │ │ -00009360: 6520 7061 7468 2074 6f20 7468 6520 4750  e path to the GP
│ │ │ │ │ -00009370: 4720 6578 6563 7574 6162 6c65 2074 6861  G executable tha
│ │ │ │ │ -00009380: 7420 5f67 7067 6d65 5f20 7769 6c6c 2075  t _gpgme_ will u
│ │ │ │ │ -00009390: 7365 2e20 2042 790a 2020 2020 2064 6566  se.  By.     def
│ │ │ │ │ -000093a0: 6175 6c74 2c20 5f6c 6962 666b 6f5f 2066  ault, _libfko_ f
│ │ │ │ │ -000093b0: 6f72 6365 7320 5f67 7067 6d65 5f20 746f  orces _gpgme_ to
│ │ │ │ │ -000093c0: 2075 7365 2027 6770 6727 2069 6e20 6361   use 'gpg' in ca
│ │ │ │ │ -000093d0: 7365 205f 6770 676d 655f 2077 6173 0a20  se _gpgme_ was. 
│ │ │ │ │ -000093e0: 2020 2020 636f 6d70 696c 6564 2074 6f20      compiled to 
│ │ │ │ │ -000093f0: 7573 6520 2767 7067 3227 2061 7320 6974  use 'gpg2' as it
│ │ │ │ │ -00009400: 7320 6465 6661 756c 7420 656e 6769 6e65  s default engine
│ │ │ │ │ -00009410: 2e20 2059 6f75 2063 616e 2075 7365 2074  .  You can use t
│ │ │ │ │ -00009420: 6869 730a 2020 2020 2066 756e 6374 696f  his.     functio
│ │ │ │ │ -00009430: 6e20 746f 206f 7665 7272 6964 6520 616e  n to override an
│ │ │ │ │ -00009440: 6420 7365 7420 7768 6174 2047 5047 2065  d set what GPG e
│ │ │ │ │ -00009450: 7865 6375 7461 626c 6520 5f67 7067 6d65  xecutable _gpgme
│ │ │ │ │ -00009460: 5f20 7769 6c6c 2075 7365 2e0a 0a2a 4e6f  _ will use...*No
│ │ │ │ │ -00009470: 7465 2a3a 204f 6e20 6120 6c69 6266 6b6f  te*: On a libfko
│ │ │ │ │ -00009480: 2062 7569 6c64 2077 6974 686f 7574 2047   build without G
│ │ │ │ │ -00009490: 5047 2073 7570 706f 7274 2c20 7468 6520  PG support, the 
│ │ │ │ │ -000094a0: 4750 472d 7265 6c61 7465 6420 6675 6e63  GPG-related func
│ │ │ │ │ -000094b0: 7469 6f6e 730a 6162 6f76 6520 7769 6c6c  tions.above will
│ │ │ │ │ -000094c0: 2073 696d 706c 7920 7265 7475 726e 2074   simply return t
│ │ │ │ │ -000094d0: 6865 2046 4b4f 5f45 5252 4f52 5f55 4e53  he FKO_ERROR_UNS
│ │ │ │ │ -000094e0: 5550 504f 5254 4544 5f46 4541 5455 5245  UPPORTED_FEATURE
│ │ │ │ │ -000094f0: 2065 7272 6f72 2063 6f64 652e 0a0a 1f0a   error code.....
│ │ │ │ │ -00009500: 4669 6c65 3a20 6c69 6266 6b6f 2e69 6e66  File: libfko.inf
│ │ │ │ │ -00009510: 6f2c 2020 4e6f 6465 3a20 5265 7472 6965  o,  Node: Retrie
│ │ │ │ │ -00009520: 7669 6e67 2053 5041 2044 6174 612c 2020  ving SPA Data,  
│ │ │ │ │ -00009530: 4e65 7874 3a20 5574 696c 6974 7920 4675  Next: Utility Fu
│ │ │ │ │ -00009540: 6e63 7469 6f6e 732c 2020 5072 6576 3a20  nctions,  Prev: 
│ │ │ │ │ -00009550: 5365 7474 696e 6720 5350 4120 4461 7461  Setting SPA Data
│ │ │ │ │ -00009560: 2c20 2055 703a 2055 7369 6e67 206c 6962  ,  Up: Using lib
│ │ │ │ │ -00009570: 666b 6f0a 0a33 2e35 2052 6574 7269 6576  fko..3.5 Retriev
│ │ │ │ │ -00009580: 696e 6720 5350 4120 4461 7461 0a3d 3d3d  ing SPA Data.===
│ │ │ │ │ +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.=====
│ │ │ │ │  00009590: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ │ -000095a0: 3d3d 3d3d 0a0a 5468 6973 2073 6563 7469  ====..This secti
│ │ │ │ │ -000095b0: 6f6e 2064 6573 6372 6962 6573 2074 6865  on describes the
│ │ │ │ │ -000095c0: 2066 756e 6374 696f 6e73 2075 7365 6420   functions used 
│ │ │ │ │ -000095d0: 666f 7220 7265 7472 6965 7669 6e67 2074  for retrieving t
│ │ │ │ │ -000095e0: 6865 2076 6172 696f 7573 2053 5041 0a64  he various SPA.d
│ │ │ │ │ -000095f0: 6174 6120 6669 656c 6473 2061 6e64 2070  ata fields and p
│ │ │ │ │ -00009600: 6172 616d 6574 6572 7320 7365 7474 696e  arameters settin
│ │ │ │ │ -00009610: 6773 2e20 2054 6865 7920 616c 6c20 7265  gs.  They all re
│ │ │ │ │ -00009620: 7475 726e 2061 6e20 464b 4f20 6572 726f  turn an FKO erro
│ │ │ │ │ -00009630: 7220 636f 6465 2e0a 5468 6520 7661 6c75  r code..The valu
│ │ │ │ │ -00009640: 6520 6f66 2074 6865 2072 6573 7065 6374  e of the respect
│ │ │ │ │ -00009650: 6976 6520 6669 656c 6420 6f72 2070 6172  ive field or par
│ │ │ │ │ -00009660: 6d65 7465 7220 7468 6174 2069 7320 6265  meter that is be
│ │ │ │ │ -00009670: 696e 6720 7265 7472 6965 7665 640a 7769  ing retrieved.wi
│ │ │ │ │ -00009680: 6c6c 2070 6c61 6365 6420 696e 746f 2074  ll placed into t
│ │ │ │ │ -00009690: 6865 2076 6172 6961 626c 6573 2077 686f  he variables who
│ │ │ │ │ -000096a0: 7365 2061 6464 7265 7373 6573 2061 7265  se addresses are
│ │ │ │ │ -000096b0: 2070 6173 7365 6420 746f 2074 6865 0a66   passed to the.f
│ │ │ │ │ -000096c0: 756e 6374 696f 6e2e 0a0a 202d 2d20 4675  unction... -- Fu
│ │ │ │ │ -000096d0: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_
│ │ │ │ │ -000096e0: 6765 745f 7370 615f 6461 7461 2028 666b  get_spa_data (fk
│ │ │ │ │ -000096f0: 6f5f 6374 785f 7420 4354 582c 2063 6861  o_ctx_t CTX, cha
│ │ │ │ │ -00009700: 7220 2a2a 5350 415f 4441 5441 293b 0a20  r **SPA_DATA);. 
│ │ │ │ │ -00009710: 2020 2020 4173 7369 676e 7320 7468 6520      Assigns the 
│ │ │ │ │ -00009720: 706f 696e 7465 7220 746f 2074 6865 2073  pointer to the s
│ │ │ │ │ -00009730: 7472 696e 6720 686f 6c64 696e 6720 7468  tring holding th
│ │ │ │ │ -00009740: 6520 6669 6e61 6c20 656e 6372 7970 7465  e final encrypte
│ │ │ │ │ -00009750: 6420 5350 410a 2020 2020 2064 6174 6120  d SPA.     data 
│ │ │ │ │ -00009760: 746f 2074 6865 2061 6464 7265 7373 2053  to the address S
│ │ │ │ │ -00009770: 5041 5f44 4154 4120 6973 2070 6f69 6e74  PA_DATA is point
│ │ │ │ │ -00009780: 696e 6720 746f 2e20 2054 6869 7320 6973  ing to.  This is
│ │ │ │ │ -00009790: 2074 6865 2064 6174 6120 7468 6174 0a20   the data that. 
│ │ │ │ │ -000097a0: 2020 2020 776f 756c 6420 6265 2070 6163      would be pac
│ │ │ │ │ -000097b0: 6b61 6765 6420 696e 746f 2061 2070 6163  kaged into a pac
│ │ │ │ │ -000097c0: 6b65 7420 616e 6420 7365 6e74 2074 6f20  ket and sent to 
│ │ │ │ │ -000097d0: 616e 2066 776b 6e6f 7020 7365 7276 6572  an fwknop server
│ │ │ │ │ -000097e0: 2e20 2054 6865 0a20 2020 2020 7265 7475  .  The.     retu
│ │ │ │ │ -000097f0: 726e 2076 616c 7565 2069 7320 616e 2046  rn value is an F
│ │ │ │ │ -00009800: 4b4f 2065 7272 6f72 2073 7461 7475 732e  KO error status.
│ │ │ │ │ -00009810: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ │ -00009820: 696e 7420 666b 6f5f 6765 745f 7261 6e64  int fko_get_rand
│ │ │ │ │ -00009830: 5f76 616c 7565 2028 666b 6f5f 6374 785f  _value (fko_ctx_
│ │ │ │ │ -00009840: 7420 4354 582c 2063 6861 7220 2a2a 5241  t CTX, char **RA
│ │ │ │ │ -00009850: 4e44 5f56 414c 293b 0a20 2020 2020 4173  ND_VAL);.     As
│ │ │ │ │ -00009860: 7369 676e 7320 7468 6520 706f 696e 7465  signs the pointe
│ │ │ │ │ -00009870: 7220 746f 2074 6865 2073 7472 696e 6720  r to the string 
│ │ │ │ │ -00009880: 686f 6c64 696e 6720 7468 6520 7261 6e64  holding the rand
│ │ │ │ │ -00009890: 6f6d 2031 362d 6368 6172 6163 7465 720a  om 16-character.
│ │ │ │ │ -000098a0: 2020 2020 2064 6563 696d 616c 206e 756d       decimal num
│ │ │ │ │ -000098b0: 6265 7220 2827 7261 6e64 5f76 616c 2729  ber ('rand_val')
│ │ │ │ │ -000098c0: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with
│ │ │ │ │ -000098d0: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con
│ │ │ │ │ -000098e0: 7465 7874 2074 6f0a 2020 2020 2074 6865  text to.     the
│ │ │ │ │ -000098f0: 2061 6464 7265 7373 2052 414e 445f 5641   address RAND_VA
│ │ │ │ │ -00009900: 4c20 6973 2070 6f69 6e74 696e 6720 746f  L is pointing to
│ │ │ │ │ -00009910: 2e20 2054 6865 2072 6574 7572 6e20 7661  .  The return va
│ │ │ │ │ -00009920: 6c75 6520 6973 2061 6e20 464b 4f0a 2020  lue is an FKO.  
│ │ │ │ │ -00009930: 2020 2065 7272 6f72 2073 7461 7475 732e     error status.
│ │ │ │ │ -00009940: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ │ -00009950: 696e 7420 666b 6f5f 6765 745f 7573 6572  int fko_get_user
│ │ │ │ │ -00009960: 6e61 6d65 2028 666b 6f5f 6374 785f 7420  name (fko_ctx_t 
│ │ │ │ │ -00009970: 4354 582c 2063 6861 7220 2a2a 5553 4552  CTX, char **USER
│ │ │ │ │ -00009980: 4e41 4d45 293b 0a20 2020 2020 4173 7369  NAME);.     Assi
│ │ │ │ │ -00009990: 676e 7320 7468 6520 706f 696e 7465 7220  gns the pointer 
│ │ │ │ │ -000099a0: 746f 2074 6865 2073 7472 696e 6720 686f  to the string ho
│ │ │ │ │ -000099b0: 6c64 696e 6720 7468 6520 7573 6572 6e61  lding the userna
│ │ │ │ │ -000099c0: 6d65 2061 7373 6f63 6961 7465 640a 2020  me associated.  
│ │ │ │ │ -000099d0: 2020 2077 6974 6820 7468 6520 6375 7272     with the curr
│ │ │ │ │ -000099e0: 656e 7420 636f 6e74 6578 7420 746f 2074  ent context to t
│ │ │ │ │ -000099f0: 6865 2061 6464 7265 7373 2052 414e 445f  he address RAND_
│ │ │ │ │ -00009a00: 5641 4c20 6973 2070 6f69 6e74 696e 6720  VAL is pointing 
│ │ │ │ │ -00009a10: 746f 2e0a 2020 2020 2054 6865 2072 6574  to..     The ret
│ │ │ │ │ -00009a20: 7572 6e20 7661 6c75 6520 6973 2061 6e20  urn value is an 
│ │ │ │ │ -00009a30: 464b 4f20 6572 726f 7220 7374 6174 7573  FKO error status
│ │ │ │ │ -00009a40: 2e0a 0a20 2d2d 2046 756e 6374 696f 6e3a  ... -- Function:
│ │ │ │ │ -00009a50: 2069 6e74 2066 6b6f 5f67 6574 5f74 696d   int fko_get_tim
│ │ │ │ │ -00009a60: 6573 7461 6d70 2028 666b 6f5f 6374 785f  estamp (fko_ctx_
│ │ │ │ │ -00009a70: 7420 4354 582c 2074 696d 655f 7420 2a54  t CTX, time_t *T
│ │ │ │ │ -00009a80: 494d 4553 5441 4d50 293b 0a20 2020 2020  IMESTAMP);.     
│ │ │ │ │ -00009a90: 5365 7473 2074 6865 2076 616c 7565 206f  Sets the value o
│ │ │ │ │ -00009aa0: 6620 7468 6520 5449 4d45 5354 414d 5020  f the TIMESTAMP 
│ │ │ │ │ -00009ab0: 7661 7269 6162 6c65 2074 6f20 7468 6520  variable to the 
│ │ │ │ │ -00009ac0: 7469 6d65 7374 616d 7020 7661 6c75 650a  timestamp value.
│ │ │ │ │ -00009ad0: 2020 2020 2061 7373 6f63 6961 7465 6420       associated 
│ │ │ │ │ -00009ae0: 7769 7468 2074 6865 2063 7572 7265 6e74  with the current
│ │ │ │ │ -00009af0: 2063 6f6e 7465 7874 2e20 2054 6865 2072   context.  The r
│ │ │ │ │ -00009b00: 6574 7572 6e20 7661 6c75 6520 6973 2061  eturn value is a
│ │ │ │ │ -00009b10: 6e20 464b 4f0a 2020 2020 2065 7272 6f72  n FKO.     error
│ │ │ │ │ -00009b20: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu
│ │ │ │ │ -00009b30: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_
│ │ │ │ │ -00009b40: 6765 745f 7370 615f 6d65 7373 6167 655f  get_spa_message_
│ │ │ │ │ -00009b50: 7479 7065 2028 666b 6f5f 6374 785f 7420  type (fko_ctx_t 
│ │ │ │ │ -00009b60: 4354 582c 2073 686f 7274 0a20 2020 2020  CTX, short.     
│ │ │ │ │ -00009b70: 2020 2020 202a 4d53 475f 5459 5045 293b       *MSG_TYPE);
│ │ │ │ │ -00009b80: 0a20 2020 2020 5365 7473 2074 6865 2076  .     Sets the v
│ │ │ │ │ -00009b90: 616c 7565 206f 6620 7468 6520 4d53 475f  alue of the MSG_
│ │ │ │ │ -00009ba0: 5459 5045 2076 6172 6961 626c 6520 746f  TYPE variable to
│ │ │ │ │ -00009bb0: 2074 6865 2053 5041 206d 6573 7361 6765   the SPA message
│ │ │ │ │ -00009bc0: 2074 7970 650a 2020 2020 2076 616c 7565   type.     value
│ │ │ │ │ -00009bd0: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with
│ │ │ │ │ -00009be0: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con
│ │ │ │ │ -00009bf0: 7465 7874 2e20 2054 6869 7320 7661 6c75  text.  This valu
│ │ │ │ │ -00009c00: 6520 6361 6e20 6265 0a20 2020 2020 6368  e can be.     ch
│ │ │ │ │ -00009c10: 6563 6b65 6420 6167 6169 6e73 7420 7468  ecked against th
│ │ │ │ │ -00009c20: 6520 6c69 7374 206f 6620 7661 6c69 6420  e list of valid 
│ │ │ │ │ -00009c30: 6d65 7373 6167 655f 7479 7065 7320 6c69  message_types li
│ │ │ │ │ -00009c40: 7374 6564 2069 6e20 2a6e 6f74 6520 5350  sted in *note SP
│ │ │ │ │ -00009c50: 410a 2020 2020 204d 6573 7361 6765 733a  A.     Messages:
│ │ │ │ │ -00009c60: 3a20 6f66 2074 6869 7320 6d61 6e75 616c  : of this manual
│ │ │ │ │ -00009c70: 2e20 2046 6f72 2065 7861 6d70 6c65 3a0a  .  For example:.
│ │ │ │ │ -00009c80: 2020 2020 2020 2020 2020 2020 2020 7368                sh
│ │ │ │ │ -00009c90: 6f72 7420 6d73 675f 7479 7065 3b0a 0a20  ort msg_type;.. 
│ │ │ │ │ -00009ca0: 2020 2020 2020 2020 2020 2020 2072 6320               rc 
│ │ │ │ │ -00009cb0: 3d20 666b 6f5f 6765 745f 7370 615f 6d65  = fko_get_spa_me
│ │ │ │ │ -00009cc0: 7373 6167 655f 7479 7065 2863 7478 2c20  ssage_type(ctx, 
│ │ │ │ │ -00009cd0: 266d 7367 5f74 7970 6529 3b0a 0a20 2020  &msg_type);..   
│ │ │ │ │ -00009ce0: 2020 2020 2020 2020 2020 2073 7769 7463             switc
│ │ │ │ │ -00009cf0: 6828 6d73 675f 7479 7065 290a 2020 2020  h(msg_type).    
│ │ │ │ │ -00009d00: 2020 2020 2020 2020 2020 7b0a 2020 2020            {.    
│ │ │ │ │ -00009d10: 2020 2020 2020 2020 2020 2020 2020 6361                ca
│ │ │ │ │ -00009d20: 7365 2046 4b4f 5f41 4343 4553 535f 4d53  se FKO_ACCESS_MS
│ │ │ │ │ -00009d30: 473a 0a20 2020 2020 2020 2020 2020 2020  G:.             
│ │ │ │ │ -00009d40: 2020 2020 2020 2020 2070 726f 6365 7373           process
│ │ │ │ │ -00009d50: 5f61 6363 6573 735f 6d73 6728 2e2e 2e29  _access_msg(...)
│ │ │ │ │ -00009d60: 3b0a 2020 2020 2020 2020 2020 2020 2020  ;.              
│ │ │ │ │ -00009d70: 2020 2020 2020 2020 6272 6561 6b3b 0a20          break;. 
│ │ │ │ │ -00009d80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00009d90: 2063 6173 6520 464b 4f5f 4e41 545f 4143   case FKO_NAT_AC
│ │ │ │ │ -00009da0: 4345 5353 5f4d 5347 3a0a 2020 2020 2020  CESS_MSG:.      
│ │ │ │ │ -00009db0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00009dc0: 7072 6f63 6573 735f 6e61 745f 6163 6365  process_nat_acce
│ │ │ │ │ -00009dd0: 7373 5f6d 7367 282e 2e2e 293b 0a20 2020  ss_msg(...);.   
│ │ │ │ │ +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(...);.
│ │ │ │ │ +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: 2020 2062 7265 616b 3b0a 2020 2020 2020     break;.      
│ │ │ │ │ -00009e00: 2020 2020 2020 2020 2f2a 2e2e 2e61 6e64          /*...and
│ │ │ │ │ -00009e10: 2073 6f20 6f6e 2e2e 2e2a 2f0a 2020 2020   so on...*/.    
│ │ │ │ │ -00009e20: 2020 2020 2020 2020 2020 7d0a 2020 2020            }.    
│ │ │ │ │ -00009e30: 2054 6865 2072 6574 7572 6e20 7661 6c75   The return valu
│ │ │ │ │ -00009e40: 6520 6973 2061 6e20 464b 4f20 6572 726f  e is an FKO erro
│ │ │ │ │ -00009e50: 7220 7374 6174 7573 2e0a 0a20 2d2d 2046  r status... -- F
│ │ │ │ │ -00009e60: 756e 6374 696f 6e3a 2069 6e74 2066 6b6f  unction: int fko
│ │ │ │ │ -00009e70: 5f67 6574 5f73 7061 5f6d 6573 7361 6765  _get_spa_message
│ │ │ │ │ -00009e80: 2028 666b 6f5f 6374 785f 7420 4354 582c   (fko_ctx_t CTX,
│ │ │ │ │ -00009e90: 2063 6861 7220 2a2a 5350 415f 4d53 4729   char **SPA_MSG)
│ │ │ │ │ -00009ea0: 3b0a 2020 2020 2041 7373 6967 6e73 2074  ;.     Assigns t
│ │ │ │ │ -00009eb0: 6865 2070 6f69 6e74 6572 2074 6f20 7468  he pointer to th
│ │ │ │ │ -00009ec0: 6520 7374 7269 6e67 2068 6f6c 6469 6e67  e string holding
│ │ │ │ │ -00009ed0: 2074 6865 2074 6865 2066 6b6f 2053 5041   the the fko SPA
│ │ │ │ │ -00009ee0: 2072 6571 7565 7374 0a20 2020 2020 6d65   request.     me
│ │ │ │ │ -00009ef0: 7373 6167 6520 6173 736f 6369 6174 6564  ssage associated
│ │ │ │ │ -00009f00: 2077 6974 6820 7468 6520 6375 7272 656e   with the curren
│ │ │ │ │ -00009f10: 7420 636f 6e74 6578 7420 746f 2074 6865  t context to the
│ │ │ │ │ -00009f20: 2061 6464 7265 7373 2053 5041 5f4d 5347   address SPA_MSG
│ │ │ │ │ -00009f30: 0a20 2020 2020 6973 2070 6f69 6e74 696e  .     is pointin
│ │ │ │ │ -00009f40: 6720 746f 2e20 2054 6865 2072 6574 7572  g to.  The retur
│ │ │ │ │ -00009f50: 6e20 7661 6c75 6520 6973 2061 6e20 464b  n value is an FK
│ │ │ │ │ -00009f60: 4f20 6572 726f 7220 7374 6174 7573 2e0a  O error status..
│ │ │ │ │ -00009f70: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ │ -00009f80: 6e74 2066 6b6f 5f67 6574 5f73 7061 5f6e  nt fko_get_spa_n
│ │ │ │ │ -00009f90: 6174 5f61 6363 6573 7320 2866 6b6f 5f63  at_access (fko_c
│ │ │ │ │ -00009fa0: 7478 5f74 2043 5458 2c20 6368 6172 0a20  tx_t CTX, char. 
│ │ │ │ │ -00009fb0: 2020 2020 2020 2020 202a 2a4e 4154 5f41           **NAT_A
│ │ │ │ │ -00009fc0: 4343 4553 5329 3b0a 2020 2020 2041 7373  CCESS);.     Ass
│ │ │ │ │ -00009fd0: 6967 6e73 2074 6865 2070 6f69 6e74 6572  igns the pointer
│ │ │ │ │ -00009fe0: 2074 6f20 7468 6520 7374 7269 6e67 2068   to the string h
│ │ │ │ │ -00009ff0: 6f6c 6469 6e67 2074 6865 2074 6865 2066  olding the the f
│ │ │ │ │ -0000a000: 6b6f 2053 5041 206e 6174 0a20 2020 2020  ko SPA nat.     
│ │ │ │ │ -0000a010: 6163 6365 7373 206d 6573 7361 6765 2061  access message a
│ │ │ │ │ -0000a020: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t
│ │ │ │ │ -0000a030: 6865 2063 7572 7265 6e74 2063 6f6e 7465  he current conte
│ │ │ │ │ -0000a040: 7874 2074 6f20 7468 6520 6164 6472 6573  xt to the addres
│ │ │ │ │ -0000a050: 730a 2020 2020 204e 4154 5f41 4343 4553  s.     NAT_ACCES
│ │ │ │ │ -0000a060: 5320 6973 2070 6f69 6e74 696e 6720 746f  S is pointing to
│ │ │ │ │ -0000a070: 2e20 2054 6865 2072 6574 7572 6e20 7661  .  The return va
│ │ │ │ │ -0000a080: 6c75 6520 6973 2061 6e20 464b 4f20 6572  lue is an FKO er
│ │ │ │ │ -0000a090: 726f 720a 2020 2020 2073 7461 7475 732e  ror.     status.
│ │ │ │ │ -0000a0a0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ │ -0000a0b0: 696e 7420 666b 6f5f 6765 745f 7370 615f  int fko_get_spa_
│ │ │ │ │ -0000a0c0: 7365 7276 6572 5f61 7574 6820 2866 6b6f  server_auth (fko
│ │ │ │ │ -0000a0d0: 5f63 7478 5f74 2043 5458 2c20 6368 6172  _ctx_t CTX, char
│ │ │ │ │ -0000a0e0: 0a20 2020 2020 2020 2020 202a 2a53 4552  .          **SER
│ │ │ │ │ -0000a0f0: 5645 525f 4155 5448 293b 0a20 2020 2020  VER_AUTH);.     
│ │ │ │ │ -0000a100: 4173 7369 676e 7320 7468 6520 706f 696e  Assigns the poin
│ │ │ │ │ -0000a110: 7465 7220 746f 2074 6865 2073 7472 696e  ter to the strin
│ │ │ │ │ -0000a120: 6720 686f 6c64 696e 6720 7468 6520 7468  g holding the th
│ │ │ │ │ -0000a130: 6520 666b 6f20 5350 4120 7365 7276 6572  e fko SPA server
│ │ │ │ │ -0000a140: 0a20 2020 2020 6175 7468 206d 6573 7361  .     auth messa
│ │ │ │ │ -0000a150: 6765 2061 7373 6f63 6961 7465 6420 7769  ge associated wi
│ │ │ │ │ -0000a160: 7468 2074 6865 2063 7572 7265 6e74 2063  th the current c
│ │ │ │ │ -0000a170: 6f6e 7465 7874 2074 6f20 7468 6520 6164  ontext to the ad
│ │ │ │ │ -0000a180: 6472 6573 730a 2020 2020 2053 4552 5645  dress.     SERVE
│ │ │ │ │ -0000a190: 525f 4155 5448 2069 7320 706f 696e 7469  R_AUTH is pointi
│ │ │ │ │ -0000a1a0: 6e67 2074 6f2e 2020 5468 6520 7265 7475  ng to.  The retu
│ │ │ │ │ -0000a1b0: 726e 2076 616c 7565 2069 7320 616e 2046  rn value is an F
│ │ │ │ │ -0000a1c0: 4b4f 2065 7272 6f72 0a20 2020 2020 7374  KO error.     st
│ │ │ │ │ -0000a1d0: 6174 7573 2e0a 0a20 2d2d 2046 756e 6374  atus... -- Funct
│ │ │ │ │ -0000a1e0: 696f 6e3a 2069 6e74 2066 6b6f 5f67 6574  ion: int fko_get
│ │ │ │ │ -0000a1f0: 5f73 7061 5f63 6c69 656e 745f 7469 6d65  _spa_client_time
│ │ │ │ │ -0000a200: 6f75 7420 2866 6b6f 5f63 7478 5f74 2043  out (fko_ctx_t C
│ │ │ │ │ -0000a210: 5458 2c20 696e 740a 2020 2020 2020 2020  TX, int.        
│ │ │ │ │ -0000a220: 2020 2a43 4c49 454e 545f 5449 4d45 4f55    *CLIENT_TIMEOU
│ │ │ │ │ -0000a230: 5429 3b0a 2020 2020 2053 6574 7320 7468  T);.     Sets th
│ │ │ │ │ -0000a240: 6520 7661 6c75 6520 6f66 2074 6865 2043  e value of the C
│ │ │ │ │ -0000a250: 4c49 454e 545f 5449 4d45 4f55 5420 7661  LIENT_TIMEOUT va
│ │ │ │ │ -0000a260: 7269 6162 6c65 2074 6f20 7468 6520 636c  riable to the cl
│ │ │ │ │ -0000a270: 6965 6e74 5f74 696d 656f 7574 0a20 2020  ient_timeout.   
│ │ │ │ │ -0000a280: 2020 7661 6c75 6520 6173 736f 6369 6174    value associat
│ │ │ │ │ -0000a290: 6564 2077 6974 6820 7468 6520 6375 7272  ed with the curr
│ │ │ │ │ -0000a2a0: 656e 7420 636f 6e74 6578 742e 2020 5468  ent context.  Th
│ │ │ │ │ -0000a2b0: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i
│ │ │ │ │ -0000a2c0: 7320 616e 0a20 2020 2020 464b 4f20 6572  s an.     FKO er
│ │ │ │ │ -0000a2d0: 726f 7220 7374 6174 7573 2e0a 0a20 2d2d  ror status... --
│ │ │ │ │ -0000a2e0: 2046 756e 6374 696f 6e3a 2069 6e74 2066   Function: int f
│ │ │ │ │ -0000a2f0: 6b6f 5f67 6574 5f73 7061 5f64 6967 6573  ko_get_spa_diges
│ │ │ │ │ -0000a300: 745f 7479 7065 2028 666b 6f5f 6374 785f  t_type (fko_ctx_
│ │ │ │ │ -0000a310: 7420 4354 582c 2073 686f 7274 0a20 2020  t CTX, short.   
│ │ │ │ │ -0000a320: 2020 2020 2020 202a 4449 4745 5354 5f54         *DIGEST_T
│ │ │ │ │ -0000a330: 5950 4529 3b0a 2020 2020 2053 6574 7320  YPE);.     Sets 
│ │ │ │ │ -0000a340: 7468 6520 7661 6c75 6520 6f66 2074 6865  the value of the
│ │ │ │ │ -0000a350: 2044 4947 4553 545f 5459 5045 2076 6172   DIGEST_TYPE var
│ │ │ │ │ -0000a360: 6961 626c 6520 746f 2074 6865 2064 6967  iable to the dig
│ │ │ │ │ -0000a370: 6573 7420 7479 7065 2076 616c 7565 0a20  est type value. 
│ │ │ │ │ -0000a380: 2020 2020 6173 736f 6369 6174 6564 2077      associated w
│ │ │ │ │ -0000a390: 6974 6820 7468 6520 6375 7272 656e 7420  ith the current 
│ │ │ │ │ -0000a3a0: 636f 6e74 6578 742e 2020 5468 6973 2076  context.  This v
│ │ │ │ │ -0000a3b0: 616c 7565 2063 616e 2062 6520 6368 6563  alue can be chec
│ │ │ │ │ -0000a3c0: 6b65 640a 2020 2020 2061 6761 696e 7374  ked.     against
│ │ │ │ │ -0000a3d0: 2074 6865 206c 6973 7420 6f66 2076 616c   the list of val
│ │ │ │ │ -0000a3e0: 6964 2064 6967 6573 745f 7479 7065 7320  id digest_types 
│ │ │ │ │ -0000a3f0: 6c69 7374 6564 2069 6e20 2a6e 6f74 6520  listed in *note 
│ │ │ │ │ -0000a400: 4469 6765 7374 733a 3a20 6f66 0a20 2020  Digests:: of.   
│ │ │ │ │ -0000a410: 2020 7468 6973 206d 616e 7561 6c2e 2020    this manual.  
│ │ │ │ │ -0000a420: 5468 6520 7265 7475 726e 2076 616c 7565  The return value
│ │ │ │ │ -0000a430: 2069 7320 616e 2046 4b4f 2065 7272 6f72   is an FKO error
│ │ │ │ │ -0000a440: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu
│ │ │ │ │ -0000a450: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_
│ │ │ │ │ -0000a460: 6765 745f 7370 615f 686d 6163 5f74 7970  get_spa_hmac_typ
│ │ │ │ │ -0000a470: 6520 2866 6b6f 5f63 7478 5f74 2043 5458  e (fko_ctx_t CTX
│ │ │ │ │ -0000a480: 2c20 7368 6f72 740a 2020 2020 2020 2020  , short.        
│ │ │ │ │ -0000a490: 2020 2a48 4d41 435f 5459 5045 293b 0a20    *HMAC_TYPE);. 
│ │ │ │ │ -0000a4a0: 2020 2020 5365 7473 2074 6865 2076 616c      Sets the val
│ │ │ │ │ -0000a4b0: 7565 206f 6620 7468 6520 484d 4143 5f54  ue of the HMAC_T
│ │ │ │ │ -0000a4c0: 5950 4520 7661 7269 6162 6c65 2074 6f20  YPE variable to 
│ │ │ │ │ -0000a4d0: 7468 6520 484d 4143 2074 7970 6520 7661  the HMAC type va
│ │ │ │ │ -0000a4e0: 6c75 650a 2020 2020 2061 7373 6f63 6961  lue.     associa
│ │ │ │ │ -0000a4f0: 7465 6420 7769 7468 2074 6865 2063 7572  ted with the cur
│ │ │ │ │ -0000a500: 7265 6e74 2063 6f6e 7465 7874 2e20 2054  rent context.  T
│ │ │ │ │ -0000a510: 6869 7320 7661 6c75 6520 6361 6e20 6265  his value can be
│ │ │ │ │ -0000a520: 2063 6865 636b 6564 0a20 2020 2020 6167   checked.     ag
│ │ │ │ │ -0000a530: 6169 6e73 7420 7468 6520 6c69 7374 206f  ainst the list o
│ │ │ │ │ -0000a540: 6620 7661 6c69 6420 686d 6163 5f74 7970  f valid hmac_typ
│ │ │ │ │ -0000a550: 6573 206c 6973 7465 6420 696e 202a 6e6f  es listed in *no
│ │ │ │ │ -0000a560: 7465 2048 4d41 4320 4469 6765 7374 733a  te HMAC Digests:
│ │ │ │ │ -0000a570: 3a0a 2020 2020 206f 6620 7468 6973 206d  :.     of this m
│ │ │ │ │ -0000a580: 616e 7561 6c2e 2020 5468 6520 7265 7475  anual.  The retu
│ │ │ │ │ -0000a590: 726e 2076 616c 7565 2069 7320 616e 2046  rn value is an F
│ │ │ │ │ -0000a5a0: 4b4f 2065 7272 6f72 2073 7461 7475 732e  KO error status.
│ │ │ │ │ -0000a5b0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ │ -0000a5c0: 696e 7420 666b 6f5f 6765 745f 7370 615f  int fko_get_spa_
│ │ │ │ │ -0000a5d0: 6469 6765 7374 2028 666b 6f5f 6374 785f  digest (fko_ctx_
│ │ │ │ │ -0000a5e0: 7420 4354 582c 2063 6861 7220 2a2a 5350  t CTX, char **SP
│ │ │ │ │ -0000a5f0: 415f 4449 4745 5354 293b 0a20 2020 2020  A_DIGEST);.     
│ │ │ │ │ -0000a600: 4173 7369 676e 7320 7468 6520 706f 696e  Assigns the poin
│ │ │ │ │ -0000a610: 7465 7220 746f 2074 6865 2073 7472 696e  ter to the strin
│ │ │ │ │ -0000a620: 6720 686f 6c64 696e 6720 7468 6520 7468  g holding the th
│ │ │ │ │ -0000a630: 6520 666b 6f20 5350 4120 6469 6765 7374  e fko SPA digest
│ │ │ │ │ -0000a640: 0a20 2020 2020 7661 6c75 6520 6173 736f  .     value asso
│ │ │ │ │ -0000a650: 6369 6174 6564 2077 6974 6820 7468 6520  ciated with the 
│ │ │ │ │ -0000a660: 6375 7272 656e 7420 636f 6e74 6578 7420  current context 
│ │ │ │ │ -0000a670: 746f 2074 6865 2061 6464 7265 7373 2053  to the address S
│ │ │ │ │ -0000a680: 5041 5f44 4947 4553 540a 2020 2020 2069  PA_DIGEST.     i
│ │ │ │ │ -0000a690: 7320 706f 696e 7469 6e67 2074 6f2e 2020  s pointing to.  
│ │ │ │ │ -0000a6a0: 5468 6520 7265 7475 726e 2076 616c 7565  The return value
│ │ │ │ │ -0000a6b0: 2069 7320 616e 2046 4b4f 2065 7272 6f72   is an FKO error
│ │ │ │ │ -0000a6c0: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu
│ │ │ │ │ -0000a6d0: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_
│ │ │ │ │ -0000a6e0: 6765 745f 7370 615f 686d 6163 2028 666b  get_spa_hmac (fk
│ │ │ │ │ -0000a6f0: 6f5f 6374 785f 7420 4354 582c 2063 6861  o_ctx_t CTX, cha
│ │ │ │ │ -0000a700: 7220 2a2a 5350 415f 484d 4143 293b 0a20  r **SPA_HMAC);. 
│ │ │ │ │ -0000a710: 2020 2020 4173 7369 676e 7320 7468 6520      Assigns the 
│ │ │ │ │ -0000a720: 706f 696e 7465 7220 746f 2074 6865 2073  pointer to the s
│ │ │ │ │ -0000a730: 7472 696e 6720 686f 6c64 696e 6720 7468  tring holding th
│ │ │ │ │ -0000a740: 6520 7468 6520 666b 6f20 5350 4120 484d  e the fko SPA HM
│ │ │ │ │ -0000a750: 4143 0a20 2020 2020 7661 6c75 6520 6173  AC.     value as
│ │ │ │ │ -0000a760: 736f 6369 6174 6564 2077 6974 6820 7468  sociated with th
│ │ │ │ │ -0000a770: 6520 6375 7272 656e 7420 636f 6e74 6578  e current contex
│ │ │ │ │ -0000a780: 7420 746f 2074 6865 2061 6464 7265 7373  t to the address
│ │ │ │ │ -0000a790: 2053 5041 5f48 4d41 430a 2020 2020 2069   SPA_HMAC.     i
│ │ │ │ │ -0000a7a0: 7320 706f 696e 7469 6e67 2074 6f2e 2020  s pointing to.  
│ │ │ │ │ -0000a7b0: 5468 6520 7265 7475 726e 2076 616c 7565  The return value
│ │ │ │ │ -0000a7c0: 2069 7320 616e 2046 4b4f 2065 7272 6f72   is an FKO error
│ │ │ │ │ -0000a7d0: 2073 7461 7475 732e 0a0a 202d 2d20 4675   status... -- Fu
│ │ │ │ │ -0000a7e0: 6e63 7469 6f6e 3a20 696e 7420 666b 6f5f  nction: int fko_
│ │ │ │ │ -0000a7f0: 6765 745f 7370 615f 656e 6372 7970 7469  get_spa_encrypti
│ │ │ │ │ -0000a800: 6f6e 5f74 7970 6520 2866 6b6f 5f63 7478  on_type (fko_ctx
│ │ │ │ │ -0000a810: 5f74 2043 5458 2c20 7368 6f72 740a 2020  _t CTX, short.  
│ │ │ │ │ -0000a820: 2020 2020 2020 2020 2a45 4e43 5f54 5950          *ENC_TYP
│ │ │ │ │ -0000a830: 4529 3b0a 2020 2020 2053 6574 7320 7468  E);.     Sets th
│ │ │ │ │ -0000a840: 6520 7661 6c75 6520 6f66 2074 6865 2045  e value of the E
│ │ │ │ │ -0000a850: 4e43 5f54 5950 4520 7661 7269 6162 6c65  NC_TYPE variable
│ │ │ │ │ -0000a860: 2074 6f20 7468 6520 656e 6372 7970 7469   to the encrypti
│ │ │ │ │ -0000a870: 6f6e 2074 7970 650a 2020 2020 2076 616c  on type.     val
│ │ │ │ │ -0000a880: 7565 2061 7373 6f63 6961 7465 6420 7769  ue associated wi
│ │ │ │ │ -0000a890: 7468 2074 6865 2063 7572 7265 6e74 2063  th the current c
│ │ │ │ │ -0000a8a0: 6f6e 7465 7874 2e20 2054 6869 7320 7661  ontext.  This va
│ │ │ │ │ -0000a8b0: 6c75 6520 6361 6e20 6265 0a20 2020 2020  lue can be.     
│ │ │ │ │ -0000a8c0: 6368 6563 6b65 6420 6167 6169 6e73 7420  checked against 
│ │ │ │ │ -0000a8d0: 7468 6520 6c69 7374 206f 6620 7661 6c69  the list of vali
│ │ │ │ │ -0000a8e0: 6420 6469 6765 7374 5f74 7970 6573 206c  d digest_types l
│ │ │ │ │ -0000a8f0: 6973 7465 6420 696e 202a 6e6f 7465 0a20  isted in *note. 
│ │ │ │ │ -0000a900: 2020 2020 456e 6372 7970 7469 6f6e 2041      Encryption A
│ │ │ │ │ -0000a910: 6c67 6f72 6974 686d 733a 3a20 6f66 2074  lgorithms:: of t
│ │ │ │ │ -0000a920: 6869 7320 6d61 6e75 616c 2e20 2054 6865  his manual.  The
│ │ │ │ │ -0000a930: 2072 6574 7572 6e20 7661 6c75 6520 6973   return value is
│ │ │ │ │ -0000a940: 2061 6e20 464b 4f0a 2020 2020 2065 7272   an FKO.     err
│ │ │ │ │ -0000a950: 6f72 2073 7461 7475 732e 0a0a 202d 2d20  or status... -- 
│ │ │ │ │ -0000a960: 4675 6e63 7469 6f6e 3a20 696e 7420 666b  Function: int fk
│ │ │ │ │ -0000a970: 6f5f 6765 745f 656e 636f 6465 645f 6461  o_get_encoded_da
│ │ │ │ │ -0000a980: 7461 2028 666b 6f5f 6374 785f 7420 4354  ta (fko_ctx_t CT
│ │ │ │ │ -0000a990: 582c 2063 6861 7220 2a2a 454e 435f 4d53  X, char **ENC_MS
│ │ │ │ │ -0000a9a0: 4729 3b0a 2020 2020 2041 7373 6967 6e73  G);.     Assigns
│ │ │ │ │ -0000a9b0: 2074 6865 2070 6f69 6e74 6572 2074 6f20   the pointer to 
│ │ │ │ │ -0000a9c0: 7468 6520 7374 7269 6e67 2068 6f6c 6469  the string holdi
│ │ │ │ │ -0000a9d0: 6e67 2074 6865 2074 6865 2065 6e63 6f64  ng the the encod
│ │ │ │ │ -0000a9e0: 6564 2053 5041 2064 6174 610a 2020 2020  ed SPA data.    
│ │ │ │ │ -0000a9f0: 2028 6265 666f 7265 2065 6e63 7279 7074   (before encrypt
│ │ │ │ │ -0000aa00: 696f 6e29 2061 7373 6f63 6961 7465 6420  ion) associated 
│ │ │ │ │ -0000aa10: 7769 7468 2074 6865 2063 7572 7265 6e74  with the current
│ │ │ │ │ -0000aa20: 2063 6f6e 7465 7874 2074 6f20 7468 650a   context to the.
│ │ │ │ │ -0000aa30: 2020 2020 2061 6464 7265 7373 2045 4e43       address ENC
│ │ │ │ │ -0000aa40: 5f4d 5347 2069 7320 706f 696e 7469 6e67  _MSG is pointing
│ │ │ │ │ -0000aa50: 2074 6f2e 2020 5468 6973 2069 7320 696e   to.  This is in
│ │ │ │ │ -0000aa60: 7465 726d 6564 6961 7465 2064 6174 6120  termediate data 
│ │ │ │ │ -0000aa70: 7468 6174 0a20 2020 2020 776f 756c 6420  that.     would 
│ │ │ │ │ -0000aa80: 6e6f 7420 6e6f 726d 616c 6c79 2062 6520  not normally be 
│ │ │ │ │ -0000aa90: 6f66 2075 7365 2075 6e6c 6573 7320 6465  of use unless de
│ │ │ │ │ -0000aaa0: 6275 6767 696e 6720 7468 6520 6c69 6272  bugging the libr
│ │ │ │ │ -0000aab0: 6172 792e 2020 5468 650a 2020 2020 2072  ary.  The.     r
│ │ │ │ │ -0000aac0: 6574 7572 6e20 7661 6c75 6520 6973 2061  eturn value is a
│ │ │ │ │ -0000aad0: 6e20 464b 4f20 6572 726f 7220 7374 6174  n FKO error stat
│ │ │ │ │ -0000aae0: 7573 2e0a 0a20 2d2d 2046 756e 6374 696f  us... -- Functio
│ │ │ │ │ -0000aaf0: 6e3a 2069 6e74 2066 6b6f 5f67 6574 5f76  n: int fko_get_v
│ │ │ │ │ -0000ab00: 6572 7369 6f6e 2028 666b 6f5f 6374 785f  ersion (fko_ctx_
│ │ │ │ │ -0000ab10: 7420 4354 582c 2063 6861 7220 2a2a 464b  t CTX, char **FK
│ │ │ │ │ -0000ab20: 4f5f 5645 5253 494f 4e29 3b0a 2020 2020  O_VERSION);.    
│ │ │ │ │ -0000ab30: 2041 7373 6967 6e73 2074 6865 2070 6f69   Assigns the poi
│ │ │ │ │ -0000ab40: 6e74 6572 2074 6f20 7468 6520 7374 7269  nter to the stri
│ │ │ │ │ -0000ab50: 6e67 2068 6f6c 6469 6e67 2074 6865 2074  ng holding the t
│ │ │ │ │ -0000ab60: 6865 2053 5041 2076 6572 7369 6f6e 2076  he SPA version v
│ │ │ │ │ -0000ab70: 616c 7565 0a20 2020 2020 6173 736f 6369  alue.     associ
│ │ │ │ │ -0000ab80: 6174 6564 2077 6974 6820 7468 6520 6375  ated with the cu
│ │ │ │ │ -0000ab90: 7272 656e 7420 636f 6e74 6578 7420 746f  rrent context to
│ │ │ │ │ -0000aba0: 2074 6865 2061 6464 7265 7373 2046 4b4f   the address FKO
│ │ │ │ │ -0000abb0: 5f56 4552 5349 4f4e 2069 730a 2020 2020  _VERSION is.    
│ │ │ │ │ -0000abc0: 2070 6f69 6e74 696e 6720 746f 2e20 2054   pointing to.  T
│ │ │ │ │ -0000abd0: 6869 7320 6973 2061 2073 7461 7469 6320  his is a static 
│ │ │ │ │ -0000abe0: 7661 6c75 6520 666f 7220 5350 4120 6461  value for SPA da
│ │ │ │ │ -0000abf0: 7461 2074 6861 7420 6973 2062 6569 6e67  ta that is being
│ │ │ │ │ -0000ac00: 0a20 2020 2020 6372 6561 7465 6420 696e  .     created in
│ │ │ │ │ -0000ac10: 2061 206e 6577 2063 6f6e 7465 7874 2e20   a new context. 
│ │ │ │ │ -0000ac20: 2046 6f72 2064 6174 6120 7061 7273 6564   For data parsed
│ │ │ │ │ -0000ac30: 2066 726f 6d20 616e 2065 7874 6572 6e61   from an externa
│ │ │ │ │ -0000ac40: 6c20 736f 7572 6365 2c0a 2020 2020 2074  l source,.     t
│ │ │ │ │ -0000ac50: 6865 2076 6572 7369 6f6e 2073 7472 696e  he version strin
│ │ │ │ │ -0000ac60: 6720 7769 6c6c 2062 6520 7768 6174 6576  g will be whatev
│ │ │ │ │ -0000ac70: 6572 2076 6572 7369 6f6e 2074 6865 2073  er version the s
│ │ │ │ │ -0000ac80: 656e 6469 6e67 2063 6c69 656e 740a 2020  ending client.  
│ │ │ │ │ -0000ac90: 2020 2075 7365 642e 2020 5468 6520 7265     used.  The re
│ │ │ │ │ -0000aca0: 7475 726e 2076 616c 7565 2069 7320 616e  turn value is an
│ │ │ │ │ -0000acb0: 2046 4b4f 2065 7272 6f72 2073 7461 7475   FKO error statu
│ │ │ │ │ -0000acc0: 732e 0a0a 5f47 5047 2d73 7065 6369 6669  s..._GPG-specifi
│ │ │ │ │ -0000acd0: 6320 6675 6e63 7469 6f6e 733a 5f0a 0a20  c functions:_.. 
│ │ │ │ │ -0000ace0: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ │ -0000acf0: 2066 6b6f 5f67 6574 5f67 7067 5f72 6563   fko_get_gpg_rec
│ │ │ │ │ -0000ad00: 6970 6965 6e74 2028 666b 6f5f 6374 785f  ipient (fko_ctx_
│ │ │ │ │ -0000ad10: 7420 4354 582c 2063 6861 720a 2020 2020  t CTX, char.    
│ │ │ │ │ -0000ad20: 2020 2020 2020 2a2a 5245 4349 5049 454e        **RECIPIEN
│ │ │ │ │ -0000ad30: 5429 3b0a 2020 2020 2041 7373 6967 6e73  T);.     Assigns
│ │ │ │ │ -0000ad40: 2074 6865 2070 6f69 6e74 6572 2074 6f20   the pointer to 
│ │ │ │ │ -0000ad50: 7468 6520 7374 7269 6e67 2068 6f6c 6469  the string holdi
│ │ │ │ │ -0000ad60: 6e67 2074 6865 2074 6865 2047 5047 2072  ng the the GPG r
│ │ │ │ │ -0000ad70: 6563 6970 6965 6e74 2049 440a 2020 2020  ecipient ID.    
│ │ │ │ │ -0000ad80: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with
│ │ │ │ │ -0000ad90: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con
│ │ │ │ │ -0000ada0: 7465 7874 2074 6f20 7468 6520 6164 6472  text to the addr
│ │ │ │ │ -0000adb0: 6573 7320 5245 4349 5049 454e 5420 6973  ess RECIPIENT is
│ │ │ │ │ -0000adc0: 0a20 2020 2020 706f 696e 7469 6e67 2074  .     pointing t
│ │ │ │ │ -0000add0: 6f2e 2020 5468 6520 7265 7475 726e 2076  o.  The return v
│ │ │ │ │ -0000ade0: 616c 7565 2069 7320 616e 2046 4b4f 2065  alue is an FKO e
│ │ │ │ │ -0000adf0: 7272 6f72 2073 7461 7475 732e 0a0a 202d  rror status... -
│ │ │ │ │ -0000ae00: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ │ -0000ae10: 666b 6f5f 6765 745f 6770 675f 7369 676e  fko_get_gpg_sign
│ │ │ │ │ -0000ae20: 6572 2028 666b 6f5f 6374 785f 7420 4354  er (fko_ctx_t CT
│ │ │ │ │ -0000ae30: 582c 2063 6861 7220 2a2a 5349 474e 4552  X, char **SIGNER
│ │ │ │ │ -0000ae40: 293b 0a20 2020 2020 4173 7369 676e 7320  );.     Assigns 
│ │ │ │ │ -0000ae50: 7468 6520 706f 696e 7465 7220 746f 2074  the pointer to t
│ │ │ │ │ -0000ae60: 6865 2073 7472 696e 6720 686f 6c64 696e  he string holdin
│ │ │ │ │ -0000ae70: 6720 7468 6520 7468 6520 4750 4720 7369  g the the GPG si
│ │ │ │ │ -0000ae80: 676e 6572 2049 440a 2020 2020 2061 7373  gner ID.     ass
│ │ │ │ │ -0000ae90: 6f63 6961 7465 6420 7769 7468 2074 6865  ociated with the
│ │ │ │ │ -0000aea0: 2063 7572 7265 6e74 2063 6f6e 7465 7874   current context
│ │ │ │ │ -0000aeb0: 2074 6f20 7468 6520 6164 6472 6573 7320   to the address 
│ │ │ │ │ -0000aec0: 5349 474e 4552 2069 730a 2020 2020 2070  SIGNER is.     p
│ │ │ │ │ -0000aed0: 6f69 6e74 696e 6720 746f 2e20 2054 6865  ointing to.  The
│ │ │ │ │ -0000aee0: 2072 6574 7572 6e20 7661 6c75 6520 6973   return value is
│ │ │ │ │ -0000aef0: 2061 6e20 464b 4f20 6572 726f 7220 7374   an FKO error st
│ │ │ │ │ -0000af00: 6174 7573 2e0a 0a20 2d2d 2046 756e 6374  atus... -- Funct
│ │ │ │ │ -0000af10: 696f 6e3a 2069 6e74 2066 6b6f 5f67 6574  ion: int fko_get
│ │ │ │ │ -0000af20: 5f67 7067 5f68 6f6d 655f 6469 7220 2866  _gpg_home_dir (f
│ │ │ │ │ -0000af30: 6b6f 5f63 7478 5f74 2043 5458 2c20 6368  ko_ctx_t CTX, ch
│ │ │ │ │ -0000af40: 6172 202a 2a47 5047 5f44 4952 293b 0a20  ar **GPG_DIR);. 
│ │ │ │ │ -0000af50: 2020 2020 4173 7369 676e 7320 7468 6520      Assigns the 
│ │ │ │ │ -0000af60: 706f 696e 7465 7220 746f 2074 6865 2073  pointer to the s
│ │ │ │ │ -0000af70: 7472 696e 6720 686f 6c64 696e 6720 7468  tring holding th
│ │ │ │ │ -0000af80: 6520 7468 6520 4750 4720 686f 6d65 0a20  e the GPG home. 
│ │ │ │ │ -0000af90: 2020 2020 6469 7265 6374 6f72 7920 6173      directory as
│ │ │ │ │ -0000afa0: 736f 6369 6174 6564 2077 6974 6820 7468  sociated with th
│ │ │ │ │ -0000afb0: 6520 6375 7272 656e 7420 636f 6e74 6578  e current contex
│ │ │ │ │ -0000afc0: 7420 746f 2074 6865 2061 6464 7265 7373  t to the address
│ │ │ │ │ -0000afd0: 0a20 2020 2020 4750 475f 4449 5220 6973  .     GPG_DIR is
│ │ │ │ │ -0000afe0: 2070 6f69 6e74 696e 6720 746f 2e20 2054   pointing to.  T
│ │ │ │ │ -0000aff0: 6865 2072 6574 7572 6e20 7661 6c75 6520  he return value 
│ │ │ │ │ -0000b000: 6973 2061 6e20 464b 4f20 6572 726f 7220  is an FKO error 
│ │ │ │ │ -0000b010: 7374 6174 7573 2e0a 0a20 2d2d 2046 756e  status... -- Fun
│ │ │ │ │ -0000b020: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f67  ction: int fko_g
│ │ │ │ │ -0000b030: 6574 5f67 7067 5f73 6967 6e61 7475 7265  et_gpg_signature
│ │ │ │ │ -0000b040: 5f76 6572 6966 7920 2866 6b6f 5f63 7478  _verify (fko_ctx
│ │ │ │ │ -0000b050: 5f74 2043 5458 2c20 756e 7369 676e 6564  _t CTX, unsigned
│ │ │ │ │ -0000b060: 0a20 2020 2020 2020 2020 2063 6861 7220  .          char 
│ │ │ │ │ -0000b070: 2a56 414c 293b 0a20 2020 2020 5365 7473  *VAL);.     Sets
│ │ │ │ │ -0000b080: 2074 6865 2076 616c 7565 206f 6620 7468   the value of th
│ │ │ │ │ -0000b090: 6520 5641 4c20 7661 7269 6162 6c65 2074  e VAL variable t
│ │ │ │ │ -0000b0a0: 6f20 7468 6520 6375 7272 656e 740a 2020  o the current.  
│ │ │ │ │ -0000b0b0: 2020 2067 7067 5f73 6967 6e61 7475 7265     gpg_signature
│ │ │ │ │ -0000b0c0: 5f76 6572 6966 7920 666c 6167 2076 616c  _verify flag val
│ │ │ │ │ -0000b0d0: 7565 2061 7373 6f63 6961 7465 6420 7769  ue associated wi
│ │ │ │ │ -0000b0e0: 7468 2074 6865 2063 7572 7265 6e74 0a20  th the current. 
│ │ │ │ │ -0000b0f0: 2020 2020 636f 6e74 6578 742e 2020 5468      context.  Th
│ │ │ │ │ -0000b100: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i
│ │ │ │ │ -0000b110: 7320 616e 2046 4b4f 2065 7272 6f72 2073  s an FKO error s
│ │ │ │ │ -0000b120: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func
│ │ │ │ │ -0000b130: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge
│ │ │ │ │ -0000b140: 745f 6770 675f 6967 6e6f 7265 5f76 6572  t_gpg_ignore_ver
│ │ │ │ │ -0000b150: 6966 795f 6572 726f 7220 2866 6b6f 5f63  ify_error (fko_c
│ │ │ │ │ -0000b160: 7478 5f74 2043 5458 2c0a 2020 2020 2020  tx_t CTX,.      
│ │ │ │ │ -0000b170: 2020 2020 756e 7369 676e 6564 2063 6861      unsigned cha
│ │ │ │ │ -0000b180: 7220 2a56 414c 293b 0a20 2020 2020 5365  r *VAL);.     Se
│ │ │ │ │ -0000b190: 7473 2074 6865 2076 616c 7565 206f 6620  ts the value of 
│ │ │ │ │ -0000b1a0: 7468 6520 5641 4c20 7661 7269 6162 6c65  the VAL variable
│ │ │ │ │ -0000b1b0: 2074 6f20 7468 6520 6375 7272 656e 740a   to the current.
│ │ │ │ │ -0000b1c0: 2020 2020 2069 676e 6f72 655f 7665 7269       ignore_veri
│ │ │ │ │ -0000b1d0: 6679 5f65 7272 6f72 2066 6c61 6720 7661  fy_error flag va
│ │ │ │ │ -0000b1e0: 6c75 6520 6173 736f 6369 6174 6564 2077  lue associated w
│ │ │ │ │ -0000b1f0: 6974 6820 7468 6520 6375 7272 656e 7420  ith the current 
│ │ │ │ │ -0000b200: 636f 6e74 6578 742e 0a20 2020 2020 5468  context..     Th
│ │ │ │ │ -0000b210: 6520 7265 7475 726e 2076 616c 7565 2069  e return value i
│ │ │ │ │ -0000b220: 7320 616e 2046 4b4f 2065 7272 6f72 2073  s an FKO error s
│ │ │ │ │ -0000b230: 7461 7475 732e 0a0a 202d 2d20 4675 6e63  tatus... -- Func
│ │ │ │ │ -0000b240: 7469 6f6e 3a20 696e 7420 666b 6f5f 6765  tion: int fko_ge
│ │ │ │ │ -0000b250: 745f 6770 675f 7369 676e 6174 7572 655f  t_gpg_signature_
│ │ │ │ │ -0000b260: 6964 2028 666b 6f5f 6374 785f 7420 4354  id (fko_ctx_t CT
│ │ │ │ │ -0000b270: 582c 2063 6861 720a 2020 2020 2020 2020  X, char.        
│ │ │ │ │ -0000b280: 2020 2a2a 5349 475f 4944 293b 0a20 2020    **SIG_ID);.   
│ │ │ │ │ -0000b290: 2020 4173 7369 676e 7320 7468 6520 706f    Assigns the po
│ │ │ │ │ -0000b2a0: 696e 7465 7220 746f 2074 6865 2073 7472  inter to the str
│ │ │ │ │ -0000b2b0: 696e 6720 686f 6c64 696e 6720 7468 6520  ing holding the 
│ │ │ │ │ -0000b2c0: 7468 6520 4750 4720 7369 676e 6174 7572  the GPG signatur
│ │ │ │ │ -0000b2d0: 6520 4944 0a20 2020 2020 6173 736f 6369  e ID.     associ
│ │ │ │ │ -0000b2e0: 6174 6564 2077 6974 6820 7468 6520 6375  ated with the cu
│ │ │ │ │ -0000b2f0: 7272 656e 7420 636f 6e74 6578 7420 746f  rrent context to
│ │ │ │ │ -0000b300: 2074 6865 2061 6464 7265 7373 2053 4947   the address SIG
│ │ │ │ │ -0000b310: 5f49 4420 6973 0a20 2020 2020 706f 696e  _ID is.     poin
│ │ │ │ │ -0000b320: 7469 6e67 2074 6f2e 2020 5468 6520 7265  ting to.  The re
│ │ │ │ │ -0000b330: 7475 726e 2076 616c 7565 2069 7320 616e  turn value is an
│ │ │ │ │ -0000b340: 2046 4b4f 2065 7272 6f72 2073 7461 7475   FKO error statu
│ │ │ │ │ -0000b350: 732e 0a0a 202d 2d20 4675 6e63 7469 6f6e  s... -- Function
│ │ │ │ │ -0000b360: 3a20 696e 7420 666b 6f5f 6765 745f 6770  : int fko_get_gp
│ │ │ │ │ -0000b370: 675f 7369 676e 6174 7572 655f 6670 7220  g_signature_fpr 
│ │ │ │ │ -0000b380: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, 
│ │ │ │ │ -0000b390: 6368 6172 0a20 2020 2020 2020 2020 202a  char.          *
│ │ │ │ │ -0000b3a0: 2a53 4947 5f46 5052 293b 0a20 2020 2020  *SIG_FPR);.     
│ │ │ │ │ -0000b3b0: 4173 7369 676e 7320 7468 6520 706f 696e  Assigns the poin
│ │ │ │ │ -0000b3c0: 7465 7220 746f 2074 6865 2073 7472 696e  ter to the strin
│ │ │ │ │ -0000b3d0: 6720 686f 6c64 696e 6720 7468 6520 7468  g holding the th
│ │ │ │ │ -0000b3e0: 6520 4750 4720 7369 676e 6174 7572 650a  e GPG signature.
│ │ │ │ │ -0000b3f0: 2020 2020 2066 696e 6765 7270 7269 6e74       fingerprint
│ │ │ │ │ -0000b400: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with
│ │ │ │ │ -0000b410: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con
│ │ │ │ │ -0000b420: 7465 7874 2074 6f20 7468 6520 6164 6472  text to the addr
│ │ │ │ │ -0000b430: 6573 730a 2020 2020 2053 4947 5f46 5052  ess.     SIG_FPR
│ │ │ │ │ -0000b440: 2069 7320 706f 696e 7469 6e67 2074 6f2e   is pointing to.
│ │ │ │ │ -0000b450: 2020 5468 6520 7265 7475 726e 2076 616c    The return val
│ │ │ │ │ -0000b460: 7565 2069 7320 616e 2046 4b4f 2065 7272  ue is an FKO err
│ │ │ │ │ -0000b470: 6f72 2073 7461 7475 732e 0a0a 202d 2d20  or status... -- 
│ │ │ │ │ -0000b480: 4675 6e63 7469 6f6e 3a20 696e 7420 666b  Function: int fk
│ │ │ │ │ -0000b490: 6f5f 6765 745f 6770 675f 7369 676e 6174  o_get_gpg_signat
│ │ │ │ │ -0000b4a0: 7572 655f 7375 6d6d 6172 7920 2866 6b6f  ure_summary (fko
│ │ │ │ │ -0000b4b0: 5f63 7478 5f74 2043 5458 2c20 696e 740a  _ctx_t CTX, int.
│ │ │ │ │ -0000b4c0: 2020 2020 2020 2020 2020 2a53 4947 5f53            *SIG_S
│ │ │ │ │ -0000b4d0: 554d 293b 0a20 2020 2020 5365 7473 2074  UM);.     Sets t
│ │ │ │ │ -0000b4e0: 6865 2076 616c 7565 206f 6620 7468 6520  he value of the 
│ │ │ │ │ -0000b4f0: 5349 475f 5355 4d20 7661 7269 6162 6c65  SIG_SUM variable
│ │ │ │ │ -0000b500: 2074 6f20 7468 6520 4750 4720 7369 676e   to the GPG sign
│ │ │ │ │ -0000b510: 6174 7572 6520 7375 6d6d 6172 790a 2020  ature summary.  
│ │ │ │ │ -0000b520: 2020 2076 616c 7565 2061 7373 6f63 6961     value associa
│ │ │ │ │ -0000b530: 7465 6420 7769 7468 2074 6865 2063 7572  ted with the cur
│ │ │ │ │ -0000b540: 7265 6e74 2063 6f6e 7465 7874 2e20 2054  rent context.  T
│ │ │ │ │ -0000b550: 6865 2072 6574 7572 6e20 7661 6c75 6520  he return value 
│ │ │ │ │ -0000b560: 6973 2061 6e0a 2020 2020 2046 4b4f 2065  is an.     FKO e
│ │ │ │ │ -0000b570: 7272 6f72 2073 7461 7475 732e 0a0a 202d  rror status... -
│ │ │ │ │ -0000b580: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ │ -0000b590: 666b 6f5f 6765 745f 6770 675f 7369 676e  fko_get_gpg_sign
│ │ │ │ │ -0000b5a0: 6174 7572 655f 7374 6174 7573 2028 666b  ature_status (fk
│ │ │ │ │ -0000b5b0: 6f5f 6374 785f 7420 4354 582c 2069 6e74  o_ctx_t CTX, int
│ │ │ │ │ -0000b5c0: 0a20 2020 2020 2020 2020 202a 5349 475f  .          *SIG_
│ │ │ │ │ -0000b5d0: 5354 4154 293b 0a20 2020 2020 5365 7473  STAT);.     Sets
│ │ │ │ │ -0000b5e0: 2074 6865 2076 616c 7565 206f 6620 7468   the value of th
│ │ │ │ │ -0000b5f0: 6520 5349 475f 5354 4154 2076 6172 6961  e SIG_STAT varia
│ │ │ │ │ -0000b600: 626c 6520 746f 2074 6865 2047 5047 2073  ble to the GPG s
│ │ │ │ │ -0000b610: 6967 6e61 7475 7265 2065 7272 6f72 0a20  ignature error. 
│ │ │ │ │ -0000b620: 2020 2020 7374 6174 7573 2076 616c 7565      status value
│ │ │ │ │ -0000b630: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with
│ │ │ │ │ -0000b640: 2074 6865 2063 7572 7265 6e74 2063 6f6e   the current con
│ │ │ │ │ -0000b650: 7465 7874 2e20 2054 6865 2072 6574 7572  text.  The retur
│ │ │ │ │ -0000b660: 6e20 7661 6c75 650a 2020 2020 2069 7320  n value.     is 
│ │ │ │ │ -0000b670: 616e 2046 4b4f 2065 7272 6f72 2073 7461  an FKO error sta
│ │ │ │ │ -0000b680: 7475 732e 0a0a 202d 2d20 4675 6e63 7469  tus... -- Functi
│ │ │ │ │ -0000b690: 6f6e 3a20 696e 7420 666b 6f5f 6765 745f  on: int fko_get_
│ │ │ │ │ -0000b6a0: 6770 675f 6578 6520 2866 6b6f 5f63 7478  gpg_exe (fko_ctx
│ │ │ │ │ -0000b6b0: 5f74 2043 5458 2c20 6368 6172 202a 2a47  _t CTX, char **G
│ │ │ │ │ -0000b6c0: 5047 5f45 5845 293b 0a20 2020 2020 4173  PG_EXE);.     As
│ │ │ │ │ -0000b6d0: 7369 676e 7320 7468 6520 706f 696e 7465  signs the pointe
│ │ │ │ │ -0000b6e0: 7220 746f 2074 6865 2073 7472 696e 6720  r to the string 
│ │ │ │ │ -0000b6f0: 686f 6c64 696e 6720 7468 6520 7468 6520  holding the the 
│ │ │ │ │ -0000b700: 4750 4720 6578 6563 7574 6162 6c65 0a20  GPG executable. 
│ │ │ │ │ -0000b710: 2020 2020 7061 7468 2061 7373 6f63 6961      path associa
│ │ │ │ │ -0000b720: 7465 6420 7769 7468 2074 6865 2063 7572  ted with the cur
│ │ │ │ │ -0000b730: 7265 6e74 2063 6f6e 7465 7874 2074 6f20  rent context to 
│ │ │ │ │ -0000b740: 7468 6520 6164 6472 6573 7320 4750 475f  the address GPG_
│ │ │ │ │ -0000b750: 4558 4520 6973 0a20 2020 2020 706f 696e  EXE is.     poin
│ │ │ │ │ -0000b760: 7469 6e67 2074 6f2e 2020 5468 6520 7265  ting to.  The re
│ │ │ │ │ -0000b770: 7475 726e 2076 616c 7565 2069 7320 616e  turn value is an
│ │ │ │ │ -0000b780: 2046 4b4f 2065 7272 6f72 2073 7461 7475   FKO error statu
│ │ │ │ │ -0000b790: 732e 0a0a 2a4e 6f74 652a 3a20 5468 6520  s...*Note*: The 
│ │ │ │ │ -0000b7a0: 6368 6172 2a20 7661 6c75 6573 2072 6574  char* values ret
│ │ │ │ │ -0000b7b0: 7269 6576 6564 2062 7920 7468 6520 4750  rieved by the GP
│ │ │ │ │ -0000b7c0: 472d 7265 6c61 7465 6420 6675 6e63 7469  G-related functi
│ │ │ │ │ -0000b7d0: 6f6e 7320 6162 6f76 650a 7769 6c6c 2062  ons above.will b
│ │ │ │ │ -0000b7e0: 6520 4e55 4c4c 2069 6620 7468 6520 636f  e NULL if the co
│ │ │ │ │ -0000b7f0: 6e74 6578 7420 7661 6c75 6520 7761 7320  ntext value was 
│ │ │ │ │ -0000b800: 6e6f 7420 7072 6576 696f 7573 6c79 2073  not previously s
│ │ │ │ │ -0000b810: 6574 2e0a 0a1f 0a46 696c 653a 206c 6962  et.....File: lib
│ │ │ │ │ -0000b820: 666b 6f2e 696e 666f 2c20 204e 6f64 653a  fko.info,  Node:
│ │ │ │ │ -0000b830: 2055 7469 6c69 7479 2046 756e 6374 696f   Utility Functio
│ │ │ │ │ -0000b840: 6e73 2c20 204e 6578 743a 2045 7272 6f72  ns,  Next: Error
│ │ │ │ │ -0000b850: 2048 616e 646c 696e 672c 2020 5072 6576   Handling,  Prev
│ │ │ │ │ -0000b860: 3a20 5265 7472 6965 7669 6e67 2053 5041  : Retrieving SPA
│ │ │ │ │ -0000b870: 2044 6174 612c 2020 5570 3a20 5573 696e   Data,  Up: Usin
│ │ │ │ │ -0000b880: 6720 6c69 6266 6b6f 0a0a 332e 3620 5574  g libfko..3.6 Ut
│ │ │ │ │ -0000b890: 696c 6974 7920 4675 6e63 7469 6f6e 730a  ility Functions.
│ │ │ │ │ +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.==
│ │ │ │ │  0000b8a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ │ -0000b8b0: 3d3d 3d3d 3d0a 0a54 6869 7320 7365 6374  =====..This sect
│ │ │ │ │ -0000b8c0: 696f 6e20 6465 7363 7269 6265 7320 7468  ion describes th
│ │ │ │ │ -0000b8d0: 6520 6675 6e63 7469 6f6e 7320 6e6f 7420  e functions not 
│ │ │ │ │ -0000b8e0: 636f 7665 7265 6420 656c 7365 7768 6572  covered elsewher
│ │ │ │ │ -0000b8f0: 6520 696e 2074 6869 730a 6d61 6e75 616c  e in this.manual
│ │ │ │ │ -0000b900: 2e20 2054 6865 7365 2061 7265 2075 7469  .  These are uti
│ │ │ │ │ -0000b910: 6c69 7479 2066 756e 6374 696f 6e73 2074  lity functions t
│ │ │ │ │ -0000b920: 6861 7420 6f70 6572 6174 6520 6f6e 2074  hat operate on t
│ │ │ │ │ -0000b930: 6865 2064 6174 6120 696e 2074 6865 2066  he data in the f
│ │ │ │ │ -0000b940: 6b6f 0a63 6f6e 7465 7874 2e20 2041 6c6c  ko.context.  All
│ │ │ │ │ -0000b950: 2062 7574 2027 666b 6f5f 7370 615f 6461   but 'fko_spa_da
│ │ │ │ │ -0000b960: 7461 5f66 696e 616c 2720 6172 6520 6361  ta_final' are ca
│ │ │ │ │ -0000b970: 6c6c 6564 2062 7920 6f74 6865 7220 6675  lled by other fu
│ │ │ │ │ -0000b980: 6e63 7469 6f6e 7320 616e 640a 6172 6520  nctions and.are 
│ │ │ │ │ -0000b990: 6e6f 7420 6e6f 726d 616c 6c79 2065 7870  not normally exp
│ │ │ │ │ -0000b9a0: 6c69 6369 746c 7920 6361 6c6c 6564 2062  licitly called b
│ │ │ │ │ -0000b9b0: 7920 7468 6520 7573 6572 2e20 2048 6f77  y the user.  How
│ │ │ │ │ -0000b9c0: 6576 6572 2c20 7468 6579 2063 616e 2062  ever, they can b
│ │ │ │ │ -0000b9d0: 652c 0a73 6f20 7468 6579 2061 7265 206c  e,.so they are l
│ │ │ │ │ -0000b9e0: 6973 7465 6420 6865 7265 2e0a 0a20 2020  isted here...   
│ │ │ │ │ -0000b9f0: 416c 6c20 6f66 2074 6865 7365 2066 756e  All of these fun
│ │ │ │ │ -0000ba00: 6374 696f 6e73 2072 6574 7572 6e20 616e  ctions return an
│ │ │ │ │ -0000ba10: 2069 6e74 6567 6572 2072 6570 7265 7365   integer represe
│ │ │ │ │ -0000ba20: 6e74 696e 6720 7468 6520 7265 7475 726e  nting the return
│ │ │ │ │ -0000ba30: 0a73 7461 7475 7320 6f66 2074 6865 2066  .status of the f
│ │ │ │ │ -0000ba40: 756e 6374 696f 6e2e 2020 5768 656e 2073  unction.  When s
│ │ │ │ │ -0000ba50: 7563 6365 7366 756c 6c2c 2074 6865 7920  uccesfull, they 
│ │ │ │ │ -0000ba60: 7769 6c6c 2072 6574 7572 6e0a 2746 4b4f  will return.'FKO
│ │ │ │ │ -0000ba70: 5f53 5543 4345 5353 272e 2020 4f74 6865  _SUCCESS'.  Othe
│ │ │ │ │ -0000ba80: 7277 6973 652c 2061 6e20 6572 726f 7220  rwise, an error 
│ │ │ │ │ -0000ba90: 636f 6465 2076 616c 7565 2069 7320 7265  code value is re
│ │ │ │ │ -0000baa0: 7475 726e 6564 2e0a 0a20 2d2d 2046 756e  turned... -- Fun
│ │ │ │ │ -0000bab0: 6374 696f 6e3a 2069 6e74 2066 6b6f 5f73  ction: int fko_s
│ │ │ │ │ -0000bac0: 7061 5f64 6174 615f 6669 6e61 6c20 2866  pa_data_final (f
│ │ │ │ │ -0000bad0: 6b6f 5f63 7478 5f74 2043 5458 2c20 6368  ko_ctx_t CTX, ch
│ │ │ │ │ -0000bae0: 6172 202a 454e 435f 4b45 592c 2069 6e74  ar *ENC_KEY, int
│ │ │ │ │ -0000baf0: 0a20 2020 2020 2020 2020 204b 454e 5f4c  .          KEN_L
│ │ │ │ │ -0000bb00: 454e 2c20 6368 6172 202a 484d 4143 5f4b  EN, char *HMAC_K
│ │ │ │ │ -0000bb10: 4559 2c20 696e 7420 484d 4143 5f4b 4559  EY, int HMAC_KEY
│ │ │ │ │ -0000bb20: 5f4c 454e 293b 0a20 2020 2020 5468 6973  _LEN);.     This
│ │ │ │ │ -0000bb30: 2066 756e 6374 696f 6e20 6973 2074 6865   function is the
│ │ │ │ │ -0000bb40: 2066 696e 616c 2073 7465 7020 696e 2063   final step in c
│ │ │ │ │ -0000bb50: 7265 6174 696e 6720 6120 636f 6d70 6c65  reating a comple
│ │ │ │ │ -0000bb60: 7465 2065 6e63 7279 7074 6564 0a20 2020  te encrypted.   
│ │ │ │ │ -0000bb70: 2020 5350 4120 6461 7461 2073 7472 696e    SPA data strin
│ │ │ │ │ -0000bb80: 6720 7375 6974 6162 6c65 2066 6f72 2074  g suitable for t
│ │ │ │ │ -0000bb90: 7261 6e73 6d69 7373 696f 6e20 746f 2061  ransmission to a
│ │ │ │ │ -0000bba0: 6e20 6677 6b6e 6f70 2073 6572 7665 722e  n fwknop server.
│ │ │ │ │ -0000bbb0: 2020 4974 0a20 2020 2020 646f 6573 2072    It.     does r
│ │ │ │ │ -0000bbc0: 6571 7569 7265 2061 6c6c 206f 6620 7468  equire all of th
│ │ │ │ │ -0000bbd0: 6520 7265 7175 6973 6974 6520 5350 4120  e requisite SPA 
│ │ │ │ │ -0000bbe0: 6461 7461 2066 6965 6c64 7320 6265 2073  data fields be s
│ │ │ │ │ -0000bbf0: 6574 2c20 6f74 6865 7277 6973 650a 2020  et, otherwise.  
│ │ │ │ │ -0000bc00: 2020 2069 7420 7769 6c6c 2066 6169 6c20     it will fail 
│ │ │ │ │ -0000bc10: 7769 7468 2061 6e20 6170 7072 6f70 7269  with an appropri
│ │ │ │ │ -0000bc20: 6174 6520 6572 726f 7220 636f 6465 2e0a  ate error code..
│ │ │ │ │ -0000bc30: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ │ -0000bc40: 6e74 2066 6b6f 5f64 6563 7279 7074 5f73  nt fko_decrypt_s
│ │ │ │ │ -0000bc50: 7061 5f64 6174 6120 2866 6b6f 5f63 7478  pa_data (fko_ctx
│ │ │ │ │ -0000bc60: 5f74 2043 5458 2c20 6368 6172 202a 4445  _t CTX, char *DE
│ │ │ │ │ -0000bc70: 435f 4b45 592c 0a20 2020 2020 2020 2020  C_KEY,.         
│ │ │ │ │ -0000bc80: 2069 6e74 204b 4559 5f4c 454e 293b 0a20   int KEY_LEN);. 
│ │ │ │ │ -0000bc90: 2020 2020 5768 656e 2067 6976 656e 2074      When given t
│ │ │ │ │ -0000bca0: 6865 2063 6f72 7265 6374 204b 4559 2028  he correct KEY (
│ │ │ │ │ -0000bcb0: 7061 7373 776f 7264 292c 2074 6869 7320  password), this 
│ │ │ │ │ -0000bcc0: 6675 6e63 7469 6f6e 2064 6563 7279 7074  function decrypt
│ │ │ │ │ -0000bcd0: 732c 0a20 2020 2020 6465 636f 6465 732c  s,.     decodes,
│ │ │ │ │ -0000bce0: 2061 6e64 2070 6172 7365 7320 7468 6520   and parses the 
│ │ │ │ │ -0000bcf0: 656e 6372 7970 7465 6420 5350 4120 6461  encrypted SPA da
│ │ │ │ │ -0000bd00: 7461 2074 6861 7420 7761 7320 7375 7070  ta that was supp
│ │ │ │ │ -0000bd10: 6c69 6564 2074 6f20 7468 650a 2020 2020  lied to the.    
│ │ │ │ │ -0000bd20: 2063 6f6e 7465 7874 2076 6961 2074 6865   context via the
│ │ │ │ │ -0000bd30: 2027 666b 6f5f 6e65 775f 7769 7468 5f64   'fko_new_with_d
│ │ │ │ │ -0000bd40: 6174 6127 2066 756e 6374 696f 6e20 7468  ata' function th
│ │ │ │ │ -0000bd50: 6174 2077 6173 2061 6c73 6f20 6361 6c6c  at was also call
│ │ │ │ │ -0000bd60: 6564 0a20 2020 2020 7769 7468 6f75 7420  ed.     without 
│ │ │ │ │ -0000bd70: 7468 6520 4b45 5920 7661 6c75 652e 2020  the KEY value.  
│ │ │ │ │ -0000bd80: 4f6e 6365 2074 6865 2064 6174 6120 6973  Once the data is
│ │ │ │ │ -0000bd90: 2064 6563 7279 7074 6564 2c20 7468 6973   decrypted, this
│ │ │ │ │ -0000bda0: 2066 756e 6374 696f 6e0a 2020 2020 2077   function.     w
│ │ │ │ │ -0000bdb0: 696c 6c20 616c 736f 2063 616c 6c20 2766  ill also call 'f
│ │ │ │ │ -0000bdc0: 6b6f 5f64 6563 6f64 655f 7370 615f 6461  ko_decode_spa_da
│ │ │ │ │ -0000bdd0: 7461 2720 746f 2064 6563 6f64 652c 2070  ta' to decode, p
│ │ │ │ │ -0000bde0: 6172 7365 2c20 7661 6c69 6461 7465 2c0a  arse, validate,.
│ │ │ │ │ -0000bdf0: 2020 2020 2061 6e64 2073 746f 7265 2074       and store t
│ │ │ │ │ -0000be00: 6865 2064 6174 6120 6669 656c 6473 2069  he data fields i
│ │ │ │ │ -0000be10: 6e20 7468 6520 636f 6e74 6578 7420 666f  n the context fo
│ │ │ │ │ -0000be20: 7220 6c61 7465 7220 7265 7472 6965 7661  r later retrieva
│ │ │ │ │ -0000be30: 6c2e 0a0a 202d 2d20 4675 6e63 7469 6f6e  l... -- Function
│ │ │ │ │ -0000be40: 3a20 696e 7420 666b 6f5f 656e 6372 7970  : int fko_encryp
│ │ │ │ │ -0000be50: 745f 7370 615f 6461 7461 2028 666b 6f5f  t_spa_data (fko_
│ │ │ │ │ -0000be60: 6374 785f 7420 4354 582c 2063 6861 7220  ctx_t CTX, char 
│ │ │ │ │ -0000be70: 2a45 4e43 5f4b 4559 2c0a 2020 2020 2020  *ENC_KEY,.      
│ │ │ │ │ -0000be80: 2020 2020 696e 7420 4b45 595f 4c45 4e29      int KEY_LEN)
│ │ │ │ │ -0000be90: 3b0a 2020 2020 2045 6e63 7279 7074 7320  ;.     Encrypts 
│ │ │ │ │ -0000bea0: 7468 6520 696e 7465 726d 6564 6961 7465  the intermediate
│ │ │ │ │ -0000beb0: 2065 6e63 6f64 6564 2053 5041 2064 6174   encoded SPA dat
│ │ │ │ │ -0000bec0: 6120 7374 6f72 6564 2069 6e20 7468 6520  a stored in the 
│ │ │ │ │ -0000bed0: 636f 6e74 6578 742e 0a20 2020 2020 5468  context..     Th
│ │ │ │ │ -0000bee0: 6973 2066 756e 6374 696f 6e20 7769 6c6c  is function will
│ │ │ │ │ -0000bef0: 2063 616c 6c20 2766 6b6f 5f65 6e63 6f64   call 'fko_encod
│ │ │ │ │ -0000bf00: 6527 2069 6620 6e65 6365 7373 6172 792e  e' if necessary.
│ │ │ │ │ -0000bf10: 2020 4974 2069 7320 6e6f 726d 616c 6c79    It is normally
│ │ │ │ │ -0000bf20: 0a20 2020 2020 6e6f 7420 6361 6c6c 6564  .     not called
│ │ │ │ │ -0000bf30: 2064 6972 6563 746c 7920 6173 2069 7420   directly as it 
│ │ │ │ │ -0000bf40: 6973 2063 616c 6c65 6420 6672 6f6d 2027  is called from '
│ │ │ │ │ -0000bf50: 666b 6f5f 7370 615f 6461 7461 5f66 696e  fko_spa_data_fin
│ │ │ │ │ -0000bf60: 616c 272e 0a0a 202d 2d20 4675 6e63 7469  al'... -- Functi
│ │ │ │ │ -0000bf70: 6f6e 3a20 696e 7420 666b 6f5f 6465 636f  on: int fko_deco
│ │ │ │ │ -0000bf80: 6465 5f73 7061 5f64 6174 6120 2866 6b6f  de_spa_data (fko
│ │ │ │ │ -0000bf90: 5f63 7478 5f74 2043 5458 293b 0a20 2020  _ctx_t CTX);.   
│ │ │ │ │ -0000bfa0: 2020 5468 6973 2066 756e 6374 696f 6e20    This function 
│ │ │ │ │ -0000bfb0: 7065 7266 6f72 6d73 2074 6865 2064 6563  performs the dec
│ │ │ │ │ -0000bfc0: 6f64 696e 672c 2070 6172 7369 6e67 2c20  oding, parsing, 
│ │ │ │ │ -0000bfd0: 7661 6c69 6461 7469 6f6e 206f 6620 7468  validation of th
│ │ │ │ │ -0000bfe0: 6520 5350 410a 2020 2020 2064 6174 6120  e SPA.     data 
│ │ │ │ │ -0000bff0: 7468 6174 2077 6173 206a 7573 7420 6465  that was just de
│ │ │ │ │ -0000c000: 6372 7970 7465 642e 2020 4974 2069 7320  crypted.  It is 
│ │ │ │ │ -0000c010: 6e6f 726d 616c 6c79 206e 6f74 2063 616c  normally not cal
│ │ │ │ │ -0000c020: 6c65 6420 6469 7265 6374 6c79 0a20 2020  led directly.   
│ │ │ │ │ -0000c030: 2020 6173 2069 7420 6973 2063 616c 6c65    as it is calle
│ │ │ │ │ -0000c040: 6420 6672 6f6d 2027 666b 6f5f 6465 6372  d from 'fko_decr
│ │ │ │ │ -0000c050: 7970 745f 7370 615f 6461 7461 2720 2877  ypt_spa_data' (w
│ │ │ │ │ -0000c060: 6869 6368 2069 7320 696e 2074 7572 6e0a  hich is in turn.
│ │ │ │ │ -0000c070: 2020 2020 2063 616c 6c65 6420 6672 6f6d       called from
│ │ │ │ │ -0000c080: 2027 666b 6f5f 6e65 775f 7769 7468 5f64   'fko_new_with_d
│ │ │ │ │ -0000c090: 6174 6127 2069 6620 6120 7061 7373 776f  ata' if a passwo
│ │ │ │ │ -0000c0a0: 7264 2069 7320 7375 7070 6c69 6564 2074  rd is supplied t
│ │ │ │ │ -0000c0b0: 6f20 6974 292e 0a0a 202d 2d20 4675 6e63  o it)... -- Func
│ │ │ │ │ -0000c0c0: 7469 6f6e 3a20 696e 7420 666b 6f5f 656e  tion: int fko_en
│ │ │ │ │ -0000c0d0: 636f 6465 5f73 7061 5f64 6174 6120 2866  code_spa_data (f
│ │ │ │ │ -0000c0e0: 6b6f 5f63 7478 5f74 2043 5458 293b 0a20  ko_ctx_t CTX);. 
│ │ │ │ │ -0000c0f0: 2020 2020 5065 7266 6f72 6d73 2074 6865      Performs the
│ │ │ │ │ -0000c100: 2062 6173 6536 3420 656e 636f 6469 6e67   base64 encoding
│ │ │ │ │ -0000c110: 206f 6620 7468 6f73 6520 5350 4120 6461   of those SPA da
│ │ │ │ │ -0000c120: 7461 2066 6965 6c64 7320 7468 6174 206e  ta fields that n
│ │ │ │ │ -0000c130: 6565 6420 746f 0a20 2020 2020 6265 2065  eed to.     be e
│ │ │ │ │ -0000c140: 6e63 6f64 6564 2c20 7065 7266 6f72 6d73  ncoded, performs
│ │ │ │ │ -0000c150: 2073 6f6d 6520 6461 7461 2076 616c 6964   some data valid
│ │ │ │ │ -0000c160: 6174 696f 6e2c 2061 6e64 2063 616c 6c73  ation, and calls
│ │ │ │ │ -0000c170: 0a20 2020 2020 2766 6b70 5f73 6574 5f73  .     'fkp_set_s
│ │ │ │ │ -0000c180: 7061 5f64 6967 6573 7427 2074 6f20 7265  pa_digest' to re
│ │ │ │ │ -0000c190: 636f 6d70 7574 6520 7468 6520 5350 4120  compute the SPA 
│ │ │ │ │ -0000c1a0: 6d65 7373 6167 6520 6469 6765 7374 2e20  message digest. 
│ │ │ │ │ -0000c1b0: 2049 7420 6973 0a20 2020 2020 6e6f 726d   It is.     norm
│ │ │ │ │ -0000c1c0: 616c 6c79 206e 6f74 2063 616c 6c65 6420  ally not called 
│ │ │ │ │ -0000c1d0: 6469 7265 6374 6c79 2061 7320 6974 2069  directly as it i
│ │ │ │ │ -0000c1e0: 7320 6361 6c6c 6564 2066 726f 6d0a 2020  s called from.  
│ │ │ │ │ -0000c1f0: 2020 2027 666b 6f5f 656e 6372 7970 745f     'fko_encrypt_
│ │ │ │ │ -0000c200: 7370 615f 6461 7461 2720 2877 6869 6368  spa_data' (which
│ │ │ │ │ -0000c210: 2069 7320 696e 2074 7572 6e20 6361 6c6c   is in turn call
│ │ │ │ │ -0000c220: 6564 2066 726f 6d0a 2020 2020 2027 666b  ed from.     'fk
│ │ │ │ │ -0000c230: 6f5f 7370 615f 6461 7461 5f66 696e 616c  o_spa_data_final
│ │ │ │ │ -0000c240: 2729 2e0a 0a5f 4750 472d 7370 6563 6966  ')..._GPG-specif
│ │ │ │ │ -0000c250: 6963 2075 7469 6c69 7479 2066 756e 6374  ic utility funct
│ │ │ │ │ -0000c260: 696f 6e73 3a5f 0a0a 202d 2d20 4675 6e63  ions:_.. -- Func
│ │ │ │ │ -0000c270: 7469 6f6e 3a20 696e 7420 666b 6f5f 6770  tion: int fko_gp
│ │ │ │ │ -0000c280: 675f 7369 676e 6174 7572 655f 6964 5f6d  g_signature_id_m
│ │ │ │ │ -0000c290: 6174 6368 2028 666b 6f5f 6374 785f 7420  atch (fko_ctx_t 
│ │ │ │ │ -0000c2a0: 4354 582c 2063 6f6e 7374 2063 6861 720a  CTX, const char.
│ │ │ │ │ -0000c2b0: 2020 2020 2020 2020 2020 2a49 442c 2075            *ID, u
│ │ │ │ │ -0000c2c0: 6e73 6967 6e65 6420 6368 6172 202a 4944  nsigned char *ID
│ │ │ │ │ -0000c2d0: 5f4d 4154 4348 293b 0a20 2020 2020 5365  _MATCH);.     Se
│ │ │ │ │ -0000c2e0: 7473 2074 6865 2076 616c 7565 206f 6620  ts the value of 
│ │ │ │ │ -0000c2f0: 7468 6520 4944 5f4d 4154 4348 2076 6172  the ID_MATCH var
│ │ │ │ │ -0000c300: 6961 626c 6520 746f 2074 7275 6520 2831  iable to true (1
│ │ │ │ │ -0000c310: 2920 6966 2074 6865 2076 616c 7565 206f  ) if the value o
│ │ │ │ │ -0000c320: 660a 2020 2020 2049 4420 6d61 7463 6865  f.     ID matche
│ │ │ │ │ -0000c330: 7320 7468 6520 4944 206f 6620 7468 6520  s the ID of the 
│ │ │ │ │ -0000c340: 4750 4720 7369 676e 6174 7572 6520 6173  GPG signature as
│ │ │ │ │ -0000c350: 736f 6369 6174 6564 2077 6974 6820 7468  sociated with th
│ │ │ │ │ -0000c360: 6520 6375 7272 656e 740a 2020 2020 2063  e current.     c
│ │ │ │ │ -0000c370: 6f6e 7465 7874 2e20 204f 7468 6572 7769  ontext.  Otherwi
│ │ │ │ │ -0000c380: 7365 2c20 4944 5f4d 4154 4348 2069 7320  se, ID_MATCH is 
│ │ │ │ │ -0000c390: 7365 7420 746f 2066 616c 7365 2028 3029  set to false (0)
│ │ │ │ │ -0000c3a0: 2e20 2054 6865 2072 6574 7572 6e0a 2020  .  The return.  
│ │ │ │ │ -0000c3b0: 2020 2076 616c 7565 2069 7320 616e 2046     value is an F
│ │ │ │ │ -0000c3c0: 4b4f 2065 7272 6f72 2073 7461 7475 732e  KO error status.
│ │ │ │ │ -0000c3d0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ │ -0000c3e0: 696e 7420 666b 6f5f 6770 675f 7369 676e  int fko_gpg_sign
│ │ │ │ │ -0000c3f0: 6174 7572 655f 6670 725f 6d61 7463 6820  ature_fpr_match 
│ │ │ │ │ -0000c400: 2866 6b6f 5f63 7478 5f74 2043 5458 2c20  (fko_ctx_t CTX, 
│ │ │ │ │ -0000c410: 636f 6e73 7420 6368 6172 0a20 2020 2020  const char.     
│ │ │ │ │ -0000c420: 2020 2020 202a 4650 522c 2075 6e73 6967       *FPR, unsig
│ │ │ │ │ -0000c430: 6e65 6420 6368 6172 202a 4650 525f 4d41  ned char *FPR_MA
│ │ │ │ │ -0000c440: 5443 4829 3b0a 2020 2020 2053 6574 7320  TCH);.     Sets 
│ │ │ │ │ -0000c450: 7468 6520 7661 6c75 6520 6f66 2074 6865  the value of the
│ │ │ │ │ -0000c460: 2046 5052 5f4d 4154 4348 2076 6172 6961   FPR_MATCH varia
│ │ │ │ │ -0000c470: 626c 6520 746f 2074 7275 6520 2831 2920  ble to true (1) 
│ │ │ │ │ -0000c480: 6966 2074 6865 2076 616c 7565 0a20 2020  if the value.   
│ │ │ │ │ -0000c490: 2020 6f66 2046 5052 206d 6174 6368 6573    of FPR matches
│ │ │ │ │ -0000c4a0: 2074 6865 2066 696e 6765 7270 7269 6e74   the fingerprint
│ │ │ │ │ -0000c4b0: 206f 6620 7468 6520 4750 4720 7369 676e   of the GPG sign
│ │ │ │ │ -0000c4c0: 6174 7572 6520 6173 736f 6369 6174 6564  ature associated
│ │ │ │ │ -0000c4d0: 2077 6974 680a 2020 2020 2074 6865 2063   with.     the c
│ │ │ │ │ -0000c4e0: 7572 7265 6e74 2063 6f6e 7465 7874 2e20  urrent context. 
│ │ │ │ │ -0000c4f0: 204f 7468 6572 7769 7365 2c20 4650 525f   Otherwise, FPR_
│ │ │ │ │ -0000c500: 4d41 5443 4820 6973 2073 6574 2074 6f20  MATCH is set to 
│ │ │ │ │ -0000c510: 6661 6c73 6520 2830 292e 0a20 2020 2020  false (0)..     
│ │ │ │ │ -0000c520: 5468 6520 7265 7475 726e 2076 616c 7565  The return value
│ │ │ │ │ -0000c530: 2069 7320 616e 2046 4b4f 2065 7272 6f72   is an FKO error
│ │ │ │ │ -0000c540: 2073 7461 7475 732e 0a0a 1f0a 4669 6c65   status.....File
│ │ │ │ │ -0000c550: 3a20 6c69 6266 6b6f 2e69 6e66 6f2c 2020  : libfko.info,  
│ │ │ │ │ -0000c560: 4e6f 6465 3a20 4572 726f 7220 4861 6e64  Node: Error Hand
│ │ │ │ │ -0000c570: 6c69 6e67 2c20 2050 7265 763a 2055 7469  ling,  Prev: Uti
│ │ │ │ │ -0000c580: 6c69 7479 2046 756e 6374 696f 6e73 2c20  lity Functions, 
│ │ │ │ │ -0000c590: 2055 703a 2055 7369 6e67 206c 6962 666b   Up: Using libfk
│ │ │ │ │ -0000c5a0: 6f0a 0a33 2e37 2045 7272 6f72 2048 616e  o..3.7 Error Han
│ │ │ │ │ -0000c5b0: 646c 696e 670a 3d3d 3d3d 3d3d 3d3d 3d3d  dling.==========
│ │ │ │ │ -0000c5c0: 3d3d 3d3d 3d3d 3d3d 0a0a 4d6f 7374 2066  ========..Most f
│ │ │ │ │ -0000c5d0: 6b6f 2066 756e 6374 696f 6e73 2072 6574  ko functions ret
│ │ │ │ │ -0000c5e0: 7572 6e20 616e 2069 6e74 6567 6572 2076  urn an integer v
│ │ │ │ │ -0000c5f0: 616c 7565 2074 6861 7420 636f 7272 6573  alue that corres
│ │ │ │ │ -0000c600: 706f 6e64 7320 746f 2065 6974 6865 720a  ponds to either.
│ │ │ │ │ -0000c610: 7375 6363 6573 7320 2830 292c 206f 7220  success (0), or 
│ │ │ │ │ -0000c620: 6f6e 6520 6f66 2074 6865 206e 6f6e 2d7a  one of the non-z
│ │ │ │ │ -0000c630: 6572 6f20 7661 6c75 6573 2074 6861 7220  ero values thar 
│ │ │ │ │ -0000c640: 636f 7272 6573 706f 6e64 7320 746f 2061  corresponds to a
│ │ │ │ │ -0000c650: 206e 756d 6265 720a 6f66 2070 6f73 7369   number.of possi
│ │ │ │ │ -0000c660: 626c 6520 6572 726f 7273 2e20 206c 6962  ble errors.  lib
│ │ │ │ │ -0000c670: 666b 6f20 7072 6f76 6964 6573 2061 2066  fko provides a f
│ │ │ │ │ -0000c680: 756e 6374 696f 6e20 746f 2067 6574 2061  unction to get a
│ │ │ │ │ -0000c690: 2064 6573 6372 6970 7469 7665 0a73 7472   descriptive.str
│ │ │ │ │ -0000c6a0: 696e 6720 666f 7220 7468 6520 6769 7665  ing for the give
│ │ │ │ │ -0000c6b0: 6e20 6572 726f 7220 636f 6465 2e0a 0a20  n error code... 
│ │ │ │ │ -0000c6c0: 2d2d 2046 756e 6374 696f 6e3a 2063 6f6e  -- Function: con
│ │ │ │ │ -0000c6d0: 7374 2063 6861 7220 2a20 666b 6f5f 6572  st char * fko_er
│ │ │ │ │ -0000c6e0: 7273 7472 2028 696e 7420 4552 525f 434f  rstr (int ERR_CO
│ │ │ │ │ -0000c6f0: 4445 290a 2020 2020 2054 6865 2066 756e  DE).     The fun
│ │ │ │ │ -0000c700: 6374 696f 6e20 2766 6b6f 5f65 7272 7374  ction 'fko_errst
│ │ │ │ │ -0000c710: 7227 2072 6574 7572 6e73 2061 2070 6f69  r' returns a poi
│ │ │ │ │ -0000c720: 6e74 6572 2074 6f20 6120 7374 6174 6963  nter to a static
│ │ │ │ │ -0000c730: 616c 6c79 0a20 2020 2020 616c 6c6f 6361  ally.     alloca
│ │ │ │ │ -0000c740: 7465 6420 7374 7269 6e67 2063 6f6e 7461  ted string conta
│ │ │ │ │ -0000c750: 696e 696e 6720 7468 6520 6465 7363 7269  ining the descri
│ │ │ │ │ -0000c760: 7074 696f 6e20 6f66 2074 6865 2065 7272  ption of the err
│ │ │ │ │ -0000c770: 6f72 2e0a 0a54 6865 206c 6973 7420 6f66  or...The list of
│ │ │ │ │ -0000c780: 2074 6865 2070 6f73 7369 626c 6520 6572   the possible er
│ │ │ │ │ -0000c790: 726f 7220 636f 6465 7320 616e 6420 7468  ror codes and th
│ │ │ │ │ -0000c7a0: 6569 7220 636f 7272 6573 706f 6e64 696e  eir correspondin
│ │ │ │ │ -0000c7b0: 670a 6465 7363 7269 7074 696f 6e73 2061  g.descriptions a
│ │ │ │ │ -0000c7c0: 7320 7265 7475 726e 6564 2062 7920 2766  s returned by 'f
│ │ │ │ │ -0000c7d0: 6b6f 5f65 7272 7374 7227 2066 6f6c 6c6f  ko_errstr' follo
│ │ │ │ │ -0000c7e0: 7773 3a0a 0a20 2d2d 2056 6172 6961 626c  ws:.. -- Variabl
│ │ │ │ │ -0000c7f0: 653a 2069 6e74 2065 7272 6f72 5f63 6f64  e: int error_cod
│ │ │ │ │ -0000c800: 650a 2020 2020 2027 464b 4f5f 5355 4343  e.     'FKO_SUCC
│ │ │ │ │ -0000c810: 4553 5327 0a20 2020 2020 2020 2020 2053  ESS'.          S
│ │ │ │ │ -0000c820: 7563 6365 7373 0a20 2020 2020 2746 4b4f  uccess.     'FKO
│ │ │ │ │ -0000c830: 5f45 5252 4f52 5f43 5458 5f4e 4f54 5f49  _ERROR_CTX_NOT_I
│ │ │ │ │ -0000c840: 4e49 5449 414c 495a 4544 270a 2020 2020  NITIALIZED'.    
│ │ │ │ │ -0000c850: 2020 2020 2020 464b 4f20 436f 6e74 6578        FKO Contex
│ │ │ │ │ -0000c860: 7420 6973 206e 6f74 2069 6e69 7469 616c  t is not initial
│ │ │ │ │ -0000c870: 697a 6564 0a20 2020 2020 2746 4b4f 5f45  ized.     'FKO_E
│ │ │ │ │ -0000c880: 5252 4f52 5f4d 454d 4f52 595f 414c 4c4f  RROR_MEMORY_ALLO
│ │ │ │ │ -0000c890: 4341 5449 4f4e 270a 2020 2020 2020 2020  CATION'.        
│ │ │ │ │ -0000c8a0: 2020 556e 6162 6c65 2074 6f20 616c 6c6f    Unable to allo
│ │ │ │ │ -0000c8b0: 6361 7465 206d 656d 6f72 790a 2020 2020  cate memory.    
│ │ │ │ │ -0000c8c0: 2027 464b 4f5f 4552 524f 525f 4649 4c45   'FKO_ERROR_FILE
│ │ │ │ │ -0000c8d0: 5359 5354 454d 5f4f 5045 5241 5449 4f4e  SYSTEM_OPERATION
│ │ │ │ │ -0000c8e0: 270a 2020 2020 2020 2020 2020 5265 6164  '.          Read
│ │ │ │ │ -0000c8f0: 2f77 7269 7465 2062 7974 6573 206d 6973  /write bytes mis
│ │ │ │ │ -0000c900: 6d61 7463 680a 2020 2020 2027 464b 4f5f  match.     'FKO_
│ │ │ │ │ -0000c910: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ -0000c920: 5441 270a 2020 2020 2020 2020 2020 4172  TA'.          Ar
│ │ │ │ │ -0000c930: 6773 2063 6f6e 7461 696e 2069 6e76 616c  gs contain inval
│ │ │ │ │ -0000c940: 6964 2064 6174 610a 2020 2020 2027 464b  id data.     'FK
│ │ │ │ │ -0000c950: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ -0000c960: 4441 5441 5f43 4c49 454e 545f 5449 4d45  DATA_CLIENT_TIME
│ │ │ │ │ -0000c970: 4f55 545f 4e45 4741 5449 5645 270a 2020  OUT_NEGATIVE'.  
│ │ │ │ │ -0000c980: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ -0000c990: 6461 7461 3a20 6e65 6761 7469 7665 2074  data: negative t
│ │ │ │ │ -0000c9a0: 696d 656f 7574 2076 616c 7565 0a20 2020  imeout value.   
│ │ │ │ │ -0000c9b0: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ -0000c9c0: 414c 4944 5f44 4154 415f 4445 434f 4445  ALID_DATA_DECODE
│ │ │ │ │ -0000c9d0: 5f4d 5347 4c45 4e5f 5641 4c49 4446 4149  _MSGLEN_VALIDFAI
│ │ │ │ │ -0000c9e0: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv
│ │ │ │ │ -0000c9f0: 616c 6964 2064 6174 613a 2069 6e76 616c  alid data: inval
│ │ │ │ │ -0000ca00: 6964 206d 6573 7361 6765 206c 656e 6774  id message lengt
│ │ │ │ │ -0000ca10: 680a 2020 2020 2027 464b 4f5f 4552 524f  h.     'FKO_ERRO
│ │ │ │ │ -0000ca20: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D
│ │ │ │ │ -0000ca30: 4543 4f44 455f 4e4f 4e5f 4153 4349 4927  ECODE_NON_ASCII'
│ │ │ │ │ -0000ca40: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ -0000ca50: 6964 2064 6174 613a 2063 6f6e 7461 696e  id data: contain
│ │ │ │ │ -0000ca60: 7320 6e6f 6e2d 6173 6369 6920 6368 6172  s non-ascii char
│ │ │ │ │ -0000ca70: 6163 7465 7273 0a20 2020 2020 2746 4b4f  acters.     'FKO
│ │ │ │ │ -0000ca80: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ -0000ca90: 4154 415f 4445 434f 4445 5f4c 545f 4d49  ATA_DECODE_LT_MI
│ │ │ │ │ -0000caa0: 4e5f 4649 454c 4453 270a 2020 2020 2020  N_FIELDS'.      
│ │ │ │ │ -0000cab0: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ -0000cac0: 3a20 696e 7375 6666 6963 6965 6e74 206e  : insufficient n
│ │ │ │ │ -0000cad0: 756d 6265 7220 6f66 2064 6174 6120 6669  umber of data fi
│ │ │ │ │ -0000cae0: 656c 6473 0a20 2020 2020 2746 4b4f 5f45  elds.     'FKO_E
│ │ │ │ │ -0000caf0: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ -0000cb00: 415f 4445 434f 4445 5f47 545f 4d41 585f  A_DECODE_GT_MAX_
│ │ │ │ │ -0000cb10: 4649 454c 4453 270a 2020 2020 2020 2020  FIELDS'.        
│ │ │ │ │ -0000cb20: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ -0000cb30: 746f 6f20 6d61 6e79 2064 6174 6120 6669  too many data fi
│ │ │ │ │ -0000cb40: 656c 6473 0a20 2020 2020 2746 4b4f 5f45  elds.     'FKO_E
│ │ │ │ │ -0000cb50: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ -0000cb60: 415f 4445 434f 4445 5f57 524f 4e47 5f4e  A_DECODE_WRONG_N
│ │ │ │ │ -0000cb70: 554d 5f46 4945 4c44 5327 0a20 2020 2020  UM_FIELDS'.     
│ │ │ │ │ -0000cb80: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat
│ │ │ │ │ -0000cb90: 613a 2069 6e76 616c 6964 206e 756d 6265  a: invalid numbe
│ │ │ │ │ -0000cba0: 7220 6f66 2066 6965 6c64 730a 2020 2020  r of fields.    
│ │ │ │ │ -0000cbb0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ -0000cbc0: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_
│ │ │ │ │ -0000cbd0: 454e 435f 4d53 475f 4c45 4e5f 4d54 5f54  ENC_MSG_LEN_MT_T
│ │ │ │ │ -0000cbe0: 5f53 495a 4527 0a20 2020 2020 2020 2020  _SIZE'.         
│ │ │ │ │ -0000cbf0: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d
│ │ │ │ │ -0000cc00: 6563 6f64 653a 2065 6e63 6f64 6564 206d  ecode: encoded m
│ │ │ │ │ -0000cc10: 6573 7361 6765 202d 2064 6967 6573 7420  essage - digest 
│ │ │ │ │ -0000cc20: 7369 7a65 2069 7320 6e6f 740a 2020 2020  size is not.    
│ │ │ │ │ -0000cc30: 2020 2020 2020 7661 6c69 640a 2020 2020        valid.    
│ │ │ │ │ -0000cc40: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ -0000cc50: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_
│ │ │ │ │ -0000cc60: 5241 4e44 5f4d 4953 5349 4e47 270a 2020  RAND_MISSING'.  
│ │ │ │ │ -0000cc70: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ -0000cc80: 6461 7461 3a20 6465 636f 6465 3a20 6d69  data: decode: mi
│ │ │ │ │ -0000cc90: 7373 696e 6720 7261 6e64 6f6d 2064 6174  ssing random dat
│ │ │ │ │ -0000cca0: 610a 2020 2020 2027 464b 4f5f 4552 524f  a.     'FKO_ERRO
│ │ │ │ │ -0000ccb0: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D
│ │ │ │ │ -0000ccc0: 4543 4f44 455f 5553 4552 4e41 4d45 5f4d  ECODE_USERNAME_M
│ │ │ │ │ -0000ccd0: 4953 5349 4e47 270a 2020 2020 2020 2020  ISSING'.        
│ │ │ │ │ -0000cce0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ -0000ccf0: 6465 636f 6465 3a20 6d69 7373 696e 6720  decode: missing 
│ │ │ │ │ -0000cd00: 7573 6572 6e61 6d65 0a20 2020 2020 2746  username.     'F
│ │ │ │ │ -0000cd10: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ -0000cd20: 5f44 4154 415f 4445 434f 4445 5f55 5345  _DATA_DECODE_USE
│ │ │ │ │ -0000cd30: 524e 414d 455f 544f 4f42 4947 270a 2020  RNAME_TOOBIG'.  
│ │ │ │ │ -0000cd40: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ -0000cd50: 6461 7461 3a20 6465 636f 6465 3a20 7573  data: decode: us
│ │ │ │ │ -0000cd60: 6572 6e61 6d65 2074 6f20 6c61 7267 650a  ername to large.
│ │ │ │ │ -0000cd70: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000cd80: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC
│ │ │ │ │ -0000cd90: 4f44 455f 5553 4552 4e41 4d45 5f44 4543  ODE_USERNAME_DEC
│ │ │ │ │ -0000cda0: 4f44 4546 4149 4c27 0a20 2020 2020 2020  ODEFAIL'.       
│ │ │ │ │ -0000cdb0: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:
│ │ │ │ │ -0000cdc0: 2064 6563 6f64 653a 2066 6169 6c65 6420   decode: failed 
│ │ │ │ │ -0000cdd0: 746f 2064 6563 6f64 6520 7573 6572 6e61  to decode userna
│ │ │ │ │ -0000cde0: 6d65 0a20 2020 2020 2746 4b4f 5f45 5252  me.     'FKO_ERR
│ │ │ │ │ -0000cdf0: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_
│ │ │ │ │ -0000ce00: 4445 434f 4445 5f55 5345 524e 414d 455f  DECODE_USERNAME_
│ │ │ │ │ -0000ce10: 5641 4c49 4446 4149 4c27 0a20 2020 2020  VALIDFAIL'.     
│ │ │ │ │ -0000ce20: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat
│ │ │ │ │ -0000ce30: 613a 2064 6563 6f64 653a 2069 6e76 616c  a: decode: inval
│ │ │ │ │ -0000ce40: 6964 2075 7365 726e 616d 650a 2020 2020  id username.    
│ │ │ │ │ -0000ce50: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ -0000ce60: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_
│ │ │ │ │ -0000ce70: 5449 4d45 5354 414d 505f 4d49 5353 494e  TIMESTAMP_MISSIN
│ │ │ │ │ -0000ce80: 4727 0a20 2020 2020 2020 2020 2049 6e76  G'.          Inv
│ │ │ │ │ -0000ce90: 616c 6964 2064 6174 613a 2064 6563 6f64  alid data: decod
│ │ │ │ │ -0000cea0: 653a 206d 6973 7369 6e67 2074 696d 6573  e: missing times
│ │ │ │ │ -0000ceb0: 7461 6d70 0a20 2020 2020 2746 4b4f 5f45  tamp.     'FKO_E
│ │ │ │ │ -0000cec0: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ -0000ced0: 415f 4445 434f 4445 5f54 494d 4553 5441  A_DECODE_TIMESTA
│ │ │ │ │ -0000cee0: 4d50 5f54 4f4f 4249 4727 0a20 2020 2020  MP_TOOBIG'.     
│ │ │ │ │ -0000cef0: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat
│ │ │ │ │ -0000cf00: 613a 2064 6563 6f64 653a 2074 696d 6573  a: decode: times
│ │ │ │ │ -0000cf10: 7461 6d70 2074 6f6f 206c 6172 6765 0a20  tamp too large. 
│ │ │ │ │ -0000cf20: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ -0000cf30: 4e56 414c 4944 5f44 4154 415f 4445 434f  NVALID_DATA_DECO
│ │ │ │ │ -0000cf40: 4445 5f54 494d 4553 5441 4d50 5f44 4543  DE_TIMESTAMP_DEC
│ │ │ │ │ -0000cf50: 4f44 4546 4149 4c27 0a20 2020 2020 2020  ODEFAIL'.       
│ │ │ │ │ -0000cf60: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:
│ │ │ │ │ -0000cf70: 2064 6563 6f64 653a 2066 6169 6c65 6420   decode: failed 
│ │ │ │ │ -0000cf80: 746f 2064 6563 6f64 6520 7469 6d65 7374  to decode timest
│ │ │ │ │ -0000cf90: 616d 700a 2020 2020 2027 464b 4f5f 4552  amp.     'FKO_ER
│ │ │ │ │ -0000cfa0: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ -0000cfb0: 5f44 4543 4f44 455f 5645 5253 494f 4e5f  _DECODE_VERSION_
│ │ │ │ │ -0000cfc0: 4d49 5353 494e 4727 0a20 2020 2020 2020  MISSING'.       
│ │ │ │ │ -0000cfd0: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:
│ │ │ │ │ -0000cfe0: 2064 6563 6f64 653a 206d 6973 7369 6e67   decode: missing
│ │ │ │ │ -0000cff0: 2076 6572 7369 6f6e 2064 6174 610a 2020   version data.  
│ │ │ │ │ -0000d000: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ -0000d010: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD
│ │ │ │ │ -0000d020: 455f 5645 5253 494f 4e5f 544f 4f42 4947  E_VERSION_TOOBIG
│ │ │ │ │ -0000d030: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva
│ │ │ │ │ -0000d040: 6c69 6420 6461 7461 3a20 6465 636f 6465  lid data: decode
│ │ │ │ │ -0000d050: 3a20 7665 7273 696f 6e20 6461 7461 2069  : version data i
│ │ │ │ │ -0000d060: 7320 746f 6f20 6c61 7267 650a 2020 2020  s too large.    
│ │ │ │ │ -0000d070: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ -0000d080: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_
│ │ │ │ │ -0000d090: 4d53 4754 5950 455f 4d49 5353 494e 4727  MSGTYPE_MISSING'
│ │ │ │ │ -0000d0a0: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ -0000d0b0: 6964 2064 6174 613a 2064 6563 6f64 653a  id data: decode:
│ │ │ │ │ -0000d0c0: 206d 6973 7369 6e67 206d 6573 7361 6765   missing message
│ │ │ │ │ -0000d0d0: 2074 7970 650a 2020 2020 2027 464b 4f5f   type.     'FKO_
│ │ │ │ │ -0000d0e0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ -0000d0f0: 5441 5f44 4543 4f44 455f 4d53 4754 5950  TA_DECODE_MSGTYP
│ │ │ │ │ -0000d100: 455f 544f 4f42 4947 270a 2020 2020 2020  E_TOOBIG'.      
│ │ │ │ │ -0000d110: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ -0000d120: 3a20 6465 636f 6465 3a20 6d65 7373 6167  : decode: messag
│ │ │ │ │ -0000d130: 6520 7479 7065 2069 7320 746f 6f20 6c61  e type is too la
│ │ │ │ │ -0000d140: 7267 650a 2020 2020 2027 464b 4f5f 4552  rge.     'FKO_ER
│ │ │ │ │ -0000d150: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ -0000d160: 5f44 4543 4f44 455f 4d53 4754 5950 455f  _DECODE_MSGTYPE_
│ │ │ │ │ -0000d170: 4445 434f 4445 4641 494c 270a 2020 2020  DECODEFAIL'.    
│ │ │ │ │ -0000d180: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ -0000d190: 7461 3a20 6465 636f 6465 3a20 6661 696c  ta: decode: fail
│ │ │ │ │ -0000d1a0: 6564 2074 6f20 6465 636f 6465 206d 6573  ed to decode mes
│ │ │ │ │ -0000d1b0: 7361 6765 2074 7970 650a 2020 2020 2027  sage type.     '
│ │ │ │ │ -0000d1c0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ -0000d1d0: 445f 4441 5441 5f44 4543 4f44 455f 4d45  D_DATA_DECODE_ME
│ │ │ │ │ -0000d1e0: 5353 4147 455f 4d49 5353 494e 4727 0a20  SSAGE_MISSING'. 
│ │ │ │ │ -0000d1f0: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ -0000d200: 2064 6174 613a 2064 6563 6f64 653a 206d   data: decode: m
│ │ │ │ │ -0000d210: 6973 7369 6e67 206d 6573 7361 6765 2064  issing message d
│ │ │ │ │ -0000d220: 6174 610a 2020 2020 2027 464b 4f5f 4552  ata.     'FKO_ER
│ │ │ │ │ -0000d230: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ -0000d240: 5f44 4543 4f44 455f 4d45 5353 4147 455f  _DECODE_MESSAGE_
│ │ │ │ │ -0000d250: 544f 4f42 4947 270a 2020 2020 2020 2020  TOOBIG'.        
│ │ │ │ │ -0000d260: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ -0000d270: 6465 636f 6465 3a20 6d65 7373 6167 6520  decode: message 
│ │ │ │ │ -0000d280: 6461 7461 2069 7320 746f 6f20 6c61 7267  data is too larg
│ │ │ │ │ -0000d290: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO
│ │ │ │ │ -0000d2a0: 525f 494e 5641 4c49 445f 4441 5441 5f44  R_INVALID_DATA_D
│ │ │ │ │ -0000d2b0: 4543 4f44 455f 4d45 5353 4147 455f 4445  ECODE_MESSAGE_DE
│ │ │ │ │ -0000d2c0: 434f 4445 4641 494c 270a 2020 2020 2020  CODEFAIL'.      
│ │ │ │ │ -0000d2d0: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ -0000d2e0: 3a20 6465 636f 6465 3a20 6661 696c 6564  : decode: failed
│ │ │ │ │ -0000d2f0: 2074 6f20 6465 636f 6465 206d 6573 7361   to decode messa
│ │ │ │ │ -0000d300: 6765 2064 6174 610a 2020 2020 2027 464b  ge data.     'FK
│ │ │ │ │ -0000d310: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ -0000d320: 4441 5441 5f44 4543 4f44 455f 4d45 5353  DATA_DECODE_MESS
│ │ │ │ │ -0000d330: 4147 455f 5641 4c49 4446 4149 4c27 0a20  AGE_VALIDFAIL'. 
│ │ │ │ │ -0000d340: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ -0000d350: 2064 6174 613a 2064 6563 6f64 653a 2069   data: decode: i
│ │ │ │ │ -0000d360: 6e76 616c 6964 206d 6573 7361 6765 2064  nvalid message d
│ │ │ │ │ -0000d370: 6174 610a 2020 2020 2027 464b 4f5f 4552  ata.     'FKO_ER
│ │ │ │ │ -0000d380: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ -0000d390: 5f44 4543 4f44 455f 4143 4345 5353 5f56  _DECODE_ACCESS_V
│ │ │ │ │ -0000d3a0: 414c 4944 4641 494c 270a 2020 2020 2020  ALIDFAIL'.      
│ │ │ │ │ -0000d3b0: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ -0000d3c0: 3a20 6465 636f 6465 3a20 696e 766c 6961  : decode: invlia
│ │ │ │ │ -0000d3d0: 6420 6163 6365 7373 2064 6174 610a 2020  d access data.  
│ │ │ │ │ -0000d3e0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ -0000d3f0: 5641 4c49 445f 4441 5441 5f44 4543 4f44  VALID_DATA_DECOD
│ │ │ │ │ -0000d400: 455f 4e41 5441 4343 4553 535f 4d49 5353  E_NATACCESS_MISS
│ │ │ │ │ -0000d410: 494e 4727 0a20 2020 2020 2020 2020 2049  ING'.          I
│ │ │ │ │ -0000d420: 6e76 616c 6964 2064 6174 613a 2064 6563  nvalid data: dec
│ │ │ │ │ -0000d430: 6f64 653a 206d 6973 7369 6e67 204e 4154  ode: missing NAT
│ │ │ │ │ -0000d440: 2061 6363 6573 7320 6461 7461 0a20 2020   access data.   
│ │ │ │ │ -0000d450: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ -0000d460: 414c 4944 5f44 4154 415f 4445 434f 4445  ALID_DATA_DECODE
│ │ │ │ │ -0000d470: 5f4e 4154 4143 4345 5353 5f54 4f4f 4249  _NATACCESS_TOOBI
│ │ │ │ │ -0000d480: 4727 0a20 2020 2020 2020 2020 2049 6e76  G'.          Inv
│ │ │ │ │ -0000d490: 616c 6964 2064 6174 613a 2064 6563 6f64  alid data: decod
│ │ │ │ │ -0000d4a0: 653a 204e 4154 2061 6363 6573 7320 6461  e: NAT access da
│ │ │ │ │ -0000d4b0: 7461 2069 7320 746f 6f20 6c61 7267 650a  ta is too large.
│ │ │ │ │ -0000d4c0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000d4d0: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC
│ │ │ │ │ -0000d4e0: 4f44 455f 4e41 5441 4343 4553 535f 4445  ODE_NATACCESS_DE
│ │ │ │ │ -0000d4f0: 434f 4445 4641 494c 270a 2020 2020 2020  CODEFAIL'.      
│ │ │ │ │ -0000d500: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ -0000d510: 3a20 6465 636f 6465 3a20 6661 696c 6564  : decode: failed
│ │ │ │ │ -0000d520: 2074 6f20 6465 636f 6465 204e 4154 2061   to decode NAT a
│ │ │ │ │ -0000d530: 6363 6573 7320 6461 7461 0a20 2020 2020  ccess data.     
│ │ │ │ │ -0000d540: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ -0000d550: 4944 5f44 4154 415f 4445 434f 4445 5f4e  ID_DATA_DECODE_N
│ │ │ │ │ -0000d560: 4154 4143 4345 5353 5f56 414c 4944 4641  ATACCESS_VALIDFA
│ │ │ │ │ -0000d570: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In
│ │ │ │ │ -0000d580: 7661 6c69 6420 6461 7461 3a20 6465 636f  valid data: deco
│ │ │ │ │ -0000d590: 6465 3a20 696e 7661 6c69 6420 4e41 5420  de: invalid NAT 
│ │ │ │ │ -0000d5a0: 6163 6365 7373 0a20 2020 2020 2746 4b4f  access.     'FKO
│ │ │ │ │ -0000d5b0: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ -0000d5c0: 4154 415f 4445 434f 4445 5f53 5256 4155  ATA_DECODE_SRVAU
│ │ │ │ │ -0000d5d0: 5448 5f4d 4953 5349 4e47 270a 2020 2020  TH_MISSING'.    
│ │ │ │ │ -0000d5e0: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ -0000d5f0: 7461 3a20 6465 636f 6465 3a20 6d69 7373  ta: decode: miss
│ │ │ │ │ -0000d600: 696e 6720 7365 7276 6572 2061 7574 680a  ing server auth.
│ │ │ │ │ -0000d610: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000d620: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC
│ │ │ │ │ -0000d630: 4f44 455f 5352 5641 5554 485f 4445 434f  ODE_SRVAUTH_DECO
│ │ │ │ │ -0000d640: 4445 4641 494c 270a 2020 2020 2020 2020  DEFAIL'.        
│ │ │ │ │ -0000d650: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ -0000d660: 6465 636f 6465 3a20 7365 7276 6572 2061  decode: server a
│ │ │ │ │ -0000d670: 7574 6820 6465 636f 6465 2066 6169 6c0a  uth decode fail.
│ │ │ │ │ -0000d680: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000d690: 494e 5641 4c49 445f 4441 5441 5f44 4543  INVALID_DATA_DEC
│ │ │ │ │ -0000d6a0: 4f44 455f 5350 415f 4558 5452 415f 544f  ODE_SPA_EXTRA_TO
│ │ │ │ │ -0000d6b0: 4f42 4947 270a 2020 2020 2020 2020 2020  OBIG'.          
│ │ │ │ │ -0000d6c0: 496e 7661 6c69 6420 6461 7461 3a20 6465  Invalid data: de
│ │ │ │ │ -0000d6d0: 636f 6465 3a20 5350 4120 6578 7472 6120  code: SPA extra 
│ │ │ │ │ -0000d6e0: 746f 6f20 6c61 7267 650a 2020 2020 2027  too large.     '
│ │ │ │ │ -0000d6f0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ -0000d700: 445f 4441 5441 5f44 4543 4f44 455f 4558  D_DATA_DECODE_EX
│ │ │ │ │ -0000d710: 5452 415f 544f 4f42 4947 270a 2020 2020  TRA_TOOBIG'.    
│ │ │ │ │ -0000d720: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ -0000d730: 7461 3a20 6465 636f 6465 3a20 6578 7472  ta: decode: extr
│ │ │ │ │ -0000d740: 6120 746f 6f20 6c61 7267 650a 2020 2020  a too large.    
│ │ │ │ │ -0000d750: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ -0000d760: 4c49 445f 4441 5441 5f44 4543 4f44 455f  LID_DATA_DECODE_
│ │ │ │ │ -0000d770: 4558 5452 415f 4445 434f 4445 4641 494c  EXTRA_DECODEFAIL
│ │ │ │ │ -0000d780: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva
│ │ │ │ │ -0000d790: 6c69 6420 6461 7461 3a20 6465 636f 6465  lid data: decode
│ │ │ │ │ -0000d7a0: 3a20 6578 7472 6120 6465 636f 6465 2066  : extra decode f
│ │ │ │ │ -0000d7b0: 6169 6c65 640a 2020 2020 2027 464b 4f5f  ailed.     'FKO_
│ │ │ │ │ -0000d7c0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ -0000d7d0: 5441 5f44 4543 4f44 455f 5449 4d45 4f55  TA_DECODE_TIMEOU
│ │ │ │ │ -0000d7e0: 545f 4d49 5353 494e 4727 0a20 2020 2020  T_MISSING'.     
│ │ │ │ │ -0000d7f0: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat
│ │ │ │ │ -0000d800: 613a 2064 6563 6f64 653a 206d 6973 7369  a: decode: missi
│ │ │ │ │ -0000d810: 6e67 2074 696d 656f 7574 0a20 2020 2020  ng timeout.     
│ │ │ │ │ -0000d820: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ -0000d830: 4944 5f44 4154 415f 4445 434f 4445 5f54  ID_DATA_DECODE_T
│ │ │ │ │ -0000d840: 494d 454f 5554 5f54 4f4f 4249 4727 0a20  IMEOUT_TOOBIG'. 
│ │ │ │ │ -0000d850: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ -0000d860: 2064 6174 613a 2064 6563 6f64 6520 7469   data: decode ti
│ │ │ │ │ -0000d870: 6d65 6f75 7420 7661 6c75 6520 6973 2074  meout value is t
│ │ │ │ │ -0000d880: 6f6f 206c 6172 6765 0a20 2020 2020 2746  oo large.     'F
│ │ │ │ │ -0000d890: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ -0000d8a0: 5f44 4154 415f 4445 434f 4445 5f54 494d  _DATA_DECODE_TIM
│ │ │ │ │ -0000d8b0: 454f 5554 5f56 414c 4944 4641 494c 270a  EOUT_VALIDFAIL'.
│ │ │ │ │ -0000d8c0: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ -0000d8d0: 6420 6461 7461 3a20 6465 636f 6465 2069  d data: decode i
│ │ │ │ │ -0000d8e0: 6e76 616c 6964 2074 696d 656f 7574 0a20  nvalid timeout. 
│ │ │ │ │ -0000d8f0: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ -0000d900: 4e56 414c 4944 5f44 4154 415f 4445 434f  NVALID_DATA_DECO
│ │ │ │ │ -0000d910: 4445 5f54 494d 454f 5554 5f44 4543 4f44  DE_TIMEOUT_DECOD
│ │ │ │ │ -0000d920: 4546 4149 4c27 0a20 2020 2020 2020 2020  EFAIL'.         
│ │ │ │ │ -0000d930: 2049 6e76 616c 6964 2064 6174 613a 2064   Invalid data: d
│ │ │ │ │ -0000d940: 6563 6f64 653a 2074 696d 656f 7574 2064  ecode: timeout d
│ │ │ │ │ -0000d950: 6563 6f64 6520 6661 696c 6564 0a20 2020  ecode failed.   
│ │ │ │ │ -0000d960: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ -0000d970: 414c 4944 5f44 4154 415f 454e 434f 4445  ALID_DATA_ENCODE
│ │ │ │ │ -0000d980: 5f4d 4553 5341 4745 5f54 4f4f 4249 4727  _MESSAGE_TOOBIG'
│ │ │ │ │ -0000d990: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ -0000d9a0: 6964 2064 6174 613a 2065 6e63 6f64 653a  id data: encode:
│ │ │ │ │ -0000d9b0: 206d 6573 7361 6765 2069 7320 746f 6f20   message is too 
│ │ │ │ │ -0000d9c0: 6c61 7267 650a 2020 2020 2027 464b 4f5f  large.     'FKO_
│ │ │ │ │ -0000d9d0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ -0000d9e0: 5441 5f45 4e43 4f44 455f 4d53 474c 454e  TA_ENCODE_MSGLEN
│ │ │ │ │ -0000d9f0: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    
│ │ │ │ │ -0000da00: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ -0000da10: 7461 3a20 656e 636f 6465 3a20 696e 7661  ta: encode: inva
│ │ │ │ │ -0000da20: 6c69 6420 6d65 7373 6167 6520 6c65 6e67  lid message leng
│ │ │ │ │ -0000da30: 7468 0a20 2020 2020 2746 4b4f 5f45 5252  th.     'FKO_ERR
│ │ │ │ │ -0000da40: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_
│ │ │ │ │ -0000da50: 454e 434f 4445 5f44 4947 4553 545f 5641  ENCODE_DIGEST_VA
│ │ │ │ │ -0000da60: 4c49 4446 4149 4c27 0a20 2020 2020 2020  LIDFAIL'.       
│ │ │ │ │ -0000da70: 2020 2049 6e76 616c 6964 2064 6174 613a     Invalid data:
│ │ │ │ │ -0000da80: 2065 6e63 6f64 653a 2069 6e76 616c 6964   encode: invalid
│ │ │ │ │ -0000da90: 2064 6967 6573 740a 2020 2020 2027 464b   digest.     'FK
│ │ │ │ │ -0000daa0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ -0000dab0: 4441 5441 5f45 4e43 4f44 455f 4449 4745  DATA_ENCODE_DIGE
│ │ │ │ │ -0000dac0: 5354 5f54 4f4f 4249 4727 0a20 2020 2020  ST_TOOBIG'.     
│ │ │ │ │ -0000dad0: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat
│ │ │ │ │ -0000dae0: 613a 2065 6e63 6f64 653a 2064 6967 6573  a: encode: diges
│ │ │ │ │ -0000daf0: 7420 6973 2074 6f6f 206c 6172 6765 0a20  t is too large. 
│ │ │ │ │ -0000db00: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ -0000db10: 4e56 414c 4944 5f44 4154 415f 454e 434f  NVALID_DATA_ENCO
│ │ │ │ │ -0000db20: 4445 5f4e 4f54 4241 5345 3634 270a 2020  DE_NOTBASE64'.  
│ │ │ │ │ -0000db30: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ -0000db40: 6461 7461 3a20 656e 636f 6465 6420 6461  data: encoded da
│ │ │ │ │ -0000db50: 7461 2069 7320 6e6f 7420 4261 7365 3634  ta is not Base64
│ │ │ │ │ -0000db60: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -0000db70: 5f49 4e56 414c 4944 5f44 4154 415f 454e  _INVALID_DATA_EN
│ │ │ │ │ -0000db80: 4352 5950 545f 4d53 474c 454e 5f56 414c  CRYPT_MSGLEN_VAL
│ │ │ │ │ -0000db90: 4944 4641 494c 270a 2020 2020 2020 2020  IDFAIL'.        
│ │ │ │ │ -0000dba0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ -0000dbb0: 656e 6372 7970 743a 2069 6e76 616c 6964  encrypt: invalid
│ │ │ │ │ -0000dbc0: 206d 6573 7361 6765 206c 656e 6774 680a   message length.
│ │ │ │ │ -0000dbd0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000dbe0: 494e 5641 4c49 445f 4441 5441 5f45 4e43  INVALID_DATA_ENC
│ │ │ │ │ -0000dbf0: 5259 5054 5f44 4947 4553 544c 454e 5f56  RYPT_DIGESTLEN_V
│ │ │ │ │ -0000dc00: 414c 4944 4641 494c 270a 2020 2020 2020  ALIDFAIL'.      
│ │ │ │ │ -0000dc10: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ -0000dc20: 3a20 656e 6372 7970 743a 2069 6e76 616c  : encrypt: inval
│ │ │ │ │ -0000dc30: 6964 2064 6967 6573 7420 6c65 6e67 7468  id digest length
│ │ │ │ │ -0000dc40: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -0000dc50: 5f49 4e56 414c 4944 5f44 4154 415f 454e  _INVALID_DATA_EN
│ │ │ │ │ -0000dc60: 4352 5950 545f 5054 4c45 4e5f 5641 4c49  CRYPT_PTLEN_VALI
│ │ │ │ │ -0000dc70: 4446 4149 4c27 0a20 2020 2020 2020 2020  DFAIL'.         
│ │ │ │ │ -0000dc80: 2049 6e76 616c 6964 2064 6174 613a 2065   Invalid data: e
│ │ │ │ │ -0000dc90: 6e63 7279 7074 3a20 696e 7661 6c69 6420  ncrypt: invalid 
│ │ │ │ │ -0000dca0: 706c 6169 6e74 6578 7420 6c65 6e67 7468  plaintext length
│ │ │ │ │ -0000dcb0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -0000dcc0: 5f49 4e56 414c 4944 5f44 4154 415f 454e  _INVALID_DATA_EN
│ │ │ │ │ -0000dcd0: 4352 5950 545f 5245 5355 4c54 5f4d 5347  CRYPT_RESULT_MSG
│ │ │ │ │ -0000dce0: 4c45 4e5f 5641 4c49 4446 4149 4c27 0a20  LEN_VALIDFAIL'. 
│ │ │ │ │ -0000dcf0: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ -0000dd00: 2064 6174 613a 2065 6e63 7279 7074 3a20   data: encrypt: 
│ │ │ │ │ -0000dd10: 696e 7661 6c69 6420 656e 6372 7970 7420  invalid encrypt 
│ │ │ │ │ -0000dd20: 7265 7375 6c74 206d 6573 7361 6765 206c  result message l
│ │ │ │ │ -0000dd30: 656e 6774 680a 2020 2020 2027 464b 4f5f  ength.     'FKO_
│ │ │ │ │ -0000dd40: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ -0000dd50: 5441 5f45 4e43 5259 5054 5f43 4950 4845  TA_ENCRYPT_CIPHE
│ │ │ │ │ -0000dd60: 524c 454e 5f44 4543 4f44 4546 4149 4c27  RLEN_DECODEFAIL'
│ │ │ │ │ -0000dd70: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ -0000dd80: 6964 2064 6174 613a 2065 6e63 7279 7074  id data: encrypt
│ │ │ │ │ -0000dd90: 3a20 6465 636f 6465 2063 6970 6865 7220  : decode cipher 
│ │ │ │ │ -0000dda0: 6c65 6e67 7468 2066 6169 6c65 640a 2020  length failed.  
│ │ │ │ │ -0000ddb0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ -0000ddc0: 5641 4c49 445f 4441 5441 5f45 4e43 5259  VALID_DATA_ENCRY
│ │ │ │ │ -0000ddd0: 5054 5f43 4950 4845 524c 454e 5f56 414c  PT_CIPHERLEN_VAL
│ │ │ │ │ -0000dde0: 4944 4641 494c 270a 2020 2020 2020 2020  IDFAIL'.        
│ │ │ │ │ -0000ddf0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ -0000de00: 656e 6372 7970 743a 2069 6e76 616c 6964  encrypt: invalid
│ │ │ │ │ -0000de10: 2063 6970 6865 7220 6c65 6e67 7468 0a20   cipher length. 
│ │ │ │ │ -0000de20: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ -0000de30: 4e56 414c 4944 5f44 4154 415f 454e 4352  NVALID_DATA_ENCR
│ │ │ │ │ -0000de40: 5950 545f 4445 4352 5950 5445 445f 4d45  YPT_DECRYPTED_ME
│ │ │ │ │ -0000de50: 5353 4147 455f 4d49 5353 494e 4727 0a20  SSAGE_MISSING'. 
│ │ │ │ │ -0000de60: 2020 2020 2020 2020 2049 6e76 616c 6964           Invalid
│ │ │ │ │ -0000de70: 2064 6174 613a 2065 6e63 7279 7074 3a20   data: encrypt: 
│ │ │ │ │ -0000de80: 6d69 7373 696e 6720 6465 6372 7970 7465  missing decrypte
│ │ │ │ │ -0000de90: 6420 6d65 7373 6167 650a 2020 2020 2027  d message.     '
│ │ │ │ │ -0000dea0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ -0000deb0: 445f 4441 5441 5f45 4e43 5259 5054 5f44  D_DATA_ENCRYPT_D
│ │ │ │ │ -0000dec0: 4543 5259 5054 4544 5f4d 5347 4c45 4e5f  ECRYPTED_MSGLEN_
│ │ │ │ │ -0000ded0: 5641 4c49 4446 4149 4c27 0a20 2020 2020  VALIDFAIL'.     
│ │ │ │ │ -0000dee0: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat
│ │ │ │ │ -0000def0: 613a 2065 6e63 7279 7074 3a20 696e 7661  a: encrypt: inva
│ │ │ │ │ -0000df00: 6c69 6420 6465 6372 7970 7465 6420 6d65  lid decrypted me
│ │ │ │ │ -0000df10: 7373 6167 6520 6c65 6e67 7468 0a20 2020  ssage length.   
│ │ │ │ │ -0000df20: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ -0000df30: 414c 4944 5f44 4154 415f 454e 4352 5950  ALID_DATA_ENCRYP
│ │ │ │ │ -0000df40: 545f 5459 5045 5f56 414c 4944 4641 494c  T_TYPE_VALIDFAIL
│ │ │ │ │ -0000df50: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva
│ │ │ │ │ -0000df60: 6c69 6420 6461 7461 3a20 656e 6372 7970  lid data: encryp
│ │ │ │ │ -0000df70: 743a 2069 6e76 616c 6964 2065 6e63 7279  t: invalid encry
│ │ │ │ │ -0000df80: 7074 696f 6e20 7479 7065 0a20 2020 2020  ption type.     
│ │ │ │ │ -0000df90: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ -0000dfa0: 4944 5f44 4154 415f 454e 4352 5950 545f  ID_DATA_ENCRYPT_
│ │ │ │ │ -0000dfb0: 4d4f 4445 5f56 414c 4944 4641 494c 270a  MODE_VALIDFAIL'.
│ │ │ │ │ -0000dfc0: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ -0000dfd0: 6420 6461 7461 3a20 656e 6372 7970 743a  d data: encrypt:
│ │ │ │ │ -0000dfe0: 2069 6e76 616c 6964 2065 6e63 7279 7074   invalid encrypt
│ │ │ │ │ -0000dff0: 696f 6e20 6d6f 6465 0a20 2020 2020 2746  ion mode.     'F
│ │ │ │ │ -0000e000: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ -0000e010: 5f44 4154 415f 454e 4352 5950 545f 5459  _DATA_ENCRYPT_TY
│ │ │ │ │ -0000e020: 5045 5f55 4e4b 4e4f 574e 270a 2020 2020  PE_UNKNOWN'.    
│ │ │ │ │ -0000e030: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ -0000e040: 7461 3a20 656e 6372 7970 743a 2075 6e6b  ta: encrypt: unk
│ │ │ │ │ -0000e050: 6e6f 776e 2065 6e63 7279 7074 696f 6e20  nown encryption 
│ │ │ │ │ -0000e060: 7479 7065 0a20 2020 2020 2746 4b4f 5f45  type.     'FKO_E
│ │ │ │ │ -0000e070: 5252 4f52 5f49 4e56 414c 4944 5f44 4154  RROR_INVALID_DAT
│ │ │ │ │ -0000e080: 415f 4655 4e43 535f 4e45 575f 454e 434d  A_FUNCS_NEW_ENCM
│ │ │ │ │ -0000e090: 5347 5f4d 4953 5349 4e47 270a 2020 2020  SG_MISSING'.    
│ │ │ │ │ -0000e0a0: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ -0000e0b0: 7461 3a20 6d69 7373 696e 6720 656e 636f  ta: missing enco
│ │ │ │ │ -0000e0c0: 6465 6420 6d65 7373 6167 650a 2020 2020  ded message.    
│ │ │ │ │ -0000e0d0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ -0000e0e0: 4c49 445f 4441 5441 5f46 554e 4353 5f4e  LID_DATA_FUNCS_N
│ │ │ │ │ -0000e0f0: 4557 5f4d 5347 4c45 4e5f 5641 4c49 4446  EW_MSGLEN_VALIDF
│ │ │ │ │ -0000e100: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I
│ │ │ │ │ -0000e110: 6e76 616c 6964 2064 6174 613a 2069 6e76  nvalid data: inv
│ │ │ │ │ -0000e120: 616c 6964 206d 6573 7361 6765 206c 656e  alid message len
│ │ │ │ │ -0000e130: 6774 6820 6672 6f6d 206e 6577 0a20 2020  gth from new.   
│ │ │ │ │ -0000e140: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ -0000e150: 414c 4944 5f44 4154 415f 4655 4e43 535f  ALID_DATA_FUNCS_
│ │ │ │ │ -0000e160: 4745 4e5f 4b45 594c 454e 5f56 414c 4944  GEN_KEYLEN_VALID
│ │ │ │ │ -0000e170: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          
│ │ │ │ │ -0000e180: 496e 7661 6c69 6420 6461 7461 3a20 696e  Invalid data: in
│ │ │ │ │ -0000e190: 7661 6c69 6420 6b65 7920 6c65 6e67 7468  valid key length
│ │ │ │ │ -0000e1a0: 2066 726f 6d20 6765 6e5f 6b65 796c 656e   from gen_keylen
│ │ │ │ │ -0000e1b0: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -0000e1c0: 5f49 4e56 414c 4944 5f44 4154 415f 4655  _INVALID_DATA_FU
│ │ │ │ │ -0000e1d0: 4e43 535f 4745 4e5f 484d 4143 4c45 4e5f  NCS_GEN_HMACLEN_
│ │ │ │ │ -0000e1e0: 5641 4c49 4446 4149 4c27 0a20 2020 2020  VALIDFAIL'.     
│ │ │ │ │ -0000e1f0: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat
│ │ │ │ │ -0000e200: 613a 2067 656e 5f68 6d61 636c 656e 2066  a: gen_hmaclen f
│ │ │ │ │ -0000e210: 6169 6c75 7265 0a20 2020 2020 2746 4b4f  ailure.     'FKO
│ │ │ │ │ -0000e220: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ -0000e230: 4154 415f 4655 4e43 535f 4745 4e5f 4b45  ATA_FUNCS_GEN_KE
│ │ │ │ │ -0000e240: 595f 454e 434f 4445 4641 494c 270a 2020  Y_ENCODEFAIL'.  
│ │ │ │ │ -0000e250: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ -0000e260: 6461 7461 3a20 6765 6e5f 6b65 793a 2065  data: gen_key: e
│ │ │ │ │ -0000e270: 6e63 6f64 6520 6661 696c 7572 650a 2020  ncode failure.  
│ │ │ │ │ -0000e280: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ -0000e290: 5641 4c49 445f 4441 5441 5f46 554e 4353  VALID_DATA_FUNCS
│ │ │ │ │ -0000e2a0: 5f47 454e 5f48 4d41 435f 454e 434f 4445  _GEN_HMAC_ENCODE
│ │ │ │ │ -0000e2b0: 4641 494c 270a 2020 2020 2020 2020 2020  FAIL'.          
│ │ │ │ │ -0000e2c0: 496e 7661 6c69 6420 6461 7461 3a20 6765  Invalid data: ge
│ │ │ │ │ -0000e2d0: 6e5f 686d 6163 3a20 656e 636f 6465 2066  n_hmac: encode f
│ │ │ │ │ -0000e2e0: 6169 6c75 7265 0a20 2020 2020 2746 4b4f  ailure.     'FKO
│ │ │ │ │ -0000e2f0: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ -0000e300: 4154 415f 4655 4e43 535f 5345 545f 4d53  ATA_FUNCS_SET_MS
│ │ │ │ │ -0000e310: 474c 454e 5f56 414c 4944 4641 494c 270a  GLEN_VALIDFAIL'.
│ │ │ │ │ -0000e320: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ -0000e330: 6420 6461 7461 3a20 7365 745f 7370 615f  d data: set_spa_
│ │ │ │ │ -0000e340: 6461 7461 3a20 696e 7661 6c69 6420 6d65  data: invalid me
│ │ │ │ │ -0000e350: 7373 6167 6520 6c65 6e67 7468 0a20 2020  ssage length.   
│ │ │ │ │ -0000e360: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ -0000e370: 414c 4944 5f44 4154 415f 484d 4143 5f4d  ALID_DATA_HMAC_M
│ │ │ │ │ -0000e380: 5347 4c45 4e5f 5641 4c49 4446 4149 4c27  SGLEN_VALIDFAIL'
│ │ │ │ │ -0000e390: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ -0000e3a0: 6964 2064 6174 613a 2069 6e76 616c 6964  id data: invalid
│ │ │ │ │ -0000e3b0: 2048 4d41 4320 6d73 676c 656e 0a20 2020   HMAC msglen.   
│ │ │ │ │ -0000e3c0: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ -0000e3d0: 414c 4944 5f44 4154 415f 484d 4143 5f45  ALID_DATA_HMAC_E
│ │ │ │ │ -0000e3e0: 4e43 4d53 474c 454e 5f56 414c 4944 4641  NCMSGLEN_VALIDFA
│ │ │ │ │ -0000e3f0: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In
│ │ │ │ │ -0000e400: 7661 6c69 6420 6461 7461 3a20 696e 7661  valid data: inva
│ │ │ │ │ -0000e410: 6c69 6420 6c65 6e67 7468 2066 6f72 2065  lid length for e
│ │ │ │ │ -0000e420: 6e63 7279 7074 6564 206d 6573 7361 6765  ncrypted message
│ │ │ │ │ -0000e430: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -0000e440: 5f49 4e56 414c 4944 5f44 4154 415f 484d  _INVALID_DATA_HM
│ │ │ │ │ -0000e450: 4143 5f43 4f4d 5041 5245 4641 494c 270a  AC_COMPAREFAIL'.
│ │ │ │ │ -0000e460: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ -0000e470: 6420 6461 7461 3a20 484d 4143 2063 6f6d  d data: HMAC com
│ │ │ │ │ -0000e480: 7061 7269 736f 6e20 6661 696c 6564 0a20  parison failed. 
│ │ │ │ │ -0000e490: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ -0000e4a0: 4e56 414c 4944 5f44 4154 415f 484d 4143  NVALID_DATA_HMAC
│ │ │ │ │ -0000e4b0: 5f54 5950 455f 5641 4c49 4446 4149 4c27  _TYPE_VALIDFAIL'
│ │ │ │ │ -0000e4c0: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ -0000e4d0: 6964 2064 6174 613a 2069 6e76 616c 6964  id data: invalid
│ │ │ │ │ -0000e4e0: 2048 4d41 4320 7479 7065 0a20 2020 2020   HMAC type.     
│ │ │ │ │ -0000e4f0: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ -0000e500: 4944 5f44 4154 415f 484d 4143 5f4c 454e  ID_DATA_HMAC_LEN
│ │ │ │ │ -0000e510: 5f56 414c 4944 4641 494c 270a 2020 2020  _VALIDFAIL'.    
│ │ │ │ │ -0000e520: 2020 2020 2020 496e 7661 6c69 6420 6461        Invalid da
│ │ │ │ │ -0000e530: 7461 3a20 696e 7661 6c69 6420 484d 4143  ta: invalid HMAC
│ │ │ │ │ -0000e540: 206c 656e 6774 680a 2020 2020 2027 464b   length.     'FK
│ │ │ │ │ -0000e550: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ -0000e560: 4441 5441 5f4d 4553 5341 4745 5f50 4f52  DATA_MESSAGE_POR
│ │ │ │ │ -0000e570: 545f 4d49 5353 494e 4727 0a20 2020 2020  T_MISSING'.     
│ │ │ │ │ -0000e580: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat
│ │ │ │ │ -0000e590: 613a 206d 6973 7369 6e67 2070 6f72 740a  a: missing port.
│ │ │ │ │ -0000e5a0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000e5b0: 494e 5641 4c49 445f 4441 5441 5f4d 4553  INVALID_DATA_MES
│ │ │ │ │ -0000e5c0: 5341 4745 5f54 5950 455f 5641 4c49 4446  SAGE_TYPE_VALIDF
│ │ │ │ │ -0000e5d0: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I
│ │ │ │ │ -0000e5e0: 6e76 616c 6964 2064 6174 613a 2069 6e76  nvalid data: inv
│ │ │ │ │ -0000e5f0: 616c 6964 206d 6573 7361 6765 2074 7970  alid message typ
│ │ │ │ │ -0000e600: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO
│ │ │ │ │ -0000e610: 525f 494e 5641 4c49 445f 4441 5441 5f4d  R_INVALID_DATA_M
│ │ │ │ │ -0000e620: 4553 5341 4745 5f45 4d50 5459 270a 2020  ESSAGE_EMPTY'.  
│ │ │ │ │ -0000e630: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ -0000e640: 6461 7461 3a20 656d 7074 7920 6461 7461  data: empty data
│ │ │ │ │ -0000e650: 206d 6573 7361 6765 0a20 2020 2020 2746   message.     'F
│ │ │ │ │ -0000e660: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ -0000e670: 5f44 4154 415f 4d45 5353 4147 455f 434d  _DATA_MESSAGE_CM
│ │ │ │ │ -0000e680: 445f 4d49 5353 494e 4727 0a20 2020 2020  D_MISSING'.     
│ │ │ │ │ -0000e690: 2020 2020 2049 6e76 616c 6964 2064 6174       Invalid dat
│ │ │ │ │ -0000e6a0: 613a 206d 6973 7369 6e67 2063 6f6d 6d61  a: missing comma
│ │ │ │ │ -0000e6b0: 6e64 206d 6573 7361 6765 0a20 2020 2020  nd message.     
│ │ │ │ │ -0000e6c0: 2746 4b4f 5f45 5252 4f52 5f49 4e56 414c  'FKO_ERROR_INVAL
│ │ │ │ │ -0000e6d0: 4944 5f44 4154 415f 4d45 5353 4147 455f  ID_DATA_MESSAGE_
│ │ │ │ │ -0000e6e0: 4143 4345 5353 5f4d 4953 5349 4e47 270a  ACCESS_MISSING'.
│ │ │ │ │ -0000e6f0: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ -0000e700: 6420 6461 7461 3a20 6d69 7373 696e 6720  d data: missing 
│ │ │ │ │ -0000e710: 6163 6365 7373 206d 6573 7361 6765 0a20  access message. 
│ │ │ │ │ -0000e720: 2020 2020 2746 4b4f 5f45 5252 4f52 5f49      'FKO_ERROR_I
│ │ │ │ │ -0000e730: 4e56 414c 4944 5f44 4154 415f 4d45 5353  NVALID_DATA_MESS
│ │ │ │ │ -0000e740: 4147 455f 4e41 545f 4d49 5353 494e 4727  AGE_NAT_MISSING'
│ │ │ │ │ -0000e750: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ -0000e760: 6964 2064 6174 613a 206d 6973 7369 6e67  id data: missing
│ │ │ │ │ -0000e770: 204e 4154 2064 6174 610a 2020 2020 2027   NAT data.     '
│ │ │ │ │ -0000e780: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ -0000e790: 445f 4441 5441 5f4d 4553 5341 4745 5f50  D_DATA_MESSAGE_P
│ │ │ │ │ -0000e7a0: 4f52 5450 524f 544f 5f4d 4953 5349 4e47  ORTPROTO_MISSING
│ │ │ │ │ -0000e7b0: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva
│ │ │ │ │ -0000e7c0: 6c69 6420 6461 7461 3a20 6d69 7373 696e  lid data: missin
│ │ │ │ │ -0000e7d0: 6720 7072 6f74 6f2f 706f 7274 2064 6174  g proto/port dat
│ │ │ │ │ -0000e7e0: 610a 2020 2020 2027 464b 4f5f 4552 524f  a.     'FKO_ERRO
│ │ │ │ │ -0000e7f0: 525f 494e 5641 4c49 445f 4441 5441 5f4e  R_INVALID_DATA_N
│ │ │ │ │ -0000e800: 4154 5f45 4d50 5459 270a 2020 2020 2020  AT_EMPTY'.      
│ │ │ │ │ -0000e810: 2020 2020 496e 7661 6c69 6420 6461 7461      Invalid data
│ │ │ │ │ -0000e820: 3a20 656d 7074 7920 4e41 5420 7661 6c75  : empty NAT valu
│ │ │ │ │ -0000e830: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO
│ │ │ │ │ -0000e840: 525f 494e 5641 4c49 445f 4441 5441 5f52  R_INVALID_DATA_R
│ │ │ │ │ -0000e850: 414e 445f 4c45 4e5f 5641 4c49 4446 4149  AND_LEN_VALIDFAI
│ │ │ │ │ -0000e860: 4c27 0a20 2020 2020 2020 2020 2049 6e76  L'.          Inv
│ │ │ │ │ -0000e870: 616c 6964 2064 6174 613a 2069 6e76 616c  alid data: inval
│ │ │ │ │ -0000e880: 6964 2072 616e 646f 6d20 6461 7461 206c  id random data l
│ │ │ │ │ -0000e890: 656e 6774 680a 2020 2020 2027 464b 4f5f  ength.     'FKO_
│ │ │ │ │ -0000e8a0: 4552 524f 525f 494e 5641 4c49 445f 4441  ERROR_INVALID_DA
│ │ │ │ │ -0000e8b0: 5441 5f53 5256 4155 5448 5f4d 4953 5349  TA_SRVAUTH_MISSI
│ │ │ │ │ -0000e8c0: 4e47 270a 2020 2020 2020 2020 2020 496e  NG'.          In
│ │ │ │ │ -0000e8d0: 7661 6c69 6420 6461 7461 3a20 7365 7276  valid data: serv
│ │ │ │ │ -0000e8e0: 6572 2061 7574 6820 6d69 7373 696e 670a  er auth missing.
│ │ │ │ │ -0000e8f0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000e900: 494e 5641 4c49 445f 4441 5441 5f54 494d  INVALID_DATA_TIM
│ │ │ │ │ -0000e910: 4553 5441 4d50 5f56 414c 4944 4641 494c  ESTAMP_VALIDFAIL
│ │ │ │ │ -0000e920: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva
│ │ │ │ │ -0000e930: 6c69 6420 6461 7461 3a20 696e 7661 6c69  lid data: invali
│ │ │ │ │ -0000e940: 6420 7469 6d65 7374 616d 7020 7661 6c75  d timestamp valu
│ │ │ │ │ -0000e950: 650a 2020 2020 2027 464b 4f5f 4552 524f  e.     'FKO_ERRO
│ │ │ │ │ -0000e960: 525f 494e 5641 4c49 445f 4441 5441 5f55  R_INVALID_DATA_U
│ │ │ │ │ -0000e970: 5345 525f 4d49 5353 494e 4727 0a20 2020  SER_MISSING'.   
│ │ │ │ │ -0000e980: 2020 2020 2020 2049 6e76 616c 6964 2064         Invalid d
│ │ │ │ │ -0000e990: 6174 613a 206d 6973 7369 6e67 2075 7365  ata: missing use
│ │ │ │ │ -0000e9a0: 7220 6461 7461 0a20 2020 2020 2746 4b4f  r data.     'FKO
│ │ │ │ │ -0000e9b0: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ -0000e9c0: 4154 415f 5553 4552 5f46 4952 5354 4348  ATA_USER_FIRSTCH
│ │ │ │ │ -0000e9d0: 4152 5f56 414c 4944 4641 494c 270a 2020  AR_VALIDFAIL'.  
│ │ │ │ │ -0000e9e0: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ -0000e9f0: 6461 7461 3a20 7573 6572 2066 6972 7374  data: user first
│ │ │ │ │ -0000ea00: 2063 6861 7220 6e6f 7420 7661 6c69 640a   char not valid.
│ │ │ │ │ -0000ea10: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000ea20: 494e 5641 4c49 445f 4441 5441 5f55 5345  INVALID_DATA_USE
│ │ │ │ │ -0000ea30: 525f 5245 4d43 4841 525f 5641 4c49 4446  R_REMCHAR_VALIDF
│ │ │ │ │ -0000ea40: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I
│ │ │ │ │ -0000ea50: 6e76 616c 6964 2064 6174 613a 2075 7365  nvalid data: use
│ │ │ │ │ -0000ea60: 7220 7265 6d63 6861 7220 6e6f 7420 7661  r remchar not va
│ │ │ │ │ -0000ea70: 6c69 640a 2020 2020 2027 464b 4f5f 4552  lid.     'FKO_ER
│ │ │ │ │ -0000ea80: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ -0000ea90: 5f55 5449 4c5f 5354 5254 4f4c 5f4c 545f  _UTIL_STRTOL_LT_
│ │ │ │ │ -0000eaa0: 4d49 4e27 0a20 2020 2020 2020 2020 2049  MIN'.          I
│ │ │ │ │ -0000eab0: 6e76 616c 6964 2064 6174 613a 2075 7469  nvalid data: uti
│ │ │ │ │ -0000eac0: 6c20 636f 6e76 6572 7369 6f6e 2074 6f20  l conversion to 
│ │ │ │ │ -0000ead0: 6c6f 6e67 206c 6573 7320 7468 616e 206d  long less than m
│ │ │ │ │ -0000eae0: 696e 696d 756d 0a20 2020 2020 2746 4b4f  inimum.     'FKO
│ │ │ │ │ -0000eaf0: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ -0000eb00: 4154 415f 5554 494c 5f53 5452 544f 4c5f  ATA_UTIL_STRTOL_
│ │ │ │ │ -0000eb10: 4754 5f4d 4158 270a 2020 2020 2020 2020  GT_MAX'.        
│ │ │ │ │ -0000eb20: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ -0000eb30: 7574 696c 2063 6f6e 7665 7273 696f 6e20  util conversion 
│ │ │ │ │ -0000eb40: 746f 206c 6f6e 6720 6772 6561 7465 7220  to long greater 
│ │ │ │ │ -0000eb50: 7468 616e 206d 6178 696d 756d 0a20 2020  than maximum.   
│ │ │ │ │ -0000eb60: 2020 2746 4b4f 5f45 5252 4f52 5f44 4154    'FKO_ERROR_DAT
│ │ │ │ │ -0000eb70: 415f 544f 4f5f 4c41 5247 4527 0a20 2020  A_TOO_LARGE'.   
│ │ │ │ │ -0000eb80: 2020 2020 2020 2056 616c 7565 206f 7220         Value or 
│ │ │ │ │ -0000eb90: 5369 7a65 206f 6620 7468 6520 6461 7461  Size of the data
│ │ │ │ │ -0000eba0: 2065 7863 6565 6465 6420 7468 6520 6d61   exceeded the ma
│ │ │ │ │ -0000ebb0: 7820 616c 6c6f 7765 640a 2020 2020 2027  x allowed.     '
│ │ │ │ │ -0000ebc0: 464b 4f5f 4552 524f 525f 494e 5641 4c49  FKO_ERROR_INVALI
│ │ │ │ │ -0000ebd0: 445f 4b45 595f 4c45 4e27 0a20 2020 2020  D_KEY_LEN'.     
│ │ │ │ │ -0000ebe0: 2020 2020 2049 6e76 616c 6964 206b 6579       Invalid key
│ │ │ │ │ -0000ebf0: 206c 656e 6774 680a 2020 2020 2027 464b   length.     'FK
│ │ │ │ │ -0000ec00: 4f5f 4552 524f 525f 5553 4552 4e41 4d45  O_ERROR_USERNAME
│ │ │ │ │ -0000ec10: 5f55 4e4b 4e4f 574e 270a 2020 2020 2020  _UNKNOWN'.      
│ │ │ │ │ -0000ec20: 2020 2020 556e 6162 6c65 2074 6f20 6465      Unable to de
│ │ │ │ │ -0000ec30: 7465 726d 696e 6520 7573 6572 6e61 6d65  termine username
│ │ │ │ │ -0000ec40: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -0000ec50: 5f49 4e43 4f4d 504c 4554 455f 5350 415f  _INCOMPLETE_SPA_
│ │ │ │ │ -0000ec60: 4441 5441 270a 2020 2020 2020 2020 2020  DATA'.          
│ │ │ │ │ -0000ec70: 4d69 7373 696e 6720 6f72 2069 6e63 6f6d  Missing or incom
│ │ │ │ │ -0000ec80: 706c 6574 6520 5350 4120 6461 7461 0a20  plete SPA data. 
│ │ │ │ │ -0000ec90: 2020 2020 2746 4b4f 5f45 5252 4f52 5f4d      'FKO_ERROR_M
│ │ │ │ │ -0000eca0: 4953 5349 4e47 5f45 4e43 4f44 4544 5f44  ISSING_ENCODED_D
│ │ │ │ │ -0000ecb0: 4154 4127 0a20 2020 2020 2020 2020 2054  ATA'.          T
│ │ │ │ │ -0000ecc0: 6865 7265 2069 7320 6e6f 2065 6e63 6f64  here is no encod
│ │ │ │ │ -0000ecd0: 6564 2064 6174 6120 746f 2070 726f 6365  ed data to proce
│ │ │ │ │ -0000ece0: 7373 0a20 2020 2020 2746 4b4f 5f45 5252  ss.     'FKO_ERR
│ │ │ │ │ -0000ecf0: 4f52 5f49 4e56 414c 4944 5f44 4947 4553  OR_INVALID_DIGES
│ │ │ │ │ -0000ed00: 545f 5459 5045 270a 2020 2020 2020 2020  T_TYPE'.        
│ │ │ │ │ -0000ed10: 2020 496e 7661 6c69 6420 6469 6765 7374    Invalid digest
│ │ │ │ │ -0000ed20: 2074 7970 650a 2020 2020 2027 464b 4f5f   type.     'FKO_
│ │ │ │ │ -0000ed30: 4552 524f 525f 494e 5641 4c49 445f 414c  ERROR_INVALID_AL
│ │ │ │ │ -0000ed40: 4c4f 575f 4950 270a 2020 2020 2020 2020  LOW_IP'.        
│ │ │ │ │ -0000ed50: 2020 496e 7661 6c69 6420 616c 6c6f 7720    Invalid allow 
│ │ │ │ │ -0000ed60: 4950 2061 6464 7265 7373 2069 6e20 7468  IP address in th
│ │ │ │ │ -0000ed70: 6520 5350 4120 6d65 7373 6167 6520 6461  e SPA message da
│ │ │ │ │ -0000ed80: 7461 0a20 2020 2020 2746 4b4f 5f45 5252  ta.     'FKO_ERR
│ │ │ │ │ -0000ed90: 4f52 5f49 4e56 414c 4944 5f53 5041 5f43  OR_INVALID_SPA_C
│ │ │ │ │ -0000eda0: 4f4d 4d41 4e44 5f4d 5347 270a 2020 2020  OMMAND_MSG'.    
│ │ │ │ │ -0000edb0: 2020 2020 2020 496e 7661 6c69 6420 5350        Invalid SP
│ │ │ │ │ -0000edc0: 4120 636f 6d6d 616e 6420 6d65 7373 6167  A command messag
│ │ │ │ │ -0000edd0: 6520 666f 726d 6174 0a20 2020 2020 2746  e format.     'F
│ │ │ │ │ -0000ede0: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ -0000edf0: 5f53 5041 5f41 4343 4553 535f 4d53 4727  _SPA_ACCESS_MSG'
│ │ │ │ │ -0000ee00: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ -0000ee10: 6964 2053 5041 2061 6363 6573 7320 6d65  id SPA access me
│ │ │ │ │ -0000ee20: 7373 6167 6520 666f 726d 6174 0a20 2020  ssage format.   
│ │ │ │ │ -0000ee30: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ -0000ee40: 414c 4944 5f53 5041 5f4e 4154 5f41 4343  ALID_SPA_NAT_ACC
│ │ │ │ │ -0000ee50: 4553 535f 4d53 4727 0a20 2020 2020 2020  ESS_MSG'.       
│ │ │ │ │ -0000ee60: 2020 2049 6e76 616c 6964 2053 5041 206e     Invalid SPA n
│ │ │ │ │ -0000ee70: 6174 5f61 6363 6573 7320 6d65 7373 6167  at_access messag
│ │ │ │ │ -0000ee80: 6520 666f 726d 6174 0a20 2020 2020 2746  e format.     'F
│ │ │ │ │ -0000ee90: 4b4f 5f45 5252 4f52 5f49 4e56 414c 4944  KO_ERROR_INVALID
│ │ │ │ │ -0000eea0: 5f45 4e43 5259 5054 494f 4e5f 5459 5045  _ENCRYPTION_TYPE
│ │ │ │ │ -0000eeb0: 270a 2020 2020 2020 2020 2020 496e 7661  '.          Inva
│ │ │ │ │ -0000eec0: 6c69 6420 656e 6372 7970 7469 6f6e 2074  lid encryption t
│ │ │ │ │ -0000eed0: 7970 650a 2020 2020 2027 464b 4f5f 4552  ype.     'FKO_ER
│ │ │ │ │ -0000eee0: 524f 525f 5752 4f4e 475f 454e 4352 5950  ROR_WRONG_ENCRYP
│ │ │ │ │ -0000eef0: 5449 4f4e 5f54 5950 4527 0a20 2020 2020  TION_TYPE'.     
│ │ │ │ │ -0000ef00: 2020 2020 2057 726f 6e67 206f 7220 696e       Wrong or in
│ │ │ │ │ -0000ef10: 6170 7072 6f70 7269 6174 6520 656e 6372  appropriate encr
│ │ │ │ │ -0000ef20: 7970 7469 6f6e 2074 7970 6520 666f 7220  yption type for 
│ │ │ │ │ -0000ef30: 7468 6973 206f 7065 7261 7469 6f6e 0a20  this operation. 
│ │ │ │ │ -0000ef40: 2020 2020 2746 4b4f 5f45 5252 4f52 5f44      'FKO_ERROR_D
│ │ │ │ │ -0000ef50: 4543 5259 5054 494f 4e5f 5349 5a45 270a  ECRYPTION_SIZE'.
│ │ │ │ │ -0000ef60: 2020 2020 2020 2020 2020 556e 6578 7065            Unexpe
│ │ │ │ │ -0000ef70: 6374 6564 206f 7220 696e 7661 6c69 6420  cted or invalid 
│ │ │ │ │ -0000ef80: 7369 7a65 2066 6f72 2064 6563 7279 7074  size for decrypt
│ │ │ │ │ -0000ef90: 6564 2064 6174 610a 2020 2020 2027 464b  ed data.     'FK
│ │ │ │ │ -0000efa0: 4f5f 4552 524f 525f 4445 4352 5950 5449  O_ERROR_DECRYPTI
│ │ │ │ │ -0000efb0: 4f4e 5f46 4149 4c55 5245 270a 2020 2020  ON_FAILURE'.    
│ │ │ │ │ -0000efc0: 2020 2020 2020 4465 6372 7970 7469 6f6e        Decryption
│ │ │ │ │ -0000efd0: 2066 6169 6c65 6420 6f72 2064 6563 7279   failed or decry
│ │ │ │ │ -0000efe0: 7074 6564 2064 6174 6120 6973 2069 6e76  pted data is inv
│ │ │ │ │ -0000eff0: 616c 6964 0a20 2020 2020 2746 4b4f 5f45  alid.     'FKO_E
│ │ │ │ │ -0000f000: 5252 4f52 5f44 4947 4553 545f 5645 5249  RROR_DIGEST_VERI
│ │ │ │ │ -0000f010: 4649 4341 5449 4f4e 5f46 4149 4c45 4427  FICATION_FAILED'
│ │ │ │ │ -0000f020: 0a20 2020 2020 2020 2020 2054 6865 2063  .          The c
│ │ │ │ │ -0000f030: 6f6d 7075 7465 6420 6469 6765 7374 2064  omputed digest d
│ │ │ │ │ -0000f040: 6964 206e 6f74 206d 6174 6368 2074 6865  id not match the
│ │ │ │ │ -0000f050: 2064 6967 6573 7420 696e 2074 6865 2073   digest in the s
│ │ │ │ │ -0000f060: 7061 2064 6174 610a 2020 2020 2027 464b  pa data.     'FK
│ │ │ │ │ -0000f070: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ -0000f080: 484d 4143 5f4b 4559 5f4c 454e 270a 2020  HMAC_KEY_LEN'.  
│ │ │ │ │ -0000f090: 2020 2020 2020 2020 496e 7661 6c69 6420          Invalid 
│ │ │ │ │ -0000f0a0: 484d 4143 206b 6579 206c 656e 6774 680a  HMAC key length.
│ │ │ │ │ -0000f0b0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000f0c0: 554e 5355 5050 4f52 5445 445f 484d 4143  UNSUPPORTED_HMAC
│ │ │ │ │ -0000f0d0: 5f4d 4f44 4527 0a20 2020 2020 2020 2020  _MODE'.         
│ │ │ │ │ -0000f0e0: 2055 6e73 7570 706f 7274 6564 2048 4d41   Unsupported HMA
│ │ │ │ │ -0000f0f0: 4320 6d6f 6465 2028 6465 6661 756c 743a  C mode (default:
│ │ │ │ │ -0000f100: 2053 4841 3235 3629 0a20 2020 2020 2746   SHA256).     'F
│ │ │ │ │ -0000f110: 4b4f 5f45 5252 4f52 5f55 4e53 5550 504f  KO_ERROR_UNSUPPO
│ │ │ │ │ -0000f120: 5254 4544 5f46 4541 5455 5245 270a 2020  RTED_FEATURE'.  
│ │ │ │ │ -0000f130: 2020 2020 2020 2020 556e 7375 7070 6f72          Unsuppor
│ │ │ │ │ -0000f140: 7465 6420 6f72 2075 6e69 6d70 6c65 6d65  ted or unimpleme
│ │ │ │ │ -0000f150: 6e74 6564 2066 6561 7475 7265 206f 7220  nted feature or 
│ │ │ │ │ -0000f160: 6675 6e63 7469 6f6e 0a20 2020 2020 2746  function.     'F
│ │ │ │ │ -0000f170: 4b4f 5f45 5252 4f52 5f5a 4552 4f5f 4f55  KO_ERROR_ZERO_OU
│ │ │ │ │ -0000f180: 545f 4441 5441 270a 2020 2020 2020 2020  T_DATA'.        
│ │ │ │ │ -0000f190: 2020 436f 756c 6420 6e6f 7420 7a65 726f    Could not zero
│ │ │ │ │ -0000f1a0: 206f 7574 2073 656e 7369 7469 7665 2064   out sensitive d
│ │ │ │ │ -0000f1b0: 6174 610a 2020 2020 2027 464b 4f5f 4552  ata.     'FKO_ER
│ │ │ │ │ -0000f1c0: 524f 525f 554e 4b4e 4f57 4e27 0a20 2020  ROR_UNKNOWN'.   
│ │ │ │ │ -0000f1d0: 2020 2020 2020 2055 6e6b 6e6f 776e 2f55         Unknown/U
│ │ │ │ │ -0000f1e0: 6e63 6c61 7373 6966 6965 6420 6572 726f  nclassified erro
│ │ │ │ │ -0000f1f0: 720a 0a20 2020 4966 2047 5047 2073 7570  r..   If GPG sup
│ │ │ │ │ -0000f200: 706f 7274 2069 7320 6176 6169 6c61 626c  port is availabl
│ │ │ │ │ -0000f210: 652c 2074 6865 7265 2061 7265 2061 6464  e, there are add
│ │ │ │ │ -0000f220: 6974 696f 6e61 6c20 706f 7373 6962 6c65  itional possible
│ │ │ │ │ -0000f230: 2065 7272 6f72 0a63 6f6e 6469 7469 6f6e   error.condition
│ │ │ │ │ -0000f240: 7320 616e 6420 6572 726f 7220 636f 6465  s and error code
│ │ │ │ │ -0000f250: 732e 2020 5468 6520 4750 4720 7375 7070  s.  The GPG supp
│ │ │ │ │ -0000f260: 6f72 7420 6973 2069 6d70 6c65 6d65 6e74  ort is implement
│ │ │ │ │ -0000f270: 6564 2076 6961 2047 5047 4d45 2e0a 5468  ed via GPGME..Th
│ │ │ │ │ -0000f280: 6520 6c69 6266 6b6f 2065 7272 6f72 2068  e libfko error h
│ │ │ │ │ -0000f290: 616e 646c 696e 6720 636f 6465 2077 7261  andling code wra
│ │ │ │ │ -0000f2a0: 7073 206d 616e 7920 6f66 2074 6865 2047  ps many of the G
│ │ │ │ │ -0000f2b0: 5047 4d45 2065 7272 6f72 2063 6f64 6573  PGME error codes
│ │ │ │ │ -0000f2c0: 2074 6861 740a 6d61 7920 6265 2065 6e63   that.may be enc
│ │ │ │ │ -0000f2d0: 6f75 6e74 6572 6564 2077 6869 6c65 2075  ountered while u
│ │ │ │ │ -0000f2e0: 7369 6e67 206c 6962 666b 6f27 7320 4750  sing libfko's GP
│ │ │ │ │ -0000f2f0: 4720 7265 6c61 7465 6420 6675 6e63 7469  G related functi
│ │ │ │ │ -0000f300: 6f6e 732e 2020 5468 6573 650a 6172 653a  ons.  These.are:
│ │ │ │ │ -0000f310: 0a0a 202d 2d20 5661 7269 6162 6c65 3a20  .. -- Variable: 
│ │ │ │ │ -0000f320: 696e 7420 6572 726f 725f 636f 6465 2028  int error_code (
│ │ │ │ │ -0000f330: 6770 676d 6520 7375 7070 6f72 7420 6f6e  gpgme support on
│ │ │ │ │ -0000f340: 6c79 290a 2020 2020 2027 464b 4f5f 4552  ly).     'FKO_ER
│ │ │ │ │ -0000f350: 524f 525f 4d49 5353 494e 475f 4750 475f  ROR_MISSING_GPG_
│ │ │ │ │ -0000f360: 4b45 595f 4441 5441 270a 2020 2020 2020  KEY_DATA'.      
│ │ │ │ │ -0000f370: 2020 2020 4d69 7373 696e 6720 4750 4720      Missing GPG 
│ │ │ │ │ -0000f380: 6b65 7920 6461 7461 2028 7369 676e 6572  key data (signer
│ │ │ │ │ -0000f390: 206f 7220 7265 6369 7069 656e 7420 6e6f   or recipient no
│ │ │ │ │ -0000f3a0: 7420 7365 7429 0a20 2020 2020 2746 4b4f  t set).     'FKO
│ │ │ │ │ -0000f3b0: 5f45 5252 4f52 5f47 5047 4d45 5f4e 4f5f  _ERROR_GPGME_NO_
│ │ │ │ │ -0000f3c0: 4f50 454e 5047 5027 0a20 2020 2020 2020  OPENPGP'.       
│ │ │ │ │ -0000f3d0: 2020 2054 6869 7320 4750 474d 4520 696d     This GPGME im
│ │ │ │ │ -0000f3e0: 706c 656d 656e 7461 7469 6f6e 2064 6f65  plementation doe
│ │ │ │ │ -0000f3f0: 7320 6e6f 7420 7375 7070 6f72 7420 4f70  s not support Op
│ │ │ │ │ -0000f400: 656e 5047 500a 2020 2020 2027 464b 4f5f  enPGP.     'FKO_
│ │ │ │ │ -0000f410: 4552 524f 525f 4750 474d 455f 434f 4e54  ERROR_GPGME_CONT
│ │ │ │ │ -0000f420: 4558 5427 0a20 2020 2020 2020 2020 2055  EXT'.          U
│ │ │ │ │ -0000f430: 6e61 626c 6520 746f 2063 7265 6174 6520  nable to create 
│ │ │ │ │ -0000f440: 4750 474d 4520 636f 6e74 6578 740a 2020  GPGME context.  
│ │ │ │ │ -0000f450: 2020 2027 464b 4f5f 4552 524f 525f 4750     'FKO_ERROR_GP
│ │ │ │ │ -0000f460: 474d 455f 504c 4149 4e54 4558 545f 4441  GME_PLAINTEXT_DA
│ │ │ │ │ -0000f470: 5441 5f4f 424a 270a 2020 2020 2020 2020  TA_OBJ'.        
│ │ │ │ │ -0000f480: 2020 4572 726f 7220 6372 6561 7469 6e67    Error creating
│ │ │ │ │ -0000f490: 2074 6865 2070 6c61 696e 7465 7874 2064   the plaintext d
│ │ │ │ │ -0000f4a0: 6174 6120 6f62 6a65 6374 0a20 2020 2020  ata object.     
│ │ │ │ │ -0000f4b0: 2746 4b4f 5f45 5252 4f52 5f47 5047 4d45  'FKO_ERROR_GPGME
│ │ │ │ │ -0000f4c0: 5f53 4554 5f50 524f 544f 434f 4c27 0a20  _SET_PROTOCOL'. 
│ │ │ │ │ -0000f4d0: 2020 2020 2020 2020 2055 6e61 626c 6520           Unable 
│ │ │ │ │ -0000f4e0: 746f 2073 6574 2047 5047 4d45 2074 6f20  to set GPGME to 
│ │ │ │ │ -0000f4f0: 7573 6520 4f70 656e 5047 5020 7072 6f74  use OpenPGP prot
│ │ │ │ │ -0000f500: 6f63 6f6c 0a20 2020 2020 2746 4b4f 5f45  ocol.     'FKO_E
│ │ │ │ │ -0000f510: 5252 4f52 5f47 5047 4d45 5f43 4950 4845  RROR_GPGME_CIPHE
│ │ │ │ │ -0000f520: 525f 4441 5441 5f4f 424a 270a 2020 2020  R_DATA_OBJ'.    
│ │ │ │ │ -0000f530: 2020 2020 2020 4572 726f 7220 6372 6561        Error crea
│ │ │ │ │ -0000f540: 7469 6e67 2074 6865 2065 6e63 7279 7074  ting the encrypt
│ │ │ │ │ -0000f550: 6564 2064 6174 6120 6461 7461 206f 626a  ed data data obj
│ │ │ │ │ -0000f560: 6563 740a 2020 2020 2027 464b 4f5f 4552  ect.     'FKO_ER
│ │ │ │ │ -0000f570: 524f 525f 4750 474d 455f 4241 445f 5041  ROR_GPGME_BAD_PA
│ │ │ │ │ -0000f580: 5353 5048 5241 5345 270a 2020 2020 2020  SSPHRASE'.      
│ │ │ │ │ -0000f590: 2020 2020 5468 6520 4750 4720 7061 7373      The GPG pass
│ │ │ │ │ -0000f5a0: 7068 7261 7365 2077 6173 206e 6f74 2076  phrase was not v
│ │ │ │ │ -0000f5b0: 616c 6964 0a20 2020 2020 2746 4b4f 5f45  alid.     'FKO_E
│ │ │ │ │ -0000f5c0: 5252 4f52 5f47 5047 4d45 5f45 4e43 5259  RROR_GPGME_ENCRY
│ │ │ │ │ -0000f5d0: 5054 5f53 4947 4e27 0a20 2020 2020 2020  PT_SIGN'.       
│ │ │ │ │ -0000f5e0: 2020 2045 7272 6f72 2064 7572 696e 6720     Error during 
│ │ │ │ │ -0000f5f0: 7468 6520 656e 6372 7970 7420 616e 6420  the encrypt and 
│ │ │ │ │ -0000f600: 7369 676e 206f 7065 7261 7469 6f6e 0a20  sign operation. 
│ │ │ │ │ -0000f610: 2020 2020 2746 4b4f 5f45 5252 4f52 5f47      'FKO_ERROR_G
│ │ │ │ │ -0000f620: 5047 4d45 5f43 4f4e 5445 5854 5f53 4947  PGME_CONTEXT_SIG
│ │ │ │ │ -0000f630: 4e45 525f 4b45 5927 0a20 2020 2020 2020  NER_KEY'.       
│ │ │ │ │ -0000f640: 2020 2055 6e61 626c 6520 746f 2063 7265     Unable to cre
│ │ │ │ │ -0000f650: 6174 6520 4750 474d 4520 636f 6e74 6578  ate GPGME contex
│ │ │ │ │ -0000f660: 7420 666f 7220 7468 6520 7369 676e 6572  t for the signer
│ │ │ │ │ -0000f670: 206b 6579 0a20 2020 2020 2746 4b4f 5f45   key.     'FKO_E
│ │ │ │ │ -0000f680: 5252 4f52 5f47 5047 4d45 5f53 4947 4e45  RROR_GPGME_SIGNE
│ │ │ │ │ -0000f690: 525f 4b45 594c 4953 545f 5354 4152 5427  R_KEYLIST_START'
│ │ │ │ │ -0000f6a0: 0a20 2020 2020 2020 2020 2045 7272 6f72  .          Error
│ │ │ │ │ -0000f6b0: 2066 726f 6d20 7369 676e 6572 206b 6579   from signer key
│ │ │ │ │ -0000f6c0: 6c69 7374 2073 7461 7274 206f 7065 7261  list start opera
│ │ │ │ │ -0000f6d0: 7469 6f6e 0a20 2020 2020 2746 4b4f 5f45  tion.     'FKO_E
│ │ │ │ │ -0000f6e0: 5252 4f52 5f47 5047 4d45 5f53 4947 4e45  RROR_GPGME_SIGNE
│ │ │ │ │ -0000f6f0: 525f 4b45 595f 4e4f 545f 464f 554e 4427  R_KEY_NOT_FOUND'
│ │ │ │ │ -0000f700: 0a20 2020 2020 2020 2020 2054 6865 206b  .          The k
│ │ │ │ │ -0000f710: 6579 2066 6f72 2074 6865 2067 6976 656e  ey for the given
│ │ │ │ │ -0000f720: 2073 6967 6e65 7220 7761 7320 6e6f 7420   signer was not 
│ │ │ │ │ -0000f730: 666f 756e 640a 2020 2020 2027 464b 4f5f  found.     'FKO_
│ │ │ │ │ -0000f740: 4552 524f 525f 4750 474d 455f 5349 474e  ERROR_GPGME_SIGN
│ │ │ │ │ -0000f750: 4552 5f4b 4559 5f41 4d42 4947 554f 5553  ER_KEY_AMBIGUOUS
│ │ │ │ │ -0000f760: 270a 2020 2020 2020 2020 2020 416d 6269  '.          Ambi
│ │ │ │ │ -0000f770: 6775 6f75 7320 6e61 6d65 2f69 6420 666f  guous name/id fo
│ │ │ │ │ -0000f780: 7220 7468 6520 7369 676e 6572 206b 6579  r the signer key
│ │ │ │ │ -0000f790: 2028 6d75 6c74 6970 6c65 206d 6174 6368   (multiple match
│ │ │ │ │ -0000f7a0: 6573 290a 2020 2020 2027 464b 4f5f 4552  es).     'FKO_ER
│ │ │ │ │ -0000f7b0: 524f 525f 4750 474d 455f 4144 445f 5349  ROR_GPGME_ADD_SI
│ │ │ │ │ -0000f7c0: 474e 4552 270a 2020 2020 2020 2020 2020  GNER'.          
│ │ │ │ │ -0000f7d0: 4572 726f 7220 6164 6469 6e67 2074 6865  Error adding the
│ │ │ │ │ -0000f7e0: 2073 6967 6e65 7220 6b65 7920 746f 2074   signer key to t
│ │ │ │ │ -0000f7f0: 6865 2067 7067 6d65 2063 6f6e 7465 7874  he gpgme context
│ │ │ │ │ -0000f800: 0a20 2020 2020 2746 4b4f 5f45 5252 4f52  .     'FKO_ERROR
│ │ │ │ │ -0000f810: 5f47 5047 4d45 5f43 4f4e 5445 5854 5f52  _GPGME_CONTEXT_R
│ │ │ │ │ -0000f820: 4543 4950 4945 4e54 5f4b 4559 270a 2020  ECIPIENT_KEY'.  
│ │ │ │ │ -0000f830: 2020 2020 2020 2020 556e 6162 6c65 2074          Unable t
│ │ │ │ │ -0000f840: 6f20 6372 6561 7465 2047 5047 4d45 2063  o create GPGME c
│ │ │ │ │ -0000f850: 6f6e 7465 7874 2066 6f72 2074 6865 2072  ontext for the r
│ │ │ │ │ -0000f860: 6563 6970 6965 6e74 206b 6579 0a20 2020  ecipient key.   
│ │ │ │ │ -0000f870: 2020 2746 4b4f 5f45 5252 4f52 5f47 5047    'FKO_ERROR_GPG
│ │ │ │ │ -0000f880: 4d45 5f52 4543 4950 4945 4e54 5f4b 4559  ME_RECIPIENT_KEY
│ │ │ │ │ -0000f890: 4c49 5354 5f53 5441 5254 270a 2020 2020  LIST_START'.    
│ │ │ │ │ -0000f8a0: 2020 2020 2020 4572 726f 7220 6672 6f6d        Error from
│ │ │ │ │ -0000f8b0: 2073 6967 6e65 7220 6b65 796c 6973 7420   signer keylist 
│ │ │ │ │ -0000f8c0: 7374 6172 7420 6f70 6572 6174 696f 6e0a  start operation.
│ │ │ │ │ -0000f8d0: 2020 2020 2027 464b 4f5f 4552 524f 525f       'FKO_ERROR_
│ │ │ │ │ -0000f8e0: 4750 474d 455f 5245 4349 5049 454e 545f  GPGME_RECIPIENT_
│ │ │ │ │ -0000f8f0: 4b45 595f 4e4f 545f 464f 554e 4427 0a20  KEY_NOT_FOUND'. 
│ │ │ │ │ -0000f900: 2020 2020 2020 2020 2054 6865 206b 6579           The key
│ │ │ │ │ -0000f910: 2066 6f72 2074 6865 2067 6976 656e 2072   for the given r
│ │ │ │ │ -0000f920: 6563 6970 6965 6e74 2077 6173 206e 6f74  ecipient was not
│ │ │ │ │ -0000f930: 2066 6f75 6e64 0a20 2020 2020 2746 4b4f   found.     'FKO
│ │ │ │ │ -0000f940: 5f45 5252 4f52 5f47 5047 4d45 5f52 4543  _ERROR_GPGME_REC
│ │ │ │ │ -0000f950: 4950 4945 4e54 5f4b 4559 5f41 4d42 4947  IPIENT_KEY_AMBIG
│ │ │ │ │ -0000f960: 554f 5553 270a 2020 2020 2020 2020 2020  UOUS'.          
│ │ │ │ │ -0000f970: 416d 6269 6775 6f75 7320 6e61 6d65 2f69  Ambiguous name/i
│ │ │ │ │ -0000f980: 6420 666f 7220 7468 6520 7265 6369 7069  d for the recipi
│ │ │ │ │ -0000f990: 656e 7420 6b65 7920 286d 756c 7469 706c  ent key (multipl
│ │ │ │ │ -0000f9a0: 6520 6d61 7463 6865 7329 0a20 2020 2020  e matches).     
│ │ │ │ │ -0000f9b0: 2746 4b4f 5f45 5252 4f52 5f47 5047 4d45  'FKO_ERROR_GPGME
│ │ │ │ │ -0000f9c0: 5f44 4543 5259 5054 5f46 4149 4c45 4427  _DECRYPT_FAILED'
│ │ │ │ │ -0000f9d0: 0a20 2020 2020 2020 2020 2044 6563 7279  .          Decry
│ │ │ │ │ -0000f9e0: 7074 696f 6e20 6f70 6572 6174 696f 6e20  ption operation 
│ │ │ │ │ -0000f9f0: 6661 696c 6564 0a20 2020 2020 2746 4b4f  failed.     'FKO
│ │ │ │ │ -0000fa00: 5f45 5252 4f52 5f47 5047 4d45 5f42 4144  _ERROR_GPGME_BAD
│ │ │ │ │ -0000fa10: 5f47 5047 5f45 5845 270a 2020 2020 2020  _GPG_EXE'.      
│ │ │ │ │ -0000fa20: 2020 2020 556e 6162 6c65 2074 6f20 7374      Unable to st
│ │ │ │ │ -0000fa30: 6174 2074 6865 2067 6976 656e 2047 5047  at the given GPG
│ │ │ │ │ -0000fa40: 2065 7865 6375 7461 626c 650a 2020 2020   executable.    
│ │ │ │ │ -0000fa50: 2027 464b 4f5f 4552 524f 525f 4750 474d   'FKO_ERROR_GPGM
│ │ │ │ │ -0000fa60: 455f 4241 445f 484f 4d45 5f44 4952 270a  E_BAD_HOME_DIR'.
│ │ │ │ │ -0000fa70: 2020 2020 2020 2020 2020 556e 6162 6c65            Unable
│ │ │ │ │ -0000fa80: 2074 6f20 7374 6174 2074 6865 2067 6976   to stat the giv
│ │ │ │ │ -0000fa90: 656e 2047 5047 2068 6f6d 6520 6469 7265  en GPG home dire
│ │ │ │ │ -0000faa0: 6374 6f72 790a 2020 2020 2027 464b 4f5f  ctory.     'FKO_
│ │ │ │ │ -0000fab0: 4552 524f 525f 4750 474d 455f 5345 545f  ERROR_GPGME_SET_
│ │ │ │ │ -0000fac0: 484f 4d45 5f44 4952 270a 2020 2020 2020  HOME_DIR'.      
│ │ │ │ │ -0000fad0: 2020 2020 556e 6162 6c65 2074 6f20 7365      Unable to se
│ │ │ │ │ -0000fae0: 7420 7468 6520 6769 7665 6e20 4750 4720  t the given GPG 
│ │ │ │ │ -0000faf0: 686f 6d65 2064 6972 6563 746f 7279 0a20  home directory. 
│ │ │ │ │ -0000fb00: 2020 2020 2746 4b4f 5f45 5252 4f52 5f47      'FKO_ERROR_G
│ │ │ │ │ -0000fb10: 5047 4d45 5f4e 4f5f 5349 474e 4154 5552  PGME_NO_SIGNATUR
│ │ │ │ │ -0000fb20: 4527 0a20 2020 2020 2020 2020 204d 6973  E'.          Mis
│ │ │ │ │ -0000fb30: 7369 6e67 2047 5047 2073 6967 6e61 7475  sing GPG signatu
│ │ │ │ │ -0000fb40: 7265 0a20 2020 2020 2746 4b4f 5f45 5252  re.     'FKO_ERR
│ │ │ │ │ -0000fb50: 4f52 5f47 5047 4d45 5f42 4144 5f53 4947  OR_GPGME_BAD_SIG
│ │ │ │ │ -0000fb60: 4e41 5455 5245 270a 2020 2020 2020 2020  NATURE'.        
│ │ │ │ │ -0000fb70: 2020 4261 6420 4750 4720 7369 676e 6174    Bad GPG signat
│ │ │ │ │ -0000fb80: 7572 650a 2020 2020 2027 464b 4f5f 4552  ure.     'FKO_ER
│ │ │ │ │ -0000fb90: 524f 525f 4750 474d 455f 5349 474e 4154  ROR_GPGME_SIGNAT
│ │ │ │ │ -0000fba0: 5552 455f 5645 5249 4659 5f44 4953 4142  URE_VERIFY_DISAB
│ │ │ │ │ -0000fbb0: 4c45 4427 0a20 2020 2020 2020 2020 2054  LED'.          T
│ │ │ │ │ -0000fbc0: 7279 696e 6720 746f 2063 6865 636b 2073  rying to check s
│ │ │ │ │ -0000fbd0: 6967 6e61 7475 7265 2077 6974 6820 7665  ignature with ve
│ │ │ │ │ -0000fbe0: 7269 6669 6361 7469 6f6e 2064 6973 6162  rification disab
│ │ │ │ │ -0000fbf0: 6c65 640a 2020 2020 2027 464b 4f5f 4552  led.     'FKO_ER
│ │ │ │ │ -0000fc00: 524f 525f 494e 5641 4c49 445f 4441 5441  ROR_INVALID_DATA
│ │ │ │ │ -0000fc10: 5f45 4e43 5259 5054 5f47 5047 5f4d 4553  _ENCRYPT_GPG_MES
│ │ │ │ │ -0000fc20: 5341 4745 5f56 414c 4944 4641 494c 270a  SAGE_VALIDFAIL'.
│ │ │ │ │ -0000fc30: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ -0000fc40: 6420 6461 7461 3a20 656e 6372 7970 743a  d data: encrypt:
│ │ │ │ │ -0000fc50: 2069 6e76 616c 6964 2047 5047 2d65 6e63   invalid GPG-enc
│ │ │ │ │ -0000fc60: 7279 7074 206d 6573 7361 6765 0a20 2020  rypt message.   
│ │ │ │ │ -0000fc70: 2020 2746 4b4f 5f45 5252 4f52 5f49 4e56    'FKO_ERROR_INV
│ │ │ │ │ -0000fc80: 414c 4944 5f44 4154 415f 454e 4352 5950  ALID_DATA_ENCRYP
│ │ │ │ │ -0000fc90: 545f 4750 475f 4449 4745 5354 5f56 414c  T_GPG_DIGEST_VAL
│ │ │ │ │ -0000fca0: 4944 4641 494c 270a 2020 2020 2020 2020  IDFAIL'.        
│ │ │ │ │ -0000fcb0: 2020 496e 7661 6c69 6420 6461 7461 3a20    Invalid data: 
│ │ │ │ │ -0000fcc0: 656e 6372 7970 743a 2069 6e76 616c 6964  encrypt: invalid
│ │ │ │ │ -0000fcd0: 2047 5047 2064 6967 6573 740a 2020 2020   GPG digest.    
│ │ │ │ │ -0000fce0: 2027 464b 4f5f 4552 524f 525f 494e 5641   'FKO_ERROR_INVA
│ │ │ │ │ -0000fcf0: 4c49 445f 4441 5441 5f45 4e43 5259 5054  LID_DATA_ENCRYPT
│ │ │ │ │ -0000fd00: 5f47 5047 5f4d 5347 4c45 4e5f 5641 4c49  _GPG_MSGLEN_VALI
│ │ │ │ │ -0000fd10: 4446 4149 4c27 0a20 2020 2020 2020 2020  DFAIL'.         
│ │ │ │ │ -0000fd20: 2049 6e76 616c 6964 2064 6174 613a 2065   Invalid data: e
│ │ │ │ │ -0000fd30: 6e63 7279 7074 3a20 696e 7661 6c69 6420  ncrypt: invalid 
│ │ │ │ │ -0000fd40: 4750 4720 6d65 7373 6167 6520 6c65 6e67  GPG message leng
│ │ │ │ │ -0000fd50: 7468 0a20 2020 2020 2746 4b4f 5f45 5252  th.     'FKO_ERR
│ │ │ │ │ -0000fd60: 4f52 5f49 4e56 414c 4944 5f44 4154 415f  OR_INVALID_DATA_
│ │ │ │ │ -0000fd70: 454e 4352 5950 545f 4750 475f 5245 5355  ENCRYPT_GPG_RESU
│ │ │ │ │ -0000fd80: 4c54 5f4d 5347 4c45 4e5f 5641 4c49 4446  LT_MSGLEN_VALIDF
│ │ │ │ │ -0000fd90: 4149 4c27 0a20 2020 2020 2020 2020 2049  AIL'.          I
│ │ │ │ │ -0000fda0: 6e76 616c 6964 2064 6174 613a 2065 6e63  nvalid data: enc
│ │ │ │ │ -0000fdb0: 7279 7074 3a20 696e 7661 6c69 6420 4750  rypt: invalid GP
│ │ │ │ │ -0000fdc0: 4720 7265 7375 6c74 206d 6573 7361 6765  G result message
│ │ │ │ │ -0000fdd0: 206c 656e 6774 680a 2020 2020 2027 464b   length.     'FK
│ │ │ │ │ -0000fde0: 4f5f 4552 524f 525f 494e 5641 4c49 445f  O_ERROR_INVALID_
│ │ │ │ │ -0000fdf0: 4441 5441 5f45 4e43 5259 5054 5f47 5047  DATA_ENCRYPT_GPG
│ │ │ │ │ -0000fe00: 5f43 4950 4845 525f 4445 434f 4445 4641  _CIPHER_DECODEFA
│ │ │ │ │ -0000fe10: 494c 270a 2020 2020 2020 2020 2020 496e  IL'.          In
│ │ │ │ │ -0000fe20: 7661 6c69 6420 6461 7461 3a20 656e 6372  valid data: encr
│ │ │ │ │ -0000fe30: 7970 743a 2047 5047 2063 6970 6865 7220  ypt: GPG cipher 
│ │ │ │ │ -0000fe40: 6661 696c 6564 0a20 2020 2020 2746 4b4f  failed.     'FKO
│ │ │ │ │ -0000fe50: 5f45 5252 4f52 5f49 4e56 414c 4944 5f44  _ERROR_INVALID_D
│ │ │ │ │ -0000fe60: 4154 415f 454e 4352 5950 545f 4750 475f  ATA_ENCRYPT_GPG_
│ │ │ │ │ -0000fe70: 454e 434f 4445 444d 5347 5f4e 554c 4c27  ENCODEDMSG_NULL'
│ │ │ │ │ -0000fe80: 0a20 2020 2020 2020 2020 2049 6e76 616c  .          Inval
│ │ │ │ │ -0000fe90: 6964 2064 6174 613a 2065 6e63 7279 7074  id data: encrypt
│ │ │ │ │ -0000fea0: 3a20 4750 472d 656e 636f 6465 6420 6d65  : GPG-encoded me
│ │ │ │ │ -0000feb0: 7373 6167 6520 6973 204e 554c 4c0a 2020  ssage is NULL.  
│ │ │ │ │ -0000fec0: 2020 2027 464b 4f5f 4552 524f 525f 494e     'FKO_ERROR_IN
│ │ │ │ │ -0000fed0: 5641 4c49 445f 4441 5441 5f45 4e43 5259  VALID_DATA_ENCRY
│ │ │ │ │ -0000fee0: 5054 5f47 5047 5f45 4e43 4f44 4544 4d53  PT_GPG_ENCODEDMS
│ │ │ │ │ -0000fef0: 474c 454e 5f56 414c 4944 4641 494c 270a  GLEN_VALIDFAIL'.
│ │ │ │ │ -0000ff00: 2020 2020 2020 2020 2020 496e 7661 6c69            Invali
│ │ │ │ │ -0000ff10: 6420 6461 7461 3a20 656e 6372 7970 743a  d data: encrypt:
│ │ │ │ │ -0000ff20: 2069 6e76 616c 6964 2047 5047 2d65 6e63   invalid GPG-enc
│ │ │ │ │ -0000ff30: 7279 7074 6564 206d 6573 7361 6765 206c  rypted message l
│ │ │ │ │ -0000ff40: 656e 6774 680a 0a20 2020 596f 7520 6361  ength..   You ca
│ │ │ │ │ -0000ff50: 6e20 7573 6520 7468 6520 2749 535f 4750  n use the 'IS_GP
│ │ │ │ │ -0000ff60: 474d 455f 4552 524f 5228 6572 725f 636f  GME_ERROR(err_co
│ │ │ │ │ -0000ff70: 6465 2927 206d 6163 726f 2074 6f20 6465  de)' macro to de
│ │ │ │ │ -0000ff80: 7465 726d 696e 6520 7768 6574 6865 720a  termine whether.
│ │ │ │ │ -0000ff90: 6f72 206e 6f74 2061 6e20 6572 726f 7220  or not an error 
│ │ │ │ │ -0000ffa0: 6964 2047 5047 4d45 2072 656c 6174 6564  id GPGME related
│ │ │ │ │ -0000ffb0: 2e20 2049 6620 7468 6520 6d61 6372 6f20  .  If the macro 
│ │ │ │ │ -0000ffc0: 6576 616c 7561 7465 7320 746f 2061 2074  evaluates to a t
│ │ │ │ │ -0000ffd0: 7275 650a 7661 6c75 652c 2079 6f75 206d  rue.value, you m
│ │ │ │ │ -0000ffe0: 6179 2062 6520 6162 6c65 2074 6f20 6765  ay be able to ge
│ │ │ │ │ -0000fff0: 7420 6164 6469 7469 6f6e 616c 2069 6e66  t additional inf
│ │ │ │ │ -00010000: 6f72 6d61 7469 6f6e 2061 626f 7574 2074  ormation about t
│ │ │ │ │ -00010010: 6865 2065 7272 6f72 0a75 7369 6e67 2074  he error.using t
│ │ │ │ │ -00010020: 6865 2066 6f6c 6c6f 7769 6e67 2066 756e  he following fun
│ │ │ │ │ -00010030: 6374 696f 6e3a 0a0a 202d 2d20 4675 6e63  ction:.. -- Func
│ │ │ │ │ -00010040: 7469 6f6e 3a20 636f 6e73 7420 6368 6172  tion: const char
│ │ │ │ │ -00010050: 202a 2066 6b6f 5f67 7067 5f65 7272 7374   * fko_gpg_errst
│ │ │ │ │ -00010060: 7220 2869 6e74 2045 5252 5f43 4f44 4529  r (int ERR_CODE)
│ │ │ │ │ -00010070: 0a20 2020 2020 5468 6520 6675 6e63 7469  .     The functi
│ │ │ │ │ -00010080: 6f6e 2027 666b 6f5f 6572 7273 7472 2720  on 'fko_errstr' 
│ │ │ │ │ -00010090: 7265 7475 726e 7320 6120 706f 696e 7465  returns a pointe
│ │ │ │ │ -000100a0: 7220 746f 2061 2073 7461 7469 6361 6c6c  r to a staticall
│ │ │ │ │ -000100b0: 790a 2020 2020 2061 6c6c 6f63 6174 6564  y.     allocated
│ │ │ │ │ -000100c0: 2073 7472 696e 6720 636f 6e74 6169 6e69   string containi
│ │ │ │ │ -000100d0: 6e67 2074 6865 2064 6573 6372 6970 7469  ng the descripti
│ │ │ │ │ -000100e0: 6f6e 206f 6620 7468 6520 4750 474d 4520  on of the GPGME 
│ │ │ │ │ -000100f0: 6572 726f 722e 0a0a 2a4e 6f74 652a 3a20  error...*Note*: 
│ │ │ │ │ -00010100: 466f 7220 736f 6d65 2065 7272 6f72 732c  For some errors,
│ │ │ │ │ -00010110: 2074 6869 7320 6675 6e63 7469 6f6e 206d   this function m
│ │ │ │ │ -00010120: 6179 2072 6574 7572 6e20 616e 2065 6d70  ay return an emp
│ │ │ │ │ -00010130: 7479 2073 7472 696e 672e 0a0a 1f0a 4669  ty string.....Fi
│ │ │ │ │ -00010140: 6c65 3a20 6c69 6266 6b6f 2e69 6e66 6f2c  le: libfko.info,
│ │ │ │ │ -00010150: 2020 4e6f 6465 3a20 4c69 6272 6172 7920    Node: Library 
│ │ │ │ │ -00010160: 436f 7079 696e 672c 2020 4e65 7874 3a20  Copying,  Next: 
│ │ │ │ │ -00010170: 436f 6e63 6570 7420 496e 6465 782c 2020  Concept Index,  
│ │ │ │ │ -00010180: 5072 6576 3a20 5573 696e 6720 6c69 6266  Prev: Using libf
│ │ │ │ │ -00010190: 6b6f 2c20 2055 703a 2054 6f70 0a0a 4170  ko,  Up: Top..Ap
│ │ │ │ │ -000101a0: 7065 6e64 6978 2041 2047 4e55 2047 454e  pendix A GNU GEN
│ │ │ │ │ -000101b0: 4552 414c 2050 5542 4c49 4320 4c49 4345  ERAL PUBLIC LICE
│ │ │ │ │ -000101c0: 4e53 450a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  NSE.************
│ │ │ │ │ +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.**************
│ │ │ │ │  000101d0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ****************
│ │ │ │ │ -000101e0: 2a2a 2a2a 2a2a 2a2a 2a0a 0a20 2020 2020  *********..     
│ │ │ │ │ -000101f0: 2020 2020 2020 2020 2056 6572 7369 6f6e           Version
│ │ │ │ │ -00010200: 2032 2028 6f72 2061 6e79 206c 6174 6572   2 (or any later
│ │ │ │ │ -00010210: 2076 6572 7369 6f6e 292c 204a 756e 6520   version), June 
│ │ │ │ │ -00010220: 3139 3931 0a0a 2020 2020 2043 6f70 7972  1991..     Copyr
│ │ │ │ │ -00010230: 6967 6874 2028 4329 2031 3938 392c 2031  ight (C) 1989, 1
│ │ │ │ │ -00010240: 3939 3120 4672 6565 2053 6f66 7477 6172  991 Free Softwar
│ │ │ │ │ -00010250: 6520 466f 756e 6461 7469 6f6e 2c20 496e  e Foundation, In
│ │ │ │ │ -00010260: 632e 0a20 2020 2020 3531 2046 7261 6e6b  c..     51 Frank
│ │ │ │ │ -00010270: 6c69 6e20 5374 7265 6574 2c20 4669 6674  lin Street, Fift
│ │ │ │ │ -00010280: 6820 466c 6f6f 722c 2042 6f73 746f 6e2c  h Floor, Boston,
│ │ │ │ │ -00010290: 204d 4120 2030 3231 3130 2d31 3330 312c   MA  02110-1301,
│ │ │ │ │ -000102a0: 2055 5341 0a0a 2020 2020 2045 7665 7279   USA..     Every
│ │ │ │ │ -000102b0: 6f6e 6520 6973 2070 6572 6d69 7474 6564  one is permitted
│ │ │ │ │ -000102c0: 2074 6f20 636f 7079 2061 6e64 2064 6973   to copy and dis
│ │ │ │ │ -000102d0: 7472 6962 7574 6520 7665 7262 6174 696d  tribute verbatim
│ │ │ │ │ -000102e0: 2063 6f70 6965 730a 2020 2020 206f 6620   copies.     of 
│ │ │ │ │ -000102f0: 7468 6973 206c 6963 656e 7365 2064 6f63  this license doc
│ │ │ │ │ -00010300: 756d 656e 742c 2062 7574 2063 6861 6e67  ument, but chang
│ │ │ │ │ -00010310: 696e 6720 6974 2069 7320 6e6f 7420 616c  ing it is not al
│ │ │ │ │ -00010320: 6c6f 7765 642e 0a0a 412e 3120 5072 6561  lowed...A.1 Prea
│ │ │ │ │ -00010330: 6d62 6c65 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d  mble.===========
│ │ │ │ │ -00010340: 3d0a 0a54 6865 206c 6963 656e 7365 7320  =..The licenses 
│ │ │ │ │ -00010350: 666f 7220 6d6f 7374 2073 6f66 7477 6172  for most softwar
│ │ │ │ │ -00010360: 6520 6172 6520 6465 7369 676e 6564 2074  e are designed t
│ │ │ │ │ -00010370: 6f20 7461 6b65 2061 7761 7920 796f 7572  o take away your
│ │ │ │ │ -00010380: 2066 7265 6564 6f6d 2074 6f0a 7368 6172   freedom to.shar
│ │ │ │ │ -00010390: 6520 616e 6420 6368 616e 6765 2069 742e  e and change it.
│ │ │ │ │ -000103a0: 2020 4279 2063 6f6e 7472 6173 742c 2074    By contrast, t
│ │ │ │ │ -000103b0: 6865 2047 4e55 2047 656e 6572 616c 2050  he GNU General P
│ │ │ │ │ -000103c0: 7562 6c69 6320 4c69 6365 6e73 6520 6973  ublic License is
│ │ │ │ │ -000103d0: 0a69 6e74 656e 6465 6420 746f 2067 7561  .intended to gua
│ │ │ │ │ -000103e0: 7261 6e74 6565 2079 6f75 7220 6672 6565  rantee your free
│ │ │ │ │ -000103f0: 646f 6d20 746f 2073 6861 7265 2061 6e64  dom to share and
│ │ │ │ │ -00010400: 2063 6861 6e67 6520 6672 6565 2073 6f66   change free sof
│ │ │ │ │ -00010410: 7477 6172 652d 2d74 6f0a 6d61 6b65 2073  tware--to.make s
│ │ │ │ │ -00010420: 7572 6520 7468 6520 736f 6674 7761 7265  ure the software
│ │ │ │ │ -00010430: 2069 7320 6672 6565 2066 6f72 2061 6c6c   is free for all
│ │ │ │ │ -00010440: 2069 7473 2075 7365 7273 2e20 2054 6869   its users.  Thi
│ │ │ │ │ -00010450: 7320 4765 6e65 7261 6c20 5075 626c 6963  s General Public
│ │ │ │ │ -00010460: 0a4c 6963 656e 7365 2061 7070 6c69 6573  .License applies
│ │ │ │ │ -00010470: 2074 6f20 6d6f 7374 206f 6620 7468 6520   to most of the 
│ │ │ │ │ -00010480: 4672 6565 2053 6f66 7477 6172 6520 466f  Free Software Fo
│ │ │ │ │ -00010490: 756e 6461 7469 6f6e 2773 2073 6f66 7477  undation's softw
│ │ │ │ │ -000104a0: 6172 6520 616e 640a 746f 2061 6e79 206f  are and.to any o
│ │ │ │ │ -000104b0: 7468 6572 2070 726f 6772 616d 2077 686f  ther program who
│ │ │ │ │ -000104c0: 7365 2061 7574 686f 7273 2063 6f6d 6d69  se authors commi
│ │ │ │ │ -000104d0: 7420 746f 2075 7369 6e67 2069 742e 2020  t to using it.  
│ │ │ │ │ -000104e0: 2853 6f6d 6520 6f74 6865 7220 4672 6565  (Some other Free
│ │ │ │ │ -000104f0: 0a53 6f66 7477 6172 6520 466f 756e 6461  .Software Founda
│ │ │ │ │ -00010500: 7469 6f6e 2073 6f66 7477 6172 6520 6973  tion software is
│ │ │ │ │ -00010510: 2063 6f76 6572 6564 2062 7920 7468 6520   covered by the 
│ │ │ │ │ -00010520: 474e 5520 4c65 7373 6572 2047 656e 6572  GNU Lesser Gener
│ │ │ │ │ -00010530: 616c 2050 7562 6c69 630a 4c69 6365 6e73  al Public.Licens
│ │ │ │ │ -00010540: 6520 696e 7374 6561 642e 2920 2059 6f75  e instead.)  You
│ │ │ │ │ -00010550: 2063 616e 2061 7070 6c79 2069 7420 746f   can apply it to
│ │ │ │ │ -00010560: 2079 6f75 7220 7072 6f67 7261 6d73 2c20   your programs, 
│ │ │ │ │ -00010570: 746f 6f2e 0a0a 2020 2057 6865 6e20 7765  too...   When we
│ │ │ │ │ -00010580: 2073 7065 616b 206f 6620 6672 6565 2073   speak of free s
│ │ │ │ │ -00010590: 6f66 7477 6172 652c 2077 6520 6172 6520  oftware, we are 
│ │ │ │ │ -000105a0: 7265 6665 7272 696e 6720 746f 2066 7265  referring to fre
│ │ │ │ │ -000105b0: 6564 6f6d 2c20 6e6f 740a 7072 6963 652e  edom, not.price.
│ │ │ │ │ -000105c0: 2020 4f75 7220 4765 6e65 7261 6c20 5075    Our General Pu
│ │ │ │ │ -000105d0: 626c 6963 204c 6963 656e 7365 7320 6172  blic Licenses ar
│ │ │ │ │ -000105e0: 6520 6465 7369 676e 6564 2074 6f20 6d61  e designed to ma
│ │ │ │ │ -000105f0: 6b65 2073 7572 6520 7468 6174 2079 6f75  ke sure that you
│ │ │ │ │ -00010600: 0a68 6176 6520 7468 6520 6672 6565 646f  .have the freedo
│ │ │ │ │ -00010610: 6d20 746f 2064 6973 7472 6962 7574 6520  m to distribute 
│ │ │ │ │ -00010620: 636f 7069 6573 206f 6620 6672 6565 2073  copies of free s
│ │ │ │ │ -00010630: 6f66 7477 6172 6520 2861 6e64 2063 6861  oftware (and cha
│ │ │ │ │ -00010640: 7267 6520 666f 720a 7468 6973 2073 6572  rge for.this ser
│ │ │ │ │ -00010650: 7669 6365 2069 6620 796f 7520 7769 7368  vice if you wish
│ │ │ │ │ -00010660: 292c 2074 6861 7420 796f 7520 7265 6365  ), that you rece
│ │ │ │ │ -00010670: 6976 6520 736f 7572 6365 2063 6f64 6520  ive source code 
│ │ │ │ │ -00010680: 6f72 2063 616e 2067 6574 2069 7420 6966  or can get it if
│ │ │ │ │ -00010690: 0a79 6f75 2077 616e 7420 6974 2c20 7468  .you want it, th
│ │ │ │ │ -000106a0: 6174 2079 6f75 2063 616e 2063 6861 6e67  at you can chang
│ │ │ │ │ -000106b0: 6520 7468 6520 736f 6674 7761 7265 206f  e the software o
│ │ │ │ │ -000106c0: 7220 7573 6520 7069 6563 6573 206f 6620  r use pieces of 
│ │ │ │ │ -000106d0: 6974 2069 6e20 6e65 770a 6672 6565 2070  it in new.free p
│ │ │ │ │ -000106e0: 726f 6772 616d 733b 2061 6e64 2074 6861  rograms; and tha
│ │ │ │ │ -000106f0: 7420 796f 7520 6b6e 6f77 2079 6f75 2063  t you know you c
│ │ │ │ │ -00010700: 616e 2064 6f20 7468 6573 6520 7468 696e  an do these thin
│ │ │ │ │ -00010710: 6773 2e0a 0a20 2020 546f 2070 726f 7465  gs...   To prote
│ │ │ │ │ -00010720: 6374 2079 6f75 7220 7269 6768 7473 2c20  ct your rights, 
│ │ │ │ │ -00010730: 7765 206e 6565 6420 746f 206d 616b 6520  we need to make 
│ │ │ │ │ -00010740: 7265 7374 7269 6374 696f 6e73 2074 6861  restrictions tha
│ │ │ │ │ -00010750: 7420 666f 7262 6964 0a61 6e79 6f6e 6520  t forbid.anyone 
│ │ │ │ │ -00010760: 746f 2064 656e 7920 796f 7520 7468 6573  to deny you thes
│ │ │ │ │ -00010770: 6520 7269 6768 7473 206f 7220 746f 2061  e rights or to a
│ │ │ │ │ -00010780: 736b 2079 6f75 2074 6f20 7375 7272 656e  sk you to surren
│ │ │ │ │ -00010790: 6465 7220 7468 6520 7269 6768 7473 2e0a  der the rights..
│ │ │ │ │ -000107a0: 5468 6573 6520 7265 7374 7269 6374 696f  These restrictio
│ │ │ │ │ -000107b0: 6e73 2074 7261 6e73 6c61 7465 2074 6f20  ns translate to 
│ │ │ │ │ -000107c0: 6365 7274 6169 6e20 7265 7370 6f6e 7369  certain responsi
│ │ │ │ │ -000107d0: 6269 6c69 7469 6573 2066 6f72 2079 6f75  bilities for you
│ │ │ │ │ -000107e0: 2069 6620 796f 750a 6469 7374 7269 6275   if you.distribu
│ │ │ │ │ -000107f0: 7465 2063 6f70 6965 7320 6f66 2074 6865  te copies of the
│ │ │ │ │ -00010800: 2073 6f66 7477 6172 652c 206f 7220 6966   software, or if
│ │ │ │ │ -00010810: 2079 6f75 206d 6f64 6966 7920 6974 2e0a   you modify it..
│ │ │ │ │ -00010820: 0a20 2020 466f 7220 6578 616d 706c 652c  .   For example,
│ │ │ │ │ -00010830: 2069 6620 796f 7520 6469 7374 7269 6275   if you distribu
│ │ │ │ │ -00010840: 7465 2063 6f70 6965 7320 6f66 2073 7563  te copies of suc
│ │ │ │ │ -00010850: 6820 6120 7072 6f67 7261 6d2c 2077 6865  h a program, whe
│ │ │ │ │ -00010860: 7468 6572 0a67 7261 7469 7320 6f72 2066  ther.gratis or f
│ │ │ │ │ -00010870: 6f72 2061 2066 6565 2c20 796f 7520 6d75  or a fee, you mu
│ │ │ │ │ -00010880: 7374 2067 6976 6520 7468 6520 7265 6369  st give the reci
│ │ │ │ │ -00010890: 7069 656e 7473 2061 6c6c 2074 6865 2072  pients all the r
│ │ │ │ │ -000108a0: 6967 6874 7320 7468 6174 0a79 6f75 2068  ights that.you h
│ │ │ │ │ -000108b0: 6176 652e 2020 596f 7520 6d75 7374 206d  ave.  You must m
│ │ │ │ │ -000108c0: 616b 6520 7375 7265 2074 6861 7420 7468  ake sure that th
│ │ │ │ │ -000108d0: 6579 2c20 746f 6f2c 2072 6563 6569 7665  ey, too, receive
│ │ │ │ │ -000108e0: 206f 7220 6361 6e20 6765 7420 7468 650a   or can get the.
│ │ │ │ │ -000108f0: 736f 7572 6365 2063 6f64 652e 2020 416e  source code.  An
│ │ │ │ │ -00010900: 6420 796f 7520 6d75 7374 2073 686f 7720  d you must show 
│ │ │ │ │ -00010910: 7468 656d 2074 6865 7365 2074 6572 6d73  them these terms
│ │ │ │ │ -00010920: 2073 6f20 7468 6579 206b 6e6f 7720 7468   so they know th
│ │ │ │ │ -00010930: 6569 720a 7269 6768 7473 2e0a 0a20 2020  eir.rights...   
│ │ │ │ │ -00010940: 5765 2070 726f 7465 6374 2079 6f75 7220  We protect your 
│ │ │ │ │ -00010950: 7269 6768 7473 2077 6974 6820 7477 6f20  rights with two 
│ │ │ │ │ -00010960: 7374 6570 733a 2028 3129 2063 6f70 7972  steps: (1) copyr
│ │ │ │ │ -00010970: 6967 6874 2074 6865 2073 6f66 7477 6172  ight the softwar
│ │ │ │ │ -00010980: 652c 0a61 6e64 2028 3229 206f 6666 6572  e,.and (2) offer
│ │ │ │ │ -00010990: 2079 6f75 2074 6869 7320 6c69 6365 6e73   you this licens
│ │ │ │ │ -000109a0: 6520 7768 6963 6820 6769 7665 7320 796f  e which gives yo
│ │ │ │ │ -000109b0: 7520 6c65 6761 6c20 7065 726d 6973 7369  u legal permissi
│ │ │ │ │ -000109c0: 6f6e 2074 6f20 636f 7079 2c0a 6469 7374  on to copy,.dist
│ │ │ │ │ -000109d0: 7269 6275 7465 2061 6e64 2f6f 7220 6d6f  ribute and/or mo
│ │ │ │ │ -000109e0: 6469 6679 2074 6865 2073 6f66 7477 6172  dify the softwar
│ │ │ │ │ -000109f0: 652e 0a0a 2020 2041 6c73 6f2c 2066 6f72  e...   Also, for
│ │ │ │ │ -00010a00: 2065 6163 6820 6175 7468 6f72 2773 2070   each author's p
│ │ │ │ │ -00010a10: 726f 7465 6374 696f 6e20 616e 6420 6f75  rotection and ou
│ │ │ │ │ -00010a20: 7273 2c20 7765 2077 616e 7420 746f 206d  rs, we want to m
│ │ │ │ │ -00010a30: 616b 6520 6365 7274 6169 6e0a 7468 6174  ake certain.that
│ │ │ │ │ -00010a40: 2065 7665 7279 6f6e 6520 756e 6465 7273   everyone unders
│ │ │ │ │ -00010a50: 7461 6e64 7320 7468 6174 2074 6865 7265  tands that there
│ │ │ │ │ -00010a60: 2069 7320 6e6f 2077 6172 7261 6e74 7920   is no warranty 
│ │ │ │ │ -00010a70: 666f 7220 7468 6973 2066 7265 650a 736f  for this free.so
│ │ │ │ │ -00010a80: 6674 7761 7265 2e20 2049 6620 7468 6520  ftware.  If the 
│ │ │ │ │ -00010a90: 736f 6674 7761 7265 2069 7320 6d6f 6469  software is modi
│ │ │ │ │ -00010aa0: 6669 6564 2062 7920 736f 6d65 6f6e 6520  fied by someone 
│ │ │ │ │ -00010ab0: 656c 7365 2061 6e64 2070 6173 7365 6420  else and passed 
│ │ │ │ │ -00010ac0: 6f6e 2c20 7765 0a77 616e 7420 6974 7320  on, we.want its 
│ │ │ │ │ -00010ad0: 7265 6369 7069 656e 7473 2074 6f20 6b6e  recipients to kn
│ │ │ │ │ -00010ae0: 6f77 2074 6861 7420 7768 6174 2074 6865  ow that what the
│ │ │ │ │ -00010af0: 7920 6861 7665 2069 7320 6e6f 7420 7468  y have is not th
│ │ │ │ │ -00010b00: 6520 6f72 6967 696e 616c 2c20 736f 0a74  e original, so.t
│ │ │ │ │ -00010b10: 6861 7420 616e 7920 7072 6f62 6c65 6d73  hat any problems
│ │ │ │ │ -00010b20: 2069 6e74 726f 6475 6365 6420 6279 206f   introduced by o
│ │ │ │ │ -00010b30: 7468 6572 7320 7769 6c6c 206e 6f74 2072  thers will not r
│ │ │ │ │ -00010b40: 6566 6c65 6374 206f 6e20 7468 6520 6f72  eflect on the or
│ │ │ │ │ -00010b50: 6967 696e 616c 0a61 7574 686f 7273 2720  iginal.authors' 
│ │ │ │ │ -00010b60: 7265 7075 7461 7469 6f6e 732e 0a0a 2020  reputations...  
│ │ │ │ │ -00010b70: 2046 696e 616c 6c79 2c20 616e 7920 6672   Finally, any fr
│ │ │ │ │ -00010b80: 6565 2070 726f 6772 616d 2069 7320 7468  ee program is th
│ │ │ │ │ -00010b90: 7265 6174 656e 6564 2063 6f6e 7374 616e  reatened constan
│ │ │ │ │ -00010ba0: 746c 7920 6279 2073 6f66 7477 6172 650a  tly by software.
│ │ │ │ │ -00010bb0: 7061 7465 6e74 732e 2020 5765 2077 6973  patents.  We wis
│ │ │ │ │ -00010bc0: 6820 746f 2061 766f 6964 2074 6865 2064  h to avoid the d
│ │ │ │ │ -00010bd0: 616e 6765 7220 7468 6174 2072 6564 6973  anger that redis
│ │ │ │ │ -00010be0: 7472 6962 7574 6f72 7320 6f66 2061 2066  tributors of a f
│ │ │ │ │ -00010bf0: 7265 650a 7072 6f67 7261 6d20 7769 6c6c  ree.program will
│ │ │ │ │ -00010c00: 2069 6e64 6976 6964 7561 6c6c 7920 6f62   individually ob
│ │ │ │ │ -00010c10: 7461 696e 2070 6174 656e 7420 6c69 6365  tain patent lice
│ │ │ │ │ -00010c20: 6e73 6573 2c20 696e 2065 6666 6563 7420  nses, in effect 
│ │ │ │ │ -00010c30: 6d61 6b69 6e67 2074 6865 0a70 726f 6772  making the.progr
│ │ │ │ │ -00010c40: 616d 2070 726f 7072 6965 7461 7279 2e20  am proprietary. 
│ │ │ │ │ -00010c50: 2054 6f20 7072 6576 656e 7420 7468 6973   To prevent this
│ │ │ │ │ -00010c60: 2c20 7765 2068 6176 6520 6d61 6465 2069  , we have made i
│ │ │ │ │ -00010c70: 7420 636c 6561 7220 7468 6174 2061 6e79  t clear that any
│ │ │ │ │ -00010c80: 0a70 6174 656e 7420 6d75 7374 2062 6520  .patent must be 
│ │ │ │ │ -00010c90: 6c69 6365 6e73 6564 2066 6f72 2065 7665  licensed for eve
│ │ │ │ │ -00010ca0: 7279 6f6e 6527 7320 6672 6565 2075 7365  ryone's free use
│ │ │ │ │ -00010cb0: 206f 7220 6e6f 7420 6c69 6365 6e73 6564   or not licensed
│ │ │ │ │ -00010cc0: 2061 7420 616c 6c2e 0a0a 2020 2054 6865   at all...   The
│ │ │ │ │ -00010cd0: 2070 7265 6369 7365 2074 6572 6d73 2061   precise terms a
│ │ │ │ │ -00010ce0: 6e64 2063 6f6e 6469 7469 6f6e 7320 666f  nd conditions fo
│ │ │ │ │ -00010cf0: 7220 636f 7079 696e 672c 2064 6973 7472  r copying, distr
│ │ │ │ │ -00010d00: 6962 7574 696f 6e20 616e 640a 6d6f 6469  ibution and.modi
│ │ │ │ │ -00010d10: 6669 6361 7469 6f6e 2066 6f6c 6c6f 772e  fication follow.
│ │ │ │ │ -00010d20: 0a0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ │ -00010d30: 2020 2020 2020 474e 5520 4745 4e45 5241        GNU GENERA
│ │ │ │ │ -00010d40: 4c20 5055 424c 4943 204c 4943 454e 5345  L PUBLIC LICENSE
│ │ │ │ │ -00010d50: 2076 322b 0a20 2020 2054 4552 4d53 2041   v2+.    TERMS A
│ │ │ │ │ -00010d60: 4e44 2043 4f4e 4449 5449 4f4e 5320 464f  ND CONDITIONS FO
│ │ │ │ │ -00010d70: 5220 434f 5059 494e 472c 2044 4953 5452  R COPYING, DISTR
│ │ │ │ │ -00010d80: 4942 5554 494f 4e20 414e 4420 4d4f 4449  IBUTION AND MODI
│ │ │ │ │ -00010d90: 4649 4341 5449 4f4e 0a0a 2020 302e 2054  FICATION..  0. T
│ │ │ │ │ -00010da0: 6869 7320 4c69 6365 6e73 6520 6170 706c  his License appl
│ │ │ │ │ -00010db0: 6965 7320 746f 2061 6e79 2070 726f 6772  ies to any progr
│ │ │ │ │ -00010dc0: 616d 206f 7220 6f74 6865 7220 776f 726b  am or other work
│ │ │ │ │ -00010dd0: 2077 6869 6368 2063 6f6e 7461 696e 7320   which contains 
│ │ │ │ │ -00010de0: 610a 2020 2020 206e 6f74 6963 6520 706c  a.     notice pl
│ │ │ │ │ -00010df0: 6163 6564 2062 7920 7468 6520 636f 7079  aced by the copy
│ │ │ │ │ -00010e00: 7269 6768 7420 686f 6c64 6572 2073 6179  right holder say
│ │ │ │ │ -00010e10: 696e 6720 6974 206d 6179 2062 6520 6469  ing it may be di
│ │ │ │ │ -00010e20: 7374 7269 6275 7465 640a 2020 2020 2075  stributed.     u
│ │ │ │ │ -00010e30: 6e64 6572 2074 6865 2074 6572 6d73 206f  nder the terms o
│ │ │ │ │ -00010e40: 6620 7468 6973 2047 656e 6572 616c 2050  f this General P
│ │ │ │ │ -00010e50: 7562 6c69 6320 4c69 6365 6e73 652e 2020  ublic License.  
│ │ │ │ │ -00010e60: 5468 6520 2250 726f 6772 616d 222c 0a20  The "Program",. 
│ │ │ │ │ -00010e70: 2020 2020 6265 6c6f 772c 2072 6566 6572      below, refer
│ │ │ │ │ -00010e80: 7320 746f 2061 6e79 2073 7563 6820 7072  s to any such pr
│ │ │ │ │ -00010e90: 6f67 7261 6d20 6f72 2077 6f72 6b2c 2061  ogram or work, a
│ │ │ │ │ -00010ea0: 6e64 2061 2022 776f 726b 2062 6173 6564  nd a "work based
│ │ │ │ │ -00010eb0: 206f 6e20 7468 650a 2020 2020 2050 726f   on the.     Pro
│ │ │ │ │ -00010ec0: 6772 616d 2220 6d65 616e 7320 6569 7468  gram" means eith
│ │ │ │ │ -00010ed0: 6572 2074 6865 2050 726f 6772 616d 206f  er the Program o
│ │ │ │ │ -00010ee0: 7220 616e 7920 6465 7269 7661 7469 7665  r any derivative
│ │ │ │ │ -00010ef0: 2077 6f72 6b20 756e 6465 720a 2020 2020   work under.    
│ │ │ │ │ -00010f00: 2063 6f70 7972 6967 6874 206c 6177 3a20   copyright law: 
│ │ │ │ │ -00010f10: 7468 6174 2069 7320 746f 2073 6179 2c20  that is to say, 
│ │ │ │ │ -00010f20: 6120 776f 726b 2063 6f6e 7461 696e 696e  a work containin
│ │ │ │ │ -00010f30: 6720 7468 6520 5072 6f67 7261 6d20 6f72  g the Program or
│ │ │ │ │ -00010f40: 2061 0a20 2020 2020 706f 7274 696f 6e20   a.     portion 
│ │ │ │ │ -00010f50: 6f66 2069 742c 2065 6974 6865 7220 7665  of it, either ve
│ │ │ │ │ -00010f60: 7262 6174 696d 206f 7220 7769 7468 206d  rbatim or with m
│ │ │ │ │ -00010f70: 6f64 6966 6963 6174 696f 6e73 2061 6e64  odifications and
│ │ │ │ │ -00010f80: 2f6f 720a 2020 2020 2074 7261 6e73 6c61  /or.     transla
│ │ │ │ │ -00010f90: 7465 6420 696e 746f 2061 6e6f 7468 6572  ted into another
│ │ │ │ │ -00010fa0: 206c 616e 6775 6167 652e 2020 2848 6572   language.  (Her
│ │ │ │ │ -00010fb0: 6569 6e61 6674 6572 2c20 7472 616e 736c  einafter, transl
│ │ │ │ │ -00010fc0: 6174 696f 6e20 6973 0a20 2020 2020 696e  ation is.     in
│ │ │ │ │ -00010fd0: 636c 7564 6564 2077 6974 686f 7574 206c  cluded without l
│ │ │ │ │ -00010fe0: 696d 6974 6174 696f 6e20 696e 2074 6865  imitation in the
│ │ │ │ │ -00010ff0: 2074 6572 6d20 226d 6f64 6966 6963 6174   term "modificat
│ │ │ │ │ -00011000: 696f 6e22 2e29 2020 4561 6368 0a20 2020  ion".)  Each.   
│ │ │ │ │ -00011010: 2020 6c69 6365 6e73 6565 2069 7320 6164    licensee is ad
│ │ │ │ │ -00011020: 6472 6573 7365 6420 6173 2022 796f 7522  dressed as "you"
│ │ │ │ │ -00011030: 2e0a 0a20 2020 2020 4163 7469 7669 7469  ...     Activiti
│ │ │ │ │ -00011040: 6573 206f 7468 6572 2074 6861 6e20 636f  es other than co
│ │ │ │ │ -00011050: 7079 696e 672c 2064 6973 7472 6962 7574  pying, distribut
│ │ │ │ │ -00011060: 696f 6e20 616e 6420 6d6f 6469 6669 6361  ion and modifica
│ │ │ │ │ -00011070: 7469 6f6e 2061 7265 0a20 2020 2020 6e6f  tion are.     no
│ │ │ │ │ -00011080: 7420 636f 7665 7265 6420 6279 2074 6869  t covered by thi
│ │ │ │ │ -00011090: 7320 4c69 6365 6e73 653b 2074 6865 7920  s License; they 
│ │ │ │ │ -000110a0: 6172 6520 6f75 7473 6964 6520 6974 7320  are outside its 
│ │ │ │ │ -000110b0: 7363 6f70 652e 2020 5468 6520 6163 740a  scope.  The act.
│ │ │ │ │ -000110c0: 2020 2020 206f 6620 7275 6e6e 696e 6720       of running 
│ │ │ │ │ -000110d0: 7468 6520 5072 6f67 7261 6d20 6973 206e  the Program is n
│ │ │ │ │ -000110e0: 6f74 2072 6573 7472 6963 7465 642c 2061  ot restricted, a
│ │ │ │ │ -000110f0: 6e64 2074 6865 206f 7574 7075 7420 6672  nd the output fr
│ │ │ │ │ -00011100: 6f6d 2074 6865 0a20 2020 2020 5072 6f67  om the.     Prog
│ │ │ │ │ -00011110: 7261 6d20 6973 2063 6f76 6572 6564 206f  ram is covered o
│ │ │ │ │ -00011120: 6e6c 7920 6966 2069 7473 2063 6f6e 7465  nly if its conte
│ │ │ │ │ -00011130: 6e74 7320 636f 6e73 7469 7475 7465 2061  nts constitute a
│ │ │ │ │ -00011140: 2077 6f72 6b20 6261 7365 6420 6f6e 0a20   work based on. 
│ │ │ │ │ -00011150: 2020 2020 7468 6520 5072 6f67 7261 6d20      the Program 
│ │ │ │ │ -00011160: 2869 6e64 6570 656e 6465 6e74 206f 6620  (independent of 
│ │ │ │ │ -00011170: 6861 7669 6e67 2062 6565 6e20 6d61 6465  having been made
│ │ │ │ │ -00011180: 2062 7920 7275 6e6e 696e 6720 7468 650a   by running the.
│ │ │ │ │ -00011190: 2020 2020 2050 726f 6772 616d 292e 2020       Program).  
│ │ │ │ │ -000111a0: 5768 6574 6865 7220 7468 6174 2069 7320  Whether that is 
│ │ │ │ │ -000111b0: 7472 7565 2064 6570 656e 6473 206f 6e20  true depends on 
│ │ │ │ │ -000111c0: 7768 6174 2074 6865 2050 726f 6772 616d  what the Program
│ │ │ │ │ -000111d0: 2064 6f65 732e 0a0a 2020 312e 2059 6f75   does...  1. You
│ │ │ │ │ -000111e0: 206d 6179 2063 6f70 7920 616e 6420 6469   may copy and di
│ │ │ │ │ -000111f0: 7374 7269 6275 7465 2076 6572 6261 7469  stribute verbati
│ │ │ │ │ -00011200: 6d20 636f 7069 6573 206f 6620 7468 6520  m copies of the 
│ │ │ │ │ -00011210: 5072 6f67 7261 6d27 7320 736f 7572 6365  Program's source
│ │ │ │ │ -00011220: 0a20 2020 2020 636f 6465 2061 7320 796f  .     code as yo
│ │ │ │ │ -00011230: 7520 7265 6365 6976 6520 6974 2c20 696e  u receive it, in
│ │ │ │ │ -00011240: 2061 6e79 206d 6564 6975 6d2c 2070 726f   any medium, pro
│ │ │ │ │ -00011250: 7669 6465 6420 7468 6174 2079 6f75 0a20  vided that you. 
│ │ │ │ │ -00011260: 2020 2020 636f 6e73 7069 6375 6f75 736c      conspicuousl
│ │ │ │ │ -00011270: 7920 616e 6420 6170 7072 6f70 7269 6174  y and appropriat
│ │ │ │ │ -00011280: 656c 7920 7075 626c 6973 6820 6f6e 2065  ely publish on e
│ │ │ │ │ -00011290: 6163 6820 636f 7079 2061 6e20 6170 7072  ach copy an appr
│ │ │ │ │ -000112a0: 6f70 7269 6174 650a 2020 2020 2063 6f70  opriate.     cop
│ │ │ │ │ -000112b0: 7972 6967 6874 206e 6f74 6963 6520 616e  yright notice an
│ │ │ │ │ -000112c0: 6420 6469 7363 6c61 696d 6572 206f 6620  d disclaimer of 
│ │ │ │ │ -000112d0: 7761 7272 616e 7479 3b20 6b65 6570 2069  warranty; keep i
│ │ │ │ │ -000112e0: 6e74 6163 7420 616c 6c20 7468 650a 2020  ntact all the.  
│ │ │ │ │ -000112f0: 2020 206e 6f74 6963 6573 2074 6861 7420     notices that 
│ │ │ │ │ -00011300: 7265 6665 7220 746f 2074 6869 7320 4c69  refer to this Li
│ │ │ │ │ -00011310: 6365 6e73 6520 616e 6420 746f 2074 6865  cense and to the
│ │ │ │ │ -00011320: 2061 6273 656e 6365 206f 6620 616e 790a   absence of any.
│ │ │ │ │ -00011330: 2020 2020 2077 6172 7261 6e74 793b 2061       warranty; a
│ │ │ │ │ -00011340: 6e64 2067 6976 6520 616e 7920 6f74 6865  nd give any othe
│ │ │ │ │ -00011350: 7220 7265 6369 7069 656e 7473 206f 6620  r recipients of 
│ │ │ │ │ -00011360: 7468 6520 5072 6f67 7261 6d20 6120 636f  the Program a co
│ │ │ │ │ -00011370: 7079 206f 660a 2020 2020 2074 6869 7320  py of.     this 
│ │ │ │ │ -00011380: 4c69 6365 6e73 6520 616c 6f6e 6720 7769  License along wi
│ │ │ │ │ -00011390: 7468 2074 6865 2050 726f 6772 616d 2e0a  th the Program..
│ │ │ │ │ -000113a0: 0a20 2020 2020 596f 7520 6d61 7920 6368  .     You may ch
│ │ │ │ │ -000113b0: 6172 6765 2061 2066 6565 2066 6f72 2074  arge a fee for t
│ │ │ │ │ -000113c0: 6865 2070 6879 7369 6361 6c20 6163 7420  he physical act 
│ │ │ │ │ -000113d0: 6f66 2074 7261 6e73 6665 7272 696e 6720  of transferring 
│ │ │ │ │ -000113e0: 6120 636f 7079 2c0a 2020 2020 2061 6e64  a copy,.     and
│ │ │ │ │ -000113f0: 2079 6f75 206d 6179 2061 7420 796f 7572   you may at your
│ │ │ │ │ -00011400: 206f 7074 696f 6e20 6f66 6665 7220 7761   option offer wa
│ │ │ │ │ -00011410: 7272 616e 7479 2070 726f 7465 6374 696f  rranty protectio
│ │ │ │ │ -00011420: 6e20 696e 2065 7863 6861 6e67 650a 2020  n in exchange.  
│ │ │ │ │ -00011430: 2020 2066 6f72 2061 2066 6565 2e0a 0a20     for a fee... 
│ │ │ │ │ -00011440: 2032 2e20 596f 7520 6d61 7920 6d6f 6469   2. You may modi
│ │ │ │ │ -00011450: 6679 2079 6f75 7220 636f 7079 206f 7220  fy your copy or 
│ │ │ │ │ -00011460: 636f 7069 6573 206f 6620 7468 6520 5072  copies of the Pr
│ │ │ │ │ -00011470: 6f67 7261 6d20 6f72 2061 6e79 2070 6f72  ogram or any por
│ │ │ │ │ -00011480: 7469 6f6e 206f 660a 2020 2020 2069 742c  tion of.     it,
│ │ │ │ │ -00011490: 2074 6875 7320 666f 726d 696e 6720 6120   thus forming a 
│ │ │ │ │ -000114a0: 776f 726b 2062 6173 6564 206f 6e20 7468  work based on th
│ │ │ │ │ -000114b0: 6520 5072 6f67 7261 6d2c 2061 6e64 2063  e Program, and c
│ │ │ │ │ -000114c0: 6f70 7920 616e 640a 2020 2020 2064 6973  opy and.     dis
│ │ │ │ │ -000114d0: 7472 6962 7574 6520 7375 6368 206d 6f64  tribute such mod
│ │ │ │ │ -000114e0: 6966 6963 6174 696f 6e73 206f 7220 776f  ifications or wo
│ │ │ │ │ -000114f0: 726b 2075 6e64 6572 2074 6865 2074 6572  rk under the ter
│ │ │ │ │ -00011500: 6d73 206f 6620 5365 6374 696f 6e20 310a  ms of Section 1.
│ │ │ │ │ -00011510: 2020 2020 2061 626f 7665 2c20 7072 6f76       above, prov
│ │ │ │ │ -00011520: 6964 6564 2074 6861 7420 796f 7520 616c  ided that you al
│ │ │ │ │ -00011530: 736f 206d 6565 7420 616c 6c20 6f66 2074  so meet all of t
│ │ │ │ │ -00011540: 6865 7365 2063 6f6e 6469 7469 6f6e 733a  hese conditions:
│ │ │ │ │ -00011550: 0a0a 2020 2020 2020 2061 2e20 596f 7520  ..       a. You 
│ │ │ │ │ -00011560: 6d75 7374 2063 6175 7365 2074 6865 206d  must cause the m
│ │ │ │ │ -00011570: 6f64 6966 6965 6420 6669 6c65 7320 746f  odified files to
│ │ │ │ │ -00011580: 2063 6172 7279 2070 726f 6d69 6e65 6e74   carry prominent
│ │ │ │ │ -00011590: 206e 6f74 6963 6573 0a20 2020 2020 2020   notices.       
│ │ │ │ │ -000115a0: 2020 2073 7461 7469 6e67 2074 6861 7420     stating that 
│ │ │ │ │ -000115b0: 796f 7520 6368 616e 6765 6420 7468 6520  you changed the 
│ │ │ │ │ -000115c0: 6669 6c65 7320 616e 6420 7468 6520 6461  files and the da
│ │ │ │ │ -000115d0: 7465 206f 6620 616e 7920 6368 616e 6765  te of any change
│ │ │ │ │ -000115e0: 2e0a 0a20 2020 2020 2020 622e 2059 6f75  ...       b. You
│ │ │ │ │ -000115f0: 206d 7573 7420 6361 7573 6520 616e 7920   must cause any 
│ │ │ │ │ -00011600: 776f 726b 2074 6861 7420 796f 7520 6469  work that you di
│ │ │ │ │ -00011610: 7374 7269 6275 7465 206f 7220 7075 626c  stribute or publ
│ │ │ │ │ -00011620: 6973 682c 2074 6861 740a 2020 2020 2020  ish, that.      
│ │ │ │ │ -00011630: 2020 2020 696e 2077 686f 6c65 206f 7220      in whole or 
│ │ │ │ │ -00011640: 696e 2070 6172 7420 636f 6e74 6169 6e73  in part contains
│ │ │ │ │ -00011650: 206f 7220 6973 2064 6572 6976 6564 2066   or is derived f
│ │ │ │ │ -00011660: 726f 6d20 7468 6520 5072 6f67 7261 6d20  rom the Program 
│ │ │ │ │ -00011670: 6f72 0a20 2020 2020 2020 2020 2061 6e79  or.          any
│ │ │ │ │ -00011680: 2070 6172 7420 7468 6572 656f 662c 2074   part thereof, t
│ │ │ │ │ -00011690: 6f20 6265 206c 6963 656e 7365 6420 6173  o be licensed as
│ │ │ │ │ -000116a0: 2061 2077 686f 6c65 2061 7420 6e6f 2063   a whole at no c
│ │ │ │ │ -000116b0: 6861 7267 6520 746f 0a20 2020 2020 2020  harge to.       
│ │ │ │ │ -000116c0: 2020 2061 6c6c 2074 6869 7264 2070 6172     all third par
│ │ │ │ │ -000116d0: 7469 6573 2075 6e64 6572 2074 6865 2074  ties under the t
│ │ │ │ │ -000116e0: 6572 6d73 206f 6620 7468 6973 204c 6963  erms of this Lic
│ │ │ │ │ -000116f0: 656e 7365 2e0a 0a20 2020 2020 2020 632e  ense...       c.
│ │ │ │ │ -00011700: 2049 6620 7468 6520 6d6f 6469 6669 6564   If the modified
│ │ │ │ │ -00011710: 2070 726f 6772 616d 206e 6f72 6d61 6c6c   program normall
│ │ │ │ │ -00011720: 7920 7265 6164 7320 636f 6d6d 616e 6473  y reads commands
│ │ │ │ │ -00011730: 2069 6e74 6572 6163 7469 7665 6c79 0a20   interactively. 
│ │ │ │ │ -00011740: 2020 2020 2020 2020 2077 6865 6e20 7275           when ru
│ │ │ │ │ -00011750: 6e2c 2079 6f75 206d 7573 7420 6361 7573  n, you must caus
│ │ │ │ │ -00011760: 6520 6974 2c20 7768 656e 2073 7461 7274  e it, when start
│ │ │ │ │ -00011770: 6564 2072 756e 6e69 6e67 2066 6f72 2073  ed running for s
│ │ │ │ │ -00011780: 7563 680a 2020 2020 2020 2020 2020 696e  uch.          in
│ │ │ │ │ -00011790: 7465 7261 6374 6976 6520 7573 6520 696e  teractive use in
│ │ │ │ │ -000117a0: 2074 6865 206d 6f73 7420 6f72 6469 6e61   the most ordina
│ │ │ │ │ -000117b0: 7279 2077 6179 2c20 746f 2070 7269 6e74  ry way, to print
│ │ │ │ │ -000117c0: 206f 7220 6469 7370 6c61 790a 2020 2020   or display.    
│ │ │ │ │ -000117d0: 2020 2020 2020 616e 2061 6e6e 6f75 6e63        an announc
│ │ │ │ │ -000117e0: 656d 656e 7420 696e 636c 7564 696e 6720  ement including 
│ │ │ │ │ -000117f0: 616e 2061 7070 726f 7072 6961 7465 2063  an appropriate c
│ │ │ │ │ -00011800: 6f70 7972 6967 6874 206e 6f74 6963 6520  opyright notice 
│ │ │ │ │ -00011810: 616e 640a 2020 2020 2020 2020 2020 6120  and.          a 
│ │ │ │ │ -00011820: 6e6f 7469 6365 2074 6861 7420 7468 6572  notice that ther
│ │ │ │ │ -00011830: 6520 6973 206e 6f20 7761 7272 616e 7479  e is no warranty
│ │ │ │ │ -00011840: 2028 6f72 2065 6c73 652c 2073 6179 696e   (or else, sayin
│ │ │ │ │ -00011850: 6720 7468 6174 2079 6f75 0a20 2020 2020  g that you.     
│ │ │ │ │ -00011860: 2020 2020 2070 726f 7669 6465 2061 2077       provide a w
│ │ │ │ │ -00011870: 6172 7261 6e74 7929 2061 6e64 2074 6861  arranty) and tha
│ │ │ │ │ -00011880: 7420 7573 6572 7320 6d61 7920 7265 6469  t users may redi
│ │ │ │ │ -00011890: 7374 7269 6275 7465 2074 6865 0a20 2020  stribute the.   
│ │ │ │ │ -000118a0: 2020 2020 2020 2070 726f 6772 616d 2075         program u
│ │ │ │ │ -000118b0: 6e64 6572 2074 6865 7365 2063 6f6e 6469  nder these condi
│ │ │ │ │ -000118c0: 7469 6f6e 732c 2061 6e64 2074 656c 6c69  tions, and telli
│ │ │ │ │ -000118d0: 6e67 2074 6865 2075 7365 7220 686f 7720  ng the user how 
│ │ │ │ │ -000118e0: 746f 0a20 2020 2020 2020 2020 2076 6965  to.          vie
│ │ │ │ │ -000118f0: 7720 6120 636f 7079 206f 6620 7468 6973  w a copy of this
│ │ │ │ │ -00011900: 204c 6963 656e 7365 2e20 2028 4578 6365   License.  (Exce
│ │ │ │ │ -00011910: 7074 696f 6e3a 2069 6620 7468 6520 5072  ption: if the Pr
│ │ │ │ │ -00011920: 6f67 7261 6d0a 2020 2020 2020 2020 2020  ogram.          
│ │ │ │ │ -00011930: 6974 7365 6c66 2069 7320 696e 7465 7261  itself is intera
│ │ │ │ │ -00011940: 6374 6976 6520 6275 7420 646f 6573 206e  ctive but does n
│ │ │ │ │ -00011950: 6f74 206e 6f72 6d61 6c6c 7920 7072 696e  ot normally prin
│ │ │ │ │ -00011960: 7420 7375 6368 2061 6e0a 2020 2020 2020  t such an.      
│ │ │ │ │ -00011970: 2020 2020 616e 6e6f 756e 6365 6d65 6e74      announcement
│ │ │ │ │ -00011980: 2c20 796f 7572 2077 6f72 6b20 6261 7365  , your work base
│ │ │ │ │ -00011990: 6420 6f6e 2074 6865 2050 726f 6772 616d  d on the Program
│ │ │ │ │ -000119a0: 2069 7320 6e6f 7420 7265 7175 6972 6564   is not required
│ │ │ │ │ -000119b0: 0a20 2020 2020 2020 2020 2074 6f20 7072  .          to pr
│ │ │ │ │ -000119c0: 696e 7420 616e 2061 6e6e 6f75 6e63 656d  int an announcem
│ │ │ │ │ -000119d0: 656e 742e 290a 0a20 2020 2020 5468 6573  ent.)..     Thes
│ │ │ │ │ -000119e0: 6520 7265 7175 6972 656d 656e 7473 2061  e requirements a
│ │ │ │ │ -000119f0: 7070 6c79 2074 6f20 7468 6520 6d6f 6469  pply to the modi
│ │ │ │ │ -00011a00: 6669 6564 2077 6f72 6b20 6173 2061 2077  fied work as a w
│ │ │ │ │ -00011a10: 686f 6c65 2e20 2049 660a 2020 2020 2069  hole.  If.     i
│ │ │ │ │ -00011a20: 6465 6e74 6966 6961 626c 6520 7365 6374  dentifiable sect
│ │ │ │ │ -00011a30: 696f 6e73 206f 6620 7468 6174 2077 6f72  ions of that wor
│ │ │ │ │ -00011a40: 6b20 6172 6520 6e6f 7420 6465 7269 7665  k are not derive
│ │ │ │ │ -00011a50: 6420 6672 6f6d 2074 6865 0a20 2020 2020  d from the.     
│ │ │ │ │ -00011a60: 5072 6f67 7261 6d2c 2061 6e64 2063 616e  Program, and can
│ │ │ │ │ -00011a70: 2062 6520 7265 6173 6f6e 6162 6c79 2063   be reasonably c
│ │ │ │ │ -00011a80: 6f6e 7369 6465 7265 6420 696e 6465 7065  onsidered indepe
│ │ │ │ │ -00011a90: 6e64 656e 7420 616e 6420 7365 7061 7261  ndent and separa
│ │ │ │ │ -00011aa0: 7465 0a20 2020 2020 776f 726b 7320 696e  te.     works in
│ │ │ │ │ -00011ab0: 2074 6865 6d73 656c 7665 732c 2074 6865   themselves, the
│ │ │ │ │ -00011ac0: 6e20 7468 6973 204c 6963 656e 7365 2c20  n this License, 
│ │ │ │ │ -00011ad0: 616e 6420 6974 7320 7465 726d 732c 2064  and its terms, d
│ │ │ │ │ -00011ae0: 6f20 6e6f 7420 6170 706c 790a 2020 2020  o not apply.    
│ │ │ │ │ -00011af0: 2074 6f20 7468 6f73 6520 7365 6374 696f   to those sectio
│ │ │ │ │ -00011b00: 6e73 2077 6865 6e20 796f 7520 6469 7374  ns when you dist
│ │ │ │ │ -00011b10: 7269 6275 7465 2074 6865 6d20 6173 2073  ribute them as s
│ │ │ │ │ -00011b20: 6570 6172 6174 6520 776f 726b 732e 2020  eparate works.  
│ │ │ │ │ -00011b30: 4275 740a 2020 2020 2077 6865 6e20 796f  But.     when yo
│ │ │ │ │ -00011b40: 7520 6469 7374 7269 6275 7465 2074 6865  u distribute the
│ │ │ │ │ -00011b50: 2073 616d 6520 7365 6374 696f 6e73 2061   same sections a
│ │ │ │ │ -00011b60: 7320 7061 7274 206f 6620 6120 7768 6f6c  s part of a whol
│ │ │ │ │ -00011b70: 6520 7768 6963 6820 6973 2061 0a20 2020  e which is a.   
│ │ │ │ │ -00011b80: 2020 776f 726b 2062 6173 6564 206f 6e20    work based on 
│ │ │ │ │ -00011b90: 7468 6520 5072 6f67 7261 6d2c 2074 6865  the Program, the
│ │ │ │ │ -00011ba0: 2064 6973 7472 6962 7574 696f 6e20 6f66   distribution of
│ │ │ │ │ -00011bb0: 2074 6865 2077 686f 6c65 206d 7573 7420   the whole must 
│ │ │ │ │ -00011bc0: 6265 206f 6e0a 2020 2020 2074 6865 2074  be on.     the t
│ │ │ │ │ -00011bd0: 6572 6d73 206f 6620 7468 6973 204c 6963  erms of this Lic
│ │ │ │ │ -00011be0: 656e 7365 2c20 7768 6f73 6520 7065 726d  ense, whose perm
│ │ │ │ │ -00011bf0: 6973 7369 6f6e 7320 666f 7220 6f74 6865  issions for othe
│ │ │ │ │ -00011c00: 7220 6c69 6365 6e73 6565 730a 2020 2020  r licensees.    
│ │ │ │ │ -00011c10: 2065 7874 656e 6420 746f 2074 6865 2065   extend to the e
│ │ │ │ │ -00011c20: 6e74 6972 6520 7768 6f6c 652c 2061 6e64  ntire whole, and
│ │ │ │ │ -00011c30: 2074 6875 7320 746f 2065 6163 6820 616e   thus to each an
│ │ │ │ │ -00011c40: 6420 6576 6572 7920 7061 7274 0a20 2020  d every part.   
│ │ │ │ │ -00011c50: 2020 7265 6761 7264 6c65 7373 206f 6620    regardless of 
│ │ │ │ │ -00011c60: 7768 6f20 7772 6f74 6520 6974 2e0a 0a20  who wrote it... 
│ │ │ │ │ -00011c70: 2020 2020 5468 7573 2c20 6974 2069 7320      Thus, it is 
│ │ │ │ │ -00011c80: 6e6f 7420 7468 6520 696e 7465 6e74 206f  not the intent o
│ │ │ │ │ -00011c90: 6620 7468 6973 2073 6563 7469 6f6e 2074  f this section t
│ │ │ │ │ -00011ca0: 6f20 636c 6169 6d20 7269 6768 7473 206f  o claim rights o
│ │ │ │ │ -00011cb0: 720a 2020 2020 2063 6f6e 7465 7374 2079  r.     contest y
│ │ │ │ │ -00011cc0: 6f75 7220 7269 6768 7473 2074 6f20 776f  our rights to wo
│ │ │ │ │ -00011cd0: 726b 2077 7269 7474 656e 2065 6e74 6972  rk written entir
│ │ │ │ │ -00011ce0: 656c 7920 6279 2079 6f75 3b20 7261 7468  ely by you; rath
│ │ │ │ │ -00011cf0: 6572 2c20 7468 650a 2020 2020 2069 6e74  er, the.     int
│ │ │ │ │ -00011d00: 656e 7420 6973 2074 6f20 6578 6572 6369  ent is to exerci
│ │ │ │ │ -00011d10: 7365 2074 6865 2072 6967 6874 2074 6f20  se the right to 
│ │ │ │ │ -00011d20: 636f 6e74 726f 6c20 7468 6520 6469 7374  control the dist
│ │ │ │ │ -00011d30: 7269 6275 7469 6f6e 206f 660a 2020 2020  ribution of.    
│ │ │ │ │ -00011d40: 2064 6572 6976 6174 6976 6520 6f72 2063   derivative or c
│ │ │ │ │ -00011d50: 6f6c 6c65 6374 6976 6520 776f 726b 7320  ollective works 
│ │ │ │ │ -00011d60: 6261 7365 6420 6f6e 2074 6865 2050 726f  based on the Pro
│ │ │ │ │ -00011d70: 6772 616d 2e0a 0a20 2020 2020 496e 2061  gram...     In a
│ │ │ │ │ -00011d80: 6464 6974 696f 6e2c 206d 6572 6520 6167  ddition, mere ag
│ │ │ │ │ -00011d90: 6772 6567 6174 696f 6e20 6f66 2061 6e6f  gregation of ano
│ │ │ │ │ -00011da0: 7468 6572 2077 6f72 6b20 6e6f 7420 6261  ther work not ba
│ │ │ │ │ -00011db0: 7365 6420 6f6e 2074 6865 0a20 2020 2020  sed on the.     
│ │ │ │ │ -00011dc0: 5072 6f67 7261 6d20 7769 7468 2074 6865  Program with the
│ │ │ │ │ -00011dd0: 2050 726f 6772 616d 2028 6f72 2077 6974   Program (or wit
│ │ │ │ │ -00011de0: 6820 6120 776f 726b 2062 6173 6564 206f  h a work based o
│ │ │ │ │ -00011df0: 6e20 7468 6520 5072 6f67 7261 6d29 206f  n the Program) o
│ │ │ │ │ -00011e00: 6e20 610a 2020 2020 2076 6f6c 756d 6520  n a.     volume 
│ │ │ │ │ -00011e10: 6f66 2061 2073 746f 7261 6765 206f 7220  of a storage or 
│ │ │ │ │ -00011e20: 6469 7374 7269 6275 7469 6f6e 206d 6564  distribution med
│ │ │ │ │ -00011e30: 6975 6d20 646f 6573 206e 6f74 2062 7269  ium does not bri
│ │ │ │ │ -00011e40: 6e67 2074 6865 206f 7468 6572 0a20 2020  ng the other.   
│ │ │ │ │ -00011e50: 2020 776f 726b 2075 6e64 6572 2074 6865    work under the
│ │ │ │ │ -00011e60: 2073 636f 7065 206f 6620 7468 6973 204c   scope of this L
│ │ │ │ │ -00011e70: 6963 656e 7365 2e0a 0a20 2033 2e20 596f  icense...  3. Yo
│ │ │ │ │ -00011e80: 7520 6d61 7920 636f 7079 2061 6e64 2064  u may copy and d
│ │ │ │ │ -00011e90: 6973 7472 6962 7574 6520 7468 6520 5072  istribute the Pr
│ │ │ │ │ -00011ea0: 6f67 7261 6d20 286f 7220 6120 776f 726b  ogram (or a work
│ │ │ │ │ -00011eb0: 2062 6173 6564 206f 6e20 6974 2c0a 2020   based on it,.  
│ │ │ │ │ -00011ec0: 2020 2075 6e64 6572 2053 6563 7469 6f6e     under Section
│ │ │ │ │ -00011ed0: 2032 2920 696e 206f 626a 6563 7420 636f   2) in object co
│ │ │ │ │ -00011ee0: 6465 206f 7220 6578 6563 7574 6162 6c65  de or executable
│ │ │ │ │ -00011ef0: 2066 6f72 6d20 756e 6465 7220 7468 6520   form under the 
│ │ │ │ │ -00011f00: 7465 726d 730a 2020 2020 206f 6620 5365  terms.     of Se
│ │ │ │ │ -00011f10: 6374 696f 6e73 2031 2061 6e64 2032 2061  ctions 1 and 2 a
│ │ │ │ │ -00011f20: 626f 7665 2070 726f 7669 6465 6420 7468  bove provided th
│ │ │ │ │ -00011f30: 6174 2079 6f75 2061 6c73 6f20 646f 206f  at you also do o
│ │ │ │ │ -00011f40: 6e65 206f 6620 7468 650a 2020 2020 2066  ne of the.     f
│ │ │ │ │ -00011f50: 6f6c 6c6f 7769 6e67 3a0a 0a20 2020 2020  ollowing:..     
│ │ │ │ │ -00011f60: 2020 612e 2041 6363 6f6d 7061 6e79 2069    a. Accompany i
│ │ │ │ │ -00011f70: 7420 7769 7468 2074 6865 2063 6f6d 706c  t with the compl
│ │ │ │ │ -00011f80: 6574 6520 636f 7272 6573 706f 6e64 696e  ete correspondin
│ │ │ │ │ -00011f90: 6720 6d61 6368 696e 652d 7265 6164 6162  g machine-readab
│ │ │ │ │ -00011fa0: 6c65 0a20 2020 2020 2020 2020 2073 6f75  le.          sou
│ │ │ │ │ -00011fb0: 7263 6520 636f 6465 2c20 7768 6963 6820  rce code, which 
│ │ │ │ │ -00011fc0: 6d75 7374 2062 6520 6469 7374 7269 6275  must be distribu
│ │ │ │ │ -00011fd0: 7465 6420 756e 6465 7220 7468 6520 7465  ted under the te
│ │ │ │ │ -00011fe0: 726d 7320 6f66 0a20 2020 2020 2020 2020  rms of.         
│ │ │ │ │ -00011ff0: 2053 6563 7469 6f6e 7320 3120 616e 6420   Sections 1 and 
│ │ │ │ │ -00012000: 3220 6162 6f76 6520 6f6e 2061 206d 6564  2 above on a med
│ │ │ │ │ -00012010: 6975 6d20 6375 7374 6f6d 6172 696c 7920  ium customarily 
│ │ │ │ │ -00012020: 7573 6564 2066 6f72 0a20 2020 2020 2020  used for.       
│ │ │ │ │ -00012030: 2020 2073 6f66 7477 6172 6520 696e 7465     software inte
│ │ │ │ │ -00012040: 7263 6861 6e67 653b 206f 722c 0a0a 2020  rchange; or,..  
│ │ │ │ │ -00012050: 2020 2020 2062 2e20 4163 636f 6d70 616e       b. Accompan
│ │ │ │ │ -00012060: 7920 6974 2077 6974 6820 6120 7772 6974  y it with a writ
│ │ │ │ │ -00012070: 7465 6e20 6f66 6665 722c 2076 616c 6964  ten offer, valid
│ │ │ │ │ -00012080: 2066 6f72 2061 7420 6c65 6173 7420 7468   for at least th
│ │ │ │ │ -00012090: 7265 650a 2020 2020 2020 2020 2020 7965  ree.          ye
│ │ │ │ │ -000120a0: 6172 732c 2074 6f20 6769 7665 2061 6e79  ars, to give any
│ │ │ │ │ -000120b0: 2074 6869 7264 2070 6172 7479 2c20 666f   third party, fo
│ │ │ │ │ -000120c0: 7220 6120 6368 6172 6765 206e 6f20 6d6f  r a charge no mo
│ │ │ │ │ -000120d0: 7265 2074 6861 6e20 796f 7572 0a20 2020  re than your.   
│ │ │ │ │ -000120e0: 2020 2020 2020 2063 6f73 7420 6f66 2070         cost of p
│ │ │ │ │ -000120f0: 6879 7369 6361 6c6c 7920 7065 7266 6f72  hysically perfor
│ │ │ │ │ -00012100: 6d69 6e67 2073 6f75 7263 6520 6469 7374  ming source dist
│ │ │ │ │ -00012110: 7269 6275 7469 6f6e 2c20 6120 636f 6d70  ribution, a comp
│ │ │ │ │ -00012120: 6c65 7465 0a20 2020 2020 2020 2020 206d  lete.          m
│ │ │ │ │ -00012130: 6163 6869 6e65 2d72 6561 6461 626c 6520  achine-readable 
│ │ │ │ │ -00012140: 636f 7079 206f 6620 7468 6520 636f 7272  copy of the corr
│ │ │ │ │ -00012150: 6573 706f 6e64 696e 6720 736f 7572 6365  esponding source
│ │ │ │ │ -00012160: 2063 6f64 652c 2074 6f20 6265 0a20 2020   code, to be.   
│ │ │ │ │ -00012170: 2020 2020 2020 2064 6973 7472 6962 7574         distribut
│ │ │ │ │ -00012180: 6564 2075 6e64 6572 2074 6865 2074 6572  ed under the ter
│ │ │ │ │ -00012190: 6d73 206f 6620 5365 6374 696f 6e73 2031  ms of Sections 1
│ │ │ │ │ -000121a0: 2061 6e64 2032 2061 626f 7665 206f 6e20   and 2 above on 
│ │ │ │ │ -000121b0: 610a 2020 2020 2020 2020 2020 6d65 6469  a.          medi
│ │ │ │ │ -000121c0: 756d 2063 7573 746f 6d61 7269 6c79 2075  um customarily u
│ │ │ │ │ -000121d0: 7365 6420 666f 7220 736f 6674 7761 7265  sed for software
│ │ │ │ │ -000121e0: 2069 6e74 6572 6368 616e 6765 3b20 6f72   interchange; or
│ │ │ │ │ -000121f0: 2c0a 0a20 2020 2020 2020 632e 2041 6363  ,..       c. Acc
│ │ │ │ │ -00012200: 6f6d 7061 6e79 2069 7420 7769 7468 2074  ompany it with t
│ │ │ │ │ -00012210: 6865 2069 6e66 6f72 6d61 7469 6f6e 2079  he information y
│ │ │ │ │ -00012220: 6f75 2072 6563 6569 7665 6420 6173 2074  ou received as t
│ │ │ │ │ -00012230: 6f20 7468 6520 6f66 6665 720a 2020 2020  o the offer.    
│ │ │ │ │ -00012240: 2020 2020 2020 746f 2064 6973 7472 6962        to distrib
│ │ │ │ │ -00012250: 7574 6520 636f 7272 6573 706f 6e64 696e  ute correspondin
│ │ │ │ │ -00012260: 6720 736f 7572 6365 2063 6f64 652e 2020  g source code.  
│ │ │ │ │ -00012270: 2854 6869 7320 616c 7465 726e 6174 6976  (This alternativ
│ │ │ │ │ -00012280: 6520 6973 0a20 2020 2020 2020 2020 2061  e is.          a
│ │ │ │ │ -00012290: 6c6c 6f77 6564 206f 6e6c 7920 666f 7220  llowed only for 
│ │ │ │ │ -000122a0: 6e6f 6e63 6f6d 6d65 7263 6961 6c20 6469  noncommercial di
│ │ │ │ │ -000122b0: 7374 7269 6275 7469 6f6e 2061 6e64 206f  stribution and o
│ │ │ │ │ -000122c0: 6e6c 7920 6966 2079 6f75 0a20 2020 2020  nly if you.     
│ │ │ │ │ -000122d0: 2020 2020 2072 6563 6569 7665 6420 7468       received th
│ │ │ │ │ -000122e0: 6520 7072 6f67 7261 6d20 696e 206f 626a  e program in obj
│ │ │ │ │ -000122f0: 6563 7420 636f 6465 206f 7220 6578 6563  ect code or exec
│ │ │ │ │ -00012300: 7574 6162 6c65 2066 6f72 6d20 7769 7468  utable form with
│ │ │ │ │ -00012310: 0a20 2020 2020 2020 2020 2073 7563 6820  .          such 
│ │ │ │ │ -00012320: 616e 206f 6666 6572 2c20 696e 2061 6363  an offer, in acc
│ │ │ │ │ -00012330: 6f72 6420 7769 7468 2053 7562 7365 6374  ord with Subsect
│ │ │ │ │ -00012340: 696f 6e20 6220 6162 6f76 652e 290a 0a20  ion b above.).. 
│ │ │ │ │ -00012350: 2020 2020 5468 6520 736f 7572 6365 2063      The source c
│ │ │ │ │ -00012360: 6f64 6520 666f 7220 6120 776f 726b 206d  ode for a work m
│ │ │ │ │ -00012370: 6561 6e73 2074 6865 2070 7265 6665 7272  eans the preferr
│ │ │ │ │ -00012380: 6564 2066 6f72 6d20 6f66 2074 6865 2077  ed form of the w
│ │ │ │ │ -00012390: 6f72 6b20 666f 720a 2020 2020 206d 616b  ork for.     mak
│ │ │ │ │ -000123a0: 696e 6720 6d6f 6469 6669 6361 7469 6f6e  ing modification
│ │ │ │ │ -000123b0: 7320 746f 2069 742e 2020 466f 7220 616e  s to it.  For an
│ │ │ │ │ -000123c0: 2065 7865 6375 7461 626c 6520 776f 726b   executable work
│ │ │ │ │ -000123d0: 2c20 636f 6d70 6c65 7465 0a20 2020 2020  , complete.     
│ │ │ │ │ -000123e0: 736f 7572 6365 2063 6f64 6520 6d65 616e  source code mean
│ │ │ │ │ -000123f0: 7320 616c 6c20 7468 6520 736f 7572 6365  s all the source
│ │ │ │ │ -00012400: 2063 6f64 6520 666f 7220 616c 6c20 6d6f   code for all mo
│ │ │ │ │ -00012410: 6475 6c65 7320 6974 2063 6f6e 7461 696e  dules it contain
│ │ │ │ │ -00012420: 732c 0a20 2020 2020 706c 7573 2061 6e79  s,.     plus any
│ │ │ │ │ -00012430: 2061 7373 6f63 6961 7465 6420 696e 7465   associated inte
│ │ │ │ │ -00012440: 7266 6163 6520 6465 6669 6e69 7469 6f6e  rface definition
│ │ │ │ │ -00012450: 2066 696c 6573 2c20 706c 7573 2074 6865   files, plus the
│ │ │ │ │ -00012460: 2073 6372 6970 7473 0a20 2020 2020 7573   scripts.     us
│ │ │ │ │ -00012470: 6564 2074 6f20 636f 6e74 726f 6c20 636f  ed to control co
│ │ │ │ │ -00012480: 6d70 696c 6174 696f 6e20 616e 6420 696e  mpilation and in
│ │ │ │ │ -00012490: 7374 616c 6c61 7469 6f6e 206f 6620 7468  stallation of th
│ │ │ │ │ -000124a0: 6520 6578 6563 7574 6162 6c65 2e0a 2020  e executable..  
│ │ │ │ │ -000124b0: 2020 2048 6f77 6576 6572 2c20 6173 2061     However, as a
│ │ │ │ │ -000124c0: 2073 7065 6369 616c 2065 7863 6570 7469   special excepti
│ │ │ │ │ -000124d0: 6f6e 2c20 7468 6520 736f 7572 6365 2063  on, the source c
│ │ │ │ │ -000124e0: 6f64 6520 6469 7374 7269 6275 7465 6420  ode distributed 
│ │ │ │ │ -000124f0: 6e65 6564 0a20 2020 2020 6e6f 7420 696e  need.     not in
│ │ │ │ │ -00012500: 636c 7564 6520 616e 7974 6869 6e67 2074  clude anything t
│ │ │ │ │ -00012510: 6861 7420 6973 206e 6f72 6d61 6c6c 7920  hat is normally 
│ │ │ │ │ -00012520: 6469 7374 7269 6275 7465 6420 2869 6e20  distributed (in 
│ │ │ │ │ -00012530: 6569 7468 6572 2073 6f75 7263 650a 2020  either source.  
│ │ │ │ │ -00012540: 2020 206f 7220 6269 6e61 7279 2066 6f72     or binary for
│ │ │ │ │ -00012550: 6d29 2077 6974 6820 7468 6520 6d61 6a6f  m) with the majo
│ │ │ │ │ -00012560: 7220 636f 6d70 6f6e 656e 7473 2028 636f  r components (co
│ │ │ │ │ -00012570: 6d70 696c 6572 2c20 6b65 726e 656c 2c20  mpiler, kernel, 
│ │ │ │ │ -00012580: 616e 6420 736f 0a20 2020 2020 6f6e 2920  and so.     on) 
│ │ │ │ │ -00012590: 6f66 2074 6865 206f 7065 7261 7469 6e67  of the operating
│ │ │ │ │ -000125a0: 2073 7973 7465 6d20 6f6e 2077 6869 6368   system on which
│ │ │ │ │ -000125b0: 2074 6865 2065 7865 6375 7461 626c 6520   the executable 
│ │ │ │ │ -000125c0: 7275 6e73 2c20 756e 6c65 7373 0a20 2020  runs, unless.   
│ │ │ │ │ -000125d0: 2020 7468 6174 2063 6f6d 706f 6e65 6e74    that component
│ │ │ │ │ -000125e0: 2069 7473 656c 6620 6163 636f 6d70 616e   itself accompan
│ │ │ │ │ -000125f0: 6965 7320 7468 6520 6578 6563 7574 6162  ies the executab
│ │ │ │ │ -00012600: 6c65 2e0a 0a20 2020 2020 4966 2064 6973  le...     If dis
│ │ │ │ │ -00012610: 7472 6962 7574 696f 6e20 6f66 2065 7865  tribution of exe
│ │ │ │ │ -00012620: 6375 7461 626c 6520 6f72 206f 626a 6563  cutable or objec
│ │ │ │ │ -00012630: 7420 636f 6465 2069 7320 6d61 6465 2062  t code is made b
│ │ │ │ │ -00012640: 7920 6f66 6665 7269 6e67 0a20 2020 2020  y offering.     
│ │ │ │ │ -00012650: 6163 6365 7373 2074 6f20 636f 7079 2066  access to copy f
│ │ │ │ │ -00012660: 726f 6d20 6120 6465 7369 676e 6174 6564  rom a designated
│ │ │ │ │ -00012670: 2070 6c61 6365 2c20 7468 656e 206f 6666   place, then off
│ │ │ │ │ -00012680: 6572 696e 6720 6571 7569 7661 6c65 6e74  ering equivalent
│ │ │ │ │ -00012690: 0a20 2020 2020 6163 6365 7373 2074 6f20  .     access to 
│ │ │ │ │ -000126a0: 636f 7079 2074 6865 2073 6f75 7263 6520  copy the source 
│ │ │ │ │ -000126b0: 636f 6465 2066 726f 6d20 7468 6520 7361  code from the sa
│ │ │ │ │ -000126c0: 6d65 2070 6c61 6365 2063 6f75 6e74 7320  me place counts 
│ │ │ │ │ -000126d0: 6173 0a20 2020 2020 6469 7374 7269 6275  as.     distribu
│ │ │ │ │ -000126e0: 7469 6f6e 206f 6620 7468 6520 736f 7572  tion of the sour
│ │ │ │ │ -000126f0: 6365 2063 6f64 652c 2065 7665 6e20 7468  ce code, even th
│ │ │ │ │ -00012700: 6f75 6768 2074 6869 7264 2070 6172 7469  ough third parti
│ │ │ │ │ -00012710: 6573 2061 7265 206e 6f74 0a20 2020 2020  es are not.     
│ │ │ │ │ -00012720: 636f 6d70 656c 6c65 6420 746f 2063 6f70  compelled to cop
│ │ │ │ │ -00012730: 7920 7468 6520 736f 7572 6365 2061 6c6f  y the source alo
│ │ │ │ │ -00012740: 6e67 2077 6974 6820 7468 6520 6f62 6a65  ng with the obje
│ │ │ │ │ -00012750: 6374 2063 6f64 652e 0a0a 2020 342e 2059  ct code...  4. Y
│ │ │ │ │ -00012760: 6f75 206d 6179 206e 6f74 2063 6f70 792c  ou may not copy,
│ │ │ │ │ -00012770: 206d 6f64 6966 792c 2073 7562 6c69 6365   modify, sublice
│ │ │ │ │ -00012780: 6e73 652c 206f 7220 6469 7374 7269 6275  nse, or distribu
│ │ │ │ │ -00012790: 7465 2074 6865 2050 726f 6772 616d 0a20  te the Program. 
│ │ │ │ │ -000127a0: 2020 2020 6578 6365 7074 2061 7320 6578      except as ex
│ │ │ │ │ -000127b0: 7072 6573 736c 7920 7072 6f76 6964 6564  pressly provided
│ │ │ │ │ -000127c0: 2075 6e64 6572 2074 6869 7320 4c69 6365   under this Lice
│ │ │ │ │ -000127d0: 6e73 652e 2020 416e 7920 6174 7465 6d70  nse.  Any attemp
│ │ │ │ │ -000127e0: 740a 2020 2020 206f 7468 6572 7769 7365  t.     otherwise
│ │ │ │ │ -000127f0: 2074 6f20 636f 7079 2c20 6d6f 6469 6679   to copy, modify
│ │ │ │ │ -00012800: 2c20 7375 626c 6963 656e 7365 206f 7220  , sublicense or 
│ │ │ │ │ -00012810: 6469 7374 7269 6275 7465 2074 6865 2050  distribute the P
│ │ │ │ │ -00012820: 726f 6772 616d 2069 730a 2020 2020 2076  rogram is.     v
│ │ │ │ │ -00012830: 6f69 642c 2061 6e64 2077 696c 6c20 6175  oid, and will au
│ │ │ │ │ -00012840: 746f 6d61 7469 6361 6c6c 7920 7465 726d  tomatically term
│ │ │ │ │ -00012850: 696e 6174 6520 796f 7572 2072 6967 6874  inate your right
│ │ │ │ │ -00012860: 7320 756e 6465 7220 7468 6973 0a20 2020  s under this.   
│ │ │ │ │ -00012870: 2020 4c69 6365 6e73 652e 2020 486f 7765    License.  Howe
│ │ │ │ │ -00012880: 7665 722c 2070 6172 7469 6573 2077 686f  ver, parties who
│ │ │ │ │ -00012890: 2068 6176 6520 7265 6365 6976 6564 2063   have received c
│ │ │ │ │ -000128a0: 6f70 6965 732c 206f 7220 7269 6768 7473  opies, or rights
│ │ │ │ │ -000128b0: 2c0a 2020 2020 2066 726f 6d20 796f 7520  ,.     from you 
│ │ │ │ │ -000128c0: 756e 6465 7220 7468 6973 204c 6963 656e  under this Licen
│ │ │ │ │ -000128d0: 7365 2077 696c 6c20 6e6f 7420 6861 7665  se will not have
│ │ │ │ │ -000128e0: 2074 6865 6972 206c 6963 656e 7365 7320   their licenses 
│ │ │ │ │ -000128f0: 7465 726d 696e 6174 6564 0a20 2020 2020  terminated.     
│ │ │ │ │ -00012900: 736f 206c 6f6e 6720 6173 2073 7563 6820  so long as such 
│ │ │ │ │ -00012910: 7061 7274 6965 7320 7265 6d61 696e 2069  parties remain i
│ │ │ │ │ -00012920: 6e20 6675 6c6c 2063 6f6d 706c 6961 6e63  n full complianc
│ │ │ │ │ -00012930: 652e 0a0a 2020 352e 2059 6f75 2061 7265  e...  5. You are
│ │ │ │ │ -00012940: 206e 6f74 2072 6571 7569 7265 6420 746f   not required to
│ │ │ │ │ -00012950: 2061 6363 6570 7420 7468 6973 204c 6963   accept this Lic
│ │ │ │ │ -00012960: 656e 7365 2c20 7369 6e63 6520 796f 7520  ense, since you 
│ │ │ │ │ -00012970: 6861 7665 206e 6f74 0a20 2020 2020 7369  have not.     si
│ │ │ │ │ -00012980: 676e 6564 2069 742e 2020 486f 7765 7665  gned it.  Howeve
│ │ │ │ │ -00012990: 722c 206e 6f74 6869 6e67 2065 6c73 6520  r, nothing else 
│ │ │ │ │ -000129a0: 6772 616e 7473 2079 6f75 2070 6572 6d69  grants you permi
│ │ │ │ │ -000129b0: 7373 696f 6e20 746f 206d 6f64 6966 790a  ssion to modify.
│ │ │ │ │ -000129c0: 2020 2020 206f 7220 6469 7374 7269 6275       or distribu
│ │ │ │ │ -000129d0: 7465 2074 6865 2050 726f 6772 616d 206f  te the Program o
│ │ │ │ │ -000129e0: 7220 6974 7320 6465 7269 7661 7469 7665  r its derivative
│ │ │ │ │ -000129f0: 2077 6f72 6b73 2e20 2054 6865 7365 2061   works.  These a
│ │ │ │ │ -00012a00: 6374 696f 6e73 0a20 2020 2020 6172 6520  ctions.     are 
│ │ │ │ │ -00012a10: 7072 6f68 6962 6974 6564 2062 7920 6c61  prohibited by la
│ │ │ │ │ -00012a20: 7720 6966 2079 6f75 2064 6f20 6e6f 7420  w if you do not 
│ │ │ │ │ -00012a30: 6163 6365 7074 2074 6869 7320 4c69 6365  accept this Lice
│ │ │ │ │ -00012a40: 6e73 652e 0a20 2020 2020 5468 6572 6566  nse..     Theref
│ │ │ │ │ -00012a50: 6f72 652c 2062 7920 6d6f 6469 6679 696e  ore, by modifyin
│ │ │ │ │ -00012a60: 6720 6f72 2064 6973 7472 6962 7574 696e  g or distributin
│ │ │ │ │ -00012a70: 6720 7468 6520 5072 6f67 7261 6d20 286f  g the Program (o
│ │ │ │ │ -00012a80: 7220 616e 7920 776f 726b 0a20 2020 2020  r any work.     
│ │ │ │ │ -00012a90: 6261 7365 6420 6f6e 2074 6865 2050 726f  based on the Pro
│ │ │ │ │ -00012aa0: 6772 616d 292c 2079 6f75 2069 6e64 6963  gram), you indic
│ │ │ │ │ -00012ab0: 6174 6520 796f 7572 2061 6363 6570 7461  ate your accepta
│ │ │ │ │ -00012ac0: 6e63 6520 6f66 2074 6869 7320 4c69 6365  nce of this Lice
│ │ │ │ │ -00012ad0: 6e73 650a 2020 2020 2074 6f20 646f 2073  nse.     to do s
│ │ │ │ │ -00012ae0: 6f2c 2061 6e64 2061 6c6c 2069 7473 2074  o, and all its t
│ │ │ │ │ -00012af0: 6572 6d73 2061 6e64 2063 6f6e 6469 7469  erms and conditi
│ │ │ │ │ -00012b00: 6f6e 7320 666f 7220 636f 7079 696e 672c  ons for copying,
│ │ │ │ │ -00012b10: 0a20 2020 2020 6469 7374 7269 6275 7469  .     distributi
│ │ │ │ │ -00012b20: 6e67 206f 7220 6d6f 6469 6679 696e 6720  ng or modifying 
│ │ │ │ │ -00012b30: 7468 6520 5072 6f67 7261 6d20 6f72 2077  the Program or w
│ │ │ │ │ -00012b40: 6f72 6b73 2062 6173 6564 206f 6e20 6974  orks based on it
│ │ │ │ │ -00012b50: 2e0a 0a20 2036 2e20 4561 6368 2074 696d  ...  6. Each tim
│ │ │ │ │ -00012b60: 6520 796f 7520 7265 6469 7374 7269 6275  e you redistribu
│ │ │ │ │ -00012b70: 7465 2074 6865 2050 726f 6772 616d 2028  te the Program (
│ │ │ │ │ -00012b80: 6f72 2061 6e79 2077 6f72 6b20 6261 7365  or any work base
│ │ │ │ │ -00012b90: 6420 6f6e 2074 6865 0a20 2020 2020 5072  d on the.     Pr
│ │ │ │ │ -00012ba0: 6f67 7261 6d29 2c20 7468 6520 7265 6369  ogram), the reci
│ │ │ │ │ -00012bb0: 7069 656e 7420 6175 746f 6d61 7469 6361  pient automatica
│ │ │ │ │ -00012bc0: 6c6c 7920 7265 6365 6976 6573 2061 206c  lly receives a l
│ │ │ │ │ -00012bd0: 6963 656e 7365 2066 726f 6d20 7468 650a  icense from the.
│ │ │ │ │ -00012be0: 2020 2020 206f 7269 6769 6e61 6c20 6c69       original li
│ │ │ │ │ -00012bf0: 6365 6e73 6f72 2074 6f20 636f 7079 2c20  censor to copy, 
│ │ │ │ │ -00012c00: 6469 7374 7269 6275 7465 206f 7220 6d6f  distribute or mo
│ │ │ │ │ -00012c10: 6469 6679 2074 6865 2050 726f 6772 616d  dify the Program
│ │ │ │ │ -00012c20: 2073 7562 6a65 6374 0a20 2020 2020 746f   subject.     to
│ │ │ │ │ -00012c30: 2074 6865 7365 2074 6572 6d73 2061 6e64   these terms and
│ │ │ │ │ -00012c40: 2063 6f6e 6469 7469 6f6e 732e 2020 596f   conditions.  Yo
│ │ │ │ │ -00012c50: 7520 6d61 7920 6e6f 7420 696d 706f 7365  u may not impose
│ │ │ │ │ -00012c60: 2061 6e79 2066 7572 7468 6572 0a20 2020   any further.   
│ │ │ │ │ -00012c70: 2020 7265 7374 7269 6374 696f 6e73 206f    restrictions o
│ │ │ │ │ -00012c80: 6e20 7468 6520 7265 6369 7069 656e 7473  n the recipients
│ │ │ │ │ -00012c90: 2720 6578 6572 6369 7365 206f 6620 7468  ' exercise of th
│ │ │ │ │ -00012ca0: 6520 7269 6768 7473 2067 7261 6e74 6564  e rights granted
│ │ │ │ │ -00012cb0: 0a20 2020 2020 6865 7265 696e 2e20 2059  .     herein.  Y
│ │ │ │ │ -00012cc0: 6f75 2061 7265 206e 6f74 2072 6573 706f  ou are not respo
│ │ │ │ │ -00012cd0: 6e73 6962 6c65 2066 6f72 2065 6e66 6f72  nsible for enfor
│ │ │ │ │ -00012ce0: 6369 6e67 2063 6f6d 706c 6961 6e63 6520  cing compliance 
│ │ │ │ │ -00012cf0: 6279 2074 6869 7264 0a20 2020 2020 7061  by third.     pa
│ │ │ │ │ -00012d00: 7274 6965 7320 746f 2074 6869 7320 4c69  rties to this Li
│ │ │ │ │ -00012d10: 6365 6e73 652e 0a0a 2020 372e 2049 662c  cense...  7. If,
│ │ │ │ │ -00012d20: 2061 7320 6120 636f 6e73 6571 7565 6e63   as a consequenc
│ │ │ │ │ -00012d30: 6520 6f66 2061 2063 6f75 7274 206a 7564  e of a court jud
│ │ │ │ │ -00012d40: 676d 656e 7420 6f72 2061 6c6c 6567 6174  gment or allegat
│ │ │ │ │ -00012d50: 696f 6e20 6f66 2070 6174 656e 740a 2020  ion of patent.  
│ │ │ │ │ -00012d60: 2020 2069 6e66 7269 6e67 656d 656e 7420     infringement 
│ │ │ │ │ -00012d70: 6f72 2066 6f72 2061 6e79 206f 7468 6572  or for any other
│ │ │ │ │ -00012d80: 2072 6561 736f 6e20 286e 6f74 206c 696d   reason (not lim
│ │ │ │ │ -00012d90: 6974 6564 2074 6f20 7061 7465 6e74 0a20  ited to patent. 
│ │ │ │ │ -00012da0: 2020 2020 6973 7375 6573 292c 2063 6f6e      issues), con
│ │ │ │ │ -00012db0: 6469 7469 6f6e 7320 6172 6520 696d 706f  ditions are impo
│ │ │ │ │ -00012dc0: 7365 6420 6f6e 2079 6f75 2028 7768 6574  sed on you (whet
│ │ │ │ │ -00012dd0: 6865 7220 6279 2063 6f75 7274 206f 7264  her by court ord
│ │ │ │ │ -00012de0: 6572 2c0a 2020 2020 2061 6772 6565 6d65  er,.     agreeme
│ │ │ │ │ -00012df0: 6e74 206f 7220 6f74 6865 7277 6973 6529  nt or otherwise)
│ │ │ │ │ -00012e00: 2074 6861 7420 636f 6e74 7261 6469 6374   that contradict
│ │ │ │ │ -00012e10: 2074 6865 2063 6f6e 6469 7469 6f6e 7320   the conditions 
│ │ │ │ │ -00012e20: 6f66 2074 6869 730a 2020 2020 204c 6963  of this.     Lic
│ │ │ │ │ -00012e30: 656e 7365 2c20 7468 6579 2064 6f20 6e6f  ense, they do no
│ │ │ │ │ -00012e40: 7420 6578 6375 7365 2079 6f75 2066 726f  t excuse you fro
│ │ │ │ │ -00012e50: 6d20 7468 6520 636f 6e64 6974 696f 6e73  m the conditions
│ │ │ │ │ -00012e60: 206f 6620 7468 6973 0a20 2020 2020 4c69   of this.     Li
│ │ │ │ │ -00012e70: 6365 6e73 652e 2020 4966 2079 6f75 2063  cense.  If you c
│ │ │ │ │ -00012e80: 616e 6e6f 7420 6469 7374 7269 6275 7465  annot distribute
│ │ │ │ │ -00012e90: 2073 6f20 6173 2074 6f20 7361 7469 7366   so as to satisf
│ │ │ │ │ -00012ea0: 7920 7369 6d75 6c74 616e 656f 7573 6c79  y simultaneously
│ │ │ │ │ -00012eb0: 0a20 2020 2020 796f 7572 206f 626c 6967  .     your oblig
│ │ │ │ │ -00012ec0: 6174 696f 6e73 2075 6e64 6572 2074 6869  ations under thi
│ │ │ │ │ -00012ed0: 7320 4c69 6365 6e73 6520 616e 6420 616e  s License and an
│ │ │ │ │ -00012ee0: 7920 6f74 6865 7220 7065 7274 696e 656e  y other pertinen
│ │ │ │ │ -00012ef0: 740a 2020 2020 206f 626c 6967 6174 696f  t.     obligatio
│ │ │ │ │ -00012f00: 6e73 2c20 7468 656e 2061 7320 6120 636f  ns, then as a co
│ │ │ │ │ -00012f10: 6e73 6571 7565 6e63 6520 796f 7520 6d61  nsequence you ma
│ │ │ │ │ -00012f20: 7920 6e6f 7420 6469 7374 7269 6275 7465  y not distribute
│ │ │ │ │ -00012f30: 2074 6865 0a20 2020 2020 5072 6f67 7261   the.     Progra
│ │ │ │ │ -00012f40: 6d20 6174 2061 6c6c 2e20 2046 6f72 2065  m at all.  For e
│ │ │ │ │ -00012f50: 7861 6d70 6c65 2c20 6966 2061 2070 6174  xample, if a pat
│ │ │ │ │ -00012f60: 656e 7420 6c69 6365 6e73 6520 776f 756c  ent license woul
│ │ │ │ │ -00012f70: 6420 6e6f 7420 7065 726d 6974 0a20 2020  d not permit.   
│ │ │ │ │ -00012f80: 2020 726f 7961 6c74 792d 6672 6565 2072    royalty-free r
│ │ │ │ │ -00012f90: 6564 6973 7472 6962 7574 696f 6e20 6f66  edistribution of
│ │ │ │ │ -00012fa0: 2074 6865 2050 726f 6772 616d 2062 7920   the Program by 
│ │ │ │ │ -00012fb0: 616c 6c20 7468 6f73 6520 7768 6f20 7265  all those who re
│ │ │ │ │ -00012fc0: 6365 6976 650a 2020 2020 2063 6f70 6965  ceive.     copie
│ │ │ │ │ -00012fd0: 7320 6469 7265 6374 6c79 206f 7220 696e  s directly or in
│ │ │ │ │ -00012fe0: 6469 7265 6374 6c79 2074 6872 6f75 6768  directly through
│ │ │ │ │ -00012ff0: 2079 6f75 2c20 7468 656e 2074 6865 206f   you, then the o
│ │ │ │ │ -00013000: 6e6c 7920 7761 7920 796f 750a 2020 2020  nly way you.    
│ │ │ │ │ -00013010: 2063 6f75 6c64 2073 6174 6973 6679 2062   could satisfy b
│ │ │ │ │ -00013020: 6f74 6820 6974 2061 6e64 2074 6869 7320  oth it and this 
│ │ │ │ │ -00013030: 4c69 6365 6e73 6520 776f 756c 6420 6265  License would be
│ │ │ │ │ -00013040: 2074 6f20 7265 6672 6169 6e20 656e 7469   to refrain enti
│ │ │ │ │ -00013050: 7265 6c79 0a20 2020 2020 6672 6f6d 2064  rely.     from d
│ │ │ │ │ -00013060: 6973 7472 6962 7574 696f 6e20 6f66 2074  istribution of t
│ │ │ │ │ -00013070: 6865 2050 726f 6772 616d 2e0a 0a20 2020  he Program...   
│ │ │ │ │ -00013080: 2020 4966 2061 6e79 2070 6f72 7469 6f6e    If any portion
│ │ │ │ │ -00013090: 206f 6620 7468 6973 2073 6563 7469 6f6e   of this section
│ │ │ │ │ -000130a0: 2069 7320 6865 6c64 2069 6e76 616c 6964   is held invalid
│ │ │ │ │ -000130b0: 206f 7220 756e 656e 666f 7263 6561 626c   or unenforceabl
│ │ │ │ │ -000130c0: 650a 2020 2020 2075 6e64 6572 2061 6e79  e.     under any
│ │ │ │ │ -000130d0: 2070 6172 7469 6375 6c61 7220 6369 7263   particular circ
│ │ │ │ │ -000130e0: 756d 7374 616e 6365 2c20 7468 6520 6261  umstance, the ba
│ │ │ │ │ -000130f0: 6c61 6e63 6520 6f66 2074 6865 2073 6563  lance of the sec
│ │ │ │ │ -00013100: 7469 6f6e 2069 730a 2020 2020 2069 6e74  tion is.     int
│ │ │ │ │ -00013110: 656e 6465 6420 746f 2061 7070 6c79 2061  ended to apply a
│ │ │ │ │ -00013120: 6e64 2074 6865 2073 6563 7469 6f6e 2061  nd the section a
│ │ │ │ │ -00013130: 7320 6120 7768 6f6c 6520 6973 2069 6e74  s a whole is int
│ │ │ │ │ -00013140: 656e 6465 6420 746f 2061 7070 6c79 0a20  ended to apply. 
│ │ │ │ │ -00013150: 2020 2020 696e 206f 7468 6572 2063 6972      in other cir
│ │ │ │ │ -00013160: 6375 6d73 7461 6e63 6573 2e0a 0a20 2020  cumstances...   
│ │ │ │ │ -00013170: 2020 4974 2069 7320 6e6f 7420 7468 6520    It is not the 
│ │ │ │ │ -00013180: 7075 7270 6f73 6520 6f66 2074 6869 7320  purpose of this 
│ │ │ │ │ -00013190: 7365 6374 696f 6e20 746f 2069 6e64 7563  section to induc
│ │ │ │ │ -000131a0: 6520 796f 7520 746f 2069 6e66 7269 6e67  e you to infring
│ │ │ │ │ -000131b0: 6520 616e 790a 2020 2020 2070 6174 656e  e any.     paten
│ │ │ │ │ -000131c0: 7473 206f 7220 6f74 6865 7220 7072 6f70  ts or other prop
│ │ │ │ │ -000131d0: 6572 7479 2072 6967 6874 2063 6c61 696d  erty right claim
│ │ │ │ │ -000131e0: 7320 6f72 2074 6f20 636f 6e74 6573 7420  s or to contest 
│ │ │ │ │ -000131f0: 7661 6c69 6469 7479 206f 660a 2020 2020  validity of.    
│ │ │ │ │ -00013200: 2061 6e79 2073 7563 6820 636c 6169 6d73   any such claims
│ │ │ │ │ -00013210: 3b20 7468 6973 2073 6563 7469 6f6e 2068  ; this section h
│ │ │ │ │ -00013220: 6173 2074 6865 2073 6f6c 6520 7075 7270  as the sole purp
│ │ │ │ │ -00013230: 6f73 6520 6f66 2070 726f 7465 6374 696e  ose of protectin
│ │ │ │ │ -00013240: 670a 2020 2020 2074 6865 2069 6e74 6567  g.     the integ
│ │ │ │ │ -00013250: 7269 7479 206f 6620 7468 6520 6672 6565  rity of the free
│ │ │ │ │ -00013260: 2073 6f66 7477 6172 6520 6469 7374 7269   software distri
│ │ │ │ │ -00013270: 6275 7469 6f6e 2073 7973 7465 6d2c 2077  bution system, w
│ │ │ │ │ -00013280: 6869 6368 2069 730a 2020 2020 2069 6d70  hich is.     imp
│ │ │ │ │ -00013290: 6c65 6d65 6e74 6564 2062 7920 7075 626c  lemented by publ
│ │ │ │ │ -000132a0: 6963 206c 6963 656e 7365 2070 7261 6374  ic license pract
│ │ │ │ │ -000132b0: 6963 6573 2e20 204d 616e 7920 7065 6f70  ices.  Many peop
│ │ │ │ │ -000132c0: 6c65 2068 6176 6520 6d61 6465 0a20 2020  le have made.   
│ │ │ │ │ -000132d0: 2020 6765 6e65 726f 7573 2063 6f6e 7472    generous contr
│ │ │ │ │ -000132e0: 6962 7574 696f 6e73 2074 6f20 7468 6520  ibutions to the 
│ │ │ │ │ -000132f0: 7769 6465 2072 616e 6765 206f 6620 736f  wide range of so
│ │ │ │ │ -00013300: 6674 7761 7265 2064 6973 7472 6962 7574  ftware distribut
│ │ │ │ │ -00013310: 6564 0a20 2020 2020 7468 726f 7567 6820  ed.     through 
│ │ │ │ │ -00013320: 7468 6174 2073 7973 7465 6d20 696e 2072  that system in r
│ │ │ │ │ -00013330: 656c 6961 6e63 6520 6f6e 2063 6f6e 7369  eliance on consi
│ │ │ │ │ -00013340: 7374 656e 7420 6170 706c 6963 6174 696f  stent applicatio
│ │ │ │ │ -00013350: 6e20 6f66 2074 6861 740a 2020 2020 2073  n of that.     s
│ │ │ │ │ -00013360: 7973 7465 6d3b 2069 7420 6973 2075 7020  ystem; it is up 
│ │ │ │ │ -00013370: 746f 2074 6865 2061 7574 686f 722f 646f  to the author/do
│ │ │ │ │ -00013380: 6e6f 7220 746f 2064 6563 6964 6520 6966  nor to decide if
│ │ │ │ │ -00013390: 2068 6520 6f72 2073 6865 2069 730a 2020   he or she is.  
│ │ │ │ │ -000133a0: 2020 2077 696c 6c69 6e67 2074 6f20 6469     willing to di
│ │ │ │ │ -000133b0: 7374 7269 6275 7465 2073 6f66 7477 6172  stribute softwar
│ │ │ │ │ -000133c0: 6520 7468 726f 7567 6820 616e 7920 6f74  e through any ot
│ │ │ │ │ -000133d0: 6865 7220 7379 7374 656d 2061 6e64 2061  her system and a
│ │ │ │ │ -000133e0: 0a20 2020 2020 6c69 6365 6e73 6565 2063  .     licensee c
│ │ │ │ │ -000133f0: 616e 6e6f 7420 696d 706f 7365 2074 6861  annot impose tha
│ │ │ │ │ -00013400: 7420 6368 6f69 6365 2e0a 0a20 2020 2020  t choice...     
│ │ │ │ │ -00013410: 5468 6973 2073 6563 7469 6f6e 2069 7320  This section is 
│ │ │ │ │ -00013420: 696e 7465 6e64 6564 2074 6f20 6d61 6b65  intended to make
│ │ │ │ │ -00013430: 2074 686f 726f 7567 686c 7920 636c 6561   thoroughly clea
│ │ │ │ │ -00013440: 7220 7768 6174 2069 7320 6265 6c69 6576  r what is believ
│ │ │ │ │ -00013450: 6564 0a20 2020 2020 746f 2062 6520 6120  ed.     to be a 
│ │ │ │ │ -00013460: 636f 6e73 6571 7565 6e63 6520 6f66 2074  consequence of t
│ │ │ │ │ -00013470: 6865 2072 6573 7420 6f66 2074 6869 7320  he rest of this 
│ │ │ │ │ -00013480: 4c69 6365 6e73 652e 0a0a 2020 382e 2049  License...  8. I
│ │ │ │ │ -00013490: 6620 7468 6520 6469 7374 7269 6275 7469  f the distributi
│ │ │ │ │ -000134a0: 6f6e 2061 6e64 2f6f 7220 7573 6520 6f66  on and/or use of
│ │ │ │ │ -000134b0: 2074 6865 2050 726f 6772 616d 2069 7320   the Program is 
│ │ │ │ │ -000134c0: 7265 7374 7269 6374 6564 2069 6e0a 2020  restricted in.  
│ │ │ │ │ -000134d0: 2020 2063 6572 7461 696e 2063 6f75 6e74     certain count
│ │ │ │ │ -000134e0: 7269 6573 2065 6974 6865 7220 6279 2070  ries either by p
│ │ │ │ │ -000134f0: 6174 656e 7473 206f 7220 6279 2063 6f70  atents or by cop
│ │ │ │ │ -00013500: 7972 6967 6874 6564 2069 6e74 6572 6661  yrighted interfa
│ │ │ │ │ -00013510: 6365 732c 0a20 2020 2020 7468 6520 6f72  ces,.     the or
│ │ │ │ │ -00013520: 6967 696e 616c 2063 6f70 7972 6967 6874  iginal copyright
│ │ │ │ │ -00013530: 2068 6f6c 6465 7220 7768 6f20 706c 6163   holder who plac
│ │ │ │ │ -00013540: 6573 2074 6865 2050 726f 6772 616d 2075  es the Program u
│ │ │ │ │ -00013550: 6e64 6572 2074 6869 730a 2020 2020 204c  nder this.     L
│ │ │ │ │ -00013560: 6963 656e 7365 206d 6179 2061 6464 2061  icense may add a
│ │ │ │ │ -00013570: 6e20 6578 706c 6963 6974 2067 656f 6772  n explicit geogr
│ │ │ │ │ -00013580: 6170 6869 6361 6c20 6469 7374 7269 6275  aphical distribu
│ │ │ │ │ -00013590: 7469 6f6e 206c 696d 6974 6174 696f 6e0a  tion limitation.
│ │ │ │ │ -000135a0: 2020 2020 2065 7863 6c75 6469 6e67 2074       excluding t
│ │ │ │ │ -000135b0: 686f 7365 2063 6f75 6e74 7269 6573 2c20  hose countries, 
│ │ │ │ │ -000135c0: 736f 2074 6861 7420 6469 7374 7269 6275  so that distribu
│ │ │ │ │ -000135d0: 7469 6f6e 2069 7320 7065 726d 6974 7465  tion is permitte
│ │ │ │ │ -000135e0: 6420 6f6e 6c79 0a20 2020 2020 696e 206f  d only.     in o
│ │ │ │ │ -000135f0: 7220 616d 6f6e 6720 636f 756e 7472 6965  r among countrie
│ │ │ │ │ -00013600: 7320 6e6f 7420 7468 7573 2065 7863 6c75  s not thus exclu
│ │ │ │ │ -00013610: 6465 642e 2020 496e 2073 7563 6820 6361  ded.  In such ca
│ │ │ │ │ -00013620: 7365 2c20 7468 6973 0a20 2020 2020 4c69  se, this.     Li
│ │ │ │ │ -00013630: 6365 6e73 6520 696e 636f 7270 6f72 6174  cense incorporat
│ │ │ │ │ -00013640: 6573 2074 6865 206c 696d 6974 6174 696f  es the limitatio
│ │ │ │ │ -00013650: 6e20 6173 2069 6620 7772 6974 7465 6e20  n as if written 
│ │ │ │ │ -00013660: 696e 2074 6865 2062 6f64 7920 6f66 0a20  in the body of. 
│ │ │ │ │ -00013670: 2020 2020 7468 6973 204c 6963 656e 7365      this License
│ │ │ │ │ -00013680: 2e0a 0a20 2039 2e20 5468 6520 4672 6565  ...  9. The Free
│ │ │ │ │ -00013690: 2053 6f66 7477 6172 6520 466f 756e 6461   Software Founda
│ │ │ │ │ -000136a0: 7469 6f6e 206d 6179 2070 7562 6c69 7368  tion may publish
│ │ │ │ │ -000136b0: 2072 6576 6973 6564 2061 6e64 2f6f 7220   revised and/or 
│ │ │ │ │ -000136c0: 6e65 770a 2020 2020 2076 6572 7369 6f6e  new.     version
│ │ │ │ │ -000136d0: 7320 6f66 2074 6865 2047 656e 6572 616c  s of the General
│ │ │ │ │ -000136e0: 2050 7562 6c69 6320 4c69 6365 6e73 6520   Public License 
│ │ │ │ │ -000136f0: 6672 6f6d 2074 696d 6520 746f 2074 696d  from time to tim
│ │ │ │ │ -00013700: 652e 2020 5375 6368 206e 6577 0a20 2020  e.  Such new.   
│ │ │ │ │ -00013710: 2020 7665 7273 696f 6e73 2077 696c 6c20    versions will 
│ │ │ │ │ -00013720: 6265 2073 696d 696c 6172 2069 6e20 7370  be similar in sp
│ │ │ │ │ -00013730: 6972 6974 2074 6f20 7468 6520 7072 6573  irit to the pres
│ │ │ │ │ -00013740: 656e 7420 7665 7273 696f 6e2c 2062 7574  ent version, but
│ │ │ │ │ -00013750: 206d 6179 0a20 2020 2020 6469 6666 6572   may.     differ
│ │ │ │ │ -00013760: 2069 6e20 6465 7461 696c 2074 6f20 6164   in detail to ad
│ │ │ │ │ -00013770: 6472 6573 7320 6e65 7720 7072 6f62 6c65  dress new proble
│ │ │ │ │ -00013780: 6d73 206f 7220 636f 6e63 6572 6e73 2e0a  ms or concerns..
│ │ │ │ │ -00013790: 0a20 2020 2020 4561 6368 2076 6572 7369  .     Each versi
│ │ │ │ │ -000137a0: 6f6e 2069 7320 6769 7665 6e20 6120 6469  on is given a di
│ │ │ │ │ -000137b0: 7374 696e 6775 6973 6869 6e67 2076 6572  stinguishing ver
│ │ │ │ │ -000137c0: 7369 6f6e 206e 756d 6265 722e 2020 4966  sion number.  If
│ │ │ │ │ -000137d0: 2074 6865 0a20 2020 2020 5072 6f67 7261   the.     Progra
│ │ │ │ │ -000137e0: 6d20 7370 6563 6966 6965 7320 6120 7665  m specifies a ve
│ │ │ │ │ -000137f0: 7273 696f 6e20 6e75 6d62 6572 206f 6620  rsion number of 
│ │ │ │ │ -00013800: 7468 6973 204c 6963 656e 7365 2077 6869  this License whi
│ │ │ │ │ -00013810: 6368 2061 7070 6c69 6573 2074 6f0a 2020  ch applies to.  
│ │ │ │ │ -00013820: 2020 2069 7420 616e 6420 2261 6e79 206c     it and "any l
│ │ │ │ │ -00013830: 6174 6572 2076 6572 7369 6f6e 222c 2079  ater version", y
│ │ │ │ │ -00013840: 6f75 2068 6176 6520 7468 6520 6f70 7469  ou have the opti
│ │ │ │ │ -00013850: 6f6e 206f 6620 666f 6c6c 6f77 696e 6720  on of following 
│ │ │ │ │ -00013860: 7468 650a 2020 2020 2074 6572 6d73 2061  the.     terms a
│ │ │ │ │ -00013870: 6e64 2063 6f6e 6469 7469 6f6e 7320 6569  nd conditions ei
│ │ │ │ │ -00013880: 7468 6572 206f 6620 7468 6174 2076 6572  ther of that ver
│ │ │ │ │ -00013890: 7369 6f6e 206f 7220 6f66 2061 6e79 206c  sion or of any l
│ │ │ │ │ -000138a0: 6174 6572 2076 6572 7369 6f6e 0a20 2020  ater version.   
│ │ │ │ │ -000138b0: 2020 7075 626c 6973 6865 6420 6279 2074    published by t
│ │ │ │ │ -000138c0: 6865 2046 7265 6520 536f 6674 7761 7265  he Free Software
│ │ │ │ │ -000138d0: 2046 6f75 6e64 6174 696f 6e2e 2020 4966   Foundation.  If
│ │ │ │ │ -000138e0: 2074 6865 2050 726f 6772 616d 2064 6f65   the Program doe
│ │ │ │ │ -000138f0: 7320 6e6f 740a 2020 2020 2073 7065 6369  s not.     speci
│ │ │ │ │ -00013900: 6679 2061 2076 6572 7369 6f6e 206e 756d  fy a version num
│ │ │ │ │ -00013910: 6265 7220 6f66 2074 6869 7320 4c69 6365  ber of this Lice
│ │ │ │ │ -00013920: 6e73 652c 2079 6f75 206d 6179 2063 686f  nse, you may cho
│ │ │ │ │ -00013930: 6f73 6520 616e 790a 2020 2020 2076 6572  ose any.     ver
│ │ │ │ │ -00013940: 7369 6f6e 2065 7665 7220 7075 626c 6973  sion ever publis
│ │ │ │ │ -00013950: 6865 6420 6279 2074 6865 2046 7265 6520  hed by the Free 
│ │ │ │ │ -00013960: 536f 6674 7761 7265 2046 6f75 6e64 6174  Software Foundat
│ │ │ │ │ -00013970: 696f 6e2e 0a0a 2020 3130 2e20 4966 2079  ion...  10. If y
│ │ │ │ │ -00013980: 6f75 2077 6973 6820 746f 2069 6e63 6f72  ou wish to incor
│ │ │ │ │ -00013990: 706f 7261 7465 2070 6172 7473 206f 6620  porate parts of 
│ │ │ │ │ -000139a0: 7468 6520 5072 6f67 7261 6d20 696e 746f  the Program into
│ │ │ │ │ -000139b0: 206f 7468 6572 2066 7265 650a 2020 2020   other free.    
│ │ │ │ │ -000139c0: 2070 726f 6772 616d 7320 7768 6f73 6520   programs whose 
│ │ │ │ │ -000139d0: 6469 7374 7269 6275 7469 6f6e 2063 6f6e  distribution con
│ │ │ │ │ -000139e0: 6469 7469 6f6e 7320 6172 6520 6469 6666  ditions are diff
│ │ │ │ │ -000139f0: 6572 656e 742c 2077 7269 7465 2074 6f20  erent, write to 
│ │ │ │ │ -00013a00: 7468 650a 2020 2020 2061 7574 686f 7220  the.     author 
│ │ │ │ │ -00013a10: 746f 2061 736b 2066 6f72 2070 6572 6d69  to ask for permi
│ │ │ │ │ -00013a20: 7373 696f 6e2e 2020 466f 7220 736f 6674  ssion.  For soft
│ │ │ │ │ -00013a30: 7761 7265 2077 6869 6368 2069 7320 636f  ware which is co
│ │ │ │ │ -00013a40: 7079 7269 6768 7465 6420 6279 0a20 2020  pyrighted by.   
│ │ │ │ │ -00013a50: 2020 7468 6520 4672 6565 2053 6f66 7477    the Free Softw
│ │ │ │ │ -00013a60: 6172 6520 466f 756e 6461 7469 6f6e 2c20  are Foundation, 
│ │ │ │ │ -00013a70: 7772 6974 6520 746f 2074 6865 2046 7265  write to the Fre
│ │ │ │ │ -00013a80: 6520 536f 6674 7761 7265 0a20 2020 2020  e Software.     
│ │ │ │ │ -00013a90: 466f 756e 6461 7469 6f6e 3b20 7765 2073  Foundation; we s
│ │ │ │ │ -00013aa0: 6f6d 6574 696d 6573 206d 616b 6520 6578  ometimes make ex
│ │ │ │ │ -00013ab0: 6365 7074 696f 6e73 2066 6f72 2074 6869  ceptions for thi
│ │ │ │ │ -00013ac0: 732e 2020 4f75 7220 6465 6369 7369 6f6e  s.  Our decision
│ │ │ │ │ -00013ad0: 0a20 2020 2020 7769 6c6c 2062 6520 6775  .     will be gu
│ │ │ │ │ -00013ae0: 6964 6564 2062 7920 7468 6520 7477 6f20  ided by the two 
│ │ │ │ │ -00013af0: 676f 616c 7320 6f66 2070 7265 7365 7276  goals of preserv
│ │ │ │ │ -00013b00: 696e 6720 7468 6520 6672 6565 2073 7461  ing the free sta
│ │ │ │ │ -00013b10: 7475 7320 6f66 0a20 2020 2020 616c 6c20  tus of.     all 
│ │ │ │ │ -00013b20: 6465 7269 7661 7469 7665 7320 6f66 206f  derivatives of o
│ │ │ │ │ -00013b30: 7572 2066 7265 6520 736f 6674 7761 7265  ur free software
│ │ │ │ │ -00013b40: 2061 6e64 206f 6620 7072 6f6d 6f74 696e   and of promotin
│ │ │ │ │ -00013b50: 6720 7468 6520 7368 6172 696e 670a 2020  g the sharing.  
│ │ │ │ │ -00013b60: 2020 2061 6e64 2072 6575 7365 206f 6620     and reuse of 
│ │ │ │ │ -00013b70: 736f 6674 7761 7265 2067 656e 6572 616c  software general
│ │ │ │ │ -00013b80: 6c79 2e0a 0a20 2020 2020 2020 2020 2020  ly...           
│ │ │ │ │ +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...
│ │ │ │ │ +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: 2020 204e 4f20 5741 5252 414e 5459 0a0a     NO WARRANTY..
│ │ │ │ │ -00013bb0: 2020 312e 2042 4543 4155 5345 2054 4845    1. BECAUSE THE
│ │ │ │ │ -00013bc0: 2050 524f 4752 414d 2049 5320 4c49 4345   PROGRAM IS LICE
│ │ │ │ │ -00013bd0: 4e53 4544 2046 5245 4520 4f46 2043 4841  NSED FREE OF CHA
│ │ │ │ │ -00013be0: 5247 452c 2054 4845 5245 2049 5320 4e4f  RGE, THERE IS NO
│ │ │ │ │ -00013bf0: 0a20 2020 2020 5741 5252 414e 5459 2046  .     WARRANTY F
│ │ │ │ │ -00013c00: 4f52 2054 4845 2050 524f 4752 414d 2c20  OR THE PROGRAM, 
│ │ │ │ │ -00013c10: 544f 2054 4845 2045 5854 454e 5420 5045  TO THE EXTENT PE
│ │ │ │ │ -00013c20: 524d 4954 5445 4420 4259 2041 5050 4c49  RMITTED BY APPLI
│ │ │ │ │ -00013c30: 4341 424c 450a 2020 2020 204c 4157 2e20  CABLE.     LAW. 
│ │ │ │ │ -00013c40: 4558 4345 5054 2057 4845 4e20 4f54 4845  EXCEPT WHEN OTHE
│ │ │ │ │ -00013c50: 5257 4953 4520 5354 4154 4544 2049 4e20  RWISE STATED IN 
│ │ │ │ │ -00013c60: 5752 4954 494e 4720 5448 4520 434f 5059  WRITING THE COPY
│ │ │ │ │ -00013c70: 5249 4748 5420 484f 4c44 4552 530a 2020  RIGHT HOLDERS.  
│ │ │ │ │ -00013c80: 2020 2041 4e44 2f4f 5220 4f54 4845 5220     AND/OR OTHER 
│ │ │ │ │ -00013c90: 5041 5254 4945 5320 5052 4f56 4944 4520  PARTIES PROVIDE 
│ │ │ │ │ -00013ca0: 5448 4520 5052 4f47 5241 4d20 2241 5320  THE PROGRAM "AS 
│ │ │ │ │ -00013cb0: 4953 2220 5749 5448 4f55 5420 5741 5252  IS" WITHOUT WARR
│ │ │ │ │ -00013cc0: 414e 5459 0a20 2020 2020 4f46 2041 4e59  ANTY.     OF ANY
│ │ │ │ │ -00013cd0: 204b 494e 442c 2045 4954 4845 5220 4558   KIND, EITHER EX
│ │ │ │ │ -00013ce0: 5052 4553 5345 4420 4f52 2049 4d50 4c49  PRESSED OR IMPLI
│ │ │ │ │ -00013cf0: 4544 2c20 494e 434c 5544 494e 472c 2042  ED, INCLUDING, B
│ │ │ │ │ -00013d00: 5554 204e 4f54 0a20 2020 2020 4c49 4d49  UT NOT.     LIMI
│ │ │ │ │ -00013d10: 5445 4420 544f 2c20 5448 4520 494d 504c  TED TO, THE IMPL
│ │ │ │ │ -00013d20: 4945 4420 5741 5252 414e 5449 4553 204f  IED WARRANTIES O
│ │ │ │ │ -00013d30: 4620 4d45 5243 4841 4e54 4142 494c 4954  F MERCHANTABILIT
│ │ │ │ │ -00013d40: 5920 414e 4420 4649 544e 4553 530a 2020  Y AND FITNESS.  
│ │ │ │ │ -00013d50: 2020 2046 4f52 2041 2050 4152 5449 4355     FOR A PARTICU
│ │ │ │ │ -00013d60: 4c41 5220 5055 5250 4f53 452e 2054 4845  LAR PURPOSE. THE
│ │ │ │ │ -00013d70: 2045 4e54 4952 4520 5249 534b 2041 5320   ENTIRE RISK AS 
│ │ │ │ │ -00013d80: 544f 2054 4845 2051 5541 4c49 5459 2041  TO THE QUALITY A
│ │ │ │ │ -00013d90: 4e44 0a20 2020 2020 5045 5246 4f52 4d41  ND.     PERFORMA
│ │ │ │ │ -00013da0: 4e43 4520 4f46 2054 4845 2050 524f 4752  NCE OF THE PROGR
│ │ │ │ │ -00013db0: 414d 2049 5320 5749 5448 2059 4f55 2e20  AM IS WITH YOU. 
│ │ │ │ │ -00013dc0: 5348 4f55 4c44 2054 4845 2050 524f 4752  SHOULD THE PROGR
│ │ │ │ │ -00013dd0: 414d 2050 524f 5645 0a20 2020 2020 4445  AM PROVE.     DE
│ │ │ │ │ -00013de0: 4645 4354 4956 452c 2059 4f55 2041 5353  FECTIVE, YOU ASS
│ │ │ │ │ -00013df0: 554d 4520 5448 4520 434f 5354 204f 4620  UME THE COST OF 
│ │ │ │ │ -00013e00: 414c 4c20 4e45 4345 5353 4152 5920 5345  ALL NECESSARY SE
│ │ │ │ │ -00013e10: 5256 4943 494e 472c 2052 4550 4149 520a  RVICING, REPAIR.
│ │ │ │ │ -00013e20: 2020 2020 204f 5220 434f 5252 4543 5449       OR CORRECTI
│ │ │ │ │ -00013e30: 4f4e 2e0a 0a20 2032 2e20 494e 204e 4f20  ON...  2. IN NO 
│ │ │ │ │ -00013e40: 4556 454e 5420 554e 4c45 5353 2052 4551  EVENT UNLESS REQ
│ │ │ │ │ -00013e50: 5549 5245 4420 4259 2041 5050 4c49 4341  UIRED BY APPLICA
│ │ │ │ │ -00013e60: 424c 4520 4c41 5720 4f52 2041 4752 4545  BLE LAW OR AGREE
│ │ │ │ │ -00013e70: 4420 544f 2049 4e0a 2020 2020 2057 5249  D TO IN.     WRI
│ │ │ │ │ -00013e80: 5449 4e47 2057 494c 4c20 414e 5920 434f  TING WILL ANY CO
│ │ │ │ │ -00013e90: 5059 5249 4748 5420 484f 4c44 4552 2c20  PYRIGHT HOLDER, 
│ │ │ │ │ -00013ea0: 4f52 2041 4e59 204f 5448 4552 2050 4152  OR ANY OTHER PAR
│ │ │ │ │ -00013eb0: 5459 2057 484f 204d 4159 0a20 2020 2020  TY WHO MAY.     
│ │ │ │ │ -00013ec0: 4d4f 4449 4659 2041 4e44 2f4f 5220 5245  MODIFY AND/OR RE
│ │ │ │ │ -00013ed0: 4449 5354 5249 4255 5445 2054 4845 2050  DISTRIBUTE THE P
│ │ │ │ │ -00013ee0: 524f 4752 414d 2041 5320 5045 524d 4954  ROGRAM AS PERMIT
│ │ │ │ │ -00013ef0: 5445 4420 4142 4f56 452c 2042 450a 2020  TED ABOVE, BE.  
│ │ │ │ │ -00013f00: 2020 204c 4941 424c 4520 544f 2059 4f55     LIABLE TO YOU
│ │ │ │ │ -00013f10: 2046 4f52 2044 414d 4147 4553 2c20 494e   FOR DAMAGES, IN
│ │ │ │ │ -00013f20: 434c 5544 494e 4720 414e 5920 4745 4e45  CLUDING ANY GENE
│ │ │ │ │ -00013f30: 5241 4c2c 2053 5045 4349 414c 2c0a 2020  RAL, SPECIAL,.  
│ │ │ │ │ -00013f40: 2020 2049 4e43 4944 454e 5441 4c20 4f52     INCIDENTAL OR
│ │ │ │ │ -00013f50: 2043 4f4e 5345 5155 454e 5449 414c 2044   CONSEQUENTIAL D
│ │ │ │ │ -00013f60: 414d 4147 4553 2041 5249 5349 4e47 204f  AMAGES ARISING O
│ │ │ │ │ -00013f70: 5554 204f 4620 5448 4520 5553 4520 4f52  UT OF THE USE OR
│ │ │ │ │ -00013f80: 0a20 2020 2020 494e 4142 494c 4954 5920  .     INABILITY 
│ │ │ │ │ -00013f90: 544f 2055 5345 2054 4845 2050 524f 4752  TO USE THE PROGR
│ │ │ │ │ -00013fa0: 414d 2028 494e 434c 5544 494e 4720 4255  AM (INCLUDING BU
│ │ │ │ │ -00013fb0: 5420 4e4f 5420 4c49 4d49 5445 4420 544f  T NOT LIMITED TO
│ │ │ │ │ -00013fc0: 204c 4f53 5320 4f46 0a20 2020 2020 4441   LOSS OF.     DA
│ │ │ │ │ -00013fd0: 5441 204f 5220 4441 5441 2042 4549 4e47  TA OR DATA BEING
│ │ │ │ │ -00013fe0: 2052 454e 4445 5245 4420 494e 4143 4355   RENDERED INACCU
│ │ │ │ │ -00013ff0: 5241 5445 204f 5220 4c4f 5353 4553 2053  RATE OR LOSSES S
│ │ │ │ │ -00014000: 5553 5441 494e 4544 2042 5920 594f 550a  USTAINED BY YOU.
│ │ │ │ │ -00014010: 2020 2020 204f 5220 5448 4952 4420 5041       OR THIRD PA
│ │ │ │ │ -00014020: 5254 4945 5320 4f52 2041 2046 4149 4c55  RTIES OR A FAILU
│ │ │ │ │ -00014030: 5245 204f 4620 5448 4520 5052 4f47 5241  RE OF THE PROGRA
│ │ │ │ │ -00014040: 4d20 544f 204f 5045 5241 5445 2057 4954  M TO OPERATE WIT
│ │ │ │ │ -00014050: 4820 414e 590a 2020 2020 204f 5448 4552  H ANY.     OTHER
│ │ │ │ │ -00014060: 2050 524f 4752 414d 5329 2c20 4556 454e   PROGRAMS), EVEN
│ │ │ │ │ -00014070: 2049 4620 5355 4348 2048 4f4c 4445 5220   IF SUCH HOLDER 
│ │ │ │ │ -00014080: 4f52 204f 5448 4552 2050 4152 5459 2048  OR OTHER PARTY H
│ │ │ │ │ -00014090: 4153 2042 4545 4e0a 2020 2020 2041 4456  AS BEEN.     ADV
│ │ │ │ │ -000140a0: 4953 4544 204f 4620 5448 4520 504f 5353  ISED OF THE POSS
│ │ │ │ │ -000140b0: 4942 494c 4954 5920 4f46 2053 5543 4820  IBILITY OF SUCH 
│ │ │ │ │ -000140c0: 4441 4d41 4745 532e 0a0a 2020 2020 2020  DAMAGES...      
│ │ │ │ │ -000140d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000140e0: 454e 4420 4f46 2054 4552 4d53 2041 4e44  END OF TERMS AND
│ │ │ │ │ -000140f0: 2043 4f4e 4449 5449 4f4e 530a 0a41 2e32   CONDITIONS..A.2
│ │ │ │ │ -00014100: 2041 7070 656e 6469 783a 2048 6f77 2074   Appendix: How t
│ │ │ │ │ -00014110: 6f20 4170 706c 7920 5468 6573 6520 5465  o Apply These Te
│ │ │ │ │ -00014120: 726d 7320 746f 2059 6f75 7220 4e65 7720  rms to Your New 
│ │ │ │ │ -00014130: 5072 6f67 7261 6d73 0a3d 3d3d 3d3d 3d3d  Programs.=======
│ │ │ │ │ +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.=========
│ │ │ │ │  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 3d3d 0a0a 4966 2079 6f75 2064 6576  ====..If you dev
│ │ │ │ │ -00014180: 656c 6f70 2061 206e 6577 2070 726f 6772  elop a new progr
│ │ │ │ │ -00014190: 616d 2c20 616e 6420 796f 7520 7761 6e74  am, and you want
│ │ │ │ │ -000141a0: 2069 7420 746f 2062 6520 6f66 2074 6865   it to be of the
│ │ │ │ │ -000141b0: 2067 7265 6174 6573 740a 706f 7373 6962   greatest.possib
│ │ │ │ │ -000141c0: 6c65 2075 7365 2074 6f20 7468 6520 7075  le use to the pu
│ │ │ │ │ -000141d0: 626c 6963 2c20 7468 6520 6265 7374 2077  blic, the best w
│ │ │ │ │ -000141e0: 6179 2074 6f20 6163 6869 6576 6520 7468  ay to achieve th
│ │ │ │ │ -000141f0: 6973 2069 7320 746f 206d 616b 6520 6974  is is to make it
│ │ │ │ │ -00014200: 0a66 7265 6520 736f 6674 7761 7265 2077  .free software w
│ │ │ │ │ -00014210: 6869 6368 2065 7665 7279 6f6e 6520 6361  hich everyone ca
│ │ │ │ │ -00014220: 6e20 7265 6469 7374 7269 6275 7465 2061  n redistribute a
│ │ │ │ │ -00014230: 6e64 2063 6861 6e67 6520 756e 6465 7220  nd change under 
│ │ │ │ │ -00014240: 7468 6573 650a 7465 726d 732e 0a0a 2020  these.terms...  
│ │ │ │ │ -00014250: 2054 6f20 646f 2073 6f2c 2061 7474 6163   To do so, attac
│ │ │ │ │ -00014260: 6820 7468 6520 666f 6c6c 6f77 696e 6720  h the following 
│ │ │ │ │ -00014270: 6e6f 7469 6365 7320 746f 2074 6865 2070  notices to the p
│ │ │ │ │ -00014280: 726f 6772 616d 2e20 2049 7420 6973 2073  rogram.  It is s
│ │ │ │ │ -00014290: 6166 6573 740a 746f 2061 7474 6163 6820  afest.to attach 
│ │ │ │ │ -000142a0: 7468 656d 2074 6f20 7468 6520 7374 6172  them to the star
│ │ │ │ │ -000142b0: 7420 6f66 2065 6163 6820 736f 7572 6365  t of each source
│ │ │ │ │ -000142c0: 2066 696c 6520 746f 206d 6f73 7420 6566   file to most ef
│ │ │ │ │ -000142d0: 6665 6374 6976 656c 790a 636f 6e76 6579  fectively.convey
│ │ │ │ │ -000142e0: 2074 6865 2065 7863 6c75 7369 6f6e 206f   the exclusion o
│ │ │ │ │ -000142f0: 6620 7761 7272 616e 7479 3b20 616e 6420  f warranty; and 
│ │ │ │ │ -00014300: 6561 6368 2066 696c 6520 7368 6f75 6c64  each file should
│ │ │ │ │ -00014310: 2068 6176 6520 6174 206c 6561 7374 2074   have at least t
│ │ │ │ │ -00014320: 6865 0a22 636f 7079 7269 6768 7422 206c  he."copyright" l
│ │ │ │ │ -00014330: 696e 6520 616e 6420 6120 706f 696e 7465  ine and a pointe
│ │ │ │ │ -00014340: 7220 746f 2077 6865 7265 2074 6865 2066  r to where the f
│ │ │ │ │ -00014350: 756c 6c20 6e6f 7469 6365 2069 7320 666f  ull notice is fo
│ │ │ │ │ -00014360: 756e 642e 0a0a 2020 2020 204f 4e45 204c  und...     ONE L
│ │ │ │ │ -00014370: 494e 4520 544f 2047 4956 4520 5448 4520  INE TO GIVE THE 
│ │ │ │ │ -00014380: 5052 4f47 5241 4d27 5320 4e41 4d45 2041  PROGRAM'S NAME A
│ │ │ │ │ -00014390: 4e44 2041 2042 5249 4546 2049 4445 4120  ND A BRIEF IDEA 
│ │ │ │ │ -000143a0: 4f46 2057 4841 5420 4954 2044 4f45 532e  OF WHAT IT DOES.
│ │ │ │ │ -000143b0: 0a20 2020 2020 436f 7079 7269 6768 7420  .     Copyright 
│ │ │ │ │ -000143c0: 2843 2920 5959 5959 2020 4e41 4d45 204f  (C) YYYY  NAME O
│ │ │ │ │ -000143d0: 4620 4155 5448 4f52 0a0a 2020 2020 2054  F AUTHOR..     T
│ │ │ │ │ -000143e0: 6869 7320 7072 6f67 7261 6d20 6973 2066  his program is f
│ │ │ │ │ -000143f0: 7265 6520 736f 6674 7761 7265 3b20 796f  ree software; yo
│ │ │ │ │ -00014400: 7520 6361 6e20 7265 6469 7374 7269 6275  u can redistribu
│ │ │ │ │ -00014410: 7465 2069 7420 616e 642f 6f72 206d 6f64  te it and/or mod
│ │ │ │ │ -00014420: 6966 790a 2020 2020 2069 7420 756e 6465  ify.     it unde
│ │ │ │ │ -00014430: 7220 7468 6520 7465 726d 7320 6f66 2074  r the terms of t
│ │ │ │ │ -00014440: 6865 2047 4e55 2047 656e 6572 616c 2050  he GNU General P
│ │ │ │ │ -00014450: 7562 6c69 6320 4c69 6365 6e73 6520 6173  ublic License as
│ │ │ │ │ -00014460: 2070 7562 6c69 7368 6564 2062 790a 2020   published by.  
│ │ │ │ │ -00014470: 2020 2074 6865 2046 7265 6520 536f 6674     the Free Soft
│ │ │ │ │ -00014480: 7761 7265 2046 6f75 6e64 6174 696f 6e3b  ware Foundation;
│ │ │ │ │ -00014490: 2065 6974 6865 7220 7665 7273 696f 6e20   either version 
│ │ │ │ │ -000144a0: 3220 6f66 2074 6865 204c 6963 656e 7365  2 of the License
│ │ │ │ │ -000144b0: 2c20 6f72 0a20 2020 2020 2861 7420 796f  , or.     (at yo
│ │ │ │ │ -000144c0: 7572 206f 7074 696f 6e29 2061 6e79 206c  ur option) any l
│ │ │ │ │ -000144d0: 6174 6572 2076 6572 7369 6f6e 2e0a 0a20  ater version... 
│ │ │ │ │ -000144e0: 2020 2020 5468 6973 2070 726f 6772 616d      This program
│ │ │ │ │ -000144f0: 2069 7320 6469 7374 7269 6275 7465 6420   is distributed 
│ │ │ │ │ -00014500: 696e 2074 6865 2068 6f70 6520 7468 6174  in the hope that
│ │ │ │ │ -00014510: 2069 7420 7769 6c6c 2062 6520 7573 6566   it will be usef
│ │ │ │ │ -00014520: 756c 2c0a 2020 2020 2062 7574 2057 4954  ul,.     but WIT
│ │ │ │ │ -00014530: 484f 5554 2041 4e59 2057 4152 5241 4e54  HOUT ANY WARRANT
│ │ │ │ │ -00014540: 593b 2077 6974 686f 7574 2065 7665 6e20  Y; without even 
│ │ │ │ │ -00014550: 7468 6520 696d 706c 6965 6420 7761 7272  the implied warr
│ │ │ │ │ -00014560: 616e 7479 206f 660a 2020 2020 204d 4552  anty of.     MER
│ │ │ │ │ -00014570: 4348 414e 5441 4249 4c49 5459 206f 7220  CHANTABILITY or 
│ │ │ │ │ -00014580: 4649 544e 4553 5320 464f 5220 4120 5041  FITNESS FOR A PA
│ │ │ │ │ -00014590: 5254 4943 554c 4152 2050 5552 504f 5345  RTICULAR PURPOSE
│ │ │ │ │ -000145a0: 2e20 2053 6565 2074 6865 0a20 2020 2020  .  See the.     
│ │ │ │ │ -000145b0: 474e 5520 4765 6e65 7261 6c20 5075 626c  GNU General Publ
│ │ │ │ │ -000145c0: 6963 204c 6963 656e 7365 2066 6f72 206d  ic License for m
│ │ │ │ │ -000145d0: 6f72 6520 6465 7461 696c 732e 0a0a 2020  ore details...  
│ │ │ │ │ -000145e0: 2020 2059 6f75 2073 686f 756c 6420 6861     You should ha
│ │ │ │ │ -000145f0: 7665 2072 6563 6569 7665 6420 6120 636f  ve received a co
│ │ │ │ │ -00014600: 7079 206f 6620 7468 6520 474e 5520 4765  py of the GNU Ge
│ │ │ │ │ -00014610: 6e65 7261 6c20 5075 626c 6963 204c 6963  neral Public Lic
│ │ │ │ │ -00014620: 656e 7365 0a20 2020 2020 616c 6f6e 6720  ense.     along 
│ │ │ │ │ -00014630: 7769 7468 2074 6869 7320 7072 6f67 7261  with this progra
│ │ │ │ │ -00014640: 6d3b 2069 6620 6e6f 742c 2077 7269 7465  m; if not, write
│ │ │ │ │ -00014650: 2074 6f20 7468 6520 4672 6565 2053 6f66   to the Free Sof
│ │ │ │ │ -00014660: 7477 6172 650a 2020 2020 2046 6f75 6e64  tware.     Found
│ │ │ │ │ -00014670: 6174 696f 6e2c 2049 6e63 2e2c 2035 3120  ation, Inc., 51 
│ │ │ │ │ -00014680: 4672 616e 6b6c 696e 2053 7472 6565 742c  Franklin Street,
│ │ │ │ │ -00014690: 2046 6966 7468 2046 6c6f 6f72 2c20 426f   Fifth Floor, Bo
│ │ │ │ │ -000146a0: 7374 6f6e 2c20 4d41 2020 3032 3131 302d  ston, MA  02110-
│ │ │ │ │ -000146b0: 3133 3031 2c20 5553 412e 0a0a 2020 2041  1301, USA...   A
│ │ │ │ │ -000146c0: 6c73 6f20 6164 6420 696e 666f 726d 6174  lso add informat
│ │ │ │ │ -000146d0: 696f 6e20 6f6e 2068 6f77 2074 6f20 636f  ion on how to co
│ │ │ │ │ -000146e0: 6e74 6163 7420 796f 7520 6279 2065 6c65  ntact you by ele
│ │ │ │ │ -000146f0: 6374 726f 6e69 6320 616e 6420 7061 7065  ctronic and pape
│ │ │ │ │ -00014700: 720a 6d61 696c 2e0a 0a20 2020 4966 2074  r.mail...   If t
│ │ │ │ │ -00014710: 6865 2070 726f 6772 616d 2069 7320 696e  he program is in
│ │ │ │ │ -00014720: 7465 7261 6374 6976 652c 206d 616b 6520  teractive, make 
│ │ │ │ │ -00014730: 6974 206f 7574 7075 7420 6120 7368 6f72  it output a shor
│ │ │ │ │ -00014740: 7420 6e6f 7469 6365 206c 696b 650a 7468  t notice like.th
│ │ │ │ │ -00014750: 6973 2077 6865 6e20 6974 2073 7461 7274  is when it start
│ │ │ │ │ -00014760: 7320 696e 2061 6e20 696e 7465 7261 6374  s in an interact
│ │ │ │ │ -00014770: 6976 6520 6d6f 6465 3a0a 0a20 2020 2020  ive mode:..     
│ │ │ │ │ -00014780: 476e 6f6d 6f76 6973 696f 6e20 7665 7273  Gnomovision vers
│ │ │ │ │ -00014790: 696f 6e20 3639 2c20 436f 7079 7269 6768  ion 69, Copyrigh
│ │ │ │ │ -000147a0: 7420 2843 2920 5945 4152 204e 414d 4520  t (C) YEAR NAME 
│ │ │ │ │ -000147b0: 4f46 2041 5554 484f 520a 2020 2020 2047  OF AUTHOR.     G
│ │ │ │ │ -000147c0: 6e6f 6d6f 7669 7369 6f6e 2063 6f6d 6573  nomovision comes
│ │ │ │ │ -000147d0: 2077 6974 6820 4142 534f 4c55 5445 4c59   with ABSOLUTELY
│ │ │ │ │ -000147e0: 204e 4f20 5741 5252 414e 5459 3b20 666f   NO WARRANTY; fo
│ │ │ │ │ -000147f0: 7220 6465 7461 696c 7320 7479 7065 2060  r details type `
│ │ │ │ │ -00014800: 7368 6f77 2077 272e 0a20 2020 2020 5468  show w'..     Th
│ │ │ │ │ -00014810: 6973 2069 7320 6672 6565 2073 6f66 7477  is is free softw
│ │ │ │ │ -00014820: 6172 652c 2061 6e64 2079 6f75 2061 7265  are, and you are
│ │ │ │ │ -00014830: 2077 656c 636f 6d65 2074 6f20 7265 6469   welcome to redi
│ │ │ │ │ -00014840: 7374 7269 6275 7465 2069 740a 2020 2020  stribute it.    
│ │ │ │ │ -00014850: 2075 6e64 6572 2063 6572 7461 696e 2063   under certain c
│ │ │ │ │ -00014860: 6f6e 6469 7469 6f6e 733b 2074 7970 6520  onditions; type 
│ │ │ │ │ -00014870: 6073 686f 7720 6327 2066 6f72 2064 6574  `show c' for det
│ │ │ │ │ -00014880: 6169 6c73 2e0a 0a20 2020 5468 6520 6879  ails...   The hy
│ │ │ │ │ -00014890: 706f 7468 6574 6963 616c 2063 6f6d 6d61  pothetical comma
│ │ │ │ │ -000148a0: 6e64 7320 2773 686f 7720 7727 2061 6e64  nds 'show w' and
│ │ │ │ │ -000148b0: 2027 7368 6f77 2063 2720 7368 6f75 6c64   'show c' should
│ │ │ │ │ -000148c0: 2073 686f 7720 7468 650a 6170 7072 6f70   show the.approp
│ │ │ │ │ -000148d0: 7269 6174 6520 7061 7274 7320 6f66 2074  riate parts of t
│ │ │ │ │ -000148e0: 6865 2047 656e 6572 616c 2050 7562 6c69  he General Publi
│ │ │ │ │ -000148f0: 6320 4c69 6365 6e73 652e 2020 4f66 2063  c License.  Of c
│ │ │ │ │ -00014900: 6f75 7273 652c 2074 6865 0a63 6f6d 6d61  ourse, the.comma
│ │ │ │ │ -00014910: 6e64 7320 796f 7520 7573 6520 6d61 7920  nds you use may 
│ │ │ │ │ -00014920: 6265 2063 616c 6c65 6420 736f 6d65 7468  be called someth
│ │ │ │ │ -00014930: 696e 6720 6f74 6865 7220 7468 616e 2027  ing other than '
│ │ │ │ │ -00014940: 7368 6f77 2077 2720 616e 6420 2773 686f  show w' and 'sho
│ │ │ │ │ -00014950: 770a 6327 3b20 7468 6579 2063 6f75 6c64  w.c'; they could
│ │ │ │ │ -00014960: 2065 7665 6e20 6265 206d 6f75 7365 2d63   even be mouse-c
│ │ │ │ │ -00014970: 6c69 636b 7320 6f72 206d 656e 7520 6974  licks or menu it
│ │ │ │ │ -00014980: 656d 732d 2d77 6861 7465 7665 7220 7375  ems--whatever su
│ │ │ │ │ -00014990: 6974 7320 796f 7572 0a70 726f 6772 616d  its your.program
│ │ │ │ │ -000149a0: 2e0a 0a20 2020 596f 7520 7368 6f75 6c64  ...   You should
│ │ │ │ │ -000149b0: 2061 6c73 6f20 6765 7420 796f 7572 2065   also get your e
│ │ │ │ │ -000149c0: 6d70 6c6f 7965 7220 2869 6620 796f 7520  mployer (if you 
│ │ │ │ │ -000149d0: 776f 726b 2061 7320 6120 7072 6f67 7261  work as a progra
│ │ │ │ │ -000149e0: 6d6d 6572 2920 6f72 0a79 6f75 7220 7363  mmer) or.your sc
│ │ │ │ │ -000149f0: 686f 6f6c 2c20 6966 2061 6e79 2c20 746f  hool, if any, to
│ │ │ │ │ -00014a00: 2073 6967 6e20 6120 2263 6f70 7972 6967   sign a "copyrig
│ │ │ │ │ -00014a10: 6874 2064 6973 636c 6169 6d65 7222 2066  ht disclaimer" f
│ │ │ │ │ -00014a20: 6f72 2074 6865 2070 726f 6772 616d 2c0a  or the program,.
│ │ │ │ │ -00014a30: 6966 206e 6563 6573 7361 7279 2e20 2048  if necessary.  H
│ │ │ │ │ -00014a40: 6572 6520 6973 2061 2073 616d 706c 653b  ere is a sample;
│ │ │ │ │ -00014a50: 2061 6c74 6572 2074 6865 206e 616d 6573   alter the names
│ │ │ │ │ -00014a60: 3a0a 0a20 2020 2020 596f 796f 6479 6e65  :..     Yoyodyne
│ │ │ │ │ -00014a70: 2c20 496e 632e 2c20 6865 7265 6279 2064  , Inc., hereby d
│ │ │ │ │ -00014a80: 6973 636c 6169 6d73 2061 6c6c 2063 6f70  isclaims all cop
│ │ │ │ │ -00014a90: 7972 6967 6874 2069 6e74 6572 6573 7420  yright interest 
│ │ │ │ │ -00014aa0: 696e 2074 6865 2070 726f 6772 616d 0a20  in the program. 
│ │ │ │ │ -00014ab0: 2020 2020 6047 6e6f 6d6f 7669 7369 6f6e      `Gnomovision
│ │ │ │ │ -00014ac0: 2720 2877 6869 6368 206d 616b 6573 2070  ' (which makes p
│ │ │ │ │ -00014ad0: 6173 7365 7320 6174 2063 6f6d 7069 6c65  asses at compile
│ │ │ │ │ -00014ae0: 7273 2920 7772 6974 7465 6e20 6279 204a  rs) written by J
│ │ │ │ │ -00014af0: 616d 6573 2048 6163 6b65 722e 0a0a 2020  ames Hacker...  
│ │ │ │ │ -00014b00: 2020 2053 4947 4e41 5455 5245 204f 4620     SIGNATURE OF 
│ │ │ │ │ -00014b10: 5459 2043 4f4f 4e2c 2031 2041 7072 696c  TY COON, 1 April
│ │ │ │ │ -00014b20: 2031 3938 390a 2020 2020 2054 7920 436f   1989.     Ty Co
│ │ │ │ │ -00014b30: 6f6e 2c20 5072 6573 6964 656e 7420 6f66  on, President of
│ │ │ │ │ -00014b40: 2056 6963 650a 0a20 2020 5468 6973 2047   Vice..   This G
│ │ │ │ │ -00014b50: 656e 6572 616c 2050 7562 6c69 6320 4c69  eneral Public Li
│ │ │ │ │ -00014b60: 6365 6e73 6520 646f 6573 206e 6f74 2070  cense does not p
│ │ │ │ │ -00014b70: 6572 6d69 7420 696e 636f 7270 6f72 6174  ermit incorporat
│ │ │ │ │ -00014b80: 696e 6720 796f 7572 0a70 726f 6772 616d  ing your.program
│ │ │ │ │ -00014b90: 2069 6e74 6f20 7072 6f70 7269 6574 6172   into proprietar
│ │ │ │ │ -00014ba0: 7920 7072 6f67 7261 6d73 2e20 2049 6620  y programs.  If 
│ │ │ │ │ -00014bb0: 796f 7572 2070 726f 6772 616d 2069 7320  your program is 
│ │ │ │ │ -00014bc0: 6120 7375 6272 6f75 7469 6e65 0a6c 6962  a subroutine.lib
│ │ │ │ │ -00014bd0: 7261 7279 2c20 796f 7520 6d61 7920 636f  rary, you may co
│ │ │ │ │ -00014be0: 6e73 6964 6572 2069 7420 6d6f 7265 2075  nsider it more u
│ │ │ │ │ -00014bf0: 7365 6675 6c20 746f 2070 6572 6d69 7420  seful to permit 
│ │ │ │ │ -00014c00: 6c69 6e6b 696e 6720 7072 6f70 7269 6574  linking propriet
│ │ │ │ │ -00014c10: 6172 790a 6170 706c 6963 6174 696f 6e73  ary.applications
│ │ │ │ │ -00014c20: 2077 6974 6820 7468 6520 6c69 6272 6172   with the librar
│ │ │ │ │ -00014c30: 792e 2020 4966 2074 6869 7320 6973 2077  y.  If this is w
│ │ │ │ │ -00014c40: 6861 7420 796f 7520 7761 6e74 2074 6f20  hat you want to 
│ │ │ │ │ -00014c50: 646f 2c20 7573 6520 7468 650a 474e 5520  do, use the.GNU 
│ │ │ │ │ -00014c60: 4c65 7373 6572 2047 656e 6572 616c 2050  Lesser General P
│ │ │ │ │ -00014c70: 7562 6c69 6320 4c69 6365 6e73 6520 696e  ublic License in
│ │ │ │ │ -00014c80: 7374 6561 6420 6f66 2074 6869 7320 4c69  stead of this Li
│ │ │ │ │ -00014c90: 6365 6e73 652e 0a0a 1f0a 4669 6c65 3a20  cense.....File: 
│ │ │ │ │ -00014ca0: 6c69 6266 6b6f 2e69 6e66 6f2c 2020 4e6f  libfko.info,  No
│ │ │ │ │ -00014cb0: 6465 3a20 436f 6e63 6570 7420 496e 6465  de: Concept Inde
│ │ │ │ │ -00014cc0: 782c 2020 4e65 7874 3a20 4675 6e63 7469  x,  Next: Functi
│ │ │ │ │ -00014cd0: 6f6e 2061 6e64 2044 6174 6120 496e 6465  on and Data Inde
│ │ │ │ │ -00014ce0: 782c 2020 5072 6576 3a20 4c69 6272 6172  x,  Prev: Librar
│ │ │ │ │ -00014cf0: 7920 436f 7079 696e 672c 2020 5570 3a20  y Copying,  Up: 
│ │ │ │ │ -00014d00: 546f 700a 0a43 6f6e 6365 7074 2049 6e64  Top..Concept Ind
│ │ │ │ │ -00014d10: 6578 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ex.*************
│ │ │ │ │ -00014d20: 0a0a 0008 5b69 6e64 6578 0008 5d0a 2a20  ....[index..].* 
│ │ │ │ │ -00014d30: 4d65 6e75 3a0a 0a2a 2063 6f6d 7069 6c69  Menu:..* compili
│ │ │ │ │ -00014d40: 6e67 2c20 7769 7468 206c 6962 666b 6f3a  ng, with libfko:
│ │ │ │ │ -00014d50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00014d60: 436f 6d70 696c 696e 6720 7769 7468 206c  Compiling with l
│ │ │ │ │ -00014d70: 6962 666b 6f2e 0a20 2020 2020 2020 2020  ibfko..         
│ │ │ │ │ +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..           
│ │ │ │ │  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 2020 2028 6c69 6e65 2020 2036 290a       (line   6).
│ │ │ │ │ -00014dc0: 2a20 636f 6e74 6578 742c 2063 7265 6174  * context, creat
│ │ │ │ │ -00014dd0: 696f 6e3a 2020 2020 2020 2020 2020 2020  ion:            
│ │ │ │ │ -00014de0: 2020 2020 2020 2020 2043 7265 6174 696e           Creatin
│ │ │ │ │ -00014df0: 6720 436f 6e74 6578 7473 2e20 2020 286c  g Contexts.   (l
│ │ │ │ │ -00014e00: 696e 6520 2020 3629 0a2a 2063 6f6e 7465  ine   6).* conte
│ │ │ │ │ -00014e10: 7874 2c20 6465 7374 7275 6374 696f 6e3a  xt, destruction:
│ │ │ │ │ +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: 2020 4465 7374 726f 7969 6e67 2043 6f6e    Destroying Con
│ │ │ │ │ -00014e40: 7465 7874 732e 2028 6c69 6e65 2020 2036  texts. (line   6
│ │ │ │ │ -00014e50: 290a 2a20 6465 6661 756c 7420 656e 6372  ).* default encr
│ │ │ │ │ -00014e60: 7970 7469 6f6e 3a20 2020 2020 2020 2020  yption:         
│ │ │ │ │ -00014e70: 2020 2020 2020 2020 2020 2045 6e63 7279             Encry
│ │ │ │ │ -00014e80: 7074 696f 6e20 416c 676f 7269 7468 6d73  ption Algorithms
│ │ │ │ │ -00014e90: 2e0a 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..
│ │ │ │ │ +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 2020                  
│ │ │ │ │ -00014ed0: 286c 696e 6520 2020 3629 0a2a 2064 6566  (line   6).* def
│ │ │ │ │ -00014ee0: 6175 6c74 206d 6573 7361 6765 2064 6967  ault message dig
│ │ │ │ │ -00014ef0: 6573 743a 2020 2020 2020 2020 2020 2020  est:            
│ │ │ │ │ -00014f00: 2020 2020 4469 6765 7374 732e 2020 2020      Digests.    
│ │ │ │ │ -00014f10: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ │ -00014f20: 2036 290a 2a20 6465 6661 756c 7420 6d65   6).* default me
│ │ │ │ │ -00014f30: 7373 6167 6520 6469 6765 7374 203c 313e  ssage digest <1>
│ │ │ │ │ -00014f40: 3a20 2020 2020 2020 2020 2020 2048 4d41  :            HMA
│ │ │ │ │ -00014f50: 4320 4469 6765 7374 732e 2020 2020 2020  C Digests.      
│ │ │ │ │ -00014f60: 2020 286c 696e 6520 2020 3629 0a2a 2064    (line   6).* d
│ │ │ │ │ -00014f70: 6967 6573 7420 7479 7065 733a 2020 2020  igest types:    
│ │ │ │ │ +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:      
│ │ │ │ │  00014f80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00014f90: 2020 2020 2020 4469 6765 7374 732e 2020        Digests.  
│ │ │ │ │ -00014fa0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ │ -00014fb0: 2020 2036 290a 2a20 656e 6372 7970 7469     6).* encrypti
│ │ │ │ │ -00014fc0: 6f6e 2074 7970 6573 3a20 2020 2020 2020  on types:       
│ │ │ │ │ -00014fd0: 2020 2020 2020 2020 2020 2020 2020 2045                 E
│ │ │ │ │ -00014fe0: 6e63 7279 7074 696f 6e20 416c 676f 7269  ncryption Algori
│ │ │ │ │ -00014ff0: 7468 6d73 2e0a 2020 2020 2020 2020 2020  thms..          
│ │ │ │ │ +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..            
│ │ │ │ │  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 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*
│ │ │ │ │ -00015040: 2065 7272 6f72 2063 6f64 6573 3a20 2020   error codes:   
│ │ │ │ │ +00015030: 2020 286c 696e 6520 2020 3629 0a2a 2065    (line   6).* e
│ │ │ │ │ +00015040: 7272 6f72 2063 6f64 6573 3a20 2020 2020  rror codes:     
│ │ │ │ │  00015050: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015060: 2020 2020 2020 2020 4572 726f 7220 4861          Error Ha
│ │ │ │ │ -00015070: 6e64 6c69 6e67 2e20 2020 2020 2028 6c69  ndling.      (li
│ │ │ │ │ -00015080: 6e65 2020 2036 290a 2a20 6572 726f 7220  ne   6).* error 
│ │ │ │ │ -00015090: 636f 6465 732c 2067 7067 6d65 2072 656c  codes, gpgme rel
│ │ │ │ │ -000150a0: 6174 6564 3a20 2020 2020 2020 2020 2020  ated:           
│ │ │ │ │ -000150b0: 2045 7272 6f72 2048 616e 646c 696e 672e   Error Handling.
│ │ │ │ │ -000150c0: 2020 2020 2020 286c 696e 6520 3234 3129        (line 241)
│ │ │ │ │ -000150d0: 0a2a 2065 7272 6f72 2068 616e 646c 696e  .* error handlin
│ │ │ │ │ -000150e0: 673a 2020 2020 2020 2020 2020 2020 2020  g:              
│ │ │ │ │ -000150f0: 2020 2020 2020 2020 2020 4572 726f 7220            Error 
│ │ │ │ │ -00015100: 4861 6e64 6c69 6e67 2e20 2020 2020 2028  Handling.      (
│ │ │ │ │ -00015110: 6c69 6e65 2020 2036 290a 2a20 6572 726f  line   6).* erro
│ │ │ │ │ -00015120: 7220 7374 7269 6e67 733a 2020 2020 2020  r strings:      
│ │ │ │ │ +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:
│ │ │ │ │ +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: 2020 2045 7272 6f72 2048 616e 646c 696e     Error Handlin
│ │ │ │ │ -00015150: 672e 2020 2020 2020 286c 696e 6520 2020  g.      (line   
│ │ │ │ │ -00015160: 3629 0a2a 2046 6972 6577 616c 6c20 4b6e  6).* Firewall Kn
│ │ │ │ │ -00015170: 6f63 6b20 4f70 6572 6174 6f72 2c20 696e  ock Operator, in
│ │ │ │ │ -00015180: 7472 6f3a 2020 2020 2020 2020 496e 7472  tro:        Intr
│ │ │ │ │ -00015190: 6f64 7563 7469 6f6e 2e20 2020 2020 2020  oduction.       
│ │ │ │ │ -000151a0: 2028 6c69 6e65 2020 2036 290a 2a20 666b   (line   6).* fk
│ │ │ │ │ -000151b0: 6f2e 683a 2020 2020 2020 2020 2020 2020  o.h:            
│ │ │ │ │ +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:              
│ │ │ │ │  000151c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000151d0: 2020 2020 206c 6962 666b 6f20 4865 6164       libfko Head
│ │ │ │ │ -000151e0: 6572 2e20 2020 2020 2020 286c 696e 6520  er.       (line 
│ │ │ │ │ -000151f0: 2020 3629 0a2a 2066 776b 6e6f 703a 2020    6).* fwknop:  
│ │ │ │ │ +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:    
│ │ │ │ │  00015200: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015210: 2020 2020 2020 2020 2020 2020 2020 496e                In
│ │ │ │ │ -00015220: 7472 6f64 7563 7469 6f6e 2e20 2020 2020  troduction.     
│ │ │ │ │ -00015230: 2020 2028 6c69 6e65 2020 2036 290a 2a20     (line   6).* 
│ │ │ │ │ -00015240: 6770 672d 7370 6563 6966 6963 2066 756e  gpg-specific fun
│ │ │ │ │ -00015250: 6374 696f 6e73 3a20 2020 2020 2020 2020  ctions:         
│ │ │ │ │ -00015260: 2020 2020 2020 2053 6574 7469 6e67 2053         Setting S
│ │ │ │ │ -00015270: 5041 2044 6174 612e 2020 2020 286c 696e  PA Data.    (lin
│ │ │ │ │ -00015280: 6520 3131 3229 0a2a 2067 7067 2d73 7065  e 112).* gpg-spe
│ │ │ │ │ -00015290: 6369 6669 6320 6675 6e63 7469 6f6e 7320  cific functions 
│ │ │ │ │ -000152a0: 3c31 3e3a 2020 2020 2020 2020 2020 2020  <1>:            
│ │ │ │ │ -000152b0: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D
│ │ │ │ │ -000152c0: 6174 612e 2028 6c69 6e65 2031 3238 290a  ata. (line 128).
│ │ │ │ │ -000152d0: 2a20 6770 672d 7370 6563 6966 6963 2066  * gpg-specific f
│ │ │ │ │ -000152e0: 756e 6374 696f 6e73 203c 323e 3a20 2020  unctions <2>:   
│ │ │ │ │ -000152f0: 2020 2020 2020 2020 2055 7469 6c69 7479           Utility
│ │ │ │ │ -00015300: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ │ -00015310: 696e 6520 2035 3229 0a2a 2067 7067 2d73  ine  52).* gpg-s
│ │ │ │ │ -00015320: 7065 6369 6669 6320 6675 6e63 7469 6f6e  pecific function
│ │ │ │ │ -00015330: 7320 3c33 3e3a 2020 2020 2020 2020 2020  s <3>:          
│ │ │ │ │ -00015340: 2020 4572 726f 7220 4861 6e64 6c69 6e67    Error Handling
│ │ │ │ │ -00015350: 2e20 2020 2020 2028 6c69 6e65 2033 3130  .      (line 310
│ │ │ │ │ -00015360: 290a 2a20 4750 4c76 322b 2c20 4765 6e65  ).* GPLv2+, Gene
│ │ │ │ │ -00015370: 7261 6c20 5075 626c 6963 204c 6963 656e  ral Public Licen
│ │ │ │ │ -00015380: 7365 3a20 2020 2020 2020 204c 6962 7261  se:        Libra
│ │ │ │ │ -00015390: 7279 2043 6f70 7969 6e67 2e20 2020 2020  ry Copying.     
│ │ │ │ │ -000153a0: 286c 696e 6520 2020 3629 0a2a 2068 6561  (line   6).* hea
│ │ │ │ │ -000153b0: 6465 7220 6669 6c65 3a20 2020 2020 2020  der file:       
│ │ │ │ │ +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:         
│ │ │ │ │  000153c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000153d0: 2020 2020 6c69 6266 6b6f 2048 6561 6465      libfko Heade
│ │ │ │ │ -000153e0: 722e 2020 2020 2020 2028 6c69 6e65 2020  r.       (line  
│ │ │ │ │ -000153f0: 2036 290a 2a20 484d 4143 2064 6967 6573   6).* HMAC diges
│ │ │ │ │ -00015400: 7420 7479 7065 733a 2020 2020 2020 2020  t types:        
│ │ │ │ │ -00015410: 2020 2020 2020 2020 2020 2020 2048 4d41               HMA
│ │ │ │ │ -00015420: 4320 4469 6765 7374 732e 2020 2020 2020  C Digests.      
│ │ │ │ │ -00015430: 2020 286c 696e 6520 2020 3629 0a2a 2069    (line   6).* i
│ │ │ │ │ -00015440: 6e63 6c75 6465 2066 696c 653a 2020 2020  nclude file:    
│ │ │ │ │ +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:      
│ │ │ │ │  00015450: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015460: 2020 2020 2020 6c69 6266 6b6f 2048 6561        libfko Hea
│ │ │ │ │ -00015470: 6465 722e 2020 2020 2020 2028 6c69 6e65  der.       (line
│ │ │ │ │ -00015480: 2020 2036 290a 2a20 6c69 6e6b 696e 672c     6).* linking,
│ │ │ │ │ -00015490: 2077 6974 6820 6c69 6266 6b6f 3a20 2020   with libfko:   
│ │ │ │ │ -000154a0: 2020 2020 2020 2020 2020 2020 2020 2043                 C
│ │ │ │ │ -000154b0: 6f6d 7069 6c69 6e67 2077 6974 6820 6c69  ompiling with li
│ │ │ │ │ -000154c0: 6266 6b6f 2e0a 2020 2020 2020 2020 2020  bfko..          
│ │ │ │ │ +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..            
│ │ │ │ │  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 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*
│ │ │ │ │ -00015510: 206d 6573 7361 6765 2064 6967 6573 7420   message digest 
│ │ │ │ │ -00015520: 7479 7065 733a 2020 2020 2020 2020 2020  types:          
│ │ │ │ │ -00015530: 2020 2020 2020 2020 4469 6765 7374 732e          Digests.
│ │ │ │ │ -00015540: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ │ -00015550: 6e65 2020 2036 290a 2a20 6d65 7373 6167  ne   6).* messag
│ │ │ │ │ -00015560: 6520 6469 6765 7374 2074 7970 6573 203c  e digest types <
│ │ │ │ │ -00015570: 313e 3a20 2020 2020 2020 2020 2020 2020  1>:             
│ │ │ │ │ -00015580: 2048 4d41 4320 4469 6765 7374 732e 2020   HMAC Digests.  
│ │ │ │ │ -00015590: 2020 2020 2020 286c 696e 6520 2020 3629        (line   6)
│ │ │ │ │ -000155a0: 0a2a 206d 6573 7361 6765 2074 7970 6573  .* message types
│ │ │ │ │ -000155b0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ │ -000155c0: 2020 2020 2020 2020 2020 5350 4120 4d65            SPA Me
│ │ │ │ │ -000155d0: 7373 6167 6573 2e20 2020 2020 2020 2028  ssages.        (
│ │ │ │ │ -000155e0: 6c69 6e65 2020 2036 290a 2a20 5369 6e67  line   6).* Sing
│ │ │ │ │ -000155f0: 6c65 2050 6163 6b65 7420 4175 7468 6f72  le Packet Author
│ │ │ │ │ -00015600: 697a 6174 696f 6e2c 2069 6e74 726f 3a20  ization, intro: 
│ │ │ │ │ -00015610: 2020 2049 6e74 726f 6475 6374 696f 6e2e     Introduction.
│ │ │ │ │ -00015620: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ │ -00015630: 3629 0a2a 2073 7061 2064 6174 612c 2072  6).* spa data, r
│ │ │ │ │ -00015640: 6574 7269 6576 696e 6720 7661 6c75 6573  etrieving values
│ │ │ │ │ -00015650: 3a20 2020 2020 2020 2020 2020 5265 7472  :           Retr
│ │ │ │ │ -00015660: 6965 7669 6e67 2053 5041 2044 6174 612e  ieving SPA Data.
│ │ │ │ │ -00015670: 2028 6c69 6e65 2020 2036 290a 2a20 7370   (line   6).* sp
│ │ │ │ │ -00015680: 6120 6461 7461 2c20 7365 7474 696e 6720  a data, setting 
│ │ │ │ │ -00015690: 7661 6c75 6573 3a20 2020 2020 2020 2020  values:         
│ │ │ │ │ -000156a0: 2020 2020 2053 6574 7469 6e67 2053 5041       Setting SPA
│ │ │ │ │ -000156b0: 2044 6174 612e 2020 2020 286c 696e 6520   Data.    (line 
│ │ │ │ │ -000156c0: 2020 3629 0a2a 2073 7061 2064 6174 612c    6).* spa data,
│ │ │ │ │ -000156d0: 2075 7469 6c69 7479 2066 756e 6374 696f   utility functio
│ │ │ │ │ -000156e0: 6e73 3a20 2020 2020 2020 2020 2020 5574  ns:           Ut
│ │ │ │ │ -000156f0: 696c 6974 7920 4675 6e63 7469 6f6e 732e  ility Functions.
│ │ │ │ │ -00015700: 2020 2028 6c69 6e65 2020 2036 290a 2a20     (line   6).* 
│ │ │ │ │ -00015710: 7370 612c 2064 6174 6120 6372 6561 7469  spa, data creati
│ │ │ │ │ -00015720: 6f6e 2063 6f64 6520 7361 6d70 6c65 3a20  on code sample: 
│ │ │ │ │ -00015730: 2020 2020 2020 2043 7265 6174 696e 6720         Creating 
│ │ │ │ │ -00015740: 6120 5350 4120 4d65 7373 6167 652e 0a20  a SPA Message.. 
│ │ │ │ │ +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: 
│ │ │ │ │ +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..   
│ │ │ │ │  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 2020 2028 6c69               (li
│ │ │ │ │ -00015790: 6e65 2020 2036 290a 2a20 5350 412c 2064  ne   6).* SPA, d
│ │ │ │ │ -000157a0: 6174 6120 666f 726d 6174 3a20 2020 2020  ata format:     
│ │ │ │ │ -000157b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000157c0: 2053 5041 2044 6174 6120 466f 726d 6174   SPA Data Format
│ │ │ │ │ -000157d0: 2e20 2020 2020 286c 696e 6520 2020 3629  .     (line   6)
│ │ │ │ │ -000157e0: 0a2a 2053 5041 2c20 696e 7472 6f3a 2020  .* SPA, intro:  
│ │ │ │ │ +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:    
│ │ │ │ │  000157f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015800: 2020 2020 2020 2020 2020 496e 7472 6f64            Introd
│ │ │ │ │ -00015810: 7563 7469 6f6e 2e20 2020 2020 2020 2028  uction.        (
│ │ │ │ │ -00015820: 6c69 6e65 2020 2036 290a 2a20 7370 612c  line   6).* spa,
│ │ │ │ │ -00015830: 206d 6573 7361 6765 2064 6174 6120 6372   message data cr
│ │ │ │ │ -00015840: 6561 7469 6f6e 3a20 2020 2020 2020 2020  eation:         
│ │ │ │ │ -00015850: 2020 2043 7265 6174 696e 6720 6120 5350     Creating a SP
│ │ │ │ │ -00015860: 4120 4d65 7373 6167 652e 0a20 2020 2020  A Message..     
│ │ │ │ │ +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..       
│ │ │ │ │  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 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ │ -000158b0: 2036 290a 2a20 7370 612c 206d 6573 7361   6).* spa, messa
│ │ │ │ │ -000158c0: 6765 2074 7970 6573 3a20 2020 2020 2020  ge types:       
│ │ │ │ │ -000158d0: 2020 2020 2020 2020 2020 2020 2053 5041               SPA
│ │ │ │ │ -000158e0: 204d 6573 7361 6765 732e 2020 2020 2020   Messages.      
│ │ │ │ │ -000158f0: 2020 286c 696e 6520 2020 3629 0a2a 2075    (line   6).* u
│ │ │ │ │ -00015900: 7469 6c69 7479 2066 756e 6374 696f 6e73  tility functions
│ │ │ │ │ -00015910: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ │ -00015920: 2020 2020 2020 5574 696c 6974 7920 4675        Utility Fu
│ │ │ │ │ -00015930: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ │ -00015940: 2020 2036 290a 0a1f 0a46 696c 653a 206c     6)....File: l
│ │ │ │ │ -00015950: 6962 666b 6f2e 696e 666f 2c20 204e 6f64  ibfko.info,  Nod
│ │ │ │ │ -00015960: 653a 2046 756e 6374 696f 6e20 616e 6420  e: Function and 
│ │ │ │ │ -00015970: 4461 7461 2049 6e64 6578 2c20 2050 7265  Data Index,  Pre
│ │ │ │ │ -00015980: 763a 2043 6f6e 6365 7074 2049 6e64 6578  v: Concept Index
│ │ │ │ │ -00015990: 2c20 2055 703a 2054 6f70 0a0a 4675 6e63  ,  Up: Top..Func
│ │ │ │ │ -000159a0: 7469 6f6e 2061 6e64 2044 6174 6120 496e  tion and Data In
│ │ │ │ │ -000159b0: 6465 780a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  dex.************
│ │ │ │ │ -000159c0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a00 085b  ***********....[
│ │ │ │ │ -000159d0: 696e 6465 7800 085d 0a2a 204d 656e 753a  index..].* Menu:
│ │ │ │ │ -000159e0: 0a0a 2a20 6572 726f 725f 636f 6465 3a20  ..* error_code: 
│ │ │ │ │ +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: 
│ │ │ │ │ +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:   
│ │ │ │ │  000159f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015a00: 2020 2020 2020 2020 2020 2045 7272 6f72             Error
│ │ │ │ │ -00015a10: 2048 616e 646c 696e 672e 2020 2020 2020   Handling.      
│ │ │ │ │ -00015a20: 286c 696e 6520 2031 3829 0a2a 2065 7272  (line  18).* err
│ │ │ │ │ -00015a30: 6f72 5f63 6f64 6520 3c31 3e3a 2020 2020  or_code <1>:    
│ │ │ │ │ +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>:      
│ │ │ │ │  00015a40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015a50: 2020 2020 4572 726f 7220 4861 6e64 6c69      Error Handli
│ │ │ │ │ -00015a60: 6e67 2e20 2020 2020 2028 6c69 6e65 2032  ng.      (line 2
│ │ │ │ │ -00015a70: 3431 290a 2a20 666b 6f5f 6465 636f 6465  41).* fko_decode
│ │ │ │ │ -00015a80: 5f73 7061 5f64 6174 613a 2020 2020 2020  _spa_data:      
│ │ │ │ │ -00015a90: 2020 2020 2020 2020 2020 2020 2055 7469               Uti
│ │ │ │ │ -00015aa0: 6c69 7479 2046 756e 6374 696f 6e73 2e20  lity Functions. 
│ │ │ │ │ -00015ab0: 2020 286c 696e 6520 2033 3829 0a2a 2066    (line  38).* f
│ │ │ │ │ -00015ac0: 6b6f 5f64 6563 7279 7074 5f73 7061 5f64  ko_decrypt_spa_d
│ │ │ │ │ -00015ad0: 6174 613a 2020 2020 2020 2020 2020 2020  ata:            
│ │ │ │ │ -00015ae0: 2020 2020 2020 5574 696c 6974 7920 4675        Utility Fu
│ │ │ │ │ -00015af0: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ │ -00015b00: 2020 3233 290a 2a20 666b 6f5f 6465 7374    23).* fko_dest
│ │ │ │ │ -00015b10: 726f 793a 2020 2020 2020 2020 2020 2020  roy:            
│ │ │ │ │ -00015b20: 2020 2020 2020 2020 2020 2020 2020 2044                 D
│ │ │ │ │ -00015b30: 6573 7472 6f79 696e 6720 436f 6e74 6578  estroying Contex
│ │ │ │ │ -00015b40: 7473 2e20 286c 696e 6520 2031 3129 0a2a  ts. (line  11).*
│ │ │ │ │ -00015b50: 2066 6b6f 5f64 6967 6573 745f 7479 7065   fko_digest_type
│ │ │ │ │ -00015b60: 5f74 3a20 2020 2020 2020 2020 2020 2020  _t:             
│ │ │ │ │ -00015b70: 2020 2020 2020 2020 4469 6765 7374 732e          Digests.
│ │ │ │ │ -00015b80: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ │ -00015b90: 6e65 2020 3137 290a 2a20 666b 6f5f 6469  ne  17).* fko_di
│ │ │ │ │ -00015ba0: 6765 7374 5f74 7970 655f 7420 3c31 3e3a  gest_type_t <1>:
│ │ │ │ │ -00015bb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015bc0: 2048 4d41 4320 4469 6765 7374 732e 2020   HMAC Digests.  
│ │ │ │ │ -00015bd0: 2020 2020 2020 286c 696e 6520 2031 3429        (line  14)
│ │ │ │ │ -00015be0: 0a2a 2066 6b6f 5f65 6e63 6f64 655f 7370  .* fko_encode_sp
│ │ │ │ │ -00015bf0: 615f 6461 7461 3a20 2020 2020 2020 2020  a_data:         
│ │ │ │ │ -00015c00: 2020 2020 2020 2020 2020 5574 696c 6974            Utilit
│ │ │ │ │ -00015c10: 7920 4675 6e63 7469 6f6e 732e 2020 2028  y Functions.   (
│ │ │ │ │ -00015c20: 6c69 6e65 2020 3434 290a 2a20 666b 6f5f  line  44).* fko_
│ │ │ │ │ -00015c30: 656e 6372 7970 7469 6f6e 5f74 7970 655f  encryption_type_
│ │ │ │ │ -00015c40: 743a 2020 2020 2020 2020 2020 2020 2020  t:              
│ │ │ │ │ -00015c50: 2020 2045 6e63 7279 7074 696f 6e20 416c     Encryption Al
│ │ │ │ │ -00015c60: 676f 7269 7468 6d73 2e0a 2020 2020 2020  gorithms..      
│ │ │ │ │ +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..        
│ │ │ │ │  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 2020 286c 696e 6520 2031          (line  1
│ │ │ │ │ -00015cb0: 3029 0a2a 2066 6b6f 5f65 6e63 7279 7074  0).* fko_encrypt
│ │ │ │ │ -00015cc0: 5f73 7061 5f64 6174 613a 2020 2020 2020  _spa_data:      
│ │ │ │ │ -00015cd0: 2020 2020 2020 2020 2020 2020 5574 696c              Util
│ │ │ │ │ -00015ce0: 6974 7920 4675 6e63 7469 6f6e 732e 2020  ity Functions.  
│ │ │ │ │ -00015cf0: 2028 6c69 6e65 2020 3332 290a 2a20 666b   (line  32).* fk
│ │ │ │ │ -00015d00: 6f5f 6572 7273 7472 3a20 2020 2020 2020  o_errstr:       
│ │ │ │ │ +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:         
│ │ │ │ │  00015d10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015d20: 2020 2020 2045 7272 6f72 2048 616e 646c       Error Handl
│ │ │ │ │ -00015d30: 696e 672e 2020 2020 2020 286c 696e 6520  ing.      (line 
│ │ │ │ │ -00015d40: 2031 3129 0a2a 2066 6b6f 5f67 6574 5f65   11).* fko_get_e
│ │ │ │ │ -00015d50: 6e63 6f64 6564 5f64 6174 613a 2020 2020  ncoded_data:    
│ │ │ │ │ -00015d60: 2020 2020 2020 2020 2020 2020 2020 5265                Re
│ │ │ │ │ -00015d70: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat
│ │ │ │ │ -00015d80: 612e 2028 6c69 6e65 2031 3133 290a 2a20  a. (line 113).* 
│ │ │ │ │ -00015d90: 666b 6f5f 6765 745f 6770 675f 6578 653a  fko_get_gpg_exe:
│ │ │ │ │ +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:  
│ │ │ │ │  00015da0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015db0: 2020 2020 2020 2052 6574 7269 6576 696e         Retrievin
│ │ │ │ │ -00015dc0: 6720 5350 4120 4461 7461 2e20 286c 696e  g SPA Data. (lin
│ │ │ │ │ -00015dd0: 6520 3138 3229 0a2a 2066 6b6f 5f67 6574  e 182).* fko_get
│ │ │ │ │ -00015de0: 5f67 7067 5f68 6f6d 655f 6469 723a 2020  _gpg_home_dir:  
│ │ │ │ │ -00015df0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00015e00: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D
│ │ │ │ │ -00015e10: 6174 612e 2028 6c69 6e65 2031 3431 290a  ata. (line 141).
│ │ │ │ │ -00015e20: 2a20 666b 6f5f 6765 745f 6770 675f 6967  * fko_get_gpg_ig
│ │ │ │ │ -00015e30: 6e6f 7265 5f76 6572 6966 795f 6572 726f  nore_verify_erro
│ │ │ │ │ -00015e40: 723a 2020 2020 2020 2052 6574 7269 6576  r:       Retriev
│ │ │ │ │ -00015e50: 696e 6720 5350 4120 4461 7461 2e20 286c  ing SPA Data. (l
│ │ │ │ │ -00015e60: 696e 6520 3135 3229 0a2a 2066 6b6f 5f67  ine 152).* fko_g
│ │ │ │ │ -00015e70: 6574 5f67 7067 5f72 6563 6970 6965 6e74  et_gpg_recipient
│ │ │ │ │ -00015e80: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ │ -00015e90: 2020 5265 7472 6965 7669 6e67 2053 5041    Retrieving SPA
│ │ │ │ │ -00015ea0: 2044 6174 612e 2028 6c69 6e65 2031 3330   Data. (line 130
│ │ │ │ │ -00015eb0: 290a 2a20 666b 6f5f 6765 745f 6770 675f  ).* fko_get_gpg_
│ │ │ │ │ -00015ec0: 7369 676e 6174 7572 655f 6670 723a 2020  signature_fpr:  
│ │ │ │ │ -00015ed0: 2020 2020 2020 2020 2020 2052 6574 7269             Retri
│ │ │ │ │ -00015ee0: 6576 696e 6720 5350 4120 4461 7461 2e20  eving SPA Data. 
│ │ │ │ │ -00015ef0: 286c 696e 6520 3136 3429 0a2a 2066 6b6f  (line 164).* fko
│ │ │ │ │ -00015f00: 5f67 6574 5f67 7067 5f73 6967 6e61 7475  _get_gpg_signatu
│ │ │ │ │ -00015f10: 7265 5f69 643a 2020 2020 2020 2020 2020  re_id:          
│ │ │ │ │ -00015f20: 2020 2020 5265 7472 6965 7669 6e67 2053      Retrieving S
│ │ │ │ │ -00015f30: 5041 2044 6174 612e 2028 6c69 6e65 2031  PA Data. (line 1
│ │ │ │ │ -00015f40: 3538 290a 2a20 666b 6f5f 6765 745f 6770  58).* fko_get_gp
│ │ │ │ │ -00015f50: 675f 7369 676e 6174 7572 655f 7374 6174  g_signature_stat
│ │ │ │ │ -00015f60: 7573 3a20 2020 2020 2020 2020 2052 6574  us:          Ret
│ │ │ │ │ -00015f70: 7269 6576 696e 6720 5350 4120 4461 7461  rieving SPA Data
│ │ │ │ │ -00015f80: 2e20 286c 696e 6520 3137 3629 0a2a 2066  . (line 176).* f
│ │ │ │ │ -00015f90: 6b6f 5f67 6574 5f67 7067 5f73 6967 6e61  ko_get_gpg_signa
│ │ │ │ │ -00015fa0: 7475 7265 5f73 756d 6d61 7279 3a20 2020  ture_summary:   
│ │ │ │ │ -00015fb0: 2020 2020 2020 5265 7472 6965 7669 6e67        Retrieving
│ │ │ │ │ -00015fc0: 2053 5041 2044 6174 612e 2028 6c69 6e65   SPA Data. (line
│ │ │ │ │ -00015fd0: 2031 3730 290a 2a20 666b 6f5f 6765 745f   170).* fko_get_
│ │ │ │ │ -00015fe0: 6770 675f 7369 676e 6174 7572 655f 7665  gpg_signature_ve
│ │ │ │ │ -00015ff0: 7269 6679 3a20 2020 2020 2020 2020 2052  rify:          R
│ │ │ │ │ -00016000: 6574 7269 6576 696e 6720 5350 4120 4461  etrieving SPA Da
│ │ │ │ │ -00016010: 7461 2e20 286c 696e 6520 3134 3629 0a2a  ta. (line 146).*
│ │ │ │ │ -00016020: 2066 6b6f 5f67 6574 5f67 7067 5f73 6967   fko_get_gpg_sig
│ │ │ │ │ -00016030: 6e65 723a 2020 2020 2020 2020 2020 2020  ner:            
│ │ │ │ │ -00016040: 2020 2020 2020 2020 5265 7472 6965 7669          Retrievi
│ │ │ │ │ -00016050: 6e67 2053 5041 2044 6174 612e 2028 6c69  ng SPA Data. (li
│ │ │ │ │ -00016060: 6e65 2031 3336 290a 2a20 666b 6f5f 6765  ne 136).* fko_ge
│ │ │ │ │ -00016070: 745f 7261 6e64 5f76 616c 7565 3a20 2020  t_rand_value:   
│ │ │ │ │ -00016080: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00016090: 2052 6574 7269 6576 696e 6720 5350 4120   Retrieving SPA 
│ │ │ │ │ -000160a0: 4461 7461 2e20 286c 696e 6520 2031 3829  Data. (line  18)
│ │ │ │ │ -000160b0: 0a2a 2066 6b6f 5f67 6574 5f73 7061 5f63  .* fko_get_spa_c
│ │ │ │ │ -000160c0: 6c69 656e 745f 7469 6d65 6f75 743a 2020  lient_timeout:  
│ │ │ │ │ -000160d0: 2020 2020 2020 2020 2020 5265 7472 6965            Retrie
│ │ │ │ │ -000160e0: 7669 6e67 2053 5041 2044 6174 612e 2028  ving SPA Data. (
│ │ │ │ │ -000160f0: 6c69 6e65 2020 3735 290a 2a20 666b 6f5f  line  75).* fko_
│ │ │ │ │ -00016100: 6765 745f 7370 615f 6461 7461 3a20 2020  get_spa_data:   
│ │ │ │ │ +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: 2020 2052 6574 7269 6576 696e 6720 5350     Retrieving SP
│ │ │ │ │ -00016130: 4120 4461 7461 2e20 286c 696e 6520 2031  A Data. (line  1
│ │ │ │ │ -00016140: 3229 0a2a 2066 6b6f 5f67 6574 5f73 7061  2).* fko_get_spa
│ │ │ │ │ -00016150: 5f64 6967 6573 743a 2020 2020 2020 2020  _digest:        
│ │ │ │ │ -00016160: 2020 2020 2020 2020 2020 2020 5265 7472              Retr
│ │ │ │ │ -00016170: 6965 7669 6e67 2053 5041 2044 6174 612e  ieving SPA Data.
│ │ │ │ │ -00016180: 2028 6c69 6e65 2020 3935 290a 2a20 666b   (line  95).* fk
│ │ │ │ │ -00016190: 6f5f 6765 745f 7370 615f 6469 6765 7374  o_get_spa_digest
│ │ │ │ │ -000161a0: 5f74 7970 653a 2020 2020 2020 2020 2020  _type:          
│ │ │ │ │ -000161b0: 2020 2020 2052 6574 7269 6576 696e 6720       Retrieving 
│ │ │ │ │ -000161c0: 5350 4120 4461 7461 2e20 286c 696e 6520  SPA Data. (line 
│ │ │ │ │ -000161d0: 2038 3129 0a2a 2066 6b6f 5f67 6574 5f73   81).* fko_get_s
│ │ │ │ │ -000161e0: 7061 5f65 6e63 7279 7074 696f 6e5f 7479  pa_encryption_ty
│ │ │ │ │ -000161f0: 7065 3a20 2020 2020 2020 2020 2020 5265  pe:           Re
│ │ │ │ │ -00016200: 7472 6965 7669 6e67 2053 5041 2044 6174  trieving SPA Dat
│ │ │ │ │ -00016210: 612e 2028 6c69 6e65 2031 3035 290a 2a20  a. (line 105).* 
│ │ │ │ │ -00016220: 666b 6f5f 6765 745f 7370 615f 686d 6163  fko_get_spa_hmac
│ │ │ │ │ -00016230: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ │ -00016240: 2020 2020 2020 2052 6574 7269 6576 696e         Retrievin
│ │ │ │ │ -00016250: 6720 5350 4120 4461 7461 2e20 286c 696e  g SPA Data. (lin
│ │ │ │ │ -00016260: 6520 3130 3029 0a2a 2066 6b6f 5f67 6574  e 100).* fko_get
│ │ │ │ │ -00016270: 5f73 7061 5f68 6d61 635f 7479 7065 3a20  _spa_hmac_type: 
│ │ │ │ │ -00016280: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00016290: 5265 7472 6965 7669 6e67 2053 5041 2044  Retrieving SPA D
│ │ │ │ │ -000162a0: 6174 612e 2028 6c69 6e65 2020 3838 290a  ata. (line  88).
│ │ │ │ │ -000162b0: 2a20 666b 6f5f 6765 745f 7370 615f 6d65  * fko_get_spa_me
│ │ │ │ │ -000162c0: 7373 6167 653a 2020 2020 2020 2020 2020  ssage:          
│ │ │ │ │ -000162d0: 2020 2020 2020 2020 2052 6574 7269 6576           Retriev
│ │ │ │ │ -000162e0: 696e 6720 5350 4120 4461 7461 2e20 286c  ing SPA Data. (l
│ │ │ │ │ -000162f0: 696e 6520 2035 3629 0a2a 2066 6b6f 5f67  ine  56).* fko_g
│ │ │ │ │ -00016300: 6574 5f73 7061 5f6d 6573 7361 6765 5f74  et_spa_message_t
│ │ │ │ │ -00016310: 7970 653a 2020 2020 2020 2020 2020 2020  ype:            
│ │ │ │ │ -00016320: 2020 5265 7472 6965 7669 6e67 2053 5041    Retrieving SPA
│ │ │ │ │ -00016330: 2044 6174 612e 2028 6c69 6e65 2020 3334   Data. (line  34
│ │ │ │ │ -00016340: 290a 2a20 666b 6f5f 6765 745f 7370 615f  ).* fko_get_spa_
│ │ │ │ │ -00016350: 6e61 745f 6163 6365 7373 3a20 2020 2020  nat_access:     
│ │ │ │ │ -00016360: 2020 2020 2020 2020 2020 2052 6574 7269             Retri
│ │ │ │ │ -00016370: 6576 696e 6720 5350 4120 4461 7461 2e20  eving SPA Data. 
│ │ │ │ │ -00016380: 286c 696e 6520 2036 3129 0a2a 2066 6b6f  (line  61).* fko
│ │ │ │ │ -00016390: 5f67 6574 5f73 7061 5f73 6572 7665 725f  _get_spa_server_
│ │ │ │ │ -000163a0: 6175 7468 3a20 2020 2020 2020 2020 2020  auth:           
│ │ │ │ │ -000163b0: 2020 2020 5265 7472 6965 7669 6e67 2053      Retrieving S
│ │ │ │ │ -000163c0: 5041 2044 6174 612e 2028 6c69 6e65 2020  PA Data. (line  
│ │ │ │ │ -000163d0: 3638 290a 2a20 666b 6f5f 6765 745f 7469  68).* fko_get_ti
│ │ │ │ │ -000163e0: 6d65 7374 616d 703a 2020 2020 2020 2020  mestamp:        
│ │ │ │ │ -000163f0: 2020 2020 2020 2020 2020 2020 2052 6574               Ret
│ │ │ │ │ -00016400: 7269 6576 696e 6720 5350 4120 4461 7461  rieving SPA Data
│ │ │ │ │ -00016410: 2e20 286c 696e 6520 2032 3929 0a2a 2066  . (line  29).* f
│ │ │ │ │ -00016420: 6b6f 5f67 6574 5f75 7365 726e 616d 653a  ko_get_username:
│ │ │ │ │ +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: 
│ │ │ │ │ +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:  
│ │ │ │ │  00016430: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00016440: 2020 2020 2020 5265 7472 6965 7669 6e67        Retrieving
│ │ │ │ │ -00016450: 2053 5041 2044 6174 612e 2028 6c69 6e65   SPA Data. (line
│ │ │ │ │ -00016460: 2020 3234 290a 2a20 666b 6f5f 6765 745f    24).* fko_get_
│ │ │ │ │ -00016470: 7665 7273 696f 6e3a 2020 2020 2020 2020  version:        
│ │ │ │ │ -00016480: 2020 2020 2020 2020 2020 2020 2020 2052                 R
│ │ │ │ │ -00016490: 6574 7269 6576 696e 6720 5350 4120 4461  etrieving SPA Da
│ │ │ │ │ -000164a0: 7461 2e20 286c 696e 6520 3132 3029 0a2a  ta. (line 120).*
│ │ │ │ │ -000164b0: 2066 6b6f 5f67 7067 5f65 7272 7374 723a   fko_gpg_errstr:
│ │ │ │ │ +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:  
│ │ │ │ │  000164c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000164d0: 2020 2020 2020 2020 4572 726f 7220 4861          Error Ha
│ │ │ │ │ -000164e0: 6e64 6c69 6e67 2e20 2020 2020 2028 6c69  ndling.      (li
│ │ │ │ │ -000164f0: 6e65 2033 3130 290a 2a20 666b 6f5f 6770  ne 310).* fko_gp
│ │ │ │ │ -00016500: 675f 7369 676e 6174 7572 655f 6670 725f  g_signature_fpr_
│ │ │ │ │ -00016510: 6d61 7463 683a 2020 2020 2020 2020 2020  match:          
│ │ │ │ │ -00016520: 2055 7469 6c69 7479 2046 756e 6374 696f   Utility Functio
│ │ │ │ │ -00016530: 6e73 2e20 2020 286c 696e 6520 2036 3129  ns.   (line  61)
│ │ │ │ │ -00016540: 0a2a 2066 6b6f 5f67 7067 5f73 6967 6e61  .* fko_gpg_signa
│ │ │ │ │ -00016550: 7475 7265 5f69 645f 6d61 7463 683a 2020  ture_id_match:  
│ │ │ │ │ -00016560: 2020 2020 2020 2020 2020 5574 696c 6974            Utilit
│ │ │ │ │ -00016570: 7920 4675 6e63 7469 6f6e 732e 2020 2028  y Functions.   (
│ │ │ │ │ -00016580: 6c69 6e65 2020 3534 290a 2a20 666b 6f5f  line  54).* fko_
│ │ │ │ │ -00016590: 6d65 7373 6167 655f 7479 7065 5f74 3a20  message_type_t: 
│ │ │ │ │ +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: 2020 2053 5041 204d 6573 7361 6765 732e     SPA Messages.
│ │ │ │ │ -000165c0: 2020 2020 2020 2020 286c 696e 6520 2031          (line  1
│ │ │ │ │ -000165d0: 3129 0a2a 2066 6b6f 5f6e 6577 3a20 2020  1).* fko_new:   
│ │ │ │ │ +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:     
│ │ │ │ │  000165e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000165f0: 2020 2020 2020 2020 2020 2020 4372 6561              Crea
│ │ │ │ │ -00016600: 7469 6e67 2043 6f6e 7465 7874 732e 2020  ting Contexts.  
│ │ │ │ │ -00016610: 2028 6c69 6e65 2020 3135 290a 2a20 666b   (line  15).* fk
│ │ │ │ │ -00016620: 6f5f 6e65 775f 7769 7468 5f64 6174 613a  o_new_with_data:
│ │ │ │ │ +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:  
│ │ │ │ │  00016630: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00016640: 2020 2020 2043 7265 6174 696e 6720 436f       Creating Co
│ │ │ │ │ -00016650: 6e74 6578 7473 2e20 2020 286c 696e 6520  ntexts.   (line 
│ │ │ │ │ -00016660: 2033 3829 0a2a 2066 6b6f 5f73 6574 5f67   38).* fko_set_g
│ │ │ │ │ -00016670: 7067 5f65 7865 3a20 2020 2020 2020 2020  pg_exe:         
│ │ │ │ │ -00016680: 2020 2020 2020 2020 2020 2020 2020 5365                Se
│ │ │ │ │ -00016690: 7474 696e 6720 5350 4120 4461 7461 2e20  tting SPA Data. 
│ │ │ │ │ -000166a0: 2020 2028 6c69 6e65 2031 3436 290a 2a20     (line 146).* 
│ │ │ │ │ -000166b0: 666b 6f5f 7365 745f 6770 675f 686f 6d65  fko_set_gpg_home
│ │ │ │ │ -000166c0: 5f64 6972 3a20 2020 2020 2020 2020 2020  _dir:           
│ │ │ │ │ -000166d0: 2020 2020 2020 2053 6574 7469 6e67 2053         Setting S
│ │ │ │ │ -000166e0: 5041 2044 6174 612e 2020 2020 286c 696e  PA Data.    (lin
│ │ │ │ │ -000166f0: 6520 3132 3629 0a2a 2066 6b6f 5f73 6574  e 126).* fko_set
│ │ │ │ │ -00016700: 5f67 7067 5f69 676e 6f72 655f 7665 7269  _gpg_ignore_veri
│ │ │ │ │ -00016710: 6679 5f65 7272 6f72 3a20 2020 2020 2020  fy_error:       
│ │ │ │ │ -00016720: 5365 7474 696e 6720 5350 4120 4461 7461  Setting SPA Data
│ │ │ │ │ -00016730: 2e20 2020 2028 6c69 6e65 2031 3339 290a  .    (line 139).
│ │ │ │ │ -00016740: 2a20 666b 6f5f 7365 745f 6770 675f 7265  * fko_set_gpg_re
│ │ │ │ │ -00016750: 6369 7069 656e 743a 2020 2020 2020 2020  cipient:        
│ │ │ │ │ -00016760: 2020 2020 2020 2020 2053 6574 7469 6e67           Setting
│ │ │ │ │ -00016770: 2053 5041 2044 6174 612e 2020 2020 286c   SPA Data.    (l
│ │ │ │ │ -00016780: 696e 6520 3131 3429 0a2a 2066 6b6f 5f73  ine 114).* fko_s
│ │ │ │ │ -00016790: 6574 5f67 7067 5f73 6967 6e61 7475 7265  et_gpg_signature
│ │ │ │ │ -000167a0: 5f76 6572 6966 793a 2020 2020 2020 2020  _verify:        
│ │ │ │ │ -000167b0: 2020 5365 7474 696e 6720 5350 4120 4461    Setting SPA Da
│ │ │ │ │ -000167c0: 7461 2e20 2020 2028 6c69 6e65 2031 3331  ta.    (line 131
│ │ │ │ │ -000167d0: 290a 2a20 666b 6f5f 7365 745f 6770 675f  ).* fko_set_gpg_
│ │ │ │ │ -000167e0: 7369 676e 6572 3a20 2020 2020 2020 2020  signer:         
│ │ │ │ │ -000167f0: 2020 2020 2020 2020 2020 2053 6574 7469             Setti
│ │ │ │ │ -00016800: 6e67 2053 5041 2044 6174 612e 2020 2020  ng SPA Data.    
│ │ │ │ │ -00016810: 286c 696e 6520 3132 3129 0a2a 2066 6b6f  (line 121).* fko
│ │ │ │ │ -00016820: 5f73 6574 5f72 616e 645f 7661 6c75 653a  _set_rand_value:
│ │ │ │ │ +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:  
│ │ │ │ │  00016830: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00016840: 2020 2020 5365 7474 696e 6720 5350 4120      Setting SPA 
│ │ │ │ │ -00016850: 4461 7461 2e20 2020 2028 6c69 6e65 2020  Data.    (line  
│ │ │ │ │ -00016860: 3334 290a 2a20 666b 6f5f 7365 745f 7370  34).* fko_set_sp
│ │ │ │ │ -00016870: 615f 636c 6965 6e74 5f74 696d 656f 7574  a_client_timeout
│ │ │ │ │ -00016880: 3a20 2020 2020 2020 2020 2020 2053 6574  :            Set
│ │ │ │ │ -00016890: 7469 6e67 2053 5041 2044 6174 612e 2020  ting SPA Data.  
│ │ │ │ │ -000168a0: 2020 286c 696e 6520 2038 3029 0a2a 2066    (line  80).* f
│ │ │ │ │ -000168b0: 6b6f 5f73 6574 5f73 7061 5f64 6174 613a  ko_set_spa_data:
│ │ │ │ │ +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:  
│ │ │ │ │  000168c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -000168d0: 2020 2020 2020 5365 7474 696e 6720 5350        Setting SP
│ │ │ │ │ -000168e0: 4120 4461 7461 2e20 2020 2028 6c69 6e65  A Data.    (line
│ │ │ │ │ -000168f0: 2031 3035 290a 2a20 666b 6f5f 7365 745f   105).* fko_set_
│ │ │ │ │ -00016900: 7370 615f 6469 6765 7374 3a20 2020 2020  spa_digest:     
│ │ │ │ │ -00016910: 2020 2020 2020 2020 2020 2020 2020 2053                 S
│ │ │ │ │ -00016920: 6574 7469 6e67 2053 5041 2044 6174 612e  etting SPA Data.
│ │ │ │ │ -00016930: 2020 2020 286c 696e 6520 2038 3929 0a2a      (line  89).*
│ │ │ │ │ -00016940: 2066 6b6f 5f73 6574 5f73 7061 5f64 6967   fko_set_spa_dig
│ │ │ │ │ -00016950: 6573 745f 7479 7065 3a20 2020 2020 2020  est_type:       
│ │ │ │ │ -00016960: 2020 2020 2020 2020 5365 7474 696e 6720          Setting 
│ │ │ │ │ -00016970: 5350 4120 4461 7461 2e20 2020 2028 6c69  SPA Data.    (li
│ │ │ │ │ -00016980: 6e65 2020 3131 290a 2a20 666b 6f5f 7365  ne  11).* fko_se
│ │ │ │ │ -00016990: 745f 7370 615f 656e 6372 7970 7469 6f6e  t_spa_encryption
│ │ │ │ │ -000169a0: 5f74 7970 653a 2020 2020 2020 2020 2020  _type:          
│ │ │ │ │ -000169b0: 2053 6574 7469 6e67 2053 5041 2044 6174   Setting SPA Dat
│ │ │ │ │ -000169c0: 612e 2020 2020 286c 696e 6520 2032 3729  a.    (line  27)
│ │ │ │ │ -000169d0: 0a2a 2066 6b6f 5f73 6574 5f73 7061 5f68  .* fko_set_spa_h
│ │ │ │ │ -000169e0: 6d61 633a 2020 2020 2020 2020 2020 2020  mac:            
│ │ │ │ │ -000169f0: 2020 2020 2020 2020 2020 5365 7474 696e            Settin
│ │ │ │ │ -00016a00: 6720 5350 4120 4461 7461 2e20 2020 2028  g SPA Data.    (
│ │ │ │ │ -00016a10: 6c69 6e65 2020 3937 290a 2a20 666b 6f5f  line  97).* fko_
│ │ │ │ │ -00016a20: 7365 745f 7370 615f 686d 6163 5f74 7970  set_spa_hmac_typ
│ │ │ │ │ -00016a30: 653a 2020 2020 2020 2020 2020 2020 2020  e:              
│ │ │ │ │ -00016a40: 2020 2053 6574 7469 6e67 2053 5041 2044     Setting SPA D
│ │ │ │ │ -00016a50: 6174 612e 2020 2020 286c 696e 6520 2031  ata.    (line  1
│ │ │ │ │ -00016a60: 3929 0a2a 2066 6b6f 5f73 6574 5f73 7061  9).* fko_set_spa
│ │ │ │ │ -00016a70: 5f6d 6573 7361 6765 3a20 2020 2020 2020  _message:       
│ │ │ │ │ -00016a80: 2020 2020 2020 2020 2020 2020 5365 7474              Sett
│ │ │ │ │ -00016a90: 696e 6720 5350 4120 4461 7461 2e20 2020  ing SPA Data.   
│ │ │ │ │ -00016aa0: 2028 6c69 6e65 2020 3633 290a 2a20 666b   (line  63).* fk
│ │ │ │ │ -00016ab0: 6f5f 7365 745f 7370 615f 6d65 7373 6167  o_set_spa_messag
│ │ │ │ │ -00016ac0: 655f 7479 7065 3a20 2020 2020 2020 2020  e_type:         
│ │ │ │ │ -00016ad0: 2020 2020 2053 6574 7469 6e67 2053 5041       Setting SPA
│ │ │ │ │ -00016ae0: 2044 6174 612e 2020 2020 286c 696e 6520   Data.    (line 
│ │ │ │ │ -00016af0: 2035 3629 0a2a 2066 6b6f 5f73 6574 5f73   56).* fko_set_s
│ │ │ │ │ -00016b00: 7061 5f6e 6174 5f61 6363 6573 733a 2020  pa_nat_access:  
│ │ │ │ │ -00016b10: 2020 2020 2020 2020 2020 2020 2020 5365                Se
│ │ │ │ │ -00016b20: 7474 696e 6720 5350 4120 4461 7461 2e20  tting SPA Data. 
│ │ │ │ │ -00016b30: 2020 2028 6c69 6e65 2020 3639 290a 2a20     (line  69).* 
│ │ │ │ │ -00016b40: 666b 6f5f 7365 745f 7370 615f 7365 7276  fko_set_spa_serv
│ │ │ │ │ -00016b50: 6572 5f61 7574 683a 2020 2020 2020 2020  er_auth:        
│ │ │ │ │ -00016b60: 2020 2020 2020 2053 6574 7469 6e67 2053         Setting S
│ │ │ │ │ -00016b70: 5041 2044 6174 612e 2020 2020 286c 696e  PA Data.    (lin
│ │ │ │ │ -00016b80: 6520 2037 3529 0a2a 2066 6b6f 5f73 6574  e  75).* fko_set
│ │ │ │ │ -00016b90: 5f74 696d 6573 7461 6d70 3a20 2020 2020  _timestamp:     
│ │ │ │ │ -00016ba0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ │ -00016bb0: 5365 7474 696e 6720 5350 4120 4461 7461  Setting SPA Data
│ │ │ │ │ -00016bc0: 2e20 2020 2028 6c69 6e65 2020 3532 290a  .    (line  52).
│ │ │ │ │ -00016bd0: 2a20 666b 6f5f 7365 745f 7573 6572 6e61  * fko_set_userna
│ │ │ │ │ -00016be0: 6d65 3a20 2020 2020 2020 2020 2020 2020  me:             
│ │ │ │ │ -00016bf0: 2020 2020 2020 2020 2053 6574 7469 6e67           Setting
│ │ │ │ │ -00016c00: 2053 5041 2044 6174 612e 2020 2020 286c   SPA Data.    (l
│ │ │ │ │ -00016c10: 696e 6520 2034 3229 0a2a 2066 6b6f 5f73  ine  42).* fko_s
│ │ │ │ │ -00016c20: 7061 5f64 6174 615f 6669 6e61 6c3a 2020  pa_data_final:  
│ │ │ │ │ +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: 2020 5574 696c 6974 7920 4675 6e63 7469    Utility Functi
│ │ │ │ │ -00016c50: 6f6e 732e 2020 2028 6c69 6e65 2020 3136  ons.   (line  16
│ │ │ │ │ -00016c60: 290a 2a20 7370 615f 6d65 7373 6167 655f  ).* spa_message_
│ │ │ │ │ -00016c70: 6669 656c 6473 3a20 2020 2020 2020 2020  fields:         
│ │ │ │ │ -00016c80: 2020 2020 2020 2020 2020 2053 5041 2044             SPA D
│ │ │ │ │ -00016c90: 6174 6120 466f 726d 6174 2e20 2020 2020  ata Format.     
│ │ │ │ │ -00016ca0: 286c 696e 6520 2031 3229 0a0a 0a1f 0a54  (line  12).....T
│ │ │ │ │ -00016cb0: 6167 2054 6162 6c65 3a0a 4e6f 6465 3a20  ag Table:.Node: 
│ │ │ │ │ -00016cc0: 546f 707f 3131 3230 0a4e 6f64 653a 2049  Top.1120.Node: I
│ │ │ │ │ -00016cd0: 6e74 726f 6475 6374 696f 6e7f 3433 3139  ntroduction.4319
│ │ │ │ │ -00016ce0: 0a4e 6f64 653a 2047 6574 7469 6e67 2053  .Node: Getting S
│ │ │ │ │ -00016cf0: 7461 7274 6564 7f36 3032 390a 4e6f 6465  tarted.6029.Node
│ │ │ │ │ -00016d00: 3a20 4665 6174 7572 6573 7f36 3632 350a  : Features.6625.
│ │ │ │ │ -00016d10: 4e6f 6465 3a20 4f76 6572 7669 6577 7f37  Node: Overview.7
│ │ │ │ │ -00016d20: 3638 330a 4e6f 6465 3a20 5350 4120 4461  683.Node: SPA Da
│ │ │ │ │ -00016d30: 7461 2046 6f72 6d61 747f 3837 3432 0a4e  ta Format.8742.N
│ │ │ │ │ -00016d40: 6f64 653a 2050 7265 7061 7261 7469 6f6e  ode: Preparation
│ │ │ │ │ -00016d50: 7f31 3133 3738 0a4e 6f64 653a 206c 6962  .11378.Node: lib
│ │ │ │ │ -00016d60: 666b 6f20 4865 6164 6572 7f31 3139 3338  fko Header.11938
│ │ │ │ │ -00016d70: 0a4e 6f64 653a 2043 6f6d 7069 6c69 6e67  .Node: Compiling
│ │ │ │ │ -00016d80: 2077 6974 6820 6c69 6266 6b6f 7f31 3234   with libfko.124
│ │ │ │ │ -00016d90: 3831 0a4e 6f64 653a 2053 5041 2050 6172  81.Node: SPA Par
│ │ │ │ │ -00016da0: 616d 6574 6572 2054 7970 6573 7f31 3335  ameter Types.135
│ │ │ │ │ -00016db0: 3636 0a4e 6f64 653a 2044 6967 6573 7473  66.Node: Digests
│ │ │ │ │ -00016dc0: 7f31 3430 3738 0a4e 6f64 653a 2053 5041  .14078.Node: SPA
│ │ │ │ │ -00016dd0: 204d 6573 7361 6765 737f 3135 3134 310a   Messages.15141.
│ │ │ │ │ -00016de0: 4e6f 6465 3a20 456e 6372 7970 7469 6f6e  Node: Encryption
│ │ │ │ │ -00016df0: 2041 6c67 6f72 6974 686d 737f 3137 3236   Algorithms.1726
│ │ │ │ │ -00016e00: 310a 4e6f 6465 3a20 484d 4143 2044 6967  1.Node: HMAC Dig
│ │ │ │ │ -00016e10: 6573 7473 7f31 3833 3939 0a4e 6f64 653a  ests.18399.Node:
│ │ │ │ │ -00016e20: 2055 7369 6e67 206c 6962 666b 6f7f 3139   Using libfko.19
│ │ │ │ │ -00016e30: 3330 300a 4e6f 6465 3a20 4372 6561 7469  300.Node: Creati
│ │ │ │ │ -00016e40: 6e67 2043 6f6e 7465 7874 737f 3230 3133  ng Contexts.2013
│ │ │ │ │ -00016e50: 390a 4e6f 6465 3a20 4465 7374 726f 7969  9.Node: Destroyi
│ │ │ │ │ -00016e60: 6e67 2043 6f6e 7465 7874 737f 3235 3132  ng Contexts.2512
│ │ │ │ │ -00016e70: 360a 4e6f 6465 3a20 4372 6561 7469 6e67  6.Node: Creating
│ │ │ │ │ -00016e80: 2061 2053 5041 204d 6573 7361 6765 7f32   a SPA Message.2
│ │ │ │ │ -00016e90: 3537 3437 0a4e 6f64 653a 2053 6574 7469  5747.Node: Setti
│ │ │ │ │ -00016ea0: 6e67 2053 5041 2044 6174 617f 3330 3538  ng SPA Data.3058
│ │ │ │ │ -00016eb0: 310a 4e6f 6465 3a20 5265 7472 6965 7669  1.Node: Retrievi
│ │ │ │ │ -00016ec0: 6e67 2053 5041 2044 6174 617f 3338 3134  ng SPA Data.3814
│ │ │ │ │ -00016ed0: 320a 4e6f 6465 3a20 5574 696c 6974 7920  2.Node: Utility 
│ │ │ │ │ -00016ee0: 4675 6e63 7469 6f6e 737f 3437 3132 350a  Functions.47125.
│ │ │ │ │ -00016ef0: 4e6f 6465 3a20 4572 726f 7220 4861 6e64  Node: Error Hand
│ │ │ │ │ -00016f00: 6c69 6e67 7f35 3035 3036 0a4e 6f64 653a  ling.50506.Node:
│ │ │ │ │ -00016f10: 204c 6962 7261 7279 2043 6f70 7969 6e67   Library Copying
│ │ │ │ │ -00016f20: 7f36 3538 3532 0a4e 6f64 653a 2043 6f6e  .65852.Node: Con
│ │ │ │ │ -00016f30: 6365 7074 2049 6e64 6578 7f38 3531 3434  cept Index.85144
│ │ │ │ │ -00016f40: 0a4e 6f64 653a 2046 756e 6374 696f 6e20  .Node: Function 
│ │ │ │ │ -00016f50: 616e 6420 4461 7461 2049 6e64 6578 7f38  and Data Index.8
│ │ │ │ │ -00016f60: 3833 3931 0a1f 0a45 6e64 2054 6167 2054  8391...End Tag T
│ │ │ │ │ -00016f70: 6162 6c65 0a0a 1f0a 4c6f 6361 6c20 5661  able....Local Va
│ │ │ │ │ -00016f80: 7269 6162 6c65 733a 0a63 6f64 696e 673a  riables:.coding:
│ │ │ │ │ -00016f90: 2075 7466 2d38 0a45 6e64 3a0a             utf-8.End:.
│ │ │ │ │ +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:.